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