epoll_ctl.2: After EPOLLHUP, EOF will be seen only after all data has been consumed

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

diff --git a/man2/epoll_ctl.2 b/man2/epoll_ctl.2
index 39d00065327afacc2c6aa6caf8bb964775cdc06b..1acf71402a127d347b8481644cde781c2f1cba49 100644 (file)
--- a/man2/epoll_ctl.2
+++ b/man2/epoll_ctl.2
@@ -130,6 +130,10 @@ Hang up happened on the associated file descriptor.
 .BR epoll_wait (2)
 will always wait for this event; it is not necessary to set it in
 .IR events .
+Note that when reading from a channel such as a pipe or a stream socket,
+this event merely indicates that the peer closed its end of the channel.
+Subsequent reads from the channel will return 0 (end of file)
+only after all outstanding data in the channel has been consumed.
 .TP
 .B EPOLLET
 Sets the Edge Triggered behavior for the associated file descriptor.