p4 archive

古いリビジョンをアーカイブディポにアーカイブします。

構文規則

p4 [g-opts] archive [-n -h -p -q -t -z] -D depot FileSpec[revSpec]

説明

admin権限を持つHelix Coreサーバユーザがこのコマンドを実行すると、特定のリビジョンをarchiveタイプのディポ内に移動することができます

ファイルがアーカイブディポに移動すると、ファイルに対する最後の 操作がarchiveに変わります。

ファイルの内容にアクセスするコマンド(p4 syncやp4 diffなど)では、 archiveのリビジョンはスキップされます。ファイルの内容にアクセスする必要がないコマンド(p4 filelogなど)では、 アーカイブ済みリビジョンに関するメタデータが引き続きレポートされます。

アーカイブディポに関するファイルシステムをマウントする前に、p4 archive -nコマンドを使用して テストを行うことができます。-nオプションを使用しない場合は、このコマンドを実行する前に アーカイブディポの記憶領域をマウントしておく必要があります。

-zオプションを指定しない場合

-zオプションを指定せずにコマンドを実行すると、以下に示す4つの条件をすべて満たすリビジョンだけがアーカイブされます。

1. RCS形式ではなく、完全な形式(+F)または圧縮された形式(+C)で保管されたリビジョン
2. ローカルディポ(remoteディポでも別のarchiveディポでもない ローカルディポ)内に存在するリビジョン
3. 別のリビジョンからコピーまたはブランチされたものではないリビジョン
4. 別のリビジョンにコピーまたはブランチされたものではないリビジョン

-zオプションを指定した場合

-zオプションを指定してコマンドを実行すると、以下に示す2つの条件を満たすリビジョンだけがアーカイブされます。

1. RCS形式ではなく、完全な形式(+F)または圧縮された形式(+C)で保管されたリビジョン
2. ローカルディポ(remoteディポでも別のarchiveディポでもない ローカルディポ)内に存在するリビジョン

このオプションを指定すると、遅延コピー ディポ内のファイル内容を複製せずに、ファイルの内部コピーを作成する目的でHelixサーバで使用される方法。オリジナルのバージョン化ファイル(ディポファイル)への遅延コピーポイント。遅延コピーの場合、ファイルをコピーするのではなく、元のファイルに対するリファレンスが保存されるため、必要なディスク容量を最小化することができます。が含まれているファイルや、それ自体が遅延コピーになっているファイルが処理対象になります。

オプション

-D depot	ファイルのアーカイブ先となるアーカイブディポを指定します。
-h	最新リビジョンをアーカイブしません。
-n	リビジョンをアーカイブしません。代わりに、どのリビジョンがアーカイブされたかを報告します。
-p	アーカイブディポ内の指定されたファイルのアーカイブを消去します。 完了時に、影響を受けるリビジョンに対する操作が 「purge」に設定されます。 警告 この状態の場合、p4 restoreコマンドを使用してファイルの内容に アクセスすることはできません。 ヒント 消去されたファイルのメタデータを保持する場合は、以下のいずれかを行ってください。 p4 obliterateコマンドの-pオプションを実行する(推奨) p4 archiveコマンドを実行してからp4 archive -pコマンドを実行する(この方法は時間がかかります)
-q	クワイエットモード。無視されたリビジョンに関するメッセージは抑止されます。
-t	テキストファイル(または、binary+Dタイプのファイルなど、デルタ形式で格納された その他のリビジョン)をアーカイブします。
-z	このオプションを指定すると、遅延コピー ディポ内のファイル内容を複製せずに、ファイルの内部コピーを作成する目的でHelixサーバで使用される方法。オリジナルのバージョン化ファイル(ディポファイル)への遅延コピーポイント。遅延コピーの場合、ファイルをコピーするのではなく、元のファイルに対するリファレンスが保存されるため、必要なディスク容量を最小化することができます。が含まれているファイルや、それ自体が遅延コピーになっているファイルが処理対象になります。「-zオプションを指定した場合」を参照してください。
g-opts	「グローバルオプション」を参照してください。

使用上の注意点

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

• デルタ形式で格納されたファイルをアーカイブするには、 -tオプションを使用します。
ヒント

大量のRCSデルタを操作する場合、 計算処理の負荷が高くなる可能性があります。

• アーカイブディポ内に保管されているリビジョンがバージョニングサービスにアクセス可能な状態になっている場合、p4 printコマンドを以下のように入力することにより、 アーカイブされているリビジョンのうち、どのリビジョンを復元するかを指定することができます。

  p4 print -A -o myOutputFile //archive/depot/myFile

  このコマンドを実行すると、アーカイブされたファイルのすべてのバージョンが myOutputFileにリダイレクトされます。その後、p4 restoreコマンドを使用して1つ以上のファイルバージョンを復元するように、 Helixサーバの管理者に依頼することができます。

  ヒント

  adminアクセス権限を持つユーザは、「p4 fstat -Ob」コマンドを実行して、サーバ上のアーカイブファイルのパス、リビジョン、タイプ、絶対ローカルパス、相対ローカルパスを表示することができます。

例

p4 archive file#3	リビジョン1から3のファイルをアーカイブします ファイル引数として単一のリビジョンを指定してp4 archiveコマンドを実行すると、 リビジョン#1から指定したリビジョンまでが暗黙的にアーカイブ対象になります。
p4 archive file#3,3	リビジョン3のファイルをアーカイブします 単一のリビジョンrevのみをアーカイブするには、 p4 archive file#rev,revの形式を使用します
デルタ形式で格納されたファイルをアーカイブするには、 -tオプションを使用します。
p4 archive -D archives -t //depot/....txt	「...」ワイルドカードを使用して、.txt拡張子を持つファイルをアーカイブします。
p4 archive -D archives -t //depot/....txt@3,3	「...」ワイルドカードを使用して、チェンジリスト3に属している、.txt拡張子を持つファイルをアーカイブします。
p4 archive -D archives -t //depot/....txt@3	「...」ワイルドカードを使用して、チェンジリスト1～3に属している、.txt拡張子を持つファイルをアーカイブします。

関連コマンド

ディポを作成する	p4 depot
ファイルをアーカイブディポから復元する	p4 restore
ファイルをアーカイブせずに完全消去する	p4 obliterate