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.