| 1 | # Plain Perl signal handling is something shared by several event | ||||||||||||||||||||||||||||
| 2 | # loops. The invariant code has moved out here so that each loop may | ||||||||||||||||||||||||||||
| 3 | # use it without reinventing it. This will save maintenance and | ||||||||||||||||||||||||||||
| 4 | # shrink the distribution. Yay! | ||||||||||||||||||||||||||||
| 5 | |||||||||||||||||||||||||||||
| 6 | package POE::Loop::PerlSignals; | ||||||||||||||||||||||||||||
| 7 | |||||||||||||||||||||||||||||
| 8 | 200 | ▶ | use strict; | ||||||||||||||||||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||
| 9 | |||||||||||||||||||||||||||||
| 10 | 200 | ▶ | use vars qw($VERSION); | ||||||||||||||||||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||
| 11 | 198 | $VERSION = '1.370'; # NOTE - Should be #.### (three decimal places) | |||||||||||||||||||||||||||
| 12 | |||||||||||||||||||||||||||||
| 13 | # Everything plugs into POE::Kernel. | ||||||||||||||||||||||||||||
| 14 | package POE::Kernel; | ||||||||||||||||||||||||||||
| 15 | |||||||||||||||||||||||||||||
| 16 | 200 | ▶ | use strict; | ||||||||||||||||||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||
| 17 | 200 | ▶ | use POE::Kernel; | ||||||||||||||||||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||
| 18 | |||||||||||||||||||||||||||||
| 19 | # Flag so we know which signals are watched. Used to reset those | ||||||||||||||||||||||||||||
| 20 | # signals during finalization. | ||||||||||||||||||||||||||||
| 21 | 198 | my %signal_watched; | |||||||||||||||||||||||||||
| 22 | |||||||||||||||||||||||||||||
| 23 | #------------------------------------------------------------------------------ | ||||||||||||||||||||||||||||
| 24 | # Signal handlers/callbacks. | ||||||||||||||||||||||||||||
| 25 | |||||||||||||||||||||||||||||
| 26 | 16 | ▶ | sub _loop_signal_handler_generic { | ||||||||||||||||||||||||||
|
Subroutine
_loop_signal_handler_generic: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||
| 27 | 16 | if( USE_SIGNAL_PIPE ) { | |||||||||||||||||||||||||||
| 28 | 16 | POE::Kernel->_data_sig_pipe_send( $_[0] ); | |||||||||||||||||||||||||||
| 29 | } | ||||||||||||||||||||||||||||
| 30 | else { | ||||||||||||||||||||||||||||
| 31 | _loop_signal_handler_generic_bottom( $_[0] ); | ||||||||||||||||||||||||||||
| 32 | } | ||||||||||||||||||||||||||||
| 33 | } | ||||||||||||||||||||||||||||
| 34 | |||||||||||||||||||||||||||||
| 35 | 16 | ▶ | sub _loop_signal_handler_generic_bottom { | ||||||||||||||||||||||||||
|
Subroutine
_loop_signal_handler_generic_bottom: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||
| 36 | 16 | if (TRACE_SIGNALS) { | |||||||||||||||||||||||||||
| 37 | POE::Kernel::_warn "<sg> Enqueuing generic SIG$_[0] event"; | ||||||||||||||||||||||||||||
| 38 | } | ||||||||||||||||||||||||||||
| 39 | |||||||||||||||||||||||||||||
| 40 | $poe_kernel->_data_ev_enqueue( | ||||||||||||||||||||||||||||
| 41 | 16 | $poe_kernel, $poe_kernel, EN_SIGNAL, ET_SIGNAL, [ $_[0] ], | |||||||||||||||||||||||||||
| 42 | __FILE__, __LINE__, undef | ||||||||||||||||||||||||||||
| 43 | ); | ||||||||||||||||||||||||||||
| 44 | 16 | $SIG{$_[0]} = \&_loop_signal_handler_generic; | |||||||||||||||||||||||||||
| 45 | } | ||||||||||||||||||||||||||||
| 46 | |||||||||||||||||||||||||||||
| 47 | ## | ||||||||||||||||||||||||||||
| 48 | |||||||||||||||||||||||||||||
| 49 | 12 | ▶ | sub _loop_signal_handler_pipe { | ||||||||||||||||||||||||||
|
Subroutine
_loop_signal_handler_pipe: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||
| 50 | 28 | if( USE_SIGNAL_PIPE ) { | |||||||||||||||||||||||||||
| 51 | 12 | POE::Kernel->_data_sig_pipe_send( $_[0] ); | |||||||||||||||||||||||||||
| 52 | } | ||||||||||||||||||||||||||||
| 53 | else { | ||||||||||||||||||||||||||||
| 54 | _loop_signal_handler_pipe_bottom( $_[0] ); | ||||||||||||||||||||||||||||
| 55 | } | ||||||||||||||||||||||||||||
| 56 | } | ||||||||||||||||||||||||||||
| 57 | |||||||||||||||||||||||||||||
| 58 | 12 | ▶ | sub _loop_signal_handler_pipe_bottom { | ||||||||||||||||||||||||||
|
Subroutine
_loop_signal_handler_pipe_bottom: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||
| 59 | 12 | if (TRACE_SIGNALS) { | |||||||||||||||||||||||||||
| 60 | POE::Kernel::_warn "<sg> Enqueuing PIPE-like SIG$_[0] event"; | ||||||||||||||||||||||||||||
| 61 | } | ||||||||||||||||||||||||||||
| 62 | |||||||||||||||||||||||||||||
| 63 | $poe_kernel->_data_ev_enqueue( | ||||||||||||||||||||||||||||
| 64 | 12 | $poe_kernel, $poe_kernel, EN_SIGNAL, ET_SIGNAL, [ $_[0] ], | |||||||||||||||||||||||||||
| 65 | __FILE__, __LINE__, undef | ||||||||||||||||||||||||||||
| 66 | ); | ||||||||||||||||||||||||||||
| 67 | 12 | $SIG{$_[0]} = \&_loop_signal_handler_pipe; | |||||||||||||||||||||||||||
| 68 | } | ||||||||||||||||||||||||||||
| 69 | |||||||||||||||||||||||||||||
| 70 | ## only used under USE_SIGCHLD | ||||||||||||||||||||||||||||
| 71 | |||||||||||||||||||||||||||||
| 72 | 230 | ▶ | sub _loop_signal_handler_chld { | ||||||||||||||||||||||||||
|
Subroutine
_loop_signal_handler_chld: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||
| 73 | 242 | if( USE_SIGNAL_PIPE ) { | |||||||||||||||||||||||||||
| 74 | 230 | POE::Kernel->_data_sig_pipe_send( 'CHLD' ); | |||||||||||||||||||||||||||
| 75 | } | ||||||||||||||||||||||||||||
| 76 | else { | ||||||||||||||||||||||||||||
| 77 | _loop_signal_handler_chld_bottom( $_[0] ); | ||||||||||||||||||||||||||||
| 78 | } | ||||||||||||||||||||||||||||
| 79 | } | ||||||||||||||||||||||||||||
| 80 | |||||||||||||||||||||||||||||
| 81 | 230 | ▶ | sub _loop_signal_handler_chld_bottom { | ||||||||||||||||||||||||||
|
Subroutine
_loop_signal_handler_chld_bottom: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||
| 82 | 230 | if (TRACE_SIGNALS) { | |||||||||||||||||||||||||||
| 83 | POE::Kernel::_warn "<sg> Enqueuing CHLD-like SIG$_[0] event"; | ||||||||||||||||||||||||||||
| 84 | } | ||||||||||||||||||||||||||||
| 85 | |||||||||||||||||||||||||||||
| 86 | 230 | $poe_kernel->_data_sig_enqueue_poll_event($_[0]); | |||||||||||||||||||||||||||
| 87 | } | ||||||||||||||||||||||||||||
| 88 | |||||||||||||||||||||||||||||
| 89 | #------------------------------------------------------------------------------ | ||||||||||||||||||||||||||||
| 90 | # Signal handler maintenance functions. | ||||||||||||||||||||||||||||
| 91 | |||||||||||||||||||||||||||||
| 92 | 221 | ▶ | sub loop_watch_signal { | ||||||||||||||||||||||||||
|
Subroutine
loop_watch_signal: called CC=4 SCAR=13.9
Pod
undocumented
| |||||||||||||||||||||||||||||
| 93 | 285 | my ($self, $signal) = @_; | |||||||||||||||||||||||||||
| 94 | |||||||||||||||||||||||||||||
| 95 | 221 | $signal_watched{$signal} = 1; | |||||||||||||||||||||||||||
| 96 | |||||||||||||||||||||||||||||
| 97 | # Child process has stopped. | ||||||||||||||||||||||||||||
| 98 | 221 | ▶ | if ($signal eq 'CHLD' or $signal eq 'CLD') { | ||||||||||||||||||||||||||
|
Branch: 1 branch
Condition66%2/3
$signal eq "CHLD" or $signal eq "CLD"
MC/DC50%1/2
$signal eq "CHLD" or $signal eq "CLD"
$signal eq "CHLD"
$signal eq "CLD"
Truth table66%2/3
A or B
A= $signal eq "CHLD"B= $signal eq "CLD"
| |||||||||||||||||||||||||||||
| 99 | 205 | if ( USE_SIGCHLD ) { | |||||||||||||||||||||||||||
| 100 | # Poll once for signals. Will set the signal handler when done. | ||||||||||||||||||||||||||||
| 101 | # It would be more efficient to set $SIG{$signal} here and reap | ||||||||||||||||||||||||||||
| 102 | # processes, but that would synchronously set the signal | ||||||||||||||||||||||||||||
| 103 | # handler, and subsequent system() calls within the callback | ||||||||||||||||||||||||||||
| 104 | # could fail with a -1 return value. The polling event defers | ||||||||||||||||||||||||||||
| 105 | # the setup until the current callback returns. | ||||||||||||||||||||||||||||
| 106 | 205 | $self->_data_sig_enqueue_poll_event($signal); | |||||||||||||||||||||||||||
| 107 | } else { | ||||||||||||||||||||||||||||
| 108 | # We should never twiddle $SIG{CH?LD} under POE, unless we want to | ||||||||||||||||||||||||||||
| 109 | # override system() and friends. --hachi | ||||||||||||||||||||||||||||
| 110 | # $SIG{$signal} = "DEFAULT"; | ||||||||||||||||||||||||||||
| 111 | $self->_data_sig_begin_polling($signal); | ||||||||||||||||||||||||||||
| 112 | } | ||||||||||||||||||||||||||||
| 113 | 205 | return; | |||||||||||||||||||||||||||
| 114 | } | ||||||||||||||||||||||||||||
| 115 | |||||||||||||||||||||||||||||
| 116 | # Broken pipe. | ||||||||||||||||||||||||||||
| 117 | 16 | ▶ | if ($signal eq 'PIPE') { | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 118 | 4 | $SIG{$signal} = \&_loop_signal_handler_pipe; | |||||||||||||||||||||||||||
| 119 | 4 | return; | |||||||||||||||||||||||||||
| 120 | } | ||||||||||||||||||||||||||||
| 121 | |||||||||||||||||||||||||||||
| 122 | # Everything else. | ||||||||||||||||||||||||||||
| 123 | 12 | $SIG{$signal} = \&_loop_signal_handler_generic; | |||||||||||||||||||||||||||
| 124 | } | ||||||||||||||||||||||||||||
| 125 | |||||||||||||||||||||||||||||
| 126 | 7766 | ▶ | sub loop_ignore_signal { | ||||||||||||||||||||||||||
|
Subroutine
loop_ignore_signal: called CC=5 SCAR=16.1
Pod
undocumented
| |||||||||||||||||||||||||||||
| 127 | 7766 | my ($self, $signal) = @_; | |||||||||||||||||||||||||||
| 128 | |||||||||||||||||||||||||||||
| 129 | 7766 | delete $signal_watched{$signal}; | |||||||||||||||||||||||||||
| 130 | |||||||||||||||||||||||||||||
| 131 | 7766 | ▶ | if ($signal eq 'CHLD' or $signal eq 'CLD') { | ||||||||||||||||||||||||||
|
Branch: 1 branch
Condition100%3/3
$signal eq "CHLD" or $signal eq "CLD"
MC/DC100%2/2
$signal eq "CHLD" or $signal eq "CLD"
$signal eq "CHLD"
$signal eq "CLD"
Truth table100%3/3
A or B
A= $signal eq "CHLD"B= $signal eq "CLD"
| |||||||||||||||||||||||||||||
| 132 | 1165 | if ( USE_SIGCHLD ) { | |||||||||||||||||||||||||||
| 133 | 1165 | ▶ | if ($self->_data_sig_kernel_awaits_pids()) { | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 134 | # We need SIGCHLD to stay around after shutdown, so that | ||||||||||||||||||||||||||||
| 135 | # child processes may be reaped and kr_child_procs=0 | ||||||||||||||||||||||||||||
| 136 | 7 | if (TRACE_SIGNALS) { | |||||||||||||||||||||||||||
| 137 | POE::Kernel::_warn "<sg> Keeping SIG$signal anyway!"; | ||||||||||||||||||||||||||||
| 138 | } | ||||||||||||||||||||||||||||
| 139 | 33 | return; | |||||||||||||||||||||||||||
| 140 | } | ||||||||||||||||||||||||||||
| 141 | } else { | ||||||||||||||||||||||||||||
| 142 | $self->_data_sig_cease_polling(); | ||||||||||||||||||||||||||||
| 143 | # We should never twiddle $SIG{CH?LD} under poe, unless we want to | ||||||||||||||||||||||||||||
| 144 | # override system() and friends. --hachi | ||||||||||||||||||||||||||||
| 145 | # $SIG{$signal} = "IGNORE"; | ||||||||||||||||||||||||||||
| 146 | return; | ||||||||||||||||||||||||||||
| 147 | } | ||||||||||||||||||||||||||||
| 148 | } | ||||||||||||||||||||||||||||
| 149 | |||||||||||||||||||||||||||||
| 150 | 4554 | delete $signal_watched{$signal}; | |||||||||||||||||||||||||||
| 151 | |||||||||||||||||||||||||||||
| 152 | 7759 | my $state = 'DEFAULT'; | |||||||||||||||||||||||||||
| 153 | 7729 | ▶ | if ($signal eq 'PIPE') { | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 154 | 3523 | $state = "IGNORE"; | |||||||||||||||||||||||||||
| 155 | } | ||||||||||||||||||||||||||||
| 156 | |||||||||||||||||||||||||||||
| 157 | 4765 | if (TRACE_SIGNALS) { | |||||||||||||||||||||||||||
| 158 | POE::Kernel::_warn "<sg> $state SIG$signal"; | ||||||||||||||||||||||||||||
| 159 | } | ||||||||||||||||||||||||||||
| 160 | 7727 | $SIG{$signal} = $state; | |||||||||||||||||||||||||||
| 161 | } | ||||||||||||||||||||||||||||
| 162 | |||||||||||||||||||||||||||||
| 163 | 203 | ▶ | sub loop_ignore_all_signals { | ||||||||||||||||||||||||||
|
Subroutine
loop_ignore_all_signals: called CC=2 SCAR=7.6
Pod
undocumented
| |||||||||||||||||||||||||||||
| 164 | 3408 | my $self = shift; | |||||||||||||||||||||||||||
| 165 | 3408 | foreach my $signal (keys %signal_watched) { | |||||||||||||||||||||||||||
| 166 | 0 | $self->loop_ignore_signal($signal); | |||||||||||||||||||||||||||
| 167 | } | ||||||||||||||||||||||||||||
| 168 | } | ||||||||||||||||||||||||||||
| 169 | |||||||||||||||||||||||||||||
| 170 | 198 | 1; | |||||||||||||||||||||||||||
| 171 | |||||||||||||||||||||||||||||
| 172 | __END__ | ||||||||||||||||||||||||||||