Provided by: laptop-mode-tools_1.74-1.2_all 
NAME
/etc/laptop-mode/laptop-mode.conf - Configuration file for laptop-mode-tools.
DESCRIPTION
This manual page documents the options that can be set in the /etc/laptop-mode/laptop-
mode.conf configuration file and in the modular configuration files in the /etc/laptop-
mode/conf.d directory. For a description of what laptop mode does, see the laptop_mode(8)
manual page.
SETTINGS
The syntax of options is OPTION=value. There are some groups of options that specify
values depending on power state and laptop mode is enabled. These use the prefix "LM_" to
indicate that a value is used only when laptop mode is enabled, "NOLM_" to indicate the
opposite, "AC_" to indicate that a value is used only when the system is running on AC
power, and "BATT_" to indicate that a value is used only when the system is running on
batteries. Settings are prefixed with a combination of an optional LM_/NOLM_ prefix and an
optional AC_/BATT_. For instance, the combination LM_AC_ means "when the system is in
laptop mode and on AC power". (Note that this situation happens only if
ENABLE_LAPTOP_MODE_ALWAYS is enabled!) If one of the prefixes (either LM_/NOLM_ or
AC_/BATT_) is missing, then the value is used independently of the state of laptop mode or
AC power, respectively. Options that start with "CONTROL_" are boolean settings that
determine whether laptop mode tools is allowed to control a certain aspect of your system.
Boolean settings always expect "0" to indicate the false (negative/no/disabled) value, and
"1" to indicate the true (positive/yes/enabled) value.
The following sections list the settings that are available in laptop-mode.conf and in the
modular configuration files.
Note: Many settings were moved from the main configuration file to the modular
configuration files. The settings here are split out by modular configuration file, but in
installations upgraded from version 1.36 or earlier they may appear in both. In such
cases, the configuration settings in the main configuration file override those in the
modular configuration files. To avoid confusion, it is advised to move the settings from
the main configuration files to the modular configuration files when this situation is
detected.
/etc/laptop-mode/conf.d/board-specific/
The board-specific settings framework is for users and distributors who would like to ship
their local customized settings on top of the default settings shipped upstream.
Add local customized settings under this folder to override the system defaults.
/etc/laptop-mode/laptop-mode.conf
This is the main configuration file. It contains the settings for enabling and disabling,
plus the core features: the Linux kernel laptop mode feature and related settings.
ENABLE_LAPTOP_MODE_TOOLS
This module determines if laptop-mode-tools should be run or not. Default is 1
Set it to 0 if you would like to completely disable laptop-mode-tools
VERBOSE_OUTPUT
Set this to 1 if you want to see a lot of output when you start/stop laptop
mode, and to 0 if you don't want this. Useful for debugging purposes.
LOG_TO_SYSLOG
Set this to 1 if you want to log messages to syslog when you start/stop laptop
mode, and to 0 if you don't want this. Useful for debugging purposes.
DEBUG Set this to 1 if you would like to execute the entire laptop-mode program in
debug mode. WARNING: This will create a lot of text output. If you are debugging
an individual module, perhaps you would want to enable each module specific
debug mode (available in module conf files)
ENABLE_AUTO_MODULES
Set this to 1 to enable all laptop mode tools modules that are termed safe to be
enabled and are marked auto. With this option alone, you can enable all auto
modules. In case you need to fine-control the behavior of individual modules,
you can modify them accordingly. Default is 1
ENABLE_LAPTOP_MODE_ON_BATTERY
ENABLE_LAPTOP_MODE_ON_AC
These options determine whether laptop mode will be activated when the computer
is on battery or on AC power, respectively. Note that if the system service
laptop-mode is not started, then laptop mode will never be started, even if this
option is enabled.
The ENABLE_LAPTOP_MODE_ON_AC setting is useful when you want to run on a
headless machine, in low-power mode, for eg. a Jukebox.
ENABLE_LAPTOP_MODE_WHEN_LID_CLOSED
When this option is enabled, laptop mode will be activated when the laptop's lid
is closed, even if the system is not working on batteries. Note that if the
system service laptop-mode is not started, then laptop mode will never be
started, even if this option is enabled. This feature is only supported on
ACPI.
MINIMUM_BATTERY_CHARGE_PERCENT
The minimum number of battery minutes, charge (in mAh) or charge (in mWh) that
you want to have available while your laptop is in laptop mode. When the number
of minutes/mAhs/mWhs goes below this value, the data loss sensitive features are
automatically disabled. Note that some batteries do not report a discharge rate,
which means that MINIMUM_BATTERY_MINUTES has no effect for these batteries.
These options are only supported on ACPI.
DISABLE_LAPTOP_MODE_ON_CRITICAL_BATTERY_LEVEL
If this option is enabled, the data loss sensitive features of laptop mode are
disabled when the battery reports its state as "critical". This option is only
supported on ACPI.
DISABLE_BATTERY_ALARM_CHECK
If this option is enabled, the alarm values are ignored from the battery. This
is helpful if you have a broken battery which is reporting false alarms.
HD The hard drives which laptop mode should operate upon. If you have multiple hard
drives, you should list them all in this option, separated by spaces, for
example: "/dev/hda /dev/hdb".
PARTITIONS
This option specifies the partitions or mount points that laptop mode should
operate upon. Separate the partitions or mount points by spaces. You can include
the entry "auto" to stand for the partitions on the hard drives specified in the
HD option.
LM_BATT_MAX_LOST_WORK_SECONDS
LM_AC_MAX_LOST_WORK_SECONDS
The maximum number of seconds worth of data that you can lose when power runs
out or when the computer crashes. This is the maximum number of seconds that
laptop mode will keep modified data in memory without being written to disk.
(Note that the NOLM value is missing: modifying this value when laptop mode is
disabled is extremely useless, as it won't save you any power, and will only
lose you work.)
CONTROL_READAHEAD
When this option is enabled, laptop mode tools controls the readahead on the
filesystems it works upon.
LM_READAHEAD
NOLM_READAHEAD
The number of kilobytes to "read ahead" on your hard disks. Reading ahead means
that whenever some data is read from disk, the data which is most likely to be
accessed next is read as well, ahead of time. This then saves a hard disk spinup
when the data is actually needed, because the data is then already in memory.
Don't set this value too high, because the readahead applies to all files that
are read!
CONTROL_NOATIME
When this option is enabled, laptop mode tools places the "noatime" option in
the mount options of your filesystems when laptop mode is active. This option
has the effect of disabling access time logging on files, which may save some
disk activity. If you use programs that depend on access times (e.g., mutt),
then you should disable this option, or enable the USE_RELATIME option.
USE_RELATIME
When this option is enabled together with the CONTROL_NOATIME option, laptop
mode tools will use the relatime option instead of the noatime option. This
option works for more applications, and still causes relatively low levels of
disk writes. Note that this functionality is only available in recent kernel
versions, and laptop mode tools will ignore this setting for kernels before
2.6.23.
CONTROL_HD_IDLE_TIMEOUT
When this option is enabled, laptop mode tools adjusts your hard drives' idle
timeouts, i.e., the time of inactivity before they spin down.
LM_AC_HD_IDLE_TIMEOUT_SECONDS
LM_BATT_HD_IDLE_TIMEOUT_SECONDS
NOLM_HD_IDLE_TIMEOUT_SECONDS
These settings control the idle timeout for your hard drives. The values are
specified in seconds. Values up to 20 minutes can be represented accurately by
the hardware, anything above that is rounded down to half-hour precision. Use
the value 0 to disable idle timeout.
CONTROL_HD_POWERMGMT
When this option is enabled, laptop mode tools adjusts your hard drives' power
management settings.
BATT_HD_POWERMGMT
LM_AC_HD_POWERMGMT
NOLM_AC_HD_POWERMGMT
These values specify the power management level for your hard drives. The legal
values for these options can be found in the hdparm(8) manual page, in the
documentation of the -B option.
CONTROL_HD_WRITECACHE
When this option is enabled, laptop mode tools controls your hard drives' write
cache settings.
NOLM_AC_HD_WRITECACHE
NOLM_BATT_HD_WRITECACHE
LM_HD_WRITECACHE
These options specify whether the write caches should be enabled for your hard
drives.
CONTROL_SYSLOG_CONF (deprecated)
When this option is enabled, laptop mode tools controls /etc/syslog.conf as a
symlink. This option is deprecated. Use the configuration-file-control module
instead, which is configured in the /etc/laptop-mode/conf.d/configuration-file-
control.conf module configuration file.
Advanced laptop-mode.conf options
These options normally do not need to be modified from their default values. Do not tweak
these settings unless you know what you are doing.
ASSUME_SCSI_IS_SATA
This option, enabled by default, tells laptop mode tools to assume that a device
/dev/sdX is a SATA device, and that it should be controlled using hdparm. If
your /dev/sdX drives are really SCSI drives, disable this option.
ACPI_WITHOUT_AC_EVENTS
Enable this option if you have a laptop with a buggy ACPI implementation that
doesn't send out AC adapter events. Enabling this option will make laptop mode
check the AC adapter state whenever the battery state changes, which achieves
just about the same effect as responding to AC adapter events.
CONTROL_MOUNT_OPTIONS
When this option is enabled, laptop mode tools is allowed to control the mount
options for your filesystems. Disabling this will break CONTROL_NOATIME, but it
will most probably also break laptop mode itself, as changes to the mount
options are crucial for achieving spun-down hard drives.
LM_DIRTY_RATIO
NOLM_DIRTY_RATIO
This option specifies the percentage of system memory that is allowed to contain
unwritten modified data when laptop mode is active.
LM_DIRTY_BACKGROUND_RATIO
NOLM_DIRTY_BACKGROUND_RATIO
This option specifies the percentage of system memory that is allowed to contain
unwritten modified data after the DIRTY_RATIO barrier has been crossed. The
effect of this option is that when more than DIRTY_RATIO percent of memory
contains modified data, the system will synchronously write back data until only
DIRTY_BACKGROUND_RATIO percent of memory contains modified data.
DEF_UPDATE
DEF_XFS_AGE_BUFFER
DEF_XFS_SYNC_INTERVAL
DEF_XFS_BUFD_INTERVAL
DEF_MAX_AGE
These options contain the default (non-laptop-mode) values for some kernel
options that are modified when laptop mode is active. You do not normally need
to change these, they represent the normal kernel defaults.
XFS_HZ This option specifies the number of units in a second that is utilized by a 2.4
kernel. If you run a 2.4 kernel with an XFS filesystem on non-Intel hardware,
you need to change this option to reflect the kernel "ticks per second" value,
which is the kernel variable HZ. Unfortunately this is not exposed anywhere, so
you'll have to specify it manually.
LM_SECONDS_BEFORE_SYNC
The number of seconds that laptop mode waits after the disk goes idle before it
starts a full sync. This should always be less than your hard disk idle timeout,
because otherwise you'll have a sync directly after your drive spins down. Two
seconds is usually a good value for this option.
XFS_HZ This option expresses the unit of the XFS tuning parameters. The default is 100.
This option is only useful for 2.4 kernels that have a value for HZ that is not
100. In the 2.6 kernel series, the XFS interfaces were modified to always use
USER_HZ (which is currently always 100), so for these kernels you do not need to
modify this value. Also, on 2.4 kernels the value of HZ is 100 for the most
common architectures, so you need only change this value if you use a less
common architecture.
/etc/laptop-mode/conf.d/ethernet.conf
The ethernet module allows you to control the behavior of your ethernet devices during AC
and battery states.
CONTROL_ETHERNET
Enable this to control various aspects of power savings in the ethernet devices.
BATT_THROTTLE_ETHERNET=1
LM_AC_THROTTLE_ETHERNET=0
NOLM_AC_THROTTLE_ETHERNET=0
These options specify the power states in which you would like to control the
ethernet device
THROTTLE_SPEED
Here, you can specify the throttling speed for your ethernet device. The default
is "slowest". Valid values are "slowest", "fastest" or the speed of your
ethernet device, like 1000. To know the exact speed of your ethernet device, you
can use the ethtool tool.
DISABLE_WAKEUP_ON_LAN
This setting controls the option to enable/disable the WoL (Wake On LAN)
feature. It permanently disables the WOL feature on the ethernet device.
Default is 1. Set it to 0 to enable the WOL feature.
ETHERNET_DEVICES
Specify the list of ethernet devices to control. Defaults to eth0
DISABLE_ETHERNET_ON_BATTERY
Set this to 1 if you want to completely disable your ethernet device when
running on battery, and when no carrier is detected on the interface (e.g., no
active cable is plugged in). Default is 0
/etc/laptop-mode/conf.d/cpuhotplug.conf
The cpuhotplug module allows you to switch off the CPU cores when running on battery
CONTROL_CPU_HOTPLUG
When this option is enabled, Laptop Mode Tools can hotplug your CPU, thus
switching it offline, and conserving some power. NOTE: This module is NOT
enabled by default
/etc/laptop-mode/conf.d/cpufreq.conf
The cpufreq module allows you to control the Linux kernel's CPU frequency scaling
settings.
CONTROL_CPU_FREQUENCY
When this option is enabled, laptop mode tools controls your CPU's frequency
scaling bounds and the scaling governor. This option is currently only supported
on 2.6 kernels.
BATT_CPU_MAXFREQ
BATT_CPU_INFREQ
BATT_CPU_GOVERNOR
BATT_CPU_IGNORE_NICE_LOAD
LM_AC_CPU_MAXFREQ
LM_AC_CPU_MINFREQ
LM_AC_CPU_GOVERNOR
LM_AC_CPU_IGNORE_NICE_LOAD
NOLM_AC_CPU_MAXFREQ
NOLM_AC_CPU_MINFREQ
NOLM_AC_CPU_GOVERNOR
NOLM_AC_CPU_IGNORE_NICE_LOAD
These options specify the CPU frequency bounds and scaling governor in the
various power states. You can change the MAXFREQ and MINFREQ values to any value
listed in
/sys/devices/system/cpu/cpu0/cpufreq/scaling_available_frequencies.
In addition, you can use "fastest" and "slowest". The GOVERNOR option controls
the setting for /sys/devices/system/cpu/cpufreq/scaling_governor. The available
options are dependent on the installed kernel. The most common ones are
"conservative", "performance" and "ondemand". The IGNORE_NICE_LOAD option
controls a setting that is available for the "conservative" and "ondemand"
governors. Set this option to 1 if you want the frequency scaling governor to
not increase the CPU frequency for the sake of low-priority ("nice") background
processes.
CONTROL_CPU_THROTTLING
When this option is enabled, laptop mode tools controls your CPU's throttling
level. It is only useful if your CPU doesn't support frequency scaling. This
option is only supported on some ACPI hardware.
BATT_CPU_THROTTLING
LM_AC_CPU_THROTTLING
NOLM_AC_CPU_THROTTLING
These options specify the throttling level for the CPU in the various power
states. You can change it to any level listed in
/proc/acpi/processor/CPU0/throttling (use only the number!). In addition, you
can use "maximum" (which is the slowest option), "minimum" (full speed) and
"medium" (about halfway).
/etc/laptop-mode/conf.d/sched-smt-power-savings.conf
The sched-smt-power-savings module controls the behavior of the process scheduler on SMT
boxes, when running in battery mode.
CONTROL_SCHED_SMT_POWER_SAVINGS
Set this to 1 to enable power savings in the process scheduler for SMT
processors.
/etc/laptop-mode/conf.d/dpms-standby.conf
The dpms-standby module allows you to control the DPMS standby timeouts for X displays.
CONTROL_DPMS_STANDBY
When this option is enabled, laptop mode will control the DPMS standby timeout
for all X displays on the machine that users have logged on to. In short, this
allows laptop mode to control the time after which your screen is blanked.
There is one limitation to this feature: the settings are not automatically
applied to new X logons. This can be fixed by configuring the display manager.
For the gdm display manager, configure a PostLogin directory (usually
/etc/gdm/PostLogin or /etc/X11/gdm/PostLogin), and in that directory create a
shell script called Default. In that file, include the command:
( sleep 60 ; /usr/sbin/laptop_mode force ) &
Similar configurations are possible for other window managers. Please
consult your window manager documentation for more information.
BATT_DPMS_STANDBY
LM_AC_DPMS_STANDBY
NOLM_AC_DPMS_STANDBY
These options specify the display standby timeouts for the X displays, in
seconds.
/etc/laptop-mode/conf.d/terminal-blanking.conf
The terminal-blanking module allows you to control the terminal blanking timeouts for the
Linux text console.
CONTROL_TERMINAL
When this option is enabled, laptop mode will control the terminal blanking
settings for Linux's virtual consoles.
TERMINALS This option should contain a space-separated list of console device files that
should be affected by the terminal blanking settings. Only one console device
file needs to be included, because the settings are shared between all virtual
consoles. By default this setting is set to /dev/tty1.
BATT_TERMINAL_BLANK_MINUTES
LM_AC_TERMINAL_BLANK_MINUTES
NOLM_AC_TERMINAL_BLANK_MINUTES
BATT_TERMINAL_POWERDOWN_MINUTES
LM_AC_TERMINAL_POWERDOWN_MINUTES
NOLM_AC_TERMINAL_POWERDOWN_MINUTES
These options specify the terminal blanking and powerdown timeouts, in minutes.
The allowed ranges are 1-60 minutes, or 0 to disable blanking or powerdown. The
values are cumulative: the powerdown value is counted from the moment of screen
blanking, not from the start of inactivity.
/etc/laptop-mode/conf.d/lcd-brightness.conf
The lcd-brightness module allows you to control the brightness of your LCD screen.
CONTROL_BRIGHTNESS
When this option is enabled, laptop mode will adjust your LCD screen's
brightness settings, if possible. You must configure the following settings for
this to work.
BATT_BRIGHTNESS_COMMAND
LM_AC_BRIGHTNESS_COMMAND
NOLM_AC_BRIGHTNESS_COMMAND
BRIGHTNESS_OUTPUT
The BRIGHTNESS_COMMAND settings specify commands that should be executed in
order to set the brightness of your LCD. The BRIGHTNESS_OUTPUT setting specifies
where the output of the command will be written. For instance, if your LCD's
brightness is adjusted by writing a numeric value 3 to a file called
/proc/brightness, you should set the command to "echo 3" and the output file to
"/proc/brightness". If your LCD's brightness is adjusted using a utility like
"toshset", you should include the entire toshset command line as the command,
and set the output file to "/dev/null".
/etc/laptop-mode/conf.d/kbd-backlight.conf
The kbd-backlight module allows you to control the brightness of your LCD screen.
CONTROL_KBDLIGHT
When this option is enabled, laptop mode will adjust your keyboard backlight
brightness settings, if possible. You must configure the following settings for
this to work.
BATT_KBDLIGHT_COMMAND
LM_AC_KBDLIGHT_COMMAND
NOLM_AC_KBDLIGHT_COMMAND
KBD_BRIGHTNESS_OUTPUT
The KBDLIGHT_COMMAND settings specify commands that should be executed in order
to set the brightness of your keyboard backlight. The KBD_BRIGHTNESS_OUTPUT
setting specifies where the output of the command will be written. For instance,
if your keyboard's backlight brightness is adjusted by writing a numeric value
3 to a file called /proc/brightness, you should set the command to "echo 3" and
the output file to "/proc/brightness". If your LCD's brightness is adjusted
using a utility like "toshset", you should include the entire toshset command
line as the command, and set the output file to "/dev/null".
CONTROL_VGASWITCHEROO
When this option is enabled, laptop mode will use the vgaswitcheroo interface to
disable the unused hybrid graphics card. For this module to work, you need to
ensure you have debugfs enabled/mounted
BATT_ENABLE_VGASWITCHEROO
LM_AC_ENABLE_VGASWITCHEROO
NOLM_AC_ENABLE_VGASWITCHEROO
VGASWITCHEROO_FILE
The above settings specify under what modes should vgaswitcheroo interface be
used to enable/disable hybrid graphics. The VGASWITCHEROO_FILE setting
specifies the vgaswitcheroo interface to talk to the Linux kernel for hybrid
graphics power savings
/etc/laptop-mode/conf.d/auto-hibernate.conf
The auto-hibernate module allows you to automatically hibernate your computer when the
battery goes critical or when the battery level goes below a certain threshold.
ENABLE_AUTO_HIBERNATION
When this option is enabled, laptop mode will automatically hibernate your
computer when the battery level reaches a certain configurable threshold. This
feature is only available when ACPI is enabled.
HIBERNATE_COMMAND
This option specifies the command that laptop mode should execute when auto-
hibernation is triggered. Normally, this is set to something like
"/usr/sbin/hibernate".
AUTO_HIBERNATION_BATTERY_CHARGE_PERCENT
The battery level threshold for auto-hibernation, as a percentage of total
battery design capacity.
AUTO_HIBERNATION_ON_CRITICAL_BATTERY_LEVEL
When this option is enabled, auto-hibernation will kick in when the battery
reports its state as "critical".
/etc/laptop-mode/conf.d/battery-level-polling.conf
Some battery hardware does not send out proper level change events, or too infrequent
ones. For such hardware, laptop mode tools will not detect that the battery has reached a
critical level. The battery-level-polling module allows you to use the auto-hibernate
module and the other battery level dependent features of laptop mode tools even when your
battery does not send out frequent ACPI to indicate a change in level.
CONTROL_BATTERY_LEVEL_POLLING
When this option is enabled, laptop mode tools will automatically poll the
battery level every once in a while to see if the levels have changed, and to
see if actions should be taken as a consequence.
/etc/laptop-mode/conf.d/start-stop-programs.conf
The start-stop-programs module allows you to start or stop programs when the computer
switches to a different power state.
CONTROL_START_STOP
If this option is enabled, laptop mode tools will automatically start and stop
daemons or other programs for you. The actual configuration of which daemons are
to be stopped/started is done by placing links to the daemons' init scripts in
the following directories:
/etc/laptop-mode/batt-start
/etc/laptop-mode/batt-stop
/etc/laptop-mode/lm-ac-start
/etc/laptop-mode/lm-ac-stop
/etc/laptop-mode/nolm-ac-start
/etc/laptop-mode/nolm-ac-stop
As you have probably guessed, the directories of the form "X-stop-daemons"
should contain init scripts of daemons that you want stopped in mode X, while
the directories of the form "X-start-daemons" should contain init scripts of
daemons that you want started in mode X. Of course, it is possible to put in
your own handling of modes as well: the only requirement on the scripts in the
directories is that they handle the "start" and "stop" commands, like init
scripts usually do.
The ordering of the script handling is as follows. When a mode is entered, the
actions of the previous mode are undone, in reverse order. This means that if
the previous mode had done "daemon1 stop", "daemon2 stop" and "daemon3 start",
then the undoing actions will be "daemon3 stop", "daemon2 start", "daemon1
start". After that, the stop-scripts for the new mode are called, and then the
start-scripts are called. Please note that there is no detection of
commonalities between modes at this point, i.e., if the mode you're coming from
and the mode you're going to both specify that a daemon "X" should be stopped,
then the daemon will be un-stopped (that is, started) while leaving the previous
mode, and then stopped again.
BATT_STOP
BATT_START
LM_AC_STOP
LM_AC_START
NOLM_AC_STOP
NOLM_AC_START
These options allow you to stop services (through their init scripts) in certain
power states. Specify a space-separated list of service names in these options.
These services are started/stopped together with the files from the directories
mentioned above.
/etc/laptop-mode/conf.d/ac97-powersave.conf
The ac97-powersave module allows you to enable the Intel AC97 integrated audio power
saving mode.
CONTROL_AC97_POWER
If this option is enabled, laptop mode tools will automatically enable the AC97
power saving settings. The power saving settings are always enabled, not only on
battery power. Note: On some machines it has been reported that the AC97 power
savings triggers the annoying click sound during power state transitions
/etc/laptop-mode/conf.d/nmi-watchdog.conf
The nmi-watchdog module allows you to enable the NMI Watchdog timer power savings.
Enabling this module lowers down one hw-pmu counter.
CONTROL_NMI_WATCHDOG
If this option is enabled, laptop mode tools will automatically disable the NMI
Watchdog timer when on battery. This module is part of auto modules. Thus
enabling auto modules setting will activate this module automatically.
/etc/laptop-mode/conf.d/nouveau.conf
The nouveau module allows you to enable the power savings for nvidia cards with the
nouveau device driver. Enabling this module should lower down power consumption.
CONTROL_NOUVEAU
If this option is enabled, laptop mode tools will automatically apply the power
savings values when on battery. This module is part of auto modules. Thus
enabling auto modules setting will activate this module automatically.
Please ensure that your nvidia card's power saving functionality are available
through the nouveau driver. Also ensure to set the correct path for your device
in "/sys/kernel/debug/dri/N/pstate" where N is the number enumerated for the
device
/etc/laptop-mode/conf.d/pci-aspm.conf
The pcie-aspm module allows you to enable the PCI Express (PCIe) Active State Power
Management (ASPM).
CONTROL_PCI_ASPM
If this option is enabled, laptop mode tools will enable PCI ASPM powersave mode
when on battery. This module is part of auto modules. Thus enabling auto modules
setting will activate this module automatically. PCIe ASPM may require that the
pcie_aspm=force kernel option is enabled.
/etc/laptop-mode/conf.d/usb-autosuspend.conf
This option has been superseded by the new runtime-pm.conf settings
/etc/laptop-mode/conf.d/runtime-pm.conf
The runtime-pm module allows you to enable the Runtime Power Management framework for the
Linux kernel.
CONTROL_RUNTIME_AUTOSUSPEND
If this option is enabled, laptop mode tools will automatically enable the USB
autosuspend feature for all devices. The USB autosuspend feature will always be
enabled, not only on battery power.
AUTOSUSPEND_RUNTIME_DEVID_BLACKLIST
Here, you can specify the list of USB IDs that should not use autosuspend. Use
lsusb to find out the IDs of your USB devices. Example:
AUTOSUSPEND_RUNTIME_DEVID_BLACKLIST="046d:c025 0123:abcd"
AUTOSUSPEND_RUNTIME_DEVTYPE_BLACKLIST
Here, you can specify the list of device driver that should not use autosuspend.
The driver type is given by "DRIVER=..." in a device's uevent file Example:
AUTOSUSPEND_RUNTIME_DEVTYPE_BLACKLIST="usbhid usb-storage usbmouse"
AUTOSUSPEND_USE_WHITELIST
Set this to use opt-in/whitelist instead of opt-out/blacklist for deciding which
devices should be autosuspended. AUTOSUSPEND_USE_WHITELIST=0 means
AUTOSUSPEND_*_BLACKLIST will be used. AUTOSUSPEND_USE_WHITELIST=1 means
AUTOSUSPEND_*_WHITELIST will be used.
AUTOSUSPEND_RUNTIME_DEVID_WHITELIST
The list of Device IDs that should use autosuspend. Use system commands or look
into sysfs to find out the IDs of your devices. Example:
AUTOSUSPEND_DEVID_WHITELIST="046d:c025 0123:abcd"
AUTOSUSPEND_RUNTIME_DEVTYPE_WHITELIST
The list of device driver types that should use autosuspend. The driver type is
given by "DRIVER=..." in a device's uevent file. Example:
AUTOSUSPEND_DEVTYPE_WHITELIST="usbhid usb-storage usbmouse"
/etc/laptop-mode/conf.d/intel-hda-powersave.conf
The intel-hda-powersave module allows you to enable the Intel HDA integrated audio power
saving mode.
CONTROL_INTEL_HDA_POWER
If this option is enabled, laptop mode tools will automatically enable the Intel
HDA power saving settings. The power saving settings are always enabled, not
only on battery power.
/etc/laptop-mode/conf.d/configuration-file-control.conf
The configuration-file-control module allows you to switch between different configuration
files when the computer is in different power states.
The primary use for this feature is for controlling the configuration files of syslog
daemons. Syslog daemons have a tendency to sync their log files when entries are written
to them. This causes disks to spin up, which is not very nice when you're trying to save
power. The syslog.conf configuration file can be tweaked so that syslogd will not sync a
given file, by prepending the log file name with a dash, like this:
mail.* -/var/log/mail/mail.log
Note: This feature will NOT work if CONTROL_SYSLOG_CONF is set in laptop-mode.conf. To
start using this feature, remove the CONTROL_SYSLOG_CONF section in laptop-mode.conf, and
then restart the laptop-mode-tools service. The new config files have different names than
the old ones, and settings are NOT migrated. You will have to do this manually.
CONTROL_CONFIG_FILES
If this option is enabled, laptop mode tools will use the following options to
switch configuration files depending on the power state.
CONFIG_FILES
This option should contain a space-separated list of configuration files that
should be switched around depending on the power state.
For each configuration file, the specific configuration files will be named as
follows:
<conffile>-nolm-ac
<conffile>-lm-ac
<conffile>-batt
The first file will be used when the system is on AC power and laptop mode is
not active. The second file will be used when the system is on AC power and
laptop mode is active. The third file will be used when the system is on battery
power.
When the laptop mode tools service is enabled, it will replace the configuration
files with a symlink to one of the three state-based configuration files. The
original configuration file will be saved as <config file>.lmbackup, and it will
be restored when the laptop mode tools service is disabled.
When you add files to this list, make sure to also add the appropriate programs
and services to the configuration settings below.
You can create the alternate configuration files yourself. If you don't, they
will be created by laptop mode tools the next time it is restarted. To force the
files to be created, run the laptop-mode service init script with the "restart"
parameter.
CONFIG_FILE_SIGNAL_PROGRAMS
This option should contain a space-separated list of programs that should be
signalled after the config files have been switched around. This only works for
programs that respond to the SIGHUP signal by reloading their configuration
files.
CONFIG_FILE_RELOAD_SERVICES
This option should contain a space-separated list of services which should be
reloaded after the config files have been switched around.
/etc/laptop-mode/conf.d/wireless-power.conf
The wireless-power module allows you to alter the power management settings for wireless
network adapters that support the iwconfig "power" option. This module is not usable for
Intel network adapters that use the iwlwifi or ipw drivers, they are supported by separate
modules described below.
CONTROL_WIRELESS_POWER_SAVING
If this option is enabled, laptop mode tools will set the wireless power saving
mode settings based on the power state.
WIRELESS_AC_POWER_SAVING
WIRELESS_BATT_POWER_SAVING
These settings define the power saving modes on AC and on battery. The allowed
values are 0 (to disable power saving mode) and 1 (to enable power saving mode).
/etc/laptop-mode/conf.d/wireless-ipw-power.conf
The wireless-ipw-power module allows you to alter the power management settings for Intel
PRO/Wireless 3945, 2100 and 2200 wireless network adapters. This module is intended for
use with the ipw3945, ipw2100, ipw2200 drivers, not with the iwlwifi drivers.
CONTROL_IPW_POWER
If this option is enabled, laptop mode tools will set the wireless power
management settings based on the power state.
IPW3945_AC_POWER
IPW3945_BATT_POWER
These settings define the power management levels for the ipw3945 driver. The
defaults are 6 for AC, and 7 for battery mode. The allowed values are 1 (highest
power) to 5 (lowest power), 6 (AC mode, full power) and 7 (battery mode, lowest
power).
IPW2100_AC_POWER
IPW2100_BATT_POWER
These settings define the power management levels for the ipw2100 driver. The
defaults are 0 for AC mode and 5 for battery mode.
/etc/laptop-mode/conf.d/wireless-iwl-power.conf
The wireless-iwl-power module allows you to alter the power management settings for Intel
PRO/Wireless 3945 and Intel WiFi Link 4965 wireless network adapters. This module is
intended for use with the iwlwifi drivers, not with the old ipw drivers.
CONTROL_IWL_POWER
If this option is enabled, laptop mode tools will set the wireless power
management settings based on the power state.
IWL_AC_POWER
IWL_BATT_POWER
These settings define the power management levels on AC and on battery. The
defaults are 0 for AC, and 3 for battery mode. The allowed values are 0 (highest
power) to 5 (lowest power), 6 (AC mode, full power) and 7 (battery mode, lowest
power).
/etc/laptop-mode/conf.d/exec-commands.conf
There can be many odd machines and many power savings settings, that laptop-mode-tools
currently does not cover. If you run into a similar power saving problem, where you do not
have a laptop-mode-tools module for it, you can use the exec-commands module to trigger
the command during power state changes. Please do contribute back the power saving item as
a module to the upstream developers.
CONTROL_EXEC_COMMANDS
Set this to 0 to disable execution of custom commands during power state
changes. Default is auto.
BATT_EXEC_COMMAND_0=
BATT_EXEC_COMMAND_1=
LM_AC_EXEC_COMMAND_0=
LM_AC_EXEC_COMMAND_1=
NOLM_AC_EXEC_COMMAND_0=
NOLM_AC_EXEC_COMMAND_1=
Here you can specify your custom command that will need to be executed. The
numbers can grow up to 9. The command needs to be specified in double quotes
/etc/laptop-mode/conf.d/eee-superhe.conf
The eee-superhe module allows you to control the CPU frequency scalling on the EEE PC. It
requires the eeepc_laptop kernel module to be loaded.
CONTROL_SUPERHE
It this option is enabled, laptop mode tools will automatically control the FSB
speed on the EEE PC.
BATT_SUPERHE
LM_AC_SUPERHE
NOLM_AC_SUPERHE
These settings define the power management levels on AC and on battery. The
defaults are 0 for LM_AC and NOLM_AC, and 2 for battery mode.
/etc/laptop-mode/conf.d/hal-polling.conf
The hal-polling module allows you to control the polling of CD/DVD drives by HAL. The
polling is needed for some drives to detect inserted CDs, but it uses a considerable
amount of power. Enable this module to disable the polling, but only if our drive doesn't
need it, or if you are willing to mount CDs manually in exchange for the power saving.
CONTROL_HAL_POLLING
If this option is enabled, laptop mode tools will control the HAL polling
behaviour.
BATT_DISABLE_HAL_POLLING
AC_DISABLE_HAL_POLLING
These settings define the polling behaviour on AC and on battery. To disable
polling, set the options to 1, to enable, set them to 0.
HAL_POLLING_DEVICES
This setting defines for which devices the polling behaviour will be altered.
It should contain a space separated list of devices.
/etc/laptop-mode/conf.d/bluetooth.conf
The bluetooth module allows you to enable/disable bluetooth depending on the power state.
CONTROL_BLUETOOTH
If this option is enabled, laptop mode tools will enable/disable bluetooth when
the power state changes.
BATT_ENABLE_BLUETOOTH
AC_ENABLE_BLUETOOTH
These settings define whether bluetooth is enabled on AC and on battery. To
disable bluetooth, set the options to 0, to enable, set them to 1.
BLUETOOTH_INTERFACES
This setting defines the interfaces the bluetooth module will control. It should
contain a space separated list of interfaces. (Note that you probably have only
one bluetooth interface, and it will probably be named "hci0".)
/etc/laptop-mode/conf.d/intel-sata-powermgmt.conf
The intel-sata-powermgmt module allows you to enable the power saving mode for Intel AHCI
compliant SATA controllers. This power saving mode is also known as Aggressive Link Power
Management (ALPM).
CONTROL_INTEL_SATA_POWER
If this option is enabled, laptop mode tools will automatically enable the Intel
SATA controller power saving settings. The power saving settings are always
enabled, not only on battery power.
BATT_ACTIVATE_SATA_POWER=1
LM_AC_ACTIVATE_SATA_POWER=0
NOLM_AC_ACTIVATE_SATA_POWER=0
These settings control the behavior of the SATA devices under AC and battery
power states
/etc/laptop-mode/conf.d/sched-mc-power-savings.conf
The sched-mc-power-savings module allows you to tune the Linux kernel process scheduler to
optimize for power usage on multi-core and multi-processor computers.
CONTROL_SCHED_MC_POWER_SAVINGS
If this option is enabled, laptop mode tools will automatically configure the
kernel process scheduler to optimize for power usage on multi-core and multi-
processor computers. The optimizations will only be enabled in battery mode.
/etc/laptop-mode/conf.d/video-out.conf
The video-out module allows you to selectively disable video outputs depending on the
power status. This works only for video hardware that supports xrandr.
CONTROL_VIDEO_OUTPUTS
If this option is enabled, laptop mode tools will automatically disable the
configured video outputs.
BATT_DISABLE_VIDEO_OUTPUTS
LM_AC_DISABLE_VIDEO_OUTPUTS
NOLM_AC_DISABLE_VIDEO_OUTPUTS
These settings define which video outputs are to be disabled in which power
state. The format is a space-separated list of outputs. The allowed names of the
outputs depend on what the video hardware supports, they can be found by running
the "xrandr" command.
SEE ALSO
laptop_mode(8).
lm-profiler(8).
hdparm(8).
AUTHOR
This manual page was written by Bart Samwel (bart@samwel.tk). Permission is granted to
copy, distribute and/or modify this document under the terms of the GNU General Public
License, Version 2 any later version published by the Free Software Foundation.
LAPTOP-MODE.CONF(8)