Helix Core P4コマンドリファレンス (2019.1)

p4 verify

Helixサーバアーカイブ(ディポファイル)の整合性(破損がなく完全な状態かどうか)を検証します。

構文

p4 [g-opts] verify [-u | -v | -z] [-m max -q -s -X -b batchsize] FileSpec[revRange] ...
p4 [g-opts] verify -t [-U | -A ][-z -m max -q -s -X -b batchsize] FileSpec[revRange] ...
p4 [g-opts] verify -S [-t -m max -q -X -b batchsize] FileSpec...
p4 [g-opts] verify -U [-u | -v | -z] [-m max -q -s -X -b batchsize] unloadFileSpec ...
p4 [g-opts] verify -A [-u | -v | -z] [-m max -q -s -X -b batchsize] archiveFileSpec ...

説明

p4 verifyは指定されたディポファイルのリビジョンごとに、リビジョン固有の情報と、リビジョンの内容のMD5ダイジェスト(フィンガープリント)をレポートします。

検証プロセスには、ディポファイル(ディポアーカイブファイルとも呼ばれます)を開き、ディポファイルを読み取り、ディポファイルのダイジェストが予期された値と一致しているかどうかを検証する処理が含まれます。

ファイルを開けない場合、p4 verifyはMISSINGとレポートします。
ファイルを開けるが、予期された内容が含まれていない場合、p4 verifyはBADとレポートします。

引数を指定しない場合、p4 verifyは各リビジョンのMD5ダイジェストを計算して表示します。

構文バリアントには次の選択肢があります。

指定したファイルリビジョンのセットを検証する。
指定した保留状態のファイルリビジョンのセットを検証する。
アンロードディポ内のファイルリビジョンを検証する。
アーカイブディポ内のファイルリビジョンを検証する。 (アクセス頻度の低いファイルのアーカイブディポの詳細は、『Helix Coreサーバ管理者ガイド: 基本』の「ファイルのアーカイブによりディスク容量を再生する」を参照してください。)

ディポファイルの整合性を定期的に検証することをお勧めします。詳細は、「Helix Coreサーバ管理者ガイド: 基本」で「p4 verify」を検索してください。

保留中のファイルを検証する

保留状態のファイルを検証すると、保留状態のアーカイブの損失または破損が起きたかどうかを確認できます。

保留状態のアーカイブが特定のエッジサーバに対してローカルである場合は、保留状態のアーカイブが作成されたエッジサーバでp4 verify -Sコマンドを発行する必要があります。保留状態のアーカイブが昇格した場合は、コミットサーバでp4 verify -Sを実行します。

また、保留状態のアーカイブが欠落しているか正しくない場合に、その再転送を要求するには、レプリカに対してp4 verify -S -tコマンドを実行します。保留状態のアーカイブをマスターから再転送するには、そのアーカイブがマスター上にある必要があります。つまり、保留状態のアーカイブが当初はマスターで作成されたものである場合、またはエッジサーバから昇格されたものである場合にのみ、再転送できます。

アーカイブされたファイルを検証する

アーカイブされたファイルを検証すると、アーカイブされたファイルが破損しているかどうかを確認できます。 p4 restoreコマンドを使用してファイルを復元する前に、次のようなコマンドを実行することをお勧めします。

$ p4 verify -A //archive/depot/mysource/...

注意

p4 verifyがエラーを返したときは、Perforceのテクニカルサポートにご連絡ください。

オプション

`-A archivefiles`	アーカイブディポ内のファイルは経年破損する可能性があります。このオプションでは、`p4 restore`コマンドを使用して破損ファイルを復元する前にファイルを検証できます。 archivefilesには、検証対象のファイル、ファイルのリスト、または一連のファイルを指定します。以下に例を示します。 //archive/depot/..../source
`-b batchsize`	デフォルトでは、`p4 verify`は一度に10,000個のファイルをバッチで処理します。「`-b batchsize`」オプションを指定すると、バッチサイズを変更することができます。「batchsize」には、整数を指定します。バッチによる処理を無効にするには、`-b 0`を指定します。 `-z`オプションが指定されている場合、`-b`オプションは無視され、すべてのオプションが1つのバッチで処理されます。
`-m max`	`p4 verify`の対象となるリビジョン数を`max`に制限します。このオプションと`-u`オプションを同時に指定すると、`p4 verify`コマンドが呼び出されるたびに、上限が設定されたリビジョンのダイジェストが計算され、保存されます。ヒント p4 verify -m 10 FileSpecを実行すると、FileSpecに応じて、10個のファイル、単一ファイルの10個のバージョン、またはファイルとファイルバージョンが組み合わされて一覧表示されます。
`-q`	非通知で実行され、ダイジェストが一致しない場合、またはリビジョンを再生成できない場合にのみ、エラーをレポートします。
`-s`	ファイルサイズとダイジェストを検証します。 `-v`は`-s`オプションを意味します。
`-S`	保留状態のファイルを検証します。このオプションを指定する場合、唯一有効なリビジョン指定子は`@=change`であり、保留状態のファイルを1つ指定します。保留状態のファイルの特定のセットのみを検証するには、ファイルパターンを使用します。分散インストール環境では、保留状態のファイルが作成されたエッジサーバでこのコマンドを実行する必要があります。保留状態のファイルが昇格した場合は、このコマンドをコミットサーバで実行することもできます。
`-t`	レプリカに対して使用する場合のみ: `p4 verify -t`を実行すると、レプリカで、破損または損失したリビジョンの内容の転送がスケジュールされます。 (このオプションは、`lbr.replication=cache`によるレプリカに対しても機能します。) `-t`オプションは`-v`オプションまたは`-u`オプションと使用することはできません。複製された環境では、`p4 verify -t`により`BAD!` または`MISSING!` のファイルが行末に`(transfer scheduled)`を付けて報告されます。
`-u`	ファイルサイズとダイジェストが保存されたことがない場合に、各ファイルのファイルサイズとMD5ダイジェストをHelixサーバデータベースに保存します。その後`p4 verify`を使用すると、p4 verifyで計算した値と保存済みの値とを比較します。
`-U unloadfile`	アンロードディポ内のファイルを検証します。詳細については、`p4 unload`を参照してください。
`-v`	各ファイルのMD5ダイジェストをHelixサーバデータベースに保存します。該当ファイルのダイジェストが既に保存されている場合でも、その既存ダイジェストを上書きします。 (`-v`オプションは、Helixサーバシステム管理者によってHelixサーバの制御範囲外で故意に変更されたアーカイブファイルの保存済みダイジェストを更新する目的でのみ使用されます。) `-v`オプションと`-u`オプションを同時に使用することはできません。
`-X`	ファイルタイプが`+X`のファイルはスキップされます(サービスはこのファイルに対して`archive`トリガを実行します)。
`-z`	現在のパスで既に計算済みであるリビジョンをスキップして、パフォーマンスを最適化します。このオプションを指定すると、遅延コピーで生成されたファイルの検証が高速化されます。結果の出力では、遅延コピーのリビジョンが、共通のアーカイブファイルにアクセスするためのソート順で最初に出現するリビジョンである場合、そのリビジョンがレポートされることがあります。このオプションは、`-v`または`-u`オプションと同時に使用できません。
`g-opts`	詳細については、「グローバルオプション」を参照してください。

使用上の留意点

ファイル引数にリビジョン指定子を使えるか？	ファイル引数にリビジョン範囲を使えるか？	最低限必要なアクセスレベル
使用可	使用可	`admin`

例

`p4 verify -S //depot/main/p4/...`	指定したパスと一致するすべての保留状態ファイルを検証します。
`p4 verify -q -S //...@=1023548`	保留状態1023548内の保留状態ファイルのみを検証します。
`p4 verify -q //...#head,#head`	ディポ内のすべてのファイルの最新リビジョンのみを検証し、問題のあるファイルのみをレポートします。

p4 verify

構文

説明

保留中のファイルを検証する

アーカイブされたファイルを検証する

オプション

使用上の留意点

例

関連コマンド