summaryrefslogtreecommitdiff
path: root/doc/ipmievd.8
diff options
context:
space:
mode:
Diffstat (limited to 'doc/ipmievd.8')
-rw-r--r--doc/ipmievd.8231
1 files changed, 231 insertions, 0 deletions
diff --git a/doc/ipmievd.8 b/doc/ipmievd.8
new file mode 100644
index 0000000..a39dce0
--- /dev/null
+++ b/doc/ipmievd.8
@@ -0,0 +1,231 @@
+.TH "ipmievd" "8" "" "Duncan Laurie" ""
+.SH "NAME"
+ipmievd \- IPMI event daemon for sending events to syslog
+.SH "SYNOPSIS"
+ipmievd [\fB\-c\fR|\fB\-h\fR|\fB\-d \fIN\fP\fR|\fB\-v\fR|\fB\-V\fR]
+\fB\-I\fR \fIopen\fP <\fIopen\fR | \fIsel\fR> [<\fIoption\fP>]
+
+ipmievd [\fB\-c\fR|\fB\-h\fR|\fB\-v\fR|\fB\-V\fR]
+\fB\-I\fR \fIlan\fP \fB\-H\fR <\fIhostname\fP>
+ [\fB\-p\fR <\fIport\fP>]
+ [\fB\-U\fR <\fIusername\fP>]
+ [\fB\-A\fR <\fIauthtype\fP>]
+ [\fB\-L\fR <\fIprivlvl\fP>]
+ [\fB\-a\fR|\fB\-E\fR|\fB\-P\fR|\fB\-f\fR <\fIpassword\fP>]
+ [\fB\-o\fR <\fIoemtype\fP>]
+ [\fB\-O\fR <\fIsel oem\fP>]
+ \fIsel\fP [<\fIoption\fP>]
+
+ipmievd [\fB\-c\fR|\fB\-h\fR|\fB\-v\fR|\fB\-V\fR]
+\fB\-I\fR \fIlanplus\fP \fB\-H\fR <\fIhostname\fP>
+ [\fB\-p\fR <\fIport\fP>]
+ [\fB\-U\fR <\fIusername\fP>]
+ [\fB\-L\fR <\fIprivlvl\fP>]
+ [\fB\-a\fR|\fB\-E\fR|\fB\-P\fR|\fB\-f\fR <\fIpassword\fP>]
+ [\fB\-o\fR <\fIoemtype\fP>]
+ [\fB\-O\fR <\fIsel oem\fP>]
+ [\fB\-C\fR <\fIciphersuite\fP>]
+ \fIsel\fR [<\fIoption\fP>]
+.SH "DESCRIPTION"
+\fBipmievd\fP is a daemon which will listen for events from the
+BMC that are being sent to the SEL and also log those messages to
+syslog. It is able to run in one of two modes: either using the
+Event Message Buffer and asynchronous event notification from the
+OpenIPMI kernel driver or actively polling the contents of the
+SEL for new events. Upon receipt of an event via either mechanism
+it will be logged to syslog with the \fILOG_LOCAL4\fP facility.
+
+It is based on the \fBipmitool\fR utility and shares the same IPMI
+interface support and session setup options. Please see the
+\fBipmitool\fR manpage for more information on supported IPMI
+interfaces.
+.SH "OPTIONS"
+.TP
+\fB\-a\fR
+Prompt for the remote server password.
+.TP
+\fB\-A\fR <\fIauthtype\fP>
+Specify an authentication type to use during IPMIv1.5 \fIlan\fP
+session activation. Supported types are NONE, PASSWORD, MD2, MD5, or OEM.
+.TP
+\fB\-c\fR
+Present output in CSV (comma separated variable) format.
+This is not available with all commands.
+.TP
+\fB\-C\fR <\fIciphersuite\fP>
+The remote server authentication, integrity, and encryption algorithms
+to use for IPMIv2 \fIlanplus\fP connections. See table 22\-19 in the
+IPMIv2 specification. The default is 3 which specifies RAKP\-HMAC\-SHA1
+authentication, HMAC\-SHA1\-96 integrity, and AES\-CBC\-128 encryption algorightms.
+.TP
+\fB\-E\fR
+The remote server password is specified by the environment
+variable \fIIPMI_PASSWORD\fP.
+.TP
+\fB\-f\fR <\fIpassword_file\fP>
+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.
+.TP
+\fB\-h\fR
+Get basic usage help from the command line.
+.TP
+\fB\-H\fR <\fIaddress\fP>
+Remote server address, can be IP address or hostname. This
+option is required for \fIlan\fP and \fIlanplus\fP interfaces.
+.TP
+\fB\-I\fR <\fIinterface\fP>
+Selects IPMI interface to use. Supported interfaces that are
+compiled in are visible in the usage help output.
+.TP
+\fB\-L\fR <\fIprivlvl\fP>
+Force session privilege level. Can be CALLBACK, USER,
+OPERATOR, ADMIN. Default is ADMIN.
+.TP
+\fB\-m\fR <\fIlocal_address\fP>
+Set the local IPMB address. The default is 0x20 and there
+should be no need to change it for normal operation.
+.TP
+\fB\-o\fR <\fIoemtype\fP>
+Select OEM type to support. This usually involves minor hacks
+in place in the code to work around quirks in various BMCs from
+various manufacturers. Use \fI\-o list\fP to see a list of
+current supported OEM types.
+.TP
+\fB\-O\fR <\fIsel oem\fP>
+Open selected file and read OEM SEL event descriptions to be used
+during SEL listings. See examples in contrib dir for file format.
+.TP
+\fB\-p\fR <\fIport\fP>
+Remote server UDP port to connect to. Default is 623.
+.TP
+\fB\-P\fR <\fIpassword\fP>
+Remote server password is specified on the command line.
+If supported it will be obscured in the process list.
+\fBNote!\fR Specifying the password as a command line
+option is not recommended.
+.TP
+\fB\-S\fR <\fIsdr_cache_file\fP>
+Use local file for remote 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
+\fB\-t\fR <\fItarget_address\fP>
+Bridge IPMI requests to the remote target address.
+.TP
+\fB\-U\fR <\fIusername\fP>
+Remote server username, default is NULL user.
+.TP
+\fB\-d \fIN\fP\fR
+Use device number N to specify the /dev/ipmiN (or
+/dev/ipmi/N or /dev/ipmidev/N) device to use for in-band
+BMC communication. Used to target a specific BMC on a
+multi-node, multi-BMC system through the ipmi device
+driver interface. Default is 0.
+.TP
+\fB\-v\fR
+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
+\fB\-V\fR
+Display version information.
+
+.LP
+If no password method is specified then ipmievd will prompt the
+user for a password. If no password is entered at the prompt,
+the remote server password will default to NULL.
+.SH "COMMANDS"
+.TP
+\fIhelp\fP
+This can be used to get command\-line help. It may also be
+placed at the end of commands to get option usage help.
+
+> ipmievd help
+.br
+Commands:
+ open Use OpenIPMI for asyncronous notification of events
+ sel Poll SEL for notification of events
+
+.TP
+\fIopen\fP
+This command starts ipmievd with the OpenIPMI event watching
+mechanism which relies on the Event Message Buffer feature of
+IPMI. This requires a properly installed and configured
+OpenIPMI driver on Linux and is only valid to be run through
+the \fIopen\fP interface. See the \fBipmitool\fR manpage
+and associated documentation for more information on setting
+up the OpenIPMI driver.
+
+\fBNote\fR: Some BMC do not support the Event Message Buffer
+required for this command. Other BMCs claim to support it but
+do not actually deliver events to it. If this is the case please
+use the \fIsel\fP method.
+
+.RS
+.TP
+\fIdaemon\fP
+Launch process as a daemon and reparent to init process.
+All messages will be sent to syslog. This is the default action.
+.TP
+\fInodaemon\fP
+Do NOT become a daemon, instead log all messages to stderr.
+.TP
+\fIpidfile\fP=<\fBfilename\fR>
+Save process ID to this file when in daemon mode. Defaults to
+/var/run/ipmievd.pid\fIN\fP (where \fIN\fP is the ipmi device
+number -- defaults to 0).
+.RE
+
+.TP
+\fIsel\fP
+This command starts 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
+\fIdaemon\fP
+Launch process as a daemon and reparent to init process.
+All messages will be sent to syslog. This is the default action.
+.TP
+\fInodaemon\fP
+Do NOT become a daemon, instead log all messages to stderr.
+.TP
+\fIpidfile\fP=<\fBfilename\fR>
+Save process ID to this file when in daemon mode. Defaults to
+/var/run/ipmievd.pid\fIN\fP (where \fIN\fP is the ipmi device
+number -- defaults to 0).
+.TP
+\fItimeout\fP=<\fBseconds\fR>
+Time between checks for SEL polling method. Default is 10 seconds.
+.RE
+.SH "EXAMPLES"
+.TP
+\fIExample 1\fP: Daemon process watching OpenIPMI for events
+
+> ipmievd \-I open open daemon
+.TP
+\fIExample 2\fP: 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...
+.br
+.SH "AUTHOR"
+Duncan Laurie <duncan@iceblink.org>
+.SH "SEE ALSO"
+.TP
+IPMItool Homepage
+http://ipmitool.sourceforge.net
+.TP
+Intelligent Platform Management Interface Specification
+http://www.intel.com/design/servers/ipmi
+.TP
+OpenIPMI Homepage
+http://openipmi.sourceforge.net