[PATCH] io_submit.2: acknowledge possibility of short return

[PATCH] io_submit.2: acknowledge possibility of short return

[Sage Weil]

Note that the return value may be a value less than nr
if not all iocbs were queued at once.  This would have saved
me an embarrassing amount of time.

Signed-off-by: Sage Weil <sage-H+wXaHxf7aLQT0dZR+AlfA@public.gmane.org>
---
 man2/io_submit.2 | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/man2/io_submit.2 b/man2/io_submit.2
index 36465b64b..77ba34671 100644
--- a/man2/io_submit.2
+++ b/man2/io_submit.2
@@ -32,7 +32,7 @@ which will be submitted to context \fIctx_id\fP.
 On success,
 .BR io_submit ()
 returns the number of \fIiocb\fPs submitted (which may be
-0 if \fInr\fP is zero).
+less than \fInr\fP, or 0 if \fInr\fP is zero).
 For the failure return, see NOTES.
 .SH ERRORS
 .TP
-- 
2.13.3

--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Re: [PATCH] io_submit.2: acknowledge possibility of short return

[Michael Kerrisk (man-opages)]

Hello Sage,

On 09/07/2017 10:44 PM, Sage Weil wrote:
> Note that the return value may be a value less than nr
> if not all iocbs were queued at once.  This would have saved
> me an embarrassing amount of time.

Thanks. Applied!

Cheers,

Michael


> Signed-off-by: Sage Weil <sage-H+wXaHxf7aLQT0dZR+AlfA@public.gmane.org>
> ---
>   man2/io_submit.2 | 2 +-
>   1 file changed, 1 insertion(+), 1 deletion(-)
> 
> diff --git a/man2/io_submit.2 b/man2/io_submit.2
> index 36465b64b..77ba34671 100644
> --- a/man2/io_submit.2
> +++ b/man2/io_submit.2
> @@ -32,7 +32,7 @@ which will be submitted to context \fIctx_id\fP.
>   On success,
>   .BR io_submit ()
>   returns the number of \fIiocb\fPs submitted (which may be
> -0 if \fInr\fP is zero).
> +less than \fInr\fP, or 0 if \fInr\fP is zero).
>   For the failure return, see NOTES.
>   .SH ERRORS
>   .TP
> 
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html