draft/man3/sigsetops.3

   1 .\" Copyright (c) 1994 Mike Battersby
   2 .\"
   3 .\" Permission is granted to make and distribute verbatim copies of this
   4 .\" manual provided the copyright notice and this permission notice are
   5 .\" preserved on all copies.
   6 .\"
   7 .\" Permission is granted to copy and distribute modified versions of this
   8 .\" manual under the conditions for verbatim copying, provided that the
   9 .\" entire resulting derived work is distributed under the terms of a
  10 .\" permission notice identical to this one.
  11 .\"
  12 .\" Since the Linux kernel and libraries are constantly changing, this
  13 .\" manual page may be incorrect or out-of-date.  The author(s) assume no
  14 .\" responsibility for errors or omissions, or for damages resulting from
  15 .\" the use of the information contained herein.  The author(s) may not
  16 .\" have taken the same level of care in the production of this manual,
  17 .\" which is licensed free of charge, as they might when working
  18 .\" professionally.
  19 .\"
  20 .\" Formatted or processed versions of this manual, if unaccompanied by
  21 .\" the source, must acknowledge the copyright and authors of this work.
  22 .\"
  23 .\" Modified by aeb, 960721
  24 .\" 2005-11-21, mtk, added descriptions of sigisemptyset(), sigandset(),
  25 .\"                  and sigorset()
  26 .\" 2007-10-26 mdw   added wording that a sigset_t must be initialized
  27 .\"                  prior to use
  28 .\"
  29 .\"WORD:        signal set              ¥·¥°¥Ê¥ë½¸¹ç
  30 .\"
  31 .\" Japanese Version Copyright (c) 1998 HANATAKA Shinya
  32 .\"         all rights reserved.
  33 .\" Translated 1998-05-24, HANATAKA Shinya <hanataka@abyss.rim.or.jp>
  34 .\" Updated 2005-12-05, Akihiro MOTOKI, Catch up to LDP man-pages 2.16
  35 .\" Updated 2008-02-09, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>, LDP v2.77
  36 .\"
  37 .TH SIGSETOPS 3 2008-09-01 "Linux" "Linux Programmer's Manual"
  38 .\"O .SH NAME
  39 .SH Ì¾Á°
  40 .\"O sigemptyset, sigfillset, sigaddset, sigdelset, sigismember \- POSIX
  41 .\"O signal set operations.
  42 sigemptyset, sigfillset, sigaddset, sigdelset, sigismember \- POSIX
  43 ¥·¥°¥Ê¥ë½¸¹ç¤ÎÁàºî
  44 .\"O .SH SYNOPSIS
  45 .SH ½ñ¼°
  46 .B #include <signal.h>
  47 .sp
  48 .BI "int sigemptyset(sigset_t *" set );
  49 .sp
  50 .BI "int sigfillset(sigset_t *" set );
  51 .sp
  52 .BI "int sigaddset(sigset_t *" set ", int " signum );
  53 .sp
  54 .BI "int sigdelset(sigset_t *" set ", int " signum );
  55 .sp
  56 .BI "int sigismember(const sigset_t *" set ", int " signum );
  57 .sp
  58 .in -4n
  59 .\"O Feature Test Macro Requirements for glibc (see
  60 .\"O .BR feature_test_macros (7)):
  61 glibc ¸þ¤±¤Îµ¡Ç½¸¡ºº¥Þ¥¯¥í¤ÎÍ×·ï
  62 .RB ( feature_test_macros (7)
  63 »²¾È):
  64 .in
  65 .sp
  66 .ad l
  67 .BR sigemptyset (),
  68 .BR sigfillset (),
  69 .BR sigaddset (),
  70 .BR sigdelset (),
  71 .BR sigismember ():
  72 .RS 4
  73 _POSIX_C_SOURCE\ >=\ 1 || _XOPEN_SOURCE || _POSIX_SOURCE
  74 .RE
  75 .ad b
  76 .\"O .SH DESCRIPTION
  77 .SH ÀâÌÀ
  78 .\"O These functions allow the manipulation of POSIX signal sets.
  79 ¤³¤ì¤é¤Î´Ø¿ô¤Ï POSIX ¥·¥°¥Ê¥ë½¸¹ç(signal set)¤òÁàºî¤¹¤ë¤¿¤á»ÈÍÑ¤¹¤ë¡£
  80 .PP
  81 .\"O .BR sigemptyset ()
  82 .\"O initializes the signal set given by
  83 .\"O .I set
  84 .\"O to empty, with all signals excluded from the set.
  85 .BR sigemptyset ()
  86 ¤Ï
  87 .I set
  88 ¤ÇÍ¿¤¨¤é¤ì¤¿¥·¥°¥Ê¥ë½¸¹ç¤ò¶õ¤Ë½é´ü²½¤·¡¢¥·¥°¥Ê¥ë¤¬°ì¤Ä¤â
  89 ´Þ¤Þ¤ì¤Æ¤¤¤Ê¤¤¾õÂÖ¤Ë¤¹¤ë¡£
  90 .PP
  91 .\"O .BR sigfillset ()
  92 .\"O initializes
  93 .\"O .I set
  94 .\"O to full, including all signals.
  95 .BR sigfillset ()
  96 ¤Ï
  97 .I set
  98 ¤ÇÍ¿¤¨¤é¤ì¤¿¥·¥°¥Ê¥ë½¸¹ç¤¬Á´¤Æ¤Î¥·¥°¥Ê¥ë¤ò´Þ¤à¤è¤¦¤Ë¤¹¤ë¡£
  99 .PP
 100 .\"O .BR sigaddset ()
 101 .\"O and
 102 .\"O .BR sigdelset ()
 103 .\"O add and delete respectively signal
 104 .\"O .I signum
 105 .\"O from
 106 .\"O .IR set .
 107 .BR sigaddset ()
 108 ¤È
 109 .BR sigdelset ()
 110 ¤Ï
 111 .I set
 112 ¤Ë
 113 .I signum
 114 ¥·¥°¥Ê¥ë¤ò¤½¤ì¤¾¤ì²Ã¤¨¤¿¤ê¡¢ºï½ü¤·¤¿¤ê¤¹¤ë¡£
 115 .PP
 116 .\"O .BR sigismember ()
 117 .\"O tests whether
 118 .\"O .I signum
 119 .\"O is a member of
 120 .\"O .I set .
 121 .BR sigismember ()
 122 ¤Ï
 123 .I signum
 124 ¤¬
 125 .I set
 126 ¤Ë´Þ¤Þ¤ì¤Æ¤¤¤ë¤«¤É¤¦¤«¤ò¥Æ¥¹¥È¤¹¤ë¡£
 127 .PP
 128 .\"O Objects of type
 129 .\"O .I sigset_t
 130 .\"O must be initialized by a call to either
 131 .\"O .BR sigemptyset ()
 132 .\"O or
 133 .\"O .BR sigfillset ()
 134 .\"O before being passed to the functions
 135 .\"O .BR sigaddset (),
 136 .\"O .BR sigdelset ()
 137 .\"O and
 138 .\"O .BR sigismember ()
 139 .\"O or the additional glibc functions described below
 140 .\"O .RB ( sigisemptyset (),
 141 .\"O .BR sigandset (),
 142 .\"O and
 143 .\"O .BR sigorset ()).
 144 .\"O The results are undefined if this is not done.
 145 .I sigset_t
 146 ·¿¤Î¥ª¥Ö¥¸¥§¥¯¥È¤Ï¡¢´Ø¿ô
 147 .BR sigaddset (),
 148 .BR sigdelset (),
 149 .BR sigismember ()
 150 ¤ä¸å½Ò¤Î glibc ¤ÎÄÉ²Ã´Ø¿ô
 151 .RB ( sigisemptyset (),
 152 .BR sigandset (),
 153 .BR sigorset ())
 154 ¤ËÅÏ¤¹Á°¤Ë¡¢
 155 .BR sigemptyset ()
 156 ¤«
 157 .BR sigfillset ()
 158 ¤ò¸Æ¤Ó½Ð¤·¤Æ½é´ü²½¤·¤Ê¤±¤ì¤Ð¤Ê¤é¤Ê¤¤¡£
 159 ½é´ü²½¤·¤Ê¤«¤Ã¤¿¾ì¹ç¤Î·ë²Ì¤ÏÌ¤ÄêµÁ¤Ç¤¢¤ë¡£
 160 .\"O .SH "RETURN VALUE"
 161 .SH ÊÖ¤êÃÍ
 162 .\"O .BR sigemptyset (),
 163 .\"O .BR sigfillset (),
 164 .\"O .BR sigaddset (),
 165 .\"O and
 166 .\"O .BR sigdelset ()
 167 .\"O return 0 on success and \-1 on error.
 168 .BR sigemptyset (),
 169 .BR sigfillset (),
 170 .BR sigaddset (),
 171 .BR sigdelset ()
 172 ¤ÏÀ®¸ù¤¹¤ì¤Ð 0 ¤ò¡¢¥¨¥é¡¼¤Î¾ì¹ç¤Ï \-1 ¤òÊÖ¤¹¡£
 173 .PP
 174 .\"O .BR sigismember ()
 175 .\"O returns 1 if
 176 .\"O .I signum
 177 .\"O is a member of
 178 .\"O .IR set ,
 179 .\"O 0 if
 180 .\"O .I signum
 181 .\"O is not a member, and \-1 on error.
 182 .BR sigismember ()
 183 ¤Ï
 184 .I signum
 185 ¤¬
 186 .I set
 187 ¤Ë´Þ¤Þ¤ì¤Æ¤¤¤ì¤Ð 1 ¤òÊÖ¤·¡¢´Þ¤Þ¤ì¤Æ¤¤¤Ê¤±¤ì¤Ð 0 ¤òÊÖ¤¹¡£
 188 ¥¨¥é¡¼¤Î¾ì¹ç¤Ï \-1 ¤òÊÖ¤¹¡£
 189 .\"O .SH ERRORS
 190 .SH ¥¨¥é¡¼
 191 .TP
 192 .B EINVAL
 193 .\"O .I sig
 194 .\"O is not a valid signal.
 195 .I sig
 196 ¤¬Í¸ú¤Ê¥·¥°¥Ê¥ë¤Ç¤Ï¤Ê¤¤¡£
 197 .\"O .SH "CONFORMING TO"
 198 .SH ½àµò
 199 POSIX.1-2001.
 200 .\"O .SH NOTES
 201 .\"O .SS Glibc Notes
 202 .SH Ãí°Õ
 203 .SS glibc ¤Ç¤ÎÃí°Õ
 204 .\"O If the
 205 .\"O .B _GNU_SOURCE
 206 .\"O feature test macro is defined, then \fI<signal.h>\fP
 207 .\"O exposes three other functions for manipulating signal
 208 .\"O sets.
 209 .B _GNU_SOURCE
 210 µ¡Ç½¸¡ºº¥Þ¥¯¥í¤¬ÄêµÁ¤µ¤ì¤Æ¤¤¤ë¤È¡¢
 211 \fI<signal.h>\fP ¤Ç¥·¥°¥Ê¥ë½¸¹ç¤òÁàºî¤¹¤ë 3¤Ä¤Î´Ø¿ô¤¬ÄÉ²Ã¤Ç¸ø³«¤µ¤ì¤ë¡£
 212 .TP
 213 .BI "int sigisemptyset(sigset_t *" set );
 214 .\"O returns 1 if
 215 .\"O .I set
 216 .\"O contains no signals, and 0 otherwise.
 217 .I set
 218 ¤Ë¥·¥°¥Ê¥ë¤¬°ì¤Ä¤â´Þ¤Þ¤ì¤Æ¤¤¤Ê¤±¤ì¤Ð 1 ¤òÊÖ¤·¡¢
 219 ¤½¤ì°Ê³°¤Ï 0 ¤òÊÖ¤¹¡£
 220 .TP
 221 .BI "int sigorset(sigset_t *" dest ", sigset_t *" left \
 222 ", sigset_t *" right );
 223 .\"O places the union of the sets
 224 .\"O .I left
 225 .\"O and
 226 .\"O .I right
 227 .\"O in
 228 .\"O .IR dest .
 229 ¥·¥°¥Ê¥ë½¸¹ç
 230 .I left
 231 ¤È
 232 .I left
 233 ¤ÎÏÂ½¸¹ç¤ò
 234 .I dest
 235 ¤Ë½ñ¤¹þ¤à¡£
 236 .TP
 237 .BI "int sigandset(sigset_t *" dest ", sigset_t *" left \
 238 ", sigset_t *" right );
 239 .\"O places the intersection of the sets
 240 .\"O .I left
 241 .\"O and
 242 .\"O .I right
 243 .\"O in
 244 .\"O .IR dest .
 245 ¥·¥°¥Ê¥ë½¸¹ç
 246 .I left
 247 ¤È
 248 .I left
 249 ¤ÎÀÑ½¸¹ç¤ò
 250 .I dest
 251 ¤Ë½ñ¤¹þ¤à¡£
 252 .PP
 253 .\"O .BR sigorset ()
 254 .\"O and
 255 .\"O .BR sigandset ()
 256 .\"O return 0 on success, and \-1 on failure.
 257 .BR sigorset ()
 258 ¤È
 259 .BR sigandset ()
 260 ¤ÏÀ®¸ù¤¹¤ë¤È 0 ¤ò¡¢¼ºÇÔ¤¹¤ë¤È \-1 ¤òÊÖ¤¹¡£
 261 .PP
 262 .\"O These functions are nonstandard (a few other systems provide similar
 263 .\"O functions) and their use should be avoided in portable applications.
 264 ¤³¤ì¤é¤Î´Ø¿ô¤ÏÈóÉ¸½à¤Ç¤¢¤ê¡¢(Â¾¤Ë¤âÆ±ÍÍ¤Î´Ø¿ô¤òÄó¶¡¤·¤Æ¤¤¤ë¥·¥¹¥Æ¥à¤â
 265 ¤¤¤¯¤Ä¤«¤Ï¤¢¤ë¤¬) °Ü¿¢À¤ò¹ÍÎ¸¤·¤¿¥¢¥×¥ê¥±¡¼¥·¥ç¥ó¤Ç¤Ï»ÈÍÑ¤òÈò¤±¤ë¤Ù¤
 266 ¤Ç¤¢¤ë¡£
 267 .\"O .SH "SEE ALSO"
 268 .SH ´ØÏ¢¹àÌÜ
 269 .BR sigaction (2),
 270 .BR sigpending (2),
 271 .BR sigprocmask (2),
 272 .BR sigsuspend (2)