.\"	$NetBSD: pkill.1,v 1.8 2003/02/14 15:59:18 grant Exp $
.\"
.\" %FreeBSD: src/usr.bin/pkill/pkill.1,v 1.8 2004/08/16 04:49:43 gad Exp %
.\" $FreeBSD$
.\"
.\" Copyright (c) 2002 The NetBSD Foundation, Inc.
.\" All rights reserved.
.\"
.\" This code is derived from software contributed to The NetBSD Foundation
.\" by Andrew Doran.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\"    notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\"    notice, this list of conditions and the following disclaimer in the
.\"    documentation and/or other materials provided with the distribution.
.\" 3. All advertising materials mentioning features or use of this software
.\"    must display the following acknowledgement:
.\"        This product includes software developed by the NetBSD
.\"        Foundation, Inc. and its contributors.
.\" 4. Neither the name of The NetBSD Foundation nor the names of its
.\"    contributors may be used to endorse or promote products derived
.\"    from this software without specific prior written permission.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGE.
.\"
.Dd March 25, 2004
.Dt PKILL 1
.Os
.Sh 名称
.Nm pgrep , pkill
.Nd 名前によるプロセスの検索、およびシグナル送出
.Sh 書式
.Nm pgrep
.Op Fl flnvx
.Op Fl G Ar gid
.Op Fl M Ar core
.Op Fl N Ar system
.Op Fl P Ar ppid
.Op Fl U Ar uid
.Op Fl d Ar delim
.Op Fl g Ar pgrp
.Op Fl s Ar sid
.Op Fl t Ar tty
.Op Fl u Ar euid
.Ar pattern ...
.Nm pkill
.Op Fl Ar signal
.Op Fl fnvx
.Op Fl G Ar gid
.Op Fl M Ar core
.Op Fl N Ar system
.Op Fl P Ar ppid
.Op Fl U Ar uid
.Op Fl g Ar pgrp
.Op Fl s Ar sid
.Op Fl t Ar tty
.Op Fl u Ar euid
.Ar pattern ...
.Sh 解説
.Nm pgrep
コマンドは、稼働中のシステム上のプロセステーブルを検索し、
コマンドラインで指定された基準にマッチしたすべてのプロセス ID を表示します。
.Pp
.Nm pkill
コマンドは、稼働中のシステム上のプロセステーブルを検索し、
コマンドラインで指定された基準にマッチしたすべてのプロセスへシグナルを送ります。
.Pp
以下のオプションを利用できます:
.Bl -tag -width ".Fl d Ar delim"
.It Fl G Ar gid
コンマ区切りのリスト
.Ar gid
で与えられた実グループ ID を持つプロセスのみにマッチを限定します。
.It Fl P Ar ppid
コンマ区切りのリスト
.Ar ppid
で与えられた親プロセス ID を持つプロセスのみにマッチを限定します。
.It Fl M Ar core
現在稼働中のシステムからではなく、指定したコアから
名前リストに関連した値を抽出します。
.It Fl N Ar system
現在のシステムがブートしたカーネルイメージ (デフォルト) からではなく、
指定されたシステムから名前リストを抽出します。
.It Fl U Ar uid
コンマ区切りのリスト
.Ar uid
で与えられた実ユーザ ID を持つプロセスのみにマッチを限定します。
.It Fl d Ar delim
それぞれのプロセス ID の間に出力される区切り文字を指定します。
デフォルトは改行文字です。
このオプションは、
.Nm pgrep
コマンドでのみ使用できます。
.It Fl f
完全な引数リストとマッチします。
デフォルトでは、プロセス名とマッチします。
.It Fl g Ar pgrp
コンマ区切りのリスト
.Ar pgrp
で与えられたプロセスグループ ID を持つプロセスのみにマッチを限定します。
0 という値は、
.Nm pgrep ,
.Nm pkill
コマンドが実行されているプロセスグループ ID を意味します。
.It Fl l
長い出力を行います。
マッチしたそれぞれのプロセスのプロセス ID の他に、プロセス名も出力します。
.Fl f
オプションと組み合わせて使用された場合、マッチしたそれぞれのプロセスの
プロセス ID と完全な引数リストを表示します。
このオプションは、
.Nm pgrep
コマンドでのみ使用できます。
.It Fl n
もしプロセスが存在する場合、最も新しく生成されたプロセスにのみマッチします。
.It Fl s Ar sid
コンマ区切りのリスト
.Ar sid
で与えられたセッション ID を持つプロセスのみにマッチを限定します。
0 という値は、
.Nm pgrep ,
.Nm pkill
コマンドが実行されているセッション ID を意味します。
.It Fl t Ar tty
コンマ区切りのリスト
.Ar tty
で与えられた端末に関連づけられたプロセスのみにマッチを限定します。
端末名は
.Pa tty Ns Ar xx
という形式でもよいし、短い
.Ar xx
という形式でも構いません。
単一のダッシュ
.Pq Ql -
を指定すると、端末に関連づけられていないプロセスに
マッチします。
.It Fl u Ar euid
コンマ区切りのリスト
.Ar euid
で与えられた実効ユーザ ID を持つプロセスのみにマッチを限定します。
.It Fl v
マッチの条件を反転させます。
つまり、与えられた基準にマッチしないプロセスを出力します。
.It Fl x
プロセス名に厳密にマッチさせます。
.Fl f
オプションが指定されている場合は、引数リストに厳密にマッチさせます。
デフォルトでは、すべての部分文字列にマッチします。
.It Fl Ns Ar signal
デフォルトの
.Dv TERM
の代わりに送出されるシグナルを指定する
非負の 10 進数、もしくはシグナル名です。
このオプションは、
.Nm pkill
の最初の引数として指定された時のみ有効です。
.El
.Pp
.Ar pattern
オペランドを指定すると、各プロセスのコマンド名または引数リスト丸ごとに
一致させるための正規表現として使用されます。
.Fl f
オプションを指定しない場合、
.Ar pattern
を使いコマンド名との一致を試みます。
しかしながら、現在のところ、
.Fx
は、各コマンドにつきコマンド名の最初の 19 文字しか保存していません。
コマンド名の最初の 19 文字より後ろとの一致を試みた場合、
黙って一致に失敗します。
.Pp
実行中の
.Nm pgrep
も
.Nm pkill
も、自分自身やシステムプロセス (カーネルスレッド) を
マッチの対象としないことに注意して下さい。
.Sh 終了ステータス
.Nm pgrep
と
.Nm pkill
ユーティリティは、終了の際に以下の値のどれかを返します:
.Bl -tag -width indent
.It 0
1 つ以上のプロセスがマッチしました。
.It 1
どのプロセスにもマッチしませんでした。
.It 2
コマンドライン上で、不正なオプションが指定されました。
.It 3
内部的なエラーが発生しました。
.El
.Sh 関連項目
.Xr kill 1 ,
.Xr killall 1 ,
.Xr ps 1 ,
.Xr kill 2 ,
.Xr sigaction 2 ,
.Xr re_format 7
.Sh 歴史
.Nm pkill
と
.Nm pgrep
ユーティリティは、
.Nx 1.6
ではじめて登場しました。
これらは、Sun
Solaris 7
に登場した同名のユーティリティを参考に作られました。
これらは
.Fx 5.3
ではじめて登場しました。
.Sh 作者
.An Andrew Doran
.Aq ad@NetBSD.org