1explain_utime_or_die(3) Library Functions Manual explain_utime_or_die(3)
2
3
4
6 explain_utime_or_die - change file times and report errors
7
9 #include <libexplain/utime.h>
10 void explain_utime_or_die(const char *pathname, const struct utimbuf
11 *times);
12
14 The explain_utime_or_die function is used to call the utime(2) system
15 call. On failure an explanation will be printed to stderr, obtained
16 from explain_utime(3), and then the process terminates by calling
17 exit(EXIT_FAILURE).
18
19 This function is intended to be used in a fashion similar to the fol‐
20 lowing example:
21 explain_utime_or_die(pathname, times);
22
23 pathname
24 The pathname, exactly as to be passed to the utime(2) system
25 call.
26
27 times The times, exactly as to be passed to the utime(2) system call.
28
29 Returns:
30 This function only returns on success. On failure, prints an
31 explanation and exits.
32
34 utime(2)
35 change file last access and modification times
36
37 explain_utime(3)
38 explain utime(2) errors
39
40 exit(2) terminate the calling process
41
43 libexplain version 1.4
44 Copyright (C) 2008 Peter Miller
45
46
47
48 explain_utime_or_die(3)