HP-UX Reference (11i v1 05/09) - 2 System Calls (vol 5)

u
utime(2) utime(2)
NAME
utime() - set file access and modification times
SYNOPSIS
#include <utime.h>
int utime(const char *path, const struct utimbuf *times);
DESCRIPTION
The utime() system call sets the access and modification times of the file to which the path argument
refers.
If times is a NULL pointer, the access and modification times of the file are set to the current time. A pro-
cess must be the owner of the file or have write permission on the file to use
utime() in this manner.
If times is not a NULL pointer, 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
a user with appropriate privileges can use
utime() this way.
The following times in the
utimbuf structure defined in <utime.h> are measured in seconds since
00:00:00 UTC (Coordinated Universal Time), January 1, 1970.
time_t actime; /* access time */
time_t modtime; /* modification time */
RETURN VALUE
utime() returns the following values:
0 Successful completion.
-1 Failure. errno is set to indicate the error.
ERRORS
If utime() fails, errno is set to one of the following values.
[EACCES] Search permission is denied by a component of the path prefix.
[EACCES] The effective user ID is not a user with appropriate privileges, and not the owner of
the file, times is a NULL pointer, and write access is denied.
[EFAULT] times is not a NULL pointer, and it points outside the process’s allocated address
space. The reliable detection of this error is implementation-dependent.
[EFAULT] path points outside the process’s allocated address space. The reliable detection of
this error is implementation-dependent.
[EINVAL] times is not a NULL pointer, and access time or modification time or both are nega-
tive.
[ENAMETOOLONG]
The length of the specified path name exceeds PATH_MAX bytes, or the length of a
component of the path name exceeds NAME_MAX bytes while _POSIX_NO_TRUNC
is
in effect.
[ENOENT] The named file does not exist.
[ENOTDIR] A component of the path prefix is not a directory.
[EPERM] The effective user ID is not a user with appropriate privileges. and not the owner of
the file, and times is not a NULL pointer.
[EROFS] The file system containing the file is mounted read-only.
DEPENDENCIES
NFS
utime() may return [EPERM] when invoked on a remote file owned by a superuser, even if the invoking
user has write permission on the file.
SEE ALSO
touch(1), stat(2).
HP-UX 11i Version 1: September 2005 − 1 − Hewlett-Packard Company Section 2−−463