Author: igor Date: Wed Jul 10 05:50:13 2013 New Revision: 11377 Log: Few fixes to pm-utils as noted by Armin
Added: trunk/BOOK/general/sysutils/pm-utils.xml (contents, props changed) Deleted: trunk/BOOK/general/sysutils/pmutils.xml Modified: trunk/BOOK/general.ent trunk/BOOK/general/sysutils/sysutils.xml trunk/BOOK/general/sysutils/upower.xml trunk/BOOK/networking/netutils/wicd.xml Modified: trunk/BOOK/general.ent ============================================================================== --- trunk/BOOK/general.ent Wed Jul 10 05:18:46 2013 (r11376) +++ trunk/BOOK/general.ent Wed Jul 10 05:50:13 2013 (r11377) @@ -347,7 +347,7 @@ <!ENTITY obex-data-server-version "0.4.6"> <!ENTITY obexd-version "0.48"> <!ENTITY pciutils-version "3.2.0"> -<!ENTITY pmutils-version "1.4.1"> +<!ENTITY pm-utils-version "1.4.1"> <!ENTITY raptor-version "2.0.9"> <!ENTITY rasqal-version "0.9.30"> <!ENTITY redland-version "1.0.16"> Added: trunk/BOOK/general/sysutils/pm-utils.xml ============================================================================== --- /dev/null 00:00:00 1970 (empty, because file is newly added) +++ trunk/BOOK/general/sysutils/pm-utils.xml Wed Jul 10 05:50:13 2013 (r11377) @@ -0,0 +1,255 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" + "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"; [ + <!ENTITY % general-entities SYSTEM "../../general.ent"> + %general-entities; + + <!ENTITY pm-utils-download-http "http://pm-utils.freedesktop.org/releases/pm-utils-&pm-utils-version;.tar.gz";> + <!ENTITY pm-utils-download-ftp " "> + <!ENTITY pm-utils-md5sum "1742a556089c36c3a89eb1b957da5a60"> + <!ENTITY pm-utils-size "204 KB"> + <!ENTITY pm-utils-buildsize "1.6 MB"> + <!ENTITY pm-utils-time "0.1 SBU"> +]> + +<sect1 id="pm-utils" xreflabel="pm-utils-&pm-utils-version;"> + <?dbhtml filename="pm-utils.html"?> + + <sect1info> + <othername>$LastChangedBy: igor $</othername> + <date>$Date: 2013-07-10 14:18:46 +0200 (Wed, 10 Jul 2013) $</date> + </sect1info> + + <title>pm-utils-&pm-utils-version;</title> + + <indexterm zone="pm-utils"> + <primary sortas="a-pm-utils">pm-utils</primary> + </indexterm> + + <sect2 role="package"> + <title>Introduction to Power Management Utilities</title> + + <para> + The <application>Power Management Utilities</application> is a small + collection of scripts to suspend and hibernate computer that can be used + to run user supplied scripts on suspend and resume. + </para> + + &lfs73_checked; + + <bridgehead renderas="sect3">Package Information</bridgehead> + <itemizedlist spacing="compact"> + <listitem> + <para> + Download (HTTP): <ulink url="&pm-utils-download-http;"/> + </para> + </listitem> + <listitem> + <para> + Download (FTP): <ulink url="&pm-utils-download-ftp;"/> + </para> + </listitem> + <listitem> + <para> + Download MD5 sum: &pm-utils-md5sum; + </para> + </listitem> + <listitem> + <para> + Download size: &pm-utils-size; + </para> + </listitem> + <listitem> + <para> + Estimated disk space required: &pm-utils-buildsize; + </para> + </listitem> + <listitem> + <para> + Estimated build time: &pm-utils-time; + </para> + </listitem> + </itemizedlist> + + <bridgehead renderas="sect3">Power Management Utilities Dependencies</bridgehead> + + <bridgehead renderas="sect4">Optional</bridgehead> + <para role="optional"> + <xref linkend="xmlto"/> (to generate man pages) + </para> + + <bridgehead renderas="sect4">Optional (runtime)</bridgehead> + <para role="optional"> + <xref linkend="hdparm"/>, + <xref linkend="wireless_tools"/> and + <ulink url="https://www.kernel.org/pub/software/network/ethtool/";>ethtool</ulink> + <!-- vbetool, deprecated? --> + <!-- radeontool, deprecated? --> + </para> + + <para condition="html" role="usernotes">User Notes: + <ulink url="&blfs-wiki;/pm-utils"/> + </para> + </sect2> + + <sect2 role="installation"> + <title>Installation of Power Management Utilities</title> + + <para> + Install <application>Power Management Utilities</application> by + running the following commands: + </para> + +<screen><userinput>./configure --prefix=/usr --sysconfdir=/etc \ + --docdir=/usr/share/doc/pm-utils-&pm-utils-version; && +make</userinput></screen> + + <para> + This package does not come with a test suite. + </para> + + <para> + Now, as the <systemitem class="username">root</systemitem> user: + </para> + +<screen role="root"><userinput>make install</userinput></screen> + + <para> + If you don't have <xref linkend="xmlto"/> installed, copy pregenerated + man pages: + </para> + +<screen role="root"><userinput>install -v -m644 man/*.1 /usr/share/man/man1 && +install -v -m644 man/*.8 /usr/share/man/man8 && +ln -sv pm-action.8 /usr/share/man/man8/pm-suspend.8 && +ln -sv pm-action.8 /usr/share/man/man8/pm-hibernate.8 && +ln -sv pm-action.8 /usr/share/man/man8/pm-suspend-hybrid.8</userinput></screen> + + </sect2> + + <sect2 role="configuration"> + <title>Configuring Power Management Utilities</title> + + <para> + Suspend or resume functionality can be easily modified by installing files + into the /etc/pm/sleep.d directory. These files, known as hooks, are run + when the system is put into a sleep state or resumed. Default hooks are + located in /usr/lib/pm-utils/sleep.d, and user hooks should be put in + /etc/pm/sleep.d. See the pm-action(8) man page for more information. + </para> + + </sect2> + + <sect2 role="content"> + <title>Contents</title> + + <segmentedlist> + <segtitle>Installed Programs</segtitle> + <segtitle>Installed Libraries</segtitle> + <segtitle>Installed Directories</segtitle> + + <seglistitem> + <seg> + on_ac_power, pm-hibernate, pm-is-supported, pm-powersave, pm-suspend + and pm-suspend-hybrid + </seg> + <seg> + None + </seg> + <seg> + /etc/pm, /usr/lib/pm-utils and + /usr/share/doc/pm-utils-&pm-utils-version; + </seg> + </seglistitem> + </segmentedlist> + + <variablelist> + <bridgehead renderas="sect3">Short Descriptions</bridgehead> + <?dbfo list-presentation="list"?> + <?dbhtml list-presentation="table"?> + + <varlistentry id="on_ac_power"> + <term><command>on_ac_power</command></term> + <listitem> + <para> + is a script that determines whether the system is running on AC + power (rather than a battery). + </para> + <indexterm zone="pm-utils on_ac_power"> + <primary sortas="b-on_ac_power">on_ac_power</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="pm-hibernate"> + <term><command>pm-hibernate</command></term> + <listitem> + <para> + is a symlink to pm-action script that puts the computer into + hibernate mode (the system is fully powered off and system state is + saved to disk). + </para> + <indexterm zone="pm-utils pm-hibernate"> + <primary sortas="b-pm-hibernate">pm-hibernate</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="pm-is-supported"> + <term><command>pm-is-supported</command></term> + <listitem> + <para> + is a script that checks whether power management features such as + suspend and hibernate are supported. + </para> + <indexterm zone="pm-utils pm-is-supported"> + <primary sortas="b-pm-is-supported">pm-is-supported</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="pm-powersave"> + <term><command>pm-powersave</command></term> + <listitem> + <para> + is a script that puts the computer into powersaving (low power) + mode. + </para> + <indexterm zone="pm-utils pm-powersave"> + <primary sortas="b-pm-powersave">pm-powersave</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="pm-suspend"> + <term><command>pm-suspend</command></term> + <listitem> + <para> + is a symlink to pm-action script that puts the computer into suspend + mode (most devices are shut down and system state is saved in RAM). + </para> + <indexterm zone="pm-utils pm-suspend"> + <primary sortas="b-pm-suspend">pm-suspend</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="pm-suspend-hybrid"> + <term><command>pm-suspend-hybrid</command></term> + <listitem> + <para> + is a symlink to pm-action script that puts the computer into + hybrid-suspend mode (the system does everything it needs to + hibernate, but suspends instead of shutting down). + </para> + <indexterm zone="pm-utils pm-suspend-hybrid"> + <primary sortas="b-pm-suspend-hybrid">pm-suspend-hybrid</primary> + </indexterm> + </listitem> + </varlistentry> + + </variablelist> + + </sect2> + +</sect1> Modified: trunk/BOOK/general/sysutils/sysutils.xml ============================================================================== --- trunk/BOOK/general/sysutils/sysutils.xml Wed Jul 10 05:18:46 2013 (r11376) +++ trunk/BOOK/general/sysutils/sysutils.xml Wed Jul 10 05:50:13 2013 (r11377) @@ -39,7 +39,7 @@ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="obex-data-server.xml"/> <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="obexd.xml"/> <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="pciutils.xml"/> - <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="pmutils.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="pm-utils.xml"/> <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="raptor.xml"/> <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="rasqal.xml"/> <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="redland.xml"/> Modified: trunk/BOOK/general/sysutils/upower.xml ============================================================================== --- trunk/BOOK/general/sysutils/upower.xml Wed Jul 10 05:18:46 2013 (r11376) +++ trunk/BOOK/general/sysutils/upower.xml Wed Jul 10 05:50:13 2013 (r11377) @@ -84,6 +84,11 @@ <xref linkend="udev-extras"/> (for GUdev) </para> + <bridgehead renderas="sect4">Recommended (runtime)</bridgehead> + <para role="recommended"> + <xref linkend="pm-utils"/> + </para> + <bridgehead renderas="sect4">Optional (Required if building GNOME)</bridgehead> <para role="optional"> <xref linkend="gobject-introspection"/> Modified: trunk/BOOK/networking/netutils/wicd.xml ============================================================================== --- trunk/BOOK/networking/netutils/wicd.xml Wed Jul 10 05:18:46 2013 (r11376) +++ trunk/BOOK/networking/netutils/wicd.xml Wed Jul 10 05:50:13 2013 (r11377) @@ -98,7 +98,7 @@ <bridgehead renderas="sect4">Optional</bridgehead> <para role="optional"> - <xref linkend="pmutils"/> (for suspend/resume integration), + <xref linkend="pm-utils"/> (for suspend/resume integration), <ulink url="http://excess.org/urwid/";>Urwid</ulink> (for the Curses-based frontend) and <ulink url="http://babel.edgewall.org/";>Babel</ulink> (for internationalization) </para> -- http://linuxfromscratch.org/mailman/listinfo/blfs-book FAQ: http://www.linuxfromscratch.org/blfs/faq.html Unsubscribe: See the above information page
