.\" Copyright (c) 1980, 1991 Regents of the University of California. .\" All rights reserved. .\" .\" %%%LICENSE_START(BSD_4_CLAUSE_UCB) .\" 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 University of .\" California, Berkeley and its contributors. .\" 4. Neither the name of the University 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 REGENTS 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 REGENTS 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. .\" %%%LICENSE_END .\" .\" @(#)killpg.2 6.5 (Berkeley) 3/10/91 .\" .\" Modified Fri Jul 23 21:55:01 1993 by Rik Faith .\" Modified Tue Oct 22 08:11:14 EDT 1996 by Eric S. Raymond .\" Modified 2004-06-16 by Michael Kerrisk .\" Added notes on CAP_KILL .\" Modified 2004-06-21 by aeb .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .\" .\" Japanese Version Copyright (c) 1997 Kazuyuki Tanisako .\" all rights reserved. .\" Translated Sat May 17 14:10:42 JST 1997 .\" by Kazuyuki Tanisako .\" Updated & Modified Sat Feb 5 21:24:32 JST 2005 .\" by Yuichi SATO .\" .TH KILLPG 2 2010\-09\-20 Linux "Linux Programmer's Manual" .SH 名前 killpg \- シグナルをプロセスグループに送る .SH 書式 \fB#include \fP .sp \fBint killpg(int \fP\fIpgrp\fP\fB, int \fP\fIsig\fP\fB);\fP .sp .in -4n glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7) 参照): .in .ad l .TP 4 \fBkillpg\fP(): _BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED .ad .SH 説明 \fBkillpg\fP() は \fIsig\fP で指定したシグナルを \fIpgrp\fP で指定したプロセスグループに送る。 シグナルの定義の一覧は \fBsignal\fP(7) を参照のこと。 引き数 \fIpgrp\fP に 0 を指定した場合には \fBkillpg\fP() は呼び出し元のプロセスが属しているプロセスグループに対してシグナルを送る。 (POSIX では以下のように記述されている: \fIpgrp\fP が 1 以下である場合、動作は未定義である。) プロセスがシグナルを送信する許可を持つためには、 プロセスが特権 (Linux では \fBCAP_KILL\fP ケーパビリティ (capability)) を持つか、 送信元プロセスの実ユーザー ID または実効ユーザー ID が 送信先プロセスの実 set\-user\-ID または保存 set\-user\-ID と 等しくなければならない。 \fBSIGCONT\fP の場合、送信プロセスと受信プロセスが 同じセッションに属していれば十分である。 .SH 返り値 成功した場合、0 が返される。エラーが発生した場合、\-1 が返され、 \fIerrno\fP が適切に設定される。 .SH エラー .TP \fBEINVAL\fP \fIsig\fP で指定された値は無効なシグナル番号である。 .TP \fBEPERM\fP プロセスが、受信するプロセスのいずれに対しても シグナルを送る許可を持っていない。 .TP \fBESRCH\fP \fIpgrp\fP で指定されたプロセスグループに属するプロセスが存在しなかった。 .TP \fBESRCH\fP プロセスグループとして 0 が指定されたが、送信プロセスは プロセスグループを持っていない。 .SH 準拠 SVr4, 4.4BSD (\fBkillpg\fP() は 4BSD で初めて追加された), POSIX.1\-2001。 .SH 注意 BSD 系システムと System\ V 系システムでは、 許可のチェックに様々な違いがある。 \fBkill\fP(2) についての POSIX の原理 (rationale) を参照すること。 POSIX で記述されていない違いとしては、返り値 \fBEPERM\fP がある。 BSD では「送信先プロセスの許可のチェックが 1 つでも失敗した場合は、 シグナルが送信されず、 \fBEPERM\fP が返される」と記述されている。 POSIX では「送信先プロセスの許可のチェックが全て失敗した場合にのみ、 \fBEPERM\fP が返される」と記述されている。 Linux では、 \fBkillpg\fP() はライブラリ関数として実装されており、 \fIkill(\-pgrp,\ sig)\fP の呼び出しが行われる。 .SH 関連項目 \fBgetpgrp\fP(2), \fBkill\fP(2), \fBsignal\fP(2), \fBcredentials\fP(7), \fBcapabilities\fP(7) .SH この文書について この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.79 の一部である。 プロジェクトの説明とバグ報告に関する情報は \%http://www.kernel.org/doc/man\-pages/ に書かれている。