OSDN Git Service

Update README
[linuxjm/LDP_man-pages.git] / draft / man3 / sigpause.3
index 6433ba9..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 2010-09-12 "Linux" "Linux Programmer's Manual"
-.\"O .SH NAME
+.TH SIGPAUSE 3 2014\-08\-19 Linux "Linux Programmer's Manual"
 .SH 名前
-.\"O sigpause \- atomically release blocked signals and wait for interrupt
 sigpause \- ブロックされたシグナルをアトミックに解放して割り込みを待つ
-.\"O .SH SYNOPSIS
 .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 / UNIX 95 */"
+\fBint sigpause(int \fP\fIsig\fP\fB);      /* System V / UNIX 95 */\fP
 .fi
-.\"O .SH DESCRIPTION
 .SH 説明
-.\"O Don't use this function.
-.\"O Use
-.\"O .BR sigsuspend (2)
-.\"O instead.
-この関数を使わないこと。
-代わりに
-.BR sigsuspend (2)
-を使うこと。
+この関数を使わないこと。 代わりに \fBsigsuspend\fP(2)  を使うこと。
 .LP
-.\"O The function
-.\"O .BR sigpause ()
-.\"O is designed to wait for some signal.
-関数
-.BR sigpause ()
-はシグナルを待つように設計されている。
-.\"O It changes the process's signal mask (set of blocked signals),
-.\"O and then waits for a signal to arrive.
-.\"O Upon arrival of a signal, the original signal mask is restored.
-この関数はプロセスのシグナルマスク (ブロックされたシグナルのセット) を変更し、
-シグナルが到着するのを待つ。
-シグナルが到着すると、シグナルマスクは元に戻される。
-.\"O .SH "RETURN VALUE"
+関数 \fBsigpause\fP()  はシグナルを待つように設計されている。 この関数はプロセスのシグナルマスク (ブロックされたシグナルのセット)
+を変更し、 シグナルが到着するのを待つ。 シグナルが到着すると、シグナルマスクは元に戻される。
 .SH 返り値
-.\"O If
-.\"O .BR sigpause ()
-.\"O returns, it was interrupted by a signal and the return value is \-1
-.\"O with
-.\"O .I errno
-.\"O set to
-.\"O .BR EINTR .
-.BR sigpause ()
-が返った場合、この関数はシグナルによって割り込まれている。
-返り値は \-1 で、
-.I errno
-は
-.B EINTR
+\fBsigpause\fP()  が返った場合、この関数はシグナルによって割り込まれている。 返り値は \-1 で、 \fIerrno\fP は \fBEINTR\fP
 に設定される。
-.\"O .SH CONFORMING TO
+.SH 属性
+.SS "マルチスレッディング (pthreads(7) 参照)"
+\fBsigpause\fP() 関数はスレッドセーフである。
 .SH 準拠
-.\"O The System V version of
-.\"O .BR sigpause ()
-.\"O is standardized in POSIX.1-2001.
-System V 版の
-.BR sigpause ()
-は POSIX.1-2001 で標準化されている。
-.\"O .SH NOTES
-.SH 備考
-.\"O .SS History
+System V 版の \fBsigpause\fP()  は POSIX.1\-2001 で標準化されている。
+.SH 注意
 .SS 歴史
-.\"O The classical BSD version of this function appeared in 4.2BSD.
-.\"O It sets the process's signal mask to
-.\"O .IR sigmask .
-.\"O UNIX 95 standardized the incompatible System V version of
-.\"O this function, which removes only the specified signal
-.\"O .I sig
-.\"O from the process's signal mask.
-.\"O .\" __xpg_sigpause: UNIX 95, spec 1170, SVID, SVr4, XPG
-.\"O The unfortunate situation with two incompatible functions with the
-.\"O same name was solved by the
-.\"O .BR \%sigsuspend (2)
-.\"O function, that takes a
-.\"O .I "sigset_t *"
-.\"O argument (instead of an
-.\"O .IR int ).
-この関数の古典的な BSD 版は 4.2BSD で登場した。
-この関数はプロセスのシグナルマスクを
-.I sigmask
-に設定する。
-UNIX 95 では BSD 版と互換性のない System V 版のこの関数が標準化された。
-UNIX 95 版は、指定されたシグナル
-.I sig
-をプロセスのシグナルマスクから削除するだけである。
 .\" __xpg_sigpause: UNIX 95, spec 1170, SVID, SVr4, XPG
-同じ名前で互換性のない 2 つの関数があるという不幸な事態は、
-.BR \%sigsuspend (2)
-関数によって解消された。
-この関数は
-.RI ( int
-の代わりに)
-.B "sigset_t *"
-引き数をとる。
-.\"O .SS Linux Notes
-.SS Linux での注意
-.\"O On Linux, this routine is a system call only on the Sparc (sparc64)
-.\"O architecture.
-Linux では、このルーチンは Sparc (sparc64) アーキテクチャでのみ
-システムコールとなっている。
-
-.\"O Libc4 and libc5 only know about the BSD version.
-libc4 と libc5 には BSD 版しかない。
+この関数の古典的な 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) アーキテクチャーでのみ システムコールとなっている。
 
-.\"O Glibc uses the BSD version if the
-.\"O .B _BSD_SOURCE
-.\"O feature test macro is defined and none of
-.\"O .BR _POSIX_SOURCE ,
-.\"O .BR _POSIX_C_SOURCE ,
-.\"O .BR _XOPEN_SOURCE ,
-.\"O .BR _GNU_SOURCE ,
-.\"O or
-.\"O .B _SVID_SOURCE
-.\"O is defined.
-.\"O Otherwise, the System V version is used.
-機能検査マクロ
-.B _BSD_SOURCE
-が定義され、
-.BR _POSIX_SOURCE ,
-.BR _POSIX_C_SOURCE ,
-.BR _XOPEN_SOURCE ,
-.BR _GNU_SOURCE ,
-.B _SVID_SOURCE
-のいずれも定義されていない場合、
-glibc は BSD 版を使う。
-それ以外の場合には、System V 版を使用する。
+.\" Libc4 and libc5 know only about the BSD version.
+.\"
 .\"
-.\"O .\" For the BSD version, one usually uses a zero
-.\"O .\" .I sigmask
-.\"O .\" to indicate that no signals are to be blocked.
-.\" BSD 版では、
-.\" .RI 「 sigmask
-.\" を 0 にして、どのシグナルもブロックされないようにする」
-.\" というのがよく使われる。
-.\"O .SH "SEE ALSO"
+.\" 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 関連項目
-.BR kill (2),
-.BR sigaction (2),
-.BR sigprocmask (2),
-.BR sigsuspend (2),
-.BR sigblock (3),
-.BR sigvec (3),
-.BR feature_test_macros (7)
+\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/ に書かれている。