r5118 - in trunk: BOOK BOOK/general/sysutils BOOK/introduction/welcome bootscripts bootscripts/blfs/init.d

randy at linuxfromscratch.org randy at linuxfromscratch.org
Mon Sep 26 13:57:45 PDT 2005


Author: randy
Date: 2005-09-26 14:57:44 -0600 (Mon, 26 Sep 2005)
New Revision: 5118

Added:
   trunk/BOOK/general/sysutils/dbus.xml
   trunk/bootscripts/blfs/init.d/dbus
Modified:
   trunk/BOOK/general.ent
   trunk/BOOK/general/sysutils/sysutils.xml
   trunk/BOOK/introduction/welcome/changelog.xml
   trunk/BOOK/introduction/welcome/credits.xml
   trunk/bootscripts/ChangeLog
   trunk/bootscripts/Makefile
Log:
Added new package D-BUS-0.50

Added: trunk/BOOK/general/sysutils/dbus.xml
===================================================================
--- trunk/BOOK/general/sysutils/dbus.xml	2005-09-26 16:12:10 UTC (rev 5117)
+++ trunk/BOOK/general/sysutils/dbus.xml	2005-09-26 20:57:44 UTC (rev 5118)
@@ -0,0 +1,309 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+   "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+
+  <!ENTITY dbus-download-http "http://dbus.freedesktop.org/releases/dbus-&dbus-version;.tar.gz">
+  <!ENTITY dbus-download-ftp  " ">
+  <!ENTITY dbus-md5sum        "1addd5b600a8a4550766005d1f59401b">
+  <!ENTITY dbus-size          "1.6 MB">
+  <!ENTITY dbus-buildsize     "34.6 MB">
+  <!ENTITY dbus-time          "0.9 SBU">
+]>
+
+<sect1 id="dbus" xreflabel="D-BUS-&dbus-version;">
+  <?dbhtml filename="dbus.html"?>
+
+  <sect1info>
+    <othername>$LastChangedBy$</othername>
+    <date>$Date$</date>
+  </sect1info>
+
+  <title>D-BUS-&dbus-version;</title>
+
+  <indexterm zone="dbus">
+    <primary sortas="a-D-BUS">D-BUS</primary>
+  </indexterm>
+
+  <sect2 role="package">
+    <title>Introduction to D-BUS</title>
+
+    <para><application>D-BUS</application> is a message bus system, a simple
+    way for applications to talk to one another.
+    <application>D-BUS</application> supplies both a system daemon (for events
+    such as <quote>new hardware device added</quote> or <quote>printer queue
+    changed</quote>) 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>
+
+    <bridgehead renderas="sect3">Package Information</bridgehead>
+    <itemizedlist spacing="compact">
+      <listitem>
+        <para>Download (HTTP): <ulink url="&dbus-download-http;"/></para>
+      </listitem>
+      <listitem>
+        <para>Download (FTP): <ulink url="&dbus-download-ftp;"/></para>
+      </listitem>
+      <listitem>
+        <para>Download MD5 sum: &dbus-md5sum;</para>
+      </listitem>
+      <listitem>
+        <para>Download size: &dbus-size;</para>
+      </listitem>
+      <listitem>
+        <para>Estimated disk space required: &dbus-buildsize;</para>
+      </listitem>
+      <listitem>
+        <para>Estimated build time: &dbus-time;</para>
+      </listitem>
+    </itemizedlist>
+
+    <bridgehead renderas="sect3">D-BUS Dependencies</bridgehead>
+
+    <bridgehead renderas="sect4">Optional</bridgehead>
+    <para><xref linkend="pkgconfig"/>,
+    <xref linkend="expat"/> or <xref linkend="libxml2"/>,
+    <xref linkend="glib2"/>,
+    <xref linkend="gtk2"/>,
+    <xref linkend="qt"/>,
+    X (<xref linkend="xorg"/> or <xref linkend="xfree86"/>),
+    <xref linkend="gcc"/> (for the Java compiler and tools),
+    <ulink url="http://nz.cosc.canterbury.ac.nz/~greg/python/Pyrex/">Pyrex</ulink>,
+    <ulink url="http://go-mono.org">Mono</ulink>,
+    <xref linkend="doxygen"/> and
+    <ulink url="http://cyberelk.net/tim/xmlto/">xmlto</ulink></para>
+
+  </sect2>
+
+  <sect2 role="kernel" id='dbus-kernel'>
+    <title>Kernel Configuration</title>
+
+    <para>Ensure the following option is enabled in the kernel configuration
+    and recompile the kernel if necessary:</para>
+
+<screen><literal>General Setup
+  System V IPC</literal></screen>
+
+    <indexterm zone="dbus dbus-kernel">
+      <primary sortas="d-dbus">dbus</primary>
+    </indexterm>
+
+  </sect2>
+
+  <sect2 role="installation">
+    <title>Installation of D-BUS</title>
+
+    <para>As the <systemitem class="username">root</systemitem> user, create a
+    system user and group to handle the system message bus activity:</para>
+
+<screen role="root"><userinput>groupadd -g 19 messagebus &&
+useradd -c "D-Bus Message Daemon User" -d /dev/null \
+        -u 19 -g messagebus -s /bin/false messagebus</userinput></screen>
+
+    <para>Install <application>D-BUS</application> by running the following
+    commands (you may wish to review the output from
+    <command>./configure --help</command> first and add any desired parameters
+    to the <command>configure</command> command shown below):</para>
+
+<screen><userinput>./configure --prefix=/usr \
+            --sysconfdir=/etc \
+            --localstatedir=/var &&
+make</userinput></screen>
+
+    <para>This package does not come with a test suite.</para>
+
+    <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
+
+<screen role="root"><userinput>make install &&
+install -v -m755 -d /usr/share/doc/dbus-0.50 &&
+install -v -m644 doc/{TODO,*.{dtd,xml,xsl,html,txt,c}} \
+    /usr/share/doc/dbus-0.50</userinput></screen>
+
+  </sect2>
+
+  <sect2 role="commands">
+    <title>Command Explanations</title>
+
+    <para><parameter>--localstatedir=/var</parameter>: This parameter causes
+    the daemon PID file to be created in
+    <filename class="directory">/var/run/dbus</filename> instead of
+    <filename class="directory">/usr/var/run/dbus</filename>.</para>
+
+  </sect2>
+
+  <sect2 role="configuration">
+    <title>Configuring dbus</title>
+
+    <sect3 id="dbus-config">
+      <title>Config Files</title>
+      <para><filename>/etc/dbus-1/session.conf</filename>,
+      <filename>/etc/dbus-1/system.conf</filename> and
+      <filename>/etc/system.d/*</filename></para>
+
+      <indexterm zone="dbus dbus-config">
+        <primary sortas="e-etc-dbus-1-session.conf">/etc/dbus-1/session.conf</primary>
+      </indexterm>
+
+      <indexterm zone="dbus dbus-config">
+        <primary sortas="e-etc-dbus-1/system.conf">/etc/dbus-1/system.conf</primary>
+      </indexterm>
+
+      <indexterm zone="dbus dbus-config">
+        <primary sortas="e-etc-system.d-star">/etc/system.d/*</primary>
+      </indexterm>
+
+    </sect3>
+
+    <sect3><title>Configuration Information</title>
+
+      <para>The configuration files listed above should probably not be
+      modified. If changes are required, you should create
+      <filename>/etc/dbus-1/session-local.conf</filename> and/or
+      <filename>/etc/dbus-1/system-local.conf</filename> and make any 
+      desired changes to these files.</para>
+
+    </sect3>
+
+    <sect3  id="dbus-init">
+      <title>Boot Script</title>
+
+      <para>To automatically start <command>dbus-daemon</command> when the
+      system is rebooted, install the
+      <filename>/etc/rc.d/init.d/dbus</filename> bootscript from the
+      <xref linkend="intro-important-bootscripts"/> package.</para>
+
+      <indexterm zone="dbus dbus-init">
+        <primary sortas="f-dbus">dbus</primary>
+      </indexterm>
+
+<screen role="root"><userinput>make install-dbus</userinput></screen>
+
+    </sect3>
+
+  </sect2>
+
+  <sect2 role="content">
+    <title>Contents</title>
+
+    <segmentedlist>
+      <segtitle>Installed Programs</segtitle>
+      <segtitle>Installed Libraries</segtitle>
+      <segtitle>Installed Directories</segtitle>
+
+      <seglistitem>
+        <seg>dbus-binding-tool, dbus-cleanup-sockets, dbus-daemon, dbus-launch,
+        dbus-monitor, dbus-send and dbus-viewer</seg>
+        <seg>libdbus-1.[so,a] and optionally, dbus-1.jar, libdbus-gcj-1.[so,a],
+        libdbus-glib-1.[so,a], libdbus-qt-1.[so,a] and
+        <application>Python</application> modules</seg>
+        <seg>/etc/dbus-1, /usr/include/dbus-1.0, /usr/lib/dbus-1.0,
+        /usr/lib/python2.4/site-packages/dbus, /usr/share/dbus-1,
+        /usr/share/doc/dbus-&dbus-version; and /var/run/dbus</seg>
+      </seglistitem>
+    </segmentedlist>
+
+    <variablelist>
+      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
+      <?dbfo list-presentation="list"?>
+      <?dbhtml list-presentation="table"?>
+
+      <varlistentry id="dbus-binding-tool">
+        <term><command>dbus-binding-tool</command></term>
+        <listitem>
+          <para>is used to create header files from
+          <application>GLib</application> object files.</para>
+          <indexterm zone="dbus dbus-binding-tool">
+            <primary sortas="b-dbus-binding-tool">dbus-binding-tool</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="dbus-cleanup-sockets">
+        <term><command>dbus-cleanup-sockets</command></term>
+        <listitem>
+          <para>is used to clean up leftover sockets in a directory.</para>
+          <indexterm zone="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 <application>D-BUS</application> message bus
+          daemon.</para>
+          <indexterm zone="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>is used to start <command>dbus-daemon</command> from a shell
+          script. It  would  normally be called from a user's login
+          scripts.</para>
+          <indexterm zone="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>is used to monitor messages going through a
+          <application>D-BUS</application> message bus.</para>
+          <indexterm zone="dbus dbus-monitor">
+            <primary sortas="b-dbus-monitor">dbus-monitor</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="dbus-send">
+        <term><command>dbus-send</command></term>
+        <listitem>
+          <para>is used to send a message to a <application>D-BUS</application>
+          message bus.</para>
+          <indexterm zone="dbus dbus-send">
+            <primary sortas="b-dbus-send">dbus-send</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="dbus-viewer">
+        <term><command>dbus-viewer</command></term>
+        <listitem>
+          <para>is a graphical <application>D-BUS</application> frontend
+          utility.</para>
+          <indexterm zone="dbus dbus-viewer">
+            <primary sortas="b-dbus-viewer">dbus-viewer</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="libdbus-1">
+        <term><filename class='libraryfile'>libdbus-1.[so,a]</filename></term>
+        <listitem>
+          <para>contains the API functions used by the
+          <application>D-BUS</application> message daemon.
+          <application>D-BUS</application> is first a library that provides
+          one-to-one communication between any two applications;
+          <command>dbus-daemon</command> is an application that uses this
+          library to implement a message bus daemon.</para>
+          <indexterm zone="dbus libdbus-1">
+            <primary sortas="c-libdbus-1">libdbus-1.[so,a]</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+    </variablelist>
+
+  </sect2>
+
+</sect1>


Property changes on: trunk/BOOK/general/sysutils/dbus.xml
___________________________________________________________________
Name: svn:keywords
   + LastChangedBy Date

Modified: trunk/BOOK/general/sysutils/sysutils.xml
===================================================================
--- trunk/BOOK/general/sysutils/sysutils.xml	2005-09-26 16:12:10 UTC (rev 5117)
+++ trunk/BOOK/general/sysutils/sysutils.xml	2005-09-26 20:57:44 UTC (rev 5118)
@@ -26,5 +26,6 @@
   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="mc.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="sysstat.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="apache-ant.xml"/>
+  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="dbus.xml"/>
 
 </chapter>

Modified: trunk/BOOK/general.ent
===================================================================
--- trunk/BOOK/general.ent	2005-09-26 16:12:10 UTC (rev 5117)
+++ trunk/BOOK/general.ent	2005-09-26 20:57:44 UTC (rev 5118)
@@ -21,7 +21,7 @@
 <!ENTITY publisher      "Unknown">
 
 
-<!ENTITY blfs-bootscripts-version     "20050910">
+<!ENTITY blfs-bootscripts-version     "20050926">
 <!ENTITY blfs-bootscripts-download    "&downloads-root;/blfs-bootscripts-&blfs-bootscripts-version;.tar.bz2">
 
 <!-- Part II -->

Modified: trunk/BOOK/introduction/welcome/changelog.xml
===================================================================
--- trunk/BOOK/introduction/welcome/changelog.xml	2005-09-26 16:12:10 UTC (rev 5117)
+++ trunk/BOOK/introduction/welcome/changelog.xml	2005-09-26 20:57:44 UTC (rev 5118)
@@ -42,10 +42,19 @@
 -->
 
     <listitem>
+      <para>September 26th, 2005</para>
+      <itemizedlist>
+        <listitem>
+          <para>[randy] - Added new package D-BUS-0.50.</para>
+        </listitem>
+      </itemizedlist>
+    </listitem>
+
+    <listitem>
       <para>September 25th, 2005</para>
       <itemizedlist>
         <listitem>
-          <para>[Randy] - Added a patch to fix a build problem with newer
+          <para>[randy] - Added a patch to fix a build problem with newer
           versions of libgsf and added a sed command so the default is to
           build the Perl plugin module to the Gnumeric instructions.</para>
         </listitem>

Modified: trunk/BOOK/introduction/welcome/credits.xml
===================================================================
--- trunk/BOOK/introduction/welcome/credits.xml	2005-09-26 16:12:10 UTC (rev 5117)
+++ trunk/BOOK/introduction/welcome/credits.xml	2005-09-26 20:57:44 UTC (rev 5118)
@@ -215,7 +215,7 @@
       </listitem>
 
       <listitem>
-        <para>ALSA Tools, Apache Ant, cairo, Cyrus-SASL, DejaGnu,
+        <para>ALSA Tools, Apache Ant, cairo, Cyrus-SASL, D-BUS, DejaGnu,
         desktop-file-utils, DocBook DSSSL Stylesheets, DocBook-utils, Ethereal,
         Evolution Data Server, Exim (many additions), Expect, FOP, FreeTTS,
         FriBidi, GCC (rewrite), gnome-audio, gnome-backgrounds, gnome-menus,

Modified: trunk/bootscripts/ChangeLog
===================================================================
--- trunk/bootscripts/ChangeLog	2005-09-26 16:12:10 UTC (rev 5117)
+++ trunk/bootscripts/ChangeLog	2005-09-26 20:57:44 UTC (rev 5118)
@@ -1,3 +1,7 @@
+2005-09-26 Randy McMurchy <randy at linuxfromscratch.org>
+	* Added D-BUS init script and updated Makefile to include a D-BUS
+	  target
+
 2005-09-10 Igor Zivkovic <igor at linuxfromscratch.org>
 	* Updated PPPoE service script to use the new command names.
 
@@ -31,7 +35,7 @@
 
 2005-03-13 Bruce Dubbs <bdubbs at linuxfromscratch.org>
 	* Updated openldap1 and openldap2 to check for running
-	daemons before starting.
+	  daemons before starting.
 
 2005-03-13 Bruce Dubbs <bdubbs at linuxfromscratch.org>
 	* Added iptables initialization script.

Modified: trunk/bootscripts/Makefile
===================================================================
--- trunk/bootscripts/Makefile	2005-09-26 16:12:10 UTC (rev 5117)
+++ trunk/bootscripts/Makefile	2005-09-26 20:57:44 UTC (rev 5118)
@@ -84,6 +84,16 @@
 	ln -sf  ../init.d/cyrus-sasl ${EXTDIR}/rc.d/rc5.d/S24cyrus-sasl
 	ln -sf  ../init.d/cyrus-sasl ${EXTDIR}/rc.d/rc6.d/K49cyrus-sasl
 
+install-dbus: create-dirs
+	install -m ${MODE} blfs/init.d/dbus ${EXTDIR}/rc.d/init.d/
+	ln -sf  ../init.d/dbus ${EXTDIR}/rc.d/rc0.d/K30cyrus-sasl
+	ln -sf  ../init.d/dbus ${EXTDIR}/rc.d/rc1.d/K30cyrus-sasl
+	ln -sf  ../init.d/dbus ${EXTDIR}/rc.d/rc2.d/S20cyrus-sasl
+	ln -sf  ../init.d/dbus ${EXTDIR}/rc.d/rc3.d/S20cyrus-sasl
+	ln -sf  ../init.d/dbus ${EXTDIR}/rc.d/rc4.d/S20cyrus-sasl
+	ln -sf  ../init.d/dbus ${EXTDIR}/rc.d/rc5.d/S20cyrus-sasl
+	ln -sf  ../init.d/dbus ${EXTDIR}/rc.d/rc6.d/K30cyrus-sasl
+
 install-dhcp: create-dirs
 	install -m ${MODE} blfs/init.d/dhcp       ${EXTDIR}/rc.d/init.d/
 	ln -sf  ../init.d/dhcp ${EXTDIR}/rc.d/rc0.d/K30dhcp

Added: trunk/bootscripts/blfs/init.d/dbus
===================================================================
--- trunk/bootscripts/blfs/init.d/dbus	2005-09-26 16:12:10 UTC (rev 5117)
+++ trunk/bootscripts/blfs/init.d/dbus	2005-09-26 20:57:44 UTC (rev 5118)
@@ -0,0 +1,42 @@
+#!/bin/sh
+# Begin $rc_base/init.d/messagebus
+
+# Based on sysklogd script from LFS-3.1 and earlier.
+# Rewritten by Gerard Beekmans  - gerard at linuxfromscratch.org
+
+#$LastChangedBy$
+#$Date$
+
+. /etc/sysconfig/rc
+. $rc_functions
+
+case "$1" in
+        start)
+                boot_mesg "Starting the D-Bus Messagebus Daemon..."
+                loadproc /usr/bin/dbus-daemon --config-file=/etc/dbus-1/system.conf
+                ;;
+
+        stop)
+                boot_mesg "Stopping the D-Bus Messagebus Daemon..."
+                killproc /usr/bin/dbus-daemon
+                rm /var/run/dbus/dbus.pid
+                rm /var/run/dbus/system_bus_socket
+                ;;
+
+        restart)
+                $0 stop
+                sleep 1
+                $0 start
+                ;;
+
+        status)
+                statusproc /usr/bin/dbus-daemon
+                ;;
+
+        *)
+                echo "Usage: $0 {start|stop|restart|status}"
+                exit 1
+                ;;
+esac
+
+# End $rc_base/init.d/messagebus


Property changes on: trunk/bootscripts/blfs/init.d/dbus
___________________________________________________________________
Name: svn:keywords
   + LastChangedBy Date




More information about the blfs-book mailing list