glfs/general/sysutils/upower.xml

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../../general.ent">
  %general-entities;

  <!ENTITY upower-download-http "http://upower.freedesktop.org/releases/UPower-&upower-version;.tar.bz2">
  <!ENTITY upower-download-ftp  " ">
  <!ENTITY upower-md5sum        "822d7d495781c6bbed36981a7a78dd30">
  <!ENTITY upower-size          "442 MB">
  <!ENTITY upower-buildsize     "10 MB">
  <!ENTITY upower-time          "0.3 SBU">
]>

<sect1 id="upower" xreflabel="UPower-&upower-version;">
  <?dbhtml filename="upower.html"?>

  <sect1info>
    <othername>$LastChangedBy$</othername>
    <date>$Date$</date>
  </sect1info>

  <title>UPower-&upower-version;</title>

  <indexterm zone="upower">
    <primary sortas="a-UPower">UPower</primary>
  </indexterm>

  <sect2 role="package">
    <title>Introduction to UPower</title>

    <para>The <application>UPower</application> package provides an interface to
    enumerating power devices, listening to device events and querying history
    and statistics. Any application or service on the system can access the
    org.freedesktop.UPower service via the system message bus.</para>

    &lfs65_checked;

    <bridgehead renderas="sect3">Package Information</bridgehead>
    <itemizedlist spacing="compact">
      <listitem>
        <para>Download (HTTP): <ulink url="&upower-download-http;"/></para>
      </listitem>
      <listitem>
        <para>Download (FTP): <ulink url="&upower-download-ftp;"/></para>
      </listitem>
      <listitem>
        <para>Download MD5 sum: &upower-md5sum;</para>
      </listitem>
      <listitem>
        <para>Download size: &upower-size;</para>
      </listitem>
      <listitem>
        <para>Estimated disk space required: &upower-buildsize;</para>
      </listitem>
      <listitem>
        <para>Estimated build time: &upower-time;</para>
      </listitem>
    </itemizedlist>

    <bridgehead renderas="sect3">UPower Dependencies</bridgehead>

    <bridgehead renderas="sect4">Required</bridgehead>
    <para role="required"><xref linkend="polkit"/> and
    <xref linkend="udev"/> (with gudev)</para>

    <bridgehead renderas="sect4">Optional</bridgehead>
    <para role="optional"><xref linkend="gtk-doc"/></para>

    <para condition="html" role="usernotes">User Notes:
    <ulink url="&blfs-wiki;/upower"/></para>

  </sect2>

  <sect2 role="installation">
    <title>Installation of UPower</title>

    <para>Install <application>UPower</application> by running the following
    commands:</para>

<screen><userinput>./configure --prefix=/usr \
            --sysconfdir=/etc \
            --localstatedir=/var \
            --libexecdir=/usr/lib/upower &amp;&amp;
make</userinput></screen>

    <para>To test the results, issue: <command>make check</command>.</para>

    <para>Now, as the <systemitem class="username">root</systemitem> user:</para>

<screen role="root"><userinput>make install</userinput></screen>

  </sect2>

  <sect2 role="commands">
    <title>Command Explanations</title>

    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    href="../../xincludes/gtk-doc-rebuild.xml"/>

  </sect2>

  <sect2 role="content">
    <title>Contents</title>

    <segmentedlist>
      <segtitle>Installed Programs</segtitle>
      <segtitle>Installed Libraries</segtitle>
      <segtitle>Installed Directories</segtitle>

      <seglistitem>
        <seg>upower and upowerd</seg>
        <seg>libdevkit-power-gobject.{so,a} and libupower-glib.{so,a}</seg>
        <seg>/usr/{include/{DeviceKit-power/devkit-power-gobject,
        libupower-glib},lib/upower}, /var/lib/upower</seg>
      </seglistitem>
    </segmentedlist>

    <variablelist>
      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
      <?dbfo list-presentation="list"?>
      <?dbhtml list-presentation="table"?>

      <varlistentry id="upower-prog">
        <term><command>upower</command></term>
        <listitem>
          <para>is the <application>UPower</application> command line
          tool.</para>
          <indexterm zone="upower upower-prog">
            <primary sortas="b-upower">upower</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="upowerd">
        <term><command>upowerd</command></term>
        <listitem>
          <para>is the <application>UPower</application> Daemon. It provides the
          org.freedesktop.UPower service on the system message bus.</para>
          <indexterm zone="upower upowerd">
            <primary sortas="b-upowerd">upowerd</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="libdevkit-power-gobject">
        <term><filename class='libraryfile'>libdevkit-power-gobject.{so,a}</filename></term>
        <listitem>
          <para>contains the old DeviceKit-power API functions.</para>
          <indexterm zone="upower libdevkit-power-gobject">
            <primary sortas="c-libdevkit-power-gobject">libdevkit-power-gobject.{so,a}</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="libupower-glib">
        <term><filename class='libraryfile'>libupower-glib.{so,a}</filename></term>
        <listitem>
          <para>contains the <application>UPower</application> API
          functions.</para>
          <indexterm zone="upower libupower-glib">
            <primary sortas="c-libupower-glib">libupower-glib.{so,a}</primary>
          </indexterm>
        </listitem>
      </varlistentry>

    </variablelist>

  </sect2>

</sect1>