epoll_ctl.2: Introduce notion of epoll instance

Introduce notion of epoll instance as distinct from epoll file descriptor.
Plus other wording clean-ups.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Michael Kerrisk 2009-01-16 07:53:24 +13:00
parent ae3faf4b62
commit a58b33605d
1 changed files with 13 additions and 16 deletions

View File

@ -18,7 +18,7 @@
.\"
.\" Davide Libenzi <davidel@xmailserver.org>
.\"
.TH EPOLL_CTL 2 2008-04-25 "Linux" "Linux Programmer's Manual"
.TH EPOLL_CTL 2 2009-01-17 "Linux" "Linux Programmer's Manual"
.SH NAME
epoll_ctl \- control interface for an epoll descriptor
.SH SYNOPSIS
@ -27,11 +27,10 @@ epoll_ctl \- control interface for an epoll descriptor
.BI "int epoll_ctl(int " epfd ", int " op ", int " fd \
", struct epoll_event *" event );
.SH DESCRIPTION
Control an
.B epoll
descriptor,
.IR epfd ,
by requesting that the operation
This system call performs control operations on the epoll instance
referred to by the file descriptor
.IR epfd .
It requests that the operation
.I op
be performed on the target file descriptor,
.IR fd .
@ -119,7 +118,7 @@ The user must call
.BR epoll_ctl ()
with
.B EPOLL_CTL_MOD
to re-enable the file descriptor with a new event mask.
to re-register the file descriptor with a new event mask.
.PP
The
.B epoll
@ -131,11 +130,11 @@ argument are :
.RS
.TP
.B EPOLL_CTL_ADD
Add the target file descriptor
Register the target file descriptor
.I fd
to the
on the
.B epoll
descriptor
instance referred to by the file descriptor
.I epfd
and associate the event
.I event
@ -149,11 +148,11 @@ associated with the target file descriptor
.IR fd .
.TP
.B EPOLL_CTL_DEL
Remove the target file descriptor
Remove (deregister) the target file descriptor
.I fd
from the
.B epoll
file descriptor,
instance referred to by
.IR epfd .
The
.I event
@ -182,8 +181,7 @@ was
.BR EPOLL_CTL_ADD ,
and the supplied file descriptor
.I fd
is already in
.IR epfd .
is already registered with this epoll instance.
.TP
.B EINVAL
.I epfd
@ -206,8 +204,7 @@ or
.BR EPOLL_CTL_DEL ,
and
.I fd
is not in
.IR epfd .
is not registered on with this epoll instance.
.TP
.B ENOMEM
There was insufficient memory to handle the requested