Provided by: laptop-mode-tools_1.68-3ubuntu1_all bug

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

       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. Default is 0

   /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/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 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/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/runtime-pm.conf
       The runtime-pm module allows you to enable the Runtime Power Management
       framework for the Linux kernel.

       CONTROL_RUNTIME_PM
                 If  this  option  is  enabled,   laptop   mode   tools   will
                 automatically  enable  the  Kernel's Runtime Power Management
                 settings. The power saving settings are always  enabled,  not
                 only on battery power.

   /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 upto 9. The command  needs  to
                 be specified in double quotes

   /etc/laptop-mode/conf.d/usb-autosuspend.conf
       The usb-autosuspend module allows you to automatically enable the Linux
       kernel's USB autosuspend feature for all USB devices.

       CONTROL_USB_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_USBID_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_USBID_BLACKLIST="046d:c025
                 0123:abcd"

   /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)