1explain_acl_to_text_or_die(3L)ibrary Functions Manuaelxplain_acl_to_text_or_die(3)
2
3
4
6 explain_acl_to_text_or_die - convert an ACL to text and report errors
7
9 #include <libexplain/acl_to_text.h>
10 char *explain_acl_to_text_or_die(acl_t acl, ssize_t *len_p);
11 char *explain_acl_to_text_on_error(acl_t acl, ssize_t *len_p);
12
14 The explain_acl_to_text_or_die function is used to call the
15 acl_to_text(3) system call. On failure an explanation will be printed
16 to stderr, obtained from the explain_acl_to_text(3) function, and then
17 the process terminates by calling exit(EXIT_FAILURE).
18
19 The explain_acl_to_text_on_error function is used to call the
20 acl_to_text(3) system call. On failure an explanation will be printed
21 to stderr, obtained from the explain_acl_to_text(3) function, but still
22 returns to the caller.
23
24 acl The acl, exactly as to be passed to the acl_to_text(3) system
25 call.
26
27 len_p The len_p, exactly as to be passed to the acl_to_text(3) system
28 call.
29
31 The explain_acl_to_text_or_die function only returns on success, see
32 acl_to_text(3) for more information. On failure, prints an explanation
33 and exits, it does not return.
34
35 The explain_acl_to_text_on_error function always returns the value
36 return by the wrapped acl_to_text(3) system call.
37
39 The explain_acl_to_text_or_die function is intended to be used in a
40 fashion similar to the following example:
41 char *result = explain_acl_to_text_or_die(acl, len_p);
42
44 acl_to_text(3)
45 convert an ACL to text
46
47 explain_acl_to_text(3)
48 explain acl_to_text(3) errors
49
50 exit(2) terminate the calling process
51
53 libexplain version 1.4
54 Copyright (C) 2013 Peter Miller
55
56
57
58 explain_acl_to_text_or_die(3)