|
Server : Apache/2.2.17 (Unix) mod_ssl/2.2.17 OpenSSL/0.9.8e-fips-rhel5 DAV/2 PHP/5.2.17 System : Linux localhost 2.6.18-419.el5 #1 SMP Fri Feb 24 22:47:42 UTC 2017 x86_64 User : nobody ( 99) PHP Version : 5.2.17 Disable Function : NONE Directory : /proc/21573/root/usr/share/devhelp/books/dbus/api/ |
Upload File : |
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1">
<title>D-Bus: Resource limits related code</title>
<link href="doxygen.css" rel="stylesheet" type="text/css">
<link href="tabs.css" rel="stylesheet" type="text/css">
</head><body>
<!-- Generated by Doxygen 1.4.7 -->
<div class="tabs">
<ul>
<li><a href="index.html"><span>Main Page</span></a></li>
<li><a href="modules.html"><span>Modules</span></a></li>
<li><a href="annotated.html"><span>Data Structures</span></a></li>
<li><a href="files.html"><span>Files</span></a></li>
<li><a href="pages.html"><span>Related Pages</span></a></li>
</ul></div>
<h1>Resource limits related code<br>
<small>
[<a class="el" href="group__DBusInternals.html">D-Bus secret internal implementation details</a>]</small>
</h1><a class="el" href="structDBusCounter.html">DBusCounter</a> and other stuff related to resource limits.
<a href="#_details">More...</a><table border="0" cellpadding="0" cellspacing="0">
<tr><td></td></tr>
<tr><td colspan="2"><br><h2>Functions</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="structDBusCounter.html">DBusCounter</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__DBusResources.html#g9911dd8fa020299a2b517251ea0be399">_dbus_counter_new</a> (void)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Creates a new <a class="el" href="structDBusCounter.html">DBusCounter</a>. <a href="#g9911dd8fa020299a2b517251ea0be399"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="structDBusCounter.html">DBusCounter</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__DBusResources.html#ge93240c77bfb66642453518c9bb90bc4">_dbus_counter_ref</a> (<a class="el" href="structDBusCounter.html">DBusCounter</a> *counter)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Increments refcount of the counter. <a href="#ge93240c77bfb66642453518c9bb90bc4"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__DBusResources.html#g48d9b53d1a395ab3c4f1846ca569ef3f">_dbus_counter_unref</a> (<a class="el" href="structDBusCounter.html">DBusCounter</a> *counter)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Decrements refcount of the counter and possibly finalizes the counter. <a href="#g48d9b53d1a395ab3c4f1846ca569ef3f"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__DBusResources.html#gcdde7d91bea4143a35329b246b889670">_dbus_counter_adjust</a> (<a class="el" href="structDBusCounter.html">DBusCounter</a> *counter, long delta)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Adjusts the value of the counter by the given delta which may be positive or negative. <a href="#gcdde7d91bea4143a35329b246b889670"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">long </td><td class="memItemRight" valign="bottom"><a class="el" href="group__DBusResources.html#g817729ebefbd486f816b24a1fefc889d">_dbus_counter_get_value</a> (<a class="el" href="structDBusCounter.html">DBusCounter</a> *counter)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Gets the current value of the counter. <a href="#g817729ebefbd486f816b24a1fefc889d"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__DBusResources.html#gdf751ffe6ca8c3f81a89df70fc9c93d0">_dbus_counter_set_notify</a> (<a class="el" href="structDBusCounter.html">DBusCounter</a> *counter, long guard_value, DBusCounterNotifyFunction function, void *user_data)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets the notify function for this counter; the notify function is called whenever the counter's value crosses the guard value in either direction (moving up, or moving down). <a href="#gdf751ffe6ca8c3f81a89df70fc9c93d0"></a><br></td></tr>
</table>
<hr><a name="_details"></a><h2>Detailed Description</h2>
<a class="el" href="structDBusCounter.html">DBusCounter</a> and other stuff related to resource limits.
<p>
Types and functions related to tracking resource limits, such as the maximum amount of memory a connection can use for messages, etc. <hr><h2>Function Documentation</h2>
<a class="anchor" name="gcdde7d91bea4143a35329b246b889670"></a><!-- doxytag: member="dbus-resources.c::_dbus_counter_adjust" ref="gcdde7d91bea4143a35329b246b889670" args="(DBusCounter *counter, long delta)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void _dbus_counter_adjust </td>
<td>(</td>
<td class="paramtype"><a class="el" href="structDBusCounter.html">DBusCounter</a> * </td>
<td class="paramname"> <em>counter</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">long </td>
<td class="paramname"> <em>delta</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Adjusts the value of the counter by the given delta which may be positive or negative.
<p>
Calls the notify function from <a class="el" href="group__DBusResources.html#gdf751ffe6ca8c3f81a89df70fc9c93d0">_dbus_counter_set_notify()</a> if that function has been specified.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>counter</em> </td><td>the counter </td></tr>
<tr><td valign="top"></td><td valign="top"><em>delta</em> </td><td>value to add to the counter's current value </td></tr>
</table>
</dl>
<p>
Definition at line <a class="el" href="dbus-resources_8c-source.html#l00141">141</a> of file <a class="el" href="dbus-resources_8c-source.html">dbus-resources.c</a>.
<p>
References <a class="el" href="dbus-resources_8c-source.html#l00060">DBusCounter::notify_data</a>, <a class="el" href="dbus-resources_8c-source.html#l00059">DBusCounter::notify_function</a>, <a class="el" href="dbus-resources_8c-source.html#l00058">DBusCounter::notify_guard_value</a>, <a class="el" href="group__DBusMacros.html#g070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>, and <a class="el" href="dbus-resources_8c-source.html#l00056">DBusCounter::value</a>.
<p>
Referenced by <a class="el" href="dbus-message_8c-source.html#l00193">_dbus_message_add_size_counter_link()</a>, and <a class="el" href="dbus-message_8c-source.html#l00253">_dbus_message_remove_size_counter()</a>.
</div>
</div><p>
<a class="anchor" name="g817729ebefbd486f816b24a1fefc889d"></a><!-- doxytag: member="dbus-resources.c::_dbus_counter_get_value" ref="g817729ebefbd486f816b24a1fefc889d" args="(DBusCounter *counter)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">long _dbus_counter_get_value </td>
<td>(</td>
<td class="paramtype"><a class="el" href="structDBusCounter.html">DBusCounter</a> * </td>
<td class="paramname"> <em>counter</em> </td>
<td> ) </td>
<td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Gets the current value of the counter.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>counter</em> </td><td>the counter </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>its current value </dd></dl>
<p>
Definition at line <a class="el" href="dbus-resources_8c-source.html#l00168">168</a> of file <a class="el" href="dbus-resources_8c-source.html">dbus-resources.c</a>.
<p>
References <a class="el" href="dbus-resources_8c-source.html#l00056">DBusCounter::value</a>.
<p>
Referenced by <a class="el" href="dbus-transport_8c-source.html#l01046">_dbus_transport_get_dispatch_status()</a>, and <a class="el" href="dbus-connection_8c-source.html#l05686">dbus_connection_get_outgoing_size()</a>.
</div>
</div><p>
<a class="anchor" name="g9911dd8fa020299a2b517251ea0be399"></a><!-- doxytag: member="dbus-resources.c::_dbus_counter_new" ref="g9911dd8fa020299a2b517251ea0be399" args="(void)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="structDBusCounter.html">DBusCounter</a>* _dbus_counter_new </td>
<td>(</td>
<td class="paramtype">void </td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Creates a new <a class="el" href="structDBusCounter.html">DBusCounter</a>.
<p>
<a class="el" href="structDBusCounter.html">DBusCounter</a> is used to count usage of some resource such as memory.<p>
<dl compact><dt><b>Returns:</b></dt><dd>new counter or <a class="el" href="group__DBusMacros.html#g070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a> on failure </dd></dl>
<p>
Definition at line <a class="el" href="dbus-resources_8c-source.html#l00077">77</a> of file <a class="el" href="dbus-resources_8c-source.html">dbus-resources.c</a>.
<p>
References <a class="el" href="dbus-memory_8h-source.html#l00046">dbus_new</a>, <a class="el" href="dbus-resources_8c-source.html#l00060">DBusCounter::notify_data</a>, <a class="el" href="dbus-resources_8c-source.html#l00059">DBusCounter::notify_function</a>, <a class="el" href="dbus-resources_8c-source.html#l00058">DBusCounter::notify_guard_value</a>, <a class="el" href="group__DBusMacros.html#g070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>, <a class="el" href="dbus-resources_8c-source.html#l00054">DBusCounter::refcount</a>, and <a class="el" href="dbus-resources_8c-source.html#l00056">DBusCounter::value</a>.
<p>
Referenced by <a class="el" href="dbus-connection_8c-source.html#l01163">_dbus_connection_new_for_transport()</a>, and <a class="el" href="dbus-transport_8c-source.html#l00093">_dbus_transport_init_base()</a>.
</div>
</div><p>
<a class="anchor" name="ge93240c77bfb66642453518c9bb90bc4"></a><!-- doxytag: member="dbus-resources.c::_dbus_counter_ref" ref="ge93240c77bfb66642453518c9bb90bc4" args="(DBusCounter *counter)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="structDBusCounter.html">DBusCounter</a>* _dbus_counter_ref </td>
<td>(</td>
<td class="paramtype"><a class="el" href="structDBusCounter.html">DBusCounter</a> * </td>
<td class="paramname"> <em>counter</em> </td>
<td> ) </td>
<td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Increments refcount of the counter.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>counter</em> </td><td>the counter </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>the counter </dd></dl>
<p>
Definition at line <a class="el" href="dbus-resources_8c-source.html#l00102">102</a> of file <a class="el" href="dbus-resources_8c-source.html">dbus-resources.c</a>.
<p>
References <a class="el" href="dbus-internals_8h-source.html#l00109">_dbus_assert</a>, and <a class="el" href="dbus-resources_8c-source.html#l00054">DBusCounter::refcount</a>.
<p>
Referenced by <a class="el" href="dbus-message_8c-source.html#l00229">_dbus_message_add_size_counter()</a>.
</div>
</div><p>
<a class="anchor" name="gdf751ffe6ca8c3f81a89df70fc9c93d0"></a><!-- doxytag: member="dbus-resources.c::_dbus_counter_set_notify" ref="gdf751ffe6ca8c3f81a89df70fc9c93d0" args="(DBusCounter *counter, long guard_value, DBusCounterNotifyFunction function, void *user_data)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void _dbus_counter_set_notify </td>
<td>(</td>
<td class="paramtype"><a class="el" href="structDBusCounter.html">DBusCounter</a> * </td>
<td class="paramname"> <em>counter</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">long </td>
<td class="paramname"> <em>guard_value</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">DBusCounterNotifyFunction </td>
<td class="paramname"> <em>function</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">void * </td>
<td class="paramname"> <em>user_data</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Sets the notify function for this counter; the notify function is called whenever the counter's value crosses the guard value in either direction (moving up, or moving down).
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>counter</em> </td><td>the counter </td></tr>
<tr><td valign="top"></td><td valign="top"><em>guard_value</em> </td><td>the value we're notified if the counter crosses </td></tr>
<tr><td valign="top"></td><td valign="top"><em>function</em> </td><td>function to call in order to notify </td></tr>
<tr><td valign="top"></td><td valign="top"><em>user_data</em> </td><td>data to pass to the function </td></tr>
</table>
</dl>
<p>
Definition at line <a class="el" href="dbus-resources_8c-source.html#l00184">184</a> of file <a class="el" href="dbus-resources_8c-source.html">dbus-resources.c</a>.
<p>
References <a class="el" href="dbus-resources_8c-source.html#l00060">DBusCounter::notify_data</a>, <a class="el" href="dbus-resources_8c-source.html#l00059">DBusCounter::notify_function</a>, and <a class="el" href="dbus-resources_8c-source.html#l00058">DBusCounter::notify_guard_value</a>.
<p>
Referenced by <a class="el" href="dbus-transport_8c-source.html#l00202">_dbus_transport_finalize_base()</a>, <a class="el" href="dbus-transport_8c-source.html#l00093">_dbus_transport_init_base()</a>, and <a class="el" href="dbus-transport_8c-source.html#l01161">_dbus_transport_set_max_received_size()</a>.
</div>
</div><p>
<a class="anchor" name="g48d9b53d1a395ab3c4f1846ca569ef3f"></a><!-- doxytag: member="dbus-resources.c::_dbus_counter_unref" ref="g48d9b53d1a395ab3c4f1846ca569ef3f" args="(DBusCounter *counter)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void _dbus_counter_unref </td>
<td>(</td>
<td class="paramtype"><a class="el" href="structDBusCounter.html">DBusCounter</a> * </td>
<td class="paramname"> <em>counter</em> </td>
<td> ) </td>
<td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Decrements refcount of the counter and possibly finalizes the counter.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>counter</em> </td><td>the counter </td></tr>
</table>
</dl>
<p>
Definition at line <a class="el" href="dbus-resources_8c-source.html#l00118">118</a> of file <a class="el" href="dbus-resources_8c-source.html">dbus-resources.c</a>.
<p>
References <a class="el" href="dbus-internals_8h-source.html#l00109">_dbus_assert</a>, <a class="el" href="dbus-memory_8c-source.html#l00617">dbus_free()</a>, and <a class="el" href="dbus-resources_8c-source.html#l00054">DBusCounter::refcount</a>.
<p>
Referenced by <a class="el" href="dbus-connection_8c-source.html#l01163">_dbus_connection_new_for_transport()</a>, <a class="el" href="dbus-message_8c-source.html#l00253">_dbus_message_remove_size_counter()</a>, <a class="el" href="dbus-transport_8c-source.html#l00202">_dbus_transport_finalize_base()</a>, <a class="el" href="dbus-transport_8c-source.html#l00093">_dbus_transport_init_base()</a>, and <a class="el" href="dbus-connection_8c-source.html#l02956">dbus_connection_free_preallocated_send()</a>.
</div>
</div><p>
<hr size="1"><address style="align: right;"><small>Generated on Mon Dec 14 22:26:14 2009 for D-Bus by
<a href="http://www.doxygen.org/index.html">
<img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.4.7 </small></address>
</body>
</html>