source: general/sysutils/upower.xml@ caed4c52

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 caed4c52 was caed4c52, checked in by Krejzi <krejzi@…>, 9 years ago

Package updates.

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