blib/lib/POE/Loop/PerlSignals.pm

filter: Statementstmt 98.1% 54 / 55 Branchbran 100% 10 / 10 Conditioncond 83.3% 5 / 6 MC/DCmcdc 75.0% 3 / 4 Subroutinesub 100% 13 / 13 Podpod 0.0% 0 / 3 totaltotal 93.4% 85 / 91 CC 9 SCAR 9.7
CC
9
Cov
97%
loop_ignore_signal
5.0
loop_watch_signal
4.0
loop_ignore_all_signals
2.1
CRAP 2.6
« blib/lib/POE/Filter/RecordBlock.pm ↑ Summary blib/lib/POE/Filter.pm »
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
BranchTrueFalseTotal
if ($signal eq "CHLD" or $signal eq "CLD") 205 16 221
Condition66%2/3
$signal eq "CHLD" or $signal eq "CLD"
l!l&&r!l&&!r
205016
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"
ABresult
1X1
011
000
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
BranchTrueFalseTotal
if ($signal eq "PIPE") 4 12 16
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
BranchTrueFalseTotal
if ($signal eq "CHLD" or $signal eq "CLD") 1165 6601 7766
Condition100%3/3
$signal eq "CHLD" or $signal eq "CLD"
l!l&&r!l&&!r
6704956601
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"
ABresult
1X1
011
000
132 1165 if ( USE_SIGCHLD ) {
133 1165 ▶ if ($self->_data_sig_kernel_awaits_pids()) {
Branch: 1 branch
BranchTrueFalseTotal
if ($self->_data_sig_kernel_awaits_pids) 3 1188 1191
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
BranchTrueFalseTotal
if ($signal eq "PIPE") 496 7230 7726
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__
« blib/lib/POE/Filter/RecordBlock.pm ↑ Summary blib/lib/POE/Filter.pm »