ultrix man page for utime

utime(3)						     Library Functions Manual							  utime(3)

Name
       utime - set file times

Syntax
       #include <sys/types.h>
       int utime (path, times)
       char *path;
       struct utimbuf *times;

Description
       The path points to a pathname naming a file.  The function sets the access and modification times of the named file.

       If  times  is  NULL, 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 to use in this manner.

       If times is not NULL, 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 the super-user can use this way.

       The function causes the time of the last file status change(st_ctime) to be updated with the current time.

       The times in the following structure are measured in seconds since 00:00:00 GMT, January 1, 1970.
       struct  utimbuf	{
	       time_t  actime;	  /* access time */
	       time_t  modtime;   /* modification time */
       };

Return Values
       Upon successful completion, a value of zero (0) is returned.  Otherwise, a value of -1 is returned, and errno is set to indicate the error.

Diagnostics
       The function fails, if any of the following is true:

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

       [EACCES]       The effective user ID is not super-user, not the owner of the file, times is NULL, and write access is denied.

       [EFAULT]       The times is not NULL and points outside the process's allocated address space.

       [EFAULT]       The path points outside the process's allocated address space.

       [ENOENT]       The named file does not exist or path points to an empty string and the environment defined is POSIX or SYSTEM_FIVE.

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

       [EPERM]	      The effective user ID is not a super-user, not the owner of the file, and times is not NULL.

       [EROFS]	      The file system containing the file is mounted read-only.

       [ETIMEDOUT]    A connect request or remote file operation failed, because the connected party did not respond after a period of time deter-
		      mined by the communications protocol.

See Also
       stat(2)

																	  utime(3)