Provided by: laptop-mode-tools_1.57-1ubuntu1_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/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.

       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.

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

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