summaryrefslogtreecommitdiffstats
path: root/bin/chio
diff options
context:
space:
mode:
authorcharnier <charnier@FreeBSD.org>1998-05-06 06:51:42 +0000
committercharnier <charnier@FreeBSD.org>1998-05-06 06:51:42 +0000
commitc4d26d7f835032c231da4c6219c73b2679691222 (patch)
treea83653b0a70dcb5e787512cfa4954591689bf876 /bin/chio
parent32338c8e0512ee1c5643fd65a793a21fabadfcfa (diff)
downloadFreeBSD-src-c4d26d7f835032c231da4c6219c73b2679691222.zip
FreeBSD-src-c4d26d7f835032c231da4c6219c73b2679691222.tar.gz
Correct use of .Nm and other cosmetics. Add rcsid. Remove unused #inc.
Diffstat (limited to 'bin/chio')
-rw-r--r--bin/chio/chio.197
-rw-r--r--bin/chio/chio.c11
2 files changed, 54 insertions, 54 deletions
diff --git a/bin/chio/chio.1 b/bin/chio/chio.1
index 010de4a..bffce3c 100644
--- a/bin/chio/chio.1
+++ b/bin/chio/chio.1
@@ -30,6 +30,8 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
+.\" $Id$
+.\"
.Dd April 2, 1996
.Dt CHIO 1
.Os
@@ -61,49 +63,53 @@ rather than the default device
.El
.Pp
The default changer may be overridden by setting the environment variable
-.Nm CHANGER
+.Ev CHANGER
to the desired changer device.
.Pp
A medium changer apparatus is made up of
-.Pa elements .
+.Em elements .
There are four element types:
-.Pa picker
+.Em picker
(medium transport),
-.Pa slot
+.Em slot
(storage),
-.Pa portal
+.Em portal
(import/export), and
-.Pa drive
+.Em drive
(data transfer). In this command description, the shorthand
-.Nm ET
+.Em ET
will be used to represent an element type, and
-.Nm EU
+.Em EU
will be used to represent an element unit. For example, to represent
-the first robotic arm in the changer, the ET would be
+the first robotic arm in the changer, the
+.Em ET
+would be
.Dq picker
-and the EU would be
+and the
+.Em EU
+would be
.Dq 0 .
.Pp
.Sh SUPPORTED COMMANDS
-.Nm chio move
+.Bl -tag -width indent
+.It Xo Nm chio move
.Ar <from ET> <from EU> <to ET> <to EU>
.Op Ar inv
-.Pp
-Moves the media unit from
+.Xc
+Move the media unit from
.Pa <from ET/EU>
to
.Pa <to ET/EU> .
If the optional modifier
.Pa inv
is specified, the media unit will be inverted before insertion.
-.Pp
-.Nm chio exchange
+.It Xo Nm chio exchange
.Ar <src ET> <src EU> <dst1 ET> <dst1 EU>
.Op Ar <dst2 ET> <dst2 ET>
.Op Ar inv1
.Op Ar inv2
-.Pp
-Performs a media unit exchange operation. The media unit in
+.Xc
+Perform a media unit exchange operation. The media unit in
.Pa <src ET/EU>
is moved to
.Pa <dst1 ET/EU>
@@ -130,11 +136,10 @@ Note that not all medium changers support the
.Nm exchange
operation; The changer must have multiple free pickers or emulate
multiple free pickers with transient storage.
-.Pp
-.Nm chio position
+.It Xo Nm chio position
.Ar <to ET> <to EU>
.Op Ar inv
-.Pp
+.Xc
Position the picker in front of the element described by
.Pa <to ET/EU> .
If the optional modifier
@@ -142,63 +147,59 @@ If the optional modifier
is specified, the media unit will be inverted before insertion.
.Pp
Note that not all changers behave as expected when issued this command.
-.Pp
-.Nm chio params
-.Pp
+.It Nm chio params
Report the number of slots, drives, pickers, and portals in the changer,
and which picker unit the changer is currently configured to use.
-.Pp
-.Nm chio getpicker
-.Pp
+.It Nm chio getpicker
Report which picker unit the changer is currently configured to use.
-.Pp
-.Nm chio setpicker
+.It Xo Nm chio setpicker
.Ar <unit>
-.Pp
+.Xc
Configure the changer to use picker
.Pa <unit> .
-.Pp
-.Nm chio status
+.It Xo Nm chio status
.Op Ar <type>
-.Pp
+.Xc
Report the status of all elements in the changer. If
.Pa <type>
is specified, report the status of all elements of type
.Pa <type> .
+.El
.Pp
The status bits are defined as follows:
.Bl -tag -width indent
-.It Nm FULL
+.It FULL
Element contains a media unit.
-.It Nm IMPEXP
+.It IMPEXP
Media was deposited into element by an outside human operator.
-.It Nm EXCEPT
+.It EXCEPT
Element is in an abnormal state.
-.It Nm ACCESS
+.It ACCESS
Media in this element is accessible by a picker.
-.It Nm EXENAB
+.It EXENAB
Element supports passing media (exporting) to an outsite human operator.
-.It Nm INENAB
+.It INENAB
Element supports receiving media (importing) from an outside human operator.
.El
-.Pp
.Sh EXAMPLES
-.Nm chio move slot 3 drive 0
-.Pp
-Moves the media in slot 3 (fourth slot) to drive 0 (first drive).
-.Pp
-.Nm chio setpicker 2
-Configures the changer to use picker 2 (third picker) for operations.
-.Pp
+.Bl -tag -width indent
+.It Nm chio move slot 3 drive 0
+Move the media in slot 3 (fourth slot) to drive 0 (first drive).
+.It Nm chio setpicker 2
+Configure the changer to use picker 2 (third picker) for operations.
+.El
.Sh FILES
-/dev/ch0 - default changer device
+.Bl -tag -width /dev/ch0 -compact
+.It Pa /dev/ch0
+default changer device
+.El
.Sh SEE ALSO
.Xr mt 1 ,
.Xr ch 4 ,
.Xr mount 8
.Sh AUTHORS
The
-.Nm chio
+.Nm
program and SCSI changer driver were written by
.An Jason R. Thorpe Aq thorpej@and.com
for And Communications, http://www.and.com/
diff --git a/bin/chio/chio.c b/bin/chio/chio.c
index a63d5b6..4507b59 100644
--- a/bin/chio/chio.c
+++ b/bin/chio/chio.c
@@ -1,5 +1,3 @@
-/* $Id: chio.c,v 1.3 1997/06/06 06:32:09 charnier Exp $ */
-
/*
* Copyright (c) 1996 Jason R. Thorpe <thorpej@and.com>
* All rights reserved.
@@ -32,13 +30,14 @@
* SUCH DAMAGE.
*/
-#include <sys/param.h>
-#include <sys/ioctl.h>
+#ifndef lint
+static const char rcsid[] =
+ "$Id$";
+#endif /* not lint */
+
#include <sys/chio.h>
#include <err.h>
-#include <errno.h>
#include <fcntl.h>
-#include <limits.h>
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
OpenPOWER on IntegriCloud