source: general/sysutils/upower.xml@ 14cff6d

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 14cff6d was 14cff6d, checked in by Pierre Labastie <pieere@…>, 6 years ago

upower-0.99.4

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

  • Property mode set to 100644
File size: 6.2 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 <para>
151 To use the command <command>upower -w</command> for information about
152 processor wakeups (this command is used by <ulink url="http://ftp.gnome.org/pub/gnome/sources/gnome-power-manager/">gnome-power-manager</ulink>)
153 you need to enable CONFIG_TIMER_STATS. This is achieved in
154 <command>make menuconfig</command> by going to the &apos;kernel-hacking&apos;
155 menu and selecting &apos;Collect kernel timers statistics&apos;.
156 </para>
157
158 </sect2>
159 <sect2 role="content">
160 <title>Contents</title>
161
162 <segmentedlist>
163 <segtitle>Installed Program</segtitle>
164 <segtitle>Installed Libraries</segtitle>
165 <segtitle>Installed Directories</segtitle>
166
167 <seglistitem>
168 <seg>
169 upower
170 </seg>
171 <seg>
172 libupower-glib.so
173 </seg>
174 <seg>
175 /etc/UPower,
176 /usr/include/libupower-glib, and
177 /var/lib/upower
178 </seg>
179 </seglistitem>
180 </segmentedlist>
181
182 <variablelist>
183 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
184 <?dbfo list-presentation="list"?>
185 <?dbhtml list-presentation="table"?>
186
187 <varlistentry id="upower-prog">
188 <term><command>upower</command></term>
189 <listitem>
190 <para>
191 is the <application>UPower</application> command line tool.
192 </para>
193 <indexterm zone="upower upower-prog">
194 <primary sortas="b-upower">upower</primary>
195 </indexterm>
196 </listitem>
197 </varlistentry>
198
199 <varlistentry id="libupower-glib">
200 <term><filename class="libraryfile">libupower-glib.so</filename></term>
201 <listitem>
202 <para>
203 contains the <application>UPower</application> API functions.
204 </para>
205 <indexterm zone="upower libupower-glib">
206 <primary sortas="c-libupower-glib">libupower-glib.so</primary>
207 </indexterm>
208 </listitem>
209 </varlistentry>
210
211 </variablelist>
212
213 </sect2>
214
215</sect1>
Note: See TracBrowser for help on using the repository browser.