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

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

[Zeng Linggang]

The markings match glibc markings.

glob:     MT-Unsafe race:utent env sig:ALRM timer local

globfree: MT-Safe

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

diff --git a/man3/glob.3 b/man3/glob.3
index 857dff0..65fc6a8 100644
--- a/man3/glob.3
+++ b/man3/glob.3
@@ -273,6 +273,40 @@ for a read error, and
 .TP
 .B GLOB_NOMATCH
 for no found matches.
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lb lb lbw24
+l l l.
+Interface	Attribute	Value
+T{
+.BR glob ()
+T}	Thread safety	T{
+MT-Unsafe race:utent env
+.br
+sig:ALRM timer locale
+T}
+T{
+.BR globfree ()
+T}	Thread safety	MT-Safe
+.TE
+
+In the above table,
+.I utent
+in
+.I race:utent
+signifies that if any of the functions
+.BR setutent (3),
+.BR getutent (3),
+or
+.BR endutent (3)
+are used in parallel in different threads of a program,
+then data races could occur.
+.BR glob (3)
+calls those functions,
+so we use race:utent to remind users.
 .SH CONFORMING TO
 POSIX.2, POSIX.1-2001.
 .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

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

[Zeng Linggang]

The markings match glibc markings.

login:  MT-Unsafe race:utent sig:ALRM timer
logout: MT-Unsafe race:utent sig:ALRM timer

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

diff --git a/man3/login.3 b/man3/login.3
index fe03b5a..98d3b91 100644
--- a/man3/login.3
+++ b/man3/login.3
@@ -109,6 +109,41 @@ user accounting log file, configured through
 .B _PATH_WTMP
 in
 .I <paths.h>
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lb lb lbw20
+l l l.
+Interface	Attribute	Value
+T{
+.BR login (),
+.br
+.BR logout ()
+T}	Thread safety	T{
+MT-Unsafe race:utent
+.br
+sig:ALRM timer
+T}
+.TE
+
+In the above table,
+.I utent
+in
+.I race:utent
+signifies that if any of the functions
+.BR setutent (3),
+.BR getutent (3),
+or
+.BR endutent (3)
+are used in parallel in different threads of a program,
+then data races could occur.
+.BR login (3)
+and
+.BR logout (3)
+calls those functions,
+so we use race:utent to remind users.
 .SH CONFORMING TO
 Not in POSIX.1-2001.
 Present on 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] login.3: ATTRIBUTES: Note functions that aren't thread-safe

[Michael Kerrisk (man-pages)]

On 04/16/2015 07:09 AM, Zeng Linggang wrote:
> The markings match glibc markings.


Thanks, Zeng. Applied.

Cheers,

Michael


> login:  MT-Unsafe race:utent sig:ALRM timer
> logout: MT-Unsafe race:utent sig:ALRM timer
> 
> Signed-off-by: Zeng Linggang <zenglg.jy-BthXqXjhjHXQFUHtdCDX3A@public.gmane.org>
> ---
>  man3/login.3 | 35 +++++++++++++++++++++++++++++++++++
>  1 file changed, 35 insertions(+)
> 
> diff --git a/man3/login.3 b/man3/login.3
> index fe03b5a..98d3b91 100644
> --- a/man3/login.3
> +++ b/man3/login.3
> @@ -109,6 +109,41 @@ user accounting log file, configured through
>  .B _PATH_WTMP
>  in
>  .I <paths.h>
> +.SH ATTRIBUTES
> +For an explanation of the terms used in this section, see
> +.BR attributes (7).
> +.TS
> +allbox;
> +lb lb lbw20
> +l l l.
> +Interface	Attribute	Value
> +T{
> +.BR login (),
> +.br
> +.BR logout ()
> +T}	Thread safety	T{
> +MT-Unsafe race:utent
> +.br
> +sig:ALRM timer
> +T}
> +.TE
> +
> +In the above table,
> +.I utent
> +in
> +.I race:utent
> +signifies that if any of the functions
> +.BR setutent (3),
> +.BR getutent (3),
> +or
> +.BR endutent (3)
> +are used in parallel in different threads of a program,
> +then data races could occur.
> +.BR login (3)
> +and
> +.BR logout (3)
> +calls those functions,
> +so we use race:utent to remind users.
>  .SH CONFORMING TO
>  Not in POSIX.1-2001.
>  Present on 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

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

[Zeng Linggang]

The markings match glibc markings.

openpty:   MT-Safe locale
forkpty:   MT-Safe locale

login_tty: MT-Unsafe race:ttyname

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

diff --git a/man3/openpty.3 b/man3/openpty.3
index a17ac08..81d73e8 100644
--- a/man3/openpty.3
+++ b/man3/openpty.3
@@ -147,6 +147,23 @@ will fail if either
 or
 .BR fork (2)
 fails.
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lbw20 lb lb
+l l l.
+Interface	Attribute	Value
+T{
+.BR forkpty (),
+.BR openpty ()
+T}	Thread safety	MT-Safe locale
+T{
+.BR login_tty ()
+T}	Thread safety	MT-Unsafe race:ttyname
+.TE
+
 .SH CONFORMING TO
 These are BSD functions, present in glibc.
 They are not standardized in POSIX.
-- 
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] openpty.3: ATTRIBUTES: Note functions that isn't thread-safe

[Michael Kerrisk (man-pages)]

On 04/16/2015 07:09 AM, Zeng Linggang wrote:
> The markings match glibc markings.


Thanks, Zeng. Applied.

Cheers,

Michael


> openpty:   MT-Safe locale
> forkpty:   MT-Safe locale
> 
> login_tty: MT-Unsafe race:ttyname
> 
> Signed-off-by: Zeng Linggang <zenglg.jy-BthXqXjhjHXQFUHtdCDX3A@public.gmane.org>
> ---
>  man3/openpty.3 | 17 +++++++++++++++++
>  1 file changed, 17 insertions(+)
> 
> diff --git a/man3/openpty.3 b/man3/openpty.3
> index a17ac08..81d73e8 100644
> --- a/man3/openpty.3
> +++ b/man3/openpty.3
> @@ -147,6 +147,23 @@ will fail if either
>  or
>  .BR fork (2)
>  fails.
> +.SH ATTRIBUTES
> +For an explanation of the terms used in this section, see
> +.BR attributes (7).
> +.TS
> +allbox;
> +lbw20 lb lb
> +l l l.
> +Interface	Attribute	Value
> +T{
> +.BR forkpty (),
> +.BR openpty ()
> +T}	Thread safety	MT-Safe locale
> +T{
> +.BR login_tty ()
> +T}	Thread safety	MT-Unsafe race:ttyname
> +.TE
> +
>  .SH CONFORMING TO
>  These are BSD functions, present in glibc.
>  They are not standardized in POSIX.
> 


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

[Zeng Linggang]

The markings match glibc markings.

posix_memalign: MT-Safe
aligned_alloc:  MT-Safe
memalign:       MT-Safe

valloc:         MT-Unsafe init
pvalloc:        MT-Unsafe init

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

diff --git a/man3/posix_memalign.3 b/man3/posix_memalign.3
index 48dc770..f7b919d 100644
--- a/man3/posix_memalign.3
+++ b/man3/posix_memalign.3
@@ -179,6 +179,28 @@ was added to glibc in version 2.16.
 The function
 .BR posix_memalign ()
 is available since glibc 2.1.91.
+.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 aligned_alloc (),
+.br
+.BR memalign (),
+.br
+.BR posix_memalign ()
+T}	Thread safety	MT-Safe
+T{
+.BR valloc (),
+.br
+.BR pvalloc ()
+T}	Thread safety	MT-Unsafe init
+.TE
+
 .SH CONFORMING TO
 The function
 .BR valloc ()
-- 
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] posix_memalign.3: ATTRIBUTES: Note functions that aren't thread-safe

[Michael Kerrisk (man-pages)]

On 04/16/2015 07:09 AM, Zeng Linggang wrote:
> The markings match glibc markings.


Thanks, Zeng. Applied.

Cheers,

Michael

> posix_memalign: MT-Safe
> aligned_alloc:  MT-Safe
> memalign:       MT-Safe
> 
> valloc:         MT-Unsafe init
> pvalloc:        MT-Unsafe init
> 
> Signed-off-by: Zeng Linggang <zenglg.jy-BthXqXjhjHXQFUHtdCDX3A@public.gmane.org>
> ---
>  man3/posix_memalign.3 | 22 ++++++++++++++++++++++
>  1 file changed, 22 insertions(+)
> 
> diff --git a/man3/posix_memalign.3 b/man3/posix_memalign.3
> index 48dc770..f7b919d 100644
> --- a/man3/posix_memalign.3
> +++ b/man3/posix_memalign.3
> @@ -179,6 +179,28 @@ was added to glibc in version 2.16.
>  The function
>  .BR posix_memalign ()
>  is available since glibc 2.1.91.
> +.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 aligned_alloc (),
> +.br
> +.BR memalign (),
> +.br
> +.BR posix_memalign ()
> +T}	Thread safety	MT-Safe
> +T{
> +.BR valloc (),
> +.br
> +.BR pvalloc ()
> +T}	Thread safety	MT-Unsafe init
> +.TE
> +
>  .SH CONFORMING TO
>  The function
>  .BR valloc ()
> 


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

[Zeng Linggang]

The markings match glibc markings.

setnetgrent:   MT-Unsafe race:netgrent locale
getnetgrent_r: MT-Unsafe race:netgrent locale
innetgr:       MT-Unsafe race:netgrent locale

endnetgrent:   MT-Unsafe race:netgrent

getnetgrent:   MT-Unsafe race:netgrent race:netgrentbuf locale

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

diff --git a/man3/setnetgrent.3 b/man3/setnetgrent.3
index 24675c8..233bea6 100644
--- a/man3/setnetgrent.3
+++ b/man3/setnetgrent.3
@@ -89,6 +89,50 @@ These functions return 1 on success and 0 for failure.
 .I /etc/netgroup
 .br
 .I /etc/nsswitch.conf
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lbw16 lb lbw23
+l l l.
+Interface	Attribute	Value
+T{
+.BR setnetgrent (),
+.br
+.BR getnetgrent_r (),
+.br
+.BR innetgr ()
+T}	Thread safety	T{
+MT-Unsafe race:netgrent
+.br
+locale
+T}
+T{
+.BR endnetgrent ()
+T}	Thread safety	MT-Unsafe race:netgrent
+T{
+.BR getnetgrent ()
+T}	Thread safety	T{
+MT-Unsafe race:netgrent
+.br
+race:netgrentbuf locale
+T}
+.TE
+
+In the above table,
+.I netgrent
+in
+.I race:netgrent
+signifies that if any of the functions
+.BR setnetgrent (3),
+.BR getnetgrent_r (3),
+.BR innetgr (3),
+.BR getnetgrent (3),
+or
+.BR endnetgrent (3)
+are used in parallel in different threads of a program,
+then data races could occur.
 .SH CONFORMING TO
 These functions are not in POSIX.1-2001, but
 .BR setnetgrent (),
-- 
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] setnetgrent.3: ATTRIBUTES: Note functions that aren't thread-safe

[Michael Kerrisk (man-pages)]

On 04/16/2015 07:09 AM, Zeng Linggang wrote:
> The markings match glibc markings.


Thanks, Zeng. Applied.

Cheers,

Michael

> setnetgrent:   MT-Unsafe race:netgrent locale
> getnetgrent_r: MT-Unsafe race:netgrent locale
> innetgr:       MT-Unsafe race:netgrent locale
> 
> endnetgrent:   MT-Unsafe race:netgrent
> 
> getnetgrent:   MT-Unsafe race:netgrent race:netgrentbuf locale
> 
> Signed-off-by: Zeng Linggang <zenglg.jy-BthXqXjhjHXQFUHtdCDX3A@public.gmane.org>
> ---
>  man3/setnetgrent.3 | 44 ++++++++++++++++++++++++++++++++++++++++++++
>  1 file changed, 44 insertions(+)
> 
> diff --git a/man3/setnetgrent.3 b/man3/setnetgrent.3
> index 24675c8..233bea6 100644
> --- a/man3/setnetgrent.3
> +++ b/man3/setnetgrent.3
> @@ -89,6 +89,50 @@ These functions return 1 on success and 0 for failure.
>  .I /etc/netgroup
>  .br
>  .I /etc/nsswitch.conf
> +.SH ATTRIBUTES
> +For an explanation of the terms used in this section, see
> +.BR attributes (7).
> +.TS
> +allbox;
> +lbw16 lb lbw23
> +l l l.
> +Interface	Attribute	Value
> +T{
> +.BR setnetgrent (),
> +.br
> +.BR getnetgrent_r (),
> +.br
> +.BR innetgr ()
> +T}	Thread safety	T{
> +MT-Unsafe race:netgrent
> +.br
> +locale
> +T}
> +T{
> +.BR endnetgrent ()
> +T}	Thread safety	MT-Unsafe race:netgrent
> +T{
> +.BR getnetgrent ()
> +T}	Thread safety	T{
> +MT-Unsafe race:netgrent
> +.br
> +race:netgrentbuf locale
> +T}
> +.TE
> +
> +In the above table,
> +.I netgrent
> +in
> +.I race:netgrent
> +signifies that if any of the functions
> +.BR setnetgrent (3),
> +.BR getnetgrent_r (3),
> +.BR innetgr (3),
> +.BR getnetgrent (3),
> +or
> +.BR endnetgrent (3)
> +are used in parallel in different threads of a program,
> +then data races could occur.
>  .SH CONFORMING TO
>  These functions are not in POSIX.1-2001, but
>  .BR setnetgrent (),
> 


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

[Zeng Linggang]

The markings match glibc markings.

updwtmp: MT-Unsafe sig:ALRM timer
logwtmp: MT-Unsafe sig:ALRM timer

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

diff --git a/man3/updwtmp.3 b/man3/updwtmp.3
index 3f451fc..70281f4 100644
--- a/man3/updwtmp.3
+++ b/man3/updwtmp.3
@@ -59,6 +59,21 @@ to append the structure to the wtmp file.
 .TP
 .I /var/log/wtmp
 database of past user logins
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lb lb lbw24
+l l l.
+Interface	Attribute	Value
+T{
+.BR updwtmp (),
+.br
+.BR logwtmp ()
+T}	Thread safety	MT-Unsafe sig:ALRM timer
+.TE
+
 .SH CONFORMING TO
 Not in POSIX.1-2001.
 Present on Solaris, NetBSD, and perhaps other systems.
-- 
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] updwtmp.3: ATTRIBUTES: Note functions that aren't thread-safe

[Michael Kerrisk (man-pages)]

On 04/16/2015 07:09 AM, Zeng Linggang wrote:
> The markings match glibc markings.

Thanks, Zeng. Applied.

Cheers,

Michael


> updwtmp: MT-Unsafe sig:ALRM timer
> logwtmp: MT-Unsafe sig:ALRM timer
> 
> Signed-off-by: Zeng Linggang <zenglg.jy-BthXqXjhjHXQFUHtdCDX3A@public.gmane.org>
> ---
>  man3/updwtmp.3 | 15 +++++++++++++++
>  1 file changed, 15 insertions(+)
> 
> diff --git a/man3/updwtmp.3 b/man3/updwtmp.3
> index 3f451fc..70281f4 100644
> --- a/man3/updwtmp.3
> +++ b/man3/updwtmp.3
> @@ -59,6 +59,21 @@ to append the structure to the wtmp file.
>  .TP
>  .I /var/log/wtmp
>  database of past user logins
> +.SH ATTRIBUTES
> +For an explanation of the terms used in this section, see
> +.BR attributes (7).
> +.TS
> +allbox;
> +lb lb lbw24
> +l l l.
> +Interface	Attribute	Value
> +T{
> +.BR updwtmp (),
> +.br
> +.BR logwtmp ()
> +T}	Thread safety	MT-Unsafe sig:ALRM timer
> +.TE
> +
>  .SH CONFORMING TO
>  Not in POSIX.1-2001.
>  Present on Solaris, NetBSD, and perhaps other systems.
> 


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

[Zeng Linggang]

The markings match glibc markings.

wordexp:  MT-Unsafe race:utent const:env env sig:ALRM timer locale

wordfree: MT-Safe

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

diff --git a/man3/wordexp.3 b/man3/wordexp.3
index 4d352cb..a38c931 100644
--- a/man3/wordexp.3
+++ b/man3/wordexp.3
@@ -184,6 +184,40 @@ unmatched quotes.
 and
 .BR wordfree ()
 are provided in glibc since version 2.1.
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lb lb lbw30
+l l l.
+Interface	Attribute	Value
+T{
+.BR wordexp ()
+T}	Thread safety	T{
+MT-Unsafe race:utent const:env
+.br
+env sig:ALRM timer locale
+T}
+T{
+.BR wordfree ()
+T}	Thread safety	MT-Safe
+.TE
+
+In the above table,
+.I utent
+in
+.I race:utent
+signifies that if any of the functions
+.BR setutent (3),
+.BR getutent (3),
+or
+.BR endutent (3)
+are used in parallel in different threads of a program,
+then data races could occur.
+.BR wordexp (3)
+calls those functions,
+so we use race:utent to remind users.
 .SH CONFORMING TO
 POSIX.1-2001.
 .SH EXAMPLE
-- 
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] wordexp.3: ATTRIBUTES: Note functions that isn't thread-safe

[Michael Kerrisk (man-pages)]

On 04/16/2015 07:09 AM, Zeng Linggang wrote:
> The markings match glibc markings.

Thanks, Zeng. Applied.

Cheers,

Michael


> wordexp:  MT-Unsafe race:utent const:env env sig:ALRM timer locale
> 
> wordfree: MT-Safe
> 
> Signed-off-by: Zeng Linggang <zenglg.jy-BthXqXjhjHXQFUHtdCDX3A@public.gmane.org>
> ---
>  man3/wordexp.3 | 34 ++++++++++++++++++++++++++++++++++
>  1 file changed, 34 insertions(+)
> 
> diff --git a/man3/wordexp.3 b/man3/wordexp.3
> index 4d352cb..a38c931 100644
> --- a/man3/wordexp.3
> +++ b/man3/wordexp.3
> @@ -184,6 +184,40 @@ unmatched quotes.
>  and
>  .BR wordfree ()
>  are provided in glibc since version 2.1.
> +.SH ATTRIBUTES
> +For an explanation of the terms used in this section, see
> +.BR attributes (7).
> +.TS
> +allbox;
> +lb lb lbw30
> +l l l.
> +Interface	Attribute	Value
> +T{
> +.BR wordexp ()
> +T}	Thread safety	T{
> +MT-Unsafe race:utent const:env
> +.br
> +env sig:ALRM timer locale
> +T}
> +T{
> +.BR wordfree ()
> +T}	Thread safety	MT-Safe
> +.TE
> +
> +In the above table,
> +.I utent
> +in
> +.I race:utent
> +signifies that if any of the functions
> +.BR setutent (3),
> +.BR getutent (3),
> +or
> +.BR endutent (3)
> +are used in parallel in different threads of a program,
> +then data races could occur.
> +.BR wordexp (3)
> +calls those functions,
> +so we use race:utent to remind users.
>  .SH CONFORMING TO
>  POSIX.1-2001.
>  .SH EXAMPLE
> 


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

[Michael Kerrisk (man-pages)]

On 04/16/2015 07:09 AM, Zeng Linggang wrote:
> The markings match glibc markings.


Thanks, Zeng. Applied.

Cheers,

Michael


> glob:     MT-Unsafe race:utent env sig:ALRM timer local
> 
> globfree: MT-Safe
> 
> Signed-off-by: Zeng Linggang <zenglg.jy-BthXqXjhjHXQFUHtdCDX3A@public.gmane.org>
> ---
>  man3/glob.3 | 34 ++++++++++++++++++++++++++++++++++
>  1 file changed, 34 insertions(+)
> 
> diff --git a/man3/glob.3 b/man3/glob.3
> index 857dff0..65fc6a8 100644
> --- a/man3/glob.3
> +++ b/man3/glob.3
> @@ -273,6 +273,40 @@ for a read error, and
>  .TP
>  .B GLOB_NOMATCH
>  for no found matches.
> +.SH ATTRIBUTES
> +For an explanation of the terms used in this section, see
> +.BR attributes (7).
> +.TS
> +allbox;
> +lb lb lbw24
> +l l l.
> +Interface	Attribute	Value
> +T{
> +.BR glob ()
> +T}	Thread safety	T{
> +MT-Unsafe race:utent env
> +.br
> +sig:ALRM timer locale
> +T}
> +T{
> +.BR globfree ()
> +T}	Thread safety	MT-Safe
> +.TE
> +
> +In the above table,
> +.I utent
> +in
> +.I race:utent
> +signifies that if any of the functions
> +.BR setutent (3),
> +.BR getutent (3),
> +or
> +.BR endutent (3)
> +are used in parallel in different threads of a program,
> +then data races could occur.
> +.BR glob (3)
> +calls those functions,
> +so we use race:utent to remind users.
>  .SH CONFORMING TO
>  POSIX.2, POSIX.1-2001.
>  .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