aboutsummaryrefslogtreecommitdiffstats
path: root/alarm.1
blob: c9634257204699667c4363347bec61395d85d7af (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
.TH ALARM 1 ALARM
.SH NAME
alarm - Schedule an alarm for a program when starting it
.SH SYNOPSIS
.BR alarm
.IR duration
.IR command
.RI [ argument \ ...]
.SH DESCRIPTION
Schedules an
.BR alarm (3)
to best triggered after a specified
.IR duration .
The process than
.BR execvp (3)
into
.IR command .
.PP
This means that
.IR command
will be killed by
.BR SIGALRM
after a selected
.IR duration .
.PP
.IR duration
must be a non-negative integer, no larger than 18h12m15s.
Recognised patterns for
.IR duration
are:
.TP
*
.IR seconds [s]
.TP
*
.IR minutes m[ seconds s]
.TP
*
.IR hours h[ minutes m][ seconds s]
.SH RATIONALE
This program is useful when testing programs for a limited
duration. Especially when running in the background, or
there is a chance of it locking the computer.
.SH "SEE ALSO"
.BR alarm (3)
.SH AUTHORS
Mattias Andrée
.RI < m@maandree.se >