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;
DESCRIPTION
Path points to a path name naming a file. utime 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 time fields in the following structure are measured in seconds since 00:00:00 GMT, Jan. 1, 1970.
time_t actime; /∗ access time ∗/
time_t modtime; /∗ modification time ∗/
utime will fail if one or more of the following are true:
[EACCES] Search permission is denied by a component of the path prefix, or the effective user ID is not super-user and not the owner of the file and times is NULL and write access is denied.
[EFAULT] Times is not NULL and points outside the process’s allocated address space, or path points outside the process’s allocated address space.
[ENAMETOOLONG] The path argument exceeds {PATH_MAX} in length, or a pathname component is longer than {NAME_MAX} (see pathconf(2)).
[ENOENT] The named file does not exist, or the path argument points to an empty string.
[ENOTDIR] A component of the path prefix is not a directory.
[EPERM] The effective user ID is not super-user and not the owner of the file and times is not NULL.
[EROFS] The file system containing the file is mounted read-only.
RETURN VALUE
Upon successful completion, a value of 0 is returned. Otherwise, a value of −1 is returned and errno is set to indicate the error.
SEE ALSO
CX/UX Programmer’s Reference Manual