utime(3) [osx man page]

UTIME(3)						   BSD Library Functions Manual 						  UTIME(3)

NAME

     utime -- set file times

LIBRARY

     Standard C Library (libc, -lc)

SYNOPSIS

     #include <utime.h>

     int
     utime(const char *path, const struct utimbuf *times);

DESCRIPTION

     This interface is obsoleted by utimes(2).

     The utime() function sets the access and modification times of the named file, based on the actime and modtime fields of the struct utimbuf
     pointed at by times.

     If the times are specified (the times argument is non-NULL), the caller must be the owner of the file or be the super-user.

     If the times are not specified (the times argument is NULL), the caller must be the owner of the file, have permission to write the file, or
     be the super-user.

ERRORS

     The utime() function may fail and set errno for any of the errors specified for the library function utimes(2).

SEE ALSO

     stat(2), utimes(2)

STANDARDS

     The utime() function conforms to IEEE Std 1003.1-1988 (``POSIX.1'').

HISTORY

     A utime() function appeared in Version 7 AT&T UNIX.

BSD
								   June 4, 1993 							       BSD

UTIME(2)						     Linux Programmer's Manual							  UTIME(2)

NAME

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

SYNOPSIS

       #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

       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

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

ERRORS

       Other errors may occur.

       EACCES Permission to write the file is denied.

       ENOENT filename does not exist.

CONFORMING TO

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

SEE ALSO

       stat(2)

Linux								    1995-06-10								  UTIME(2)