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

Comparing libev/ev.pod (file contents):
Revision 1.362 by root, Sun Jan 30 21:10:13 2011 UTC vs.
Revision 1.366 by sf-exg, Thu Feb 3 16:21:08 2011 UTC

… …
3188 atexit (program_exits); 3188 atexit (program_exits);
3189 3189
3190 3190
3191=head2 C<ev_async> - how to wake up an event loop 3191=head2 C<ev_async> - how to wake up an event loop
3192 3192
3193In general, you cannot use an C<ev_run> from multiple threads or other 3193In general, you cannot use an C<ev_loop> from multiple threads or other
3194asynchronous sources such as signal handlers (as opposed to multiple event 3194asynchronous sources such as signal handlers (as opposed to multiple event
3195loops - those are of course safe to use in different threads). 3195loops - those are of course safe to use in different threads).
3196 3196
3197Sometimes, however, you need to wake up an event loop you do not control, 3197Sometimes, however, you need to wake up an event loop you do not control,
3198for example because it belongs to another thread. This is what C<ev_async> 3198for example because it belongs to another thread. This is what C<ev_async>
… …
3308trust me. 3308trust me.
3309 3309
3310=item ev_async_send (loop, ev_async *) 3310=item ev_async_send (loop, ev_async *)
3311 3311
3312Sends/signals/activates the given C<ev_async> watcher, that is, feeds 3312Sends/signals/activates the given C<ev_async> watcher, that is, feeds
3313an C<EV_ASYNC> event on the watcher into the event loop. Unlike 3313an C<EV_ASYNC> event on the watcher into the event loop, and instantly
3314returns.
3315
3314C<ev_feed_event>, this call is safe to do from other threads, signal or 3316Unlike C<ev_feed_event>, this call is safe to do from other threads,
3315similar contexts (see the discussion of C<EV_ATOMIC_T> in the embedding 3317signal or similar contexts (see the discussion of C<EV_ATOMIC_T> in the
3316section below on what exactly this means). 3318embedding section below on what exactly this means).
3317 3319
3318Note that, as with other watchers in libev, multiple events might get 3320Note that, as with other watchers in libev, multiple events might get
3319compressed into a single callback invocation (another way to look at this 3321compressed into a single callback invocation (another way to look at this
3320is that C<ev_async> watchers are level-triggered, set on C<ev_async_send>, 3322is that C<ev_async> watchers are level-triggered, set on C<ev_async_send>,
3321reset when the event loop detects that). 3323reset when the event loop detects that).
… …
5222The physical time that is observed. It is apparently strictly monotonic :) 5224The physical time that is observed. It is apparently strictly monotonic :)
5223 5225
5224=item wall-clock time 5226=item wall-clock time
5225 5227
5226The time and date as shown on clocks. Unlike real time, it can actually 5228The time and date as shown on clocks. Unlike real time, it can actually
5227be wrong and jump forwards and backwards, e.g. when the you adjust your 5229be wrong and jump forwards and backwards, e.g. when you adjust your
5228clock. 5230clock.
5229 5231
5230=item watcher 5232=item watcher
5231 5233
5232A data structure that describes interest in certain events. Watchers need 5234A data structure that describes interest in certain events. Watchers need
… …
5235=back 5237=back
5236 5238
5237=head1 AUTHOR 5239=head1 AUTHOR
5238 5240
5239Marc Lehmann <libev@schmorp.de>, with repeated corrections by Mikael 5241Marc Lehmann <libev@schmorp.de>, with repeated corrections by Mikael
5240Magnusson and Emanuele Giaquinta. 5242Magnusson and Emanuele Giaquinta, and minor corrections by many others.
5241 5243

Diff Legend

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