| … | |
… | |
| 46 | my ($w, $revents) = @_; |
46 | my ($w, $revents) = @_; |
| 47 | warn $w->path, " has changed somehow.\n"; |
47 | warn $w->path, " has changed somehow.\n"; |
| 48 | }; |
48 | }; |
| 49 | |
49 | |
| 50 | # MAINLOOP |
50 | # MAINLOOP |
| 51 | EV::run; # loop until EV::unloop is called or all watchers stop |
51 | EV::run; # loop until EV::break is called or all watchers stop |
| 52 | EV::run EV::RUN_ONCE; # block until at least one event could be handled |
52 | EV::run EV::RUN_ONCE; # block until at least one event could be handled |
| 53 | EV::run EV::RUN_NOWAIT; # try to handle same events, but do not block |
53 | EV::run EV::RUN_NOWAIT; # try to handle same events, but do not block |
| 54 | |
54 | |
| 55 | BEFORE YOU START USING THIS MODULE |
55 | BEFORE YOU START USING THIS MODULE |
| 56 | If you only need timer, I/O, signal, child and idle watchers and not the |
56 | If you only need timer, I/O, signal, child and idle watchers and not the |
| … | |
… | |
| 233 | $backend = EV::backend |
233 | $backend = EV::backend |
| 234 | $backend = $loop->backend |
234 | $backend = $loop->backend |
| 235 | Returns an integer describing the backend used by libev |
235 | Returns an integer describing the backend used by libev |
| 236 | (EV::BACKEND_SELECT or EV::BACKEND_EPOLL). |
236 | (EV::BACKEND_SELECT or EV::BACKEND_EPOLL). |
| 237 | |
237 | |
| 238 | EV::run [$flags] |
238 | $active = EV::run [$flags] |
| 239 | $loop->run ([$flags]) |
239 | $active = $loop->run ([$flags]) |
| 240 | Begin checking for events and calling callbacks. It returns when a |
240 | Begin checking for events and calling callbacks. It returns when a |
| 241 | callback calls EV::unloop. |
241 | callback calls EV::break or the flasg are nonzero (in which case the |
|
|
242 | return value is true) or when there are no active watchers which |
|
|
243 | reference the loop (keepalive is true), in which case the return |
|
|
244 | value will be false. The returnv alue can generally be interpreted |
|
|
245 | as "if true, there is more work left to do". |
| 242 | |
246 | |
| 243 | The $flags argument can be one of the following: |
247 | The $flags argument can be one of the following: |
| 244 | |
248 | |
| 245 | 0 as above |
249 | 0 as above |
| 246 | EV::RUN_ONCE block at most once (wait, but do not loop) |
250 | EV::RUN_ONCE block at most once (wait, but do not loop) |
| … | |
… | |
| 554 | to system time: |
558 | to system time: |
| 555 | |
559 | |
| 556 | my $hourly = EV::periodic 0, 3600, 0, sub { print "once/hour\n" }; |
560 | my $hourly = EV::periodic 0, 3600, 0, sub { print "once/hour\n" }; |
| 557 | |
561 | |
| 558 | That doesn't mean there will always be 3600 seconds in between |
562 | That doesn't mean there will always be 3600 seconds in between |
| 559 | triggers, but only that the the clalback will be called when the |
563 | triggers, but only that the the callback will be called when the |
| 560 | system time shows a full hour (UTC). |
564 | system time shows a full hour (UTC). |
| 561 | |
565 | |
| 562 | Another way to think about it (for the mathematically inclined) |
566 | Another way to think about it (for the mathematically inclined) |
| 563 | is that EV::periodic will try to run the callback in this mode |
567 | is that EV::periodic will try to run the callback in this mode |
| 564 | at the next possible time where "$time = $at (mod $interval)", |
568 | at the next possible time where "$time = $at (mod $interval)", |
| … | |
… | |
| 925 | |
929 | |
| 926 | Please see the libev documentation for further details. |
930 | Please see the libev documentation for further details. |
| 927 | |
931 | |
| 928 | $w = EV::async $callback |
932 | $w = EV::async $callback |
| 929 | $w = EV::async_ns $callback |
933 | $w = EV::async_ns $callback |
|
|
934 | $w = $loop->async ($callback) |
|
|
935 | $w = $loop->async_ns ($callback) |
| 930 | $w->send |
936 | $w->send |
| 931 | $bool = $w->async_pending |
937 | $bool = $w->async_pending |
|
|
938 | |
|
|
939 | CLEANUP WATCHERS - how to clean up when the event loop goes away |
|
|
940 | Cleanup watchers are not supported on the Perl level, they can only be |
|
|
941 | used via XS currently. |
| 932 | |
942 | |
| 933 | PERL SIGNALS |
943 | PERL SIGNALS |
| 934 | While Perl signal handling (%SIG) is not affected by EV, the behaviour |
944 | While Perl signal handling (%SIG) is not affected by EV, the behaviour |
| 935 | with EV is as the same as any other C library: Perl-signals will only be |
945 | with EV is as the same as any other C library: Perl-signals will only be |
| 936 | handled when Perl runs, which means your signal handler might be invoked |
946 | handled when Perl runs, which means your signal handler might be invoked |
