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

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

View File

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