1explain_wait3_or_die(3) Library Functions Manual explain_wait3_or_die(3)
2
3
4
6 explain_wait3_or_die - wait for process to change state and report
7 errors
8
10 #include <libexplain/wait3.h>
11 void explain_wait3_or_die(int *status, int options, struct rusage
12 *rusage);
13
15 The explain_wait3_or_die function is used to call the wait3(2) system
16 call. On failure an explanation will be printed to stderr, obtained
17 from explain_wait3(3), and then the process terminates by calling
18 exit(EXIT_FAILURE).
19
20 This function is intended to be used in a fashion similar to the fol‐
21 lowing example:
22 int pid = explain_wait3_or_die(status, options, rusage);
23
24 status The status, exactly as to be passed to the wait3(2) system
25 call.
26
27 options The options, exactly as to be passed to the wait3(2) system
28 call.
29
30 rusage The rusage, exactly as to be passed to the wait3(2) system
31 call.
32
33 Returns:
34 This function only returns on success. On failure, prints an
35 explanation and exits.
36
38 wait3(2)
39 wait for process to change state
40
41 explain_wait3(3)
42 explain wait3(2) errors
43
44 exit(2) terminate the calling process
45
47 libexplain version 1.4
48 Copyright (C) 2008 Peter Miller
49
50
51
52 explain_wait3_or_die(3)