reltimerid Subroutine

Purpose

Releases a previously allocated interval timer.

Library

Standard C Library (libc.a)

Syntax

#include <sys/time.h> #include <sys/events.h> int reltimerid ( TimerID) timer_t TimerID;

Description

The reltimerid subroutine is used to release a previously allocated interval timer, which is returned by the gettimerid subroutine. Any pending timer event generated by this interval timer is cancelled when the call returns.

Parameters

Item	Description
TimerID	Specifies the ID of the interval timer being released.

Return Values

The reltimerid subroutine returns a 0 if it is successful. If an error occurs, the value -1 is returned and errno is set.

Error Codes

If the reltimerid subroutine fails, a -1 is returned and errno is set with the following error code:

Item	Description
EINVAL	The timer ID specified by the Timerid parameter is not a valid timer ID.