Sys::AlarmCall 1.2

Sys::AlarmCall is a package to handle the logic in timing out calls with alarm() and an ALRM handler, allowing nested calls as well.

SYNOPSIS

use Sys::AlarmCall;

$result = alarm_call($timeout1,$func1,@args1);
@result = alarm_call($timeout2,$func2,@args2);

Sys::AlarmCall provides a straightforward function call to use the alarm handler. It also handles the logic which allows nested time out calls if timeout calls are run thorugh the alarm_call() functions.

The main advantages of Sys::AlarmCall are that:

1. simple calls, e.g.

@result = &func(@args); #Normal function call with &
$result = func(@args);; #Normal function call
@result = &$code_reference(@args);
@result = $obj->func(@args); #Object method call

become simple calls:

@result = alarm_call($timeout,&func,@args);
$result = alarm_call($timeout,func,@args);
@result = alarm_call($timeout,$code_reference,@args);
@result = alarm_call($timeout,->func,$obj,@args);