utime(2)utime(2)NAMEutime() - set file access and modification times
SYNOPSISDESCRIPTION
The system call sets the access and modification times of the file to
which the path argument refers.
If times is a NULL pointer, 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 on the file to use in this manner.
The following times in the structure defined in are measured in seconds
since 00:00:00 UTC (Coordinated Universal Time), January 1, 1970.
time_t actime; /* access time */
time_t modtime; /* modification time */
Security Restrictions
If times is not a NULL pointer, times is interpreted as a pointer to a
utimbuf structure, and the access and modification times are set to the
values contained in the designated structure. Only the owner of the
file or a user with the privilege can use this way.
See privileges(5) for more information about privileged access on sys‐
tems that support fine-grained privileges.
RETURN VALUE
returns the following values:
Successful completion.
Failure.
is set to indicate the error.
ERRORS
If fails, is set to one of the following values.
Search permission is denied by a component of the path prefix.
The effective user ID is not a
user with the privilege, and not the owner of the
file, times is a NULL pointer, and write access
is denied.
times is not a NULL pointer, and it points outside the
process's allocated address space. The reliable
detection of this error is implementation-depen‐
dent.
path points outside the process's allocated address
space. The reliable detection of this error is
implementation-dependent.
times is not a NULL pointer, and access time or modifi‐
cation time or both are negative.
The length of the specified path name exceeds
bytes, or the length of a component of the path
name exceeds bytes while is in effect.
The named file does not exist.
A component of the path prefix is not a directory.
The effective user ID is not a
user with the privilege, and not the owner of the
file, and times is not a NULL pointer.
The file system containing the file is mounted read-only.
DEPENDENCIES
NFS
may return when invoked on a remote file owned by a superuser, or users
with and privileges, even if the invoking user has write permission on
the file.
See privileges(5) for more information about privileged access on sys‐
tems that support fine-grained privileges.
SEE ALSOtouch(1), stat(2), privileges(5).
STANDARDS CONFORMANCEutime(2)