On Mon, Dec 23, 2019 at 6:07 AM Ingo Schwarze <schwa...@usta.de> wrote:

> Theo de Raadt wrote on Sun, Dec 22, 2019 at 05:34:45PM -0700:
> > Philip Guenther <guent...@gmail.com> wrote:
> >> Somebody wrote:
>
> >>> The man pages for readv and writev don't document the possibility of
> >>> such errors.
>
> >> IMO, weird errnos from devices should be documented in the manpage for
> the
> >> device.  Consider the termios(4) manpage, for example.
>
> > I agree on that.  Otherwise the information-flood is too much.
> >
> > But I think some of our manual pages are a bit weak indicating there
> > are other errors not listed:
>
> Is the following good enough?
>
> Or are you saying that *all* section 2 and 3 manual pages should be
> reworded to say:  "FOOBAR may for example fail if:"?
>

Not all.  For section 2 it's the calls that take an fd that need to be
open-ended about errors.

Philip Guenther

Reply via email to