ローカルサーバのサブミット済みファイルをリモートサーバにコピーします。

p4 [g-opts] push [-n -v] [-r remotespec] [-S stream | filespec]

p4 pushコマンドは、指定したファイルのセットと、これらのファイルをサブミットしたチェンジリストを、指定したリモートサーバにコピーします。

プッシュが可能なのは、プッシュされるファイルがリモートサーバに完全に適合していて、共有されている共通の履歴に基づいて厳密に構築されている場合のみです。衝突やずれが多数ある場合、プッシュは拒否されます。それ以外の場合、チェンジリストはリモートサーバの新しいサブミット済みチェンジリストになります。

チェンジリストがリモートサーバに追加されると、新しいチェンジ番号が付与されますが、ファイルが保持する記述、ユーザ、タイプ、ワークスペースおよびファイルのセットは同じです。

ファイルがリモートサーバに追加されると、同じチェンジリストに保持され、現在の最新リビジョンの後に開始される新規のリビジョンになります。新規のリビジョンは、同じリビジョン番号、ファイルタイプ、操作、日付、タイムスタンプ、ダイジェスト、ならびにファイルサイズを保持します。

そのチェンジリストがリモートサーバに新規でサブミットされたチェンジリストだとしても、リモートサーバではサブミットトリガは実行されません。

通常、p4 pushコマンドはリモートの仕様を設定し、リモート仕様のDepotMapフィールドはプッシュするファイルを指定します。p4 pushコマンドは、プッシュされるファイルをさらに制限するfilespec引数も指定する場合があります。リモート仕様がDepotMapのローカルおよびリモート側で異なるパターンを使用する場合、filespec引数(該当の場合)はローカルのfilenameシンタックスでファイルを指定する必要があります。

あるチェンジリストに、filespecが一致するファイルと一致しないファイルが含まれている場合、一致するファイルのみがプッシュに含まれます。チェンジリストの一部をプッシュしないようにするには、適切なfilespecを指定する必要があります(例えば//...@change,#headなど)。

ファイルのリビジョンとチェンジリストに加えて、p4 pushコマンドはアーカイブの内容もリモートサーバにコピーします。遅延コピーの場合、リモートサーバはすでに対応するアーカイブを保有している場合があり、この場合遅延コピーはリモートサーバの既存のアーカイブを参照するように調整されます。

p4 pushコマンドは、反映を記述したすべての反映記録をプッシュされるファイルにコピーします。これらの反映レコードはリモートサーバで調整され、その結果リモートサーバのチェンジリスト番号とリビジョン番号が反映されます。

ファイルのセットをプッシュするには、現在のサーバのこれらのファイルに対する読み取りアクセス権と、リモートサーバにある同じファイルに対する書き込みアクセス権を持っている必要があります(リモートサーバのプロテクションテーブルによる)。ローカルのuseridはリモートサーバのuseridとして使用され、p4 pushコマンドを実行する前に両方のサーバにログインしておく必要があります。

p4 pushコマンドは不可分です。指定のファイルをすべてプッシュするか、どれもプッシュしないかのいずれかになります。

-rオプションが指定されていない場合、p4 pushは、オリジンに指定されたリモートサーバにファイルをプッシュします。

デフォルトでは、変更をサーバからサーバへプッシュすることはできません。サーバ間で変更をプッシュするには、各サーバの管理者はプッシュを有効にする必要があります。プッシュを開始するサーバではserver.allowpushを1に設定し、目的のサーバではserver.allowpushを2に設定します。ファイルタイプ修飾子+k、+l、+Sには、特別な考慮事項があります。+kタイプのファイルは、プッシュされたときにダイジェストをクリアします。これは、サーバ間のマージによる衝突は検出されないことを意味します。プッシュ後にリモートサーバでダイジェストを再生成するには、p4 verifyを使用します。

+lタイプのファイルをプッシュする時、リモートサーバで保留中のチェンジリストによりファイルが作業中であっても、新しいファイルがサーバに追加されます。+Sタイプのファイルをプッシュする時、指定の制限を超える古いアーカイブはp4 pushコマンドで消去されません。