UTIME(2)                             SysV                             UTIME(2)



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 pathname 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.

          struct utimbuf {
                 time_t  actime;   /* access time */
                 time_t  modtime;  /* modification time */
          };

ERRORS
     utime will fail 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' allocated
                   address space.

     [EFAULT]      path points outside the process' allocated address space.

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

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.

NOTES
     Under other implementations, utime fails if either of the following is
     true:

     [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.