man2/timer_delete.2

   1 .\" Copyright (c) 2009 Linux Foundation, written by Michael Kerrisk
   2 .\"     <mtk.manpages@gmail.com>
   3 .\"
   4 .\" SPDX-License-Identifier: Linux-man-pages-copyleft
   5 .\"
   6 .TH TIMER_DELETE 2 2021-03-22 "Linux man-pages (unreleased)" "Linux Programmer's Manual"
   7 .SH NAME
   8 timer_delete \- delete a POSIX per-process timer
   9 .SH LIBRARY
  10 Real-time library
  11 .RI ( librt ", " \-lrt )
  12 .SH SYNOPSIS
  13 .nf
  14 .B  #include <time.h>
  15 .PP
  16 .BI "int timer_delete(timer_t " timerid );
  17 .fi
  18 .PP
  19 .RS -4
  20 Feature Test Macro Requirements for glibc (see
  21 .BR feature_test_macros (7)):
  22 .RE
  23 .PP
  24 .BR timer_delete ():
  25 .nf
  26     _POSIX_C_SOURCE >= 199309L
  27 .fi
  28 .SH DESCRIPTION
  29 .BR timer_delete ()
  30 deletes the timer whose ID is given in
  31 .IR timerid .
  32 If the timer was armed at the time of this call,
  33 it is disarmed before being deleted.
  34 The treatment of any pending signal generated by the deleted timer
  35 is unspecified.
  36 .SH RETURN VALUE
  37 On success,
  38 .BR timer_delete ()
  39 returns 0.
  40 On failure, \-1 is returned, and
  41 .I errno
  42 is set to indicate the error.
  43 .SH ERRORS
  44 .TP
  45 .B EINVAL
  46 .I timerid
  47 is not a valid timer ID.
  48 .SH VERSIONS
  49 This system call is available since Linux 2.6.
  50 .SH STANDARDS
  51 POSIX.1-2001, POSIX.1-2008.
  52 .SH SEE ALSO
  53 .BR clock_gettime (2),
  54 .BR timer_create (2),
  55 .BR timer_getoverrun (2),
  56 .BR timer_settime (2),
  57 .BR time (7)