管理解説書

vos listvldb

目的

ボリュームの VLDB 項目を表示します。

構文

vos listvldb [-name <volume name or ID>]  [-server <machine name>]  
             [-partition <partition name>]  [-locked]  [-quiet]  [-nosort]  
             [-cell <cell name>]  [-noauth]  [-localauth]  [-verbose]  [-help]
    
vos listvl [-na <volume name or ID>]  [-s <machine name>]
           [-p <partition name>]  [-lock]  [-q]  [-nos]  [-c <cell name>]  
           [-noa]  [-loca]  [-v]  [-h]

構文

vos listvldb コマンドは、指定されたボリュームのボリューム・ロケーション・データベース (VLDB) 項目の情報を書式設定して、表示します。出力は、このコマンドに指定されるオプションの組み合わせによって異なります。以下のように、必要なタイプの VLDB 項目を表示するには、指示どおりにオプションを組み合わせてください。

VLDB のすべての項目を表示する場合には、オプションは指定しないでください。
ボリュームのサイトとして特定のファイル・サーバー・マシンを指定する、すべての VLDB 項目。 -server 引き数にマシン名を指定します。
ボリュームのサイトとして任意のファイル・サーバー・マシンに特定の区画を指定する、すべての VLDB 項目。 -partition 引き数に区画名を指定します。
ボリュームのサイトとして特定のファイル・サーバー・マシンを指定する、すべての VLDB 項目。 -server 引き数と -partition 引き数を組み合わせます。
単一の VLDB 項目。 -name 引き数にボリューム名または ID 番号を指定します。
特定のサイトで検出される、VLDB 項目がロックされているボリュームのみの VLDB 項目。サイトを定義する引き数と -locked フラグを組み合わせます。

オプション

-name

3 つのタイプのいずかのボリュームの完全名またはボリューム ID 番号を指定します。

-server

表示する VLDB 項目にサイトとしてリストされているファイル・サーバー・マシンを指定します。マシンの IP アドレスまたはホスト名 (完全修飾名またはあいまいでない省略形) を指定します。詳細については、vos コマンド・セットの解説ページを参照してください。

この引き数は、-partition 引き数または -locked フラグ (あるいはその両方) と組み合わせて使用することができます。

-partition

表示する VLDB 項目でサイトとしてリストされている区画 (-server 引き数に指定されたファイル・サーバー・マシン上の区画) を指定します。名前の前にスラッシュを付けて完全な区画名を指定するか (たとえば、/vicepa)、または使用可能な 3 つの省略形のいずれかを使用してください。詳細については、vos コマンド・セットの解説ページを参照してください。

この引き数は、-server 引き数または -locked フラグ (あるいはその両方) と組み合わせて使用することができます。

-locked

ロックされた VLDB 項目だけを表示します。このフラグは、-server 引き数または -partition 引き数 (あるいはその両方) と組み合わせて使用することができます。

-quiet

リストされているボリューム数およびその状況を要約する行を抑制します。そうでなければ、複数のボリュームが出力されているときに、その先頭と末尾に出力されます。

-nosort

デフォルトである、ボリューム名によるボリューム項目のアルファベット順のソートを抑止します。

-cell

コマンドを実行するセルを指定します。この引き数は、 -localauth フラグと一緒に使用してはなりません。詳細については、vos の解説ページを参照してください。

-noauth

コマンドの発行側に非特権 ID anonymous を割り当てます。このフラグは -localauth フラグと一緒に使用してはなりません。詳細については、vos の解説ページを参照してください。

-localauth

ローカルの /usr/afs/etc/KeyFile ファイルのキーを使用して、サーバー・チケットを構成します。相互認証の間、vos コマンド・インタープリターは、ボリューム・サーバーおよびボリューム・ロケーション・サーバーに、このチケットを提供します。このフラグは、-cell 引き数、または -noauth フラグと一緒に使用してはなりません。詳細については、vos の解説ページを参照してください。

-verbose

標準出力ストリームに、コマンド実行の詳細なトレースを出力します。この引き数を省略すると、警告およびエラー・メッセージだけが表示されます。

-help

このコマンドのオンライン・ヘルプを出力します。これ以外の有効なオプションはすべて無視されます。

出力

出力に複数の VLDB 項目が含まれている場合、デフォルトで、第 1 行には、ボリュームを含むファイル・サーバー・マシン、区画、またはその両方が報告されます。出力の最終行には、表示されている項目数が報告されます。 -quiet フラグを組み込むと、これらの行を抑制します。

デフォルトでは、ボリュームはボリューム名でアルファベット順にソートされます。 -nosort フラグを組み込むと、ソート・ステップがスキップされます。そのため、項目数が多い場合は、出力の作成が速くなります。

各ボリュームの VLDB 項目には、次の情報が記録されています。

基本 (読み取り / 書き込み) ボリューム名。読み取り専用およびバックアップ・バージョンの名前は同じで、拡張子は、それぞれ .readonly と .backup です。
ボリューム ID 番号は、実際に存在するボリュームのバージョンに割り当てられます。読み取り / 書き込みの場合は RWrite、読み取り専用の場合は ROnly、バックアップの場合は Backup、 ReleaseClone の場合は RClone というフィールドに設定されます。 (フィールドが表示されない場合、対応するバージョンのボリュームは存在しません。) 通常、RClone フィールドが現れると、解放操作が正常終了しなかったことを示します。 Old release および New release フラグは、すぐ後で説明するサイト定義行の 1 行または複数行に表示される場合もよくあります。
ボリュームの読み取り / 書き込みコピーまたは読み取り専用コピーを含むサイト数。文字列 サイト数 -> の後に続きます。
ボリュームの読み取り / 書き込みコピーまたは読み取り専用コピーを含む各サイトの 1 行。ファイル・サーバー・マシン、区画、およびボリュームのタイプ (読み取り / 書き込みの場合は RW、読み取り専用の場合は、RO) を指定します。バックアップ・バージョンが存在する場合、読み取り / 書き込みサイトを共用することができます。複数のフラグが、以下のサイト定義と一緒に表示できます。

Not released
vos addsite コマンドを使用して、読み取り専用サイトを定義して以来、 vos release コマンドが発行されていないことを示します。
Old release
vos release コマンドが正常終了せず、このサイトに以前の廃止されたバージョンのボリュームが残っていることを示します。
New release
vos release コマンドは正常終了しませんでしたが、このサイトは適切な新規バージョンのボリュームを受け取ったことを示します。
VLDB 項目がロックされている場合は、文字列ボリュームは現在ロックされていますとなります。

New release および Old release フラグの詳細な説明については、 vos release コマンドの解説ページを参照してください。

例

次のコマンドは、usr という名前の ABC Corporation ボリュームの VLDB 情報を表示します。このボリュームには、次のように 2 つの読み取り専用の複写サイトがあります。

   % vos listvldb -name usr
   usr
    RWrite: 5360870981   ROnly: 536870982   Backup: 536870983
    number of sites -> 3
       server fs1.abc.com partition /vicepa RO Site
       server fs3.abc.com partition /vicepa RO Site
       server fs2.abc.com partition /vicepb RW Site

次の例は、ファイル・サーバー・マシン fs4.abc.com にある 2 つのボリュームの項目を表示しています。最初の VLDB 項目は現在ロックされています。このマシンをボリューム・サイトに指定する項目は 508 あります。

   % vos listvldb -server fs4.abc.com
   VLDB entries for server fs4.abc.com
       .       .           .        .
       .       .           .        .
   user.smith
    RWrite: 278541326   ROnly: 278541327   Backup: 278542328
    number of sites -> 1
      server fs4.abc.com partition /vicepg RW Site
       Volume is currently LOCKED
      user.terry
       RWrite 354287190   ROnly 354287191   Backup 354287192
       number of sites -> 1
         server fs4.abc.com partition /vicepc RW Site
         .       .           .        .
         .       .           .        .
      Total entries: 508

必要となる特権

なし。

関連情報

[ ページのトップ | 前ページ | 次ページ | 目次 | 索引 ]