7047461 "temporarily" restore sfw version of ipmitool to userland build-167
authorNorm Jacobs <Norm.Jacobs@Oracle.COM>
Wed, 25 May 2011 22:38:48 -0700
changeset 268 6518166b581c
parent 267 f7eb7d0199e2
child 269 c89549bf8187
7047461 "temporarily" restore sfw version of ipmitool to userland
components/ipmitool/Makefile
components/ipmitool/README
components/ipmitool/ipmievd.8
components/ipmitool/ipmievd.xml
components/ipmitool/ipmitool.1m
components/ipmitool/ipmitool.license
components/ipmitool/ipmitool.p5m
components/ipmitool/patches/ipmievd.local4.patch
components/ipmitool/patches/ipmitool.scanning.patch
components/ipmitool/svc-ipmievd
components/ipmitool/test_ipmievd
components/ipmitool/test_ipmitool
components/meta-packages/history/SUNWipmi.p5m
components/meta-packages/history/system%2Fipmi%2Fipmitool.p5m
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/components/ipmitool/Makefile	Wed May 25 22:38:48 2011 -0700
@@ -0,0 +1,62 @@
+#
+# CDDL HEADER START
+#
+# The contents of this file are subject to the terms of the
+# Common Development and Distribution License (the "License").
+# You may not use this file except in compliance with the License.
+#
+# You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
+# or http://www.opensolaris.org/os/licensing.
+# See the License for the specific language governing permissions
+# and limitations under the License.
+#
+# When distributing Covered Code, include this CDDL HEADER in each
+# file and include the License file at usr/src/OPENSOLARIS.LICENSE.
+# If applicable, add the following below this CDDL HEADER, with the
+# fields enclosed by brackets "[]" replaced with your own identifying
+# information: Portions Copyright [yyyy] [name of copyright owner]
+#
+# CDDL HEADER END
+#
+
+#
+# Copyright (c) 2011, Oracle and/or its affiliates. All rights reserved.
+#
+
+include ../../make-rules/shared-macros.mk
+
+COMPONENT_NAME=		ipmitool
+COMPONENT_VERSION=	1.8.10
+COMPONENT_SRC=		$(COMPONENT_NAME)-$(COMPONENT_VERSION)
+COMPONENT_PROJECT_URL=	http://ipmitool.sourceforge.net
+COMPONENT_ARCHIVE=	$(COMPONENT_SRC).tar.gz
+COMPONENT_ARCHIVE_HASH=	sha1:61605c1f11b74b0f6ff0ba4d019cd8d2e1bdc2c4
+COMPONENT_ARCHIVE_URL=	http://cdnetworks-us-2.dl.sourceforge.net/sourceforge/ipmitool/$(COMPONENT_ARCHIVE)
+
+include ../../make-rules/prep.mk
+include ../../make-rules/configure.mk
+include ../../make-rules/ips.mk
+
+# The version of libtool in the source archive causes the build to fail to
+# link in src/plugins/lan.  The bundled vesion works fine.
+COMPONENT_PREP_ACTION=(cd $(@D) ; libtoolize -f)
+
+COMPILER=gcc
+
+CONFIGURE_OPTIONS  +=		--prefix=/usr/sfw
+CONFIGURE_OPTIONS  +=		--enable-intf-free=no
+CONFIGURE_OPTIONS  +=		CFLAGS="$(CFLAGS)"
+
+
+# common targets
+build:		$(BUILD_32)
+
+install:	$(INSTALL_32)
+
+# run test_ipmitool && test_ipmievd as root vs self
+# on test vs build machine in tmp vs workspace dir
+test:		$(NO_TESTS)
+
+BUILD_PKG_DEPENDENCIES =	$(BUILD_TOOLS)
+
+include ../../make-rules/depend.mk
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/components/ipmitool/README	Wed May 25 22:38:48 2011 -0700
@@ -0,0 +1,23 @@
+
+IMPORTANT:   LSARC 2007/542 Contract Notification Requirements
+
+When any change, modification, version update, bug fix, or other edit occurs
+to the ipmi package(s) or related modules in Solaris, it is mandatory that
+notification describing the change(s) be provided to [email protected] 
+
+---
+
+Patches:
+
+1. ipmitool.scanning.patch - fix ipmitool SEGV core dump seen on some
+   Sun Fire X4500s. This fix is expected to be delivered back to Sourceforge
+   before 1.8.11 or 1.8.12 by GNHSoft (or by Sun NSG RE). Sun CR 6739869.
+
+   		gpatch -p0 < ipmitool.scanning.patch
+
+2. ipmievd.local4.patch - fix to allow ipmievd to automatically start
+   logging events to syslog "out of the box" instead of having to edit
+   /etc/syslog.conf with the following line to allow logging of events:
+
+	       	local4.info                      /var/adm/messages
+
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/components/ipmitool/ipmievd.8	Wed May 25 22:38:48 2011 -0700
@@ -0,0 +1,209 @@
+'\" t
+.\"
+.\" CDDL HEADER START
+.\"
+.\" The contents of this file are subject to the terms of the
+.\" Common Development and Distribution License (the "License").
+.\" You may not use this file except in compliance with the License.
+.\"
+.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
+.\" or http://www.opensolaris.org/os/licensing.
+.\" See the License for the specific language governing permissions
+.\" and limitations under the License.
+.\"
+.\" When distributing Covered Code, include this CDDL HEADER in each
+.\" file and include the License file at usr/src/OPENSOLARIS.LICENSE.
+.\" If applicable, add the following below this CDDL HEADER, with the
+.\" fields enclosed by brackets "[]" replaced with your own identifying
+.\" information: Portions Copyright [yyyy] [name of copyright owner]
+.\"
+.\" CDDL HEADER END
+.\"
+.\"
+.\" Copyright (c) 2007, 2011, Oracle and/or its affiliates. All rights reserved.
+.\"
+.\" ipmievd man page
+.\"
+.TH "ipmievd" "8" "29 November 2006"
+.SH "NAME"
+ipmievd \- IPMI event daemon for sending events to syslog
+.SH "SYNOPSIS"
+.B ipmievd
+[\-chvV] \-I lan \-H hostname [ \-p <port>] [\-U <username>] [ \-f <password_file>] [\-S <sdrcache>] sel [<option>]
+
+.B ipmievd
+[\-chvV] \-I lanplus \-H hostname [\-p <port>] [\-U <username>] [\-f <password_file>] [\-S <sdrcache>] sel [<option>]
+
+.B ipmievd
+[\-chvV] \-I bmc [\-S <sdrcache>] sel [<option>]
+
+.SH "DESCRIPTION"
+\fBipmievd\fP is a daemon that listens for events from the
+Baseboard Management Controller (BMC) which are being sent to the 
+System Event Log (SEL), and logs those messages to
+syslog. The daemon actively polls the contents of the SEL for 
+new events.
+When an event is received, it is logged to
+syslog using the
+\fILOG_LOCAL4\fP facility.  On Solaris, it has been made to use
+\fILOG_DAEMON\fP instead, so that no changes to /etc/syslog.conf are necessary.
+.LP
+\fBipmievd\fP is based on the \fBipmitool\fR utility and it shares the same 
+Intelligent Platform Management Interface (IPMI)
+support and session setup options.  The
+\fBipmitool\fR man page provides more information on supported IPMI
+interfaces.
+.SH "OPTIONS"
+.TP 
+.B \-c
+Present output in comma separated variable (CSV) format.
+.TP 
+.BI \-f " password_file"
+Specify a file containing the remote server password. If this
+option is absent, or if password_file is empty, the password
+will default to NULL.
+.IP
+If the 
+.B \-f 
+option is not present, ipmitool will prompt the
+user for a password. If no password is entered at the prompt,
+the remote server password will default to NULL.
+.IP
+For IPMI v1.5, the maximum password length is 16 characters.
+Passwords longer than 16 characters will be truncated.
+.IP
+For IPMI v2.0, the maximum password length is 20 characters.
+Passwords longer than 20 characters will be truncated.
+The longer password length is supported by the 
+.B lanplus 
+interface.
+.TP 
+.B \-h
+Get basic usage help from the command line.
+.TP 
+.BI \-H " hostname"
+Remote server address, which can be an IP address or hostname.  This 
+option is required for the LAN interface connection.
+.TP 
+.BI \-I " interface"
+Selects IPMI interface to use. Possible interfaces are:
+
+.TS
+tab(+);
+l l .
+bmc+IPMI v2.0 BMC interface [default]
+lan+IPMI v1.5 LAN Interface
+lanplus+IPMI v2.0 RMCP+ LAN Interface
+.TE
+.TP 
+.BI \-p " port"
+Remote server UDP port to connect to (default is 623).
+.TP 
+.BI \-S " sdrcache"
+Use local file for remote Sensor Data Repository (SDR) cache. 
+Using a local SDR cache can drastically increase performance
+for commands that require knowledge of the entire SDR to perform
+their function.
+.TP 
+\.BI \-U " username"
+Remote server username; default is NULL user.
+.TP 
+.B \-v
+Increase verbose output level.  This option can be specified
+multiple times to increase the level of debug output.  If given
+three times, you will get hexdumps of all incoming and
+outgoing packets.
+.TP 
+.B \-V
+Display version information.
+.SH "COMMANDS"
+.TP 
+\fIhelp\fP
+This can be used to get command\-line help.  It can also be
+placed at the end of commands to get option usage help.
+
+> ipmievd bmc help
+.br 
+Commands:
+    sel      Poll SEL for notification of events
+.TP 
+\fIsel\fP
+This command starts 
+.B ipmievd 
+with the SEL Polling event watching
+mechanism.  This will poll the SEL periodically to determine if
+new events have been logged.  This command should work with all
+BMCs and is capable of using the LAN interface as well to monitor
+a remote system and log its events to a local syslog.
+.RS
+.TP 
+\fBdaemon\fP
+Launch process as a daemon and reparent to init process.
+All messages will be sent to syslog.  This is the default action.
+.TP 
+\fBnodaemon\fP
+Do \fInot\fP become a daemon; instead, log all messages to stderr.
+.TP
+\fBpidfile\fR=\fIfilename\fR
+Save process ID to this file when in daemon mode.  Defaults to
+/var/run/ipmievd.pid.
+.TP 
+\fBtimeout\fR=\fIseconds\fR
+Time between checks for SEL polling method.  Default is 10 seconds.
+.SH "EXIT STATUS"
+Upon successful completion, 
+.B ipmievd 
+returns 0.  On failure, 1 is returned.
+.SH "EXAMPLE"
+Local non\-daemon process checking remote SEL every 30
+seconds:
+
+> ipmievd \-I lan \-H 1.2.3.4 \-f passfile sel nodaemon timeout=30
+.br 
+Reading Sensors...
+.br 
+Waiting for Events...
+.SH "FILES"
+\fB/platform/i86pc/kernel/drv/bmc\fR
+.in +30n
+.sp
+32-bit \fBELF\fR kernel module for the bmc driver.
+.sp
+.in -30n
+\fB/platform/i86pc/kernel/drv/amd64/bmc\fR
+.in +30n
+.sp
+64-bit \fBELF\fR kernel module for the bmc driver.
+.in -30n
+\fB/dev/bmc\fR
+.in +30n
+.sp
+Character device node used to communicate with the bmc driver.
+.in -30n
+.SH "SEE ALSO"
+attributes(5),
+ipmitool(1M), 
+smf(5), 
+svcadm(1M), 
+svccfg(1M), 
+svcs(1)
+.TP 
+IPMItool Homepage
+http://ipmitool.sourceforge.net
+.TP 
+Intelligent Platform Management Interface Specification
+http://www.intel.com/design/servers/ipmi/spec.htm
+.TP 
+OpenIPMI Homepage
+http://openipmi.sourceforge.net
+.SH "NOTES"
+The
+.B ipmievd 
+daemon is managed by the service management
+facility, smf(5), under the service identifier:
+svc:/network/ipmievd:default.
+.LP
+Administrative actions on this service, such as enabling
+or disabling, can be performed using svcadm(1M). Use 
+svccfg(1M) to make configuration changes and
+svcs(1) to view configuration information and service status.
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/components/ipmitool/ipmievd.xml	Wed May 25 22:38:48 2011 -0700
@@ -0,0 +1,106 @@
+<?xml version="1.0"?>
+<!--
+CDDL HEADER START
+
+The contents of this file are subject to the terms of the
+Common Development and Distribution License (the "License").
+You may not use this file except in compliance with the License.
+
+You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
+or http://www.opensolaris.org/os/licensing.
+See the License for the specific language governing permissions
+and limitations under the License.
+
+When distributing Covered Code, include this CDDL HEADER in each
+file and include the License file at usr/src/OPENSOLARIS.LICENSE.
+If applicable, add the following below this CDDL HEADER, with the
+fields enclosed by brackets "[]" replaced with your own identifying
+information: Portions Copyright [yyyy] [name of copyright owner]
+
+CDDL HEADER END
+-->
+
+<!DOCTYPE service_bundle SYSTEM "/usr/share/lib/xml/dtd/service_bundle.dtd.1">
+<!--
+    Copyright (c) 2007, 2011, Oracle and/or its affiliates. All rights reserved.
+-->
+
+<service_bundle type='manifest' name='SUNWipmi:ipmievd'>
+
+<service name='network/ipmievd' type='service' version='1'>
+
+	<!--
+	  Configure a default instance for the service since it doesn't
+	  require additional configuration intervention before it starts.
+	-->
+	<create_default_instance enabled='false' />
+
+	<!--
+	  Wait for all usr filesystem to be mounted. ipmievd is
+	  located in /usr/lib.
+	-->
+	<dependency
+	    name='filesystem-usr'
+	    grouping='require_all'
+	    restart_on='none'
+	    type='service'>
+	    <service_fmri
+		value='svc:/system/filesystem/usr:default'/>
+	</dependency>
+
+	<!--
+	  Wait for syslog to be started in order to write system
+	  messages from the kernel.
+	-->
+	<dependency
+	    name='syslog'
+	    grouping='require_all'
+	    restart_on='none'
+	    type='service'>
+	    <service_fmri
+		value='svc:/system/system-log:default'/>
+	</dependency>
+
+	<!--
+	  The ipmievd start/stop methods.
+	-->
+
+	<exec_method
+		type='method'
+		name='start'
+		exec='/lib/svc/method/svc-ipmievd %m'
+		timeout_seconds='60'/>
+
+	<exec_method
+		type='method'
+		name='stop'
+		exec=':kill'
+		timeout_seconds='60' />
+
+	<property_group name='startd' type='framework'>
+		<!--
+		  Sub-process core dumps and external kill signals are not
+		  considered errors, so the service should be restarted.
+	        -->
+		<propval name='ignore_error' type='astring'
+			 value='core,signal' />
+	</property_group>
+
+	<stability value='Unstable' />
+
+	<template>
+		<common_name>
+			<loctext xml:lang='C'>
+				IPMI event daemon
+			</loctext>
+		</common_name>
+		<documentation>
+			<manpage title='ipmievd' section='8'
+				manpath='/usr/share/man' />
+			<doc_link name='sourceforge.net'
+				uri='http://sourceforge.net/projects/ipmitool' />
+		</documentation>
+	</template>
+</service>
+
+</service_bundle>
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/components/ipmitool/ipmitool.1m	Wed May 25 22:38:48 2011 -0700
@@ -0,0 +1,2145 @@
+'\" t
+.\"
+.\" CDDL HEADER START
+.\"
+.\" The contents of this file are subject to the terms of the
+.\" Common Development and Distribution License (the "License").
+.\" You may not use this file except in compliance with the License.
+.\"
+.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
+.\" or http://www.opensolaris.org/os/licensing.
+.\" See the License for the specific language governing permissions
+.\" and limitations under the License.
+.\"
+.\" When distributing Covered Code, include this CDDL HEADER in each
+.\" file and include the License file at usr/src/OPENSOLARIS.LICENSE.
+.\" If applicable, add the following below this CDDL HEADER, with the
+.\" fields enclosed by brackets "[]" replaced with your own identifying
+.\" information: Portions Copyright [yyyy] [name of copyright owner]
+.\"
+.\" CDDL HEADER END
+.\"
+.\" Copyright (c) 2004, 2011, Oracle and/or its affiliates. All rights reserved.
+.\"
+.TH ipmitool 1m "10 December 2008"
+.SH NAME
+ipmitool \- utility for controlling IPMI\-enabled devices
+.SH SYNOPSIS 
+.B ipmitool 
+[\-chvV] \-I lan \-H hostname  [\-p <port>] [\-U <username>] [\-f <password_file>] [\-S <sdrcache>] <command>
+
+.B ipmitool 
+[\-chvV] \-I lanplus \-H hostname  [\-p <port>] [\-U <username>] [\-f <password_file>] [\-S <sdrcache>] <command>
+
+.B ipmitool 
+[\-chvV] \-I bmc [\-S <sdrcache>] <command>
+
+.SH DESCRIPTION
+This program lets you manage Intelligent Platform Management Interface 
+(IPMI) functions of either the local system, via a kernel device driver,
+or a remote system, using IPMI v1.5 and IPMI v2.0. These functions include printing 
+FRU information, LAN configuration, sensor readings, and remote chassis 
+power control.
+     
+IPMI management by a remote station is disabled on platforms as they 
+are shipped. It can be enabled only by the root user on the local system.
+
+.SH SECURITY WARNING
+There are several security issues to be considered before enabling the
+IPMI LAN interface. A remote station has the ability to control a system's power 
+state as well as being able to gather certain platform information. To reduce 
+vulnerability it is strongly advised that the IPMI LAN interface only be 
+enabled in 'trusted' environments where system security is not an issue or 
+where there is a dedicated secure 'management network'. 
+
+Further it is strongly advised that you should not enable IPMI for
+remote access without setting a password, and that that password should
+not be the same as any other password on that system.  
+        
+When an IPMI password is changed on a remote machine the new password is 
+sent across the network as clear text. This could be observed and then 
+used to attack the remote system. It is thus recommended that IPMI
+password management only be done using a tool, such as 'ipmitool', running
+on the local station.
+        	  
+.SH OPTIONS
+.TP
+\-c
+Present output in CSV (comma separated variable) format.
+.TP    
+\-f <password_file>
+Specifies a file containing the remote server password. If this
+option is absent, or if password_file is empty, the password
+will default to NULL.
+
+If the \-f option is not present, ipmitool will prompt the
+user for a password. If no password is entered at the prompt,
+the remote server password will default to NULL.
+
+For IPMI v1.5, the maximum password length is 16 characters.
+Passwords longer than 16 characters will be truncated.
+
+For IPMI v2.0, the maximum password length is 20 characters;
+longer passwords are truncated.
+The longer password length is supported by the lanplus interface.
+.TP
+\-h
+Get basic usage help from the command line.
+.TP
+\-H <hostname>
+Remote server address, can be IP address  or  hostname.
+This  option  is required for the LAN interface connection.
+.TP
+\-I <interface>
+Selects IPMI interface to use.  Possible interfaces are
+lan, lanplus or bmc.
+.TP          
+\-p <port>
+Selects remote port (default is 623).
+.TP
+\-S <sdrcache>
+Uses Sensor Data Repository information from the file
+<sdrcache> to dramatically speed up the `sdr' and
+`sel elist' commands.  This file is typically created
+with the `sdr dump <sdrcache>' command.
+.TP
+\-U <username>
+Remote username, default is NULL user. 
+.TP
+\-v
+Increase verbose output  level.   This  option  may  be
+specified multiple times to increase the level of debug
+output.  If given three times you will get hexdumps  of
+all incoming and outgoing packets.
+.TP
+\-V
+Display version information.
+
+
+.SH COMMANDS
+.TP
+help This can be used to get command\-line help  on  ipmitool
+commands.  It may also be placed at the end of commands
+to get option usage help.
+
+ipmitool \-I bmc help
+.br
+Commands:
+        raw          Send a RAW IPMI request and print
+                     response
+        i2c          Send an I2C Master Write-Read
+                     command and print response
+        spd          Print SPD information from remote
+                     I2C device
+        lan          Configure LAN Channels
+        chassis      Get chassis status and set power
+                     state
+        power        Alias for chassis power commands
+        event        Send pre-defined events to MC
+        mc           Management Controller status and
+                     global enables
+        sdr          Print Sensor Data Repository
+                     entries and readings
+        sensor       Print detailed sensor information
+        fru          Print built-in FRU and scan SDR
+                     for FRU locators
+        sel          Print System Event Log (SEL)
+        pef          Configure Platform Event Filtering
+                     (PEF)
+        sol          Configure IPMIv2.0 Serial-over-LAN
+        isol         Configure IPMIv1.5 Serial-over-LAN
+        user         Configure Management Controller
+                     users
+        channel      Configure Management Controller
+                     channels
+        sunoem       OEM Commands for Sun servers
+        kontronoem   OEM Commands for Kontron
+        picmg        Run a PICMG/ATA extended command
+        firewall     Configure firmware firewall
+        session      Print session information
+        exec         Run list of commands from file
+        set          Set runtime variable for shell and
+                     exec
+        echo         Echo lines to stdout in scripts
+        ekanalyzer   Run FRU-Ekeying analyzer using FRU
+                     files
+
+ipmitool \-I bmc chassis help
+.br
+Chassis Commands:  status, power, identify, policy, restart_cause, poh, bootdev, bootparam, selftest
+
+ipmitool \-I bmc chassis power help
+.br
+chassis power Commands: status, on, off, cycle, reset, diag, soft
+.TP
+bmc|mc
+.RS
+.TP
+reset <warm|cold>
+.br
+
+Instructs the BMC to perform a warm or cold reset.
+.TP
+info
+.br
+
+Displays information about the BMC hardware, including device revision,
+firmware revision, IPMI version supported, manufacturer ID,
+and information on additional device support.
+.TP 
+watchdog
+.br 
+
+These commands allow a user to view and change the current 
+state of the watchdog timer.
+.RS
+.TP 
+get
+.br
+
+Show current Watchdog Timer settings and countdown state.
+.TP 
+reset
+.br
+
+Reset the Watchdog Timer to its most recent state and restart the 
+countdown timer.
+.TP 
+off
+.br
+
+Turn off a currently running Watchdog countdown timer.
+.RE
+.TP 
+selftest
+.br 
+
+Check on the basic health of the BMC by executing the Get Self Test
+results command and reporting the results.
+.TP
+getenables
+.br
+
+Displays a list of the currently enabled options for the BMC.
+.br
+.TP
+setenables <option>=[on|off]
+.br
+
+Enables or disables the given \fIoption\fR.  Currently supported
+values for \fIoption\fR include:
+.RS
+.TP
+recv_msg_intr
+.br
+
+Receive Message Queue Interrupt
+.TP
+event_msg_intr
+.br
+
+Event Message Buffer Full Interrupt
+.TP
+event_msg
+.br
+
+Event Message Buffer
+.TP
+system_event_log
+.br
+
+System Event Logging
+.TP
+oem0
+.br
+
+OEM-Defined option #0
+.TP
+oem1
+.br
+
+OEM-Defined option #1
+.TP
+oem2
+.br
+
+OEM-Defined option #2
+.RE
+.RE
+.TP
+channel
+.RS
+.TP
+authcap <channel number> <max priv>
+
+Displays  information  about  the
+authentication capabilities of the selected channel
+at the specified privilege level.
+.RS
+.TP
+Possible privilege levels are:
+.br
+1   Callback level
+.br
+2   User level
+.br
+3   Operator level
+.br
+4   Administrator level
+.br
+5   OEM Proprietary level
+.RE
+.TP
+info [channel number]
+
+Displays  information  about  the
+selected  channel.  If no channel is given it will
+display information about the currently used channel:
+.RS
+.PP
+ipmitool \-I bmc channel info
+.br
+Channel 0xf info:
+.br
+  Channel Medium Type   : System Interface
+.br
+  Channel Protocol Type : KCS
+.br
+  Session Support       : session\-less
+.br
+  Active Session Count  : 0
+.br
+  Protocol Vendor ID    : 7154
+.RE
+.TP
+getaccess <channel number> [userid]
+.br
+
+Configure the given userid as the default on the given channel number.
+When the given channel is subsequently used, the user is identified
+implicitly by the given userid.
+.TP
+setaccess <channel number> <userid> [callin=on|off]
+ [ipmi=on|off] [link=on|off] [privilege=level]
+.br
+
+Configure user access information on the given channel for the given userid.
+.TP
+getciphers <all | supported> <ipmi | sol> [channel]
+.br
+
+Displays the list of cipher suites supported for the given
+application (ipmi or sol) on the given channel.
+.RE
+.TP
+chassis
+.RS
+.TP
+status
+.br
+
+Displays information regarding the high-level
+status of the system chassis and main power
+subsystem.
+.TP
+poh
+.br
+
+This  command  will  return  the  Power\-On Hours counter.
+.TP
+identify <interval>
+
+Control the front panel identify  light.   Default interval
+is 15 seconds.  Use 0 to turn off.  Use "force" to turn on 
+indefinitely.
+.TP
+restart_cause
+.br
+
+Query the chassis for the cause of the last system restart.
+.TP 
+selftest
+.br 
+
+Check on the basic health of the BMC by executing the Get Self Test
+results command and reporting the results.
+.TP
+policy
+.br
+
+Set the chassis power policy in  the  event  power failure.
+.RS
+.TP
+list
+.br
+
+Return supported policies.
+.TP
+always\-on
+.br
+
+Turn on when power is restored.
+.TP
+previous
+.br
+
+Returned to  previous  state  when  power  is restored.
+.TP
+always\-off
+.br
+
+Stay off after power is restored.
+.RE
+.TP
+power
+.br
+
+Performs a chassis control  command  to  view  and
+change the power state.
+.RS
+.TP
+status
+.br
+
+Show current chassis power status.
+.TP
+on
+.br
+
+Power up chassis.
+.TP
+off
+.br
+
+Power  down  chassis  into  soft  off  (S4/S5
+state).   WARNING: This command does not initiate a clean 
+shutdown of the operating  system prior to powering down the system.
+.TP
+cycle
+.br
+
+Provides a power off interval of
+at least 1 second.  No action should occur if
+chassis power is in S4/S5 state,  but  it  is
+recommended  to  check  power state first and
+only issue a power cycle command if the  system  power is 
+on or in lower sleep state than S4/S5.
+.TP
+reset
+.br
+
+This command will perform a hard reset.
+.TP
+diag
+.br
+
+Pulse a  diagnostic  interrupt (NMI) directly to the processor(s).
+.TP
+soft
+.br 
+
+Initiate a soft\-shutdown of OS  via  ACPI  by
+emulating a fatal overtemperature.
+.RE
+.TP
+bootdev <device> [clear-cmos=yes|no] [options=help,...]
+.br
+
+Request the system to boot from an alternate boot device on next reboot.  If the optional
+`clear-cmos` argument is present, the parameter given will be used to determine if the
+values stored in persistent CMOS memory are cleared the next time the system is rebooted.
+Note that this command is not supported on many platforms.
+Various options may be used to modify the boot device settings.
+Run "bootdev none options=help" for a list of available boot device
+modifiers/options.
+
+.RS
+.TP
+Currently supported values for <device> are:
+.TP
+pxe
+.br
+
+Force PXE boot
+.TP
+disk
+.br
+
+Force boot from BIOS default boot device
+.TP
+safe
+.br
+
+Force boot from BIOS default boot device, request Safe Mode
+.TP
+diag
+.br
+
+Force boot from diagnostic partition
+.TP
+cdrom
+.br
+
+Force boot from CD/DVD
+.TP
+bios
+.br
+
+Force boot into BIOS setup
+.TP 
+floppy
+.br 
+
+Force boot from Floppy/primary removable media
+.RE
+.TP 
+bootparam
+.br 
+
+Get or set various system boot option parameters.
+.RS
+.TP 
+get <param #>
+.br 
+
+Get boot parameter. Currently supported values for <param #> are:
+
+0 - Set In Progress
+
+1 - Service Partition Selector
+
+2 - Service Partition Scan
+
+3 - BMC Boot Flag Valid Bit Clearing
+
+4 - Boot Info Acknowledge 
+
+5 - Boot Flags
+
+6 - Boot Initiator Info
+
+7 - Boot Initiator Mailbox
+.br 
+
+.TP 
+set <option> [value ...]
+.br 
+
+Set boot parameter.
+
+.RS
+.TP 
+Currently supported values for <option> are:
+.TP 
+force_pxe
+.br 
+
+Force PXE boot
+.TP 
+force_disk
+.br 
+
+Force boot from default hard-drive
+.TP 
+force_safe
+.br 
+
+Force boot from default hard-drive, request Safe Mode
+.TP 
+force_diag
+.br 
+
+Force boot from diagnostic partition
+.TP 
+force_cdrom
+.br 
+
+Force boot from CD/DVD 
+.TP 
+force_bios
+.br 
+
+Force boot into BIOS setup
+
+.RE
+.RE
+.RE
+.TP
+ekanalyzer <command> <xx=file1> <xx=file2> [<rc=file3>] ...
+.RS
+
+.br
+NOTE : This command can support a maximum of 8 files per command line
+.TP
+file1
+.br
+binary file that stores FRU data of a Carrier or an AMC module
+.TP
+file2
+.br
+binary file that stores FRU data of an AMC module.
+These binary files can be generated from command:
+ipmitool fru read <id> <file>
+.TP
+file3
+.br
+configuration file used for configuring On-Carrier Device ID
+or OEM GUID. This file is optional.
+.TP
+.br
+xx : indicates the type of the file.
+.br
+It can take the following value:
+.RS
+.TP
+.br
+oc : On-Carrier device
+.TP
+.br
+a1 : AMC slot A1
+.TP
+.br
+a2 : AMC slot A2
+.TP
+.br
+a3 : AMC slot A3
+.TP
+.br
+a4 : AMC slot A4
+.TP
+.br
+b1 : AMC slot B1
+.TP
+.br
+b2 : AMC slot B2
+.TP
+.br
+b3 : AMC slot B3
+.TP
+.br
+b4 : AMC slot B4
+.TP
+.br
+sm : Shelf Manager
+
+.RE
+.TP
+.br
+The available commands for ekanalyzer are:
+
+.TP
+print [<carrier | power | all>]
+.RS
+.TP
+carrier (default) <oc=file1> <oc=file2> ...
+.br
+
+Display point-to-point physical connectivity between carriers and AMC modules.
+ Example:
+   ipmitool ekanalyzer print carrier oc=fru oc=carrierfru
+   From Carrier file: fru
+      Number of AMC bays supported by Carrier: 2 
+      AMC slot B1 topology:
+         Port 0 =====> On Carrier Device ID 0, Port 16
+         Port 1 =====> On Carrier Device ID 0, Port 12
+         Port 2 =====> AMC slot B2, Port 2
+      AMC slot B2 topology:
+         Port 0 =====> On Carrier Device ID 0, Port 3
+         Port 2 =====> AMC slot B1, Port 2
+   *-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*
+   From Carrier file: carrierfru
+      On Carrier Device ID 0 topology:
+         Port 0 =====> AMC slot B1, Port 4
+         Port 1 =====> AMC slot B1, Port 5
+         Port 2 =====> AMC slot B2, Port 6
+         Port 3 =====> AMC slot B2, Port 7
+      AMC slot B1 topology:
+         Port 0 =====> AMC slot B2, Port 0
+      AMC slot B1 topology:
+         Port 1 =====> AMC slot B2, Port 1
+      Number of AMC bays supported by Carrier: 2
+
+.TP
+power <xx=file1> <xx=file2> ...
+.br
+
+Display power supply information between carrier and AMC modules.
+.TP
+all <xx=file> <xx=file> ...
+.br
+
+Display both physical connectivity and power supply of each carrier and AMC
+modules.
+
+.RE
+.TP
+frushow <xx=file>
+.br
+
+Convert a binary FRU file into human readable text format. Use -v option to get
+more display information.
+
+.RE
+.RS
+.TP
+summary [<match | unmatch | all>]
+.RS
+.TP
+match (default) <xx=file> <xx=file> ...
+.br
+
+Display only matched results of Ekeying match between an On-Carrier device
+and an AMC module or between 2 AMC modules. Example:
+ ipmitool ekanalyzer summary match oc=fru b1=amcB1 a2=amcA2
+ On-Carrier Device vs AMC slot B1
+  AMC slot B1 port 0 ==> On-Carrier Device 0 port 16
+   Matching Result
+   - From On-Carrier Device ID 0
+    -Channel ID 11 || Lane 0: enable
+    -Link Type: AMC.2 Ethernet
+    -Link Type extension: 1000BASE-BX (SerDES Gigabit) Ethernet link
+    -Link Group ID: 0 || Link Asym. Match: exact match
+   - To AMC slot B1
+    -Channel ID 0 || Lane 0: enable
+    -Link Type: AMC.2 Ethernet
+    -Link Type extension: 1000BASE-BX (SerDES Gigabit) Ethernet link
+    -Link Group ID: 0 || Link Asym. Match: exact match
+   *-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*
+  AMC slot B1 port 1 ==> On-Carrier Device 0 port 12
+   Matching Result
+   - From On-Carrier Device ID 0
+    -Channel ID 6 || Lane 0: enable
+    -Link Type: AMC.2 Ethernet
+    -Link Type extension: 1000BASE-BX (SerDES Gigabit) Ethernet link
+    -Link Group ID: 0 || Link Asym. Match: exact match
+   - To AMC slot B1
+    -Channel ID 1 || Lane 0: enable
+    -Link Type: AMC.2 Ethernet
+    -Link Type extension: 1000BASE-BX (SerDES Gigabit) Ethernet link
+    -Link Group ID: 0 || Link Asym. Match: exact match
+   *-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*
+ On-Carrier Device vs AMC slot A2
+  AMC slot A2 port 0 ==> On-Carrier Device 0 port 3
+   Matching Result
+   - From On-Carrier Device ID 0
+    -Channel ID 9 || Lane 0: enable
+    -Link Type: AMC.2 Ethernet
+    -Link Type extension: 1000BASE-BX (SerDES Gigabit) Ethernet link
+    -Link Group ID: 0 || Link Asym. Match: exact match
+   - To AMC slot A2
+    -Channel ID 0 || Lane 0: enable
+    -Link Type: AMC.2 Ethernet
+    -Link Type extension: 1000BASE-BX (SerDES Gigabit) Ethernet link
+    -Link Group ID: 0 || Link Asym. Match: exact match
+   *-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*
+ AMC slot B1 vs AMC slot A2
+  AMC slot A2 port 2 ==> AMC slot B1 port 2
+   Matching Result
+   - From AMC slot B1
+    -Channel ID 2 || Lane 0: enable
+    -Link Type: AMC.3 Storage
+    -Link Type extension: Serial Attached SCSI (SAS/SATA)
+    -Link Group ID: 0 || Link Asym. Match: FC or SAS interface {exact match}
+   - To AMC slot A2
+    -Channel ID 2 || Lane 0: enable
+    -Link Type: AMC.3 Storage
+    -Link Type extension: Serial Attached SCSI (SAS/SATA)
+    -Link Group ID: 0 || Link Asym. Match: FC or SAS interface {exact match}
+ *-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*
+.TP
+unmatch <xx=file> <xx=file> ...
+.br
+
+Display the unmatched results of Ekeying match between an On-Carrier device
+and an AMC module or between 2 AMC modules
+.TP
+all <xx=file> <xx=file> ...
+.br
+
+Display both matched result and unmatched results of Ekeying match between two
+cards or two modules.
+.RE
+.RE
+.TP
+event
+.RS
+.TP
+<predefined event number n>
+.br
+
+Send a pre-defined test event to the System Event Log.  The following events are
+included as a means to test the functionality of the System Event Log component
+of the BMC (an entry will be added each time the event \fIn\fR command is
+executed).
+
+Currently supported values for \fIn\fR are:
+.br
+1	Temperature: Upper Critical: Going High
+.br
+2	Voltage Threshold: Lower Critical: Going Low
+.br
+3	Memory: Correctable ECC
+.br
+
+\fINOTE\fR: These pre-defined events will likely not
+produce "accurate" SEL records for a particular system because they will
+not be correctly tied to a valid sensor number, but they are sufficient
+to verify correct operation of the SEL.
+
+.TP
+file <filename>
+.br
+
+Event log records specified in \fIfilename\fR will be added to the System Event Log.
+
+The format of each line in the file is as follows:
+
+<{EvM Revision} {Sensor Type} {Sensor Num} {Event Dir/Type} {Event Data 0} {Event Data 1} {Event Data 2}>[# COMMENT]
+
+e.g.:
+.br
+0x4 0x2 0x60 0x1 0x52 0x0 0x0 # Voltage threshold: Lower Critical: Going Low
+.br 
+
+EvM Revision - 
+The "Event Message Revision" is 0x04 for messages that comply with the IPMI 2.0 
+Specification and 0x03 for messages that comply with the IPMI 1.0 Specification.
+
+Sensor Type - 
+Indicates the Event Type or Class.
+
+Sensor Num - 
+Represents the 'sensor' within the management controller that generated 
+the Event Message.
+
+Event Dir/Type - 
+This field is encoded with the event direction as the high bit 
+(bit 7) and the event type as the low 7 bits.  Event direction is 
+0 for an assertion event and 1 for a deassertion event. 
+
+See the IPMI 2.0 specification for further details on the definitions for
+each field.
+
+.TP 
+<sensorid> <list>
+.br 
+
+Get a list of all the possible Sensor States and pre-defined Sensor State
+Shortcuts available for a particular sensor.   \fIsensorid\fR is the character 
+string representation of the sensor and must be enclosed in double quotes
+if it includes white space.  Several different commands including 
+\fIipmitool sensor list\fR may be used to obtain a list that includes 
+the \fIsensorid\fR strings representing the sensors on a given system. 
+.RS
+.PP 
+ipmitool \-I open event "PS 2T Fan Fault" list
+.br 
+Finding sensor PS 2T Fan Fault... ok
+.br 
+Sensor States:
+.br 
+  State Deasserted
+.br 
+  State Asserted
+.br 
+Sensor State Shortcuts:
+.br 
+  present    absent
+.br 
+  assert     deassert
+.br 
+  limit      nolimit
+.br 
+  fail       nofail
+.br 
+  yes        no
+.br 
+  on         off
+.br 
+  up         down
+
+.RE
+.TP 
+<sensorid> <sensor state> [<direction>]
+
+Generate a custom event based on existing sensor information.
+The optional event \fBdirection\fR can be either \fIassert\fR
+(the default) or \fIdeassert\fR.  
+
+.RS
+.PP 
+ipmitool event "PS 2T Fan Fault" "State Asserted"
+.br 
+Finding sensor PS 2T Fan Fault... ok
+.br 
+   0 | Pre-Init Time-stamp   | Fan PS 2T Fan Fault | State Asserted
+.RE
+.RS
+.PP 
+ipmitool event "PS 2T Fan Fault" "State Deasserted"
+.br 
+Finding sensor PS 2T Fan Fault... ok
+.br 
+   0 | Pre-Init Time-stamp   | Fan PS 2T Fan Fault | State Desserted
+.RE
+.RS
+.PP 
+.RE
+
+.RE
+.TP
+exec <filename>
+
+.RS
+Execute ipmitool commands from \fIfilename\fR.  Each line
+is a complete command.  The syntax of the commands
+are defined by the COMMANDS section in this manpage.
+Each line may have an optional comment at the end
+of the line, delimited with a `#' symbol.
+
+e.g., a command file with one line:
+
+sdr list # get a list of sdr records
+.br
+.RE
+.TP
+fru
+.RS
+.TP
+print
+.br
+
+This command will read all Field  Replaceable  Unit (FRU)
+inventory  data  and  extract  such information as
+serial number, part number, asset tags, and  short
+strings describing the chassis, board, or product.
+.TP 
+read <fru id> <fru file>
+.br 
+
+\fIfru id\fR is the digit ID of the FRU (see output of 'fru print').
+\fIfru file\fR is the absolute pathname of a file in which to dump the
+binary FRU data pertaining to the specified FRU entity.
+.TP 
+write <fru id> <fru file>
+.br 
+
+\fIfru id\fR is the digit ID of the FRU (see output of 'fru print').
+\fIfru file\fR is the absolute pathname of a file from which to pull
+the binary FRU data before uploading it to the specified FRU.
+.TP 
+upgEkey <fru id> <fru file>
+.br 
+
+Update a multirecord FRU location.
+\fIfru id\fR is the digit ID of the FRU (see output of 'fru print').
+\fIfru file\fR is the absolute pathname of a file from which to pull the
+binary FRU data to upload into the specified multirecord FRU entity.
+
+.TP 
+edit <fru id> 
+.br 
+
+This command provides interactive editing of some supported records, namely
+PICMG Carrier Activation Record.  \fIfru id\fR is the digit ID of the FRU 
+(see output of 'fru print'); default is 0.
+
+.TP 
+edit <fru id> field <section> <index> <string>
+.br 
+
+This command may be used to set a field string to a new value.  It replaces 
+the FRU data found at \fIindex\fR in the specified \fIsection\fR with the 
+supplied \fIstring\fR.  
+
+.RS
+.TP
+fru id
+.br
+
+is the digit ID of the FRU (see output of 'fru print').
+.TP
+section
+.br
+
+is a string which refers to FRU Inventory Information
+Storage Areas and may be refer to:
+.RS
+.TP 
+c FRU Inventory Chassis Info Area
+.br
+.TP
+b FRU Inventory Board Info Area
+.br
+.TP
+p FRU Inventory Product Info Area
+.RE
+.TP
+index
+.br
+
+specifies the field number. Field numbering starts on the first 'english text' field type. For instance in the <\fBboard\fR> info area field '0' is <\fBBoard Manufacturer\fR> and field '2' is <\fBBoard Serial Number\fR>; see IPMI Platform Management FRU Information Storage Definition v1.0 R1.1 for field locations.
+.TP
+string
+.br
+
+must be the same length as the string being replaced and must be 8-bit ASCII (0xCx).
+.RE
+.TP 
+edit <fru id> oem iana <record> <format> [<args>]
+.br 
+
+This command edits the data found in the multirecord area. Support for
+OEM specific records is limited. 
+.RE
+.TP 
+firewall
+.br 
+
+This command supports the firmware firewall capability.  It may be used to 
+add or remove security-based restrictions on certain commands/command 
+sub-functions  or to list the current firmware firewall restrictions set on 
+any commands.  For each firmware firewall command listed below, parameters 
+may be included to cause the command to be executed with increasing 
+granularity on a specific LUN, for a specific NetFn, for a specific IPMI 
+Command, and finally for a specific command's sub-function (see Appendix H in the 
+IPMI 2.0 Specification for a listing of any sub-function numbers that may 
+be associated with a particular command).
+
+Parameter syntax and dependencies are as follows:
+
+[<channel H>] [<lun L> [<netfn N> [<command C [<subfn S>]]]] 
+
+Note that if "netfn <\fBN\fR>" is specified, then "lun <\fBL\fR>" must also be 
+specified;  if "command <\fBC\fR>" is specified, then "netfn <\fBN\fR>" (and
+therefore "lun <\fBL\fR>") must also be specified, and so forth.
+
+"channel <\fBH\fR>" is an optional and standalone parameter.  If not specified,
+the requested operation will be performed on the current channel.  Note that
+command support may vary from channel to channel. 
+
+Firmware firewall commands:
+.RS
+.TP 
+info [<parms as described above>]
+.br 
+
+List firmware firewall information for the specified LUN, NetFn, and 
+Command (if supplied) on the current or specified channel.  Listed
+information includes the support, configurable, and enabled bits for
+the specified command or commands.
+
+Some usage examples:
+.RS
+.TP 
+info [<channel H>] [<lun L>] 
+.br 
+
+This command will list firmware firewall information for all NetFns for the 
+specified LUN on either the current or the specified channel.
+.TP 
+info [<channel H>] [<lun L> [<netfn N>]] 
+.br 
+
+This command will print out all command information for a single LUN/NetFn pair.
+.TP 
+info [<channel H>] [<lun L> [<netfn N> [<command C]]] 
+.br 
+
+This prints out detailed, human-readable information showing the support, configurable,
+and enabled bits for the specified command on the specified LUN/NetFn pair.  Information
+will be printed about each of the command subfunctions.
+.TP 
+info [<channel H>] [<lun L> [<netfn N> [<command C [<subfn S>]]]] 
+.br 
+
+Print out information for a specific sub-function.
+.RE
+.TP 
+enable [<parms as described above>]
+.br 
+
+This command is used to enable commands for a given NetFn/LUN combination on
+the specified channel. 
+.TP 
+disable [<parms as described above>] [force]
+.br 
+
+This command is used to disable commands for a given NetFn/LUN combination on
+the specified channel.   Great care should be taken if using the "force"
+option so as not to disable the "Set Command Enables" command.
+.TP 
+reset [<parms as described above>]
+.br 
+
+This command may be used to reset the firmware firewall back to a state
+where all commands and command sub-functions are enabled.
+
+.RE
+.TP
+i2c <i2caddr> <read bytes> [<write data>]
+.br
+
+Sends an I^2C Master Write-Read command (if <write data> is supplied,
+it is written to the I^2C master first)
+to the device at address <i2caddr> and displays <read bytes> bytes of response.
+.br
+
+Note: this command is not supported by all BMCs.
+.br
+
+The following command writes the values 0x2, 0x3, and 0x4, then attempts to read 5 bytes from the I^2C master
+at address 0xa:
+.br
+
+ipmitool i2c 0xa 5 0x2 0x3 0x4
+
+.TP
+isol
+.RS
+.TP 
+info
+.br 
+
+Retrieve information about the Intel IPMI v1.5 Serial\-Over\-LAN
+configuration.
+.TP 
+set <parameter> <value>
+.br 
+
+Configure parameters for Intel IPMI v1.5 Serial\-over\-LAN.
+.RS
+.TP
+Valid parameters and values are:
+.br
+.TP
+enabled
+true, false
+.TP
+privilege\-level
+user, operator, admin, oem
+.TP
+bit\-rate
+9.6, 19.2, 38.4, 57.6, 115.2
+.RE
+.TP
+activate
+.br
+
+Causes ipmitool to enter Intel IPMI v1.5 Serial Over LAN mode. An RMCP+
+connection is made to the BMC, the terminal is set to raw mode, and user
+input is sent to the serial console on the remote server. On exit, the
+the SOL payload mode is deactivated and the terminal is reset to its
+original settings.
+.RS
+
+Special escape sequences are provided to control the SOL session:
+.RS
+.TP
+~.        Terminate connection
+.TP
+~^Z       Suspend ipmitool
+.TP
+~^X       Suspend ipmitool, but don't restore tty on restart
+.TP
+~B        Send break
+.TP
+~~        Send the escape character by typing it twice
+.TP
+~?        Print the supported escape sequences
+.RE
+
+Note that escapes are only recognized immediately after newline.
+.RE
+
+.RE
+.TP 
+kontronoem
+.RS
+
+OEM commands specific to Kontron devices.
+.TP
+setsn
+.br
+
+Set FRU serial number.
+.TP
+setmfgdate
+.br
+
+Set FRU manufacturing date.
+.TP
+nextboot <boot device>
+.br
+
+Select the next boot order on the Kontron CP6012.
+.RE
+.TP
+lan
+.RS
+.TP
+print [<channel>]
+.br
+
+Print the  current  configuration  for  the  given channel.
+The default will print information on the first found LAN channel.
+.TP
+set <channel> <command> <parameter>
+.br
+
+Set the given  command and parameter  on  the  given  channel.
+Valid command/parameters are:
+.RS
+.TP
+ipaddr <x.x.x.x>
+.br
+
+Set the IP address for this channel.
+.TP
+netmask <x.x.x.x>
+.br
+
+Set the netmask for this channel.
+.TP
+macaddr <xx:xx:xx:xx:xx:xx>
+.br
+
+Set the MAC address for this channel.
+.TP
+defgw ipaddr <x.x.x.x>
+.br
+
+Set the default gateway IP address.
+.TP
+defgw macaddr <xx:xx:xx:xx:xx:xx>
+.br
+
+Set the default gateway MAC address.
+.TP
+bakgw ipaddr <x.x.x.x>
+.br
+
+Set the backup gateway IP address.
+.TP
+bakgw macaddr <xx:xx:xx:xx:xx:xx>
+.br
+
+Set the backup gateway MAC address.
+.TP
+password <pass>
+.br
+
+Set the null user password.
+.TP
+snmp <community string>
+.br
+
+Set the SNMP community string.
+.TP
+user
+.br
+
+Enable user access mode for userid 1 (issue the `user'
+command to display information about userids for a given channel).
+.TP
+access <on|off>
+.br
+
+Set LAN channel access mode.
+.TP 
+alert <on|off>
+.br 
+
+Enable or disable PEF alerting for this channel.
+.TP
+ipsrc <source>
+.br
+
+Set the IP address source:
+.br
+none = unspecified
+.br
+static = manually configured static IP address
+.br
+dhcp = address obtained by BMC running DHCP
+.br
+bios = address loaded by BIOS or system software
+.TP
+arp respond <on|off>
+.br
+
+Set BMC generated ARP responses.
+.TP
+arp generate <on|off>
+.br
+
+Set BMC generated gratuitous ARPs.
+.TP
+arp interval <seconds>
+.br
+
+Set BMC generated gratuitous ARP interval.
+.TP
+auth <level,...> <type,...>
+.br
+
+Set the valid  authtypes  for  a  given  auth level.
+.br
+Levels: callback, user, operator, admin
+.br
+Types: none, md2, md5, password, oem
+.TP
+cipher_privs <privlist>
+.br
+
+Correlates cipher suite numbers with the maximum privilege
+level that is allowed to use it.  In this way, cipher suites can restricted
+to users with a given privilege level, so that, for example,
+administrators are required to use a stronger cipher suite than
+normal users.
+
+The format of \fIprivlist\fR is as follows.  Each character represents a privilege level
+and the character position identifies the cipher suite number.  For example, the
+first character represents cipher suite 1 (cipher suite 0 is reserved), the second represents
+cipher suite 2, and so on.  \fIprivlist\fR must be 15 characters in length.
+
+Characters used in \fIprivlist\fR and their associated privilege levels are:
+
+X	Cipher Suite Unused
+.br
+c	CALLBACK
+.br
+u	USER
+.br
+o	OPERATOR
+.br
+a	ADMIN
+.br
+O	OEM
+.br
+
+So, to set the maximum privilege for cipher suite 1 to USER and suite 2 to
+ADMIN, issue the following command:
+
+ipmitool -I \fIinterface\fR lan set \fIchannel\fR cipher_privs uaXXXXXXXXXXXXX
+
+.RE
+.TP
+alert print [<channel>] [<destination>]
+.br 
+
+Print alert information for the specified channel and destination.  
+The default will print all alerts for all alert destinations on the 
+first found LAN channel.
+
+.TP
+alert set <channel> <destination> <command> <parameter>
+.br 
+
+Set an alert on the given LAN channel and destination.   Alert Destinations are
+listed via the 'lan alert print' command.  Valid command/parameters are:
+.RS
+.TP 
+ipaddr <x.x.x.x>
+.br 
+
+Set alert IP address.
+.TP 
+macaddr <xx:xx:xx:xx:xx:xx>
+.br 
+
+Set alert MAC address.
+.TP 
+gateway <default | backup>
+.br 
+
+Set the channel gateway to use for alerts.
+.TP 
+ack <on | off>
+.br 
+
+Set Alert Acknowledge on or off.
+.TP 
+type <pet | oem1 | oem2>
+.br 
+
+Set the destination type as PET or OEM.
+.TP 
+time <seconds>
+.br 
+
+Set ack timeout or unack retry interval.
+.TP 
+retry <number>
+.br 
+
+Set the number of alert retries.
+.RE
+.TP
+stats get [<channel>]
+.br 
+
+Retrieve information about the IP connections on the specified channel.
+The default will retrieve statistics on the first found LAN channel.
+.TP
+stats clear [<channel>]
+.br 
+
+Clear all IP/UDP/RMCP Statistics to 0 on the specified channel.
+The default will clear statistics on the first found LAN channel.
+.RE
+.TP
+pef
+.RS
+.TP
+info
+.br
+
+This command will query the BMC and print information about the PEF supported features.
+.TP
+status
+.br
+
+This command prints the current PEF status (the last SEL entry processed by the BMC, etc).
+.TP
+policy
+.br
+
+This command lists the PEF policy table entries.  Each policy 
+entry describes an alert destination.  A policy set is a 
+collection of table entries.  PEF alert actions reference policy sets.
+.TP
+list
+.br
+
+This command lists the PEF table entries.  Each PEF entry 
+relates a sensor event to an action.  When PEF is active, 
+each platform event causes the BMC to scan this table for 
+entries matching the event, and possible actions to be taken.
+Actions are performed in priority order (higher criticality first).
+.RE
+.TP
+picmg <properties> 
+.RS
+
+Run a PICMG/ATA extended command. Get PICMG properties may be used to
+obtain and print Extension major version information, PICMG identifier,
+FRU Device ID and Max FRU Device ID.
+.TP 
+addrinfo
+.br 
+
+Get address information.  This command may return information on the Hardware
+address, IPMB-0 Address, FRU ID, Site/Entity ID, and Site/Entity Type.
+.TP 
+frucontrol <fru id> <options>
+.br 
+
+Set various control options:
+.RS
+.TP 
+0x00      - Cold Reset
+.br 
+.TP 
+0x01      - Warm Reset
+.br 
+.TP 
+0x02      - Graceful Reboot
+.br 
+.TP 
+0x03      - Issue Diagnostic Interrupt
+.br 
+.TP 
+0x04      - Quiesce [AMC only]
+.br 
+.TP 
+0x05-0xFF - Cold Reset
+.br 
+.RE
+.TP 
+activate <fru id>
+.br 
+
+Activate the specified FRU.
+.TP 
+deactivate <fru id>
+.br 
+
+Deactivate the specified FRU.
+.TP 
+policy get <fru id>
+.br 
+
+Get FRU activation policy.
+.TP 
+policy set <fru id> <lockmask> <lock>
+.br 
+
+Set FRU activation policy.  \fIlockmask\fR is 1 or 0 to indicate action
+on the deactivation or activation locked bit respectively.  \fIlock\fR is
+1 or 0 to set/clear locked bit.
+.TP 
+portstate set|getall|getgranted|getdenied <parameters> 
+.br 
+
+Get or set various port states.  See usage for parameter details.
+.RE
+.TP 
+power <chassis power command>
+.br 
+
+Alias for the "chassis power" commands.
+See the "chassis power" commands for usage information.
+.TP 
+raw <netfn> <cmd> [<data>]
+.br
+
+This will allow you to execute raw IPMI commands.   For
+example to query the POH counter with a raw command:
+
+ipmitool \-v \-I bmc raw 0x0 0xf
+.br
+RAW REQ (netfn=0x0 cmd=0xf data_len=0)
+.br
+RAW RSP (5 bytes)
+.br
+3c 72 0c 00 00
+.TP
+sdr
+.RS
+.TP
+info
+.br
+
+This command will query the BMC for Sensor Data Record (SDR) Repository information.
+.TP
+type [list|<sensor type>]
+.br
+
+Displays sensor data records only for the sensor type (e.g. `temperature', `voltage', etc.)
+chosen.  A list of all supported sensor types may be displayed if the `list' keyword is used instead
+of a sensor type.  Note that the sensor type is not case sensitive.  Also note that there may be a large
+delay before any information is displayed, because ipmitool does a full scan of all sensor records and builds
+a list of just those that meet the type criterion given.
+.TP
+list|elist [all|full|compact|event|mcloc|fru|generic]
+.br
+
+This command will read the Sensor Data Records (SDR) and 
+extract sensor information of a given type, then query each sensor and 
+print its name, reading, and status.  The `elist' form of this command
+prints additional information about each data record (e.g. threshold type,
+sensor number, sensor entity).
+.RS
+.TP
+Valid types are:
+.RS
+.TP
+all
+.br
+
+All SDR records (Sensor and Locator) 
+.TP
+full
+.br
+
+Full Sensor Record
+.TP
+compact
+.br
+
+Compact Sensor Record
+.TP
+event
+.br
+
+Event-Only Sensor Record
+.TP
+mcloc
+.br
+
+Management Controller Locator Record
+.TP
+fru
+.br
+
+FRU Locator Record
+.TP
+generic
+.br
+
+Generic SDR records
+.RE
+.RE
+.TP
+entity <id>[.<instance>]
+.br
+
+Displays all sensors associated with an entity.  Get a list of
+valid entity ids on the target system by issuing the `sdr list' command
+with the verbose option (`-v').  A list of all entity ids can be found
+in the IPMI specifications.
+.TP
+dump <file>
+.br
+
+Dumps raw SDR data to a file.  This file may also be used as the sdr cache, supplied to ipmitool
+with the `\-S' option, dramatically speeding up the `sdr' and `sel elist' commands.
+.TP 
+fill sensors
+.br 
+
+Create the SDR Repository for the current configuration.  Will perform
+a 'Clear SDR Repository' command so be careful.
+.TP 
+fill file <filename>
+.br 
+
+Fill the SDR Repository using records stored in a binary data file. Will perform
+a 'Clear SDR Repository' command so be careful.
+.RE
+.TP
+sel
+.br
+
+NOTE: System Event Log (SEL) entry-times are displayed as 
+`Pre-Init Time-stamp' if the SEL clock needs to be set.
+Ensure that the SEL clock is accurate by invoking the
+`sel time get' and
+`sel time set <time string>' commands.
+.RS
+.TP
+info 
+.br
+
+This command will query the BMC for information
+about the System Event Log (SEL) and its contents.
+.TP
+clear
+.br
+
+This command will clear the contents of the SEL.
+It cannot be undone so be careful.
+.TP
+list|elist
+.br
+
+When this command is invoked without arguments, the entire
+contents of the SEL are displayed.  In addition to the information
+displayed by the `list' command, the `elist' command will cross-reference
+SEL records with SDR records to produce descriptive event output.
+
+.RS
+.TP
+<count> | first <count>
+.br
+
+Displays the first \fIcount\fR (least-recent) entries in the SEL.
+If \fIcount\fR is zero, all entries are displayed.
+.TP
+last <count>
+.br
+
+Displays the last \fIcount\fR (most-recent) entries in the SEL.
+If \fIcount\fR is zero, all entries are displayed.
+.RE
+.TP          
+delete <SEL Record ID> ... <SEL Record ID>
+.br 
+
+Delete one or more SEL event records.
+.TP 
+add <file>
+.br 
+
+Read event entries from a file and add them to the SEL.  New SEL
+entries area added onto the SEL after the last record in the SEL.
+Record added is of type 2 and is automatically timestamped.
+.TP 
+get <SEL Record ID>
+.br 
+
+Print information on the specified SEL Record entry.
+.TP 
+save <file>
+
+Save SEL records to a text file that can be fed back into the
+`event file' ipmitool command.  This can be useful for
+testing Event generation by building an appropriate Platform
+Event Message file based on existing events.  Please see the
+available help for the 'event file ...' command for a description of
+the format of this file.
+.TP 
+writeraw <file>
+
+Save SEL records to a file in raw, binary format.  This file can
+be fed back to the `sel readraw' ipmitool command for viewing.
+.TP 
+readraw <file>
+
+Read and display SEL records from a binary file.  Such a file can
+be created using the `sel writeraw' ipmitool command.
+.TP          
+time
+.RS
+.TP
+get
+.br
+
+Displays the SEL clock's current time.
+.TP
+set <time string>
+.br
+
+Sets the SEL clock.  Future SEL entries will use the time
+set by this command.  <time string> is of the
+form "MM/DD/YYYY HH:MM:SS".  Note that hours are in 24-hour
+form.  It is recommended that the SEL be cleared before
+setting the time.
+.RE
+.RE
+.TP
+sensor
+.RS
+.TP
+list
+.br
+
+Lists sensors and thresholds in a wide table format.
+.TP
+get <id> ... [id]
+.br
+
+Prints information for sensors specified by name.
+.TP
+thresh <id> <threshold> <setting>
+.br
+
+This allows you to set a particular sensor threshold 
+value.  The sensor is specified by name.
+.RS
+.TP
+Valid thresholds are:
+.br
+unr   Upper Non\-Recoverable
+.br
+ucr   Upper Critical
+.br
+unc   Upper Non\-Critical
+.br
+lnc   Lower Non\-Critical
+.br
+lcr   Lower Critical
+.br
+lnr   Lower Non\-Recoverable
+.RE
+.RE
+.TP
+session
+.RS
+.TP
+info <active | all | id 0xnnnnnnnn | handle 0xnn>
+.br
+
+Get information about the specified session(s).  You may identify
+sessions by their id, by their handle number, by their active status,
+or by using the keyword `all' to specify all sessions.
+.RE
+.TP
+sol
+.RS
+.TP
+info [<channel number>]
+.br
+
+Retrieve information about the Serial-Over-LAN configuration on 
+the specified channel.  If no channel is given, it will display 
+SOL configuration data for the currently used channel.
+.TP 
+payload <enable | disable> <channel> <userid>
+.br 
+
+Enable or disable SOL payload for the user on the specified channel. 
+.TP
+set <parameter> <value> [channel]
+.br
+
+Configure parameters for Serial Over Lan.  If no channel is given,
+it will display SOL configuration data for the currently used
+channel.  Configuration parameter updates are automatically guarded
+with the updates to the set-in-progress parameter.
+.RS
+.TP
+Valid parameters and values are:
+.br
+.TP
+set-in-progress
+set-complete set-in-progress commit-write
+.TP
+enabled
+true false
+.TP
+force-encryption
+true false
+.TP
+force-authentication
+true false
+.TP
+privilege-level
+user operator admin oem
+.TP
+character-accumulate-level
+Decimal number given in 5-millisecond increments
+.TP
+character-send-threshold
+Decimal number
+.TP
+retry-count
+Decimal number.  0 indicates no retries after packet is transmitted.
+.TP
+retry-interval
+Decimal number in 10 millisend increments.  0 indicates 
+that retries should be sent back to back.
+.TP
+non-volatile-bit-rate
+serial, 19.2, 38.4, 57.6, 115.2.  Setting this value to 
+serial indicates that the BMC should use the setting used 
+by the IPMI over serial channel.
+.TP
+volatile-bit-rate
+serial, 19.2, 38.4, 57.6, 115.2.  Setting this value to 
+serial indiates that the BMC should use the setting used 
+by the IPMI over serial channel.
+.RE
+.TP
+activate [usesolkeepalive | nokeepalive]
+.br
+
+Causes ipmitool to enter Serial Over LAN
+mode, and is only available when using the lanplus
+interface.  An RMCP+ connection is made to the BMC,
+the terminal is set to raw mode, and user input is
+sent to the serial console on the remote server.
+On exit,the the SOL payload mode is deactivated and
+the terminal is reset to its original settings.
+.RS
+
+Special escape sequences are provided to control the SOL session:
+.RS
+.TP
+~.   Terminate connection
+.TP
+~^Z  Suspend ipmitool
+.TP 
+~^X  Suspend ipmitool, but don't restore tty on restart
+.TP
+~B   Send break
+.TP
+~~   Send the escape character by typing it twice
+.TP
+~?   Print the supported escape sequences
+.RE
+
+Note that escapes are only recognized immediately after newline.
+.RE
+.TP
+deactivate
+.br
+
+Deactivates Serial Over LAN mode on the BMC.
+Exiting Serial Over LAN mode should automatically cause
+this command to be sent to the BMC, but in the case of an
+unintentional exit from SOL mode, this command may be
+necessary to reset the state of the BMC.
+.RE
+.TP 
+spd <i2cbus> <i2caddr> [<channel>] [<maxread>]
+.br 
+
+This command may be used to read SPD (Serial Presence Detect) data using the 
+I2C Master Write-Read IPMI command.
+
+.TP
+sunoem
+.br
+
+Sun OEM-specific IPMI commands.  Support for these commands depends heavily on the Sun platform targeted.
+Please consult your Sun Hardware Reference Guide for information on Sun OEM-specific IPMI
+functionality to determine if the following commands are supported on your desired platform.
+.RS
+.TP
+fan speed <0-100>
+.br
+
+Sets the system fan speed (in units of PWM duty cycle)
+.RE
+.RS
+.TP
+sshkey
+.br
+
+Administer SSH keys for service processor users.
+.RS
+.TP
+set <userid> <id_rsa.pub>
+.br
+
+Sets the SSH key for the given userid to the key found in the given file.  (A
+list of users may be obtained with the 'user list' command).
+.RE
+.RS
+.TP
+del <userid>
+.br
+
+Delete the SSH key for the given userid.
+.RE
+.RE
+
+.RS
+.TP
+led
+.br
+
+Manipulate the settings for LEDs found via the `sdr elist generic' command.
+Once the sensor ID of the LED is found (the `elist' command displayed the sensor ID),
+it may be used in the following subcommands.  When an LED type is required, it can
+be one of the following values: `OK2RM' (OK to Remove), `SERVICE' (Service Required),
+`ACT' (Activity), or `LOCATE' (Locate).  When an LED mode is required, it can be one
+of the following values: `OFF' (Off), `ON' (Steady On), `STANDBY' (100ms ON, 2900ms OFF blink rate),
+`SLOW' (1HZ blink rate), or `FAST' (4HZ blink rate).
+
+.RS
+.TP
+get <sensorid> [<ledtype>]
+.br
+
+Read the status of the LED with the given <sensorid>.  If <sensorid> is the special keyword `all', then
+the status of all LEDs will be displayed.  The optional parameter, <ledtype>, further restricts the output
+to LEDs of the given type.
+.RE
+.RS
+.TP
+set <sensorid> <ledmode> [<ledtype>]
+.br
+
+Sets the mode of the LED with the given <sensorid> (and optionally the given type <ledtype>) to the given <ledmode>.
+If <sensorid> is the special keyword `all', then the status of all LEDs will be set (optionally qualified by the
+given type <ledtype>).
+.RE
+.RE
+.TP
+user
+.RS
+.TP
+summary
+.br
+
+Displays a summary of userid information, including maximum number of userids,
+the number of enabled users, and the number of fixed names defined.
+.TP
+list
+.br
+
+Displays a list of user information for all defined userids.
+.TP
+set
+.RS
+.TP
+name <userid> <username>
+.br
+
+Sets the username associated with the given userid.
+.TP
+password <userid> [<password>]
+.br
+
+Sets the password for the given userid.  If no password is given,
+the password is cleared (set to the NULL password).  Be careful when
+removing passwords from administrator-level accounts.
+.RE
+.TP
+disable <userid>
+.br
+
+Disables access to the BMC by the given userid.
+.TP
+enable <userid>
+.br
+
+Enables access to the BMC by the given userid.
+.TP 
+priv <userid> <privilege level> [<channel>]
+.br 
+
+Set user privilege level on the specified channel.  If the channel is not 
+specified, the current channel will be used.
+.TP
+test <userid> <16|20> [<password>]
+.br
+
+Determine whether a password has been stored as 16 or 20 bytes.
+.RE
+
+\fINOTE\fR: Sun systems, such
+as the v20z and v40z, maintain the LAN interface on 
+channel 1.  To determine on which channel the LAN interface
+is located, issue the `channel info \fIchannel\fR' command.
+.SH BMC INTERFACE
+The ipmitool bmc interface utilizes the bmc device driver.
+     
+In order to force ipmitool to make use of the device interface
+you can specify it on the command line:
+
+ipmitool \-I bmc <command>
+
+.SH LAN INTERFACE
+The ipmitool lan interface communicates with a remote BMC over an
+Ethernet LAN connection using UDP over IPv4.  UDP datagrams
+are formatted to contain IPMI request/response messages with
+IPMI session headers and RMCP headers.
+
+IPMI\-over\-LAN uses version 1 of the Remote  Management  Control
+Protocol (RMCP) to support pre\-OS and OS\-absent management.
+RMCP is a request\-response protocol  delivered  using
+UDP datagrams to port 623.
+
+The LAN interface is an authenticated multi\-session connection;
+messages  delivered  to  the  BMC can (and should) be
+authenticate with a challenge/response protocol with either
+straight   password/key  or  MD5  message\-digest.
+ipmitool  will  attempt  to   connect   with   administrator
+privilege level as this is required to perform chassis power
+functions.
+
+You can tell ipmitool to use the lan interface with  the  \-I
+option:
+
+ipmitool \-I lan \-H <hostname> [\-f password_file] <command>
+
+A hostname must be given on the command line in order to use
+the  lan  interface  with 'ipmitool'.   The \fIpassword_file\fR
+is optional but, if present, should contain the password to be
+used for authentication.  If no password is given, ipmitool will
+attempt to connect without authentication.
+
+If \fIpassword_file\fR is present and non\-empty ipmitool will
+attempt to authenticate with an MD5 message-digest if MD5 is 
+supported by the BMC.  If MD5 is not supported by the BMC,
+straight password/key authentication will be attempted.
+
+.SH LANPLUS INTERFACE
+
+.LP
+Like the \fIlan\fP interface, the \fIlanplus\fP interface
+communicates with the BMC over an Ethernet LAN connection
+using UDP over IPv4.  The difference is that the \fIlanplus\fP
+interface uses the RMCP+ protocol as described in the IPMI v2.0
+specification.  RMCP+ allows for improved authentication and data
+integrity checks, as well as encryption and the ability to carry
+multiple types of payloads.  Generic Serial-over-LAN support 
+requires RMCP+, so the ipmitool \fIsol activate\fP command requires
+the use of the \fIlanplus\fP interface.
+.LP
+Establishing a RMCP+ session uses RAKP (Remote
+Authenticated Key-Exchange Protocol), which enables the negotiation of
+many options.  ipmitool does not yet allow the user to specify
+values for all the options, defaulting to the most obvious settings for those
+settings marked as required in the v2.0 specification.  Authentication and integrity 
+HMACs use the SHA-1 algorithm, and encryption is performed with AES, in CBC mode,
+at 128-bits of strength. Role-level logins are not supported.  ipmitool must
+be configured with the appropriate option for the \fIlanplus\fP interface
+to be available, as it is not enabled by default.  This interface currently
+requires the OpenSSL library.
+.LP
+You can tell ipmitool to use the lanplus interface with the \fB\-I\fR option:
+.PP
+ipmitool \-I lanplus \-H <hostname> [\-U username] [\-f password_file] <expression>
+.LP
+The options available for the \fIlanplus\fP interface are identical to those available for
+ the \fIlan\fP interface.
+
+.SH EXIT STATUS
+
+Upon successful completion, ipmitool returns 0.  On failure, 1 is returned.
+
+.SH EXAMPLES
+.TP
+Example 1 : Listing remote sensors:
+
+> ipmitool \-I lan \-H 1.2.3.4 \-f passfile sdr list
+.br
+Baseboard 1.25V  | 1.24 Volts        | ok
+.br
+Baseboard 2.5V   | 2.49 Volts        | ok
+.br
+Baseboard 3.3V   | 3.32 Volts        | ok
+.TP
+Example 2: Displaying status of a remote sensor:
+
+> ipmitool \-I lan \-H 1.2.3.4 \-f passfile sensor get "Baseboard 1.25V"
+.br
+Locating sensor record...
+.br
+Sensor ID              : Baseboard 1.25V (0x10)
+.br
+Sensor Type (Analog)   : Voltage
+.br
+Sensor Reading         : 1.245 (+/\- 0.039) Volts
+.br
+Status                 : ok
+.br
+Lower Non\-Recoverable  : na
+.br
+Lower Critical         : 1.078
+.br
+Lower Non\-Critical     : 1.107
+.br
+Upper Non\-Critical     : 1.382
+.br
+Upper Critical         : 1.431
+.br
+Upper Non\-Recoverable  : na 
+.TP
+Example 3: Displaying the power status of a remote chassis:
+
+> ipmitool \-I lan \-H 1.2.3.4 \-f passfile chassis power status
+.br
+Chassis Power is on
+.TP
+Example 4: Controlling the power on a remote chassis:
+
+> ipmitool \-I lan \-H 1.2.3.4 \-f passfile chassis power on
+.br
+Chassis Power Control: Up/On
+	
+.SH FILES
+
+\fB/platform/i86pc/kernel/drv/bmc\fR
+.in +30n
+.sp
+32-bit \fBELF\fR kernel module for the bmc driver.
+.sp
+.in -30n
+\fB/platform/i86pc/kernel/drv/amd64/bmc\fR
+.in +30n
+.sp
+64-bit \fBELF\fR kernel module for the bmc driver.
+.in -30n
+\fB/dev/bmc\fR
+.in +30n
+.sp
+Character device node used to communicate with the bmc driver.
+.in -30n
+
+.TP
+IPMI Specifications
+http://www.intel.com/design/servers/ipmi/spec.htm
+.SH SEE ALSO
+attributes(5)
+.SH NOTES
+IPMI V1.5 and, at the time of writing, IPMI V2.X only support IPv4. 
+There is no requirement for a BMC to use the same IP address as its 
+host system. In an IPv6 environment the host system can have an IPv6
+address and  'ipmitool' can be used to assign an IPv4 address to the
+BMC.
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/components/ipmitool/ipmitool.license	Wed May 25 22:38:48 2011 -0700
@@ -0,0 +1,30 @@
+Copyright (c) 2003 Sun Microsystems, Inc.  All Rights Reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions
+are met:
+
+Redistribution of source code must retain the above copyright
+notice, this list of conditions and the following disclaimer.
+
+Redistribution in binary form must reproduce the above copyright
+notice, this list of conditions and the following disclaimer in the
+documentation and/or other materials provided with the distribution.
+
+Neither the name of Sun Microsystems, Inc. or the names of
+contributors may be used to endorse or promote products derived
+from this software without specific prior written permission.
+
+This software is provided "AS IS," without a warranty of any kind.
+ALL EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES,
+INCLUDING ANY IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A
+PARTICULAR PURPOSE OR NON-INFRINGEMENT, ARE HEREBY EXCLUDED.
+SUN MICROSYSTEMS, INC. ("SUN") AND ITS LICENSORS SHALL NOT BE LIABLE
+FOR ANY DAMAGES SUFFERED BY LICENSEE AS A RESULT OF USING, MODIFYING
+OR DISTRIBUTING THIS SOFTWARE OR ITS DERIVATIVES.  IN NO EVENT WILL
+SUN OR ITS LICENSORS BE LIABLE FOR ANY LOST REVENUE, PROFIT OR DATA,
+OR FOR DIRECT, INDIRECT, SPECIAL, CONSEQUENTIAL, INCIDENTAL OR
+PUNITIVE DAMAGES, HOWEVER CAUSED AND REGARDLESS OF THE THEORY OF
+LIABILITY, ARISING OUT OF THE USE OF OR INABILITY TO USE THIS SOFTWARE,
+EVEN IF SUN HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
+
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/components/ipmitool/ipmitool.p5m	Wed May 25 22:38:48 2011 -0700
@@ -0,0 +1,66 @@
+#
+# CDDL HEADER START
+#
+# The contents of this file are subject to the terms of the
+# Common Development and Distribution License (the "License").
+# You may not use this file except in compliance with the License.
+#
+# You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
+# or http://www.opensolaris.org/os/licensing.
+# See the License for the specific language governing permissions
+# and limitations under the License.
+#
+# When distributing Covered Code, include this CDDL HEADER in each
+# file and include the License file at usr/src/OPENSOLARIS.LICENSE.
+# If applicable, add the following below this CDDL HEADER, with the
+# fields enclosed by brackets "[]" replaced with your own identifying
+# information: Portions Copyright [yyyy] [name of copyright owner]
+#
+# CDDL HEADER END
+#
+# Copyright (c) 2011, Oracle and/or its affiliates. All rights reserved.
+#
+
+<transform file path=usr.*/man/.+ -> default mangler.man.stability volatile>
+
+set name=pkg.fmri value=pkg:/system/management/[email protected]$(IPS_COMPONENT_VERSION),$(BUILD_VERSION)
+set name=pkg.summary value="ipmitool - utility for controlling IPMI-enabled devices"
+set name=info.classification value="org.opensolaris.category.2008:System/Hardware"
+set name=info.upstream_url value=$(COMPONENT_PROJECT_URL)
+set name=info.source_url value=$(COMPONENT_ARCHIVE_URL)
+set name=opensolaris.arc_url \
+   value=http://arc.opensolaris.org/caselog/PSARC/2004/453
+set name=org.opensolaris.consolidation value=$(CONSOLIDATION)
+
+license ipmitool.license license='BSD-like'
+
+dir path=lib
+dir path=lib/svc
+dir path=lib/svc/manifest
+dir path=lib/svc/manifest/network
+dir path=lib/svc/method
+dir path=usr
+dir path=usr/sbin
+dir path=usr/lib
+dir path=usr/sfw
+dir path=usr/sfw/bin
+dir path=usr/share
+dir path=usr/share/man
+dir path=usr/share/man/man1m
+dir path=usr/share/man/man8
+file usr/bin/ipmitool path=usr/sbin/ipmitool
+file usr/sbin/ipmievd path=usr/lib/ipmievd mode=0555
+link path=usr/sfw/bin/ipmitool target=../../sbin/ipmitool
+file ipmitool.1m path=usr/share/man/man1m/ipmitool.1m
+file ipmievd.8 path=usr/share/man/man8/ipmievd.8
+file ipmievd.xml path=lib/svc/manifest/network/ipmievd.xml
+file svc-ipmievd path=lib/svc/method/svc-ipmievd
+
+legacy pkg=SUNWipmi  \
+    desc="IPMI management tool 1.8.10" \
+    name="ipmitool, (usr)"
+
+legacy pkg=SUNWipmir \
+    desc="IPMI management tool 1.8.10 (root)" \
+    name="ipmitool, (root)"
+
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/components/ipmitool/patches/ipmievd.local4.patch	Wed May 25 22:38:48 2011 -0700
@@ -0,0 +1,11 @@
+--- ipmitool-1.8.10/lib/log.c.orig	Fri Nov 21 13:00:00 2008
++++ ipmitool-1.8.10/lib/log.c	Fri Nov 21 13:02:00 2008
[email protected]@ -120,7 +120,7 @@
+ 	logpriv->level = verbose + LOG_NOTICE;
+ 
+ 	if (logpriv->daemon)
+-		openlog(logpriv->name, LOG_CONS, LOG_LOCAL4);
++		openlog(logpriv->name, LOG_CONS, LOG_DAEMON);
+ }
+ 
+ /*
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/components/ipmitool/patches/ipmitool.scanning.patch	Wed May 25 22:38:48 2011 -0700
@@ -0,0 +1,12 @@
+--- ipmitool-1.8.10/lib/ipmi_sdr.c.orig	Fri Nov 21 13:00:00 2008
++++ ipmitool-1.8.10/lib/ipmi_sdr.c	Fri Nov 21 13:01:00 2008
[email protected]@ -1760,7 +1760,8 @@
+ 				printf("ns  | %2d.%1d | ",
+ 				       sensor->entity.id,
+ 				       sensor->entity.instance);
+-				if (IS_SCANNING_DISABLED(rsp->data[1]))
++				if ((rsp != NULL) &&
++				    IS_SCANNING_DISABLED(rsp->data[1]))
+ 					printf("Disabled");
+ 				else
+ 					printf("No Reading");
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/components/ipmitool/svc-ipmievd	Wed May 25 22:38:48 2011 -0700
@@ -0,0 +1,66 @@
+#!/bin/sh
+#
+# CDDL HEADER START
+#
+# The contents of this file are subject to the terms of the
+# Common Development and Distribution License (the "License").
+# You may not use this file except in compliance with the License.
+#
+# You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
+# or http://www.opensolaris.org/os/licensing.
+# See the License for the specific language governing permissions
+# and limitations under the License.
+#
+# When distributing Covered Code, include this CDDL HEADER in each
+# file and include the License file at usr/src/OPENSOLARIS.LICENSE.
+# If applicable, add the following below this CDDL HEADER, with the
+# fields enclosed by brackets "[]" replaced with your own identifying
+# information: Portions Copyright [yyyy] [name of copyright owner]
+#
+# CDDL HEADER END
+#
+#
+# Copyright (c) 2007, 2011, Oracle and/or its affiliates. All rights reserved.
+#
+
+# These are the SMF start/stop/restart methods for ipmievd.
+
+# smf(5)
+. /lib/svc/share/smf_include.sh
+
+SMF_FMRI="svc:/network/ipmievd:default"
+
+if [ $# -eq 0 ]; then
+    # No arguments provided - report current status (use "-c" option to
+    # svcprop to get the current properties, otherwise false will result)
+    if [ "`/usr/bin/svcprop -c -p general/enabled $SMF_FMRI`" = "true" ]
+    then
+        echo "svc-ipmievd: ipmievd is enabled"
+    else
+        echo "svc-ipmievd: ipmievd is disabled"
+    fi
+else
+    case "$1" in
+	'start')
+		# ipmievd requires the presence of a BMC character device
+		# to run.  If one is not detected, then disable the service
+		# and exit.
+
+		if [ ! -c /dev/bmc ]; then
+			echo "$0:  No BMC device found: disabling."
+			/usr/sbin/svcadm disable $SMF_FMRI
+			exit $SMF_EXIT_OK
+		fi
+
+		/usr/lib/ipmievd sel
+		[ $? -ne 0 ] && exit 1
+		;;
+
+	*)
+		echo "Usage: $0 start"
+		exit 1
+		;;
+    esac
+fi
+
+exit $SMF_EXIT_OK
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/components/ipmitool/test_ipmievd	Wed May 25 22:38:48 2011 -0700
@@ -0,0 +1,290 @@
+#!/bin/sh
+
+# CDDL HEADER START
+#
+# The contents of this file are subject to the terms of the
+# Common Development and Distribution License (the "License").
+# You may not use this file except in compliance with the License.
+#
+# You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
+# or http://www.opensolaris.org/os/licensing.
+# See the License for the specific language governing permissions
+# and limitations under the License.
+#
+# When distributing Covered Code, include this CDDL HEADER in each
+# file and include the License file at usr/src/OPENSOLARIS.LICENSE.
+# If applicable, add the following below this CDDL HEADER, with the
+# fields enclosed by brackets "[]" replaced with your own identifying
+# information: Portions Copyright [yyyy] [name of copyright owner]
+#
+# CDDL HEADER END
+#
+# Copyright (c) 2008, 2011, Oracle and/or its affiliates. All rights reserved.
+#
+
+# ----------------------------------------------------------------------------
+# test_ipmievd		confirm basic ipmievd functionality works
+#
+# exercise syslog event reporting via event injection via ipmitool
+# ----------------------------------------------------------------------------
+
+cmd_name="`basename $0`"		# the name of this command
+
+cmd_err="${cmd_name}: error:"		# the (fatal) error header
+cmd_warn="${cmd_name}: warning:"	# the warning header
+cmd_info="${cmd_name}: info:"		# the informational header
+cmd_query="${cmd_name}: query:"		# the interrogative header
+
+bin_path="/usr/sbin:/usr/lib"	# path(s) to needed binary executable(s)
+proto_root=""			# path to proto root from build
+state_fn="/tmp/$cnd_name.$$.db"	# state file for cleanup
+
+# Design_Note: typically it takes about 4 seconds for an event to be syslogged,
+#              let's allow at least 12 seconds for it to be syslogged.
+
+SYSLOG_DELAY_SEC=12	# max wait in sec for event to be syslogged
+
+# ----------------------------------------------------------------------------
+
+usage()
+{
+    echo "usage: $cmd_name [-r <proto_root>]"
+    echo "       -r  path to proto root of recent build of tool+daemon"
+    echo "purpose: confirm basic ipmievd functionality works;"
+    echo "         this is NOT a comprehensive test"
+    echo "examples:"
+    echo "	$cmd_name -r \$CODEMGR_WS/proto/root_\`uname -p\`"
+    echo "caveats: installs and leaves installed new tool+daemon on error"
+} # usage()
+
+# ----------------------------------------------------------------------------
+
+show_env()
+{
+    echo "$cmd_info general environment:"
+    date ; id ; uname -a ; pwd ; echo "$PATH"
+    [ -r /etc/release ] && cat /etc/release
+    [ -r /etc/motd ] && grep bfu /etc/motd
+    ipmievd -V
+    ipmitool -V
+} # usage()
+
+# ----------------------------------------------------------------------------
+
+enforce_i386()
+{
+    proctype=`uname -p`
+    [ "$proctype" != "i386" ] && {
+	echo "$cmd_err processor type $proctype != i386"
+	exit 1
+    }
+} # enforce_i386()
+
+# ----------------------------------------------------------------------------
+
+install_proto()
+{
+    [ "$proto_root" = "" ] && {
+	echo "$cmd_info skipping install of unset proto_root" ; return 0
+    }
+    [ ! -r /usr/sbin/ipmitool.orig ] && {
+	cp -p /usr/sbin/ipmitool /usr/sbin/ipmitool.orig
+    }
+    [ ! -r /usr/lib/ipmievd.orig ] && {
+	cp -p /usr/lib/ipmievd /usr/lib/ipmievd.orig
+    }
+
+    # disable/kill ipmievd before overwriting binary
+
+    sstate=`svcs | grep '/ipmievd:' | awk '{print $1}'`
+    echo "ipmievd_svc_state: $sstate" > $state_fn
+    [ "$sstate" = "online" ] && {
+	echo "$cmd_info disabling ipmievd service per proto_root"
+	svcadm disable -ts ipmievd
+    }
+    pkill -x ipmievd	# may or may not have been running as a service
+
+    echo "$cmd_info installing proto_root tool+daemon"
+    cp $proto_root/usr/sbin/ipmitool /usr/sbin/ipmitool
+    cp $proto_root/usr/lib/ipmievd   /usr/lib/ipmievd
+
+} # install_proto()
+
+# ----------------------------------------------------------------------------
+
+uninstall_proto()
+{
+    [ "$proto_root" = "" ] && {
+	echo "$cmd_info skipping uninstall of unset proto_root" ; return 0
+    }
+
+    # disable/kill ipmievd before overwriting binary
+
+    sstate=`svcs | grep '/ipmievd:' | awk '{print $1}'`
+    [ "$sstate" = "online" ] && {
+	echo "$cmd_info disabling ipmievd service per proto_root"
+	svcadm disable -ts ipmievd
+    }
+    pkill -x ipmievd	# may or may not have been running as a service
+
+    echo "$cmd_info uninstalling proto_root tool+daemon"
+    [ -r /usr/sbin/ipmitool.orig ] && {
+	cp -p /usr/sbin/ipmitool.orig /usr/sbin/ipmitool
+    }
+    [ -r /usr/lib/ipmievd.orig ] && {
+	cp -p /usr/lib/ipmievd.orig /usr/lib/ipmievd
+    }
+
+    # restore initial state of ipmievd svc if known
+
+    [ ! -r $state_fn ] && return 0
+
+    was_online=`grep -c "ipmievd_svc_state.*online" $state_fn`
+    [ $was_online -ne 0 ] && {
+	echo "$cmd_info enabling ipmievd service per initial state"
+	svcadm enable -s ipmievd
+    }
+} # uninstall_proto()
+
+# ----------------------------------------------------------------------------
+
+test_opt_version()
+{
+    tnm="version option"
+    ipmievd -V > ipmievd_V.out
+    rc=$?
+    [ $rc -ne 0 ] && {
+	echo "$cmd_err $tnm failed with exit code $rc" ; exit $rc
+    }
+    cnt=`grep -i -c 'version.*[0-9][0-9]*\.[0-9]' ipmievd_V.out`
+    [ $cnt -le 0 ] && {
+	echo "$cmd_err $tnm output missing version" ; exit 1
+    }
+    echo "$cmd_info $tnm passed"
+} # test_opt_version()
+
+# ----------------------------------------------------------------------------
+
+test_opt_help()
+{
+    tnm="help option"
+    ipmievd -h > ipmievd_h.out 2>&1
+    rc=$?
+    [ $rc -ne 0 ] && {
+	echo "$cmd_err $tnm failed with exit code $rc" ; exit $rc
+    }
+    cnt=`grep -i 'interface' ipmievd_h.out | grep -i -c 'bmc'`
+    [ $cnt -le 0 ] && {
+	echo "$cmd_err $tnm output missing bmc interface" ; exit 1
+    }
+    echo "$cmd_info $tnm passed"
+} # test_opt_help()
+
+# ----------------------------------------------------------------------------
+
+test_svc_online()
+{
+    tnm="service online check"
+    sstate=`svcs | grep '/ipmievd:' | awk '{print $1}'`
+    [ "$sstate" = "online" ] && {
+	echo "$cmd_info disabling ipmievd service"
+	svcadm disable -ts ipmievd
+    }
+
+    echo "$cmd_info enabling ipmievd service"
+    svcadm enable -ts ipmievd
+    sstate=`svcs | grep '/ipmievd:' | awk '{print $1}'`
+    [ "$sstate" != "online" ] && {
+	echo "$cmd_err $tnm ipmievd service state $sstate != online" ; exit 1
+    }
+    echo "$cmd_info $tnm passed"
+} # test_svc_online()
+
+# ----------------------------------------------------------------------------
+
+test_syslog_init()
+{
+    tnm="syslog initial entries"
+    # Reading|Waiting events below are generated by bringing svc online;
+    # wait some for them to be syslogged.
+    echo "$cmd_info may wait $SYSLOG_DELAY_SEC sec per expected syslog entry"
+    sleep $SYSLOG_DELAY_SEC
+    cnt1=`grep -i -c 'ipmievd.*Reading' /var/adm/messages`
+    cnt2=`grep -i -c 'ipmievd.*Waiting' /var/adm/messages`
+    grep ipmievd /var/adm/messages > ipmievd.syslog_init.out
+    [ $cnt1 -lt 1 ] || [ $cnt2 -lt 1 ] && {
+	echo "$cmd_err $tnm ipmievd too few initial syslog entries" ; exit 1
+    }
+    echo "$cmd_info $tnm passed"
+} # test_syslog_init()
+
+# ----------------------------------------------------------------------------
+
+test_syslog_event()
+{
+    num="$1"	# event number being tested
+
+    tnm="syslog event $num entry"
+    now=`date | awk '{print $2 " " $3}'`
+    cnt1=`grep -i -c "$now.*ipmievd" /var/adm/messages`
+    ipmitool event $num > ipmitool.syslog_event_$num.out
+    rc=$?
+    [ $rc -ne 0 ] && {
+	echo "$cmd_warn $tnm ipmitool exit code $rc"
+    }
+    sleep $SYSLOG_DELAY_SEC
+    cnt2=`grep -i -c "$now.*ipmievd" /var/adm/messages`
+    cnt3=`expr $cnt1 + 1` # expected val
+    [ $cnt2 -lt $cnt3 ] && {
+	echo "$cmd_err $tnm not syslogged in $SYSLOG_DELAY_SEC sec" ; exit 1
+    }
+    [ $cnt2 -gt $cnt3 ] && {
+	echo "$cmd_warn $tnm more syslog entries seen than expected"
+    }
+    echo "$cmd_info $tnm passed"
+} # test_syslog_event()
+
+# ----------------------------------------------------------------------------
+
+# main()
+
+while getopts r: opt; do # {
+    case $opt in
+	r)  proto_root="$OPTARG";;
+	-)  break;;
+	\?) echo "$cmd_err bad option(s)" ; usage ; exit 22;;
+    esac
+done # } while grabbing cmd line args
+
+shift `expr $OPTIND - 1`
+
+too_much="$1"
+[ "$too_much" != "" ] && {
+    echo "$cmd_err too few/many args" ; usage ; exit 7
+}
+[ "$proto_root" != "" ] && [ ! -d $proto_root ] && {
+    echo "$cmd_err proto_root $proto_root not a dir" ; usage ; exit 20
+}
+
+PATH="${bin_path}:$PATH"
+export PATH
+
+# ----------------------------------------------------------------------------
+
+enforce_i386
+install_proto
+show_env
+
+test_opt_version
+test_opt_help
+test_svc_online
+test_syslog_init
+# Design_Note: not all platforms appear to support event 3 (ECC);
+#              so skip it and just do events 1 and 2.
+for n in 1 2; do
+    test_syslog_event $n
+done
+
+uninstall_proto
+
+echo "$cmd_info all tests passed"	# if reach here then aok
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/components/ipmitool/test_ipmitool	Wed May 25 22:38:48 2011 -0700
@@ -0,0 +1,413 @@
+#!/bin/sh
+
+# CDDL HEADER START
+#
+# The contents of this file are subject to the terms of the
+# Common Development and Distribution License (the "License").
+# You may not use this file except in compliance with the License.
+#
+# You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
+# or http://www.opensolaris.org/os/licensing.
+# See the License for the specific language governing permissions
+# and limitations under the License.
+#
+# When distributing Covered Code, include this CDDL HEADER in each
+# file and include the License file at usr/src/OPENSOLARIS.LICENSE.
+# If applicable, add the following below this CDDL HEADER, with the
+# fields enclosed by brackets "[]" replaced with your own identifying
+# information: Portions Copyright [yyyy] [name of copyright owner]
+#
+# CDDL HEADER END
+#
+# Copyright (c) 2008, 2011, Oracle and/or its affiliates. All rights reserved.
+#
+
+# ----------------------------------------------------------------------------
+# test_ipmitool		confirm basic ipmitool functionality works
+#
+# exercise a commonly used subset of all ipmitool commands,
+# for each such command:
+#	save its output to a *.out file
+#	confirm ipmitool exit status is 0 (good)
+#	confirm *.out contains some piece of expected data
+# ----------------------------------------------------------------------------
+
+cmd_name="`basename $0`"		# the name of this command
+
+cmd_err="${cmd_name}: error:"		# the (fatal) error header
+cmd_warn="${cmd_name}: warning:"	# the warning header
+cmd_info="${cmd_name}: info:"		# the informational header
+cmd_query="${cmd_name}: query:"		# the interrogative header
+
+bin_path="/usr/sbin"	# path(s) to ipmitool binary executable(s)
+
+# ----------------------------------------------------------------------------
+
+usage()
+{
+    echo "usage: $cmd_name [-p <bin_path>]"
+    echo "       -p  path to ipmitool binary"
+    echo "purpose: confirm basic ipmitool functionality works;"
+    echo "         this is NOT a comprehensive test"
+    echo "examples:"
+    echo "	$cmd_name -p \$CODEMGR_WS/proto/root_\`uname -p\`/usr/sbin"
+} # usage()
+
+# ----------------------------------------------------------------------------
+
+show_env()
+{
+    echo "$cmd_info general environment:"
+    date ; id ; uname -a ; pwd ; echo "$PATH"
+    [ -r /etc/release ] && cat /etc/release
+    [ -r /etc/motd ] && grep bfu /etc/motd
+    ipmitool -V
+} # show_env()
+
+# ----------------------------------------------------------------------------
+
+enforce_i386()
+{
+    proctype=`uname -p`
+    [ "$proctype" != "i386" ] && {
+	echo "$cmd_err processor type $proctype != i386"
+	echo "$cmd_info future versions of this test tool may use"
+	echo "    ipmitool -I lan -H <i386_host>"
+	echo "when run on $proctype but that is a future enhancement (TBD)"
+	exit 1
+    }
+} # enforce_i386()
+
+# ----------------------------------------------------------------------------
+
+test_opt_version()
+{
+    tnm="version option"
+    ipmitool -V > ipmitool_V.out
+    rc=$?
+    [ $rc -ne 0 ] && {
+	echo "$cmd_err $tnm failed with exit code $rc" ; exit $rc
+    }
+    cnt=`grep -i -c 'version.*[0-9][0-9]*\.[0-9]' ipmitool_V.out`
+    [ $cnt -le 0 ] && {
+	echo "$cmd_err $tnm output missing version" ; exit 1
+    }
+    echo "$cmd_info $tnm passed"
+} # test_opt_version()
+
+# ----------------------------------------------------------------------------
+
+test_cmd_help()
+{
+    tnm="help command"
+    ipmitool help > ipmitool_help.out 2>&1
+    rc=$?
+    [ $rc -ne 0 ] && {
+	echo "$cmd_err $tnm failed with exit code $rc" ; exit $rc
+    }
+    cnt=`grep -i -c 'chassis.*status' ipmitool_help.out`
+    [ $cnt -le 0 ] && {
+	echo "$cmd_err $tnm output missing chassis" ; exit 1
+    }
+    echo "$cmd_info $tnm passed"
+} # test_cmd_help()
+
+# ----------------------------------------------------------------------------
+
+test_cmd_bmc()
+{
+    tnm="bmc info command"
+    ipmitool bmc info > ipmitool_bmc_info.out
+    rc=$?
+    [ $rc -ne 0 ] && {
+	echo "$cmd_err $tnm failed with exit code $rc" ; exit $rc
+    }
+    cnt=`grep -c 'IPMI Version' ipmitool_bmc_info.out`
+    [ $cnt -lt 1 ] && {
+	echo "$cmd_err $tnm output missing IPMI Version" ; exit 1
+    }
+    echo "$cmd_info $tnm passed"
+    tnm="bmc getenables command"
+    ipmitool bmc getenables > ipmitool_bmc_getenables.out
+    rc=$?
+    [ $rc -ne 0 ] && {
+	echo "$cmd_err $tnm failed with exit code $rc" ; exit $rc
+    }
+    cnt=`grep -c 'OEM' ipmitool_bmc_getenables.out`
+    [ $cnt -lt 3 ] && {
+	echo "$cmd_err $tnm output too few OEM" ; exit 1
+    }
+    echo "$cmd_info $tnm passed"
+} # test_cmd_bmc()
+
+# ----------------------------------------------------------------------------
+
+test_cmd_sel()
+{
+    tnm="sel info command"
+    ipmitool sel info > ipmitool_sel_info.out
+    rc=$?
+    [ $rc -ne 0 ] && {
+	echo "$cmd_err $tnm failed with exit code $rc" ; exit $rc
+    }
+    cnt=`egrep -c 'Version|Entries' ipmitool_sel_info.out`
+    [ $cnt -lt 2 ] && {
+	echo "$cmd_err $tnm output missing Version or Entries" ; exit 1
+    }
+    echo "$cmd_info $tnm passed"
+    tnm="sel time get command"
+    ipmitool sel time get > ipmitool_sel_time_get.out
+    rc=$?
+    [ $rc -ne 0 ] && {
+	echo "$cmd_err $tnm failed with exit code $rc" ; exit $rc
+    }
+    nowyr=`date '+%Y'`
+    cnt=`grep -c "$nowyr" ipmitool_sel_time_get.out`
+    [ $cnt -lt 1 ] && {
+	echo "$cmd_err $tnm missing $nowyr" ; exit 1
+    }
+    echo "$cmd_info $tnm passed"
+    tnm="sel list command"
+    cnt=`grep 'Entries' ipmitool_sel_info.out | awk '{print $NF}'`
+    [ $cnt -eq 0 ] && {
+	echo "$cmd_info $tnm passed" ; return 0
+    }
+    ipmitool sel list $cnt > ipmitool_sel_list.out
+    rc=$?
+    [ $rc -ne 0 ] && {
+	echo "$cmd_err $tnm failed with exit code $rc" ; exit $rc
+    }
+    cnt2=`wc ipmitool_sel_list.out | awk '{print $1}'`
+    [ $cnt2 -ne $cnt ] && {
+	echo "$cmd_err $tnm output lines $cnt2 != $cnt" ; exit 1
+    }
+    echo "$cmd_info $tnm passed"
+} # test_cmd_sel()
+
+# ----------------------------------------------------------------------------
+
+test_cmd_chassis()
+{
+    tnm="chassis status command"
+    ipmitool chassis status > ipmitool_chassis_status.out
+    rc=$?
+    [ $rc -ne 0 ] && {
+	echo "$cmd_err $tnm failed with exit code $rc" ; exit $rc
+    }
+    cnt=`grep -c 'System Power' ipmitool_chassis_status.out`
+    [ $cnt -eq 0 ] && {
+	echo "$cmd_err $tnm output missing System Power" ; exit 1
+    }
+    echo "$cmd_info $tnm passed"
+} # test_cmd_chassis()
+
+# ----------------------------------------------------------------------------
+
+test_cmd_fru()
+{
+    tnm="fru print command"
+    ipmitool fru print > ipmitool_fru_print.out
+    rc=$?
+    [ $rc -ne 0 ] && {
+	echo "$cmd_err $tnm failed with exit code $rc" ; exit $rc
+    }
+    cnt=`grep -i -c 'Manufacturer.*Sun Microsystems' ipmitool_fru_print.out`
+    [ $cnt -lt 1 ] && {
+	echo "$cmd_err $tnm output too few Sun Microsystems" ; exit 1
+    }
+    echo "$cmd_info $tnm passed"
+} # test_cmd_fru()
+
+# ----------------------------------------------------------------------------
+
+test_cmd_lan()
+{
+    tnm="lan print command"
+    ipmitool lan print > ipmitool_lan_print.out
+    rc=$?
+    [ $rc -ne 0 ] && {
+	echo "$cmd_err $tnm failed with exit code $rc" ; exit $rc
+    }
+    cnt=`egrep -c 'ARP|MAC|IP' ipmitool_lan_print.out`
+    [ $cnt -lt 3 ] && {
+	echo "$cmd_err $tnm output too few ARP|MAC|IP" ; exit 1
+    }
+    echo "$cmd_info $tnm passed"
+    tnm="lan alert print command"
+    ipmitool lan alert print > ipmitool_lan_alert_print.out
+    rc=$?
+    [ $rc -ne 0 ] && {
+	echo "$cmd_err $tnm failed with exit code $rc" ; exit $rc
+    }
+    cnt=`grep -c 'Destination' ipmitool_lan_alert_print.out`
+    [ $cnt -lt 1 ] && {
+	echo "$cmd_err $tnm output missing Destination" ; exit 1
+    }
+    echo "$cmd_info $tnm passed"
+} # test_cmd_lan()
+
+# ----------------------------------------------------------------------------
+
+test_cmd_channel()
+{
+    tnm="channel info command"
+    ipmitool channel info > ipmitool_channel_info.out
+    rc=$?
+    [ $rc -ne 0 ] && {
+	echo "$cmd_err $tnm failed with exit code $rc" ; exit $rc
+    }
+    cnt=`grep -i -c 'Channel 0x.*info' ipmitool_channel_info.out`
+    [ $cnt -lt 1 ] && {
+	echo "$cmd_err $tnm output missing Channel number" ; exit 1
+    }
+    echo "$cmd_info $tnm passed"
+} # test_cmd_channel()
+
+# ----------------------------------------------------------------------------
+
+test_cmd_sensor()
+{
+    tnm="sensor list command"
+    ipmitool sensor list > ipmitool_sensor_list.out
+    rc=$?
+    [ $rc -ne 0 ] && {
+	echo "$cmd_err $tnm failed with exit code $rc" ; exit $rc
+    }
+    cnt=`egrep -i -c 'degrees|RPM|volts' ipmitool_sensor_list.out`
+    [ $cnt -lt 10 ] && {
+	echo "$cmd_err $tnm output too few degrees|RPM|volts" ; exit 1
+    }
+    echo "$cmd_info $tnm passed"
+    tnm="sensor get command"
+    cnt=`expr $cnt % 10`
+    # note: sensor names might have whitespace in them
+    snm=`egrep -i 'degrees|RPM|volts' ipmitool_sensor_list.out | \
+	head -$cnt | tail -1 | cut -d'|' -f1`
+    snm=`echo $snm`	# drop any leading or trailing whitespace
+    ipmitool sensor get "$snm" > ipmitool_sensor_get.out
+    rc=$?
+    [ $rc -ne 0 ] && {
+	echo "$cmd_err $tnm failed with exit code $rc" ; exit $rc
+    }
+    cnt=`egrep -i 'degrees|RPM|volts' ipmitool_sensor_get.out | \
+	grep -c 'Sensor Reading'`
+    [ $cnt -ne 1 ] && {
+	echo "$cmd_err $tnm wrong Sensor Reading for $snm" ; exit 1
+    }
+    echo "$cmd_info $tnm passed"
+} # test_cmd_sensor()
+
+# ----------------------------------------------------------------------------
+
+test_cmd_sdr()
+{
+    tnm="sdr list command"
+    ipmitool sdr list all > ipmitool_sdr_list_all.out
+    rc=$?
+    [ $rc -ne 0 ] && {
+	echo "$cmd_err $tnm failed with exit code $rc" ; exit $rc
+    }
+    cnt=`egrep -i -c 'degrees|RPM|volts' ipmitool_sdr_list_all.out`
+    [ $cnt -lt 10 ] && {
+	echo "$cmd_err $tnm output too few degrees|RPM|volts" ; exit 1
+    }
+    echo "$cmd_info $tnm passed"
+    tnm="sdr get command"
+    cnt=`expr $cnt / 2`
+    # note: sensor names might have whitespace in them
+    snm=`egrep -i 'degrees|RPM|volts' ipmitool_sdr_list_all.out | \
+	head -$cnt | tail -1 | cut -d'|' -f1`
+    snm=`echo $snm`	# drop any leading or trailing whitespace
+    ipmitool sdr get "$snm" > ipmitool_sdr_get.out
+    rc=$?
+    [ $rc -ne 0 ] && {
+	echo "$cmd_err $tnm failed with exit code $rc" ; exit $rc
+    }
+    cnt=`egrep -i 'degrees|RPM|volts' ipmitool_sdr_get.out | \
+	grep -c 'Sensor Reading'`
+    [ $cnt -ne 1 ] && {
+	echo "$cmd_err $tnm wrong Sensor Reading for $snm" ; exit 1
+    }
+    echo "$cmd_info $tnm passed"
+} # test_cmd_sdr()
+
+# ----------------------------------------------------------------------------
+
+test_cmd_power()
+{
+    tnm="power status command"
+    ipmitool power status > ipmitool_power_status.out
+    rc=$?
+    [ $rc -ne 0 ] && {
+	echo "$cmd_err $tnm failed with exit code $rc" ; exit $rc
+    }
+    cnt=`grep -i -c 'power.*on' ipmitool_power_status.out`
+    [ $cnt -lt 1 ] && {
+	echo "$cmd_err $tnm output missing power on" ; exit 1
+    }
+    echo "$cmd_info $tnm passed"
+} # test_cmd_power()
+
+# ----------------------------------------------------------------------------
+
+test_cmd_echo()
+{
+    tnm="echo command"
+    ipmitool echo "hello world from pid $$" > ipmitool_echo.out
+    rc=$?
+    [ $rc -ne 0 ] && {
+	echo "$cmd_err $tnm failed with exit code $rc" ; exit $rc
+    }
+    cnt=`grep -c "pid $$" ipmitool_echo.out`
+    [ $cnt -ne 1 ] && {
+	echo "$cmd_err $tnm output missing my pid" ; exit 1
+    }
+    echo "$cmd_info $tnm passed"
+} # test_cmd_echo()
+
+# ----------------------------------------------------------------------------
+
+# main()
+
+while getopts p: opt; do # {
+    case $opt in
+	p)  bin_path="$OPTARG";;
+	-)  break;;
+	\?) echo "$cmd_err bad option(s)" ; usage ; exit 22;;
+    esac
+done # } while grabbing cmd line args
+
+shift `expr $OPTIND - 1`
+
+too_much="$1"
+[ "$too_much" != "" ] && {
+    echo "$cmd_err too few/many args" ; usage ; exit 7
+}
+
+PATH="${bin_path}:$PATH"
+export PATH
+
+# ----------------------------------------------------------------------------
+
+enforce_i386
+show_env
+
+# version 1.8.8 and later
+
+test_opt_version
+test_cmd_help
+test_cmd_bmc
+test_cmd_sel
+test_cmd_chassis
+test_cmd_fru
+test_cmd_lan
+test_cmd_channel
+test_cmd_sensor
+test_cmd_sdr
+
+# version 1.8.10 and later
+
+test_cmd_power
+test_cmd_echo
+
+echo "$cmd_info all tests passed"	# if reach here then aok
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/components/meta-packages/history/SUNWipmi.p5m	Wed May 25 22:38:48 2011 -0700
@@ -0,0 +1,29 @@
+#
+# CDDL HEADER START
+#
+# The contents of this file are subject to the terms of the
+# Common Development and Distribution License (the "License").
+# You may not use this file except in compliance with the License.
+#
+# You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
+# or http://www.opensolaris.org/os/licensing.
+# See the License for the specific language governing permissions
+# and limitations under the License.
+#
+# When distributing Covered Code, include this CDDL HEADER in each
+# file and include the License file at usr/src/OPENSOLARIS.LICENSE.
+# If applicable, add the following below this CDDL HEADER, with the
+# fields enclosed by brackets "[]" replaced with your own identifying
+# information: Portions Copyright [yyyy] [name of copyright owner]
+#
+# CDDL HEADER END
+#
+# Copyright (c) 2011, Oracle and/or its affiliates. All rights reserved.
+#
+
+set name=pkg.fmri value=pkg:/[email protected],5.11-0.133
+set name=pkg.renamed value=true
+
+set name=org.opensolaris.consolidation value=$(CONSOLIDATION)
+
+depend fmri=system/ipmi/[email protected] type=require
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/components/meta-packages/history/system%2Fipmi%2Fipmitool.p5m	Wed May 25 22:38:48 2011 -0700
@@ -0,0 +1,29 @@
+#
+# CDDL HEADER START
+#
+# The contents of this file are subject to the terms of the
+# Common Development and Distribution License (the "License").
+# You may not use this file except in compliance with the License.
+#
+# You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
+# or http://www.opensolaris.org/os/licensing.
+# See the License for the specific language governing permissions
+# and limitations under the License.
+#
+# When distributing Covered Code, include this CDDL HEADER in each
+# file and include the License file at usr/src/OPENSOLARIS.LICENSE.
+# If applicable, add the following below this CDDL HEADER, with the
+# fields enclosed by brackets "[]" replaced with your own identifying
+# information: Portions Copyright [yyyy] [name of copyright owner]
+#
+# CDDL HEADER END
+#
+# Copyright (c) 2011, Oracle and/or its affiliates. All rights reserved.
+#
+
+set name=pkg.fmri value=pkg:/system/ipmi/[email protected],5.11-0.151.0.1
+set name=pkg.renamed value=true
+
+set name=org.opensolaris.consolidation value=$(CONSOLIDATION)
+
+depend fmri=system/management/[email protected] type=require