diff options
Diffstat (limited to 'bin/chio/chio.1')
-rw-r--r-- | bin/chio/chio.1 | 97 |
1 files changed, 49 insertions, 48 deletions
diff --git a/bin/chio/chio.1 b/bin/chio/chio.1 index 010de4a71409..bffce3c47254 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/ |