poll.2: Remove EBADF error from ERRORS

As reported by Motohiro:

"man poll" describe this error code.

>ERRORS
>   EBADF  An invalid file descriptor was given in one of the sets.

but current kernel implementation ignore invalid file descriptor,
not return EBADF.
...

In the other hand, SUSv3 talk about

> POLLNVAL
>    The specified fd value is invalid. This flag is only valid in the
>    revents member; it shall ignored in the events member.

and

> If the value of fd is less than 0, events shall be ignored, and
> ireevents shall be set to 0 in that entry on return from poll().

but, no desribe EBADF.
(see http://www.opengroup.org/onlinepubs/009695399/functions/poll.html)

So, I think the implementation is correct.

Why don't we remove EBADF description?

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Reported-by: KOSAKI Motohiro <kosaki.motohiro@jp.fujitsu.com>
This commit is contained in:
Michael Kerrisk 2008-06-11 02:09:08 +02:00
parent c7a20d46be
commit f1a291ecd0
1 changed files with 1 additions and 4 deletions

View File

@ -28,7 +28,7 @@
.\" 2006-07-01, mtk, Added POLLRDHUP + various other wording and
.\" formatting changes.
.\"
.TH POLL 2 2008-04-23 "Linux" "Linux Programmer's Manual"
.TH POLL 2 2009-06-02 "Linux" "Linux Programmer's Manual"
.SH NAME
poll, ppoll \- wait for some event on a file descriptor
.SH SYNOPSIS
@ -256,9 +256,6 @@ On error, \-1 is returned, and
is set appropriately.
.SH ERRORS
.TP
.B EBADF
An invalid file descriptor was given in one of the sets.
.TP
.B EFAULT
The array given as argument was not contained in the calling program's
address space.