UTIMES(3B)							    UTIMES(3B)

NAME    [Toc]    [Back]

     utimes - set file times

SYNOPSIS    [Toc]    [Back]

     #include <sys/time.h>

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

DESCRIPTION    [Toc]    [Back]

     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 "inodechanged"
 time of the file is set to the current time.

     This routine emulates the 4.3BSD utimes system call.

RETURN VALUE    [Toc]    [Back]

     Upon successful completion, a value of 0 is returned.  Otherwise, a value
     of	-1 is returned and errno is set	to indicate the	error.	Utimes 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]	 File or tvp points outside the	process's allocated address
		 space.

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







									Page 1






UTIMES(3B)							    UTIMES(3B)



NOTES
     Note that prior to	IRIX 6.5.10 the	utimes() call only offered second
     resolution	because	it used	the utime() call internally to execute its
     functionality. utimes() now uses the new utimets()	call to	execute	its
     functionality and thus now	can offer the microsecond accuracy it
     promises.

SEE ALSO    [Toc]    [Back]

     stat(2), utime(2),	utimets(2)


									PPPPaaaaggggeeee 2222