1explain_acl_from_text_or_dieL(i3b)rary Functions Maneuxapllain_acl_from_text_or_die(3)
2
3
4

NAME

6       explain_acl_from_text_or_die  -  create  an  ACL  from  text and report
7       errors
8

SYNOPSIS

10       #include <libexplain/acl_from_text.h>
11       acl_t explain_acl_from_text_or_die(const char *text);
12       acl_t explain_acl_from_text_on_error(const char *text);
13

DESCRIPTION

15       The  explain_acl_from_text_or_die  function  is  used   to   call   the
16       acl_from_text(3) system call. On failure an explanation will be printed
17       to stderr, obtained from  the  explain_acl_from_text(3)  function,  and
18       then the process terminates by calling exit(EXIT_FAILURE).
19
20       The   explain_acl_from_text_on_error  function  is  used  to  call  the
21       acl_from_text(3) system call. On failure an explanation will be printed
22       to  stderr,  obtained  from  the explain_acl_from_text(3) function, but
23       still returns to the caller.
24
25       text    The text, exactly as to be passed to the acl_from_text(3)  sys‐
26               tem call.
27

RETURN VALUE

29       The  explain_acl_from_text_or_die function only returns on success, see
30       acl_from_text(3) for more information. On failure, prints  an  explana‐
31       tion and exits, it does not return.
32
33       The  explain_acl_from_text_on_error  function  always returns the value
34       return by the wrapped acl_from_text(3) system call.
35

EXAMPLE

37       The explain_acl_from_text_or_die function is intended to be used  in  a
38       fashion similar to the following example:
39              acl_t result = explain_acl_from_text_or_die(text);
40

SEE ALSO

42       acl_from_text(3)
43               create an ACL from text
44
45       explain_acl_from_text(3)
46               explain acl_from_text(3) errors
47
48       exit(2) terminate the calling process
49
51       libexplain version 1.4
52       Copyright (C) 2013 Peter Miller
53
54
55
56                                               explain_acl_from_text_or_die(3)
Impressum