Provided by: ipmiutil_2.9.7-1_i386 bug

NAME

       ipmiutil_sensor - show Sensor Data Records

SYNOPSIS

       ipmiutil  sensor  [-abcdefgmpqrstuvwx  -i  id  -n  snum -h tval -l tval
       -NUPREFJTVY]

DESCRIPTION

       ipmiutil 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.  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 by default only  displays  Sensor  Data  Records
       reported  by from the Baseboard Management Controller.  To show sensors
       for other controllers, see options -b and -m below.

OPTIONS

       Command line options are described below.

       -a snum
              ReArms the sensor number for events

       -b     Shows SDRs for Bladed (PICMG or ATCA) systems by traversing  the
              child MCs (same as -e).

       -c     Show   sensor   list   in  a  simpler/Canonical  format  without
              uninterpreted binary values.  Only the user-friendly interpreted
              sensor information is shown.  (same as -s).

       -d <file>
              Dump the SDRs to a specified binary file.

       -e     Show  Every  SDR  in a bladed system by traversing the child MCs
              (same as -b).

       -f <file>
              Restore the SDRs  from  the  specified  binary  File.   This  is
              normally only done with the initial factory provisioning.

       -g sens_type
              Shows only those SDRs matching the given sensor type group.  The
              sens_type string can be "fan", "temp", "voltage", or any  string
              or  substring  matching  those  in  the  IPMI 2.0 Table 42-3 for
              Sensor Types.  Multiple types can  be  listed,  separated  by  a
              comma (,) but no spaces.

       -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 non-critical threshold value, with the more
              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_".  The ID argument can be one hex  number  (e.g.  0x0e  or
              0e),  or  a  range  of  hex  numbers  (e.g.  0e-1a  or  1a,2a or
              0x0e-0x2a).  This is useful to repeatedly view just a few sensor
              readings  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 non-critical threshold value, with the more
              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 002000s
              Show  SDRs for a specific MC (e.g. bus 00, sa 20, lun 00).  This
              could be used for PICMG or ATCA  blade  systems.   The  trailing
              character,  if present, indicates SMI addressing if 's', or IPMB
              addressing if 'i' or not present.

       -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.

       -o     Output  the memory DIMM information from SMBIOS, including size.
              Not available if using IPMI LAN via -N.  Sample output:
              Memory Device (0,0): DIMM_A1 : size=2048MB
              Memory Device (0,1): DIMM_A2 : not present

       -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  starting the /etc/init.d/ipmi_port service for
              the  desired  runlevels.    For   Windows,   the   filename   is
              thresholds.cmd.

       -q     Show  any  thresholds  for  each sensor in short format with ':'
              delimiters, useful as an example  for  setting  thresholds  with
              '-u'.

       -r     Show Raw SDR bytes also.

       -s     Show   sensor   list   in  a  simpler/canonical  format  without
              uninterpreted binary values.  Only the user-friendly interpreted
              sensor information is shown.  (same as -c).

       -t     Show any Thresholds for each sensor also, in text format.

       -u     Set  unique  threshold  values.   The  values are specified in a
              string of threshold values.  It can be in raw hex characters  or
              in  float  values.  All 6 possible thresholds must be specified,
              but only the ones  that  are  valid  for  this  sensor  will  be
              applied. These values are validated for ordering.  For example:
                -u 6:5:4:60:65:69 (float) or
                -u 0x0605043c4145 (raw hex)
               would   mean   0x06=noncrit_lo,  0x05=crit_lo,  0x04=nonrec_lo,
              0x3c=noncrit_hi, 0x41=crit_hi, 0x45=nonrec_hi.

       -v     Show  Verbose  output,  including   volatile   thresholds,   SDR
              thresholds, max/min, hysteresis, and BMC_TAM decoding.

       -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.

       -L n   Loop n times.  This is useful along  with  -i.  Default  is  one
              loop.

       -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, lan, lan2, lan2i, kcs, smb.  Note that lan2i means
              lan2  with  intelplus.   The  default is to detect any available
              driver type and use it.

       -J     Use  the  specified  LanPlus   cipher   suite   (0   thru   17):
              0=none/none/none,       1=sha1/none/none,      2=sha1/sha1/none,
              3=sha1/sha1/cbc128,  4=sha1/sha1/xrc4_128,  5=sha1/sha1/xrc4_40,
              6=md5/none/none, ... 14=md5/md5/xrc4_40.  Default is 3.

       -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.

EXAMPLES

       ipmiutil sensor sample output is below.
       ipmiutil ver 2.21
       sensor: version 2.21
       -- BMC version 0.17, IPMI version 2.0
       _ID_  SDR_Type_xx  ET  Own  Typ  S_Num  Sens_Description   Hex & Interp
       Reading
       000b SDR Full 01 01 20 a 01 snum 30 Baseboard Temp   =  2e  OK    46.00
       degrees C
       000e  SDR Full 01 01 20 m 04 snum 50 Fan 1A           = 6f OK   7659.00
       RPM
       0042 SDR Comp 02 6f 20 a 21 snum e0 DIMM 1A           =  00  c0  04  00
       Present
       004e SDR FRU  11 1b dev: 20 03 80 00 0a 01 Pwr Supply 1 FRU
       0050 SDR IPMB 12 1b dev: 20 00 bf 07 01 Basbrd Mgmt Ctlr
       0051 SDR OEM  c0 09 Intel: 02 02 00 01 70 71
       0065 SDR OEM  c0 11 Intel: SDR Package 17
       [...]

       Output Columns:
       _ID_:  This  is  an SDR ID or index number, in hex.  This may vary from
       chassis to chassis.
       SDR_Type_xx: This shows the SDR Type and its hex representation.   Some
       SDR types have a custom display.  The OEM SDRs only show the OEM vendor
       by IANA number and then usually the data is listed in hex.
       ET: For Full or Comp SDRs, this shows the Event Type.  For other  SDRs,
       this shows the size of the SDR entry in hex (Sz).
       Own: This is the hex slave address of the SDR Owner, usually 20 if BMC.
       a/m:  This  indicates  whether  this  sensor is either automatically or
       manually rearmed, respectively.
       Typ: This is the Sensor Type as defined in Table 42-3 of the  IPMI  2.0
       spec.  (01 = Temperature, 02 = Voltage, 03 = Current, 04 = Fan, etc.)
       S_Num:  This  is  the  sensor  number  in hex.  This remains consistent
       across baseboards of the same type.  The output can be parsed with  the
       "snum" delimiter to extract this value.
       Sens_Description:  This  is  the text description of this SDR, which is
       stored within the SDR on the BMC.
       Hex  &  Interp  Reading:  This  is  the  raw  hex  value  returned   by
       GetSensorReading, and its interpreted meaning.

SEE ALSO

       ipmiutil(8)   ialarms(8)  iconfig(8)  icmd(8)  idiscover(8)  ievents(8)
       ifru(8) igetevent(8) ihealth(8) ilan(8)  ireset(8)  isel(8)  iserial(8)
       isol(8) iwdt(8)

WARNINGS

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

COPYRIGHT

       Copyright (C) 2009  Kontron America, Inc.

       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 at users.sourceforge.net>

                           Version 1.6: 09 Nov 2011                 ISENSOR(8)