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

NAME

6       explain_stat_or_die - get file status and report errors
7

SYNOPSIS

9       #include <libexplain/stat.h>
10       void explain_stat_or_die(const char *pathname, struct stat *buf);
11

DESCRIPTION

13       The  explain_stat_or_die  function  is  used to call the stat(2) system
14       call.  On failure an explanation will be printed  to  stderr,  obtained
15       from  explain_stat(3),  and  then  the  process  terminates  by calling
16       exit(EXIT_FAILURE).
17
18       This function is intended to be used in a fashion similar to  the  fol‐
19       lowing example:
20              explain_stat_or_die(pathname, buf);
21
22       pathname
23               The  pathname,  exactly  as  to be passed to the stat(2) system
24               call.
25
26       buf     The buf, exactly as to be passed to the stat(2) system call.
27
28       Returns:
29               This function only returns on success.  On failure,  prints  an
30               explanation and exits.
31

SEE ALSO

33       stat(2) get file status
34
35       explain_stat(3)
36               explain stat(2) errors
37
38       exit(2) terminate the calling process
39
41       libexplain version 1.4
42       Copyright (C) 2008 Peter Miller
43
44
45
46                                                        explain_stat_or_die(3)
Impressum