1.\" $OpenBSD: xen.4,v 1.2 2017/07/21 18:27:32 mikeb Exp $ 2.\" 3.\" Copyright (c) 2015 Mike Belopuhov 4.\" 5.\" Permission to use, copy, modify, and distribute this software for any 6.\" purpose with or without fee is hereby granted, provided that the above 7.\" copyright notice and this permission notice appear in all copies. 8.\" 9.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES 10.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF 11.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR 12.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES 13.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN 14.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF 15.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. 16.\" 17.Dd $Mdocdate: July 21 2017 $ 18.Dt XEN 4 19.Os 20.Sh NAME 21.Nm xen 22.Nd Xen domU nexus device 23.Sh SYNOPSIS 24.Cd "xen0 at pvbus?" 25.Sh DESCRIPTION 26.Nm 27driver performs HVM domU guest initialization, provides abstraction for 28virtual Xen interrupts, access to the XenStore configuration storage as 29well as a device probing facility for paravirtualized devices such as 30disk and network interfaces. 31.Pp 32When running under XenServer, to let the host know that the guest has 33finished initializing and to allow graceful shutdown, set the following 34XenStore properties with 35.Xr hostctl 8 36in 37.Xr rc.local 8 : 38.Bd -literal -offset indent 39ostype=$(sysctl -n kern.ostype) 40osrelease=$(sysctl -n kern.osrelease) 41 42# XenServer Tools version 43hostctl attr/PVAddons/MajorVersion 6 44hostctl attr/PVAddons/MinorVersion 2 45hostctl attr/PVAddons/MicroVersion 0 46hostctl attr/PVAddons/BuildVersion 76888 47hostctl attr/PVAddons/Installed 1 48 49# OS version 50hostctl data/os_name "$ostype $osrelease" 51hostctl data/os_uname $osrelease 52hostctl data/os_distro $ostype 53 54# Update XenStore 55hostctl data/updated 1 56.Ed 57.Sh SEE ALSO 58.Xr autoconf 4 , 59.Xr intro 4 , 60.Xr pvbus 4 61.Sh HISTORY 62The 63.Nm 64driver first appeared in 65.Ox 5.9 . 66.Sh AUTHORS 67The 68.Nm 69driver was written by 70.An Mike Belopuhov Aq Mt mikeb@openbsd.org 71from scratch, inspired by the 72.Fx 73implementation. 74