HWdiag Commands and Options

Language:

The following tables list the HWdiag utility commands and options.

Note - Not all commands are available on all platforms. To find out which commands are available on your system, enter hwdiag -h.

HWdiag Commands

Component	Action	Options	Description and Options
cpld			CPLD, FPGA tests, and utilities.
	reg	all\|`fgpa`	Dump CPLD registers.
	vr_check		Print voltage regulator status.
	log read `number_of_ last_entries`		Read the last three entries from the cpld log file.
	mbus		(X8-8 only) Check MBUS status.
cpu			Display CPU information.
	capid all\|`cpu`		Decode CAPID values for CPU.
	info all\|`cpu`	-v	Dump CPU devices and display coding for all registers.
	pirom_info all\|`cpu`		Dump PIROM CPU information.
fan			Fan test and utilities.
	get	-m	Display fan RPM.
	info	-r	Display fan presence information.
gpio			GPIO utilities.
gpio	get all\|`gpio_pin`		Get information about GPIO pin.
i2c			Test the sideband i2c topology.
	scan all\|`bus`		Display accessible i2c devices.
	test all\|`bus`		Test connectivity of platform i2c devices. This test returns a pass or fail.
io			IO tests and utilities.
	nvme_info	-v	Display information from VPD and MI for NVMe devices.
	nvme_test	-v	Check for PCIe link width and speed of NVMe drives and NVMe add-in-cards.
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, such as 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.
	read		Read the specified PCIe register. read <socket> <bus> <dev> <func> <offset>
	scan		Scan all PCIe devices.
	status all\|`pci-target(s)`		Print status of pci-target(s)
power			Display power information.
	get		Display sensor readings. get amps\|volts\|watts all\|`sensor`.
	info all\|`sensor`		Display information about voltage reduction devices (VRD). `sensor` identifies an individual sensor.
system			Display system information.
	summary		Display system summary.
	fabric test all\| `cpu`		Test the system fabric, including QPI bus speed, PCIe link speed, and memory frequency.
	info		Display system configuration information.
	port80 `number_of_last_codes`	-m	Display host boot progress. Optionally, enter the number of last codes to show the last codes for port80.
	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 temperature sensors.

HWdiag Command Options

The following table lists the HWdiag command options.

Option	Long	Description
– f	force	Force execution of a command regardless of prerequisites.*
– h	help	Display help test.
– i	interactive	Prompts when you use it with a main command.*
– l	log <`filename`>	Enable HWdiag to start logging to <`filename`>. Note - Use -t to add time stamp to logging.
– m	monitor <.1 sec>	Set monitoring interval in increments of tenths of a second (.1 second). Overrides current monitoring interval.*
– n	numberloop	Set the number of loops to run a command continually.
– p	persist	Use persistent hardware presence data for all invocations of any HWdiag command.
– q	quiterr	Exit HWdiag utility immediately after an error occurs.
– r	raw	Modify HWdiag output for easier parsing.*
– s	sampleint	Sample interval in seconds to set the number of seconds of sleep between collecting data samples. Use only with -n option.
– t	timestamp	Add time stamp to logging. Use with -l option.
– u	unit [ 1,2,4 ]	Control the output format of dump subcommands. Options are 1 byte (default), 2 byte, or 4 byte format.*
– v	verbose	Enhance the verbosity of output.*
– x	exclude	Exclude a feature.*

Note - *Implement the HWdiag command option only on subcommands. For details on the syntax, refer to the subcommand documentation or display the help by typing help hwdiag -hv.