aboutsummaryrefslogblamecommitdiffstats
path: root/README
blob: 9d7b24077dc652cec53a85456ab80df1217110cf (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 [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)