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

#### 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() 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.

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-2016 The IEEE and The Open Group, All Rights Reserved
[ Main Index | XBD | XSH | XCU | XRAT ]