[New-bugs-announce] [issue16873] increase epoll.poll() maxevents default value, and improve documentation

[Charles-François Natali]

New submission from Charles-François Natali:

In issue #16853, it was noted that many several projects don't set epoll.poll() maxevents argument, which effectively limits the number of events retuend to FD_SETSIZE-1 (set in selectmodule.c).

Also, the methode documentation can confuse users into thinking that by default, the number of events is unlimited:
"""

.. method:: epoll.poll(timeout=-1, maxevents=-1)

   Wait for events. timeout in seconds (float)
"""

It would probably make sense to use a larger default value for epoll max events (the only downside is increased memory consumption for the events array), maybe based on RLIMIT_NOFILE hard limit.
And the documentation should probably be improved.

----------
components: Library (Lib)
messages: 179157
nosy: neologix
priority: normal
severity: normal
stage: needs patch
status: open
title: increase epoll.poll() maxevents default value, and improve documentation
type: enhancement
versions: Python 3.4

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue16873>
_______________________________________