epoll.7: Some minor clarifications at start of DESCRIPTION

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Michael Kerrisk 2012-04-15 07:23:08 +12:00
parent dfad7db9a2
commit 2b348e568f
1 changed files with 13 additions and 9 deletions

View File

@ -24,21 +24,24 @@ epoll \- I/O event notification facility
.SH SYNOPSIS .SH SYNOPSIS
.B #include <sys/epoll.h> .B #include <sys/epoll.h>
.SH DESCRIPTION .SH DESCRIPTION
The
.B epoll .B epoll
is a variant of API performs a similar task to
.BR poll (2) .BR poll (2):
that can be used either as an edge-triggered or a level-triggered monitoring multiple file descriptors to see if I/O is possible on any of them.
The
.B epoll
API can be used either as an edge-triggered or a level-triggered
interface and scales well to large numbers of watched file descriptors. interface and scales well to large numbers of watched file descriptors.
The following system calls are provided to The following system calls are provided to
create and manage an create and manage an
.B epoll .B epoll
instance: instance:
.IP * 3 .IP * 3
An .BR epoll_create (2)
creates an
.B epoll .B epoll
instance created by instance and returns a file descriptor referring to that instance.
.BR epoll_create (2),
which returns a file descriptor referring to the epoll instance.
(The more recent (The more recent
.BR epoll_create1 (2) .BR epoll_create1 (2)
extends the functionality of extends the functionality of
@ -52,8 +55,9 @@ instance is sometimes called an
.I epoll .I epoll
set. set.
.IP * .IP *
Finally, the actual wait is started by .BR epoll_wait (2)
.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 The
.B epoll .B epoll