4.3BSD-Reno/share/man/cat2/utimes.0

UTIMES(2)		      1987			UTIMES(2)



NNAAMMEE
     utimes - set file times

SSYYNNOOPPSSIISS
     ##iinncclluuddee <<ssyyss//ttiimmee..hh>>

     uuttiimmeess((ffiillee,, ttvvpp))
     cchhaarr **ffiillee;;
     ssttrruucctt ttiimmeevvaall ttvvpp[[22]];;

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

RREETTUURRNN VVAALLUUEE
     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.

EERRRROORRSS
     _U_t_i_m_e_s 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 7/27/90             September				1






UTIMES(2)		      1987			UTIMES(2)



		    allocated address space.

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

SSEEEE AALLSSOO
     stat(2)
















































Printed 7/27/90             September				2