hp-check

hp-check [OPTION]...

-h, --help
    Show this help message and exit

-i, --info
    Print detailed information about the hp-check tool

-g, --gui
    Launch the graphical user interface version

-rTEST, --run=TEST
    Run specific test(s); separate multiple with ','

-t, --test
    Enter interactive test mode for step-by-step diagnosis

-l, --list
    List all available test names

-u, --upgrade
    Upgrade mode: check for outdated HPLIP components or plugins

-s, --system
    Display comprehensive system information

-m, --model
    Perform printer model compatibility verification

The hp-check command is a key diagnostic utility in the HPLIP (HP Linux Imaging and Printing) software suite, designed to verify if a Linux system is properly configured for HP printers and multifunction devices.

It conducts extensive checks across multiple areas, including:
• OS and kernel compatibility with HPLIP.
• Installed HPLIP version and all required dependencies like CUPS, Python modules, dbus, PolicyKit, and sane.
• Hardware detection for USB, network (JetDirect), parallel, and fax support.
• Permissions, user groups (lp, lpadmin), and udev rules.
• Service status (avahi-daemon, cupsd) and firewall configurations.

Results are clearly categorized: PASS (no issues), WARN (potential problems), FAIL (requires fix), or ERROR (critical failure), with detailed recommendations for resolution. This makes it invaluable for pre-installation verification, troubleshooting print/scan issues, or ensuring optimal HPLIP performance.

Primarily used before running hp-setup or after installation problems. Verbose output helps users or support teams identify exact blockers.

Requires root/sudo for full checks (e.g., sudo hp-check); verbose output may scroll quickly. HPLIP-specific; irrelevant for non-HP devices.

PASS: Fully compatible.
WARN: Advisory note.
FAIL: Manual intervention needed.
ERROR: Blocks functionality; fix immediately.

sudo hp-check -t (interactive mode).
hp-check -u (check for plugin updates).

Developed by HP as part of the HPLIP project starting ~2005 to support open-source printing/scanning on Linux. Evolved with HPLIP releases, adding GUI, upgrade checks, and broader distro support (e.g., Ubuntu, Fedora). Latest versions align with HPLIP 3.24.x.

hp(1), hp-setup(1), hp-probe(1), hp-plugin(1), lsusb(8), lpstat(1)