setnetgrent.3: ATTRIBUTES: Note functions that aren't thread-safe

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@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Zeng Linggang 2015-04-16 13:09:36 +08:00 committed by Michael Kerrisk
parent b63bb31a91
commit ff4465781b
1 changed files with 44 additions and 0 deletions

View File

@ -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 (),