NAME    [Toc]    [Back]

       gettimer - Get value of a per-process timer

SYNOPSIS    [Toc]    [Back]

       #include <sys/timers.h>

       int gettimer(
               timer_t timerid,
               struct itimerspec *tp );

LIBRARY    [Toc]    [Back]

       Standard C Library (libc)

PARAMETERS    [Toc]    [Back]

       Specifies  the  per-process  timer  to  use; this value is
       obtained from a call to mktimer().  Points to  an  itimerspec
 structure.

DESCRIPTION    [Toc]    [Back]

       The  gettimer()  function gets the current value of a perprocess
 timer.

NOTES    [Toc]    [Back]

       The gettimer() function is part of the POSIX 1003.4  realtime
  extensions,  which  is  not an approved standard. As
       such, it is liable to change.  Trial use

RETURN VALUES    [Toc]    [Back]

       Upon  successful  completion,  the   gettimer()   function
       returns  the  value  0  (zero).  Otherwise, the gettimer()
       function returns a value of -1 and sets errno to  indicate
       the error.

ERRORS    [Toc]    [Back]

       If  the gettimer() function fails, errno may be set to the
       following value: The timerid parameter does not specify  a
       known timer.

SEE ALSO    [Toc]    [Back]

       Functions: mktimer(3), reltimer(3), rmtimer(3)



                                                      gettimer(3)