OSDN Git Service

Update README
[linuxjm/LDP_man-pages.git] / release / man3 / sigpause.3
index d003dbe..9964f61 100644 (file)
@@ -1,5 +1,6 @@
 .\" Copyright (C) 2004 Andries Brouwer (aeb@cwi.nl)
 .\"
+.\" %%%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
+.\"
+.\"*******************************************************************
+.\"
+.\" This file was generated with po4a. Translate the source file.
+.\"
+.\"*******************************************************************
 .\"
 .\" Japanese Version Copyright (c) 1997 HANATAKA Shinya
 .\"         all rights reserved.
 .\"   Catch up to LDP man-pages 2.16
 .\"   Rename sigpause.2 to sigpause.3, and modified a little.
 .\"
-.\"WORD:       signal                  ¥·¥°¥Ê¥ë
-.\"WORD:       interrupt               ³ä¤ê¹þ¤ß
-.\"WORD:       mask                    ¥Þ¥¹¥¯
-.\"WORD:       block                   ¥Ö¥í¥Ã¥¯¤¹¤ë
-.\"
-.TH SIGPAUSE 3 2005-12-01 "Linux" "Linux Programmer's Manual"
-.SH Ì¾Á°
-sigpause \- ¥Ö¥í¥Ã¥¯¤µ¤ì¤¿¥·¥°¥Ê¥ë¤ò¥¢¥È¥ß¥Ã¥¯¤Ë²òÊü¤·¤Æ³ä¤ê¹þ¤ß¤òÂÔ¤Ä
-.SH ½ñ¼°
+.TH SIGPAUSE 3 2014\-08\-19 Linux "Linux Programmer's Manual"
+.SH 名前
+sigpause \- ブロックされたシグナルをアトミックに解放して割り込みを待つ
+.SH 書式
 .nf
-.B #include <signal.h>
+\fB#include <signal.h>\fP
 .sp
-.BI "int sigpause(int " sigmask ");  /* BSD */"
+\fBint sigpause(int \fP\fIsigmask\fP\fB);  /* BSD (ただし「備考」を参照) */\fP
 .sp
-.BI "int sigpause(int " sig ");      /* System V / Unix95 */"
+\fBint sigpause(int \fP\fIsig\fP\fB);      /* System V / UNIX 95 */\fP
 .fi
-.SH ÀâÌÀ
-¤³¤Î´Ø¿ô¤ò»È¤ï¤Ê¤¤¤³¤È¡£
-Âå¤ï¤ê¤Ë
-.BR sigsuspend (2)
-¤ò»È¤¦¤³¤È¡£
+.SH 説明
+この関数を使わないこと。 代わりに \fBsigsuspend\fP(2)  を使うこと。
 .LP
-´Ø¿ô
-.BR sigpause ()
-¤Ï¥·¥°¥Ê¥ë¤òÂԤĤ褦¤ËÀ߷פµ¤ì¤Æ¤¤¤ë¡£
-¤³¤Î´Ø¿ô¤Ï¥×¥í¥»¥¹¤Î¥·¥°¥Ê¥ë¥Þ¥¹¥¯ (¥Ö¥í¥Ã¥¯¤µ¤ì¤¿¥·¥°¥Ê¥ë¤Î¥»¥Ã¥È) ¤òÊѹ¹¤·¡¢
-¥·¥°¥Ê¥ë¤¬ÅþÃ夹¤ë¤Î¤òÂԤġ£
-¥·¥°¥Ê¥ë¤¬ÅþÃ夹¤ë¤È¡¢¥·¥°¥Ê¥ë¥Þ¥¹¥¯¤Ï¸µ¤ËÌᤵ¤ì¤ë¡£
-.SH ÊÖ¤êÃÍ
-.BR sigpause ()
-¤¬Ê֤俾ì¹ç¡¢¤³¤Î´Ø¿ô¤Ï¥·¥°¥Ê¥ë¤Ë¤è¤Ã¤Æ³ä¤ê¹þ¤Þ¤ì¤Æ¤¤¤ë¡£
-ÊÖ¤êÃͤϠ\-1 ¤Ç¡¢
-.I errno
-¤Ï
-.B EINTR
-¤ËÀßÄꤵ¤ì¤ë¡£
-.SH ½àµò
-System V ÈǤÎ
-.BR sigpause ()
-¤Ï POSIX.1-2001 ¤Çɸ½à²½¤µ¤ì¤Æ¤¤¤ë¡£
-.SH È÷¹Í
-.SS Îò»Ë
-¤³¤Î´Ø¿ô¤Î¸ÅŵŪ¤Ê BSD ÈǤϠ4.2BSD ¤ÇÅо줷¤¿¡£
-¤³¤Î´Ø¿ô¤Ï¥×¥í¥»¥¹¤Î¥·¥°¥Ê¥ë¥Þ¥¹¥¯¤ò
-.I sigmask
-¤ËÀßÄꤹ¤ë¡£
-Unix95 ¤Ç¤Ï BSD ÈǤȸߴ¹À­¤Î¤Ê¤¤ System V ÈǤΤ³¤Î´Ø¿ô¤¬É¸½à²½¤µ¤ì¤¿¡£
-Unix95 ÈǤϡ¢»ØÄꤵ¤ì¤¿¥·¥°¥Ê¥ë
-.I sig
-¤ò¥×¥í¥»¥¹¤Î¥·¥°¥Ê¥ë¥Þ¥¹¥¯¤«¤éºï½ü¤¹¤ë¤À¤±¤Ç¤¢¤ë¡£
-.\" __xpg_sigpause: Unix 95, spec 1170, SVID, SVr4, XPG
-Ʊ¤¸Ì¾Á°¤Ç¸ß´¹À­¤Î¤Ê¤¤ 2 ¤Ä¤Î´Ø¿ô¤¬¤¢¤ë¤È¤¤¤¦ÉÔ¹¬¤Ê»öÂ֤ϡ¢
-.BR \%sigsuspend (2)
-´Ø¿ô¤Ë¤è¤Ã¤Æ²ò¾Ã¤µ¤ì¤¿¡£
-¤³¤Î´Ø¿ô¤Ï
-.RI ( int
-¤ÎÂå¤ï¤ê¤Ë)
-.B "sigset_t *"
-°ú¤­¿ô¤ò¤È¤ë¡£
-.SS Linux ¤Ç¤ÎÃí°Õ
-Linux ¤Ç¤Ï¡¢¤³¤Î¥ë¡¼¥Á¥ó¤Ï Sparc (sparc64) ¥¢¡¼¥­¥Æ¥¯¥Á¥ã¤Ç¤Î¤ß
-¥·¥¹¥Æ¥à¥³¡¼¥ë¤È¤Ê¤Ã¤Æ¤¤¤ë¡£
-
-libc4 ¤È libc5 ¤Ë¤Ï BSD ÈǤ·¤«¤Ê¤¤¡£
+関数 \fBsigpause\fP()  はシグナルを待つように設計されている。 この関数はプロセスのシグナルマスク (ブロックされたシグナルのセット)
+を変更し、 シグナルが到着するのを待つ。 シグナルが到着すると、シグナルマスクは元に戻される。
+.SH 返り値
+\fBsigpause\fP()  が返った場合、この関数はシグナルによって割り込まれている。 返り値は \-1 で、 \fIerrno\fP は \fBEINTR\fP
+に設定される。
+.SH 属性
+.SS "マルチスレッディング (pthreads(7) 参照)"
+\fBsigpause\fP() 関数はスレッドセーフである。
+.SH 準拠
+System V 版の \fBsigpause\fP()  は POSIX.1\-2001 で標準化されている。
+.SH 注意
+.SS 歴史
+.\" __xpg_sigpause: UNIX 95, spec 1170, SVID, SVr4, XPG
+この関数の古典的な BSD 版は 4.2BSD で登場した。 この関数はプロセスのシグナルマスクを \fIsigmask\fP に設定する。 UNIX 95
+では BSD 版と互換性のない System V 版のこの関数が標準化された。 UNIX 95 版は、指定されたシグナル \fIsig\fP
+をプロセスのシグナルマスクから削除するだけである。 同じ名前で互換性のない 2 つの関数があるという不幸な事態は、 \fB\%sigsuspend\fP(2)
+関数によって解消された。 この関数は (\fIint\fP の代わりに)  \fBsigset_t\ *\fP 引き数をとる。
+.SS "Linux での注意"
+Linux では、このルーチンは Sparc (sparc64) アーキテクチャーでのみ システムコールとなっている。
 
-µ¡Ç½¸¡ºº¥Þ¥¯¥í
-.B _BSD_SOURCE
-¤¬ÄêµÁ¤µ¤ì¡¢
-.BR _POSIX_SOURCE ,
-.BR _POSIX_C_SOURCE ,
-.BR _XOPEN_SOURCE ,
-.BR _GNU_SOURCE ,
-.B _SVID_SOURCE
-¤Î¤¤¤º¤ì¤âÄêµÁ¤µ¤ì¤Æ¤¤¤Ê¤¤¾ì¹ç¡¢
-glibc ¤Ï BSD ÈǤò»È¤¦¡£
-.B _XOPEN_SOURCE
-¤¬ÄêµÁ¤µ¤ì¤¿¾ì¹ç¡¢System V ÈǤò»ÈÍѤ¹¤ë¡£
+.\" Libc4 and libc5 know only about the BSD version.
+.\"
 .\"
-.\" BSD ÈǤǤϡ¢
-.\" .RI ¡Ö sigmask
-.\" ¤ò 0 ¤Ë¤·¤Æ¡¢¤É¤Î¥·¥°¥Ê¥ë¤â¥Ö¥í¥Ã¥¯¤µ¤ì¤Ê¤¤¤è¤¦¤Ë¤¹¤ë¡×
-.\" ¤È¤¤¤¦¤Î¤¬¤è¤¯»È¤ï¤ì¤ë¡£
-.SH ´ØÏ¢¹àÌÜ
-.BR kill (2),
-.BR sigaction (2),
-.BR sigprocmask (2),
-.BR sigsuspend (2),
-.BR sigblock (3),
-.BR sigvec (3),
-.BR feature_test_macros (7)
+.\" For the BSD version, one usually uses a zero
+.\" .I sigmask
+.\" to indicate that no signals are to be blocked.
+機能検査マクロ \fB_BSD_SOURCE\fP が定義され、 \fB_POSIX_SOURCE\fP, \fB_POSIX_C_SOURCE\fP,
+\fB_XOPEN_SOURCE\fP, \fB_GNU_SOURCE\fP, \fB_SVID_SOURCE\fP のいずれも定義されていない場合、 glibc は
+BSD 版を使う。 それ以外の場合には、System V 版を使用する (宣言を得るためには \fB_XOPEN_SOURCE\fP
+が定義されていなければならない)。 glibc 2.19 以降では、 \fI<signal.h>\fP では System V
+版だけが公開される。 BSD 版の \fBsigpause\fP() を使用していたアプリケーションは \fBsigsuspend\fP(2)
+を使用するように修正すべきである。
+.SH 関連項目
+\fBkill\fP(2), \fBsigaction\fP(2), \fBsigprocmask\fP(2), \fBsigsuspend\fP(2),
+\fBsigblock\fP(3), \fBsigvec\fP(3), \fBfeature_test_macros\fP(7)
+.SH この文書について
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.79 の一部である。
+プロジェクトの説明とバグ報告に関する情報は \%http://www.kernel.org/doc/man\-pages/ に書かれている。