utime(3)utime(3)Nameutime - set file times
Syntax
#include <sys/types.h>
int utime (path, times)
char *path;
struct utimbuf *times;
Description
The path points to a pathname naming a file. The function 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 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 can use this way.
The function causes the time of the last file status change(st_ctime)
to be updated with the current time.
The times in the following structure are measured in seconds since
00:00:00 GMT, January 1, 1970.
struct utimbuf {
time_t actime; /* access time */
time_t modtime; /* modification time */
};
Return Values
Upon successful completion, a value of zero (0) is returned. Other‐
wise, a value of -1 is returned, and errno is set to indicate the
error.
Diagnostics
The function fails, if any of the following is true:
[EACCES] Search permission is denied by a component of the path
prefix.
[EACCES] The effective user ID is not super-user, not the owner
of the file, times is NULL, and write access is denied.
[EFAULT] The times is not NULL and points outside the process's
allocated address space.
[EFAULT] The path points outside the process's allocated address
space.
[ENOENT] The named file does not exist or path points to an empty
string and the environment defined is POSIX or SYS‐
TEM_FIVE.
[ENOTDIR] A component of the path prefix is not a directory.
[EPERM] The effective user ID is not a super-user, not the owner
of the file, and times is not NULL.
[EROFS] The file system containing the file is mounted read-
only.
[ETIMEDOUT] A connect request or remote file operation failed,
because the connected party did not respond after a
period of time determined by the communications proto‐
col.
See Alsostat(2)utime(3)