1explain_fstatat_or_die(3)  Library Functions Manual  explain_fstatat_or_die(3)
2
3
4

NAME

6       explain_fstatat_or_die  -  get  file  status  relative  to a dir fd and
7       report errors
8

SYNOPSIS

10       #include <libexplain/fstatat.h>
11       void explain_fstatat_or_die(int fildes, const  char  *pathname,  struct
12       stat *data, int flags);
13       int  explain_fstatat_on_error(int  fildes, const char *pathname, struct
14       stat *data, int flags);
15

DESCRIPTION

17       The explain_fstatat_or_die function is used to call the fstatat(2) sys‐
18       tem call. On failure an explanation will be printed to stderr, obtained
19       from the explain_fstatat(3) function, and then the  process  terminates
20       by calling exit(EXIT_FAILURE).
21
22       The  explain_fstatat_on_error  function  is used to call the fstatat(2)
23       system call. On failure an  explanation  will  be  printed  to  stderr,
24       obtained from the explain_fstatat(3) function, but still returns to the
25       caller.
26
27       fildes  The fildes, exactly as to be passed to  the  fstatat(2)  system
28               call.
29
30       pathname
31               The  pathname, exactly as to be passed to the fstatat(2) system
32               call.
33
34       data    The data, exactly as to be  passed  to  the  fstatat(2)  system
35               call.
36
37       flags   The  flags,  exactly  as  to be passed to the fstatat(2) system
38               call.
39

RETURN VALUE

41       The  explain_fstatat_or_die  function  only  returns  on  success,  see
42       fstatat(2)  for more information. On failure, prints an explanation and
43       exits, it does not return.
44
45       The explain_fstatat_on_error function always returns the  value  return
46       by the wrapped fstatat(2) system call.
47

EXAMPLE

49       The explain_fstatat_or_die function is intended to be used in a fashion
50       similar to the following example:
51              explain_fstatat_or_die(fildes, pathname, data, flags);
52

SEE ALSO

54       fstatat(2)
55               get file status relative to a directory file descriptor
56
57       explain_fstatat(3)
58               explain fstatat(2) errors
59
60       exit(2) terminate the calling process
61

63       libexplain version 1.4
64       Copyright (C) 2013 Peter Miller
65
66
67
68                                                     explain_fstatat_or_die(3)
Impressum