getitimer(2)               DG/UX 4.30                getitimer(2)



     NAME
          getitimer - get the current state of one of the interval
          timers

     SYNOPSIS
          #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

          -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
          setitimer(2), alarm(2), sigvec(2).






     Licensed material--property of copyright holder(s)         Page 1