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