Re: [PATCH] man2/prctl.2: Add PR_GET_TID_ADDRESS description

[Michael Kerrisk (man-pages)]

Hi Cyril,

On Tue, Feb 19, 2013 at 4:47 PM, Cyrill Gorcunov <gorcunov@xxxxxxxxxx> wrote:
> Signed-off-by: Cyrill Gorcunov <gorcunov@xxxxxxxxxx>
> ---
>  man2/prctl.2 | 12 ++++++++++++
>  1 file changed, 12 insertions(+)
>
> diff --git a/man2/prctl.2 b/man2/prctl.2
> index 012af4d..4906c70 100644
> --- a/man2/prctl.2
> +++ b/man2/prctl.2
> @@ -761,6 +761,18 @@ option.
>  .\" symbolic-link transitions over all process running in a system.
>  .\" ========== END FIXME
>  .RE
> +.TP
> +.BR PR_GET_TID_ADDRESS " (since Linux 3.5)"
> +Return
> +.I clear_child_tid
> +in the location pointed by
> +.IR "(int\ **) arg2" .
> +See
> +.BR set_tid_address (2)
> +for more details.
> +This feature is available only if the kernel is built with the
> +.BR CONFIG_CHECKPOINT_RESTORE
> +option enabled.
>  .\"
>  .SH "RETURN VALUE"
>  On success,


As it happened, I added documentation for this flag a few weeks ago,
but your patc includes some details that I didn't document, so I've
applied those pieces to yield:

       PR_GET_TID_ADDRESS (since Linux 3.5)
              Retrieve   the   clear_child_tid    address    set    by
              set_tid_address(2) and the clone(2) CLONE_CHILD_CLEARTID
              flag, in the location pointed to by (int **) arg2.  This
              feature  is  available  only if the kernel is built with
              the CONFIG_CHECKPOINT_RESTORE option enabled.

Thanks,

Michael

-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Author of "The Linux Programming Interface"; http://man7.org/tlpi/
--
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html
Please read the FAQ at  http://www.tux.org/lkml/