poll.2: Document negative value in 'fd' field

Reported-by: Michael Welsh Duggan <mwd@cert.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Michael Kerrisk 2012-04-15 23:45:42 +12:00
parent ef30129360
commit 096ca08af4
1 changed files with 12 additions and 1 deletions

View File

@ -28,7 +28,7 @@
.\" 2006-07-01, mtk, Added POLLRDHUP + various other wording and
.\" formatting changes.
.\"
.TH POLL 2 2010-09-20 "Linux" "Linux Programmer's Manual"
.TH POLL 2 2012-04-15 "Linux" "Linux Programmer's Manual"
.SH NAME
poll, ppoll \- wait for some event on a file descriptor
.SH SYNOPSIS
@ -72,6 +72,17 @@ array in
The field
.I fd
contains a file descriptor for an open file.
If this field is negative, then the corresponding
.I events
field is ignored and the
.I revents
field returns zero.
(This provides an easy way of ignoring a
file descriptor for a single
.BR poll ()
call: simply negate the
.I fd
field.)
The field
.I events