Bug 58424 – epoll_wait(2) man page missing EINTR

• Status: RESOLVED FIXED
• Product: Gentoo Linux

[Description David Lloyd 2004-07-26 08:31:12 UTC]

The epoll_wait(2) manpage fails to specify that the epoll_wait function can return EINTR if a signal is delivered while waiting for an event.  This is a fairly important tidbit of information. :)

I am only submitting this bug here because I don't know if Gentoo is maitaining its own manual pages.  Also, I'm not sure who does maintain these pages normally; are they part of the glibc distribution?  If you'd like me to forward this request on to someone else, I will.

Thanks.

Reproducible: Always
Steps to Reproduce:
1.
2.
3.

[Comment 1 SpanKY 2004-10-14 19:03:02 UTC]

problem in the man-pages package

[Comment 2 rob holland (RETIRED) 2005-01-05 09:04:09 UTC]

David, can you check this is worded ok wrt to epoll_wait, I just copied it from poll.2

diff -ur man-pages-2.00/man2/epoll_wait.2 man-pages-2.00.new/man2/epoll_wait.2
--- man-pages-2.00/man2/epoll_wait.2	2004-11-03 13:51:07.000000000 +0000
+++ man-pages-2.00.new/man2/epoll_wait.2	2005-01-05 17:52:37.880114584 +0000
@@ -96,6 +96,9 @@
 .I epfd
 is not a valid file descriptor.
 .TP
+.B EINTR
+A signal occured before any requested events.
+.TP
 .B EFAULT
 The memory area pointed to by
 .I events

[Comment 3 David Lloyd 2005-01-10 17:31:15 UTC]

This looks correct to me (of course I'm not a kernel superexpert, just a normal mild-mannered userspace developer).  Might be worth doing a bit more research to see if the other epoll functions can be interrupted, but I think this is the important one.

[Comment 4 rob holland (RETIRED) 2005-01-20 15:21:04 UTC]

*stamp of approval*

Thanks David, didn't notice your reply come through on email for some reason.

[Comment 5 SpanKY 2005-03-16 18:50:12 UTC]

added to 2.01 w/out rev bump

thanks guys