[ Previous | Next | Contents | Glossary | Home | Search ]
AIX Version 4.3 Base Operating System and Extensions Technical Reference, Volume 2

reltimerid Subroutine


Releases a previously allocated interval timer.


Standard C Library (libc.a)


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


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.


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:

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

Implementation Specifics

This subroutine is part of Base Operating System (BOS) Runtime.

Related Information

The gettimerid subroutine.

List of Time Data Manipulation Services in AIX Version 4.3 System Management Guide: Operating System and Devices.

Subroutines Overview in AIX Version 4.3 General Programming Concepts: Writing and Debugging Programs.

[ Previous | Next | Contents | Glossary | Home | Search ]