From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from eggs.gnu.org ([2001:4830:134:3::10]:46220) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Vgd02-0007GV-RN for qemu-devel@nongnu.org; Wed, 13 Nov 2013 11:09:04 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Vgczy-0005mi-O2 for qemu-devel@nongnu.org; Wed, 13 Nov 2013 11:09:02 -0500 Received: from mail-pd0-x22b.google.com ([2607:f8b0:400e:c02::22b]:50620) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Vgczy-0005mG-5M for qemu-devel@nongnu.org; Wed, 13 Nov 2013 11:08:58 -0500 Received: by mail-pd0-f171.google.com with SMTP id z10so596284pdj.30 for ; Wed, 13 Nov 2013 08:08:57 -0800 (PST) MIME-Version: 1.0 In-Reply-To: <1384273995-16486-13-git-send-email-cminyard@mvista.com> References: <1384273995-16486-1-git-send-email-cminyard@mvista.com> <1384273995-16486-13-git-send-email-cminyard@mvista.com> Date: Wed, 13 Nov 2013 10:08:57 -0600 Message-ID: From: Bret Ketchum Content-Type: multipart/alternative; boundary=047d7b41be3eb09d2904eb112ed4 Subject: Re: [Qemu-devel] [PATCH 12/16] ipmi: Add documentation List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , To: Corey Minyard Cc: Corey Minyard , qemu-devel@nongnu.org --047d7b41be3eb09d2904eb112ed4 Content-Type: text/plain; charset=ISO-8859-1 The actual default I/O address for KCS is 0xca2. On Tue, Nov 12, 2013 at 10:33 AM, Corey Minyard wrote: > Add some basic documentation for the IPMI device. > > Signed-off-by: Corey Minyard > --- > qemu-options.hx | 35 +++++++++++++++++++++++++++++++++++ > 1 file changed, 35 insertions(+) > > diff --git a/qemu-options.hx b/qemu-options.hx > index 5bcfaa0..500d7c8 100644 > --- a/qemu-options.hx > +++ b/qemu-options.hx > @@ -327,6 +327,41 @@ Add device @var{driver}. @var{prop}=@var{value} sets > driver > properties. Valid properties depend on the driver. To get help on > possible drivers and properties, use @code{-device help} and > @code{-device @var{driver},help}. > + > +Some drivers are: > +@item -device > isa-ipmi[,interface=kcs|bt][,iobase=@var{val}][,irq=@var{val}][,slave_addr=@var{val}][,chardev=name] > + > +Add an IPMI device. This also adds a corresponding SMBIOS entry to the > +SMBIOS tables for x86. The following options are handled: > +@table @option > +@item interface=kcs|bt > +Define the interface type to use. Currently the IPMI-defined KCS and > +BT interfaces are handled. The default is KCS. > +@item iobase=@var{val} > +Define the I/O address of the interface. The default is 0xca0 for KCS > +and 0xe4 for BT. > +@item irq=@var{val} > +Define the interrupt to use. The default is 5. To disable interrupts, > +set this to 0. > +@item slave_addr=@var{val} > +The IPMI slave address to use for the BMC. The default is 0x20. > +@item 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. > +@end table > ETEXI > > DEF("name", HAS_ARG, QEMU_OPTION_name, > -- > 1.8.3.1 > > --047d7b41be3eb09d2904eb112ed4 Content-Type: text/html; charset=ISO-8859-1 Content-Transfer-Encoding: quoted-printable

=A0=A0=A0=A0 The actual default I/O address= for KCS is 0xca2.


On Tue, Nov 12, 2013 at 10:33 AM, Corey Minyard <minyard@a= cm.org> wrote:
Add some basic documentation for the IPMI de= vice.

Signed-off-by: Corey Minyard <cmi= nyard@mvista.com>
---
=A0qemu-options.hx | 35 +++++++++++++++++++++++++++++++++++
=A01 file changed, 35 insertions(+)

diff --git a/qemu-options.hx b/qemu-options.hx
index 5bcfaa0..500d7c8 100644
--- a/qemu-options.hx
+++ b/qemu-options.hx
@@ -327,6 +327,41 @@ Add device @var{driver}. =A0@var{prop}=3D@var{value} s= ets driver
=A0properties. =A0Valid properties depend on the driver. =A0To get help on<= br> =A0possible drivers and properties, use @code{-device help} and
=A0@code{-device @var{driver},help}.
+
+Some drivers are:
+@item -device isa-ipmi[,interface=3Dkcs|bt][,iobase=3D@var{val}][,irq=3D@v= ar{val}][,slave_addr=3D@var{val}][,chardev=3Dname]
+
+Add an IPMI device. =A0This also adds a corresponding SMBIOS entry to the<= br> +SMBIOS tables for x86. =A0The following options are handled:
+@table @option
+@item interface=3Dkcs|bt
+Define the interface type to use. =A0Currently the IPMI-defined KCS and +BT interfaces are handled. =A0The default is KCS.
+@item iobase=3D@var{val}
+Define the I/O address of the interface. =A0The default is 0xca0 for KCS +and 0xe4 for BT.
+@item irq=3D@var{val}
+Define the interrupt to use. =A0The default is 5. =A0To disable interrupts= ,
+set this to 0.
+@item slave_addr=3D@var{val}
+The IPMI slave address to use for the BMC. =A0The default is 0x20.
+@item chardev=3Dname
+If a chardev is not specified, the IPMI driver uses a built-in baseboard +management controller (BMC) simulator. =A0It 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. =A0If you do this, it is strongly recommended that you use
+the "reconnect=3D" chardev option to reconnect to the simulator = if the
+connection is lost. =A0Note 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. =A0It'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 mor= e
+details on the external interface.
+@end table
=A0ETEXI

=A0DEF("name", HAS_ARG, QEMU_OPTION_name,
--
1.8.3.1


--047d7b41be3eb09d2904eb112ed4--