tlp-stat

Generate status report with configuration and all active settings

$ sudo tlp-stat

$ sudo tlp-stat --[battery|disk|processor|graphics|pcie|rfkill|usb]

$ sudo tlp-stat [[-v|--verbose]] --[battery|processor|pcie|usb]

$ sudo tlp-stat [[-c|--config]]

$ sudo tlp-stat [[-P|--pev]]

$ sudo tlp-stat --psup

$ sudo tlp-stat [[-t|--temp]]

$ sudo tlp-stat [[-s|--system]]

tlp-stat [OPTIONS]

-b
    Battery status and cycle count information.

-c
    TLP configuration from /etc/default/tlp and active settings.

-d
    Disk/drive parameters, including SATA ALPM and spin-down status.

-e
    Graphics card (AMD, Intel, Nvidia) power management details.

-g
    Global TLP settings and runtime information.

-h
    Display help message and exit.

-i
    Input/Output device power saving settings.

-l
    Kernel and system power management features and states.

-p
    Processor (CPU) frequency scaling, turbo boost, and idle states.

-r
    Radio devices (Bluetooth, Wi-Fi, WWAN) power states.

-s
    (Default) Shows a summary of essential power settings.

-t
    Temperatures, fan speeds, and thermal management.

-u
    USB device power saving settings and status.

-w
    PCI/PCIe device power management details.

-z
    Verbose output, showing more detailed information for selected sections.

--auto-mode
    Displays statistics specifically for TLP's automatic (AC/battery) mode switching.

tlp-stat is a command-line utility that provides comprehensive information about the current power management settings and operational status configured by TLP, an advanced power management tool for Linux. It allows users to inspect various aspects of their system's power consumption and TLP's active optimizations.

This tool is essential for verifying TLP's proper functioning, troubleshooting power-related issues, and understanding how TLP influences hardware components to improve battery life and reduce power usage. It can display details for components like battery, CPU, disks, graphics, USB, Wi-Fi, and more.

tlp-stat requires TLP to be installed and running on the system to provide meaningful output. Some information, particularly system-wide statistics or hardware-level details, may require root privileges (e.g., via sudo) to be fully accessible and accurate. The output can be extensive, so piping to less or grep is often useful for filtering.

Multiple options can be combined (e.g., tlp-stat -b -c -p) to display information from different sections simultaneously, providing a comprehensive overview tailored to your needs.

The output of tlp-stat -s or tlp-stat -g is often requested when reporting issues with TLP, as it provides a quick overview of the active configuration and system state, which is crucial for diagnosis.

For full and accurate system information, especially concerning low-level hardware states or kernel settings, running sudo tlp-stat is highly recommended to bypass permission restrictions.

TLP (Linux Advanced Power Management) was initially released around 2011 to address power consumption and battery life issues on Linux laptops. tlp-stat has been an integral part of the TLP suite from its early versions, providing the primary means for users to inspect the effects of TLP's configurations and the actual power states of various hardware components. Its evolution mirrors TLP's growth in supporting more hardware and advanced power-saving techniques.

tlp(8), tlp-rdw(8), tlp-sleep(8), powertop(8), upower(1)