1explain_acl_get_fd_or_die(3)Library Functions Manualexplain_acl_get_fd_or_die(3)
2
3
4
6 explain_acl_get_fd_or_die - Execute acl_get_fd(3) and report errors
7
9 #include <libexplain/acl_get_fd.h>
10 acl_t explain_acl_get_fd_or_die(int fildes);
11 acl_t explain_acl_get_fd_on_error(int fildes);
12
14 The explain_acl_get_fd_or_die function is used to call the
15 acl_get_fd(3) system call. On failure an explanation will be printed to
16 stderr, obtained from the explain_acl_get_fd(3) function, and then the
17 process terminates by calling exit(EXIT_FAILURE).
18
19 The explain_acl_get_fd_on_error function is used to call the
20 acl_get_fd(3) system call. On failure an explanation will be printed to
21 stderr, obtained from the explain_acl_get_fd(3) function, but still
22 returns to the caller.
23
24 fildes The fildes, exactly as to be passed to the acl_get_fd(3) system
25 call.
26
28 The explain_acl_get_fd_or_die function only returns on success, see
29 acl_get_fd(3) for more information. On failure, prints an explanation
30 and exits, it does not return.
31
32 The explain_acl_get_fd_on_error function always returns the value
33 return by the wrapped acl_get_fd(3) system call.
34
36 The explain_acl_get_fd_or_die function is intended to be used in a
37 fashion similar to the following example:
38 explain_acl_get_fd_or_die(fildes);
39
41 acl_get_fd(3)
42 Execute acl_get_fd(3)
43
44 explain_acl_get_fd(3)
45 explain acl_get_fd(3) errors
46
47 exit(2) terminate the calling process
48
50 libexplain version 1.4
51 Copyright (C) 2013 Peter Miller
52
53
54
55 explain_acl_get_fd_or_die(3)