gh-127481: Add EPOLLWAKEUP to the select module

Doc/library/select.rst

@@ -284,31 +284,31 @@
    | Constant                | Meaning                                       |
    +=========================+===============================================+
    | :const:`EPOLLIN`        | Available for read                            |
    +-------------------------+-----------------------------------------------+
    | :const:`EPOLLOUT`       | Available for write                           |
    +-------------------------+-----------------------------------------------+
    | :const:`EPOLLPRI`       | Urgent data for read                          |
    +-------------------------+-----------------------------------------------+
    | :const:`EPOLLERR`       | Error condition happened on the assoc. fd     |
    +-------------------------+-----------------------------------------------+
    | :const:`EPOLLHUP`       | Hang up happened on the assoc. fd             |
    +-------------------------+-----------------------------------------------+
    | :const:`EPOLLET`        | Set Edge Trigger behavior, the default is     |
    |                         | Level Trigger behavior                        |
    +-------------------------+-----------------------------------------------+
    | :const:`EPOLLONESHOT`   | Set one-shot behavior. After one event is     |
    |                         | pulled out, the fd is internally disabled     |
    +-------------------------+-----------------------------------------------+
    | :const:`EPOLLEXCLUSIVE` | Wake only one epoll object when the           |
    |                         | associated fd has an event. The default (if   |
    |                         | this flag is not set) is to wake all epoll    |
    |                         | objects polling on a fd.                      |
    +-------------------------+-----------------------------------------------+
    | :const:`EPOLLRDHUP`     | Stream socket peer closed connection or shut  |
    |                         | down writing half of connection.              |
    +-------------------------+-----------------------------------------------+
    | :const:`EPOLLRDNORM`    | Equivalent to :const:`EPOLLIN`                |
    +-------------------------+-----------------------------------------------+
    | :const:`EPOLLRDBAND`    | Priority data band can be read.               |
    +-------------------------+-----------------------------------------------+
    | :const:`EPOLLWRNORM`    | Equivalent to :const:`EPOLLOUT`               |
@@ -317,11 +317,17 @@
    +-------------------------+-----------------------------------------------+
    | :const:`EPOLLMSG`       | Ignored.                                      |
    +-------------------------+-----------------------------------------------+
+   | :const:`EPOLLWAKEUP`    | Prevents sleep during event waiting.          |
+   +-------------------------+-----------------------------------------------+
 
    .. versionadded:: 3.6
       :const:`EPOLLEXCLUSIVE` was added.  It's only supported by Linux Kernel 4.5
       or later.
 
+   .. versionadded:: 3.14
+      :const:`EPOLLWAKEUP` was added. It's only supported by Linux Kernel 3.5
+      or later.
+
 .. method:: epoll.close()
 
    Close the control file descriptor of the epoll object.

Misc/NEWS.d/next/Library/2024-12-01-23-18-43.gh-issue-127481.K36AoP.rst

@@ -0,0 +1,2 @@
+Add the ``EPOLLWAKEUP`` constants to the :mod:`select`
+module.

Modules/selectmodule.c

@@ -2715,6 +2715,10 @@ _select_exec(PyObject *m)
 #ifdef EPOLLMSG
     ADD_INT(EPOLLMSG);
 #endif
+#ifdef EPOLLWAKEUP
+    /* Kernel 3.5+ */
+    ADD_INT(EPOLLWAKEUP);
+#endif
 
 #ifdef EPOLL_CLOEXEC
     ADD_INT(EPOLL_CLOEXEC);