hw-probe 命令

常用示例

说明

hw-probe collects a snapshot of a machine's hardware configuration and the related kernel/userspace logs, then optionally uploads it to the public Linux Hardware Database at linux-hardware.org. The uploaded probe gets a permanent URL that can be shared on bug trackers, mailing lists, or vendor support requests. A probe combines the output of standard tools (lspci, lsusb, lscpu, dmidecode, smartctl, lshw, edid, dmesg, Xorg.log, etc.) into a structured, anonymized bundle. The database aggregates these reports to track hardware compatibility across Linux distributions, identify suitable drivers for unsupported devices, and recommend kernels known to work with a given configuration. The tool also doubles as a self-monitoring agent: with -start it adds a cron job that runs daily, compares the new probe with the previous one and emails the user if a disk SMART error, missing device, or other anomaly appears. It is widely used by distributions, vendors, and end users to diagnose driver issues, plan upgrades, and inventory fleets of machines.

参数

-all

Probe for all hardware. Equivalent to enabling every individual probe collector.

-probe

Probe for hardware (a lighter probe than -all).

-logs

Collect system logs (dmesg, journal, lspci, lsusb, etc.).

-log-level _N_

Set log collection verbosity: `mini`, `default`, or `maximal`.

-upload

Upload the resulting probe to linux-hardware.org and print the public URL.

-check

Run operability sanity tests on graphics, drive, CPU and memory.

-check-graphics

Test integrated and discrete graphics with glxgears.

-check-hdd

Test drive read speed with hdparm.

-check-cpu

Test CPU using dd and md5sum.

-check-memory

Test RAM with memtester.

-id _DESC_, -name _DESC_

Set a custom name or description for the probe.

-i _ID_

Tag the probe with an inventory identifier.

-generate-inventory, -generate-inventory-id

Request a new inventory ID, linked to -email.

-email _ADDR_

Email address to associate with a generated inventory ID.

-disable _A,B,C_

Disable specific log collectors (e.g. `xdpyinfo,xorg.conf`).

-enable _A,B,C_

Force-enable specific log collectors disabled by default.

-dump-acpi

Dump the ACPI tables.

-decode-acpi

Decode dumped ACPI tables (requires acpica-tools).

-show

Show summary of probe data on the console.

-verbose

Print detailed log output during probing.

-pci-ids _PATH_, -usb-ids _PATH_, -sdio-ids _PATH_, -pnp-ids _PATH_

Use a custom IDs database file when decoding device IDs.

-import _DIR_

Re-create probes from a directory of previously-saved probe data.

-start

Install a daily cron job that probes the system and emails on hardware failure.

-stop

Remove the daily cron job created by -start.