Files

TLP consists – aside from manpages and docs – solely of POSIX compatible shell scripts (i.e. without Bash extensions) and Perl scripts.

To be able to install the essential part of TLP without a dependency on NetworkManager, it is recommended to provide two packages:

  • tlp – Essential functionality

  • tlp-rdwRadio Device Wizard only (depends on NetworkManager)

The following table explains the provided files and assigns them to the packages:

File

Package

Target directory or file

Purpose

00-template.conf

tlp

/etc/tlp.d/

Template for drop-in configuration

bat.d/*

tlp

/usr/share/tlp/bat.d/

[from 1.4] TLP battery plugins

[from 1.6] completions/bash/tlp.bash_completion
[before 1.6] tlp.bash_completion

tlp

/usr/share/bash-completion/completions/
tlp,
tlp-stat,
bluetooth,
nfc [from 1.5],
wifi,
wwan

Bash completion rules

[from 1.6] completions/zsh/_tlp
_tlp-radio-device
_tlp-run-on
_tlp-stat

tlp

/usr/share/zsh/site-functions/

Zsh completion rules

de.linrunner.tlp.metainfo.xml

tlp

/usr/share/metainfo

AppStream metadata

defaults.conf

tlp

/usr/share/tlp/

Intrinsic configuration defaults for both tlp and tlp-rdw

deprecated.conf

tlp

/usr/share/tlp/

[from 1.6] Deprecated configuration parameters and related messages for tlp-stat -c

func.d/*

tlp

/usr/share/tlp/func.d/

TLP function libraries

man/*

tlp

/usr/share/man/
man1/,
man8/

Manpages

README.d

tlp

/etc/tlp.d/README

Explains the drop-in configuration directory

rename.conf

tlp

/usr/share/tlp/

[from 1.4] translation table for parameters

tlp.conf

tlp

/etc/

User configuration file for both tlp and tlp-rdw

tlp

tlp

/usr/sbin/

TLP main program

tlp-func-base

tlp

/usr/share/tlp/

TLP base function library

tlp.init

tlp

/etc/init.d/tlp

SysV init script to be invoked upon system start/shutdown: calls tlp init start/stop to apply power saving settings, switch radio devices and set the battery thresholds

tlp-pcilist

tlp

/usr/share/tlp/

Report settings for PCIe devices; called by tlp-stat

tlp-readconfs

tlp

/usr/share/tlp/

Read and consolidate all of TLP’s configuration files; called by tlp-func-base

tlp-rf

tlp

/usr/bin/
bluetooth,
nfc [from 1.5],
wifi,
wwan

Script to turn radio devices on and off (symlinks to the same file)

tlp.rules

tlp

/lib/udev/rules.d/85-tlp.rules

Call tlp-usb-udev for every plugged USB device

tlp-run-on

tlp

/usr/bin/
run-on-bat,
run-on-ac

Start commands conditionally depending on the power source (symlinks to the same file)

tlp.service

tlp

/lib/systemd/system/

Service to be invoked upon system start/shutdown by systemd: calls tlp init start/stop to apply power saving settings, switch radio devices and set the battery thresholds.

tlp-sleep

tlp

/lib/systemd/system-sleep/tlp

Script to be invoked by systemd upon suspend and resume: calls tlp resume/suspend to apply settings

tlp-sleep.elogind

tlp

/lib/elogind/system-sleep/49-tlp-sleep

Script to be invoked by elogind upon suspend and resume: calls tlp resume/suspend to apply settings

tlp-stat

tlp

/usr/bin/

Status report with all effective settings

tlp-usb-udev

tlp

/lib/udev/

Enable autosuspend for plugged USB devices

tlp-usblist

tlp

/usr/share/tlp/

Report USB settings; called by tlp-stat

tlp.upstart

tlp

n/a

Upstart script (currently not used)

tpacpi-bat

tlp

/usr/sbin/

Script providing battery recalibration for ThinkPads since model year 2011 - e.g. T420/X220 and newer. Written by Elliot Wolk.

man-rdw/*

tlp-rdw

/usr/share/man/man8/

Manpages

tlp-rdw

tlp-rdw

/usr/bin

RDW command line tool

[from 1.6] completions/bash/tlp-rdw.bash_completion
[before 1.6] tlp-rdw.bash_completion

tlp

/usr/share/bash-completion/completions/tlp-rdw

Bash completion rules

[from 1.6] completions/zsh/_tlp-rdw

tlp

/usr/share/zsh/site-functions/_tlp-rdw

Zsh completion rules

tlp-rdw.bash_completion

tlp-rdw

/usr/share/bash-completion/completions/tlp-rdw

Bash completion rules

tlp-rdw.rules

tlp-rdw

/lib/udev/rules.d/85-tlp-rdw.rules

Call tlp-rdw-udev for dock/undock events

tlp-rdw-udev

tlp-rdw

/lib/udev/

Handle dock/undock events

tlp-rdw-nm

tlp-rdw

[from 1.6] /usr/lib/NetworkManager/dispatcher.d
[until 1.5] /etc/NetworkManager/dispatcher.d

NetworkManager hook for ifup/ifdown events

unit-tests/*

n/a

n/a

[from 1.4] functional tests of TLP (incomplete coverage); needs specific hardware, not suited for package autotest; see unit-tests.rst for requirements

VERSION

n/a

n/a

Contains TLP’s version number, used by the Makefile

Makefile

n/a

n/a

Installation of scripts and config file to their respective target dirs; see Makefile

changelog

tlp

distribution dependent

Changelog for TLP – the target directory is distribution specific and therefore it is not installed by the Makefile

README.md

tlp

distribution dependent

README file for TLP – the target directory is distribution specific and therefore it is not installed by the Makefile

AUTHORS

n/a

distribution dependent

List of developers / contributors

COPYING

n/a

distribution dependent

Copyright information:
- The target directory is distribution specific and therefore it is not installed by the Makefile
- Installation of this file (or inclusion in a distribution specific template) is mandatory

LICENSE

n/a

distribution dependent

GPL v2 license text