release/man2/signal.2

   1 .\" Copyright (c) 2000 Andries Brouwer <aeb@cwi.nl>
   2 .\" and Copyright (c) 2008, Linux Foundation, written by Michael Kerrisk
   3 .\"      <mtk.manpages@gmail.com>
   4 .\" and Copyright (c) 2008, Linux Foundation, written by Michael Kerrisk
   5 .\"      <mtk.manpages@gmail.com>
   6 .\" based on work by Rik Faith <faith@cs.unc.edu>
   7 .\" and Mike Battersby <mike@starbug.apana.org.au>.
   8 .\"
   9 .\" Permission is granted to make and distribute verbatim copies of this
  10 .\" manual provided the copyright notice and this permission notice are
  11 .\" preserved on all copies.
  12 .\"
  13 .\" Permission is granted to copy and distribute modified versions of this
  14 .\" manual under the conditions for verbatim copying, provided that the
  15 .\" entire resulting derived work is distributed under the terms of a
  16 .\" permission notice identical to this one.
  17 .\"
  18 .\" Since the Linux kernel and libraries are constantly changing, this
  19 .\" manual page may be incorrect or out-of-date.  The author(s) assume no
  20 .\" responsibility for errors or omissions, or for damages resulting from
  21 .\" the use of the information contained herein.  The author(s) may not
  22 .\" have taken the same level of care in the production of this manual,
  23 .\" which is licensed free of charge, as they might when working
  24 .\" professionally.
  25 .\"
  26 .\" Formatted or processed versions of this manual, if unaccompanied by
  27 .\" the source, must acknowledge the copyright and authors of this work.
  28 .\"
  29 .\" Modified 2004-11-19, mtk:
  30 .\" added pointer to sigaction.2 for details of ignoring SIGCHLD
  31 .\" 2007-06-03, mtk: strengthened portability warning, and rewrote
  32 .\"     various sections.
  33 .\" 2008-07-11, mtk: rewrote and expanded portability discussion.
  34 .\"
  35 .\" Japanese Version Copyright (c) 1997 HANATAKA Shinya
  36 .\"         all rights reserved.
  37 .\" Translated 1997-03-03, HANATAKA Shinya <hanataka@abyss.rim.or.jp>
  38 .\" Modified 2000-09-24, HANATAKA Shinya <hanataka@abyss.rim.or.jp>
  39 .\" Updated & Modified 2002-01-14, Yuichi SATO <ysato@h4.dion.ne.jp>
  40 .\" Updated & Modified 2004-01-17, Yuichi SATO <ysato444@yahoo.co.jp>
  41 .\" Updated & Modified 2005-01-07, Yuichi SATO
  42 .\" Updated 2007-06-01, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>, LDP v2.50
  43 .\" Updated 2007-06-13, Akihiro MOTOKI, LDP v2.55
  44 .\" Updated 2008-08-08, Akihiro MOTOKI, LDP v3.05
  45 .\"
  46 .\"WORD:        signal                  シグナル
  47 .\"WORD:        signal handler          シグナル・ハンドラ
  48 .\"WORD:        library                 ライブラリ
  49 .\"WORD:        semantics               方式
  50 .\"WORD:        prototype               型宣言
  51 .\"WORD:        architecture            アーキテクチャー
  52 .\"WORD:        endless loop            無限ループ
  53 .\"WORD:        feature test macro      機能検査マクロ
  54 .\"WORD:        disposition             処理方法
  55 .\"
  56 .TH SIGNAL 2 2008-07-11 "Linux" "Linux Programmer's Manual"
  57 .SH 名前
  58 signal \- ANSI C シグナル操作
  59 .SH 書式
  60 .B #include <signal.h>
  61 .sp
  62 .B typedef void (*sighandler_t)(int);
  63 .sp
  64 .BI "sighandler_t signal(int " signum ", sighandler_t " sighandler );
  65 .SH 説明
  66 .BR signal ()
  67 の動作は UNIX のバージョンにより異なる。
  68 また、歴史的に見て Linux のバージョンによっても異なっている。
  69 \fBこのシステムコールの使用は避け、\fP
  70 代わりに
  71 .BR sigaction (2)
  72 を使用すること。
  73 下記の「移植性」を参照。
  74
  75 .BR signal ()
  76 はシグナル
  77 .I signum
  78 の処理方法を
  79 .I handler
  80 に設定する。
  81 .I handler
  82 には、
  83 .BR SIG_IGN "、"
  84 .BR SIG_DFL "、"
  85 プログラマが定義した関数 (「シグナル・ハンドラ」) のアドレスの
  86 いずれかを指定する。
  87
  88 シグナル
  89 .I signum
  90 がプロセスに配送されると、以下のいずれかが発生する。
  91 .TP 3
  92 *
  93 処理方法が
  94 .B SIG_IGN
  95 に設定されている場合、そのシグナルは無視される。
  96 .TP
  97 *
  98 処理方法が
  99 .B SIG_DFL
 100 に設定されている場合、シグナルに関連づけられた
 101 デフォルトの動作が行われる
 102 .RB ( signal (7)
 103 参照)。
 104 .TP
 105 *
 106 処理方法として関数が設定されている場合、
 107 まず最初に処理方法が
 108 .B SIG_DFL
 109 にリセットされるかそのシグナルのブロックが実行された後、
 110 .I signum
 111 を引き数として
 112 .I handler
 113 が呼び出される。
 114 ハンドラが起動される際にシグナルがブロックされた場合、
 115 ハンドラが返る際にそのシグナルのブロックが解除される。
 116 .PP
 117 シグナル
 118 .B SIGKILL
 119 と
 120 .B SIGSTOP
 121 は捕捉できず、無視することもできない。
 122 .SH 返り値
 123 .BR signal ()
 124 は、今までのシグナル・ハンドラの値を返す。エラーの場合は
 125 .B SIG_ERR
 126 を返す。
 127 .SH エラー
 128 .TP
 129 .B EINVAL
 130 .I signum
 131 が不正である。
 132 .SH 準拠
 133 C89, C99, POSIX.1-2001.
 134 .SH 注意
 135 マルチスレッドプロセスにおける
 136 .BR signal ()
 137 の結果は、指定されていない。
 138 .PP
 139 POSIX によると、
 140 .BR kill (2)
 141 や
 142 .BR raise (3)
 143 で生成できない
 144 .BR SIGFPE ,
 145 .BR SIGILL ,
 146 .B SIGSEGV
 147 シグナルを無視した後の動作は未定義である。
 148 0 による整数割り算の結果は未定義となる。
 149 ある種のアーキテクチャでは、これは
 150 .B SIGFPE
 151 シグナルを生成する。
 152 (同様に負の最大整数を \-1 で割ると
 153 .B SIGFPE
 154 が生成されるかもしれない。)
 155 このシグナルを無視すると無限ループに陥るかもしれない。
 156 .PP
 157 .B SIGCHLD
 158 の動作として
 159 .B SIG_IGN
 160 を設定した場合の詳細な動作については、
 161 .BR sigaction (2)
 162 を参照すること。
 163 .PP
 164 シグナル・ハンドラ内から安全に呼び出すことができる、
 165 async-signal-safe functions (非同期シングルで安全な関数) の
 166 リストについては
 167 .BR signal (7)
 168 を参照。
 169 .PP
 170 .I sighandler_t
 171 の使用は GNU 拡張である。
 172 各種バージョンの libc でこの型は定義済みである;
 173 libc4 と libc5 では
 174 .I SignalHandler
 175 を定義している。
 176 glibc では
 177 .I sig_t
 178 を定義しており、
 179 .B _GNU_SOURCE
 180 が定義されている場合には
 181 .I sighandler_t
 182 も定義されている。
 183 このような型を使用しないと、
 184 .BR signal ()
 185 の宣言は読みにくいものとなる。
 186 .in +4n
 187 .nf
 188
 189 .BI "void ( *" signal "(int " signum ", void (*" handler ")(int)) ) (int);"
 190 .fi
 191 .in
 192 .SS 移植性
 193 移植性のある
 194 .BR signal ()
 195 の使い方は、シグナルの処理方法を
 196 .BR SIG_DFL
 197 か
 198 .BR SIG_IGN
 199 に設定する方法だけである。
 200 シグナル・ハンドラを設定するのに
 201 .BR signal ()
 202 を使ったときの動作はシステムにより異なる
 203 (POSIX.1 は明示的にこの違いを認めている)。
 204 .B "移植性が必要なときはこのシステムコールを使用しないこと。"
 205
 206 POSIX.1 は、
 207 .BR sigaction (2)
 208 を規定することで移植性に関する混乱を解決した。
 209 .BR sigaction (2)
 210 はシグナル・ハンドラが起動される際の挙動を明示的に制御できる。
 211 .BR signal ()
 212 の代わりにこのインターフェイスを使うこと。
 213
 214 オリジナルの UNIX システムでは、
 215 .BR signal ()
 216 を使って設定されたハンドラがシグナルの配送により起動されると、
 217 そのシグナルの処理方法は
 218 .B SIG_DFL
 219 にリセットされ、システムは同じシグナルがさらに生成されても
 220 シグナルの配送をブロックしなかった。
 221 System V でも、
 222 .BR signal ()
 223 に対してこれらの挙動を規定している。
 224 こうした挙動はまずく、ハンドラがハンドラ自身を再設定する機会が
 225 来るより前に、同じシグナルがまた配送される可能性がある。
 226 さらに、同じシグナルが立て続けに配送されると、同じシグナルが
 227 ハンドラを繰り返し起動されることになる。
 228
 229 BSD では、シグナル処理の挙動を変更することで、この状況を改善した
 230 (しかし、残念なことに、
 231 .BR signal ()
 232 を使ってハンドラを設定する際に挙動が黙って変更される)。
 233 BSD では、シグナルハンドラが起動された際、
 234 シグナルの処理方法はリセットされず、
 235 ハンドラの実行中は、同じシグナルのさらなる生成は配送がブロックされる。
 236
 237 Linux での状況は以下の通りである。
 238 .IP * 2
 239 カーネルの
 240 .BR signal ()
 241 システムコールは System V 方式を提供している。
 242 .IP *
 243 デフォルトでは、glibc 2 以降では、
 244 .BR signal ()
 245 ラッパー関数はカーネルのシステムコールを起動しない。
 246 代わりに、ラッパー関数は BSD 方式を示すフラグを使って
 247 .BR sigaction (2)
 248 を呼び出す。
 249 機能検査マクロ
 250 .B _BSD_SOURCE
 251 を定義していれば、このデフォルトの動作となる。
 252 デフォルトでは、
 253 .B _BSD_SOURCE
 254 が定義される。
 255 .B _BSD_SOURCE
 256 は
 257 .B _GNU_SOURCE
 258 が定義された場合には暗黙のうちに定義され、
 259 もちろん明示的に定義することもできる。
 260 .sp
 261 glibc 2 以降では、機能検査マクロ
 262 .B _BSD_SOURCE
 263 が定義されていなければ、
 264 .BR signal ()
 265 は System V 方式となる。
 266 .RB ( gcc (1)
 267 が標準指定モード
 268 .RI ( -std=xxx " or " -ansi )
 269 で起動された場合、もしくは
 270 .BR _POSIX_SOURCE ,
 271 .BR _XOPEN_SOURCE ,
 272 .B _SVID_SOURCE
 273 といった他の様々な機能検査マクロが定義された場合、
 274 デフォルトの
 275 .B _BSD_SOURCE
 276 の暗黙の定義は行われない。
 277 .BR feature_test_macros (7)
 278 を参照のこと。)
 279 .\"
 280 .\" System V semantics are also provided if one uses the separate
 281 .\" .BR sysv_signal (3)
 282 .\" function.
 283 .IP *
 284 Linux の libc4 と libc5 の
 285 .BR signal ()
 286 関数は System V 方式である。
 287 libc5 システムにおいて
 288 .I <signal.h>
 289 のかわりに
 290 .I <bsd/signal.h>
 291 をインクルードすると、
 292 .BR signal ()
 293 は
 294 .BR __bsd_signal ()
 295 に再定義され、
 296 .BR signal ()
 297 は BSD 方式となる。
 298 .SH 関連項目
 299 .BR kill (1),
 300 .BR alarm (2),
 301 .BR kill (2),
 302 .BR killpg (2),
 303 .BR pause (2),
 304 .BR sigaction (2),
 305 .BR signalfd (2),
 306 .BR sigpending (2),
 307 .BR sigprocmask (2),
 308 .BR sigsuspend (2),
 309 .BR bsd_signal (3),
 310 .BR raise (3),
 311 .BR siginterrupt (3),
 312 .BR sigqueue (3),
 313 .BR sigsetops (3),
 314 .BR sigvec (3),
 315 .BR sysv_signal (3),
 316 .BR signal (7)