← Back to branch summary

~ubuntu-branches/ubuntu/maverick/pm-utils/maverick

« back to all changes in this revision

Viewing changes to man/pm-action.xml

  • Committer: Bazaar Package Importer
  • Author(s): Michael Biebl, Michael Biebl, Martin Pitt
  • Date: 2010-07-13 16:24:27 UTC
  • mfrom: (40.1.2 experimental)
  • Revision ID: james.westby@ubuntu.com-20100713162427-vpmf1kkj79e715j0
Tags: 1.4.1-1
http://bugs.debian.org/588587
http://bugs.debian.org/588768
[ Michael Biebl ]
* New upstream release. (Closes: #588587)
  The main improvement is that this ships some generally useful power
  management hooks by default. Note that this conflicts with similar
  packages such as laptop-mode-tools or pm-utils-powersave-policy, so you
  should not enable them and pm-utils at the same time.
  Current hooks when switching to battery:
  - [disable_wol] Disable Wake-on-LAN on ethernet cards
  - [hal-cd-polling] Disable HAL's polling of CD drives for automounting
    them. Note that this HAL functionality is already obsolete in Debian's
    current GNOME, but still being used in current KDE and XFCE desktops.
  - [harddrive] More aggressive harddrive spindown times
  - [intel-audio-powersave] Put ac97 and hda cards to sleep when inactive.
  - [journal-commit, xfs_buffer] Delay ext[34]/ext journal/metadata
    writeback
  - [laptop-mode] Delay hard disk writeback times of dirty caches, to avoid
    spin ups
  - [pcie_aspm] PCI express cards power saving
  - [readahead] More speculative readahead, at the expense of using more
    memory
  - [sata_alpm] Enable SATA link power management
  - [sched-powersave] Try to use fewer cores on multi-core machines
  - [wireless] Reduce RX/TX power when idle on some known-working drivers
    (various Intel chips for now)
* video-quirks/*
  - Update quirks to latest upstream release pm-quirks-20100619.
* Drop patches applied upstream
  - debian/patches/05-inspiron-8600-ati-quirk.patch
  - debian/patches/08-fix-lock-file-handling.patch
  - debian/patches/12-man-page-fixes.patch
* Refresh and update all patches so they apply cleanly.
* debian/control
  - Demote radeontool to Suggests. The standard Debian/Ubuntu kernels use
    KMS for radeon which makes this tool obsolete. (Closes: #588768)

[ Martin Pitt ]
* debian/control: Add hdparm Recommends and ethtool/wireless-tools Suggests,
  for the newly added power saving hooks.
* debian/control: Conflicts/Replaces: pm-utils-powersave-policy, superseded
  by the now integrated power.d hooks.

Show diffs side-by-side

added added

removed removed

Lines of Context:
man/pm-action.xml
104
104
      For some options external programs are needed.
105
105
    </para>
106
106
    <para>
107
 
      These commands will usually be called by <command>DeviceKit-power</command>
 
107
      These commands will usually be called by <command>UPower</command>
108
108
      or <command>hald</command> when triggered to do so by a program
109
109
      in a desktop session such as <command>gnome-power-manager</command>. 
110
110
      Calling them from the command line is also possible, but it is not 
144
144
        <listitem>
145
145
          <para>
146
146
            Hybrid-suspend is the process where the system does everything it
147
 
            needs to hibernate, suspends instead of shutting down. This means that 
 
147
            needs to hibernate, but suspends instead of shutting down. This means that
148
148
            your computer can wake up quicker than for normal hibernation 
149
149
            if you do not run out of power, and you can resume even if you run out of power.
150
150
            s2both(8) is an hybrid-suspend implementation.
166
166
    </para>
167
167
    <para>
168
168
      If <command>pm-suspend</command>, <command>pm-hibernate</command>,
169
 
      or <command>pm-suspend-hybrid</command> is invoked without any
 
169
      or <command>pm-suspend-hybrid</command> are invoked without any
170
170
      commandline parameters, they will try to grab the correct quirks
171
 
      from HAL if it is installed.
 
171
      from the internal quirk database.
172
172
    </para>
173
173
    <variablelist>
174
174
      <!-- Use the variablelist.term.separator and the
224
224
          <para>
225
225
            This option initializes the video card into a VGA text mode, and
226
226
            then uses the BIOS to set the video mode. On some systems S3 BIOS
227
 
            only initializes the video bios to text mode, and so both S3 BIOS
 
227
            only initializes the video BIOS to text mode, and so both S3 BIOS
228
228
            and S3 MODE are needed.
229
229
          </para>
230
230
        </listitem>
288
288
            <filename>/etc/pm/last_known_working.quirkdb</filename>.
289
289
            This parameter will only save the actual quirks that were 
290
290
            used to successfully suspend/resume a system, and will be 
291
 
            specific to the exact configuration of that sustem, including
 
291
            specific to the exact configuration of that system, including
292
292
            the video hardware, video driver, and whether or not kernel
293
293
            modesetting was used.
294
294
          </para>
323
323
        <term><filename>/usr/lib/pm-utils/sleep.d</filename></term>
324
324
        <listitem>
325
325
          <para>
326
 
            Programs in these directories (we call them hooks) are 
 
326
            Programs in these directories (called hooks) are
327
327
            combined and executed in C sort order before suspend and 
328
328
            hibernate with as argument 'suspend' or 'hibernate'.
329
 
            Afterwards they are called  in reverse order with
 
329
            Afterwards they are called in reverse order with
330
330
            argument 'resume' and 'thaw' respectively.
331
331
            If both directories contain a similar named file,
332
 
            the one in /etc/pm/sleep.d will get preference. It
 
332
            the one in <filename>/etc/pm/sleep.d</filename> will get preference. It
333
333
            is possible to disable a hook in the distribution
334
334
            directory by putting a non-executable file in 
335
 
            /etc/pm/sleep.d, or by adding it to the HOOK_BLACKLIST 
 
335
            <filename>/etc/pm/sleep.d</filename>, or by adding it to the HOOK_BLACKLIST
336
336
            configuration variable.
337
337
          </para>
338
338
        </listitem>
394
394
    <title>CONFIGURATION VARIABLES</title>
395
395
    <para>
396
396
      Configuration variables defined by pm-utils. These can be set 
397
 
      in any file in /etc/pm/config.d
 
397
      in any file in <filename>/etc/pm/config.d/</filename>.
398
398
    </para>
399
399
    
400
400
    <variablelist>
479
479
            If your system clock drifts across a suspend/resume or
480
480
            hibernate/thaw cycle, you should set this to true.
481
481
            This will cause pm-utils to synchronize the system clock
482
 
            whenever we go through a sleep/wake cycle at the expense of 
 
482
            whenever going through a sleep/wake cycle at the expense of
483
483
            making suspend/resume take longer.
484
484
          </para>
485
485
        </listitem>
502
502
    <title>RETURN VALUES</title>
503
503
    <para>
504
504
      Return values less than 128 mean that pm-action failed before trying to
505
 
      put the system in the requested power saving state.  A return value
506
 
      of 128 means that we tried to put the machine in the requested power state
507
 
      but failed.  A return value greater than 128 means we encountered an error
508
 
      and we also failed to enter the requested power saving state.
 
505
      put the system in the requested power saving state. A return value
 
506
      of 128 means that pm-action tried to put the machine in the requested power state
 
507
      but failed. A return value greater than 128 means pm-action encountered an error
 
508
      and also failed to enter the requested power saving state.
509
509
    </para>
510
510
  </refsect1>
511
511
  <refsect1 id="debugging">