release/man2/kill.2

   1 .\" Hey Emacs! This file is -*- nroff -*- source.
   2 .\"
   3 .\" Copyright (c) 1992 Drew Eckhardt (drew@cs.colorado.edu), March 28, 1992
   4 .\"
   5 .\" Permission is granted to make and distribute verbatim copies of this
   6 .\" manual provided the copyright notice and this permission notice are
   7 .\" preserved on all copies.
   8 .\"
   9 .\" Permission is granted to copy and distribute modified versions of this
  10 .\" manual under the conditions for verbatim copying, provided that the
  11 .\" entire resulting derived work is distributed under the terms of a
  12 .\" permission notice identical to this one.
  13 .\"
  14 .\" Since the Linux kernel and libraries are constantly changing, this
  15 .\" manual page may be incorrect or out-of-date.  The author(s) assume no
  16 .\" responsibility for errors or omissions, or for damages resulting from
  17 .\" the use of the information contained herein.  The author(s) may not
  18 .\" have taken the same level of care in the production of this manual,
  19 .\" which is licensed free of charge, as they might when working
  20 .\" professionally.
  21 .\"
  22 .\" Formatted or processed versions of this manual, if unaccompanied by
  23 .\" the source, must acknowledge the copyright and authors of this work.
  24 .\"
  25 .\" Modified by Michael Haardt <michael@moria.de>
  26 .\" Modified by Thomas Koenig <ig25@rz.uni-karlsruhe.de>
  27 .\" Modified 1993-07-23 by Rik Faith <faith@cs.unc.edu>
  28 .\" Modified 1993-07-25 by Rik Faith <faith@cs.unc.edu>
  29 .\" Modified 1995-11-01 by Michael Haardt
  30 .\"  <michael@cantor.informatik.rwth-aachen.de>
  31 .\" Modified 1996-04-14 by Andries Brouwer <aeb@cwi.nl>
  32 .\"  [added some polishing contributed by Mike Battersby <mib@deakin.edu.au>]
  33 .\" Modified 1996-07-21 by Andries Brouwer <aeb@cwi.nl>
  34 .\" Modified 1997-01-17 by Andries Brouwer <aeb@cwi.nl>
  35 .\" Modified 2001-12-18 by Andries Brouwer <aeb@cwi.nl>
  36 .\" Modified 2002-07-24 by Michael Kerrisk <mtk.manpages@gmail.com>
  37 .\"     Added note on historical rules enforced when an unprivileged process
  38 .\"     sends a signal.
  39 .\" Modified 2004-06-16 by Michael Kerrisk <mtk.manpages@gmail.com>
  40 .\"     Added note on CAP_KILL
  41 .\" Modified 2004-06-24 by aeb
  42 .\" Modified, 2004-11-30, after idea from emmanuel.colbus@ensimag.imag.fr
  43 .\"
  44 .\"*******************************************************************
  45 .\"
  46 .\" This file was generated with po4a. Translate the source file.
  47 .\"
  48 .\"*******************************************************************
  49 .TH KILL 2 2009\-09\-15 Linux "Linux Programmer's Manual"
  50 .SH 名前
  51 kill \- プロセスにシグナルを送る
  52 .SH 書式
  53 .nf
  54 \fB#include <sys/types.h>\fP
  55 .br
  56 \fB#include <signal.h>\fP
  57 .sp
  58 \fBint kill(pid_t \fP\fIpid\fP\fB, int \fP\fIsig\fP\fB);\fP
  59 .fi
  60 .sp
  61 .in -4n
  62 glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7)  参照):
  63 .in
  64 .sp
  65 .ad l
  66 \fBkill\fP(): _POSIX_C_SOURCE\ >=\ 1 || _XOPEN_SOURCE || _POSIX_SOURCE
  67 .ad b
  68 .SH 説明
  69 システムコールの \fBkill\fP()  は、任意のプロセス・グループもしくはプロセスにシグナルを 送るのに使われる。
  70 .PP
  71 \fIpid\fP に正の値を指定した場合、シグナル \fIsig\fP が \fIpid\fP で指定された ID を持つプロセスに送られる。
  72 .PP
  73 \fIpid\fP に 0 を指定した場合、 呼び出し元のプロセスのプロセス・グループに属するすべてのプロセスに \fIsig\fP で指定したシグナルが送られる。
  74 .PP
  75 \fIpid\fP に \-1 を指定した場合、 \fIsig\fP で指定したシグナルが、 呼び出し元のプロセスがシグナルを送る許可を持つ全てのプロセスに
  76 送られる。但し、プロセス番号 1 (\fIinit\fP) へはシグナルは送られない。 以下の関連部分も参照のこと。
  77 .PP
  78 \fIpid\fP に \-1 より小さな値を指定した場合、 ID が \fI\-pid\fP のプロセス・グループに属するすべてのプロセスに \fIsig\fP
  79 で指定したシグナルが送られる。
  80 .PP
  81 \fIsig\fP に 0 を指定した場合、シグナルは送られないが、 エラーのチェックは行われる。これを使って、プロセス ID や プロセスグループ ID
  82 の存在確認を行うことができる。
  83
  84 プロセスがシグナルを送信する許可を持つためには、 プロセスが特権 (Linux では \fBCAP_KILL\fP ケーパビリティ (capability))
  85 を持つか、 送信元プロセスの実ユーザー ID または実効ユーザー ID が 送信先プロセスの実 set\-user\-ID または保存
  86 set\-user\-ID と 等しくなければならない。 \fBSIGCONT\fP の場合、送信プロセスと受信プロセスが
  87 同じセッションに属していれば十分である。
  88 .SH 返り値
  89 成功した場合 (少なくとも一つのシグナルが送信された場合)、 0 が返される。エラーの場合 \-1 が返され、 \fIerrno\fP が適切に設定される。
  90 .SH エラー
  91 .TP
  92 \fBEINVAL\fP
  93 無効なシグナルを指定した。
  94 .TP
  95 \fBEPERM\fP
  96 プロセスが、受信するプロセスのいずれに対しても シグナルを送る許可を持っていない。
  97 .TP
  98 \fBESRCH\fP
  99 指定したプロセスまたはプロセス・グループが存在しなかった。 ゾンビプロセスは存在するプロセスとしてみなされる。
 100 ゾンビプロセスとはすでに処理は終了しているが、親プロセスによる \fBwait\fP()  処理が行われていないプロセスのことである。
 101 .SH 準拠
 102 SVr4, 4.3BSD, POSIX.1\-2001.
 103 .SH 注意
 104 プロセス番号 1 の \fIinit\fP プロセスに送ることができるシグナルは、 \fIinit\fP が明示的にシグナルハンドラを設定したシグナルだけである。
 105 こうなっているのは、誤ってシステムをダウンさせないようにするためである。
 106 .LP
 107 POSIX.1\-2001 では、 \fIkill(\-1,sig)\fP が 呼び出し元のプロセスがシグナルを送ることが出来るプロセス全てに \fIsig\fP
 108 を送ることを要求している。 但し、システム実装時に定められたシステムプロセスは シグナルの送信対象から除外される。 Linux
 109 では、プロセスが自分自身にシグナルを送れるようになっているが、 Linux の \fIkill(\-1,sig)\fP
 110 は呼び出し元のプロセスにはシグナルを送らない。
 111 .LP
 112 POSIX.1\-2001 では以下の動作になることを要求している。 自分自身にシグナルを送ると、シグナルを送ったスレッドがそのシグナルをブロック
 113 しておらず、他のどのスレッドもそのシグナルを受ける状態にもなく \fBsigwait\fP(3)  でそのシグナルを待ってもいない場合、 \fBkill\fP()
 114 が返る前に少なくとも一つのブロックされていない シグナルがシグナルを送ったスレッドに配送されなければならない。
 115 .SS "Linux での注意"
 116 .\" In the 0.* kernels things chopped and changed quite
 117 .\" a bit - MTK, 24 Jul 02
 118 Linux では、特権のないプロセスが他のプロセスにシグナルを送信するために 必要な権限についてのルールが、カーネルバージョンにより違っている。
 119 カーネル 1.0 から 1.2.2 では、送信側の実効ユーザーID が受信側の 実効ユーザー IDと一致すればシグナルを送信できた。 カーネル
 120 1.2.3 から 1.3.77では、送信側の実効ユーザーID が受信側の 実ユーザーID か実効ユーザーID
 121 のいずれかと一致すればシグナルを送信できた。 現在のルールは、POSIX.1\-2001 に準拠しており、カーネル 1.3.78 以降で 適用されている。
 122 .SH バグ
 123 バージョン 2.6.7 以前の 2.6 系のカーネルには、 プロセスグループにシグナルを送ったときに、 呼び出し元のプロセスがプロセスグループの
 124 (全メンバーではなく) 一部のメンバー に対してのみシグナルを送る許可を持っている場合に、 \fBkill\fP()  がエラー \fBEPERM\fP
 125 で失敗するというバグがある。 このエラーが返るにもかかわらず、そのシグナルは呼び出し元が シグナルを送る許可を持つ全てのプロセスへ送られる。
 126 .SH 関連項目
 127 \fB_exit\fP(2), \fBkillpg\fP(2), \fBsignal\fP(2), \fBtkill\fP(2), \fBexit\fP(3),
 128 \fBsigqueue\fP(3), \fBcredentials\fP(7), \fBcapabilities\fP(7), \fBsignal\fP(7)