# 管理解説書

## 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 という名前の Example Corporation ボリュームの VLDB 情報を表示します。このボリュームには、次のように 2 つの読み取り専用の複写サイトがあります。

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

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

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

必要となる特権

なし。

関連情報

vos

vos examine

vos listvol

vos lock

vos unlock

vos unlockvldb

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

(C) IBM Corporation 2000. All Rights Reserved