mirror of
https://git.linuxfromscratch.org/lfs.git
synced 2025-01-18 21:17:38 +00:00
251 lines
8.9 KiB
XML
251 lines
8.9 KiB
XML
<?xml version="1.0" encoding="UTF-8"?>
|
|
<!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-dbus" role="wrap" revision="systemd">
|
|
<?dbhtml filename="dbus.html"?>
|
|
|
|
<sect1info condition="script">
|
|
<productname>dbus</productname>
|
|
<productnumber>&dbus-version;</productnumber>
|
|
<address>&dbus-url;</address>
|
|
</sect1info>
|
|
|
|
<title>D-Bus-&dbus-version;</title>
|
|
|
|
<indexterm zone="ch-system-dbus">
|
|
<primary sortas="a-dbus">D-Bus</primary>
|
|
</indexterm>
|
|
|
|
<sect2 role="package">
|
|
<title/>
|
|
|
|
<para>D-Bus is a message bus system, a simple way for applications to talk
|
|
to one another. D-Bus supplies both a system daemon (for events such as
|
|
"new hardware device added" or "printer queue changed") and a
|
|
per-user-login-session daemon (for general IPC needs among user
|
|
applications). Also, the message bus is built on top of a general one-to-one
|
|
message passing framework, which can be used by any two applications to
|
|
communicate directly (without going through the message bus daemon).</para>
|
|
|
|
<segmentedlist>
|
|
<segtitle>&buildtime;</segtitle>
|
|
<segtitle>&diskspace;</segtitle>
|
|
|
|
<seglistitem>
|
|
<seg>&dbus-fin-sbu;</seg>
|
|
<seg>&dbus-fin-du;</seg>
|
|
</seglistitem>
|
|
</segmentedlist>
|
|
|
|
</sect2>
|
|
|
|
<sect2 role="installation">
|
|
<title>Installation of D-Bus</title>
|
|
|
|
<para>Prepare D-Bus for compilation:</para>
|
|
|
|
<screen><userinput remap="configure">./configure --prefix=/usr \
|
|
--sysconfdir=/etc \
|
|
--localstatedir=/var \
|
|
--runstatedir=/run \
|
|
--enable-user-session \
|
|
--disable-static \
|
|
--disable-doxygen-docs \
|
|
--disable-xml-docs \
|
|
--docdir=/usr/share/doc/dbus-&dbus-version; \
|
|
--with-system-socket=/run/dbus/system_bus_socket</userinput></screen>
|
|
|
|
<variablelist>
|
|
<title>The meaning of the configure options:</title>
|
|
|
|
<varlistentry>
|
|
<term>
|
|
<parameter>--runstatedir=/run</parameter> and
|
|
<parameter>--with-system-socket=/run/dbus/system_bus_socket</parameter>
|
|
</term>
|
|
<listitem>
|
|
<para>These cause the PID file and the system bus socket
|
|
to be in <filename class="directory">/run</filename>, instead of
|
|
the deprecated <filename class="directory">/var/run</filename>.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term>
|
|
<parameter>--enable-user-session</parameter>
|
|
</term>
|
|
<listitem>
|
|
<para>This ensures the D-Bus per-user service and socket unit
|
|
files are installed for Systemd. They are not useful (but
|
|
harmless) in a base LFS installation, however they can be used
|
|
once systemd is rebuilt with PAM support in BLFS.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
|
|
|
<para>Compile the package:</para>
|
|
|
|
<screen><userinput remap="make">make</userinput></screen>
|
|
|
|
<para>To test the results, issue:</para>
|
|
|
|
<screen><userinput remap="test">make check</userinput></screen>
|
|
|
|
<para>Many tests are disabled because they require additional
|
|
packages that are not included in LFS. Instructions for running the
|
|
comprehensive test suite can be found in
|
|
<ulink url="&blfs-book;general/dbus.html">the BLFS book</ulink>.</para>
|
|
|
|
<para>Install the package:</para>
|
|
|
|
<screen><userinput remap="install">make install</userinput></screen>
|
|
|
|
<para>Create a symlink so that D-Bus and systemd can use the same
|
|
<filename>machine-id</filename> file:</para>
|
|
|
|
<screen><userinput remap="install">ln -sfv /etc/machine-id /var/lib/dbus</userinput></screen>
|
|
|
|
</sect2>
|
|
|
|
<sect2 id="contents-dbus" role="content">
|
|
<title>Contents of D-Bus</title>
|
|
|
|
<segmentedlist>
|
|
<segtitle>Installed programs</segtitle>
|
|
<segtitle>Installed libraries</segtitle>
|
|
<segtitle>Installed directories</segtitle>
|
|
|
|
<seglistitem>
|
|
<seg>dbus-cleanup-sockets, dbus-daemon, dbus-launch, dbus-monitor,
|
|
dbus-run-session, dbus-send, dbus-test-tool,
|
|
dbus-update-activation-environment, and dbus-uuidgen</seg>
|
|
<seg>libdbus-1.so</seg>
|
|
<seg>/etc/dbus-1, /usr/include/dbus-1.0, /usr/lib/dbus-1.0,
|
|
/usr/share/dbus-1, /usr/share/doc/dbus-&dbus-version;,
|
|
and /var/lib/dbus</seg>
|
|
</seglistitem>
|
|
</segmentedlist>
|
|
|
|
<variablelist>
|
|
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
|
|
<?dbfo list-presentation="list"?>
|
|
<?dbhtml list-presentation="table"?>
|
|
|
|
<varlistentry id="dbus-cleanup-sockets">
|
|
<term><command>dbus-cleanup-sockets</command></term>
|
|
<listitem>
|
|
<para>is used to remove leftover sockets in a directory</para>
|
|
<indexterm zone="ch-system-dbus dbus-cleanup-sockets">
|
|
<primary sortas="b-dbus-cleanup-sockets">dbus-cleanup-sockets</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="dbus-daemon">
|
|
<term><command>dbus-daemon</command></term>
|
|
<listitem>
|
|
<para>Is the D-Bus message bus daemon</para>
|
|
<indexterm zone="ch-system-dbus dbus-daemon">
|
|
<primary sortas="b-dbus-daemon">dbus-daemon</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="dbus-launch">
|
|
<term><command>dbus-launch</command></term>
|
|
<listitem>
|
|
<para>Starts <command>dbus-daemon</command> from a shell
|
|
script</para>
|
|
<indexterm zone="ch-system-dbus dbus-launch">
|
|
<primary sortas="b-dbus-launch">dbus-launch</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="dbus-monitor">
|
|
<term><command>dbus-monitor</command></term>
|
|
<listitem>
|
|
<para>Monitors messages passing through a D-Bus message bus</para>
|
|
<indexterm zone="ch-system-dbus dbus-monitor">
|
|
<primary sortas="b-dbus-monitor">dbus-monitor</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="dbus-run-session">
|
|
<term><command>dbus-run-session</command></term>
|
|
<listitem>
|
|
<para>Starts a session bus instance of <command>dbus-daemon</command>
|
|
from a shell script and starts a specified program in that
|
|
session</para>
|
|
<indexterm zone="ch-system-dbus dbus-run-session">
|
|
<primary sortas="b-dbus-run-session">dbus-run-session</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="dbus-send">
|
|
<term><command>dbus-send</command></term>
|
|
<listitem>
|
|
<para>Sends a message to a D-Bus message bus</para>
|
|
<indexterm zone="ch-system-dbus dbus-send">
|
|
<primary sortas="b-dbus-send">dbus-send</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="dbus-test-tool">
|
|
<term><command>dbus-test-tool</command></term>
|
|
<listitem>
|
|
<para>Is a tool to help packages test
|
|
<application>D-Bus</application></para>
|
|
<indexterm zone="ch-system-dbus dbus-test-tool">
|
|
<primary sortas="b-dbus-test-tool">dbus-test-tool</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<!-- This is a very long command name. Excuse the long <primary> statement below. -->
|
|
<varlistentry id="dbus-update-activation-environment">
|
|
<term><command>dbus-update-activation-environment</command></term>
|
|
<listitem>
|
|
<para>Updates environment variables that will be set for
|
|
<application>D-Bus</application> session services</para>
|
|
<indexterm zone="ch-system-dbus dbus-update-activation-environment">
|
|
<primary sortas="b-dbus-update-activation-environment">dbus-update-activation-environment</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="dbus-uuidgen">
|
|
<term><command>dbus-uuidgen</command></term>
|
|
<listitem>
|
|
<para>Generates a universally unique ID</para>
|
|
<indexterm zone="ch-system-dbus dbus-uuidgen">
|
|
<primary sortas="b-dbus-uuidgen">dbus-uuidgen</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="libdbus-1">
|
|
<term><filename class="libraryfile">libdbus-1</filename></term>
|
|
<listitem>
|
|
<para>Contains API functions used to communicate with the D-Bus
|
|
message bus</para>
|
|
<indexterm zone="ch-system-dbus libdbus-1">
|
|
<primary sortas="c-libdbus-1">libdbus-1</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
|
|
|
</sect2>
|
|
|
|
</sect1>
|