aboutsummaryrefslogtreecommitdiffstats
path: root/README
blob: 92848e7ae4ade1aac6037692073ac76713d1ceb8 (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 [ARGS...]

DESCRIPTION
	Schedules an alarm(3) to best triggered after a specified
	DURATION. The process than execvp(3) into COMMAND ARGS.

	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)