/usr/share/perl5/Net/Server/SIG.pm is in libnet-server-perl 0.99-3.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 | # -*- perl -*-
#
# Net::Server::SIG - Safer signals
#
# $Id: SIG.pm,v 1.4 2007/02/03 05:55:23 rhandom Exp $
#
# Copyright (C) 2001-2007
#
# Paul Seamons
# paul@seamons.com
# http://seamons.com/
#
# This package may be distributed under the terms of either the
# GNU General Public License
# or the
# Perl Artistic License
#
# All rights reserved.
#
################################################################
package Net::Server::SIG;
use strict;
use vars qw($VERSION @ISA @EXPORT_OK
%_SIG %_SIG_SUB);
use Exporter ();
$VERSION = '0.01';
### fall back to parent methods
@ISA = qw(Exporter);
@EXPORT_OK = qw(register_sig unregister_sig check_sigs);
sub register_sig {
die 'Usage: register_sig( SIGNAME => \&code_ref )' if @_ % 2;
if( @_ > 2 ){
register_sig(shift(),shift()) while @_;
return;
}
my $sig = shift;
my $code_ref = shift;
my $ref = ref($code_ref);
if( ! $ref ){
if( $code_ref eq 'DEFAULT' ){
delete $_SIG{$sig};
delete $_SIG_SUB{$sig};
$SIG{$sig} = 'DEFAULT';
}elsif( $code_ref eq 'IGNORE' ){
delete $_SIG{$sig};
delete $_SIG_SUB{$sig};
$SIG{$sig} = 'IGNORE';
}else{
die "Scalar argument limited to \"DEFAULT\" and \"IGNORE\".";
}
}elsif( $ref eq 'CODE' ){
$_SIG{$sig} = 0;
$_SIG_SUB{$sig} = $code_ref;
$SIG{$sig} = sub{ $Net::Server::SIG::_SIG{$_[0]} = 1; };
}else{
die "Unsupported sig type -- must be 'DEFAULT' or a code ref.";
}
}
### ui sub
sub unregister_sig {
register_sig(shift(),'DEFAULT');
}
sub check_sigs {
# print "Checking signals\n";
my @found = ();
foreach (keys %_SIG){
next unless $_SIG{$_};
$_SIG{$_} = 0;
push @found, $_;
&{ $_SIG_SUB{$_} }($_);
}
return @found;
}
1;
=head1 NAME
Net::Server::SIG - adpf - Safer signal handling
=head1 SYNOPSIS
use Net::Server::SIG qw(register_sig check_sigs);
use IO::Select ();
use POSIX qw(WNOHANG);
my $select = IO::Select->new();
register_sig(PIPE => 'IGNORE',
HUP => 'DEFAULT',
USR1 => sub { print "I got a SIG $_[0]\n"; },
USR2 => sub { print "I got a SIG $_[0]\n"; },
CHLD => sub { 1 while (waitpid(-1, WNOHANG) > 0); },
);
### add some handles to the select
$select->add(\*STDIN);
### loop forever trying to stay alive
while ( 1 ){
### do a timeout to see if any signals got passed us
### while we were processing another signal
my @fh = $select->can_read(10);
my $key;
my $val;
### this is the handler for safe (fine under unsafe also)
if( &check_sigs() ){
# or my @sigs = &check_sigs();
next unless @fh;
}
my $handle = $fh[@fh];
### do something with the handle
}
=head1 DESCRIPTION
Signals in Perl 5 are unsafe. Some future releases may be
able to fix some of this (ie Perl 5.8 or 6.0), but it would
be nice to have some safe, portable signal handling now.
Clarification - much of the time, signals are safe enough.
However, if the program employs forking or becomes a daemon
which can receive many simultaneous signals, then the
signal handling of Perl is normally not sufficient for the
task.
Using a property of the select() function, Net::Server::SIG
attempts to fix the unsafe problem. If a process is blocking on
select() any signal will short circuit the select. Using
this concept, Net::Server::SIG does the least work possible (changing
one bit from 0 to 1). And depends upon the actual processing
of the signals to take place immediately after the the select
call via the "check_sigs" function. See the example shown
above and also see the sigtest.pl script located in the examples
directory of this distribution.
=head1 FUNCTIONS
=over 4
=item C<register_sig($SIG =E<gt> \&code_ref)>
Takes key/value pairs where the key is the signal name, and the
argument is either a code ref, or the words 'DEFAULT' or
'IGNORE'. The function register_sig must be used in
conjunction with check_sigs, and with a blocking select() function
call -- otherwise, you will observe the registered signal
mysteriously vanish.
=item C<unregister_sig($SIG)>
Takes the name of a signal as an argument. Calls register_sig
with a this signal name and 'DEFAULT' as arguments (same as
register_sig(SIG,'DEFAULT')
=item C<check_sigs()>
Checks to see if any registered signals have occured. If so, it
will play the registered code ref for that signal. Return value
is array containing any SIGNAL names that had occured.
=back
=head1 AUTHORS
Paul Seamons (paul@seamons.com)
Rob B Brown (rob@roobik.com) - Provided a sounding board and feedback
in creating Net::Server::SIG and sigtest.pl.
=head1 LICENSE
This package may be distributed under the terms of either the
GNU General Public License
or the
Perl Artistic License
All rights reserved.
=cut
|