p4 files

ディポ内のファイルに関する情報を、ファイルの内容にアクセスすることなく提供します。

構文

p4 [g-opts] files [-a -A -e] [-i][-m max] [[FileSpec][revSpec]]
p4 [g-opts] files -U unloadFileSpec

説明

このコマンドは、引数として指定されたファイルパターンに一致するファイルを一覧表示します。 リビジョン指定子が与えられていれば、その指定されたリビジョンのファイルについての説明が表示されます。 出力は1行に1ファイルずつ、次のフォーマットで表示されます。

depot-file-location#rev - action change changelist (filetype)

それぞれの意味は、以下のとおりです。

• depot-file-location は、ディポのルートディレクトリに対するファイルの相対的な場所です。
• rev は、ファイルの最新リビジョンのリビジョン番号です。
• action は、最新リビジョンにおいて実行されたアクション、つまり、add、edit、delete、branch、move/add、move/delete、integrate、import、purge、archiveです。
• changelist は、そのリビジョンがサブミットされたチェンジリストの番号です。
• filetype は、最新リビジョンにおけるファイルのHelixサーバファイルタイプです。

通常のHelixサーバコマンドと異なり、p4 filesはディポのあらゆるファイルについてレポートします。 その範囲はクライアントビューで表示できるファイルに限られません。 コマンドラインのファイルパターンがクライアントシンタックスで指定されている場合、クライアントワークスペースにあるファイルのみが表示されます。

オプション

-a	指定されたファイルに対して、リビジョン範囲における最上位のリビジョンのみを表示するのではなく、範囲内のすべてのリビジョンをリストします。
-A	出力をアーカイブディポ内のファイルに限定します。
-e	削除、完全消去、またはアーカイブされたファイルを除外し、同期または反映を実行できるファイルのみを残します。
-i	大文字と小文字が区別されるサーバでファイルをリスト表示した場合、ファイル引数の大文字と小文字の区別が無視されます。
-m max	最初からmax件までのファイルのみに出力を制限します。
-U unloadfile	アンロードディポにあるファイルのみをリストします。 詳細については、p4 unloadを参照してください。
g-opts	詳細については、「グローバルオプション」を参照してください。

使用上の留意点

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

• リビジョンはリビジョン範囲で指定できます。 この場合、指定された範囲内のリビジョンを持つファイルのみがリストされ、デフォルトではその中の最上位のリビジョンが最新リビジョンとして表示されます。 (リビジョン範囲におけるすべてのファイルの情報を表示するには、p4 files -aを使用します。)
• p4 filesの出力は、指定範囲の広いファイル引数で呼び出されると、かなり大量になることがあるため(例えば、p4 files //depot/...では、ディポの全ファイルに関する情報が表示される)、p4 groupによって設定されmaxresultsの制限を受けることがあります。

例

p4 files //depot/...	ディポ内のすべてのファイルに関する情報を提供します。
p4 files //clientname/...	指定されたクライアントのビューで表示できるすべてのディポファイルに関する情報を提供します。
p4 files @2011/03/10	2011年3月10日に存在していたすべてのディポファイルのリビジョンに関する情報を提供します。
p4 files @2011/03/31:08:00,@2011/03/31:17:00	2011年3月31日の営業時間内に変更されたすべてのファイルとリビジョンをリスト表示します。
p4 files //depot/proj2/...@p2lab	ディレクトリ//depot/proj2/... でp2labラベルによりタグ付けされるファイルおよびリビジョンをリスト表示します。
p4 files //depot/file.c	//depot/file.cの最新リビジョンの情報を表示します。 (これは、#1,#headの暗黙的な範囲における最上位のリビジョンです)。
p4 files -a //depot/file.c	//depot/file.cのすべてのリビジョンの情報を表示します(これは、#1,#headの暗黙的な範囲におけるすべてのリビジョンです)。
p4 files -A //arch/depot/proj/...	管理者がp4 archiveを用いて//depot/proj/...を archという名前のアーカイブディポに転送した場合、アーカイブされたプロジェクト内のファイルに関する情報を表示します。

関連コマンド

ファイルのリビジョン履歴をリスト表示する	p4 filelog
現在作業状態になっているすべてのファイルのリストを表示する	p4 opened
使用中のクライアントワークスペースに同期したファイルリビジョンのリストを表示する	p4 have
ディポファイルの内容を参照する	p4 print