NAME

utime − set file access and modification times

SYNOPSIS

#include <sys/types.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 times in the following structure are measured in seconds since 00:00:00 GMT, Jan. 1, 1970. 

structutimbuf{
time_tactime;/∗ access time ∗/
time_tmodtime;/∗ modification time ∗/
};

utime fails if one or more of the following are true:

­[ENOENT] The named file does not exist. 

­[ENOTDIR] A component of the path prefix is not a directory. 

­[EACCES] Search permission is denied by a component of the path prefix. 

­[EPERM] The effective user ID is not super-user and not the owner of the file and times is not NULL. 

­[EACCES] The effective user ID is not super-user and not the owner of the file and times is NULL and write access is denied. 

­[EROFS] The file system containing the file is mounted read-only. 

­[EFAULT] times is not NULL and points outside the process’s allocated address space. 

­[EFAULT] path points outside the process’s allocated address space. 

­[EINTR] A signal was caught during the utime system call. 

­[ENOLINK] path points to a remote machine and the link to that machine is no longer active. 

­[EMULTIHOP] Components of path require hopping to multiple remote machines. 

SEE ALSO

stat(2). 

DIAGNOSTICS

Upon successful completion, a value of 0 is returned.  Otherwise, a value of −1 is returned and errno is set to indicate the error. 

September 29, 2021