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

Comparing libev/ev.pod (file contents):
Revision 1.88 by ayin, Tue Dec 18 13:06:18 2007 UTC vs.
Revision 1.90 by root, Thu Dec 20 01:18:37 2007 UTC

… …
331 331
332=item C<EVBACKEND_KQUEUE> (value 8, most BSD clones) 332=item C<EVBACKEND_KQUEUE> (value 8, most BSD clones)
333 333
334Kqueue deserves special mention, as at the time of this writing, it 334Kqueue deserves special mention, as at the time of this writing, it
335was broken on all BSDs except NetBSD (usually it doesn't work with 335was broken on all BSDs except NetBSD (usually it doesn't work with
336anything but sockets and pipes, except on Darwin, where of course its 336anything but sockets and pipes, except on Darwin, where of course it's
337completely useless). For this reason its not being "autodetected" 337completely useless). For this reason it's not being "autodetected"
338unless you explicitly specify it explicitly in the flags (i.e. using 338unless you explicitly specify it explicitly in the flags (i.e. using
339C<EVBACKEND_KQUEUE>). 339C<EVBACKEND_KQUEUE>).
340 340
341It scales in the same way as the epoll backend, but the interface to the 341It scales in the same way as the epoll backend, but the interface to the
342kernel is more efficient (which says nothing about its actual speed, of 342kernel is more efficient (which says nothing about its actual speed, of
… …
2250 2250
2251If defined to be C<1>, libev will try to detect the availability of the 2251If defined to be C<1>, libev will try to detect the availability of the
2252realtime clock option at compiletime (and assume its availability at 2252realtime clock option at compiletime (and assume its availability at
2253runtime if successful). Otherwise no use of the realtime clock option will 2253runtime if successful). Otherwise no use of the realtime clock option will
2254be attempted. This effectively replaces C<gettimeofday> by C<clock_get 2254be attempted. This effectively replaces C<gettimeofday> by C<clock_get
2255(CLOCK_REALTIME, ...)> and will not normally affect correctness. See tzhe note about libraries 2255(CLOCK_REALTIME, ...)> and will not normally affect correctness. See the
2256in the description of C<EV_USE_MONOTONIC>, though. 2256note about libraries in the description of C<EV_USE_MONOTONIC>, though.
2257 2257
2258=item EV_USE_SELECT 2258=item EV_USE_SELECT
2259 2259
2260If undefined or defined to be C<1>, libev will compile in support for the 2260If undefined or defined to be C<1>, libev will compile in support for the
2261C<select>(2) backend. No attempt at autodetection will be done: if no 2261C<select>(2) backend. No attempt at autodetection will be done: if no
… …
2445definition and a statement, respectively. See the F<ev.v> header file for 2445definition and a statement, respectively. See the F<ev.v> header file for
2446their default definitions. One possible use for overriding these is to 2446their default definitions. One possible use for overriding these is to
2447avoid the C<struct ev_loop *> as first argument in all cases, or to use 2447avoid the C<struct ev_loop *> as first argument in all cases, or to use
2448method calls instead of plain function calls in C++. 2448method calls instead of plain function calls in C++.
2449 2449
2450=head2 EXPORTED API SYMBOLS
2451
2452If you need to re-export the API (e.g. via a dll) and you need a list of
2453exported symbols, you can use the provided F<Symbol.*> files which list
2454all public symbols, one per line:
2455
2456 Symbols.ev for libev proper
2457 Symbols.event for the libevent emulation
2458
2459This can also be used to rename all public symbols to avoid clashes with
2460multiple versions of libev linked together (which is obviously bad in
2461itself, but sometimes it is inconvinient to avoid this).
2462
2463A sed comamnd like this will create wrapper C<#define>'s that you need to
2464include before including F<ev.h>:
2465
2466 <Symbols.ev sed -e "s/.*/#define & myprefix_&/" >wrap.h
2467
2468This would create a file F<wrap.h> which essentially looks like this:
2469
2470 #define ev_backend myprefix_ev_backend
2471 #define ev_check_start myprefix_ev_check_start
2472 #define ev_check_stop myprefix_ev_check_stop
2473 ...
2474
2450=head2 EXAMPLES 2475=head2 EXAMPLES
2451 2476
2452For a real-world example of a program the includes libev 2477For a real-world example of a program the includes libev
2453verbatim, you can have a look at the EV perl module 2478verbatim, you can have a look at the EV perl module
2454(L<http://software.schmorp.de/pkg/EV.html>). It has the libev files in 2479(L<http://software.schmorp.de/pkg/EV.html>). It has the libev files in

Diff Legend

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