1 .\" $NetBSD: chio.1,v 1.4 1997/10/02 00:41:25 hubertf Exp $
3 .\" Copyright (c) 1996 Jason R. Thorpe <thorpej@and.com>
4 .\" All rights reserved.
6 .\" Redistribution and use in source and binary forms, with or without
7 .\" modification, are permitted provided that the following conditions
9 .\" 1. Redistributions of source code must retain the above copyright
10 .\" notice, this list of conditions and the following disclaimer.
11 .\" 2. Redistributions in binary form must reproduce the above copyright
12 .\" notice, this list of conditions and the following disclaimer in the
13 .\" documentation and/or other materials provided with the distribution.
14 .\" 3. All advertising materials mentioning features or use of this software
15 .\" must display the following acknowledgements:
16 .\" This product includes software developed by Jason R. Thorpe
17 .\" for And Communications, http://www.and.com/
18 .\" 4. The name of the author may not be used to endorse or promote products
19 .\" derived from this software without specific prior written permission.
21 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
22 .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
23 .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
24 .\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
25 .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
26 .\" BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
27 .\" LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
28 .\" AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
29 .\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
30 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
40 .Nd medium changer control utility
54 is used to control the operation of medium changers, such as those found
55 in tape and optical disk jukeboxes.
57 The options are as follows:
58 .Bl -tag -width indent
62 rather than the default device
66 The default changer may be overridden by setting the environment variable
68 to the desired changer device.
70 A medium changer apparatus is made up of
72 There are four element types:
80 (data transfer). In this command description, the shorthand
82 will be used to represent an element type, and
84 will be used to represent an element unit. For example, to represent
85 the first robotic arm in the changer, the
94 .Sh SUPPORTED COMMANDS
95 .Bl -tag -width indent
97 .Ar <from ET> <from EU> <to ET> <to EU>
100 Move the media unit from
104 If the optional modifier
106 is specified, the media unit will be inverted before insertion.
108 .Ar <src ET> <src EU> <dst1 ET> <dst1 EU>
109 .Op Ar <dst2 ET> <dst2 ET>
113 Perform a media unit exchange operation. The media unit in
117 and the media unit previously in
121 In the case of a simple exchange,
123 is omitted and the values
125 are used in their place.
126 The optional modifiers
130 specify whether the media units are to be inverted before insertion into
136 Note that not all medium changers support the
138 operation; the changer must have multiple free pickers or emulate
139 multiple free pickers with transient storage.
144 Position the picker in front of the element described by
146 If the optional modifier
148 is specified, the media unit will be inverted before insertion.
150 Note that not all changers behave as expected when issued this command.
152 Report the number of slots, drives, pickers, and portals in the changer,
153 and which picker unit the changer is currently configured to use.
155 Report which picker unit the changer is currently configured to use.
159 Configure the changer to use picker
165 Perform an \fBINITIALIZE ELEMENT STATUS\fR
166 operation on the changer. The optional
168 parameter may be given to specify a timeout in seconds for the
169 operations. This may be used if the operation takes unusually long
170 because of buggy firmware or the like.
178 Change volume tag for an element in the media changer. This command
179 is only supported by few media changers. If it is not supported by a
180 device, using this command will usually result in a "Invalid Field in
181 CDB" error message on the console.
185 flag is specified, the volume tag of the specified element is
188 flag is specified, the volume tag is superseded with the specified
189 volume tag even if a volume tag is already defined for the element.
190 It is an error to not specify the
192 flag when trying to set a label for an element which already has
193 volume tag information defined.
195 The command works with the primary volume tag or, if the
197 flag is given, with the alternate volume tag.
202 Report the status of all elements in the changer. If
204 is specified, report the status of all elements of type
207 Print the primary volume tag for each loaded medium, if any. The volume
208 tag is printed as \fB<LABEL:SERIAL>\fR.
210 Print the alternate volume tag for each loaded medium, if any.
212 Print the additional sense code and additional sense code qualifier for
215 Print the element source address for each element.
217 Print SCSI bus information for each element. Note that this information
218 is valid only for drives.
220 Print the internal element addresses for each element. The internal
221 element address is not normally used with this driver. It is reported
222 for diagnostic purposes only.
224 Print all additional information (as in
229 The status bits are defined as follows:
230 .Bl -tag -width indent
232 Element contains a media unit.
234 Media was deposited into element by an outside human operator.
236 Element is in an abnormal state.
238 Media in this element is accessible by a picker.
240 Element supports passing media (exporting) to an outside human operator.
242 Element supports receiving media (importing) from an outside human operator.
246 .Bl -tag -width indent
247 .It Nm chio move slot 3 drive 0
248 Move the media in slot 3 (fourth slot) to drive 0 (first drive).
249 .It Nm chio setpicker 2
250 Configure the changer to use picker 2 (third picker) for operations.
253 .Bl -tag -width /dev/ch0 -compact
255 default changer device
263 program and SCSI changer driver were written by
264 .An Jason R. Thorpe Aq thorpej@and.com
265 for And Communications, http://www.and.com/.
268 .An Hans Huebner Aq hans@artcom.de