glfs/general/sysutils/packagekit.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 packagekit-download-http "http://www.packagekit.org/releases/PackageKit-&packagekit-version;.tar.xz">
  <!ENTITY packagekit-download-ftp  " ">
  <!ENTITY packagekit-md5sum        "f31a53e5bbd95ee737fce0b4bd174083">
  <!ENTITY packagekit-size          "7.5 MB">
  <!ENTITY packagekit-buildsize     "104 MB">
  <!ENTITY packagekit-time          "1.0 SBU">
]>

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

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

  <title>packagekit-&packagekit-version;</title>

  <indexterm zone="packagekit">
    <primary sortas="a-packagekit">packagekit</primary>
  </indexterm>

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

    <para><application>PackageKit</application> is a system designed to make
    installing and updating software on your computer easier. The primary design
    goal is to unify all the software graphical tools used in different
    distributions, and use some of the latest technology like PolicyKit to make
    the process suck less.</para>

    <para>If you, as a BLFS user, are offended by the above description of software
    installation, please be aware that this package is only included here because it
    is a required dependency for a <emphasis>full</emphasis>
    <application>GNOME</application> desktop.</para>

    &lfs70_built;

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

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

    <bridgehead renderas="sect4">Required</bridgehead>
    <para role="required"><xref linkend="glib2"/>,
    <xref linkend="gtk3"/>,
    <xref linkend="dbus"/>, and
    <xref linkend="dbus-glib"/></para>

    <bridgehead renderas="sect4">Recommended</bridgehead>
    <para role="recommended"><xref linkend="udev"/> (specifically, gudev),
    <xref linkend="NetworkManager"/>, and
    <xref linkend="polkit"/></para>

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

  </sect2>

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

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

    <!-- FWIW, \-\-disable-browser-plugin is the default, so no need to specify it -->
<screen><userinput>./configure --prefix=/usr \
            --sysconfdir=/etc \
            --libexecdir=/usr/lib/PackageKit \
            --localstatedir=/var \
            --disable-tests \
            --disable-qt &amp;&amp;
make</userinput></screen>

    <para>Although this package has a testsuite, it fails, apparently looking for
    <filename>/lib/PackageKit/desktop-files.db</filename>.</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>

    <para><parameter>--sysconfdir=/etc</parameter>: This parameter puts
    various files and a <application>PackageKit</application> directory into
    <filename class="directory">/etc</filename> instead of
    <filename class="directory">/usr/etc</filename>.</para>

    <para><parameter>--libexecdir=/usr/lib/PackageKit</parameter>: This parameter
    puts <command>packagekitd</command> and its helper applications into
    <filename class="directory">/usr/lib/PackageKit</filename> instead of
    <filename class="directory">/usr/libexec</filename>.</para>

    <para><parameter>--localstatedir=/var</parameter>: This parameter
    puts files in <filename class="directory">/var</filename> instead of
    <filename class="directory">/usr/var</filename>.</para>

    <para><parameter>--disable-tests</parameter>: This package is only in the
    book as a build dependency, so we do not waste time building a testsuite
    which is going to fail.</para>

    <para><parameter>--disable-qt</parameter>: This parameter prevents the package
    testing for, and linking to, <application>Qt</application> since it is only
    included in the book as a required dependency of <application>GNOME</application>.
    </para>

  </sect2>

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

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

      <seglistitem>
        <seg>__init__.py, backend.py, enums.py, filter.py, misc.py, package.py, packagekit-bugreport.sh, packagekitd, pk-command-not-found, pk-debuginfo-install, pk-device-rebind, pk-gstreamer-install, pkcon, pkgenpack, pkmon, and progress.py</seg>
        <seg>libpackagekit-glib2.{so,a}, libpk-gtk-module.{so,a}, libpk-plugin-clear-firmware-requests.{so,a}, libpk_backend_dummy.{so,a}, libpk_backend_test_fail.{so,a}, libpk_backend_test_nop.{so,a}, libpk_backend_test_spawn.{so,a}, libpk_backend_test_succeed.{so,a}, libpk_backend_test_thread.{so,a}, libpk_plugin-check-shared-libraries-in-use.{so,a}, libpk_plugin-no-update-process.{so,a}, libpk_plugin-scan-desktop-files.{so,a}, libpk_plugin-update-check-processes.{so,a}, libpk_plugin-update-package-list.{so,a}, and libpk_plugin_scripts.{so,a}</seg>
        <seg>/{etc/{PackageKit/events/{post-transaction.d,pre-transaction.d},bash_completion.d,cron.daily,dbus-1/system.d,profile.d,sysconfig},usr/{include/PackageKit/{backend,packagekit-glib2,plugin},lib/{PackageKit,packagekit-backend,packagekit-plugins,python2.7/site-packages/packagekit},share/{PackageKit/{helpers/test_spawn,website/img/thumbnails},gtk-doc/html/PackageKit,locale/{bg_BG/LC_MESSAGES,fa_IR/LC_MESSAGES}}},var/{cache/PackageKit/downloads,lib/PackageKit}}</seg>
      </seglistitem>
    </segmentedlist>

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

      <varlistentry id="__init__.py">
        <term><command>__init__.py</command></term>
        <listitem>
          <para>does this .....</para>
          <indexterm zone="packagekit __init__.py">
            <primary sortas="b-__init__.py">__init__.py</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="backend.py">
        <term><command>backend.py</command></term>
        <listitem>
          <para>does this .....</para>
          <indexterm zone="packagekit backend.py">
            <primary sortas="b-backend.py">backend.py</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="enums.py">
        <term><command>enums.py</command></term>
        <listitem>
          <para>does this .....</para>
          <indexterm zone="packagekit enums.py">
            <primary sortas="b-enums.py">enums.py</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="filter.py">
        <term><command>filter.py</command></term>
        <listitem>
          <para>does this .....</para>
          <indexterm zone="packagekit filter.py">
            <primary sortas="b-filter.py">filter.py</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="misc.py">
        <term><command>misc.py</command></term>
        <listitem>
          <para>does this .....</para>
          <indexterm zone="packagekit misc.py">
            <primary sortas="b-misc.py">misc.py</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="package.py">
        <term><command>package.py</command></term>
        <listitem>
          <para>does this .....</para>
          <indexterm zone="packagekit package.py">
            <primary sortas="b-package.py">package.py</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="packagekit-bugreport.sh">
        <term><command>packagekit-bugreport.sh</command></term>
        <listitem>
          <para>does this .....</para>
          <indexterm zone="packagekit packagekit-bugreport.sh">
            <primary sortas="b-packagekit-bugreport.sh">packagekit-bugreport.sh</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="packagekitd">
        <term><command>packagekitd</command></term>
        <listitem>
          <para>does this .....</para>
          <indexterm zone="packagekit packagekitd">
            <primary sortas="b-packagekitd">packagekitd</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="pk-command-not-found">
        <term><command>pk-command-not-found</command></term>
        <listitem>
          <para>does this .....</para>
          <indexterm zone="packagekit pk-command-not-found">
            <primary sortas="b-pk-command-not-found">pk-command-not-found</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="pk-debuginfo-install">
        <term><command>pk-debuginfo-install</command></term>
        <listitem>
          <para>does this .....</para>
          <indexterm zone="packagekit pk-debuginfo-install">
            <primary sortas="b-pk-debuginfo-install">pk-debuginfo-install</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="pk-device-rebind">
        <term><command>pk-device-rebind</command></term>
        <listitem>
          <para>does this .....</para>
          <indexterm zone="packagekit pk-device-rebind">
            <primary sortas="b-pk-device-rebind">pk-device-rebind</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="pk-gstreamer-install">
        <term><command>pk-gstreamer-install</command></term>
        <listitem>
          <para>does this .....</para>
          <indexterm zone="packagekit pk-gstreamer-install">
            <primary sortas="b-pk-gstreamer-install">pk-gstreamer-install</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="pkcon">
        <term><command>pkcon</command></term>
        <listitem>
          <para>does this .....</para>
          <indexterm zone="packagekit pkcon">
            <primary sortas="b-pkcon">pkcon</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="pkgenpack">
        <term><command>pkgenpack</command></term>
        <listitem>
          <para>does this .....</para>
          <indexterm zone="packagekit pkgenpack">
            <primary sortas="b-pkgenpack">pkgenpack</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="pkmon">
        <term><command>pkmon</command></term>
        <listitem>
          <para>does this .....</para>
          <indexterm zone="packagekit pkmon">
            <primary sortas="b-pkmon">pkmon</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="progress.py">
        <term><command>progress.py</command></term>
        <listitem>
          <para>does this .....</para>
          <indexterm zone="packagekit progress.py">
            <primary sortas="b-progress.py">progress.py</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="libpackagekit-glib2">
        <term><filename class='libraryfile'>libpackagekit-glib2.{so,a}</filename></term>
        <listitem>
          <para>contains functions that .....</para>
          <indexterm zone="packagekit libpackagekit-glib2">
            <primary sortas="c-libpackagekit-glib2">libpackagekit-glib2.{so,a}</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="libpk-gtk-module">
        <term><filename class='libraryfile'>libpk-gtk-module.{so,a}</filename></term>
        <listitem>
          <para>contains functions that .....</para>
          <indexterm zone="packagekit libpk-gtk-module">
            <primary sortas="c-libpk-gtk-module">libpk-gtk-module.{so,a}</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="libpk-plugin-clear-firmware-requests">
        <term><filename class='libraryfile'>libpk-plugin-clear-firmware-requests.{so,a}</filename></term>
        <listitem>
          <para>contains functions that .....</para>
          <indexterm zone="packagekit libpk-plugin-clear-firmware-requests">
            <primary sortas="c-libpk-plugin-clear-firmware-requests">libpk-plugin-clear-firmware-requests.{so,a}</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="libpk_backend_dummy">
        <term><filename class='libraryfile'>libpk_backend_dummy.{so,a}</filename></term>
        <listitem>
          <para>contains functions that .....</para>
          <indexterm zone="packagekit libpk_backend_dummy">
            <primary sortas="c-libpk_backend_dummy">libpk_backend_dummy.{so,a}</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="libpk_backend_test_fail">
        <term><filename class='libraryfile'>libpk_backend_test_fail.{so,a}</filename></term>
        <listitem>
          <para>contains functions that .....</para>
          <indexterm zone="packagekit libpk_backend_test_fail">
            <primary sortas="c-libpk_backend_test_fail">libpk_backend_test_fail.{so,a}</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="libpk_backend_test_nop">
        <term><filename class='libraryfile'>libpk_backend_test_nop.{so,a}</filename></term>
        <listitem>
          <para>contains functions that .....</para>
          <indexterm zone="packagekit libpk_backend_test_nop">
            <primary sortas="c-libpk_backend_test_nop">libpk_backend_test_nop.{so,a}</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="libpk_backend_test_spawn">
        <term><filename class='libraryfile'>libpk_backend_test_spawn.{so,a}</filename></term>
        <listitem>
          <para>contains functions that .....</para>
          <indexterm zone="packagekit libpk_backend_test_spawn">
            <primary sortas="c-libpk_backend_test_spawn">libpk_backend_test_spawn.{so,a}</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="libpk_backend_test_succeed">
        <term><filename class='libraryfile'>libpk_backend_test_succeed.{so,a}</filename></term>
        <listitem>
          <para>contains functions that .....</para>
          <indexterm zone="packagekit libpk_backend_test_succeed">
            <primary sortas="c-libpk_backend_test_succeed">libpk_backend_test_succeed.{so,a}</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="libpk_backend_test_thread">
        <term><filename class='libraryfile'>libpk_backend_test_thread.{so,a}</filename></term>
        <listitem>
          <para>contains functions that .....</para>
          <indexterm zone="packagekit libpk_backend_test_thread">
            <primary sortas="c-libpk_backend_test_thread">libpk_backend_test_thread.{so,a}</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="libpk_plugin-check-shared-libraries-in-use">
        <term><filename class='libraryfile'>libpk_plugin-check-shared-libraries-in-use.{so,a}</filename></term>
        <listitem>
          <para>contains functions that .....</para>
          <indexterm zone="packagekit libpk_plugin-check-shared-libraries-in-use">
            <primary sortas="c-libpk_plugin-check-shared-libraries-in-use">libpk_plugin-check-shared-libraries-in-use.{so,a}</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="libpk_plugin-no-update-process">
        <term><filename class='libraryfile'>libpk_plugin-no-update-process.{so,a}</filename></term>
        <listitem>
          <para>contains functions that .....</para>
          <indexterm zone="packagekit libpk_plugin-no-update-process">
            <primary sortas="c-libpk_plugin-no-update-process">libpk_plugin-no-update-process.{so,a}</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="libpk_plugin-scan-desktop-files">
        <term><filename class='libraryfile'>libpk_plugin-scan-desktop-files.{so,a}</filename></term>
        <listitem>
          <para>contains functions that .....</para>
          <indexterm zone="packagekit libpk_plugin-scan-desktop-files">
            <primary sortas="c-libpk_plugin-scan-desktop-files">libpk_plugin-scan-desktop-files.{so,a}</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="libpk_plugin-update-check-processes">
        <term><filename class='libraryfile'>libpk_plugin-update-check-processes.{so,a}</filename></term>
        <listitem>
          <para>contains functions that .....</para>
          <indexterm zone="packagekit libpk_plugin-update-check-processes">
            <primary sortas="c-libpk_plugin-update-check-processes">libpk_plugin-update-check-processes.{so,a}</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="libpk_plugin-update-package-list">
        <term><filename class='libraryfile'>libpk_plugin-update-package-list.{so,a}</filename></term>
        <listitem>
          <para>contains functions that .....</para>
          <indexterm zone="packagekit libpk_plugin-update-package-list">
            <primary sortas="c-libpk_plugin-update-package-list">libpk_plugin-update-package-list.{so,a}</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="libpk_plugin_scripts">
        <term><filename class='libraryfile'>libpk_plugin_scripts.{so,a}</filename></term>
        <listitem>
          <para>contains functions that .....</para>
          <indexterm zone="packagekit libpk_plugin_scripts">
            <primary sortas="c-libpk_plugin_scripts">libpk_plugin_scripts.{so,a}</primary>
          </indexterm>
        </listitem>
      </varlistentry>

    </variablelist>

  </sect2>

</sect1>