[src/trunk]: src/share/man/man9 add a note about pmap_activate() and pmap_dea...

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

details:   https://anonhg.NetBSD.org/src/rev/19f0d942ef4a
branches:  trunk
changeset: 838362:19f0d942ef4a
user:      mrg <mrg%NetBSD.org@localhost>
date:      Sun Jan 13 06:59:15 2019 +0000

description:
add a note about pmap_activate() and pmap_deactivate() not being allow to block.

diffstat:

 share/man/man9/pmap.9 |  14 ++++++++++++--
 1 files changed, 12 insertions(+), 2 deletions(-)

diffs (42 lines):

diff -r a883747fdcf4 -r 19f0d942ef4a share/man/man9/pmap.9
--- a/share/man/man9/pmap.9     Sun Jan 13 06:10:34 2019 +0000
+++ b/share/man/man9/pmap.9     Sun Jan 13 06:59:15 2019 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: pmap.9,v 1.44 2012/02/16 12:10:10 yamt Exp $
+.\"    $NetBSD: pmap.9,v 1.45 2019/01/13 06:59:15 mrg Exp $
 .\"
 .\" Copyright (c) 2000, 2001, 2002 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -27,7 +27,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd February 16, 2012
+.Dd January 13, 2019
 .Dt PMAP 9
 .Os
 .Sh NAME
@@ -764,6 +764,12 @@
 is the current lwp.
 .Fn pmap_activate
 must be able to handle this scenario.
+.Pp
+The
+.Fn pmap_activate
+call, like
+.Fn pmap_deactivate ,
+must never block, as it is used for context switching.
 .It void Fn "pmap_deactivate" "struct lwp *l"
 Deactivate the physical map used by the process behind lwp
 .Fa l .
@@ -775,6 +781,10 @@
 may not always be called when
 .Fa l
 is the current lwp.
+.Pp
+As above,
+.Fn pmap_deactivate
+must never block.
 .It void Fn "pmap_zero_page" "paddr_t pa"
 Zero the PAGE_SIZE sized region starting at physical address
 .Fa pa .