NAME
utime.h — access
and modification times structure
SYNOPSIS
DESCRIPTION
The <utime.h> header shall declare the utimbuf structure, which shall include the following members:
time_t actime Access time. time_t modtime Modification time.
The times shall be measured in seconds since the Epoch.
The <utime.h> header shall define the time_t type as described in <sys/types.h>.
The following shall be declared as a function and may also be defined as a macro. A function prototype shall be provided.
int utime(const char *, const struct utimbuf *);
APPLICATION USAGE
The utime(3) function only allows setting file timestamps to the nearest second. Applications should use the utimensat(3) function instead. See <sys/stat.h>.
RATIONALE
None.
FUTURE DIRECTIONS
The <utime.h> header may be removed in a future version.
SEE ALSO
XSH futimens(3), utime(3)
CHANGE HISTORY
First released in Issue 3.
Issue 6
The following new requirements on POSIX implementations derive from alignment with the Single UNIX Specification:
- The time_t type is defined.
Issue 7
The <utime.h> header is marked obsolescent.