*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->OpenBSD man pages -> chio (1)              



NAME    [Toc]    [Back]

     chio - medium changer control utility

SYNOPSIS    [Toc]    [Back]

     chio [-f changer] command arg1 arg2 [arg3 [...]]

DESCRIPTION    [Toc]    [Back]

     The chio utility is used to control the operation of  medium
     such as those found in tape and optical disk jukeboxes.

     The options are as follows:

     -f changer
             Use  the  device changer rather than the default device /dev/ch0.

     The default changer may be overridden by setting  the  environment variable
     CHANGER to the desired changer device.

     A  medium  changer  apparatus is made up of elements.  There
are four element
  types:  picker  (medium  transport),  slot  (storage),
portal (import/export),
  and drive (data transfer).  In this command description, the
     shorthand `ET' will be used to represent  an  element  type,
and `EU' will
     be  used to represent an element unit.  For example, to represent the
     first robotic arm in the changer, the ET would be ``picker''
and the EU
     would be ``0''.


     # chio move <from ET> <from EU> <to ET> <to EU> [inv]

     Moves  the  media  unit from <from ET/EU> to <to ET/EU>.  If
the optional
     modifier inv is specified, the media unit will  be  inverted
before insertion.

     # chio exchange <src ET> <src EU> <dst1 ET> <dst1 EU> [<dst2
ET> <dst2
     EU>] [inv1] [inv2]

     Performs a media unit exchange operation.  The media unit in
<src ET/EU>
     is  moved  to  <dst1 ET/EU> and the media unit previously in
<dst1 ET/EU> is
     moved to <dst2 ET/EU>.  In the case of  a  simple  exchange,
<dst2 ET/EU> is
     omitted  and the values <src ET/EU> are used in their place.
The optional
     modifiers inv1 and inv2 specify whether the media units  are
to be inverted
  before  insertion into <dst1 ET/EU> and <dst2 ET/EU> respectively.

     Note that not all medium changers support the exchange operation; the
     changer  must have multiple free pickers or emulate multiple
free pickers
     with transient storage.

     # chio position <to ET> <to EU> [inv]

     Position the picker in front of the element described by <to
ET/EU>.  If
     the  optional modifier inv is specified, the media unit will
be inverted
     before insertion.

     Note that not all changers behave as expected in response to
this command.

     # chio params

     Report  the number of slots, drives, pickers, and portals in
the changer,
     and which picker unit the changer is currently configured to

     # chio getpicker

     Report which picker unit the changer is currently configured
to use.

     # chio setpicker <unit>

     Configure the changer to use picker <unit>.

     # chio status [<type>]

     Report the status of all elements in the changer.  If <type>
is specified,
 report the status of all elements of type <type>.

     The status bits are defined as follows:

     FULL    Element contains a media unit.

     IMPEXP  Media was deposited into element by an outside human

     EXCEPT  Element is in an abnormal state.

     ACCESS  Media in this element is accessible by a picker.

     EXENAB  Element supports passing  media  (exporting)  to  an
outside human

     INENAB  Element supports receiving media (importing) from an
outside human

FILES    [Toc]    [Back]

     /dev/ch0  default changer device

EXAMPLES    [Toc]    [Back]

     # chio move slot 3 drive 0

     Moves the media in slot 3 (fourth slot) to  drive  0  (first

     # chio setpicker 2

     Configures  the  changer  to use picker 2 (third picker) for

SEE ALSO    [Toc]    [Back]

     mt(1), ch(4)

AUTHORS    [Toc]    [Back]

     The chio program and SCSI changer driver were written by Jason R. Thorpe
     <thorpej@and.com>        for        And       Communications

OpenBSD     3.6                           April      2,      1996
[ Back ]
 Similar pages
Name OS Title
mc Tru64 SCSI medium changer interface
autochanger HP-UX SCSI interfaces for medium changer device and magnetooptical autochanger surface device
mcutil Tru64 Media changer manipulation utility
mc HP-UX media changer manipulation utility
rndc HP-UX name server control utility
rndc OpenBSD name server control utility
fwcontrol FreeBSD FireWire control utility
ngctl FreeBSD netgraph control utility
kbdcontrol FreeBSD keyboard control and configuration utility
cdcontrol FreeBSD compact disc control utility
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service