<!DOCTYPE REFENTRY PUBLIC "-//Sun Microsystems//DTD DocBook V3.0-Based SolBook Subset V2.0//EN" [
<!--ArborText, Inc., 1988-1999, v.4002-->
<!--ARC : LSARC 2006/368 D-BUS Message Bus System -->
<!ENTITY cmd "libdbus-1">
<!ENTITY % commonents SYSTEM "smancommon.ent">
%commonents;
<!ENTITY % booktitles SYSTEM "booktitles.ent">
%booktitles;
<!ENTITY suncopy "Copyright (c) 2007 Sun Microsystems, Inc. All Rights Reserved.">
]>
<refentry id="libdbus-1-3">
<!-- %Z%%M% %I% %E% SMI; -->
<refmeta><refentrytitle>&cmd;</refentrytitle><manvolnum>3</manvolnum>
<refmiscinfo class="date">20 Nov 2007</refmiscinfo>
<refmiscinfo class="sectdesc">&man3;</refmiscinfo>
<refmiscinfo class="software">&release;</refmiscinfo>
<refmiscinfo class="arch">generic</refmiscinfo>
<refmiscinfo class="copyright">&suncopy;</refmiscinfo>
</refmeta>
<indexterm><primary>&cmd;</primary></indexterm>
<indexterm><primary>libdbus-glib-1</primary></indexterm>
<indexterm><primary>D\-Bus Library and GLib bindings</primary></indexterm>
<refnamediv id="libdbus-1-3-name"><refname>&cmd;</refname>
<refname>libdbus-glib-1</refname>
<refpurpose>D\-Bus Library and GLib bindings</refpurpose></refnamediv>

<refsect1 id="libdbus-1-3-desc"><title>&desc-tt;</title>
<para>
D\-Bus is a message bus system, a simple way for applications to talk to one
another.  The <command>&cmd;</command> library provides low-level API.
The <command>dbus-glib-1</command> library provides C-language bindings for using
D\-Bus with a higher-level approach.  The higher level approach is possible
because GLib defines a main loop, an object/type system, and an out-of-memory
handling policy (it exits the program).
</para>

<para>
D\-Bus supplies both a system daemon (for events such as &quot;new hardware
device added&quot; or &quot;printer queue changed&quot;) 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 apps to communicate directly (without
going through the message bus daemon).
</para>

<para>
The D\-Bus API isn't finished yet, and the design is by no means set in stone.
One of our main goals is for lots of projects to use it, so if you would not
use it, by all means mail us and say why - design, licensing, indentation
style, we would rather know than not know.
</para>
</refsect1>

<refsect1 id="libdbus-1-3-file"><title>&file-tt;</title>
<para>
The following files are used by this application:
</para>

<variablelist termlength="wholeline">
<varlistentry>
<term><filename>/usr/lib/&cmd;.so</filename></term>
<listitem><para>
D\-Bus library
</para>
</listitem></varlistentry>
<varlistentry>
<term><filename>/usr/lib/libdbus-glib-1;.so</filename></term>
<listitem><para>
D\-Bus GLib bindings library
</para></listitem></varlistentry>
<varlistentry>
<term><filename>/usr/share/gtk-doc/html/dbus-glib</filename></term>
<listitem><para>
Location of developer documentation
</para></listitem></varlistentry>
</variablelist>
</refsect1>

<refsect1 id="libdbus-glib-1-3-attr"><title>&attr-tt;</title>
<para>
See
<olink targetdocent="REFMAN5" localinfo="attributes-5">
<citerefentry><refentrytitle>attributes</refentrytitle>
<manvolnum>5</manvolnum></citerefentry></olink>
for descriptions of the following attributes:
</para>

<informaltable frame="all">
<tgroup cols="2" colsep="1" rowsep="1">
<colspec colname="COLSPEC0" colwidth="1*">
<colspec colname="COLSPEC1" colwidth="1*">
<thead>
<row>
<entry align="center" valign="middle">ATTRIBUTE TYPE</entry>
<entry align="center"
valign="middle">ATTRIBUTE VALUE</entry></row>
</thead>
<tbody>
<row>
<entry><para>Availability</para></entry>
<entry><para>system/library/libdbus-glib</para></entry>
</row>
<row>
<entry><para>Availability</para></entry>
<entry><para>SUNWdbus-libs</para></entry>
</row>
<row>
<entry colname="COLSPEC0"><para>Interface stability</para></entry>
<entry colname="COLSPEC1"><para>Volatile</para></entry>
</row>
</tbody></tgroup></informaltable>
</refsect1>

<refsect1 id="libdbus-1-3-also"><title>&also-tt;</title>
<!--Reference to another man page-->
<!--Reference to a Help manual-->
<!--Reference to a book.-->
<para>
<citerefentry><refentrytitle>dbus-binding-tool</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
<citerefentry><refentrytitle>dbus-cleanup-sockets</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
<citerefentry><refentrytitle>dbus-daemon</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
<citerefentry><refentrytitle>dbus-launch</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
<citerefentry><refentrytitle>dbus-monitor</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
<citerefentry><refentrytitle>dbus-send</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
<citerefentry><refentrytitle>dbus-uuidgen</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
<citerefentry><refentrytitle>libglib-2.0</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
<citerefentry><refentrytitle>attributes</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
<citerefentry><refentrytitle>gnome-interfaces</refentrytitle><manvolnum>5</manvolnum></citerefentry>
</para>
</refsect1>

<refsect1 id="libdbus-1-3-note"><title>&note-tt;</title>
<para>
Written by Brian Cameron, Sun Microsystems Inc., 2007.
</para>
</refsect1>
</refentry>
