名前

       kill - プロセスにシグナルを送る

書式

       #include <sys/types.h>
       #include <signal.h>

       int kill(pid_t pid, int sig);

   glibc 向けの機能検査マクロの要件 (feature_test_macros(7)  参照):

       kill(): _POSIX_C_SOURCE

説明

       システムコールの kill()  は、任意のプロセスグループもしくはプロセスにシグナルを 送るのに使われる。

       pid に正の値を指定した場合、シグナル sig が pid で指定された ID を持つプロセスに送られる。

       pid に 0 を指定した場合、 呼び出し元のプロセスのプロセスグループに属するすべてのプロセスに sig で指定した
       シグナルが送られる。

       pid に -1 を指定した場合、 sig で指定したシグナルが、  呼び出し元のプロセスがシグナルを送る許可を持つ全て
       のプロセスに  送られる。但し、プロセス番号  1  (init) へはシグナルは送られない。 以下の関連部分も参照のこ
       と。

       pid に -1 より小さな値を指定した場合、 ID が -pid のプロセスグループに属するすべてのプロセスに sig で指定
       したシグナルが送られる。

       If sig is 0, then no signal is sent, but existence and permission checks are still performed; this can be
       used to check for the existence of a process ID or process group ID  that  the  caller  is  permitted  to
       signal.

       For  a  process  to have permission to send a signal, it must either be privileged (under Linux: have the
       CAP_KILL capability in the user namespace of the target process), or the real or effective user ID of the
       sending  process must equal the real or saved set-user-ID of the target process.  In the case of SIGCONT,
       it suffices when the sending and receiving processes belong to  the  same  session.   (Historically,  the
       rules were different; see NOTES.)

返り値

       成功した場合  (少なくとも一つのシグナルが送信された場合)、 0 が返される。エラーの場合 -1 が返され、 errno
       が適切に設定される。

エラー

       EINVAL 無効なシグナルを指定した。

       EPERM  呼び出し元のプロセスが、受信するプロセスのいずれに対しても シグナルを送る許可を持っていない。

       ESRCH  The target process or process group does not exist.  Note that an  existing  process  might  be  a
              zombie, a process that has terminated execution, but has not yet been wait(2)ed for.

準拠

       POSIX.1-2001, POSIX.1-2008, SVr4, 4.3BSD.

注意

       プロセス番号 1 の init プロセスに送ることができるシグナルは、 init が明示的にシグナルハンドラーを設定した
       シグナルだけである。 こうなっているのは、誤ってシステムをダウンさせないようにするためである。

       POSIX.1 では、 kill(-1,sig) が 呼び出し元のプロセスがシグナルを送ることが出来るプロセス全てに sig  を送る
       ことを要求している。   但し、システム実装時に定められたシステムプロセスは  シグナルの送信対象から除外され
       る。 Linux では、プロセスが自分自身にシグナルを送れるようになっているが、 Linux の kill(-1,sig)  は呼び出
       し元のプロセスにはシグナルを送らない。

       POSIX.1 では以下の動作になることを要求している。 自分自身にシグナルを送ると、シグナルを送ったスレッドがそ
       のシグナルをブロック しておらず、他のどのスレッドもそのシグナルを受ける状態にもなく sigwait(3)   でそのシ
       グナルを待ってもいない場合、  kill()  が返る前に少なくとも一つのブロックされていない シグナルがシグナルを
       送ったスレッドに配送されなければならない。

   Linux での注意
       Linux  では、特権のないプロセスが他のプロセスにシグナルを送信するために必要な権限についてのルールが、カー
       ネルバージョンにより違っている。  カーネル  1.0 から 1.2.2 では、送信側の実効ユーザー ID が送信対象の実効
       ユーザー ID と一致するか、 送信側の実ユーザー ID が送信対象の実ユーザー ID と一致すれば、  シグナルを送信
       できた。 カーネル 1.2.3 から 1.3.77では、送信側の実効ユーザー ID が送信対象の実ユーザー ID か実効ユーザー
       ID のいずれかと一致すればシグナルを送信できた。 現在のルールは、POSIX.1  に準拠しており、カーネル  1.3.78
       以降で 適用されている。

バグ

       バージョン  2.6.7 以前の 2.6 系のカーネルには、 プロセスグループにシグナルを送ったときに、 呼び出し元のプ
       ロセスがプロセスグループの (全メンバーではなく)  一部のメンバーに対してのみシグナルを送る許可を持っていな
       い場合に、 kill()  がエラー EPERM で失敗するというバグがある。 このエラーが返るにもかかわらず、そのシグナ
       ルは呼び出し元が シグナルを送る許可を持つ全てのプロセスへ送られる。

関連項目

       kill(1),  _exit(2),  pidfd_send_signal(2),  signal(2),   tkill(2),   exit(3),   killpg(3),   sigqueue(3),
       capabilities(7), credentials(7), signal(7)

この文書について

       この  man ページは Linux man-pages プロジェクトのリリース 5.10 の一部である。プロジェクトの説明とバグ報告
       に関する情報は https://www.kernel.org/doc/man-pages/ に書かれている。