1 # File: Stem/Event/Perl.pm
3 # This file is part of Stem.
4 # Copyright (C) 1999, 2000, 2001 Stem Systems, Inc.
6 # Stem is free software; you can redistribute it and/or modify
7 # it under the terms of the GNU General Public License as published by
8 # the Free Software Foundation; either version 2 of the License, or
9 # (at your option) any later version.
11 # Stem is distributed in the hope that it will be useful,
12 # but WITHOUT ANY WARRANTY; without even the implied warranty of
13 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 # GNU General Public License for more details.
16 # You should have received a copy of the GNU General Public License
17 # along with Stem; if not, write to the Free Software
18 # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
20 # For a license to use the Stem under conditions other than those
21 # described here, to purchase support for this software, or to purchase a
22 # commercial warranty contract, please contact Stem Systems at:
24 # Stem Systems, Inc. 781-643-7504
25 # 79 Everett St. info@stemsystems.com
29 =head1 Stem::Event::Perl
31 This module is a pure Perl event loop. It requires Perl 5.8 (or
32 better) which has safe signal handling. It provides the common event
33 API for the standard classes:
37 package Stem::Event::Perl ;
38 our @ISA = qw( Stem::Event ) ;
41 use Stem::Event::Signal ;
45 unless ( eval { require Time::HiRes } ) {
47 Time::HiRes->import( qw( time ) ) ;
51 # get the hashes for each of the event types
53 my ( $signal_events, $timer_events, $read_events, $write_events ) =
54 map scalar( Stem::Event::_get_events( $_ )), qw( signal timer
59 #print "PERL START\n" ;
61 while( keys %{$timer_events} ||
62 keys %{$signal_events} ||
63 keys %{$read_events} ||
64 keys %{$write_events} ) {
66 my $timeout = find_min_delay() ;
68 #print "TIMEOUT [$timeout]\n" ;
72 _one_time_loop( $timeout ) ;
74 my $delta_time = time() - $time ;
75 trigger_timer_events( $delta_time ) ;
83 # force a no wait select call if no timeout was passed in
87 #print "ONE TIME $timeout\n" ;
88 # use Carp qw( cluck ) ;
91 # print "\n\n********EVENT LOOP\n\n" ;
92 # print "READ EVENTS\n", map $_->dump(), values %{$read_events} ;
93 # print "WRITE EVENTS\n", map $_->dump(), values %{$write_events} ;
95 my $read_vec = make_select_vec( $read_events ) ;
96 my $write_vec = make_select_vec( $write_events ) ;
98 #print "R BEFORE ", unpack( 'b*', $read_vec), "\n" ;
99 #print "W BEFORE ", unpack( 'b*', $write_vec), "\n" ;
102 my $cnt = select( $read_vec, $write_vec, undef, $timeout ) ;
104 #print "SEL CNT [$cnt]\n" ;
105 #print "R AFTER ", unpack( 'b*', $read_vec), "\n" ;
106 #print "W AFTER ", unpack( 'b*', $write_vec), "\n" ;
108 trigger_select_vec( 'read', $read_events, $read_vec ) ;
109 trigger_select_vec( 'write', $write_events, $write_vec, ) ;
111 #print "\n\n********END EVENT LOOP\n\n" ;
117 $_->cancel() for values %{$signal_events},
118 values %{$timer_events},
119 values %{$read_events},
120 values %{$write_events} ;
127 while( my( undef, $event ) = each %{$timer_events} ) {
129 if ( $event->{'time_left'} < $min_delay || $min_delay == 0 ) {
131 $min_delay = $event->{'time_left'} ;
133 #print "MIN [$min_delay]\n" ;
137 return unless $min_delay ;
142 sub trigger_timer_events {
146 #print "TIMER DELTA $delta\n" ;
148 while( my( undef, $event ) = each %{$timer_events} ) {
150 #print $event->dump() ;
152 next unless $event->{'active'} ;
154 next unless ( $event->{'time_left'} -= $delta ) <= 0 ;
156 $event->timer_triggered() ;
160 sub make_select_vec {
162 my( $io_events ) = @_ ;
164 my $select_vec = '' ;
166 while( my( undef, $event ) = each %{$io_events} ) {
168 #print "make F: [", fileno $event->{'fh'}, "] ACT [$event->{'active'}]\n" ;
170 unless ( defined fileno $event->{'fh'} ) {
172 #print "BAD FH $event->{'fh'}\n" ;
173 print "\n\n***EVENT BAD FH\n", $event->dump() ;
178 next unless $event->{'active'} ;
179 vec( $select_vec, fileno $event->{'fh'}, 1 ) = 1 ;
185 sub trigger_select_vec {
187 my( $event_type, $io_events, $select_vec ) = @_ ;
189 while( my( undef, $event ) = each %{$io_events} ) {
191 next unless $event->{'active'} ;
192 if ( vec( $select_vec, fileno $event->{'fh'}, 1 ) ) {
201 ############################################################################
203 package Stem::Event::Plain ;
206 # right now we trigger plain events when they are created. this should
207 # change to a queue and trigger after i/o and timer events