timer_delete Subroutine

Purpose

Deletes a per process timer.

Library

Standard C Library (libc.a)

Syntax

#include <time.h>

int timer_delete (timerid)
timer_t timerid;

Description

The timer_delete subroutine deletes the specified timer, timerid, that was previously created by the timer_create subroutine. If the timer is armed when the timer_delete subroutine is called, the timer is automatically disarmed before removal.

Parameters

Item	Description
timerid	Specifies the timer ID.

Return Values

If successful, the timer_delete subroutine returns a value of zero. Otherwise, the subroutine returns a value of -1 and sets errno to indicate the error.

Error Codes

The timer_delete subroutine fails if:

Item	Description
EINVAL	The timerid parameter is not a valid timer ID.
ENOTSUP	The function is not supported with checkpoint-restart processes.