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