Aren
/
NetBSD
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

cleanup .Nm usage

This commit is contained in:
lukem 1997-09-15 13:23:01 +00:00
parent d0c91e4214
commit de787845e5
1 changed files with 25 additions and 17 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

42
bin/chio/chio.1
View File

@ -1,4 +1,4 @@
.\" $NetBSD: chio.1,v 1.1.1.1 1996/04/03 00:34:38 thorpej Exp $
.\" $NetBSD: chio.1,v 1.2 1997/09/15 13:23:01 lukem Exp $
.\"
.\" Copyright (c) 1996 Jason R. Thorpe <thorpej@and.com>
.\" All rights reserved.
@ -37,7 +37,7 @@
.Nm chio
.Nd medium changer control utility
.Sh SYNOPSIS
.Nm chio
.Nm
.Op Fl f Ar changer
.Ar command
.Ar arg1
@ -47,7 +47,7 @@
.Oc
.Oc
.Sh DESCRIPTION
.Nm Chio
.Nm
is used to control the operation of medium changers, such as those found
in tape and optical disk jukeboxes.
.Pp
@ -61,7 +61,7 @@ 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
@ -75,9 +75,9 @@ There are four element types:
(import/export), and
.Pa drive
(data transfer). In this command description, the shorthand
.Nm ET
.Ic ET
will be used to represent an element type, and
.Nm EU
.Ic EU
will be used to represent an element unit. For example, to represent
the first robotic arm in the changer, the ET would be
.Dq picker
@ -85,7 +85,8 @@ and the EU would be
.Dq 0 .
.Pp
.Sh SUPPORTED COMMANDS
.Nm chio move
.Nm
.Ic move
.Ar <from ET> <from EU> <to ET> <to EU>
.Op Ar inv
.Pp
@ -97,7 +98,8 @@ If the optional modifier
.Pa inv
is specified, the media unit will be inverted before insertion.
.Pp
.Nm chio exchange
.Nm
.Ic exchange
.Ar <src ET> <src EU> <dst1 ET> <dst1 EU>
.Op Ar <dst2 ET> <dst2 ET>
.Op Ar inv1
@ -127,11 +129,12 @@ and
respecitively.
.Pp
Note that not all medium changers support the
.Nm exchange
.Ic exchange
operation; The changer must have multiple free pickers or emulate
multiple free pickers with transient storage.
.Pp
.Nm chio position
.Nm
.Ic position
.Ar <to ET> <to EU>
.Op Ar inv
.Pp
@ -143,22 +146,26 @@ 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
.Nm
.Ic params
.Pp
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
.Nm
.Ic getpicker
.Pp
Report which picker unit the changer is currently configured to use.
.Pp
.Nm chio setpicker
.Nm
.Ic setpicker
.Ar <unit>
.Pp
Configure the changer to use picker
.Pa <unit> .
.Pp
.Nm chio status
.Nm
.Ic status
.Op Ar <type>
.Pp
Report the status of all elements in the changer. If
@ -183,11 +190,12 @@ Element supports receiving media (importing) from an outside human operator.
.El
.Pp
.Sh EXAMPLES
.Nm chio move slot 3 drive 0
.Dl 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
.Dl chio setpicker 2
.Pp
Configures the changer to use picker 2 (third picker) for operations.
.Pp
.Sh FILES
@ -197,6 +205,6 @@ Configures the changer to use picker 2 (third picker) for operations.
.Xr mount 8 .
.Sh AUTHOR
The
.Nm chio
.Nm
program and SCSI changer driver were written by Jason R. Thorpe
<thorpej@and.com> for And Communications, http://www.and.com/