<!DOCTYPE REFENTRY PUBLIC "-//Sun Microsystems//DTD DocBook V3.0-Based SolBook Subset V2.0//EN" [

<!--ArborText, Inc., 1988-1999, v.4002-->

<!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">

<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>

<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>