Document settings for XenServer

Figured out by Dinar Talypov and Maxim Khitrov.  With input from
deraadt@ and schwarze@.  OK schwarze.

1 files changed, 28 insertions, 2 deletions

diff --git a/share/man/man4/xen.4 b/share/man/man4/xen.4
index a8757e0d285..3d5201ecbf6 100644
--- a/share/man/man4/xen.4
+++ b/share/man/man4/xen.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: xen.4,v 1.1 2015/12/09 00:26:39 mikeb Exp $
+.\"	$OpenBSD: xen.4,v 1.2 2017/07/21 18:27:32 mikeb Exp $
 .\"
 .\" Copyright (c) 2015 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: December 9 2015 $
+.Dd $Mdocdate: July 21 2017 $
 .Dt XEN 4
 .Os
 .Sh NAME
@@ -28,6 +28,32 @@ driver performs HVM domU guest initialization, provides abstraction for
 virtual Xen interrupts, access to the XenStore configuration storage as
 well as a device probing facility for paravirtualized devices such as
 disk and network interfaces.
+.Pp
+When running under XenServer, to let the host know that the guest has
+finished initializing and to allow graceful shutdown, set the following
+XenStore properties with
+.Xr hostctl 8
+in
+.Xr rc.local 8 :
+.Bd -literal -offset indent
+ostype=$(sysctl -n kern.ostype)
+osrelease=$(sysctl -n kern.osrelease)
+
+# XenServer Tools version
+hostctl attr/PVAddons/MajorVersion 6
+hostctl attr/PVAddons/MinorVersion 2
+hostctl attr/PVAddons/MicroVersion 0
+hostctl attr/PVAddons/BuildVersion 76888
+hostctl attr/PVAddons/Installed 1
+
+# OS version
+hostctl data/os_name "$ostype $osrelease"
+hostctl data/os_uname $osrelease
+hostctl data/os_distro $ostype
+
+# Update XenStore
+hostctl data/updated 1
+.Ed
 .Sh SEE ALSO
 .Xr autoconf 4 ,
 .Xr intro 4 ,