NAME
sys/time.h — time
types
SYNOPSIS
[XSI]
#include <sys/time.h>
DESCRIPTION
The <sys/time.h> header shall define the fd_set type and the timeval structure, as described in <sys/select.h>.
The <sys/time.h> header shall define the time_t and suseconds_t types as described in <sys/types.h>.
The <sys/time.h> header shall define the following as described in <sys/select.h>: FD_CLR(3) FD_ISSET(3) FD_SET(3) FD_ZERO(3) FD_SETSIZE
The following shall be declared as functions and may also be defined as macros. Function prototypes shall be provided.
int select(int, fd_set *restrict, fd_set *restrict, fd_set *restrict,
struct timeval *restrict);
int utimes(const char *, const struct timeval [2]);
Inclusion of the <sys/time.h> header may make visible all symbols from the <sys/select.h> header.
APPLICATION USAGE
None.
RATIONALE
The <sys/time.h> header refers to <sys/select.h> for the definition of the timeval structure, instead of the other way round, because <sys/time.h> is an optional (XSI) header whereas <sys/select.h> is mandatory.
FUTURE DIRECTIONS
None.
SEE ALSO
XSH futimens(3), pselect(3)
CHANGE HISTORY
First released in Issue 4, Version 2.
Issue 5
Issue 6
The restrict keyword is added to the prototypes for gettimeofday (), select(3), and setitimer ().
The note is added that inclusion of this header may also make symbols visible from <sys/select.h>.
The utimes(3) function is marked LEGACY.
Issue 7
This reference page is clarified with respect to macros and symbolic constants.
Issue 8
Austin Group Defect 1171 is applied, replacing the timeval structure definition with a reference to its description in <sys/select.h>.
Austin Group Defect 1330 is applied, removing obsolescent interfaces.