UTIME (2)
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
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
|