p4 monitor
概要
Perforceのプロセス情報を表示します。
構文
p4 [g-opts] monitor show [-a -l -e -L [-s R/T/P/I]
p4 [g-opts] monitor terminate id
p4 [g-opts] monitor clear id
p4 [g-opts] monitor clear all
p4 [g-opts] monitor pause id
p4 [g-opts] monitor resume id
解説
p4 monitorによってシステム管理者は、Perforceサーバマシン上でどのようなPerforce関連プロセスが実行中かを監視することができます。
p4 monitorを使用するには、p4 configureで構成可能変数monitorを設定して、Perforceサービス上で監視を有効にする必要があります。プロセスの監視を制御するには、構成可能変数monitorを0(監視を無効にする)、1(アクティブなプロセスの監視を有効にする)、または2(アクティブなプロセスと休止プロセスの監視を有効にする)に設定します。値5、10、25は、ロック情報の取得に関係します。
コマンド構文バリアントには、次の選択肢があります。
-
現在のプロセス情報を表示するには、p4 monitor showを使用します。デフォルトではすべてのプロセスがリストされますが、引数なしでコマンド(例えば、
sync、edit、submit)だけが表示されます。この形式でp4 monitorを実行するには、list権限が必要です。指定された状態のプロセスのみを表示するには、-sを使用します。statusそれぞれのコマンドに関連付けられた引数のリストを表示するには、
-a(arguments)オプションまたは-l(long)オプションを使用します。ユーザ環境からの追加情報が必要な場合は、-e(environment)オプションを使用します。これらのオプションを指定するには、admin権限が必要です。-Lオプションにより、ロックされたファイルを表示できます。 -
プロセスを終了させるためにマークするには、p4 monitor terminate
idを使用します。このコマンドの実行には、super権限が必要です。プロセスが少なくとも10秒間実行中でない限り、p4 monitor terminateコマンドはプロセスに終了のためのマークを付けません。p4 obliterateなど一部のコマンドは終了することができません。
-
監視テーブルからエントリを消去するには、p4 monitor clear
idを使用します。p4 monitor clear allを実行すれば、テーブル全体を消去することができます。これらのコマンドの実行には、super権限が必要です。実行中と示されたプロセスは、たとえp4 monitor clearで監視テーブルから消去されたとしても、終了するまで実行し続けます。
-
p4 verifyやp4 pullなどの長時間実行されるタスクを、p4 monitor pauseおよびp4 monitor resumeによって制御することができます。
p4 monitorの出力の各行には、次のフィールドが含まれます。
pid
status
owner
hh:mm:ss
command
[args]
|
|
UNIX環境におけるプロセスID(またはWindows環境におけるスレッドID)です。 |
|
|
プロセスにより、 |
|
|
そのコマンドを実行したユーザのPerforceユーザ名です。 |
|
|
コマンドを実行してから経過した時間を示します。 |
|
|
Perforceサービスが受信したコマンドと引数です。 |
例えば、p4 monitor show -Lコマンドの次のような出力では、ロックされたファイルについての情報が以下のように表示されます。
8764 R user 00:00:00 edit
[server.locks/clients/88,d/ws4(W),db.locks(R),db.rev(R)]
8766 R user 00:00:00 edit
[server.locks/clients/89,d/ws5(W),db.locks(R),db.rev(R)]
8768 R user 00:00:00 monitor
pid、ステータス、所有者、経過時間に続けて、ws4とws5のワークスペース専用モードによるクライアントワークスペースのロックと、読み取り専用モードのdb.locksおよびdb.revテーブルを含む、さまざまなファイルをロックする2つの編集コマンドを示しています。
オプション
|
|
プロセスに関連付けられたすべての引数(例えば、 Perforceユーザ名は10文字に切り捨てられ、出力行の文字数は全部で80文字に制限されます。 |
|
|
起動しているPerforceアプリケーション(既知の場合)、ホストIPアドレス、およびワークスペース名を含む環境情報を表示します。 |
|
|
長い形式で、すべての引数が表示されます。ユーザ名やコマンドライン引数のリストは、切り捨てられません。 |
|
|
ロックされたファイルの情報を表示します。情報が収集されるのは、p4 monitorコマンドが実行されている期間のみで、その後は継続しません。このオプションを使用するのに事前に必要な条件は、サーバーを実行するプラットフォームにより異なります。
このオプションと共に |
|
|
ステータスが |
|
|
「“グローバルオプション”」を参照してください。 |
使用上の留意点
|
ファイル引数にリビジョン指定子を使えるか？ |
ファイル引数にリビジョン範囲を使えるか？ |
最低限必要なアクセスレベル |
|---|---|---|
|
使用不可 |
使用不可 |
|
-
サーバ側において早いタイミングでコマンドが終了すると、誤って実行中とリストされる場合があります。このようなプロセスは、スーパーユーザがp4 monitor clearで消去することができます。
-
複数のプロセスを実行するコマンド(例えば、p4 submitなど)があります。例えば、
dm_CommitSubmitまたはdm_SubmitChangeが、p4 submitコマンドの2つの独立したフェーズとしてp4 monitorの出力に表示されることがあります。 -
休止プロセスの監視を有効にしている場合(構成可能変数
monitorを2に設定)、休止プロセスはstatusがR、commandがIDLEで表示されます。
例
|
p4 monitor show |
Perforceのプロセス情報(コマンドのみ)を表示します。 |
|
p4 monitor show -l |
出力行の長さを制限せずに、コマンドと引数を表示します。 |
|
p4 monitor show -a |
出力行ごとに80文字に制限し、コマンドと引数を表示します。 |
|
p4 monitor terminate 123 |
プロセス123を終了のためにマークするよう、Perforceサービスに通知します。 |
|
p4 monitor clear all |
監視テーブルのすべてのエントリを消去します。 |