OSDN Git Service

(split) LDP: Restore and add Copyrights for draft pages
[linuxjm/LDP_man-pages.git] / draft / man2 / sigsuspend.2
index 9969a56..49cb939 100644 (file)
@@ -2,6 +2,7 @@
 .\" based on earlier work by faith@cs.unc.edu and
 .\" Mike Battersby <mib@deakin.edu.au>
 .\"
+.\" %%%LICENSE_START(VERBATIM)
 .\" Permission is granted to make and distribute verbatim copies of this
 .\" manual provided the copyright notice and this permission notice are
 .\" preserved on all copies.
 .\"
 .\" Formatted or processed versions of this manual, if unaccompanied by
 .\" the source, must acknowledge the copyright and authors of this work.
+.\" %%%LICENSE_END
 .\"
 .\" 2005-09-15, mtk, Created new page by splitting off from sigaction.2
 .\"
+.\"*******************************************************************
+.\"
+.\" This file was generated with po4a. Translate the source file.
+.\"
+.\"*******************************************************************
+.\"
 .\" Japanese Version Copyright (c) 2005 Akihiro MOTOKI all rights reserved.
 .\" Translated 2005-10-03, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
 .\"
-.TH SIGSUSPEND 2 2008-08-29 "Linux" "Linux Programmer's Manual"
-.\"O .SH NAME
-.SH Ì¾Á°
-.\"O sigsuspend \- wait for a signal
-sigsuspend \- ¥·¥°¥Ê¥ë¤òÂÔ¤Ä
-.\"O .SH SYNOPSIS
-.SH ½ñ¼°
-.B #include <signal.h>
+.TH SIGSUSPEND 2 2013\-04\-19 Linux "Linux Programmer's Manual"
+.SH 名前
+sigsuspend \- シグナルを待つ
+.SH 書式
+\fB#include <signal.h>\fP
 .sp
-.BI "int sigsuspend(const sigset_t *" mask );
+\fBint sigsuspend(const sigset_t *\fP\fImask\fP\fB);\fP
 .sp
 .in -4n
-.\"O Feature Test Macro Requirements for glibc (see
-.\"O .BR feature_test_macros (7)):
-glibc ¸þ¤±¤Îµ¡Ç½¸¡ºº¥Þ¥¯¥í¤ÎÍ×·ï
-.RB ( feature_test_macros (7)
-»²¾È):
+glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7)  参照):
 .in
 .sp
 .ad l
-.BR sigsuspend ():
-_POSIX_C_SOURCE\ >=\ 1 || _XOPEN_SOURCE || _POSIX_SOURCE
+\fBsigsuspend\fP(): _POSIX_C_SOURCE\ >=\ 1 || _XOPEN_SOURCE ||
+_POSIX_SOURCE
 .ad b
-.\"O .SH DESCRIPTION
-.SH ÀâÌÀ
-.\"O .BR sigsuspend ()
-.\"O temporarily replaces the signal mask of the calling process with the
-.\"O mask given by
-.\"O .I mask
-.\"O and then suspends the process until delivery of a signal whose
-.\"O action is to invoke a signal handler or to terminate a process.
-.BR sigsuspend ()
-¤Ï¡¢¸Æ¤Ó½Ð¤·¸µ¥×¥í¥»¥¹¤Î¥·¥°¥Ê¥ë¥Þ¥¹¥¯¤ò
-.I mask
-¤Ç»ØÄꤵ¤ì¤¿¥Þ¥¹¥¯¤Ë°ì»þŪ¤ËÃÖ¤­´¹¤¨¡¢
-¥·¥°¥Ê¥ë¥Ï¥ó¥É¥é¤Îµ¯Æ°¤â¤·¤¯¤Ï¥×¥í¥»¥¹¤Î½ªÎ»¤¬¥¢¥¯¥·¥ç¥ó¤È¤·¤Æ
-ÀßÄꤵ¤ì¤¿¥·¥°¥Ê¥ë¤¬ÇÛÁ÷¤µ¤ì¤ë¤Þ¤Ç¡¢¤½¤Î¥×¥í¥»¥¹¤òÄä»ß¤¹¤ë¡£
+.SH 説明
+\fBsigsuspend\fP()  は、呼び出し元プロセスのシグナルマスクを \fImask\fP で指定されたマスクに一時的に置き換え、
+シグナルハンドラの起動もしくはプロセスの終了がアクションとして 設定されたシグナルが配送されるまで、そのプロセスを停止する。
 
-.\"O If the signal terminates the process, then
-.\"O .BR sigsuspend ()
-.\"O does not return.
-.\"O If the signal is caught, then
-.\"O .BR sigsuspend ()
-.\"O returns after the signal handler returns,
-.\"O and the signal mask is restored to the state before the call to
-.\"O .BR sigsuspend ().
-¥·¥°¥Ê¥ë¤¬¥×¥í¥»¥¹¤ò½ªÎ»¤µ¤»¤ë¤â¤Î¤Î¾ì¹ç¡¢
-.BR sigsuspend ()
-¤ÏÊÖ¤é¤Ê¤¤¡£¥·¥°¥Ê¥ë¤¬Ê᪤µ¤ì¤¿¾ì¹ç¡¢
-¥·¥°¥Ê¥ë¥Ï¥ó¥É¥é¤Î½èÍý¤¬½ª¤ï¤Ã¤¿¸å¤Ë
-.BR sigsuspend ()
-¤ÏÊ֤ꡢ¥·¥°¥Ê¥ë¥Þ¥¹¥¯¤Ï
-.BR sigsuspend ()
-¤¬¸Æ¤Ó½Ð¤µ¤ì¤ëÁ°¤Î¾õÂÖ¤ËÉü¸µ¤µ¤ì¤ë¡£
+シグナルがプロセスを終了させるものの場合、 \fBsigsuspend\fP()  は返らない。シグナルが捕捉された場合、
+シグナルハンドラの処理が終わった後に \fBsigsuspend\fP()  は返り、シグナルマスクは \fBsigsuspend\fP()
+が呼び出される前の状態に復元される。
 
-.\"O It is not possible to block
-.\"O .B SIGKILL
-.\"O or
-.\"O .BR SIGSTOP ;
-.\"O specifying these signals in
-.\"O .IR mask ,
-.\"O has no effect on the process's signal mask.
-.B SIGKILL
-¤È
-.B SIGSTOP
-¤ò¶Ø»ß (block) ¤¹¤ë¤³¤È¤Ï¤Ç¤­¤Ê¤¤;
-¤³¤ì¤é¤Î¥·¥°¥Ê¥ë¤ò
-.I mask
-¤Ë»ØÄꤷ¤Æ¤â¡¢¥×¥í¥»¥¹¤Î¥·¥°¥Ê¥ë¥Þ¥¹¥¯¤Ï±Æ¶Á¤ò¼õ¤±¤Ê¤¤¡£
-.\"O .SH "RETURN VALUE"
-.SH ÊÖ¤êÃÍ
-.\"O .BR sigsuspend ()
-.\"O always returns \-1, normally with the error
-.\"O .BR EINTR .
-.BR sigsuspend ()
-¤Ï¾ï¤Ë \-1 ¤òÊÖ¤·¡¢Ä̾ï¤Ï
-.B EINTR
-¥¨¥é¡¼¤¬È¯À¸¤¹¤ë¡£
-.\"O .SH ERRORS
-.SH ¥¨¥é¡¼
-.TP
-.B EFAULT
-.\"O .I mask
-.\"O points to memory which is not a valid part of the process address space.
-.I mask
-¤¬»Ø¤·¤Æ¤¤¤ë¥á¥â¥ê¤¬¡¢¥×¥í¥»¥¹¤Î¥¢¥É¥ì¥¹¶õ´Ö¤ÎÍ­¸ú¤ÊÉôʬ¤Ç¤Ï¤Ê¤¤¡£
-.TP
-.B EINTR
-.\"O The call was interrupted by a signal.
-¥·¥¹¥Æ¥à¥³¡¼¥ë¤Ï¥·¥°¥Ê¥ë¤Ë¤è¤ê³ä¤ê¹þ¤Þ¤ì¤¿¡£
-.\"O .SH "CONFORMING TO"
-.SH ½àµò
-POSIX.1-2001.
-.\"O .SH NOTES
-.SH Ãí°Õ
+\fBSIGKILL\fP と \fBSIGSTOP\fP を禁止 (block) することはできない; これらのシグナルを \fImask\fP
+に指定しても、プロセスのシグナルマスクは影響を受けない。
+.SH 返り値
+\fBsigsuspend\fP() は常に \-1 を返し、 \fIerrno\fP にエラーの原因を示す値 (通常は \fBEINTR\fP) を設定する。
+.SH エラー
+.TP 
+\fBEFAULT\fP
+\fImask\fP が指しているメモリが、プロセスのアドレス空間の有効な部分ではない。
+.TP 
+\fBEINTR\fP
+システムコールはシグナルにより割り込まれた。
+.SH 準拠
+POSIX.1\-2001.
+.SH 注意
 .PP
-.\"O Normally,
-.\"O .BR sigsuspend ()
-.\"O is used in conjunction with
-.\"O .BR sigprocmask (2)
-.\"O in order to prevent delivery of a signal during the execution of a
-.\"O critical code section.
-.\"O The caller first blocks the signals with
-.\"O .BR sigprocmask (2).
-.\"O When the critical code has completed, the caller then waits for the
-.\"O signals by calling
-.\"O .BR sigsuspend ()
-.\"O with the signal mask that was returned by
-.\"O .BR sigprocmask (2)
-.\"O (in the
-.\"O .I oldset
-.\"O argument).
-.BR sigsuspend ()
-¤Ï¡¢Ä̾¥¯¥ê¥Æ¥£¥«¥ë¡¦¥³¡¼¥É¡¦¥»¥¯¥·¥ç¥ó (critical code section) ¤Î
-¼Â¹ÔÃæ¤Ë¥·¥°¥Ê¥ë¤¬ÇÛÁ÷¤µ¤ì¤ë¤Î¤òËɻߤ¹¤ë¤¿¤á¤Ë¡¢
-.BR sigprocmask (2)
-¤ÈÁȤ߹ç¤ï¤»¤Æ»ÈÍѤµ¤ì¤ë¡£
-¤Þ¤ººÇ½é¤Ë¡¢¸Æ¤Ó½Ð¤·¸µ¤Ï
-.BR sigprocmask (2)
-¤ò»È¤Ã¤Æ¥·¥°¥Ê¥ë¤ò¶Ø»ß¤¹¤ë¡£
-¥¯¥ê¥Æ¥£¥«¥ë¡¦¥³¡¼¥É¤¬´°Î»¤¹¤ë¤È¡¢¸Æ¤Ó½Ð¤·¸µ¤Ï
-.BR sigprocmask (2)
-¤¬
-.RI ( oldset
-°ú¤­¿ô¤Ç) ÊÖ¤¹¥·¥°¥Ê¥ë¥Þ¥¹¥¯¤ò»ØÄꤷ¤Æ
-.BR sigsuspend ()
-¤ò¸Æ¤Ó½Ð¤¹¤³¤È¤Ç¡¢¥¯¥ê¥Æ¥£¥«¥ë¡¦¥³¡¼¥É¼Â¹ÔÃæ¤ËȯÀ¸¤·¤¿
-¥·¥°¥Ê¥ë¤òÂԤĤ³¤È¤¬¤Ç¤­¤ë¡£
+\fBsigsuspend\fP()  は、通常、クリティカル・コード・セクション (critical code section) の
+実行中にシグナルが配送されるのを防止するために、 \fBsigprocmask\fP(2)  と組み合わせて使用される。 まず最初に、呼び出し元は
+\fBsigprocmask\fP(2)  を使ってシグナルを禁止する。 クリティカル・コードが完了すると、呼び出し元は \fBsigprocmask\fP(2)
+が (\fIoldset\fP 引き数で) 返すシグナルマスクを指定して \fBsigsuspend\fP()
+を呼び出すことで、クリティカル・コード実行中に発生した シグナルを待つことができる。
 .PP
-.\"O See
-.\"O .BR sigsetops (3)
-.\"O for details on manipulating signal sets.
-¥·¥°¥Ê¥ë½¸¹ç¤ÎÁàºî¤Ë´Ø¤¹¤ë¾ÜºÙ¤Ï
-.BR sigsetops (3)
-¤ò»²¾È¤Î¤³¤È¡£
-.\"O .SH "SEE ALSO"
-.SH ´ØÏ¢¹àÌÜ
-.BR kill (2),
-.BR pause (2),
-.BR sigaction (2),
-.BR signal (2),
-.BR sigprocmask (2),
-.BR sigwaitinfo (2),
-.BR sigsetops (3),
-.BR sigwait (3),
-.BR signal (7)
+シグナル集合の操作に関する詳細は \fBsigsetops\fP(3)  を参照のこと。
+.SH 関連項目
+\fBkill\fP(2), \fBpause\fP(2), \fBsigaction\fP(2), \fBsignal\fP(2), \fBsigprocmask\fP(2),
+\fBsigwaitinfo\fP(2), \fBsigsetops\fP(3), \fBsigwait\fP(3), \fBsignal\fP(7)
+.SH この文書について
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.53 の一部
+である。プロジェクトの説明とバグ報告に関する情報は
+http://www.kernel.org/doc/man\-pages/ に書かれている。