[Qemu-devel] [PATCH 18/18] IPMI: Add documentation.

[minyard]

From: Corey Minyard <address@hidden>

Add some basic documentation for the IPMI device.

Signed-off-by: Corey Minyard <address@hidden>
---
 qemu-options.hx |   35 +++++++++++++++++++++++++++++++++++
 1 files changed, 35 insertions(+), 0 deletions(-)

diff --git a/qemu-options.hx b/qemu-options.hx
index c5f592c..598b3d3 100644
--- a/qemu-options.hx
+++ b/qemu-options.hx
@@ -558,6 +558,41 @@ Add device @var{driver}.  @address@hidden sets driver
 properties.  Valid properties depend on the driver.  To get help on
 possible drivers and properties, use @code{-device ?} and
 @code{-device @var{driver},?}.
+
+Some drivers are:
address@hidden -device 
isa-ipmi[,interface=kcs|bt][,address@hidden,address@hidden,address@hidden,chardev=name]
+
+Add an IPMI device.  This also adds a corresponding SMBIOS entry to the
+SMBIOS tables for x86.  The following options are handled:
address@hidden @option
address@hidden interface=kcs|bt
+Define the interface type to use.  Currently the IPMI-defined KCS and
+BT interfaces are handled.  The default is KCS.
address@hidden address@hidden
+Define the I/O address of the interface.  The default is 0xca0 for KCS
+and 0xe4 for BT.
address@hidden address@hidden
+Define the interrupt to use.  The default is 5.  To disable interrupts,
+set this to 0.
address@hidden address@hidden
+The IPMI slave address to use for the BMC.  The default is 0x20.
address@hidden chardev=name
+If a chardev is not specified, the IPMI driver uses a built-in baseboard
+management controller (BMC) simulator.  It provides a basic BMC with a
+watchdog timer and associated sensor.
+
+If a chardev is specified, A connection is made to an external BMC
+simulator.  If you do this, it is strongly recommended that you use
+the "reconnect=" chardev option to reconnect to the simulator if the
+connection is lost.  Note that if this is not used carefully, it can
+be a security issue, as the interface has the ability to send resets,
+NMIs, and power off the VM.  It's best if QEMU makes a connection to
+an external simulator running on a secure port on localhost, so
+neither the simulator nor QEMU is exposed to any outside network.
+
+See the "lanserv/README.vm" file in the OpenIPMI library for more
+details on the external interface.
address@hidden table
 ETEXI
 
 DEFHEADING()
-- 
1.7.4.1