Provided by: laptop-mode-tools_1.74-1.2_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. 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)