getgrnam.3: Add description of the functions are not thread-safe.
PATCH 1/1 getgrnam.3: Add description of the functions are not thread-safe.
The functions getgrnam() and getgrgid() return a pointer to a static area which is overwritten by a subsequent call to them. So they are thread-unsafe.
Signed-off-by Peng Haitao <[email protected]>
--- man3/getgrnam.3 | 15 ++++++++++++++- 1 files changed, 14 insertions(+), 1 deletions(-)
man3/getgrnam.3 +14 -1
@@ -28,7 +28,7 @@ .\" Modified 1993-07-24 by Rik Faith ([email protected]) .\" Modified 2003-11-15 by aeb .\" -.TH GETGRNAM 3 2010-10-21 "" "Linux Programmer's Manual" +.TH GETGRNAM 3 2011-09-07 "" "Linux Programmer's Manual" .SH NAME getgrnam, getgrnam_r, getgrgid, getgrgid_r \- get group file entry .SH SYNOPSIS
@@ -199,6 +199,19 @@ Insufficient buffer space supplied. .TP .I /etc/group local group database file +.SH ATTRIBUTES +.SS Multithreading (see pthreads(7)) +The two functions +.BR getgrnam () +and +.BR getgrgid () +are not thread-safe. +.LP +The two functions +.BR getgrnam_r () +and +.BR getgrgid_r () +are thread-safe. .SH "CONFORMING TO" SVr4, 4.3BSD, POSIX.1-2001. .SH NOTES
Signature · 10 lines
1.7.1 -- Best Regards, Peng Haitao -- To unsubscribe from this list: send the line "unsubscribe linux-man" in the body of a message to [email protected] More majordomo info at http://vger.kernel.org/majordomo-info.html
A message that is not in the archive (sent off-list or not yet received): [email protected]
Quoted 3 lines · Peng Haitao
The functions
getgrnam()andgetgrgid()return a pointer to a static area which is overwritten by a subsequent call to them. So they are thread-unsafe.
I've applied this patch.
Thanks,
Michael
Quoted 45 lines
Signed-off-by Peng Haitao <[email protected]>--- man3/getgrnam.3 | 15 ++++++++++++++- 1 files changed, 14 insertions(+), 1 deletions(-)man3/getgrnam.3 +14
-2@@ -28,7 +28,7 @@ .\" Modified 1993-07-24 by Rik Faith ([email protected]) .\" Modified 2003-11-15 by aeb .\" -.TH GETGRNAM 3 2010-10-21 "" "Linux Programmer's Manual" +.TH GETGRNAM 3 2011-09-07 "" "Linux Programmer's Manual" .SH NAME getgrnam, getgrnam_r, getgrgid, getgrgid_r \- get group file entry .SH SYNOPSIS@@ -199,6 +199,19 @@ Insufficient buffer space supplied. .TP .I /etc/group local group database file +.SH ATTRIBUTES +.SS Multithreading (see pthreads(7)) +The two functions +.BR getgrnam () +and +.BR getgrgid () +are not thread-safe. +.LP +The two functions +.BR getgrnam_r () +and +.BR getgrgid_r () +are thread-safe. .SH "CONFORMING TO" SVr4, 4.3BSD, POSIX.1-2001. .SH NOTES --1.7.1
--
Best Regards,
Peng Haitao
Signature · 7 lines
Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Author of "The Linux Programming Interface"; http://man7.org/tlpi/ -- To unsubscribe from this list: send the line "unsubscribe linux-man" in the body of a message to [email protected] More majordomo info at http://vger.kernel.org/majordomo-info.html