IPMItool

IPMItool is a very simple, easy-to-use, open source and cross-platform command-line software written in the C programming language and designed to act as an interface to systems that support both 1.5 and 2.0 branches of the IPMI (Intelligent Platform Management Interface) specification.

Features at a glance

With IPMItool you will be able to easily read the SDR (Software-defined Radio), display SEL’s contents, print sensor values, print FRU information, perform chassis power control, as well as to read and set LAN (Local Area Network) configuration parameters. Additionally, the software also allows you to use a system interface provided by a kernel device driver (OpenIPMI) by taking advantage of IPMI-over-LAN interfaces.

The following Interfaces are officially supported by IPMItool: LAN, LAN Plus, OpenIPMI, FreeIPMI, IMB, BMC, LIPMI and Serial. A dummy interface is also provided, as well as the ipmievd and ipmishell tools. Support for some of these interfaces is added by default when configuring the project, as others require explicit enablement.

Command-line options

From the command-line interface (CLI), the user will be able to do a lot of tasks using the ipmitool command generated after compilation. It allows you to send RAW IPMI requests, configure LAN channels, run a ATCA or PICMG extended command, configure firmware firewall, print session information, as welll as to lunch an interactive IPMI shell.

Under the hood, availability and supported OSes

The IPMItool project is written entirely in the C programming language and it’s available for download only as a a source archive, which must be configured and compiled prior to installation. Besides GNU/Linux, the software works successfully under FreeBSD, Solaris and Mac OS X operating systems. Both 32-bit and 64-bit architectures are supported at this time. A select number of Linux distributions include the IPMItool program in their default software repositories, so you can install it without the need to compile its sources.

What is new in this release:

• ID: 299 - openipmi plugin writes zero to wrong byte
• ID: 301 - Add OS/Hypervisor installation status events
• ID: 298 - fix LANplus retry
• ID: 295 - inform user if SOL session disconnected
• ID: 297 - don't print-out SEL entry if ID not present
• ID: 296 - Fix PSD size decoding
• ID: 293 - Use of uninitialized variable in ipmi_main()
• ID: 278 - Error in sol looptest
• ID: 290 - ipmi_sol.c needs a clean-up
• ID: 85 - Supermicro memory ECC error display
• ID: 290 - ipmi_sol.c needs a clean-up
• ID: 286 - Open session retries hit assert in ipmi_lanplus_send_payload
• ID: 285 - Fix SEGV in ipmi_lanplus_open_session
• ID: 284 - Fix SEGV in ipmi_main
• ID: 283 - ipmi_intf_socket_connect fails with IPv4 hosts
• ID: 46 - ipmi_fwum needs some re-work
• ID: 50 - ipmi_hpmfwupg needs a clean up
• ID: 279 - ipmitool sdr list broken
• ID: 44 - dummy interface support - fake-ipmistack project
• ID: 48 - Remove hard-coded FRU inventory access length restriction
• ID: 276 - HPM.1 upgrade combined patch
• ID: 90 - Add options to chassis bootparam set bootflag
• ID: 292 -Properly handle plugin non-zero target adddress with -t
• Numerous Fixes based on running Coverity
• Use TIOCFLUSH if TCFLSH is missing to get the serial plugin building on Hurd.
• Disable imb and open plugins by default on Hurd. The platform lack the required kernel support.
• Change serial plugin to only try to disable the IUCLC serial line flag on platforms supporting it. Fixes build problem on Hurd and FreeBSD.
• PA: 83 - Revised IPv6 patch
• FR: 24 - Exchange OS Name Hostname BMC URL during startup
• ID: 304 - Incorect byteswap in SOL maximum payload
• ID: 303 - Fix build error in HPM.2 code
• ID: 300 - new sunoem functionality
• ID: 144 - Fix 'dcmi power set_limit action '
• ID: 302 - HPM.2 long message support
• ID: 309 - Add new SEL entries for ipmi 2.0 rev 1.1
• ID: 280 - man page cleanup
• ID: 311 - man page update for new sunoem commands

What is new in version 1.8.15:

• ID: 299 - openipmi plugin writes zero to wrong byte
• ID: 301 - Add OS/Hypervisor installation status events
• ID: 298 - fix LANplus retry
• ID: 295 - inform user if SOL session disconnected
• ID: 297 - don't print-out SEL entry if ID not present
• ID: 296 - Fix PSD size decoding
• ID: 293 - Use of uninitialized variable in ipmi_main()
• ID: 278 - Error in sol looptest
• ID: 290 - ipmi_sol.c needs a clean-up
• ID: 85 - Supermicro memory ECC error display
• ID: 290 - ipmi_sol.c needs a clean-up
• ID: 286 - Open session retries hit assert in ipmi_lanplus_send_payload
• ID: 285 - Fix SEGV in ipmi_lanplus_open_session
• ID: 284 - Fix SEGV in ipmi_main
• ID: 283 - ipmi_intf_socket_connect fails with IPv4 hosts
• ID: 46 - ipmi_fwum needs some re-work
• ID: 50 - ipmi_hpmfwupg needs a clean up
• ID: 279 - ipmitool sdr list broken
• ID: 44 - dummy interface support - fake-ipmistack project
• ID: 48 - Remove hard-coded FRU inventory access length restriction
• ID: 276 - HPM.1 upgrade combined patch
• ID: 90 - Add options to chassis bootparam set bootflag
• ID: 292 -Properly handle plugin non-zero target adddress with -t
• Numerous Fixes based on running Coverity
• Use TIOCFLUSH if TCFLSH is missing to get the serial plugin building on Hurd.
• Disable imb and open plugins by default on Hurd. The platform lack the required kernel support.
• Change serial plugin to only try to disable the IUCLC serial line flag on platforms supporting it. Fixes build problem on Hurd and FreeBSD.
• PA: 83 - Revised IPv6 patch
• FR: 24 - Exchange OS Name Hostname BMC URL during startup
• ID: 304 - Incorect byteswap in SOL maximum payload
• ID: 303 - Fix build error in HPM.2 code
• ID: 300 - new sunoem functionality
• ID: 144 - Fix 'dcmi power set_limit action '
• ID: 302 - HPM.2 long message support
• ID: 309 - Add new SEL entries for ipmi 2.0 rev 1.1
• ID: 280 - man page cleanup
• ID: 311 - man page update for new sunoem commands

What is new in version 1.8.13:

• ID: 3611905 - Direct Serial Basic/Terminal Mode Interface drivers
• ID: 3577766 - configure's knobs and switches don't work
• ID: 3611253 - do not override OS-default values for interfaces
• ID: 65 - Fixes for configure.in for cross compilation
• ID: 3571153 - OpenIPMI/ipmievd fails to compile on Solaris
• numerous ipmitool man page updates
• ID: 3611226 - Bridging support for PICMG Platforms
• Add support for getsysinfo/setsysinfo commands to ipmi mc
• Cleanup Dell OEM code to use new sysinfo interface
• ID: 93 - str-to-int conversion is weak
• ID: 3582307 - ipmi_fru - ipmi_fru_main() return codes
• ID: 3582310 - ipmi_fru - ipmi_fru_main() - misuse of printf()
• ID: 3576213 - ipmi_fru - unused variable
• ID: 3578276 - ipmi_fru - free() on freed memory possible
• ID: 3578275 - ipmi_fru - memory leaks
• ID: 3528271 - ipmi_fru - possible *flow via FRUID
• ID: 3578277 - ipmi_fru - possible NULL pointer
• ID: 3612372 - Recognize Broadcom IANA number and BCM5725 product
• ID: 3608758 - add IPMI_NETFN_OEM
• ID: 143 - Reversed 'channel authcap' capabilities Fixes reversed IPMIv1.5/2.0 'channel authcap' capabilities
• ID: 3587318 - "dcmi discover" is not DCMI 1.5 compatible
• ID: 3608757 - ipmi_fru - various fixes
• ID: 3598203 - 'mc getsysinfo|setsysinfo' needs a bit of re-work
• ID: 3597782 - ipmi_mc - sysinfo_param() has two consecutive returns
• ID: 3597781 - 'mc getsysinfo|setsysinfo' help has typos
• ID: 3608763 - ipmi_sdr - code cleanup & output display cleanup
• ID: 3610286 - ipmi_sdr - ipmi_sdr_print_type - incorrect eval
• ID: 3600930 - ipmi_sdr - code cleanup
• ID: 3602439 - ipmi_sdr - memory leaks
• ID: 3595199 - ipmi_sdr - Add support for 'ipmitool sdr help'
• ID: 3592773 - 'ipmitool sdr info'; prints incorrect info
• ID: 3592770 - 'ipmitool sdr list|elist INV_INPUT' return code
• ID: 3577159 - ipmi_sdr - uint32_t cast to uint8_t and back
• ID: 3528368 - ipmi_sdr - possible int *flow
• ID: 226 - ipmi_sdradd - typo
• ID: 258 - ipmi_sdradd - error printed on STDOUT
• Fixed ipmievd start under systemd.
• ID: 3608760 - Add bswap.h to ipmi_chassis.c and ipmi_pef.c
• ID: 3564701 - ipmitool 1.8.12 doesn't build on big endian architectures
• ID: 3600907 - defined value for "Chassis may not support Force Identify"
• ID: 256 - ipmitool could crash when IPv6 address is returned
• ID: 211 - 'lib/ipmi_dcmi.c' - typo & error printed on STDOUT
• ID: 3612237 - If DCMI command fails, incorrect completion code is printed
• ID: 3608149 - ipmitool - set pointer to NULL after free()
• ID: 3603419 - DCMI - waste of resources
• ID: 3600908 - DMCI - crash in ipmi_print_sensor_info(), NULL ref
• ID: 3609985 - delloem : Wrong MAC returned when flex addressing is enabled
• ID: 113 - delloem exec file won't handle more than one command
• ID: 28 - delloem - clean up the code
• ID: 3608261 - delloem - code formatting
• ID: 3528247 - delloem - fix possible *int flows
• ID: 3600910 - delloem - code cleanup
• ID: 3576211 - delloem - unused variable
• ID: 3578022 - delloem - fix typos
• ID: 263 - ipmi_ek* - cleanup
• ID: 3308765 - ipmi_ek* - cleanup
• ID: 3586228 - ipmi_ek* - ipmi_ekanalyzer_usage() rework
• ID: 3528388 - ipmi_ek* - a typo in error message
• ID: 3576212 - ipmi_event - better rsp handling
• ID: 3607393 - ipmi_event - redundant '\n' in error message
• ID: 153 - ipmi_firewall - printf() used instead of lprintf()
• ID: 3608003 - ipmi_fru - atol() should be replaced with str2*()
• ID: 3600911 - ipmi_fru - fix multiple increments in args to printf
• ID: 3600914 - no more crash on no response. allow more send/recv loops of waiting.
• ID: 70 - Fixes and updates for ipmitool hpm
• ID: 3528308 - ipmi_hpmfwupg - possible int *flow
• ID: 3608762 - ipmi_hpmfwup - Fixed help messages for hpm command
• ID: 3607981 - ipmi_lanp - replace atoi() calls
• ID: 3607320 - ipmi_lanp - possible NULL reference
• ID: 3600926 - ipmi_lanp - code cleanup
• ID: 3613575 - memory leak - ipmi_password_file_read()
• ID: 3522740 - reading password from file is limited to 16byte passwords
• ID: 3613605 - ipmi_main - call free() on pointer to static data
• ID: 3608761 - ipmi_main - PICMG Get Device Locator was never run
• ID: 3577155 - ipmi_main' - memory leaks
• ID: 239 - typo in 'mc selftest', add details
• ID: 3597471 - ipmi_mc - needs a bit of re-work - rc, inv. options
• ID: 3597468 - ipmi_mc - print_mc_usage() prints to STDOUT
• ID: 3597469 - 'mc watchdog off' prints on STDERR, should be STDOUT
• ID: 3597470 - 'mc watchdog reset' prints on STDERR, should be STDOUT
• ID: 3611254 - OEM handle for Intel 82751 in SPT mode
• ID: 3600927 - change eval order of input param in ipmi_oem_setup()
• ID: 3600928 - ipmi_pef - code cleanup
• ID: 3592732 - ipmi_picmg.c - printf() misuse
• ID: 3528310 - ipmi_picmg.c - NULL reference
• ID: 3528347 - ipmi_raw.c - possible int *flow
• ID: 3587913 - Command % ipmitool raw help; returns 1
• Added code to support sensors on other luns (On behalf of Kontron Germany)
• ID: 3611912 - Add missing newlines when cvs output is specified
• ID: 244 - ipmi_sel - "0.0" displayed for unspecified threshold values
• ID: 3612371 - Typo in impi_sel debug output
• ID: 3016359 - ipmi_sel - Get SEL Alloc Information is incorrect
• ID: 3568976 - 'sel set time' behaviour is inconsistent
• ID: 3528371 - ipmi_sensor - possible int *flow
• ID: 3601265 - 'ipmitool sensor get' leaks memory
• ID: 3601106 - 'ipmitool sensor get NACname' output incorrect/inconsistent
• ID: 3608007 - ipmi_session - typo in error message
• ID: 101 - ipmi_sol - possible int *flow
• ID: 3600933 - ipmi_sol - use of deprecated bzero()
• ID: 3609472 - ipmi_sol - Add the instance to the SOL commands
• ID: 3588726 - 'ipmitool sol payload status ...;'segfaults on no rsp
• ID: 3522731 - ipmi_sol - ipmi_get_sol_info() returns always 0
• ID: 3613042 - add missing Entity IDs
• ID: 3611306 - ipmi_tsol - fix always fail in case of error
• ID: 259 - ipmi_user - memory leak
• ID: 260 - ipmi_user - replace atoi() call
• ID: 2871903 - ipmitool user priv incorrectly sets Link Auth
• ID: 3600960 - check the copy of password exists
• ID: 3609473 - Add assertion/deassertion to threshold events
• ID: 104 - ipmishell - possible int *flow
• ID: 262 - 'set' segfaults when no IPMI inf present
• ID: 257 ipmitool exec segfaults if invalid input given
• ID: 254 - Fix retry of authentication capabilities retrieval
• ID: 3611303 - lan - error check is missing braces
• ID: 253 - Fix lanplus retransmission
• ID: 212 - 'lib/ipmi_dcmi.c' - possible int *flow
• ID: 264 - incorrect array index in get_lan_param_select()
• ID: 269 - Fixes for configure.in for cross compilation
• ID: 267 - Corruption in "lan alert print" output
• ID: 41 - ipmi_sel_interpret() - clean up formatting, indentation
• ID: 242 - Incorrect DCMI Power Reading "IPMI timestamp" interpretation
• ID: 229 - 'lib/ipmi_ekanalyzer.c' - a typo ``Too few argument!''
• ID: 266 - file descriptor leak in ipmi_fwum and ipmi_ekanalyzer
• ID: 99 - 'lib/ipmi_sel.c' - possible int *flow
• ID: 222 - 'lib/ipmi_sdr.c' - a typo 'Not Reading' -> 'No Reading'
• ID: 35 - Script to setup redirection of SNMP to/from BMC
• ID: 273 - Reduce SOL Input buffer size by SOL header size