release/man2/sigaction.2

   1 .\" t
   2 .\" Copyright (c) 1994,1995 Mike Battersby <mib@deakin.edu.au>
   3 .\" and Copyright 2004, 2005 Michael Kerrisk <mtk.manpages@gmail.com>
   4 .\" based on work by faith@cs.unc.edu
   5 .\"
   6 .\" Permission is granted to make and distribute verbatim copies of this
   7 .\" manual provided the copyright notice and this permission notice are
   8 .\" preserved on all copies.
   9 .\"
  10 .\" Permission is granted to copy and distribute modified versions of this
  11 .\" manual under the conditions for verbatim copying, provided that the
  12 .\" entire resulting derived work is distributed under the terms of a
  13 .\" permission notice identical to this one.
  14 .\"
  15 .\" Since the Linux kernel and libraries are constantly changing, this
  16 .\" manual page may be incorrect or out-of-date.  The author(s) assume no
  17 .\" responsibility for errors or omissions, or for damages resulting from
  18 .\" the use of the information contained herein.  The author(s) may not
  19 .\" have taken the same level of care in the production of this manual,
  20 .\" which is licensed free of charge, as they might when working
  21 .\" professionally.
  22 .\"
  23 .\" Formatted or processed versions of this manual, if unaccompanied by
  24 .\" the source, must acknowledge the copyright and authors of this work.
  25 .\"
  26 .\" Modified, aeb, 960424
  27 .\" Modified Fri Jan 31 17:31:20 1997 by Eric S. Raymond <esr@thyrsus.com>
  28 .\" Modified Thu Nov 26 02:12:45 1998 by aeb - add SIGCHLD stuff.
  29 .\" Modified Sat May  8 17:40:19 1999 by Matthew Wilcox
  30 .\"     add POSIX.1b signals
  31 .\" Modified Sat Dec 29 01:44:52 2001 by Evan Jones <ejones@uwaterloo.ca>
  32 .\"     SA_ONSTACK
  33 .\" Modified 2004-11-11 by Michael Kerrisk <mtk.manpages@gmail.com>
  34 .\"     Added mention of SIGCONT under SA_NOCLDSTOP
  35 .\"     Added SA_NOCLDWAIT
  36 .\" Modified 2004-11-17 by Michael Kerrisk <mtk.manpages@gmail.com>
  37 .\"     Updated discussion for POSIX.1-2001 and SIGCHLD and sa_flags.
  38 .\"     Formatting fixes
  39 .\" 2004-12-09, mtk, added SI_TKILL + other minor changes
  40 .\" 2005-09-15, mtk, split sigpending(), sigprocmask(), sigsuspend()
  41 .\"     out of this page into separate pages.
  42 .\" 2010-06-11 Andi Kleen, add hwpoison signal extensions
  43 .\" 2010-06-11 mtk, improvements to discussion of various siginfo_t fields.
  44 .\"
  45 .\"*******************************************************************
  46 .\"
  47 .\" This file was generated with po4a. Translate the source file.
  48 .\"
  49 .\"*******************************************************************
  50 .TH SIGACTION 2 2012\-04\-26 Linux "Linux Programmer's Manual"
  51 .SH 名前
  52 sigaction \- シグナルの動作の確認と変更
  53 .SH 書式
  54 .nf
  55 \fB#include <signal.h>\fP
  56 .sp
  57 \fBint sigaction(int \fP\fIsignum\fP\fB, const struct sigaction *\fP\fIact\fP\fB,\fP
  58 \fB              struct sigaction *\fP\fIoldact\fP\fB);\fP
  59 .fi
  60 .sp
  61 .in -4n
  62 glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7)  参照):
  63 .in
  64 .sp
  65 .ad l
  66 \fBsigaction\fP(): _POSIX_C_SOURCE\ >=\ 1 || _XOPEN_SOURCE || _POSIX_SOURCE
  67 .ad b
  68 .SH 説明
  69 \fBsigaction\fP()  システムコールは、特定のシグナルを受信した際の プロセスの動作を変更するのに使用される (シグナルの概要については
  70 \fBsignal\fP(7)  を参照)。
  71 .PP
  72 \fIsignum\fP には、 \fBSIGKILL\fP と \fBSIGSTOP\fP 以外の有効なシグナルをどれでも指定できる。
  73 .PP
  74 \fIact\fP が NULL 以外であれば、シグナル \fIsignum\fP の新しい動作 (action) として \fIact\fP が設定される。
  75 \fIoldact\fP が NULL でなければ、今までの動作が \fIoldact\fP に格納される。
  76 .PP
  77 \fIsigaction\fP 構造体は以下のような感じに定義される。
  78 .sp
  79 .in +4n
  80 .nf
  81 struct sigaction {
  82     void     (*sa_handler)(int);
  83     void     (*sa_sigaction)(int, siginfo_t *, void *);
  84     sigset_t   sa_mask;
  85     int        sa_flags;
  86     void     (*sa_restorer)(void);
  87 };
  88 .fi
  89 .in
  90 .PP
  91 アーキテクチャによっては共用体 (union) が用いられており、その場合には \fIsa_handler\fP と \fIsa_sigaction\fP
  92 の両方を同時に割り当てることはできない。
  93 .PP
  94 \fIsa_restorer\fP 要素は廃止予定であり使用すべきではない。 POSIX には \fIsa_restorer\fP 要素に関する規定はない。
  95 .PP
  96 \fIsa_handler\fP は \fIsignum\fP に対応する動作を指定するもので、 デフォルトの動作を行う \fBSIG_DFL\fP、
  97 そのシグナルを無視する \fBSIG_IGN\fP、 シグナルハンドラ関数へのポインタが設定できる。
  98 シグナルハンドラ関数の引き数は一つであり、シグナル番号が引き数として 渡される。
  99 .PP
 100 \fIsa_flags\fP に \fBSA_SIGINFO\fP が指定された場合、 (\fIsa_handler\fP ではなく)
 101 \fIsa_sigaction\fP により \fIsignum\fP に対応するシグナルハンドラ関数が指定さ
 102 れる。指定される関数は、最初の引き数としてシグナル番号を、二番目の引き
 103 数として \fIsiginfo_t\fP へのポインタを、三番目の引き数として (\fIvoid\ *\fP
 104 にキャストした) \fIucontext_t\fP へのポインタを受けとる。 (一般的には、
 105 ハンドラ関数の三番目の引き数が使用されない。\fIucontext_t\fP についての
 106 詳しい情報は \fBgetcontext\fP(2) を参照。)
 107 .PP
 108 \fIsa_mask\fP は、シグナル・ハンドラ実行中に禁止 (block) すべきシグナルのマスクを指定する
 109 (ハンドラ実行中のシグナルの禁止は、シグナル・ハンドラが起動されたスレッド のシグナルのマスクに追加することで行われる)。 さらに、
 110 \fBSA_NODEFER\fP フラグが指定されていない場合は、ハンドラを起動するきっかけとなる シグナルにも \fIsa_mask\fP が適用される。
 111 .PP
 112 \fIsa_flags\fP はシグナル・ハンドラの動作を変更するためのフラグの集合を指定する。 \fIsa_flags\fP には、以下に示すフラグの (0
 113 個以上の) 論理和をとったものを指定する。
 114 .RS 4
 115 .TP
 116 \fBSA_NOCLDSTOP\fP
 117 \fIsignum\fP が \fBSIGCHLD\fP の場合、 子プロセスが停止したり (子プロセスが \fBSIGSTOP\fP, \fBSIGTSTP\fP,
 118 \fBSIGTTIN\fP, \fBSIGTTOU\fP を受けたとき) 再開したり (子プロセスが \fBSIGCONT\fP を受けたとき) したときに
 119 \fBSIGCHLD\fP の通知を受けない。 このフラグは、 \fBSIGCHLD\fP に対してハンドラを設定する際にのみ意味を持つ。
 120 .TP
 121 \fBSA_NOCLDWAIT\fP (Linux 2.6 以降)
 122 .\" To be precise: Linux 2.5.60 -- MTK
 123 (Linux 2.6 以降)  \fIsignum\fP が \fBSIGCHLD\fP の場合、子プロセスが終了したときに
 124 子プロセスをゾンビプロセスに変化させない (\fBwaitpid\fP(2)  も参照)。 このフラグは、 \fBSIGCHLD\fP
 125 に対してハンドラを設定する際、もしくはそのシグナルの処理方法を \fBSIG_DFL\fP に設定する際にのみ意味を持つ。
 126
 127 \fBSIGCHLD\fP に対してハンドラを設定する際に \fBSA_NOCLDWAIT\fP フラグをセットした場合、 子プロセスが終了した際に
 128 \fBSIGCHLD\fP シグナルが生成されるかどうかは、 POSIX.1 では規定されていない。 Linux では、この状況で \fBSIGCHLD\fP
 129 シグナルは生成される。 いくつかの他の実装では生成されない。
 130 .TP
 131 \fBSA_NODEFER\fP
 132 それ自身のシグナル・ハンドラーの内部にいる時でも そのシグナルをマスクしないようにする。 このフラグはシグナルハンドラを設定する際にのみ意味を持つ。
 133 \fBSA_NOMASK\fP はこのフラグと同じ意味だが、廃止されており、非標準である。
 134 .TP
 135 \fBSA_ONSTACK\fP
 136 \fBsigaltstack\fP(2)  で提供される別のシグナル・スタックでシグナルハンドラを呼び出す。
 137 別のシグナル・スタックが利用可能でなければ、デフォルトのスタックが 使用される。 このフラグはシグナルハンドラを設定する際にのみ意味を持つ。
 138 .TP
 139 \fBSA_RESETHAND\fP
 140 シグナルハンドラが呼ばれる度に、シグナルの動作をデフォルトに戻す。 このフラグはシグナルハンドラを設定する際にのみ意味を持つ。
 141 \fBSA_ONESHOT\fP はこのフラグと同じ意味だが、廃止されており、非標準である。
 142 .TP
 143 \fBSA_RESTART\fP
 144 いくつかのシステムコールをシグナルの通知の前後で再開できるようにして、 BSD シグナル方式 (semantics) と互換性のある動作を提供する。
 145 このフラグはシグナルハンドラを設定する際にのみ意味を持つ。 \fBsignal\fP(7)  に書かれているシステムコールの再開に関する議論を参照のこと。
 146 .TP
 147 \fBSA_SIGINFO\fP (Linux 2.2 以降)
 148 .\" (The
 149 .\" .I sa_sigaction
 150 .\" field was added in Linux 2.1.86.)
 151 シグナルハンドラは一つではなく、三つの引き数を持つ。この場合は \fIsa_handler\fP のかわりに \fIsa_sigaction\fP
 152 を設定しなければならない このフラグはシグナルハンドラを設定する際にのみ意味を持つ。
 153 .RE
 154 .PP
 155 \fIsa_sigaction\fP のパラメータ \fIsiginfo_t\fP は以下の要素を持つ構造体である:
 156 .sp
 157 .in +4n
 158 .nf
 159 .\" FIXME
 160 .\" si_trapno seems to be only used on SPARC and Alpha;
 161 .\" this page could use a little more detail on its purpose there.
 162 .\" In the kernel: si_tid
 163 siginfo_t {
 164     int      si_signo;    /* Signal number */
 165     int      si_errno;    /* An errno value */
 166     int      si_code;     /* Signal code */
 167     int      si_trapno;   /* Trap number that caused
 168                              hardware\-generated signal
 169                              (unused on most architectures) */
 170     pid_t    si_pid;      /* Sending process ID */
 171     uid_t    si_uid;      /* Real user ID of sending process */
 172     int      si_status;   /* Exit value or signal */
 173     clock_t  si_utime;    /* User time consumed */
 174     clock_t  si_stime;    /* System time consumed */
 175     sigval_t si_value;    /* Signal value */
 176     int      si_int;      /* POSIX.1b signal */
 177     void    *si_ptr;      /* POSIX.1b signal */
 178     int      si_overrun;  /* Timer overrun count; POSIX.1b timers */
 179     int      si_timerid;  /* Timer ID; POSIX.1b timers */
 180     void    *si_addr;     /* Memory location which caused fault */
 181     long     si_band;     /* Band event (was \fIint\fP in
 182                              glibc 2.3.2 and earlier) */
 183     int      si_fd;       /* File descriptor */
 184     short    si_addr_lsb; /* Least significant bit of address
 185                              (since kernel 2.6.32) */
 186 }
 187 .fi
 188 .in
 189
 190 \fIsi_signo\fP, \fIsi_errno\fP, \fIsi_code\fP は全てのシグナルに対して定義されている (\fIsi_errno\fP は
 191 Linux では一般的には使用されない)。 構造体の残りの部分は、共用体 (union) になっているかもしれない。
 192 その場合は該当するシグナルにおいて意味のあるフィールドのみを読み込む ことができる。
 193 .IP * 2
 194 Signals sent with \fBkill\fP(2)  and \fBsigqueue\fP(3)  fill in \fIsi_pid\fP and
 195 \fIsi_uid\fP.  In addition, signals sent with \fBsigqueue\fP(3)  fill in \fIsi_int\fP
 196 and \fIsi_ptr\fP with the values specified by the sender of the signal; see
 197 \fBsigqueue\fP(3)  for more details.
 198 .IP *
 199 POSIX.1b タイマ (Linux 2.6 以降) は \fIsi_overrun\fP と \fIsi_timerid\fP を
 200 設定する。 \fIsi_timerid\fP フィールドはカーネルがタイマを特定するのに
 201 使用する内部 ID であり、 \fBtimer_create\fP(2) が返すタイマ ID と同じではない。
 202 \fIsi_overrun\fP フィールドはタイマが回り切った回数である。
 203 これは \fBtimer_getoverrun\fP(2) の呼び出しで取得できる情報と同じである。
 204 これらのフィールドは非標準で Linux による拡張である。
 205 .IP *
 206 Signals sent for message queue notification (see the description of
 207 \fBSIGEV_SIGNAL\fP in \fBmq_notify\fP(3))  fill in \fIsi_int\fP/\fIsi_ptr\fP, with the
 208 \fIsigev_value\fP supplied to \fBmq_notify\fP(3); \fIsi_pid\fP, with the process ID
 209 of the message sender; and \fIsi_uid\fP, with the real user ID of the message
 210 sender.
 211 .IP *
 212 .\" FIXME .
 213 .\" When si_utime and si_stime where originally implemented, the
 214 .\" measurement unit was HZ, which was the same as clock ticks
 215 .\" (sysconf(_SC_CLK_TCK)).  In 2.6, HZ became configurable, and
 216 .\" was *still* used as the unit to return the info these fields,
 217 .\" with the result that the field values depended on the the
 218 .\" configured HZ.  Of course, the should have been measured in
 219 .\" USER_HZ instead, so that sysconf(_SC_CLK_TCK) could be used to
 220 .\" convert to seconds.  I have a queued patch to fix this:
 221 .\" http://thread.gmane.org/gmane.linux.kernel/698061/ .
 222 .\" This patch made it into 2.6.27.
 223 .\" But note that these fields still don't return the times of
 224 .\" waited-for children (as is done by getrusage() and times()
 225 .\" and wait4()).  Solaris 8 does include child times.
 226 \fBSIGCHLD\fP は \fIsi_pid\fP, \fIsi_uid\fP, \fIsi_status\fP, \fIsi_utime\fP,
 227 \fIsi_stime\fP を設定し、子プロセスに関する情報を提供する。
 228 \fIsi_pid\fP フィールドは子プロセスのプロセス ID で、
 229 \fIsi_uid\fP フィールドは子プロセスの実ユーザ ID である。
 230 \fIsi_stime\fP フィールドには、 (\fIsi_code\fP が \fBCLD_EXITED\fP の場合は)
 231 子プロセスの終了ステータスが、それ以外の場合は状態が変化する原因と
 232 なったシグナル番号が格納される。
 233 \fIsi_utime\fP と \fIsi_stime\fP には子プロセスが使用したユーザ CPU 時間とシ
 234 ステム CPU 時間がそれぞれ格納される。(\fBgetrusage\fP(2) や \fBtime\fP(2) と
 235 異なり) これらのフィールドには wait 待ちの子プロセスにより使用された時
 236 間は含まれない。 2.6 より前と 2.6.27 以降のカーネルでは、 これらのフィー
 237 ルドに格納される CPU 時間の単位は \fIsysconf(_SC_CLK_TCK)\fP である。
 238 2.6.27 より前の 2.6 系のカーネルでは、バグがあり、 これらのフィールドの
 239 CPU 時間の単位が (カーネルのコンフィグで指定される) システムの jiffy で
 240 あった (\fBtime\fP(7) 参照)。
 241 .IP *
 242 .\" FIXME SIGTRAP also sets the following for ptrace_notify() ?
 243 .\"     info.si_code = exit_code;
 244 .\"     info.si_pid = task_pid_vnr(current);
 245 .\"     info.si_uid = current_uid();  /* Real UID */
 246 \fBSIGILL\fP, \fBSIGFPE\fP, \fBSIGSEGV\fP, \fBSIGBUS\fP, and \fBSIGTRAP\fP fill in
 247 \fIsi_addr\fP with the address of the fault.  On some architectures, these
 248 signals also fill in the \fIsi_trapno\fP filed.  Some suberrors of \fBSIGBUS\fP,
 249 in particular \fBBUS_MCEERR_AO\fP and \fBBUS_MCEERR_AR\fP, also fill in
 250 \fIsi_addr_lsb\fP.  This field indicates the least significant bit of the
 251 reported address and therefore the extent of the corruption.  For example,
 252 if a full page was corrupted, \fIsi_addr_lsb\fP contains
 253 \fIlog2(sysconf(_SC_PAGESIZE))\fP.  \fBBUS_MCERR_*\fP and \fIsi_addr_lsb\fP are
 254 Linux\-specific extensions.
 255 .IP *
 256 \fBSIGIO\fP/\fBSIGPOLL\fP (the two names are synonyms on Linux)  fills in
 257 \fIsi_band\fP and \fIsi_fd\fP.  The \fIsi_band\fP event is a bit mask containing the
 258 same values as are filled in the \fIrevents\fP field by \fBpoll\fP(2).  The
 259 \fIsi_fd\fP field indicates the file descriptor for which the I/O event
 260 occurred.
 261 .PP
 262 \fIsi_code\fP は、そのシグナルが送信された理由を示す値である (ビットマスクではない)。 以下のリストに、どのシグナルの場合でも
 263 \fIsi_code\fP に入りうる値を、シグナルが生成された理由とともに記載する。
 264 .RS 4
 265 .TP  15
 266 \fBSI_USER\fP
 267 \fBkill\fP(2)
 268 .TP
 269 \fBSI_KERNEL\fP
 270 カーネルにより送信された
 271 .TP
 272 \fBSI_QUEUE\fP
 273 \fBsigqueue\fP(3)
 274 .TP
 275 \fBSI_TIMER\fP
 276 POSIX タイマが満了した
 277 .TP
 278 \fBSI_MESGQ\fP
 279 POSIX メッセージキューの状態が変化した (Linux 2.6.6 以降)。 \fBmq_notify\fP(3)\fB参照。\fP
 280 .TP
 281 \fBSI_ASYNCIO\fP
 282 非同期 IO (AIO) が完了した
 283 .TP
 284 \fBSI_SIGIO\fP
 285 Queued \fBSIGIO\fP (only in kernels up to Linux 2.2; from Linux 2.4 onward
 286 \fBSIGIO\fP/\fBSIGPOLL\fP fills in \fIsi_code\fP as described below).
 287 .TP
 288 \fBSI_TKILL\fP
 289 .\" SI_DETHREAD is defined in 2.6.9 sources, but isn't implemented
 290 .\" It appears to have been an idea that was tried during 2.5.6
 291 .\" through to 2.5.24 and then was backed out.
 292 \fBtkill\fP(2)  または \fBtgkill\fP(2)  (Linux 2.4.19 以降)
 293 .RE
 294 .PP
 295 \fBSIGILL\fP シグナルの場合、 \fIsi_code\fP には以下の値を指定できる:
 296 .RS 4
 297 .TP  15
 298 \fBILL_ILLOPC\fP
 299 不正な命令コード (opcode)
 300 .TP
 301 \fBILL_ILLOPN\fP
 302 不正なオペランド
 303 .TP
 304 \fBILL_ILLADR\fP
 305 不正なアドレッシングモード
 306 .TP
 307 \fBILL_ILLTRP\fP
 308 不正なトラップ
 309 .TP
 310 \fBILL_PRVOPC\fP
 311 特権が必要な命令コード (opcode)
 312 .TP
 313 \fBILL_PRVREG\fP
 314 特権が必要なレジスタ
 315 .TP
 316 \fBILL_COPROC\fP
 317 コプロセッサのエラー
 318 .TP
 319 \fBILL_BADSTK\fP
 320 内部スタックエラー
 321 .RE
 322 .PP
 323 \fBSIGFPE\fP シグナルの場合、 \fIsi_code\fP には以下の値を指定できる:
 324 .RS 4
 325 .TP  15
 326 \fBFPE_INTDIV\fP
 327 整数の 0 による除算
 328 .TP
 329 \fBFPE_INTOVF\fP
 330 整数のオーバーフロー
 331 .TP
 332 \fBFPE_FLTDIV\fP
 333 浮動小数点の 0 による除算
 334 .TP
 335 \fBFPE_FLTOVF\fP
 336 浮動小数点のオーバーフロー
 337 .TP
 338 \fBFPE_FLTUND\fP
 339 浮動小数点のアンダーフロー
 340 .TP
 341 \fBFPE_FLTRES\fP
 342 浮動小数点の不正確な演算結果 (inexact result)
 343 .TP
 344 \fBFPE_FLTINV\fP
 345 浮動小数点の不正な操作
 346 .TP
 347 \fBFPE_FLTSUB\fP
 348 範囲外の添字 (subscript)
 349 .RE
 350 .PP
 351 \fBSIGSEGV\fP シグナルの場合、 \fIsi_code\fP には以下の値を指定できる:
 352 .RS 4
 353 .TP  15
 354 \fBSEGV_MAPERR\fP
 355 オブジェクトにマッピングされていないアドレス
 356 .TP
 357 \fBSEGV_ACCERR\fP
 358 マッピングされたオブジェクトに対するアクセス許可がない
 359 .RE
 360 .PP
 361 \fBSIGBUS\fP シグナルの場合、 \fIsi_code\fP には以下の値を指定できる:
 362 .RS 4
 363 .TP  15
 364 \fBBUS_ADRALN\fP
 365 不正なアドレス・アライメント (alignment)
 366 .TP
 367 \fBBUS_ADRERR\fP
 368 存在しない物理アドレス
 369 .TP
 370 \fBBUS_OBJERR\fP
 371 オブジェクト固有のハードウェアエラー
 372 .TP
 373 \fBBUS_MCEERR_AR\fP (Linux 2.6.32 以降)
 374 Hardware memory error consumed on a machine check; action required.
 375 .TP
 376 \fBBUS_MCEERR_AO\fP (Linux 2.6.32  以降)
 377 Hardware memory error detected in process but not consumed; action optional.
 378 .RE
 379 .PP
 380 \fBSIGTRAP\fP シグナルの場合、 \fIsi_code\fP には以下の値を指定できる:
 381 .RS 4
 382 .TP  15
 383 \fBTRAP_BRKPT\fP
 384 プロセスのブレークポイント
 385 .TP
 386 \fBTRAP_TRACE\fP
 387 プロセスのトレース・トラップ
 388 .TP
 389 \fBTRAP_BRANCH\fP (Linux 2.4 以降)
 390 process taken branch trap
 391 .TP
 392 \fBTRAP_HWBKPT\fP (Linux 2.4 以降)
 393 hardware breakpoint/watchpoint
 394 .RE
 395 .PP
 396 \fBSIGCHLD\fP シグナルの場合、 \fIsi_code\fP には以下の値を指定できる:
 397 .RS 4
 398 .TP  15
 399 \fBCLD_EXITED\fP
 400 子プロセスが終了した (exited)
 401 .TP
 402 \fBCLD_KILLED\fP
 403 子プロセスが kill された
 404 .TP
 405 \fBCLD_DUMPED\fP
 406 子プロセスが異常終了した
 407 .TP
 408 \fBCLD_TRAPPED\fP
 409 トレース対象の子プロセスがトラップを上げた
 410 .TP
 411 \fBCLD_STOPPED\fP
 412 子プロセスが停止 (stop) した
 413 .TP
 414 \fBCLD_CONTINUED\fP
 415 停止していた子プロセスが再開した (Linux 2.6.9 以降)
 416 .RE
 417 .PP
 418 \fBSIGIO\fP/\fBSIGPOLL\fP シグナルの場合、 \fIsi_code\fP には以下の値を
 419 指定できる:
 420 .RS 4
 421 .TP  15
 422 \fBPOLL_IN\fP
 423 入力データが利用可能
 424 .TP
 425 \fBPOLL_OUT\fP
 426 出力バッファが利用可能
 427 .TP
 428 \fBPOLL_MSG\fP
 429 入力メッセージが利用可能
 430 .TP
 431 \fBPOLL_ERR\fP
 432 I/O エラー
 433 .TP
 434 \fBPOLL_PRI\fP
 435 高優先の入力が利用可能
 436 .TP
 437 \fBPOLL_HUP\fP
 438 デバイスが接続されていない
 439 .RE
 440 .SH 返り値
 441 \fBsigaction\fP()  は成功すれば 0 を返し、エラーならば \-1 を返す。
 442 .SH エラー
 443 .TP
 444 \fBEFAULT\fP
 445 \fIact\fP か \fIoldact\fP が指しているメモリが正しいプロセスのアドレス空間にない。
 446 .TP
 447 \fBEINVAL\fP
 448 無効なシグナルが指定された。補足 (catch) したり無視したりできない シグナルである \fBSIGKILL\fP や \fBSIGSTOP\fP
 449 に対する動作を変更しようとした場合にも発生する。
 450 .SH 準拠
 451 .\" SVr4 does not document the EINTR condition.
 452 POSIX.1\-2001, SVr4.
 453 .SH 注意
 454 \fBfork\fP(2) 経由で作成された子プロセスは、親プロセスのシグナルの処理方法の コピーを継承する。
 455 \fBexecve\fP(2) の前後で、ハンドラが設定されているシグナルの処理方法はデフォルトにリセットされ、
 456 無視が設定されているシグナルの処理方法は変更されずそのままとなる。
 457
 458 POSIX では、 \fBkill\fP(2)  や \fBraise\fP(3)  で生成できないシグナル \fBSIGFPE\fP, \fBSIGILL\fP,
 459 \fBSIGSEGV\fP を無視 (ignore) した場合、その後の動作は未定義である。 ゼロによる整数割り算の結果は未定義となる。
 460 アーキテクチャーによっては、このとき \fBSIGFPE\fP シグナルが生成される。 (同様に負の最大整数を \-1 で割ると \fBSIGFPE\fP
 461 が生成されるかもしれない)  このシグナルを無視すると無限ループに陥るかもしれない。
 462 .PP
 463 POSIX.1\-1990 では \fBSIGCHLD\fP に \fBSIG_IGN\fP を設定することを認めていない。 POSIX.1\-2001
 464 では認められており、 \fBSIGCHLD\fP を無視することでゾンビプロセスの生成を防止することができる (\fBwait\fP(2)  を参照)。
 465 さらに、BSD と SystemV では \fBSIGCHLD\fP を無視した際の動作が異なっている。
 466 そのため、完全に移植性がある方法で、終了した子プロセスがゾンビにならないこと を保証するには、 \fBSIGCHLD\fP シグナルを補足し、
 467 \fBwait\fP(2)  などを実行するしかない。
 468 .PP
 469 POSIX.1\-1990 の仕様では \fBSA_NOCLDSTOP\fP のみが定義されている。
 470 POSIX.1\-2001 では \fBSA_NOCLDWAIT\fP, \fBSA_RESETHAND\fP, \fBSA_NODEFER\fP,
 471 \fBSA_SIGINFO\fP が追加された。 UNIX の古い実装で動かすアプリケーションで、
 472 他の \fIsa_flags\fP フラグを使用すると移植性が下がる。
 473 .PP
 474 \fBSA_RESETHAND\fP フラグは SVr4 の同じ名前のフラグと互換性がある。
 475 .PP
 476 \fBSA_NODEFER\fP フラグは 1.3.9 以降のカーネルでは同じ名前の SVr4 のフラグと互換性がある。 ぞれ以前の Linux
 477 カーネルの実装では、このフラグを設定しているシグナル だけでなく、どのシグナルでも受けることを許していた (実際には \fIsa_mask\fP
 478 の設定により無効にできる)。
 479 .PP
 480 \fBsigaction\fP()  の二番目の引き数に NULL を指定して呼び出すと、現在のシグナルハンドラを確認する
 481 ことができる。また、二番目と三番目の引き数を NULL にて呼び出すことで、 指定されたシグナルが現在のマシンで使えるかどうかチェックできる。
 482 .PP
 483 \fBSIGKILL\fP や \fBSIGSTOP\fP を (\fIsa_mask\fP に指定して) 禁止することはできない。 禁止しようとしても黙って無視される。
 484 .PP
 485 シグナル集合の操作に関する詳細は \fBsigsetops\fP(3)  を参照のこと。
 486 .PP
 487 シグナルハンドラ内から安全に呼び出すことができる、 async\-signal\-safe functions (非同期シングルで安全な関数) の
 488 リストについては \fBsignal\fP(7)  を参照。
 489 .SS 非公式
 490 \fBSA_SIGINFO\fP が導入される前は、 \fIstruct sigcontext\fP 型の二番目の引き数と一緒に \fIsa_handler\fP
 491 を使用することで、 いくつかの追加の情報を入手することができた。 詳細についてはカーネルソースの関連部分を見てほしい。
 492 現在はこの使用法は廃止されている。
 493 .SH バグ
 494 2.6.13 以前のカーネルでは、 \fIsa_flags\fP に \fBSA_NODEFER\fP を指定した場合、
 495 ハンドラが実行中に配送されたシグナル自身がマスクされなくなるだけでなく、 \fIsa_mask\fP に指定されたシグナルもマスクされなくなる。
 496 このバグは、カーネル 2.6.14 で修正された。
 497 .SH 例
 498 \fBmprotect\fP(2)  参照。
 499 .SH 関連項目
 500 \fBkill\fP(1), \fBkill\fP(2), \fBkillpg\fP(2), \fBpause\fP(2), \fBsigaltstack\fP(2),
 501 \fBsignal\fP(2), \fBsignalfd\fP(2), \fBsigpending\fP(2), \fBsigprocmask\fP(2),
 502 \fBsigsuspend\fP(2), \fBwait\fP(2), \fBraise\fP(3), \fBsiginterrupt\fP(3),
 503 \fBsigqueue\fP(3), \fBsigsetops\fP(3), \fBsigvec\fP(3), \fBcore\fP(5),
 504 \fBsignal\fP(7)
 505 .SH この文書について
 506 この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.40 の一部
 507 である。プロジェクトの説明とバグ報告に関する情報は
 508 http://www.kernel.org/doc/man\-pages/ に書かれている。