The access and modification times of the file named by
or referenced by
are changed as specified by the argument
the access and modification times are set to the current time.
The caller must be the owner of the file, have permission to
write the file, or be the super-user.
it is assumed to point to an array of two timeval structures.
The access time is set to the value of the first element, and the
modification time is set to the value of the second element.
For file systems that support file birth (creation) times (such as
the birth time will be set to the value of the second element
if the second element is older than the currently set birth time.
To set both a birth time and a modification time,
two calls are required; the first to set the birth time
and the second to set the (presumably newer) modification time.
Ideally a new system call will be added that allows the setting
of all three times at once.
The caller 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
except in the case where the named file is a symbolic link,
in which case
changes the access and modification times of the link,
changes the times of the file the link references.
system call is equivalent to
except in the case where
specifies a relative path.
In this case the access and modification time
is set to that of a file relative to the directory associated with the file
instead of the current working directory.
is passed the special value
parameter, the current working directory is used and the behavior
is identical to a call to