Re: [patch] Document fork() behaviour for the Linux native AIO io_context

[Michael Kerrisk <mtk.manpages-gM/Ye1E23mwN+BqQ9rBEUg@public.gmane.org>]

Hi Jeff,

On Wed, Apr 15, 2009 at 5:54 AM, Jeff Moyer <jmoyer-H+wXaHxf7aLQT0dZR+AlfA@public.gmane.org> wrote:
> Hi,
>
> It was noted on lkml that the fork behaviour is documented for the posix
> AIO calls, but not for the Linux native calls.  Here is a patch which
> adds a small blurb that folks will hopefully find useful.
>
> Signed-off-by: Jeff Moyer <jmoyer-H+wXaHxf7aLQT0dZR+AlfA@public.gmane.org>
>
> Upon fork, the child process does not inherit the io_context_t data structures
> returned by io_setup, and thus cannot submit further asynchronous I/O or
> reap event completions for said contexts.

Thanks.  I tweaked that very slightly, and have applied for man-pages-3.22.

Cheers,

Michael

--- a/man2/fork.2
+++ b/man2/fork.2
@@ -83,7 +83,9 @@ The child does not inherit timers from its parent
 The child does not inherit outstanding asynchronous I/O operations
 from its parent
 .RB ( aio_read (3),
-.BR aio_write (3)).
+.BR aio_write (3)),
+nor does it inherit outstanding asynchronous I/O context from its parent
+.RB ( io_setup (2)).
 .PP
 The process attributes in the preceding list are all specified
 in POSIX.1-2001.



> diff --git a/man2/fork.2 b/man2/fork.2
> index ce93b3e..fb9008e 100644
> --- a/man2/fork.2
> +++ b/man2/fork.2
> @@ -83,7 +83,9 @@ The child does not inherit timers from its parent
>  The child does not inherit outstanding asynchronous I/O operations
>  from its parent
>  .RB ( aio_read (3),
> -.BR aio_write (3)).
> +.BR aio_write (3)),
> +nor does it inherit the asynchronous io_context returned by
> +.BR io_setup (2).
>  .PP
>  The process attributes in the preceding list are all specified
>  in POSIX.1-2001.
>



-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
git://git.kernel.org/pub/scm/docs/man-pages/man-pages.git
man-pages online: http://www.kernel.org/doc/man-pages/online_pages.html
Found a bug? http://www.kernel.org/doc/man-pages/reporting_bugs.html
--
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