目的
磁気テープのラベルを読み取り、表示します。
構文
backup readlabel [-portoffset <TC port offset>] [-localauth] [-cell <cell name>] [-help] backup rea [-p <TC port offset>] [-l] [-c <cell name>] [-h]
構文
backup readlabel コマンドは、磁気テープの磁気テープ・ラベルの情報を表示します。磁気テープの名前 (永続名、または磁気テープの内容を表す AFS 磁気テープ名 が特定の形式で書き込まれます) とその容量などを表示します。
指定されたポート・オフセットの /usr/afs/backup/CFG_device_name ファイルに FILE YES 命令がある場合、 backup readlabel コマンドは、磁気テープの先頭ではなく、テープ・コーディネーターの /usr/afs/backup/tapeconfig ファイルのポート・オフセットにリストされているバックアップ・データ・ファイルの最初の 16 KB からラベル情報を読み取ります。
このコマンドを実行すると、デフォルトでは、テープ・コーディネーターは、ローカルの /usr/afs/backup/CFG_device_name ファイルの MOUNT 命令を呼び出して、最初の磁気テープにアクセスします。MOUNT 命令がない場合には、磁気テープの挿入をバックアップ操作員に要求します。ただし、 CFG_device_name ファイルに AUTOQUERY NO 命令があるか、あるいは butc コマンドが -noautoquery フラグ付きで発行されている場合には、テープ・コーディネーターは、磁気テープがすでに装置に挿入されているとみなします。そうでない場合、テープ・コーディネーターは MOUNT 命令を呼び出すか、操作員にプロンプトを出します。
オプション
出力
このコマンドの出力は、コマンドが発行されたシェル・ウィンドウと [テープ・コーディネーター] ウィンドウに表示されます。
磁気テープにラベルが付いていないか、指定された磁気テープ装置が空の場合には、次のような出力が表示されます。
Failed to read tape label.
そうでない場合には、シェル・ウィンドウに次の出力が表示されます。
Tape read was labelled: tape name (dump id) size: size Kbytes
磁気テープに永続名がある場合には tape name に永続名が、そうでない場合には AFS 磁気テープ名が表示されます。 dump ID には、磁気テープにある初期ダンプのダンプ ID が、 size には記録されている磁気テープの容量が キロバイトで表示されます。
[テープ・コーディネーター] ウィンドウでは、下線で囲まれた Tape label という見出しが上部に表示され、下部には次の文字列が表示されます。
-- End of tape label --
この間に、次の情報が表示されます。
出力が完了すると、ReadLabel: 完了 というメッセージが表示されます。
例
次の例は、永続名 が oct.guest.dump 容量が 2 MB の磁気テープの出力例です。容量は KB 単位で出力されています (2097152 = 2 x 10242)。
% backup readlabel -portoffset 6 Tape read was labelled: oct.guest.dump (907215000) size: 2097152 Kbytes
[テープ・コーディネーター] ウィンドウの出力は、次のようになります。
Tape label ---------- tape name = oct.guest.dump AFS tape name = guests.monthly.3 creationTime = Thu Oct 1 00:10:00 1998 cell = abc.com size = 2097152 Kbytes dump path = /monthly dump id = 907215000 useCount = 5 ---- End of tape label ----
永続名のない磁気テープの場合は、次のようになります。
% backup readlabel -portoffset 6 Tape read was labelled: guests.monthly.2 (909899900) size: 2097152 Kbytes
[テープ・コーディネーター] ウィンドウの出力は、次のようになります。
Tape label ---------- tape name = <NULL> AFS tape name = guests.monthly.2 creationTime = Sun Nov 1 00:58:20 1998 cell = abc.com size = 2097152 Kbytes dump path = /monthly dump id = 909899900 useCount = 1 ---- End of tape label ----
必要となる特権
コマンドの発行者は、バックアップ・サーバーが実行されているすべてのマシン上の /usr/afs/etc/UserList ファイルにリストされていなければなりません。また、-localauth フラグを使用する場合は、ローカル・スーパーユーザー root としてサーバー・マシンにログオンする必要があります。
関連情報