RMTIMER(3)                           SysV                           RMTIMER(3)



NAME
     rmtimer - free a per-process timer

SYNOPSIS
     #include <sys/timers.h>

     int rmtimer (timer_id)
     timer_t timer_id;

DESCRIPTION
     The rmtimer function is used to free a previously allocated per-process
     timer (returned by the mktimer(3) function).

     Any pending per-process timer event generated by the timer specified by
     the timer_id argument is cancelled when this call returns.

     The timer_id argument specifies the per-process timer to deallocate.

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

ERRORS
     rmtimer fails if:

     [EINVAL]       The timerid argument does not specify an allocated per-
                    process timer.

SEE ALSO
     gettimer(3), mktimer(3), reltimer(3), <sys/timers>