<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1">
<title>DBusTransport object</title>
<link href="doxygen.css" rel="stylesheet" type="text/css">
</head><body>
<!-- Generated by Doxygen 1.2.15 -->
<center>
<a class="qindex" href="index.html">Main Page</a> <a class="qindex" href="modules.html">Modules</a> <a class="qindex" href="annotated.html">Data Structures</a> <a class="qindex" href="files.html">File List</a> <a class="qindex" href="functions.html">Data Fields</a> <a class="qindex" href="pages.html">Related Pages</a> </center>
<hr><h1>DBusTransport object<br>
<small>
[<a class="el" href="group__DBusInternals.html">D-BUS internal implementation details</a>]</small>
</h1>"Backend" for a <a class="el" href="structDBusConnection.html">DBusConnection</a>.
<a href="#_details">More...</a><table border=0 cellpadding=0 cellspacing=0>
<tr><td colspan=2><br><h2>Typedefs</h2></td></tr>
<tr><td nowrap align=right valign=top>typedef DBusTransport </td><td valign=bottom><a class="el" href="group__DBusTransport.html#a24">DBusTransport</a></td></tr>
<tr><td> </td><td><font size=-1><em>Opaque object representing a way message stream.</em> <a href="#a24">More...</a><em></em></font><br><br></td></tr>
<tr><td colspan=2><br><h2>Functions</h2></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> </td><td valign=bottom><a class="el" href="group__DBusTransport.html#a1">_dbus_transport_init_base</a> (DBusTransport *transport, const <a class="el" href="structDBusTransportVTable.html">DBusTransportVTable</a> *<a class="el" href="structDBusTransport.html#m1">vtable</a>, <a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> server, const <a class="el" href="structDBusString.html">DBusString</a> *<a class="el" href="structDBusTransport.html#m8">address</a>)</td></tr>
<tr><td> </td><td><font size=-1><em>Initializes the base class members of DBusTransport.</em> <a href="#a1">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top>void </td><td valign=bottom><a class="el" href="group__DBusTransport.html#a2">_dbus_transport_finalize_base</a> (DBusTransport *transport)</td></tr>
<tr><td> </td><td><font size=-1><em>Finalizes base class members of DBusTransport.</em> <a href="#a2">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top>DBusTransport * </td><td valign=bottom><a class="el" href="group__DBusTransport.html#a3">_dbus_transport_open</a> (const char *<a class="el" href="structDBusTransport.html#m8">address</a>, <a class="el" href="structDBusError.html">DBusError</a> *error)</td></tr>
<tr><td> </td><td><font size=-1><em>Opens a new transport for the given address.</em> <a href="#a3">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top>DBusTransport * </td><td valign=bottom><a class="el" href="group__DBusTransport.html#a4">_dbus_transport_ref</a> (DBusTransport *transport)</td></tr>
<tr><td> </td><td><font size=-1><em>Increments the reference count for the transport.</em> <a href="#a4">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top>void </td><td valign=bottom><a class="el" href="group__DBusTransport.html#a5">_dbus_transport_unref</a> (DBusTransport *transport)</td></tr>
<tr><td> </td><td><font size=-1><em>Decrements the reference count for the transport.</em> <a href="#a5">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top>void </td><td valign=bottom><a class="el" href="group__DBusTransport.html#a6">_dbus_transport_disconnect</a> (DBusTransport *transport)</td></tr>
<tr><td> </td><td><font size=-1><em>Closes our end of the connection to a remote application.</em> <a href="#a6">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> </td><td valign=bottom><a class="el" href="group__DBusTransport.html#a7">_dbus_transport_get_is_connected</a> (DBusTransport *transport)</td></tr>
<tr><td> </td><td><font size=-1><em>Returns <a class="el" href="group__DBusMacros.html#a2">TRUE</a> if the transport has not been disconnected.</em> <a href="#a7">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> </td><td valign=bottom><a class="el" href="group__DBusTransport.html#a8">_dbus_transport_get_is_authenticated</a> (DBusTransport *transport)</td></tr>
<tr><td> </td><td><font size=-1><em>Returns <a class="el" href="group__DBusMacros.html#a2">TRUE</a> if we have been authenticated.</em> <a href="#a8">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top>const char * </td><td valign=bottom><a class="el" href="group__DBusTransport.html#a9">_dbus_transport_get_address</a> (DBusTransport *transport)</td></tr>
<tr><td> </td><td><font size=-1><em>Gets the address of a transport.</em> <a href="#a9">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> </td><td valign=bottom><a class="el" href="group__DBusTransport.html#a10">_dbus_transport_handle_watch</a> (DBusTransport *transport, <a class="el" href="structDBusWatch.html">DBusWatch</a> *watch, unsigned int condition)</td></tr>
<tr><td> </td><td><font size=-1><em>Handles a watch by reading data, writing data, or disconnecting the transport, as appropriate for the given condition.</em> <a href="#a10">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> </td><td valign=bottom><a class="el" href="group__DBusTransport.html#a11">_dbus_transport_set_connection</a> (DBusTransport *transport, <a class="el" href="structDBusConnection.html">DBusConnection</a> *<a class="el" href="structDBusTransport.html#m2">connection</a>)</td></tr>
<tr><td> </td><td><font size=-1><em>Sets the connection using this transport.</em> <a href="#a11">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top>void </td><td valign=bottom><a class="el" href="group__DBusTransport.html#a12">_dbus_transport_messages_pending</a> (DBusTransport *transport, int queue_length)</td></tr>
<tr><td> </td><td><font size=-1><em>Notifies the transport when the outgoing message queue goes from empty to non-empty or vice versa.</em> <a href="#a12">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top>void </td><td valign=bottom><a class="el" href="group__DBusTransport.html#a13">_dbus_transport_do_iteration</a> (DBusTransport *transport, unsigned int flags, int timeout_milliseconds)</td></tr>
<tr><td> </td><td><font size=-1><em>Performs a single poll()/select() on the transport's file descriptors and then reads/writes data as appropriate, queueing incoming messages and sending outgoing messages.</em> <a href="#a13">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top>DBusDispatchStatus </td><td valign=bottom><a class="el" href="group__DBusTransport.html#a15">_dbus_transport_get_dispatch_status</a> (DBusTransport *transport)</td></tr>
<tr><td> </td><td><font size=-1><em>Reports our current dispatch status (whether there's buffered data to be queued as messages, or not, or we need memory).</em> <a href="#a15">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> </td><td valign=bottom><a class="el" href="group__DBusTransport.html#a16">_dbus_transport_queue_messages</a> (DBusTransport *transport)</td></tr>
<tr><td> </td><td><font size=-1><em>Processes data we've read while handling a watch, potentially converting some of it to messages and queueing those messages on the connection.</em> <a href="#a16">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top>void </td><td valign=bottom><a class="el" href="group__DBusTransport.html#a17">_dbus_transport_set_max_message_size</a> (DBusTransport *transport, long size)</td></tr>
<tr><td> </td><td><font size=-1><em>See <a class="el" href="group__DBusConnection.html#a53">dbus_connection_set_max_message_size</a>().</em> <a href="#a17">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top>long </td><td valign=bottom><a class="el" href="group__DBusTransport.html#a18">_dbus_transport_get_max_message_size</a> (DBusTransport *transport)</td></tr>
<tr><td> </td><td><font size=-1><em>See <a class="el" href="group__DBusConnection.html#a54">dbus_connection_get_max_message_size</a>().</em> <a href="#a18">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top>void </td><td valign=bottom><a class="el" href="group__DBusTransport.html#a19">_dbus_transport_set_max_received_size</a> (DBusTransport *transport, long size)</td></tr>
<tr><td> </td><td><font size=-1><em>See <a class="el" href="group__DBusConnection.html#a55">dbus_connection_set_max_received_size</a>().</em> <a href="#a19">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top>long </td><td valign=bottom><a class="el" href="group__DBusTransport.html#a20">_dbus_transport_get_max_received_size</a> (DBusTransport *transport)</td></tr>
<tr><td> </td><td><font size=-1><em>See <a class="el" href="group__DBusConnection.html#a56">dbus_connection_get_max_received_size</a>().</em> <a href="#a20">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> </td><td valign=bottom><a class="el" href="group__DBusTransport.html#a21">_dbus_transport_get_unix_user</a> (DBusTransport *transport, unsigned long *uid)</td></tr>
<tr><td> </td><td><font size=-1><em>See <a class="el" href="group__DBusConnection.html#a40">dbus_connection_get_unix_user</a>().</em> <a href="#a21">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top>void </td><td valign=bottom><a class="el" href="group__DBusTransport.html#a22">_dbus_transport_set_unix_user_function</a> (DBusTransport *transport, DBusAllowUnixUserFunction function, void *data, <a class="el" href="group__DBusMemory.html#a8">DBusFreeFunction</a> free_data_function, void **old_data, <a class="el" href="group__DBusMemory.html#a8">DBusFreeFunction</a> *old_free_data_function)</td></tr>
<tr><td> </td><td><font size=-1><em>See <a class="el" href="group__DBusConnection.html#a41">dbus_connection_set_unix_user_function</a>().</em> <a href="#a22">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> </td><td valign=bottom><a class="el" href="group__DBusTransport.html#a23">_dbus_transport_set_auth_mechanisms</a> (DBusTransport *transport, const char **mechanisms)</td></tr>
<tr><td> </td><td><font size=-1><em>Sets the SASL authentication mechanisms supported by this transport.</em> <a href="#a23">More...</a><em></em></font><br><br></td></tr>
</table>
<hr><a name="_details"></a><h2>Detailed Description</h2>
"Backend" for a <a class="el" href="structDBusConnection.html">DBusConnection</a>.
<p>
<p>
Types and functions related to DBusTransport. A transport is an abstraction that can send and receive data via various kinds of network connections or other IPC mechanisms. <hr><h2>Typedef Documentation</h2>
<a name="a24" doxytag="dbus-transport.h::DBusTransport"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> DBusTransport
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Opaque object representing a way message stream.
<p>
<a class="el" href="structDBusTransport.html">DBusTransport</a> abstracts various kinds of actual transport mechanism, such as different network protocols, or encryption schemes.
<p>
Definition at line <a class="el" href="dbus-transport_8h-source.html#l00031">31</a> of file <a class="el" href="dbus-transport_8h-source.html">dbus-transport.h</a>. </td>
</tr>
</table>
<hr><h2>Function Documentation</h2>
<a name="a6" doxytag="dbus-transport.c::_dbus_transport_disconnect"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> void _dbus_transport_disconnect </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusTransport.html">DBusTransport</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>transport</em> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Closes our end of the connection to a remote application.
<p>
Further attempts to use this transport will fail. Only the first call to <a class="el" href="group__DBusTransport.html#a6">_dbus_transport_disconnect</a>() will have an effect.<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>transport</em> </td><td>
the transport. </td></tr>
</table>
</dl>
<p>
Definition at line <a class="el" href="dbus-transport_8c-source.html#l00411">411</a> of file <a class="el" href="dbus-transport_8c-source.html">dbus-transport.c</a>.
<p>
References <a class="el" href="structDBusTransportVTable.html#m2">DBusTransportVTable::disconnect</a>, <a class="el" href="dbus-transport-protected_8h-source.html#l00107">disconnected</a>, and <a class="el" href="dbus-transport-protected_8h-source.html#l00086">vtable</a>. </td>
</tr>
</table>
<a name="a13" doxytag="dbus-transport.c::_dbus_transport_do_iteration"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> void _dbus_transport_do_iteration </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusTransport.html">DBusTransport</a> * </td>
<td class="mdname" nowrap> <em>transport</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>unsigned int </td>
<td class="mdname" nowrap> <em>flags</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>int </td>
<td class="mdname" nowrap> <em>timeout_milliseconds</em></td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Performs a single poll()/select() on the transport's file descriptors and then reads/writes data as appropriate, queueing incoming messages and sending outgoing messages.
<p>
This is the backend for <a class="el" href="group__DBusConnectionInternals.html#a30">_dbus_connection_do_iteration</a>(). See <a class="el" href="group__DBusConnectionInternals.html#a30">_dbus_connection_do_iteration</a>() for full details.<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>transport</em> </td><td>
the transport. </td></tr>
<tr><td valign=top><em>flags</em> </td><td>
indicates whether to read or write, and whether to block. </td></tr>
<tr><td valign=top><em>timeout_milliseconds</em> </td><td>
if blocking, timeout or -1 for no timeout. </td></tr>
</table>
</dl>
<p>
Definition at line <a class="el" href="dbus-transport_8c-source.html#l00651">651</a> of file <a class="el" href="dbus-transport_8c-source.html">dbus-transport.c</a>.
<p>
References <a class="el" href="dbus-transport-protected_8h-source.html#l00107">disconnected</a>, <a class="el" href="structDBusTransportVTable.html#m5">DBusTransportVTable::do_iteration</a>, and <a class="el" href="dbus-transport-protected_8h-source.html#l00086">vtable</a>. </td>
</tr>
</table>
<a name="a2" doxytag="dbus-transport-protected.h::_dbus_transport_finalize_base"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> void _dbus_transport_finalize_base </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusTransport.html">DBusTransport</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>transport</em> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Finalizes base class members of <a class="el" href="structDBusTransport.html">DBusTransport</a>.
<p>
Chained up to from subclass finalizers.<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>transport</em> </td><td>
the transport. </td></tr>
</table>
</dl>
<p>
Definition at line <a class="el" href="dbus-transport_8c-source.html#l00182">182</a> of file <a class="el" href="dbus-transport_8c-source.html">dbus-transport.c</a>.
<p>
References <a class="el" href="dbus-transport-protected_8h-source.html#l00101">address</a>, <a class="el" href="dbus-transport-protected_8h-source.html#l00092">auth</a>, <a class="el" href="dbus-transport-protected_8h-source.html#l00107">disconnected</a>, <a class="el" href="dbus-transport-protected_8h-source.html#l00105">free_unix_user_data</a>, <a class="el" href="dbus-transport-protected_8h-source.html#l00098">live_messages_size</a>, <a class="el" href="dbus-transport-protected_8h-source.html#l00090">loader</a>, and <a class="el" href="dbus-transport-protected_8h-source.html#l00104">unix_user_data</a>. </td>
</tr>
</table>
<a name="a9" doxytag="dbus-transport.c::_dbus_transport_get_address"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> const char* _dbus_transport_get_address </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusTransport.html">DBusTransport</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>transport</em> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Gets the address of a transport.
<p>
It will be <a class="el" href="group__DBusMacros.html#a4">NULL</a> for a server-side transport.<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>transport</em> </td><td>
the transport </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
transport's address </dl>
<p>
Definition at line <a class="el" href="dbus-transport_8c-source.html#l00544">544</a> of file <a class="el" href="dbus-transport_8c-source.html">dbus-transport.c</a>.
<p>
References <a class="el" href="dbus-transport-protected_8h-source.html#l00101">address</a>. </td>
</tr>
</table>
<a name="a15" doxytag="dbus-transport.c::_dbus_transport_get_dispatch_status"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> DBusDispatchStatus _dbus_transport_get_dispatch_status </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusTransport.html">DBusTransport</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>transport</em> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Reports our current dispatch status (whether there's buffered data to be queued as messages, or not, or we need memory).
<p>
<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>transport</em> </td><td>
the transport </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
current status </dl>
<p>
Definition at line <a class="el" href="dbus-transport_8c-source.html#l00770">770</a> of file <a class="el" href="dbus-transport_8c-source.html">dbus-transport.c</a>.
<p>
References <a class="el" href="dbus-transport-protected_8h-source.html#l00092">auth</a>, <a class="el" href="dbus-transport-protected_8h-source.html#l00098">live_messages_size</a>, <a class="el" href="dbus-transport-protected_8h-source.html#l00090">loader</a>, <a class="el" href="dbus-transport-protected_8h-source.html#l00096">max_live_messages_size</a>, and <a class="el" href="dbus-transport-protected_8h-source.html#l00113">unused_bytes_recovered</a>. </td>
</tr>
</table>
<a name="a8" doxytag="dbus-transport.c::_dbus_transport_get_is_authenticated"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> _dbus_transport_get_is_authenticated </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusTransport.html">DBusTransport</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>transport</em> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Returns <a class="el" href="group__DBusMacros.html#a2">TRUE</a> if we have been authenticated.
<p>
Will return <a class="el" href="group__DBusMacros.html#a2">TRUE</a> even if the transport is disconnected.
<p>
<p>
<dl compact><dt><b>
<a class="el" href="todo.html#_todo000072">Todo: </a></b><dd>
needs to drop connection->mutex when calling the unix_user_function</dl><dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>transport</em> </td><td>
the transport </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
whether we're authenticated </dl>
<p>
Definition at line <a class="el" href="dbus-transport_8c-source.html#l00447">447</a> of file <a class="el" href="dbus-transport_8c-source.html">dbus-transport.c</a>.
<p>
References <a class="el" href="dbus-transport-protected_8h-source.html#l00092">auth</a>, <a class="el" href="dbus-transport-protected_8h-source.html#l00108">authenticated</a>, <a class="el" href="dbus-transport-protected_8h-source.html#l00088">connection</a>, <a class="el" href="dbus-transport-protected_8h-source.html#l00107">disconnected</a>, <a class="el" href="dbus-transport-protected_8h-source.html#l00112">is_server</a>, <a class="el" href="dbus-transport-protected_8h-source.html#l00111">receive_credentials_pending</a>, <a class="el" href="dbus-transport-protected_8h-source.html#l00110">send_credentials_pending</a>, <a class="el" href="dbus-sysdeps_8h-source.html#l00108">DBusCredentials::uid</a>, <a class="el" href="dbus-transport-protected_8h-source.html#l00104">unix_user_data</a>, and <a class="el" href="dbus-transport-protected_8h-source.html#l00103">unix_user_function</a>. </td>
</tr>
</table>
<a name="a7" doxytag="dbus-transport.c::_dbus_transport_get_is_connected"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> _dbus_transport_get_is_connected </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusTransport.html">DBusTransport</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>transport</em> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Returns <a class="el" href="group__DBusMacros.html#a2">TRUE</a> if the transport has not been disconnected.
<p>
Disconnection can result from <a class="el" href="group__DBusTransport.html#a6">_dbus_transport_disconnect</a>() or because the server drops its end of the connection.<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>transport</em> </td><td>
the transport. </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
whether we're connected </dl>
<p>
Definition at line <a class="el" href="dbus-transport_8c-source.html#l00432">432</a> of file <a class="el" href="dbus-transport_8c-source.html">dbus-transport.c</a>.
<p>
References <a class="el" href="dbus-transport-protected_8h-source.html#l00107">disconnected</a>. </td>
</tr>
</table>
<a name="a18" doxytag="dbus-transport.c::_dbus_transport_get_max_message_size"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> long _dbus_transport_get_max_message_size </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusTransport.html">DBusTransport</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>transport</em> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
See <a class="el" href="group__DBusConnection.html#a54">dbus_connection_get_max_message_size</a>().
<p>
<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>transport</em> </td><td>
the transport </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
max message size </dl>
<p>
Definition at line <a class="el" href="dbus-transport_8c-source.html#l00873">873</a> of file <a class="el" href="dbus-transport_8c-source.html">dbus-transport.c</a>.
<p>
References <a class="el" href="dbus-transport-protected_8h-source.html#l00090">loader</a>. </td>
</tr>
</table>
<a name="a20" doxytag="dbus-transport.c::_dbus_transport_get_max_received_size"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> long _dbus_transport_get_max_received_size </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusTransport.html">DBusTransport</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>transport</em> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
See <a class="el" href="group__DBusConnection.html#a56">dbus_connection_get_max_received_size</a>().
<p>
<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>transport</em> </td><td>
the transport </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
max bytes for all live messages </dl>
<p>
Definition at line <a class="el" href="dbus-transport_8c-source.html#l00903">903</a> of file <a class="el" href="dbus-transport_8c-source.html">dbus-transport.c</a>.
<p>
References <a class="el" href="dbus-transport-protected_8h-source.html#l00096">max_live_messages_size</a>. </td>
</tr>
</table>
<a name="a21" doxytag="dbus-transport.c::_dbus_transport_get_unix_user"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> _dbus_transport_get_unix_user </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusTransport.html">DBusTransport</a> * </td>
<td class="mdname" nowrap> <em>transport</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>unsigned long * </td>
<td class="mdname" nowrap> <em>uid</em></td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
See <a class="el" href="group__DBusConnection.html#a40">dbus_connection_get_unix_user</a>().
<p>
<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>transport</em> </td><td>
the transport </td></tr>
<tr><td valign=top><em>uid</em> </td><td>
return location for the user ID </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
<a class="el" href="group__DBusMacros.html#a2">TRUE</a> if uid is filled in with a valid user ID </dl>
<p>
Definition at line <a class="el" href="dbus-transport_8c-source.html#l00916">916</a> of file <a class="el" href="dbus-transport_8c-source.html">dbus-transport.c</a>.
<p>
References <a class="el" href="dbus-transport-protected_8h-source.html#l00092">auth</a>, <a class="el" href="dbus-transport-protected_8h-source.html#l00108">authenticated</a>, and <a class="el" href="dbus-sysdeps_8h-source.html#l00108">DBusCredentials::uid</a>. </td>
</tr>
</table>
<a name="a10" doxytag="dbus-transport.c::_dbus_transport_handle_watch"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> _dbus_transport_handle_watch </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusTransport.html">DBusTransport</a> * </td>
<td class="mdname" nowrap> <em>transport</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap><a class="el" href="structDBusWatch.html">DBusWatch</a> * </td>
<td class="mdname" nowrap> <em>watch</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>unsigned int </td>
<td class="mdname" nowrap> <em>condition</em></td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Handles a watch by reading data, writing data, or disconnecting the transport, as appropriate for the given condition.
<p>
<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>transport</em> </td><td>
the transport. </td></tr>
<tr><td valign=top><em>watch</em> </td><td>
the watch. </td></tr>
<tr><td valign=top><em>condition</em> </td><td>
the current state of the watched file descriptor. </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
<a class="el" href="group__DBusMacros.html#a3">FALSE</a> if not enough memory to fully handle the watch </dl>
<p>
Definition at line <a class="el" href="dbus-transport_8c-source.html#l00559">559</a> of file <a class="el" href="dbus-transport_8c-source.html">dbus-transport.c</a>.
<p>
References <a class="el" href="dbus-transport-protected_8h-source.html#l00107">disconnected</a>, <a class="el" href="structDBusTransportVTable.html#m1">DBusTransportVTable::handle_watch</a>, and <a class="el" href="dbus-transport-protected_8h-source.html#l00086">vtable</a>. </td>
</tr>
</table>
<a name="a1" doxytag="dbus-transport-protected.h::_dbus_transport_init_base"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> _dbus_transport_init_base </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusTransport.html">DBusTransport</a> * </td>
<td class="mdname" nowrap> <em>transport</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>const <a class="el" href="structDBusTransportVTable.html">DBusTransportVTable</a> * </td>
<td class="mdname" nowrap> <em>vtable</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap><a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> </td>
<td class="mdname" nowrap> <em>server</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>const <a class="el" href="structDBusString.html">DBusString</a> * </td>
<td class="mdname" nowrap> <em>address</em></td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Initializes the base class members of <a class="el" href="structDBusTransport.html">DBusTransport</a>.
<p>
Chained up to by subclasses in their constructor.<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>transport</em> </td><td>
the transport being created. </td></tr>
<tr><td valign=top><em>vtable</em> </td><td>
the subclass vtable. </td></tr>
<tr><td valign=top><em>server</em> </td><td>
<a class="el" href="group__DBusMacros.html#a2">TRUE</a> if this transport is on the server side of a connection </td></tr>
<tr><td valign=top><em>address</em> </td><td>
the address of the transport </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
<a class="el" href="group__DBusMacros.html#a2">TRUE</a> on success. </dl>
<p>
Definition at line <a class="el" href="dbus-transport_8c-source.html#l00088">88</a> of file <a class="el" href="dbus-transport_8c-source.html">dbus-transport.c</a>.
<p>
References <a class="el" href="dbus-transport-protected_8h-source.html#l00101">address</a>, <a class="el" href="dbus-transport-protected_8h-source.html#l00092">auth</a>, <a class="el" href="dbus-transport-protected_8h-source.html#l00108">authenticated</a>, <a class="el" href="dbus-transport-protected_8h-source.html#l00094">credentials</a>, <a class="el" href="dbus-transport-protected_8h-source.html#l00107">disconnected</a>, <a class="el" href="dbus-transport-protected_8h-source.html#l00105">free_unix_user_data</a>, <a class="el" href="dbus-sysdeps_8h-source.html#l00109">DBusCredentials::gid</a>, <a class="el" href="dbus-transport-protected_8h-source.html#l00112">is_server</a>, <a class="el" href="dbus-transport-protected_8h-source.html#l00098">live_messages_size</a>, <a class="el" href="dbus-transport-protected_8h-source.html#l00090">loader</a>, <a class="el" href="dbus-transport-protected_8h-source.html#l00096">max_live_messages_size</a>, <a class="el" href="dbus-transport-protected_8h-source.html#l00109">messages_need_sending</a>, <a class="el" href="dbus-sysdeps_8h-source.html#l00107">DBusCredentials::pid</a>, <a class="el" href="dbus-transport-protected_8h-source.html#l00111">receive_credentials_pending</a>, <a class="el" href="dbus-transport-protected_8h-source.html#l00084">refcount</a>, <a class="el" href="dbus-transport-protected_8h-source.html#l00110">send_credentials_pending</a>, <a class="el" href="dbus-sysdeps_8h-source.html#l00108">DBusCredentials::uid</a>, <a class="el" href="dbus-transport-protected_8h-source.html#l00104">unix_user_data</a>, <a class="el" href="dbus-transport-protected_8h-source.html#l00103">unix_user_function</a>, and <a class="el" href="dbus-transport-protected_8h-source.html#l00086">vtable</a>. </td>
</tr>
</table>
<a name="a12" doxytag="dbus-transport.c::_dbus_transport_messages_pending"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> void _dbus_transport_messages_pending </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusTransport.html">DBusTransport</a> * </td>
<td class="mdname" nowrap> <em>transport</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>int </td>
<td class="mdname" nowrap> <em>queue_length</em></td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Notifies the transport when the outgoing message queue goes from empty to non-empty or vice versa.
<p>
Typically causes the transport to add or remove its DBUS_WATCH_WRITABLE watch.<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>transport</em> </td><td>
the transport. </td></tr>
<tr><td valign=top><em>queue_length</em> </td><td>
the length of the outgoing message queue. </td></tr>
</table>
</dl>
<p>
Definition at line <a class="el" href="dbus-transport_8c-source.html#l00623">623</a> of file <a class="el" href="dbus-transport_8c-source.html">dbus-transport.c</a>.
<p>
References <a class="el" href="dbus-transport-protected_8h-source.html#l00107">disconnected</a>, <a class="el" href="dbus-transport-protected_8h-source.html#l00109">messages_need_sending</a>, <a class="el" href="structDBusTransportVTable.html#m4">DBusTransportVTable::messages_pending</a>, and <a class="el" href="dbus-transport-protected_8h-source.html#l00086">vtable</a>. </td>
</tr>
</table>
<a name="a3" doxytag="dbus-transport.c::_dbus_transport_open"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="structDBusTransport.html">DBusTransport</a>* _dbus_transport_open </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">const char * </td>
<td class="mdname" nowrap> <em>address</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap><a class="el" href="structDBusError.html">DBusError</a> * </td>
<td class="mdname" nowrap> <em>error</em></td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Opens a new transport for the given address.
<p>
(This opens a client-side-of-the-connection transport.)
<p>
<p>
<dl compact><dt><b>
<a class="el" href="todo.html#_todo000071">Todo: </a></b><dd>
error messages on bad address could really be better. DBusResultCode is a bit limiting here.</dl><dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>address</em> </td><td>
the address. </td></tr>
<tr><td valign=top><em>error</em> </td><td>
location to store reason for failure. </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
new transport of <a class="el" href="group__DBusMacros.html#a4">NULL</a> on failure. </dl>
<p>
Definition at line <a class="el" href="dbus-transport_8c-source.html#l00210">210</a> of file <a class="el" href="dbus-transport_8c-source.html">dbus-transport.c</a>. </td>
</tr>
</table>
<a name="a16" doxytag="dbus-transport.c::_dbus_transport_queue_messages"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> _dbus_transport_queue_messages </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusTransport.html">DBusTransport</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>transport</em> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Processes data we've read while handling a watch, potentially converting some of it to messages and queueing those messages on the connection.
<p>
<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>transport</em> </td><td>
the transport </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
<a class="el" href="group__DBusMacros.html#a2">TRUE</a> if we had enough memory to queue all messages </dl>
<p>
Definition at line <a class="el" href="dbus-transport_8c-source.html#l00808">808</a> of file <a class="el" href="dbus-transport_8c-source.html">dbus-transport.c</a>.
<p>
References <a class="el" href="dbus-transport-protected_8h-source.html#l00088">connection</a>, <a class="el" href="dbus-list_8h-source.html#l00039">DBusList::data</a>, <a class="el" href="dbus-transport-protected_8h-source.html#l00098">live_messages_size</a>, and <a class="el" href="dbus-transport-protected_8h-source.html#l00090">loader</a>. </td>
</tr>
</table>
<a name="a4" doxytag="dbus-transport.c::_dbus_transport_ref"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="structDBusTransport.html">DBusTransport</a>* _dbus_transport_ref </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusTransport.html">DBusTransport</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>transport</em> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Increments the reference count for the transport.
<p>
<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>transport</em> </td><td>
the transport. </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
the transport. </dl>
<p>
Definition at line <a class="el" href="dbus-transport_8c-source.html#l00371">371</a> of file <a class="el" href="dbus-transport_8c-source.html">dbus-transport.c</a>.
<p>
References <a class="el" href="dbus-transport-protected_8h-source.html#l00084">refcount</a>. </td>
</tr>
</table>
<a name="a23" doxytag="dbus-transport.c::_dbus_transport_set_auth_mechanisms"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> _dbus_transport_set_auth_mechanisms </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusTransport.html">DBusTransport</a> * </td>
<td class="mdname" nowrap> <em>transport</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>const char ** </td>
<td class="mdname" nowrap> <em>mechanisms</em></td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Sets the SASL authentication mechanisms supported by this transport.
<p>
<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>transport</em> </td><td>
the transport </td></tr>
<tr><td valign=top><em>mechanisms</em> </td><td>
the <a class="el" href="group__DBusMacros.html#a4">NULL</a>-terminated array of mechanisms</td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
<a class="el" href="group__DBusMacros.html#a3">FALSE</a> if no memory </dl>
<p>
Definition at line <a class="el" href="dbus-transport_8c-source.html#l00975">975</a> of file <a class="el" href="dbus-transport_8c-source.html">dbus-transport.c</a>.
<p>
References <a class="el" href="dbus-transport-protected_8h-source.html#l00092">auth</a>. </td>
</tr>
</table>
<a name="a11" doxytag="dbus-transport.c::_dbus_transport_set_connection"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="group__DBusTypes.html#a2">dbus_bool_t</a> _dbus_transport_set_connection </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusTransport.html">DBusTransport</a> * </td>
<td class="mdname" nowrap> <em>transport</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap><a class="el" href="structDBusConnection.html">DBusConnection</a> * </td>
<td class="mdname" nowrap> <em>connection</em></td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Sets the connection using this transport.
<p>
Allows the transport to add watches to the connection, queue incoming messages, and pull outgoing messages.<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>transport</em> </td><td>
the transport. </td></tr>
<tr><td valign=top><em>connection</em> </td><td>
the connection. </td></tr>
</table>
</dl><dl compact><dt><b>
Returns: </b><dd>
<a class="el" href="group__DBusMacros.html#a3">FALSE</a> if not enough memory </dl>
<p>
Definition at line <a class="el" href="dbus-transport_8c-source.html#l00597">597</a> of file <a class="el" href="dbus-transport_8c-source.html">dbus-transport.c</a>.
<p>
References <a class="el" href="dbus-transport-protected_8h-source.html#l00088">connection</a>, <a class="el" href="structDBusTransportVTable.html#m3">DBusTransportVTable::connection_set</a>, and <a class="el" href="dbus-transport-protected_8h-source.html#l00086">vtable</a>. </td>
</tr>
</table>
<a name="a17" doxytag="dbus-transport.c::_dbus_transport_set_max_message_size"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> void _dbus_transport_set_max_message_size </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusTransport.html">DBusTransport</a> * </td>
<td class="mdname" nowrap> <em>transport</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>long </td>
<td class="mdname" nowrap> <em>size</em></td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
See <a class="el" href="group__DBusConnection.html#a53">dbus_connection_set_max_message_size</a>().
<p>
<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>transport</em> </td><td>
the transport </td></tr>
<tr><td valign=top><em>size</em> </td><td>
the max size of a single message </td></tr>
</table>
</dl>
<p>
Definition at line <a class="el" href="dbus-transport_8c-source.html#l00860">860</a> of file <a class="el" href="dbus-transport_8c-source.html">dbus-transport.c</a>.
<p>
References <a class="el" href="dbus-transport-protected_8h-source.html#l00090">loader</a>. </td>
</tr>
</table>
<a name="a19" doxytag="dbus-transport.c::_dbus_transport_set_max_received_size"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> void _dbus_transport_set_max_received_size </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusTransport.html">DBusTransport</a> * </td>
<td class="mdname" nowrap> <em>transport</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>long </td>
<td class="mdname" nowrap> <em>size</em></td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
See <a class="el" href="group__DBusConnection.html#a55">dbus_connection_set_max_received_size</a>().
<p>
<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>transport</em> </td><td>
the transport </td></tr>
<tr><td valign=top><em>size</em> </td><td>
the max size of all incoming messages </td></tr>
</table>
</dl>
<p>
Definition at line <a class="el" href="dbus-transport_8c-source.html#l00885">885</a> of file <a class="el" href="dbus-transport_8c-source.html">dbus-transport.c</a>.
<p>
References <a class="el" href="dbus-transport-protected_8h-source.html#l00098">live_messages_size</a>, and <a class="el" href="dbus-transport-protected_8h-source.html#l00096">max_live_messages_size</a>. </td>
</tr>
</table>
<a name="a22" doxytag="dbus-transport.c::_dbus_transport_set_unix_user_function"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> void _dbus_transport_set_unix_user_function </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusTransport.html">DBusTransport</a> * </td>
<td class="mdname" nowrap> <em>transport</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>DBusAllowUnixUserFunction </td>
<td class="mdname" nowrap> <em>function</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>void * </td>
<td class="mdname" nowrap> <em>data</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap><a class="el" href="group__DBusMemory.html#a8">DBusFreeFunction</a> </td>
<td class="mdname" nowrap> <em>free_data_function</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>void ** </td>
<td class="mdname" nowrap> <em>old_data</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap><a class="el" href="group__DBusMemory.html#a8">DBusFreeFunction</a> * </td>
<td class="mdname" nowrap> <em>old_free_data_function</em></td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
See <a class="el" href="group__DBusConnection.html#a41">dbus_connection_set_unix_user_function</a>().
<p>
<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>transport</em> </td><td>
the transport </td></tr>
<tr><td valign=top><em>function</em> </td><td>
the predicate </td></tr>
<tr><td valign=top><em>data</em> </td><td>
data to pass to the predicate </td></tr>
<tr><td valign=top><em>free_data_function</em> </td><td>
function to free the data </td></tr>
<tr><td valign=top><em>old_data</em> </td><td>
the old user data to be freed </td></tr>
<tr><td valign=top><em>old_free_data_function</em> </td><td>
old free data function to free it with </td></tr>
</table>
</dl>
<p>
Definition at line <a class="el" href="dbus-transport_8c-source.html#l00951">951</a> of file <a class="el" href="dbus-transport_8c-source.html">dbus-transport.c</a>.
<p>
References <a class="el" href="dbus-transport-protected_8h-source.html#l00105">free_unix_user_data</a>, <a class="el" href="dbus-transport-protected_8h-source.html#l00104">unix_user_data</a>, and <a class="el" href="dbus-transport-protected_8h-source.html#l00103">unix_user_function</a>. </td>
</tr>
</table>
<a name="a5" doxytag="dbus-transport.c::_dbus_transport_unref"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> void _dbus_transport_unref </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="structDBusTransport.html">DBusTransport</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>transport</em> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Decrements the reference count for the transport.
<p>
Disconnects and finalizes the transport if the reference count reaches zero.<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>transport</em> </td><td>
the transport. </td></tr>
</table>
</dl>
<p>
Definition at line <a class="el" href="dbus-transport_8c-source.html#l00388">388</a> of file <a class="el" href="dbus-transport_8c-source.html">dbus-transport.c</a>.
<p>
References <a class="el" href="structDBusTransportVTable.html#m0">DBusTransportVTable::finalize</a>, <a class="el" href="dbus-transport-protected_8h-source.html#l00084">refcount</a>, and <a class="el" href="dbus-transport-protected_8h-source.html#l00086">vtable</a>. </td>
</tr>
</table>
<hr><address align="right"><small>Generated on Wed Jun 9 05:01:28 2004 for D-BUS by
<a href="http://www.doxygen.org/index.html">
<img src="doxygen.png" alt="doxygen" align="middle" border=0
width=110 height=53></a>1.2.15 </small></address>
</body>
</html>
distrib
>
Mandriva
>
2007.0
>
x86_64
>
media
>
main-release
>
by-pkgid
>
926d2d1e3111287cee1b0a4fad4fb4f6
>
files
>
211
