getitimer(2)
_________________________________________________________________
getitimer System Call
getitimer gets the current state of one of the interval timers.
_________________________________________________________________
SYNTAX
#include <sys/time.h>
int getitimer (which_timer, current_state_ptr)
int which_timer;
struct itimerval *current_state_ptr;
PARAMETERS
which_timer Specifies which of the three available timers to
set. Can be ITIMER_REAL, TIMER_VIRTUAL, or
ITIMER_PROF.
current_state_ptr
The current value of the specified timer.
DESCRIPTION
Validate the arguments and return the current_value. The
itimerval structure defined in <sys/time.h> is of the form:
struct itimerval
{
struct timeval it_interval; /* timer interval
struct timeval it_value; /* current value
}
If it_value is non-zero, it indicates the time to the next timer
expiration. If it_interval is non-zero, it specifies a value to
be used in reloading it_value when the timer expires.
RETURN VALUE
0 Call was successful
DG/UX 4.00 Page 1
Licensed material--property of copyright holder(s)
getitimer(2)
-1 An error occurred. Errno is set to indicate
error.
EXCEPTIONS
Errno may be set to one of the following error codes:
EFAULT <current_state_ptr> specified a bad address
EINVAL invalid argument
SEE ALSO
The related system calls: setitimer, alarm, sigvec
DG/UX 4.00 Page 2
Licensed material--property of copyright holder(s)