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