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はディポのあらゆるファイルについてレポートします。
その範囲はクライアントビューで表示できるファイルに限られません。コマンドラインのファイルパターンがクライアントシンタックスで指定されている場合、
クライアントワークスペースにあるファイルのみが表示されます。
オプション
|
|
指定されたファイルに対して、リビジョン範囲における最上位のリビジョンのみを 表示するのではなく、範囲内のすべてのリビジョンをリストします。 |
|
|
出力をアーカイブディポ内のファイルに限定します。 |
|
|
削除、完全消去、またはアーカイブされたファイルを除外し、同期または反映を 実行できるファイルのみを残します。 |
|
|
大文字と小文字が区別されるサーバでファイルをリスト表示した場合、 ファイル引数の大文字と小文字の区別が無視されます。 |
|
|
最初から |
|
|
アンロードディポにあるファイルのみをリストします。
詳細については、「 |
|
|
「グローバルオプション」を参照してください。 |
使用上の注意点
| ファイル引数でリビジョン指定子を使用できるか？ | ファイル引数でリビジョン範囲を使用できるか？ | 最低限必要なアクセスレベル |
|---|---|---|
|
はい |
はい |
|
- リビジョンはリビジョン範囲で指定できます。この場合、指定された範囲内の
リビジョンを持つファイルのみがリストされ、デフォルトではその中の
最上位のリビジョンが最新リビジョンとして表示されます。(リビジョン範囲におけるすべての
ファイルの情報を表示するには、
p4 files -aを使用します) p4 filesの出力は、指定範囲の広いファイル引数で呼び出されると、 かなり大量になることがあるため(例えば、p4 files //depot/...では、 ディポの全ファイルに関する情報が表示される)、p4 groupによって設定されたmaxresultsの制限を受けることがあります。
例
|
|
ディポ内のすべてのファイルに関する情報を提供します。 |
|
|
指定されたクライアントのビューで表示できるすべてのディポファイルに関する 情報を提供します。 |
|
|
大文字と小文字を区別しない形でp4 files //clientname/...を取得します。 |
|
|
2011年3月10日に存在していたすべてのディポファイルのリビジョンに 関する情報を提供します。 |
|
|
2011年3月31日の営業時間内に変更されたすべてのファイルとリビジョンを 一覧表示します。 |
| p4 files @=14 | 指定されたチェンジリストで保留またはサブミットされたファイルを一覧表示します。 |
| p4 files //depot/foo/...@12 | 指定されたチェンジリストまでのすべてのチェンジリストの指定のパス内のファイルを一覧表示します。 |
| p4 files //depot/foo/...@12,@12 | 指定されたチェンジリストの指定のパス内のファイルだけを一覧表示します。 そのため、同じチェンジリスト番号を持つファイルだけが表示されることになります。 |
|
|
ラベル |
|
|
|
|
|
|
|
|
管理者が |
関連コマンド
|
ファイルのリビジョン履歴をリスト表示する |
|
|
現在作業状態になっているすべてのファイルのリストを表示する |
|
|
使用中のクライアントワークスペースに同期したファイルリビジョンのリストを表示する |
|
|
ディポファイルの内容を参照する |
