p4 clean

概要

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

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

構文

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

解説

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

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

  2. ファイルはディポ内に存在しますが、ワークスペースからは失われます。ディポから同期されたファイルのバージョンが、ワークスペースに追加されます。

  3. ワークスペース内で修正されてチェックインされていないファイルが、ディポからの最新バージョンに復元されます。

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

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

提案された一連のワークスペース調整動作をプレビューするには、-nオプションを使用します。

オプション

-a

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

-d

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

-e

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

-I

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

-l

ローカルファイルシンタックスの出力を相対パスで、p4 statusのワークスペースを中心とするビューと同様に表示します。

-n

作業を実行せずに、操作結果をプレビューします。

file

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

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