UTIME(S) XENIX System V UTIME(S)
Name
utime - Sets file access and modification times.
Syntax
#include <sys/types.h>
int utime (path, times)
char *path;
struct utimbuf *times;
Description
path points to a pathname 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
since 00:00:00 GMT, Jan. 1, 1970.
struct utimbuf {
time_t actime; /* access time */
time_t modtime;/* modification time */
};
utime will fail if one or more of the following are true:
The named file does not exist. [ENOENT]
A component of the path prefix is not a directory.
[ENOTDIR]
Search permission is denied by a component of the path
prefix. [EACCES]
The effective user ID is not super-user and not the
owner of the file and times is not NULL. [EPERM]
The effective user ID is not super-user and not the
owner of the file and times is NULL and write access is
denied. [EACCES]
The file system containing the file is mounted read-
only. [EROFS]
Page 1 (printed 8/7/87)
UTIME(S) XENIX System V UTIME(S)
times is not NULL and points outside the process'
allocated address space. [EFAULT]
path points outside the process' allocated address
space. [EFAULT]
Return Value
Upon successful completion, a value of 0 is returned.
Otherwise, a value of -1 is returned and errno is set to
indicate the error.
See Also
stat(S)
Page 2 (printed 8/7/87)
