draft/man2/sigprocmask.2

   1 .\" Copyright (c) 2005 Michael Kerrisk
   2 .\" based on earlier work by faith@cs.unc.edu and
   3 .\" Mike Battersby <mib@deakin.edu.au>
   4 .\"
   5 .\" Permission is granted to make and distribute verbatim copies of this
   6 .\" manual provided the copyright notice and this permission notice are
   7 .\" preserved on all copies.
   8 .\"
   9 .\" Permission is granted to copy and distribute modified versions of this
  10 .\" manual under the conditions for verbatim copying, provided that the
  11 .\" entire resulting derived work is distributed under the terms of a
  12 .\" permission notice identical to this one.
  13 .\"
  14 .\" Since the Linux kernel and libraries are constantly changing, this
  15 .\" manual page may be incorrect or out-of-date.  The author(s) assume no
  16 .\" responsibility for errors or omissions, or for damages resulting from
  17 .\" the use of the information contained herein.  The author(s) may not
  18 .\" have taken the same level of care in the production of this manual,
  19 .\" which is licensed free of charge, as they might when working
  20 .\" professionally.
  21 .\"
  22 .\" Formatted or processed versions of this manual, if unaccompanied by
  23 .\" the source, must acknowledge the copyright and authors of this work.
  24 .\"
  25 .\" 2005-09-15, mtk, Created new page by splitting off from sigaction.2
  26 .\"
  27 .\" Japanese Version Copyright (c) 2005 Akihiro MOTOKI all rights reserved.
  28 .\" Translated 2005-10-03, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
  29 .\"
  30 .TH SIGPROCMASK 2 2008-10-17 "Linux" "Linux Programmer's Manual"
  31 .\"O .SH NAME
  32 .SH 名前
  33 .\"O sigprocmask \- examine and change blocked signals
  34 sigprocmask \- 禁止するシグナルの確認と変更
  35 .\"O .SH SYNOPSIS
  36 .SH 書式
  37 .B #include <signal.h>
  38 .sp
  39 .BI "int sigprocmask(int " how ", const sigset_t *" set ,
  40 .BI "sigset_t *" oldset );
  41 .sp
  42 .in -4n
  43 .\"O Feature Test Macro Requirements for glibc (see
  44 .\"O .BR feature_test_macros (7)):
  45 glibc 向けの機能検査マクロの要件
  46 .RB ( feature_test_macros (7)
  47 参照):
  48 .in
  49 .sp
  50 .ad l
  51 .BR sigprocmask ():
  52 _POSIX_C_SOURCE\ >=\ 1 || _XOPEN_SOURCE || _POSIX_SOURCE
  53 .ad b
  54 .\"O .SH DESCRIPTION
  55 .SH 説明
  56 .\"O .BR sigprocmask ()
  57 .\"O is used to fetch and/or change the signal mask of the calling thread.
  58 .\"O The signal mask is the set of signals whose delivery is currently
  59 .\"O blocked for the caller
  60 .\"O (see also
  61 .\"O .BR signal (7)
  62 .\"O for more details).
  63 .BR sigprocmask ()
  64 を使うと、呼び出したスレッドのシグナルマスクの取得/変更ができる。
  65 シグナルマスクは、呼び出し元に対して現在配送が禁止されているシグナルの
  66 集合のことである (詳細については
  67 .BR signal (7)
  68 も参照のこと)。
  69
  70 .\"O The behavior of the call is dependent on the value of
  71 .\"O .IR how ,
  72 .\"O as follows.
  73 このコールの動作は
  74 .I how
  75 の値によって決まる:
  76 .TP
  77 .B SIG_BLOCK
  78 .\"O The set of blocked signals is the union of the current set and the
  79 .\"O .I set
  80 .\"O argument.
  81 禁止されたシグナルの集合は現在の値と
  82 .I set
  83 引き数を結合したものとなる。
  84 .TP
  85 .B SIG_UNBLOCK
  86 .\"O The signals in
  87 .\"O .I set
  88 .\"O are removed from the current set of blocked signals.
  89 .\"O It is permissible to attempt to unblock a signal which is not blocked.
  90 現在禁止されているシグナルの集合から
  91 .I set
  92 にあるシグナルを取り除く。禁止されていないシグナルを取り除こうと
  93 することも認められている。
  94 .TP
  95 .B SIG_SETMASK
  96 .\"O The set of blocked signals is set to the argument
  97 .\"O .IR set .
  98 禁止されているシグナルの集合に
  99 .I set
 100 引き数を設定する。
 101 .PP
 102 .\"O If
 103 .\"O .I oldset
 104 .\"O is non-NULL, the previous value of the signal mask is stored in
 105 .\"O .IR oldset .
 106 .I oldset
 107 が NULL でなければ、シグナルマスクの今までの値を
 108 .I oldset
 109 に格納する。
 110
 111 .\"O If
 112 .\"O .I set
 113 .\"O is NULL, then the signal mask is unchanged (i.e.,
 114 .\"O .I how
 115 .\"O is ignored),
 116 .\"O but the current value of the signal mask is nevertheless returned in
 117 .\"O .I oldset
 118 .\"O (if it is not NULL).
 119 .I set
 120 が NULL であれば、シグナルマスクは変更されない (すなわち、
 121 .I how
 122 は無視される)。
 123 .I set
 124 の値にかかわらず、現在のシグナルマスクの値は
 125 .I oldset
 126 に入れて返される (但し、
 127 .I oldset
 128 が NULL でない場合)。
 129
 130 .\"O The use of
 131 .\"O .BR sigprocmask ()
 132 .\"O is unspecified in a multithreaded process; see
 133 .\"O .BR pthread_sigmask (3).
 134 マルチスレッドのプロセスで
 135 .BR sigprocmask ()
 136 を使用した場合の動作は規定されていない。
 137 .BR pthread_sigmask (3)
 138 を参照のこと。
 139 .\"O .SH "RETURN VALUE"
 140 .SH 返り値
 141 .\"O .BR sigprocmask ()
 142 .\"O returns 0 on success and \-1 on error.
 143 .BR sigprocmask ()
 144 は成功すれば 0 を返し、エラーならば \-1 を返す。
 145 .\"O .SH ERRORS
 146 .SH エラー
 147 .B EINVAL
 148 .\"O The value specified in
 149 .\"O .I how
 150 .\"O was invalid.
 151 .I how
 152 に指定された値が有効ではない。
 153 .\"O .SH "CONFORMING TO"
 154 .SH 準拠
 155 POSIX.1-2001.
 156 .\"O .SH NOTES
 157 .SH 注意
 158 .\"O It is not possible to block
 159 .\"O .BR SIGKILL " or " SIGSTOP .
 160 .\"O Attempts to do so are silently ignored.
 161 .B SIGKILL
 162 や
 163 .B SIGSTOP
 164 を禁止することはできない。
 165 禁止しようとしても黙って無視される。
 166
 167 .\"O Each of the threads in a process has its own signal mask.
 168 プロセス内の各スレッドはそれぞれ専用のシグナルマスクを持つ。
 169
 170 .\"O A child created via
 171 .\"O .BR fork (2)
 172 .\"O inherits a copy of its parent's signal mask;
 173 .\"O the signal mask is preserved across
 174 .\"O .BR execve (2).
 175 .BR fork (2)
 176 経由で作成された子プロセスは親プロセスのシグナルマスクのコピーを継承する。
 177 .BR execve (2)
 178 の前後でシグナルマスクは保持される。
 179
 180 .\"O If
 181 .\"O .BR SIGBUS ,
 182 .\"O .BR SIGFPE ,
 183 .\"O .BR SIGILL ,
 184 .\"O or
 185 .\"O .B SIGSEGV
 186 .\"O are generated
 187 .\"O while they are blocked, the result is undefined,
 188 .\"O unless the signal was generated by
 189 .\"O .BR kill (2),
 190 .\"O .BR sigqueue (3),
 191 .\"O or
 192 .\"O .BR raise (3).
 193 シグナル
 194 .BR SIGBUS ,
 195 .BR SIGFPE ,
 196 .BR SIGILL ,
 197 .B SIGSEGV
 198 が禁止されている間に生成された場合で、
 199 そのシグナルが
 200 .BR kill (2),
 201 .BR sigqueue (3),
 202 .BR raise (3)
 203 によって生成されたものでないときには、
 204 その後の動作は未定義である。
 205 .PP
 206 .\"O See
 207 .\"O .BR sigsetops (3)
 208 .\"O for details on manipulating signal sets.
 209 シグナル集合の操作に関する詳細は
 210 .BR sigsetops (3)
 211 を参照のこと。
 212 .\"O .SH "SEE ALSO"
 213 .SH 関連項目
 214 .BR kill (2),
 215 .BR pause (2),
 216 .BR sigaction (2),
 217 .BR signal (2),
 218 .BR sigpending (2),
 219 .BR sigsuspend (2),
 220 .BR pthread_sigmask (3),
 221 .BR sigqueue (3),
 222 .BR sigsetops (3),
 223 .BR signal (7)