source: general/sysutils/upower.xml@ f57b5c7

10.0 10.1 11.0 7.10 7.4 7.5 7.6 7.6-blfs 7.6-systemd 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gnome kde5-13430 kde5-14269 kde5-14686 ken/refactor-virt krejzi/svn lazarus nosym perl-modules qt5new systemd-11177 systemd-13485 trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since f57b5c7 was f57b5c7, checked in by Krejzi <krejzi@…>, 9 years ago

Add missing dependency to UPower page.

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

  • Property mode set to 100644
File size: 6.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 "bfaaa1e7f8479fca5594406b3c36dff9">
10 <!ENTITY upower-size "393 KB">
11 <!ENTITY upower-buildsize "9.3 MB">
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 &lfs72_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="intltool"/>,
81 <xref linkend="libusb"/>,
82 <xref linkend="polkit"/>, and
83 <xref linkend="udev"/> or <xref linkend="udev-extras"/> (for GUdev)
84 </para>
85
86 <bridgehead renderas="sect4">Optional (Required if building GNOME)</bridgehead>
87 <para role="optional">
88 <xref linkend="gobject-introspection"/>
89 </para>
90
91 <bridgehead renderas="sect4">Optional</bridgehead>
92 <para role="optional">
93 <xref linkend="gtk-doc"/> and
94 <xref linkend="python3"/> (used only in the testsuite).
95 </para>
96
97 <para condition="html" role="usernotes">User Notes:
98 <ulink url="&blfs-wiki;/upower"/>
99 </para>
100 </sect2>
101
102 <sect2 role="installation">
103 <title>Installation of UPower</title>
104
105 <para>
106 Install <application>UPower</application> by running the following
107 commands:
108 </para>
109
110<screen><userinput>./configure --prefix=/usr \
111 --sysconfdir=/etc \
112 --localstatedir=/var \
113 --libexecdir=/usr/lib/upower \
114 --disable-static &amp;&amp;
115make</userinput></screen>
116
117 <para>
118 To test the results, issue: <command>make check</command>.
119 </para>
120
121 <para>
122 Now, as the <systemitem class="username">root</systemitem> user:
123 </para>
124
125<screen role="root"><userinput>make install</userinput></screen>
126
127 </sect2>
128
129 <sect2 role="commands">
130 <title>Command Explanations</title>
131
132 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
133 href="../../xincludes/static-libraries.xml"/>
134
135 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
136 href="../../xincludes/gtk-doc-rebuild.xml"/>
137
138 </sect2>
139
140 <sect2 role="configuration">
141 <title>Configuring your kernel for UPower</title>
142
143 <para>
144 To use the command <command>upower -w</command> for information about
145 processor wakeups (this command is used by <xref linkend="gnome-power-manager"/>)
146 you need to enable CONFIG_TIMER_STATS. This is achieved in
147 <command>make menuconfig</command> by going to the &apos;kernel-hacking&apos;
148 menu and selecting &apos;Collect kernel timers statistics&apos;.
149 </para>
150
151 </sect2>
152 <sect2 role="content">
153 <title>Contents</title>
154
155 <segmentedlist>
156 <segtitle>Installed Programs</segtitle>
157 <segtitle>Installed Libraries</segtitle>
158 <segtitle>Installed Directories</segtitle>
159
160 <seglistitem>
161 <seg>
162 upower and upowerd
163 </seg>
164 <seg>
165 libupower-glib.so
166 </seg>
167 <seg>
168 /etc/UPower,
169 /usr/include/libupower-glib,
170 /usr/lib/upower and
171 /var/lib/upower
172 </seg>
173 </seglistitem>
174 </segmentedlist>
175
176 <variablelist>
177 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
178 <?dbfo list-presentation="list"?>
179 <?dbhtml list-presentation="table"?>
180
181 <varlistentry id="upower-prog">
182 <term><command>upower</command></term>
183 <listitem>
184 <para>
185 is the <application>UPower</application> command line tool.
186 </para>
187 <indexterm zone="upower upower-prog">
188 <primary sortas="b-upower">upower</primary>
189 </indexterm>
190 </listitem>
191 </varlistentry>
192
193 <varlistentry id="upowerd">
194 <term><command>upowerd</command></term>
195 <listitem>
196 <para>
197 is the <application>UPower</application> Daemon. It provides the
198 org.freedesktop.UPower service on the system message bus.
199 </para>
200 <indexterm zone="upower upowerd">
201 <primary sortas="b-upowerd">upowerd</primary>
202 </indexterm>
203 </listitem>
204 </varlistentry>
205
206 <varlistentry id="libupower-glib">
207 <term><filename class='libraryfile'>libupower-glib.so</filename></term>
208 <listitem>
209 <para>
210 contains the <application>UPower</application> API functions.
211 </para>
212 <indexterm zone="upower libupower-glib">
213 <primary sortas="c-libupower-glib">libupower-glib.so</primary>
214 </indexterm>
215 </listitem>
216 </varlistentry>
217
218 </variablelist>
219
220 </sect2>
221
222</sect1>
Note: See TracBrowser for help on using the repository browser.