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

Comparing libev/ev.pod (file contents):
Revision 1.336 by root, Mon Oct 25 11:10:10 2010 UTC vs.
Revision 1.338 by root, Sun Oct 31 21:16:26 2010 UTC

463epoll scales either O(1) or O(active_fds). 463epoll scales either O(1) or O(active_fds).
464 464
465The epoll mechanism deserves honorable mention as the most misdesigned 465The epoll mechanism deserves honorable mention as the most misdesigned
466of the more advanced event mechanisms: mere annoyances include silently 466of the more advanced event mechanisms: mere annoyances include silently
467dropping file descriptors, requiring a system call per change per file 467dropping file descriptors, requiring a system call per change per file
468descriptor (and unnecessary guessing of parameters), problems with dup and 468descriptor (and unnecessary guessing of parameters), problems with dup,
469returning before the timeout value, resulting in additional iterations
470(and only giving 5ms accuracy while select on the same platform gives
469so on. The biggest issue is fork races, however - if a program forks then 4710.1ms) and so on. The biggest issue is fork races, however - if a program
470I<both> parent and child process have to recreate the epoll set, which can 472forks then I<both> parent and child process have to recreate the epoll
471take considerable time (one syscall per file descriptor) and is of course 473set, which can take considerable time (one syscall per file descriptor)
472hard to detect. 474and is of course hard to detect.
473 475
474Epoll is also notoriously buggy - embedding epoll fds I<should> work, but 476Epoll is also notoriously buggy - embedding epoll fds I<should> work, but
475of course I<doesn't>, and epoll just loves to report events for totally 477of course I<doesn't>, and epoll just loves to report events for totally
476I<different> file descriptors (even already closed ones, so one cannot 478I<different> file descriptors (even already closed ones, so one cannot
477even remove them from the set) than registered in the set (especially 479even remove them from the set) than registered in the set (especially
478on SMP systems). Libev tries to counter these spurious notifications by 480on SMP systems). Libev tries to counter these spurious notifications by
479employing an additional generation counter and comparing that against the 481employing an additional generation counter and comparing that against the
480events to filter out spurious ones, recreating the set when required. Last 482events to filter out spurious ones, recreating the set when required. Last
481not least, it also refuses to work with some file descriptors which work 483not least, it also refuses to work with some file descriptors which work
482perfectly fine with C<select> (files, many character devices...). 484perfectly fine with C<select> (files, many character devices...).
485
486Epoll is truly the train wreck analog among event poll mechanisms.
483 487
484While stopping, setting and starting an I/O watcher in the same iteration 488While stopping, setting and starting an I/O watcher in the same iteration
485will result in some caching, there is still a system call per such 489will result in some caching, there is still a system call per such
486incident (because the same I<file descriptor> could point to a different 490incident (because the same I<file descriptor> could point to a different
487I<file description> now), so its best to avoid that. Also, C<dup ()>'ed 491I<file description> now), so its best to avoid that. Also, C<dup ()>'ed

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines