OSDN Git Service

(split) LDP: Update releases based on LDP 3.52 release
[linuxjm/LDP_man-pages.git] / release / man2 / sigsuspend.2
index 3fb41db..bd9869b 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
 .\"
-.\" 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"
-.SH Ì¾Á°
-sigsuspend \- ¥·¥°¥Ê¥ë¤òÂÔ¤Ä
-.SH ½ñ¼°
-.B #include <signal.h>
+.\" This file was generated with po4a. Translate the source file.
+.\"
+.\"*******************************************************************
+.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
-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
-.SH ÀâÌÀ
-.BR sigsuspend ()
-¤Ï¡¢¸Æ¤Ó½Ð¤·¸µ¥×¥í¥»¥¹¤Î¥·¥°¥Ê¥ë¥Þ¥¹¥¯¤ò
-.I mask
-¤Ç»ØÄꤵ¤ì¤¿¥Þ¥¹¥¯¤Ë°ì»þŪ¤ËÃÖ¤­´¹¤¨¡¢
-¥·¥°¥Ê¥ë¥Ï¥ó¥É¥é¤Îµ¯Æ°¤â¤·¤¯¤Ï¥×¥í¥»¥¹¤Î½ªÎ»¤¬¥¢¥¯¥·¥ç¥ó¤È¤·¤Æ
-ÀßÄꤵ¤ì¤¿¥·¥°¥Ê¥ë¤¬ÇÛÁ÷¤µ¤ì¤ë¤Þ¤Ç¡¢¤½¤Î¥×¥í¥»¥¹¤òÄä»ß¤¹¤ë¡£
+.SH 説明
+\fBsigsuspend\fP()  は、呼び出し元プロセスのシグナルマスクを \fImask\fP で指定されたマスクに一時的に置き換え、
+シグナルハンドラの起動もしくはプロセスの終了がアクションとして 設定されたシグナルが配送されるまで、そのプロセスを停止する。
 
-¥·¥°¥Ê¥ë¤¬¥×¥í¥»¥¹¤ò½ªÎ»¤µ¤»¤ë¤â¤Î¤Î¾ì¹ç¡¢
-.BR sigsuspend ()
-¤ÏÊÖ¤é¤Ê¤¤¡£¥·¥°¥Ê¥ë¤¬Ê᪤µ¤ì¤¿¾ì¹ç¡¢
-¥·¥°¥Ê¥ë¥Ï¥ó¥É¥é¤Î½èÍý¤¬½ª¤ï¤Ã¤¿¸å¤Ë
-.BR sigsuspend ()
-¤ÏÊ֤ꡢ¥·¥°¥Ê¥ë¥Þ¥¹¥¯¤Ï
-.BR sigsuspend ()
-¤¬¸Æ¤Ó½Ð¤µ¤ì¤ëÁ°¤Î¾õÂÖ¤ËÉü¸µ¤µ¤ì¤ë¡£
+シグナルがプロセスを終了させるものの場合、 \fBsigsuspend\fP()  は返らない。シグナルが捕捉された場合、
+シグナルハンドラの処理が終わった後に \fBsigsuspend\fP()  は返り、シグナルマスクは \fBsigsuspend\fP()
+が呼び出される前の状態に復元される。
 
-.B SIGKILL
-¤È
-.B SIGSTOP
-¤ò¶Ø»ß (block) ¤¹¤ë¤³¤È¤Ï¤Ç¤­¤Ê¤¤;
-¤³¤ì¤é¤Î¥·¥°¥Ê¥ë¤ò
-.I mask
-¤Ë»ØÄꤷ¤Æ¤â¡¢¥×¥í¥»¥¹¤Î¥·¥°¥Ê¥ë¥Þ¥¹¥¯¤Ï±Æ¶Á¤ò¼õ¤±¤Ê¤¤¡£
-.SH ÊÖ¤êÃÍ
-.BR sigsuspend ()
-¤Ï¾ï¤Ë \-1 ¤òÊÖ¤·¡¢Ä̾ï¤Ï
-.B EINTR
-¥¨¥é¡¼¤¬È¯À¸¤¹¤ë¡£
-.SH ¥¨¥é¡¼
-.TP
-.B EFAULT
-.I mask
-¤¬»Ø¤·¤Æ¤¤¤ë¥á¥â¥ê¤¬¡¢¥×¥í¥»¥¹¤Î¥¢¥É¥ì¥¹¶õ´Ö¤ÎÍ­¸ú¤ÊÉôʬ¤Ç¤Ï¤Ê¤¤¡£
-.TP
-.B EINTR
-¥·¥¹¥Æ¥à¥³¡¼¥ë¤Ï¥·¥°¥Ê¥ë¤Ë¤è¤ê³ä¤ê¹þ¤Þ¤ì¤¿¡£
-.SH ½àµò
-POSIX.1-2001.
-.SH Ãí°Õ
+\fBSIGKILL\fP と \fBSIGSTOP\fP を禁止 (block) することはできない; これらのシグナルを \fImask\fP
+に指定しても、プロセスのシグナルマスクは影響を受けない。
+.SH 返り値
+\fBsigsuspend\fP()  always returns \-1, with \fIerrno\fP set to inndicate the error
+(normally, \fBEINTR\fP).
+.SH エラー
+.TP 
+\fBEFAULT\fP
+\fImask\fP が指しているメモリが、プロセスのアドレス空間の有効な部分ではない。
+.TP 
+\fBEINTR\fP
+システムコールはシグナルにより割り込まれた。
+.SH 準拠
+POSIX.1\-2001.
+.SH 注意
 .PP
-.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
-¥·¥°¥Ê¥ë½¸¹ç¤ÎÁàºî¤Ë´Ø¤¹¤ë¾ÜºÙ¤Ï
-.BR sigsetops (3)
-¤ò»²¾È¤Î¤³¤È¡£
-.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.52 の一部
+である。プロジェクトの説明とバグ報告に関する情報は
+http://www.kernel.org/doc/man\-pages/ に書かれている。