aboutsummaryrefslogtreecommitdiffstats
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)