312 lines
8.3 KiB
Groff
312 lines
8.3 KiB
Groff
.\" %NetBSD: chio.1,v 1.4 1997/10/02 00:41:25 hubertf Exp %
|
|
.\"
|
|
.\" Copyright (c) 1996 Jason R. Thorpe <thorpej@and.com>
|
|
.\" 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.
|
|
.\"
|
|
.\" %FreeBSD: src/bin/chio/chio.1,v 1.23 2003/03/24 16:08:13 charnier Exp %
|
|
.\"
|
|
.\" $FreeBSD$
|
|
.Dd May 14, 1998
|
|
.Dt CHIO 1
|
|
.Os
|
|
.Sh 名称
|
|
.Nm chio
|
|
.Nd メディアチェンジャ制御ユーティリティ
|
|
.Sh 書式
|
|
.Nm chio
|
|
.Op Fl f Ar changer
|
|
.Ar command
|
|
.Op Fl <flags>
|
|
.Ar arg1
|
|
.Ar arg2
|
|
.Op Ar arg3 Op ...
|
|
.Sh 解説
|
|
.Nm
|
|
ユーティリティは、テープや光ディスクなどのジュークボックスに見られるような
|
|
メディアチェンジャの動作を制御するために使われます。
|
|
.Pp
|
|
オプションには以下のものがあります:
|
|
.Bl -tag -width indent
|
|
.It Fl f Ar changer
|
|
デフォルトの
|
|
.Pa /dev/ch0
|
|
デバイスのかわりに
|
|
.Ar changer
|
|
を使用します。
|
|
.El
|
|
.Pp
|
|
環境変数
|
|
.Ev CHANGER
|
|
にデバイス名をセットしておくと、
|
|
それをデフォルトのチェンジャとして使用することができます。
|
|
.Pp
|
|
メディアチェンジャ装置は複数の
|
|
.Em element
|
|
から成り立っています。
|
|
element には 5 種類あり、それぞれ
|
|
.Em picker
|
|
(メディア搬送)、
|
|
.Em slot
|
|
(保管)、
|
|
.Em portal
|
|
(出し入れ)、
|
|
.Em drive
|
|
(データ転送)、
|
|
.Em voltag
|
|
(ボリューム識別子の選択)
|
|
です。
|
|
.Em voltag
|
|
擬似 element タイプは、ボリュームタグ
|
|
(典型的にはテープ上のバーコード) によるテープの選択を可能にします
|
|
.Pp
|
|
このコマンドの解説では省略形
|
|
.Em ET
|
|
で element の種類を表し、
|
|
.Em EU
|
|
で element の装置番号を表します。
|
|
たとえば、チェンジャ内の一つめのロボットアームを表現する場合には、
|
|
.Em ET
|
|
は
|
|
.Dq picker
|
|
となり、
|
|
.Em EU
|
|
は
|
|
.Dq 0
|
|
となります。
|
|
.Sh サポートされるコマンド
|
|
.Bl -tag -width indent
|
|
.It Ic move Xo
|
|
.Ar <from ET> <from EU> <to ET> <to EU>
|
|
.Op Cm inv
|
|
.Xc
|
|
メディアユニットを
|
|
.Ar <from ET/EU>
|
|
から
|
|
.Ar <to ET/EU>
|
|
へと移動します。
|
|
オプションの修飾子
|
|
.Cm inv
|
|
が指定された場合は、挿入前にメディアユニットが裏返されます。
|
|
.It Ic exchange Xo
|
|
.Ar <src ET> <src EU> <dst1 ET> <dst1 EU>
|
|
.Op Ar <dst2 ET> <dst2 ET>
|
|
.Op Cm inv1
|
|
.Op Cm inv2
|
|
.Xc
|
|
メディアユニットの交換作業をおこないます。
|
|
.Ar <src ET/EU>
|
|
にあるメディアユニットは
|
|
.Ar <dst1 ET/EU>
|
|
に移され、以前に
|
|
.Ar <dst1 ET/EU>
|
|
にあったメディアユニットは
|
|
.Ar <dst2 ET/EU>
|
|
に移されます。
|
|
単純に交換する場合には、
|
|
.Ar <dst2 ET/EU>
|
|
を省略すると
|
|
.Ar <src ET/EU>
|
|
が代りに使われます。
|
|
オプションの修飾子
|
|
.Cm inv1
|
|
や
|
|
.Cm inv2
|
|
が指定された場合には、それぞれ
|
|
.Ar <dst1 ET/EU>
|
|
や
|
|
.Ar <dst2 ET/EU>
|
|
への挿入前にメディアユニットが裏返されます。
|
|
.Pp
|
|
すべてのメディアチェンジャが
|
|
.Ic exchange
|
|
操作をサポートしているわけではないことに注意してください。
|
|
exchange 操作のためには、チェンジャが複数の空き picker を持っているか、
|
|
一時的な保管場所を用いて複数の空き picker をエミュレートする必要があります。
|
|
.Pp
|
|
.It Ic return Xo
|
|
.Ar <from ET> <from EU>
|
|
.Xc
|
|
メディアユニットを、元の element へ返します。
|
|
このコマンドは、指定したメディアユニットの状態を問い合わせ、
|
|
そのソース属性に記述されている element へとメディアユニットを移動します。
|
|
この方法は、
|
|
ドライブやポータルからチェンジャ内の元の element へメディアを戻すのに
|
|
便利です。
|
|
.Pp
|
|
.It Ic position Xo
|
|
.Ar <to ET> <to EU>
|
|
.Op Cm inv
|
|
.Xc
|
|
picker を
|
|
.Ar <to ET/EU>
|
|
で指定した element の前に配置します。
|
|
もしオプションの修飾子
|
|
.Cm inv
|
|
が指定された場合は、挿入前にメディアユニットが裏返されます。
|
|
.Pp
|
|
このコマンドを発行しても、すべてのチェンジャが期待通りの動作をするとは
|
|
限らないことに注意してください。
|
|
.It Ic params
|
|
チェンジャ内の slot, drive, picker, portal の数と、
|
|
現在どの picker が使用可能になっているかを報告します。
|
|
.It Ic getpicker
|
|
.Pp
|
|
現在どの picker が使用可能になっているかを報告します。
|
|
.It Xo Nm setpicker
|
|
.Ar <unit>
|
|
.Xc
|
|
.Pa <unit>
|
|
番の picker を使用可能にします。
|
|
.Pp
|
|
.It Ic ielem Xo
|
|
.Op Ar <timeout>
|
|
.Xc
|
|
チェンジャに対して
|
|
.Em element の状態の初期化 (INITIALIZE ELEMENT STATUS)
|
|
の操作を行います。
|
|
オプションとして
|
|
.Ar <timeout>
|
|
パラメータを指定して、操作がタイムアウトする秒数を指定可能です。
|
|
ファームウェアのバグなどのために、
|
|
操作に異常に長い時間がかかる場合に使用できます。
|
|
.It Ic voltag Xo
|
|
.Op Fl fca
|
|
.Ar <ET>
|
|
.Ar <EU>
|
|
.Op Ar <label>
|
|
.Op Ar <serial>
|
|
.Xc
|
|
メディアチェンジャ内の element に対するボリュームタグを変更します。
|
|
少数のメディアチェンジャのみ、本コマンドをサポートします。
|
|
デバイスがサポートしていない場合に本コマンドを使用すると、
|
|
通常、コンソールに "Invalid Field in CDB" というエラーが表示されます。
|
|
.Pp
|
|
.Fl c
|
|
フラグを指定すると、指定した element のボリュームタグをクリアします。
|
|
.Fl f
|
|
フラグを指定すると、
|
|
element に対して既にボリュームタグが定義されていたとしても、
|
|
指定したボリュームタグでボリュームタグを置き換えます。
|
|
ボリュームタグ情報が既に定義されている element に対し、
|
|
.Fl f
|
|
フラグを指定せずにラベルを設定しようとすると、エラーとなります。
|
|
.Pp
|
|
本コマンドはプライマリボリュームタグに対して作用しますが、
|
|
.Fl a
|
|
フラグを指定すると、代替ボリュームタグに対して作用します。
|
|
.It Ic status Xo
|
|
.Op Fl vVsSbIa
|
|
.Op Ar <type>
|
|
.Xc
|
|
チェンジャ内のすべての element の状態を報告します。もし
|
|
.Ar <type>
|
|
が指定されていると、
|
|
.Ar <type>
|
|
型の elememt の状態を報告します。
|
|
.It Fl v
|
|
ロードされている各メディアに対し、
|
|
存在すればプライマリボリュームタグを表示します。
|
|
ボリュームタグは
|
|
.Dq <LABEL:SERIAL>
|
|
のように表示されます。
|
|
.It Fl V
|
|
存在すれば代替ボリュームタグを表示します。
|
|
.It Fl s
|
|
各 element に対し、追加のセンスコードと、追加のセンスコード修飾子を
|
|
表示します。
|
|
.It Fl S
|
|
各 element に対し、element のソースアドレスを表示します。
|
|
.It Fl b
|
|
各 element に対し、SCSI バス情報を表示します。
|
|
この情報は、ドライブに対してのみ有効です。
|
|
.It Fl I
|
|
各 element に対し、内部 element アドレスを表示します。
|
|
通常、本ドライバは内部 element アドレスを使用しません。
|
|
診断目的でのみ、表示を行います。
|
|
.It Fl a
|
|
すべての追加情報を表示します (
|
|
.Fl vVsSba
|
|
を指定したのと同じ)。
|
|
.El
|
|
.Pp
|
|
ステータスビットは以下のように定義されています:
|
|
.Bl -tag -width indent
|
|
.It FULL
|
|
element にメディアユニットが入っています。
|
|
.It IMPEXP
|
|
外部の人間の操作により element にメディアが挿入されました。
|
|
.It EXCEPT
|
|
element が異常な状態になっています。
|
|
.It ACCESS
|
|
この element 内のメディアは picker でアクセス可能です。
|
|
.It EXENAB
|
|
element は外部の人間の操作によるメディアの取り出しが可能です。
|
|
.It INENAB
|
|
element は外部の人間の操作によるメディアの挿入が可能です。
|
|
.El
|
|
.Sh 使用例
|
|
.Bl -tag -width indent
|
|
.It Li chio move slot 3 drive 0
|
|
スロット 3 (4 番目のスロット) のメディアをドライブ 0 (1 番目のドライブ) に
|
|
移動させます。
|
|
.It Li chio move voltag VOLUME01 drive 0
|
|
バーコード VOLUME01 を持つメディアをドライブ 0 (最初のドライブ) に
|
|
移動させます。
|
|
.It Li chio return drive 0
|
|
テープをドライブ 0 (最初のドライブ) から取り除き、
|
|
これをラックの元の場所へ返します。
|
|
.It Li chio setpicker 2
|
|
チェンジャが picker 2 (3 番目の picker) を作業に使用するように設定します。
|
|
.El
|
|
.Sh 関連ファイル
|
|
.Bl -tag -width /dev/ch0 -compact
|
|
.It Pa /dev/ch0
|
|
デフォルトのチェンジャデバイス
|
|
.El
|
|
.Sh 関連項目
|
|
.Xr mt 1 ,
|
|
.Xr mount 8
|
|
.Sh 作者
|
|
.An -nosplit
|
|
.Nm
|
|
プログラムと SCSI チェンジャドライバは
|
|
And Communications 社
|
|
.Pa http://www.and.com/
|
|
の
|
|
.An Jason R. Thorpe Aq thorpej@and.com
|
|
によって書かれました。
|
|
.Pp
|
|
さらに
|
|
.An Hans Huebner
|
|
.Aq hans@artcom.de
|
|
と
|
|
.An Steve Gunn
|
|
.Aq csg@waterspout.com
|
|
が作業を行いました。
|