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

Comparing libev/ev.pod (file contents):
Revision 1.277 by root, Thu Dec 31 06:50:17 2009 UTC vs.
Revision 1.280 by sf-exg, Tue Feb 16 12:17:57 2010 UTC

… …
374 374
375=item C<EVFLAG_SIGNALFD> 375=item C<EVFLAG_SIGNALFD>
376 376
377When this flag is specified, then libev will attempt to use the 377When this flag is specified, then libev will attempt to use the
378I<signalfd> API for it's C<ev_signal> (and C<ev_child>) watchers. This API 378I<signalfd> API for it's C<ev_signal> (and C<ev_child>) watchers. This API
379delivers signals synchronously, which makes is both faster and might make 379delivers signals synchronously, which makes it both faster and might make
380it possible to get the queued signal data. 380it possible to get the queued signal data. It can also simplify signal
381handling with threads, as long as you properly block signals in your
382threads that are not interested in handling them.
381 383
382Signalfd will not be used by default as this changes your signal mask, and 384Signalfd will not be used by default as this changes your signal mask, and
383there are a lot of shoddy libraries and programs (glib's threadpool for 385there are a lot of shoddy libraries and programs (glib's threadpool for
384example) that can't properly initialise their signal masks. 386example) that can't properly initialise their signal masks.
385 387
… …
1865Returns the remaining time until a timer fires. If the timer is active, 1867Returns the remaining time until a timer fires. If the timer is active,
1866then this time is relative to the current event loop time, otherwise it's 1868then this time is relative to the current event loop time, otherwise it's
1867the timeout value currently configured. 1869the timeout value currently configured.
1868 1870
1869That is, after an C<ev_timer_set (w, 5, 7)>, C<ev_timer_remaining> returns 1871That is, after an C<ev_timer_set (w, 5, 7)>, C<ev_timer_remaining> returns
1870C<5>. When the timer is started and one second passes, C<ev_timer_remain> 1872C<5>. When the timer is started and one second passes, C<ev_timer_remaining>
1871will return C<4>. When the timer expires and is restarted, it will return 1873will return C<4>. When the timer expires and is restarted, it will return
1872roughly C<7> (likely slightly less as callback invocation takes some time, 1874roughly C<7> (likely slightly less as callback invocation takes some time,
1873too), and so on. 1875too), and so on.
1874 1876
1875=item ev_tstamp repeat [read-write] 1877=item ev_tstamp repeat [read-write]
… …
2160In current versions of libev, the signal will not be blocked indefinitely 2162In current versions of libev, the signal will not be blocked indefinitely
2161unless you use the C<signalfd> API (C<EV_SIGNALFD>). While this reduces 2163unless you use the C<signalfd> API (C<EV_SIGNALFD>). While this reduces
2162the window of opportunity for problems, it will not go away, as libev 2164the window of opportunity for problems, it will not go away, as libev
2163I<has> to modify the signal mask, at least temporarily. 2165I<has> to modify the signal mask, at least temporarily.
2164 2166
2165So I can't stress this enough I<if you do not reset your signal mask 2167So I can't stress this enough: I<If you do not reset your signal mask when
2166when you expect it to be empty, you have a race condition in your 2168you expect it to be empty, you have a race condition in your code>. This
2167program>. This is not a libev-specific thing, this is true for most event 2169is not a libev-specific thing, this is true for most event libraries.
2168libraries.
2169 2170
2170=head3 Watcher-Specific Functions and Data Members 2171=head3 Watcher-Specific Functions and Data Members
2171 2172
2172=over 4 2173=over 4
2173 2174
… …
3450Erkki Seppala has written Ocaml bindings for libev, to be found at 3451Erkki Seppala has written Ocaml bindings for libev, to be found at
3451L<http://modeemi.cs.tut.fi/~flux/software/ocaml-ev/>. 3452L<http://modeemi.cs.tut.fi/~flux/software/ocaml-ev/>.
3452 3453
3453=item Lua 3454=item Lua
3454 3455
3455Brian Maher has written a partial interface to libev 3456Brian Maher has written a partial interface to libev for lua (at the
3456for lua (only C<ev_io> and C<ev_timer>), to be found at 3457time of this writing, only C<ev_io> and C<ev_timer>), to be found at
3457L<http://github.com/brimworks/lua-ev>. 3458L<http://github.com/brimworks/lua-ev>.
3458 3459
3459=back 3460=back
3460 3461
3461 3462

Diff Legend

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