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

Comparing libev/ev.pod (file contents):
Revision 1.211 by root, Mon Nov 3 14:34:16 2008 UTC vs.
Revision 1.213 by root, Wed Nov 5 02:48:45 2008 UTC

417i.e. keep at least one watcher active per fd at all times. Stopping and 417i.e. keep at least one watcher active per fd at all times. Stopping and
418starting a watcher (without re-setting it) also usually doesn't cause 418starting a watcher (without re-setting it) also usually doesn't cause
419extra overhead. A fork can both result in spurious notifications as well 419extra overhead. A fork can both result in spurious notifications as well
420as in libev having to destroy and recreate the epoll object, which can 420as in libev having to destroy and recreate the epoll object, which can
421take considerable time and thus should be avoided. 421take considerable time and thus should be avoided.
422
423All this means that, in practise, C<EVBACKEND_SELECT> is as fast or faster
424then epoll for maybe up to a hundred file descriptors. So sad.
422 425
423While nominally embeddable in other event loops, this feature is broken in 426While nominally embeddable in other event loops, this feature is broken in
424all kernel versions tested so far. 427all kernel versions tested so far.
425 428
426This backend maps C<EV_READ> and C<EV_WRITE> in the same way as 429This backend maps C<EV_READ> and C<EV_WRITE> in the same way as
1998There is no support for kqueue, as apparently it cannot be used to 2001There is no support for kqueue, as apparently it cannot be used to
1999implement this functionality, due to the requirement of having a file 2002implement this functionality, due to the requirement of having a file
2000descriptor open on the object at all times, and detecting renames, unlinks 2003descriptor open on the object at all times, and detecting renames, unlinks
2001etc. is difficult. 2004etc. is difficult.
2002 2005
2006=head3 C<stat ()> is a synchronous operation
2007
2008Libev doesn't normally do any kind of I/O itself, and so is not blocking
2009the process. The exception are C<ev_stat> watchers - those call C<stat
2010()>, which is a synchronous operation.
2011
2012For local paths, this usually doesn't matter: unless the system is very
2013busy or the intervals between stat's are large, a stat call will be fast,
2014as the path data is suually in memory already (except when starting the
2015watcher).
2016
2017For networked file systems, calling C<stat ()> can block an indefinite
2018time due to network issues, and even under good conditions, a stat call
2019often takes multiple milliseconds.
2020
2021Therefore, it is best to avoid using C<ev_stat> watchers on networked
2022paths, although this is fully supported by libev.
2023
2003=head3 The special problem of stat time resolution 2024=head3 The special problem of stat time resolution
2004 2025
2005The C<stat ()> system call only supports full-second resolution portably, 2026The C<stat ()> system call only supports full-second resolution portably,
2006and even on systems where the resolution is higher, most file systems 2027and even on systems where the resolution is higher, most file systems
2007still only support whole seconds. 2028still only support whole seconds.

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines