1 .\" Copyright (c) 1980, 1991 Regents of the University of California.
2 .\" All rights reserved.
4 .\" %%%LICENSE_START(BSD_4_CLAUSE_UCB)
5 .\" Redistribution and use in source and binary forms, with or without
6 .\" modification, are permitted provided that the following conditions
8 .\" 1. Redistributions of source code must retain the above copyright
9 .\" notice, this list of conditions and the following disclaimer.
10 .\" 2. Redistributions in binary form must reproduce the above copyright
11 .\" notice, this list of conditions and the following disclaimer in the
12 .\" documentation and/or other materials provided with the distribution.
13 .\" 3. All advertising materials mentioning features or use of this software
14 .\" must display the following acknowledgement:
15 .\" This product includes software developed by the University of
16 .\" California, Berkeley and its contributors.
17 .\" 4. Neither the name of the University nor the names of its contributors
18 .\" may be used to endorse or promote products derived from this software
19 .\" without specific prior written permission.
21 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
22 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
23 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
24 .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
25 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
26 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
27 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
28 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
29 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
30 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
34 .\" @(#)killpg.2 6.5 (Berkeley) 3/10/91
36 .\" Modified Fri Jul 23 21:55:01 1993 by Rik Faith <faith@cs.unc.edu>
37 .\" Modified Tue Oct 22 08:11:14 EDT 1996 by Eric S. Raymond <esr@thyrsus.com>
38 .\" Modified 2004-06-16 by Michael Kerrisk <mtk.manpages@gmail.com>
39 .\" Added notes on CAP_KILL
40 .\" Modified 2004-06-21 by aeb
42 .\"*******************************************************************
44 .\" This file was generated with po4a. Translate the source file.
46 .\"*******************************************************************
48 .\" Japanese Version Copyright (c) 1997 Kazuyuki Tanisako
49 .\" all rights reserved.
50 .\" Translated Sat May 17 14:10:42 JST 1997
51 .\" by Kazuyuki Tanisako <tanisako@osa.dec-j.co.jp>
52 .\" Updated & Modified Sat Feb 5 21:24:32 JST 2005
53 .\" by Yuichi SATO <ysato444@yahoo.co.jp>
55 .TH KILLPG 2 2010\-09\-20 Linux "Linux Programmer's Manual"
57 killpg \- シグナルをプロセス・グループに送る
59 \fB#include <signal.h>\fP
61 \fBint killpg(int \fP\fIpgrp\fP\fB, int \fP\fIsig\fP\fB);\fP
64 glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7) 参照):
69 _BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED
72 \fBkillpg\fP() は \fIsig\fP で指定したシグナルを \fIpgrp\fP で指定したプロセス・グループに送る。 シグナルの定義の一覧は
73 \fBsignal\fP(7) を参照のこと。
75 引き数 \fIpgrp\fP に 0 を指定した場合には \fBkillpg\fP()
76 は呼び出し元のプロセスが属しているプロセス・グループに対してシグナルを送る。 (POSIX では以下のように記述されている: \fIpgrp\fP が 1
79 プロセスがシグナルを送信する許可を持つためには、 プロセスが特権 (Linux では \fBCAP_KILL\fP ケーパビリティ (capability))
80 を持つか、 送信元プロセスの実ユーザー ID または実効ユーザー ID が 送信先プロセスの実 set\-user\-ID または保存
81 set\-user\-ID と 等しくなければならない。 \fBSIGCONT\fP の場合、送信プロセスと受信プロセスが
84 成功した場合、0 が返される。エラーが発生した場合、\-1 が返され、 \fIerrno\fP が適切に設定される。
88 \fIsig\fP で指定された値は無効なシグナル番号である。
91 プロセスが、受信するプロセスのいずれに対しても シグナルを送る許可を持っていない。
94 \fIpgrp\fP で指定されたプロセス・グループに属するプロセスが存在しなかった。
97 プロセス・グループとして 0 が指定されたが、送信プロセスは プロセス・グループを持っていない。
99 SVr4, 4.4BSD (\fBkillpg\fP() は 4BSD で初めて追加された), POSIX.1\-2001。
101 BSD 系システムと System\ V 系システムでは、 許可のチェックに様々な違いがある。 \fBkill\fP(2) についての POSIX の原理
102 (rationale) を参照すること。 POSIX で記述されていない違いとしては、返り値 \fBEPERM\fP がある。 BSD
103 では「送信先プロセスの許可のチェックが 1 つでも失敗した場合は、 シグナルが送信されず、 \fBEPERM\fP が返される」と記述されている。 POSIX
104 では「送信先プロセスの許可のチェックが全て失敗した場合にのみ、 \fBEPERM\fP が返される」と記述されている。
106 Linux では、 \fBkillpg\fP() はライブラリ関数として実装されており、 \fIkill(\-pgrp,\ sig)\fP の呼び出しが行われる。
108 \fBgetpgrp\fP(2), \fBkill\fP(2), \fBsignal\fP(2), \fBcredentials\fP(7),
109 \fBcapabilities\fP(7)
111 この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.76 の一部である。
112 プロジェクトの説明とバグ報告に関する情報は \%http://www.kernel.org/doc/man\-pages/ に書かれている。