From 22817fb6a16c5bff9c668d25b4bdc66c40524051 Mon Sep 17 00:00:00 2001 From: joerg Date: Thu, 6 Mar 1997 15:30:06 +0000 Subject: Import Jason Thorpe's contribution for an updated SCSI media changer device (now, finally!). --- bin/chio/chio.1 | 202 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 202 insertions(+) create mode 100644 bin/chio/chio.1 (limited to 'bin/chio/chio.1') diff --git a/bin/chio/chio.1 b/bin/chio/chio.1 new file mode 100644 index 0000000..22696f4 --- /dev/null +++ b/bin/chio/chio.1 @@ -0,0 +1,202 @@ +.\" $NetBSD: $ +.\" +.\" Copyright (c) 1996 Jason R. Thorpe +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" 3. All advertising materials mentioning features or use of this software +.\" must display the following acknowledgements: +.\" This product includes software developed by Jason R. Thorpe +.\" for And Communications, http://www.and.com/ +.\" 4. The name of the author may not be used to endorse or promote products +.\" derived from this software without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR +.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES +.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. +.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, +.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, +.\" BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; +.\" LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED +.\" AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, +.\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.Dd April 2, 1996 +.Dt CHIO 1 +.Os +.Sh NAME +.Nm chio +.Nd medium changer control utility +.Sh SYNOPSIS +.Nm chio +.Op Fl f Ar changer +.Ar command +.Ar arg1 +.Ar arg2 +.Oo +.Ar arg3 Oo ... +.Oc +.Oc +.Sh DESCRIPTION +.Nm Chio +is used to control the operation of medium changers, such as those found +in tape and optical disk jukeboxes. +.Pp +The options are as follows: +.Bl -tag -width indent +.It Fl f Ar changer +Use the device +.Pa changer +rather than the default device +.Pa /dev/ch0 . +.El +.Pp +The default changer may be overridden by setting the environment variable +.Nm CHANGER +to the desired changer device. +.Pp +A medium changer apparatus is made up of +.Pa elements . +There are four element types: +.Pa picker +(medium transport), +.Pa slot +(storage), +.Pa portal +(import/export), and +.Pa drive +(data transfer). In this command description, the shorthand +.Nm ET +will be used to represent an element type, and +.Nm 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 +and the EU would be +.Dq 0 . +.Pp +.Sh SUPPORTED COMMANDS +.Nm chio move +.Ar +.Op Ar inv +.Pp +Moves the media unit from +.Pa +to +.Pa . +If the optional modifier +.Pa inv +is specified, the media unit will be inverted before insertion. +.Pp +.Nm chio exchange +.Ar +.Op Ar +.Op Ar inv1 +.Op Ar inv2 +.Pp +Performs a media unit exchange operation. The media unit in +.Pa +is moved to +.Pa +and the media unit previously in +.Pa +is moved to +.Pa . +In the case of a simple exchange, +.Pa +is omitted and the values +.Pa +are used in their place. +The optional modifiers +.Pa inv1 +and +.Pa inv2 +specify whether the media units are to be inverted before insertion into +.Pa +and +.Pa +respecitively. +.Pp +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 +.Ar +.Op Ar inv +.Pp +Position the picker in front of the element described by +.Pa . +If the optional modifier +.Pa inv +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 +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 +Report which picker unit the changer is currently configured to use. +.Pp +.Nm chio setpicker +.Ar +.Pp +Configure the changer to use picker +.Pa . +.Pp +.Nm chio status +.Op Ar +.Pp +Report the status of all elements in the changer. If +.Pa +is specified, report the status of all elements of type +.Pa . +.Pp +The status bits are defined as follows: +.Bl -tag -width indent +.It Nm FULL +Element contains a media unit. +.It Nm IMPEXP +Media was deposited into element by an outside human operator. +.It Nm EXCEPT +Element is in an abnormal state. +.It Nm ACCESS +Media in this element is accessible by a picker. +.It Nm EXENAB +Element supports passing media (exporting) to an outsite human operator. +.It Nm 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 +.Sh FILES +/dev/ch0 - default changer device +.Sh SEE ALSO +.Xr mt 1 , +.Xr mount 8 . +.Sh AUTHOR +The +.Nm chio +program and SCSI changer driver were written by Jason R. Thorpe + for And Communications, http://www.and.com/ -- cgit v1.1