NAME    [Toc]    [Back]

       utime, utimes - change access and/or modification times of an inode

SYNOPSIS    [Toc]    [Back]

       #include <sys/types.h>
       #include <utime.h>

       int utime(const char *filename, struct utimbuf *buf);


       #include <sys/time.h>

       int utimes(char *filename, struct timeval *tvp);

DESCRIPTION    [Toc]    [Back]

       utime  changes the access and modification times of the inode specified
       by filename to the actime and modtime fields of buf  respectively.   If
       buf is NULL, then the access and modification times of the file are set
       to the current time.  The utimbuf structure is:

	      struct utimbuf {
		      time_t actime;  /* access time */
		      time_t modtime; /* modification time */
	      };

       In the Linux DLL 4.4.1 libraries, utimes is just a wrapper  for	utime:
       tvp[0].tv_sec  is  actime,  and	tvp[1].tv_sec is modtime.  The timeval
       structure is:

	      struct timeval {
		      long    tv_sec;	      /* seconds */
		      long    tv_usec;	      /* microseconds */
	      };

RETURN VALUE    [Toc]    [Back]

       On success, zero is returned.  On error, -1 is returned, and  errno  is
       set appropriately.

ERRORS    [Toc]    [Back]

       Other errors may occur.


       EACCES Permission to write the file is denied.

       ENOENT filename does not exist.

CONFORMING TO    [Toc]    [Back]

       utime:  SVr4,  SVID, POSIX.  SVr4 documents additional error conditions
       EFAULT, EINTR, ELOOP, EMULTIHOP, ENAMETOOLONG, ENOLINK,	ENOTDIR,  ENOLINK,
 ENOTDIR, EPERM, EROFS.
       utimes: BSD 4.3

SEE ALSO    [Toc]    [Back]

       stat(2)



Linux				  1995-06-10			      UTIME(2)