1explain_acl_set_fd_or_die(3)Library Functions Manualexplain_acl_set_fd_or_die(3)
2
3
4

NAME

6       explain_acl_set_fd_or_die  -  set  an ACL by file descriptor and report
7       errors
8

SYNOPSIS

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

DESCRIPTION

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

RETURN VALUE

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

EXAMPLE

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

SEE ALSO

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