FREEIPMI_INTERPRET_SENSOR(5)

NAME
freeipmi_interpret_sensor.conf - specify sensor interpretation rules

DESCRIPTION
The /usr/local/etc/freeipmi/freeipmi_interpret_sensor.conf defines how IPMI sensors should be interpreted. IPMI based sensors specify a number of states/thresholds when they are read. Based on those states/thresholds, libraries and tools such as libfreeipmi(3), libipmimonitoring(3) and ipmi-sensors(8) can report if a sensor reading is "good" or "bad" via a report of a NOMINAL, WARNING, or CRITICAL state.

Each of the states listed below are (hopefully) descriptive enough to describe the state conditions that may be set/unset for each sensor type. For more detailed information on each of the individual states listed below, please see the IPMI Specification "Sensor and Event Code Tables". Ipmi-sensors(8) can be used to determine the sensor types and the states/thresholds that exist on a system by outputting very verbose output and seeing what types of Assertion or Deassertion events are possible.

The possible values for all states/thresholds below are:

Nominal - Signal Nominal reading if state/threshold tripped

Warning - Signal Warning reading if state/treshold tripped

Critical - Signal Critical reading if state/threshold tripped

Not all IPMI sensor types and event types are currently supported. If you would like more to be supported, please e-mail the FreeIPMI mailing list.

The default values selected for individual states/thresholds being tripped are based on best guesses and motherboards being analyzed. If you think they should be changed, please e-mail the FreeIPMI mailing list to discuss what the defaults should be.

Most default interpretations can be determined quite easily and can meet the needs of most users. For example, a reading of "Performance_Met" is normally better than "Performance_Lags". However, some sensors can be ambiguous and depend completely on the manufacturer. For example, "State_Asserted" vs. "State_Deasserted" are completely at the interpretation of the vendor. Users are advised to adjust the interpretations below as needed for their machines.

Every group of state conditions below includes a configuration for "No_Event". This is the condition under which no sensor states/events have occurred or are triggered. Under most conditions, a mapping to "Nominal" is preferred. However, under some circumstances, it may be useful to report something else. For example, if a sensor on a particular motherboard is required to report a state/event, a no sensor state condition could indicate a broken a sensor. This is highly dependent on the motherboard.

FORMAT
The configuration options that can be specified in the configuration file are listed below. Each configuration option must be listed on a separate line. Arguments for an option are separated by any amount of whitespace. Multiple arguments are also separated by whitespace. Comments can be marked by using the pound sign ("#") character, and lines can be continued on the next using backslash ("\").

OPTIONS

IPMI_Threshold_Sensor
    The following states correspond to threshold sensors. This normally applies to sensors that measure non-discrete values, such as temperatures, voltages, RPM, etc.

    IPMI_Threshold_Sensor_No_Event
        Defaults to Nominal.

    IPMI_Threshold_Sensor_At_Or_Below_Lower_Non_Critical_Threshold
        Defaults to Nominal.

    IPMI_Threshold_Sensor_At_Or_Below_Lower_Critical_Threshold
        Defaults to Critical.

    IPMI_Threshold_Sensor_At_Or_Below_Lower_Non_Recoverable_Threshold
        Defaults to Critical.

    IPMI_Threshold_Sensor_At_Or_Above_Upper_Non_Critical_Threshold
        Defaults to Nominal.

    IPMI_Threshold_Sensor_At_Or_Above_Upper_Critical_Threshold
        Defaults to Critical.

    IPMI_Threshold_Sensor_At_Or_Above_Upper_Non_Recoverable_Threshold
        Defaults to Critical.

IPMI_Temperature_State
    The following states correspond to Temperature sensors that report an assertion or deassertion.

    IPMI_Temperature_State_No_Event
        Defaults to Nominal.

    IPMI_Temperature_State_Deasserted
        Defaults to Nominal.

    IPMI_Temperature_State_Asserted
        Defaults to Warning.

IPMI_Temperature_Limit
    The following states correspond to Temperature sensors that report on limits.

    IPMI_Temperature_Limit_No_Event
        Defaults to Nominal.

    IPMI_Temperature_Limit_Not_Exceeded
        Defaults to Nominal.

    IPMI_Temperature_Limit_Exceeded
        Defaults to Critical.

IPMI_Temperature_Transition_Severity
    The following states correspond to Temperature sensors that report on device severity.

    IPMI_Temperature_Transition_Severity_No_Event
        Defaults to Nominal.

    IPMI_Temperature_Transition_Severity_Transition_To_OK
        Defaults to Nominal.

    IPMI_Temperature_Transition_Severity_Transition_To_Non_Critical_From_OK
        Defaults to Warning.

    IPMI_Temperature_Transition_Severity_Transition_To_Critical_From_Less_Severe
        Defaults to Critical.

    IPMI_Temperature_Transition_Severity_Transition_To_Non_Recoverable_From_Less_Severe
        Defaults to Critical.

    IPMI_Temperature_Transition_Severity_Transition_To_Non_Critical_From_More_Severe
        Defaults to Warning.

    IPMI_Temperature_Transition_Severity_Transition_To_Critical_From_Non_Recoverable
        Defaults to Critical.

    IPMI_Temperature_Transition_Severity_Transition_To_Non_Recoverable
        Defaults to Critical.

    IPMI_Temperature_Transition_Severity_Monitor
        Defaults to Warning.

    IPMI_Temperature_Transition_Severity_Informational
        Defaults to Nominal.

IPMI_Voltage_State
    The following states correspond to Voltage sensors that report an assertion or deassertion.

    IPMI_Voltage_State_No_Event
        Defaults to Nominal.

    IPMI_Voltage_State_Deasserted
        Defaults to Nominal.

    IPMI_Voltage_State_Asserted
        Defaults to Warning.

IPMI_Voltage_Performance
    The following states correspond to Voltage sensors that report on performance.

    IPMI_Voltage_Performance_No_Event
        Defaults to Nominal.

    IPMI_Voltage_Performance_Met
        Defaults to Nominal.

    IPMI_Voltage_Performance_Lags
        Defaults to Critical.

IPMI_Voltage_Transition_Severity
    The following states correspond to Voltage sensors that report on device severity.

    IPMI_Voltage_Transition_Severity_No_Event
        Defaults to Nominal.

    IPMI_Voltage_Transition_Severity_Transition_To_OK
        Defaults to Nominal.

    IPMI_Voltage_Transition_Severity_Transition_To_Non_Critical_From_OK
        Defaults to Warning.

    IPMI_Voltage_Transition_Severity_Transition_To_Critical_From_Less_Severe
        Defaults to Critical.

    IPMI_Voltage_Transition_Severity_Transition_To_Non_Recoverable_From_Less_Severe
        Defaults to Critical.

    IPMI_Voltage_Transition_Severity_Transition_To_Non_Critical_From_More_Severe
        Defaults to Warning.

    IPMI_Voltage_Transition_Severity_Transition_To_Critical_From_Non_Recoverable
        Defaults to Critical.

    IPMI_Voltage_Transition_Severity_Transition_To_Non_Recoverable
        Defaults to Critical.

    IPMI_Voltage_Transition_Severity_Monitor
        Defaults to Warning.

    IPMI_Voltage_Transition_Severity_Informational
        Defaults to Nominal.

IPMI_Current_Transition_Severity
    The following states correspond to Current sensors that report on device severity.

    IPMI_Current_Transition_Severity_No_Event
        Defaults to Nominal.

    IPMI_Current_Transition_Severity_Transition_To_OK
        Defaults to Nominal.

    IPMI_Current_Transition_Severity_Transition_To_Non_Critical_From_OK
        Defaults to Warning.

    IPMI_Current_Transition_Severity_Transition_To_Critical_From_Less_Severe
        Defaults to Critical.

    IPMI_Current_Transition_Severity_Transition_To_Non_Recoverable_From_Less_Severe
        Defaults to Critical.

    IPMI_Current_Transition_Severity_Transition_To_Non_Critical_From_More_Severe
        Defaults to Warning.

    IPMI_Current_Transition_Severity_Transition_To_Critical_From_Non_Recoverable
        Defaults to Critical.

    IPMI_Current_Transition_Severity_Transition_To_Non_Recoverable
        Defaults to Critical.

    IPMI_Current_Transition_Severity_Monitor
        Defaults to Warning.

    IPMI_Current_Transition_Severity_Informational
        Defaults to Nominal.

IPMI_Fan_State
    The following states correspond to Fan sensors that report an assertion or deassertion.

    IPMI_Fan_State_No_Event
        Defaults to Nominal.

    IPMI_Fan_State_Deasserted
        Defaults to Nominal.

    IPMI_Fan_State_Asserted
        Defaults to Warning.

IPMI_Fan_Transition_Severity
    The following states correspond to Fan sensors that report on device severity.

    IPMI_Fan_Transition_Severity_No_Event
        Defaults to Nominal.

    IPMI_Fan_Transition_Severity_Transition_To_OK
        Defaults to Nominal.

    IPMI_Fan_Transition_Severity_Transition_To_Non_Critical_From_OK
        Defaults to Warning.

    IPMI_Fan_Transition_Severity_Transition_To_Critical_From_Less_Severe
        Defaults to Critical.

    IPMI_Fan_Transition_Severity_Transition_To_Non_Recoverable_From_Less_Severe
        Defaults to Critical.

    IPMI_Fan_Transition_Severity_Transition_To_Non_Critical_From_More_Severe
        Defaults to Warning.

    IPMI_Fan_Transition_Severity_Transition_To_Critical_From_Non_Recoverable
        Defaults to Critical.

    IPMI_Fan_Transition_Severity_Transition_To_Non_Recoverable
        Defaults to Critical.

    IPMI_Fan_Transition_Severity_Monitor
        Defaults to Warning.

    IPMI_Fan_Transition_Severity_Informational
        Defaults to Nominal.

IPMI_Fan_Device_Present
    The following states correspond to Fan sensors that report on device installation.

    IPMI_Fan_Device_Present_Device_No_Event
        Defaults to Nominal.

    IPMI_Fan_Device_Present_Device_Removed_Device_Absent
        Defaults to Critical.

    IPMI_Fan_Device_Present_Device_Inserted_Device_Present
        Defaults to Nominal.

IPMI_Power_Supply_Transition_Severity
    The following states correspond to Power Supply sensors that report on device severity.

    IPMI_Power_Supply_Transition_Severity_No_Event
        Defaults to Nominal.

    IPMI_Power_Supply_Transition_Severity_Transition_To_OK
        Defaults to Nominal.

    IPMI_Power_Supply_Transition_Severity_Transition_To_Non_Critical_From_OK
        Defaults to Warning.

    IPMI_Power_Supply_Transition_Severity_Transition_To_Critical_From_Less_Severe
        Defaults to Critical.

    IPMI_Power_Supply_Transition_Severity_Transition_To_Non_Recoverable_From_Less_Severe
        Defaults to Critical.

    IPMI_Power_Supply_Transition_Severity_Transition_To_Non_Critical_From_More_Severe
        Defaults to Warning.

    IPMI_Power_Supply_Transition_Severity_Transition_To_Critical_From_Non_Recoverable
        Defaults to Critical.

    IPMI_Power_Supply_Transition_Severity_Transition_To_Non_Recoverable
        Defaults to Critical.

    IPMI_Power_Supply_Transition_Severity_Monitor
        Defaults to Warning.

    IPMI_Power_Supply_Transition_Severity_Informational
        Defaults to Nominal.

IPMI_Fan_Transition_Availability
    The following states correspond to Fan sensors that report on device availability.

    IPMI_Fan_Transition_Availability_No_Event
        Defaults to Nominal.

    IPMI_Fan_Transition_Availability_To_Running
        Defaults to Nominal.

    IPMI_Fan_Transition_Availability_To_In_Test
        Defaults to Warning.

    IPMI_Fan_Transition_Availability_To_Power_Off
        Defaults to Warning.

    IPMI_Fan_Transition_Availability_To_On_Line
        Defaults to Warning.

    IPMI_Fan_Transition_Availability_To_Off_Line
        Defaults to Warning.

    IPMI_Fan_Transition_Availability_To_Off_Duty
        Defaults to Warning.

    IPMI_Fan_Transition_Availability_To_Degraded
        Defaults to Critical.

    IPMI_Fan_Transition_Availability_To_Power_Save
        Defaults to Warning.

    IPMI_Fan_Transition_Availability_Install_Error
        Defaults to Critical.

IPMI_Fan_Redundancy
    The following states correspond to Fan sensors that report on redundancy.

    IPMI_Fan_Redundancy_No_Event
        Defaults to Nominal.

    IPMI_Fan_Redundancy_Fully_Redundant
        Defaults to Nominal.

    IPMI_Fan_Redundancy_Redundancy_Lost
        Defaults to Critical.

    IPMI_Fan_Redundancy_Redundancy_Degraded
        Defaults to Warning.

    IPMI_Fan_Redundancy_Non_Redundant_Sufficient_Resources_From_Redundant
        Defaults to Critical.

    IPMI_Fan_Redundancy_Non_Redundant_Sufficient_Resources_From_Insufficient_Redundancy
        Defaults to Critical.

    IPMI_Fan_Redundancy_Non_Redundant_Insufficient_Resources
        Defaults to Critical.

    IPMI_Fan_Redundancy_Redundancy_Degraded_From_Fully_Redundant
        Defaults to Warning.

    IPMI_Fan_Redundancy_Redundancy_Degraded_From_Non_Redundant
        Defaults to Warning.

IPMI_Physical_Security
    The following states correspond to Physical Security sensors w/ Physical Security specific output states.

    IPMI_Physical_Security_No_Event
        Defaults to Nominal.

    IPMI_Physical_Security_General_Chassis_Intrusion
        Defaults to Critical.

    IPMI_Physical_Security_Drive_Bay_Intrusion
        Defaults to Critical.

    IPMI_Physical_Security_IO_Card_Intrusion
        Defaults to Critical.

    IPMI_Physical_Security_Processor_Area_Intrusion
        Defaults to Critical.

    IPMI_Physical_Security_LAN_Leash_Lost
        Defaults to Critical.

    IPMI_Physical_Security_Unauthorized_Dock_Undock
        Defaults to Critical.

    IPMI_Physical_Security_FAN_Area_Intrusion
        Defaults to Critical.

IPMI_Platform_Security_Violation_Attempt
    The following states correspond to Platform Violation Attempt sensors w/ Platform Security Violation Attempt specific output states.

    IPMI_Platform_Security_Violation_Attempt_No_Event
        Defaults to Nominal.

    IPMI_Platform_Security_Violation_Attempt_Secure_Mode_Violation_Attempt
        Defaults to Critical.

    IPMI_Platform_Security_Violation_Attempt_Pre_Boot_Password_Violation_User_Password
        Defaults to Critical.

    IPMI_Platform_Security_Violation_Attempt_Pre_Boot_Password_Violation_Attempt_Setup_Password
        Defaults to Critical.

    IPMI_Platform_Security_Violation_Attempt_Pre_Boot_Password_Violation_Network_Boot_Password
        Defaults to Critical.

    IPMI_Platform_Security_Violation_Attempt_Other_Pre_Boot_Password_Violation
        Defaults to Critical.

    IPMI_Platform_Security_Violation_Attempt_Out_Of_Band_Access_Password_Violation
        Defaults to Critical.

IPMI_Processor
    The following states correspond to Processor sensors w/ Processor specific output states.

    IPMI_Processor_No_Event
        Defaults to Nominal.

    IPMI_Processor_IERR
        Defaults to Critical.

    IPMI_Processor_Thermal_Trip
        Defaults to Critical.

    IPMI_Processor_FRB1_BIST_Failure
        Defaults to Critical.

    IPMI_Processor_FRB2_Hang_In_POST_Failure
        Defaults to Critical.

    IPMI_Processor_FRB3_Processor_Startup_Initialization_Failure
        Defaults to Critical.

    IPMI_Processor_Configuration_Error
        Defaults to Critical.

    IPMI_Processor_SMBIOS_Uncorrectable_CPU_Complex_Error
        Defaults to Critical.

    IPMI_Processor_Processor_Presence_Detected
        Defaults to Nominal.

    IPMI_Processor_Processor_Disabled
        Defaults to Critical.

    IPMI_Processor_Terminator_Presence_Detected
        Defaults to Critical.

    IPMI_Processor_Processor_Automatically_Throttled
        Defaults to Warning.

    IPMI_Processor_Machine_Check_Exception
        Defaults to Critical.

    IPMI_Processor_Correctable_Machine_Check_Error
        Defaults to Warning.

IPMI_Processor_State
    The following states correspond to Processor sensors that report an assertion or deassertion.

    IPMI_Processor_State_No_Event
        Defaults to Nominal.

    IPMI_Processor_State_Deasserted
        Defaults to Nominal.

    IPMI_Processor_State_Asserted
        Defaults to Critical.

IPMI_Power_Supply
    The following states correspond to Power Supply sensors w/ Power Supply specific output states.

    IPMI_Power_Supply_No_Event
        Defaults to Nominal.

    IPMI_Power_Supply_Presence_Detected
        Defaults to Nominal.

    IPMI_Power_Supply_Power_Supply_Failure_Detected
        Defaults to Critical.

    IPMI_Power_Supply_Predictive_Failure
        Defaults to Critical.

    IPMI_Power_Supply_Power_Supply_Input_Lost_AC_DC
        Defaults to Critical.

    IPMI_Power_Supply_Power_Supply_Input_Lost_Or_Out_Of_Range
        Defaults to Critical.

    IPMI_Power_Supply_Power_Supply_Input_Out_Of_Range_But_Present
        Defaults to Critical.

    IPMI_Power_Supply_Configuration_Error
        Defaults to Critical.

IPMI_Power_Supply_State
    The following states correspond to Power_Supply sensors that report an assertion or deassertion.

    IPMI_Power_Supply_State_No_Event
        Defaults to Nominal.

    IPMI_Power_Supply_State_Deasserted
        Defaults to Critical.

    IPMI_Power_Supply_State_Asserted
        Defaults to Nominal.

IPMI_Power_Supply_Redundancy
    The following states correspond to Power Supply sensors that report on redundancy.

    IPMI_Power_Supply_Redundancy_No_Event
        Defaults to Nominal.

    IPMI_Power_Supply_Redundancy_Fully_Redundant
        Defaults to Nominal.

    IPMI_Power_Supply_Redundancy_Redundancy_Lost
        Defaults to Critical.

    IPMI_Power_Supply_Redundancy_Redundancy_Degraded
        Defaults to Warning.

    IPMI_Power_Supply_Redundancy_Non_Redundant_Sufficient_Resources_From_Redundant
        Defaults to Critical.

    IPMI_Power_Supply_Redundancy_Non_Redundant_Sufficient_Resources_From_Insufficient_Redundancy
        Defaults to Critical.

    IPMI_Power_Supply_Redundancy_Non_Redundant_Insufficient_Resources
        Defaults to Critical.

    IPMI_Power_Supply_Redundancy_Redundancy_Degraded_From_Fully_Redundant
        Defaults to Warning.

    IPMI_Power_Supply_Redundancy_Redundancy_Degraded_From_Non_Redundant
        Defaults to Warning.

IPMI_Power_Unit
    The following states correspond to Power Unit sensors w/ Power Unit specific output states.

    IPMI_Power_Unit_No_Event
        Defaults to Nominal.

    IPMI_Power_Unit_Power_Off_Power_Down
        Defaults to Nominal.

    IPMI_Power_Unit_Power_Cycle
        Defaults to Nominal.

    IPMI_Power_Unit_240VA_Power_Down
        Defaults to Warning.

    IPMI_Power_Unit_Interlock_Power_Down
        Defaults to Warning.

    IPMI_Power_Unit_AC_Lost
        Defaults to Critical.

    IPMI_Power_Unit_Soft_Power_Control_Failure
        Defaults to Critical.

    IPMI_Power_Unit_Power_Unit_Failure_Detected
        Defaults to Critical.

    IPMI_Power_Unit_Predictive_Failure
        Defaults to Critical.

IPMI_Power_Unit_Device_Present
    The following states correspond to Power Unit sensors that report on device installation.

    IPMI_Power_Unit_Device_Present_No_Event
        Defaults to Nominal.

    IPMI_Power_Unit_Device_Present_Device_Removed_Device_Absent
        Defaults to Critical.

    IPMI_Power_Unit_Device_Present_Device_Inserted_Device_Present
        Defaults to Nominal.

IPMI_Power_Unit_Redundancy
    The following states correspond to Power Unit sensors that report on redundancy.

    IPMI_Power_Unit_Redundancy_No_Event
        Defaults to Nominal.

    IPMI_Power_Unit_Redundancy_Fully_Redundant
        Defaults to Nominal.

    IPMI_Power_Unit_Redundancy_Redundancy_Lost
        Defaults to Critical.

    IPMI_Power_Unit_Redundancy_Redundancy_Degraded
        Defaults to Warning.

    IPMI_Power_Unit_Redundancy_Non_Redundant_Sufficient_Resources_From_Redundant
        Defaults to Critical.

    IPMI_Power_Unit_Redundancy_Non_Redundant_Sufficient_Resources_From_Insufficient_Redundancy
        Defaults to Critical.

    IPMI_Power_Unit_Redundancy_Non_Redundant_Insufficient_Resources
        Defaults to Critical.

    IPMI_Power_Unit_Redundancy_Redundancy_Degraded_From_Fully_Redundant
        Defaults to Warning.

    IPMI_Power_Unit_Redundancy_Redundancy_Degraded_From_Non_Redundant
        Defaults to Warning.

IPMI_Cooling_Device_Redundancy
    The following states correspond to Cooling Device sensors that report on redundancy.

    IPMI_Cooling_Device_Redundancy_No_Event
        Defaults to Nominal.

    IPMI_Cooling_Device_Redundancy_Fully_Redundant
        Defaults to Nominal.

    IPMI_Cooling_Device_Redundancy_Redundancy_Lost
        Defaults to Critical.

    IPMI_Cooling_Device_Redundancy_Redundancy_Degraded
        Defaults to Warning.

    IPMI_Cooling_Device_Redundancy_Non_Redundant_Sufficient_Resources_From_Redundant
        Defaults to Critical.

    IPMI_Cooling_Device_Redundancy_Non_Redundant_Sufficient_Resources_From_Insufficient_Redundancy
        Defaults to Critical.

    IPMI_Cooling_Device_Redundancy_Non_Redundant_Insufficient_Resources
        Defaults to Critical.

    IPMI_Cooling_Device_Redundancy_Redundancy_Degraded_From_Fully_Redundant
        Defaults to Warning.

    IPMI_Cooling_Device_Redundancy_Redundancy_Degraded_From_Non_Redundant
        Defaults to Warning.

IPMI_Memory
    The following states correspond to Memory sensors w/ Memory specific output states.

    IPMI_Memory_No_Event
        Defaults to Nominal.

    IPMI_Memory_Correctable_Memory_Error
        Defaults to Warning.

    IPMI_Memory_Uncorrectable_Memory_Error
        Defaults to Critical.

    IPMI_Memory_Parity
        Defaults to Critical.

    IPMI_Memory_Memory_Scrub_Failed
        Defaults to Critical.

    IPMI_Memory_Memory_Device_Disabled
        Defaults to Critical.

    IPMI_Memory_Correctable_Memory_Error_Logging_Limit_Reached
        Defaults to Warning.

    IPMI_Memory_Presence_Detected
        Defaults to Nominal.

    IPMI_Memory_Configuration_Error
        Defaults to Critical.

    IPMI_Memory_Spare
        Defaults to Nominal.

    IPMI_Memory_Memory_Automatically_Throttled
        Defaults to Warning.

    IPMI_Memory_Critical_Overtemperature
        Defaults to Critical.

IPMI_Memory_Redundancy
    The following states correspond to Cooling Device sensors that report on redundancy.

    IPMI_Memory_Redundancy_No_Event
        Defaults to Nominal.

    IPMI_Memory_Redundancy_Fully_Redundant
        Defaults to Nominal.

    IPMI_Memory_Redundancy_Redundancy_Lost
        Defaults to Critical.

    IPMI_Memory_Redundancy_Redundancy_Degraded
        Defaults to Warning.

    IPMI_Memory_Redundancy_Non_Redundant_Sufficient_Resources_From_Redundant
        Defaults to Critical.

    IPMI_Memory_Redundancy_Non_Redundant_Sufficient_Resources_From_Insufficient_Redundancy
        Defaults to Critical.

    IPMI_Memory_Redundancy_Non_Redundant_Insufficient_Resources
        Defaults to Critical.

    IPMI_Memory_Redundancy_Redundancy_Degraded_From_Fully_Redundant
        Defaults to Warning.

    IPMI_Memory_Redundancy_Redundancy_Degraded_From_Non_Redundant
        Defaults to Warning.

IPMI_Drive_Slot
    The following states correspond to Drive Slot sensors w/ Drive Slot specific output states.

    IPMI_Drive_Slot_No_Event
        Defaults to Nominal.

    IPMI_Drive_Slot_Drive_Presence
        Defaults to Nominal.

    IPMI_Drive_Slot_Drive_Fault
        Defaults to Critical.

    IPMI_Drive_Slot_Predictive_Failure
        Defaults to Critical.

    IPMI_Drive_Slot_Hot_Spare
        Defaults to Nominal.

    IPMI_Drive_Slot_Consistency_Check_Parity_Check_In_Progress
        Defaults to Nominal.

    IPMI_Drive_Slot_In_Critical_Array
        Defaults to Critical.

    IPMI_Drive_Slot_In_Failed_Array
        Defaults to Critical.

    IPMI_Drive_Slot_Rebuild_Remap_In_Progress
        Defaults to Nominal.

    IPMI_Drive_Slot_Rebuild_Remap_Aborted
        Defaults to Critical.

IPMI_Drive_Slot_State
    The following states correspond to Drive Slot sensors that report an assertion or deassertion.

    IPMI_Drive_Slot_State_No_Event
        Defaults to Nominal.

    IPMI_Drive_Slot_State_Deasserted
        Defaults to Warning.

    IPMI_Drive_Slot_State_Asserted
        Defaults to Nominal.

IPMI_Drive_Slot_Predictive_Failure
    The following states correspond to Drive_Slot sensors that report a predictive failure assertion or deassertion.

    IPMI_Drive_Slot_Predictive_Failure_No_Event
        Defaults to Nominal.

    IPMI_Drive_Slot_Predictive_Failure_Deasserted
        Defaults to Nominal.

    IPMI_Drive_Slot_Predictive_Failure_Asserted
        Defaults to Critical.

IPMI_Drive_Slot_Device_Present
    The following states correspond to Drive Slot sensors that report on device installation.

    IPMI_Drive_Slot_Device_Present_No_Event
        Defaults to Nominal.

    IPMI_Drive_Slot_Device_Present_Device_Removed_Device_Absent
        Defaults to Critical.

    IPMI_Drive_Slot_Device_Present_Device_Inserted_Device_Present
        Defaults to Nominal.

IPMI_System_Firmware_Progress
    The following states correspond to System Firmware Progress sensors w/ System Firmware Progress specific output states.

    IPMI_System_Firmware_Progress_No_Event
        Defaults to Nominal.

    IPMI_System_Firmware_Progress_System_Firmware_Error
        Defaults to Critical.

    IPMI_System_Firmware_Progress_System_Firmware_Hang
        Defaults to Critical.

    IPMI_System_Firmware_Progress_System_Firmware_Progress
        Defaults to Nominal.

IPMI_Event_Logging_Disabled
    The following states correspond to Event Logging Disabled sensors w/

    IPMI_Event_Logging_Disabled_No_Event
        Defaults to Nominal.

    IPMI_Event_Logging_Disabled_Correctable_Memory_Error_Logging_Disabled
        Defaults to Critical.

    IPMI_Event_Logging_Disabled_Event_Type_Logging_Disabled
        Defaults to Critical.

    IPMI_Event_Logging_Disabled_Log_Area_Reset_Cleared
        Defaults to Nominal.

    IPMI_Event_Logging_Disabled_All_Event_Logging_Disabled
        Defaults to Critical.

    IPMI_Event_Logging_Disabled_SEL_Full
        Defaults to Critical.

    IPMI_Event_Logging_Disabled_SEL_Almost_Full
        Defaults to Warning.

    IPMI_Event_Logging_Disabled_Correctable_Machine_Check_Error_Logging_Disabled
        Defaults to Critical.

IPMI_System_Event
    The following states correspond to System Event sensors w/ System Event specific output states.

    IPMI_System_Event_No_Event
        Defaults to Nominal.

    IPMI_System_Event_System_Reconfigured
        Defaults to Warning.

    IPMI_System_Event_OEM_System_Boot_Event
        Defaults to Nominal.

    IPMI_System_Event_Undetermined_System_Hardware_Failure
        Defaults to Critical.

    IPMI_System_Event_Entry_Added_To_Auxiliary_Log
        Defaults to Nominal.

    IPMI_System_Event_PEF_Action
        Defaults to Nominal.

    IPMI_System_Event_Timestamp_Clock_Sync
        Defaults to Warning.

IPMI_System_Event_State
    The following states correspond to System Event sensors that report an assertion or deassertion.

    IPMI_System_Event_State_No_Event
        Defaults to Nominal.

    IPMI_System_Event_State_Deasserted
        Defaults to Nominal.

    IPMI_System_Event_State_Asserted
        Defaults to Warning.

IPMI_Critical_Interrupt
    The following states correspond to Critical Interrupt sensors w/ Critical Interrupt specific output states.

    IPMI_Critical_Interrupt_No_Event
        Defaults to Nominal.

    IPMI_Critical_Interrupt_Front_Panel_NMI_Diagnostic_Interrupt
        Defaults to Critical.

    IPMI_Critical_Interrupt_Bus_Timeout
        Defaults to Critical.

    IPMI_Critical_Interrupt_IO_Channel_Check_NMI
        Defaults to Critical.

    IPMI_Critical_Interrupt_Software_NMI
        Defaults to Warning.

    IPMI_Critical_Interrupt_PCI_PERR
        Defaults to Critical.

    IPMI_Critical_Interrupt_PCI_SERR
        Defaults to Critical.

    IPMI_Critical_Interrupt_EISA_Fail_Safe_Timeout
        Defaults to Critical.

    IPMI_Critical_Interrupt_Bus_Correctable_Error
        Defaults to Warning.

    IPMI_Critical_Interrupt_Bus_Uncorrectable_Error
        Defaults to Critical.

    IPMI_Critical_Interrupt_Fatal_NMI
        Defaults to Critical.

    IPMI_Critical_Interrupt_Bus_Fatal_Error
        Defaults to Critical. IPMI_Critical_Interrupt_Bus_Degraded Defaults to Warning.

IPMI_Button_Switch
    The following states correspond to Button/Switch sensors w/ Button/Switch specific output states.

    IPMI_Button_Switch_No_Event
        Defaults to Nominal.

    IPMI_Button_Switch_Power_Button_Pressed
        Defaults to Nominal.

    IPMI_Button_Switch_Sleep_Button_Pressed
        Defaults to Nominal.

    IPMI_Button_Switch_Reset_Button_Pressed
        Defaults to Nominal.

    IPMI_Button_Switch_FRU_Latch_Open
        Defaults to Warning.

    IPMI_Button_Switch_FRU_Service_Request_Button
        Defaults to Warning.

IPMI_Button_Switch_State
    The following states correspond to Button/Switch sensors that report an assertion or deassertion.

    IPMI_Button_Switch_State_No_Event
        Defaults to Nominal.

    IPMI_Button_Switch_State_Deasserted
        Defaults to Nominal.

    IPMI_Button_Switch_State_Asserted
        Defaults to Nominal.

IPMI_Module_Board_State
    The following states correspond to Module/Board sensors that report an assertion or deassertion.

    IPMI_Module_Board_State_No_Event
        Defaults to Nominal.

    IPMI_Module_Board_State_Deasserted
        Defaults to Nominal.

    IPMI_Module_Board_State_Asserted
        Defaults to Critical.

IPMI_Module_Board_Device_Present
    The following states correspond to Module/Board sensors that report on device installation.

    IPMI_Module_Board_Device_Present_No_Event
        Defaults to Nominal.

    IPMI_Module_Board_Device_Present_Device_Removed_Device_Absent
        Defaults to Critical.

    IPMI_Module_Board_Device_Present_Device_Inserted_Device_Present
        Defaults to Nominal.

IPMI_Chip_Set_Transition_Severity
    The following states correspond to Chip Set sensors that report on device severity.

    IPMI_Chip_Set_Transition_Severity_No_Event
        Defaults to Nominal.

    IPMI_Chip_Set_Transition_Severity_Transition_To_OK
        Defaults to Nominal.

    IPMI_Chip_Set_Transition_Severity_Transition_To_Non_Critical_From_OK
        Defaults to Warning.

    IPMI_Chip_Set_Transition_Severity_Transition_To_Critical_From_Less_Severe
        Defaults to Critical.

    IPMI_Chip_Set_Transition_Severity_Transition_To_Non_Recoverable_From_Less_Severe
        Defaults to Critical.

    IPMI_Chip_Set_Transition_Severity_Transition_To_Non_Critical_From_More_Severe
        Defaults to Warning.

    IPMI_Chip_Set_Transition_Severity_Transition_To_Critical_From_Non_Recoverable
        Defaults to Critical.

    IPMI_Chip_Set_Transition_Severity_Transition_To_Non_Recoverable
        Defaults to Critical.

    IPMI_Chip_Set_Transition_Severity_Monitor
        Defaults to Warning.

    IPMI_Chip_Set_Transition_Severity_Informational
        Defaults to Nominal.

IPMI_Cable_Interconnect
    The following states correspond to Cable/Interconnect sensors w/ Cable/Interconnect specific output states.

    IPMI_Cable_Interconnect_No_Event
        Defaults to Nominal.

    IPMI_Cable_Interconnect_Is_Connected
        Defaults to Nominal.

    IPMI_Cable_Interconnect_Configuration_Error
        Defaults to Critical.

IPMI_Boot_Error
    The following states correspond to Boot Error sensors w/ Boot Error specific output states.

    IPMI_Boot_Error_No_Event
        Defaults to Nominal.

    IPMI_Boot_Error_No_Bootable_Media
        Defaults to Critical.

    IPMI_Boot_Error_Non_Bootable_Diskette_Left_In_Drive
        Defaults to Critical.

    IPMI_Boot_Error_PXE_Server_Not_Found
        Defaults to Critical.

    IPMI_Boot_Error_Invalid_Boot_Sector
        Defaults to Critical.

    IPMI_Boot_Error_Timeout_Waiting_For_User_Selection_Of_Boot_Source
        Defaults to Warning.

IPMI_Slot_Connector
    The following states correspond to Slot Connector sensors w/ Slot Connector specific output states.

    IPMI_Slot_Connector_No_Event
        Defaults to Nominal.

    IPMI_Slot_Connector_Fault_Status_Asserted
        Defaults to Critical.

    IPMI_Slot_Connector_Identify_Status_Asserted
        Defaults to Warning.

    IPMI_Slot_Connector_Slot_Connector_Device_Installed_Attached
        Defaults to Nominal.

    IPMI_Slot_Connector_Slot_Connector_Ready_For_Device_Installation
        Defaults to Nominal.

    IPMI_Slot_Connector_Slot_Connector_Ready_For_Device_Removal
        Defaults to Nominal.

    IPMI_Slot_Connector_Slot_Power_Is_Off
        Defaults to Nominal.

    IPMI_Slot_Connector_Slot_Connector_Device_Removal_Request
        Defaults to Warning.

    IPMI_Slot_Connector_Interlock_Asserted
        Defaults to Warning.

    IPMI_Slot_Connector_Slot_Is_Disabled
        Defaults to Warning.

    IPMI_Slot_Connector_Slot_Holds_Spare_Device
        Defaults to Nominal.

IPMI_System_ACPI_Power_State

    IPMI_System_ACPI_Power_State_No_Event
        Defaults to Nominal.

    IPMI_System_ACPI_Power_State_S0_G0
        Defaults to Nominal.

    IPMI_System_ACPI_Power_State_S1
        Defaults to Nominal.

    IPMI_System_ACPI_Power_State_S2
        Defaults to Nominal.

    IPMI_System_ACPI_Power_State_S3
        Defaults to Nominal.

    IPMI_System_ACPI_Power_State_S4
        Defaults to Nominal.

    IPMI_System_ACPI_Power_State_S5_G2
        Defaults to Nominal.

    IPMI_System_ACPI_Power_State_S4_S5_Soft_Off
        Defaults to Nominal.

    IPMI_System_ACPI_Power_State_G3_Mechanical_Off
        Defaults to Nominal.

    IPMI_System_ACPI_Power_State_Sleeping_in_an_S1_S2_or_S3_States
        Defaults to Nominal.

    IPMI_System_ACPI_Power_State_G1_Sleeping
        Defaults to Nominal.

    IPMI_System_ACPI_Power_State_S5_Entered_By_Override
        Defaults to Nominal.

    IPMI_System_ACPI_Power_State_Legacy_ON_State
        Defaults to Nominal.

    IPMI_System_ACPI_Power_State_Legacy_OFF_State
        Defaults to Nominal.

    IPMI_System_ACPI_Power_State_Unspecified
        Defaults to Critical.

    IPMI_System_ACPI_Power_State_Unknown
        Defaults to Critical.

IPMI_Watchdog2
    The following states correspond to Watchdog 2 sensors w/ Watchdog 2 specific output states.

    IPMI_Watchdog2_No_Event
        Defaults to Nominal.

    IPMI_Watchdog2_Timer_Expired
        Defaults to Warning.

    IPMI_Watchdog2_Hard_Reset
        Defaults to Critical.

    IPMI_Watchdog2_Power_Down
        Defaults to Critical.

    IPMI_Watchdog2_Power_Cycle
        Defaults to Critical.

    IPMI_Watchdog2_Reserved1
        Defaults to Nominal.

    IPMI_Watchdog2_Reserved2
        Defaults to Nominal.

    IPMI_Watchdog2_Reserved3
        Defaults to Nominal.

    IPMI_Watchdog2_Reserved4
        Defaults to Nominal.

    IPMI_Watchdog2_Timer_Interrupt
        Defaults to Warning.

IPMI_Entity_Presence
    The following states correspond to Entity Presence sensors w/ Entity Presence specific output states.

    IPMI_Entity_Presence_No_Event
        Defaults to Nominal.

    IPMI_Entity_Presence_Entity_Present
        Defaults to Nominal.

    IPMI_Entity_Presence_Entity_Absent
        Defaults to Critical.

    IPMI_Entity_Presence_Entity_Disabled
        Defaults to Critical.

IPMI_Entity_Presence_Device_Present
    The following states correspond to Entity Presence sensors that report on device installation.

    IPMI_Entity_Presence_Device_Present_No_Event
        Defaults to Nominal.

    IPMI_Entity_Presence_Device_Present_Device_Removed_Device_Absent
        Defaults to Nominal.

    IPMI_Entity_Presence_Device_Present_Device_Inserted_Device_Present
        Defaults to Nominal.

IPMI_Management_Subsystem_Health
    The following states correspond to Management Subsystem Health sensors w/ Management Subsystem Health specific output states.

    IPMI_Management_Subsystem_Health_No_Event
        Defaults to Nominal.

    IPMI_Management_Subsystem_Health_Sensor_Access_Degraded_Or_Unavailable
        Defaults to Critical.

    IPMI_Management_Subsystem_Health_Controller_Access_Degraded_Or_Unavailable
        Defaults to Critical.

    IPMI_Management_Subsystem_Health_Management_Controller_Off_Line
        Defaults to Critical.

    IPMI_Management_Subsystem_Health_Management_Controller_Unavailable
        Defaults to Critical.

    IPMI_Management_Subsystem_Health_Sensor_Failure
        Defaults to Critical.

    IPMI_Management_Subsystem_Health_FRU_Failure
        Defaults to Critical.

IPMI_Battery
    The following states correspond to Battery sensors w/ Battery specific output states.

    IPMI_Battery_No_Event
        Defaults to Nominal.

    IPMI_Battery_Battery_Low
        Defaults to Warning.

    IPMI_Battery_Battery_Failed
        Defaults to Critical.

    IPMI_Battery_Battery_Presence_Detected
        Defaults to Nominal.

IPMI_FRU_State
    The following states correspond to FRU State sensors w/ FRU State specific output states.

    IPMI_FRU_State_No_Event
        Defaults to Nominal.

    IPMI_FRU_State_FRU_Not_Installed
        Defaults to Critical.

    IPMI_FRU_State_FRU_Inactive
        Defaults to Critical.

    IPMI_FRU_State_FRU_Activation_Requested
        Defaults to Warning.

    IPMI_FRU_State_FRU_Activation_In_Progress
        Defaults to Warning.

    IPMI_FRU_State_FRU_Active
        Defaults to Nominal.

    IPMI_FRU_State_FRU_Deactivation_Requested
        Defaults to Warning.

    IPMI_FRU_State_FRU_Deactivation_In_Progress
        Defaults to Warning.

    IPMI_FRU_State_FRU_Communication_Lost
        Defaults to Critical.

IPMI_OEM
    The following configuration options can be used to configure OEM specific interpretations. Users should be aware that both IPMI_OEM_Bitmask and IPMI_OEM_Value can be configured for an identical Manufacturer-ID, Product-ID, Event-Reading-Type-Code, and Sensor-Type combination. All interpretations rules for a specific combination are iterated through and the worst resulting sensor state is returned (i.e. Warning < Nominal, Critical < Warning). If no match is found, no sensor state is returned for the OEM sensor reading. For each of the configuration options below, <Manufacturer-ID> is the numeric IANA manufacturer ID for the manufacturer in question. The <Product-ID> is one or more numeric IDs representing the manufacturer's product. The <Product-ID> can be listed as a single numeric number (e.g. 1234), a range of IDs separated by a dash (e.g. 12-20), or a list of specific product IDs separted by a plus (e.g. 12+19+22). Both the Manufacturer-ID and Product-ID can be found using bmc-info(8). Multiple <Manufacturer-ID> and <Product-ID> pairs can be input separated by commas. The Event-Reading-Type-Code and Sensor-Type need not be OEM types. They may be non-OEM types and used to provide interpretation rules for sensors that may be behaving outside the standard of the IPMI specification.

    IPMI_OEM_Bitmask <Manufacturer-ID>:<Product-ID>,... Event-Reading-Type-Code Sensor-Type Sensor-Event-Bitmask State
        IPMI_OEM_Bitmask can be used to configure a state interpretation for a specific Manufacturer-ID, Product-ID, Event-Reading-Type-Code, and Sensor-Type combination and a specific bitmask of the Sensor-Event. The state will be accepted as the sensor interpretation if the inputted bitmask ANDed with the actual sensor event bitmask reading is true. As a special case, the state will be accepted if the inputted bitmask and the actual sensor event bitmask are both 0. In other words, if no events happened, an OEM interpretation can be configured for this case by inputing a bitmask of 0x0000.

    IPMI_OEM_Value <Manufacturer-ID>:<Product-ID>,... Event-Reading-Type-Code Sensor-Type Sensor-Event-Bitmask-Value State
        IPMI_OEM_Value can be used to configure a state interpretation for a specific Manufacturer-ID, Product-ID, Event-Reading-Type-Code, and Sensor-Type combination and a specific value for the Sensor-Event-Bitmask. The state will be accepted as the sensor interpretation if the inputted bitmask value is equal to the actual sensor event bitmask reading.

FILES
/usr/local/etc/freeipmi/freeipmi_interpret_sensor.conf

REPORTING BUGS
Report bugs to <freeipmi-users@gnu.org> or <freeipmi-devel@gnu.org>.

COPYRIGHT
Copyright (C) 2007-2012 Lawrence Livermore National Security, LLC.

This library is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version.

SEE ALSO
libfreeipmi(3), libipmimonitoring(3), ipmi-sensors(8)

http://www.gnu.org/software/freeipmi/