Module Name: src
Committed By: riastradh
Date: Mon Aug 20 14:29:05 UTC 2018
Modified Files:
src/share/man/man9: uvm_map.9
Log Message:
Clarify reference counting of uvm_map.
To generate a diff of this commit:
cvs rdiff -u -r1.10 -r1.11 src/share/man/man9/uvm_map.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/uvm_map.9
diff -u src/share/man/man9/uvm_map.9:1.10 src/share/man/man9/uvm_map.9:1.11
--- src/share/man/man9/uvm_map.9:1.10 Sat May 20 08:00:47 2017
+++ src/share/man/man9/uvm_map.9 Mon Aug 20 14:29:05 2018
@@ -1,4 +1,4 @@
-.\" $NetBSD: uvm_map.9,v 1.10 2017/05/20 08:00:47 wiz Exp $
+.\" $NetBSD: uvm_map.9,v 1.11 2018/08/20 14:29:05 riastradh Exp $
.\"
.\" Copyright (c) 1998 Matthew R. Green
.\" All rights reserved.
@@ -136,11 +136,21 @@ is any other value, then a regular mappi
The start address of the map will be returned in
.Fa startp .
.El
-Note that
+If
+.Fa uobj
+is supplied, then
.Fn uvm_map
-does not add a reference to
-.Fa uobj ;
-it is the caller's responsibility to do so.
+.Em consumes
+the caller's reference to
+.Fa uobj
+on success;
+.Fn uvm_unmap
+will release it when removing this mapping.
+On failure,
+.Fn uvm_map
+leaves the reference count of
+.Fa uobj
+unmodified.
.Pp
.Fa align
specifies alignment of mapping unless
