LDP: Update original to LDP v3.68

[linuxjm/LDP_man-pages.git] / original / man7 / epoll.7

diff --git a/original/man7/epoll.7 b/original/man7/epoll.7
index 19032f2..4099295 100644 (file)
--- a/original/man7/epoll.7
+++ b/original/man7/epoll.7
@@ -1,7 +1,6 @@
-.\"
-.\"  epoll by Davide Libenzi ( efficient event notification retrieval )
 .\"  Copyright (C) 2003  Davide Libenzi
 .\"
+.\" %%%LICENSE_START(GPLv2+_SW_3_PARA)
 .\"  This program is free software; you can redistribute it and/or modify
 .\"  it under the terms of the GNU General Public License as published by
 .\"  the Free Software Foundation; either version 2 of the License, or
@@ -12,9 +11,10 @@
 .\"  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 .\"  GNU General Public License for more details.
 .\"
-.\"  You should have received a copy of the GNU General Public License
-.\"  along with this program; if not, write to the Free Software
-.\"  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+.\" You should have received a copy of the GNU General Public
+.\" License along with this manual; if not, see
+.\" <http://www.gnu.org/licenses/>.
+.\" %%%LICENSE_END
 .\"
 .\"  Davide Libenzi <davidel@xmailserver.org>
 .\"
@@ -58,7 +58,7 @@ set.
 .BR epoll_wait (2)
 waits for I/O events,
 blocking the calling thread if no events are currently available.
-.SS Level-Triggered and Edge-Triggered
+.SS Level-triggered and edge-triggered
 The
 .B epoll
 event distribution interface is able to behave both as edge-triggered
@@ -104,8 +104,8 @@ will probably hang despite the available data still present in the file
 input buffer;
 meanwhile the remote peer might be expecting a response based on the
 data it already sent.
-The reason for this is that edge-triggered mode only
-delivers events when changes occur on the monitored file descriptor.
+The reason for this is that edge-triggered mode
+delivers events only when changes occur on the monitored file descriptor.
 So, in step
 .B 5
 the caller might end up waiting for some data that is already present inside
@@ -195,7 +195,7 @@ the default value for
 .I max_user_watches
 is 1/25 (4%) of the available low memory,
 divided by the registration cost in bytes.
-.SS Example for Suggested Usage
+.SS Example for suggested usage
 While the usage of
 .B epoll
 when employed as a level-triggered interface does have the same
@@ -294,7 +294,7 @@ calling
 .BR epoll_ctl (2)
 with
 .BR EPOLL_CTL_MOD .
-.SS Questions and Answers
+.SS Questions and answers
 .TP 4
 .B Q0
 What is the key used to distinguish the file descriptors registered in an
@@ -364,7 +364,7 @@ file descriptor itself poll/epoll/selectable?
 Yes.
 If an
 .B epoll
-file descriptor has events waiting then it will
+file descriptor has events waiting, then it will
 indicate as being readable.
 .TP
 .B Q4
@@ -484,7 +484,7 @@ The same is true when writing using
 .BR write (2).
 (Avoid this latter technique if you cannot guarantee that
 the monitored file descriptor always refers to a stream-oriented file.)
-.SS Possible Pitfalls and Ways to Avoid Them
+.SS Possible pitfalls and ways to avoid them
 .TP
 .B o Starvation (edge-triggered)
 .PP
@@ -543,8 +543,17 @@ mechanisms, for example, FreeBSD has
 .IR kqueue ,
 and Solaris has
 .IR /dev/poll .
-.SH "SEE ALSO"
+.SH SEE ALSO
 .BR epoll_create (2),
 .BR epoll_create1 (2),
 .BR epoll_ctl (2),
 .BR epoll_wait (2)
+.SH COLOPHON
+This page is part of release 3.68 of the Linux
+.I man-pages
+project.
+A description of the project,
+information about reporting bugs,
+and the latest version of this page,
+can be found at
+\%http://www.kernel.org/doc/man\-pages/.