[PATCH] cfree.3: ATTRIBUTES: Note function that is thread-safe

[PATCH] cfree.3: ATTRIBUTES: Note function that is thread-safe

[Ma Shimiao]

The function cfree() in glibc is thread safe.
It's marking matches glibc marking.

Signed-off-by: Ma Shimiao <mashimiao.fnst-BthXqXjhjHXQFUHtdCDX3A@public.gmane.org>
---
 man3/cfree.3 | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/man3/cfree.3 b/man3/cfree.3
index 1401c63..c322dc9 100644
--- a/man3/cfree.3
+++ b/man3/cfree.3
@@ -109,6 +109,18 @@ was not a pointer to a block previously allocated by
 one of the routines in the
 .BR malloc (3)
 family.
+.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 cfree ()
+T}	Thread safety	MT-Safe /* In glibc */
+.TE
 .SH CONFORMING TO
 The 3-argument version of
 .BR cfree ()
-- 
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] cfree.3: ATTRIBUTES: Note function that is thread-safe

[Michael Kerrisk (man-pages)]

On 01/28/2015 07:09 AM, Ma Shimiao wrote:
> The function cfree() in glibc is thread safe.
> It's marking matches glibc marking.


Thanks, Ma Shimiao. Applied in the mt_attributes branch.
One question below.

> Signed-off-by: Ma Shimiao <mashimiao.fnst-BthXqXjhjHXQFUHtdCDX3A@public.gmane.org>
> ---
>  man3/cfree.3 | 12 ++++++++++++
>  1 file changed, 12 insertions(+)
> 
> diff --git a/man3/cfree.3 b/man3/cfree.3
> index 1401c63..c322dc9 100644
> --- a/man3/cfree.3
> +++ b/man3/cfree.3
> @@ -109,6 +109,18 @@ was not a pointer to a block previously allocated by
>  one of the routines in the
>  .BR malloc (3)
>  family.
> +.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 cfree ()
> +T}	Thread safety	MT-Safe /* In glibc */

What is the "?* In glibc */" for?

Cheers,

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

Re: [PATCH] cfree.3: ATTRIBUTES: Note function that is thread-safe

[Ma Shimiao]

Hello Michael,
On 01/28/2015 07:05 PM, Michael Kerrisk (man-pages) wrote:
>> +.BR attributes (7).
>> > +.TS
>> > +allbox;
>> > +lb lb lb
>> > +l l l.
>> > +Interface	Attribute	Value
>> > +T{
>> > +.BR cfree ()
>> > +T}	Thread safety	MT-Safe /* In glibc */
> What is the "?* In glibc */" for?
This page records different versions of cfree.
Like cfree in SunOS 4, SCO OpenServer, glibc and so on.
I just can confirm thread safety of cfree in glibc.
So, I added a comment to help users understand which cfree 
I'm declaring.

Did I miss something or any good ideas?


Best regards
-- 
Ma Shimiao
Development Dept.I
Nanjing Fujitsu Nanda Software Tech. Co., Ltd.(FNST)
--
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] cfree.3: ATTRIBUTES: Note function that is thread-safe

[Michael Kerrisk (man-pages)]

On 01/29/2015 02:31 AM, Ma Shimiao wrote:
> Hello Michael,
> On 01/28/2015 07:05 PM, Michael Kerrisk (man-pages) wrote:
>>> +.BR attributes (7).
>>>> +.TS
>>>> +allbox;
>>>> +lb lb lb
>>>> +l l l.
>>>> +Interface	Attribute	Value
>>>> +T{
>>>> +.BR cfree ()
>>>> +T}	Thread safety	MT-Safe /* In glibc */
>> What is the "?* In glibc */" for?
> This page records different versions of cfree.
> Like cfree in SunOS 4, SCO OpenServer, glibc and so on.
> I just can confirm thread safety of cfree in glibc.
> So, I added a comment to help users understand which cfree 
> I'm declaring.
> 
> Did I miss something or any good ideas?

Oh -- I see what you mean, Ma Shimiao. I did not look at
the whole page--it's a strange page indeed, and your
choice seems reasonable.

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