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

NAME

6       explain_lstat_or_die - get file status and report errors
7

SYNOPSIS

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

DESCRIPTION

13       The  explain_lstat_or_die  function is used to call the lstat(2) system
14       call.  On failure an explanation will be printed  to  stderr,  obtained
15       from  explain_lstat(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_lstat_or_die(pathname , buf);
21
22       pathname
23               The  pathname,  exactly  as to be passed to the lstat(2) system
24               call.
25
26       buf     The buf, exactly as to be passed to the lstat(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       lstat(2)
34               get file status
35
36       explain_lstat(3)
37               explain lstat(2) errors
38
39       exit(2) terminate the calling process
40

42       libexplain version 1.4
43       Copyright (C) 2008 Peter Miller
44
45
46
47                                                       explain_lstat_or_die(3)
Impressum