Provide a man page for Alfreds lovely readdir_r function. Also

fixed a minor indentation nit and added a few {}s to make readdir_r
easier on old eyes.

1 files changed, 19 insertions, 0 deletions

diff --git a/lib/libc/gen/directory.3 b/lib/libc/gen/directory.3
index 23cd2f9..6334d38 100644
--- a/lib/libc/gen/directory.3
+++ b/lib/libc/gen/directory.3
@@ -38,6 +38,7 @@
 .Sh NAME
 .Nm opendir ,
 .Nm readdir ,
+.Nm readdir_r ,
 .Nm telldir ,
 .Nm seekdir ,
 .Nm rewinddir ,
@@ -51,6 +52,8 @@
 .Fn opendir "const char *filename"
 .Ft struct dirent *
 .Fn readdir "DIR *dirp"
+.Ft int
+.Fn readdir_r "DIR *dirp" "struct dirent *entry" "struct dirent **result"
 .Ft long
 .Fn telldir "const DIR *dirp"
 .Ft void
@@ -90,6 +93,22 @@ upon reaching the end of the directory or detecting an invalid
 .Fn seekdir
 operation.
 .Pp
+.Fn readdir_r
+provides the same functionality as
+.Fn readdir ,
+but the caller must provide a directory
+.Fa entry
+buffer to store the results in.  If the read succeeds, 
+.Fa result
+is pointed at the
+.Fa entry ;
+upon reaching the end of the directory
+.Fa result
+is set to
+.Dv NULL .
+.Fn readdir_r
+returns 0 on success or an error number to indicate failure.
+.Pp
 The
 .Fn telldir
 function