NAME

utime.h - access and modification times structure

SYNOPSIS

^[OB] #include <utime.h>

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() function only allows setting file timestamps to the nearest second. Applications should use the utimensat() function instead. See <sys/stat.h>.

RATIONALE

None.

FUTURE DIRECTIONS

The <utime.h> header may be removed in a future version.

SEE ALSO

<sys/stat.h>, <sys/types.h>

XSH futimens, utime

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.