readdir.3: Add description of the function is not thread-safe
PATCH 1/1 readdir.3: Add description of the function is not thread-safe
The data returned by readdir() may be overwritten by subsequent calls to readdir() for the same directory stream, so it is not thread-safe.
Signed-off-by Peng Haitao <[email protected]>
--- man3/readdir.3 | 11 ++++++++++- 1 files changed, 10 insertions(+), 1 deletions(-)
man3/readdir.3 +10 -1
@@ -31,7 +31,7 @@ .\" Rework discussion of nonstandard structure fields. .\" 2008-09-11, mtk, Document readdir_r(). .\" -.TH READDIR 3 2010-09-10 "" "Linux Programmer's Manual" +.TH READDIR 3 2011-09-07 "" "Linux Programmer's Manual" .SH NAME readdir, readdir_r \- read a directory .SH SYNOPSIS
@@ -142,6 +142,15 @@ returns 0, and returns NULL in .TP .B EBADF Invalid directory stream descriptor \fIdirp\fP. +.SH ATTRIBUTES +.SS Multithreading (see pthreads(7)) +The +.BR readdir () +function is not thread-safe. +.LP +The +.BR readdir_r () +function is 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