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, const 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 appropri-
ately.
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)
Linux 1995-06-10 UTIME(2)
Generated by $Id: phpMan.php,v 4.55 2007/09/05 04:42:51 chedong Exp $ Author: Che Dong
On Apache/1.3.41 (Unix) PHP/5.2.5 mod_perl/1.30 mod_gzip/1.3.26.1a
Under GNU General Public License
2009-01-10 12:57 @38.103.63.58 CrawledBy CCBot/1.0 (+http://www.commoncrawl.org/bot.html)