Module Name: src
Committed By: riastradh
Date: Sat Mar 18 16:12:20 UTC 2017
Modified Files:
src/share/man/man9: namei.9
Log Message:
Clarify what NOCACHE and MAKEENTRY do and who uses them.
De-editorialize.
To generate a diff of this commit:
cvs rdiff -u -r1.37 -r1.38 src/share/man/man9/namei.9
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/share/man/man9/namei.9
diff -u src/share/man/man9/namei.9:1.37 src/share/man/man9/namei.9:1.38
--- src/share/man/man9/namei.9:1.37 Sat May 7 08:52:10 2016
+++ src/share/man/man9/namei.9 Sat Mar 18 16:12:20 2017
@@ -1,4 +1,4 @@
-.\" $NetBSD: namei.9,v 1.37 2016/05/07 08:52:10 wiz Exp $
+.\" $NetBSD: namei.9,v 1.38 2017/03/18 16:12:20 riastradh Exp $
.\"
.\" Copyright (c) 2001, 2005, 2006 The NetBSD Foundation, Inc.
.\" All rights reserved.
@@ -360,19 +360,24 @@ This only makes sense in
mode and when creating a directory.
Set by the caller and used internally.
.It Dv NOCACHE
-The name looked up should not be entered in the
+The last component name looked up should not be entered in the
.Xr namecache 9 .
-Set and used internally.
-(Currently sometimes set by callers, but most likely this is
-improper/incorrect.)
-May also be used by file-system-level vnode functions.
+Set by the caller.
+Used internally in
+.Nm
+to decide whether to set
+.Dv MAKEENTRY
+for the last component.
+Used by the rename system call for lookup of the target node, which
+will be overwritten.
.It Dv MAKEENTRY
The current pathname component should be added to the
.Xr namecache 9 .
Set and used internally.
-Also abused by the
+Used by
.Xr nfs 4
-code.
+to decide whether to record directory and node mtimes in order to
+determine cache freshness for subsequent lookups.
.El
.Pp
The following additional historic flags have been removed from
