From 215b808acf4bb204e6fb04ceed5b1d6571714739 Mon Sep 17 00:00:00 2001
From: Bob Beck <beck@cvs.openbsd.org>
Date: Sat, 6 Oct 2018 23:08:14 +0000
Subject: Stop telling oversimplifying lies about whether or not VOP_LOOKUP
 will return the original vnode to you locked or unlocked. Just admit that it
 depends... ok guenther@

---
 share/man/man9/VOP_LOOKUP.9 | 19 +++++++++++++------
 1 file changed, 13 insertions(+), 6 deletions(-)

diff --git a/share/man/man9/VOP_LOOKUP.9 b/share/man/man9/VOP_LOOKUP.9
index ce8286978c8..37af6826a58 100644
--- a/share/man/man9/VOP_LOOKUP.9
+++ b/share/man/man9/VOP_LOOKUP.9
@@ -1,4 +1,4 @@
-.\" $OpenBSD: VOP_LOOKUP.9,v 1.43 2018/06/07 13:37:27 visa Exp $
+.\" $OpenBSD: VOP_LOOKUP.9,v 1.44 2018/10/06 23:08:13 beck Exp $
 .\"
 .\" Copyright (c) 2003 Ted Unangst
 .\" Copyright (c) 2000, 2001 The NetBSD Foundation, Inc.
@@ -24,7 +24,7 @@
 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd $Mdocdate: June 7 2018 $
+.Dd $Mdocdate: October 6 2018 $
 .Dt VOP_LOOKUP 9
 .Os
 .Sh NAME
@@ -644,19 +644,26 @@ in the directory
 and return a vnode in
 .Fa vpp .
 .Fa dvp
-is locked on entry and exit, and
+must be locked and referenced on entry with
+.Xr vget 9 .
+On a successful return,
 .Fa vpp
-is locked upon a successful return.
+will be returned locked and referenced, and
+.Fa dvp
+will return with the same reference count, but may be returned locked
+or unlocked depending on the specific flags used in
+.Fa cnp->cn_flags .
+On error
 .Fa vpp
 will be
 .Dv NULL
-on error, and
+and
 .Fa cnp->cn_flags
 will be set to
 .Dv PDIRUNLOCK
 if
 .Fa dvp
-has been unlocked for an unsuccessful return.
+has been unlocked.
 .Pp
 .It Fn VOP_MKDIR dvp vpp cnp vap
 Create a new directory named by
-- 
cgit v1.2.3