| ipmi_cmdlang(7) | Shell interface to an IPMI system | ipmi_cmdlang(7) |
ipmi_cmdlang - A command language interface to the IPMI library
ipmi_cmdlang is a command language designed to supply the full power of OpenIPMI on a command line. It has a large number of commands and well-formed responses to each command. Note that this assumes some knowledge of OpenIPMI and how it works; you can get that from the IPMI document that comes with OpenIPMI.
ipmish starts up with no connections or anything of that nature. You must enter commands to make connections to domains. Then you can enter commands to manipulate those domains or objects inside those domains.
Note that you may use quotes, either '' or to contain parameters with spaces.
Lines with a # character in the first column are ignored.
In the command language, you will deal with various objects like sensors, controls, domains, and entities. Each of these has a name. The name of the domain is assigned by the user in the domain new command, all the other names are based on the domain name of the domain they belong to and various attributes about the object. These names are all well-formed. They are
<domain> - A name of a domain. Each registered domain in a system has a name assigned by the user.
<entity> - Entity names are in the form:
The <entity spec> is either
<sensor> - These come in the form
<control> - These come in the form
<mc> - A management controller. These come in the form
<connection> - A connection number, in the form
<pet> - A platform event trap id, in the form
<lanparm> - A LAN parameter id, in the form
<pef> - A PEF id, in the form
<fru> - A FRU id, in the form
In all cases, the object names have parts that are optional, and the entire object name is optional. If a part is left empty, then all objects that are part of the specified parts are operated on. For instance, if the system has a sensor named d1(7.1).temp then specifying d1 would operation on all sensors in the domain named d1. Specifying d1(7.1) Would operation on all sensors in that entity. Specifying an empty name, either with or by just entering nothing if the object is the last thing in the command's parameters.
Note this optionality gives a lot of power, but can be very dangerous. Entering domain close will close every domain, for instance.
In commands, every object operated on will generate a response for that object. If no object is operated on, the command will produce an error.
The commands and displays use a variety of other parameters for specifying various IPMI things.
<guid> - a 16-byte globally unique ID, all globbed together in one big hexadecimal thing.
<threshold> is a threshold for a sensor; the value it must go over/under to generate an event. It is always displayed as one of lower non-critical lower critical lower non-recoverable upper non-critical upper critical upper non-recoverable. It may be entered as one of the above, or as ln, lc, lr, un, uc, ur as a short form.
<threshold enable> is the enable for a threshold. It is like <threshold> above, but also has a going-high or going-low and an assertion or deassertion appended to the end of the name. The short form will have a l or h for going-low and going high and then a a or d appended for assertion and deassertion So for instance, urld is upper non-recoverable going-low deassertion.
<discrete enable> is the enable or disable for a discrete sensor and is specified with the sensor offset. The long form is <integer> assertion or <integer> deassertion and the short form is <integer>[ad] where the number is the offset and [ad] means assertion or deassertion.
<hot-swap state> is one of not_present, inactive activation_requested activation_in_progress active deactivation_requested deactivation_in_progress or out_of_con.
<color> is one of black, white, red, green blue yellow or orange.
<bool> is one of true, on, t, or 1 for true and one of false, off, f, or 0 for false. Output is always true or false.
The command language is hierarchical, meaning that commands may have subcommands, and subcommands may have subsubcommands, etc. So, for instance, the command to create a domain is domain new. The command to list all sensors in a domain named domain1 is sensor list domain1.
Each command has a reponse for each object operated on, which is listed after the command description. In those responses, anything that begins with a % is optional. Entries of the form **name** refer to object info descriptions that are listed in the object info section. If an entry has two '.' indented one space below it, then that entry may occur zero or more times.
Each section below defines the unique subcommands of a main command.
Help for any command is available with:
help command [subcommand [...]] - Help for any command.
Some commands are common to almost all subcommands. These are:
list <containing object> - List all objects of the specified type that are contained in the specified object. For instance, control list <entity> will list all controls in the given entity.
<containing object type>
Name: <name>
.
.
info <object> - List static information about the given object.
<object type>
Name: <name>
**object info**
These commands deal with domain objects.
new <domain> <options> <parms> [<parms>] - Open a connection to a new domain. <parms> are either:
The <IP> is the IP address or host name of the LAN-capable BMC to connect with. The <port> is generally 623. <enc> is the authentication type, either md5, md2, straight, or none. <auth> is the authentication level, either admin, operator or user. <name> and <password> are the user name and password of the IPMI user to use for the connection. The <smi num> is the driver number, generally 0. Options enable and disable various automitic processing and are:
-[no]all - all automatic handling. This will override the other processing options and turn them all on. This is true by default.
-[no]sdrs - sdr fetching. This turns on fetching SDRs when they are found. This is false by default.
-[no]frus - FRU fetching This turns on fetching FRU information when it is found. This is false by default.
-[no]sel - SEL fetching. This turns on fetching SELs when they are found. This is false by default.
-[no]ipmbscan - IPMB bus scanning. This turns on scanning IPMB busses when they are found. This is false by default.
-[no]oeminit - enable or disable special OEM processing (like ATCA).
-[no]seteventrcvr - setting event receivers. Note that setting event receivers and waiting til up is not affected by the -all option. If this is true (the default) then OpenIPMI will attempt to set the event receiver for an MC it finds that does not have it set to a valid destination.
-wait_til_up - wait until the domain is up before returning Note that if you specify this and the domain never comes up, you will never get a prompt. This is not affected by the -all option. By default -all and -seteventrcvr are true, which turns everything on.
Domain Created: <domain>
open <domain> <options> <parms> [<parms>] - Open a connection to a new domain. <parms> are either:
The <IP> is the IP address or host name of the LAN-capable BMC to connect with. The <port> defaults 623. <authtype> is the authentication type, either rmcp+, md5, md2, straight, or none. It defaults to the best authentication supported by the server. <auth> is the authentication level, either admin, operator or user. It defaults to admin. <username> and <password> are the user name and password of the IPMI user to use for the connection. For RMCP+ connections, the authentication algorithms supported (-Ra) are: bmcpick, rakp_none, rakp_hmac_sha1, and rakp_hmac_md5. The integrity algorithms (-Ri) supported are: bmcpick, none, hmac_sha1, hmac_md5, and md5. The confidentiality algorithms (-Rc) are: bmcpick, aes_cbc_128, xrc4_128, and xrc_40. The defaults are rackp_hmac_sha1, hmac_sha1, and aes_cb_128. -Rl turns on lookup up names by the name and the privilege level (allowing the same name with different privileges and different passwords), the default is straight name lookup. -Rk sets the BMC key, needed if the system does two-key lookups.
For SMI types, the <smi num> is the driver number, generally 0.
The <hackname> enables certain hacks for broken platforms. This may be listed multiple times to enable multiple hacks. The currently available hacks are:
intelplus - For Intel platforms that have broken RMCP+.
rakp3_wrong_rolem - For systems that truncate role(m) in the RAKP3 msg.
rmcpp_integ_sik - For systems that use SIK instead of K(1) for integrity.
The -M option sets the maximum outstanding messages. The default is 2, ranges 1-63.
Options enable and disable various automitic processing and are:
-[no]all - all automatic handling. This will override the other processing options and turn them all on. This is true by default.
-[no]sdrs - sdr fetching. This turns on fetching SDRs when they are found. This is false by default.
-[no]frus - FRU fetching This turns on fetching FRU information when it is found. This is false by default.
-[no]sel - SEL fetching. This turns on fetching SELs when they are found. This is false by default.
-[no]ipmbscan - IPMB bus scanning. This turns on scanning IPMB busses when they are found. This is false by default.
-[no]oeminit - enable or disable special OEM processing (like ATCA).
-[no]seteventrcvr - setting event receivers. Note that setting event receivers is not affected by the -all option. If this is true (the default) then OpenIPMI will attempt to set the event receiver for an MC it finds that does not have it set to a valid destination. -[no]setseltime - set SEL time. Note that setting the SEL time is not affected by the -all option. If this is true (the default) then OpenIPMI will attempt to set the time in the SELs it finds. It will set it to the current system time.
-wait_til_up - wait until the domain is up before returning Note that if you specify this and the domain never comes up, you will never get a prompt. This is not affected by the -all option. By default -all and -seteventrcvr are true, which turns everything on.
Domain Created: <domain>
fru <domain> <is_logical> <device_address> <device_id> <lun> <private_bus> <channel> - dump a fru given all it's insundry information.
Domain
Name: <domain>
FRU
**FRU INFO**
msg <domain> <channel> <ipmb> <LUN> <NetFN> <Cmd> [data...] - Send a command to the given IPMB address on the given channel and display the response. Note that this does not require the existance of an MC in OpenIPMI.
Domain: <domain>
channel: <chan>
ipmb: <ipmb>
LUN: <lun>
NetFN: <netfn>
command: <cmd>
Data: <data bytes>
scan <domain> <ipmb addr> [ipmb addr] - scan an IPMB to add or remove it. If a range is given, then scan all IPMBs in the range.
Scan done: <domain>
rescan_sels <domain> - Rescan all the SELs in the domain.
SEL Rescan done: <domain>
presence <domain> - Audit the presence of all enities in the domain. Note that this just starts the process; it will run in the background.
Presence check started: <domain>
close <domain> - close the given domain.
Domain closed: <domain>
sel_rescan_time <domain> <time in seconds> - Set the time between SEL rescans for all. It affects all current SELs and SELs that are discovered in the future. Zero disables scans.
Domain SEL rescan time set: <domain>
ipmb_rescan_time <domain> <time in seconds> - Set the time between IPMB rescans for this domain. zero disables scans.
Domain IPMB rescan time set: <domain>
These commands deal with FRU objects. Note that FRU objects are allocated by the domain fru command, and are not allocated here.
list - List all the frus in the system
Domain
Name: <domain>
FRUs
Name: <fru>
.
.
.
.
info <fru> - Dump information about a FRU
**FRU INFO**
areainfo <fru> - Dump the info about the FRU's areas
FRU
Name: <fru>
FRU Length: <integer>
Area
Name: <area name>
Number: <integer>
Offset: <integer>
Length: <integer>
Used Length: <Integer>
.
.
write <fru> - Write the local FRU data out into the FRU
FRU written: <fru>
close <fru> - Delete the FRU
FRU deleted: <fru>
setval <fru> <name> [num] value - Set the value of a FRU element. The name is the record name, or multi-record. The number is required for fields that need it (custom and multi-record). The value is an a single value for integers. For strings it is a string type (either binary, ascii, or unicode) and the info. Binary and unicode data is specified as numbers. ascii data is specified in a string. Note that setting a ascii value with no string will clear the value. Zero length strings and data is valid.
FRU value set: <fru>
area_offset <fru> <area name> <offset> - Set the offset of the given area to the given value. Area names are internal_data, chassis_info, board_info, product_info, and multi_record.
FRU area offset set: <fru>
area_length <fru> <area name> <length> - Set the length of the given area to the given value. Area names are internal_data, chassis_info board_info, product_info, and multi_record
FRU area length set: <fru>
area_add <fru> <area name> <offset> <length> - Add the given area to the FRU.
FRU area added: <fru>
area_delete <fru> <area name> - Delete the given area from the FRU
FRU area deleted: <fru>
These commands deal with entity objects.
list <entity> - List all the entities that meed the criteria
Domain
Name: <domain>
Entities
Name: <entity>
.
.
.
.
info <entity> - Dump information about an entity.
Entity
Name: <entity>
**ENTITY INFO**
.
.
fru <entity> - Dump the FRU information about the given entity.
Entity
Name: <entity>
FRU
**FRU INFO**
These commands deal with hot-swap of entities. Note that there is no info or list command for this subcommand.
get_act_time <entity> - Get the hot-swap auto-activate time.
Entity
Name: <entity>
Auto-Activation Time: <integer>
set_act_time <entity> - Set the hot-swap auto-activate time.
Set act time: <entity>
get_deact_time <entity> - Get the hot-swap auto-deactivate time Response:
Entity
Name: <entity> Auto-Deactivation Time: <integer>
set_deact_time <entity> - Set the hot-swap auto-deactivate time
Set deact time: <entity>
activation_request <entity> - Act like a user requested an activation of the entity. This is generally equivalent to closing the handle latch or something like that.
Activation requested: <entity>
activate <entity> - activate the given entity
Activated: <entity>
deactivate <entity> - deactivate the given entity
Deactivated: <entity>
state <entity> - Return the current hot-swap state of the given entity.
Entity
Name: <entity>
State: <hot-swap state>
check <entity> - Audit the entity's hot-swap state
Check started: <entity>
get <sensor> - Get the sensor's current reading.
Sensor
Name: <sensor>
Event Messages Enabled: <bool>
Sensor Scanning Enabled: <bool>
Initial Update In Progress: <bool>
%Value: <double> %Raw Value: <integer> Threshold
Name: <threshold>
Out Of Range: <bool>
Event
Offset: <integer>
%Name: <string name of event offset>
Set: <bool>
rearm <sensor> global | <threshold enable> [<threshold enable> ..] | <discrete enable> [<discrete enable> ..] - Rearm the sensor. If global is specified, then rearm all events in the sensor. Otherwise, if it is a threshold sensor, then put in a list of threshold enables. If it is a discrete sensor, then put in a list of discrete enables.
Rearm done: <sensor>
get_thresholds <sensor> - Get the sensor's thresholds
Sensor
Name: <sensor>
Threshold
Name: <threshold>
Value: <double>
set_thresholds <sensor> <threshold> <value> ... - Set the sensor's thresholds to the given values. If a threshold is not specified, it will not be modified. Thresholds are un, uc, ur, lr, lc, ln. The u stands for upper, l for lower, n for non-critical, c for critical, and r for non-recoverable. The value is floating point.
Thresholds set: <sensor>
get_hysteresis <sensor> - Get the sensor's hysteresis values
Sensor
Name: <sensor>
Positivie Hysteresis: <integer>
Negative Hysteresis: <integer>
set_hysteresis <sensor> <pos hyst> <neg hyst> - Set the sensor's hysteresis to the given values. These are raw integer value; hystersis is specified as a raw value and it cannot be converted to floating point because the function may be non-linear.
Hysteresis set: <sensor>
get_event_enables <sensor> - Get the sensor's event enable values
Sensor
Name: <sensor>
Event Messages Enabled: <bool>
Sensor Scanning Enabled: <bool>
Busy: <bool>
Threshold
Name: <threshold>
Enabled: <bool>
.
.
Event
Offset: <integer>
Name: <event offset name for sensor>
%Assertion Enabled: <bool>
%Deassertion Enabled: <bool>
set_event_enables <sensor> msg|nomsg scan|noscan [<enable> [<enable> ...]] - Set the sensor's event enable values. This turns sensor messages and scanning on and off and will enable all the listed enables and disable all over ones. The enables are either a <threshold enable> or a <discrete enable>.
Event enables set: <sensor>
enable_events <sensor> msg|nomsg scan|noscan [<enable> [<enable> ...]] - Enable event enable values. This turns sensor messages and scanning on and off and will enable all the listed enables. All other enables will be left alone. The enables are either a <threshold enable> or a <discrete enable>.
Event enables set: <sensor>
disable_events <sensor> msg|nomsg scan|noscan [<enable> [<enable> ...]] - Disable event enable values. This turns sensor messages and scanning on and off and will disable all the listed enable. All other enables will be left alone. The enables are either a <threshold enable> or a <discrete enable>.
Event enables set: <sensor>
Commands dealing with controls.
set <control> <value> [<value> ..] - Set the value of a control. The settings depend on control type, most take one or more integer values depending on the number of physical things the control contains. An identifier type takes one or more unsigned characters. A light set with settings take the form
Set done: <control>
get <control> - Get the value of a control. The reponse depends on the control type.
Control
Name: <control>
Light
Num: 0
Local Control: <bool>
%Color: <color>
%On Time: <integer>
%Off Time: <integer>
Data: <byte1> <byte2> ...
Value
Num: <integer>
Value: <integer>
Commands dealing with MC objects.
reset <warm | cold> <mc> - Do a warm or cold reset on the given MC
Reset done: <mc>
msg <mc> <LUN> <NetFN> <Cmd> [data...] - Send the given command to the management controller and display the response.
MC: <mc>
LUN: <lun>
NetFN: <netfn>
command: <cmd>
Data: <data bytes>
set_events_enable <mc> <enable | disable> - enables or disables events on the MC.
Events enable done: <mc>
get_events_enable <mc> - Prints out if the events are enabled for the given MC.
Events Enable: <bool>
sdrs <mc> <main | sensor> - list the SDRs for the mc. Either gets the main SDR repository or the sensor SDR repository.
MC
Name: <mc>
SDR
Record ID: <integer>
Type: <integer>
Version: <integer>.<integer>
Data: <data bytes>
get_sel_time <mc> - Get the time in the SEL for the given MC.
MC
Name: <mc>
SEL Time: <integer>
set_sel_time <mc> <time> - Set the time in the SEL for the given MC.
MC SEL time set
Name: <mc>
rescan_sel <mc> - Rescan the SEL in the MC.
SEL Rescan done: <mc>
sel_rescan_time <mc> <time in seconds> - Set the time between SEL rescans for the SEL on this MC. Zero disables scans.
MC SEL rescan time set: <domain>
sel_info <mc> - Dump information about the MC's SEL.
MC
Name: <mc>
SEL Version: <integer>.<integer>
SEL Count: <integer>
SEL Slots Used: <integer>
SEL Free Bytes: <integer>
SEL Last Addition Timestamp: <integer>
SEL overflow: <bool>
SEL Supports Delete: <bool>
SEL Supports Partial Add: <bool>
SEL Supports Reserve: <bool>
SEL Supports Get SEL Allocation: <bool>
chan info <mc> <channel> - Dump information about the MC's channel.
Channel Info
MC: <mc>
Number: <integer>
Medium: <integer>
Protocol Type: <integer>
Session Support: session-less|single-session|multi-session|session-based
Vendor ID: <data bytes>
Aux Info: <data bytes>
chan get_access <mc> <channel> non-volatile|present|both - Dump information about the MC's channel access. There are two different places where this is stored, the present in-use values (volatile) and the non-volatile storage that is loaded at startup. Note if you specify channel 0xe, the response channel will be different; it will be the current channel.
Channel Access
MC: <mc>
Channel: <integer>
Type: non-volatile|present
Alerting Enabled: <bool>
Per-Message Auth: <bool>
User Auth: <bool>
Access Mode: disable|pre-boot|always|shared
Privilege Limit: callback|user|operator|admin|oem
chan set_access <mc> <channel> non-volatile|present|both <parm> <value> ... - Set information about the MC's channel access. There are two different places where this is stored, the present in-use values (volatile) and the non-volatile storage that is loaded at startup. Note if you specify channel 0xe, the modified channel will be the current channel. Parms are:
alert true|false msg_auth true|false user_auth true|false access_mode disabled|pre-boot|always|shared privilege_limit callback|user|operator|admin|oem
Channel Access Set
MC: <mc>
Channel: <integer>
chan user list <mc> <channel> [<user num>] - List users associated with the channel. Each user number has an associated name and password that is global in the MC (not associated with a channel). There is also channel-specific information for each user. This command lists the global user information and the channel-specific information for the channel specified. If no user number is listed, then all users for the channel are listed. Otherwise only the given user is listed.
Channel Access Set
MC: <mc>
Channel: <integer>
Max User: <integer>
Enabled Users: <integer>
Fixed Users: <integer>
User
Number: <integer>
*String Name: <string>
*Binary Name: <data bytes>
Link Auth Enabled: <bool>
Msg Auth Enabled: <bool>
Access CB Only: <bool>
Privilege Limit: <integer>
Session Limit: <integer>
.
.
chan user set <mc> <channel> <user num> <parm> <value> ... - Set information about the user number. Only the specified values are modified. The name and password are global values, all other are channel-specific. The parms are: are:
link_enabled true|false msg_enabled true|false cb_only true|false privilege_limit callback|user|operator|admin|oem|no_access session_limit <integer> name <user name string> password <password string, <= 16 characters> password2 <password string, <= 20 characters> enable disable
User Info Set: <mc>
Commands dealing with the system event log. Note that there is no info command.
list <domain> - The list command is unique in this object, so it is specified explicitly here. List the local copy of the system event log for the entire domain.
Domain
Name: <domain>
Entries: <integer>
Slots in use: <integer>
Event
**EVENT INFO**
.
.
mc_list <domain> - List the local copy of the system event log on the given MC.
MC
Name: <mc>
Entries: <integer>
Slots in use: <integer>
Event
**EVENT INFO**
.
.
delete <mc> <record #> - Delete the given event number from the SEL
Event deleted
MC: <mc>
Record: <integer>
add <mc> <type> <13 bytes of data> - Add the event data to the SEL.
MC
Name: <mc>
Record ID: <integer>
clear <domain> - clear the system event log
SEL Clear done: <domain>
Commands dealing with connections.
activate <connection> - Activate the given connection
Connection activated: <connection>
Commands dealing with platform event traps.
new <domain> <connection> <channel> <ip addr> <mac_addr> <eft selector> <policy num> <apt selector> <lan dest selector> - Set up the domain to send PET traps from the given connection to the given IP/MAC address over the given channel.
PET Created: <pet>
mcnew <mc> <channel> <ip addr> <mac_addr> <eft selector> <policy num> <apt selector> <lan dest selector> - Set up the domain to send PET traps from the given connection to the given IP/MAC address over the given channel. This takes an MC instead of a connection.
PET Created: <pet>
close <pet> - Close the pet.
PET destroyed: <pet>
commands dealing with platform even filters. These are basically connections to the PEF configuration parameters in an MC. You use a pef to fetch a pef config, which you can then modify and write back to the MC. Note that when you get a pef config, you claim a lock on the MC that must be unlocked.
new <mc> - Create a pef for the given MC.
PEF: <pef>
unlock_mc <mc> - Unlock the PEF lock on the given MC.
PEF unlocked: <mc>
close <pef> - Free the given pef
PEF destroyed: <pef>
Commands dealing with PEF configurations. These are the actual PEF data items.
get <pef> - Fetch the pef data items from the pef and create a pef config.
PEF Config
Name: <pef config>
**PEF CONFIG**
update <pef config> <parm> [selector] <value> - Set the given parameter in the pef config to the given value. If the parameter has a selector of some type, the selector must be given, otherwise no selector should be given.
PEF config updated: <pef config>
set <pef> <pef config> - Write the pef data back to the pef. Note that this must be the same pef used to create the config.
PEF config set: <pef config>
unlock <pef> <pef config> - Unlock the lock in the MC and mark the pef config as unlocked.
PEF config unlocked: <pef config>
close <pef config> - Free the pef config.
PEF config destroyed: <pef config>
Commands dealing with lanparms. These are basically connections to the LAN configuration parameters in an MC. You use a lanparm to fetch a lanparm config, which you can then modify and write back to the MC. Note that when you get a lanparm config, you claim a lock on the MC that must be unlocked.
new <mc> <channel> - Create a lanparm for the given MC and channel.
LANPARM: <lanparm>
unlock_mc <mc> <channel> - Unlock the lanparm lock on the given MC and channel.
LANPARM unlocked: <mc>
close <lanparm> - Free the given lanparm
LANPARM destroyed: <lanparm>
Commands dealing with lanparm configurations. These are the actual lanparm data items.
get <lanparm> - Fetch the lanparm data items from the lanparm and create a lanparm config.
LANPARM Config
Name: <lanparm config>
**LANPARM CONFIG**
set <lanparm> <lanparm config> - Write the lanparm data back to the lanparm. Note that this must be the same lanparm used to create the config.
LANPARM config set: <lanparm config>
unlock <lanparm> <lanparm config> - Unlock the lock in the MC and mark the lanparm config as unlocked.
LANPARM config unlocked: <lanparm config>
close <lanparm config> - Free the lanparm config.
LANPARM config destroyed: <lanparm config>
A few general commands exist.
evinfo <bool> - Turn on or off dumping object information when an event comes in. This is false by default.
debug <type> <bool> - Turn the given debugging type on or off
The command language will output events to the console when they happen. Events all occur in the format:
Event
**EVENT INFO**
The event info varies on the type of events. The defined events are listed below. Note that the output of some events depends on the setting of the evinfo command; the information about the object itself may or may not be output.
Some events have another event container; this is the IPMI event that caused the event to be output.
The following event is output when the domain is completely up and operational and finished all it SDR, FRU, and bus scans:
EVENT
Object Type: Domain
Name: <domain>
Operation: Domain fully up
Connection Number: <integer>
Port Number: <integer>
Any Connection Up: <bool>
Error: <integer>
The following comes out when domain connection infomration changes:
EVENT
Object Type: Domain
Name: <domain>
Operation: Connection Change
The following comes out when domains are added:
EVENT
Object Type: Domain
Name: <domain>
Operation: Add
%**DOMAIN INFO**
The following comes out when domains are destroyed:
EVENT
Object Type: Domain
Name: <domain>
Operation: Delete
The following comes out when the domain gets an event that does not have a handler:
EVENT
Object Type: Event
**EVENT INFO**
The following comes out when an entity is added:
EVENT
Object Type: Entity
Name: <entity>
Operation: Add
%**ENTITY INFO**
The following comes out when an entity is deleted:
EVENT
Object Type: Entity
Name: <entity>
Operation: Delete
The following comes out when an entity is changed:
EVENT
Object Type: Entity
Name: <entity>
Operation: Change
%**ENTITY INFO**
The following comes out when an entity's FRU is added:
EVENT
Object Type: Entity FRU
Name: <entity>
Operation: Add
%**FRU INFO**
The following comes out when an entity's FRU is deleted:
EVENT
Object Type: Entity FRU
Name: <entity>
Operation: Delete
The following comes out when an entity's FRU is changed:
EVENT
Object Type: Entity FRU
Name: <entity>
Operation: Change
%**FRU INFO**
The following comes out when an entity's presence changes:
EVENT
Object Type: Entity
Name: <entity>
Operation: Presence Change
Present: <bool>
%Event
**EVENT INFO**
The following comes out when an entity's hot-swap state changes:
EVENT
Object Type: Entity
Name: <entity>
Operation: Hot-Swap Change
Last State: <hot-swap state>
State: <hot-swap state>
%Event
**EVENT INFO**
The following comes out when an MC is added:
EVENT
Object Type: MC
Name: <mc>
Operation: Add
%**MC INFO**
The following comes out when an MC is removed:
EVENT
Object Type: MC
Name: <mc>
Operation: Delete
The following comes out when an MC is changed:
EVENT
Object Type: MC
Name: <mc>
Operation: Change
%**MC INFO**
The following comes out when an MC changes active state:
EVENT
Object Type: MC
Name: <mc>
Operation: Active Changed
Active: <bool>
The following comes out when a discrete sensor gets an event:
EVENT
Object Type: Sensor
Name: <sensor>
Operation: Event
Offset: <integer>
Direction: assertion | deassertion
Severity: <integer>
Previous Severity: <integer>
%Event
**EVENT INFO**
The following comes out when a threshold sensor gets an event:
EVENT
Object Type: Sensor
Name: <sensor>
Operation: Event
Threshold: <threshold>
High/Low: going-high | going-low
Direction: assertion | deassertion
%Value: <double>
%Raw Value: <integer>
%Event
**EVENT INFO**
The following comes out when a sensor is added:
EVENT
Object Type: Sensor
Name: <sensor>
Operation: Add
%**SENSOR INFO**
The following comes out when a sensor is deleted:
EVENT
Object Type: Sensor
Name: <sensor>
Operation: Delete
The following comes out when a sensor is changed:
EVENT
Object Type: Sensor
Name: <sensor>
Operation: Change
%**SENSOR INFO**
The following comes out when a control gets an event:
EVENT
Object Type: Control
Name: <control>
Operation: Event
Value
Number: <integer>
Value: <integer>
%Event
**EVENT INFO**
The following comes out when a control is added:
EVENT
Object Type: Control
Name: <control>
Operation: Add
%**CONTROL INFO**
The following comes out when a control is deleted:
EVENT
Object Type: Control
Name: <control>
Operation: Delete
The following comes out when a control is changed:
EVENT
Object Type: Control
Name: <control>
Operation: Change
%**CONTROL INFO**
Many of the command responses and events contain information about an objects. The definitions of this information output is done here.
MC: <mc>
Record ID: <integer>
Event type: <integer>
Timestamp: <integer>
Data: <data bytes>
Type: <domain type>
GUID: <hex string>
SEL Rescan Time: <time>
IPMB Rescan Time: <time>
Type: unknown | mc | fru | generic
Present: <bool>
Presence sensor always there: <bool>
Hot swappable: <bool>
%Supports managed hot swap: <bool>
%Parents
Name: <entity>
Name: <entity>
.
.
%Children
Name: <entity>
Name: <entity>
.
.
%Physical Slot: <integer>
%Id: <string>
Entity ID String: <string>
Note that Parents and Children fields will not be present if the entity has no parents or children. Each entity type except unknown will have its own output info. These are:
mc
Channel: <channel>
LUN: <lun>
OEM: <oem field from SDR>
Slave Address: <ipmb>
ACPI_system_power_notify_required: <bool>
ACPI_device_power_notify_required: <bool>
controller_logs_init_agent_errors: <bool>
log_init_agent_errors_accessing: <bool>
global_init: <bool>
chassis_device: <bool>
bridge: <bool>
IPMB_event_generator: <bool>
IPMB_event_receiver: <bool>
FRU_inventory_device: <bool>
SEL_device: <bool>
SDR_repository_device: <bool>
sensor_device: <bool>
fru
Channel: <channel>
LUN: <lun>
OEM: <oem field from SDR>
Slave Address: <ipmb>
access_address: <ipmb>
private_bus_id: <integer>
device_type: <integer>
device_modifier: <integer>
is_logical_fru: <bool>
fru_device_id: <integer>
generic
Channel: <channel>
LUN: <lun>
OEM: <oem field from SDR>
access_address: <ipmb>
private_bus_id: <integer>
device_type: <integer>
device_modifier: <integer>
slave_address: <ipmb>
address_span: <integer>
Active: <bool>
GUID: <hex string>
SEL Rescan Time: <integer>
provides_device_sdrs: <bool>
device_available: <bool>
chassis_support: <bool>
bridge_support: <bool>
ipmb_event_generator: <bool>
ipmb_event_receiver: <bool>
fru_inventory_support: <bool>
sel_device_support: <bool>
sdr_repository_support: <bool>
sensor_device_support: <bool>
device_id: <ipmb>
device_revision: <integer>
fw_revision: <integer>.<integer>
version: <integer>.<integer>
manufacturer_id: <integer>
product_id: <integer>
aux_fw_revision: <integer> <integer> <integer> <integer>
LUN: <integer>
Number: <integer>
Event Reading Type: <integer>
Event Reading Type Name: one of:
unspecified threshold discrete_usage discrete_state
discrete_predictive_failure discrete_limit_exceeded
discrete_performance_met discrete_severity discrete_device_presence
discrete_device_enable discrete_availability discrete_redundancy
discrete_acpi_power
Type: <integer>
Type Name: <sensor type (a generic string)>
%Direction: input | output
%Event Support: per state | entire sensor | global
Init Scanning: <bool>
Init Events: <bool>
Init Thresholds: <bool>
Init Hysteresis: <bool>
Init Type: <bool>
Init Power Up Events: <bool>
Init Power Up Scanning: <bool>
Ignore If No Entity: <bool>
Auto Rearm: <bool>
OEM1: <integer>
Id: <string>
For threshold sensors, the following exist:
Threshold Access: none | readable | settable | fixed
Threshold
Name: <threshold>
Readable: <bool>
Settable: <bool>
Supports: going high assertion | going low assertion
| going high deassertion | going low deassertion
.
.
Hysteresis Support: none | readable | settable | fixed
%Nominal Reading: <float>
%Normal Max: <float>
%Normal Min: <float>
%Sensor Max: <float>
%Sensor Min: <float>
Base Unit: <integer>
Base Unit Name: <string>
%Rate Unit: <integer>
%Rate Unit Name: <string>
%Modifier Use: / | *
%Modifier Unit: <integer>
%Modifier Unit Name: <string>
For discrete sensors, the following exist:
Event
Offset: <integer>
Supports: assertion | deassertion
.
.
Type: <control type>
Generates Events: <bool>
Settable: <bool>
Readable: <bool>
Num Values: <integer>
Id: <string>
Controls of type light that are set with settings have the following:
Set with: settings
Local Control: <bool>
Color: <color>
.
.
Controls of type light that are set with transitions have the following:
Light
Number: <integer>
Num Values: <integer>
Value
Number: <integer>
Num Transitions: <integer>
Transition
Number: <integer>
Color: <color>
Time: <integer>
.
.
.
.
Controls of type identifier have the following:
Max Length: <integer>
Name: <fru>
record
Name: <name>
Type: binary | ascii | unicode | integer
%Number: <integer>
Data: data depending on type
.
.
Multi-record
Number: <integer>
Type: binary | ascii | unicode
Data: <data in the above format>
.
.
support_auth_oem: <bool>
support_auth_straight: <bool>
support_auth_md5: <bool>
support_auth_md2: <bool>
support_auth_none: <bool>
ip_addr_source: <integer>
num_alert_destinations: <integer>
%ipv4_ttl: <integer>
%ipv4_flags: <integer>
%ipv4_precedence: <integer>
%ipv4_tos: <integer>
%ip_addr: <ip addr>
%mac_addr: <mac addr>
%subnet_mask: <ip addr>
%primary_rmcp_port <integer>
%secondary_rmcp_port <integer>
%bmc_generated_arps: <bool>
%bmc_generated_garps: <bool>
%garp_interval: <integer>
%default_gateway_ip_addr: <ip addr>
%default_gateway_mac_addr: <mac addr>
%backup_gateway_ip_addr: <ip addr>
%backup_gateway_mac_addr: <mac addr>
community_string: <string>
User
Name: callback
enable_auth_oem: <bool>
enable_auth_straight: <bool>
enable_auth_md5: <bool>
enable_auth_md2: <bool>
enable_auth_none: <bool>
User
Name: user
enable_auth_oem: <bool>
enable_auth_straight: <bool>
enable_auth_md5: <bool>
enable_auth_md2: <bool>
enable_auth_none: <bool>
User
Name: operator
enable_auth_oem: <bool>
enable_auth_straight: <bool>
enable_auth_md5: <bool>
enable_auth_md2: <bool>
enable_auth_none: <bool>
User
Name: admin
enable_auth_oem: <bool>
enable_auth_straight: <bool>
enable_auth_md5: <bool>
enable_auth_md2: <bool>
enable_auth_none: <bool>
User
Name: oem
enable_auth_oem: <bool>
enable_auth_straight: <bool>
enable_auth_md5: <bool>
enable_auth_md2: <bool>
enable_auth_none: <bool>
Alert Destination
Number: <integer>
alert_ack: <bool>
dest_type: <integer>
alert_retry_interval: <integer>
max_alert_retries: <integer>
dest_format: <integer>
gw_to_use: <integer>
dest_ip_addr: <ip addr>
dest_mac_addr: <mac addr>
.
.
alert_startup_delay_enabled: <bool>
startup_delay_enabled: <bool>
event_messages_enabled: <bool>
pef_enabled: <bool>
diagnostic_interrupt_enabled: <bool>
oem_action_enabled: <bool>
power_cycle_enabled: <bool>
reset_enabled: <bool>
power_down_enabled: <bool>
alert_enabled: <bool>
%startup_delay: <integer>
%alert_startup_delay: <integer>
guid_enabled: <bool>
guid_val: <guid>
num_event_filters: <integer>
num_alert_policies: <integer>
num_alert_strings: <integer>
Event Filter
Number: <integer>
enable_filter: <bool>
filter_type: <integer>
diagnostic_interrupt: <bool>
oem_action: <bool>
power_cycle: <bool>
reset: <bool>
power_down: <bool>
alert: <bool>
alert_policy_number: <integer>
event_severity: <integer>
generator_id_addr: <integer>
generator_id_channel_lun: <integer>
sensor_type: <integer>
sensor_number: <integer>
event_trigger: <integer>
data1_offset_mask: <integer>
data1_mask: <integer>
data1_compare1: <integer>
data1_compare2: <integer>
data2_mask: <integer>
data2_compare1: <integer>
data2_compare2: <integer>
data3_mask: <integer>
data3_compare1: <integer>
data3_compare2: <integer>
.
.
Alert Policy
Number: <integer>
policy_num: <integer>
enabled: <bool>
policy: <integer>
channel: <integer>
destination_selector: <integer>
alert_string_event_specific: <bool>
alert_string_selector: <integer>
.
.
Alert String
event_filter: <integer>
alert_string_set: <integer>
alert_string: <string>
.
.
Active: <bool>
Up: <bool>
Port
Number: <integer>
Info: <info string>
Up: <bool>
.
.
MC: <mc>
MC: <mc>
Channel: <channel>
IP Address: <ip address>
MAC Address: <mac address>
EFT Selector: <eft selector>
Policy Number: <policy number>
APT Selector: <apt selector>
LAN Dest Selector: <lan dest selector>
MC: <mc>
Channel: <integer>
None
Corey Minyard <cminyard@mvista.com>
| 05/13/03 | OpenIPMI |