UTIME(2) DOMAIN/IX Reference Manual (SYS5) UTIME(2)
NAME
utime - set file access and modification times
USAGE
#include <sys/types.h>
int utime (path, times)
char *path;
struct utimbuf *times;
DESCRIPTION
Utime sets the access and modification times of a file.
Path names the 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 therein. 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
since 00:00:00 GMT, Jan. 1, 1970.
struct utimbuf {
time_t actime; /* access time */
time_t modtime;/* modification time */
};
RETURN VALUE
Upon successful completion, utime returns zero. Otherwise,
it returns -1 and sets errno to indicate the error.
ERRORS
Utime will fail if one or more of the following is true:
[ENOENT] The file named does not exist.
[ENOTDIR] A component of the path prefix is not a
directory.
[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
Printed 5/10/85 UTIME-1
UTIME(2) DOMAIN/IX Reference Manual (SYS5) UTIME(2)
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 pro-
cess' allocated address space.
[EFAULT] Path points outside the process' allocated
address space.
RELATED INFORMATION
stat(2)
UTIME-2 Printed 5/10/85