MFC r267667:
use .Mt to mark up email addresses consistently (part1)

PR: 191174
Submitted by: Franco Fichtner <franco at lastsummer.de>

MFC r306714:
Document where chio(1) originated from & which version of FreeBSD first
included it.

PR: 211776
Approved by: bcr (mentor)
Differential Revision: https://reviews.freebsd.org/D8104

MFC r306584:
Move the description of CHANGER variable to ENVIRONMENT section rather than
in the DESCRIPTION section.
From OpenBSD src/bin/chio/chio.1 r1.23

PR: 212158
Approved by: bjk
Obtained from: OpenBSD
Differential Revision: https://reviews.freebsd.org/D8117

Copy head (r256279) to stable/10 as part of the 10.0-RELEASE cycle.

Approved by: re (implicit)
Sponsored by: The FreeBSD Foundation

Update chio(1) and ch(4) to support reporting element designators.

This allows mapping a tape drive in a changer (as reported by
'chio status') to a sa(4) driver instance by comparing the
serial numbers.

The designators can be ASCII (which is printed out directly), binary
(which is printed in hex format) or UTF-8, which is printed in either
native UTF-8 format if the terminal can support it, or in %XX notation
for non-ASCII characters. Thanks to Hiroki Sato <hrs@> for the
explaining UTF-8 printing and example UTF-8 printing code.

chio.h: Modify the changer_element_status structure to add new
fields and definitions from the SMC3r16 spec.

Rename the original CHIOGSTATUS ioctl to OCHIOGTATUS and
define a new CHIOGSTATUS ioctl.

Clean up some tab/space issues.

chio.c: For the 'status' subcommand, print the designator field
if it is supplied by a device.

scsi_ch.h: Add new flags for DVCID and CURDATA to the READ
ELEMENT STATUS command structure.

Add a read_element_status_device_id structure
for the data fields in the new standard. Add new
unions, dt_or_obsolete and voltage_devid, to hold
and address data from either SCSI-2 or newer devices.

scsi_ch.c: Implement support for fetching device IDs with READ
ELEMENT STATUS data.

Add new arguments to scsi_read_element_status() to
allow the user to request the DVCID and CURDATA bits.
This isn't compiled into libcam (it's only an internal
kernel interface), so we don't need any special
handling for the API change.

If the user issues the new CHIOGSTATUS ioctl, copy all of
the available element status data out. If he issues the
OCHIOGSTATUS ioctl, we don't copy the new fields in the
structure.

Fix a bug in chopen() that would result in the peripheral
never getting unheld if chgetparams() failed.

Sponsored by: Spectra Logic
Submitted by: Po-Li Soong
MFC After: 1 week

Add static keywords to chio(1).

All other global variables are already marked static, so for consistency
sake, add them to these three arrays as well.

Zero struct before reading from it

PR: 140384
Found by: clang static analyzer
MFC after: 3 weeks

When running a "chio return" operation using a physical source unit
rather than a voltag name, do not set the CESR_VOLTAGS flags in the
CHIOGSTATUS command requesting the current status. As voltags are an
optional feature that must be handled as "reserved" by media changers
not implementing the feature, always setting CESR_VOLTAGS resulted in
the command being aborted with an `Invalid field in CDB', and
consequently the "chio return" failed, for media changers that do not
support voltags.

MFC after: 1 week

Don't specify SRCS= when it can be obtained from PROGS=

Add the new standard EXIT STATUS section where appropriate.
Sort standard sections in the (documented) preferred order.

Removed harmful empty lines that crept in during the copyright
header update.

/*- or .\"- or #- to begin license clauses.

Mechanically kill hard sentence breaks.

Quiet warnings about copyright[].

The .Nm utility

Correct typos, mostly s/ a / an / where appropriate. Some whitespace cleanup,
especially in troff files.

Remove double #include <sys/cdef.h> and __FBSDID.

PR: 40053
Submitted by: Dan Lukes <dan@obluda.cz>

Consistently use __FBSDID

Replace use of __progname with the functionally identical and more
acceptable getprogname(3).

Use ANSI-99 int names (uintXX_t) over traditional BSD int names
(u_intXX_t).

Fix a boatload of warnings inspired by lint, a commercial lint
and WARNS=4.

Modernization effort for bin/c*:

o __P has been reoved
o Old-style K&R declarations have been converted to new C89 style
o register has been removed
o prototype for main() has been removed (gcc3 makes it an error)
o int main(int argc, char *argv[]) is the preferred main definition.
o Attempt to not break style(9) conformance for declarations more than
they already are.

Approved by: arch@, new style(9)

Default to WARNS=2. Binary builds that cannot handle this must explicitly
set WARNS=0.

Reviewed by: mike

mdoc(7) police: join split punctuation to macro calls.

Remove whitespace at EOL.

mdoc(7) police: remove extraneous .Pp before and/or after .Sh.

Fix warnings on alpha and re-enable WARNS=2.

Submitted by: Mike Barcroft <mike@q9media.com>

Argh...this isn't ready for WARNS=2 on alpha.

Constify and lockdown with WARNS=2.

Submitted by: Mike Barcroft <mike@q9media.com>
MFC after: 2 weeks

Removed -I${.CURDIR}/.../sys from CFLAGS.

mdoc(7) police: simplify construct.

log

more removal of trailing periods from SEE ALSO.

Avoid use of direct troff requests in mdoc(7) manual pages.

Use .Cm macro where appropriate.

Fix horrendous abuse of the Nm and Pa mdoc macros, and remove troff
bold markers \fB and \fR.

Add two new features to chio(1):
- The ability to specify elements by volume tag instead of their actual
physical location. e.g., instead of:
chio move slot 3 slot 4
you would now use:
chio move voltag FOO slot 4

- The ability to return an element to its previous location, as specified
by the source element. e.g., instead of:
chio move drive 0 slot 4
you would now use:
chio return drive 0
or
chio return voltag FOO

These features will obviously only work with changers that support volume
tags and/or source element IDs. chio(1) should fail gracefully if the user
attempts to use these new features and the source element ID or volume tag
are not found.

PR: bin/21178
Submitted by: "C. Stephen Gunn" <csg@waterspout.com>
Reviewed by: ken

Don't explicitly declare optarg and optind. These are declared in
unistd.h, which is already included.

$Id$ -> $FreeBSD$

Correct some style issues in my previous commit.

Submitted by: bde

Undo some of the reversions from previous revisions, and attempt to
minimize diffs with {Net,Open}BSD

Hinted-More-Or-Less-By: bde

Changes from OpenBSD:
* Better usage() - correct syntax, display available commands
instead of examples
* Accept command abbreviations
* sprintf -> snprintf (for paranoia)
* manpage capitalisation tweak

Obtained from: OpenBSD

getopt(3) returns -1 not EOF.

First set of fixes to keep egcs happy. These include {} around single
statement if blocks[*] when the else could be ambiguous, not defaulting
to int type and removal of some unused variables.

[*] This is explicitly allowed by style(9) when the single statement
spans more than one line.

Reviewed by: obrien, chuckr

Fixed printf format errors (new bugs in rev.1.7). Fixed a spelling error
(rev.1.7 blew away most of rev.1.2-1.6; I'm only fixing blowing away of
rev.1.4).

superceded -> superseded, which after some debate on #FreeBSD is in
fact the proper spelling.

PR: docs/8697
Submitted by: Sascha Blank <blank@fox.uni-trier.de>

Fix 'chio params' so that it actually prints out the current picker.
(This was broken when the volume tag changes went in.)

Submitted by: Josef Karthauser <joe@pavilion.net>

Updated the ch(4) driver and chio(1) command to include volume
tag support. These changes have been tested with a Breeze Hill
Q47 DLT and a DEC DLT2500 media changer. The latter has no
volume tag support.

The chio(1) command was updated to include various flags to the
status subcommand. These flags can be used to select additional
information to be displayed (like volume tags).

A new chio(1) subcommand named 'voltag' has been added which allows
for changes to volume tags inside the media changer controller.
This could not be tested as the Q47 does not provide the functio-
nality.

Submitted by: Hans Huebner

Fix a bunch of spelling errors.

PR: 6856
Submitted by: Josh Gilliam <josh@quick.net>

Do not remove include of <sys/param.h> and <sys/types.h>. They should
be here before including almost any POSIX header.
Requested by: Bruce

Correct use of .Nm and other cosmetics. Add rcsid. Remove unused #inc.

.Sh AUTHOR -> .Sh AUTHORS
Use .An/.Aq

spelling

Obtained from: OpenBSD (src/bin/chio/chio.c rev 1.7) by todd@openbsd.org

spelling corrections.

PR: docs/4450
Submitted by: josh@quick.net

This command doesn't need to be setuid root, it's only asking
for potential trouble.
Reviewed by: security officers.
Noted by: OpenBSD

Do not use __progname.

Add X-reference to ch(4).

Remove unused variables. Suppress -Wall warnings. Check for potential buffer
overflow. Display available command in usage string.
Obtained from: {Net|Open}BSD

This commit was generated by cvs2svn to compensate for changes in r23449,
which included commits to RCS files with non-trunk default branches.