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

p4 clean

ワークスペースのファイルを復元し、対応するディポファイルの状態と一致させます。

p4 cleanコマンドは、p4 reconcile -wコマンドと同等です。

構文

p4 [g-opts] clean [-e -a -d -I -m -l -n] [file ...]

説明

p4 cleanコマンドは、ユーザのワークスペースのファイルと対応するディポファイルとの不一致の検出時に、次の動作を行います。

  1. ワークスペースに存在するがディポには存在しないファイルをワークスペースから削除します。
    警告

    p4 cleanコマンドを実行してファイルを削除する前に、適切なディレクトリに移動していることを確認してください。 適切なディレクトリに移動していない場合、保持する必要があるローカルファイルを誤って削除してしまう可能性があります。

  2. ファイルはディポ内には存在しますが、ワークスペースからは削除されます。 ディポから同期されたファイルのバージョンが、ワークスペースに追加されます。
  3. ワークスペース内で修正されてチェックインされていないファイルが、ディポからの最新バージョンに復元されます。

p4 cleanによる追加、編集、または削除の対象範囲を制限するには、-a-e、または-dオプションを使用します。 例えば、-aオプションを使用すると、ワークスペース内の新規ファイルがすべて削除されます。

デフォルトでは、p4 cleanP4IGNOREファイルで記述されている、(編集ではなく)追加されたファイルまたはパスあるいはその両方をチェックしません。 この動作をオーバーライドし、P4IGNOREファイルを無視するには、-Iオプションを使用します。

ワークスペースに一致するかどうかを検査する一連の操作をプレビューするには、-nオプションを使用します。

オプション

-a

追加されたファイル: ワークスペース内のファイルからディポに対応するファイルがないものを検索し、それらを削除します。

-d

削除されたファイル: ディポ内のファイルからワークスペースに存在しないファイルを検索し、それらをワークスペースに追加します。

-e

編集されたファイル: ワークスペース内のファイルから変更されたものを検索し、それらをディポから同期された最新ファイルバージョンに復元します。

-I

無視するかどうかのチェックを行いません。つまり、P4IGNOREによって指定された、追加したファイルに対するすべての設定を無視します。

-m ファイルを同期またはサブミットした時間(ディポ内)とファイルを変更した時間(ワークスペース内)を比較して、ファイルの変更の有無を判断します。 通常、Helixサーバはファイルのダイジェストを使用して、ワークスペースのファイルがディポの最新リビジョンのファイルと相違があるか判断します。 大きなファイルの場合、これには時間がかかります。 ただし、タイムスタンプが同じである場合、負担がかかるダイジェスト比較はスキップできます。 このオプションは、cleanを使用して、削除や追加ではなく変更されたファイルを見つける場合にのみ関係します。

-l

相対パスによるローカルファイルシンタックスで出力を表示します。これはワークスペースの観点で実行するp4 statusと同様です。

-n

処理を行わずに、操作の結果をプレビューします。

ファイル

バージョンを最新のディポのファイルのバージョンと調整したいファイル。 このパラメータを省略すると、ローカルの作業ディレクトリにあるファイルが使用されます。

g-opts

詳細については、グローバルオプションを参照してください。

使用上の留意点

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

使用不可

使用不可

read

  • p4 cleanコマンドは出力をディポシンタックスで生成します。 ファイル名およびパスをローカルシンタックスで確認するには、-lオプションを使用するか、p4 statusコマンドを使用する必要があります。 次のコマンドの出力を比較してください。一方は-lオプションなしで、もう一方にはオプションが付いています。

    C:\test\local\client\copy\l>p4 clean -n bar
    //depot/copy/l/bar#none - deleted as c:\test\local\client\copy\l\bar
    C:\test\local\client\copy\l>p4 clean -n -l bar
    //depot/copy/l/bar#none - deleted as bar
  • 引数なしで呼び出されると、p4 cleanは、ワークスペースの特定のファイルがディポの最新状況を反映するように調整します。

関連コマンド

同等のコマンド: p4 reconcile -w

p4 reconcile