4.3BSD-UWisc/man/cat2/utimes.2

UTIMES(2)           UNIX Programmer's Manual            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.  Oth-
     erwise, a value of -1 is returned and _e_r_r_n_o is set to indi-
     cate 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 char-
                    acters, 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



Printed 12/27/86         August 26, 1985                        1






UTIMES(2)           UNIX Programmer's Manual            UTIMES(2)



                    allocated address space.

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

SEE ALSO
     stat(2)
















































Printed 12/27/86         August 26, 1985                        2