-'\" t
+.\" t
.\" Copyright (c) 2005 by Michael Kerrisk <mtk.manpages@gmail.com>
.\"
.\" Permission is granted to make and distribute verbatim copies of this
.\" Formatted or processed versions of this manual, if unaccompanied by
.\" the source, must acknowledge the copyright and authors of this work.
.\"
-.\" Japanese Version Copyright (c) 2005 Akihiro MOTOKI all rights reserved.
-.\" Translated 2005-12-04, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
+.\"*******************************************************************
.\"
-.TH SIGSET 3 2010-09-20 "Linux" "Linux Programmer's Manual"
-.\"O .SH NAME
+.\" This file was generated with po4a. Translate the source file.
+.\"
+.\"*******************************************************************
+.TH SIGSET 3 2010\-09\-20 Linux "Linux Programmer's Manual"
.SH 名前
-.\"O sigset, sighold, sigrelse, sigignore \- System V signal API
sigset, sighold, sigrelse, sigignore \- System V 版シグナル API
-.\"O .SH SYNOPSIS
.SH 書式
-.B #include <signal.h>
+\fB#include <signal.h>\fP
.sp
-.B typedef void (*sighandler_t)(int);
+\fBtypedef void (*sighandler_t)(int);\fP
.sp
-.BI "sighandler_t sigset(int " sig ", sighandler_t " disp );
+\fBsighandler_t sigset(int \fP\fIsig\fP\fB, sighandler_t \fP\fIdisp\fP\fB);\fP
.sp
-.BI "int sighold(int " sig );
+\fBint sighold(int \fP\fIsig\fP\fB);\fP
.sp
-.BI "int sigrelse(int " sig );
+\fBint sigrelse(int \fP\fIsig\fP\fB);\fP
.sp
-.BI "int sigignore(int " sig );
+\fBint sigignore(int \fP\fIsig\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 sigset (),
-.BR sighold (),
-.BR sigrelse (),
-.BR sigignore ():
+\fBsigset\fP(), \fBsighold\fP(), \fBsigrelse\fP(), \fBsigignore\fP():
.br
.RS 4
-_XOPEN_SOURCE\ >=\ 500 ||
-_XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED
+_XOPEN_SOURCE\ >=\ 500 || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED
.RE
.ad
-.\"O .SH DESCRIPTION
.SH 説明
-.\"O These functions are provided in glibc as a compatibility interface
-.\"O for programs that make use of the historical System V signal API.
-.\"O This API is obsolete: new applications should use the POSIX signal API
-.\"O .RB ( sigaction (2),
-.\"O .BR sigprocmask (2),
-.\"O etc.)
-これらの関数は、昔ながらの System V 版シグナル API を使用しているプログラム
-に対して互換性のあるインタフェースを glibc で提供するものである。
-この API は過去のものであり、新しいアプリケーションでは
-POSIX シグナル API
-.RB ( sigaction (2),
-.BR sigprocmask (2)
-など) を使用すべきである。
+これらの関数は、昔ながらの System V 版シグナル API を使用しているプログラム に対して互換性のあるインタフェースを glibc
+で提供するものである。 この API は過去のものであり、新しいアプリケーションでは POSIX シグナル API (\fBsigaction\fP(2),
+\fBsigprocmask\fP(2) など) を使用すべきである。
-.\"O The
-.\"O .BR sigset ()
-.\"O function modifies the disposition of the signal
-.\"O .IR sig .
-.\"O The
-.\"O .I disp
-.\"O argument can be the address of a signal handler function,
-.\"O or one of the following constants:
-関数
-.BR sigset ()
-はシグナル
-.I sig
-のシグナルハンドラの動作を変更する。
-.I disp
-引き数には、シグナルハンドラ関数のアドレスか、
-以下の定数のいずれか一つを指定できる。
-.TP
-.B SIG_DFL
-.\"O Reset the disposition of
-.\"O .I sig
-.\"O to the default.
-.I sig
-の動作をデフォルトにリセットする。
-.TP
-.B SIG_IGN
-.\"O Ignore
-.\"O .IR sig .
-.I sig
-を無視する。
-.TP
-.B SIG_HOLD
-.\"O Add
-.\"O .I sig
-.\"O to the process's signal mask, but leave the disposition of
-.\"O .I sig
-.\"O unchanged.
-そのプロセスのシグナルマスクに
-.I sig
-を追加するが、
-.I sig
-の動作は変更しない。
+関数 \fBsigset\fP() はシグナル \fIsig\fP のシグナルハンドラの動作を変更する。 \fIdisp\fP
+引き数には、シグナルハンドラ関数のアドレスか、 以下の定数のいずれか一つを指定できる。
+.TP
+\fBSIG_DFL\fP
+\fIsig\fP の動作をデフォルトにリセットする。
+.TP
+\fBSIG_IGN\fP
+\fIsig\fP を無視する。
+.TP
+\fBSIG_HOLD\fP
+そのプロセスのシグナルマスクに \fIsig\fP を追加するが、 \fIsig\fP の動作は変更しない。
.PP
-.\"O If
-.\"O .I disp
-.\"O specifies the address of a signal handler, then
-.\"O .I sig
-.\"O is added to the process's signal mask during execution of the handler.
-.I disp
-にシグナルハンドラのアドレスが指定された場合、
-シグナルハンドラの実行中は、そのプロセスのシグナルマスクに
-.I sig
-が追加される。
+\fIdisp\fP にシグナルハンドラのアドレスが指定された場合、 シグナルハンドラの実行中は、そのプロセスのシグナルマスクに \fIsig\fP が追加される。
.PP
-.\"O If
-.\"O .I disp
-.\"O was specified as a value other than
-.\"O .BR SIG_HOLD ,
-.\"O then
-.\"O .I sig
-.\"O is removed from the process's signal mask.
-.I disp
-に
-.B SIG_HOLD
-以外の値が指定された場合、
-そのプロセスのシグナルマスクから
-.I sig
-が削除される。
+\fIdisp\fP に \fBSIG_HOLD\fP 以外の値が指定された場合、 そのプロセスのシグナルマスクから \fIsig\fP が削除される。
.PP
-.\"O The dispositions for
-.\"O .B SIGKILL
-.\"O and
-.\"O .B SIGSTOP
-.\"O cannot be changed.
-シグナル
-.B SIGKILL
-と
-.B SIGSTOP
-に対する動作は変更できない。
+シグナル \fBSIGKILL\fP と \fBSIGSTOP\fP に対する動作は変更できない。
.PP
-.\"O The
-.\"O .BR sighold ()
-.\"O function adds
-.\"O .I sig
-.\"O to the calling process's signal mask.
-関数
-.BR sighold ()
-は、呼び出し元プロセスのシグナルマスクに
-.I sig
-を追加する。
+関数 \fBsighold\fP() は、呼び出し元プロセスのシグナルマスクに \fIsig\fP を追加する。
-.\"O The
-.\"O .BR sigrelse ()
-.\"O function removes
-.\"O .I sig
-.\"O from the calling process's signal mask.
-関数
-.BR sigrelse ()
-は、呼び出し元プロセスのシグナルマスクから
-.I sig
-を削除する。
+関数 \fBsigrelse\fP() は、呼び出し元プロセスのシグナルマスクから \fIsig\fP を削除する。
-.\"O The
-.\"O .BR sigignore ()
-.\"O function sets the disposition of
-.\"O .I sig
-.\"O to
-.\"O .BR SIG_IGN .
-関数
-.BR sigignore ()
-は、
-.I sig
-の動作を
-.B SIG_IGN
-に設定する。
-.\"O .SH RETURN VALUE
+関数 \fBsigignore\fP() は、 \fIsig\fP の動作を \fBSIG_IGN\fP に設定する。
.SH 返り値
-.\"O On success,
-.\"O .BR sigset ()
-.\"O returns
-.\"O .B SIG_HOLD
-.\"O if
-.\"O .I sig
-.\"O was blocked before the call,
-.\"O or the signal's previous disposition
-.\"O if it was not blocked before the call.
-.BR sigset ()
-は成功すると、
-呼び出し前に
-.I sig
-がブロックされていた場合には
-.B SIG_HOLD
-を返し、
-ブロックされていなかった場合には
-変更前のそのシグナルの動作を返す。
-.\"O On error,
-.\"O .BR sigset ()
-.\"O returns \-1, with
-.\"O .I errno
-.\"O set to indicate the error.
-エラーの場合、
-.BR sigset ()
-は \-1 を返し、
-.I errno
-にエラーを示す値をセットする。
-.\"O (But see BUGS below.)
-但し、以下の「バグ」の節も参照のこと。
+\fBsigset\fP() は成功すると、 呼び出し前に \fIsig\fP がブロックされていた場合には \fBSIG_HOLD\fP を返し、
+ブロックされていなかった場合には 変更前のそのシグナルの動作を返す。 エラーの場合、 \fBsigset\fP() は \-1 を返し、 \fIerrno\fP
+にエラーを示す値をセットする。 但し、以下の「バグ」の節も参照のこと。
-.\"O The
-.\"O .BR sighold (),
-.\"O .BR sigrelse (),
-.\"O and
-.\"O .BR sigignore ()
-.\"O functions return 0 on success; on error, these functions return \-1 and set
-.\"O .I errno
-.\"O to indicate the error.
-関数
-.BR sighold (),
-.BR sigrelse (),
-.BR sigignore ()
-は成功すると 0 を返す。エラーの場合、\-1 を返し、
-.I errno
-にエラーを示す値をセットする。
-.\"O .SH ERRORS
+関数 \fBsighold\fP(), \fBsigrelse\fP(), \fBsigignore\fP() は成功すると 0 を返す。エラーの場合、\-1 を返し、
+\fIerrno\fP にエラーを示す値をセットする。
.SH エラー
-.\"O For
-.\"O .BR sigset ()
-.\"O see the ERRORS under
-.\"O .BR sigaction (2)
-.\"O and
-.\"O .BR sigprocmask (2).
-.BR sigset ()
-に関しては、
-.BR sigaction (2)
-と
-.BR sigprocmask (2)
-の「エラー」の節を参照。
+\fBsigset\fP() に関しては、 \fBsigaction\fP(2) と \fBsigprocmask\fP(2) の「エラー」の節を参照。
-.\"O For
-.\"O .BR sighold ()
-.\"O and
-.\"O .BR sigrelse ()
-.\"O see the ERRORS under
-.\"O .BR sigprocmask (2).
-.BR sighold ()
-と
-.BR sigrelse ()
-に関しては、
-.BR sigprocmask (2)
-の「エラー」の節を参照。
+\fBsighold\fP() と \fBsigrelse\fP() に関しては、 \fBsigprocmask\fP(2) の「エラー」の節を参照。
-.\"O For
-.\"O .BR sigignore (),
-.\"O see the errors under
-.\"O .BR sigaction (2).
-.BR sigignore ()
-に関しては、
-.BR sigaction (2)
-の「エラー」の節を参照。
-.\"O .SH "CONFORMING TO"
+\fBsigignore\fP() に関しては、 \fBsigaction\fP(2) の「エラー」の節を参照。
.SH 準拠
-SVr4, POSIX.1-2001.
-.\"O These functions are obsolete: do not use them in new programs.
-これらの関数は廃止予定である。新しいプログラムでは使用しないこと。
-.\"O POSIX.1-2008 marks
-.\"O .BR sighold (),
-.\"O .BR sigignore (),
-.\"O .BR sigpause (),
-.\"O .BR sigrelse (),
-.\"O and
-.\"O .BR sigset ()
-.\"O as obsolete, recommending the use of
-.\"O .BR sigaction (2),
-.\"O .BR sigprocmask (2),
-.\"O .BR pthread_sigmask (3),
-.\"O and
-.\"O .BR sigsuspend (2)
-.\"O instead.
-POSIX.1-2008 は、
-.BR sighold (),
-.BR sigignore (),
-.BR sigpause (),
-.BR sigrelse (),
-.BR sigset ()
-を廃止予定としている。
-代わりに、
-.BR sigaction (2),
-.BR sigprocmask (2),
-.BR pthread_sigmask (3),
-.BR sigsuspend (2)
-の使用が推奨されている。
-.\"O .SH NOTES
+SVr4, POSIX.1\-2001. これらの関数は廃止予定である。新しいプログラムでは使用しないこと。 POSIX.1\-2008 は、
+\fBsighold\fP(), \fBsigignore\fP(), \fBsigpause\fP(), \fBsigrelse\fP(), \fBsigset\fP()
+を廃止予定としている。 代わりに、 \fBsigaction\fP(2), \fBsigprocmask\fP(2), \fBpthread_sigmask\fP(3),
+\fBsigsuspend\fP(2) の使用が推奨されている。
.SH 注意
-.\"O These functions appeared in glibc version 2.1.
これらの関数は glibc 2.1 で登場した。
-.\"O The
-.\"O .I sighandler_t
-.\"O type is a GNU extension; it is only used on this page to make the
-.\"O .BR sigset ()
-.\"O prototype more easily readable.
-.I sighandler_t
-型は GNU による拡張であり、この man page で
-.BR sigset ()
+\fIsighandler_t\fP 型は GNU による拡張であり、この man page で \fBsigset\fP()
のプロトタイプをより読みやすくするために使われているだけである。
-.\"O The
-.\"O .BR sigset ()
-.\"O function provides reliable signal handling semantics (as when calling
-.\"O .BR sigaction (2)
-.\"O with
-.\"O .I sa_mask
-.\"O equal to 0).
-関数
-.BR sigset ()
-は信頼性のあるシグナル処理機構を提供する
-.RI ( sa_mask
-を 0 で
-.BR sigaction (2)
+関数 \fBsigset\fP() は信頼性のあるシグナル処理機構を提供する (\fIsa_mask\fP を 0 で \fBsigaction\fP(2)
を呼び出したときと同様)。
-.\"O On System V, the
-.\"O .BR signal ()
-.\"O function provides unreliable semantics (as when calling
-.\"O .BR sigaction (2)
-.\"O with
-.\"O .I sa_mask
-.\"O equal to
-.\"O .IR "SA_RESETHAND | SA_NODEFER" ).
-System V では、関数
-.BR signal ()
-が提供する処理機構は信頼性のないものである
-.RI ( sa_mask
-を
-.IR "SA_RESETHAND | SA_NODEFER"
-として
-.BR sigaction (2)
-を呼び出したときと同様)。
-.\"O On BSD,
-.\"O .BR signal ()
-.\"O provides reliable semantics.
-BSD では、
-.BR signal ()
-は信頼性のある処理機構を提供する。
-.\"O POSIX.1-2001 leaves these aspects of
-.\"O .BR signal ()
-.\"O unspecified.
-POSIX.1-2001 では、
-.BR signal ()
-のこの点は規定しないままとなっている。
-.\"O See
-.\"O .BR signal (2)
-.\"O for further details.
-さらなる詳細については
-.BR signal (2)
-を参照。
+System V では、関数 \fBsignal\fP() が提供する処理機構は信頼性のないものである (\fIsa_mask\fP を
+\fISA_RESETHAND | SA_NODEFER\fP として \fBsigaction\fP(2) を呼び出したときと同様)。 BSD では、
+\fBsignal\fP() は信頼性のある処理機構を提供する。 POSIX.1\-2001 では、 \fBsignal\fP()
+のこの点は規定しないままとなっている。 さらなる詳細については \fBsignal\fP(2) を参照。
-.\"O In order to wait for a signal,
-.\"O BSD and System V both provided a function named
-.\"O .BR sigpause (3),
-.\"O but this function has a different argument on the two systems.
-.\"O See
-.\"O .BR sigpause (3)
-.\"O for details.
-BSD と System V のどちらのシステムでも
-シグナルを待つために、
-.BR sigpause (3)
-という名前の関数が提供されているが、
-この関数の引き数は両方のシステムで異なる。
-詳細は
-.BR sigpause (3)
-を参照。
-.\"O .SH BUGS
+BSD と System V のどちらのシステムでも シグナルを待つために、 \fBsigpause\fP(3) という名前の関数が提供されているが、
+この関数の引き数は両方のシステムで異なる。 詳細は \fBsigpause\fP(3) を参照。
.SH バグ
-.\"O In versions of glibc before 2.2,
-.\"O .BR sigset ()
-.\"O did not unblock
-.\"O .I sig
-.\"O if
-.\"O .I disp
-.\"O was specified as a value other than
-.\"O .BR SIG_HOLD .
-2.2 より前のバージョンの glibc では、
-.I disp
-に
-.B SIG_HOLD
-以外の値が指定された場合、
-.I sig
+2.2 より前のバージョンの glibc では、 \fIdisp\fP に \fBSIG_HOLD\fP 以外の値が指定された場合、 \fIsig\fP
のブロック解除を行っていなかった。
-.\"O In all versions of glibc up to and including 2.3.5,
-.\"O .BR sigset ()
-.\"O does not correctly return the previous disposition of the signal
-.\"O in two cases.
-2.3.5 以前の全てのバージョンの glibc では、
-.BR sigset ()
-が変更前のシグナルの動作を正しく返さない場合が 2つある。
-.\"O First, if
-.\"O .I disp
-.\"O is specified as
-.\"O .BR SIG_HOLD ,
-.\"O then a successful
-.\"O .BR sigset ()
-.\"O always returns
-.\"O .BR SIG_HOLD .
-.\"O Instead, it should return the previous disposition of the signal
-.\"O (unless the signal was blocked, in which case
-.\"O .B SIG_HOLD
-.\"O should be returned).
-一つめは、
-.I disp
-に
-.B SIG_HOLD
-が指定されると、成功した場合
-.BR sigset ()
-は常に
-.B SIG_HOLD
-を返すことである。
-正しくは、(シグナルがブロックされていなかった場合には)
-変更前のシグナルの動作を返すべきである
-(シグナルがブロックされていた場合には、
-.B SIG_HOLD
-が返される)。
-.\"O Second, if the signal is currently blocked, then
-.\"O the return value of a successful
-.\"O .BR sigset ()
-.\"O should be
-.\"O .BR SIG_HOLD .
-.\"O Instead, the previous disposition of the signal is returned.
-もう一つは、シグナルが現在ブロックされている場合には、
-成功した場合の
-.BR sigset ()
-の返り値は
-.B SIG_HOLD
-になるべきであるが、実際には
-変更前のシグナルの動作が返されることである。
-.\"O These problems have been fixed since glibc 2.5.
-これらの問題は glibc 2.5 以降で修正されている。
.\" See http://sourceware.org/bugzilla/show_bug.cgi?id=1951
-.\"O .SH "SEE ALSO"
+2.3.5 以前の全てのバージョンの glibc では、 \fBsigset\fP() が変更前のシグナルの動作を正しく返さない場合が 2つある。
+一つめは、 \fIdisp\fP に \fBSIG_HOLD\fP が指定されると、成功した場合 \fBsigset\fP() は常に \fBSIG_HOLD\fP
+を返すことである。 正しくは、(シグナルがブロックされていなかった場合には) 変更前のシグナルの動作を返すべきである
+(シグナルがブロックされていた場合には、 \fBSIG_HOLD\fP が返される)。 もう一つは、シグナルが現在ブロックされている場合には、 成功した場合の
+\fBsigset\fP() の返り値は \fBSIG_HOLD\fP になるべきであるが、実際には 変更前のシグナルの動作が返されることである。 これらの問題は
+glibc 2.5 以降で修正されている。
.SH 関連項目
-.BR kill (2),
-.BR pause (2),
-.BR sigaction (2),
-.BR signal (2),
-.BR sigprocmask (2),
-.BR raise (3),
-.BR sigpause (3),
-.BR sigvec (3),
-.BR signal (7)
+\fBkill\fP(2), \fBpause\fP(2), \fBsigaction\fP(2), \fBsignal\fP(2), \fBsigprocmask\fP(2),
+\fBraise\fP(3), \fBsigpause\fP(3), \fBsigvec\fP(3), \fBsignal\fP(7)
OSDN Git Service
