Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
ipmievd(8)							    ipmievd(8)

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 ses-
	      sion 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  al-
	      gorithms 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 algorightms.

       -E     The remote server	password is specified by the environment vari-
	      able 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 op-
	      tion 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!	Speci-
	      fying 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 asyncronous 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 docu-
	      mentation	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 ac-
	      tually 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.  De-
		     faults to /var/run/ipmievd.pidN (where N is the ipmi  de-
		     vice 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	 moni-
	      tor 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.   De-
		     faults  to	/var/run/ipmievd.pidN (where N is the ipmi de-
		     vice 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 sec-
       onds

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

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)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | COMMANDS | EXAMPLES | AUTHOR | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=ipmievd&sektion=8&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help