1explain_acl_get_file_or_die(L3i)brary Functions Manueaxlplain_acl_get_file_or_die(3)
2
3
4

NAME

6       explain_acl_get_file_or_die - Execute acl_get_file(3) and report errors
7

SYNOPSIS

9       #include <libexplain/acl_get_file.h>
10       acl_t   explain_acl_get_file_or_die(const  char  *pathname,  acl_type_t
11       type);
12       acl_t explain_acl_get_file_on_error(const  char  *pathname,  acl_type_t
13       type);
14

DESCRIPTION

16       The   explain_acl_get_file_or_die   function   is   used  to  call  the
17       acl_get_file(3) system call. On failure an explanation will be  printed
18       to stderr, obtained from the explain_acl_get_file(3) function, and then
19       the process terminates by calling exit(EXIT_FAILURE).
20
21       The  explain_acl_get_file_on_error  function  is  used  to   call   the
22       acl_get_file(3)  system call. On failure an explanation will be printed
23       to stderr, obtained  from  the  explain_acl_get_file(3)  function,  but
24       still returns to the caller.
25
26       pathname
27               The  pathname,  exactly  as to be passed to the acl_get_file(3)
28               system call.
29
30       type    The type, exactly as to be passed to the acl_get_file(3) system
31               call.
32

RETURN VALUE

34       The  explain_acl_get_file_or_die  function only returns on success, see
35       acl_get_file(3) for more information. On failure, prints an explanation
36       and exits, it does not return.
37
38       The  explain_acl_get_file_on_error  function  always  returns the value
39       return by the wrapped acl_get_file(3) system call.
40

EXAMPLE

42       The explain_acl_get_file_or_die function is intended to be  used  in  a
43       fashion similar to the following example:
44              acl_t result = explain_acl_get_file_or_die(pathname, type);
45

SEE ALSO

47       acl_get_file(3)
48               Execute acl_get_file(3)
49
50       explain_acl_get_file(3)
51               explain acl_get_file(3) errors
52
53       exit(2) terminate the calling process
54

56       libexplain version 1.4
57       Copyright (C) 2013 Peter Miller
58
59
60
61                                                explain_acl_get_file_or_die(3)
Impressum