[src/trunk]: src/share/man/man9 Clarify what NOCACHE and MAKEENTRY do and who...

[riastradh <riastradh%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/1957aab85be2
branches:  trunk
changeset: 352142:1957aab85be2
user:      riastradh <riastradh%NetBSD.org@localhost>
date:      Sat Mar 18 16:12:20 2017 +0000

description:
Clarify what NOCACHE and MAKEENTRY do and who uses them.

De-editorialize.

diffstat:

 share/man/man9/namei.9 |  21 +++++++++++++--------
 1 files changed, 13 insertions(+), 8 deletions(-)

diffs (41 lines):

diff -r 1c13ce915f3a -r 1957aab85be2 share/man/man9/namei.9
--- a/share/man/man9/namei.9    Sat Mar 18 15:25:40 2017 +0000
+++ b/share/man/man9/namei.9    Sat Mar 18 16:12:20 2017 +0000
@@ -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 @@
 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