[src/trunk]: src Add a NVMM(4) man page.

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

details:   https://anonhg.NetBSD.org/src/rev/5fc0431f5483
branches:  trunk
changeset: 837596:5fc0431f5483
user:      maxv <maxv%NetBSD.org@localhost>
date:      Wed Dec 12 08:20:53 2018 +0000

description:
Add a NVMM(4) man page.

diffstat:

 distrib/sets/lists/man/mi |   5 ++-
 share/man/man4/Makefile   |   4 +-
 share/man/man4/nvmm.4     |  66 +++++++++++++++++++++++++++++++++++++++++++++++
 3 files changed, 72 insertions(+), 3 deletions(-)

diffs (121 lines):

diff -r 3c7bc34ffb17 -r 5fc0431f5483 distrib/sets/lists/man/mi
--- a/distrib/sets/lists/man/mi Wed Dec 12 08:12:18 2018 +0000
+++ b/distrib/sets/lists/man/mi Wed Dec 12 08:20:53 2018 +0000
@@ -1,4 +1,4 @@
-# $NetBSD: mi,v 1.1631 2018/12/12 07:04:05 maxv Exp $
+# $NetBSD: mi,v 1.1632 2018/12/12 08:20:53 maxv Exp $
 #
 # Note: don't delete entries from here - mark them as "obsolete" instead.
 #
@@ -1505,6 +1505,7 @@
 ./usr/share/man/cat4/ntwoc.0                   man-sys-catman          .cat
 ./usr/share/man/cat4/null.0                    man-sys-catman          .cat
 ./usr/share/man/cat4/nvme.0                    man-sys-catman          .cat
+./usr/share/man/cat4/nvmm.0                    man-sys-catman          .cat
 ./usr/share/man/cat4/nxt2k.0                   man-sys-catman          .cat
 ./usr/share/man/cat4/oak.0                     man-sys-catman          .cat
 ./usr/share/man/cat4/oboe.0                    man-sys-catman          .cat
@@ -4617,6 +4618,7 @@
 ./usr/share/man/html4/ntwoc.html               man-sys-htmlman         html
 ./usr/share/man/html4/null.html                        man-sys-htmlman         html
 ./usr/share/man/html4/nvme.html                        man-sys-htmlman         html
+./usr/share/man/html4/nvmm.html                        man-sys-htmlman         html
 ./usr/share/man/html4/nxt2k.html               man-sys-htmlman         html
 ./usr/share/man/html4/oak.html                 man-sys-htmlman         html
 ./usr/share/man/html4/oboe.html                        man-sys-htmlman         html
@@ -7587,6 +7589,7 @@
 ./usr/share/man/man4/ntwoc.4                   man-sys-man             .man
 ./usr/share/man/man4/null.4                    man-sys-man             .man
 ./usr/share/man/man4/nvme.4                    man-sys-man             .man
+./usr/share/man/man4/nvmm.4                    man-sys-man             .man
 ./usr/share/man/man4/nxt2k.4                   man-sys-man             .man
 ./usr/share/man/man4/oak.4                     man-sys-man             .man
 ./usr/share/man/man4/oboe.4                    man-sys-man             .man
diff -r 3c7bc34ffb17 -r 5fc0431f5483 share/man/man4/Makefile
--- a/share/man/man4/Makefile   Wed Dec 12 08:12:18 2018 +0000
+++ b/share/man/man4/Makefile   Wed Dec 12 08:20:53 2018 +0000
@@ -1,4 +1,4 @@
-#      $NetBSD: Makefile,v 1.675 2018/12/12 07:04:05 maxv Exp $
+#      $NetBSD: Makefile,v 1.676 2018/12/12 08:20:53 maxv Exp $
 #      @(#)Makefile    8.1 (Berkeley) 6/18/93
 
 MAN=   aac.4 ac97.4 acardide.4 aceride.4 acphy.4 \
@@ -44,7 +44,7 @@
        mpu.4 mtd.4 mtio.4 msm6242b.4 multicast.4 mvsata.4 \
        nadb.4 ne.4 neo.4 netintro.4 nfe.4 nfsmb.4 njata.4 njs.4 \
        nsclpcsio.4 nside.4 nsphy.4 nsphyter.4 ntwoc.4 null.4 nsmb.4 \
-       nvme.4 \
+       nvme.4 nvmm.4 \
        oak.4 oosiop.4 opl.4 options.4 optiide.4 osiop.4 otus.4 \
        pad.4 pas.4 pcdisplay.4 pcf8563rtc.4 pciide.4 pckbc.4 pckbd.4 pcn.4 \
        pcppi.4 pcscp.4 pcweasel.4 pdcide.4 pdcsata.4 piixide.4 piixpcib.4 \
diff -r 3c7bc34ffb17 -r 5fc0431f5483 share/man/man4/nvmm.4
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/share/man/man4/nvmm.4     Wed Dec 12 08:20:53 2018 +0000
@@ -0,0 +1,66 @@
+.\"    $NetBSD: nvmm.4,v 1.1 2018/12/12 08:20:53 maxv Exp $
+.\"
+.\" Copyright (c) 2018 The NetBSD Foundation, Inc.
+.\" All rights reserved.
+.\"
+.\" This code is derived from software contributed to The NetBSD Foundation
+.\" by Maxime Villard.
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in the
+.\"    documentation and/or other materials provided with the distribution.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
+.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
+.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+.\" CONTRACT, STRICT LIABILITY, OR TORT (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 December 12, 2018
+.Dt NVMM 4
+.Os
+.Sh NAME
+.Nm nvmm
+.Nd NetBSD Virtual Machine Monitor
+.Sh DESCRIPTION
+The
+.Nm
+driver provides kernel support for hardware-accelerated virtualization.
+It is made of a generic MI frontend, to which MD backends can be plugged
+to implement the core virtualization.
+.Pp
+In practice,
+.Nm
+is used by the
+.Xr libnvmm 3
+API to implement hypervisors.
+.Sh SUPPORT
+The following backends are supported:
+.Bl -hyphen -compact -offset indent
+.It
+x86-SVM, for x86 AMD CPUs
+.El
+.Sh CAVEATS
+Currently,
+.Nm
+cannot be enabled in a kernel configuration, and must rather be modloaded
+dynamically from the filesystem.
+.El
+.Sh SEE ALSO
+.Xr libnvmm 3
+.Sh AUTHORS
+The
+.Nm
+driver was written by
+.An Maxime Villard .