# 管理解説書

## vos listvol

目的

ボリューム・ヘッダーの情報を表示します。

構文

    vos listvol -server <machine name>  [-partition <partition name>]
                [-fast]  [-long]  [-quiet]  [-extended]  [-cell <cell name>]
                [-noauth]  [-localauth]  [-verbose]  [-help]

    vos listvo -s <machine name>  [-p <partition name>]  [-f]  [-lon]
               [-q]  [-e]  [-c <cell name>]  [-n]  [-loc]  [-v]  [-h]

構文

vos listvol コマンドは、指定されたボリュームのボリューム・ヘッダーから、ボリューム、ボリューム ID、ボリューム・タイプ、サイズ、サーバーでの状況などの情報を読み取り、書式設定して表示します。実際に表示される内容は、このコマンドに使用する引き数によって異なります。さまざまな数のボリュームに関するボリューム・ヘッダー情報を表示するには、以下に指示されるとおり、コマンドの引き数を組み合わせます。

- ファイル・サーバー・マシンのすべてのボリュームに対して、 -server 引き数にマシン名を指定します。
- 特定のサイトにある、すべてのボリュームに対して、 -server 引き数と -partition 引き数を組み合わせます。

1 つ以上のボリューム・ロケーション・データベース (VLDB) 項目を表示する場合には、vos listvldb コマンドを使用してください。単一ボリュームの VLDB 項目とボリューム・ヘッダーを表示するには、vos examine コマンドを使用します。

オプション

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

  この引き数は、-partition 引き数や、 -fast、-long、または -extended フラグと組み合わせて使用することができます。

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

-fast
  -server 引き数 (場合によっては -partition 引き数も) に指定されたサイトに格納されたボリュームの ID 番号を表示します。このフラグは、-extended フラグと一緒に使用してはなりません。

-long
  -server 引き数 (場合によっては -partition 引き数も) に指定されたサイトに格納されたボリュームについて詳しい情報を表示します。たとえば、ボリュームに関連付けられた 3 つすべてのボリューム・タイプのボリューム ID、および読み取り / 書き込みボリュームの割り当て量、作成日、更新日などの情報が含まれます。

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

-extended
  -server 引き数 (場合によっては -partition 引き数も) に指定されたサイトのボリュームについて、統計情報やアクセス・パターンを表示します。統計情報としては、ボリューム内でのファイルの読み取り読み取り回数または書き込み回数、所有者および他のユーザーがファイルおよびディレクトリーを削除した最新の情報があります。このフラグは、-fast フラグと一緒に使用してはなりません。

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

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

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

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

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

出力

出力は、ボリューム名でアルファベット順に配列され、デフォルトでは、各項目の単一行に以下の情報が表示されます。

- 名前
- ボリューム ID 番号
- タイプ (このフラグは、読み取り / 書き込みの場合は `RW`、読み取り専用の場合は `RO`、バックアップの場合は `BK`)
- サイズ (KB 単位) (`1024` はメガバイトと等しい)
- -extended フラグが指定されている場合は、ボリューム内のファイル数
- ファイル・サーバー・マシン上の状況。これは以下のいずれかです。

  `On-line`
    キャッシュ・マネージャーは、このボリュームに完全にアクセス可能です。

  `Off-line`
    キャッシュ・マネージャーは、このボリュームにアクセスできませんが、ボリュームは破壊されていないようです。この状況は、たとえば、ボリュームのダンプ処理中に現れます。

  `Off-line**needs salvage**`
    キャッシュ・マネージャーは、このボリュームにアクセスできません。ボリュームは破壊されているようです。 bos salvage または salvager コマンドを使用して、破壊を修復します。

次のメッセージが、既にリストされている情報の代わりに表示される場合、クローンが作成されているなどのため、キャッシュ・マネージャーまたは vos コマンド・インタープリターがボリュームにアクセスできないことを示します。

       **** ボリューム volume_ID は使用中です ****

次のメッセージが、既にリストされている情報の代わりに表示される場合、ファイル・サーバーがボリュームに接続できないことを示します。ボリュームがひどく破壊されている可能性があるためです。ファイル・サーバー・マシンの /usr/afs/logs ディレクトリーの FileLog および VolserLog ログ・ファイルは、可能な限り追加情報を提供します。この追加情報を表示するには、bos getlog コマンドを使用します。

       **** ボリューム volume_ID に接続できませんでした ****

個別のボリューム情報は、要約行により大括弧で囲まれます。出力の最初の行にはリストのボリューム数が示されます。出力の最後の行にはオンライン、オフライン、および使用中のボリューム数の合計が表示されます。 -quiet フラグを使用した場合には、これらの行は表示されません。

-fast フラグを追加すると、各ボリュームのボリューム ID 番号だけが昇順で表示されます。最終行 (オンライン、オフライン、使用中のボリューム数の合計が表示) は省略されます。

-long フラグを組み込むと、各ボリュームの出力に、デフォルトのリスト表示のすべての情報と以下の情報が含まれます。このリストの各項目は、以下のように、出力の別の行と対応します。

- VLDB またはボリューム・ヘッダーから派生するのではなく、コマンド実行と同様にコマンド・インタープリターにより判別される、ボリュームを含むファイル・サーバー・マシンおよび区画。
- 以下の各種バージョンのボリュームに関連するボリューム ID 番号。読み取り / 書き込み (`RWrite`)、読み取り専用 (`ROnly`)、バックアップ (`Backup`)、および ReleaseClone (`RClone`)。これらのボリューム ID のいずれかが、ボリュームの出力の第 1 行に表示されるボリューム ID 番号と一致します。 `RWrite`、`ROnly`、または `Backup` フィールドが `0` (ゼロ) である場合、該当するタイプのボリュームはありません。現在、ReleaseClone がない場合は、`RClone` フィールドは全く表示されません。
- ボリュームの読み取り / 書き込みコピーに割り当てられた最大割り当て量は、`MaxQuota` フィールドに KB ブロック単位で表示されます。
- `Creation` フィールドのボリュームが作成された日時。ボリュームが backup diskrestore、 backup volrestore、vos restore コマンドで復元されていると、これは復元時刻を表します。
- `Last Update` フィールドのボリュームの内容が最後に変更された日時。読み取り専用およびバックアップ・ボリュームの場合、 `Creation` フィールドのタイム・スタンプと一致します。
- 次の 2 つの時刻のうち遅い時刻以降の、取り出しまたは保管操作の場合のボリュームに対するアクセス回数です。
  - コマンドが発行された日の 午前 12 時 00 分
  - ボリュームのロケーションが最後に変更された時刻

-extended フラグを組み込むと、各ボリュームの出力に、-long フラグと 2 つの統計表で報告されるすべての情報が含まれます。

- `未加工の読み取り / 書き込み状況` 表というラベルの付いた表により、読み取りまたは書き込みのためにアクセスされたボリュームの回数を要約します。
- `Writes Affecting Authorship` 表には、指定されたボリュームのファイルおよびディレクトリーに対して実行された、書き込み操作についての情報が表示されます。

例

次の例は、フラグが指定されていない場合、ファイル・サーバー・マシン fs2.abc.com 上の /vicepb 区画の出力を示しています。

       % vos listvol -server fs2.abc.com -partition b
       Total number of volumes on server fs2.abc.com   \
                                           partition /vicepb : 66
       sys                  1969534847 RW       1582 K On-line
       sys.backup           1969535105 BK       1582 K On-line
             .                   .     .         .   .    .
             .                   .     .         .   .    .
       user.pat             1969534536 RW      17518 K On-line
       user.pat.backup      1969534538 BK      17537 K On-line
       Total volumes onLine 66 ; Total volumes offLine 0 ;  Total busy 0

次の例は、-fast フラグを追加した場合の出力例です。

       % vos listvol -server fs2.abc.com -partition b -fast
       Total number of volumes on server fs2.abc.com   \
                                           partition /vicepb : 66
        1969516782
        1969516784
            .
            .
        1969535796

次の例は、-long フラグによって 2 つのボリュームが表示された例を表しています。

       % vos listvol -server fs2.abc.com -partition b -long
       Total number of volumes on server fs2.abc.com \
                                           partition /vicepb: 66
             .                   .      .         .   .    .
             .                   .      .         .   .    .
       user.pat             1969534536 RW      17518 K On-line
            fs2.abc.com /vicepb
            RWrite 1969534536 ROnly 0        Backup 1969534538
            MaxQuota      20000 K
            Creation    Mon Jun 12 09:02:25 1989
            Last Update Thu May 20 17:39:34 1999
            1573 accesses in the past day (i.e., vnode references)
       user.pat.backup      1969534538 BK      17537 K On-line
            fs2.abc.com /vicepb
            RWrite 1969534536 ROnly 0        Backup 1969534538
            MaxQuota      20000 K
            Creation    Tue Jun 13 04:37:59 1989
            Last Update Wed May 19 06:37:59 1999
            0 accesses in the past day (i.e., vnode references)
              .                   .      .         .   .    .
              .                   .      .         .   .    .
       Total volumes onLine 66 ; Total volumes offLine 0 ; \
                                                    Total busy 0

必要となる特権

なし。

関連情報

backup diskrestore

backup volrestore

bos getlog

bos salvage

salvager

vos

vos examine

vos listvldb

vos restore

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

(C) IBM Corporation 2000. All Rights Reserved