Re: [PATCH] getgrent_r.3: ATTRIBUTES: Note functions that are/aren't thread-safe
From: Michael Kerrisk (man-pages) <hidden>
Date: 2015-06-18 07:05:11
Possibly related (same subject, not in this thread)
- 2015-06-18 · [PATCH] getgrent_r.3: ATTRIBUTES: Note functions that are/aren't thread-safe · Zeng Linggang <hidden>
On 06/18/2015 07:36 AM, Zeng Linggang wrote:
The markings match glibc markings. markings of functions in glibc are: - getgrent_r: MT-Unsafe race:grent locale - fgetgrent_r: MT-Safe
Thanks, Zeng Linggang. Applied. Cheers, Michael
quoted hunk
Signed-off-by: Zeng Linggang <redacted> --- man3/getgrent_r.3 | 28 ++++++++++++++++++++++++++++ 1 file changed, 28 insertions(+)diff --git a/man3/getgrent_r.3 b/man3/getgrent_r.3 index 00927d6..847e69c 100644 --- a/man3/getgrent_r.3 +++ b/man3/getgrent_r.3@@ -114,6 +114,34 @@ No more entries. .B ERANGE Insufficient buffer space supplied. Try again with larger buffer. +.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 getgrent_r () +T} Thread safety MT-Unsafe race:grent locale +T{ +.BR fgetgrent_r () +T} Thread safety MT-Safe +.TE + +In the above table, +.I grent +in +.I race:grent +signifies that if any of the functions +.BR setgrent (), +.BR getgrent (), +.BR endgrent (), +or +.BR getgrent_r () +are used in parallel in different threads of a program, +then data races could occur. .SH CONFORMING TO These functions are GNU extensions, done in a style resembling the POSIX version of functions like
-- 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