1explain_acl_set_fd_or_die(3)Library Functions Manualexplain_acl_set_fd_or_die(3)
2
3
4
6 explain_acl_set_fd_or_die - set an ACL by file descriptor and report
7 errors
8
10 #include <libexplain/acl_set_fd.h>
11 void explain_acl_set_fd_or_die(int fildes, acl_t acl);
12 int explain_acl_set_fd_on_error(int fildes, acl_t acl);
13
15 The explain_acl_set_fd_or_die function is used to call the
16 acl_set_fd(3) system call. On failure an explanation will be printed to
17 stderr, obtained from the explain_acl_set_fd(3) function, and then the
18 process terminates by calling exit(EXIT_FAILURE).
19
20 The explain_acl_set_fd_on_error function is used to call the
21 acl_set_fd(3) system call. On failure an explanation will be printed to
22 stderr, obtained from the explain_acl_set_fd(3) function, but still
23 returns to the caller.
24
25 fildes The fildes, exactly as to be passed to the acl_set_fd(3) system
26 call.
27
28 acl The acl, exactly as to be passed to the acl_set_fd(3) system
29 call.
30
32 The explain_acl_set_fd_or_die function only returns on success, see
33 acl_set_fd(3) for more information. On failure, prints an explanation
34 and exits, it does not return.
35
36 The explain_acl_set_fd_on_error function always returns the value
37 return by the wrapped acl_set_fd(3) system call.
38
40 The explain_acl_set_fd_or_die function is intended to be used in a
41 fashion similar to the following example:
42 explain_acl_set_fd_or_die(fildes, acl);
43
45 acl_set_fd(3)
46 set an ACL by file descriptor
47
48 explain_acl_set_fd(3)
49 explain acl_set_fd(3) errors
50
51 exit(2) terminate the calling process
52
54 libexplain version 1.4
55 Copyright (C) 2013 Peter Miller
56
57
58
59 explain_acl_set_fd_or_die(3)