man/man2/alarm.2

   1 .\" Copyright (c) 1980 Regents of the University of California.
   2 .\" All rights reserved.  The Berkeley software License Agreement
   3 .\" specifies the terms and conditions for redistribution.
   4 .\"
   5 .\"     @(#)alarm.3c    6.3 (Berkeley) 5/27/86
   6 .\"
   7 .TH ALARM 2  "May 27, 1986"
   8 .UC 4
   9 .SH NAME
  10 alarm \- schedule signal after specified time
  11 .SH SYNOPSIS
  12 .nf
  13 .ft B
  14 #include <unistd.h>
  15
  16 unsigned int alarm(unsigned int \fIseconds\fP)
  17 .ft R
  18 .fi
  19 .SH DESCRIPTION
  20 .B Alarm
  21 causes signal SIGALRM, see
  22 .BR sigaction (2),
  23 to be sent to the invoking process
  24 in a number of seconds given by the argument.
  25 Unless caught or ignored, the signal terminates the process.
  26 .PP
  27 Alarm requests are not stacked; successive calls reset the alarm clock.
  28 If the argument is 0, any alarm request is canceled.
  29 Because of scheduling delays,
  30 resumption of execution of when the signal is
  31 caught may be delayed an arbitrary amount.
  32 .PP
  33 The return value is the amount of time previously remaining in the alarm clock.
  34 .SH "SEE ALSO"
  35 .BR pause (2),
  36 .BR sigsuspend (2),
  37 .BR sigaction (2),
  38 .BR sleep (3).