Perl in a Nutshell

Perl in a NutshellSearch this book
Previous: 8.130 ShellChapter 8
Standard Modules
Next: 8.132 Socket
 

8.131 sigtrap

Pragma to enable simple signal handling. Provides two signal handlers that can be installed, or you can install your own handler; also provides options to specify which signals to trap. Ignores requests to trap signals not used in your system's architecture.

use sigtrap;               # initialize default signal handlers
use sigtrap qw(die normal-signals);
use sigtrap 'handler' => \handlername, 'normal-signals';
use sigtrap qw(handler handlername normal-signals
               stack-trace error-signals);

8.131.1 Signal Handler Options

Used to specify which handler is to be installed and used for signals installed after the handler:

die

Installs handler that dies with a message indicating what signal was trapped.

handler handlername

Installs your handler handlername.

stack-trace

Default signal handler. Outputs stack trace to STDERR and tries to dump core.

8.131.2 Signal List Options

You can specify your own list of options:

use sigtrap qw(BUS SEGV PIPE ABRT);
or use one of the following built-in option lists:

error-signals

Signals that indicate a serious problem: ABRT, BUS, EMT, FPE, ILL, QUIT, SEGV, SYS, and TRAP.

normal-signals

Signals a program is most likely to encounter: HUP, INT, PIPE, and TERM.

old-interface-signals

Default. Signals trapped by default in older versions of sigtrap: ABRT, BUS, EMT, FPE, ILL, PIPE, QUIT, SEGV, SYS, TERM, and TRAP.

8.131.3 Other Options

any

Installs handlers only for subsequently listed signals that aren't already taken care of.

number

Requires that the version of sigtrap being used must be at least number.

signal

Installs a handler for any argument that looks like a signal name.

untrapped

Installs handlers only for subsequently listed signals not already trapped or ignored.


Previous: 8.130 ShellPerl in a NutshellNext: 8.132 Socket
8.130 ShellBook Index8.132 Socket