utimes(2)
_________________________________________________________________
utimes System Call
Set file access and modification times.
_________________________________________________________________
SYNTAX
#include <sys/time.h>
int utimes (path, times)
char * path;
struct timeval times[2];
PARAMETERS
path Address of a pathname.
times Address of an initialized array of two time values
giving the access and modification times.
DESCRIPTION
<Path> points to a pathname naming a file, which must reside on a
file system device mounted read-write. If <path> refers to a
symbolic link, the target of the symbolic link is affected.
Utimes sets the `time-last-accessed' and `time-last-modified'
attributes of the subject file to <times[0]> and <times[1]>
respectively.
If utimes fails, the file is left unchanged. Otherwise, the
`time-last-changed' attribute of the subject file is set to the
current time.
ACCESS CONTROL
The calling process must have permission to resolve <path>.
The calling process's effective user id must be superuser or the
user id of the subject file.
RETURN VALUE
0 The file's access and modification times were
changed successfully.
DG/UX 4.00 Page 1
Licensed material--property of copyright holder(s)
utimes(2)
-1 An error occurred. Errno is set to indicate the
error.
EXCEPTIONS
Errno may be set to one of the following error codes:
EFAULT Some part of the array pointed to by <times> lies
outside the process's readable address space.
EPERM Permission to set the access and modification
times to an arbitrary value is denied to the
calling process.
EROFS The file system device containing the subject file
is mounted read-only.
ENOENT The file the pathname resolved to does not exist.
ENOENT A non-terminal component of the pathname does not
exist.
ENOTDIR A non-terminal component of the pathname was not a
directory or symbolic link.
ENAMETOOLONG The pathname exceeds the length limit for
pathnames.
ENAMETOOLONG A component of the pathname exceeds the length
limit for filenames.
ENOMEM There are not enough system resources to resolve
the pathname or to expand a symbolic link.
ELOOP The number of symbolic links encountered during
pathname resolution exceeded MAXSYMLINKS. A
symbolic link cycle is suspected.
EPERM The pathname contains a character not in the
DG/UX 4.00 Page 2
Licensed material--property of copyright holder(s)
utimes(2)
allowed character set.
EFAULT The pathname does not completely reside in the
process's address space or the pathname does not
terminate in the process's address space.
SEE ALSO
The related manual sections: dg_mstat(2), lstat(2), stat(2),
ustat(2), utime(2).
stat(5).
DG/UX 4.00 Page 3
Licensed material--property of copyright holder(s)