NAME
sys/time.h — time
types
SYNOPSIS
[XSI]
#include <sys/time.h>
DESCRIPTION
The <sys/time.h> header shall define the timeval structure, which shall include at least the following members:
time_t tv_sec Seconds. suseconds_t tv_usec Microseconds.
[OB] The <sys/time.h> header shall define the itimerval structure, which shall include at least the following members:
struct timeval it_interval Timer interval. struct timeval it_value Current value.
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 fd_set type as described in <sys/select.h>.
[OB] The <sys/time.h> header shall define the following symbolic constants for the which argument of getitimer(3) and setitimer(3):
- ITIMER_REAL
- Decrements in real time.
- ITIMER_VIRTUAL
- Decrements in process virtual time.
- ITIMER_PROF
- Decrements both in process virtual time and when the system is running on behalf of the process.
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.
[OB]
int getitimer(int, struct itimerval *);
int gettimeofday(struct timeval *restrict, void *restrict);
int setitimer(int, const struct itimerval *restrict,
struct itimerval *restrict);
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
None.
FUTURE DIRECTIONS
None.
SEE ALSO
<sys/select.h> , <sys/types.h>
XSH futimens(3) , getitimer(3) , gettimeofday(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(3), select(3), and setitimer(3).
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.