[PATCH ] ATTRIBUTES: new correct versions

[PATCH ] ATTRIBUTES: new correct versions

[Zeng Linggang]

Hi,

This patch-set is the new correct versions for previous patches from me.

1. Fix an English grammar mistake in the title: "those" should be "that".
2. Quote the glibc markings in the commit message.

ps:
Please *ignore* all patches before this patch-set sent by me.
Include the child thread about below subject:
[PATCH v2] getutent.3: ATTRIBUTES: Note functions those aren't thread-safe
[PATCH] ctime.3: ATTRIBUTES: Note functions thoes aren't thread-safe
[PATCH] asprintf.3: ATTRIBUTES: Note functions those are thread-safe
[PATCH] getutent.3: ATTRIBUTES: Note functions those aren't thread-safe

Thanks,
Zeng
--
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] asprintf.3: ATTRIBUTES: Note functions that are thread-safe

[Zeng Linggang]

The markings match glibc markings.

asprintf:  MT-Safe locale
vasprintf: MT-Safe locale

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

diff --git a/man3/asprintf.3 b/man3/asprintf.3
index f8f9a9b..981126c 100644
--- a/man3/asprintf.3
+++ b/man3/asprintf.3
@@ -58,6 +58,20 @@ If memory allocation wasn't possible, or some other error occurs,
 these functions will return \-1, and the contents of
 .I strp
 is undefined.
+.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 asprintf (),
+.BR vasprintf ()
+T}	Thread safety	MT-Safe locale
+.TE
+
 .SH CONFORMING TO
 These functions are GNU extensions, not in C or POSIX.
 They are also available under *BSD.
-- 
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] ctime.3: ATTRIBUTES: Note functions that aren't thread-safe

[Zeng Linggang]

The markings match glibc markings.

asctime:     MT-Unsafe race:asctime locale

asctime_r:   MT-Safe locale

ctime:       MT-Unsafe race:tmbuf race:asctime env locale

ctime_r:     MT-Safe env locale
gmtime_r:    MT-Safe env locale
localtime_r: MT-Safe env locale
mktime:      MT-Safe env locale

gmtime:      MT-Unsafe race:tmbuf env locale
localtime:   MT-Unsafe race:tmbuf env locale

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

diff --git a/man3/ctime.3 b/man3/ctime.3
index b127716..c5959d1 100644
--- a/man3/ctime.3
+++ b/man3/ctime.3
@@ -279,6 +279,39 @@ Each of these functions returns the value described, or NULL
 (\-1 in case of
 .BR mktime ())
 in case an error was detected.
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lbw14 lb lbw31
+l l l.
+Interface	Attribute	Value
+T{
+.BR asctime ()
+T}	Thread safety	MT-Unsafe race:asctime locale
+T{
+.BR asctime_r ()
+T}	Thread safety	MT-Safe locale
+T{
+.BR ctime ()
+T}	Thread safety	T{
+MT-Unsafe race:tmbuf
+.br
+race:asctime env locale
+T}
+T{
+.BR ctime_r (),
+.BR gmtime_r (),
+.BR localtime_r (),
+.BR mktime ()
+T}	Thread safety	MT-Safe env locale
+T{
+.BR gmtime (),
+.BR localtime ()
+T}	Thread safety	MT-Unsafe race:tmbuf env locale
+.TE
+
 .SH CONFORMING TO
 POSIX.1-2001.
 C89 and C99 specify
-- 
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] gethostbyname.3: ATTRIBUTES: Note functions that aren't thread-safe

[Zeng Linggang]

The markings match glibc markings.

gethostbyname:    MT-Unsafe race:hostbyname env locale

gethostbyaddr:    MT-Unsafe race:hostbyaddr env locale

sethostent:       MT-Unsafe race:hostent env locale
endhostent:       MT-Unsafe race:hostent env locale
gethostent_r:     MT-Unsafe race:hostent env locale

herror:           MT‐Safe
hstrerror:        MT‐Safe

gethostent:       MT-Unsafe race:hostent race:hostentbuf env locale

gethostbyname2:   MT-Unsafe race:hostbyname2 env locale

gethostbyaddr_r:  MT-Safe env locale
gethostbyname_r:  MT-Safe env locale
gethostbyname2_r: MT-Safe env locale

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

diff --git a/man3/gethostbyname.3 b/man3/gethostbyname.3
index 41a5886..91898b9 100644
--- a/man3/gethostbyname.3
+++ b/man3/gethostbyname.3
@@ -314,6 +314,77 @@ host database file
 .TP
 .I /etc/nsswitch.conf
 name service switch configuration
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lbw18 lb lbw29
+l l l.
+Interface	Attribute	Value
+T{
+.BR gethostbyname ()
+T}	Thread safety	T{
+MT-Unsafe race:hostbyname env
+.br
+locale
+T}
+T{
+.BR gethostbyaddr ()
+T}	Thread safety	T{
+MT-Unsafe race:hostbyaddr env
+.br
+locale
+T}
+T{
+.BR sethostent (),
+.br
+.BR endhostent (),
+.br
+.BR gethostent_r ()
+T}	Thread safety	T{
+MT-Unsafe race:hostent env
+.br
+locale
+T}
+T{
+.BR herror (),
+.br
+.BR hstrerror ()
+T}	Thread safety	MT-Safe
+T{
+.BR gethostent ()
+T}	Thread safety	T{
+MT-Unsafe race:hostent
+.br
+race:hostentbuf env locale
+T}
+T{
+.BR gethostbyname2 ()
+T}	Thread safety	T{
+MT-Unsafe race:hostbyname2
+.br
+env locale
+T}
+T{
+.BR gethostbyaddr_r (),
+.BR gethostbyname_r (),
+.BR gethostbyname2_r ()
+T}	Thread safety	MT-Safe env locale
+.TE
+
+In the above table,
+.I hostent
+in
+.I race:hostent
+signifies that if any of the functions
+.BR sethostent (3),
+.BR gethostent (3),
+.BR gethostent_r (3),
+or
+.BR endhostent (3)
+are used in parallel in different threads of a program,
+then data races could occur.
 .SH CONFORMING TO
 POSIX.1-2001 specifies
 .BR gethostbyname (),
-- 
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] getnetent.3: ATTRIBUTES: Note functions that aren't thread-safe

[Zeng Linggang]

The markings match glibc markings.

getnetent:    MT-Unsafe race:netent race:netentbuf env locale

getnetbyname: MT-Unsafe race:netbyname env locale

getnetbyaddr: MT-Unsafe race:netbyaddr locale

setnetent:    MT-Unsafe race:netent env locale
endnetent:    MT-Unsafe race:netent env locale

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

diff --git a/man3/getnetent.3 b/man3/getnetent.3
index f071744..c4f197e 100644
--- a/man3/getnetent.3
+++ b/man3/getnetent.3
@@ -142,6 +142,57 @@ error occurs or the end of the file is reached.
 .TP
 .I /etc/networks
 networks database file
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lbw14 lb lbw25
+l l l.
+Interface	Attribute	Value
+T{
+.BR getnetent ()
+T}	Thread safety	T{
+MT-Unsafe race:netent
+.br
+race:netentbuf env locale
+T}
+T{
+.BR getnetbyname ()
+T}	Thread safety	T{
+MT-Unsafe race:netbyname
+.br
+env locale
+T}
+T{
+.BR getnetbyaddr ()
+T}	Thread safety	T{
+MT-Unsafe race:netbyaddr
+.br
+locale
+T}
+T{
+.BR setnetent (),
+.br
+.BR endnetent ()
+T}	Thread safety	T{
+MT-Unsafe race:netent env
+.br
+locale
+T}
+.TE
+
+In the above table,
+.I netent
+in
+.I race:netent
+signifies that if any of the functions
+.BR setnetent (3),
+.BR getnetent (3),
+or
+.BR endnetent (3)
+are used in parallel in different threads of a program,
+then data races could occur.
 .SH CONFORMING TO
 4.3BSD, 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] get_nprocs_conf.3: ATTRIBUTES: Note functions that are thread-safe

[Zeng Linggang]

The markings match glibc markings.

get_nprocs:      MT-Safe
get_nprocs_conf: MT-Safe

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

diff --git a/man3/get_nprocs_conf.3 b/man3/get_nprocs_conf.3
index 8faf84f..157ac01 100644
--- a/man3/get_nprocs_conf.3
+++ b/man3/get_nprocs_conf.3
@@ -45,6 +45,21 @@ This may be less than the number returned by
 because processors may be offline (e.g., on hotpluggable systems).
 .SH RETURN VALUE
 As given in DESCRIPTION.
+.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 get_nprocs (),
+.br
+.BR get_nprocs_conf ()
+T}	Thread safety	MT-Safe
+.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

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

[Zeng Linggang]

The markings match glibc markings.

getutent:  MT-Unsafe init race:utent race:utentbuf sig:ALRM timer

getutid:   MT-Unsafe init race:utent sig:ALRM timer
getutline: MT-Unsafe init race:utent sig:ALRM timer

pututline: MT-Unsafe race:utent sig:ALRM timer

setutent:  MT-Unsafe race:utent
endutent:  MT-Unsafe race:utent
utmpname:  MT-Unsafe race:utent

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

diff --git a/man3/getutent.3 b/man3/getutent.3
index 4ff5581..1611d9b 100644
--- a/man3/getutent.3
+++ b/man3/getutent.3
@@ -155,6 +155,61 @@ functions can also fail for the reasons described in
 /var/run/utmp	database of currently logged-in users
 .br
 /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 lbw28
+l l l.
+Interface	Attribute	Value
+T{
+.BR getutent ()
+T}	Thread safety	T{
+MT-Unsafe init race:utent
+.br
+race:utentbuf sig:ALRM timer
+T}
+T{
+.BR getutid (),
+.br
+.BR getutline ()
+T}	Thread safety	T{
+MT-Unsafe init race:utent
+.br
+sig:ALRM timer
+T}
+T{
+.BR pututline ()
+T}	Thread safety	T{
+MT-Unsafe race:utent
+.br
+sig:ALRM timer
+T}
+T{
+.BR setutent (),
+.br
+.BR endutent (),
+.br
+.BR utmpname ()
+T}	Thread safety	MT-Unsafe race:utent
+.TE
+
+In the above table,
+.I utent
+in
+.I race:utent
+signifies that if any of the functions
+.BR setutent (3),
+.BR getutent (3),
+.BR getutid (3),
+.BR getutline (3),
+.BR pututline (3),
+.BR utmpname (3),
+or
+.BR endutent (3)
+are used in parallel in different threads of a program,
+then data races could occur.
 .SH CONFORMING TO
 XPG2, SVr4.
 .LP
-- 
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] mbsnrtowcs.3: ATTRIBUTES: Note function that isn't thread-safe

[Zeng Linggang]

The marking matches glibc marking.

mbsnrtowcs: MT-Unsafe race:mbsnrtowcs/!ps

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

diff --git a/man3/mbsnrtowcs.3 b/man3/mbsnrtowcs.3
index 305ad4d..f5e084e 100644
--- a/man3/mbsnrtowcs.3
+++ b/man3/mbsnrtowcs.3
@@ -160,6 +160,19 @@ is returned, and
 .I errno
 set to
 .BR EILSEQ .
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lb lb lbw29
+l l l.
+Interface	Attribute	Value
+T{
+.BR mbsnrtowcs ()
+T}	Thread safety	MT-Unsafe race:mbsnrtowcs/!ps
+.TE
+
 .SH CONFORMING TO
 POSIX.1-2008.
 .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] mbsrtowcs.3: ATTRIBUTES: Note function that isn't thread-safe

[Zeng Linggang]

The marking matches glibc marking.

mbsrtowcs: MT-Unsafe race:mbsrtowcs/!ps

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

diff --git a/man3/mbsrtowcs.3 b/man3/mbsrtowcs.3
index 4df9986..1359685 100644
--- a/man3/mbsrtowcs.3
+++ b/man3/mbsrtowcs.3
@@ -123,6 +123,19 @@ is returned, and
 .I errno
 set to
 .BR EILSEQ .
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lb lb lbw28
+l l l.
+Interface	Attribute	Value
+T{
+.BR mbsrtowcs ()
+T}	Thread safety	MT-Unsafe race:mbsrtowcs/!ps
+.TE
+
 .SH CONFORMING TO
 C99.
 .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] perror.3: ATTRIBUTES: Note function that is thread-safe

[Zeng Linggang]

The marking matches glibc marking.

perror: MT-Safe race:stderr

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

diff --git a/man3/perror.3 b/man3/perror.3
index 20f2209..2d67edc 100644
--- a/man3/perror.3
+++ b/man3/perror.3
@@ -108,6 +108,19 @@ Thus, if a failing call is not immediately followed by a call to
 the value of
 .I errno
 should be saved.
+.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 perror ()
+T}	Thread safety	MT-Safe race:stderr
+.TE
+
 .SH CONFORMING TO
 The function
 .BR perror ()
-- 
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] printf.3: ATTRIBUTES: Note functions that are thread-safe

[Zeng Linggang]

The markings match glibc markings.

printf:    MT-Safe locale
fprintf:   MT-Safe locale
sprintf:   MT-Safe locale
snprintf:  MT-Safe locale
vprintf:   MT-Safe locale
vfprintf:  MT-Safe locale
vsprintf:  MT-Safe locale
vsnprintf: MT-Safe locale

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

diff --git a/man3/printf.3 b/man3/printf.3
index db60850..8c95f96 100644
--- a/man3/printf.3
+++ b/man3/printf.3
@@ -822,6 +822,29 @@ A \(aq%\(aq is written.
 No argument is converted.
 The complete conversion
 specification is \(aq%%\(aq.
+.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 printf (),
+.BR fprintf (),
+.br
+.BR sprintf (),
+.BR snprintf (),
+.br
+.BR vprintf (),
+.BR vfprintf (),
+.br
+.BR vsprintf (),
+.BR vsnprintf ()
+T}	Thread safety	MT-Safe locale
+.TE
+
 .SH CONFORMING TO
 The
 .BR fprintf (),
-- 
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] scandir.3: ATTRIBUTES: Note functions that are thread-safe

[Zeng Linggang]

The markings match glibc markings.

scandir:     MT-Safe
scandirat:   MT-Safe

alphasort:   MT-Safe locale
versionsort: MT-Safe locale

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

diff --git a/man3/scandir.3 b/man3/scandir.3
index 6322c2e..640a275 100644
--- a/man3/scandir.3
+++ b/man3/scandir.3
@@ -226,6 +226,24 @@ was added to glibc in version 2.1.
 
 .BR scandirat ()
 was added to glibc in version 2.15.
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lbw26 lb lb
+l l l.
+Interface	Attribute	Value
+T{
+.BR scandir (),
+.BR scandirat ()
+T}	Thread safety	MT-Safe
+T{
+.BR alphasort (),
+.BR versionsort ()
+T}	Thread safety	MT-Safe locale
+.TE
+
 .SH CONFORMING TO
 .BR alphasort (),
 .BR scandir ():
-- 
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] scanf.3: ATTRIBUTES: Note functions that are thread-safe

[Zeng Linggang]

The markings match glibc markings.

scanf:   MT-Safe locale
fscanf:  MT-Safe locale
sscanf:  MT-Safe locale
vscanf:  MT-Safe locale
vsscanf: MT-Safe locale
vfscanf: MT-Safe locale

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

diff --git a/man3/scanf.3 b/man3/scanf.3
index 02455b4..6018694 100644
--- a/man3/scanf.3
+++ b/man3/scanf.3
@@ -574,6 +574,26 @@ Out of memory.
 .B ERANGE
 The result of an integer conversion would exceed the size
 that can be stored in the corresponding integer type.
+.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 scanf (),
+.BR fscanf (),
+.br
+.BR sscanf (),
+.BR vscanf (),
+.br
+.BR vsscanf (),
+.BR vfscanf ()
+T}	Thread safety	MT-Safe locale
+.TE
+
 .SH CONFORMING TO
 The functions
 .BR fscanf (),
-- 
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] unlocked_stdio.3: ATTRIBUTES: Note functions that aren't thread-safe

[Zeng Linggang]

The markings match glibc markings.

getc_unlocked:     MT-Safe race:stream
putc_unlocked:     MT-Safe race:stream
clearerr_unlocked: MT-Safe race:stream
fflush_unlocked:   MT-Safe race:stream
fgetc_unlocked:    MT-Safe race:stream
fputc_unlocked:    MT-Safe race:stream
fread_unlocked:    MT-Safe race:stream
fwrite_unlocked:   MT-Safe race:stream
fgets_unlocked:    MT-Safe race:stream
fputs_unlocked:    MT-Safe race:stream
getwc_unlocked:    MT-Safe race:stream
fgetwc_unlocked:   MT-Safe race:stream
fputwc_unlocked:   MT-Safe race:stream
putwc_unlocked:    MT-Safe race:stream
fgetws_unlocked:   MT-Safe race:stream
fputws_unlocked:   MT-Safe race:stream

getchar_unlocked:  MT-Unsafe race:stdin
getwchar_unlocked: MT-Unsafe race:stdin

putchar_unlocked:  MT-Unsafe race:stdout
putwchar_unlocked: MT-Unsafe race:stdout

feof_unlocked:     MT-Safe
ferror_unlocked:   MT-Safe
fileno_unlocked:   MT-Safe

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

diff --git a/man3/unlocked_stdio.3 b/man3/unlocked_stdio.3
index d5aada7..24bd179 100644
--- a/man3/unlocked_stdio.3
+++ b/man3/unlocked_stdio.3
@@ -110,6 +110,47 @@ without the "_unlocked" suffix, except that they do not use locking
 of locks set by others) and hence are thread-unsafe.
 See
 .BR flockfile (3).
+.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 getc_unlocked (),
+.BR putc_unlocked (),
+.BR clearerr_unlocked (),
+.BR fflush_unlocked (),
+.BR fgetc_unlocked (),
+.BR fputc_unlocked (),
+.BR fread_unlocked (),
+.BR fwrite_unlocked (),
+.BR fgets_unlocked (),
+.BR fputs_unlocked (),
+.BR getwc_unlocked (),
+.BR fgetwc_unlocked (),
+.BR fputwc_unlocked (),
+.BR putwc_unlocked (),
+.BR fgetws_unlocked (),
+.BR fputws_unlocked ()
+T}	Thread safety	MT-Safe race:stream
+T{
+.BR getchar_unlocked (),
+.BR getwchar_unlocked ()
+T}	Thread safety	MT-Unsafe race:stdin
+T{
+.BR putchar_unlocked (),
+.BR putwchar_unlocked ()
+T}	Thread safety	MT-Unsafe race:stdout
+T{
+.BR feof_unlocked (),
+.BR ferror_unlocked (),
+.BR fileno_unlocked ()
+T}	Thread safety	MT-Safe
+.TE
+
 .SH CONFORMING TO
 The four functions
 .BR getc_unlocked (),
-- 
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] wcrtomb.3: ATTRIBUTES: Note function that isn't thread-safe

[Zeng Linggang]

The marking matches glibc marking.

wcrtomb: MT-Unsafe race:wcrtomb/!ps

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

diff --git a/man3/wcrtomb.3 b/man3/wcrtomb.3
index 059e724..98bbba5 100644
--- a/man3/wcrtomb.3
+++ b/man3/wcrtomb.3
@@ -106,6 +106,19 @@ is returned, and
 .I errno
 set to
 .BR EILSEQ .
+.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 wcrtomb ()
+T}	Thread safety	MT-Unsafe race:wcrtomb/!ps
+.TE
+
 .SH CONFORMING TO
 C99.
 .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] wcsnrtombs.3: ATTRIBUTES: Note function that isn't thread-safe

[Zeng Linggang]

The marking matches glibc marking.

wcsnrtombs: MT-Unsafe race:wcsnrtombs/!ps

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

diff --git a/man3/wcsnrtombs.3 b/man3/wcsnrtombs.3
index a02c603..ab69767 100644
--- a/man3/wcsnrtombs.3
+++ b/man3/wcsnrtombs.3
@@ -157,6 +157,19 @@ is returned, and
 .I errno
 set to
 .BR EILSEQ .
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lb lb lbw29
+l l l.
+Interface	Attribute	Value
+T{
+.BR wcsnrtombs ()
+T}	Thread safety	MT-Unsafe race:wcsnrtombs/!ps
+.TE
+
 .SH CONFORMING TO
 POSIX.1-2008.
 .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] wcsrtombs.3: ATTRIBUTES: Note function that isn't thread-safe

[Zeng Linggang]

The marking matches glibc marking.

wcsrtombs: MT-Unsafe race:wcsrtombs/!ps

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

diff --git a/man3/wcsrtombs.3 b/man3/wcsrtombs.3
index 144ef47..8c01701 100644
--- a/man3/wcsrtombs.3
+++ b/man3/wcsrtombs.3
@@ -123,6 +123,19 @@ is returned, and
 .I errno
 set to
 .BR EILSEQ .
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lb lb lbw28
+l l l.
+Interface	Attribute	Value
+T{
+.BR wcsrtombs ()
+T}	Thread safety	MT-Unsafe race:wcsrtombs/!ps
+.TE
+
 .SH CONFORMING TO
 C99.
 .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] wprintf.3: ATTRIBUTES: Note functions that are thread-safe

[Zeng Linggang]

The markings match glibc markings.

wprintf:   MT-Safe locale
fwprintf:  MT-Safe locale
swprintf:  MT-Safe locale
vwprintf:  MT-Safe locale
vfwprintf: MT-Safe locale
vswprintf: MT-Safe locale

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

diff --git a/man3/wprintf.3 b/man3/wprintf.3
index 57d1cf4..219560d 100644
--- a/man3/wprintf.3
+++ b/man3/wprintf.3
@@ -208,6 +208,26 @@ case of the functions
 and
 .BR vswprintf ().
 They return \-1 when an error occurs.
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lbw24 lb lb
+l l l.
+Interface	Attribute	Value
+T{
+.BR wprintf (),
+.BR fwprintf (),
+.br
+.BR swprintf (),
+.BR vwprintf (),
+.br
+.BR vfwprintf (),
+.BR vswprintf ()
+T}	Thread safety	MT-Safe locale
+.TE
+
 .SH CONFORMING TO
 C99.
 .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 ] ATTRIBUTES: new correct versions

[Michael Kerrisk (man-pages)]

On 04/08/2015 04:56 AM, Zeng Linggang wrote:
> Hi,
> 
> This patch-set is the new correct versions for previous patches from me.
> 
> 1. Fix an English grammar mistake in the title: "those" should be "that".
> 2. Quote the glibc markings in the commit message.
> 
> ps:
> Please *ignore* all patches before this patch-set sent by me.
> Include the child thread about below subject:
> [PATCH v2] getutent.3: ATTRIBUTES: Note functions those aren't thread-safe
> [PATCH] ctime.3: ATTRIBUTES: Note functions thoes aren't thread-safe
> [PATCH] asprintf.3: ATTRIBUTES: Note functions those are thread-safe
> [PATCH] getutent.3: ATTRIBUTES: Note functions those aren't thread-safe

Thanks, Zeng. Perfect! I have applied all of the following, sent by you 
on 8 April:

    asprintf.3: ATTRIBUTES: Note functions that are thread-safe
    ctime.3: ATTRIBUTES: Note functions that aren't thread-safe
    gethostbyname.3: ATTRIBUTES: Note functions that aren't thread-safe
    getnetent.3: ATTRIBUTES: Note functions that aren't thread-safe
    get_nprocs_conf.3: ATTRIBUTES: Note functions that are thread-safe
    getutent.3: ATTRIBUTES: Note functions that aren't thread-safe
    mbsnrtowcs.3: ATTRIBUTES: Note function that isn't thread-safe
    mbsrtowcs.3: ATTRIBUTES: Note function that isn't thread-safe
    perror.3: ATTRIBUTES: Note function that is thread-safe
    printf.3: ATTRIBUTES: Note functions that are thread-safe
    scandir.3: ATTRIBUTES: Note functions that are thread-safe
    scanf.3: ATTRIBUTES: Note functions that are thread-safe
    unlocked_stdio.3: ATTRIBUTES: Note functions that aren't thread-safe
    wcrtomb.3: ATTRIBUTES: Note function that isn't thread-safe
    wcsnrtombs.3: ATTRIBUTES: Note function that isn't thread-safe
    wcsrtombs.3: ATTRIBUTES: Note function that isn't thread-safe
    wprintf.3: ATTRIBUTES: Note functions that are thread-safe

I believe that is everything. Please let me know if there is 
something from you that I should still apply.

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 ] ATTRIBUTES: new correct versions

[Zeng Linggang]

Hi,

On Sat, 2015-04-11 at 08:53 +0200, Michael Kerrisk (man-pages) wrote:
> On 04/08/2015 04:56 AM, Zeng Linggang wrote:
> > Hi,
> > 
> > This patch-set is the new correct versions for previous patches from me.
> > 
> > 1. Fix an English grammar mistake in the title: "those" should be "that".
> > 2. Quote the glibc markings in the commit message.
> > 
> > ps:
> > Please *ignore* all patches before this patch-set sent by me.
> > Include the child thread about below subject:
> > [PATCH v2] getutent.3: ATTRIBUTES: Note functions those aren't thread-safe
> > [PATCH] ctime.3: ATTRIBUTES: Note functions thoes aren't thread-safe
> > [PATCH] asprintf.3: ATTRIBUTES: Note functions those are thread-safe
> > [PATCH] getutent.3: ATTRIBUTES: Note functions those aren't thread-safe
> 
> Thanks, Zeng. Perfect! I have applied all of the following, sent by you 
> on 8 April:
> 
>     asprintf.3: ATTRIBUTES: Note functions that are thread-safe
>     ctime.3: ATTRIBUTES: Note functions that aren't thread-safe
>     gethostbyname.3: ATTRIBUTES: Note functions that aren't thread-safe
>     getnetent.3: ATTRIBUTES: Note functions that aren't thread-safe
>     get_nprocs_conf.3: ATTRIBUTES: Note functions that are thread-safe
>     getutent.3: ATTRIBUTES: Note functions that aren't thread-safe
>     mbsnrtowcs.3: ATTRIBUTES: Note function that isn't thread-safe
>     mbsrtowcs.3: ATTRIBUTES: Note function that isn't thread-safe
>     perror.3: ATTRIBUTES: Note function that is thread-safe
>     printf.3: ATTRIBUTES: Note functions that are thread-safe
>     scandir.3: ATTRIBUTES: Note functions that are thread-safe
>     scanf.3: ATTRIBUTES: Note functions that are thread-safe
>     unlocked_stdio.3: ATTRIBUTES: Note functions that aren't thread-safe
>     wcrtomb.3: ATTRIBUTES: Note function that isn't thread-safe
>     wcsnrtombs.3: ATTRIBUTES: Note function that isn't thread-safe
>     wcsrtombs.3: ATTRIBUTES: Note function that isn't thread-safe
>     wprintf.3: ATTRIBUTES: Note functions that are thread-safe
> 
> I believe that is everything. Please let me know if there is 
> something from you that I should still apply.
> 

Hmm, right, that is all.

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

[Zeng Linggang]

The markings match glibc markings.

Signed-off-by: Zeng Linggang <zenglg.jy-BthXqXjhjHXQFUHtdCDX3A@public.gmane.org>
Signed-off-by: Ma Shimiao <mashimiao.fnst-BthXqXjhjHXQFUHtdCDX3A@public.gmane.org>
---
 man3/getutent.3 | 36 ++++++++++++++++++++++++++++++++++++
 1 file changed, 36 insertions(+)

diff --git a/man3/getutent.3 b/man3/getutent.3
index 4ff5581..2160969 100644
--- a/man3/getutent.3
+++ b/man3/getutent.3
@@ -155,6 +155,42 @@ functions can also fail for the reasons described in
 /var/run/utmp	database of currently logged-in users
 .br
 /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 lb
+l l l.
+Interface	Attribute	Value
+T{
+.BR getutent ()
+T}	Thread safety	T{
+MT-Unsafe init race:utent
+.br
+race:utentbuf sig:ALRM timer
+T}
+T{
+.BR getutid (),
+.br
+.BR getutline ()
+T}	Thread safety	T{
+MT-Unsafe init race:utent sig:ALRM
+.br
+timer
+T}
+T{
+.BR pututline ()
+T}	Thread safety	MT-Unsafe race:utent sig:ALRM timer
+T{
+.BR setutent (),
+.br
+.BR endutent (),
+.br
+.BR utmpname ()
+T}	Thread safety	MT-Unsafe race:utent
+.TE
+
 .SH CONFORMING TO
 XPG2, SVr4.
 .LP
-- 
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] perror.3: ATTRIBUTES: Note function that is thread-safe

[Zeng Linggang]

The marking matches glibc marking.

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

diff --git a/man3/perror.3 b/man3/perror.3
index 20f2209..2d67edc 100644
--- a/man3/perror.3
+++ b/man3/perror.3
@@ -108,6 +108,19 @@ Thus, if a failing call is not immediately followed by a call to
 the value of
 .I errno
 should be saved.
+.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 perror ()
+T}	Thread safety	MT-Safe race:stderr
+.TE
+
 .SH CONFORMING TO
 The function
 .BR perror ()
-- 
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] perror.3: ATTRIBUTES: Note function that is thread-safe

[Michael Kerrisk (man-pages)]

On 03/23/2015 04:24 AM, Zeng Linggang wrote:
> The marking matches glibc marking.

Hello Zend Linggang,

Patch applied. Thank you.

Cheers,

Michael


> Signed-off-by: Zeng Linggang <zenglg.jy-BthXqXjhjHXQFUHtdCDX3A@public.gmane.org>
> Signed-off-by: Ma Shimiao <mashimiao.fnst-BthXqXjhjHXQFUHtdCDX3A@public.gmane.org>
> ---
>  man3/perror.3 | 13 +++++++++++++
>  1 file changed, 13 insertions(+)
> 
> diff --git a/man3/perror.3 b/man3/perror.3
> index 20f2209..2d67edc 100644
> --- a/man3/perror.3
> +++ b/man3/perror.3
> @@ -108,6 +108,19 @@ Thus, if a failing call is not immediately followed by a call to
>  the value of
>  .I errno
>  should be saved.
> +.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 perror ()
> +T}	Thread safety	MT-Safe race:stderr
> +.TE
> +
>  .SH CONFORMING TO
>  The function
>  .BR perror ()
> 


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