utime(3) Library Functions Manual utime(3)
Name
utime - 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. Otherwise, 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 SYSTEM_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 deter-
mined by the communications protocol.
See Also
stat(2)
utime(3)
