OSDN Git Service

Update releases for LDP 3.68
[linuxjm/LDP_man-pages.git] / release / man2 / killpg.2
index 2e047b5..a64ce27 100644 (file)
@@ -1,6 +1,7 @@
 .\" 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:
@@ -28,6 +29,7 @@
 .\" 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
 .\"
 .\"     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
 .\" Updated & Modified Sat Feb  5 21:24:32 JST 2005
 .\"         by Yuichi SATO <ysato444@yahoo.co.jp>
 .\"
-.\"WORD:       process group           ¥×¥í¥»¥¹¡¦¥°¥ë¡¼¥×
-.\"WORD:       signal                  ¥·¥°¥Ê¥ë
-.\"WORD:       effective user ID       ¼Â¸ú¥æ¡¼¥¶¡¼ID
-.\"WORD:       super-user              ¥¹¡¼¥Ñ¡¼¡¦¥æ¡¼¥¶¡¼
-.\"
-.TH KILLPG 2 2010-09-20 "Linux" "Linux Programmer's Manual"
-.SH Ì¾Á°
-killpg \- ¥·¥°¥Ê¥ë¤ò¥×¥í¥»¥¹¡¦¥°¥ë¡¼¥×¤ËÁ÷¤ë
-.SH ½ñ¼°
-.B #include <signal.h>
+.TH KILLPG 2 2010\-09\-20 Linux "Linux Programmer's Manual"
+.SH 名前
+killpg \- シグナルをプロセス・グループに送る
+.SH 書式
+\fB#include <signal.h>\fP
 .sp
-.BI "int killpg(int " pgrp ", int " sig );
+\fBint killpg(int \fP\fIpgrp\fP\fB, int \fP\fIsig\fP\fB);\fP
 .sp
 .in -4n
-glibc ¸þ¤±¤Îµ¡Ç½¸¡ºº¥Þ¥¯¥í¤ÎÍ×·ï
-.RB ( feature_test_macros (7)
-»²¾È):
+glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7)  参照):
 .in
-.sp
 .ad l
-.TP 4
-.BR killpg ():
-_BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 ||
-_XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED
+.TP  4
+\fBkillpg\fP():
+_BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED
 .ad
-.SH ÀâÌÀ
-.BR killpg ()
-¤Ï
-.I sig
-¤Ç»ØÄꤷ¤¿¥·¥°¥Ê¥ë¤ò
-.I pgrp
-¤Ç»ØÄꤷ¤¿¥×¥í¥»¥¹¡¦¥°¥ë¡¼¥×¤ËÁ÷¤ë¡£
-¥·¥°¥Ê¥ë¤ÎÄêµÁ¤Î°ìÍ÷¤Ï
-.BR signal (7)
-¤ò»²¾È¤Î¤³¤È¡£
+.SH 説明
+\fBkillpg\fP()  は \fIsig\fP で指定したシグナルを \fIpgrp\fP で指定したプロセス・グループに送る。 シグナルの定義の一覧は
+\fBsignal\fP(7)  を参照のこと。
 
-°ú¤­¿ô
-.I pgrp
-¤Ë 0 ¤ò»ØÄꤷ¤¿¾ì¹ç¤Ë¤Ï
-.BR killpg ()
-¤Ï¸Æ¤Ó½Ð¤·¸µ¤Î¥×¥í¥»¥¹¤¬Â°¤·¤Æ¤¤¤ë¥×¥í¥»¥¹¡¦¥°¥ë¡¼¥×¤ËÂФ·¤Æ¥·¥°¥Ê¥ë¤òÁ÷¤ë¡£
-(POSIX ¤Ç¤Ï°Ê²¼¤Î¤è¤¦¤Ëµ­½Ò¤µ¤ì¤Æ¤¤¤ë:
-.I pgrp
-¤¬ 1 °Ê²¼¤Ç¤¢¤ë¾ì¹ç¡¢Æ°ºî¤Ï̤ÄêµÁ¤Ç¤¢¤ë¡£)
+引き数 \fIpgrp\fP に 0 を指定した場合には \fBkillpg\fP()
+は呼び出し元のプロセスが属しているプロセス・グループに対してシグナルを送る。 (POSIX では以下のように記述されている: \fIpgrp\fP が 1
+以下である場合、動作は未定義である。)
 
-¥×¥í¥»¥¹¤¬¥·¥°¥Ê¥ë¤òÁ÷¿®¤¹¤ëµö²Ä¤ò»ý¤Ä¤¿¤á¤Ë¤Ï¡¢
-¥×¥í¥»¥¹¤¬Æø¢ (Linux ¤Ç¤Ï
-.B CAP_KILL
-¥±¡¼¥Ñ¥Ó¥ê¥Æ¥£ (capability)) ¤ò»ý¤Ä¤«¡¢
-Á÷¿®¸µ¥×¥í¥»¥¹¤Î¼Â¥æ¡¼¥¶¡¼ ID ¤Þ¤¿¤Ï¼Â¸ú¥æ¡¼¥¶¡¼ ID ¤¬
-Á÷¿®Àè¥×¥í¥»¥¹¤Î¼Â set-user-ID ¤Þ¤¿¤ÏÊݸ set-user-ID ¤È
-Åù¤·¤¯¤Ê¤±¤ì¤Ð¤Ê¤é¤Ê¤¤¡£
-.B SIGCONT
-¤Î¾ì¹ç¡¢Á÷¿®¥×¥í¥»¥¹¤È¼õ¿®¥×¥í¥»¥¹¤¬
-Ʊ¤¸¥»¥Ã¥·¥ç¥ó¤Ë°¤·¤Æ¤¤¤ì¤Ð½½Ê¬¤Ç¤¢¤ë¡£
-.SH ÊÖ¤êÃÍ
-Àµ¾ï½ªÎ»¤¹¤ë¤È 0 ¤¬ÊÖ¤êÃͤȤʤ롣°Û¾ï½ªÎ»¤Î¾ì¹ç \-1 ¤¬ÊÖ¤êÃͤȤʤê
-.I errno
-¤Ë¸¶°ø¥³¡¼¥É¤¬ÀßÄꤵ¤ì¤ë¡£
-.SH ¥¨¥é¡¼
-.TP
-.B EINVAL
-.I sig
-¤Ç»ØÄꤵ¤ì¤¿ÃͤÏ̵¸ú¤Ê¥·¥°¥Ê¥ëÈÖ¹æ¤Ç¤¢¤ë¡£
-.TP
-.B EPERM
-¥×¥í¥»¥¹¤Ë²¿¤ì¤«¤ÎÁ÷¿®Àè¥×¥í¥»¥¹¤Ë¥·¥°¥Ê¥ë¤òÁ÷¿®¤¹¤ëµö²Ä¤¬¤Ê¤¤¡£
-.TP
-.B ESRCH
-.I pgrp
-¤Ç»ØÄꤵ¤ì¤¿¥×¥í¥»¥¹¡¦¥°¥ë¡¼¥×¤Ë°¤¹¤ë¥×¥í¥»¥¹¤¬Â¸ºß¤·¤Ê¤«¤Ã¤¿¡£
-.TP
-.B ESRCH
-¥×¥í¥»¥¹¡¦¥°¥ë¡¼¥×¤È¤·¤Æ 0 ¤¬»ØÄꤵ¤ì¤¿¤¬¡¢Á÷¿®¥×¥í¥»¥¹¤Ï
-¥×¥í¥»¥¹¡¦¥°¥ë¡¼¥×¤ò»ý¤Ã¤Æ¤¤¤Ê¤¤¡£
-.SH ½àµò
-SVr4, 4.4BSD
-.RB ( killpg ()
-¤Ï 4BSD ¤Ç½é¤á¤ÆÄɲ䵤줿), POSIX.1-2001¡£
-.SH Ãí°Õ
-BSD ·Ï¥·¥¹¥Æ¥à¤È System V ·Ï¥·¥¹¥Æ¥à¤Ç¤Ï¡¢
-µö²Ä¤Î¥Á¥§¥Ã¥¯¤ËÍÍ¡¹¤Ê°ã¤¤¤¬¤¢¤ë¡£
-.BR kill (2)
-¤Ë¤Ä¤¤¤Æ¤Î POSIX ¤Î¸¶Íý (rationale) ¤ò»²¾È¤¹¤ë¤³¤È¡£
-POSIX ¤Çµ­½Ò¤µ¤ì¤Æ¤¤¤Ê¤¤°ã¤¤¤È¤·¤Æ¤Ï¡¢ÊÖ¤êÃÍ
-.B EPERM
-¤¬¤¢¤ë¡£
-BSD ¤Ç¤Ï¡ÖÁ÷¿®Àè¥×¥í¥»¥¹¤Îµö²Ä¤Î¥Á¥§¥Ã¥¯¤¬ 1 ¤Ä¤Ç¤â¼ºÇÔ¤·¤¿¾ì¹ç¤Ï¡¢
-¥·¥°¥Ê¥ë¤¬Á÷¿®¤µ¤ì¤º¡¢
-.B EPERM
-¤¬ÊÖ¤µ¤ì¤ë¡×¤Èµ­½Ò¤µ¤ì¤Æ¤¤¤ë¡£
-POSIX ¤Ç¤Ï¡ÖÁ÷¿®Àè¥×¥í¥»¥¹¤Îµö²Ä¤Î¥Á¥§¥Ã¥¯¤¬Á´¤Æ¼ºÇÔ¤·¤¿¾ì¹ç¤Ë¤Î¤ß¡¢
-.B EPERM
-¤¬ÊÖ¤µ¤ì¤ë¡×¤Èµ­½Ò¤µ¤ì¤Æ¤¤¤ë¡£
+プロセスがシグナルを送信する許可を持つためには、 プロセスが特権 (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 ¤Ç¤Ï¡¢
-.BR killpg ()
-¤Ï¥é¥¤¥Ö¥é¥ê´Ø¿ô¤È¤·¤Æ¼ÂÁõ¤µ¤ì¤Æ¤ª¤ê¡¢
-.I "kill(-pgrp,\ sig)"
-¤Î¸Æ¤Ó½Ð¤·¤¬¹Ô¤ï¤ì¤ë¡£
-.SH ´ØÏ¢¹àÌÜ
-.BR getpgrp (2),
-.BR kill (2),
-.BR signal (2),
-.BR credentials (7),
-.BR capabilities (7)
+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.68 の一部である。
+プロジェクトの説明とバグ報告に関する情報は \%http://www.kernel.org/doc/man\-pages/ に書かれている。