Provided by: ipmitool_1.8.19-7build2_amd64 bug

NAME

       ipmievd - IPMI event daemon for sending events to syslog

SYNOPSIS

       ipmievd [-c|-h|-d N|-v|-V] -I open <open | sel> [<option>]

       ipmievd [-c|-h|-v|-V] -I lan -H <hostname>
               [-p <port>]
               [-U <username>]
               [-A <authtype>]
               [-L <privlvl>]
               [-a|-E|-P|-f <password>]
               [-o <oemtype>]
               [-O <sel oem>]
               sel [<option>]

       ipmievd [-c|-h|-v|-V] -I lanplus -H <hostname>
               [-p <port>]
               [-U <username>]
               [-L <privlvl>]
               [-a|-E|-P|-f <password>]
               [-o <oemtype>]
               [-O <sel oem>]
               [-C <ciphersuite>]
               sel [<option>]

DESCRIPTION

       ipmievd  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 LOG_LOCAL4 facility.

       It is based on the ipmitool utility and shares the same IPMI interface support and session
       setup options.  Please see the ipmitool manpage for more  information  on  supported  IPMI
       interfaces.

OPTIONS

       -a     Prompt for the remote server password.

       -A <authtype>
              Specify  an  authentication  type  to  use  during IPMIv1.5 lan session activation.
              Supported types are NONE, PASSWORD, MD2, MD5, or OEM.

       -c     Present output in CSV (comma separated variable) format.   This  is  not  available
              with all commands.

       -C <ciphersuite>
              The  remote  server authentication, integrity, and encryption algorithms to use for
              IPMIv2 lanplus 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 algorithms.

       -E     The remote server password is specified by the environment variable IPMI_PASSWORD.

       -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.

       -h     Get basic usage help from the command line.

       -H <address>
              Remote  server address, can be IP address or hostname.  This option is required for
              lan and lanplus interfaces.

       -I <interface>
              Selects IPMI interface to use.  Supported  interfaces  that  are  compiled  in  are
              visible in the usage help output.

       -L <privlvl>
              Force  session privilege level.  Can be CALLBACK, USER, OPERATOR, ADMIN. Default is
              ADMIN.

       -m <local_address>
              Set the local IPMB address.  The default is 0x20 and there should  be  no  need  to
              change it for normal operation.

       -o <oemtype>
              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 -o  list  to
              see a list of current supported OEM types.

       -O <sel oem>
              Open  selected  file  and  read  OEM  SEL  event descriptions to be used during SEL
              listings.  See examples in contrib dir for file format.

       -p <port>
              Remote server UDP port to connect to.  Default is 623.

       -P <password>
              Remote server password is specified on the command line.  If supported it  will  be
              obscured  in  the  process  list.   Note! Specifying the password as a command line
              option is not recommended.

       -S <sdr_cache_file>
              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.

       -t <target_address>
              Bridge IPMI requests to the remote target address.

       -U <username>
              Remote server username, default is NULL user.

       -d N   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.

       -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.

       -V     Display version information.

       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.

COMMANDS

       help   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
              Commands:
                  open    Use OpenIPMI for asynchronous notification of events
                  sel     Poll SEL for notification of events

       open   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
              open interface.  See the ipmitool manpage and  associated  documentation  for  more
              information on setting up the OpenIPMI driver.

              Note:  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 sel method.

              daemon Launch  process as a daemon and reparent to init process.  All messages will
                     be sent to syslog.  This is the default action.

              nodaemon
                     Do NOT become a daemon, instead log all messages to stderr.

              pidfile=<filename>
                     Save  process  ID  to  this  file  when  in  daemon   mode.    Defaults   to
                     /run/ipmievd.pidN (where N is the ipmi device number -- defaults to 0).

       sel    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.

              daemon Launch process as a daemon and reparent to init process.  All messages  will
                     be sent to syslog.  This is the default action.

              nodaemon
                     Do NOT become a daemon, instead log all messages to stderr.

              pidfile=<filename>
                     Save   process   ID   to  this  file  when  in  daemon  mode.   Defaults  to
                     /run/ipmievd.pidN (where N is the ipmi device number -- defaults to 0).

              timeout=<seconds>
                     Time between checks for SEL polling method.  Default is 10 seconds.

EXAMPLES

       Example 1: Daemon process watching OpenIPMI for events

              > ipmievd -I open open daemon

       Example 2: Local non-daemon process checking remote SEL every 30 seconds

              > ipmievd -I lan -H 1.2.3.4 -f passfile sel nodaemon timeout=30
              Reading Sensors...
              Waiting for Events...

FILES

       /usr/share/misc/enterprise-numbers.txt
              system IANA PEN registry  taken  from  https://www.iana.org/assignments/enterprise-
              numbers.txt

       ~/.local/usr/share/misc/enterprise-numbers.txt
              user's  override for the system IANA PEN registry, this file if it exists is loaded
              instead of the system registry (see above).

AUTHOR

       Duncan Laurie <duncan@iceblink.org>

SEE ALSO

       IPMItool Homepage
              http://ipmitool.sourceforge.net

       Intelligent Platform Management Interface Specification
              http://www.intel.com/design/servers/ipmi

       OpenIPMI Homepage
              http://openipmi.sourceforge.net