ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/AnyEvent/lib/AnyEvent.pm
(Generate patch)

Comparing AnyEvent/lib/AnyEvent.pm (file contents):
Revision 1.145 by root, Thu May 29 03:45:37 2008 UTC vs.
Revision 1.158 by root, Fri Jun 6 15:35:30 2008 UTC

1=head1 => NAME 1=head1 NAME
2 2
3AnyEvent - provide framework for multiple event loops 3AnyEvent - provide framework for multiple event loops
4 4
5EV, Event, Glib, Tk, Perl, Event::Lib, Qt, POE - various supported event loops 5EV, Event, Glib, Tk, Perl, Event::Lib, Qt, POE - various supported event loops
6 6
… …
17 }); 17 });
18 18
19 my $w = AnyEvent->condvar; # stores whether a condition was flagged 19 my $w = AnyEvent->condvar; # stores whether a condition was flagged
20 $w->send; # wake up current and all future recv's 20 $w->send; # wake up current and all future recv's
21 $w->recv; # enters "main loop" till $condvar gets ->send 21 $w->recv; # enters "main loop" till $condvar gets ->send
22
23=head1 INTRODUCTION/TUTORIAL
24
25This manpage is mainly a reference manual. If you are interested
26in a tutorial or some gentle introduction, have a look at the
27L<AnyEvent::Intro> manpage.
22 28
23=head1 WHY YOU SHOULD USE THIS MODULE (OR NOT) 29=head1 WHY YOU SHOULD USE THIS MODULE (OR NOT)
24 30
25Glib, POE, IO::Async, Event... CPAN offers event models by the dozen 31Glib, POE, IO::Async, Event... CPAN offers event models by the dozen
26nowadays. So what is different about AnyEvent? 32nowadays. So what is different about AnyEvent?
… …
132Many watchers either are used with "recursion" (repeating timers for 138Many watchers either are used with "recursion" (repeating timers for
133example), or need to refer to their watcher object in other ways. 139example), or need to refer to their watcher object in other ways.
134 140
135An any way to achieve that is this pattern: 141An any way to achieve that is this pattern:
136 142
137 my $w; $w = AnyEvent->type (arg => value ..., cb => sub { 143 my $w; $w = AnyEvent->type (arg => value ..., cb => sub {
138 # you can use $w here, for example to undef it 144 # you can use $w here, for example to undef it
139 undef $w; 145 undef $w;
140 }); 146 });
141 147
142Note that C<my $w; $w => combination. This is necessary because in Perl, 148Note that C<my $w; $w => combination. This is necessary because in Perl,
143my variables are only visible after the statement in which they are 149my variables are only visible after the statement in which they are
144declared. 150declared.
145 151
… …
346AnyEvent program, you I<have> to create at least one watcher before you 352AnyEvent program, you I<have> to create at least one watcher before you
347C<fork> the child (alternatively, you can call C<AnyEvent::detect>). 353C<fork> the child (alternatively, you can call C<AnyEvent::detect>).
348 354
349Example: fork a process and wait for it 355Example: fork a process and wait for it
350 356
351 my $done = AnyEvent->condvar; 357 my $done = AnyEvent->condvar;
352 358
353 my $pid = fork or exit 5; 359 my $pid = fork or exit 5;
354 360
355 my $w = AnyEvent->child ( 361 my $w = AnyEvent->child (
356 pid => $pid, 362 pid => $pid,
357 cb => sub { 363 cb => sub {
358 my ($pid, $status) = @_; 364 my ($pid, $status) = @_;
359 warn "pid $pid exited with status $status"; 365 warn "pid $pid exited with status $status";
360 $done->send; 366 $done->send;
361 }, 367 },
362 ); 368 );
363 369
364 # do something else, then wait for process exit 370 # do something else, then wait for process exit
365 $done->recv; 371 $done->recv;
366 372
367=head2 CONDITION VARIABLES 373=head2 CONDITION VARIABLES
368 374
369If you are familiar with some event loops you will know that all of them 375If you are familiar with some event loops you will know that all of them
370require you to run some blocking "loop", "run" or similar function that 376require you to run some blocking "loop", "run" or similar function that
… …
591 597
592This is a mutator function that returns the callback set and optionally 598This is a mutator function that returns the callback set and optionally
593replaces it before doing so. 599replaces it before doing so.
594 600
595The callback will be called when the condition becomes "true", i.e. when 601The callback will be called when the condition becomes "true", i.e. when
596C<send> or C<croak> are called. Calling C<recv> inside the callback 602C<send> or C<croak> are called, with the only argument being the condition
597or at any later time is guaranteed not to block. 603variable itself. Calling C<recv> inside the callback or at any later time
604is guaranteed not to block.
598 605
599=back 606=back
600 607
601=head1 GLOBAL VARIABLES AND FUNCTIONS 608=head1 GLOBAL VARIABLES AND FUNCTIONS
602 609
… …
745 752
746=item L<AnyEvent::DNS> 753=item L<AnyEvent::DNS>
747 754
748Provides rich asynchronous DNS resolver capabilities. 755Provides rich asynchronous DNS resolver capabilities.
749 756
757=item L<AnyEvent::HTTP>
758
759A simple-to-use HTTP library that is capable of making a lot of concurrent
760HTTP requests.
761
750=item L<AnyEvent::HTTPD> 762=item L<AnyEvent::HTTPD>
751 763
752Provides a simple web application server framework. 764Provides a simple web application server framework.
753 765
754=item L<AnyEvent::FastPing> 766=item L<AnyEvent::FastPing>
… …
800no warnings; 812no warnings;
801use strict; 813use strict;
802 814
803use Carp; 815use Carp;
804 816
805our $VERSION = '4.1'; 817our $VERSION = 4.151;
806our $MODEL; 818our $MODEL;
807 819
808our $AUTOLOAD; 820our $AUTOLOAD;
809our @ISA; 821our @ISA;
810 822
… …
1166This functionality might change in future versions. 1178This functionality might change in future versions.
1167 1179
1168For example, to force the pure perl model (L<AnyEvent::Impl::Perl>) you 1180For example, to force the pure perl model (L<AnyEvent::Impl::Perl>) you
1169could start your program like this: 1181could start your program like this:
1170 1182
1171 PERL_ANYEVENT_MODEL=Perl perl ... 1183 PERL_ANYEVENT_MODEL=Perl perl ...
1172 1184
1173=item C<PERL_ANYEVENT_PROTOCOLS> 1185=item C<PERL_ANYEVENT_PROTOCOLS>
1174 1186
1175Used by both L<AnyEvent::DNS> and L<AnyEvent::Socket> to determine preferences 1187Used by both L<AnyEvent::DNS> and L<AnyEvent::Socket> to determine preferences
1176for IPv4 or IPv6. The default is unspecified (and might change, or be the result 1188for IPv4 or IPv6. The default is unspecified (and might change, or be the result
… …
1651specified in the variable. 1663specified in the variable.
1652 1664
1653You can make AnyEvent completely ignore this variable by deleting it 1665You can make AnyEvent completely ignore this variable by deleting it
1654before the first watcher gets created, e.g. with a C<BEGIN> block: 1666before the first watcher gets created, e.g. with a C<BEGIN> block:
1655 1667
1656 BEGIN { delete $ENV{PERL_ANYEVENT_MODEL} } 1668 BEGIN { delete $ENV{PERL_ANYEVENT_MODEL} }
1657 1669
1658 use AnyEvent; 1670 use AnyEvent;
1659 1671
1660Similar considerations apply to $ENV{PERL_ANYEVENT_VERBOSE}, as that can 1672Similar considerations apply to $ENV{PERL_ANYEVENT_VERBOSE}, as that can
1661be used to probe what backend is used and gain other information (which is 1673be used to probe what backend is used and gain other information (which is
1662probably even less useful to an attacker than PERL_ANYEVENT_MODEL). 1674probably even less useful to an attacker than PERL_ANYEVENT_MODEL).
1675
1676
1677=head1 BUGS
1678
1679Perl 5.8 has numerous memleaks that sometimes hit this module and are hard
1680to work around. If you suffer from memleaks, first upgrade to Perl 5.10
1681and check wether the leaks still show up. (Perl 5.10.0 has other annoying
1682mamleaks, such as leaking on C<map> and C<grep> but it is usually not as
1683pronounced).
1663 1684
1664 1685
1665=head1 SEE ALSO 1686=head1 SEE ALSO
1666 1687
1667Utility functions: L<AnyEvent::Util>. 1688Utility functions: L<AnyEvent::Util>.
… …
1684Nontrivial usage examples: L<Net::FCP>, L<Net::XMPP2>, L<AnyEvent::DNS>. 1705Nontrivial usage examples: L<Net::FCP>, L<Net::XMPP2>, L<AnyEvent::DNS>.
1685 1706
1686 1707
1687=head1 AUTHOR 1708=head1 AUTHOR
1688 1709
1689 Marc Lehmann <schmorp@schmorp.de> 1710 Marc Lehmann <schmorp@schmorp.de>
1690 http://home.schmorp.de/ 1711 http://home.schmorp.de/
1691 1712
1692=cut 1713=cut
1693 1714
16941 17151
1695 1716

Diff Legend

– Removed lines
+ Added lines
< Changed lines
> Changed lines