release/man2/wait.2

   1 .\" Hey Emacs! This file is -*- nroff -*- source.
   2 .\"
   3 .\" Copyright (c) 1993 by Thomas Koenig <ig25@rz.uni-karlsruhe.de>
   4 .\" and Copyright (c) 2004 by Michael Kerrisk <mtk.manpages@gmail.com>
   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 .\" License.
  26 .\"
  27 .\" Modified Sat Jul 24 13:30:06 1993 by Rik Faith <faith@cs.unc.edu>
  28 .\" Modified Sun Aug 21 17:42:42 1994 by Rik Faith <faith@cs.unc.edu>
  29 .\"          (Thanks to Koen Holtman <koen@win.tue.nl>)
  30 .\" Modified Wed May 17 15:54:12 1995 by Rik Faith <faith@cs.unc.edu>
  31 .\"           To remove *'s from status in macros (Thanks to Michael Shields).
  32 .\" Modified as suggested by Nick Duffek <nsd@bbc.com>, aeb, 960426
  33 .\" Modified Mon Jun 23 14:09:52 1997 by aeb - add EINTR.
  34 .\" Modified Thu Nov 26 02:12:45 1998 by aeb - add SIGCHLD stuff.
  35 .\" Modified Mon Jul 24 21:37:38 2000 by David A. Wheeler
  36 .\"          <dwheeler@dwheeler.com> - noted thread issues.
  37 .\" Modified 26 Jun 01 by Michael Kerrisk
  38 .\"          Added __WCLONE, __WALL, and __WNOTHREAD descriptions
  39 .\" Modified 2001-09-25, aeb
  40 .\" Modified 26 Jun 01 by Michael Kerrisk, <mtk.manpages@gmail.com>
  41 .\"     Updated notes on setting disposition of SIGCHLD to SIG_IGN
  42 .\" 2004-11-11, mtk
  43 .\"     Added waitid(2); added WCONTINUED and WIFCONTINUED()
  44 .\"     Added text on SA_NOCLDSTOP
  45 .\"     Updated discussion of SA_NOCLDWAIT to reflect 2.6 behavior
  46 .\"     Much other text rewritten
  47 .\" 2005-05-10, mtk, __W* flags can't be used with waitid()
  48 .\" 2008-07-04, mtk, removed erroneous text about SA_NOCLDSTOP
  49 .\"
  50 .\" Japanese Version Copyright (c) 1997 HANATAKA Shinya all rights reserved.
  51 .\" Japanese Version Copyright (c) 2005 Akihiro MOTOKI all rights reserved.
  52 .\" Translated 1997-03-04, HANATAKA Shinya <hanataka@abyss.rim.or.jp>
  53 .\" Modified 2000-09-23, HANATAKA Shinya <hanataka@abyss.rim.or.jp>
  54 .\" Updated 2001-06-25, Kentaro Shirakata <argrath@ub32.org>
  55 .\" Updated 2001-10-15, Kentaro Shirakata <argrath@ub32.org>
  56 .\" Updated 2001-12-13, Kentaro Shirakata <argrath@ub32.org>
  57 .\" Updated 2002-10-21, Kentaro Shirakata <argrath@ub32.org>
  58 .\" Updated 2003-01-27, Kentaro Shirakata <argrath@ub32.org>
  59 .\" Updated 2003-09-12, Kentaro Shirakata <argrath@ub32.org>
  60 .\" Updated 2005-03-19, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
  61 .\" Updated 2005-12-26, Akihiro MOTOKI
  62 .\" Updated 2008-07-31, Akihiro MOTOKI, LDP v3.05
  63 .\"
  64 .\"WORD:        signal handling         シグナル処理
  65 .\"WORD:        suspend                 停止(suspend)
  66 .\"WORD:        zombie                  ゾンビ(zombie)
  67 .\"WORD:        child process           子プロセス
  68 .\"WORD:        process group           プロセス・グループ
  69 .\"WORD:        process group ID        プロセス・グループID
  70 .\"WORD:        stop                    停止(stop)
  71 .\"WORD:        effective user ID       実効ユーザーID
  72 .\"WORD:        block                   禁止(block)
  73 .\"
  74 .TH WAIT 2 2010-09-26 "Linux" "Linux Programmer's Manual"
  75 .SH 名前
  76 wait, waitpid, waitid \- プロセスの状態変化を待つ
  77 .SH 書式
  78 .B #include <sys/types.h>
  79 .br
  80 .B #include <sys/wait.h>
  81 .sp
  82 .BI "pid_t wait(int *" "status" );
  83
  84 .BI "pid_t waitpid(pid_t " pid ", int *" status ", int " options );
  85
  86 .BI "int waitid(idtype_t " idtype ", id_t " id \
  87 ", siginfo_t *" infop ", int " options );
  88 .sp
  89 .in -4n
  90 glibc 向けの機能検査マクロの要件
  91 .RB ( feature_test_macros (7)
  92 参照):
  93 .in
  94 .sp
  95 .ad l
  96 .PD 0
  97 .BR waitid ():
  98 .RS 4
  99 _SVID_SOURCE ||
 100 _XOPEN_SOURCE\ >=\ 500 ||
 101 _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED
 102 .br
 103 || /* glibc 2.12 以降: */ _POSIX_C_SOURCE\ >=\ 200809L
 104 .RE
 105 .PD
 106 .ad
 107 .SH 説明
 108 これらのシステムコールはいずれも、呼び出し元プロセスの子プロセスの
 109 状態変化を待ち、状態が変化したその子プロセスの情報を取得するのに
 110 使用される。
 111 状態変化とは以下のいずれかである:
 112 子プロセスの終了、シグナルによる子プロセスの停止、
 113 シグナルによる子プロセスの再開。
 114 子プロセスが終了した場合は、wait を実行することで、
 115 システムがその子プロセスに関連するリソースを解放できるようになる。
 116 wait が実行されなかった場合には、終了した子プロセスは
 117 「ゾンビ」状態で残り続ける (下記の注意の章を参照のこと)。
 118
 119 子プロセスの状態変化がすでに発生していた場合、これらのコールは
 120 すぐに復帰する。それ以外の場合は、子プロセスの状態変化が起こるか、
 121 シグナルハンドラによりシステムコールが中断されるまで、
 122 停止 (block) する (後者は、
 123 .BR sigaction (2)
 124 の
 125 .B SA_RESTART
 126 フラグによりシステムコールが自動的に再スタートするようになっていない
 127 場合の動作である)。
 128 以下の説明では、状態変化が起こったがこれらのシステムコールのいずれかに
 129 よって待たれていない子プロセスを
 130 .I waitable
 131 (待ち可能) と呼ぶ。
 132 .SS "wait() と waitpid()"
 133 .BR wait ()
 134 システムコールは、子プロセスのいずれかが終了するまで
 135 呼び出し元のプロセスの実行を一時停止する。
 136 以下の二つの呼び出しは等価である:
 137 .nf
 138
 139     wait(&status);
 140
 141     waitpid(\-1, &status, 0);
 142 .fi
 143
 144 .BR waitpid ()
 145 システムコールは、
 146 .I pid
 147 引き数で指定した子プロセスの状態変化が起こるまで、
 148 呼び出し元のプロセスの実行を一時停止する。デフォルトでは、
 149 .BR waitpid ()
 150 は子プロセスの終了だけを待つが、この動作は
 151 .I options
 152 引き数により変更可能である。
 153
 154 .I pid
 155 に指定できる値は以下の通り:
 156 .IP "< \-1"
 157 プロセスグループID が
 158 .I pid
 159 の絶対値に等しい子プロセスのいずれかが終了するまでを待つ。
 160 .IP \-1
 161 子プロセスのどれかが終了するまで待つ。
 162 .IP 0
 163 プロセスグループID が呼び出したプロセスのものと等しい
 164 子プロセスを待つ。
 165 .IP "> 0"
 166 プロセスID が
 167 .I pid
 168 に等しい子プロセスを待つ。
 169 .PP
 170 .I options
 171 の値は次の定数の 0 個以上の論理和である:
 172 .TP 12
 173 .B WNOHANG
 174 状態変化が起こった子プロセスがない場合にすぐに復帰する。
 175 .TP
 176 .B WUNTRACED
 177 子プロセスが停止した場合にも復帰する (子プロセスが
 178 .BR ptrace (2)
 179 でトレースされている場合は除く)。
 180 このオプションが指定されていない場合でも、停止したプロセスが
 181 「トレース (traced)」されていれば、子プロセスの状態が報告される。
 182 .TP
 183 .BR WCONTINUED " (Linux 2.6.10 以降)"
 184 停止した子プロセスが
 185 .B SIGCONT
 186 の配送により再開した場合にも復帰する。
 187 .PP
 188 (Linux 専用オプションについては後述する)
 189 .PP
 190 .I status
 191 が NULL でなければ、
 192 .BR wait ()
 193 や
 194 .BR waitpid ()
 195 は
 196 .I status
 197 で指す \fIint\fP に状態情報を格納する。
 198 この整数は以下のマクロを使って検査できる。
 199 (これらのマクロの引き数には、
 200 .BR wait ()
 201 や
 202 .BR waitpid ()
 203 が書き込んだ整数そのものを指定する。ポインタではない!)
 204 .TP
 205 .BI WIFEXITED( status )
 206 子プロセスが正常に終了した場合に真を返す。
 207 「正常に」とは、
 208 .BR exit (3)
 209 か
 210 .BR _exit (2)
 211 が呼び出された場合、もしくは
 212 main() から復帰した場合である。
 213 .TP
 214 .BI WEXITSTATUS( status )
 215 子プロセスの終了ステータスを返す。
 216 終了ステータスは
 217 .I status
 218 引き数の下位 8ビットで構成されており、
 219 .BR exit (3)
 220 や
 221 .BR _exit (2)
 222 の呼び出し時に渡された値、もしくは main() の return 文の
 223 引き数として指定された値である。
 224 このマクロを使用するのは
 225 .B WIFEXITED
 226 が真を返した場合だけにすべきである。
 227 .TP
 228 .BI WIFSIGNALED( status )
 229 子プロセスがシグナルにより終了した場合に真を返す。
 230 .TP
 231 .BI WTERMSIG( status )
 232 子プロセス終了の原因となったシグナルの番号を返す。
 233 このマクロを使用するのは
 234 .B WIFSIGNALED
 235 が真を返した場合だけにすべきである。
 236 .TP
 237 .BI WCOREDUMP( status )
 238 子プロセスがコアダンプを生成した場合に真を返す。
 239 このマクロを使用するのは
 240 .B WIFSIGNALED
 241 が真を返した場合だけにすべきである。
 242 このマクロは POSIX.1-2001 では規定されておらず、
 243 (AIX, SunOS などの) いくつかの UNIX の実装では利用できない。
 244 必ず #ifdef WCOREDUMP ... #endif で括って使用すること。
 245 .TP
 246 .BI WIFSTOPPED( status )
 247 子プロセスがシグナルの配送により停止した場合に真を返す。
 248 これが真になるのは、システムコールが
 249 .B WUNTRACED
 250 を指定して呼び出された場合か、子プロセスがトレースされている場合
 251 .RB ( ptrace (2)
 252 参照) だけである。
 253 .TP
 254 .BI WSTOPSIG( status )
 255 子プロセスを停止させたシグナルの番号を返す。
 256 このマクロを使用するのは
 257 .B WIFSTOPPED
 258 が 0 以外を返した場合だけにすべきである。
 259 .TP
 260 .BI WIFCONTINUED( status )
 261 (Linux 2.6.10 以降)
 262 子プロセスが
 263 .B SIGCONT
 264 の配送により再開した場合に真を返す。
 265 .SS "waitid()"
 266 .BR waitid ()
 267 システムコール (Linux 2.6.9 以降で利用可能) を使うと、
 268 子プロセスのどの状態変化を待つかについてより細かな制御ができる。
 269
 270 引き数
 271 .I idtype
 272 と
 273 .I id
 274 でどの子プロセスを待つかを選択する:
 275 .IP "\fIidtype\fP == \fBP_PID\fP"
 276 プロセスID が
 277 .I id
 278 と一致する子プロセスを待つ。
 279 .IP "\fIidtype\fP == \fBP_PGID\fP"
 280 プロセスグループID が
 281 .I id
 282 と一致する子プロセスを待つ。
 283 .IP "\fIidtype\fP == \fBP_ALL\fP"
 284 子プロセス全部を対象に待つ。
 285 .I id
 286 は無視される。
 287 .PP
 288 子プロセスのどの状態変化を待つかは以下のフラグで指定する
 289 .RI ( options
 290 には 1個以上のフラグの論理和をとって指定する):
 291 .TP 12
 292 .B WEXITED
 293 子プロセスの終了を待つ。
 294 .TP
 295 .B WSTOPPED
 296 子プロセスがシグナルの配送により停止するのを待つ。
 297 .TP
 298 .B WCONTINUED
 299 (停止していた) 子プロセスが
 300 .B SIGCONT
 301 が配送されて再開するのを待つ。
 302 .PP
 303 さらに以下のフラグを論理和の形で
 304 .I options
 305 に指定できる:
 306 .TP 12
 307 .B WNOHANG
 308 .BR waitpid ()
 309 と同様。
 310 .TP
 311 .B WNOWAIT
 312 waitable 状態のプロセスをそのままにする。この後で wait コールを
 313 使って、同じ子プロセスの状態情報をもう一度取得することができる。
 314 .PP
 315 成功した場合には、
 316 .BR waitid ()
 317 は
 318 .I infop
 319 が指す
 320 .I siginfo_t
 321 構造体の以下のフィールドを設定する:
 322 .TP 12
 323 \fIsi_pid\fP
 324 子プロセスのプロセスID。
 325 .TP
 326 \fIsi_uid\fP
 327 子プロセスの実ユーザID
 328 (このフィールドは他のほとんどの実装では設定されない)。
 329 .TP
 330 \fIsi_signo\fP
 331 常に
 332 .B SIGCHLD
 333 が設定される。
 334 .TP
 335 \fIsi_status\fP
 336 .BR _exit (2)
 337 (か
 338 .BR exit (3))
 339 に指定された子プロセスの終了ステータス、もしくは
 340 子プロセスの終了、停止、再開の原因となったシグナルが設定される。
 341 このフィールドをどう解釈するかは、
 342 .I si_code
 343 フィールドを参照して決めることができる。
 344 .TP
 345 \fIsi_code\fP
 346 以下のいずれかが設定される:
 347 .B CLD_EXITED
 348 (子プロセスが
 349 .BR _exit (2)
 350 を呼び出した);
 351 .B CLD_KILLED
 352 (シグナルにより子プロセスが kill された);
 353 .B CLD_DUMPED
 354 (シグナルにより子プロセスが kill され、コア・ダンプが行われた);
 355 .B CLD_STOPPED
 356 (シグナルにより子プロセスが停止した);
 357 .BR CLD_TRAPPED
 358 (トレースされていた子プロセスがトラップを受信した);
 359 .B CLD_CONTINUED
 360 .RB ( SIGCONT
 361 により子プロセスが再開された)。
 362 .PP
 363 .B WNOHANG
 364 が
 365 .I options
 366 に指定されていて、
 367 waitable 状態の子プロセスがなかった場合には、
 368 .BR waitid ()
 369 はすぐに 0 を返す。このとき、
 370 .I infop
 371 が指す
 372 .I siginfo_t
 373 構造体の内容は不定である。
 374 .\" POSIX.1-2001 では、不定の可能性を残している。
 375 .\" (Linux を含む) ほとんどの実装では、この場合に構造体を 0 で埋めるが、
 376 .\" 少なくとも一つの実装 (AIX 5.1) ではそうならない。 -- MTK Nov 04
 377 この場合を waitable 状態の子プロセスがあった場合と区別するには、
 378 .BR waitid ()
 379 を呼び出す前に
 380 .I si_pid
 381 を 0 にしておき、コールが復帰した後でこのフィールドが 0 以外の値かどうか
 382 をチェックすればよい。
 383 .SH 返り値
 384 .BR wait ():
 385 成功すると、終了した子プロセスのプロセスID を返す。
 386 エラーの場合 \-1 を返す。
 387
 388 .BR waitpid ():
 389 成功すると、状態が変化した子プロセスのプロセスID を返す。
 390 .B WNOHANG
 391 が指定されていて、
 392 .I pid
 393 で指示された子プロセスが一つ以上存在するが、どの子プロセスでも
 394 状態変化が起こっていなかった場合は、 0 を返す。
 395 エラーの場合 \-1 を返す。
 396
 397 .BR waitid ():
 398 成功すると 0 を返す。
 399 .B WNOHANG
 400 が指定されていて、
 401 .I pid
 402 で指示された子プロセスで状態変化が起こっていなかった場合にも
 403 0 を返す。
 404 エラーの場合 \-1 を返す。
 405 .\" FIXME: As reported by Vegard Nossum, if infop is NULL, then waitid()
 406 .\" returns the PID of the child.  Either this is a bug, or it is intended
 407 .\" behavior that needs to be documented.  See my Jan 2009 LKML mail
 408 .\" "waitid() return value strangeness when infop is NULL".
 409 エラーの場合、これらのシステムコールはいずれも
 410 .I errno
 411 に適切な値を設定する。
 412 .SH エラー
 413 .TP
 414 .B ECHILD
 415 .RB ( wait ()
 416 の場合)
 417 呼び出し元プロセスには、wait を行っていない子プロセスはない。
 418 .TP
 419 .B ECHILD
 420 .RB ( waitpid ()
 421 か
 422 .BR waitid ()
 423 の場合)
 424 .I pid
 425 .RB ( waitpid ())
 426 か
 427 .I idtype
 428 と
 429 .I id
 430 .RB ( waitid ())
 431 で指定したプロセスが存在しないか、呼び出し元プロセスの子プロセスでない
 432 .RB ( SIGCHLD
 433 の動作に
 434 .B SIG_IGN
 435 を設定した場合には、自分自身の子プロセスでも起こりうる。
 436 スレッドに関しては「Linux での注意」の節も参照すること)。
 437 .TP
 438 .B EINTR
 439 .B WNOHANG
 440 が設定されておらず、禁止 (block) されていないシグナルや
 441 .B SIGCHLD
 442 を受信した。
 443 .BR signal (7)
 444 参照。
 445 .TP
 446 .B EINVAL
 447 .I options
 448 引き数が不正である。
 449 .SH 準拠
 450 SVr4, 4.3BSD, POSIX.1-2001.
 451 .SH 注意
 452 終了したが、wait されていない子プロセスは「ゾンビ」になる。
 453 後で親プロセスが wait を実行して子プロセスについての情報を取得できるように、
 454 カーネルはゾンビプロセスについて最小限の情報 (PID、終了ステータス、
 455 リソース使用状況) を保持する。
 456 ゾンビプロセスは、 wait によってシステムから削除されない限り、
 457 カーネルのプロセステーブルの 1 エントリを消費する。このプロセステーブルが
 458 一杯になると、新たにプロセスを作ることができなくなる。
 459 親プロセスが終了すると、その親プロセスの「ゾンビ」の
 460 子プロセスは (もしあれば)
 461 .BR init (8)
 462 の養子となる。
 463 .BR init (8)
 464 は wait を自動的に実行し、ゾンビを削除する。
 465
 466 POSIX.1-2001 では以下のように規定されている。
 467 .B SIGCHLD
 468 の動作が
 469 .B SIG_IGN
 470 に設定されたか、
 471 .B SIGCHLD
 472 に対して
 473 .B SA_NOCLDWAIT
 474 フラグが設定された場合
 475 .RB ( sigaction (2)
 476 参照)、終了した子プロセスはゾンビにはならず、
 477 .BR wait ()
 478 や
 479 .BR waitpid ()
 480 の呼び出しは全ての子プロセスが終了するまで停止し、
 481 子プロセスが全部終了した後
 482 .I errno
 483 に
 484 .B ECHILD
 485 を設定して失敗する。
 486 (もともとの POSIX 標準は
 487 .B SIGCHLD
 488 に
 489 .B SIG_IGN
 490 を設定した場合の振る舞いを未規定のままにしている。
 491 .B SIGCHLD
 492 のデフォルトの動作が「無視」であるにもかかわらず、
 493 .B SIGCHLD
 494 の動作として
 495 .B SIG_IGN
 496 を明示的に設定した場合にはゾンビプロセスの子プロセスの扱いが
 497 異なる点に注意すること。)
 498 Linux 2.6 はこの仕様に準拠している。
 499 しかし、Linux 2.4 (とそれ以前のバージョン) はそうではない:
 500 .B SIGCHLD
 501 が無視される状態で
 502 .BR wait ()
 503 または
 504 .BR waitpid ()
 505 が呼び出された場合、
 506 .B SIGCHLD
 507 が無視されていないかのように振る舞う。
 508 つまり、呼び出しによって次の子プロセスの終了までブロックされ、
 509 終了した子プロセスの PID と状態が返される。
 510 .SS Linux での注意
 511 Linux カーネルでは、カーネルによってスケジュールされるスレッドは
 512 プロセスと明確に区別できる構成要素ではない。スレッドは Linux 固有の
 513 .BR clone (2)
 514 システムコールを使用して生成されるプロセスに過ぎない。
 515 移植性のある
 516 .BR pthread_create (3)
 517 コールのような他のルーチンは
 518 .BR clone (2)
 519 を使用して実装されている;
 520 これらでは
 521 .BR waitid ()
 522 を使うことはできない。
 523 Linux 2.4 より前では、スレッドは単に特殊なプロセスであったので、
 524 例え同じスレッドグループであっても、
 525 あるスレッドが別のスレッドの子プロセスが終了するのを待つことは出来なかった。
 526 しかし、POSIX ではこのような機能を規定しており、
 527 Linux 2.4 以降では、あるスレッドが同じスレッドグループの他のスレッドの
 528 子プロセスが終了するのを待つことができるようになった。
 529 そして将来はこれがデフォルトの動作になるであろう。
 530 .LP
 531 .BR clone (2)
 532 を用いて作られた子プロセスには、以下の Linux 固有の
 533 .I options
 534 が使用できる。
 535 .TP
 536 .B __WCLONE
 537 .\" since 0.99pl10
 538 "clone" な子プロセスだけを待つ。
 539 指定されなかった場合は非 "clone" な子プロセスだけを待つ
 540 ("clone" な子プロセスは、終了時に親プロセスへ全くシグナルを送らないか、
 541 .B SIGCHLD
 542 以外のシグナルを送る)。
 543 このオプションは
 544 .B __WALL
 545 も指定された場合は無視される。
 546 .TP
 547 .BR __WALL " (Linux 2.4 以降)"
 548 .\" since patch-2.3.48
 549 "clone" であるかないかに関わらず、
 550 全ての子プロセスを待つ。
 551 .TP
 552 .BR __WNOTHREAD " (Linux 2.4 以降)"
 553 .\" since patch-2.4.0-test8
 554 同じスレッドグループの他のスレッドの子プロセスは待たない。
 555 Linux 2.4 より前ではデフォルトであった。
 556 .SH 例
 557 .\" fork.2 もこのサンプルプログラムを参照している。
 558 以下のプログラムは、
 559 .BR fork (2)
 560 と
 561 .BR waitpid ()
 562 の使用方法の例を示している。
 563 このプログラムでは子プロセスを生成する。
 564 コマンドライン引き数が指定されなかったときは、
 565 子プロセスは
 566 .BR pause (2)
 567 を使ってその実行を一時停止し、ユーザがその子プロセスに
 568 シグナルを送信できるようにする。
 569 コマンドライン引き数が指定された場合は、
 570 子プロセスは直ちに終了し、
 571 コマンドラインで指定された整数を終了ステータスとして使用する。
 572 親プロセスは、
 573 .BR waitpid ()
 574 を使って子プロセスを監視し、
 575 wait のステータス値を上記の W*() マクロを使って解析するという
 576 ループを実行する。
 577
 578 下記ののシェル・セッションはプログラムの実行例である:
 579 .in +4n
 580 .nf
 581
 582 .RB "$" " ./a.out &"
 583 Child PID is 32360
 584 [1] 32359
 585 .RB "$" " kill \-STOP 32360"
 586 stopped by signal 19
 587 .RB "$" " kill \-CONT 32360"
 588 continued
 589 .RB "$" " kill \-TERM 32360"
 590 killed by signal 15
 591 [1]+  Done                    ./a.out
 592 $
 593 .fi
 594 .in
 595 .SS プログラムのソース
 596 \&
 597 .nf
 598 #include <sys/wait.h>
 599 #include <stdlib.h>
 600 #include <unistd.h>
 601 #include <stdio.h>
 602
 603 int
 604 main(int argc, char *argv[])
 605 {
 606     pid_t cpid, w;
 607     int status;
 608
 609     cpid = fork();
 610     if (cpid == \-1) {
 611         perror("fork");
 612         exit(EXIT_FAILURE);
 613     }
 614
 615     if (cpid == 0) {            /* Code executed by child */
 616         printf("Child PID is %ld\\n", (long) getpid());
 617         if (argc == 1)
 618             pause();                    /* Wait for signals */
 619         _exit(atoi(argv[1]));
 620
 621     } else {                    /* Code executed by parent */
 622         do {
 623             w = waitpid(cpid, &status, WUNTRACED | WCONTINUED);
 624             if (w == \-1) {
 625                 perror("waitpid");
 626                 exit(EXIT_FAILURE);
 627             }
 628
 629             if (WIFEXITED(status)) {
 630                 printf("exited, status=%d\\n", WEXITSTATUS(status));
 631             } else if (WIFSIGNALED(status)) {
 632                 printf("killed by signal %d\\n", WTERMSIG(status));
 633             } else if (WIFSTOPPED(status)) {
 634                 printf("stopped by signal %d\\n", WSTOPSIG(status));
 635             } else if (WIFCONTINUED(status)) {
 636                 printf("continued\\n");
 637             }
 638         } while (!WIFEXITED(status) && !WIFSIGNALED(status));
 639         exit(EXIT_SUCCESS);
 640     }
 641 }
 642 .fi
 643 .SH 関連項目
 644 .BR _exit (2),
 645 .BR clone (2),
 646 .BR fork (2),
 647 .BR kill (2),
 648 .BR ptrace (2),
 649 .BR sigaction (2),
 650 .BR signal (2),
 651 .BR wait4 (2),
 652 .BR pthread_create (3),
 653 .BR credentials (7),
 654 .BR signal (7)