LinuxCommandLibrary

tlp-stat

Show TLP power management status and configuration

TLDR

Generate status report with configuration and all active settings

$ sudo tlp-stat
copy

Show information about various devices
$ sudo tlp-stat --[battery|disk|processor|graphics|pcie|rfkill|usb]
copy

Show verbose information about devices that support verbosity
$ sudo tlp-stat [[-v|--verbose]] --[battery|processor|pcie|usb]
copy

Show configuration
$ sudo tlp-stat [[-c|--config]]
copy

Monitor [p]ower supply udev [ev]ents
$ sudo tlp-stat [[-P|--pev]]
copy

Show [p]ower [sup]ply diagonistics
$ sudo tlp-stat --psup
copy

Show [t]emperatures and fan speed
$ sudo tlp-stat [[-t|--temp]]
copy

Show general system information
$ sudo tlp-stat [[-s|--system]]
copy

SYNOPSIS

tlp-stat [OPTIONS]

PARAMETERS

-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.

DESCRIPTION

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.

CAVEATS

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.

COMBINING OPTIONS

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.

TROUBLESHOOTING

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.

ROOT PRIVILEGES

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.

HISTORY

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.

SEE ALSO

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

Copied to clipboard