lfs/chapter06/libdbus.xml

122 lines
3.6 KiB
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;
]>
<sect1 id="ch-system-libdbus" role="wrap">
<?dbhtml filename="libdbus.html"?>
<sect1info condition="script">
<productname>libdbus</productname>
<productnumber>&dbus-version;</productnumber>
<address>&dbus-url;</address>
</sect1info>
<title>Libdbus-&dbus-version;</title>
<indexterm zone="ch-system-libdbus">
<primary sortas="a-libdbus">Libdbus</primary>
</indexterm>
<sect2 role="package">
<title/>
<para>Libdbus package provides a library to communicate with
D-Bus messagebus daemon. It is only installed to satisfy
circular dependency between Systemd and D-Bus.</para>
<segmentedlist>
<segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle>
<seglistitem>
<seg>&dbus-ch6-sbu;</seg>
<seg>&dbus-ch6-du;</seg>
</seglistitem>
</segmentedlist>
</sect2>
<sect2 role="installation">
<title>Installation of Libdbus</title>
<note>
<para><application>Libdbus</application> is part of the D-Bus sources.
You should first unpack the D-Bus tarball and change to the
<filename>dbus-&dbus-version;</filename> directory.</para>
</note>
<para>Prepare Libdbus for compilation:</para>
<screen><userinput remap="configure">./configure --prefix=/usr \
--sysconfdir=/etc \
--localstatedir=/var \
--libexecdir=/usr/lib/dbus-1.0 \
--disable-static</userinput></screen>
<para>Compile the package:</para>
<screen><userinput remap="make">make -C dbus libdbus-1.la</userinput></screen>
<para>This package does come with a testsuite, but it is not
possible to run it because only part of the package was
built.</para>
<para>Install the package:</para>
<screen><userinput remap="install">make -C dbus lib_LTLIBRARIES=libdbus-1.la \
install-libLTLIBRARIES \
install-dbusincludeHEADERS \
install-nodist_dbusarchincludeHEADERS
make install-pkgconfigDATA</userinput></screen>
<para>The shared library needs to be moved to
<filename class="directory">/lib</filename>, and as a result the
<filename class="extension">.so</filename> file in
<filename class="directory">/usr/lib</filename> will need to be recreated:</para>
<screen><userinput remap="install">mv -v /usr/lib/libdbus-1.so.* /lib
ln -sfv ../../lib/$(readlink /usr/lib/libdbus-1.so) /usr/lib/libdbus-1.so</userinput></screen>
</sect2>
<sect2 id="contents-libdbus" role="content">
<title>Contents of Libdbus</title>
<segmentedlist>
<segtitle>Installed programs</segtitle>
<segtitle>Installed libraries</segtitle>
<segtitle>Installed directories</segtitle>
<seglistitem>
<seg>none</seg>
<seg>libdbus-1.so</seg>
<seg>/usr/include/dbus-1.0, /usr/lib/dbus-1.0</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="libdbus-lib">
<term><filename class="libraryfile">libdbus-1.so</filename></term>
<listitem>
<para>Contains API functions used to communicate with the D-Bus
message bus.</para>
<indexterm zone="ch-system-libdbus libdbus-lib">
<primary sortas="c-libdbus">libdbus</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>