utime(2) DG/UX 4.30 utime(2)
NAME
utime - Set file access and modification times.
SYNOPSIS
#include <sys/types.h>
#include <utime.h>
int utime (path, times)
char * path;
struct utimbuf *times;
PARAMETERS
path Address of a pathname.
times NULL or address of an initialized structure
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. Utime sets the `time-last-accessed' and `time-
last-modified' attributes of the subject file. If <times>
is NULL, `time-last-accessed' and `time-last-modified' are
set to the current time. Otherwise, the `time-last-
accessed' is set to <(*times).actime> and `time-last-
modified' is set to <(*times).modtime>.
If utime 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>.
If <times> is NULL, either the calling process must have
write permission to the subject file or the calling
process's effective user id must be equal to the user id of
the subject file.
Otherwise, 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.
-1 An error occurred. Errno is set to indicate
the error.
Licensed material--property of copyright holder(s) Page 1
utime(2) DG/UX 4.30 utime(2)
EXCEPTIONS
Errno may be set to one of the following error codes:
EACCES Permission to set the access and modification
times to the current time is denied to the
calling process.
EFAULT <Times> is not NULL and some part of the
utimbuf structure 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.
Licensed material--property of copyright holder(s) Page 2
utime(2) DG/UX 4.30 utime(2)
EPERM The pathname contains a character not in the
allowed character set.
SEE ALSO
The related manual sections: dg_mstat(2), lstat(2),
stat(2), ustat(2), utimes(2),
stat(5).
Licensed material--property of copyright holder(s) Page 3