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

NAME

6       explain_utime_or_die - change file times and report errors
7

SYNOPSIS

9       #include <libexplain/utime.h>
10       void  explain_utime_or_die(const  char  *pathname, const struct utimbuf
11       *times);
12

DESCRIPTION

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

SEE ALSO

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 0.40
44       Copyright (C) 2008 Peter Miller
45
46
47
48                                                       explain_utime_or_die(3)
Impressum