p4 populate

あるファイル集合のブランチ処理を1回の操作で行います。

構文

p4 [g-opts] populate [-d description] [-f -n -o] [-m max] fromFile[rev] toFile

p4 [g-opts] populate [-d description] [-f -n -o] [-m max] -b branch [-r] 
                      [toFile[rev]]

p4 [g-opts] populate [-d description] [-f -n -o] [-m max] -b branch -s fromFile[rev] 
                      [toFile]

p4 [g-opts] populate [-d description] [-f -n -o] [-m max] -S stream [-P parent] [-r] 
                      [toFile[rev]]

説明

p4 populateコマンドは、あるファイル集合(反映元)をディポ内の別の場所(反映先)へと1回の操作でブランチします。 新しいファイルがただちに作成され、p4 submitコマンドやクライアントワークスペースを必要としません。

p4 populateコマンドを実行するとchange-submitトリガが起動するため、変更内容を検証してからサブミットを行うことができます。 詳細については、『Helix Coreサーバ管理者ガイド: 基本』の「Change-submitトリガ」を参照してください。

change-contentトリガの作業中チェンジリストと同様に、change-submitトリガの一時的な作業中チェンジリストレコードが作成されるため、変更内容の説明を確認することができます。 ただし、p4 populateコマンドでブランチされたファイルはオープンされないため、p4 describeコマンドやp4 openedコマンドを実行しても、change-submitトリガに対してファイルが返されることはありません。

「-d description」オプションを指定しなかった場合、コマンドラインで指定された引数が説明として使用されます。

change-contentステージ完了後にp4 populateコマンドが失敗した場合、change-failトリガが有効になります。 詳細については、「サブミットに対してトリガを起動させる」の「change-failed」を参照してください。

rpl.checksum.change構成可能変数の値はこのコマンド用に実行される認証のレベルを決定します。

オプション

-b branch	ユーザ定義のbranch仕様のビューを使用します。反映元がブランチビューの左側、反映先がブランチビューの右側になります。
-d description	自動的にサブミットされるチェンジリストに対して説明を指定します。 説明が与えられていない場合、説明としてコマンドライン引数を使用します。
-f	削除されたファイルを強制的に反映先にブランチします。 (デフォルトでは、削除されたファイルは存在しないものとして扱われ、スキップされます。)
-m max	操作対象のファイルをmax個に制限します。
-n	実際には何も行わずに、操作の結果をプレビューします。
-o	p4 populateコマンドによって作成されたファイルのリストを表示します。
-P parent	-S streamとともに使用すると、ストリームの実際の親ではない親ストリームを指定します。
-r	反映処理の方向を逆にします(反映元から反映先ではなく、反映先から反映元)。
-s	-b branchとともに使用すると、fromFileを反映元として扱い、ユーザ定義のブランチビューの両側を反映先として扱います。 (任意指定のtoFile引数を使用すると、反映先ファイル集合の範囲がさらに限定されます。) -r使用時、-sオプションは無視されます。
-S stream	ストリームのビューを使用します。反映元はストリーム自体であり、反映先はストリームの親です。
g-opts	詳細については、グローバルオプションを参照してください。

使用上の留意点

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