p4 opened

作業中のチェンジリスト内にある作業状態のファイルをリスト表示します。

構文規則

p4 [g-opts] opened [-a -c change] [-C workspace] [-u user -m max -s -g] [file ...]
p4 [g-opts] opened [-a -x] [-m max] [file ...]

説明

注意

このコマンドは、オープン可能なストリーム仕様でも機能します。「オプション」で、-Soオプションの説明を参照してください。

p4 openedは、p4 addp4 editp4 deleteまたはp4 integrateによって 現在作業状態になっているファイルをリスト表示するために使用します。 デフォルトでは、現在のクライアントワークスペースにある作業状態のファイルがすべてリスト表示されます。 コマンドライン引数を使用すると、特定の作業中チェンジリストに含まれる ファイルのみをリスト表示する、すべての作業中チェンジリストにある 作業状態のファイルを表示する、表示されるファイルの数を制限する、 作業状態のファイルを特定のユーザに制限することができます。

p4 openedに引数としてファイル指定が与えられていれば、リストにはそのファイル指定に 適合するファイルのみが含まれます。

作業状態の各ファイルについて表示される情報には、ファイル名、 ディポ内での保存場所、ファイルが最後に同期したリビジョンの番号、 ファイルが作業状態にされたチェンジリストの番号、 ファイルを作業状態にした目的の操作(addeditdeletebranchmove/addmove/deleteintegrateimportpurgearchive)、ファイルタイプが含まれます。 各ファイルの出力は次のフォーマットで表示されます。

depot-file#rev - actionchnum change (type) [lock-status]

各項目の意味は以下のとおりです。

  • depot-fileこれは、ディポシンタックス内のパスです。
  • revこれは、リビジョン番号です。
  • actionこれは、ファイルがオープンされた目的です(addeditdeletebranchintegrate)。
  • chnumこれは、サブミットされたチェンジリストの番号です。
  • typeこれは、特定のリビジョンにおけるファイルのタイプです。
  • ファイルがロックされている場合は(p4 lockを参照)、 行末に*locked*の警告が表示されます。
  • +l修飾子を使用するファイルタイプを持つファイルには排他的ロック (p4 typemapの例を参照)が適用され、*exclusive*という ロックステータスで表示されます。

-sオプションを使用すると、ファイルの#rev番号とタイプ (type)が省略された簡易出力が得られます。 このコマンド形式は通常、デフォルト状態よりも速く動作します。

-uオプションで、特定ユーザにより作業状態にされたファイルへの出力を制限します。 制限しない場合は、このコマンドをすべてのユーザに適用します。

-gオプションを指定すると、マルチサーバ環境のコミットサーバで作業状態に なっているファイルが一覧表示されます。

次の例では、ユーザ詳細がコマンド出力に含まれていることを示しています。 この場合、現在のワークスペースと現在のユーザが識別されていないことが示されています。 ただし、作業状態にしたファイルを保有する他のユーザが識別されています。

$ p4 opened
//depot/file-1.txt#1 - edit default change (text) by adam@scratch
//depot/file-2.txt#1 - edit default change (text)

すべてのワークスペースに対して要求しているこの例では、ユーザ名が常に表示されます。

$ p4 opened -a
//depot/file-1.txt#1 - edit default change (text) by adam@scratch
//depot/file-2.txt#1 - edit default change (text) by normal@scratch

オプション

-a

すべてのクライアントワークスペース内にある作業状態のファイルをリスト表示します。

マルチサーバ環境でこのオプションを指定すると、エッジサーバ上のすべての ワークスペースで作業状態になっているファイルが一覧表示されます。

-c change

作業中チェンジリストchangeのファイルをリスト表示します。 デフォルトチェンジリストのファイルをリスト表示するには、p4 opened -c defaultを使用します。

-C workspace

指定されたクライアントworkspace内で作業状態にあるファイルのみ をリスト表示します。

-g

マルチサーバ環境のコミットサーバで作業状態になっているファイルが一覧表示されます。 これにより、エッジサーバからコミットサーバ上でグローバルにロックする可能性のある ファイルを追跡することができます。コミットサーバ上でコマンドクエリが実行されるため、 ファイル仕様引数を指定する場合は、ディポシンタックスで指定する必要があります。 -gオプションは-aオプションを暗黙的に示します。

-m max

max件までの作業状態のファイルのみを一覧表示します。

-s

簡易出力。リビジョン番号およびファイルタイプを出力しません。 このオプションは、大規模なサイトで-a(すべてのワークスペース)オプションを 使用する場合に特に効率的です。

-u user

userによって作業状態にされているファイルのみを一覧表示します。

このオプションは、現在のワークスペースのみでなく、指定されたユーザ名のいずれかの ワークスペースで作業状態になっているファイルもリスト表示します。

-x

マルチサーバ環境のすべてのサーバで、ファイルタイプが+lになっている すべてのファイル(排他的な作業状態のファイル)が一覧表示されます。 このオプションは、-aオプションを暗黙的に示します。

-So このオプションを-c changeオプションと組み合わせて使用すると、現在編集用にオープンされている ストリーム仕様を一覧表示することができます。デフォルト設定の場合、-Soオプションを省略すると、ファイルリストの前に 作業状態のストリーム仕様が一覧表示されます。 編集用にオープンされているストリーム仕様が存在しない場合、ストリーム仕様は表示されません。

g-opts

グローバルオプション」を参照してください。

使用上の注意点

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

いいえ

いいえ

list

  • Helixサーバは、既に作業状態になっているファイルをユーザが 作業状態にすることを防止しません。Helixサーバはデフォルトで、複数のユーザがファイルを同時に編集し、 p4 resolveでファイル衝突を解決することを許可します。他のユーザが既に特定のファイルを 作業状態にしているかどうかを調べるには、p4 opened -a fileを使用します。
  • ロックされたファイルは、p4 openedの出力において *locked*と表示されます。UNIXでは、次のコマンドを実行することによって、 作業状態でかつロックされているファイルをすべて検索することができます。

    $ p4 opened | grep "*locked*"

    これにより、p4 lockでロックされた作業状態のファイルを一覧表示します。

  • p4 opened -aこのコマンドを大規模な環境で実行すると、パフォーマンスに影響する可能性があります。 作業状態のファイルの正確なリビジョン番号やファイルタイプの情報が必要ない場合は、 p4 opened -asを使用することをお勧めします。
  • p4 openedこのコマンドの場合、保留中のチェンジリストのファイルは表示されません 保留中のチェンジリストを表示するには、p4 changes -s shelvedを使用し、それからp4 describe -s -S changelistを使用して、 選択したチェンジリストのファイルを表示します。

p4 opened -c 35 //depot/main/...

ディポのmainサブディレクトリにある作業中のチェンジリスト35のファイルを すべてリスト表示します。

p4 opened -a -c default

全クライアントワークスペースのデフォルトチェンジリストについて、 作業状態のファイルをすべてリスト表示します。

p4 opened -u maria サーバ上の任意のワークスペースで、指定されたユーザの作業状態のファイルを一覧表示します。