Table of Contents
This
interface is obsoleted by utimes(2)
. The function sets the access and
modification times of the named file. If is the access and modification
times are set to the current time. The calling process must be the owner
of the file or have permission to write the file. If is is assumed
to be a pointer to a utimbuf structure, as defined in struct utimbuf
{ time_t actime; /* Access time */
time_t modtime; /* Modification time */
} ; The access time is set to the value of the actime member, and the
modification time is set to the value of the modtime member. The times
are measured in seconds since 0 hours, 0 minutes, 0 seconds, January 1,
1970, Coordinated Universal Time. The calling process must be the owner
of the file or be the super-user. In either case, the inode-change-time of
the file is set to the current time.
Upon successful completion,
a value of 0 is returned. Otherwise, a value of -1 is returned and is set
to indicate the error.
will fail if: Search permission is denied
for a component of the path prefix; or the argument is and the effective
user ID of the process does not match the owner of the file, and is not
the super-user, and write access is denied. or points outside the process’s
allocated address space. The pathname contains a character with the high-order
bit set. An I/O error occurred while reading or writing the affected inode.
Too many symbolic links were encountered in translating the pathname.
A component of a pathname exceeded 255 characters, or an entire path name
exceeded 1023 characters. The named file does not exist. A component of
the path prefix is not a directory. The argument is not and the calling
process’s effective user ID does not match the owner of the file and is
not the super-user. The file system containing the file is mounted read-only.
A function appeared in
The function conforms
to
Table of Contents