| Skip Navigation Links | |
| Exit Print View | |
 | man pages section 2: System Calls Oracle Solaris 11 Information Library |
| Skip Navigation Links | |
| Exit Print View | |
| man pages section 2: System Calls Oracle Solaris 11 Information Library |
- set file access and modification times
#include <sys/time.h>intutimes(const char *path,const struct timevaltimes[2]);
intfutimesat(intfildes,const char *path,const struct timevaltimes[2]);
Theutimes() function sets the access and modification times of the filepointed to by thepath argument to the value of thetimesargument. It allows time specifications accurate to the microsecond.
Thefutimesat() function also sets access and modification times. Seefsattr(5).Ifpath is a relative path name, however,futimesat() resolves the path relativeto thefildes argument rather than the current working directory. Iffildes is set toAT_FDCWD, defined in <fcntl.h>,futimesat() resolves the path relativeto the current working directory. Ifpath is a null pointer,futimesat() sets the access and modification times on the file referenced byfildes. Thefildes argument is ignored even whenfutimesat() is provided withan absolute path.
Thetimes argument is an array oftimeval structures. The first arraymember represents the date and time of last access, and the secondmember represents the date and time of last modification. The timesin thetimeval structure are measured in seconds and microseconds since the Epoch,although rounding toward the nearest second may occur.
If thetimes argument is a null pointer, the access and modificationtimes of the file are set to the current time. Theeffective user ID of the process must be the same as theowner of the file, or must have write access to the fileor the {PRIV_FILE_OWNER} privilege to use this call in this manner. Uponcompletion,utimes() will mark the time of the last file status change,st_ctime, for update.
Upon successful completion,0 is returned. Otherwise,-1 is returned,errnois set to indicate the error, and the file times will notbe affected.
Theutimes() andfutimesat() functions will fail if:
Search permission is denied by a component of the path prefix; or thetimes argument is a null pointer and the effective user ID of the process does not match the owner of the file and write access is denied.
Thepath ortimes argument points to an illegal address. Forfutimesat(),path might have the valueNULL if thefildes argument refers to a valid open file descriptor.
A signal was caught during the execution of theutimes() function.
The number of microseconds specified in one or both of thetimeval structures pointed to bytimes was greater than or equal to 1,000,000 or less than 0.
An I/O error occurred while reading from or writing to the file system.
Too many symbolic links were encountered in resolvingpath.
The length of thepath argument exceeds {PATH_MAX} or a pathname component is longer than {NAME_MAX}.
Thepath argument points to a remote machine and the link to that machine is no longer active.
A component ofpath does not name an existing file orpath is an empty string.
A component of the path prefix is not a directory or thepath argument is relative and thefildes argument is notAT_FDCWD or does not refer to a valid directory.
Thetimes argument is not a null pointer and the calling process's effective user ID has write access to the file but does not match the owner of the file and the calling process does not have the appropriate privileges.
The file system containing the file is read-only.
Theutimes() andfutimesat() functions may fail if:
Path name resolution of a symbolic link produced an intermediate result whose length exceeds {PATH_MAX}.
Seeattributes(5) for descriptions of the following attributes:
|
Forutimes(), seestandards(5).
futimens(2),stat(2),utime(2),attributes(5),fsattr(5),standards(5)
Copyright © 2011, Oracle and/or its affiliates. All rights reserved.Legal Notices |   |