apr-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From bo...@apache.org
Subject svn commit: r794511 [20/29] - /apr/site/trunk/docs/docs/apr/trunk/
Date Thu, 16 Jul 2009 03:44:29 GMT
Modified: apr/site/trunk/docs/docs/apr/trunk/group___a_p_r___util___d_b_m.html
URL: http://svn.apache.org/viewvc/apr/site/trunk/docs/docs/apr/trunk/group___a_p_r___util___d_b_m.html?rev=794511&r1=794510&r2=794511&view=diff
==============================================================================
--- apr/site/trunk/docs/docs/apr/trunk/group___a_p_r___util___d_b_m.html (original)
+++ apr/site/trunk/docs/docs/apr/trunk/group___a_p_r___util___d_b_m.html Thu Jul 16 03:44:20 2009
@@ -43,64 +43,31 @@
 <tr><td class="memItemLeft" nowrap align="right" valign="top">typedef struct <a class="el" href="structapr__dbm__t.html">apr_dbm_t</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___d_b_m.html#g47f6ff771143ed7b7987c686c20c8536">apr_dbm_t</a></td></tr>
 
 <tr><td colspan="2"><br><h2>Functions</h2></td></tr>
-<tr><td class="memItemLeft" nowrap align="right" valign="top">&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___d_b_m.html#gc36b022b8ba06c1d966762b73972c090">APU_DECLARE</a> (<a class="el" href="group__apr__errno.html#gf76ee4543247e9fb3f3546203e590a6c">apr_status_t</a>) apr_dbm_open_ex(<a class="el" href="structapr__dbm__t.html">apr_dbm_t</a> **dbm</td></tr>
+<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="group__apr__errno.html#gf76ee4543247e9fb3f3546203e590a6c">apr_status_t</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___d_b_m.html#gf7295ba8157f487b78319e168e1344b4">apr_dbm_open_ex</a> (<a class="el" href="structapr__dbm__t.html">apr_dbm_t</a> **dbm, const char *type, const char *name, apr_int32_t mode, <a class="el" href="group__apr__file__info.html#g3af19c4c47007169064a70f9351bc7d8">apr_fileperms_t</a> perm, <a class="el" href="group__apr__pools.html#gf137f28edcf9a086cd6bc36c20d7cdfb">apr_pool_t</a> *cntxt)</td></tr>
 
-<tr><td class="memItemLeft" nowrap align="right" valign="top">&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___d_b_m.html#gbd2528499ce66c68dc05d60927725a39">APU_DECLARE</a> (void) apr_dbm_close(<a class="el" href="structapr__dbm__t.html">apr_dbm_t</a> *dbm)</td></tr>
+<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="group__apr__errno.html#gf76ee4543247e9fb3f3546203e590a6c">apr_status_t</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___d_b_m.html#gb2d9cc87f4922ae11a175556ec66e390">apr_dbm_open</a> (<a class="el" href="structapr__dbm__t.html">apr_dbm_t</a> **dbm, const char *name, apr_int32_t mode, <a class="el" href="group__apr__file__info.html#g3af19c4c47007169064a70f9351bc7d8">apr_fileperms_t</a> perm, <a class="el" href="group__apr__pools.html#gf137f28edcf9a086cd6bc36c20d7cdfb">apr_pool_t</a> *cntxt)</td></tr>
 
-<tr><td class="memItemLeft" nowrap align="right" valign="top">&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___d_b_m.html#ge463ab34ff3f518da3d799f0e264e20d">APU_DECLARE</a> (char *) apr_dbm_geterror(<a class="el" href="structapr__dbm__t.html">apr_dbm_t</a> *dbm</td></tr>
+<tr><td class="memItemLeft" nowrap align="right" valign="top">void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___d_b_m.html#gad1e796c7436bf855ce6ec3c567eb3eb">apr_dbm_close</a> (<a class="el" href="structapr__dbm__t.html">apr_dbm_t</a> *dbm)</td></tr>
 
-<tr><td colspan="2"><br><h2>Variables</h2></td></tr>
-<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="g763fd8db6bba8fbbbc113ca0d61c47c2"></a><!-- doxytag: member="APR_Util_DBM::type" ref="g763fd8db6bba8fbbbc113ca0d61c47c2" args="" -->
-const char *&nbsp;</td><td class="memItemRight" valign="bottom"><b>type</b></td></tr>
+<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="group__apr__errno.html#gf76ee4543247e9fb3f3546203e590a6c">apr_status_t</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___d_b_m.html#gc990e695db20e3fa6998089081685196">apr_dbm_fetch</a> (<a class="el" href="structapr__dbm__t.html">apr_dbm_t</a> *dbm, <a class="el" href="structapr__datum__t.html">apr_datum_t</a> key, <a class="el" href="structapr__datum__t.html">apr_datum_t</a> *pvalue)</td></tr>
 
-<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="g8f8f80d37794cde9472343e4487ba3eb"></a><!-- doxytag: member="APR_Util_DBM::name" ref="g8f8f80d37794cde9472343e4487ba3eb" args="" -->
-const char const char *&nbsp;</td><td class="memItemRight" valign="bottom"><b>name</b></td></tr>
+<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="group__apr__errno.html#gf76ee4543247e9fb3f3546203e590a6c">apr_status_t</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___d_b_m.html#g014a6acf6f86aaac5fc44af5b8951051">apr_dbm_store</a> (<a class="el" href="structapr__dbm__t.html">apr_dbm_t</a> *dbm, <a class="el" href="structapr__datum__t.html">apr_datum_t</a> key, <a class="el" href="structapr__datum__t.html">apr_datum_t</a> value)</td></tr>
 
-<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="g719919dff9b073c668fd47f22f420774"></a><!-- doxytag: member="APR_Util_DBM::mode" ref="g719919dff9b073c668fd47f22f420774" args="" -->
-const char const char apr_int32_t&nbsp;</td><td class="memItemRight" valign="bottom"><b>mode</b></td></tr>
+<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="group__apr__errno.html#gf76ee4543247e9fb3f3546203e590a6c">apr_status_t</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___d_b_m.html#g3b218881f3bb9f8e909f32d99ae2ad34">apr_dbm_delete</a> (<a class="el" href="structapr__dbm__t.html">apr_dbm_t</a> *dbm, <a class="el" href="structapr__datum__t.html">apr_datum_t</a> key)</td></tr>
 
-<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="ga8065a83f4f6501dc243d0c894030278"></a><!-- doxytag: member="APR_Util_DBM::perm" ref="ga8065a83f4f6501dc243d0c894030278" args="" -->
-const char const char <br class="typebreak">
-apr_int32_t <a class="el" href="group__apr__file__info.html#g3af19c4c47007169064a70f9351bc7d8">apr_fileperms_t</a>&nbsp;</td><td class="memItemRight" valign="bottom"><b>perm</b></td></tr>
+<tr><td class="memItemLeft" nowrap align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___d_b_m.html#g20379004362aeeef11166bdaa8c47d1e">apr_dbm_exists</a> (<a class="el" href="structapr__dbm__t.html">apr_dbm_t</a> *dbm, <a class="el" href="structapr__datum__t.html">apr_datum_t</a> key)</td></tr>
 
-<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="g3652f9b9de5ead2ce68dfe0b9e09699a"></a><!-- doxytag: member="APR_Util_DBM::cntxt" ref="g3652f9b9de5ead2ce68dfe0b9e09699a" args="" -->
-const char const char <br class="typebreak">
-apr_int32_t <a class="el" href="group__apr__file__info.html#g3af19c4c47007169064a70f9351bc7d8">apr_fileperms_t</a> <br class="typebreak">
-<a class="el" href="group__apr__pools.html#gf137f28edcf9a086cd6bc36c20d7cdfb">apr_pool_t</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><b>cntxt</b></td></tr>
+<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="group__apr__errno.html#gf76ee4543247e9fb3f3546203e590a6c">apr_status_t</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___d_b_m.html#ge5428eaa8df9a036212c8fad60e95e3c">apr_dbm_firstkey</a> (<a class="el" href="structapr__dbm__t.html">apr_dbm_t</a> *dbm, <a class="el" href="structapr__datum__t.html">apr_datum_t</a> *pkey)</td></tr>
 
-<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="g2017a36de7a77aa016bb7553a97af18a"></a><!-- doxytag: member="APR_Util_DBM::key" ref="g2017a36de7a77aa016bb7553a97af18a" args="" -->
-<a class="el" href="structapr__datum__t.html">apr_datum_t</a>&nbsp;</td><td class="memItemRight" valign="bottom"><b>key</b></td></tr>
+<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="group__apr__errno.html#gf76ee4543247e9fb3f3546203e590a6c">apr_status_t</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___d_b_m.html#g92b8233ccf421b89d2144f834dd6f9a6">apr_dbm_nextkey</a> (<a class="el" href="structapr__dbm__t.html">apr_dbm_t</a> *dbm, <a class="el" href="structapr__datum__t.html">apr_datum_t</a> *pkey)</td></tr>
 
-<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="g28a8123792275d5480b92912a9e85b0e"></a><!-- doxytag: member="APR_Util_DBM::pvalue" ref="g28a8123792275d5480b92912a9e85b0e" args="" -->
-<a class="el" href="structapr__datum__t.html">apr_datum_t</a> <a class="el" href="structapr__datum__t.html">apr_datum_t</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><b>pvalue</b></td></tr>
+<tr><td class="memItemLeft" nowrap align="right" valign="top">void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___d_b_m.html#gcd9f6bc4a633720ac882daba9e0d9873">apr_dbm_freedatum</a> (<a class="el" href="structapr__dbm__t.html">apr_dbm_t</a> *dbm, <a class="el" href="structapr__datum__t.html">apr_datum_t</a> data)</td></tr>
 
-<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="g711ebc0efad43aba10f32ded4a28cf17"></a><!-- doxytag: member="APR_Util_DBM::value" ref="g711ebc0efad43aba10f32ded4a28cf17" args="" -->
-<a class="el" href="structapr__datum__t.html">apr_datum_t</a> <a class="el" href="structapr__datum__t.html">apr_datum_t</a>&nbsp;</td><td class="memItemRight" valign="bottom"><b>value</b></td></tr>
+<tr><td class="memItemLeft" nowrap align="right" valign="top">char *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___d_b_m.html#g597bd9e35de9575afb55b3326789c0f3">apr_dbm_geterror</a> (<a class="el" href="structapr__dbm__t.html">apr_dbm_t</a> *dbm, int *errcode, char *errbuf, apr_size_t errbufsize)</td></tr>
 
-<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="g1bbfe97dd2f6cc19a02af7fd6ef61fbd"></a><!-- doxytag: member="APR_Util_DBM::pkey" ref="g1bbfe97dd2f6cc19a02af7fd6ef61fbd" args="" -->
-<a class="el" href="structapr__datum__t.html">apr_datum_t</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><b>pkey</b></td></tr>
+<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="group__apr__errno.html#gf76ee4543247e9fb3f3546203e590a6c">apr_status_t</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___d_b_m.html#g7a3a1bd1ece38d90739ecb7cf72bf4fb">apr_dbm_get_usednames_ex</a> (<a class="el" href="group__apr__pools.html#gf137f28edcf9a086cd6bc36c20d7cdfb">apr_pool_t</a> *pool, const char *type, const char *pathname, const char **used1, const char **used2)</td></tr>
 
-<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="g4ff6b2b1fb4c551508be94e8b31d75c7"></a><!-- doxytag: member="APR_Util_DBM::data" ref="g4ff6b2b1fb4c551508be94e8b31d75c7" args="" -->
-<a class="el" href="structapr__datum__t.html">apr_datum_t</a>&nbsp;</td><td class="memItemRight" valign="bottom"><b>data</b></td></tr>
-
-<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="g01afc7eb5f3439433db4e8fdbed092e9"></a><!-- doxytag: member="APR_Util_DBM::errcode" ref="g01afc7eb5f3439433db4e8fdbed092e9" args="" -->
-int *&nbsp;</td><td class="memItemRight" valign="bottom"><b>errcode</b></td></tr>
-
-<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="g0685405e21ba98006ffc7459350e47b5"></a><!-- doxytag: member="APR_Util_DBM::errbuf" ref="g0685405e21ba98006ffc7459350e47b5" args="" -->
-int char *&nbsp;</td><td class="memItemRight" valign="bottom"><b>errbuf</b></td></tr>
-
-<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="g87b174ca67f400954b4696446a9a35e5"></a><!-- doxytag: member="APR_Util_DBM::errbufsize" ref="g87b174ca67f400954b4696446a9a35e5" args="" -->
-int char apr_size_t&nbsp;</td><td class="memItemRight" valign="bottom"><b>errbufsize</b></td></tr>
-
-<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="gf694cab4f4f6cd4b594af3c43cef1d0a"></a><!-- doxytag: member="APR_Util_DBM::pathname" ref="gf694cab4f4f6cd4b594af3c43cef1d0a" args="" -->
-const char const char *&nbsp;</td><td class="memItemRight" valign="bottom"><b>pathname</b></td></tr>
-
-<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="ge1e64da159a1d4114c6c5c4b2568cc66"></a><!-- doxytag: member="APR_Util_DBM::used1" ref="ge1e64da159a1d4114c6c5c4b2568cc66" args="" -->
-const char const char const char **&nbsp;</td><td class="memItemRight" valign="bottom"><b>used1</b></td></tr>
-
-<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="gd076b56c48879e14e0daddd60ff3eb8c"></a><!-- doxytag: member="APR_Util_DBM::used2" ref="gd076b56c48879e14e0daddd60ff3eb8c" args="" -->
-const char const char const <br class="typebreak">
-char const char **&nbsp;</td><td class="memItemRight" valign="bottom"><b>used2</b></td></tr>
+<tr><td class="memItemLeft" nowrap align="right" valign="top">void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___d_b_m.html#g1ee45897c5e1b0718dfa4bd35a75dbe1">apr_dbm_get_usednames</a> (<a class="el" href="group__apr__pools.html#gf137f28edcf9a086cd6bc36c20d7cdfb">apr_pool_t</a> *pool, const char *pathname, const char **used1, const char **used2)</td></tr>
 
 </table>
 <hr><h2>Define Documentation</h2>
@@ -181,15 +148,15 @@
 </div>
 </div><p>
 <hr><h2>Function Documentation</h2>
-<a class="anchor" name="ge463ab34ff3f518da3d799f0e264e20d"></a><!-- doxytag: member="apr_dbm.h::APU_DECLARE" ref="ge463ab34ff3f518da3d799f0e264e20d" args="(char *) apr_dbm_geterror(apr_dbm_t *dbm" -->
+<a class="anchor" name="gad1e796c7436bf855ce6ec3c567eb3eb"></a><!-- doxytag: member="apr_dbm.h::apr_dbm_close" ref="gad1e796c7436bf855ce6ec3c567eb3eb" args="(apr_dbm_t *dbm)" -->
 <div class="memitem">
 <div class="memproto">
       <table class="memname">
         <tr>
-          <td class="memname">APU_DECLARE           </td>
+          <td class="memname">void apr_dbm_close           </td>
           <td>(</td>
-          <td class="paramtype">char *&nbsp;</td>
-          <td class="paramname">          </td>
+          <td class="paramtype"><a class="el" href="structapr__dbm__t.html">apr_dbm_t</a> *&nbsp;</td>
+          <td class="paramname"> <em>dbm</em>          </td>
           <td>&nbsp;)&nbsp;</td>
           <td></td>
         </tr>
@@ -198,202 +165,442 @@
 <div class="memdoc">
 
 <p>
-Report more information when an apr_dbm function fails. <dl compact><dt><b>Parameters:</b></dt><dd>
+Close a dbm file previously opened by apr_dbm_open <dl compact><dt><b>Parameters:</b></dt><dd>
   <table border="0" cellspacing="2" cellpadding="0">
-    <tr><td valign="top"></td><td valign="top"><em>dbm</em>&nbsp;</td><td>The database </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>errcode</em>&nbsp;</td><td>A DBM-specific value for the error (for logging). If this isn't needed, it may be NULL. </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>errbuf</em>&nbsp;</td><td>Location to store the error text </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>errbufsize</em>&nbsp;</td><td>The size of the provided buffer </td></tr>
+    <tr><td valign="top"></td><td valign="top"><em>dbm</em>&nbsp;</td><td>The database to close </td></tr>
   </table>
 </dl>
-<dl class="return" compact><dt><b>Returns:</b></dt><dd>The errbuf parameter, for convenience. </dd></dl>
 
 </div>
 </div><p>
-<a class="anchor" name="gbd2528499ce66c68dc05d60927725a39"></a><!-- doxytag: member="apr_dbm.h::APU_DECLARE" ref="gbd2528499ce66c68dc05d60927725a39" args="(void) apr_dbm_close(apr_dbm_t *dbm)" -->
+<a class="anchor" name="g3b218881f3bb9f8e909f32d99ae2ad34"></a><!-- doxytag: member="apr_dbm.h::apr_dbm_delete" ref="g3b218881f3bb9f8e909f32d99ae2ad34" args="(apr_dbm_t *dbm, apr_datum_t key)" -->
 <div class="memitem">
 <div class="memproto">
       <table class="memname">
         <tr>
-          <td class="memname">APU_DECLARE           </td>
+          <td class="memname"><a class="el" href="group__apr__errno.html#gf76ee4543247e9fb3f3546203e590a6c">apr_status_t</a> apr_dbm_delete           </td>
           <td>(</td>
-          <td class="paramtype">void&nbsp;</td>
-          <td class="paramname">          </td>
-          <td>&nbsp;)&nbsp;</td>
+          <td class="paramtype"><a class="el" href="structapr__dbm__t.html">apr_dbm_t</a> *&nbsp;</td>
+          <td class="paramname"> <em>dbm</em>, </td>
+        </tr>
+        <tr>
+          <td class="paramkey"></td>
+          <td></td>
+          <td class="paramtype"><a class="el" href="structapr__datum__t.html">apr_datum_t</a>&nbsp;</td>
+          <td class="paramname"> <em>key</em></td><td>&nbsp;</td>
+        </tr>
+        <tr>
           <td></td>
+          <td>)</td>
+          <td></td><td></td><td></td>
         </tr>
       </table>
 </div>
 <div class="memdoc">
 
 <p>
-Close a dbm file previously opened by apr_dbm_open <dl compact><dt><b>Parameters:</b></dt><dd>
-  <table border="0" cellspacing="2" cellpadding="0">
-    <tr><td valign="top"></td><td valign="top"><em>dbm</em>&nbsp;</td><td>The database to close</td></tr>
-  </table>
-</dl>
-Proactively toss any memory associated with the <a class="el" href="structapr__datum__t.html">apr_datum_t</a>. <dl compact><dt><b>Parameters:</b></dt><dd>
+Delete a dbm record value by key <dl compact><dt><b>Parameters:</b></dt><dd>
   <table border="0" cellspacing="2" cellpadding="0">
     <tr><td valign="top"></td><td valign="top"><em>dbm</em>&nbsp;</td><td>The database </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>data</em>&nbsp;</td><td>The datum to free.</td></tr>
-  </table>
-</dl>
-If the specified file/path were passed to apr_dbm_open(), return the actual file/path names which would be (created and) used. At most, two files may be used; used2 may be NULL if only one file is used. <dl compact><dt><b>Parameters:</b></dt><dd>
-  <table border="0" cellspacing="2" cellpadding="0">
-    <tr><td valign="top"></td><td valign="top"><em>pool</em>&nbsp;</td><td>The pool for allocating used1 and used2. </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>pathname</em>&nbsp;</td><td>The path name to generate used-names from. </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>used1</em>&nbsp;</td><td>The first pathname used by the apr_dbm implementation. </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>used2</em>&nbsp;</td><td>The second pathname used by apr_dbm. If only one file is used by the specific implementation, this will be set to NULL. </td></tr>
-  </table>
-</dl>
-<dl class="remark" compact><dt><b>Remarks:</b></dt><dd>The dbm file(s) don't need to exist. This function only manipulates the pathnames.</dd></dl>
-Sort all of the registerd functions for a given hook<p>
-Print all of the information about the current hook. This is used for debugging purposes. <dl compact><dt><b>Parameters:</b></dt><dd>
-  <table border="0" cellspacing="2" cellpadding="0">
-    <tr><td valign="top"></td><td valign="top"><em>szName</em>&nbsp;</td><td>The name of the hook </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>aszPre</em>&nbsp;</td><td>All of the functions in the predecessor array </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>aszSucc</em>&nbsp;</td><td>All of the functions in the successor array</td></tr>
-  </table>
-</dl>
-Remove all currently registered functions.<p>
-Set reslist cleanup order. <dl compact><dt><b>Parameters:</b></dt><dd>
-  <table border="0" cellspacing="2" cellpadding="0">
-    <tr><td valign="top"></td><td valign="top"><em>reslist</em>&nbsp;</td><td>The resource list. </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>mode</em>&nbsp;</td><td>Cleanup order mode <pre>
-           APR_RESLIST_CLEANUP_DEFAULT  default pool cleanup order
-           APR_RESLIST_CLEANUP_FIRST    use pool pre cleanup
- </pre> </td></tr>
-  </table>
-</dl>
-<dl class="remark" compact><dt><b>Remarks:</b></dt><dd>If APR_RESLIST_CLEANUP_FIRST is used the destructors will be called before child pools of the pool used to create the reslist are destroyed. This allows to explicitly destroy the child pools inside reslist destructors.</dd></dl>
-Initialize the SHA digest <dl compact><dt><b>Parameters:</b></dt><dd>
-  <table border="0" cellspacing="2" cellpadding="0">
-    <tr><td valign="top"></td><td valign="top"><em>context</em>&nbsp;</td><td>The SHA context to initialize</td></tr>
-  </table>
-</dl>
-Update the SHA digest <dl compact><dt><b>Parameters:</b></dt><dd>
-  <table border="0" cellspacing="2" cellpadding="0">
-    <tr><td valign="top"></td><td valign="top"><em>context</em>&nbsp;</td><td>The SHA1 context to update </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>input</em>&nbsp;</td><td>The buffer to add to the SHA digest </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>inputLen</em>&nbsp;</td><td>The length of the input buffer</td></tr>
+    <tr><td valign="top"></td><td valign="top"><em>key</em>&nbsp;</td><td>The key datum of the record to delete </td></tr>
   </table>
 </dl>
-Update the SHA digest with binary data <dl compact><dt><b>Parameters:</b></dt><dd>
+<dl class="remark" compact><dt><b>Remarks:</b></dt><dd>It is not an error to delete a non-existent record. </dd></dl>
+
+</div>
+</div><p>
+<a class="anchor" name="g20379004362aeeef11166bdaa8c47d1e"></a><!-- doxytag: member="apr_dbm.h::apr_dbm_exists" ref="g20379004362aeeef11166bdaa8c47d1e" args="(apr_dbm_t *dbm, apr_datum_t key)" -->
+<div class="memitem">
+<div class="memproto">
+      <table class="memname">
+        <tr>
+          <td class="memname">int apr_dbm_exists           </td>
+          <td>(</td>
+          <td class="paramtype"><a class="el" href="structapr__dbm__t.html">apr_dbm_t</a> *&nbsp;</td>
+          <td class="paramname"> <em>dbm</em>, </td>
+        </tr>
+        <tr>
+          <td class="paramkey"></td>
+          <td></td>
+          <td class="paramtype"><a class="el" href="structapr__datum__t.html">apr_datum_t</a>&nbsp;</td>
+          <td class="paramname"> <em>key</em></td><td>&nbsp;</td>
+        </tr>
+        <tr>
+          <td></td>
+          <td>)</td>
+          <td></td><td></td><td></td>
+        </tr>
+      </table>
+</div>
+<div class="memdoc">
+
+<p>
+Search for a key within the dbm <dl compact><dt><b>Parameters:</b></dt><dd>
   <table border="0" cellspacing="2" cellpadding="0">
-    <tr><td valign="top"></td><td valign="top"><em>context</em>&nbsp;</td><td>The SHA1 context to update </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>input</em>&nbsp;</td><td>The buffer to add to the SHA digest </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>inputLen</em>&nbsp;</td><td>The length of the input buffer</td></tr>
+    <tr><td valign="top"></td><td valign="top"><em>dbm</em>&nbsp;</td><td>The database </td></tr>
+    <tr><td valign="top"></td><td valign="top"><em>key</em>&nbsp;</td><td>The datum describing a key to test </td></tr>
   </table>
 </dl>
-Finish computing the SHA digest <dl compact><dt><b>Parameters:</b></dt><dd>
+
+</div>
+</div><p>
+<a class="anchor" name="gc990e695db20e3fa6998089081685196"></a><!-- doxytag: member="apr_dbm.h::apr_dbm_fetch" ref="gc990e695db20e3fa6998089081685196" args="(apr_dbm_t *dbm, apr_datum_t key, apr_datum_t *pvalue)" -->
+<div class="memitem">
+<div class="memproto">
+      <table class="memname">
+        <tr>
+          <td class="memname"><a class="el" href="group__apr__errno.html#gf76ee4543247e9fb3f3546203e590a6c">apr_status_t</a> apr_dbm_fetch           </td>
+          <td>(</td>
+          <td class="paramtype"><a class="el" href="structapr__dbm__t.html">apr_dbm_t</a> *&nbsp;</td>
+          <td class="paramname"> <em>dbm</em>, </td>
+        </tr>
+        <tr>
+          <td class="paramkey"></td>
+          <td></td>
+          <td class="paramtype"><a class="el" href="structapr__datum__t.html">apr_datum_t</a>&nbsp;</td>
+          <td class="paramname"> <em>key</em>, </td>
+        </tr>
+        <tr>
+          <td class="paramkey"></td>
+          <td></td>
+          <td class="paramtype"><a class="el" href="structapr__datum__t.html">apr_datum_t</a> *&nbsp;</td>
+          <td class="paramname"> <em>pvalue</em></td><td>&nbsp;</td>
+        </tr>
+        <tr>
+          <td></td>
+          <td>)</td>
+          <td></td><td></td><td></td>
+        </tr>
+      </table>
+</div>
+<div class="memdoc">
+
+<p>
+Fetch a dbm record value by key <dl compact><dt><b>Parameters:</b></dt><dd>
   <table border="0" cellspacing="2" cellpadding="0">
-    <tr><td valign="top"></td><td valign="top"><em>digest</em>&nbsp;</td><td>the output buffer in which to store the digest </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>context</em>&nbsp;</td><td>The context to finalize</td></tr>
+    <tr><td valign="top"></td><td valign="top"><em>dbm</em>&nbsp;</td><td>The database </td></tr>
+    <tr><td valign="top"></td><td valign="top"><em>key</em>&nbsp;</td><td>The key datum to find this record </td></tr>
+    <tr><td valign="top"></td><td valign="top"><em>pvalue</em>&nbsp;</td><td>The value datum retrieved for this record </td></tr>
   </table>
 </dl>
-Format a UUID into a string, following the standard format <dl compact><dt><b>Parameters:</b></dt><dd>
+
+</div>
+</div><p>
+<a class="anchor" name="ge5428eaa8df9a036212c8fad60e95e3c"></a><!-- doxytag: member="apr_dbm.h::apr_dbm_firstkey" ref="ge5428eaa8df9a036212c8fad60e95e3c" args="(apr_dbm_t *dbm, apr_datum_t *pkey)" -->
+<div class="memitem">
+<div class="memproto">
+      <table class="memname">
+        <tr>
+          <td class="memname"><a class="el" href="group__apr__errno.html#gf76ee4543247e9fb3f3546203e590a6c">apr_status_t</a> apr_dbm_firstkey           </td>
+          <td>(</td>
+          <td class="paramtype"><a class="el" href="structapr__dbm__t.html">apr_dbm_t</a> *&nbsp;</td>
+          <td class="paramname"> <em>dbm</em>, </td>
+        </tr>
+        <tr>
+          <td class="paramkey"></td>
+          <td></td>
+          <td class="paramtype"><a class="el" href="structapr__datum__t.html">apr_datum_t</a> *&nbsp;</td>
+          <td class="paramname"> <em>pkey</em></td><td>&nbsp;</td>
+        </tr>
+        <tr>
+          <td></td>
+          <td>)</td>
+          <td></td><td></td><td></td>
+        </tr>
+      </table>
+</div>
+<div class="memdoc">
+
+<p>
+Retrieve the first record key from a dbm <dl compact><dt><b>Parameters:</b></dt><dd>
   <table border="0" cellspacing="2" cellpadding="0">
-    <tr><td valign="top"></td><td valign="top"><em>buffer</em>&nbsp;</td><td>The buffer to place the formatted UUID string into. It must be at least APR_UUID_FORMATTED_LENGTH + 1 bytes long to hold the formatted UUID and a null terminator </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>uuid</em>&nbsp;</td><td>The UUID to format</td></tr>
+    <tr><td valign="top"></td><td valign="top"><em>dbm</em>&nbsp;</td><td>The database </td></tr>
+    <tr><td valign="top"></td><td valign="top"><em>pkey</em>&nbsp;</td><td>The key datum of the first record </td></tr>
   </table>
 </dl>
-Converts an XML element tree to flat text <dl compact><dt><b>Parameters:</b></dt><dd>
+
+</div>
+</div><p>
+<a class="anchor" name="gcd9f6bc4a633720ac882daba9e0d9873"></a><!-- doxytag: member="apr_dbm.h::apr_dbm_freedatum" ref="gcd9f6bc4a633720ac882daba9e0d9873" args="(apr_dbm_t *dbm, apr_datum_t data)" -->
+<div class="memitem">
+<div class="memproto">
+      <table class="memname">
+        <tr>
+          <td class="memname">void apr_dbm_freedatum           </td>
+          <td>(</td>
+          <td class="paramtype"><a class="el" href="structapr__dbm__t.html">apr_dbm_t</a> *&nbsp;</td>
+          <td class="paramname"> <em>dbm</em>, </td>
+        </tr>
+        <tr>
+          <td class="paramkey"></td>
+          <td></td>
+          <td class="paramtype"><a class="el" href="structapr__datum__t.html">apr_datum_t</a>&nbsp;</td>
+          <td class="paramname"> <em>data</em></td><td>&nbsp;</td>
+        </tr>
+        <tr>
+          <td></td>
+          <td>)</td>
+          <td></td><td></td><td></td>
+        </tr>
+      </table>
+</div>
+<div class="memdoc">
+
+<p>
+Proactively toss any memory associated with the <a class="el" href="structapr__datum__t.html">apr_datum_t</a>. <dl compact><dt><b>Parameters:</b></dt><dd>
   <table border="0" cellspacing="2" cellpadding="0">
-    <tr><td valign="top"></td><td valign="top"><em>p</em>&nbsp;</td><td>The pool to allocate out of </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>elem</em>&nbsp;</td><td>The XML element to convert </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>style</em>&nbsp;</td><td>How to covert the XML. One of: <pre>
-     APR_XML_X2T_FULL                start tag, contents, end tag 
-     APR_XML_X2T_INNER               contents only 
-     APR_XML_X2T_LANG_INNER          xml:lang + inner contents 
-     APR_XML_X2T_FULL_NS_LANG        FULL + ns defns + xml:lang 
- </pre> </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>namespaces</em>&nbsp;</td><td>The namespace of the current XML element </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>ns_map</em>&nbsp;</td><td>Namespace mapping </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>pbuf</em>&nbsp;</td><td>Buffer to put the converted text into </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>psize</em>&nbsp;</td><td>Size of the converted text</td></tr>
+    <tr><td valign="top"></td><td valign="top"><em>dbm</em>&nbsp;</td><td>The database </td></tr>
+    <tr><td valign="top"></td><td valign="top"><em>data</em>&nbsp;</td><td>The datum to free. </td></tr>
   </table>
 </dl>
-Quote an XML element <dl compact><dt><b>Parameters:</b></dt><dd>
+
+</div>
+</div><p>
+<a class="anchor" name="g1ee45897c5e1b0718dfa4bd35a75dbe1"></a><!-- doxytag: member="apr_dbm.h::apr_dbm_get_usednames" ref="g1ee45897c5e1b0718dfa4bd35a75dbe1" args="(apr_pool_t *pool, const char *pathname, const char **used1, const char **used2)" -->
+<div class="memitem">
+<div class="memproto">
+      <table class="memname">
+        <tr>
+          <td class="memname">void apr_dbm_get_usednames           </td>
+          <td>(</td>
+          <td class="paramtype"><a class="el" href="group__apr__pools.html#gf137f28edcf9a086cd6bc36c20d7cdfb">apr_pool_t</a> *&nbsp;</td>
+          <td class="paramname"> <em>pool</em>, </td>
+        </tr>
+        <tr>
+          <td class="paramkey"></td>
+          <td></td>
+          <td class="paramtype">const char *&nbsp;</td>
+          <td class="paramname"> <em>pathname</em>, </td>
+        </tr>
+        <tr>
+          <td class="paramkey"></td>
+          <td></td>
+          <td class="paramtype">const char **&nbsp;</td>
+          <td class="paramname"> <em>used1</em>, </td>
+        </tr>
+        <tr>
+          <td class="paramkey"></td>
+          <td></td>
+          <td class="paramtype">const char **&nbsp;</td>
+          <td class="paramname"> <em>used2</em></td><td>&nbsp;</td>
+        </tr>
+        <tr>
+          <td></td>
+          <td>)</td>
+          <td></td><td></td><td></td>
+        </tr>
+      </table>
+</div>
+<div class="memdoc">
+
+<p>
+If the specified file/path were passed to <a class="el" href="group___a_p_r___util___d_b_m.html#gb2d9cc87f4922ae11a175556ec66e390">apr_dbm_open()</a>, return the actual file/path names which would be (created and) used. At most, two files may be used; used2 may be NULL if only one file is used. <dl compact><dt><b>Parameters:</b></dt><dd>
   <table border="0" cellspacing="2" cellpadding="0">
-    <tr><td valign="top"></td><td valign="top"><em>p</em>&nbsp;</td><td>The pool to allocate out of </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>elem</em>&nbsp;</td><td>The element to quote</td></tr>
+    <tr><td valign="top"></td><td valign="top"><em>pool</em>&nbsp;</td><td>The pool for allocating used1 and used2. </td></tr>
+    <tr><td valign="top"></td><td valign="top"><em>pathname</em>&nbsp;</td><td>The path name to generate used-names from. </td></tr>
+    <tr><td valign="top"></td><td valign="top"><em>used1</em>&nbsp;</td><td>The first pathname used by the apr_dbm implementation. </td></tr>
+    <tr><td valign="top"></td><td valign="top"><em>used2</em>&nbsp;</td><td>The second pathname used by apr_dbm. If only one file is used by the specific implementation, this will be set to NULL. </td></tr>
   </table>
 </dl>
-Set the timeout the acquire will wait for a free resource when the maximum number of resources is exceeded. <dl compact><dt><b>Parameters:</b></dt><dd>
+<dl class="remark" compact><dt><b>Remarks:</b></dt><dd>The dbm file(s) don't need to exist. This function only manipulates the pathnames. </dd></dl>
+
+</div>
+</div><p>
+<a class="anchor" name="g7a3a1bd1ece38d90739ecb7cf72bf4fb"></a><!-- doxytag: member="apr_dbm.h::apr_dbm_get_usednames_ex" ref="g7a3a1bd1ece38d90739ecb7cf72bf4fb" args="(apr_pool_t *pool, const char *type, const char *pathname, const char **used1, const char **used2)" -->
+<div class="memitem">
+<div class="memproto">
+      <table class="memname">
+        <tr>
+          <td class="memname"><a class="el" href="group__apr__errno.html#gf76ee4543247e9fb3f3546203e590a6c">apr_status_t</a> apr_dbm_get_usednames_ex           </td>
+          <td>(</td>
+          <td class="paramtype"><a class="el" href="group__apr__pools.html#gf137f28edcf9a086cd6bc36c20d7cdfb">apr_pool_t</a> *&nbsp;</td>
+          <td class="paramname"> <em>pool</em>, </td>
+        </tr>
+        <tr>
+          <td class="paramkey"></td>
+          <td></td>
+          <td class="paramtype">const char *&nbsp;</td>
+          <td class="paramname"> <em>type</em>, </td>
+        </tr>
+        <tr>
+          <td class="paramkey"></td>
+          <td></td>
+          <td class="paramtype">const char *&nbsp;</td>
+          <td class="paramname"> <em>pathname</em>, </td>
+        </tr>
+        <tr>
+          <td class="paramkey"></td>
+          <td></td>
+          <td class="paramtype">const char **&nbsp;</td>
+          <td class="paramname"> <em>used1</em>, </td>
+        </tr>
+        <tr>
+          <td class="paramkey"></td>
+          <td></td>
+          <td class="paramtype">const char **&nbsp;</td>
+          <td class="paramname"> <em>used2</em></td><td>&nbsp;</td>
+        </tr>
+        <tr>
+          <td></td>
+          <td>)</td>
+          <td></td><td></td><td></td>
+        </tr>
+      </table>
+</div>
+<div class="memdoc">
+
+<p>
+If the specified file/path were passed to <a class="el" href="group___a_p_r___util___d_b_m.html#gb2d9cc87f4922ae11a175556ec66e390">apr_dbm_open()</a>, return the actual file/path names which would be (created and) used. At most, two files may be used; used2 may be NULL if only one file is used. <dl compact><dt><b>Parameters:</b></dt><dd>
   <table border="0" cellspacing="2" cellpadding="0">
-    <tr><td valign="top"></td><td valign="top"><em>reslist</em>&nbsp;</td><td>The resource list. </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>timeout</em>&nbsp;</td><td>Timeout to wait. The zero waits forever.</td></tr>
+    <tr><td valign="top"></td><td valign="top"><em>pool</em>&nbsp;</td><td>The pool for allocating used1 and used2. </td></tr>
+    <tr><td valign="top"></td><td valign="top"><em>type</em>&nbsp;</td><td>The type of DBM you require info on </td></tr>
   </table>
 </dl>
-Set reslist cleanup order. <dl compact><dt><b>Parameters:</b></dt><dd>
+<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="group___a_p_r___util___d_b_m.html#gf7295ba8157f487b78319e168e1344b4">apr_dbm_open_ex</a> </dd></dl>
+<dl compact><dt><b>Parameters:</b></dt><dd>
   <table border="0" cellspacing="2" cellpadding="0">
-    <tr><td valign="top"></td><td valign="top"><em>reslist</em>&nbsp;</td><td>The resource list. </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>mode</em>&nbsp;</td><td>Cleanup order mode <pre>
-           APR_RESLIST_CLEANUP_DEFAULT  default pool cleanup order
-           APR_RESLIST_CLEANUP_FIRST    use pool pre cleanup
- </pre> </td></tr>
+    <tr><td valign="top"></td><td valign="top"><em>pathname</em>&nbsp;</td><td>The path name to generate used-names from. </td></tr>
+    <tr><td valign="top"></td><td valign="top"><em>used1</em>&nbsp;</td><td>The first pathname used by the apr_dbm implementation. </td></tr>
+    <tr><td valign="top"></td><td valign="top"><em>used2</em>&nbsp;</td><td>The second pathname used by apr_dbm. If only one file is used by the specific implementation, this will be set to NULL. </td></tr>
   </table>
 </dl>
-<dl class="remark" compact><dt><b>Remarks:</b></dt><dd>If APR_RESLIST_CLEANUP_FIRST is used the destructors will be called before child pools of the pool used to create the reslist are destroyed. This allows to explicitly destroy the child pools inside reslist destructors.</dd></dl>
-Append a piece of text to the end of a list <dl compact><dt><b>Parameters:</b></dt><dd>
+<dl class="return" compact><dt><b>Returns:</b></dt><dd>An error if the specified type is invalid. </dd></dl>
+<dl class="remark" compact><dt><b>Remarks:</b></dt><dd>The dbm file(s) don't need to exist. This function only manipulates the pathnames. </dd></dl>
+
+</div>
+</div><p>
+<a class="anchor" name="g597bd9e35de9575afb55b3326789c0f3"></a><!-- doxytag: member="apr_dbm.h::apr_dbm_geterror" ref="g597bd9e35de9575afb55b3326789c0f3" args="(apr_dbm_t *dbm, int *errcode, char *errbuf, apr_size_t errbufsize)" -->
+<div class="memitem">
+<div class="memproto">
+      <table class="memname">
+        <tr>
+          <td class="memname">char* apr_dbm_geterror           </td>
+          <td>(</td>
+          <td class="paramtype"><a class="el" href="structapr__dbm__t.html">apr_dbm_t</a> *&nbsp;</td>
+          <td class="paramname"> <em>dbm</em>, </td>
+        </tr>
+        <tr>
+          <td class="paramkey"></td>
+          <td></td>
+          <td class="paramtype">int *&nbsp;</td>
+          <td class="paramname"> <em>errcode</em>, </td>
+        </tr>
+        <tr>
+          <td class="paramkey"></td>
+          <td></td>
+          <td class="paramtype">char *&nbsp;</td>
+          <td class="paramname"> <em>errbuf</em>, </td>
+        </tr>
+        <tr>
+          <td class="paramkey"></td>
+          <td></td>
+          <td class="paramtype">apr_size_t&nbsp;</td>
+          <td class="paramname"> <em>errbufsize</em></td><td>&nbsp;</td>
+        </tr>
+        <tr>
+          <td></td>
+          <td>)</td>
+          <td></td><td></td><td></td>
+        </tr>
+      </table>
+</div>
+<div class="memdoc">
+
+<p>
+Report more information when an apr_dbm function fails. <dl compact><dt><b>Parameters:</b></dt><dd>
   <table border="0" cellspacing="2" cellpadding="0">
-    <tr><td valign="top"></td><td valign="top"><em>p</em>&nbsp;</td><td>The pool to allocate out of </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>hdr</em>&nbsp;</td><td>The text header to append to </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>text</em>&nbsp;</td><td>The new text to append</td></tr>
-  </table>
-</dl>
-Converts an XML element tree to flat text <dl compact><dt><b>Parameters:</b></dt><dd>
-  <table border="0" cellspacing="2" cellpadding="0">
-    <tr><td valign="top"></td><td valign="top"><em>p</em>&nbsp;</td><td>The pool to allocate out of </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>elem</em>&nbsp;</td><td>The XML element to convert </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>style</em>&nbsp;</td><td>How to covert the XML. One of: <pre>
-     APR_XML_X2T_FULL                start tag, contents, end tag 
-     APR_XML_X2T_INNER               contents only 
-     APR_XML_X2T_LANG_INNER          xml:lang + inner contents 
-     APR_XML_X2T_FULL_NS_LANG        FULL + ns defns + xml:lang 
- </pre> </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>namespaces</em>&nbsp;</td><td>The namespace of the current XML element </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>ns_map</em>&nbsp;</td><td>Namespace mapping </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>pbuf</em>&nbsp;</td><td>Buffer to put the converted text into </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>psize</em>&nbsp;</td><td>Size of the converted text</td></tr>
+    <tr><td valign="top"></td><td valign="top"><em>dbm</em>&nbsp;</td><td>The database </td></tr>
+    <tr><td valign="top"></td><td valign="top"><em>errcode</em>&nbsp;</td><td>A DBM-specific value for the error (for logging). If this isn't needed, it may be NULL. </td></tr>
+    <tr><td valign="top"></td><td valign="top"><em>errbuf</em>&nbsp;</td><td>Location to store the error text </td></tr>
+    <tr><td valign="top"></td><td valign="top"><em>errbufsize</em>&nbsp;</td><td>The size of the provided buffer </td></tr>
   </table>
 </dl>
-Quote an XML element <dl compact><dt><b>Parameters:</b></dt><dd>
+<dl class="return" compact><dt><b>Returns:</b></dt><dd>The errbuf parameter, for convenience. </dd></dl>
+
+</div>
+</div><p>
+<a class="anchor" name="g92b8233ccf421b89d2144f834dd6f9a6"></a><!-- doxytag: member="apr_dbm.h::apr_dbm_nextkey" ref="g92b8233ccf421b89d2144f834dd6f9a6" args="(apr_dbm_t *dbm, apr_datum_t *pkey)" -->
+<div class="memitem">
+<div class="memproto">
+      <table class="memname">
+        <tr>
+          <td class="memname"><a class="el" href="group__apr__errno.html#gf76ee4543247e9fb3f3546203e590a6c">apr_status_t</a> apr_dbm_nextkey           </td>
+          <td>(</td>
+          <td class="paramtype"><a class="el" href="structapr__dbm__t.html">apr_dbm_t</a> *&nbsp;</td>
+          <td class="paramname"> <em>dbm</em>, </td>
+        </tr>
+        <tr>
+          <td class="paramkey"></td>
+          <td></td>
+          <td class="paramtype"><a class="el" href="structapr__datum__t.html">apr_datum_t</a> *&nbsp;</td>
+          <td class="paramname"> <em>pkey</em></td><td>&nbsp;</td>
+        </tr>
+        <tr>
+          <td></td>
+          <td>)</td>
+          <td></td><td></td><td></td>
+        </tr>
+      </table>
+</div>
+<div class="memdoc">
+
+<p>
+Retrieve the next record key from a dbm <dl compact><dt><b>Parameters:</b></dt><dd>
   <table border="0" cellspacing="2" cellpadding="0">
-    <tr><td valign="top"></td><td valign="top"><em>p</em>&nbsp;</td><td>The pool to allocate out of </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>elem</em>&nbsp;</td><td>The element to quote </td></tr>
+    <tr><td valign="top"></td><td valign="top"><em>dbm</em>&nbsp;</td><td>The database </td></tr>
+    <tr><td valign="top"></td><td valign="top"><em>pkey</em>&nbsp;</td><td>The key datum of the next record </td></tr>
   </table>
 </dl>
 
 </div>
 </div><p>
-<a class="anchor" name="gc36b022b8ba06c1d966762b73972c090"></a><!-- doxytag: member="apr_dbm.h::APU_DECLARE" ref="gc36b022b8ba06c1d966762b73972c090" args="(apr_status_t) apr_dbm_open_ex(apr_dbm_t **dbm" -->
+<a class="anchor" name="gb2d9cc87f4922ae11a175556ec66e390"></a><!-- doxytag: member="apr_dbm.h::apr_dbm_open" ref="gb2d9cc87f4922ae11a175556ec66e390" args="(apr_dbm_t **dbm, const char *name, apr_int32_t mode, apr_fileperms_t perm, apr_pool_t *cntxt)" -->
 <div class="memitem">
 <div class="memproto">
       <table class="memname">
         <tr>
-          <td class="memname">APU_DECLARE           </td>
+          <td class="memname"><a class="el" href="group__apr__errno.html#gf76ee4543247e9fb3f3546203e590a6c">apr_status_t</a> apr_dbm_open           </td>
           <td>(</td>
-          <td class="paramtype"><a class="el" href="group__apr__errno.html#gf76ee4543247e9fb3f3546203e590a6c">apr_status_t</a>&nbsp;</td>
-          <td class="paramname">          </td>
-          <td>&nbsp;)&nbsp;</td>
+          <td class="paramtype"><a class="el" href="structapr__dbm__t.html">apr_dbm_t</a> **&nbsp;</td>
+          <td class="paramname"> <em>dbm</em>, </td>
+        </tr>
+        <tr>
+          <td class="paramkey"></td>
+          <td></td>
+          <td class="paramtype">const char *&nbsp;</td>
+          <td class="paramname"> <em>name</em>, </td>
+        </tr>
+        <tr>
+          <td class="paramkey"></td>
+          <td></td>
+          <td class="paramtype">apr_int32_t&nbsp;</td>
+          <td class="paramname"> <em>mode</em>, </td>
+        </tr>
+        <tr>
+          <td class="paramkey"></td>
           <td></td>
+          <td class="paramtype"><a class="el" href="group__apr__file__info.html#g3af19c4c47007169064a70f9351bc7d8">apr_fileperms_t</a>&nbsp;</td>
+          <td class="paramname"> <em>perm</em>, </td>
+        </tr>
+        <tr>
+          <td class="paramkey"></td>
+          <td></td>
+          <td class="paramtype"><a class="el" href="group__apr__pools.html#gf137f28edcf9a086cd6bc36c20d7cdfb">apr_pool_t</a> *&nbsp;</td>
+          <td class="paramname"> <em>cntxt</em></td><td>&nbsp;</td>
+        </tr>
+        <tr>
+          <td></td>
+          <td>)</td>
+          <td></td><td></td><td></td>
         </tr>
       </table>
 </div>
 <div class="memdoc">
 
 <p>
-Open a dbm file by file name and type of DBM <dl compact><dt><b>Parameters:</b></dt><dd>
+Open a dbm file by file name <dl compact><dt><b>Parameters:</b></dt><dd>
   <table border="0" cellspacing="2" cellpadding="0">
     <tr><td valign="top"></td><td valign="top"><em>dbm</em>&nbsp;</td><td>The newly opened database </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>type</em>&nbsp;</td><td>The type of the DBM (not all may be available at run time) <pre>
-  db   for Berkeley DB files
-  gdbm for GDBM files
-  ndbm for NDBM files
-  sdbm for SDBM files (always available)
-  default for the default DBM type
-  </pre> </td></tr>
     <tr><td valign="top"></td><td valign="top"><em>name</em>&nbsp;</td><td>The dbm file name to open </td></tr>
     <tr><td valign="top"></td><td valign="top"><em>mode</em>&nbsp;</td><td>The flag value <pre>
            APR_DBM_READONLY   open for read-only access
@@ -406,11 +613,69 @@
   </table>
 </dl>
 <dl class="remark" compact><dt><b>Remarks:</b></dt><dd>The dbm name may not be a true file name, as many dbm packages append suffixes for seperate data and index files. </dd></dl>
-<dl compact><dt><b><a class="el" href="bug.html#_bug000001">Bug:</a></b></dt><dd>In apr-util 0.9 and 1.x, the type arg was case insensitive. This was highly inefficient, and as of 2.x the dbm name must be provided in the correct case (lower case for all bundled providers) </dd></dl>
+
+</div>
+</div><p>
+<a class="anchor" name="gf7295ba8157f487b78319e168e1344b4"></a><!-- doxytag: member="apr_dbm.h::apr_dbm_open_ex" ref="gf7295ba8157f487b78319e168e1344b4" args="(apr_dbm_t **dbm, const char *type, const char *name, apr_int32_t mode, apr_fileperms_t perm, apr_pool_t *cntxt)" -->
+<div class="memitem">
+<div class="memproto">
+      <table class="memname">
+        <tr>
+          <td class="memname"><a class="el" href="group__apr__errno.html#gf76ee4543247e9fb3f3546203e590a6c">apr_status_t</a> apr_dbm_open_ex           </td>
+          <td>(</td>
+          <td class="paramtype"><a class="el" href="structapr__dbm__t.html">apr_dbm_t</a> **&nbsp;</td>
+          <td class="paramname"> <em>dbm</em>, </td>
+        </tr>
+        <tr>
+          <td class="paramkey"></td>
+          <td></td>
+          <td class="paramtype">const char *&nbsp;</td>
+          <td class="paramname"> <em>type</em>, </td>
+        </tr>
+        <tr>
+          <td class="paramkey"></td>
+          <td></td>
+          <td class="paramtype">const char *&nbsp;</td>
+          <td class="paramname"> <em>name</em>, </td>
+        </tr>
+        <tr>
+          <td class="paramkey"></td>
+          <td></td>
+          <td class="paramtype">apr_int32_t&nbsp;</td>
+          <td class="paramname"> <em>mode</em>, </td>
+        </tr>
+        <tr>
+          <td class="paramkey"></td>
+          <td></td>
+          <td class="paramtype"><a class="el" href="group__apr__file__info.html#g3af19c4c47007169064a70f9351bc7d8">apr_fileperms_t</a>&nbsp;</td>
+          <td class="paramname"> <em>perm</em>, </td>
+        </tr>
+        <tr>
+          <td class="paramkey"></td>
+          <td></td>
+          <td class="paramtype"><a class="el" href="group__apr__pools.html#gf137f28edcf9a086cd6bc36c20d7cdfb">apr_pool_t</a> *&nbsp;</td>
+          <td class="paramname"> <em>cntxt</em></td><td>&nbsp;</td>
+        </tr>
+        <tr>
+          <td></td>
+          <td>)</td>
+          <td></td><td></td><td></td>
+        </tr>
+      </table>
+</div>
+<div class="memdoc">
+
 <p>
-Open a dbm file by file name <dl compact><dt><b>Parameters:</b></dt><dd>
+Open a dbm file by file name and type of DBM <dl compact><dt><b>Parameters:</b></dt><dd>
   <table border="0" cellspacing="2" cellpadding="0">
     <tr><td valign="top"></td><td valign="top"><em>dbm</em>&nbsp;</td><td>The newly opened database </td></tr>
+    <tr><td valign="top"></td><td valign="top"><em>type</em>&nbsp;</td><td>The type of the DBM (not all may be available at run time) <pre>
+  db   for Berkeley DB files
+  gdbm for GDBM files
+  ndbm for NDBM files
+  sdbm for SDBM files (always available)
+  default for the default DBM type
+  </pre> </td></tr>
     <tr><td valign="top"></td><td valign="top"><em>name</em>&nbsp;</td><td>The dbm file name to open </td></tr>
     <tr><td valign="top"></td><td valign="top"><em>mode</em>&nbsp;</td><td>The flag value <pre>
            APR_DBM_READONLY   open for read-only access
@@ -422,67 +687,55 @@
     <tr><td valign="top"></td><td valign="top"><em>cntxt</em>&nbsp;</td><td>The pool to use when creating the dbm </td></tr>
   </table>
 </dl>
-<dl class="remark" compact><dt><b>Remarks:</b></dt><dd>The dbm name may not be a true file name, as many dbm packages append suffixes for seperate data and index files.</dd></dl>
-Fetch a dbm record value by key <dl compact><dt><b>Parameters:</b></dt><dd>
-  <table border="0" cellspacing="2" cellpadding="0">
-    <tr><td valign="top"></td><td valign="top"><em>dbm</em>&nbsp;</td><td>The database </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>key</em>&nbsp;</td><td>The key datum to find this record </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>pvalue</em>&nbsp;</td><td>The value datum retrieved for this record</td></tr>
-  </table>
-</dl>
+<dl class="remark" compact><dt><b>Remarks:</b></dt><dd>The dbm name may not be a true file name, as many dbm packages append suffixes for seperate data and index files. </dd></dl>
+<dl compact><dt><b><a class="el" href="bug.html#_bug000001">Bug:</a></b></dt><dd>In apr-util 0.9 and 1.x, the type arg was case insensitive. This was highly inefficient, and as of 2.x the dbm name must be provided in the correct case (lower case for all bundled providers) </dd></dl>
+
+</div>
+</div><p>
+<a class="anchor" name="g014a6acf6f86aaac5fc44af5b8951051"></a><!-- doxytag: member="apr_dbm.h::apr_dbm_store" ref="g014a6acf6f86aaac5fc44af5b8951051" args="(apr_dbm_t *dbm, apr_datum_t key, apr_datum_t value)" -->
+<div class="memitem">
+<div class="memproto">
+      <table class="memname">
+        <tr>
+          <td class="memname"><a class="el" href="group__apr__errno.html#gf76ee4543247e9fb3f3546203e590a6c">apr_status_t</a> apr_dbm_store           </td>
+          <td>(</td>
+          <td class="paramtype"><a class="el" href="structapr__dbm__t.html">apr_dbm_t</a> *&nbsp;</td>
+          <td class="paramname"> <em>dbm</em>, </td>
+        </tr>
+        <tr>
+          <td class="paramkey"></td>
+          <td></td>
+          <td class="paramtype"><a class="el" href="structapr__datum__t.html">apr_datum_t</a>&nbsp;</td>
+          <td class="paramname"> <em>key</em>, </td>
+        </tr>
+        <tr>
+          <td class="paramkey"></td>
+          <td></td>
+          <td class="paramtype"><a class="el" href="structapr__datum__t.html">apr_datum_t</a>&nbsp;</td>
+          <td class="paramname"> <em>value</em></td><td>&nbsp;</td>
+        </tr>
+        <tr>
+          <td></td>
+          <td>)</td>
+          <td></td><td></td><td></td>
+        </tr>
+      </table>
+</div>
+<div class="memdoc">
+
+<p>
 Store a dbm record value by key <dl compact><dt><b>Parameters:</b></dt><dd>
   <table border="0" cellspacing="2" cellpadding="0">
     <tr><td valign="top"></td><td valign="top"><em>dbm</em>&nbsp;</td><td>The database </td></tr>
     <tr><td valign="top"></td><td valign="top"><em>key</em>&nbsp;</td><td>The key datum to store this record by </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>value</em>&nbsp;</td><td>The value datum to store in this record</td></tr>
-  </table>
-</dl>
-Delete a dbm record value by key <dl compact><dt><b>Parameters:</b></dt><dd>
-  <table border="0" cellspacing="2" cellpadding="0">
-    <tr><td valign="top"></td><td valign="top"><em>dbm</em>&nbsp;</td><td>The database </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>key</em>&nbsp;</td><td>The key datum of the record to delete </td></tr>
-  </table>
-</dl>
-<dl class="remark" compact><dt><b>Remarks:</b></dt><dd>It is not an error to delete a non-existent record.</dd></dl>
-Search for a key within the dbm <dl compact><dt><b>Parameters:</b></dt><dd>
-  <table border="0" cellspacing="2" cellpadding="0">
-    <tr><td valign="top"></td><td valign="top"><em>dbm</em>&nbsp;</td><td>The database </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>key</em>&nbsp;</td><td>The datum describing a key to test</td></tr>
+    <tr><td valign="top"></td><td valign="top"><em>value</em>&nbsp;</td><td>The value datum to store in this record </td></tr>
   </table>
 </dl>
-Retrieve the first record key from a dbm <dl compact><dt><b>Parameters:</b></dt><dd>
-  <table border="0" cellspacing="2" cellpadding="0">
-    <tr><td valign="top"></td><td valign="top"><em>dbm</em>&nbsp;</td><td>The database </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>pkey</em>&nbsp;</td><td>The key datum of the first record</td></tr>
-  </table>
-</dl>
-Retrieve the next record key from a dbm <dl compact><dt><b>Parameters:</b></dt><dd>
-  <table border="0" cellspacing="2" cellpadding="0">
-    <tr><td valign="top"></td><td valign="top"><em>dbm</em>&nbsp;</td><td>The database </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>pkey</em>&nbsp;</td><td>The key datum of the next record</td></tr>
-  </table>
-</dl>
-If the specified file/path were passed to apr_dbm_open(), return the actual file/path names which would be (created and) used. At most, two files may be used; used2 may be NULL if only one file is used. <dl compact><dt><b>Parameters:</b></dt><dd>
-  <table border="0" cellspacing="2" cellpadding="0">
-    <tr><td valign="top"></td><td valign="top"><em>pool</em>&nbsp;</td><td>The pool for allocating used1 and used2. </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>type</em>&nbsp;</td><td>The type of DBM you require info on </td></tr>
-  </table>
-</dl>
-<dl class="see" compact><dt><b>See also:</b></dt><dd>apr_dbm_open_ex </dd></dl>
-<dl compact><dt><b>Parameters:</b></dt><dd>
-  <table border="0" cellspacing="2" cellpadding="0">
-    <tr><td valign="top"></td><td valign="top"><em>pathname</em>&nbsp;</td><td>The path name to generate used-names from. </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>used1</em>&nbsp;</td><td>The first pathname used by the apr_dbm implementation. </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>used2</em>&nbsp;</td><td>The second pathname used by apr_dbm. If only one file is used by the specific implementation, this will be set to NULL. </td></tr>
-  </table>
-</dl>
-<dl class="return" compact><dt><b>Returns:</b></dt><dd>An error if the specified type is invalid. </dd></dl>
-<dl class="remark" compact><dt><b>Remarks:</b></dt><dd>The dbm file(s) don't need to exist. This function only manipulates the pathnames. </dd></dl>
 
 </div>
 </div><p>
 </div>
-<hr size="1"><address style="text-align: right;"><small>Generated on Mon Jun 15 09:45:29 2009 for Apache Portable Runtime by&nbsp;
+<hr size="1"><address style="text-align: right;"><small>Generated on Thu Jul 16 13:37:23 2009 for Apache Portable Runtime by&nbsp;
 <a href="http://www.doxygen.org/index.html">
 <img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.8 </small></address>
 </body>



Mime
View raw message