UTIME(2) UTIME(2)
NAME
utime - set file access and modification times
SYNOPSIS
#include <sys/types.h>
int utime (path, times)
char *path;
struct utimbuf *times;
DESCRIPTION
Path points to a path name naming a file. utime sets the
access and modification times of the named file.
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 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
this way.
The times in the following structure are measured in seconds
and microseconds since 00:00:00 GMT, Jan. 1, 1970.
struct utimbuf {
time_t actime; /* access time */
time_t ausec;
time_t modtime;/* modification time */
time_t modusec;
};
utime will fail if one or more of the following are true:
[ENOENT] The named file does not exist.
[ENOTDIR] A component of the path prefix is not a
directory.
Page 1 May 1989
UTIME(2) UTIME(2)
[EACCES] Search permission is denied by a component of
the path prefix.
[EPERM] The effective user ID is not super-user and
not the owner of the file and times is not
NULL.
[EACCES] The effective user ID is not super-user and
not the owner of the file and times is NULL
and write access is denied.
[EROFS] The file system containing the file is
mounted read-only.
[EFAULT] Times is not NULL and points outside the
process's allocated address space.
[EFAULT] Path points outside the process's allocated
address space.
[EINTR] A signal was caught during the utime system
call.
[ENOLINK] Path points to a remote machine and the link
to that machine is no longer active.
[EMULTIHOP] Components of path require hopping to
multiple remote machines.
SEE ALSO
stat(2).
DIAGNOSTICS
Upon successful completion, a value of 0 is returned.
Otherwise, a value of -1 is returned and errno is set to
indicate the error.
Page 2 May 1989