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

Comparing libev/ev.pod (file contents):
Revision 1.61 by root, Thu Nov 29 12:21:05 2007 UTC vs.
Revision 1.63 by root, Thu Nov 29 20:05:59 2007 UTC

… …
265or setgid) then libev will I<not> look at the environment variable 265or setgid) then libev will I<not> look at the environment variable
266C<LIBEV_FLAGS>. Otherwise (the default), this environment variable will 266C<LIBEV_FLAGS>. Otherwise (the default), this environment variable will
267override the flags completely if it is found in the environment. This is 267override the flags completely if it is found in the environment. This is
268useful to try out specific backends to test their performance, or to work 268useful to try out specific backends to test their performance, or to work
269around bugs. 269around bugs.
270
271=item C<EVFLAG_FORKCHECK>
272
273Instead of calling C<ev_default_fork> or C<ev_loop_fork> manually after
274a fork, you can also make libev check for a fork in each iteration by
275enabling this flag.
276
277This works by calling C<getpid ()> on every iteration of the loop,
278and thus this might slow down your event loop if you do a lot of loop
279iterations and little real work, but is usually not noticable (on my
280Linux system for example, C<getpid> is actually a simple 5-insn sequence
281without a syscall and thus I<very> fast, but my Linux system also has
282C<pthread_atfork> which is even faster).
283
284The big advantage of this flag is that you can forget about fork (and
285forget about forgetting to tell libev about forking) when you use this
286flag.
287
288This flag setting cannot be overriden or specified in the C<LIBEV_FLAGS>
289environment variable.
270 290
271=item C<EVBACKEND_SELECT> (value 1, portable select backend) 291=item C<EVBACKEND_SELECT> (value 1, portable select backend)
272 292
273This is your standard select(2) backend. Not I<completely> standard, as 293This is your standard select(2) backend. Not I<completely> standard, as
274libev tries to roll its own fd_set with no limits on the number of fds, 294libev tries to roll its own fd_set with no limits on the number of fds,
… …
1828Similar to the other two macros, this gives you the value of the default 1848Similar to the other two macros, this gives you the value of the default
1829loop, if multiple loops are supported ("ev loop default"). 1849loop, if multiple loops are supported ("ev loop default").
1830 1850
1831=back 1851=back
1832 1852
1833Example: Declare and initialise a check watcher, working regardless of 1853Example: Declare and initialise a check watcher, utilising the above
1834wether multiple loops are supported or not. 1854macros so it will work regardless of wether multiple loops are supported
1855or not.
1835 1856
1836 static void 1857 static void
1837 check_cb (EV_P_ ev_timer *w, int revents) 1858 check_cb (EV_P_ ev_timer *w, int revents)
1838 { 1859 {
1839 ev_check_stop (EV_A_ w); 1860 ev_check_stop (EV_A_ w);
… …
1841 1862
1842 ev_check check; 1863 ev_check check;
1843 ev_check_init (&check, check_cb); 1864 ev_check_init (&check, check_cb);
1844 ev_check_start (EV_DEFAULT_ &check); 1865 ev_check_start (EV_DEFAULT_ &check);
1845 ev_loop (EV_DEFAULT_ 0); 1866 ev_loop (EV_DEFAULT_ 0);
1846
1847 1867
1848=head1 EMBEDDING 1868=head1 EMBEDDING
1849 1869
1850Libev can (and often is) directly embedded into host 1870Libev can (and often is) directly embedded into host
1851applications. Examples of applications that embed it include the Deliantra 1871applications. Examples of applications that embed it include the Deliantra
… …
1891 ev_vars.h 1911 ev_vars.h
1892 ev_wrap.h 1912 ev_wrap.h
1893 1913
1894 ev_win32.c required on win32 platforms only 1914 ev_win32.c required on win32 platforms only
1895 1915
1896 ev_select.c only when select backend is enabled (which is by default) 1916 ev_select.c only when select backend is enabled (which is enabled by default)
1897 ev_poll.c only when poll backend is enabled (disabled by default) 1917 ev_poll.c only when poll backend is enabled (disabled by default)
1898 ev_epoll.c only when the epoll backend is enabled (disabled by default) 1918 ev_epoll.c only when the epoll backend is enabled (disabled by default)
1899 ev_kqueue.c only when the kqueue backend is enabled (disabled by default) 1919 ev_kqueue.c only when the kqueue backend is enabled (disabled by default)
1900 ev_port.c only when the solaris port backend is enabled (disabled by default) 1920 ev_port.c only when the solaris port backend is enabled (disabled by default)
1901 1921
… …
2143interface) and F<EV.xs> (implementation) files. Only the F<EV.xs> file 2163interface) and F<EV.xs> (implementation) files. Only the F<EV.xs> file
2144will be compiled. It is pretty complex because it provides its own header 2164will be compiled. It is pretty complex because it provides its own header
2145file. 2165file.
2146 2166
2147The usage in rxvt-unicode is simpler. It has a F<ev_cpp.h> header file 2167The usage in rxvt-unicode is simpler. It has a F<ev_cpp.h> header file
2148that everybody includes and which overrides some autoconf choices: 2168that everybody includes and which overrides some configure choices:
2149 2169
2170 #define EV_MINIMAL 1
2150 #define EV_USE_POLL 0 2171 #define EV_USE_POLL 0
2151 #define EV_MULTIPLICITY 0 2172 #define EV_MULTIPLICITY 0
2152 #define EV_PERIODICS 0 2173 #define EV_PERIODIC_ENABLE 0
2174 #define EV_STAT_ENABLE 0
2175 #define EV_FORK_ENABLE 0
2153 #define EV_CONFIG_H <config.h> 2176 #define EV_CONFIG_H <config.h>
2177 #define EV_MINPRI 0
2178 #define EV_MAXPRI 0
2154 2179
2155 #include "ev++.h" 2180 #include "ev++.h"
2156 2181
2157And a F<ev_cpp.C> implementation file that contains libev proper and is compiled: 2182And a F<ev_cpp.C> implementation file that contains libev proper and is compiled:
2158 2183

Diff Legend

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