1explain_acl_to_text_or_die(3L)ibrary Functions Manuaelxplain_acl_to_text_or_die(3)
2
3
4

NAME

6       explain_acl_to_text_or_die - convert an ACL to text and report errors
7

SYNOPSIS

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

DESCRIPTION

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

RETURN VALUE

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

EXAMPLE

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

SEE ALSO

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)
Impressum