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

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

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 ]