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

utime(2)							      utime(2)

NAME
       utime() - set file access and modification times

SYNOPSIS
DESCRIPTION
       The  system  call sets the access and modification times of the file to
       which the path argument refers.

       If times is a NULL pointer, the access and modification	times  of  the
       file  are  set to the current time.  A process must be the owner of the
       file or have write permission on the file to use in this manner.

       The following times in the structure defined in are measured in seconds
       since 00:00:00 UTC (Coordinated Universal Time), January 1, 1970.

	      time_t actime;	 /* access time */
	      time_t modtime;	 /* modification time */

   Security Restrictions
       If  times is not a NULL pointer, times is interpreted as a pointer to a
       utimbuf structure, and the access and modification times are set to the
       values  contained  in  the designated structure.	 Only the owner of the
       file or a user with the privilege can use this way.

       See privileges(5) for more information about privileged access on  sys‐
       tems that support fine-grained privileges.

RETURN VALUE
       returns the following values:

	      Successful completion.
	      Failure.
		     is set to indicate the error.

ERRORS
       If fails, is set to one of the following values.

	      Search permission is denied by a component of the path prefix.

	      The effective user ID is not a
			     user with the privilege, and not the owner of the
			     file, times is a NULL pointer, and	 write	access
			     is denied.

	      times	     is	 not a NULL pointer, and it points outside the
			     process's allocated address space.	 The  reliable
			     detection	of this error is implementation-depen‐
			     dent.

	      path	     points outside the	 process's  allocated  address
			     space.   The  reliable detection of this error is
			     implementation-dependent.

	      times	     is not a NULL pointer, and access time or modifi‐
			     cation time or both are negative.

	      The length of the specified path name exceeds
			     bytes,  or	 the length of a component of the path
			     name exceeds bytes while is in effect.

	      The named file does not exist.

	      A component of the path prefix is not a directory.

	      The effective user ID is not a
			     user with the privilege, and not the owner of the
			     file, and times is not a NULL pointer.

	      The file system containing the file is mounted read-only.

DEPENDENCIES
   NFS
       may return when invoked on a remote file owned by a superuser, or users
       with and privileges, even if the invoking user has write permission  on
       the file.

       See  privileges(5) for more information about privileged access on sys‐
       tems that support fine-grained privileges.

SEE ALSO
       touch(1), stat(2), privileges(5).

STANDARDS CONFORMANCE
								      utime(2)

Vote for polarhome