# ipmievd - IPMI event daemon for sending events to syslog - man(8) - [phpMan]

[_ipmievd_(8)](https://www.chedong.com/phpMan.php/man/ipmievd/8/markdown)                                                                                [_ipmievd_(8)](https://www.chedong.com/phpMan.php/man/ipmievd/8/markdown)

## 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 ei‐
       ther 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 inter‐
       faces.

## OPTIONS
### -a     

### -A 
              Specify  an  authentication  type to use during IPMIv1.5 _lan_ session activation.  Sup‐
              ported types are NONE, PASSWORD, MD2, MD5, or OEM.

### -c     
              all commands.

### -C 
              The  remote server authentication, integrity, and encryption algorithms to use for IP‐
              MIv2 _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     

### -f 
              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     

### -H 
              Remote server address, can be IP address or hostname.  This option is required for _lan_
              and _lanplus_ interfaces.

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

### -L 
              Force session privilege level.  Can be CALLBACK, USER, OPERATOR, ADMIN. Default is AD‐
              MIN.

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

### -o 
              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 
              Open selected file and read OEM SEL event descriptions to be used during SEL listings.
              See examples in contrib dir for file format.

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

### -P 
              Remote  server password is specified on the command line.  If supported it will be ob‐
              scured in the process list.  **Note! **Specifying the password as a command line option is
              not recommended.

### -S 
              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 
              Bridge IPMI requests to the remote target address.

### -U 
              Remote server username, default is NULL user.

### -d _
              vice 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     
              crease the level of debug output.  If given three times you will get hexdumps  of  all
              incoming and outgoing packets.

### -V     


       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  com‐
              mands 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 con‐
              figured  OpenIPMI  driver on Linux and is only valid to be run through the _open_ inter‐
              face.  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/ip‐
                     mievd.pid_N_ (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/ip‐
                     mievd.pid_N_ (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-num>‐
              bers.txt

### ~/.local/usr/share/misc/enterprise-numbers.txt
              user's override for the system IANA PEN registry, this file if it exists is loaded in‐
              stead 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>

Duncan Laurie                                                                             [_ipmievd_(8)](https://www.chedong.com/phpMan.php/man/ipmievd/8/markdown)
