epoll_ctl.2: Reordered parts of the text

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

View File

@ -32,11 +32,45 @@ referred to by the file descriptor
.IR epfd .
It requests that the operation
.I op
be performed on the target file descriptor,
be performed for the target file descriptor,
.IR fd .
Valid values for the
.I op
argument are :
.TP
.B EPOLL_CTL_ADD
Register the target file descriptor
.I fd
on the
.B epoll
instance referred to by the file descriptor
.I epfd
and associate the event
.I event
with the internal file linked to
.IR fd .
.TP
.B EPOLL_CTL_MOD
Change the event
.I event
associated with the target file descriptor
.IR fd .
.TP
.B EPOLL_CTL_DEL
Remove (deregister) the target file descriptor
.I fd
from the
.B epoll
instance referred to by
.IR epfd .
The
.I event
describes the object linked to the file descriptor
is ignored and can be NULL (but see BUGS below).
.PP
The
.I event
argument describes the object linked to the file descriptor
.IR fd .
The
.I struct epoll_event
@ -119,45 +153,6 @@ The user must call
with
.B EPOLL_CTL_MOD
to re-register the file descriptor with a new event mask.
.PP
The
.B epoll
interface supports all file descriptors that support
.BR poll (2).
Valid values for the
.I op
argument are :
.RS
.TP
.B EPOLL_CTL_ADD
Register the target file descriptor
.I fd
on the
.B epoll
instance referred to by the file descriptor
.I epfd
and associate the event
.I event
with the internal file linked to
.IR fd .
.TP
.B EPOLL_CTL_MOD
Change the event
.I event
associated with the target file descriptor
.IR fd .
.TP
.B EPOLL_CTL_DEL
Remove (deregister) the target file descriptor
.I fd
from the
.B epoll
instance referred to by
.IR epfd .
The
.I event
is ignored and can be NULL (but see BUGS below).
.RE
.SH "RETURN VALUE"
When successful,
.BR epoll_ctl ()
@ -220,6 +215,11 @@ does not support
.BR epoll_ctl ()
is Linux-specific, and was introduced in kernel 2.5.44.
.\" The interface should be finalized by Linux kernel 2.5.66.
.SH NOTES
The
.B epoll
interface supports all file descriptors that support
.BR poll (2).
.SH BUGS
In kernel versions before 2.6.9, the
.B EPOLL_CTL_DEL