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.64 by root, Sat Dec 1 15:32:53 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,
… …
1437 1457
1438 // create io watchers for each fd and a timer before blocking 1458 // create io watchers for each fd and a timer before blocking
1439 static void 1459 static void
1440 adns_prepare_cb (ev_loop *loop, ev_prepare *w, int revents) 1460 adns_prepare_cb (ev_loop *loop, ev_prepare *w, int revents)
1441 { 1461 {
1442 int timeout = 3600000;truct pollfd fds [nfd]; 1462 int timeout = 3600000;
1463 struct pollfd fds [nfd];
1443 // actual code will need to loop here and realloc etc. 1464 // actual code will need to loop here and realloc etc.
1444 adns_beforepoll (ads, fds, &nfd, &timeout, timeval_from (ev_time ())); 1465 adns_beforepoll (ads, fds, &nfd, &timeout, timeval_from (ev_time ()));
1445 1466
1446 /* the callback is illegal, but won't be called as we stop during check */ 1467 /* the callback is illegal, but won't be called as we stop during check */
1447 ev_timer_init (&tw, 0, timeout * 1e-3); 1468 ev_timer_init (&tw, 0, timeout * 1e-3);
… …
1828Similar to the other two macros, this gives you the value of the default 1849Similar to the other two macros, this gives you the value of the default
1829loop, if multiple loops are supported ("ev loop default"). 1850loop, if multiple loops are supported ("ev loop default").
1830 1851
1831=back 1852=back
1832 1853
1833Example: Declare and initialise a check watcher, working regardless of 1854Example: Declare and initialise a check watcher, utilising the above
1834wether multiple loops are supported or not. 1855macros so it will work regardless of wether multiple loops are supported
1856or not.
1835 1857
1836 static void 1858 static void
1837 check_cb (EV_P_ ev_timer *w, int revents) 1859 check_cb (EV_P_ ev_timer *w, int revents)
1838 { 1860 {
1839 ev_check_stop (EV_A_ w); 1861 ev_check_stop (EV_A_ w);
… …
1841 1863
1842 ev_check check; 1864 ev_check check;
1843 ev_check_init (&check, check_cb); 1865 ev_check_init (&check, check_cb);
1844 ev_check_start (EV_DEFAULT_ &check); 1866 ev_check_start (EV_DEFAULT_ &check);
1845 ev_loop (EV_DEFAULT_ 0); 1867 ev_loop (EV_DEFAULT_ 0);
1846
1847 1868
1848=head1 EMBEDDING 1869=head1 EMBEDDING
1849 1870
1850Libev can (and often is) directly embedded into host 1871Libev can (and often is) directly embedded into host
1851applications. Examples of applications that embed it include the Deliantra 1872applications. Examples of applications that embed it include the Deliantra
… …
1891 ev_vars.h 1912 ev_vars.h
1892 ev_wrap.h 1913 ev_wrap.h
1893 1914
1894 ev_win32.c required on win32 platforms only 1915 ev_win32.c required on win32 platforms only
1895 1916
1896 ev_select.c only when select backend is enabled (which is by default) 1917 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) 1918 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) 1919 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) 1920 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) 1921 ev_port.c only when the solaris port backend is enabled (disabled by default)
1901 1922
… …
2143interface) and F<EV.xs> (implementation) files. Only the F<EV.xs> file 2164interface) 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 2165will be compiled. It is pretty complex because it provides its own header
2145file. 2166file.
2146 2167
2147The usage in rxvt-unicode is simpler. It has a F<ev_cpp.h> header file 2168The usage in rxvt-unicode is simpler. It has a F<ev_cpp.h> header file
2148that everybody includes and which overrides some autoconf choices: 2169that everybody includes and which overrides some configure choices:
2149 2170
2171 #define EV_MINIMAL 1
2150 #define EV_USE_POLL 0 2172 #define EV_USE_POLL 0
2151 #define EV_MULTIPLICITY 0 2173 #define EV_MULTIPLICITY 0
2152 #define EV_PERIODICS 0 2174 #define EV_PERIODIC_ENABLE 0
2175 #define EV_STAT_ENABLE 0
2176 #define EV_FORK_ENABLE 0
2153 #define EV_CONFIG_H <config.h> 2177 #define EV_CONFIG_H <config.h>
2178 #define EV_MINPRI 0
2179 #define EV_MAXPRI 0
2154 2180
2155 #include "ev++.h" 2181 #include "ev++.h"
2156 2182
2157And a F<ev_cpp.C> implementation file that contains libev proper and is compiled: 2183And a F<ev_cpp.C> implementation file that contains libev proper and is compiled:
2158 2184

Diff Legend

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