UTIME
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,
ENOLINK, ENOTDIR, EPERM, EROFS.
utimes:
BSD 4.3
SEE ALSO
stat(2)