(BSD System Compatibility)
utimes(3bsd)
utimes --
(BSD) set file times
Synopsis
/usr/ucb/cc [flag . . . ] file . . .
#include <sys/types.h>
int utimes(char *file, struct timeval *tvp);
Description
utimes
sets the access and modification times of the file named by
file.
If
tvp
is
NULL,
the access and modification times are set to the current time.
A process must be the owner of the file or have write permission for
the file to use
utimes
in this manner.
If
tvp
is not
NULL,
it is assumed to point to an array of two
timeval
structures.
The access time is set to the value of the first member,
and the modification time is set to the value of the second member.
Only the owner of the file or the privileged user may use
utimes
in this manner.
In either case, the
inode-changed
time of the file is set to the current time.
Return values
Upon successful completion, a value of 0 is returned.
Otherwise, a value of -1 is returned and
errno
is set to indicate the error.
utimes
will fail if one or more of the following are true:
ENOTDIR-
A component of the path prefix of
file
is not a directory.
ENAMETOOLONG-
The length of a component of
file
exceeds 255 characters, or the length of
file
exceeds 1023 characters.
ENOENT-
The file referred to by
file
does not exist.
EACCES-
Search permission is denied for a component of the path prefix of
file.
ELOOP-
Too many symbolic links were encountered in translating
file.
EPERM-
The effective user
ID
of the process is not privileged user and not the owner of the file, and
tvp
is not
NULL.
EACCES-
The effective user
ID
of the process is not privileged user and not the owner of the file, write
permission is denied for the file, and
tvp
is
NULL.
EIO-
An I/O error occurred while reading from or writing to the file system.
EROFS-
The file system containing the file is mounted read-only.
EFAULT-
file
or
tvp
points outside the process's allocated address space.
References
stat(2),
utime(2)
Notices
utimes is a library routine that calls the
utime(2)
system call.
© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 25 April 2004