xref: /dflybsd-src/share/man/man4/acpi_pvpanic.4 (revision 2af72e0ae32e279a57a5bd47226cf522fc024203)
1*2af72e0aSImre Vadász.\"
2*2af72e0aSImre Vadász.\" Copyright (c) 2015 The DragonFly Project.  All rights reserved.
3*2af72e0aSImre Vadász.\"
4*2af72e0aSImre Vadász.\" Redistribution and use in source and binary forms, with or without
5*2af72e0aSImre Vadász.\" modification, are permitted provided that the following conditions
6*2af72e0aSImre Vadász.\" are met:
7*2af72e0aSImre Vadász.\"
8*2af72e0aSImre Vadász.\" 1. Redistributions of source code must retain the above copyright
9*2af72e0aSImre Vadász.\"    notice, this list of conditions and the following disclaimer.
10*2af72e0aSImre Vadász.\" 2. Redistributions in binary form must reproduce the above copyright
11*2af72e0aSImre Vadász.\"    notice, this list of conditions and the following disclaimer in
12*2af72e0aSImre Vadász.\"    the documentation and/or other materials provided with the
13*2af72e0aSImre Vadász.\"    distribution.
14*2af72e0aSImre Vadász.\" 3. Neither the name of The DragonFly Project nor the names of its
15*2af72e0aSImre Vadász.\"    contributors may be used to endorse or promote products derived
16*2af72e0aSImre Vadász.\"    from this software without specific, prior written permission.
17*2af72e0aSImre Vadász.\"
18*2af72e0aSImre Vadász.\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
19*2af72e0aSImre Vadász.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
20*2af72e0aSImre Vadász.\" LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
21*2af72e0aSImre Vadász.\" FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE
22*2af72e0aSImre Vadász.\" COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
23*2af72e0aSImre Vadász.\" INCIDENTAL, SPECIAL, EXEMPLARY OR CONSEQUENTIAL DAMAGES (INCLUDING,
24*2af72e0aSImre Vadász.\" BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
25*2af72e0aSImre Vadász.\" LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
26*2af72e0aSImre Vadász.\" AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
27*2af72e0aSImre Vadász.\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
28*2af72e0aSImre Vadász.\" OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
29*2af72e0aSImre Vadász.\" SUCH DAMAGE.
30*2af72e0aSImre Vadász.\"
31*2af72e0aSImre Vadász.Dd November 23, 2015
32*2af72e0aSImre Vadász.Dt ACPI_PVPANIC 4
33*2af72e0aSImre Vadász.Os
34*2af72e0aSImre Vadász.Sh NAME
35*2af72e0aSImre Vadász.Nm acpi_pvpanic
36*2af72e0aSImre Vadász.Nd Qemu pvpanic Device
37*2af72e0aSImre Vadász.Sh SYNOPSIS
38*2af72e0aSImre VadászTo compile this driver into the kernel,
39*2af72e0aSImre Vadászplace the following line in your
40*2af72e0aSImre Vadászkernel configuration file:
41*2af72e0aSImre Vadász.Bd -ragged -offset indent
42*2af72e0aSImre Vadász.Cd "device acpi_pvpanic"
43*2af72e0aSImre Vadász.Ed
44*2af72e0aSImre Vadász.Pp
45*2af72e0aSImre VadászAlternatively, to load the driver as a
46*2af72e0aSImre Vadászmodule at boot time, place the following line in
47*2af72e0aSImre Vadász.Xr loader.conf 5 :
48*2af72e0aSImre Vadász.Bd -literal -offset indent
49*2af72e0aSImre Vadászacpi_pvpanic_load="YES"
50*2af72e0aSImre Vadász.Ed
51*2af72e0aSImre Vadász.Sh DESCRIPTION
52*2af72e0aSImre VadászThe
53*2af72e0aSImre Vadász.Nm
54*2af72e0aSImre Vadászdriver provides support for the pvpanic device that can be provided
55*2af72e0aSImre Vadászto virtual-machines by the
56*2af72e0aSImre Vadász.Xr qemu 1
57*2af72e0aSImre Vadászvirtual machine monitor.
58*2af72e0aSImre VadászThe pvpanic device can be enabled in
59*2af72e0aSImre Vadász.Xr qemu 1
60*2af72e0aSImre Vadászby adding the
61*2af72e0aSImre Vadász.Fl device Ar pvpanic
62*2af72e0aSImre Vadászcommand line option.
63*2af72e0aSImre VadászWhen the
64*2af72e0aSImre Vadász.Nm
65*2af72e0aSImre Vadászdriver is used, the virtual machine execution will be stopped when the
66*2af72e0aSImre Vadászkernel signals a panic.
67*2af72e0aSImre VadászFor accessing
68*2af72e0aSImre Vadász.Xr ddb 4
69*2af72e0aSImre Vadászthe virtual machine then needs to be resumed manually (e.g. using the
70*2af72e0aSImre Vadász.Dq cont
71*2af72e0aSImre Vadászcommand in the qemu-monitor console).
72*2af72e0aSImre Vadász.Sh SEE ALSO
73*2af72e0aSImre Vadász.Xr acpi 4 ,
74*2af72e0aSImre Vadász.Xr ddb 4
75*2af72e0aSImre Vadász.Sh HISTORY
76*2af72e0aSImre VadászThe
77*2af72e0aSImre Vadász.Nm
78*2af72e0aSImre Vadászdriver first appeared in
79*2af72e0aSImre Vadász.Dx 4.5 .
80*2af72e0aSImre Vadász.Sh AUTHORS
81*2af72e0aSImre Vadász.An -nosplit
82*2af72e0aSImre VadászThe
83*2af72e0aSImre Vadász.Nm
84*2af72e0aSImre Vadászdriver was written by
85*2af72e0aSImre Vadász.An Imre Vadasz Aq Mt imre@vdsz.com .
86