getpwnam.3: Add description of the functions are not thread-safe
PATCH 1/1 getpwnam.3: Add description of the functions are not thread-safe
The functions getpwnam() and getpwuid() return a pointer to a static area which is overwritten by a subsequent call to them. So they are thread-unsafe.
--- man3/getpwnam.3 | 15 ++++++++++++++- 1 files changed, 14 insertions(+), 1 deletions(-)
man3/getpwnam.3 +14 -1
@@ -32,7 +32,7 @@ .\" Modified 2003-11-15 by aeb .\" 2008-11-07, mtk, Added an example program for getpwnam_r(). .\" -.TH GETPWNAM 3 2010-10-21 "GNU" "Linux Programmer's Manual" +.TH GETPWNAM 3 2011-09-15 "GNU" "Linux Programmer's Manual" .SH NAME getpwnam, getpwnam_r, getpwuid, getpwuid_r \- get password file entry .SH SYNOPSIS
@@ -206,6 +206,19 @@ Insufficient buffer space supplied. .TP .I /etc/passwd local password database file +.SH ATTRIBUTES +.SS Multithreading (see pthreads(7)) +The two functions +.BR getpwnam () +and +.BR getpwuid () +are not thread_safe. +.LP +The two functions +.BR getpwnam_r () +and +.BR getpwuid_r () +are thread-safe. .SH "CONFORMING TO" SVr4, 4.3BSD, POSIX.1-2001. The
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]
Peng,
I dug through some old mails...
Quoted 3 lines · Peng Haitao
The functions
getpwnam()andgetpwuid()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 to my local branch.
Cheers,
Michael
Quoted 49 lines
Signed-off-by Peng Haitao <[email protected]>--- man3/getpwnam.3 | 15 ++++++++++++++- 1 files changed, 14 insertions(+), 1 deletions(-)man3/getpwnam.3 +14
-2@@ -32,7 +32,7 @@ .\" Modified 2003-11-15 by aeb .\" 2008-11-07, mtk, Added an example program for getpwnam_r(). .\" -.TH GETPWNAM 3 2010-10-21 "GNU" "Linux Programmer's Manual" +.TH GETPWNAM 3 2011-09-15 "GNU" "Linux Programmer's Manual" .SH NAME getpwnam, getpwnam_r, getpwuid, getpwuid_r \- get password file entry .SH SYNOPSIS@@ -206,6 +206,19 @@ Insufficient buffer space supplied. .TP .I /etc/passwd local password database file +.SH ATTRIBUTES +.SS Multithreading (see pthreads(7)) +The two functions +.BR getpwnam () +and +.BR getpwuid () +are not thread_safe. +.LP +The two functions +.BR getpwnam_r () +and +.BR getpwuid_r () +are thread-safe. .SH "CONFORMING TO" SVr4, 4.3BSD, POSIX.1-2001. The --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
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