Re: [LTP] Return value explanation about io_channel.c

[Jeff M. <jm...@re...>]

"Michael Kerrisk" <mtk...@go...> writes:

> On Wed, Jun 18, 2008 at 6:28 PM, Michael Kerrisk
>
> And the text I'll add to each page is something like this:
>
>    RETURN VALUE
>        On  success,  io_cancel()  returns  0.   For  the failure
>        return, see NOTES.
>
>    NOTES
>        Glibc does not provide a wrapper function for this system
>        call.
>
>        The  wrapper  provided in libaio for io_cancel() does not
>        follow the usual C  library  conventions  for  indicating
>        error:  on  error  it returns a negated error number (the
>        negative of one of the values listed in ERRORS).  If  the
>        system  call  is  invoked via syscall(2), then the return
>        value follows the usual  conventions  for  indicating  an
>        error:  -1,  with  errno  set  to a (positive) value that
>        indicates the error.
>
> Seem okay?

That looks fine to me.  Thanks for your persistence;  we all benefit
from better documentation.

Cheers,

Jeff