Return to alarm.3 CVS log

Up to [CSRG BSD Unix] / 43BSDReno / lib / libc / gen

BSD 4.3reno

.\" Copyright (c) 1980 Regents of the University of California.
.\" All rights reserved.  The Berkeley software License Agreement
.\" specifies the terms and conditions for redistribution.
.\"
.\"	@(#)alarm.3	6.3 (Berkeley) 5/27/86
.\"
.TH ALARM 3C  "May 27, 1986"
.UC 4
.SH NAME
alarm \- schedule signal after specified time
.SH SYNOPSIS
.nf
.B alarm(seconds)
.B unsigned seconds;
.fi
.SH DESCRIPTION
.ft B
This interface is made obsolete by setitimer(2).
.ft R
.PP
.I Alarm
causes signal SIGALRM, see
.IR sigvec (2),
to be sent to the invoking process
in a number of seconds given by the argument.
Unless caught or ignored, the signal terminates the process.
.PP
Alarm requests are not stacked; successive calls reset the alarm clock.
If the argument is 0, any alarm request is canceled.
Because of scheduling delays,
resumption of execution of when the signal is
caught may be delayed an arbitrary amount.
The longest specifiable delay time is 2147483647 seconds.
.PP
The return value is the amount of time previously remaining in the alarm clock.
.SH "SEE ALSO"
sigpause(2), sigvec(2), signal(3C), sleep(3), ualarm(3), usleep(3)

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.