release/man3/sigsetops.3

   1 .\" Copyright (c) 1994 Mike Battersby
   2 .\"
   3 .\" %%%LICENSE_START(VERBATIM)
   4 .\" Permission is granted to make and distribute verbatim copies of this
   5 .\" manual provided the copyright notice and this permission notice are
   6 .\" preserved on all copies.
   7 .\"
   8 .\" Permission is granted to copy and distribute modified versions of this
   9 .\" manual under the conditions for verbatim copying, provided that the
  10 .\" entire resulting derived work is distributed under the terms of a
  11 .\" permission notice identical to this one.
  12 .\"
  13 .\" Since the Linux kernel and libraries are constantly changing, this
  14 .\" manual page may be incorrect or out-of-date.  The author(s) assume no
  15 .\" responsibility for errors or omissions, or for damages resulting from
  16 .\" the use of the information contained herein.  The author(s) may not
  17 .\" have taken the same level of care in the production of this manual,
  18 .\" which is licensed free of charge, as they might when working
  19 .\" professionally.
  20 .\"
  21 .\" Formatted or processed versions of this manual, if unaccompanied by
  22 .\" the source, must acknowledge the copyright and authors of this work.
  23 .\" %%%LICENSE_END
  24 .\"
  25 .\" Modified by aeb, 960721
  26 .\" 2005-11-21, mtk, added descriptions of sigisemptyset(), sigandset(),
  27 .\"                  and sigorset()
  28 .\" 2007-10-26 mdw   added wording that a sigset_t must be initialized
  29 .\"                  prior to use
  30 .\"
  31 .\"*******************************************************************
  32 .\"
  33 .\" This file was generated with po4a. Translate the source file.
  34 .\"
  35 .\"*******************************************************************
  36 .TH SIGSETOPS 3 2008\-09\-01 Linux "Linux Programmer's Manual"
  37 .SH 名前
  38 sigemptyset, sigfillset, sigaddset, sigdelset, sigismember \- POSIX シグナル集合の操作
  39 .SH 書式
  40 \fB#include <signal.h>\fP
  41 .sp
  42 \fBint sigemptyset(sigset_t *\fP\fIset\fP\fB);\fP
  43 .sp
  44 \fBint sigfillset(sigset_t *\fP\fIset\fP\fB);\fP
  45 .sp
  46 \fBint sigaddset(sigset_t *\fP\fIset\fP\fB, int \fP\fIsignum\fP\fB);\fP
  47 .sp
  48 \fBint sigdelset(sigset_t *\fP\fIset\fP\fB, int \fP\fIsignum\fP\fB);\fP
  49 .sp
  50 \fBint sigismember(const sigset_t *\fP\fIset\fP\fB, int \fP\fIsignum\fP\fB);\fP
  51 .sp
  52 .in -4n
  53 glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7)  参照):
  54 .in
  55 .sp
  56 .ad l
  57 \fBsigemptyset\fP(), \fBsigfillset\fP(), \fBsigaddset\fP(), \fBsigdelset\fP(),
  58 \fBsigismember\fP():
  59 .RS 4
  60 _POSIX_C_SOURCE\ >=\ 1 || _XOPEN_SOURCE || _POSIX_SOURCE
  61 .RE
  62 .ad b
  63 .SH 説明
  64 これらの関数は POSIX シグナル集合(signal set)を操作するため使用する。
  65 .PP
  66 \fBsigemptyset\fP()  は \fIset\fP で与えられたシグナル集合を空に初期化し、シグナルが一つも 含まれていない状態にする。
  67 .PP
  68 \fBsigfillset\fP()  は \fIset\fP で与えられたシグナル集合が全てのシグナルを含むようにする。
  69 .PP
  70 \fBsigaddset\fP()  と \fBsigdelset\fP()  は \fIset\fP に \fIsignum\fP
  71 シグナルをそれぞれ加えたり、削除したりする。
  72 .PP
  73 \fBsigismember\fP()  は \fIsignum\fP が \fIset\fP に含まれているかどうかをテストする。
  74 .PP
  75 \fIsigset_t\fP 型のオブジェクトは、関数 \fBsigaddset\fP(), \fBsigdelset\fP(), \fBsigismember\fP()
  76 や後述の glibc の追加関数 (\fBsigisemptyset\fP(), \fBsigandset\fP(), \fBsigorset\fP())  に渡す前に、
  77 \fBsigemptyset\fP()  か \fBsigfillset\fP()  を呼び出して初期化しなければならない。
  78 初期化しなかった場合の結果は未定義である。
  79 .SH 返り値
  80 \fBsigemptyset\fP(), \fBsigfillset\fP(), \fBsigaddset\fP(), \fBsigdelset\fP()  は成功すれば 0
  81 を、エラーの場合は \-1 を返す。
  82 .PP
  83 \fBsigismember\fP()  は \fIsignum\fP が \fIset\fP に含まれていれば 1 を返し、含まれていなければ 0 を返す。
  84 エラーの場合は \-1 を返す。
  85 .SH エラー
  86 .TP
  87 \fBEINVAL\fP
  88 \fIsig\fP が有効なシグナルではない。
  89 .SH 準拠
  90 POSIX.1\-2001.
  91 .SH 注意
  92 .SS "glibc での注意"
  93 \fB_GNU_SOURCE\fP 機能検査マクロが定義されていると、 \fI<signal.h>\fP でシグナル集合を操作する
  94 3つの関数が追加で公開される。
  95 .TP
  96 \fBint sigisemptyset(sigset_t *\fP\fIset\fP\fB);\fP
  97 \fIset\fP にシグナルが一つも含まれていなければ 1 を返し、 それ以外は 0 を返す。
  98 .TP
  99 \fBint sigorset(sigset_t *\fP\fIdest\fP\fB, sigset_t *\fP\fIleft\fP\fB, sigset_t *\fP\fIright\fP\fB);\fP
 100 シグナル集合 \fIleft\fP と \fIleft\fP の和集合を \fIdest\fP に書き込む。
 101 .TP
 102 \fBint sigandset(sigset_t *\fP\fIdest\fP\fB, sigset_t *\fP\fIleft\fP\fB, sigset_t *\fP\fIright\fP\fB);\fP
 103 シグナル集合 \fIleft\fP と \fIleft\fP の積集合を \fIdest\fP に書き込む。
 104 .PP
 105 \fBsigorset\fP()  と \fBsigandset\fP()  は成功すると 0 を、失敗すると \-1 を返す。
 106 .PP
 107 これらの関数は非標準であり、(他にも同様の関数を提供しているシステムも いくつかはあるが) 移植性を考慮したアプリケーションでは使用を避けるべき
 108 である。
 109 .SH 関連項目
 110 \fBsigaction\fP(2), \fBsigpending\fP(2), \fBsigprocmask\fP(2), \fBsigsuspend\fP(2)
 111 .SH この文書について
 112 この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.50 の一部
 113 である。プロジェクトの説明とバグ報告に関する情報は
 114 http://www.kernel.org/doc/man\-pages/ に書かれている。