apr-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From bo...@apache.org
Subject svn commit: r794511 [16/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___base64.html
URL: http://svn.apache.org/viewvc/apr/site/trunk/docs/docs/apr/trunk/group___a_p_r___util___base64.html?rev=794511&r1=794510&r2=794511&view=diff
==============================================================================
--- apr/site/trunk/docs/docs/apr/trunk/group___a_p_r___util___base64.html (original)
+++ apr/site/trunk/docs/docs/apr/trunk/group___a_p_r___util___base64.html Thu Jul 16 03:44:20 2009
@@ -25,1533 +25,232 @@
 </h1><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">&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___base64.html#gf43a293bb29d7041e6c85e90b967715f">APU_DECLARE</a> (int) apr_base64_encode_len(int len)</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___base64.html#g5dad9df13a7018e3946a54c8d2c27ae9">apr_base64_encode_len</a> (int len)</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="g4cb0359205d009041bb10a3a24ad47a5"></a><!-- doxytag: member="APR_Util_Base64::plain_src" ref="g4cb0359205d009041bb10a3a24ad47a5" args="" -->
-const char *&nbsp;</td><td class="memItemRight" valign="bottom"><b>plain_src</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___base64.html#g6176124b05512773de40cc5e899058b9">apr_base64_encode</a> (char *coded_dst, const char *plain_src, int len_plain_src)</td></tr>
 
-<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="g23d56ef91e6602387e96a5ae6b3bd7d4"></a><!-- doxytag: member="APR_Util_Base64::len_plain_src" ref="g23d56ef91e6602387e96a5ae6b3bd7d4" args="" -->
-const char int&nbsp;</td><td class="memItemRight" valign="bottom"><b>len_plain_src</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___base64.html#ge7480ce6b723e71cf91583217d96f1d7">apr_base64_encode_binary</a> (char *coded_dst, const unsigned char *plain_src, int len_plain_src)</td></tr>
 
-<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="g08926cbeac2cf20ecb41b19c6c5ee914"></a><!-- doxytag: member="APR_Util_Base64::coded_src" ref="g08926cbeac2cf20ecb41b19c6c5ee914" args="" -->
-const char *&nbsp;</td><td class="memItemRight" valign="bottom"><b>coded_src</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___base64.html#gd1ba714a6708376e6a21722a40a698a2">apr_base64_decode_len</a> (const char *coded_src)</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___base64.html#g1f717903883e7405c2a0d0ec5814f865">apr_base64_decode</a> (char *plain_dst, const char *coded_src)</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___base64.html#g3d8f1517351d8b7a18b8396642b98975">apr_base64_decode_binary</a> (unsigned char *plain_dst, const char *coded_src)</td></tr>
 
 </table>
 <hr><h2>Function Documentation</h2>
-<a class="anchor" name="gf43a293bb29d7041e6c85e90b967715f"></a><!-- doxytag: member="apr_base64.h::APU_DECLARE" ref="gf43a293bb29d7041e6c85e90b967715f" args="(int) apr_base64_encode_len(int len)" -->
+<a class="anchor" name="g1f717903883e7405c2a0d0ec5814f865"></a><!-- doxytag: member="apr_base64.h::apr_base64_decode" ref="g1f717903883e7405c2a0d0ec5814f865" args="(char *plain_dst, const char *coded_src)" -->
 <div class="memitem">
 <div class="memproto">
       <table class="memname">
         <tr>
-          <td class="memname">APU_DECLARE           </td>
+          <td class="memname">int apr_base64_decode           </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">char *&nbsp;</td>
+          <td class="paramname"> <em>plain_dst</em>, </td>
+        </tr>
+        <tr>
+          <td class="paramkey"></td>
+          <td></td>
+          <td class="paramtype">const char *&nbsp;</td>
+          <td class="paramname"> <em>coded_src</em></td><td>&nbsp;</td>
+        </tr>
+        <tr>
           <td></td>
+          <td>)</td>
+          <td></td><td></td><td></td>
         </tr>
       </table>
 </div>
 <div class="memdoc">
 
 <p>
-Given the length of an un-encrypted string, get the length of the encrypted string. <dl compact><dt><b>Parameters:</b></dt><dd>
-  <table border="0" cellspacing="2" cellpadding="0">
-    <tr><td valign="top"></td><td valign="top"><em>len</em>&nbsp;</td><td>the length of an unencrypted string. </td></tr>
-  </table>
-</dl>
-<dl class="return" compact><dt><b>Returns:</b></dt><dd>the length of the string after it is encrypted</dd></dl>
-Encode a text string using base64encoding. <dl compact><dt><b>Parameters:</b></dt><dd>
-  <table border="0" cellspacing="2" cellpadding="0">
-    <tr><td valign="top"></td><td valign="top"><em>coded_dst</em>&nbsp;</td><td>The destination string for the encoded string. </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>plain_src</em>&nbsp;</td><td>The original string in plain text </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>len_plain_src</em>&nbsp;</td><td>The length of the plain text string </td></tr>
-  </table>
-</dl>
-<dl class="return" compact><dt><b>Returns:</b></dt><dd>the length of the encoded string</dd></dl>
-Encode an EBCDIC string using base64encoding. <dl compact><dt><b>Parameters:</b></dt><dd>
-  <table border="0" cellspacing="2" cellpadding="0">
-    <tr><td valign="top"></td><td valign="top"><em>coded_dst</em>&nbsp;</td><td>The destination string for the encoded string. </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>plain_src</em>&nbsp;</td><td>The original string in plain text </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>len_plain_src</em>&nbsp;</td><td>The length of the plain text string </td></tr>
-  </table>
-</dl>
-<dl class="return" compact><dt><b>Returns:</b></dt><dd>the length of the encoded string</dd></dl>
-Determine the maximum buffer length required to decode the plain text string given the encoded string. <dl compact><dt><b>Parameters:</b></dt><dd>
-  <table border="0" cellspacing="2" cellpadding="0">
-    <tr><td valign="top"></td><td valign="top"><em>coded_src</em>&nbsp;</td><td>The encoded string </td></tr>
-  </table>
-</dl>
-<dl class="return" compact><dt><b>Returns:</b></dt><dd>the maximum required buffer length for the plain text string</dd></dl>
 Decode a string to plain 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>plain_dst</em>&nbsp;</td><td>The destination string for the plain text </td></tr>
     <tr><td valign="top"></td><td valign="top"><em>coded_src</em>&nbsp;</td><td>The encoded string </td></tr>
   </table>
 </dl>
-<dl class="return" compact><dt><b>Returns:</b></dt><dd>the length of the plain text string</dd></dl>
+<dl class="return" compact><dt><b>Returns:</b></dt><dd>the length of the plain text string </dd></dl>
+
+</div>
+</div><p>
+<a class="anchor" name="g3d8f1517351d8b7a18b8396642b98975"></a><!-- doxytag: member="apr_base64.h::apr_base64_decode_binary" ref="g3d8f1517351d8b7a18b8396642b98975" args="(unsigned char *plain_dst, const char *coded_src)" -->
+<div class="memitem">
+<div class="memproto">
+      <table class="memname">
+        <tr>
+          <td class="memname">int apr_base64_decode_binary           </td>
+          <td>(</td>
+          <td class="paramtype">unsigned char *&nbsp;</td>
+          <td class="paramname"> <em>plain_dst</em>, </td>
+        </tr>
+        <tr>
+          <td class="paramkey"></td>
+          <td></td>
+          <td class="paramtype">const char *&nbsp;</td>
+          <td class="paramname"> <em>coded_src</em></td><td>&nbsp;</td>
+        </tr>
+        <tr>
+          <td></td>
+          <td>)</td>
+          <td></td><td></td><td></td>
+        </tr>
+      </table>
+</div>
+<div class="memdoc">
+
+<p>
 Decode an EBCDIC string to plain 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>plain_dst</em>&nbsp;</td><td>The destination string for the plain text </td></tr>
     <tr><td valign="top"></td><td valign="top"><em>coded_src</em>&nbsp;</td><td>The encoded string </td></tr>
   </table>
 </dl>
-<dl class="return" compact><dt><b>Returns:</b></dt><dd>the length of the plain text string</dd></dl>
-empty out an entire bucket brigade. This includes destroying all of the buckets within the bucket brigade's bucket list. This is similar to apr_brigade_destroy(), except that it does not deregister the brigade's pool cleanup function. <dl compact><dt><b>Parameters:</b></dt><dd>
-  <table border="0" cellspacing="2" cellpadding="0">
-    <tr><td valign="top"></td><td valign="top"><em>data</em>&nbsp;</td><td>The bucket brigade to clean up </td></tr>
-  </table>
-</dl>
-<dl class="remark" compact><dt><b>Remarks:</b></dt><dd>Generally, you should use apr_brigade_destroy(). This function can be useful in situations where you have a single brigade that you wish to reuse many times by destroying all of the buckets in the brigade and putting new buckets into it later.</dd></dl>
-Partition a bucket brigade at a given offset (in bytes from the start of the brigade). This is useful whenever a filter wants to use known ranges of bytes from the brigade; the ranges can even overlap. <dl compact><dt><b>Parameters:</b></dt><dd>
-  <table border="0" cellspacing="2" cellpadding="0">
-    <tr><td valign="top"></td><td valign="top"><em>b</em>&nbsp;</td><td>The brigade to partition </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>point</em>&nbsp;</td><td>The offset at which to partition the brigade </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>after_point</em>&nbsp;</td><td>Returns a pointer to the first bucket after the partition </td></tr>
-  </table>
-</dl>
-<dl class="return" compact><dt><b>Returns:</b></dt><dd>APR_SUCCESS on success, APR_INCOMPLETE if the contents of the brigade were shorter than <em>point</em>, or an error code. </dd></dl>
-<dl class="remark" compact><dt><b>Remarks:</b></dt><dd>if APR_INCOMPLETE is returned, <em>after_point</em> will be set to the brigade sentinel.</dd></dl>
-Return the total length of the brigade. <dl compact><dt><b>Parameters:</b></dt><dd>
-  <table border="0" cellspacing="2" cellpadding="0">
-    <tr><td valign="top"></td><td valign="top"><em>bb</em>&nbsp;</td><td>The brigade to compute the length of </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>read_all</em>&nbsp;</td><td>Read unknown-length buckets to force a size </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>length</em>&nbsp;</td><td>Returns the length of the brigade (up to the end, or up to a bucket read error), or -1 if the brigade has buckets of indeterminate length and read_all is 0.</td></tr>
-  </table>
-</dl>
-Take a bucket brigade and store the data in a flat char* <dl compact><dt><b>Parameters:</b></dt><dd>
-  <table border="0" cellspacing="2" cellpadding="0">
-    <tr><td valign="top"></td><td valign="top"><em>bb</em>&nbsp;</td><td>The bucket brigade to create the char* from </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>c</em>&nbsp;</td><td>The char* to write into </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>len</em>&nbsp;</td><td>The maximum length of the char array. On return, it is the actual length of the char array.</td></tr>
-  </table>
-</dl>
-Creates a pool-allocated string representing a flat bucket brigade <dl compact><dt><b>Parameters:</b></dt><dd>
-  <table border="0" cellspacing="2" cellpadding="0">
-    <tr><td valign="top"></td><td valign="top"><em>bb</em>&nbsp;</td><td>The bucket brigade to create the char array from </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>c</em>&nbsp;</td><td>On return, the allocated char array </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>len</em>&nbsp;</td><td>On return, the length of the char array. </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>pool</em>&nbsp;</td><td>The pool to allocate the string from.</td></tr>
-  </table>
-</dl>
-Split a brigade to represent one LF line. <dl compact><dt><b>Parameters:</b></dt><dd>
-  <table border="0" cellspacing="2" cellpadding="0">
-    <tr><td valign="top"></td><td valign="top"><em>bbOut</em>&nbsp;</td><td>The bucket brigade that will have the LF line appended to. </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>bbIn</em>&nbsp;</td><td>The input bucket brigade to search for a LF-line. </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>block</em>&nbsp;</td><td>The blocking mode to be used to split the line. </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>maxbytes</em>&nbsp;</td><td>The maximum bytes to read. If this many bytes are seen without a LF, the brigade will contain a partial line.</td></tr>
-  </table>
-</dl>
-create an iovec of the elements in a bucket_brigade... return number of elements used. This is useful for writing to a file or to the network efficiently. <dl compact><dt><b>Parameters:</b></dt><dd>
-  <table border="0" cellspacing="2" cellpadding="0">
-    <tr><td valign="top"></td><td valign="top"><em>b</em>&nbsp;</td><td>The bucket brigade to create the iovec from </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>vec</em>&nbsp;</td><td>The iovec to create </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>nvec</em>&nbsp;</td><td>The number of elements in the iovec. On return, it is the number of iovec elements actually filled out.</td></tr>
-  </table>
-</dl>
-This function writes a list of strings into a bucket brigade. <dl compact><dt><b>Parameters:</b></dt><dd>
-  <table border="0" cellspacing="2" cellpadding="0">
-    <tr><td valign="top"></td><td valign="top"><em>b</em>&nbsp;</td><td>The bucket brigade to add to </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>flush</em>&nbsp;</td><td>The flush function to use if the brigade is full </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>ctx</em>&nbsp;</td><td>The structure to pass to the flush function </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>va</em>&nbsp;</td><td>A list of strings to add </td></tr>
-  </table>
-</dl>
-<dl class="return" compact><dt><b>Returns:</b></dt><dd>APR_SUCCESS or error code.</dd></dl>
-This function writes a string into a bucket brigade.<p>
-The apr_brigade_write function attempts to be efficient with the handling of heap buckets. Regardless of the amount of data stored inside a heap bucket, heap buckets are a fixed size to promote their reuse.<p>
-If an attempt is made to write a string to a brigade that already ends with a heap bucket, this function will attempt to pack the string into the remaining space in the previous heap bucket, before allocating a new heap bucket.<p>
-This function always returns APR_SUCCESS, unless a flush function is passed, in which case the return value of the flush function will be returned if 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>b</em>&nbsp;</td><td>The bucket brigade to add to </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>flush</em>&nbsp;</td><td>The flush function to use if the brigade is full </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>ctx</em>&nbsp;</td><td>The structure to pass to the flush function </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>str</em>&nbsp;</td><td>The string to add </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>nbyte</em>&nbsp;</td><td>The number of bytes to write </td></tr>
-  </table>
-</dl>
-<dl class="return" compact><dt><b>Returns:</b></dt><dd>APR_SUCCESS or error code</dd></dl>
-This function writes multiple strings into a bucket brigade. <dl compact><dt><b>Parameters:</b></dt><dd>
-  <table border="0" cellspacing="2" cellpadding="0">
-    <tr><td valign="top"></td><td valign="top"><em>b</em>&nbsp;</td><td>The bucket brigade to add to </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>flush</em>&nbsp;</td><td>The flush function to use if the brigade is full </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>ctx</em>&nbsp;</td><td>The structure to pass to the flush function </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>vec</em>&nbsp;</td><td>The strings to add (address plus length for each) </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>nvec</em>&nbsp;</td><td>The number of entries in iovec </td></tr>
-  </table>
-</dl>
-<dl class="return" compact><dt><b>Returns:</b></dt><dd>APR_SUCCESS or error code</dd></dl>
-This function writes a string into a bucket brigade. <dl compact><dt><b>Parameters:</b></dt><dd>
-  <table border="0" cellspacing="2" cellpadding="0">
-    <tr><td valign="top"></td><td valign="top"><em>bb</em>&nbsp;</td><td>The bucket brigade to add to </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>flush</em>&nbsp;</td><td>The flush function to use if the brigade is full </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>ctx</em>&nbsp;</td><td>The structure to pass to the flush function </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>str</em>&nbsp;</td><td>The string to add </td></tr>
-  </table>
-</dl>
-<dl class="return" compact><dt><b>Returns:</b></dt><dd>APR_SUCCESS or error code</dd></dl>
-This function writes a character into a bucket brigade. <dl compact><dt><b>Parameters:</b></dt><dd>
-  <table border="0" cellspacing="2" cellpadding="0">
-    <tr><td valign="top"></td><td valign="top"><em>b</em>&nbsp;</td><td>The bucket brigade to add to </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>flush</em>&nbsp;</td><td>The flush function to use if the brigade is full </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>ctx</em>&nbsp;</td><td>The structure to pass to the flush function </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>c</em>&nbsp;</td><td>The character to add </td></tr>
-  </table>
-</dl>
-<dl class="return" compact><dt><b>Returns:</b></dt><dd>APR_SUCCESS or error code</dd></dl>
-Evaluate a printf and put the resulting string at the end of the bucket brigade. <dl compact><dt><b>Parameters:</b></dt><dd>
-  <table border="0" cellspacing="2" cellpadding="0">
-    <tr><td valign="top"></td><td valign="top"><em>b</em>&nbsp;</td><td>The brigade to write to </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>flush</em>&nbsp;</td><td>The flush function to use if the brigade is full </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>ctx</em>&nbsp;</td><td>The structure to pass to the flush function </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>fmt</em>&nbsp;</td><td>The format of the string to write </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>va</em>&nbsp;</td><td>The arguments to fill out the format </td></tr>
-  </table>
-</dl>
-<dl class="return" compact><dt><b>Returns:</b></dt><dd>APR_SUCCESS or error code</dd></dl>
-Decrement the refcount of the data in the bucket. This function should only be called by type-specific bucket destruction functions. <dl compact><dt><b>Parameters:</b></dt><dd>
-  <table border="0" cellspacing="2" cellpadding="0">
-    <tr><td valign="top"></td><td valign="top"><em>data</em>&nbsp;</td><td>The private data pointer from the bucket to be destroyed </td></tr>
-  </table>
-</dl>
-<dl class="return" compact><dt><b>Returns:</b></dt><dd>TRUE or FALSE; TRUE if the reference count is now zero, indicating that the shared resource itself can be destroyed by the caller.</dd></dl>
-Enable or disable memory-mapping for a FILE bucket (default is enabled) <dl compact><dt><b>Parameters:</b></dt><dd>
-  <table border="0" cellspacing="2" cellpadding="0">
-    <tr><td valign="top"></td><td valign="top"><em>b</em>&nbsp;</td><td>The bucket </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>enabled</em>&nbsp;</td><td>Whether memory-mapping should be enabled </td></tr>
-  </table>
-</dl>
-<dl class="return" compact><dt><b>Returns:</b></dt><dd>APR_SUCCESS normally, or an error code if the operation fails</dd></dl>
-apr_dbd_get_driver: get the driver struct for a name<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>pool</em>&nbsp;</td><td>- (process) pool to register cleanup </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>name</em>&nbsp;</td><td>- driver name </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>driver</em>&nbsp;</td><td>- pointer to driver struct. </td></tr>
-  </table>
-</dl>
-<dl class="return" compact><dt><b>Returns:</b></dt><dd>APR_SUCCESS for success <p>
-APR_ENOTIMPL for no driver (when DSO not enabled) <p>
-APR_EDSOOPEN if DSO driver file can't be opened <p>
-APR_ESYMNOTFOUND if the driver file doesn't contain a driver</dd></dl>
-apr_dbd_open_ex: open a connection to a backend<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>pool</em>&nbsp;</td><td>- working pool </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>params</em>&nbsp;</td><td>- arguments to driver (implementation-dependent) </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>handle</em>&nbsp;</td><td>- pointer to handle to return </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>driver</em>&nbsp;</td><td>- driver struct. </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>error</em>&nbsp;</td><td>- descriptive error. </td></tr>
-  </table>
-</dl>
-<dl class="return" compact><dt><b>Returns:</b></dt><dd>APR_SUCCESS for success <p>
-APR_EGENERAL if driver exists but connection failed </dd></dl>
-<dl class="remark" compact><dt><b>Remarks:</b></dt><dd>PostgreSQL: the params is passed directly to the PQconnectdb() function (check PostgreSQL documentation for more details on the syntax). <p>
-SQLite2: the params is split on a colon, with the first part used as the filename and second part converted to an integer and used as file mode. <p>
-SQLite3: the params is passed directly to the sqlite3_open() function as a filename to be opened (check SQLite3 documentation for more details). <p>
-Oracle: the params can have "user", "pass", "dbname" and "server" keys, each followed by an equal sign and a value. Such key/value pairs can be delimited by space, CR, LF, tab, semicolon, vertical bar or comma. <p>
-MySQL: the params can have "host", "port", "user", "pass", "dbname", "sock", "flags" "fldsz", "group" and "reconnect" keys, each followed by an equal sign and a value. Such key/value pairs can be delimited by space, CR, LF, tab, semicolon, vertical bar or comma. For now, "flags" can only recognise CLIENT_FOUND_ROWS (check MySQL manual for details). The value associated with "fldsz" determines maximum amount of memory (in bytes) for each of the fields in the result set of prepared statements. By default, this value is 1 MB. The value associated with "group" determines which group from configuration file to use (see MYSQL_READ_DEFAULT_GROUP option of mysql_options() in MySQL manual). Reconnect is set to 1 by default (i.e. true). <p>
-FreeTDS: the params can have "username", "password", "appname", "dbname", "host", "charset", "lang" and "server" keys, each followed by an equal sign and a value.</dd></dl>
-apr_dbd_open: open a connection to a backend<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>pool</em>&nbsp;</td><td>- working pool </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>params</em>&nbsp;</td><td>- arguments to driver (implementation-dependent) </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>handle</em>&nbsp;</td><td>- pointer to handle to return </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>driver</em>&nbsp;</td><td>- driver struct. </td></tr>
-  </table>
-</dl>
-<dl class="return" compact><dt><b>Returns:</b></dt><dd>APR_SUCCESS for success <p>
-APR_EGENERAL if driver exists but connection failed </dd></dl>
-<dl class="see" compact><dt><b>See also:</b></dt><dd>apr_dbd_open_ex</dd></dl>
-apr_dbd_close: close a connection to a backend<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>handle</em>&nbsp;</td><td>- handle to close </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>driver</em>&nbsp;</td><td>- driver struct. </td></tr>
-  </table>
-</dl>
-<dl class="return" compact><dt><b>Returns:</b></dt><dd>APR_SUCCESS for success or error status</dd></dl>
-check_conn: check status of a database connection<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>driver</em>&nbsp;</td><td>- the driver </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>pool</em>&nbsp;</td><td>- working pool </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>handle</em>&nbsp;</td><td>- the connection to check </td></tr>
-  </table>
-</dl>
-<dl class="return" compact><dt><b>Returns:</b></dt><dd>APR_SUCCESS or error</dd></dl>
-apr_dbd_set_dbname: select database name. May be a no-op if not supported.<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>driver</em>&nbsp;</td><td>- the driver </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>pool</em>&nbsp;</td><td>- working pool </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>handle</em>&nbsp;</td><td>- the connection </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>name</em>&nbsp;</td><td>- the database to select </td></tr>
-  </table>
-</dl>
-<dl class="return" compact><dt><b>Returns:</b></dt><dd>0 for success or error code</dd></dl>
-apr_dbd_transaction_start: start a transaction. May be a no-op.<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>driver</em>&nbsp;</td><td>- the driver </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>pool</em>&nbsp;</td><td>- a pool to use for error messages (if any). </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>handle</em>&nbsp;</td><td>- the db connection </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>trans</em>&nbsp;</td><td>- ptr to a transaction. May be null on entry </td></tr>
-  </table>
-</dl>
-<dl class="return" compact><dt><b>Returns:</b></dt><dd>0 for success or error code </dd></dl>
-<dl class="remark" compact><dt><b>Remarks:</b></dt><dd>Note that transaction modes, set by calling apr_dbd_transaction_mode_set(), will affect all query/select calls within a transaction. By default, any error in query/select during a transaction will cause the transaction to inherit the error code and any further query/select calls will fail immediately. Put transaction in "ignore errors" mode to avoid that. Use "rollback" mode to do explicit rollback.</dd></dl>
-apr_dbd_transaction_end: end a transaction (commit on success, rollback on error). May be a no-op.<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>driver</em>&nbsp;</td><td>- the driver </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>handle</em>&nbsp;</td><td>- the db connection </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>trans</em>&nbsp;</td><td>- the transaction. </td></tr>
-  </table>
-</dl>
-<dl class="return" compact><dt><b>Returns:</b></dt><dd>0 for success or error code</dd></dl>
-apr_dbd_transaction_mode_get: get the mode of transaction<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>driver</em>&nbsp;</td><td>- the driver </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>trans</em>&nbsp;</td><td>- the transaction </td></tr>
-  </table>
-</dl>
-<dl class="return" compact><dt><b>Returns:</b></dt><dd>mode of transaction</dd></dl>
-apr_dbd_transaction_mode_set: set the mode of transaction<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>driver</em>&nbsp;</td><td>- the driver </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>trans</em>&nbsp;</td><td>- the transaction </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>mode</em>&nbsp;</td><td>- new mode of the transaction </td></tr>
-  </table>
-</dl>
-<dl class="return" compact><dt><b>Returns:</b></dt><dd>the mode of transaction in force after the call</dd></dl>
-apr_dbd_query: execute an SQL query that doesn't return a result set<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>driver</em>&nbsp;</td><td>- the driver </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>handle</em>&nbsp;</td><td>- the connection </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>nrows</em>&nbsp;</td><td>- number of rows affected. </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>statement</em>&nbsp;</td><td>- the SQL statement to execute </td></tr>
-  </table>
-</dl>
-<dl class="return" compact><dt><b>Returns:</b></dt><dd>0 for success or error code</dd></dl>
-apr_dbd_select: execute an SQL query that returns a result set<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>driver</em>&nbsp;</td><td>- the driver </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>pool</em>&nbsp;</td><td>- pool to allocate the result set </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>handle</em>&nbsp;</td><td>- the connection </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>res</em>&nbsp;</td><td>- pointer to result set pointer. May point to NULL on entry </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>statement</em>&nbsp;</td><td>- the SQL statement to execute </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>random</em>&nbsp;</td><td>- 1 to support random access to results (seek any row); 0 to support only looping through results in order (async access - faster) </td></tr>
-  </table>
-</dl>
-<dl class="return" compact><dt><b>Returns:</b></dt><dd>0 for success or error code</dd></dl>
-apr_dbd_num_cols: get the number of columns in a results set<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>driver</em>&nbsp;</td><td>- the driver </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>res</em>&nbsp;</td><td>- result set. </td></tr>
-  </table>
-</dl>
-<dl class="return" compact><dt><b>Returns:</b></dt><dd>number of columns</dd></dl>
-apr_dbd_num_tuples: get the number of rows in a results set of a synchronous select<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>driver</em>&nbsp;</td><td>- the driver </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>res</em>&nbsp;</td><td>- result set. </td></tr>
-  </table>
-</dl>
-<dl class="return" compact><dt><b>Returns:</b></dt><dd>number of rows, or -1 if the results are asynchronous</dd></dl>
-apr_dbd_get_row: get a row from a result set<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>driver</em>&nbsp;</td><td>- the driver </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>pool</em>&nbsp;</td><td>- pool to allocate the row </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>res</em>&nbsp;</td><td>- result set pointer </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>row</em>&nbsp;</td><td>- pointer to row pointer. May point to NULL on entry </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>rownum</em>&nbsp;</td><td>- row number (counting from 1), or -1 for "next row". Ignored if random access is not supported. </td></tr>
-  </table>
-</dl>
-<dl class="return" compact><dt><b>Returns:</b></dt><dd>0 for success, -1 for rownum out of range or data finished</dd></dl>
-apr_dbd_prepare: prepare a statement<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>driver</em>&nbsp;</td><td>- the driver </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>pool</em>&nbsp;</td><td>- pool to alloc the result from </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>handle</em>&nbsp;</td><td>- the connection </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>query</em>&nbsp;</td><td>- the SQL query </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>label</em>&nbsp;</td><td>- A label for the prepared statement. use NULL for temporary prepared statements (eg within a Request in httpd) </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>statement</em>&nbsp;</td><td>- statement to prepare. May point to null on entry. </td></tr>
-  </table>
-</dl>
-<dl class="return" compact><dt><b>Returns:</b></dt><dd>0 for success or error code </dd></dl>
-<dl class="remark" compact><dt><b>Remarks:</b></dt><dd>To specify parameters of the prepared query, use %s, %d etc. (see below for full list) in place of database specific parameter syntax (e.g. for PostgreSQL, this would be $1, $2, for SQLite3 this would be ? etc.). For instance: "SELECT name FROM customers WHERE name=%s" would be a query that this function understands. <p>
-Here is the full list of format specifiers that this function understands and what they map to in SQL: %hhd (TINY INT), %hhu (UNSIGNED TINY INT), %hd (SHORT), %hu (UNSIGNED SHORT), %d (INT), %u (UNSIGNED INT), %ld (LONG), %lu (UNSIGNED LONG), %lld (LONG LONG), %llu (UNSIGNED LONG LONG), %f (FLOAT, REAL), %lf (DOUBLE PRECISION), %s (VARCHAR), %pDt (TEXT), %pDi (TIME), %pDd (DATE), %pDa (DATETIME), %pDs (TIMESTAMP), %pDz (TIMESTAMP WITH TIME ZONE), %pDb (BLOB), %pDc (CLOB) and %pDn (NULL). Not all databases have support for all these types, so the underlying driver will attempt the "best match" where possible. A % followed by any letter not in the above list will be interpreted as VARCHAR (i.e. %s).</dd></dl>
-apr_dbd_pquery: query using a prepared statement + args<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>driver</em>&nbsp;</td><td>- the driver </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>pool</em>&nbsp;</td><td>- working pool </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>handle</em>&nbsp;</td><td>- the connection </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>nrows</em>&nbsp;</td><td>- number of rows affected. </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>statement</em>&nbsp;</td><td>- the prepared statement to execute </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>nargs</em>&nbsp;</td><td>- ignored (for backward compatibility only) </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>args</em>&nbsp;</td><td>- args to prepared statement </td></tr>
-  </table>
-</dl>
-<dl class="return" compact><dt><b>Returns:</b></dt><dd>0 for success or error code</dd></dl>
-apr_dbd_pselect: select using a prepared statement + args<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>driver</em>&nbsp;</td><td>- the driver </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>pool</em>&nbsp;</td><td>- working pool </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>handle</em>&nbsp;</td><td>- the connection </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>res</em>&nbsp;</td><td>- pointer to query results. May point to NULL on entry </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>statement</em>&nbsp;</td><td>- the prepared statement to execute </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>random</em>&nbsp;</td><td>- Whether to support random-access to results </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>nargs</em>&nbsp;</td><td>- ignored (for backward compatibility only) </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>args</em>&nbsp;</td><td>- args to prepared statement </td></tr>
-  </table>
-</dl>
-<dl class="return" compact><dt><b>Returns:</b></dt><dd>0 for success or error code</dd></dl>
-apr_dbd_pbquery: query using a prepared statement + binary args<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>driver</em>&nbsp;</td><td>- the driver </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>pool</em>&nbsp;</td><td>- working pool </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>handle</em>&nbsp;</td><td>- the connection </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>nrows</em>&nbsp;</td><td>- number of rows affected. </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>statement</em>&nbsp;</td><td>- the prepared statement to execute </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>args</em>&nbsp;</td><td>- binary args to prepared statement </td></tr>
-  </table>
-</dl>
-<dl class="return" compact><dt><b>Returns:</b></dt><dd>0 for success or error code</dd></dl>
-apr_dbd_pbselect: select using a prepared statement + binary args<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>driver</em>&nbsp;</td><td>- the driver </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>pool</em>&nbsp;</td><td>- working pool </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>handle</em>&nbsp;</td><td>- the connection </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>res</em>&nbsp;</td><td>- pointer to query results. May point to NULL on entry </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>statement</em>&nbsp;</td><td>- the prepared statement to execute </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>random</em>&nbsp;</td><td>- Whether to support random-access to results </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>args</em>&nbsp;</td><td>- binary args to prepared statement </td></tr>
-  </table>
-</dl>
-<dl class="return" compact><dt><b>Returns:</b></dt><dd>0 for success or error code</dd></dl>
-apr_dbd_datum_get: get a binary entry from a row<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>driver</em>&nbsp;</td><td>- the driver </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>row</em>&nbsp;</td><td>- row pointer </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>col</em>&nbsp;</td><td>- entry number </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>type</em>&nbsp;</td><td>- type of data to get </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>data</em>&nbsp;</td><td>- pointer to data, allocated by the caller </td></tr>
-  </table>
-</dl>
-<dl class="return" compact><dt><b>Returns:</b></dt><dd>APR_SUCCESS on success, APR_ENOENT if data is NULL or APR_EGENERAL</dd></dl>
-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>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
-           APR_DBM_READWRITE  open for read-write access
-           APR_DBM_RWCREATE   open for r/w, create if needed
-           APR_DBM_RWTRUNC    open for r/w, truncate if already there
- </pre> </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>perm</em>&nbsp;</td><td>Permissions to apply to if created </td></tr>
-    <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>
-Store a dbm record value by key <dl compact><dt><b>Parameters:</b></dt><dd>
+<dl class="return" compact><dt><b>Returns:</b></dt><dd>the length of the plain text string </dd></dl>
+
+</div>
+</div><p>
+<a class="anchor" name="gd1ba714a6708376e6a21722a40a698a2"></a><!-- doxytag: member="apr_base64.h::apr_base64_decode_len" ref="gd1ba714a6708376e6a21722a40a698a2" args="(const char *coded_src)" -->
+<div class="memitem">
+<div class="memproto">
+      <table class="memname">
+        <tr>
+          <td class="memname">int apr_base64_decode_len           </td>
+          <td>(</td>
+          <td class="paramtype">const char *&nbsp;</td>
+          <td class="paramname"> <em>coded_src</em>          </td>
+          <td>&nbsp;)&nbsp;</td>
+          <td></td>
+        </tr>
+      </table>
+</div>
+<div class="memdoc">
+
+<p>
+Determine the maximum buffer length required to decode the plain text string given the encoded string. <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>
+    <tr><td valign="top"></td><td valign="top"><em>coded_src</em>&nbsp;</td><td>The encoded string </td></tr>
   </table>
 </dl>
-Delete a dbm record value by key <dl compact><dt><b>Parameters:</b></dt><dd>
+<dl class="return" compact><dt><b>Returns:</b></dt><dd>the maximum required buffer length for the plain text string </dd></dl>
+
+</div>
+</div><p>
+<a class="anchor" name="g6176124b05512773de40cc5e899058b9"></a><!-- doxytag: member="apr_base64.h::apr_base64_encode" ref="g6176124b05512773de40cc5e899058b9" args="(char *coded_dst, const char *plain_src, int len_plain_src)" -->
+<div class="memitem">
+<div class="memproto">
+      <table class="memname">
+        <tr>
+          <td class="memname">int apr_base64_encode           </td>
+          <td>(</td>
+          <td class="paramtype">char *&nbsp;</td>
+          <td class="paramname"> <em>coded_dst</em>, </td>
+        </tr>
+        <tr>
+          <td class="paramkey"></td>
+          <td></td>
+          <td class="paramtype">const char *&nbsp;</td>
+          <td class="paramname"> <em>plain_src</em>, </td>
+        </tr>
+        <tr>
+          <td class="paramkey"></td>
+          <td></td>
+          <td class="paramtype">int&nbsp;</td>
+          <td class="paramname"> <em>len_plain_src</em></td><td>&nbsp;</td>
+        </tr>
+        <tr>
+          <td></td>
+          <td>)</td>
+          <td></td><td></td><td></td>
+        </tr>
+      </table>
+</div>
+<div class="memdoc">
+
+<p>
+Encode a text string using base64encoding. <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>
+    <tr><td valign="top"></td><td valign="top"><em>coded_dst</em>&nbsp;</td><td>The destination string for the encoded string. </td></tr>
+    <tr><td valign="top"></td><td valign="top"><em>plain_src</em>&nbsp;</td><td>The original string in plain text </td></tr>
+    <tr><td valign="top"></td><td valign="top"><em>len_plain_src</em>&nbsp;</td><td>The length of the plain text string </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>
+<dl class="return" compact><dt><b>Returns:</b></dt><dd>the length of the encoded string </dd></dl>
+
+</div>
+</div><p>
+<a class="anchor" name="ge7480ce6b723e71cf91583217d96f1d7"></a><!-- doxytag: member="apr_base64.h::apr_base64_encode_binary" ref="ge7480ce6b723e71cf91583217d96f1d7" args="(char *coded_dst, const unsigned char *plain_src, int len_plain_src)" -->
+<div class="memitem">
+<div class="memproto">
+      <table class="memname">
+        <tr>
+          <td class="memname">int apr_base64_encode_binary           </td>
+          <td>(</td>
+          <td class="paramtype">char *&nbsp;</td>
+          <td class="paramname"> <em>coded_dst</em>, </td>
+        </tr>
+        <tr>
+          <td class="paramkey"></td>
+          <td></td>
+          <td class="paramtype">const unsigned char *&nbsp;</td>
+          <td class="paramname"> <em>plain_src</em>, </td>
+        </tr>
+        <tr>
+          <td class="paramkey"></td>
+          <td></td>
+          <td class="paramtype">int&nbsp;</td>
+          <td class="paramname"> <em>len_plain_src</em></td><td>&nbsp;</td>
+        </tr>
+        <tr>
+          <td></td>
+          <td>)</td>
+          <td></td><td></td><td></td>
+        </tr>
+      </table>
+</div>
+<div class="memdoc">
+
+<p>
+Encode an EBCDIC string using base64encoding. <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>coded_dst</em>&nbsp;</td><td>The destination string for the encoded string. </td></tr>
+    <tr><td valign="top"></td><td valign="top"><em>plain_src</em>&nbsp;</td><td>The original string in plain text </td></tr>
+    <tr><td valign="top"></td><td valign="top"><em>len_plain_src</em>&nbsp;</td><td>The length of the plain text string </td></tr>
   </table>
 </dl>
-Retrieve the first record key from a dbm <dl compact><dt><b>Parameters:</b></dt><dd>
+<dl class="return" compact><dt><b>Returns:</b></dt><dd>the length of the encoded string </dd></dl>
+
+</div>
+</div><p>
+<a class="anchor" name="g5dad9df13a7018e3946a54c8d2c27ae9"></a><!-- doxytag: member="apr_base64.h::apr_base64_encode_len" ref="g5dad9df13a7018e3946a54c8d2c27ae9" args="(int len)" -->
+<div class="memitem">
+<div class="memproto">
+      <table class="memname">
+        <tr>
+          <td class="memname">int apr_base64_encode_len           </td>
+          <td>(</td>
+          <td class="paramtype">int&nbsp;</td>
+          <td class="paramname"> <em>len</em>          </td>
+          <td>&nbsp;)&nbsp;</td>
+          <td></td>
+        </tr>
+      </table>
+</div>
+<div class="memdoc">
+
+<p>
+Given the length of an un-encrypted string, get the length of the encrypted string. <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>
-MDr4 translation setup. Provides the APR translation handle to be used for translating the content before calculating the 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 MD4 content to set the translation for. </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>xlate</em>&nbsp;</td><td>The translation handle to use for this MD4 context</td></tr>
-  </table>
-</dl>
-MD4 block update operation. Continue an MD4 message-digest operation, processing another message block, and updating the context. <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 MD4 content to update. </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>input</em>&nbsp;</td><td>next message block to update </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>inputLen</em>&nbsp;</td><td>The length of the next message block</td></tr>
-  </table>
-</dl>
-MD4 finalization. Ends an MD4 message-digest operation, writing the message digest and zeroing the context <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 final MD4 digest </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>context</em>&nbsp;</td><td>The MD4 content we are finalizing.</td></tr>
-  </table>
-</dl>
-MD4 digest computation <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 MD4 digest </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>input</em>&nbsp;</td><td>message block to use </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>inputLen</em>&nbsp;</td><td>The length of the message block</td></tr>
-  </table>
-</dl>
-MD5 translation setup. Provides the APR translation handle to be used for translating the content before calculating the 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 MD5 content to set the translation for. </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>xlate</em>&nbsp;</td><td>The translation handle to use for this MD5 context</td></tr>
-  </table>
-</dl>
-MD5 block update operation. Continue an MD5 message-digest operation, processing another message block, and updating the context. <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 MD5 content to update. </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>input</em>&nbsp;</td><td>next message block to update </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>inputLen</em>&nbsp;</td><td>The length of the next message block</td></tr>
-  </table>
-</dl>
-MD5 finalization. Ends an MD5 message-digest operation, writing the message digest and zeroing the context <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 final MD5 digest </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>context</em>&nbsp;</td><td>The MD5 content we are finalizing.</td></tr>
-  </table>
-</dl>
-MD5 in one step <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 final MD5 digest </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>input</em>&nbsp;</td><td>The message block to use </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>inputLen</em>&nbsp;</td><td>The length of the message block</td></tr>
-  </table>
-</dl>
-Encode a password using an MD5 algorithm <dl compact><dt><b>Parameters:</b></dt><dd>
-  <table border="0" cellspacing="2" cellpadding="0">
-    <tr><td valign="top"></td><td valign="top"><em>password</em>&nbsp;</td><td>The password to encode </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>salt</em>&nbsp;</td><td>The salt to use for the encoding </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>result</em>&nbsp;</td><td>The string to store the encoded password in </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>nbytes</em>&nbsp;</td><td>The size of the result buffer</td></tr>
-  </table>
-</dl>
-Validate hashes created by APR-supported algorithms: md5 and sha1. hashes created by crypt are supported only on platforms that provide crypt(3), so don't rely on that function unless you know that your application will be run only on platforms that support it. On platforms that don't support crypt(3), this falls back to a clear text string comparison. <dl compact><dt><b>Parameters:</b></dt><dd>
-  <table border="0" cellspacing="2" cellpadding="0">
-    <tr><td valign="top"></td><td valign="top"><em>passwd</em>&nbsp;</td><td>The password to validate </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>hash</em>&nbsp;</td><td>The password to validate against</td></tr>
-  </table>
-</dl>
-Enables a Server for use again <dl compact><dt><b>Parameters:</b></dt><dd>
-  <table border="0" cellspacing="2" cellpadding="0">
-    <tr><td valign="top"></td><td valign="top"><em>mc</em>&nbsp;</td><td>The memcache client object to use </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>ms</em>&nbsp;</td><td>Server to Activate</td></tr>
-  </table>
-</dl>
-Disable a Server <dl compact><dt><b>Parameters:</b></dt><dd>
-  <table border="0" cellspacing="2" cellpadding="0">
-    <tr><td valign="top"></td><td valign="top"><em>mc</em>&nbsp;</td><td>The memcache client object to use </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>ms</em>&nbsp;</td><td>Server to Disable</td></tr>
-  </table>
-</dl>
-Creates a new Server Object <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>Pool to use </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>host</em>&nbsp;</td><td>hostname of the server </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>port</em>&nbsp;</td><td>port of the server </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>min</em>&nbsp;</td><td>minimum number of client sockets to open </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>smax</em>&nbsp;</td><td>soft maximum number of client connections to open </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>max</em>&nbsp;</td><td>hard maximum number of client connections </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>ttl</em>&nbsp;</td><td>time to live in seconds of a client connection </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>ns</em>&nbsp;</td><td>location of the new server object </td></tr>
-  </table>
-</dl>
-<dl class="see" compact><dt><b>See also:</b></dt><dd>apr_reslist_create </dd></dl>
-<dl class="remark" compact><dt><b>Remarks:</b></dt><dd>min, smax, and max are only used when APR_HAS_THREADS</dd></dl>
-Creates a new memcached client object <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>Pool to use </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>max_servers</em>&nbsp;</td><td>maximum number of servers </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>Not currently used </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>mc</em>&nbsp;</td><td>location of the new memcache client object</td></tr>
-  </table>
-</dl>
-Gets a value from the server, allocating the value out of 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>mc</em>&nbsp;</td><td>client to use </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>p</em>&nbsp;</td><td>Pool to use </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>key</em>&nbsp;</td><td>null terminated string containing the key </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>baton</em>&nbsp;</td><td>location of the allocated value </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>len</em>&nbsp;</td><td>length of data at baton </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>any flags set by the client for this key </td></tr>
-  </table>
-</dl>
-<dl class="return" compact><dt><b>Returns:</b></dt><dd></dd></dl>
-Sets a value by key on the server <dl compact><dt><b>Parameters:</b></dt><dd>
-  <table border="0" cellspacing="2" cellpadding="0">
-    <tr><td valign="top"></td><td valign="top"><em>mc</em>&nbsp;</td><td>client to use </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>key</em>&nbsp;</td><td>null terminated string containing the key </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>baton</em>&nbsp;</td><td>data to store on the server </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>len</em>&nbsp;</td><td>length of data at baton </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>timeout</em>&nbsp;</td><td>time in seconds for the data to live on the server </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>any flags set by the client for this key</td></tr>
-  </table>
-</dl>
-Adds value by key on the server <dl compact><dt><b>Parameters:</b></dt><dd>
-  <table border="0" cellspacing="2" cellpadding="0">
-    <tr><td valign="top"></td><td valign="top"><em>mc</em>&nbsp;</td><td>client to use </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>key</em>&nbsp;</td><td>null terminated string containing the key </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>baton</em>&nbsp;</td><td>data to store on the server </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>len</em>&nbsp;</td><td>length of data at baton </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>timeout</em>&nbsp;</td><td>time for the data to live on the server </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>any flags set by the client for this key </td></tr>
-  </table>
-</dl>
-<dl class="return" compact><dt><b>Returns:</b></dt><dd>APR_SUCCESS if the key was added, APR_EEXIST if the key already exists on the server.</dd></dl>
-Replaces value by key on the server <dl compact><dt><b>Parameters:</b></dt><dd>
-  <table border="0" cellspacing="2" cellpadding="0">
-    <tr><td valign="top"></td><td valign="top"><em>mc</em>&nbsp;</td><td>client to use </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>key</em>&nbsp;</td><td>null terminated string containing the key </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>baton</em>&nbsp;</td><td>data to store on the server </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>len</em>&nbsp;</td><td>length of data at baton </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>timeout</em>&nbsp;</td><td>time for the data to live on the server </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>any flags set by the client for this key </td></tr>
-  </table>
-</dl>
-<dl class="return" compact><dt><b>Returns:</b></dt><dd>APR_SUCCESS if the key was added, APR_EEXIST if the key did not exist on the server.</dd></dl>
-Deletes a key from a server <dl compact><dt><b>Parameters:</b></dt><dd>
-  <table border="0" cellspacing="2" cellpadding="0">
-    <tr><td valign="top"></td><td valign="top"><em>mc</em>&nbsp;</td><td>client to use </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>key</em>&nbsp;</td><td>null terminated string containing the key </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>timeout</em>&nbsp;</td><td>time for the delete to stop other clients from adding</td></tr>
-  </table>
-</dl>
-Increments a value <dl compact><dt><b>Parameters:</b></dt><dd>
-  <table border="0" cellspacing="2" cellpadding="0">
-    <tr><td valign="top"></td><td valign="top"><em>mc</em>&nbsp;</td><td>client to use </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>key</em>&nbsp;</td><td>null terminated string containing the key </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>n</em>&nbsp;</td><td>number to increment by </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>nv</em>&nbsp;</td><td>new value after incrmenting</td></tr>
-  </table>
-</dl>
-Decrements a value <dl compact><dt><b>Parameters:</b></dt><dd>
-  <table border="0" cellspacing="2" cellpadding="0">
-    <tr><td valign="top"></td><td valign="top"><em>mc</em>&nbsp;</td><td>client to use </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>key</em>&nbsp;</td><td>null terminated string containing the key </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>n</em>&nbsp;</td><td>number to decrement by </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>nv</em>&nbsp;</td><td>new value after decrementing</td></tr>
-  </table>
-</dl>
-Query a server's version <dl compact><dt><b>Parameters:</b></dt><dd>
-  <table border="0" cellspacing="2" cellpadding="0">
-    <tr><td valign="top"></td><td valign="top"><em>ms</em>&nbsp;</td><td>server to query </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>p</em>&nbsp;</td><td>Pool to allocate answer from </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>baton</em>&nbsp;</td><td>location to store server version string </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>len</em>&nbsp;</td><td>length of the server version string</td></tr>
-  </table>
-</dl>
-Query a server for statistics <dl compact><dt><b>Parameters:</b></dt><dd>
-  <table border="0" cellspacing="2" cellpadding="0">
-    <tr><td valign="top"></td><td valign="top"><em>ms</em>&nbsp;</td><td>server to query </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>p</em>&nbsp;</td><td>Pool to allocate answer from </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>stats</em>&nbsp;</td><td>location of the new statistics structure</td></tr>
-  </table>
-</dl>
-push/add an object to the queue, blocking if the queue is already full<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>queue</em>&nbsp;</td><td>the queue </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>data</em>&nbsp;</td><td>the data </td></tr>
-  </table>
-</dl>
-<dl class="return" compact><dt><b>Returns:</b></dt><dd>APR_EINTR the blocking was interrupted (try again) <p>
-APR_EOF the queue has been terminated <p>
-APR_SUCCESS on a successful push</dd></dl>
-pop/get an object from the queue, blocking if the queue is already empty<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>queue</em>&nbsp;</td><td>the queue </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>data</em>&nbsp;</td><td>the data </td></tr>
-  </table>
-</dl>
-<dl class="return" compact><dt><b>Returns:</b></dt><dd>APR_EINTR the blocking was interrupted (try again) <p>
-APR_EOF if the queue has been terminated <p>
-APR_SUCCESS on a successful pop</dd></dl>
-push/add an object to the queue, returning immediately if the queue is full<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>queue</em>&nbsp;</td><td>the queue </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>data</em>&nbsp;</td><td>the data </td></tr>
-  </table>
-</dl>
-<dl class="return" compact><dt><b>Returns:</b></dt><dd>APR_EINTR the blocking operation was interrupted (try again) <p>
-APR_EAGAIN the queue is full <p>
-APR_EOF the queue has been terminated <p>
-APR_SUCCESS on a successful push</dd></dl>
-pop/get an object to the queue, returning immediately if the queue is empty<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>queue</em>&nbsp;</td><td>the queue </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>data</em>&nbsp;</td><td>the data </td></tr>
-  </table>
-</dl>
-<dl class="return" compact><dt><b>Returns:</b></dt><dd>APR_EINTR the blocking operation was interrupted (try again) <p>
-APR_EAGAIN the queue is empty <p>
-APR_EOF the queue has been terminated <p>
-APR_SUCCESS on a successful push</dd></dl>
-interrupt all the threads blocking on this queue.<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>queue</em>&nbsp;</td><td>the queue</td></tr>
-  </table>
-</dl>
-terminate the queue, sending an interrupt to all the blocking threads<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>queue</em>&nbsp;</td><td>the queue</td></tr>
-  </table>
-</dl>
-Destroy the given resource list and all resources controlled by this list. FIXME: Should this block until all resources become available, or maybe just destroy all the free ones, or maybe destroy them even though they might be in use by something else? Currently it will abort if there are resources that haven't been released, so there is an assumption that all resources have been released to the list before calling this function. <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 reslist to destroy</td></tr>
-  </table>
-</dl>
-Retrieve a resource from the list, creating a new one if necessary. If we have met our maximum number of resources, we will block until one becomes available.<p>
-Return a resource back to the list of available resources.<p>
-Invalidate a resource in the pool - e.g. a database connection that returns a "lost connection" error and can't be restored. Use this instead of apr_reslist_release if the resource is bad.<p>
-Perform routine maintenance on the resource list. This call may instantiate new resources or expire old resources. <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>
-  </table>
-</dl>
-Destroy a managed memory block. <dl compact><dt><b>Parameters:</b></dt><dd>
-  <table border="0" cellspacing="2" cellpadding="0">
-    <tr><td valign="top"></td><td valign="top"><em>rmm</em>&nbsp;</td><td>The relocatable memory block to destroy</td></tr>
-  </table>
-</dl>
-Attach to a relocatable memory block already managed by the apr_rmm API. <dl compact><dt><b>Parameters:</b></dt><dd>
-  <table border="0" cellspacing="2" cellpadding="0">
-    <tr><td valign="top"></td><td valign="top"><em>rmm</em>&nbsp;</td><td>The relocatable memory block </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>lock</em>&nbsp;</td><td>An <a class="el" href="structapr__anylock__t.html">apr_anylock_t</a> of the appropriate type of lock </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>membuf</em>&nbsp;</td><td>The block of relocatable memory already under management </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>cont</em>&nbsp;</td><td>The pool to use for local storage and management</td></tr>
-  </table>
-</dl>
-Detach from the managed block of memory. <dl compact><dt><b>Parameters:</b></dt><dd>
-  <table border="0" cellspacing="2" cellpadding="0">
-    <tr><td valign="top"></td><td valign="top"><em>rmm</em>&nbsp;</td><td>The relocatable memory block to detach from</td></tr>
-  </table>
-</dl>
-Free allocation returned by apr_rmm_malloc or apr_rmm_calloc. <dl compact><dt><b>Parameters:</b></dt><dd>
-  <table border="0" cellspacing="2" cellpadding="0">
-    <tr><td valign="top"></td><td valign="top"><em>rmm</em>&nbsp;</td><td>The relocatable memory block </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>entity</em>&nbsp;</td><td>The memory allocation to free</td></tr>
-  </table>
-</dl>
-Close an sdbm file previously opened by apr_sdbm_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>db</em>&nbsp;</td><td>The database to close</td></tr>
-  </table>
-</dl>
-Lock an sdbm database for concurency of multiple operations <dl compact><dt><b>Parameters:</b></dt><dd>
-  <table border="0" cellspacing="2" cellpadding="0">
-    <tr><td valign="top"></td><td valign="top"><em>db</em>&nbsp;</td><td>The database to lock </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>type</em>&nbsp;</td><td>The lock type <pre>
-           APR_FLOCK_SHARED
-           APR_FLOCK_EXCLUSIVE
- </pre> </td></tr>
-  </table>
-</dl>
-<dl class="remark" compact><dt><b>Remarks:</b></dt><dd>Calls to apr_sdbm_lock may be nested. All apr_sdbm functions perform implicit locking. Since an APR_FLOCK_SHARED lock cannot be portably promoted to an APR_FLOCK_EXCLUSIVE lock, apr_sdbm_store and apr_sdbm_delete calls will fail if an APR_FLOCK_SHARED lock is held. The apr_sdbm_lock call requires the database to be opened with the APR_SHARELOCK mode value.</dd></dl>
-Release an sdbm lock previously aquired by apr_sdbm_lock <dl compact><dt><b>Parameters:</b></dt><dd>
-  <table border="0" cellspacing="2" cellpadding="0">
-    <tr><td valign="top"></td><td valign="top"><em>db</em>&nbsp;</td><td>The database to unlock</td></tr>
-  </table>
-</dl>
-Fetch an sdbm 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>db</em>&nbsp;</td><td>The database </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>value</em>&nbsp;</td><td>The value datum retrieved for this record </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>
-  </table>
-</dl>
-Store an sdbm 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>db</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>
-    <tr><td valign="top"></td><td valign="top"><em>opt</em>&nbsp;</td><td>The method used to store the record <pre>
-           APR_SDBM_INSERT     return an error if the record exists
-           APR_SDBM_REPLACE    overwrite any existing record for key
- </pre></td></tr>
-  </table>
-</dl>
-Delete an sdbm 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>db</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>
-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>db</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 first record </td></tr>
-  </table>
-</dl>
-<dl class="remark" compact><dt><b>Remarks:</b></dt><dd>The keys returned are not ordered. To traverse the list of keys for an sdbm opened with APR_SHARELOCK, the caller must use apr_sdbm_lock prior to retrieving the first record, and hold the lock until after the last call to apr_sdbm_nextkey.</dd></dl>
-Retrieve the next record key from an sdbm <dl compact><dt><b>Parameters:</b></dt><dd>
-  <table border="0" cellspacing="2" cellpadding="0">
-    <tr><td valign="top"></td><td valign="top"><em>db</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 next record</td></tr>
-  </table>
-</dl>
-Returns true if the sdbm database opened for read-only access <dl compact><dt><b>Parameters:</b></dt><dd>
-  <table border="0" cellspacing="2" cellpadding="0">
-    <tr><td valign="top"></td><td valign="top"><em>db</em>&nbsp;</td><td>The database to test</td></tr>
-  </table>
-</dl>
-Destroy the thread pool and stop all the threads <dl class="return" compact><dt><b>Returns:</b></dt><dd>APR_SUCCESS if all threads are stopped.</dd></dl>
-Schedule a task to the bottom of the tasks of same priority. <dl compact><dt><b>Parameters:</b></dt><dd>
-  <table border="0" cellspacing="2" cellpadding="0">
-    <tr><td valign="top"></td><td valign="top"><em>me</em>&nbsp;</td><td>The thread pool </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>func</em>&nbsp;</td><td>The task function </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>param</em>&nbsp;</td><td>The parameter for the task function </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>priority</em>&nbsp;</td><td>The priority of the task. </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>owner</em>&nbsp;</td><td>Owner of this task. </td></tr>
-  </table>
-</dl>
-<dl class="return" compact><dt><b>Returns:</b></dt><dd>APR_SUCCESS if the task had been scheduled successfully</dd></dl>
-Schedule a task to be run after a delay <dl compact><dt><b>Parameters:</b></dt><dd>
-  <table border="0" cellspacing="2" cellpadding="0">
-    <tr><td valign="top"></td><td valign="top"><em>me</em>&nbsp;</td><td>The thread pool </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>func</em>&nbsp;</td><td>The task function </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>param</em>&nbsp;</td><td>The parameter for the task function </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>time</em>&nbsp;</td><td>Time in microseconds </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>owner</em>&nbsp;</td><td>Owner of this task. </td></tr>
-  </table>
-</dl>
-<dl class="return" compact><dt><b>Returns:</b></dt><dd>APR_SUCCESS if the task had been scheduled successfully</dd></dl>
-Schedule a task to the top of the tasks of same priority. <dl compact><dt><b>Parameters:</b></dt><dd>
-  <table border="0" cellspacing="2" cellpadding="0">
-    <tr><td valign="top"></td><td valign="top"><em>me</em>&nbsp;</td><td>The thread pool </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>func</em>&nbsp;</td><td>The task function </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>param</em>&nbsp;</td><td>The parameter for the task function </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>priority</em>&nbsp;</td><td>The priority of the task. </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>owner</em>&nbsp;</td><td>Owner of this task. </td></tr>
-  </table>
-</dl>
-<dl class="return" compact><dt><b>Returns:</b></dt><dd>APR_SUCCESS if the task had been scheduled successfully</dd></dl>
-Cancel tasks submitted by the owner. If there is any task from the owner that is currently running, the function will spin until the task finished. <dl compact><dt><b>Parameters:</b></dt><dd>
-  <table border="0" cellspacing="2" cellpadding="0">
-    <tr><td valign="top"></td><td valign="top"><em>me</em>&nbsp;</td><td>The thread pool </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>owner</em>&nbsp;</td><td>Owner of the task </td></tr>
-  </table>
-</dl>
-<dl class="return" compact><dt><b>Returns:</b></dt><dd>APR_SUCCESS if the task has been cancelled successfully </dd></dl>
-<dl class="note" compact><dt><b>Note:</b></dt><dd>The task function should not be calling cancel, otherwise the function may get stuck forever. The function assert if it detect such a case.</dd></dl>
-Get owner of the task currently been executed by the thread. <dl compact><dt><b>Parameters:</b></dt><dd>
-  <table border="0" cellspacing="2" cellpadding="0">
-    <tr><td valign="top"></td><td valign="top"><em>thd</em>&nbsp;</td><td>The thread is executing a task </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>owner</em>&nbsp;</td><td>Pointer to receive owner of the task. </td></tr>
-  </table>
-</dl>
-<dl class="return" compact><dt><b>Returns:</b></dt><dd>APR_SUCCESS if the owner is retrieved successfully</dd></dl>
-Special case for CONNECT parsing: it comes with the hostinfo part only <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>hostinfo</em>&nbsp;</td><td>The hostinfo string to parse </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>uptr</em>&nbsp;</td><td>The <a class="el" href="structapr__uri__t.html">apr_uri_t</a> to fill out </td></tr>
-  </table>
-</dl>
-<dl class="return" compact><dt><b>Returns:</b></dt><dd>APR_SUCCESS for success or error code</dd></dl>
-Find out whether or not the specified conversion is single-byte-only. <dl compact><dt><b>Parameters:</b></dt><dd>
-  <table border="0" cellspacing="2" cellpadding="0">
-    <tr><td valign="top"></td><td valign="top"><em>convset</em>&nbsp;</td><td>The handle allocated by apr_xlate_open, specifying the parameters of conversion </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>onoff</em>&nbsp;</td><td>Output: whether or not the conversion is single-byte-only </td></tr>
-  </table>
-</dl>
-<dl class="remark" compact><dt><b>Remarks:</b></dt><dd>Return APR_ENOTIMPL if charset transcoding is not available in this instance of apr-util (i.e., APR_HAS_XLATE is undefined).</dd></dl>
-Convert a buffer of text from one codepage to another. <dl compact><dt><b>Parameters:</b></dt><dd>
-  <table border="0" cellspacing="2" cellpadding="0">
-    <tr><td valign="top"></td><td valign="top"><em>convset</em>&nbsp;</td><td>The handle allocated by apr_xlate_open, specifying the parameters of conversion </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>inbuf</em>&nbsp;</td><td>The address of the source buffer </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>inbytes_left</em>&nbsp;</td><td>Input: the amount of input data to be translated Output: the amount of input data not yet translated </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>outbuf</em>&nbsp;</td><td>The address of the destination buffer </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>outbytes_left</em>&nbsp;</td><td>Input: the size of the output buffer Output: the amount of the output buffer not yet used </td></tr>
-  </table>
-</dl>
-<dl class="remark" compact><dt><b>Remarks:</b></dt><dd>Returns APR_ENOTIMPL if charset transcoding is not available in this instance of apr-util (i.e., APR_HAS_XLATE is undefined). Returns APR_INCOMPLETE if the input buffer ends in an incomplete multi-byte character.</dd></dl>
-To correctly terminate the output buffer for some multi-byte character set encodings, a final call must be made to this function after the complete input string has been converted, passing the inbuf and inbytes_left parameters as NULL. (Note that this mode only works from version 1.1.0 onwards)<p>
-Convert a single-byte character from one charset to another. <dl compact><dt><b>Parameters:</b></dt><dd>
-  <table border="0" cellspacing="2" cellpadding="0">
-    <tr><td valign="top"></td><td valign="top"><em>convset</em>&nbsp;</td><td>The handle allocated by apr_xlate_open, specifying the parameters of conversion </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>inchar</em>&nbsp;</td><td>The single-byte character to convert. </td></tr>
-  </table>
-</dl>
-<dl class="warning" compact><dt><b>Warning:</b></dt><dd>This only works when converting between single-byte character sets. -1 will be returned if the conversion can't be performed.</dd></dl>
-Close a codepage translation handle. <dl compact><dt><b>Parameters:</b></dt><dd>
-  <table border="0" cellspacing="2" cellpadding="0">
-    <tr><td valign="top"></td><td valign="top"><em>convset</em>&nbsp;</td><td>The codepage translation handle to close </td></tr>
-  </table>
-</dl>
-<dl class="remark" compact><dt><b>Remarks:</b></dt><dd>Return APR_ENOTIMPL if charset transcoding is not available in this instance of apr-util (i.e., APR_HAS_XLATE is undefined).</dd></dl>
-Feed input into the parser <dl compact><dt><b>Parameters:</b></dt><dd>
-  <table border="0" cellspacing="2" cellpadding="0">
-    <tr><td valign="top"></td><td valign="top"><em>parser</em>&nbsp;</td><td>The XML parser for parsing this data. </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>data</em>&nbsp;</td><td>The data to parse. </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>len</em>&nbsp;</td><td>The length of the data. </td></tr>
-  </table>
-</dl>
-<dl class="return" compact><dt><b>Returns:</b></dt><dd>Any errors found during parsing. </dd></dl>
-<dl class="remark" compact><dt><b>Remarks:</b></dt><dd>Use apr_xml_parser_geterror() to get more error information.</dd></dl>
-Terminate the parsing and return the result <dl compact><dt><b>Parameters:</b></dt><dd>
-  <table border="0" cellspacing="2" cellpadding="0">
-    <tr><td valign="top"></td><td valign="top"><em>parser</em>&nbsp;</td><td>The XML parser for parsing this data. </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>pdoc</em>&nbsp;</td><td>The resulting parse information. May be NULL to simply terminate the parsing without fetching the info. </td></tr>
-  </table>
-</dl>
-<dl class="return" compact><dt><b>Returns:</b></dt><dd>Any errors found during the final stage of parsing. </dd></dl>
-<dl class="remark" compact><dt><b>Remarks:</b></dt><dd>Use apr_xml_parser_geterror() to get more error information.</dd></dl>
-return the URI's (existing) index, or insert it and return a new index <dl compact><dt><b>Parameters:</b></dt><dd>
-  <table border="0" cellspacing="2" cellpadding="0">
-    <tr><td valign="top"></td><td valign="top"><em>uri_array</em>&nbsp;</td><td>array to insert into </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>uri</em>&nbsp;</td><td>The uri to insert </td></tr>
-  </table>
-</dl>
-<dl class="return" compact><dt><b>Returns:</b></dt><dd>int The uri's index</dd></dl>
-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
-           APR_DBM_READWRITE  open for read-write access
-           APR_DBM_RWCREATE   open for r/w, create if needed
-           APR_DBM_RWTRUNC    open for r/w, truncate if already there
- </pre> </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>perm</em>&nbsp;</td><td>Permissions to apply to if created </td></tr>
-    <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>
-<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>
-<p>
-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>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
-           APR_DBM_READWRITE  open for read-write access
-           APR_DBM_RWCREATE   open for r/w, create if needed
-           APR_DBM_RWTRUNC    open for r/w, truncate if already there
- </pre> </td></tr>

[... 556 lines stripped ...]


Mime
View raw message