[ Previous | Next | Table of Contents | Index | Library Home | Legal | Search ]

Technical Reference: Base Operating System and Extensions , 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 5L Version 5.1 System Management Concepts: Operating System and Devices.

Subroutines Overview in AIX 5L Version 5.1 General Programming Concepts: Writing and Debugging Programs.


[ Previous | Next | Table of Contents | Index | Library Home | Legal | Search ]