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

Comparing libev/ev.pod (file contents):
Revision 1.217 by root, Mon Nov 17 03:37:08 2008 UTC vs.
Revision 1.218 by root, Thu Nov 20 00:35:10 2008 UTC

… …
2999Tony Arcieri has written a ruby extension that offers access to a subset 2999Tony Arcieri has written a ruby extension that offers access to a subset
3000of the libev API and adds file handle abstractions, asynchronous DNS and 3000of the libev API and adds file handle abstractions, asynchronous DNS and
3001more on top of it. It can be found via gem servers. Its homepage is at 3001more on top of it. It can be found via gem servers. Its homepage is at
3002L<http://rev.rubyforge.org/>. 3002L<http://rev.rubyforge.org/>.
3003 3003
3004Roger Pack reports that using the link order C<-lws2_32 -lmsvcrt-ruby-190>
3005makes rev work even on mingw.
3006
3004=item D 3007=item D
3005 3008
3006Leandro Lucarella has written a D language binding (F<ev.d>) for libev, to 3009Leandro Lucarella has written a D language binding (F<ev.d>) for libev, to
3007be found at L<http://proj.llucax.com.ar/wiki/evd>. 3010be found at L<http://proj.llucax.com.ar/wiki/evd>.
3008 3011
… …
3184keeps libev from including F<config.h>, and it also defines dummy 3187keeps libev from including F<config.h>, and it also defines dummy
3185implementations for some libevent functions (such as logging, which is not 3188implementations for some libevent functions (such as logging, which is not
3186supported). It will also not define any of the structs usually found in 3189supported). It will also not define any of the structs usually found in
3187F<event.h> that are not directly supported by the libev core alone. 3190F<event.h> that are not directly supported by the libev core alone.
3188 3191
3192In stanbdalone mode, libev will still try to automatically deduce the
3193configuration, but has to be more conservative.
3194
3189=item EV_USE_MONOTONIC 3195=item EV_USE_MONOTONIC
3190 3196
3191If defined to be C<1>, libev will try to detect the availability of the 3197If defined to be C<1>, libev will try to detect the availability of the
3192monotonic clock option at both compile time and runtime. Otherwise no use 3198monotonic clock option at both compile time and runtime. Otherwise no
3193of the monotonic clock option will be attempted. If you enable this, you 3199use of the monotonic clock option will be attempted. If you enable this,
3194usually have to link against librt or something similar. Enabling it when 3200you usually have to link against librt or something similar. Enabling it
3195the functionality isn't available is safe, though, although you have 3201when the functionality isn't available is safe, though, although you have
3196to make sure you link against any libraries where the C<clock_gettime> 3202to make sure you link against any libraries where the C<clock_gettime>
3197function is hiding in (often F<-lrt>). 3203function is hiding in (often F<-lrt>). See also C<EV_USE_CLOCK_SYSCALL>.
3198 3204
3199=item EV_USE_REALTIME 3205=item EV_USE_REALTIME
3200 3206
3201If defined to be C<1>, libev will try to detect the availability of the 3207If defined to be C<1>, libev will try to detect the availability of the
3202real-time clock option at compile time (and assume its availability at 3208real-time clock option at compile time (and assume its availability at
3203runtime if successful). Otherwise no use of the real-time clock option will 3209runtime if successful). Otherwise no use of the real-time clock option will
3204be attempted. This effectively replaces C<gettimeofday> by C<clock_get 3210be attempted. This effectively replaces C<gettimeofday> by C<clock_get
3205(CLOCK_REALTIME, ...)> and will not normally affect correctness. See the 3211(CLOCK_REALTIME, ...)> and will not normally affect correctness. See the
3206note about libraries in the description of C<EV_USE_MONOTONIC>, though. 3212note about libraries in the description of C<EV_USE_MONOTONIC>, though.
3207 3213
3214=item EV_USE_CLOCK_SYSCALL
3215
3216If defined to be C<1>, libev will try to use a direct syscall instead
3217of calling the system-provided C<clock_gettime> function. This option
3218exists because on GNU/Linux, C<clock_gettime> is in C<librt>, but C<librt>
3219unconditionally pulls in C<libpthread>, slowing down single-threaded
3220programs needlessly. Using a direct syscall is slightly slower, because
3221no optimised vdso implementation can be used, but avoids the pthread
3222dependency. Defaults to C<1> on GNU/Linux with glibc 2.x or higher.
3223
3208=item EV_USE_NANOSLEEP 3224=item EV_USE_NANOSLEEP
3209 3225
3210If defined to be C<1>, libev will assume that C<nanosleep ()> is available 3226If defined to be C<1>, libev will assume that C<nanosleep ()> is available
3211and will use it for delays. Otherwise it will use C<select ()>. 3227and will use it for delays. Otherwise it will use C<select ()>.
3212 3228
… …
3227 3243
3228=item EV_SELECT_USE_FD_SET 3244=item EV_SELECT_USE_FD_SET
3229 3245
3230If defined to C<1>, then the select backend will use the system C<fd_set> 3246If defined to C<1>, then the select backend will use the system C<fd_set>
3231structure. This is useful if libev doesn't compile due to a missing 3247structure. This is useful if libev doesn't compile due to a missing
3232C<NFDBITS> or C<fd_mask> definition or it mis-guesses the bitset layout on 3248C<NFDBITS> or C<fd_mask> definition or it mis-guesses the bitset layout
3233exotic systems. This usually limits the range of file descriptors to some 3249on exotic systems. This usually limits the range of file descriptors to
3234low limit such as 1024 or might have other limitations (winsocket only 3250some low limit such as 1024 or might have other limitations (winsocket
3235allows 64 sockets). The C<FD_SETSIZE> macro, set before compilation, might 3251only allows 64 sockets). The C<FD_SETSIZE> macro, set before compilation,
3236influence the size of the C<fd_set> used. 3252configures the maximum size of the C<fd_set>.
3237 3253
3238=item EV_SELECT_IS_WINSOCKET 3254=item EV_SELECT_IS_WINSOCKET
3239 3255
3240When defined to C<1>, the select backend will assume that 3256When defined to C<1>, the select backend will assume that
3241select/socket/connect etc. don't understand file descriptors but 3257select/socket/connect etc. don't understand file descriptors but

Diff Legend

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