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 ...]

説明

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

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

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

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

ただし、

• depot-file はディポシンタックスで記述されたパスです。
• rev はリビジョン番号です。
• action はファイルが作業状態にされた目的(add、edit、delete、branch、integrate)です。
• 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オプションを暗黙的に示します。
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	全クライアントワークスペースのデフォルトチェンジリストについて、作業状態のファイルをすべてリスト表示します。