[PATCH] err.3: ATTRIBUTES: Note functions that are thread-safe

[PATCH] err.3: ATTRIBUTES: Note functions that are thread-safe

[Zeng Linggang]

The markings match glibc markings.
markings of functions in glibc are:
- err:    MT-Safe locale
- err:    MT-Safe locale
- errx:   MT-Safe locale
- warn:   MT-Safe locale
- warnx:  MT-Safe locale
- verr:   MT-Safe locale
- verrx:  MT-Safe locale
- vwarn:  MT-Safe locale
- vwarnx: MT-Safe locale

Signed-off-by: Zeng Linggang <zenglg.jy-BthXqXjhjHXQFUHtdCDX3A@public.gmane.org>
---
 man3/err.3 | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/man3/err.3 b/man3/err.3
index 783d60a..14eb6e5 100644
--- a/man3/err.3
+++ b/man3/err.3
@@ -106,6 +106,29 @@ and
 .BR verrx ()
 functions do not return, but exit with the value of the argument
 .IR eval .
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lbw17 lb lb
+l l l.
+Interface	Attribute	Value
+T{
+.BR err (),
+.BR errx (),
+.br
+.BR warn (),
+.BR warnx (),
+.br
+.BR verr (),
+.BR verrx (),
+.br
+.BR vwarn (),
+.BR vwarnx ()
+T}	Thread safety	MT-Safe locale
+.TE
+
 .SH CONFORMING TO
 These functions are nonstandard BSD extensions.
 .\" .SH HISTORY
-- 
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

[PATCH] gethostid.3: ATTRIBUTES: Note functions that isn't thread-safe

[Zeng Linggang]

The markings match glibc markings.
markings of functions in glibc are:
- gethostid: MT-Safe hostid env locale
- sethostid: MT-Unsafe const:hostid

Signed-off-by: Zeng Linggang <zenglg.jy-BthXqXjhjHXQFUHtdCDX3A@public.gmane.org>
---
 man3/gethostid.3 | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/man3/gethostid.3 b/man3/gethostid.3
index bbeb4a5..4b46deb 100644
--- a/man3/gethostid.3
+++ b/man3/gethostid.3
@@ -89,6 +89,22 @@ to store the host ID.
 .B EPERM
 The calling process's effective user or group ID is not the same
 as its corresponding real ID.
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lb lb lbw25
+l l l.
+Interface	Attribute	Value
+T{
+.BR gethostid ()
+T}	Thread safety	MT-Safe hostid env locale
+T{
+.BR sethostid ()
+T}	Thread safety	MT-Unsafe const:hostid
+.TE
+
 .SH CONFORMING TO
 4.2BSD; these functions were dropped in 4.4BSD.
 SVr4 includes
-- 
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] gethostid.3: ATTRIBUTES: Note functions that isn't thread-safe

[Michael Kerrisk (man-pages)]

On 04/23/2015 06:51 AM, Zeng Linggang wrote:
> The markings match glibc markings.
> markings of functions in glibc are:
> - gethostid: MT-Safe hostid env locale
> - sethostid: MT-Unsafe const:hostid


Thanks, Zeng. Applied.

It's probably better to title patches like this as:

     ATTRIBUTES: Note functions that are/aren't thread-safe

Cheers,

Michael


> Signed-off-by: Zeng Linggang <zenglg.jy-BthXqXjhjHXQFUHtdCDX3A@public.gmane.org>
> ---
>  man3/gethostid.3 | 16 ++++++++++++++++
>  1 file changed, 16 insertions(+)
> 
> diff --git a/man3/gethostid.3 b/man3/gethostid.3
> index bbeb4a5..4b46deb 100644
> --- a/man3/gethostid.3
> +++ b/man3/gethostid.3
> @@ -89,6 +89,22 @@ to store the host ID.
>  .B EPERM
>  The calling process's effective user or group ID is not the same
>  as its corresponding real ID.
> +.SH ATTRIBUTES
> +For an explanation of the terms used in this section, see
> +.BR attributes (7).
> +.TS
> +allbox;
> +lb lb lbw25
> +l l l.
> +Interface	Attribute	Value
> +T{
> +.BR gethostid ()
> +T}	Thread safety	MT-Safe hostid env locale
> +T{
> +.BR sethostid ()
> +T}	Thread safety	MT-Unsafe const:hostid
> +.TE
> +
>  .SH CONFORMING TO
>  4.2BSD; these functions were dropped in 4.4BSD.
>  SVr4 includes
> 


-- 
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] gethostid.3: ATTRIBUTES: Note functions that isn't thread-safe

[Zeng Linggang]

Hi,

On Wed, 2015-04-29 at 21:14 +0200, Michael Kerrisk (man-pages) wrote:
> On 04/23/2015 06:51 AM, Zeng Linggang wrote:
> > The markings match glibc markings.
> > markings of functions in glibc are:
> > - gethostid: MT-Safe hostid env locale
> > - sethostid: MT-Unsafe const:hostid
> 
> 
> Thanks, Zeng. Applied.
> 
> It's probably better to title patches like this as:
> 
>      ATTRIBUTES: Note functions that are/aren't thread-safe
> 

OK, thank you very much.

Best regards,
zeng

> Cheers,
> 
> Michael
> 


--
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

[PATCH] getmntent.3: ATTRIBUTES: Note functions that isn't thread-safe

[Zeng Linggang]

The markings match glibc markings.
markings of functions in glibc are:
- setmntent:   MT-Safe
- endmntent:   MT-Safe
- hasmntopt:   MT-Safe
- getmntent:   MT-Unsafe race:mntentbuf locale
- addmntent:   MT-Safe race:stream locale
- getmntent_r: MT-Safe locale

Signed-off-by: Zeng Linggang <zenglg.jy-BthXqXjhjHXQFUHtdCDX3A@public.gmane.org>
---
 man3/getmntent.3 | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/man3/getmntent.3 b/man3/getmntent.3
index 085c632..130ec82 100644
--- a/man3/getmntent.3
+++ b/man3/getmntent.3
@@ -199,6 +199,30 @@ a match is found and NULL otherwise.
 /etc/fstab          filesystem description file
 /etc/mtab           mounted filesystem description file
 .fi
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lbw13 lb lbw31
+l l l.
+Interface	Attribute	Value
+T{
+.BR setmntent (),
+.BR endmntent (),
+.BR hasmntopt ()
+T}	Thread safety	MT-Safe
+T{
+.BR getmntent ()
+T}	Thread safety	MT-Unsafe race:mntentbuf locale
+T{
+.BR addmntent ()
+T}	Thread safety	MT-Safe race:stream locale
+T{
+.BR getmntent_r ()
+T}	Thread safety	MT-Safe locale
+.TE
+
 .SH CONFORMING TO
 The nonreentrant functions are from SunOS 4.1.3.
 A routine
-- 
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] getmntent.3: ATTRIBUTES: Note functions that isn't thread-safe

[Michael Kerrisk (man-pages)]

On 04/23/2015 06:51 AM, Zeng Linggang wrote:
> The markings match glibc markings.
> markings of functions in glibc are:
> - setmntent:   MT-Safe
> - endmntent:   MT-Safe
> - hasmntopt:   MT-Safe
> - getmntent:   MT-Unsafe race:mntentbuf locale
> - addmntent:   MT-Safe race:stream locale
> - getmntent_r: MT-Safe locale


Thanks, Zeng. Applied. (See comment on previous mail re Patch Title).

Cheers,

Michael



> Signed-off-by: Zeng Linggang <zenglg.jy-BthXqXjhjHXQFUHtdCDX3A@public.gmane.org>
> ---
>  man3/getmntent.3 | 24 ++++++++++++++++++++++++
>  1 file changed, 24 insertions(+)
> 
> diff --git a/man3/getmntent.3 b/man3/getmntent.3
> index 085c632..130ec82 100644
> --- a/man3/getmntent.3
> +++ b/man3/getmntent.3
> @@ -199,6 +199,30 @@ a match is found and NULL otherwise.
>  /etc/fstab          filesystem description file
>  /etc/mtab           mounted filesystem description file
>  .fi
> +.SH ATTRIBUTES
> +For an explanation of the terms used in this section, see
> +.BR attributes (7).
> +.TS
> +allbox;
> +lbw13 lb lbw31
> +l l l.
> +Interface	Attribute	Value
> +T{
> +.BR setmntent (),
> +.BR endmntent (),
> +.BR hasmntopt ()
> +T}	Thread safety	MT-Safe
> +T{
> +.BR getmntent ()
> +T}	Thread safety	MT-Unsafe race:mntentbuf locale
> +T{
> +.BR addmntent ()
> +T}	Thread safety	MT-Safe race:stream locale
> +T{
> +.BR getmntent_r ()
> +T}	Thread safety	MT-Safe locale
> +.TE
> +
>  .SH CONFORMING TO
>  The nonreentrant functions are from SunOS 4.1.3.
>  A routine
> 


-- 
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

[PATCH] longjmp.3: ATTRIBUTES: Note functions that are thread-safe

[Zeng Linggang]

The markings match glibc markings.
markings of functions in glibc are:
- longjmp:    MT-Safe
- siglongjmp: MT-Safe

Signed-off-by: Zeng Linggang <zenglg.jy-BthXqXjhjHXQFUHtdCDX3A@public.gmane.org>
---
 man3/longjmp.3 | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/man3/longjmp.3 b/man3/longjmp.3
index 69bd6f5..2687703 100644
--- a/man3/longjmp.3
+++ b/man3/longjmp.3
@@ -87,6 +87,20 @@ also restores the signal mask that was saved by
 .BR sigsetjmp (3).
 .SH RETURN VALUE
 These functions never return.
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lbw23 lb lb
+l l l.
+Interface	Attribute	Value
+T{
+.BR longjmp (),
+.BR siglongjmp ()
+T}	Thread safety	MT-Safe
+.TE
+
 .SH CONFORMING TO
 C89, C99, and POSIX.1-2001 specify
 .BR longjmp ().
-- 
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] longjmp.3: ATTRIBUTES: Note functions that are thread-safe

[Michael Kerrisk (man-pages)]

On 04/23/2015 06:51 AM, Zeng Linggang wrote:
> The markings match glibc markings.
> markings of functions in glibc are:
> - longjmp:    MT-Safe
> - siglongjmp: MT-Safe


Thanks, Zeng. Applied.

Cheers,

Michael


> Signed-off-by: Zeng Linggang <zenglg.jy-BthXqXjhjHXQFUHtdCDX3A@public.gmane.org>
> ---
>  man3/longjmp.3 | 14 ++++++++++++++
>  1 file changed, 14 insertions(+)
> 
> diff --git a/man3/longjmp.3 b/man3/longjmp.3
> index 69bd6f5..2687703 100644
> --- a/man3/longjmp.3
> +++ b/man3/longjmp.3
> @@ -87,6 +87,20 @@ also restores the signal mask that was saved by
>  .BR sigsetjmp (3).
>  .SH RETURN VALUE
>  These functions never return.
> +.SH ATTRIBUTES
> +For an explanation of the terms used in this section, see
> +.BR attributes (7).
> +.TS
> +allbox;
> +lbw23 lb lb
> +l l l.
> +Interface	Attribute	Value
> +T{
> +.BR longjmp (),
> +.BR siglongjmp ()
> +T}	Thread safety	MT-Safe
> +.TE
> +
>  .SH CONFORMING TO
>  C89, C99, and POSIX.1-2001 specify
>  .BR longjmp ().
> 


-- 
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

[PATCH] mcheck.3: ATTRIBUTES: Note functions that aren't thread-safe

[Zeng Linggang]

mcheck() and mprobe() match glibc markings.
>From research, We think mcheck_pedantic() and mcheck_check_all() are not
thread-safe. But, there is not markings of mcheck_pedantic() and
mcheck_check_all() in glibc document.
- mcheck:           MT-Unsafe race:mcheck const:malloc_hooks
- mcheck_pedantic:  MT-Unsafe race:mcheck const:malloc_hooks
- mcheck_check_all: MT-Unsafe race:mcheck const:malloc_hooks
- mprobe:           MT-Unsafe race:mcheck const:malloc_hooks

Signed-off-by: Zeng Linggang <zenglg.jy-BthXqXjhjHXQFUHtdCDX3A@public.gmane.org>
---
 man3/mcheck.3 | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/man3/mcheck.3 b/man3/mcheck.3
index e59da31..b836de7 100644
--- a/man3/mcheck.3
+++ b/man3/mcheck.3
@@ -142,6 +142,27 @@ The
 and
 .BR mprobe ()
 functions are present since at least glibc 2.0
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lbw28 lb lbw21
+l l l.
+Interface	Attribute	Value
+T{
+.BR mcheck (),
+.BR mcheck_pedantic (),
+.br
+.BR mcheck_check_all (),
+.BR mprobe ()
+T}	Thread safety	T{
+MT-Unsafe race:mcheck
+.br
+const:malloc_hooks
+T}
+.TE
+
 .SH CONFORMING TO
 These functions are GNU extensions.
 .SH NOTES
-- 
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] mcheck.3: ATTRIBUTES: Note functions that aren't thread-safe

[Michael Kerrisk (man-pages)]

On 04/23/2015 06:51 AM, Zeng Linggang wrote:
> mcheck() and mprobe() match glibc markings.
>>From research, We think mcheck_pedantic() and mcheck_check_all() are not
> thread-safe. But, there is not markings of mcheck_pedantic() and
> mcheck_check_all() in glibc document.
> - mcheck:           MT-Unsafe race:mcheck const:malloc_hooks
> - mcheck_pedantic:  MT-Unsafe race:mcheck const:malloc_hooks
> - mcheck_check_all: MT-Unsafe race:mcheck const:malloc_hooks
> - mprobe:           MT-Unsafe race:mcheck const:malloc_hooks


Thanks, Zeng. Applied.

Cheers,

Michael


> Signed-off-by: Zeng Linggang <zenglg.jy-BthXqXjhjHXQFUHtdCDX3A@public.gmane.org>
> ---
>  man3/mcheck.3 | 21 +++++++++++++++++++++
>  1 file changed, 21 insertions(+)
> 
> diff --git a/man3/mcheck.3 b/man3/mcheck.3
> index e59da31..b836de7 100644
> --- a/man3/mcheck.3
> +++ b/man3/mcheck.3
> @@ -142,6 +142,27 @@ The
>  and
>  .BR mprobe ()
>  functions are present since at least glibc 2.0
> +.SH ATTRIBUTES
> +For an explanation of the terms used in this section, see
> +.BR attributes (7).
> +.TS
> +allbox;
> +lbw28 lb lbw21
> +l l l.
> +Interface	Attribute	Value
> +T{
> +.BR mcheck (),
> +.BR mcheck_pedantic (),
> +.br
> +.BR mcheck_check_all (),
> +.BR mprobe ()
> +T}	Thread safety	T{
> +MT-Unsafe race:mcheck
> +.br
> +const:malloc_hooks
> +T}
> +.TE
> +
>  .SH CONFORMING TO
>  These functions are GNU extensions.
>  .SH NOTES
> 


-- 
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

[PATCH] setjmp.3: ATTRIBUTES: Note functions that are thread-safe

[Zeng Linggang]

The markings match glibc markings.
markings of functions in glibc are:
- setjmp:    MT-Safe
- sigsetjmp: MT-Safe

Signed-off-by: Zeng Linggang <zenglg.jy-BthXqXjhjHXQFUHtdCDX3A@public.gmane.org>
---
 man3/setjmp.3 | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/man3/setjmp.3 b/man3/setjmp.3
index 8aacc54..4decbd5 100644
--- a/man3/setjmp.3
+++ b/man3/setjmp.3
@@ -85,6 +85,20 @@ nonzero when returning from
 or
 .BR siglongjmp (3)
 using the saved context.
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lbw21 lb lb
+l l l.
+Interface	Attribute	Value
+T{
+.BR setjmp (),
+.BR sigsetjmp ()
+T}	Thread safety	MT-Safe
+.TE
+
 .SH CONFORMING TO
 C89, C99, and POSIX.1-2001 specify
 .BR setjmp ().
-- 
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

[PATCH] setlocale.3: ATTRIBUTES: Note functions that isn't thread-safe

[Zeng Linggang]

The marking matches glibc marking.
The marking of functions in glibc is:
- setlocale: MT-Unsafe const:locale env

Signed-off-by: Zeng Linggang <zenglg.jy-BthXqXjhjHXQFUHtdCDX3A@public.gmane.org>
---
 man3/setlocale.3 | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/man3/setlocale.3 b/man3/setlocale.3
index 5dd289a..632257d 100644
--- a/man3/setlocale.3
+++ b/man3/setlocale.3
@@ -173,6 +173,19 @@ The string returned is such that a subsequent call with that string
 and its associated category will restore that part of the process's
 locale.
 The return value is NULL if the request cannot be honored.
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lb lb lbw26
+l l l.
+Interface	Attribute	Value
+T{
+.BR setlocale ()
+T}	Thread safety	MT-Unsafe const:locale env
+.TE
+
 .SH CONFORMING TO
 C89, C99, POSIX.1-2001.
 .SH SEE ALSO
-- 
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] setlocale.3: ATTRIBUTES: Note functions that isn't thread-safe

[Michael Kerrisk (man-pages)]

On 04/23/2015 06:51 AM, Zeng Linggang wrote:
> The marking matches glibc marking.
> The marking of functions in glibc is:
> - setlocale: MT-Unsafe const:locale env


Thanks, Zeng. Applied.

Note that the title of this patch as a number disagreement. It should
say "Note function that isn't thread-safe" (i.e., s/functions/function).

Cheers,

Michael


> Signed-off-by: Zeng Linggang <zenglg.jy-BthXqXjhjHXQFUHtdCDX3A@public.gmane.org>
> ---
>  man3/setlocale.3 | 13 +++++++++++++
>  1 file changed, 13 insertions(+)
> 
> diff --git a/man3/setlocale.3 b/man3/setlocale.3
> index 5dd289a..632257d 100644
> --- a/man3/setlocale.3
> +++ b/man3/setlocale.3
> @@ -173,6 +173,19 @@ The string returned is such that a subsequent call with that string
>  and its associated category will restore that part of the process's
>  locale.
>  The return value is NULL if the request cannot be honored.
> +.SH ATTRIBUTES
> +For an explanation of the terms used in this section, see
> +.BR attributes (7).
> +.TS
> +allbox;
> +lb lb lbw26
> +l l l.
> +Interface	Attribute	Value
> +T{
> +.BR setlocale ()
> +T}	Thread safety	MT-Unsafe const:locale env
> +.TE
> +
>  .SH CONFORMING TO
>  C89, C99, POSIX.1-2001.
>  .SH SEE ALSO
> 


-- 
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] setlocale.3: ATTRIBUTES: Note functions that isn't thread-safe

[Zeng Linggang]

Hi,

On Wed, 2015-04-29 at 21:17 +0200, Michael Kerrisk (man-pages) wrote:
> On 04/23/2015 06:51 AM, Zeng Linggang wrote:
> > The marking matches glibc marking.
> > The marking of functions in glibc is:
> > - setlocale: MT-Unsafe const:locale env
> 
> 
> Thanks, Zeng. Applied.
> 
> Note that the title of this patch as a number disagreement. It should
> say "Note function that isn't thread-safe" (i.e., s/functions/function).
> 

OK, thank you very much.

Best regards,
zeng

> Cheers,
> 
> Michael


--
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

[PATCH] setlogmask.3: ATTRIBUTES: Note functions that isn't thread-safe

[Zeng Linggang]

The marking matches glibc marking.
The marking of functions in glibc is:
- setlogmask: MT-Unsafe race:LogMask

Signed-off-by: Zeng Linggang <zenglg.jy-BthXqXjhjHXQFUHtdCDX3A@public.gmane.org>
---
 man3/setlogmask.3 | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/man3/setlogmask.3 b/man3/setlogmask.3
index fe708f4..4d45d98 100644
--- a/man3/setlogmask.3
+++ b/man3/setlogmask.3
@@ -72,6 +72,19 @@ This function returns the previous log priority mask.
 None.
 .\" .SH NOTES
 .\" The glibc logmask handling was broken in versions before glibc 2.1.1.
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lb lb lbw22
+l l l.
+Interface	Attribute	Value
+T{
+.BR setlogmask ()
+T}	Thread safety	MT-Unsafe race:LogMask
+.TE
+
 .SH CONFORMING TO
 POSIX.1-2001.
 Note that the description in POSIX.1-2001 is flawed.
-- 
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] setlogmask.3: ATTRIBUTES: Note functions that isn't thread-safe

[Michael Kerrisk (man-pages)]

On 04/23/2015 06:51 AM, Zeng Linggang wrote:
> The marking matches glibc marking.
> The marking of functions in glibc is:
> - setlogmask: MT-Unsafe race:LogMask


Thanks, Zeng. Applied. (Again a number disagreement in the title 
of this patch; s/functions/function/)

Cheers,

Michael



> Signed-off-by: Zeng Linggang <zenglg.jy-BthXqXjhjHXQFUHtdCDX3A@public.gmane.org>
> ---
>  man3/setlogmask.3 | 13 +++++++++++++
>  1 file changed, 13 insertions(+)
> 
> diff --git a/man3/setlogmask.3 b/man3/setlogmask.3
> index fe708f4..4d45d98 100644
> --- a/man3/setlogmask.3
> +++ b/man3/setlogmask.3
> @@ -72,6 +72,19 @@ This function returns the previous log priority mask.
>  None.
>  .\" .SH NOTES
>  .\" The glibc logmask handling was broken in versions before glibc 2.1.1.
> +.SH ATTRIBUTES
> +For an explanation of the terms used in this section, see
> +.BR attributes (7).
> +.TS
> +allbox;
> +lb lb lbw22
> +l l l.
> +Interface	Attribute	Value
> +T{
> +.BR setlogmask ()
> +T}	Thread safety	MT-Unsafe race:LogMask
> +.TE
> +
>  .SH CONFORMING TO
>  POSIX.1-2001.
>  Note that the description in POSIX.1-2001 is flawed.
> 


-- 
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

[PATCH] sleep.3: ATTRIBUTES: Note functions that isn't thread-safe

[Zeng Linggang]

The marking matches glibc marking.
The marking of functions in glibc is:
- sleep: MT-Unsafe sig:SIGCHLD/linux

Signed-off-by: Zeng Linggang <zenglg.jy-BthXqXjhjHXQFUHtdCDX3A@public.gmane.org>
---
 man3/sleep.3 | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/man3/sleep.3 b/man3/sleep.3
index e50d617..f761ed8 100644
--- a/man3/sleep.3
+++ b/man3/sleep.3
@@ -41,6 +41,19 @@ seconds have elapsed or a signal arrives which is not ignored.
 Zero if the requested time has elapsed,
 or the number of seconds left to sleep,
 if the call was interrupted by a signal handler.
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lb lb lbw27
+l l l.
+Interface	Attribute	Value
+T{
+.BR sleep ()
+T}	Thread safety	MT-Unsafe sig:SIGCHLD/linux
+.TE
+
 .SH CONFORMING TO
 POSIX.1-2001.
 .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] sleep.3: ATTRIBUTES: Note functions that isn't thread-safe

[Michael Kerrisk (man-pages)]

On 04/23/2015 06:51 AM, Zeng Linggang wrote:
> The marking matches glibc marking.
> The marking of functions in glibc is:
> - sleep: MT-Unsafe sig:SIGCHLD/linux


Thanks, Zeng. Applied. (Again a number disagreement in the title 
of this patch; s/functions/function/)

Cheers,

Michael




> Signed-off-by: Zeng Linggang <zenglg.jy-BthXqXjhjHXQFUHtdCDX3A@public.gmane.org>
> ---
>  man3/sleep.3 | 13 +++++++++++++
>  1 file changed, 13 insertions(+)
> 
> diff --git a/man3/sleep.3 b/man3/sleep.3
> index e50d617..f761ed8 100644
> --- a/man3/sleep.3
> +++ b/man3/sleep.3
> @@ -41,6 +41,19 @@ seconds have elapsed or a signal arrives which is not ignored.
>  Zero if the requested time has elapsed,
>  or the number of seconds left to sleep,
>  if the call was interrupted by a signal handler.
> +.SH ATTRIBUTES
> +For an explanation of the terms used in this section, see
> +.BR attributes (7).
> +.TS
> +allbox;
> +lb lb lbw27
> +l l l.
> +Interface	Attribute	Value
> +T{
> +.BR sleep ()
> +T}	Thread safety	MT-Unsafe sig:SIGCHLD/linux
> +.TE
> +
>  .SH CONFORMING TO
>  POSIX.1-2001.
>  .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

[PATCH] strsignal.3: ATTRIBUTES: Note functions that isn't thread-safe

[Zeng Linggang]

The marking matches glibc marking.
The marking of functions in glibc is:
- strsignal: MT-Unsafe race:strsignal locale

Signed-off-by: Zeng Linggang <zenglg.jy-BthXqXjhjHXQFUHtdCDX3A@public.gmane.org>
---
 man3/strsignal.3 | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/man3/strsignal.3 b/man3/strsignal.3
index 8c82a6f..c0e887e 100644
--- a/man3/strsignal.3
+++ b/man3/strsignal.3
@@ -81,6 +81,19 @@ function returns the appropriate description
 string, or an unknown signal message if the signal number is invalid.
 On some systems (but not on Linux), NULL may instead be
 returned for an invalid signal number.
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lb lb lbw31
+l l l.
+Interface	Attribute	Value
+T{
+.BR strsignal ()
+T}	Thread safety	MT-Unsafe race:strsignal locale
+.TE
+
 .SH CONFORMING TO
 POSIX.1-2008.
 Present on Solaris and the BSDs.
-- 
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] strsignal.3: ATTRIBUTES: Note functions that isn't thread-safe

[Michael Kerrisk (man-pages)]

On 04/23/2015 06:51 AM, Zeng Linggang wrote:
> The marking matches glibc marking.
> The marking of functions in glibc is:
> - strsignal: MT-Unsafe race:strsignal locale


Thanks, Zeng. Applied. (Again a number disagreement in the title 
of this patch; s/functions/function/)

Cheers,

Michael




> Signed-off-by: Zeng Linggang <zenglg.jy-BthXqXjhjHXQFUHtdCDX3A@public.gmane.org>
> ---
>  man3/strsignal.3 | 13 +++++++++++++
>  1 file changed, 13 insertions(+)
> 
> diff --git a/man3/strsignal.3 b/man3/strsignal.3
> index 8c82a6f..c0e887e 100644
> --- a/man3/strsignal.3
> +++ b/man3/strsignal.3
> @@ -81,6 +81,19 @@ function returns the appropriate description
>  string, or an unknown signal message if the signal number is invalid.
>  On some systems (but not on Linux), NULL may instead be
>  returned for an invalid signal number.
> +.SH ATTRIBUTES
> +For an explanation of the terms used in this section, see
> +.BR attributes (7).
> +.TS
> +allbox;
> +lb lb lbw31
> +l l l.
> +Interface	Attribute	Value
> +T{
> +.BR strsignal ()
> +T}	Thread safety	MT-Unsafe race:strsignal locale
> +.TE
> +
>  .SH CONFORMING TO
>  POSIX.1-2008.
>  Present on Solaris and the BSDs.
> 


-- 
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] err.3: ATTRIBUTES: Note functions that are thread-safe

[Michael Kerrisk (man-pages)]

On 04/23/2015 06:51 AM, Zeng Linggang wrote:
> The markings match glibc markings.
> markings of functions in glibc are:
> - err:    MT-Safe locale
> - err:    MT-Safe locale
> - errx:   MT-Safe locale
> - warn:   MT-Safe locale
> - warnx:  MT-Safe locale
> - verr:   MT-Safe locale
> - verrx:  MT-Safe locale
> - vwarn:  MT-Safe locale
> - vwarnx: MT-Safe locale

Thanks, Zeng. Applied.

Cheers,

Michael



> Signed-off-by: Zeng Linggang <zenglg.jy-BthXqXjhjHXQFUHtdCDX3A@public.gmane.org>
> ---
>  man3/err.3 | 23 +++++++++++++++++++++++
>  1 file changed, 23 insertions(+)
> 
> diff --git a/man3/err.3 b/man3/err.3
> index 783d60a..14eb6e5 100644
> --- a/man3/err.3
> +++ b/man3/err.3
> @@ -106,6 +106,29 @@ and
>  .BR verrx ()
>  functions do not return, but exit with the value of the argument
>  .IR eval .
> +.SH ATTRIBUTES
> +For an explanation of the terms used in this section, see
> +.BR attributes (7).
> +.TS
> +allbox;
> +lbw17 lb lb
> +l l l.
> +Interface	Attribute	Value
> +T{
> +.BR err (),
> +.BR errx (),
> +.br
> +.BR warn (),
> +.BR warnx (),
> +.br
> +.BR verr (),
> +.BR verrx (),
> +.br
> +.BR vwarn (),
> +.BR vwarnx ()
> +T}	Thread safety	MT-Safe locale
> +.TE
> +
>  .SH CONFORMING TO
>  These functions are nonstandard BSD extensions.
>  .\" .SH HISTORY
> 


-- 
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