programming.nbk: Home | Index | Next Page: Why not SQL? | Previous Page: utimbuf
set access and modification times for file
#include <sys/types.h>
#include <utime.h>
int utime(const char *pathname, const struct utimbuf *times);
The utime() function sets the access and modification times of the named file.
If times is NULL, the access and modification times of the file are set to the current time. The effective user ID of the process must match the owner of the file or the process must have write permission to the file or appropriate privileges to use utime() in this way.
If times is not NULL, it is interpreted as a pointer to a utimbuf structure; and the access and modification times are set to the values in the designated structure. Only the owner of the file and processes with appropriate privileges can use the utime() function in this manner.
If successful, utime() returns a value of zero. On failure, it returns -1, does not change the file times, and sets errno to indicate the error:
EACCES A component of the pathname prefix denies search permission.
EFAULT pathname is an invalid pointer, or times is not NULL and is an invalid pointer.
EINTR A signal interrupted the call.
ENAMETOOLONG The length of the pathname parameter exceeds PATH_MAX or a pathname component is longer than NAME_MAX.
ENOENT The named file does not exist or pathname points to an empty string.
ENOTDIR A component of the pathname prefix is not a directory.
EPERM The process has insufficient permissions.
EROFS The file system that contains the file is mounted as read-only.
programming.nbk: Home | Index | Next Page: Why not SQL? | Previous Page: utimbuf
Notebook exported on Monday, 7 July 2008, 18:56:06 PM Eastern Daylight Time