[PATCH] getgrouplist.3: ATTRIBUTES: Note function that is thread safe with exceptions

[PATCH] getgrouplist.3: ATTRIBUTES: Note function that is thread safe with exceptions

[Peng Haitao]

The function getgrouplist() is thread safe with exceptions.

Signed-off-by: Peng Haitao <penght-BthXqXjhjHXQFUHtdCDX3A@public.gmane.org>
---
 man3/getgrouplist.3 | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/man3/getgrouplist.3 b/man3/getgrouplist.3
index 3d28eed..b24532a 100644
--- a/man3/getgrouplist.3
+++ b/man3/getgrouplist.3
@@ -95,6 +95,18 @@ can be used to resize the buffer passed to a further call
 .BR getgrouplist ().
 .SH VERSIONS
 This function is present since glibc 2.2.4.
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lb lb lb
+l l l.
+Interface	Attribute	Value
+T{
+.BR getgrouplist ()
+T}	Thread safety	MT-Safe locale
+.TE
 .SH CONFORMING TO
 This function is nonstandard; it appears on most BSDs.
 .SH BUGS
-- 
1.9.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] getgrouplist.3: ATTRIBUTES: Note function that is thread safe with exceptions

[Michael Kerrisk (man-pages)]

Thanks, Haitao. Applied in my local branch.

Cheers,

Michael



On 07/22/2014 05:52 AM, Peng Haitao wrote:
> The function getgrouplist() is thread safe with exceptions.
> 
> Signed-off-by: Peng Haitao <penght-BthXqXjhjHXQFUHtdCDX3A@public.gmane.org>
> ---
>  man3/getgrouplist.3 | 12 ++++++++++++
>  1 file changed, 12 insertions(+)
> 
> diff --git a/man3/getgrouplist.3 b/man3/getgrouplist.3
> index 3d28eed..b24532a 100644
> --- a/man3/getgrouplist.3
> +++ b/man3/getgrouplist.3
> @@ -95,6 +95,18 @@ can be used to resize the buffer passed to a further call
>  .BR getgrouplist ().
>  .SH VERSIONS
>  This function is present since glibc 2.2.4.
> +.SH ATTRIBUTES
> +For an explanation of the terms used in this section, see
> +.BR attributes (7).
> +.TS
> +allbox;
> +lb lb lb
> +l l l.
> +Interface	Attribute	Value
> +T{
> +.BR getgrouplist ()
> +T}	Thread safety	MT-Safe locale
> +.TE
>  .SH CONFORMING TO
>  This function is nonstandard; it appears on most BSDs.
>  .SH BUGS
> 


-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/
--
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] getgrouplist.3: ATTRIBUTES: Note function that is thread safe with exceptions

[Carlos O'Donell]

On Mon, Jul 21, 2014 at 11:52 PM, Peng Haitao <penght-BthXqXjhjHXQFUHtdCDX3A@public.gmane.org> wrote:
> The function getgrouplist() is thread safe with exceptions.
> +T}     Thread safety   MT-Safe locale

Excellent continued use of the new safety attributes.

Peng, I'm very happy to see such good work go into the linux kernel man pages.

Cheers,
Carlos.
--
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] getgrouplist.3: ATTRIBUTES: Note function that is thread safe with exceptions

[Michael Kerrisk (man-pages)]

On Tue, Jul 22, 2014 at 1:42 PM, Carlos O'Donell
<carlos-v2tUB8YBRSi3e3T8WW9gsA@public.gmane.org> wrote:
> On Mon, Jul 21, 2014 at 11:52 PM, Peng Haitao <penght-BthXqXjhjHXQFUHtdCDX3A@public.gmane.org> wrote:
>> The function getgrouplist() is thread safe with exceptions.
>> +T}     Thread safety   MT-Safe locale
>
> Excellent continued use of the new safety attributes.
>
> Peng, I'm very happy to see such good work go into the linux kernel man pages.

Seconded. Thanks, Haitaio, for all your work in reformatting the
existing pages to the new ATTRIBUTES layout. ( continue working from
the front of the alphabet, and we will eventually meet in the middle.
But my time for this work is very limited right now, sorry.)

Thanks,

Michael


-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/
--
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