---
name: "timer_delete"
section: "2"
platform: "linux"
package: "man-pages"
version: "6.19-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux", "freebsd"]
url: "https://new.carta.tech/timer_delete"
---

# timer\_delete(2)

delete a POSIX per-process timer

## NAME

timer\_delete - delete a POSIX per-process timer

## LIBRARY

Real-time library (*librt*, *-lrt*)

## SYNOPSIS

```
#include <time.h>
```

**int timer\_delete(timer\_t** *timerid***);**

Feature Test Macro Requirements for glibc (see [**feature\_test\_macros**(7)](/feature_test_macros/7.md)):

**timer\_delete**():

```
    _POSIX_C_SOURCE >= 199309L
```

## DESCRIPTION

**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.

## STANDARDS

POSIX.1-2024.

## HISTORY

Linux 2.6. POSIX.1-2001.

## SEE ALSO

[**clock\_gettime**(2)](/clock_gettime/2.md), [**timer\_create**(2)](/timer_create/2.md), [**timer\_getoverrun**(2)](/timer_getoverrun/2.md), [**timer\_settime**(2)](/timer_settime/2.md), [**time**(7)](/time/7.md)