source: general/sysutils/upower.xml@ ff204c0a

10.0 10.1 11.0 8.4 9.0 9.1 bdubbs/svn ken/refactor-virt lazarus qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since ff204c0a was ff204c0a, checked in by Bruce Dubbs <bdubbs@…>, 3 years ago

Update to upower-0.99.9.
Update to exo-0.12.4.
Update to libwebp-1.0.2.
Remove hardcoded version from docbook-xsl-nons

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@21006 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 8.0 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY upower-download-http "https://upower.freedesktop.org/releases/upower-&upower-version;.tar.xz">
8 <!ENTITY upower-download-ftp " ">
9 <!ENTITY upower-md5sum "3b2f729ab05afa5df70d0c387194c9fc">
10 <!ENTITY upower-size "440 KB">
11 <!ENTITY upower-buildsize "11 MB">
12 <!ENTITY upower-time "0.1 SBU">
13]>
14
15<sect1 id="upower" xreflabel="UPower-&upower-version;">
16 <?dbhtml filename="upower.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>UPower-&upower-version;</title>
24
25 <indexterm zone="upower">
26 <primary sortas="a-UPower">UPower</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to UPower</title>
31
32 <para>
33 The <application>UPower</application> package provides an interface to
34 enumerating power devices, listening to device events and querying history
35 and statistics. Any application or service on the system can access the
36 org.freedesktop.UPower service via the system message bus.
37 </para>
38
39 &lfs83_checked;
40
41 <bridgehead renderas="sect3">Package Information</bridgehead>
42 <itemizedlist spacing="compact">
43 <listitem>
44 <para>
45 Download (HTTP): <ulink url="&upower-download-http;"/>
46 </para>
47 </listitem>
48 <listitem>
49 <para>
50 Download (FTP): <ulink url="&upower-download-ftp;"/>
51 </para>
52 </listitem>
53 <listitem>
54 <para>
55 Download MD5 sum: &upower-md5sum;
56 </para>
57 </listitem>
58 <listitem>
59 <para>
60 Download size: &upower-size;
61 </para>
62 </listitem>
63 <listitem>
64 <para>
65 Estimated disk space required: &upower-buildsize;
66 </para>
67 </listitem>
68 <listitem>
69 <para>
70 Estimated build time: &upower-time;
71 </para>
72 </listitem>
73 </itemizedlist>
74
75 <bridgehead renderas="sect3">UPower Dependencies</bridgehead>
76
77 <bridgehead renderas="sect4">Required</bridgehead>
78 <para role="required">
79 <xref linkend="dbus-glib"/>,
80 <xref linkend="libgudev"/>,
81 <xref linkend="libusb"/>, and
82 <xref linkend="polkit"/>
83 </para>
84
85 <bridgehead renderas="sect4">Optional (Required if building GNOME)</bridgehead>
86 <para role="optional">
87 <xref linkend="gobject-introspection"/>
88 </para>
89
90 <bridgehead renderas="sect4">Optional</bridgehead>
91 <para role="optional">
92 <xref linkend="gtk-doc"/> and
93 <xref linkend="pygobject3"/>,
94 <ulink url="https://launchpad.net/umockdev/">umockdev</ulink>, and
95 <ulink url="https://pypi.python.org/pypi/python-dbusmock">python-dbusmock</ulink>
96 (for part of the testsuite).
97 </para>
98
99 <para condition="html" role="usernotes">User Notes:
100 <ulink url="&blfs-wiki;/upower"/>
101 </para>
102 </sect2>
103
104 <sect2 role="installation">
105 <title>Installation of UPower</title>
106
107 <para>
108 Install <application>UPower</application> by running the following
109 commands:
110 </para>
111
112<screen><userinput>./configure --prefix=/usr \
113 --sysconfdir=/etc \
114 --localstatedir=/var \
115 --enable-deprecated \
116 --disable-static &amp;&amp;
117make</userinput></screen>
118
119 <para>
120 To test the results, issue: <command>make check</command>. Some
121 checks may not pass due to missing files. Test suite should be run from
122 a local GUI session started with dbus-launch.
123 </para>
124
125 <para>
126 Now, as the <systemitem class="username">root</systemitem> user:
127 </para>
128
129<screen role="root"><userinput>make install</userinput></screen>
130
131 </sect2>
132
133 <sect2 role="commands">
134 <title>Command Explanations</title>
135
136 <para>
137 <parameter>--enable-deprecated</parameter>: This switch enables
138 deprecated functionality which is still needed by some
139 applications.
140 </para>
141
142 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
143 href="../../xincludes/static-libraries.xml"/>
144
145 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
146 href="../../xincludes/gtk-doc-rebuild.xml"/>
147
148 </sect2>
149
150 <sect2 role="configuration" revision="systemd">
151
152 <title>Configuring UPower</title>
153<!-- timer statistics have been removed from kernel (since 4.11)
154 I do not know if there is a replacement. See
155 https://patchwork.kernel.org/patch/9561519
156 and https://bugs.freedesktop.org/show_bug.cgi?id=100626
157
158 <para>
159 To use the command <command>upower -w</command> for information about
160 processor wakeups (this command is used by <phrase revision="sysv"><ulink url="http://ftp.gnome.org/pub/gnome/sources/gnome-power-manager/">gnome-power-manager</ulink></phrase><phrase revision="systemd"><xref linkend="gnome-power-manager"/></phrase>)
161 you need to enable CONFIG_TIMER_STATS. This is achieved in
162 <command>make menuconfig</command> by going to the &apos;kernel-hacking&apos;
163 menu and selecting &apos;Collect kernel timers statistics&apos;.
164 </para>
165-->
166 <sect3 id="upower-init" revision="systemd">
167 <title>Systemd Unit</title>
168
169 <para>
170 To start the <command>UPower</command> service at boot,
171 enable the previously installed systemd unit by
172 running the following command as the
173 <systemitem class="username">root</systemitem> user:
174 </para>
175
176 <indexterm zone="upower upower-init">
177 <primary sortas="f-upower">upower</primary>
178 </indexterm>
179
180<screen role="root"><userinput>systemctl enable upower</userinput></screen>
181
182 </sect3>
183
184 </sect2>
185
186 <sect2 role="content">
187 <title>Contents</title>
188
189 <segmentedlist>
190 <segtitle>Installed Program<!--
191See below... <phrase revision="systemd">s</phrase>--></segtitle>
192 <segtitle>Installed Libraries</segtitle>
193 <segtitle>Installed Directories</segtitle>
194
195 <seglistitem>
196 <seg>
197 upower
198<!-- <phrase revision="systemd"> and upowerd</phrase>
199Upowerd should not be listed, as it is in /usr/libexec, and is not supposed
200to be run by a user. Furthermore, upowerd is also in sysv, and there is no
201reason so single out systemd here. -->
202 </seg>
203 <seg>
204 libupower-glib.so
205 </seg>
206 <seg>
207 /etc/UPower,
208 /usr/include/libupower-glib, and
209 /var/lib/upower
210 </seg>
211 </seglistitem>
212 </segmentedlist>
213
214 <variablelist>
215 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
216 <?dbfo list-presentation="list"?>
217 <?dbhtml list-presentation="table"?>
218
219 <varlistentry id="upower-prog">
220 <term><command>upower</command></term>
221 <listitem>
222 <para>
223 is the <application>UPower</application> command line tool.
224 </para>
225 <indexterm zone="upower upower-prog">
226 <primary sortas="b-upower">upower</primary>
227 </indexterm>
228 </listitem>
229 </varlistentry>
230<!-- See above
231 <varlistentry id="upowerd" revision="systemd">
232 <term><command>upowerd</command></term>
233 <listitem>
234 <para>
235 is the <application>UPower</application> Daemon. It provides the
236 org.freedesktop.UPower service on the system message bus.
237 </para>
238 <indexterm zone="upower upowerd">
239 <primary sortas="b-upowerd">upowerd</primary>
240 </indexterm>
241 </listitem>
242 </varlistentry>-->
243
244 <varlistentry id="libupower-glib">
245 <term><filename class="libraryfile">libupower-glib.so</filename></term>
246 <listitem>
247 <para>
248 contains the <application>UPower</application> API functions.
249 </para>
250 <indexterm zone="upower libupower-glib">
251 <primary sortas="c-libupower-glib">libupower-glib.so</primary>
252 </indexterm>
253 </listitem>
254 </varlistentry>
255
256 </variablelist>
257
258 </sect2>
259
260</sect1>
Note: See TracBrowser for help on using the repository browser.