NAME | SYNOPSIS | DESCRIPTION | RETURN VALUES | ERRORS | ATTRIBUTES | SEE ALSO
#include <sys/types.h> #include <utime.h>int utime(const char *path, const struct utimbuf *times);
The utime() function sets the access and modification times of the file pointed to by path, and causes the time of the last file status change (st_ctime) to be updated.
If times is NULL, the access and modification times of the file are set to the current time. A process must be the owner of the file or have write permission to use utime() in this manner.
If times is not NULL, times is interpreted as a pointer to a utimbuf structure (defined in <utime.h>) and the access and modification times are set to the values contained in the designated structure. Only the owner of the file or the super-user may use utime() in this manner.
The utimbuf structure contains the following members:
time_t actime; /* access time */ time_t modtime; /* modification time */
The times contained in the members of the utimbuf structure are measured in seconds since 00:00:00 UTC, January 1, 1970.
Upon successful completion, 0 is returned. Otherwise, -1 is returned and errno is set to indicate the error.
The utime() function will fail if:
Search permission is denied by a component of the path prefix; or the effective user ID of the process is not super-user and not the owner of the file, write permission is denied for the file, and times is NULL.
The path argument points to an illegal address.
A signal was caught during the execution of the utime() function.
An I/O error occurred while reading from or writing to the file system.
Too many symbolic links were encountered in translating path.
The length of the path argument exceeds PATH_MAX, or the length of a path component exceeds NAME_MAX while _POSIX_NO_TRUNC is in effect.
The named file does not exist or is a null pathname.
The path argument points to a remote machine and the link to that machine is no longer active.
A component of the path prefix is not a directory.
The effective user of the calling process is not super-user and not the owner of the file, and times is not NULL.
The file system containing the file is mounted read-only.
See attributes(5) for descriptions of the following attributes:
ATTRIBUTE TYPE | ATTRIBUTE VALUE |
---|---|
MT-Level | Async-Signal-Safe |
NAME | SYNOPSIS | DESCRIPTION | RETURN VALUES | ERRORS | ATTRIBUTES | SEE ALSO