aboutsummaryrefslogblamecommitdiffstats
path: root/README
blob: 92848e7ae4ade1aac6037692073ac76713d1ceb8 (plain) (tree)
1
2
3
4
5
6
7
8
9

                                                                
 

                                        
 


                                                                 
 

                                                               
 




                                                             
 






                                                                  
 
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)