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 *);

The following sections are informative.

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

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

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.

End of informative text.