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

NAME

6       explain_utimes_or_die  - change file access and modify times and report
7       errors
8

SYNOPSIS

10       #include <libexplain/utimes.h>
11       void explain_utimes_or_die(const char *pathname, const  struct  timeval
12       *data);
13       int  explain_utimes_on_error(const char *pathname, const struct timeval
14       *data);
15

DESCRIPTION

17       The explain_utimes_or_die function is used to call the utimes(2) system
18       call.  On  failure  an  explanation will be printed to stderr, obtained
19       from the explain_utimes(3) function, and then the process terminates by
20       calling exit(EXIT_FAILURE).
21
22       The explain_utimes_on_error function is used to call the utimes(2) sys‐
23       tem call. On failure an explanation will be printed to stderr, obtained
24       from the explain_utimes(3) function, but still returns to the caller.
25
26       pathname
27               The  pathname,  exactly as to be passed to the utimes(2) system
28               call.
29
30       data    The data, exactly as to be passed to the utimes(2) system call.
31

RETURN VALUE

33       The  explain_utimes_or_die  function  only  returns  on  success,   see
34       utimes(2)  for  more information. On failure, prints an explanation and
35       exits, it does not return.
36
37       The explain_utimes_on_error function always returns the value return by
38       the wrapped utimes(2) system call.
39

EXAMPLE

41       The  explain_utimes_or_die function is intended to be used in a fashion
42       similar to the following example:
43              explain_utimes_or_die(pathname, data);
44

SEE ALSO

46       utimes(2)
47               change file last access and modification times
48
49       explain_utimes(3)
50               explain utimes(2) errors
51
52       exit(2) terminate the calling process
53

55       libexplain version 1.4
56       Copyright (C) 2010 Peter Miller
57
58
59
60                                                      explain_utimes_or_die(3)
Impressum