pgrep(1)

pgrep, pkill − 名前によるプロセスの検索、およびシグナル送出

pgrep [−flnvx] [−G gid] [−M core] [−N system] [−P ppid] [−U uid] [−d delim] [−g pgrp] [−s sid] [−t tty] [−u euid] pattern ...

pkill [−signal] [−fnvx] [−G gid] [−M core] [−N system] [−P ppid] [−U uid] [−g pgrp] [−s sid] [−t tty] [−u euid] pattern ...

解説

pgrep コマンドは、稼働中のシステム上のプロセステーブルを検索し、コマンド ラインで指定された基準にマッチしたすべてのプロセス ID を表示します。

pkill コマンドは、稼働中のシステム上のプロセステーブルを検索し、コマンド ラインで指定された基準にマッチしたすべてのプロセスへシグナルを送ります。

以下のオプションを利用できます:

コンマ区切りのリスト gid で与えられた実グループ ID を持つプロセ スのみにマッチを限定します。

−P ppid
コンマ区切りのリスト ppid で与えられた親プロセス ID を持つプロ セスのみにマッチを限定します。

−M core
現在稼働中のシステムからではなく、指定したコアから名前リストに 関連した値を抽出します。

−N system
現在のシステムがブートしたカーネルイメージ (デフォルト) からで はなく、指定されたシステムから名前リストを抽出します。

−U uid
コンマ区切りのリスト uid で与えられた実ユーザ ID を持つプロセス のみにマッチを限定します。

−d delim
それぞれのプロセス ID の間に出力される区切り文字を指定します。 デフォルトは改行文字です。このオプションは、 pgrep コマンドでの み使用できます。

−f
完全な引数リストとマッチします。デフォルトでは、プロセス名と マッチします。

−g pgrp
コンマ区切りのリスト pgrp で与えられたプロセスグループ ID を持 つプロセスのみにマッチを限定します。 0 という値は、 pgrep, pkill コマンドが実行されているプロセスグループ ID を意味しま す。

−l
長い出力を行います。マッチしたそれぞれのプロセスのプロセス ID の他に、プロセス名も出力します。 −f オプションと組み合わせて使 用された場合、マッチしたそれぞれのプロセスのプロセス ID と完全 な引数リストを表示します。このオプションは、 pgrep コマンドでの み使用できます。

−n
もしプロセスが存在する場合、最も新しく生成されたプロセスにのみ マッチします。

−s sid
コンマ区切りのリスト sid で与えられたセッション ID を持つプロセ スのみにマッチを限定します。 0 という値は、 pgrep, pkill コマン ドが実行されているセッション ID を意味します。

−t tty
コンマ区切りのリスト tty で与えられた端末に関連づけられたプロセ スのみにマッチを限定します。端末名は ttyxx という形式でもよい し、短い xx という形式でも構いません。単一のダッシュ (‘-’) を指 定すると、端末に関連づけられていないプロセスにマッチします。

−u euid
コンマ区切りのリスト euid で与えられた実効ユーザ ID を持つプロ セスのみにマッチを限定します。

−v
マッチの条件を反転させます。つまり、与えられた基準にマッチしな いプロセスを出力します。

−x
プロセス名に厳密にマッチさせます。 −f オプションが指定されてい る場合は、引数リストに厳密にマッチさせます。デフォルトでは、す べての部分文字列にマッチします。

−signal
デフォルトの TERM の代わりに送出されるシグナルを指定する非負の 10 進数、もしくはシグナル名です。このオプションは、 pkill の最 初の引数として指定された時のみ有効です。

pattern オペランドを指定すると、各プロセスのコマンド名または引数リスト丸 ごとに一致させるための正規表現として使用されます。 −f オプションを指定し ない場合、 pattern を使いコマンド名との一致を試みます。しかしながら、現在 のところ、 FreeBSD は、各コマンドにつきコマンド名の最初の 19 文字しか保存 していません。コマンド名の最初の 19 文字より後ろとの一致を試みた場合、 黙って一致に失敗します。

実行中の pgrep も pkill も、自分自身やシステムプロセス (カーネルスレッド) をマッチの対象としないことに注意して下さい。

終了ステータス

pgrep と pkill ユーティリティは、終了の際に以下の値のどれかを返します:

1 つ以上のプロセスがマッチしました。

1
どのプロセスにもマッチしませんでした。

2
コマンドライン上で、不正なオプションが指定されました。

3
内部的なエラーが発生しました。

関連項目

kill(1), killall(1), ps(1), kill(2), sigaction(2), re_format(7)

pkill と pgrep ユーティリティは、 NetBSD 1.6 ではじめて登場しました。これ らは、Sun Solaris 7 に登場した同名のユーティリティを参考に作られました。 これらは FreeBSD 5.3 ではじめて登場しました。

Andrew Doran ⟨ad@NetBSD.org⟩

FreeBSD 10.0 March 25, 2004 FreeBSD 10.0