The Open Group Base Specifications Issue 7
IEEE Std 1003.1-2008
Copyright © 2001-2008 The IEEE and The Open Group

NAME

utime.h - access and modification times structure

SYNOPSIS

[OB] [Option Start] #include <utime.h> [Option End]

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() 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:

Issue 7

The <utime.h> header is marked obsolescent.

End of informative text.

 

return to top of page

UNIX ® is a registered Trademark of The Open Group.
POSIX ® is a registered Trademark of The IEEE.
Copyright © 2001-2008 The IEEE and The Open Group, All Rights Reserved
[ Main Index | XBD | XSH | XCU | XRAT ]