Document the KVP interface

1 files changed, 26 insertions, 3 deletions

diff --git a/share/man/man4/hyperv.4 b/share/man/man4/hyperv.4
index 3052fb737f9..d961fb8e2d6 100644
--- a/share/man/man4/hyperv.4
+++ b/share/man/man4/hyperv.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: hyperv.4,v 1.3 2016/09/15 18:27:27 mikeb Exp $
+.\"	$OpenBSD: hyperv.4,v 1.4 2016/11/03 13:26:51 mikeb Exp $
 .\"
 .\" Copyright (c) 2016 Mike Belopuhov
 .\"
@@ -14,7 +14,7 @@
 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 .\"
-.Dd $Mdocdate: September 15 2016 $
+.Dd $Mdocdate: November 3 2016 $
 .Dt HYPERV 4
 .Os
 .Sh NAME
@@ -28,10 +28,33 @@ driver performs Synthetic Interrupt Controller initialization,
 sets up hypercalls,
 and provides access to VMBus services required by paravirtualized
 devices such as disk and network interfaces.
+.Pp
+An access is also provided to the Key-Value Pair exchange interface
+via
+.Xr pvbus 4 .
+All keys are associated to one of several key pools:
+.Em Auto ,
+.Em Guest ,
+.Em External
+or
+.Em Guest/Parameters .
+It's possible to modify values of keys in the
+.Em Auto
+pool as well as
+set new keys in the
+.Em Guest
+pool with
+.Xr hostctl 8 .
+The Host provides its read-only keys in
+.Em External
+and
+.Em Guest/Parameters
+pools.
 .Sh SEE ALSO
 .Xr autoconf 4 ,
 .Xr intro 4 ,
-.Xr pvbus 4
+.Xr pvbus 4 ,
+.Xr hostctl 8
 .Sh HISTORY
 The
 .Nm