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

     utimes - set file times

     #include <sys/time.h>

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

     The utimes call uses the "accessed" and "updated" times in
     that order from the tvp vector to set the corresponding
     recorded times for file.

     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

     Upon successful completion, a value of 0 is returned.  Oth-
     erwise, a value of -1 is returned and errno is set to indi-
     cate the error.

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

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

     [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

     [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]	    File or tvp points outside the process's

Printed 11/26/99	 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.


Printed 11/26/99	 August 26, 1985			2

Generated: 2016-12-26
Generated by man2html V0.25
page hit count: 807
Valid CSS Valid XHTML 1.0 Strict