1explain_futimesat_or_die(3)Library Functions Manualexplain_futimesat_or_die(3)
2
3
4

NAME

6       explain_futimesat_or_die - change timestamps of a file    relative to a
7       directory  and report errors
8

SYNOPSIS

10       #include <libexplain/futimesat.h>
11       void explain_futimesat_or_die(int fildes, const char  *pathname,  const
12       struct timeval *data);
13       int  explain_futimesat_on_error(int fildes, const char *pathname, const
14       struct timeval *data);
15

DESCRIPTION

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

RETURN VALUE

38       The  explain_futimesat_or_die  function  only  returns  on success, see
39       futimesat(2) for more information. On failure,  prints  an  explanation
40       and exits, it does not return.
41
42       The explain_futimesat_on_error function always returns the value return
43       by the wrapped futimesat(2) system call.
44

EXAMPLE

46       The explain_futimesat_or_die function is intended to be used in a fash‐
47       ion similar to the following example:
48              explain_futimesat_or_die(fildes, pathname, data);
49

SEE ALSO

51       futimesat(2)
52               change timestamps of a file relative to a directory
53
54       explain_futimesat(3)
55               explain futimesat(2) errors
56
57       exit(2) terminate the calling process
58

60       libexplain version 1.4
61       Copyright (C) 2013 Peter Miller
62
63
64
65                                                   explain_futimesat_or_die(3)
Impressum