Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

RedHat 9 (Linux i386) - man page for utime (redhat section 2)

UTIME(2)						     Linux Programmer's Manual							  UTIME(2)

utime, utimes - change access and/or modification times of an inode
#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);
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 */ };
On success, zero is returned. On error, -1 is returned, and errno is set appropriately.
Other errors may occur. EACCES Permission to write the file is denied. ENOENT filename does not exist.
utime: SVr4, SVID, POSIX. SVr4 documents additional error conditions EFAULT, EINTR, ELOOP, EMULTIHOP, ENAMETOOLONG, ENOLINK, ENOTDIR, ENO- LINK, ENOTDIR, EPERM, EROFS. utimes: BSD 4.3
stat(2) Linux 1995-06-10 UTIME(2)