aboutsummaryrefslogtreecommitdiffstats
path: root/README
blob: 9d7b24077dc652cec53a85456ab80df1217110cf (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
NAME
	alarm - Schedule an alarm for a program when starting it

SYNOPSIS
	alarm duration command [argument...]

DESCRIPTION
	Schedules an alarm(3) to best triggered after a specified
	duration. The process than execvp(3) into command.

	This means that command will be killed by SIGALRM after
	a selected duration.

	duration must be a non-negative integer, no larger
	than 18h12m15s. Recognised patterns for duration are:
	*	seconds[s]
	*	minutesm[secondss]
	*	hoursh[minutesm][secondss]

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.

SEE ALSO
	alarm(3)