NAME    [Toc]    [Back]

       rmtimer - Free a per-process timer

SYNOPSIS    [Toc]    [Back]

       #include <sys/timers.h>

       int rmtimer(
               timer_t timer_id );

LIBRARY    [Toc]    [Back]

       Standard C Library (libc)

PARAMETERS    [Toc]    [Back]

       Specifies the per-process timer to deallocate.

DESCRIPTION    [Toc]    [Back]

       The  rmtimer() function is used to free a previously allocated
  per-process  timer  (previously  returned  by   the
       mktimer()  function).  Any pending per-process timer event
       generated by the timer specified by the timer_id parameter
       is canceled when this function successfully executes.

NOTES    [Toc]    [Back]

       Trial use

RETURN VALUES    [Toc]    [Back]

       Upon   successful   completion,  the  value  0  (zero)  is
       returned. Otherwise, the value -1 is returned and errno is
       set to indicate the error.

ERRORS    [Toc]    [Back]

       If  the  rmtimer() function fails, errno may be set to the
       following value: The timerid parameter does not specify an
       allocated per-process timer.

SEE ALSO    [Toc]    [Back]

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



                                                       rmtimer(3)