utime(2)							System Calls Manual							  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 systems 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-dependent.

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

	      times	     is not a NULL pointer, and access time or modification 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 systems that support fine-grained privileges.

SEE ALSO

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

STANDARDS CONFORMANCE

																	  utime(2)