perl/Msg.pm

   1 #
   2 # This has been taken from the 'Advanced Perl Programming' book by Sriram Srinivasan
   3 #
   4 # I am presuming that the code is distributed on the same basis as perl itself.
   5 #
   6 # I have modified it to suit my devious purposes (Dirk Koopman G1TLH)
   7 #
   8 #
   9 #
  10
  11 package Msg;
  12
  13 use strict;
  14
  15 use DXUtil;
  16
  17 use IO::Select;
  18 use DXDebug;
  19 use Timer;
  20
  21 use vars qw(%rd_callbacks %wt_callbacks %er_callbacks $rd_handles $wt_handles $er_handles $now %conns $noconns $blocking_supported $cnum $total_in $total_out $io_socket);
  22
  23 %rd_callbacks = ();
  24 %wt_callbacks = ();
  25 %er_callbacks = ();
  26 $rd_handles   = IO::Select->new();
  27 $wt_handles   = IO::Select->new();
  28 $er_handles   = IO::Select->new();
  29 $total_in = $total_out = 0;
  30
  31 $now = time;
  32
  33 BEGIN {
  34     # Checks if blocking is supported
  35     eval {
  36                 local $^W;
  37         require POSIX; POSIX->import(qw(O_NONBLOCK F_SETFL F_GETFL))
  38     };
  39
  40         eval {
  41                 local $^W;
  42                 require IO::Socket::INET6;
  43         };
  44
  45         if ($@) {
  46                 dbg($@);
  47                 require IO::Socket;
  48                 $io_socket = 'IO::Socket::INET';
  49         } else {
  50                 $io_socket = 'IO::Socket::INET6';
  51         }
  52         $io_socket->import;
  53
  54         if ($@ || $main::is_win) {
  55                 $blocking_supported = $io_socket->can('blocking') ? 2 : 0;
  56         } else {
  57                 $blocking_supported = $io_socket->can('blocking') ? 2 : 1;
  58         }
  59
  60
  61         # import as many of these errno values as are available
  62         eval {
  63                 local $^W;
  64                 require Errno; Errno->import(qw(EAGAIN EINPROGRESS EWOULDBLOCK));
  65         };
  66
  67         unless ($^O eq 'MSWin32') {
  68                 if ($] >= 5.6) {
  69                         eval {
  70                                 local $^W;
  71                                 require Socket; Socket->import(qw(IPPROTO_TCP TCP_NODELAY));
  72                         };
  73                 } else {
  74                         dbg("IPPROTO_TCP and TCP_NODELAY manually defined");
  75                         eval 'sub IPPROTO_TCP {     6 };';
  76                         eval 'sub TCP_NODELAY {     1 };';
  77                 }
  78         }
  79         # http://support.microsoft.com/support/kb/articles/Q150/5/37.asp
  80         # defines EINPROGRESS as 10035.  We provide it here because some
  81         # Win32 users report POSIX::EINPROGRESS is not vendor-supported.
  82         if ($^O eq 'MSWin32') {
  83                 eval '*EINPROGRESS = sub { 10036 };' unless defined *EINPROGRESS;
  84                 eval '*EWOULDBLOCK = *EAGAIN = sub { 10035 };' unless defined *EWOULDBLOCK;
  85                 eval '*F_GETFL     = sub {     0 };' unless defined *F_GETFL;
  86                 eval '*F_SETFL     = sub {     0 };' unless defined *F_SETFL;
  87                 eval 'sub IPPROTO_TCP  {     6 };';
  88                 eval 'sub TCP_NODELAY  {     1 };';
  89                 $blocking_supported = 0;   # it appears that this DOESN'T work :-(
  90         }
  91 }
  92
  93 my $w = $^W;
  94 $^W = 0;
  95 my $eagain = eval {EAGAIN()};
  96 my $einprogress = eval {EINPROGRESS()};
  97 my $ewouldblock = eval {EWOULDBLOCK()};
  98 $^W = $w;
  99 $cnum = 0;
 100
 101
 102 #
 103 #-----------------------------------------------------------------
 104 # Generalised initializer
 105
 106 sub new
 107 {
 108     my ($pkg, $rproc) = @_;
 109         my $obj = ref($pkg);
 110         my $class = $obj || $pkg;
 111
 112     my $conn = {
 113         rproc => $rproc,
 114                 inqueue => [],
 115                 outqueue => [],
 116                 state => 0,
 117                 lineend => "\r\n",
 118                 csort => 'telnet',
 119                 timeval => 60,
 120                 blocking => 0,
 121                 cnum => (($cnum < 999) ? (++$cnum) : ($cnum = 1)),
 122     };
 123
 124         $noconns++;
 125
 126         dbg("Connection created ($noconns)") if isdbg('connll');
 127         return bless $conn, $class;
 128 }
 129
 130 sub set_error
 131 {
 132         my $conn = shift;
 133         my $callback = shift;
 134         $conn->{eproc} = $callback;
 135         set_event_handler($conn->{sock}, error => $callback) if exists $conn->{sock};
 136 }
 137
 138 sub set_rproc
 139 {
 140         my $conn = shift;
 141         my $callback = shift;
 142         $conn->{rproc} = $callback;
 143 }
 144
 145 sub blocking
 146 {
 147         return unless $blocking_supported;
 148
 149         # Make the handle stop blocking, the Windows way.
 150         if ($blocking_supported) {
 151                 $_[0]->blocking($_[1]);
 152         } else {
 153                 my $flags = fcntl ($_[0], F_GETFL, 0);
 154                 if ($_[1]) {
 155                         $flags &= ~O_NONBLOCK;
 156                 } else {
 157                         $flags |= O_NONBLOCK;
 158                 }
 159                 fcntl ($_[0], F_SETFL, $flags);
 160         }
 161 }
 162
 163 # save it
 164 sub conns
 165 {
 166         my $pkg = shift;
 167         my $call = shift;
 168         my $ref;
 169
 170         if (ref $pkg) {
 171                 $call = $pkg->{call} unless $call;
 172                 return undef unless $call;
 173                 dbg("changing $pkg->{call} to $call") if isdbg('connll') && exists $pkg->{call} && $call ne $pkg->{call};
 174                 delete $conns{$pkg->{call}} if exists $pkg->{call} && exists $conns{$pkg->{call}} && $pkg->{call} ne $call;
 175                 $pkg->{call} = $call;
 176                 $ref = $conns{$call} = $pkg;
 177                 dbg("Connection $pkg->{cnum} $call stored") if isdbg('connll');
 178         } else {
 179                 $ref = $conns{$call};
 180         }
 181         return $ref;
 182 }
 183
 184 # this is only called by any dependent processes going away unexpectedly
 185 sub pid_gone
 186 {
 187         my ($pkg, $pid) = @_;
 188
 189         my @pid = grep {$_->{pid} == $pid} values %conns;
 190         foreach my $p (@pid) {
 191                 &{$p->{eproc}}($p, "$pid has gorn") if exists $p->{eproc};
 192                 $p->disconnect;
 193         }
 194 }
 195
 196 sub ax25
 197 {
 198         my $conn = shift;
 199         return $conn->{csort} eq 'ax25';
 200 }
 201
 202 sub peerhost
 203 {
 204         my $conn = shift;
 205         $conn->{peerhost} ||= 'ax25' if $conn->ax25;
 206         $conn->{peerhost} ||= $conn->{sock}->peerhost if $conn->{sock} && $conn->{sock}->isa('IO::Socket::INET');
 207         $conn->{peerhost} ||= 'UNKNOWN';
 208         return $conn->{peerhost};
 209 }
 210
 211 #-----------------------------------------------------------------
 212 # Send side routines
 213 sub connect {
 214     my ($pkg, $to_host, $to_port, $rproc) = @_;
 215
 216     # Create a connection end-point object
 217     my $conn = $pkg;
 218         unless (ref $pkg) {
 219                 $conn = $pkg->new($rproc);
 220         }
 221         $conn->{peerhost} = $to_host;
 222         $conn->{peerport} = $to_port;
 223         $conn->{sort} = 'Outgoing';
 224
 225     # Create a new internet socket
 226     my $sock = $io_socket->new();
 227     return undef unless $sock;
 228
 229         my $proto = getprotobyname('tcp');
 230         $sock->socket(AF_INET, SOCK_STREAM, $proto) or return undef;
 231
 232         blocking($sock, 0);
 233         $conn->{blocking} = 0;
 234
 235         # does the host resolve?
 236         my $ip = gethostbyname($to_host);
 237         return undef unless $ip;
 238
 239         my $r = connect($sock, pack_sockaddr_in($to_port, $ip));
 240         return undef unless $r || _err_will_block($!);
 241
 242         $conn->{sock} = $sock;
 243         $conn->{peerhost} = $sock->peerhost;    # for consistency
 244
 245     if ($conn->{rproc}) {
 246         my $callback = sub {$conn->_rcv};
 247         set_event_handler ($sock, read => $callback);
 248     }
 249     return $conn;
 250 }
 251
 252 sub start_program
 253 {
 254         my ($conn, $line, $sort) = @_;
 255         my $pid;
 256
 257         local $^F = 10000;              # make sure it ain't closed on exec
 258         my ($a, $b) = $io_socket->socketpair(AF_UNIX, SOCK_STREAM, PF_UNSPEC);
 259         if ($a && $b) {
 260                 $a->autoflush(1);
 261                 $b->autoflush(1);
 262                 $pid = fork;
 263                 if (defined $pid) {
 264                         if ($pid) {
 265                                 close $b;
 266                                 $conn->{sock} = $a;
 267                                 $conn->{csort} = $sort;
 268                                 $conn->{lineend} = "\cM" if $sort eq 'ax25';
 269                                 $conn->{pid} = $pid;
 270                                 if ($conn->{rproc}) {
 271                                         my $callback = sub {$conn->_rcv};
 272                                         Msg::set_event_handler ($a, read => $callback);
 273                                 }
 274                                 dbg("connect $conn->{cnum}: started pid: $conn->{pid} as $line") if isdbg('connect');
 275                         } else {
 276                                 $^W = 0;
 277                                 dbgclose();
 278                                 STDIN->close;
 279                                 STDOUT->close;
 280                                 STDOUT->close;
 281                                 *STDIN = IO::File->new_from_fd($b, 'r') or die;
 282                                 *STDOUT = IO::File->new_from_fd($b, 'w') or die;
 283                                 *STDERR = IO::File->new_from_fd($b, 'w') or die;
 284                                 close $a;
 285                                 unless ($main::is_win) {
 286                                         #                                               $SIG{HUP} = 'IGNORE';
 287                                         $SIG{HUP} = $SIG{CHLD} = $SIG{TERM} = $SIG{INT} = 'DEFAULT';
 288                                         alarm(0);
 289                                 }
 290                                 exec "$line" or dbg("exec '$line' failed $!");
 291                         }
 292                 } else {
 293                         dbg("cannot fork for $line");
 294                 }
 295         } else {
 296                 dbg("no socket pair $! for $line");
 297         }
 298         return $pid;
 299 }
 300
 301 sub disconnect
 302 {
 303     my $conn = shift;
 304         return if exists $conn->{disconnecting};
 305
 306         $conn->{disconnecting} = 1;
 307     my $sock = delete $conn->{sock};
 308         $conn->{state} = 'E';
 309         $conn->{timeout}->del if $conn->{timeout};
 310
 311         # be careful to delete the correct one
 312         my $call;
 313         if ($call = $conn->{call}) {
 314                 my $ref = $conns{$call};
 315                 delete $conns{$call} if $ref && $ref == $conn;
 316         }
 317         $call ||= 'unallocated';
 318         dbg("Connection $conn->{cnum} $call disconnected") if isdbg('connll');
 319
 320         # get rid of any references
 321         for (keys %$conn) {
 322                 if (ref($conn->{$_})) {
 323                         delete $conn->{$_};
 324                 }
 325         }
 326
 327         if (defined($sock)) {
 328                 set_event_handler ($sock, read => undef, write => undef, error => undef);
 329                 shutdown($sock, 3);
 330                 close($sock);
 331         }
 332
 333         unless ($main::is_win) {
 334                 kill 'TERM', $conn->{pid} if exists $conn->{pid};
 335         }
 336 }
 337
 338 sub send_now {
 339     my ($conn, $msg) = @_;
 340     $conn->enqueue($msg);
 341     $conn->_send (1); # 1 ==> flush
 342 }
 343
 344 sub send_later {
 345     my ($conn, $msg) = @_;
 346     $conn->enqueue($msg);
 347     my $sock = $conn->{sock};
 348     return unless defined($sock);
 349     set_event_handler ($sock, write => sub {$conn->_send(0)});
 350 }
 351
 352 sub enqueue {
 353     my $conn = shift;
 354     push (@{$conn->{outqueue}}, defined $_[0] ? $_[0] : '');
 355 }
 356
 357 sub _send {
 358     my ($conn, $flush) = @_;
 359     my $sock = $conn->{sock};
 360     return unless defined($sock);
 361     my $rq = $conn->{outqueue};
 362
 363     # If $flush is set, set the socket to blocking, and send all
 364     # messages in the queue - return only if there's an error
 365     # If $flush is 0 (deferred mode) make the socket non-blocking, and
 366     # return to the event loop only after every message, or if it
 367     # is likely to block in the middle of a message.
 368
 369 #       if ($conn->{blocking} != $flush) {
 370 #               blocking($sock, $flush);
 371 #               $conn->{blocking} = $flush;
 372 #       }
 373     my $offset = (exists $conn->{send_offset}) ? $conn->{send_offset} : 0;
 374
 375     while (@$rq) {
 376         my $msg            = $rq->[0];
 377                 my $mlth           = length($msg);
 378         my $bytes_to_write = $mlth - $offset;
 379         my $bytes_written  = 0;
 380                 confess("Negative Length! msg: '$msg' lth: $mlth offset: $offset") if $bytes_to_write < 0;
 381         while ($bytes_to_write > 0) {
 382             $bytes_written = syswrite ($sock, $msg,
 383                                        $bytes_to_write, $offset);
 384             if (!defined($bytes_written)) {
 385                 if (_err_will_block($!)) {
 386                     # Should happen only in deferred mode. Record how
 387                     # much we have already sent.
 388                     $conn->{send_offset} = $offset;
 389                     # Event handler should already be set, so we will
 390                     # be called back eventually, and will resume sending
 391                     return 1;
 392                 } else {    # Uh, oh
 393                                         &{$conn->{eproc}}($conn, $!) if exists $conn->{eproc};
 394                                         $conn->disconnect;
 395                     return 0; # fail. Message remains in queue ..
 396                 }
 397             } elsif (isdbg('raw')) {
 398                                 my $call = $conn->{call} || 'none';
 399                                 dbgdump('raw', "$call send $bytes_written: ", $msg);
 400                         }
 401                         $total_out      += $bytes_written;
 402             $offset         += $bytes_written;
 403             $bytes_to_write -= $bytes_written;
 404         }
 405         delete $conn->{send_offset};
 406         $offset = 0;
 407         shift @$rq;
 408         #last unless $flush; # Go back to select and wait
 409                             # for it to fire again.
 410     }
 411     # Call me back if queue has not been drained.
 412     unless (@$rq) {
 413         set_event_handler ($sock, write => undef);
 414                 if (exists $conn->{close_on_empty}) {
 415                         &{$conn->{eproc}}($conn, undef) if exists $conn->{eproc};
 416                         $conn->disconnect;
 417                 }
 418     }
 419     1;  # Success
 420 }
 421
 422 sub dup_sock
 423 {
 424         my $conn = shift;
 425         my $oldsock = $conn->{sock};
 426         my $rc = $rd_callbacks{$oldsock};
 427         my $wc = $wt_callbacks{$oldsock};
 428         my $ec = $er_callbacks{$oldsock};
 429         my $sock = $oldsock->new_from_fd($oldsock, "w+");
 430         if ($sock) {
 431                 set_event_handler($oldsock, read=>undef, write=>undef, error=>undef);
 432                 $conn->{sock} = $sock;
 433                 set_event_handler($sock, read=>$rc, write=>$wc, error=>$ec);
 434                 $oldsock->close;
 435         }
 436 }
 437
 438 sub _err_will_block {
 439         return 0 unless $blocking_supported;
 440         return ($_[0] == $eagain || $_[0] == $ewouldblock || $_[0] == $einprogress);
 441 }
 442
 443 sub close_on_empty
 444 {
 445         my $conn = shift;
 446         $conn->{close_on_empty} = 1;
 447 }
 448
 449 #-----------------------------------------------------------------
 450 # Receive side routines
 451
 452 sub new_server {
 453     @_ == 4 || die "Msg->new_server (myhost, myport, login_proc\n";
 454     my ($pkg, $my_host, $my_port, $login_proc) = @_;
 455         my $self = $pkg->new($login_proc);
 456
 457     $self->{sock} = $io_socket->new (
 458                                           LocalAddr => "$my_host:$my_port",
 459 #                                          LocalPort => $my_port,
 460                                           Listen    => SOMAXCONN,
 461                                           Proto     => 'tcp',
 462                                           Reuse => 1);
 463     die "Could not create socket: $! \n" unless $self->{sock};
 464     set_event_handler ($self->{sock}, read => sub { $self->new_client }  );
 465         return $self;
 466 }
 467
 468
 469 sub nolinger
 470 {
 471         my $conn = shift;
 472
 473         unless ($main::is_win) {
 474                 if (isdbg('sock')) {
 475                         my ($l, $t) = unpack "ll", getsockopt($conn->{sock}, SOL_SOCKET, SO_LINGER);
 476                         my $k = unpack 'l', getsockopt($conn->{sock}, SOL_SOCKET, SO_KEEPALIVE);
 477                         my $n = $main::is_win ? 0 : unpack "l", getsockopt($conn->{sock}, IPPROTO_TCP, TCP_NODELAY);
 478                         dbg("Linger is: $l $t, keepalive: $k, nagle: $n");
 479                 }
 480
 481                 eval {setsockopt($conn->{sock}, SOL_SOCKET, SO_KEEPALIVE, 1)} or dbg("setsockopt keepalive: $!");
 482                 eval {setsockopt($conn->{sock}, SOL_SOCKET, SO_LINGER, pack("ll", 0, 0))} or dbg("setsockopt linger: $!");
 483                 eval {setsockopt($conn->{sock}, IPPROTO_TCP, TCP_NODELAY, 1)} or eval {setsockopt($conn->{sock}, SOL_SOCKET, TCP_NODELAY, 1)} or dbg("setsockopt tcp_nodelay: $!");
 484                 $conn->{sock}->autoflush(0);
 485
 486                 if (isdbg('sock')) {
 487                         my ($l, $t) = unpack "ll", getsockopt($conn->{sock}, SOL_SOCKET, SO_LINGER);
 488                         my $k = unpack 'l', getsockopt($conn->{sock}, SOL_SOCKET, SO_KEEPALIVE);
 489                         my $n = $main::is_win ? 0 : unpack "l", getsockopt($conn->{sock}, IPPROTO_TCP, TCP_NODELAY);
 490                         dbg("Linger is: $l $t, keepalive: $k, nagle: $n");
 491                 }
 492         }
 493 }
 494
 495 sub dequeue
 496 {
 497         my $conn = shift;
 498
 499         if ($conn->{msg} =~ /\n/) {
 500                 my @lines = split /\r?\n/, $conn->{msg};
 501                 if ($conn->{msg} =~ /\n$/) {
 502                         delete $conn->{msg};
 503                 } else {
 504                         $conn->{msg} = pop @lines;
 505                 }
 506                 for (@lines) {
 507                         &{$conn->{rproc}}($conn, defined $_ ? $_ : '');
 508                 }
 509         }
 510 }
 511
 512 sub _rcv {                     # Complement to _send
 513     my $conn = shift; # $rcv_now complement of $flush
 514     # Find out how much has already been received, if at all
 515     my ($msg, $offset, $bytes_to_read, $bytes_read);
 516     my $sock = $conn->{sock};
 517     return unless defined($sock);
 518
 519         my @lines;
 520 #       if ($conn->{blocking}) {
 521 #               blocking($sock, 0);
 522 #               $conn->{blocking} = 0;
 523 #       }
 524         $bytes_read = sysread ($sock, $msg, 1024, 0);
 525         if (defined ($bytes_read)) {
 526                 if ($bytes_read > 0) {
 527                         $total_in += $bytes_read;
 528                         if (isdbg('raw')) {
 529                                 my $call = $conn->{call} || 'none';
 530                                 dbgdump('raw', "$call read $bytes_read: ", $msg);
 531                         }
 532                         if ($conn->{echo}) {
 533                                 my @ch = split //, $msg;
 534                                 my $out;
 535                                 for (@ch) {
 536                                         if (/[\cH\x7f]/) {
 537                                                 $out .= "\cH \cH";
 538                                                 $conn->{msg} =~ s/.$//;
 539                                         } else {
 540                                                 $out .= $_;
 541                                                 $conn->{msg} .= $_;
 542                                         }
 543                                 }
 544                                 if (defined $out) {
 545                                         set_event_handler ($sock, write => sub{$conn->_send(0)});
 546                                         push @{$conn->{outqueue}}, $out;
 547                                 }
 548                         } else {
 549                                 $conn->{msg} .= $msg;
 550                         }
 551                 }
 552         } else {
 553                 if (_err_will_block($!)) {
 554                         return ;
 555                 } else {
 556                         $bytes_read = 0;
 557                 }
 558     }
 559
 560 FINISH:
 561     if (defined $bytes_read && $bytes_read == 0) {
 562                 &{$conn->{eproc}}($conn, $!) if exists $conn->{eproc};
 563                 $conn->disconnect;
 564     } else {
 565                 unless ($conn->{disable_read}) {
 566                         $conn->dequeue if exists $conn->{msg};
 567                 }
 568         }
 569 }
 570
 571 sub new_client {
 572         my $server_conn = shift;
 573     my $sock = $server_conn->{sock}->accept();
 574         if ($sock) {
 575                 my $conn = $server_conn->new($server_conn->{rproc});
 576                 $conn->{sock} = $sock;
 577                 blocking($sock, 0);
 578                 $conn->nolinger;
 579                 $conn->{blocking} = 0;
 580                 my ($rproc, $eproc) = &{$server_conn->{rproc}} ($conn, $conn->{peerhost} = $sock->peerhost(), $conn->{peerport} = $sock->peerport());
 581                 $conn->{sort} = 'Incoming';
 582                 if ($eproc) {
 583                         $conn->{eproc} = $eproc;
 584                         set_event_handler ($sock, error => $eproc);
 585                 }
 586                 if ($rproc) {
 587                         $conn->{rproc} = $rproc;
 588                         my $callback = sub {$conn->_rcv};
 589                         set_event_handler ($sock, read => $callback);
 590                 } else {  # Login failed
 591                         &{$conn->{eproc}}($conn, undef) if exists $conn->{eproc};
 592                         $conn->disconnect();
 593                 }
 594         } else {
 595                 dbg("Msg: error on accept ($!)") if isdbg('err');
 596         }
 597 }
 598
 599 sub close_server
 600 {
 601         my $conn = shift;
 602         set_event_handler ($conn->{sock}, read => undef, write => undef, error => undef );
 603         $conn->{sock}->close;
 604 }
 605
 606 # close all clients (this is for forking really)
 607 sub close_all_clients
 608 {
 609         foreach my $conn (values %conns) {
 610                 $conn->disconnect;
 611         }
 612 }
 613
 614 sub disable_read
 615 {
 616         my $conn = shift;
 617         set_event_handler ($conn->{sock}, read => undef);
 618         return $_[0] ? $conn->{disable_read} = $_[0] : $_[0];
 619 }
 620
 621 #
 622 #----------------------------------------------------
 623 # Event loop routines used by both client and server
 624
 625 sub set_event_handler {
 626     shift unless ref($_[0]); # shift if first arg is package name
 627     my ($handle, %args) = @_;
 628     my $callback;
 629     if (exists $args{'write'}) {
 630         $callback = $args{'write'};
 631         if ($callback) {
 632             $wt_callbacks{$handle} = $callback;
 633             $wt_handles->add($handle);
 634         } else {
 635             delete $wt_callbacks{$handle};
 636             $wt_handles->remove($handle);
 637         }
 638     }
 639     if (exists $args{'read'}) {
 640         $callback = $args{'read'};
 641         if ($callback) {
 642             $rd_callbacks{$handle} = $callback;
 643             $rd_handles->add($handle);
 644         } else {
 645             delete $rd_callbacks{$handle};
 646             $rd_handles->remove($handle);
 647        }
 648     }
 649     if (exists $args{'error'}) {
 650         $callback = $args{'error'};
 651         if ($callback) {
 652             $er_callbacks{$handle} = $callback;
 653             $er_handles->add($handle);
 654         } else {
 655             delete $er_callbacks{$handle};
 656             $er_handles->remove($handle);
 657        }
 658     }
 659 }
 660
 661 sub event_loop {
 662     my ($pkg, $loop_count, $timeout, $wronly) = @_; # event_loop(1) to process events once
 663     my ($conn, $r, $w, $e, $rset, $wset, $eset);
 664     while (1) {
 665
 666        # Quit the loop if no handles left to process
 667                 if ($wronly) {
 668                         last unless $wt_handles->count();
 669
 670                         ($rset, $wset, $eset) = IO::Select->select(undef, $wt_handles, undef, $timeout);
 671
 672                         foreach $w (@$wset) {
 673                                 &{$wt_callbacks{$w}}($w) if exists $wt_callbacks{$w};
 674                         }
 675                 } else {
 676
 677                         last unless ($rd_handles->count() || $wt_handles->count());
 678
 679                         ($rset, $wset, $eset) = IO::Select->select($rd_handles, $wt_handles, $er_handles, $timeout);
 680
 681                         foreach $e (@$eset) {
 682                                 &{$er_callbacks{$e}}($e) if exists $er_callbacks{$e};
 683                         }
 684                         foreach $r (@$rset) {
 685                                 &{$rd_callbacks{$r}}($r) if exists $rd_callbacks{$r};
 686                         }
 687                         foreach $w (@$wset) {
 688                                 &{$wt_callbacks{$w}}($w) if exists $wt_callbacks{$w};
 689                         }
 690                 }
 691
 692                 Timer::handler;
 693
 694         if (defined($loop_count)) {
 695             last unless --$loop_count;
 696         }
 697     }
 698 }
 699
 700 sub sleep
 701 {
 702         my ($pkg, $interval) = @_;
 703         my $now = time;
 704         while (time - $now < $interval) {
 705                 $pkg->event_loop(10, 0.01);
 706         }
 707 }
 708
 709 sub DESTROY
 710 {
 711         my $conn = shift;
 712         my $call = $conn->{call} || 'unallocated';
 713         my $host = $conn->{peerhost} || '';
 714         my $port = $conn->{peerport} || '';
 715         dbg("Connection $conn->{cnum} $call [$host $port] being destroyed") if isdbg('connll');
 716         $noconns--;
 717 }
 718
 719 1;
 720
 721 __END__
 722