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.363 by root, Sun Jan 30 22:38:59 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 instanlty
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).

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines