timer_delete(2)

timer_delete2

Delete a posix per-process timer

Usage

#include <time.h>

int timer_delete(timer_t timerid);

Feature Test Macro Requirements for glibc (see feature_test_macros(7)):

timer_delete():

    _POSIX_C_SOURCE >= 199309L

Library

Real-time library (librt, -lrt)

Overview

timer_delete() deletes the timer whose ID is given in timerid. If the timer was armed at the time of this call, it is disarmed before being deleted. The treatment of any pending signal generated by the deleted timer is unspecified.

Return value

On success, timer_delete() returns 0. On failure, -1 is returned, and errno is set to indicate the error.

Errors

EINVAL

timerid is not a valid timer ID.

Releases

9 releases since Debian 6.0 (Squeeze); the text changed 8 times.

  1. 6.0
  2. 7
  3. 8
  4. 9
  5. 10
  6. 11
  7. 12
  8. 13
  9. Arch

Standards

POSIX.1-2024.

History

Linux 2.6. POSIX.1-2001.

From man-pages 6.19-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.