UTIME(3) | Library Functions Manual | UTIME(3) |
utime
— set file
times
Standard C Library (libc, -lc)
#include
<utime.h>
int
utime
(const char *path,
const struct utimbuf *times);
The
utime
()
function sets the access and modification times of the named file, based on
the actime and modtime fields of
the struct utimbuf pointed at by
times.
If the times are specified (the times
argument is non-NULL
), the caller must be the owner
of the file or be the super-user.
If the times are not specified (the times
argument is NULL
), the caller must be the owner of
the file, have permission to write the file, or be the super-user.
The utime
() function may fail and set
errno for any of the errors specified for the library
function utimes(2).
The utime
() function conforms to
IEEE Std 1003.1-1988 (“POSIX.1”).
A utime
() function appeared in
Version 7 AT&T UNIX.
June 4, 1993 | macOS 14.6 |