p4 print
概要
ディポファイルのリビジョンの内容を表示します。
構文
p4 [g-opts] print [-a -A -k -q] [-m max] [-o outfile] file[revRange] …
p4 [g-opts] print -U unloadfile …
解説
p4 printは、ディポファイルの内容を標準出力へ書き出します。リビジョン範囲を指定した場合、指定された範囲内のリビジョンを持つファイルだけを書き出します。デフォルトでは、範囲内の最高位リビジョンだけを書き出します。(指定されたリビジョン範囲における全ファイルを出力するには、p4 print -aを使用します。)複数のファイルパターンを含めることもできます。その場合には、それらのファイルパターンのいずれかに適合するすべてのファイルが表示されます。
ディポのどのファイルでも、p4 protectによって認められたアクセス権限に従って表示させることができます。ファイル引数がクライアントビューによってマッピングされていない場合は、ディポシンタックスで指定しなければなりません。
デフォルトでは、ファイルの内容とともに、そのファイルのディポにおける位置を記述するヘッダ、表示されたファイルのリビジョン番号、そのリビジョンがサブミットされるチェンジリストの番号も表示されます。ヘッダを抑制するには、-q (quiet)オプションを使用します。
デフォルトでは、RCSキーワードは拡張されます。キーワード拡張を抑制するには、-k (keyword)オプションを使用してください。
デフォルトでは、指定したファイルについてローカルディポが検索されます。-Uオプションを指定した場合は、代わりにアンロードディポが検索されます。
オプション
|
|
すべてのファイルに対して、指定されたリビジョン範囲内の最新リビジョンだけでなく、全リビジョンを書き出します。 |
|
|
アーカイブディポに格納されたファイルの書き出しを試みます。 |
|
|
RCSキーワード拡張を抑制します。 |
|
|
|
|
|
ディポのオリジナルファイルと同じファイルタイプ、属性、パーミッション設定を保持して、出力をローカルディスク上の指定された出力ファイルにリダイレクトします。 |
|
|
通常はPerforceによって追加される1行のファイルヘッダの表示を抑制します。 |
|
|
アンロードディポ内の指定されたファイルを検索します。アンロード済みのクライアント、ラベル、またはタスクストリームについてのデータを表示できます。 |
|
|
「“グローバルオプション”」を参照してください。 |
使用上の留意点
|
ファイル引数にリビジョン指定子を使えるか？ |
ファイル引数にリビジョン範囲を使えるか？ |
最低限必要なアクセスレベル |
|---|---|---|
|
使用可 |
使用可 |
|
-
ほとんどの端末ではUTF16のコンテンツを表示できないことから、p4 printコマンドのデフォルトの動作ではUTF8のコンテンツを返します。端末からの出力を完全に回避し出力ファイルを指定することで、この動作をオーバーライドすることができます。例：
p4 print -q -o
outputfile//depot/fileお使いの端末でUTF16形式の出力がサポートされている場合は、標準出力を出力ファイルとして次のように指定します。
p4 print -q -o - //depot/
file -
p4 printのファイル引数としてリビジョン範囲を指定することができます。デフォルトでは、適合するファイルの最新のリビジョンだけが表示されます。(これは、範囲が指定されないときに黙示的範囲が
#1,#headであり、その最新リビジョンが#headであることを意味しています。)指定された(もしくは黙示的)範囲の全ファイルを書き出すには、-aオプションを指定します。 -
ファイル引数を詳細に定義せずにp4 printを実行すると、結果が大量に出力されるがあるため(例えばp4 print //depot/...と指定すると、ディポのすべてのファイルの内容を表示)、出力はp4 groupで設定された
maxresultsの制限に準拠します。 -
多くの場合、p4 printの出力はOSのシェルを介してファイルにリダイレクトすれば十分です。
-oオプションは、ユーザがファイルタイプやパーミッションの自動設定を必要とする状況に対処するために使用します。これはシンボリックリンク(symlinkタイプとして保存)のようなファイル、appleタイプのファイル、またはtext+xタイプとして保存されているUNIXシェルスクリプトの実行ビットの自動設定などには便利です。