From d9bdf7bf13c43f5997b49af0ccd7906cc1df632b Mon Sep 17 00:00:00 2001 From: sheldonh Date: Tue, 19 Sep 2000 09:46:01 +0000 Subject: Fix horrendous abuse of the Nm and Pa mdoc macros, and remove troff bold markers \fB and \fR. --- bin/chio/chio.1 | 84 +++++++++++++++++++++++++++++---------------------------- 1 file changed, 43 insertions(+), 41 deletions(-) (limited to 'bin/chio/chio.1') diff --git a/bin/chio/chio.1 b/bin/chio/chio.1 index 4697c9b..8be3e08 100644 --- a/bin/chio/chio.1 +++ b/bin/chio/chio.1 @@ -58,7 +58,7 @@ The options are as follows: .Bl -tag -width indent .It Fl f Ar changer Use the device -.Pa changer +.Ar changer rather than the default device .Pa /dev/ch0 . .El @@ -100,51 +100,51 @@ would be .Pp .Sh SUPPORTED COMMANDS .Bl -tag -width indent -.It Xo Nm move +.It Ic move Xo .Ar -.Op Ar inv +.Op inv .Xc Move the media unit from -.Pa +.Ar to -.Pa . +.Ar . If the optional modifier -.Pa inv +.Dq inv is specified, the media unit will be inverted before insertion. -.It Xo Nm exchange +.It Ic exchange Xo .Ar .Op Ar -.Op Ar inv1 -.Op Ar inv2 +.Op inv1 +.Op inv2 .Xc Perform a media unit exchange operation. The media unit in -.Pa +.Ar is moved to -.Pa +.Ar and the media unit previously in -.Pa +.Ar is moved to -.Pa . +.Ar . In the case of a simple exchange, -.Pa +.Ar is omitted and the values -.Pa +.Ar are used in their place. The optional modifiers -.Pa inv1 +.Dq inv1 and -.Pa inv2 +.Dq inv2 specify whether the media units are to be inverted before insertion into -.Pa +.Ar and -.Pa +.Ar respectively. .Pp Note that not all medium changers support the .Ic exchange operation; the changer must have multiple free pickers or emulate multiple free pickers with transient storage. -.It Xo Nm return +.It Ic return Xo .Ar .Xc Return the media unit to its source element. @@ -153,38 +153,39 @@ will move it to the element specified in its source attribute. This is a convenient way to return media from a drive or portal to its previous element in the changer. .Pp -.It Xo Nm position +.It Ic position Xo .Ar -.Op Ar inv +.Op inv .Xc Position the picker in front of the element described by -.Pa . +.Ar . If the optional modifier -.Pa inv +.Dq inv is specified, the media unit will be inverted before insertion. .Pp Note that not all changers behave as expected when issued this command. -.It Nm params +.It Ic params Report the number of slots, drives, pickers, and portals in the changer, and which picker unit the changer is currently configured to use. -.It Nm getpicker +.It Ic getpicker Report which picker unit the changer is currently configured to use. -.It Xo Nm setpicker +.It Ic setpicker Xo .Ar .Xc Configure the changer to use picker -.Pa . +.Ar . .Pp -.It Xo Nm ielem -.Op Pa +.It Ic ielem Xo +.Op Ar .Xc -Perform an \fBINITIALIZE ELEMENT STATUS\fR +Perform an +.Em INITIALIZE ELEMENT STATUS operation on the changer. The optional -.Pa +.Ar parameter may be given to specify a timeout in seconds for the operations. This may be used if the operation takes unusually long because of buggy firmware or the like. -.It Xo Nm voltag +.It Ic voltag Xo .Op Fl fca .Ar .Ar @@ -211,17 +212,18 @@ volume tag information defined. The command works with the primary volume tag or, if the .Fl a flag is given, with the alternate volume tag. -.It Xo Nm status +.It Ic status Xo .Op Fl vVsSbIa .Op Ar .Xc Report the status of all elements in the changer. If -.Pa +.Ar is specified, report the status of all elements of type -.Pa . +.Ar . .It Fl v Print the primary volume tag for each loaded medium, if any. The volume -tag is printed as \fB\fR. +tag is printed as +.Dq . .It Fl V Print the alternate volume tag for each loaded medium, if any. .It Fl s @@ -260,14 +262,14 @@ Element supports receiving media (importing) from an outside human operator. .Pp .Sh EXAMPLES .Bl -tag -width indent -.It Nm chio move slot 3 drive 0 +.It Li chio move slot 3 drive 0 Move the media in slot 3 (fourth slot) to drive 0 (first drive). -.It Nm chio move voltag VOLUME01 drive 0 +.It Li chio move voltag VOLUME01 drive 0 Move the media with the barcode VOLUME01 to drive 0 (first drive). -.It Nm chio return drive 0 +.It Li chio return drive 0 Remove the tape from drive 0 (first drive) and return it to its original location in the rack. -.It Nm chio setpicker 2 +.It Li chio setpicker 2 Configure the changer to use picker 2 (third picker) for operations. .El .Sh FILES -- cgit v1.1