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 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
オプション
|
すべてのクライアントワークスペース内にある作業状態のファイルをリスト表示します。 マルチサーバ環境でこのオプションを指定すると、エッジサーバ上のすべての ワークスペースで作業状態になっているファイルが一覧表示されます。 |
|
作業中チェンジリスト |
|
指定されたクライアント |
|
マルチサーバ環境のコミットサーバで作業状態になっているファイルが一覧表示されます。
これにより、エッジサーバからコミットサーバ上でグローバルにロックする可能性のある
ファイルを追跡することができます。コミットサーバ上でコマンドクエリが実行されるため、
ファイル仕様引数を指定する場合は、ディポシンタックスで指定する必要があります。
|
|
|
|
簡易出力。リビジョン番号およびファイルタイプを出力しません。
このオプションは、大規模なサイトで |
|
このオプションは、現在のワークスペースのみでなく、指定されたユーザ名のいずれかの ワークスペースで作業状態になっているファイルもリスト表示します。 |
|
マルチサーバ環境のすべてのサーバで、ファイルタイプが |
-So | このオプションを-c changeオプションと組み合わせて使用すると、現在編集用にオープンされている ストリーム仕様を一覧表示することができます。デフォルト設定の場合、-Soオプションを省略すると、ファイルリストの前に 作業状態のストリーム仕様が一覧表示されます。 編集用にオープンされているストリーム仕様が存在しない場合、ストリーム仕様は表示されません。 |
|
「グローバルオプション」を参照してください。 |
使用上の注意点
ファイル引数でリビジョン指定子を使用できるか? | ファイル引数でリビジョン範囲を使用できるか? | 最低限必要なアクセスレベル |
---|---|---|
いいえ |
いいえ |
|
- 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 -u maria
|
サーバ上の任意のワークスペースで、指定されたユーザの作業状態のファイルを一覧表示します。 |