UTIME(S) UNIX System V UTIME(S)
Name
utime - set file access and modification times
Syntax
#include <sys/types.h>
int utime (path, times)
char *path;
struct utimbuf *times;
Description
path points to a path name naming a file. The utime system
call 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 Greenwich Mean Time (GMT), Jan. 1, 1970.
struct utimbuf {
time_t actime; /* access time */
time_t modtime;/* modification time */
};
The utime system call will fail if one or more of the
following is true:
[ENOENT] The named file 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
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(S)
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.
Standards Conformance
utime is conformant with:
AT&T SVID Issue 2, Select Code 307-127;
The X/Open Portability Guide II of January 1987;
IEEE POSIX Std 1003.1-1988 with C Standard Language-
Dependent System Support;
and NIST FIPS 151-1.
(printed 6/20/89)