ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/libev/ev.pod
(Generate patch)

Comparing libev/ev.pod (file contents):
Revision 1.191 by root, Tue Sep 30 19:45:23 2008 UTC vs.
Revision 1.196 by root, Tue Oct 21 20:04:14 2008 UTC

… …
685C<EVUNLOOP_ONE>, which will make the innermost C<ev_loop> call return, or 685C<EVUNLOOP_ONE>, which will make the innermost C<ev_loop> call return, or
686C<EVUNLOOP_ALL>, which will make all nested C<ev_loop> calls return. 686C<EVUNLOOP_ALL>, which will make all nested C<ev_loop> calls return.
687 687
688This "unloop state" will be cleared when entering C<ev_loop> again. 688This "unloop state" will be cleared when entering C<ev_loop> again.
689 689
690It is safe to call C<ev_unloop> from otuside any C<ev_loop> calls.
691
690=item ev_ref (loop) 692=item ev_ref (loop)
691 693
692=item ev_unref (loop) 694=item ev_unref (loop)
693 695
694Ref/unref can be used to add or remove a reference count on the event 696Ref/unref can be used to add or remove a reference count on the event
… …
967 969
968 ev_io_start (EV_DEFAULT_UC, &w); 970 ev_io_start (EV_DEFAULT_UC, &w);
969 971
970=item C<ev_TYPE_stop> (loop *, ev_TYPE *watcher) 972=item C<ev_TYPE_stop> (loop *, ev_TYPE *watcher)
971 973
972Stops the given watcher again (if active) and clears the pending 974Stops the given watcher if active, and clears the pending status (whether
975the watcher was active or not).
976
973status. It is possible that stopped watchers are pending (for example, 977It is possible that stopped watchers are pending - for example,
974non-repeating timers are being stopped when they become pending), but 978non-repeating timers are being stopped when they become pending - but
975C<ev_TYPE_stop> ensures that the watcher is neither active nor pending. If 979calling C<ev_TYPE_stop> ensures that the watcher is neither active nor
976you want to free or reuse the memory used by the watcher it is therefore a 980pending. If you want to free or reuse the memory used by the watcher it is
977good idea to always call its C<ev_TYPE_stop> function. 981therefore a good idea to always call its C<ev_TYPE_stop> function.
978 982
979=item bool ev_is_active (ev_TYPE *watcher) 983=item bool ev_is_active (ev_TYPE *watcher)
980 984
981Returns a true value iff the watcher is active (i.e. it has been started 985Returns a true value iff the watcher is active (i.e. it has been started
982and not yet been stopped). As long as a watcher is active you must not modify 986and not yet been stopped). As long as a watcher is active you must not modify
… …
1792to exchange stat structures with application programs compiled using the 1796to exchange stat structures with application programs compiled using the
1793default compilation environment. 1797default compilation environment.
1794 1798
1795=head3 Inotify and Kqueue 1799=head3 Inotify and Kqueue
1796 1800
1797When C<inotify (7)> support has been compiled into libev (generally only 1801When C<inotify (7)> support has been compiled into libev (generally
1802only available with Linux 2.6.25 or above due to bugs in earlier
1798available with Linux) and present at runtime, it will be used to speed up 1803implementations) and present at runtime, it will be used to speed up
1799change detection where possible. The inotify descriptor will be created lazily 1804change detection where possible. The inotify descriptor will be created
1800when the first C<ev_stat> watcher is being started. 1805lazily when the first C<ev_stat> watcher is being started.
1801 1806
1802Inotify presence does not change the semantics of C<ev_stat> watchers 1807Inotify presence does not change the semantics of C<ev_stat> watchers
1803except that changes might be detected earlier, and in some cases, to avoid 1808except that changes might be detected earlier, and in some cases, to avoid
1804making regular C<stat> calls. Even in the presence of inotify support 1809making regular C<stat> calls. Even in the presence of inotify support
1805there are many cases where libev has to resort to regular C<stat> polling, 1810there are many cases where libev has to resort to regular C<stat> polling,
… …
2502=over 4 2507=over 4
2503 2508
2504=item ev_once (loop, int fd, int events, ev_tstamp timeout, callback) 2509=item ev_once (loop, int fd, int events, ev_tstamp timeout, callback)
2505 2510
2506This function combines a simple timer and an I/O watcher, calls your 2511This function combines a simple timer and an I/O watcher, calls your
2507callback on whichever event happens first and automatically stop both 2512callback on whichever event happens first and automatically stops both
2508watchers. This is useful if you want to wait for a single event on an fd 2513watchers. This is useful if you want to wait for a single event on an fd
2509or timeout without having to allocate/configure/start/stop/free one or 2514or timeout without having to allocate/configure/start/stop/free one or
2510more watchers yourself. 2515more watchers yourself.
2511 2516
2512If C<fd> is less than 0, then no I/O watcher will be started and events 2517If C<fd> is less than 0, then no I/O watcher will be started and the
2513is being ignored. Otherwise, an C<ev_io> watcher for the given C<fd> and 2518C<events> argument is being ignored. Otherwise, an C<ev_io> watcher for
2514C<events> set will be created and started. 2519the given C<fd> and C<events> set will be created and started.
2515 2520
2516If C<timeout> is less than 0, then no timeout watcher will be 2521If C<timeout> is less than 0, then no timeout watcher will be
2517started. Otherwise an C<ev_timer> watcher with after = C<timeout> (and 2522started. Otherwise an C<ev_timer> watcher with after = C<timeout> (and
2518repeat = 0) will be started. While C<0> is a valid timeout, it is of 2523repeat = 0) will be started. C<0> is a valid timeout.
2519dubious value.
2520 2524
2521The callback has the type C<void (*cb)(int revents, void *arg)> and gets 2525The callback has the type C<void (*cb)(int revents, void *arg)> and gets
2522passed an C<revents> set like normal event callbacks (a combination of 2526passed an C<revents> set like normal event callbacks (a combination of
2523C<EV_ERROR>, C<EV_READ>, C<EV_WRITE> or C<EV_TIMEOUT>) and the C<arg> 2527C<EV_ERROR>, C<EV_READ>, C<EV_WRITE> or C<EV_TIMEOUT>) and the C<arg>
2524value passed to C<ev_once>: 2528value passed to C<ev_once>. Note that it is possible to receive I<both>
2529a timeout and an io event at the same time - you probably should give io
2530events precedence.
2531
2532Example: wait up to ten seconds for data to appear on STDIN_FILENO.
2525 2533
2526 static void stdin_ready (int revents, void *arg) 2534 static void stdin_ready (int revents, void *arg)
2527 { 2535 {
2536 if (revents & EV_READ)
2537 /* stdin might have data for us, joy! */;
2528 if (revents & EV_TIMEOUT) 2538 else if (revents & EV_TIMEOUT)
2529 /* doh, nothing entered */; 2539 /* doh, nothing entered */;
2530 else if (revents & EV_READ)
2531 /* stdin might have data for us, joy! */;
2532 } 2540 }
2533 2541
2534 ev_once (STDIN_FILENO, EV_READ, 10., stdin_ready, 0); 2542 ev_once (STDIN_FILENO, EV_READ, 10., stdin_ready, 0);
2535 2543
2536=item ev_feed_event (ev_loop *, watcher *, int revents) 2544=item ev_feed_event (ev_loop *, watcher *, int revents)

Diff Legend

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