Go to main content

Oracle® x86 Server Diagnostics, Applications, and Utilities Guide

Exit Print View

Updated: June 2016
 
 

HWdiag Commands

This section describes how to use the HWdiag command line.

Using the HWdiag Command Line

HWdiag commands use the form hwdiag main-command [subcommand ...].

For example:

[(restricted_shell) ORACLESP-XXxxXXxxXXxx:~]# hwdiag led get /SYS/MB/P1/MR0/D1/SERVICE
HWdiag (Restricted Mode) - Build Number 81018 (May 12 2013 at 00:42:14)
  LED                             VALUE
  ------------------------------------------
  /SYS/MB/P1/MR0/D1/SERVICE     : off

[(restricted_shell) ORACLESP-XXxxXXxxXXxx:~]#

Many subcommands require an additional subcommand to identify the actual device or devices being acted on. This target can be an individual device or all, which represents all the valid targets for the subcommand. In the above example, hwdiag led get /SYS/MB/P1/MR0/D1/SERVICE returns the state of a single LED. If you enter hwdiag led get all, it displays the state of all the system LEDs.


Note - Main commands and subcommands are case insensitive. However hwdiag is not. For example, hwdiag led get all is the same as hwdiag LED GET ALL.

If you enter an incomplete command line, HWdiag displays the syntax for the command and a list of valid subcommands. Use this information to re-enter the command with a complete and valid set of parameters and subcommands.

The following display shows an example.

[(flash)root@ORACLESP-XXxxXXxxXXxx:~]# hwdiag temp
HWdiag - Build Number 81018 (May 12 2013 at 00:42:14)

Syntax: hwdiag temp ...

   get [all|<sensor>]
              - Display Temperature Sensor Reading
   info [all|<sensor>]
              - Display Temperature Sensor Information
[(flash)root@ORACLESP-XXxxXXxxXXxx:~]# hwdiag temp get
HWdiag - Build Number 81018 (May 12 2013 at 00:42:14)

Syntax: hwdiag temp get all|<sensor>

Valid Options for Temperature :
  ALL                             /SYS/MB/T_IN_PS
  /SYS/MB/P0                      /SYS/MB/T_IN_ZONE1
  /SYS/MB/P1                      /SYS/MB/T_IN_ZONE2
  /SYS/MB/P2                      /SYS/MB/T_IN_ZONE3
  /SYS/MB/P3                      /SYS/MB/T_IN_ZONE4
  /SYS/MB/T_CORE_NET01            /SYS/MB/T_OUT_SLOT1
  /SYS/MB/T_CORE_NET23            /SYS/T_FRONT
[(flash)root@ORACLESP-XXxxXXxxXXxx:~]# hwdiag temp get all
HWdiag - Build Number 81018 (May 12 2013 at 00:42:14)
  DEVICE                          TEMP
  -------------------------------------------
  /SYS/MB/P0                    : 64.00 margin
  /SYS/MB/P1                    : 64.00 margin
  /SYS/MB/P2                    : 63.00 margin
  /SYS/MB/P3                    : 64.00 margin
  /SYS/MB/T_CORE_NET01          : 38.75 deg C
  /SYS/MB/T_CORE_NET23          : 38.00 deg C
  /SYS/MB/T_IN_PS               : 26.75 deg C
  /SYS/MB/T_IN_ZONE1            : 30.75 deg C
  /SYS/MB/T_IN_ZONE2            : 30.75 deg C
  /SYS/MB/T_IN_ZONE3            : 29.50 deg C
  /SYS/MB/T_IN_ZONE4            : 28.25 deg C
  /SYS/MB/T_OUT_SLOT1           : 29.75 deg C
  /SYS/T_FRONT                  : 24.50 deg C

Command Descriptions

The following table lists the HWdiag commands.


Note - Not all commands are available on all platforms. To find out which commands are available on your system, enter hwdiag –h.
Table 1  HWdiag Commands
Component
Action
Options
Description and Options
cpld
Power and CPLD commands.
reg
Dump CPLD registers.
vr_check
Print voltage regulator status.
log
Read and clear FPGA event log and trigger an event in log.
cpu
Display CPU information.
info all|cpu
-r
Dump CPU devices.
fan
Fan test/utilities.
get
-m
Display fan RPM.
info
Displays fan presence information.
testpsu
Check PSU (power supply) fans.
test chassis fans
Check chassis fans.
gpio
SP GPIO.
get gpio_pin
-r
Get information about specific pins.
i2c
Test the sideband i2c topology.
scan all|bus
Display all accessible i2c devices.
test all|bus
Test connectivity of all platform i2c devices. This test returns a pass or fail.
led
Get information about LEDs.
get all|led
Display the state of LEDs.
info all|led
Display information about LED registers.
mem
Display memory (DIMM) information.
info all|dimm name
Display memory configuration.
spd all|dimm name
-r
Display DIMM SPD information, which includes things like size, speed, and voltage. The information displayed varies according to manufacturer.
pci
PCIe tests and utilities.
dump
Read PCIe registers.
dump <socket> <bus> <dev> <func> [std|ext]|[<offset> <count>]
  • std reads the entire space

  • ext reads the extended space

  • <offset><count> specifies a single register

info all|device
-r
Display PCIe link information for all, or for a single device.
lspci
Display all PCIe devices, Linux style.
read
Read the specified PCIe register.
read <socket> <bus> <dev> <func> <offset>
power
Display power information.
get
Display sensor readings.
get amps|volts|watts all|sensor.
sensor identifies an individual sensor.
info all|sensor
Display information about sensors.
system
summary
Display system summary.
fabric test all
Test the system fabric, including QPI bus speed, PCIe link speed, and memory frequency.
info
Display system configuration information.
port80
-m
Display host boot progress by monitoring port 80. The default interval is 5ms.
rtc
Display the real time clock (RTC).
thermal
-m, –r
Display system thermal information, including temperatures, fan speeds, and power.
version
Display the version of system components.
temp
Display temperatures.
get all|sensor
Display temperature sensor readings.
info all|sensor
Display information about system sensors.
Table 2  Options
Option
Long
Description
– h
help
Display help.
– l
log <filename>
Enable HWdiag to start logging to filename.

Note - Use – t to add time stamp to logging.

– t
timestamp
Add timestamp to logging. Use with – l option.
– m
monitor <.1 sec>
Set monitoring interval in increments of tenths of a second (.1 second). Overrides current monitoring interval.
– r
raw
Modify HWdiag output for easier parsing.
– i
interactive
Prompts when used with a main command.