1explain_utimensat_or_die(3)Library Functions Manualexplain_utimensat_or_die(3)
2
3
4

NAME

6       explain_utimensat_or_die - change file timestamps and report errors
7

SYNOPSIS

9       #include <libexplain/utimensat.h>
10       void  explain_utimensat_or_die(int  fildes, const char *pathname, const
11       struct timespec *data, int flags);
12       int explain_utimensat_on_error(int fildes, const char *pathname,  const
13       struct timespec *data, int flags);
14

DESCRIPTION

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

RETURN VALUE

40       The explain_utimensat_or_die function only returns on success, see uti‐
41       mensat(2) for more information. On failure, prints an  explanation  and
42       exits, it does not return.
43
44       The explain_utimensat_on_error function always returns the value return
45       by the wrapped utimensat(2) system call.
46

EXAMPLE

48       The explain_utimensat_or_die function is intended to be used in a fash‐
49       ion similar to the following example:
50              explain_utimensat_or_die(fildes, pathname, data, flags);
51

SEE ALSO

53       utimensat(2)
54               change file timestamps with nanosecond precision
55
56       explain_utimensat(3)
57               explain utimensat(2) errors
58
59       exit(2) terminate the calling process
60

62       libexplain version 1.4
63       Copyright (C) 2012 Peter Miller
64
65
66
67                                                   explain_utimensat_or_die(3)
Impressum