p4 opened
概要
作業中のチェンジリスト内にある作業状態のファイルをリスト表示します。
構文
p4 [g-opts
] opened [-a -s] [-c change
] [-C workspace
] [-u user
] [-m max
] [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
- action
chnum
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
)が省略された簡易出力が得られます。このコマンド形式は通常、デフォルト状態よりも速く動作します。
オプション
|
すべてのクライアントワークスペース内にある作業状態のファイルをリスト表示します。 分散環境において、このオプションはエッジサーバの他のワークスペースで作業状態にしたファイルのみを一覧表示します。ほかのエッジサーバで作業状態にしたファイルは表示されません。 |
|
作業中チェンジリスト |
|
指定されたクライアント |
|
|
|
簡易出力。リビジョン番号およびファイルタイプを出力しません。このオプションは、大規模なサイトで |
|
|
|
分散環境において、すべてのサーバで |
|
「“グローバルオプション”」を参照してください。 |
使用上の留意点
ファイル引数にリビジョン指定子を使えるか? |
ファイル引数にリビジョン範囲を使えるか? |
最低限必要なアクセスレベル |
---|---|---|
使用不可 |
使用不可 |
|
-
Perforceは、ユーザがすでに作業状態になっているファイルを作業状態にする操作を妨げません。デフォルトの構成では、複数のユーザが同じファイルを同時に編集し、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/... |
ディポのサブディレクトリ |
p4 opened -a -c default |
全クライアントワークスペースのデフォルトチェンジリストについて、作業状態のファイルをすべてリスト表示します。 |