| 1 | =head1 NAME |
1 | =head1 NAME |
| 2 | |
2 | |
| 3 | AnyEvent::Fork::RPC - simple RPC extension for AnyEvent::Fork |
3 | AnyEvent::Fork::RPC - simple RPC extension for AnyEvent::Fork |
|
|
4 | |
|
|
5 | THE API IS NOT FINISHED, CONSIDER THIS A TECHNOLOGY DEMO |
| 4 | |
6 | |
| 5 | =head1 SYNOPSIS |
7 | =head1 SYNOPSIS |
| 6 | |
8 | |
| 7 | use AnyEvent::Fork::RPC; |
9 | use AnyEvent::Fork::RPC; |
| 8 | # use AnyEvent::Fork is not needed |
10 | # use AnyEvent::Fork is not needed |
| … | |
… | |
| 548 | undef $rw; undef $ww; # it ends here |
550 | undef $rw; undef $ww; # it ends here |
| 549 | |
551 | |
| 550 | if (@rcb || %rcb) { |
552 | if (@rcb || %rcb) { |
| 551 | $on_error->("unexpected eof"); |
553 | $on_error->("unexpected eof"); |
| 552 | } else { |
554 | } else { |
| 553 | $on_destroy->(); |
555 | $on_destroy->() |
|
|
556 | if $on_destroy; |
| 554 | } |
557 | } |
| 555 | } elsif ($! != Errno::EAGAIN && $! != Errno::EWOULDBLOCK) { |
558 | } elsif ($! != Errno::EAGAIN && $! != Errno::EWOULDBLOCK) { |
| 556 | undef $rw; undef $ww; # it ends here |
559 | undef $rw; undef $ww; # it ends here |
| 557 | $on_error->("read: $!"); |
560 | $on_error->("read: $!"); |
| 558 | } |
561 | } |
| … | |
… | |
| 561 | $ww ||= AE::io $fh, 1, $wcb; |
564 | $ww ||= AE::io $fh, 1, $wcb; |
| 562 | }); |
565 | }); |
| 563 | |
566 | |
| 564 | my $guard = Guard::guard { |
567 | my $guard = Guard::guard { |
| 565 | $shutdown = 1; |
568 | $shutdown = 1; |
| 566 | $ww ||= $fh && AE::io $fh, 1, $wcb; |
569 | |
|
|
570 | shutdown $fh, 1 if $fh && !$ww; |
| 567 | }; |
571 | }; |
| 568 | |
572 | |
| 569 | my $id; |
573 | my $id; |
| 570 | |
574 | |
| 571 | $arg{async} |
575 | $arg{async} |
| … | |
… | |
| 573 | $id = ($id == 0xffffffff ? 0 : $id) + 1; |
577 | $id = ($id == 0xffffffff ? 0 : $id) + 1; |
| 574 | $id = ($id == 0xffffffff ? 0 : $id) + 1 while exists $rcb{$id}; # rarely loops |
578 | $id = ($id == 0xffffffff ? 0 : $id) + 1 while exists $rcb{$id}; # rarely loops |
| 575 | |
579 | |
| 576 | $rcb{$id} = pop; |
580 | $rcb{$id} = pop; |
| 577 | |
581 | |
| 578 | $guard; # keep it alive |
582 | $guard if 0; # keep it alive |
| 579 | |
583 | |
| 580 | $wbuf .= pack "LL/a*", $id, &$f; |
584 | $wbuf .= pack "LL/a*", $id, &$f; |
| 581 | $ww ||= $fh && AE::io $fh, 1, $wcb; |
585 | $ww ||= $fh && AE::io $fh, 1, $wcb; |
| 582 | } |
586 | } |
| 583 | : sub { |
587 | : sub { |
| … | |
… | |
| 769 | |
773 | |
| 770 | Of course, this might be blocking if you pass a lot of file descriptors, |
774 | Of course, this might be blocking if you pass a lot of file descriptors, |
| 771 | so you might want to look into L<AnyEvent::FDpasser> which can handle the |
775 | so you might want to look into L<AnyEvent::FDpasser> which can handle the |
| 772 | gory details. |
776 | gory details. |
| 773 | |
777 | |
|
|
778 | =head1 EXCEPTIONS |
|
|
779 | |
|
|
780 | There are no provisions whatsoever for catching exceptions at this time - |
|
|
781 | in the child, exeptions might kill the process, causing calls to be lost |
|
|
782 | and the parent encountering a fatal error. In the parent, exceptions in |
|
|
783 | the result callback will not be caught and cause undefined behaviour. |
|
|
784 | |
| 774 | =head1 SEE ALSO |
785 | =head1 SEE ALSO |
| 775 | |
786 | |
| 776 | L<AnyEvent::Fork>, to create the processes in the first place. |
787 | L<AnyEvent::Fork>, to create the processes in the first place. |
| 777 | |
788 | |
| 778 | L<AnyEvent::Fork::Pool>, to manage whole pools of processes. |
789 | L<AnyEvent::Fork::Pool>, to manage whole pools of processes. |
