Sets the modification time for a file.

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

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

Parameters

filename

File on which to set modification time. The process must have write access to the file.

times

Pointer to stored time values. If times is a NULL pointer, the modification time is set to the current time. Otherwise, times must point to a UTIMBUF structure, defined in sys\utime.h.

Remarks

The modification time is set from the modtime field in the UTIMBUF structure. Although this structure contains a field for access time, only the modification time is set.

Return Values

0	The file-modification time was changed.
-1	Time was unchanged and the function sets errno to one of these values: EACCES Pathname specifies directory or read-only file. EINVAL Invalid argument; the times argument is invalid. EMFILE Too many open files (the file must be opened to change its modification time). ENOENT Filename or pathname not found.

Requirements

See Also

asctime, ctime, gmtime, localtime, time