summaryrefslogtreecommitdiff
path: root/manual/filesys.texi
diff options
context:
space:
mode:
authorFlorian Weimer <fweimer@redhat.com>2016-02-20 12:56:55 +0100
committerFlorian Weimer <fweimer@redhat.com>2016-02-20 12:56:55 +0100
commit7584a3f96de88d5eefe5d6c634515278cbfbf052 (patch)
tree7904460c019d1a398a7fa84d5a53e231bc2dc11e /manual/filesys.texi
parent8d9c92017d85f23ba6a2b3614b2f2bcf1820d6f0 (diff)
Deprecate readdir_r, readdir64_r [BZ #19056]
Diffstat (limited to 'manual/filesys.texi')
-rw-r--r--manual/filesys.texi13
1 files changed, 7 insertions, 6 deletions
diff --git a/manual/filesys.texi b/manual/filesys.texi
index 972e1065be..b3236642e4 100644
--- a/manual/filesys.texi
+++ b/manual/filesys.texi
@@ -525,8 +525,9 @@ locking. Like @code{readdir} it returns the next entry from the
directory. To prevent conflicts between simultaneously running
threads the result is stored inside the @var{entry} object.
-@strong{Portability Note:} It is recommended to use @code{readdir}
-instead of @code{readdir_r} for the following reasons:
+@strong{Portability Note:} @code{readdir_r} is deprecated. It is
+recommended to use @code{readdir} instead of @code{readdir_r} for the
+following reasons:
@itemize @bullet
@item
@@ -604,10 +605,10 @@ In all other aspects this function is equivalent to @code{readdir}.
@comment LFS
@deftypefun int readdir64_r (DIR *@var{dirstream}, struct dirent64 *@var{entry}, struct dirent64 **@var{result})
@safety{@prelim{}@mtsafe{}@asunsafe{@asulock{}}@acunsafe{@aculock{}}}
-The @code{readdir64_r} function is equivalent to the @code{readdir_r}
-function except that it takes parameters of base type @code{struct
-dirent64} instead of @code{struct dirent} in the second and third
-position. The same precautions mentioned in the documentation of
+The deprecated @code{readdir64_r} function is equivalent to the
+@code{readdir_r} function except that it takes parameters of base type
+@code{struct dirent64} instead of @code{struct dirent} in the second and
+third position. The same precautions mentioned in the documentation of
@code{readdir_r} also apply here.
@end deftypefun