EN JA
PROCSTAT(1)
PROCSTAT(1) FreeBSD General Commands Manual PROCSTAT(1)

名称

procstat詳細なプロセス情報を取得する

書式

procstat [ -h][ -n][ -C][ -w interval][ -b | -c | -e | -f | -i | -j | -k | -l | -s | -t | -v | -x][ -a | pid | core ...]

解説

procstat ユーティリティは、 pid 引数によって識別されるプロセスか、または -a フラグが使用されるなら、すべてのプロセスに関する詳細な情報を表示します。また、コアファイルが引数として指定されるなら、プロセスのコアファイルから抽出された情報を表示することができます。

デフォルトで、基本的なプロセス統計値が印刷 (表示) されます。次のオプションの 1 つは、印刷のための、より詳細なプロセス情報を選択するために指定されます:

-b
プロセスのためのバイナリ情報を表示します。
-c
プロセスのためのコマンド行引数を表示します。
-e
プロセスのための環境変数を表示します。
-f
プロセスのためのファイル記述子情報を表示します。
-i
プロセスのためのシグナルの保留中 (pending) とディスポジション (disposition) 情報を表示します。
-j
プロセススレッドのためのシグナルの保留中とブロックされた情報を表示します。
-k
現在 CPU で実行されているスレッドのスタックと、スタックがディスクにスワップされているスレッドを除いて、プロセス内のカーネルスレッドのスタックを表示します。フラグが繰り返されるなら、関数名と同様に関数オフセットが、印刷されます。
-l
プロセスのためのリソースの制限を表示します。
-s
プロセスのためのセキュリティ資格証明情報を表示します。
-t
プロセスのためのスレッド情報を表示します。
-v
プロセスのための仮想メモリマッピングを表示します。
-x
プロセスのための ELF の補助ベクタ (vector) を表示します。

すべてのオプションは、対応する情報の行へのプロセス ID である最初のフィールドをテーブルの形式で出力を生成します。 -h フラグは、テーブルヘッダを抑制するために使用されます。

-w フラグは、要求されたプロセス情報の印刷を繰り返すウェート間隔を指定するために使用されます。 -w フラグが指定されないなら、出力は、繰り返されません。

-C フラグは、ファイル記述子の視点で追加ケーパビリティ情報の印刷を要求します。

VM やファイル記述子の情報のような、何らかの情報は、プロセスの所有者またはスーパユーザだけが利用可能です。

バイナリ情報

プロセス ID、コマンドと、プロセスバイナリへのパスを表示します:

PID
プロセス ID
COMM
コマンド
OSREL
プロセスバイナリのための osreldate
PATH
プロセスバイナリへのパス (利用可能であるなら)

コマンド行引数

プロセス ID、コマンドと、コマンド行引数を表示します:

PID
プロセス ID
COMM
コマンド
ARGS
コマンド行引数 (利用可能であるなら)

ファイル記述子

プロセス ID、コマンド、ファイル記述子番号と、オブジェクトタイプまたはファイルシステムのパスのようなファイル毎の記述子のオブジェクト情報を含んで、プロセスによって参照される各ファイル記述子に関数詳しい情報を表示します。デフォルトで、次の情報が印刷されます:

PID
プロセス ID
COMM
コマンド
FD
ファイル記述子番号または cwd/root/jail
T
ファイル記述子タイプ
V
vnode タイプ
FLAGS
ファイル記述子フラグ
REF
ファイル記述子参照カウント
OFFSET
ファイル記述子オフセット
PRO
ネットワークプロトコル
NAME
ファイルパスまたはソケットアドレス (利用可能であるなら)

次のファイル記述子タイプが表示されます:

c
crypto (暗号)
e
POSIX semaphore (セマフォ)
f
fifo
h
shared memory (共有メモリ)
k
kqueue
m
message queue (メッセージキュー)
p
pipe (パイプ)
s
socket (ソケット)
t
pseudo-terminal master (疑似端末マスタ)
v
vnode

次の vnode タイプが表示されます:

-
not a vnode
b
block device (ブロックデバイス)
c
character device (キャラクタデバイス)
d
directory (ディレクトリ)
f
fifo
l
symbolic link (インボリックリンク)
r
regular file (通常ファイル)
s
socket (ソケット)
x
revoked device (破棄されたデバイス)

次のファイル記述子フラグが表示されます:

r
read (読み込み)
w
write (書き込み)
a
append (追加)
s
async (非同期)
f
fsync
n
non-blocking (ブロック化なし)
d
direct I/O (直接 I/O)
l
lock held (ロック保持)

-C フラグが指定されるなら、vnode タイプ、参照カウント、とオフセットフィールドは、省略され、新しいケーパビリティフィールドは、それぞれのケーパビリティ記述子のために存在している、 cap_rights_limit(2) で説明されるような、リストケーパビリティに含まれます。

シグナルディスポジション情報

次のプロセスのためのシグナルの保留中とディスポジションを表示します:

PID
プロセス ID
COMM
コマンド
SIG
シグナル名
FLAGS
3 つのシンボルがある、プロセスシグナルディスポジション詳細
P
シグナルがグローバルなプロセスキューで保留中であるなら、- そうでなければ
I
シグナル配信ディスポジションが SIGIGN であるなら、- そうでなければ
C
シグナル配信が、捕獲されることであるなら、- そうでなければ

-n スイッチが与えられるなら、シグナル名の代わりにシグナル番号を表示します。

スレッドシグナル情報

プロセススレッドのための保留中でブロックされているシグナルを表示します。

PID
プロセス ID
COMM
コマンド
TID
スレッド ID
SIG
シグナル名
FLAGS
2 つのシンボルがある、スレッドシグナル配信状態
P
シグナルがスレッドのために保留中であるなら、- そうでないなら
B
シグナルがスレッドシグナルマスクでブロックされているなら、- ブロックされていないなら

-n スイッチには -i スイッチと同じ効果があるなら、シグナル番号が、シグナル名の代わりに表示されます。

カーネルスレッドスタック

スレッドウェート (待ち) チャンネルのさらなる解釈を与えて、プロセスのカーネルスレッドスタックを表示します。 -k フラグが繰り返されるなら、関数名だけではなく、関数オフセットが、印刷されます。

この機能は、カーネルにコンパイルするために options STACK または options DDB を必要とします。

PID
プロセス ID
TID
スレッド ID
COMM
コマンド
TDNAME
スレッド名
KSTACK
カーネルスレッド呼び出しスタック

セキュリティ資格証明

プロセス資格証明情報を表示します:

PID
プロセス ID
COMM
コマンド
EUID
実効ユーザ ID
RUID
実ユーザ ID
SVUID
saved ユーザ ID
EGID
実効グループ ID
RGID
実グループ ID
SVGID
saved グループ ID
UMASK
ファイル作成モードマスク
FLAGS
資格証明フラグ
GROUPS
グループ set

次の資格証明フラグが表示されます:

C
ケーパビリティモード

スレッド情報

プロセス ID、スレッド毎の ID、名前、CPU と、実行状態を含む、スレッド毎の情報を表示します:

PID
プロセス ID
TID
スレッド ID
COMM
コマンド
TDNAME
スレッド名
CPU
現在または最新の CPU の実行
PRI
スレッド優先順位
STATE
スレッド状態
WCHAN
スレッドウェートチャネル

仮想メモリマッピング

アドレス、マッピングメタデータ、とマップされたオブジェクト情報を含む、プロセス仮想メモリマッピングを表示します:

PID
プロセス ID
START
マッピングの開始アドレス
END
マッピングの終了アドレス
PRT
保護フラグ
RES
常駐しているページ
PRES
プライベートの常駐しているページ
REF
参照カウント
SHD
シャドウページカウント
FL
マッピングフラグ
TP
VM オブジェクトタイプ

次の保護フラグが表示されます:

r
read (読み込み)
w
write (書き込み)
x
execute (実行)

次の VM オブジェクトタイプが表示されます:

--
none
dd
dead
df
default
dv
device
ph
physical
sg
scatter/gather
sw
swap
vn
vnode

次のマッピングフラグが表示されます:

C
copy-on-write
N
needs copy
S
1 つ以上のスーパページ (superpage) マッピングが使用されます
D
下に成長 (トップダウンスタック (top-down stack))
U
上に成長 (ボトムアップスタック (bottom-up stack))

終了ステータス

The procstat utility exits 0 on success, and >0 if an error occurs.

作者

Robert N M Watson

バグ

いくつかのフィールド値は、 procstat の出力が機械的に解析される範囲を制限する、空白を含みます。

オープンされたファイルまたはメモリマッピングパス名の表示は、カーネルの名前キャッシュを使用して実装されています。ファイルシステムが名前キャッシュを使用しないか、またはファイルへのパスが、キャッシュにないなら、パスは、表示されません。

procstat は、現在、カーネルのクラッシュダンプからではなく、生きているカーネルからのデータの抽出のみをサポートしています。

October 27, 2013 FreeBSD