HW-PROBE(1)

💖 NAME 💖

hw-probe — hardware probe and system info collection tool. Yes bestie, it literally goes and finds out everything about your machine. It's giving full-diagnostic main character energy. 💅

✨ DESCRIPTION ✨

🌸 NAME:

Hardware Probe (hw-probe) — a tool to probe for hardware, check operability and find drivers. That's the whole vibe. 🎀

🦋 DESCRIPTION:

okay so listen: Hardware Probe (hw-probe) is a tool to probe for hardware, check its operability and upload the result to the BSD hardware database. No cap.

And the way that by creating probes you contribute to the "HDD/SSD Desktop-Class Reliability Test" study?? Obsessed. Here's the link, keep it: https://github.com/linuxhw/SMART

🫶 USAGE:

hw-probe [options]

⭐ EXAMPLE:

hw-probe -all -upload

🔒 PRIVACY:

Your private business stays your private business, fr fr. Private information — and that includes the username, the machine's hostname, IP addresses, MAC addresses, UUIDs and serial numbers — is NOT uploaded to the database. Periodt.

But here's the nuance, don't skip it: the tool uploads a 32-byte prefix of salted SHA512 hash of MAC addresses and serial numbers to properly identify unique computers and hard drives. UUIDs are decorated in the same way, but formatted like regular UUIDs in order to save readability of logs. And all the data is uploaded securely via HTTPS. Safe, secure, slay. 🔐

💅 INFORMATION OPTIONS:

• -h | -help — print this help. The classic. 💖
• -v | -version — print version info.
• -dumpversion — print the tool version (1.6) and don't do anything else. Just the number, nothing more, she said what she said.

👑 GENERAL OPTIONS:

• -all — probe for hardware. The whole point, honestly. 🔥
• -log-level N — set the logging level to N. Available values:
  • minimal — default
  • maximal
• -minimal | -min — collect minimal number of logs. Equal to --log-level=min.
• -maximal | -max — collect maximal number of logs. Equal to --log-level=max. Go big or go home. ✨
• -enable LIST — comma separated list of logs to enable in addition to current log level.
• -disable LIST — comma separated list of logs to disable in current log level. Heads up though: some logs cannot be disabled. For example, you can disable collecting of 'fstab', but you cannot disable logging of 'smartctl'. Some things are simply non-negotiable. 🙈
• -check — check devices operability. Tests performance of CPU, memory, graphics cards and drives. Vibe check, but make it hardware. 🩺
• -check-extended — perform extended check. The deluxe version.
• -upload — upload result to the hardware database. You will get a permanent URL to view the probe. 🎀

By use of this option you confirm uploading of 32-byte prefix of salted SHA512 hash of MAC addresses and serial numbers to prevent duplication of computers in the DB.

• -hwinfo-path PATH — path to a local hwinfo binary.
• -proxy ADDRESS:PORT — set outgoing http/https proxy using syntax: proxy.domain.local:3128.

🍓 INVENTORY OPTIONS:

• -i | -inventory-id ID — mark the probe by inventory ID.
• -generate-inventory-id — generate new inventory ID. Fresh one, just for you. ✨
• -email ADDR — email for node status notifications.

🌈 MONITORING OPTIONS:

• -start — start monitoring of the node.
• -stop — stop monitoring of the node.
• -remind-inventory — remind node inventory ID. She's just reminding you, that's all. 💜

🧚 OTHER OPTIONS:

• -save DIR — save probe package to DIR. This is useful if you are offline and need to upload a probe later (with the help of -src option).
• -src | -source PATH — a probe to upload.
• -fix PATH — update list of devices and host info in the probe using probe data.
• -show-devices — show devices list.
• -show — show host info and devices list.
• -show-host — show host info only.
• -verbose — use with -show option to show type and status of the device.
• -printers — probe for printers. 🖨️
• -scanners — probe for scanners.
• -id | -name DESC — any description of the probe.
• -pci-ids PATH
• -usb-ids PATH
• -sdio-ids PATH
• -pnp-ids PATH — path to {pci,usb,sdio,pnp}.ids file to read missed device names.
• -list — list executed probes (for debugging).
• -clean — do nothing. Obsolete option. 💀 Truly iconic behaviour.
• -save-uploaded — save uploaded probes.
• -debug | -d — do nothing. Obsolete option. 💀
• -dump-acpi — probe for ACPI table.
• -decode-acpi — decode ACPI table.
• -import DIR — import probes from the database to DIR for offline use.
  • If you are using Snap or Flatpak package, then DIR will be created in the sandbox data directory.
  • Provide inventory ID by -i option in order to import your inventory.

📁 DATA LOCATION:

Probes info is saved in the /root/HW_PROBE directory.

---

A tool to probe for hardware, check operability and find drivers License: LGPL-2.1-or-later OR BSD-4-Clause

Usage: hw-probe [options] Example: hw-probe -all -upload

🌸 AUTHOR 🌸

This manual page was written by Mathieu Malaterre <malat@debian.org> for the Debian GNU/Linux system (but may be used by others). Respect the author, bestie, she ate. 🫶

---

Hardware Probe 1.6 🌈 September 2022 — that's the version and the date, mwah, thanks for reading, love u, bye!! 💖✨🎀