source: general/sysutils/upower.xml@ 1552ac8

10.0 10.1 11.0 7.10 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind ken/refactor-virt lazarus nosym perl-modules qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 1552ac8 was 1552ac8, checked in by DJ Lucas <dj@…>, 5 years ago

[Systemd merge] - gpm, sysstat, udisks, udisks2, upower to finish Chapter 12

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

  • Property mode set to 100644
File size: 7.4 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 "http://upower.freedesktop.org/releases/upower-&upower-version;.tar.xz">
8 <!ENTITY upower-download-ftp " ">
9 <!ENTITY upower-md5sum "78800e1ac7f92b24aabdf433e38f75d2">
10 <!ENTITY upower-size "416 KB">
11 <!ENTITY upower-buildsize "13 MB (add 2 MB for tests)">
12 <!ENTITY upower-time "0.2 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 &lfs79_checked;&gcc6_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="python3"/> (used only in the testsuite).
94 </para>
95
96 <para condition="html" role="usernotes">User Notes:
97 <ulink url="&blfs-wiki;/upower"/>
98 </para>
99 </sect2>
100
101 <sect2 role="installation">
102 <title>Installation of UPower</title>
103
104 <para>
105 Install <application>UPower</application> by running the following
106 commands:
107 </para>
108
109<screen><userinput>./configure --prefix=/usr \
110 --sysconfdir=/etc \
111 --localstatedir=/var \
112 --enable-deprecated \
113 --disable-static &amp;&amp;
114make</userinput></screen>
115
116 <para>
117 To test the results, issue: <command>make check</command>. Some
118 checks may not pass due to missing files. Test suite should be run from
119 a local GUI session started with dbus-launch.
120 </para>
121
122 <para>
123 Now, as the <systemitem class="username">root</systemitem> user:
124 </para>
125
126<screen role="root"><userinput>make install</userinput></screen>
127
128 </sect2>
129
130 <sect2 role="commands">
131 <title>Command Explanations</title>
132
133 <para>
134 <parameter>--enable-deprecated</parameter>: This switch enables
135 deprecated functionality which is still needed by some
136 applications.
137 </para>
138
139 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
140 href="../../xincludes/static-libraries.xml"/>
141
142 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
143 href="../../xincludes/gtk-doc-rebuild.xml"/>
144
145 </sect2>
146
147 <sect2 role="configuration">
148 <title>Configuring your kernel for UPower</title>
149
150<!-- FIXME: Update for systemd xref for gnome-power-manager after it goes in -->
151 <para>
152 To use the command <command>upower -w</command> for information about
153 processor wakeups (this command is used by <ulink url="http://ftp.gnome.org/pub/gnome/sources/gnome-power-manager/">gnome-power-manager</ulink>)
154 you need to enable CONFIG_TIMER_STATS. This is achieved in
155 <command>make menuconfig</command> by going to the &apos;kernel-hacking&apos;
156 menu and selecting &apos;Collect kernel timers statistics&apos;.
157 </para>
158
159 <sect3 id="upower-init" revision="systemd">
160 <title>Systemd Unit</title>
161
162 <para>
163 To start the <command>upowerd</command> daemon at boot,
164 enable the previously installed systemd unit by
165 running the following command as the
166 <systemitem class="username">root</systemitem> user:
167 </para>
168
169 <indexterm zone="upower upower-init">
170 <primary sortas="f-upower">upower</primary>
171 </indexterm>
172
173<screen role="root"><userinput>systemctl enable upower</userinput></screen>
174
175 </sect3>
176
177 </sect2>
178
179 <sect2 role="content">
180 <title>Contents</title>
181
182 <segmentedlist>
183 <segtitle>Installed Program<phrase revision="systemd">s</phrase></segtitle>
184 <segtitle>Installed Libraries</segtitle>
185 <segtitle>Installed Directories</segtitle>
186
187 <seglistitem>
188 <seg>
189 upower<phrase revision="systemd"> and upowerd</phrase>
190 </seg>
191 <seg>
192 libupower-glib.so
193 </seg>
194 <seg>
195 /etc/UPower,
196 /usr/include/libupower-glib, and
197 /var/lib/upower
198 </seg>
199 </seglistitem>
200 </segmentedlist>
201
202 <variablelist>
203 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
204 <?dbfo list-presentation="list"?>
205 <?dbhtml list-presentation="table"?>
206
207 <varlistentry id="upower-prog">
208 <term><command>upower</command></term>
209 <listitem>
210 <para>
211 is the <application>UPower</application> command line tool.
212 </para>
213 <indexterm zone="upower upower-prog">
214 <primary sortas="b-upower">upower</primary>
215 </indexterm>
216 </listitem>
217 </varlistentry>
218
219 <varlistentry id="upowerd" revision="systemd">
220 <term><command>upowerd</command></term>
221 <listitem>
222 <para>
223 is the <application>UPower</application> Daemon. It provides the
224 org.freedesktop.UPower service on the system message bus.
225 </para>
226 <indexterm zone="upower upowerd">
227 <primary sortas="b-upowerd">upowerd</primary>
228 </indexterm>
229 </listitem>
230 </varlistentry>
231
232 <varlistentry id="libupower-glib">
233 <term><filename class="libraryfile">libupower-glib.so</filename></term>
234 <listitem>
235 <para>
236 contains the <application>UPower</application> API functions.
237 </para>
238 <indexterm zone="upower libupower-glib">
239 <primary sortas="c-libupower-glib">libupower-glib.so</primary>
240 </indexterm>
241 </listitem>
242 </varlistentry>
243
244 </variablelist>
245
246 </sect2>
247
248</sect1>
Note: See TracBrowser for help on using the repository browser.