summaryrefslogtreecommitdiff
path: root/lib/libc
diff options
context:
space:
mode:
authordholland <dholland@NetBSD.org>2021-02-17 23:51:04 +0000
committerdholland <dholland@NetBSD.org>2021-02-17 23:51:04 +0000
commit0ef3edfee50e16cce3026bdb74337fc7557ba8a8 (patch)
treeeb8d93f81a1f7e90857bdfec83ef2755f9c12fa1 /lib/libc
parentb0fdac27bae4fac65a037400471f1a88e2cafd35 (diff)
Document that rewinddir(3) might either reopen or just lseek the dir.
(Currently it depends on the underlying directory, but documenting the exact details seems inadvisable.) Also, Someone(TM) should check if POSIX permits this or if we ought to improve the implementation.
Diffstat (limited to 'lib/libc')
-rw-r--r--lib/libc/gen/directory.313
1 files changed, 11 insertions, 2 deletions
diff --git a/lib/libc/gen/directory.3 b/lib/libc/gen/directory.3
index 66bd1a48bbc..1375afaca3e 100644
--- a/lib/libc/gen/directory.3
+++ b/lib/libc/gen/directory.3
@@ -1,4 +1,4 @@
-.\" $NetBSD: directory.3,v 1.42 2021/02/17 23:39:46 dholland Exp $
+.\" $NetBSD: directory.3,v 1.43 2021/02/17 23:51:04 dholland Exp $
.\"
.\" Copyright (c) 1983, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@@ -29,7 +29,7 @@
.\"
.\" @(#)directory.3 8.1 (Berkeley) 6/4/93
.\"
-.Dd January 22, 2016
+.Dd February 17, 2021
.Dt DIRECTORY 3
.Os
.Sh NAME
@@ -225,6 +225,15 @@ It also causes the directory stream to refer to the
current state of the corresponding directory, as if a call to
.Fn opendir
was made.
+It is not specified whether this refers to the ``corresponding directory''
+by name or by underlying object.
+(These can differ if
+.Xr rename 2
+has been used.)
+.\" Note: currently the underlying fd is reopened if and only if
+.\" __DTF_READALL is in effect, which is true for union mounts and
+.\" nfs; documenting that exactly seems inadvisable since it might
+.\" change. -- dholland 20210217
.Pp
If
.Fa dirp