UTIMES(2)                                                            UTIMES(2)



NAME
       utimes - set file times

SYNOPSIS
       #include <sys/time.h>

       utimes(file, tvp)
       char *file;
       struct timeval tvp[2];

DESCRIPTION
       The  _u_t_i_m_e_s  call uses the “accessed” and “updated” times in that order
       from the _t_v_p vector to set the corresponding recorded times for _f_i_l_e_.

       The caller must be the owner  of  the  file  or  the  super-user.   The
       “inode-changed” time of the file is set to the current time.

RETURN VALUE
       Upon  successful  completion,  a  value of 0 is returned.  Otherwise, a
       value of -1 is returned and _e_r_r_n_o is set to indicate the error.

ERRORS
       _U_t_i_m_e will fail if one or more of the following are true:

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

       [EINVAL]       The pathname contains a character  with  the  high-order
                      bit set.

       [ENAMETOOLONG] A component of a pathname exceeded 255 characters, or an
                      entire path name exceeded 1023 characters.

       [ENOENT]       The named file does not exist.

       [ELOOP]        Too many symbolic links were encountered in  translating
                      the pathname.

       [EPERM]        The  process  is not super-user and not the owner of the
                      file.

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

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

       [EFAULT]       _F_i_l_e or  _t_v_p  points  outside  the  process’s  allocated
                      address space.

       [EIO]          An  I/O  error  occurred  while  reading  or writing the
                      affected inode.

SEE ALSO
       stat(2)



4th Berkeley Distribution       August 26, 1985                      UTIMES(2)