Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   10987 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

utimes(2)							     utimes(2)

NAME
       utimes - set file access and modification times

SYNOPSIS
DESCRIPTION
       The function sets the access and modification times of the file pointed
       to by the path argument to the value of the times argument.  The	 func‐
       tion allows time specifications accurate to the microsecond.

       For  the times argument is an array of structures. The first array mem‐
       ber represents the date and time of last access, and the second	member
       represents  the	date  and time of last modification.  The times in the
       structure are measured in seconds and  microseconds  since  the	Epoch,
       although rounding toward the nearest second may occur.

       If  the	times argument is a null pointer, the access and  modification
       times of the file are set to the current time. The effective user ID of
       the  process  must  be  the same as the owner of the file, or must have
       write access to the file or appropriate privileges to use this call  in
       this  manner. Upon completion, will mark the time of the last file sta‐
       tus change, st_ctime, for update.

RETURN VALUE
       Upon successful completion, 0 is returned. Otherwise,  −1  is  returned
       and  is	set  to	 indicate  the	error,	and the file times will not be
       affected.

ERRORS
       The utimes() function will fail if:

	      Search permission is denied by a component of the
				     path prefix; or the times argument	 is  a
				     null pointer and the effective user ID of
				     the process does not match the  owner  of
				     the file and write access is denied.

	      Too many symbolic links were encountered in resolving path.

	      The length of the	     path  argument exceeds or a pathname com‐
				     ponent is longer than

	      A component of	     path does not name an  existing  file  or
				     path is an empty string.

	      A component of the     path prefix is not a directory.

	      The		     times  argument is not a null pointer and
				     the calling process'  effective  user  ID
				     has write access to the file but does not
				     match the owner of the file and the call‐
				     ing process does not have the appropriate
				     privileges.

	      The file system containing the file is read-only.

       The function may fail if:

	      Pathname resolution of a symbolic link produced an  intermediate
	      result
				     whose length exceeds

SEE ALSO
       <sys/time.h>.

CHANGE HISTORY
       First released in Issue 4, Version 2.

								     utimes(2)

Vote for polarhome