sensor(8) - Linux man page

Name

sensor - show Sensor Data Records

Synopsis

sensor [-acmpstwx -i id -n snum -h tval -l tval -NUPRETVF]

Description

sensor is a program that uses IPMI commands to show and decode Sensor Data Records and current sensor readings for all sensors in the system. The readings are only retrieved for Full SDR records. This utility can use either the /dev/ipmi0 driver from OpenIPMI, the /dev/imb driver from Intel, the /dev/ipmikcs driver from valinux, direct user-space IOs, or the IPMI LAN interface if -N.

Note that this utility currently only displays Sensor Data Records reported by from the BMC chipset. Some systems may have other devices with sensors that are also available via IPMI.

Options

Command line options are described below.
-a snum
ReArms the sensor number for events
-c
Shows SDRs for the Child MCs on a PICMG or ATCA system.
-h tval
Highest threshold value to set for the specified sensor. This tval can be in decimal, or of the form 0x1a, to match the raw reading value shown by sensor following the " = ". The value passed is set as the highest threshold value, with the less critical ones set by the utility as incrementally lower. This simplifies the interface and ensures that the threshold values do not get out of order. This requires specifying the sensor number via -n.
-i id
Show or set only the sensor Index corresponding to id, where id is the hex ID of the SDR as shown in the sensor output under "_ID_". This is useful to repeatedly view just one sensor reading for changes, or to set just one sensor quickly without reading all of the SDRs.
-l tval
Lowest threshold value to set for the specified sensor. This tval can be in decimal, or of the form 0x1a, to match the raw reading value shown by sensor following the " = ". The value passed is set as the lowest threshold value, with the less critical ones set by the utility as incrementally higher. This simplifies the interface and ensures that the threshold values do not get out of order. This requires specifying the sensor number via -n.
-m 002000
Show SDRs for a specific MC (e.g. bus 00, sa 20, lun 00). This would be used for PICMG or ATCA blade systems.
-n snum
Number of the sensor to set. This num can be in decimal, or of the form 0x1a, to match the value shown by sensor following the "snum" tag. This is required if setting hi/lo thresholds via -h/-l.
-p
Persist the threshold being set (as specified via -l or -h). This writes a "sensor -i" script line to the file /usr/share/ipmiutil/thresholds.sh, which can then be executed at each reboot by including it in /etc/init.d for the desired runlevel. For Windows, the filename is thresholds.cmd.
-r
Show Raw SDR bytes also.
-s
Show sensor list in a simpler format without uninterpreted binary values. Only the user-friendly interpreted sensor information is shown.
-t
Show any Thresholds for each sensor also.
-w
Wrap the threshold data onto the same line as the sensor. This may be convenient for scripting.
-x
Causes eXtra debug messages to be displayed.
-N nodename
Nodename or IP address of the remote target system. If a nodename is specified, IPMI LAN interface is used. Otherwise the local system management interface is used.
-P/-R rmt_pswd
Remote password for the nodename given. The default is a null password.
-U rmt_user
Remote username for the nodename given. The default is a null username.
-E
Use the remote password from Environment variable IPMI_PASSWORD.
-F drv_t
Force the driver type to one of the followng: imb, va, open, gnu, landesk, lan2, lan, kcs, smb. The default is to detect any available driver type and use it.
-T
Use a specified IPMI LAN Authentication Type: 0=None, 1=MD2, 2=MD5, 4=Straight Password, 5=OEM.
-V
Use a specified IPMI LAN privilege level. 1=Callback level, 2=User level, 3=Operator level, 4=Administrator level (default), 5=OEM level.
-Y
Yes, do prompt the user for the IPMI LAN remote password. Alternatives for the password are -E or -P.

See Also

alarms(8) bmchealth(8) fruconfig(8) getevent(8) hwreset(8) icmd(8) pefconfig(8) showsel(8) tmconfig(8) wdt(8)

Warnings

See http://ipmiutil.sourceforge.net/ for the latest version of sensor and any bug fix list.

Copyright

Copyright © 2001-2003 Intel Corp.

See the file COPYING in the distribution for more details regarding redistribution.

This utility is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY.

Author

Andy Cress <arcress@users.sourceforge.net>

Referenced By

isolconsole(8)