utime() -- System Call (libc)

Change file access and modification times
#include <sys/types.h>
#include <utime.h>
int utime(file, times)
char *file;
time_t times[2];

utime() sets  the access and  modification times associated  with the given
file to times obtained  from times[0] and times[1], respectively.  The time
of last change to the attributes is set to the time of the utime() call.

This call must be made by the owner of file or by the superuser.

Files

<sys/types.h>

See Also

libc,
restor,
stat(),
utime.h
POSIX Standard, §5.6.6

Diagnostics

utime() returns -1 on errors, such as if file does not exist or the invoker
not the owner.

© 2012 by Stephen A. Ness