https://bugzilla.kernel.org/show_bug.cgi?id=61911 Bug ID: 61911 Summary: incorrect sentence in the description of struct pollfd's events field Product: Documentation Version: unspecified Hardware: All OS: Linux Status: NEW Severity: normal Priority: P1 Component: man-pages Assignee: documentation_man-pages@xxxxxxxxxxxxxxxxxxxx Reporter: bonzini@xxxxxxx Regression: No The manual page says: The field events is an input parameter, a bit mask specifying the events the application is interested in for the file descriptor fd. If this field is specified as zero, then all events are ignored for fd and revents returns zero. However, this is not what happens. POLLHUP and POLLERR are always reported (as one would expect, actually). Test case 1: #include <poll.h> int main(void) { struct pollfd pfd = { .fd = 0 }; sleep(1); poll(&pfd, 1, 0); } $ echo x > fifo & strace -e poll ./a.out < fifo poll([{fd=0, events=0}], 1, 0) = 1 ([{fd=0, revents=POLLHUP}]) Test case 2: #include <poll.h> int main(void) { struct pollfd pfd = { .fd = 1 }; sleep(1); poll(&pfd, 1, 0); } $ :< fifo & strace -e poll ./a.out > fifo poll([{fd=1, events=0}], 1, 0) = 1 ([{fd=1, revents=POLLERR}]) -- You are receiving this mail because: You are watching the assignee of the bug. -- To unsubscribe from this list: send the line "unsubscribe linux-man" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html
