apr-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From bo...@apache.org
Subject svn commit: r794511 [21/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___s_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___s_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___s_d_b_m.html (original)
+++ apr/site/trunk/docs/docs/apr/trunk/group___a_p_r___util___d_b_m___s_d_b_m.html Thu Jul 16 03:44:20 2009
@@ -42,35 +42,25 @@
 <tr><td class="memItemLeft" nowrap align="right" valign="top">typedef struct <a class="el" href="group___a_p_r___util___d_b_m___s_d_b_m.html#gf24cdea6e4884036a40484259efa68c6">apr_sdbm_t</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___d_b_m___s_d_b_m.html#gf24cdea6e4884036a40484259efa68c6">apr_sdbm_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___s_d_b_m.html#g4bb60b96f7cf5537f14df8b35576dd76">APU_DECLARE</a> (<a class="el" href="group__apr__errno.html#gf76ee4543247e9fb3f3546203e590a6c">apr_status_t</a>) apr_sdbm_open(<a class="el" href="group___a_p_r___util___d_b_m___s_d_b_m.html#gf24cdea6e4884036a40484259efa68c6">apr_sdbm_t</a> **db</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___s_d_b_m.html#g08c6121b4159ae86cec6e915e1e5d758">apr_sdbm_open</a> (<a class="el" href="group___a_p_r___util___d_b_m___s_d_b_m.html#gf24cdea6e4884036a40484259efa68c6">apr_sdbm_t</a> **db, const char *name, apr_int32_t mode, <a class="el" href="group__apr__file__info.html#g3af19c4c47007169064a70f9351bc7d8">apr_fileperms_t</a> perms, <a class="el" href="group__apr__pools.html#gf137f28edcf9a086cd6bc36c20d7cdfb">apr_pool_t</a> *p)</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="g8f8f80d37794cde9472343e4487ba3eb"></a><!-- doxytag: member="APR_Util_DBM_SDBM::name" ref="g8f8f80d37794cde9472343e4487ba3eb" args="" -->
-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___s_d_b_m.html#gf684c3a70d2c9ebe02bb1e2fffe23e1e">apr_sdbm_close</a> (<a class="el" href="group___a_p_r___util___d_b_m___s_d_b_m.html#gf24cdea6e4884036a40484259efa68c6">apr_sdbm_t</a> *db)</td></tr>
 
-<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="g719919dff9b073c668fd47f22f420774"></a><!-- doxytag: member="APR_Util_DBM_SDBM::mode" ref="g719919dff9b073c668fd47f22f420774" args="" -->
-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___s_d_b_m.html#g2c2edd6a123d8ca2a6334fa8874b724d">apr_sdbm_lock</a> (<a class="el" href="group___a_p_r___util___d_b_m___s_d_b_m.html#gf24cdea6e4884036a40484259efa68c6">apr_sdbm_t</a> *db, int type)</td></tr>
 
-<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="g4644cd2c8097d1b754ec32f7c5ea6d5b"></a><!-- doxytag: member="APR_Util_DBM_SDBM::perms" ref="g4644cd2c8097d1b754ec32f7c5ea6d5b" args="" -->
-const char apr_int32_t <br class="typebreak">
-<a class="el" href="group__apr__file__info.html#g3af19c4c47007169064a70f9351bc7d8">apr_fileperms_t</a>&nbsp;</td><td class="memItemRight" valign="bottom"><b>perms</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___s_d_b_m.html#gb96a7e08ddac3cb6bff97a822b68de14">apr_sdbm_unlock</a> (<a class="el" href="group___a_p_r___util___d_b_m___s_d_b_m.html#gf24cdea6e4884036a40484259efa68c6">apr_sdbm_t</a> *db)</td></tr>
 
-<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="g766306d113a8e2b594eaaae5b3156b2e"></a><!-- doxytag: member="APR_Util_DBM_SDBM::p" ref="g766306d113a8e2b594eaaae5b3156b2e" args="" -->
-const char apr_int32_t <br class="typebreak">
-<a class="el" href="group__apr__file__info.html#g3af19c4c47007169064a70f9351bc7d8">apr_fileperms_t</a> <a class="el" href="group__apr__pools.html#gf137f28edcf9a086cd6bc36c20d7cdfb">apr_pool_t</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><b>p</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___s_d_b_m.html#g7d9eae450e9f9a2f1bcf626a3f8ca43f">apr_sdbm_fetch</a> (<a class="el" href="group___a_p_r___util___d_b_m___s_d_b_m.html#gf24cdea6e4884036a40484259efa68c6">apr_sdbm_t</a> *db, <a class="el" href="structapr__sdbm__datum__t.html">apr_sdbm_datum_t</a> *value, <a class="el" href="structapr__sdbm__datum__t.html">apr_sdbm_datum_t</a> key)</td></tr>
 
-<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="gc765329451135abec74c45e1897abf26"></a><!-- doxytag: member="APR_Util_DBM_SDBM::type" ref="gc765329451135abec74c45e1897abf26" args="" -->
-int&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___s_d_b_m.html#gc12993b882c50afa0777945ea4a88572">apr_sdbm_store</a> (<a class="el" href="group___a_p_r___util___d_b_m___s_d_b_m.html#gf24cdea6e4884036a40484259efa68c6">apr_sdbm_t</a> *db, <a class="el" href="structapr__sdbm__datum__t.html">apr_sdbm_datum_t</a> key, <a class="el" href="structapr__sdbm__datum__t.html">apr_sdbm_datum_t</a> value, int opt)</td></tr>
 
-<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="g711ebc0efad43aba10f32ded4a28cf17"></a><!-- doxytag: member="APR_Util_DBM_SDBM::value" ref="g711ebc0efad43aba10f32ded4a28cf17" args="" -->
-<a class="el" href="structapr__sdbm__datum__t.html">apr_sdbm_datum_t</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><b>value</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___s_d_b_m.html#g5744462c07c40d26c275beaeb902ff9c">apr_sdbm_delete</a> (<a class="el" href="group___a_p_r___util___d_b_m___s_d_b_m.html#gf24cdea6e4884036a40484259efa68c6">apr_sdbm_t</a> *db, const <a class="el" href="structapr__sdbm__datum__t.html">apr_sdbm_datum_t</a> key)</td></tr>
 
-<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="g3aaa51a0f0ad91af61adcd67436260aa"></a><!-- doxytag: member="APR_Util_DBM_SDBM::key" ref="g3aaa51a0f0ad91af61adcd67436260aa" args="" -->
-<a class="el" href="structapr__sdbm__datum__t.html">apr_sdbm_datum_t</a> <a class="el" href="structapr__sdbm__datum__t.html">apr_sdbm_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___s_d_b_m.html#ge5410d9dc681393e597f492f30c6447f">apr_sdbm_firstkey</a> (<a class="el" href="group___a_p_r___util___d_b_m___s_d_b_m.html#gf24cdea6e4884036a40484259efa68c6">apr_sdbm_t</a> *db, <a class="el" href="structapr__sdbm__datum__t.html">apr_sdbm_datum_t</a> *key)</td></tr>
 
-<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="g7dabf0be7fe6c0e41bab93d005632e83"></a><!-- doxytag: member="APR_Util_DBM_SDBM::opt" ref="g7dabf0be7fe6c0e41bab93d005632e83" args="" -->
-<a class="el" href="structapr__sdbm__datum__t.html">apr_sdbm_datum_t</a> <br class="typebreak">
-<a class="el" href="structapr__sdbm__datum__t.html">apr_sdbm_datum_t</a> int&nbsp;</td><td class="memItemRight" valign="bottom"><b>opt</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___s_d_b_m.html#g77d7f848ccb68e9f465a988d0af80911">apr_sdbm_nextkey</a> (<a class="el" href="group___a_p_r___util___d_b_m___s_d_b_m.html#gf24cdea6e4884036a40484259efa68c6">apr_sdbm_t</a> *db, <a class="el" href="structapr__sdbm__datum__t.html">apr_sdbm_datum_t</a> *key)</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___s_d_b_m.html#gbad67008f83fd219173acc5abdd0b42d">apr_sdbm_rdonly</a> (<a class="el" href="group___a_p_r___util___d_b_m___s_d_b_m.html#gf24cdea6e4884036a40484259efa68c6">apr_sdbm_t</a> *db)</td></tr>
 
 </table>
 <hr><h2>Define Documentation</h2>
@@ -166,15 +156,15 @@
 </div>
 </div><p>
 <hr><h2>Function Documentation</h2>
-<a class="anchor" name="g4bb60b96f7cf5537f14df8b35576dd76"></a><!-- doxytag: member="apr_sdbm.h::APU_DECLARE" ref="g4bb60b96f7cf5537f14df8b35576dd76" args="(apr_status_t) apr_sdbm_open(apr_sdbm_t **db" -->
+<a class="anchor" name="gf684c3a70d2c9ebe02bb1e2fffe23e1e"></a><!-- doxytag: member="apr_sdbm.h::apr_sdbm_close" ref="gf684c3a70d2c9ebe02bb1e2fffe23e1e" args="(apr_sdbm_t *db)" -->
 <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_sdbm_close           </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 class="paramtype"><a class="el" href="group___a_p_r___util___d_b_m___s_d_b_m.html#gf24cdea6e4884036a40484259efa68c6">apr_sdbm_t</a> *&nbsp;</td>
+          <td class="paramname"> <em>db</em>          </td>
           <td>&nbsp;)&nbsp;</td>
           <td></td>
         </tr>
@@ -183,28 +173,154 @@
 <div class="memdoc">
 
 <p>
-Open an sdbm database by file name <dl compact><dt><b>Parameters:</b></dt><dd>
+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 newly opened database </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>name</em>&nbsp;</td><td>The sdbm file to open </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>mode</em>&nbsp;</td><td>The flag values (APR_READ and APR_BINARY flags are implicit) <pre>
-           APR_WRITE          open for read-write access
-           APR_CREATE         create the sdbm if it does not exist
-           APR_TRUNCATE       empty the contents of the sdbm
-           APR_EXCL           fail for APR_CREATE if the file exists
-           APR_DELONCLOSE     delete the sdbm when closed
-           APR_SHARELOCK      support locking across process/machines
- </pre> </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>perms</em>&nbsp;</td><td>Permissions to apply to if created </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>p</em>&nbsp;</td><td>The pool to use when creating the sdbm </td></tr>
+    <tr><td valign="top"></td><td valign="top"><em>db</em>&nbsp;</td><td>The database to close </td></tr>
   </table>
 </dl>
-<dl class="remark" compact><dt><b>Remarks:</b></dt><dd>The sdbm name is not a true file name, as sdbm appends suffixes for seperate data and index files.</dd></dl>
-Close an sdbm file previously opened by apr_sdbm_open <dl compact><dt><b>Parameters:</b></dt><dd>
+
+</div>
+</div><p>
+<a class="anchor" name="g5744462c07c40d26c275beaeb902ff9c"></a><!-- doxytag: member="apr_sdbm.h::apr_sdbm_delete" ref="g5744462c07c40d26c275beaeb902ff9c" args="(apr_sdbm_t *db, const apr_sdbm_datum_t key)" -->
+<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_sdbm_delete           </td>
+          <td>(</td>
+          <td class="paramtype"><a class="el" href="group___a_p_r___util___d_b_m___s_d_b_m.html#gf24cdea6e4884036a40484259efa68c6">apr_sdbm_t</a> *&nbsp;</td>
+          <td class="paramname"> <em>db</em>, </td>
+        </tr>
+        <tr>
+          <td class="paramkey"></td>
+          <td></td>
+          <td class="paramtype">const <a class="el" href="structapr__sdbm__datum__t.html">apr_sdbm_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>
+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 to close</td></tr>
+    <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>
+
+</div>
+</div><p>
+<a class="anchor" name="g7d9eae450e9f9a2f1bcf626a3f8ca43f"></a><!-- doxytag: member="apr_sdbm.h::apr_sdbm_fetch" ref="g7d9eae450e9f9a2f1bcf626a3f8ca43f" args="(apr_sdbm_t *db, apr_sdbm_datum_t *value, apr_sdbm_datum_t key)" -->
+<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_sdbm_fetch           </td>
+          <td>(</td>
+          <td class="paramtype"><a class="el" href="group___a_p_r___util___d_b_m___s_d_b_m.html#gf24cdea6e4884036a40484259efa68c6">apr_sdbm_t</a> *&nbsp;</td>
+          <td class="paramname"> <em>db</em>, </td>
+        </tr>
+        <tr>
+          <td class="paramkey"></td>
+          <td></td>
+          <td class="paramtype"><a class="el" href="structapr__sdbm__datum__t.html">apr_sdbm_datum_t</a> *&nbsp;</td>
+          <td class="paramname"> <em>value</em>, </td>
+        </tr>
+        <tr>
+          <td class="paramkey"></td>
+          <td></td>
+          <td class="paramtype"><a class="el" href="structapr__sdbm__datum__t.html">apr_sdbm_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>
+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>
+
+</div>
+</div><p>
+<a class="anchor" name="ge5410d9dc681393e597f492f30c6447f"></a><!-- doxytag: member="apr_sdbm.h::apr_sdbm_firstkey" ref="ge5410d9dc681393e597f492f30c6447f" args="(apr_sdbm_t *db, apr_sdbm_datum_t *key)" -->
+<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_sdbm_firstkey           </td>
+          <td>(</td>
+          <td class="paramtype"><a class="el" href="group___a_p_r___util___d_b_m___s_d_b_m.html#gf24cdea6e4884036a40484259efa68c6">apr_sdbm_t</a> *&nbsp;</td>
+          <td class="paramname"> <em>db</em>, </td>
+        </tr>
+        <tr>
+          <td class="paramkey"></td>
+          <td></td>
+          <td class="paramtype"><a class="el" href="structapr__sdbm__datum__t.html">apr_sdbm_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>
+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>
+
+</div>
+</div><p>
+<a class="anchor" name="g2c2edd6a123d8ca2a6334fa8874b724d"></a><!-- doxytag: member="apr_sdbm.h::apr_sdbm_lock" ref="g2c2edd6a123d8ca2a6334fa8874b724d" args="(apr_sdbm_t *db, int type)" -->
+<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_sdbm_lock           </td>
+          <td>(</td>
+          <td class="paramtype"><a class="el" href="group___a_p_r___util___d_b_m___s_d_b_m.html#gf24cdea6e4884036a40484259efa68c6">apr_sdbm_t</a> *&nbsp;</td>
+          <td class="paramname"> <em>db</em>, </td>
+        </tr>
+        <tr>
+          <td class="paramkey"></td>
+          <td></td>
+          <td class="paramtype">int&nbsp;</td>
+          <td class="paramname"> <em>type</em></td><td>&nbsp;</td>
+        </tr>
+        <tr>
+          <td></td>
+          <td>)</td>
+          <td></td><td></td><td></td>
+        </tr>
+      </table>
+</div>
+<div class="memdoc">
+
+<p>
 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>
@@ -214,19 +330,172 @@
  </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>
+<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>
+
+</div>
+</div><p>
+<a class="anchor" name="g77d7f848ccb68e9f465a988d0af80911"></a><!-- doxytag: member="apr_sdbm.h::apr_sdbm_nextkey" ref="g77d7f848ccb68e9f465a988d0af80911" args="(apr_sdbm_t *db, apr_sdbm_datum_t *key)" -->
+<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_sdbm_nextkey           </td>
+          <td>(</td>
+          <td class="paramtype"><a class="el" href="group___a_p_r___util___d_b_m___s_d_b_m.html#gf24cdea6e4884036a40484259efa68c6">apr_sdbm_t</a> *&nbsp;</td>
+          <td class="paramname"> <em>db</em>, </td>
+        </tr>
+        <tr>
+          <td class="paramkey"></td>
+          <td></td>
+          <td class="paramtype"><a class="el" href="structapr__sdbm__datum__t.html">apr_sdbm_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>
+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 to unlock</td></tr>
+    <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>
-Fetch an sdbm record value by key <dl compact><dt><b>Parameters:</b></dt><dd>
+
+</div>
+</div><p>
+<a class="anchor" name="g08c6121b4159ae86cec6e915e1e5d758"></a><!-- doxytag: member="apr_sdbm.h::apr_sdbm_open" ref="g08c6121b4159ae86cec6e915e1e5d758" args="(apr_sdbm_t **db, const char *name, apr_int32_t mode, apr_fileperms_t perms, apr_pool_t *p)" -->
+<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_sdbm_open           </td>
+          <td>(</td>
+          <td class="paramtype"><a class="el" href="group___a_p_r___util___d_b_m___s_d_b_m.html#gf24cdea6e4884036a40484259efa68c6">apr_sdbm_t</a> **&nbsp;</td>
+          <td class="paramname"> <em>db</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>perms</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>p</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 an sdbm database 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>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>
+    <tr><td valign="top"></td><td valign="top"><em>db</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 sdbm file to open </td></tr>
+    <tr><td valign="top"></td><td valign="top"><em>mode</em>&nbsp;</td><td>The flag values (APR_READ and APR_BINARY flags are implicit) <pre>
+           APR_WRITE          open for read-write access
+           APR_CREATE         create the sdbm if it does not exist
+           APR_TRUNCATE       empty the contents of the sdbm
+           APR_EXCL           fail for APR_CREATE if the file exists
+           APR_DELONCLOSE     delete the sdbm when closed
+           APR_SHARELOCK      support locking across process/machines
+ </pre> </td></tr>
+    <tr><td valign="top"></td><td valign="top"><em>perms</em>&nbsp;</td><td>Permissions to apply to if created </td></tr>
+    <tr><td valign="top"></td><td valign="top"><em>p</em>&nbsp;</td><td>The pool to use when creating the sdbm </td></tr>
   </table>
 </dl>
+<dl class="remark" compact><dt><b>Remarks:</b></dt><dd>The sdbm name is not a true file name, as sdbm appends suffixes for seperate data and index files. </dd></dl>
+
+</div>
+</div><p>
+<a class="anchor" name="gbad67008f83fd219173acc5abdd0b42d"></a><!-- doxytag: member="apr_sdbm.h::apr_sdbm_rdonly" ref="gbad67008f83fd219173acc5abdd0b42d" args="(apr_sdbm_t *db)" -->
+<div class="memitem">
+<div class="memproto">
+      <table class="memname">
+        <tr>
+          <td class="memname">int apr_sdbm_rdonly           </td>
+          <td>(</td>
+          <td class="paramtype"><a class="el" href="group___a_p_r___util___d_b_m___s_d_b_m.html#gf24cdea6e4884036a40484259efa68c6">apr_sdbm_t</a> *&nbsp;</td>
+          <td class="paramname"> <em>db</em>          </td>
+          <td>&nbsp;)&nbsp;</td>
+          <td></td>
+        </tr>
+      </table>
+</div>
+<div class="memdoc">
+
+<p>
+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>
+
+</div>
+</div><p>
+<a class="anchor" name="gc12993b882c50afa0777945ea4a88572"></a><!-- doxytag: member="apr_sdbm.h::apr_sdbm_store" ref="gc12993b882c50afa0777945ea4a88572" args="(apr_sdbm_t *db, apr_sdbm_datum_t key, apr_sdbm_datum_t value, int opt)" -->
+<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_sdbm_store           </td>
+          <td>(</td>
+          <td class="paramtype"><a class="el" href="group___a_p_r___util___d_b_m___s_d_b_m.html#gf24cdea6e4884036a40484259efa68c6">apr_sdbm_t</a> *&nbsp;</td>
+          <td class="paramname"> <em>db</em>, </td>
+        </tr>
+        <tr>
+          <td class="paramkey"></td>
+          <td></td>
+          <td class="paramtype"><a class="el" href="structapr__sdbm__datum__t.html">apr_sdbm_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__sdbm__datum__t.html">apr_sdbm_datum_t</a>&nbsp;</td>
+          <td class="paramname"> <em>value</em>, </td>
+        </tr>
+        <tr>
+          <td class="paramkey"></td>
+          <td></td>
+          <td class="paramtype">int&nbsp;</td>
+          <td class="paramname"> <em>opt</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 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>
@@ -235,39 +504,39 @@
     <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>
+ </pre> </td></tr>
   </table>
 </dl>
-Returns true if the sdbm database opened for read-only access <dl compact><dt><b>Parameters:</b></dt><dd>
+
+</div>
+</div><p>
+<a class="anchor" name="gb96a7e08ddac3cb6bff97a822b68de14"></a><!-- doxytag: member="apr_sdbm.h::apr_sdbm_unlock" ref="gb96a7e08ddac3cb6bff97a822b68de14" args="(apr_sdbm_t *db)" -->
+<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_sdbm_unlock           </td>
+          <td>(</td>
+          <td class="paramtype"><a class="el" href="group___a_p_r___util___d_b_m___s_d_b_m.html#gf24cdea6e4884036a40484259efa68c6">apr_sdbm_t</a> *&nbsp;</td>
+          <td class="paramname"> <em>db</em>          </td>
+          <td>&nbsp;)&nbsp;</td>
+          <td></td>
+        </tr>
+      </table>
+</div>
+<div class="memdoc">
+
+<p>
+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 test </td></tr>
+    <tr><td valign="top"></td><td valign="top"><em>db</em>&nbsp;</td><td>The database to unlock </td></tr>
   </table>
 </dl>
 
 </div>
 </div><p>
 </div>
-<hr size="1"><address style="text-align: right;"><small>Generated on Mon Jun 15 09:45:30 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>

Modified: apr/site/trunk/docs/docs/apr/trunk/group___a_p_r___util___date.html
URL: http://svn.apache.org/viewvc/apr/site/trunk/docs/docs/apr/trunk/group___a_p_r___util___date.html?rev=794511&r1=794510&r2=794511&view=diff
==============================================================================
--- apr/site/trunk/docs/docs/apr/trunk/group___a_p_r___util___date.html (original)
+++ apr/site/trunk/docs/docs/apr/trunk/group___a_p_r___util___date.html Thu Jul 16 03:44:20 2009
@@ -28,13 +28,11 @@
 <tr><td class="memItemLeft" nowrap align="right" valign="top">#define&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___date.html#g8be88b25f4b477ad13c4067c959411b0">APR_DATE_BAD</a>&nbsp;&nbsp;&nbsp;((<a class="el" href="group__apr__time.html#gdb4bde16055748190eae190c55aa02bb">apr_time_t</a>)0)</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___date.html#g4a4f99fb264d6c243cbbcb106c8e08c7">APU_DECLARE</a> (int) apr_date_checkmask(const char *data</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___date.html#g6576e5747a46f262c54dc4286f65d6f8">apr_date_checkmask</a> (const char *data, const char *mask)</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___date.html#g9e15cdbb028ab9a85bfcc48eb7e842e9">APU_DECLARE</a> (<a class="el" href="group__apr__time.html#gdb4bde16055748190eae190c55aa02bb">apr_time_t</a>) apr_date_parse_http(const char *date)</td></tr>
+<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="group__apr__time.html#gdb4bde16055748190eae190c55aa02bb">apr_time_t</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___date.html#gbd0ad0c1000ed8c95fb6a9660aed27c6">apr_date_parse_http</a> (const char *date)</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="g6bd7250007a3cfeadacf370fbf68cf5a"></a><!-- doxytag: member="APR_Util_Date::mask" ref="g6bd7250007a3cfeadacf370fbf68cf5a" args="" -->
-const char *&nbsp;</td><td class="memItemRight" valign="bottom"><b>mask</b></td></tr>
+<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="group__apr__time.html#gdb4bde16055748190eae190c55aa02bb">apr_time_t</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___date.html#ga6d4a18ff9f40c37c0f145d063c50e96">apr_date_parse_rfc</a> (const char *date)</td></tr>
 
 </table>
 <hr><h2>Define Documentation</h2>
@@ -54,17 +52,61 @@
 </div>
 </div><p>
 <hr><h2>Function Documentation</h2>
-<a class="anchor" name="g9e15cdbb028ab9a85bfcc48eb7e842e9"></a><!-- doxytag: member="apr_date.h::APU_DECLARE" ref="g9e15cdbb028ab9a85bfcc48eb7e842e9" args="(apr_time_t) apr_date_parse_http(const char *date)" -->
+<a class="anchor" name="g6576e5747a46f262c54dc4286f65d6f8"></a><!-- doxytag: member="apr_date.h::apr_date_checkmask" ref="g6576e5747a46f262c54dc4286f65d6f8" args="(const char *data, const char *mask)" -->
 <div class="memitem">
 <div class="memproto">
       <table class="memname">
         <tr>
-          <td class="memname">APU_DECLARE           </td>
+          <td class="memname">int apr_date_checkmask           </td>
           <td>(</td>
-          <td class="paramtype"><a class="el" href="group__apr__time.html#gdb4bde16055748190eae190c55aa02bb">apr_time_t</a>&nbsp;</td>
-          <td class="paramname">          </td>
+          <td class="paramtype">const char *&nbsp;</td>
+          <td class="paramname"> <em>data</em>, </td>
+        </tr>
+        <tr>
+          <td class="paramkey"></td>
+          <td></td>
+          <td class="paramtype">const char *&nbsp;</td>
+          <td class="paramname"> <em>mask</em></td><td>&nbsp;</td>
+        </tr>
+        <tr>
+          <td></td>
+          <td>)</td>
+          <td></td><td></td><td></td>
+        </tr>
+      </table>
+</div>
+<div class="memdoc">
+
+<p>
+Compare a string to a mask <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 string to compare </td></tr>
+    <tr><td valign="top"></td><td valign="top"><em>mask</em>&nbsp;</td><td>Mask characters (arbitrary maximum is 256 characters): <pre>
+   '@' - uppercase letter
+   '$' - lowercase letter
+   '&amp;' - hex digit
+   '#' - digit
+   '~' - digit or space
+   '*' - swallow remaining characters
+ </pre> </td></tr>
+  </table>
+</dl>
+<dl class="remark" compact><dt><b>Remarks:</b></dt><dd>The mask tests for an exact match for any other character </dd></dl>
+<dl class="return" compact><dt><b>Returns:</b></dt><dd>1 if the string matches, 0 otherwise </dd></dl>
+
+</div>
+</div><p>
+<a class="anchor" name="gbd0ad0c1000ed8c95fb6a9660aed27c6"></a><!-- doxytag: member="apr_date.h::apr_date_parse_http" ref="gbd0ad0c1000ed8c95fb6a9660aed27c6" args="(const char *date)" -->
+<div class="memitem">
+<div class="memproto">
+      <table class="memname">
+        <tr>
+          <td class="memname"><a class="el" href="group__apr__time.html#gdb4bde16055748190eae190c55aa02bb">apr_time_t</a> apr_date_parse_http           </td>
+          <td>(</td>
+          <td class="paramtype">const char *&nbsp;</td>
+          <td class="paramname"> <em>date</em>          </td>
           <td>&nbsp;)&nbsp;</td>
-          <td> const</td>
+          <td></td>
         </tr>
       </table>
 </div>
@@ -80,66 +122,51 @@
     <tr><td valign="top"></td><td valign="top"><em>date</em>&nbsp;</td><td>The date in one of the three formats above </td></tr>
   </table>
 </dl>
-<dl class="return" compact><dt><b>Returns:</b></dt><dd>the apr_time_t number of microseconds since 1 Jan 1970 GMT, or 0 if this would be out of range or if the date is invalid.</dd></dl>
-Parses a string resembling an RFC 822 date. This is meant to be leinent in its parsing of dates. Hence, this will parse a wider range of dates than apr_date_parse_http.<p>
-The prominent mailer (or poster, if mailer is unknown) that has been seen in the wild is included for the unknown formats. <pre>
-     Sun, 06 Nov 1994 08:49:37 GMT  ; RFC 822, updated by RFC 1123
-     Sunday, 06-Nov-94 08:49:37 GMT ; RFC 850, obsoleted by RFC 1036
-     Sun Nov  6 08:49:37 1994       ; ANSI C's asctime() format
-     Sun, 6 Nov 1994 08:49:37 GMT   ; RFC 822, updated by RFC 1123
-     Sun, 06 Nov 94 08:49:37 GMT    ; RFC 822
-     Sun, 6 Nov 94 08:49:37 GMT     ; RFC 822
-     Sun, 06 Nov 94 08:49 GMT       ; Unknown [drtr@ast.cam.ac.uk] 
-     Sun, 6 Nov 94 08:49 GMT        ; Unknown [drtr@ast.cam.ac.uk]
-     Sun, 06 Nov 94 8:49:37 GMT     ; Unknown [Elm 70.85]
-     Sun, 6 Nov 94 8:49:37 GMT      ; Unknown [Elm 70.85] 
- </pre><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>date</em>&nbsp;</td><td>The date in one of the formats above </td></tr>
-  </table>
-</dl>
 <dl class="return" compact><dt><b>Returns:</b></dt><dd>the apr_time_t number of microseconds since 1 Jan 1970 GMT, or 0 if this would be out of range or if the date is invalid. </dd></dl>
 
 </div>
 </div><p>
-<a class="anchor" name="g4a4f99fb264d6c243cbbcb106c8e08c7"></a><!-- doxytag: member="apr_date.h::APU_DECLARE" ref="g4a4f99fb264d6c243cbbcb106c8e08c7" args="(int) apr_date_checkmask(const char *data" -->
+<a class="anchor" name="ga6d4a18ff9f40c37c0f145d063c50e96"></a><!-- doxytag: member="apr_date.h::apr_date_parse_rfc" ref="ga6d4a18ff9f40c37c0f145d063c50e96" args="(const char *date)" -->
 <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__time.html#gdb4bde16055748190eae190c55aa02bb">apr_time_t</a> apr_date_parse_rfc           </td>
           <td>(</td>
-          <td class="paramtype">int&nbsp;</td>
-          <td class="paramname">          </td>
+          <td class="paramtype">const char *&nbsp;</td>
+          <td class="paramname"> <em>date</em>          </td>
           <td>&nbsp;)&nbsp;</td>
-          <td> const</td>
+          <td></td>
         </tr>
       </table>
 </div>
 <div class="memdoc">
 
 <p>
-Compare a string to a mask <dl compact><dt><b>Parameters:</b></dt><dd>
+Parses a string resembling an RFC 822 date. This is meant to be leinent in its parsing of dates. Hence, this will parse a wider range of dates than apr_date_parse_http.<p>
+The prominent mailer (or poster, if mailer is unknown) that has been seen in the wild is included for the unknown formats. <pre>
+     Sun, 06 Nov 1994 08:49:37 GMT  ; RFC 822, updated by RFC 1123
+     Sunday, 06-Nov-94 08:49:37 GMT ; RFC 850, obsoleted by RFC 1036
+     Sun Nov  6 08:49:37 1994       ; ANSI C's asctime() format
+     Sun, 6 Nov 1994 08:49:37 GMT   ; RFC 822, updated by RFC 1123
+     Sun, 06 Nov 94 08:49:37 GMT    ; RFC 822
+     Sun, 6 Nov 94 08:49:37 GMT     ; RFC 822
+     Sun, 06 Nov 94 08:49 GMT       ; Unknown [drtr@ast.cam.ac.uk] 
+     Sun, 6 Nov 94 08:49 GMT        ; Unknown [drtr@ast.cam.ac.uk]
+     Sun, 06 Nov 94 8:49:37 GMT     ; Unknown [Elm 70.85]
+     Sun, 6 Nov 94 8:49:37 GMT      ; Unknown [Elm 70.85] 
+ </pre><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>data</em>&nbsp;</td><td>The string to compare </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>mask</em>&nbsp;</td><td>Mask characters (arbitrary maximum is 256 characters): <pre>
-   '@' - uppercase letter
-   '$' - lowercase letter
-   '&amp;' - hex digit
-   '#' - digit
-   '~' - digit or space
-   '*' - swallow remaining characters
- </pre> </td></tr>
+    <tr><td valign="top"></td><td valign="top"><em>date</em>&nbsp;</td><td>The date in one of the formats above </td></tr>
   </table>
 </dl>
-<dl class="remark" compact><dt><b>Remarks:</b></dt><dd>The mask tests for an exact match for any other character </dd></dl>
-<dl class="return" compact><dt><b>Returns:</b></dt><dd>1 if the string matches, 0 otherwise </dd></dl>
+<dl class="return" compact><dt><b>Returns:</b></dt><dd>the apr_time_t number of microseconds since 1 Jan 1970 GMT, or 0 if this would be out of range or if the date is invalid. </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>

Modified: apr/site/trunk/docs/docs/apr/trunk/group___a_p_r___util___error.html
URL: http://svn.apache.org/viewvc/apr/site/trunk/docs/docs/apr/trunk/group___a_p_r___util___error.html?rev=794511&r1=794510&r2=794511&view=diff
==============================================================================
--- apr/site/trunk/docs/docs/apr/trunk/group___a_p_r___util___error.html (original)
+++ apr/site/trunk/docs/docs/apr/trunk/group___a_p_r___util___error.html Thu Jul 16 03:44:20 2009
@@ -527,7 +527,7 @@
 </div>
 </div><p>
 </div>
-<hr size="1"><address style="text-align: right;"><small>Generated on Mon Jun 15 09:45:31 2009 for Apache Portable Runtime by&nbsp;
+<hr size="1"><address style="text-align: right;"><small>Generated on Thu Jul 16 13:37:24 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>

Modified: apr/site/trunk/docs/docs/apr/trunk/group___a_p_r___util___f_i_f_o.html
URL: http://svn.apache.org/viewvc/apr/site/trunk/docs/docs/apr/trunk/group___a_p_r___util___f_i_f_o.html?rev=794511&r1=794510&r2=794511&view=diff
==============================================================================
--- apr/site/trunk/docs/docs/apr/trunk/group___a_p_r___util___f_i_f_o.html (original)
+++ apr/site/trunk/docs/docs/apr/trunk/group___a_p_r___util___f_i_f_o.html Thu Jul 16 03:44:20 2009
@@ -28,19 +28,21 @@
 <tr><td class="memItemLeft" nowrap align="right" valign="top">typedef struct <a class="el" href="group___a_p_r___util___f_i_f_o.html#g8c74c22abf47b63555a2109b06f83abb">apr_queue_t</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___f_i_f_o.html#g8c74c22abf47b63555a2109b06f83abb">apr_queue_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___f_i_f_o.html#g800ac20c5c4e08fbf81a0faae86faa80">APU_DECLARE</a> (<a class="el" href="group__apr__errno.html#gf76ee4543247e9fb3f3546203e590a6c">apr_status_t</a>) apr_queue_create(<a class="el" href="group___a_p_r___util___f_i_f_o.html#g8c74c22abf47b63555a2109b06f83abb">apr_queue_t</a> **queue</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___f_i_f_o.html#g9c8c5ec3d8779a6c2ffffb8b74f784c7">apr_queue_create</a> (<a class="el" href="group___a_p_r___util___f_i_f_o.html#g8c74c22abf47b63555a2109b06f83abb">apr_queue_t</a> **queue, unsigned int queue_capacity, <a class="el" href="group__apr__pools.html#gf137f28edcf9a086cd6bc36c20d7cdfb">apr_pool_t</a> *a)</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___f_i_f_o.html#g60727407a451e3eb4f7cc9939fc5b179">APU_DECLARE</a> (unsigned int) apr_queue_size(<a class="el" href="group___a_p_r___util___f_i_f_o.html#g8c74c22abf47b63555a2109b06f83abb">apr_queue_t</a> *queue)</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___f_i_f_o.html#g220fffb8eb2f23aa2fe626b64076df88">apr_queue_push</a> (<a class="el" href="group___a_p_r___util___f_i_f_o.html#g8c74c22abf47b63555a2109b06f83abb">apr_queue_t</a> *queue, void *data)</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="g6c5bb4d7cf58c4fb29851ac07e165e9f"></a><!-- doxytag: member="APR_Util_FIFO::queue_capacity" ref="g6c5bb4d7cf58c4fb29851ac07e165e9f" args="" -->
-unsigned int&nbsp;</td><td class="memItemRight" valign="bottom"><b>queue_capacity</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___f_i_f_o.html#g302387f5afb71d3c771b76448088bd34">apr_queue_pop</a> (<a class="el" href="group___a_p_r___util___f_i_f_o.html#g8c74c22abf47b63555a2109b06f83abb">apr_queue_t</a> *queue, void **data)</td></tr>
 
-<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="geed3ca2b8c395737bb0893a0ea915f52"></a><!-- doxytag: member="APR_Util_FIFO::a" ref="geed3ca2b8c395737bb0893a0ea915f52" args="" -->
-unsigned int <a class="el" href="group__apr__pools.html#gf137f28edcf9a086cd6bc36c20d7cdfb">apr_pool_t</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><b>a</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___f_i_f_o.html#gba8216476d7e5abc3a5ec8a47adf96d5">apr_queue_trypush</a> (<a class="el" href="group___a_p_r___util___f_i_f_o.html#g8c74c22abf47b63555a2109b06f83abb">apr_queue_t</a> *queue, void *data)</td></tr>
 
-<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="gf00cdd742d205932a8309628d39efd5e"></a><!-- doxytag: member="APR_Util_FIFO::data" ref="gf00cdd742d205932a8309628d39efd5e" args="" -->
-void *&nbsp;</td><td class="memItemRight" valign="bottom"><b>data</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___f_i_f_o.html#g128207222433384f286f61ec806f4af8">apr_queue_trypop</a> (<a class="el" href="group___a_p_r___util___f_i_f_o.html#g8c74c22abf47b63555a2109b06f83abb">apr_queue_t</a> *queue, void **data)</td></tr>
+
+<tr><td class="memItemLeft" nowrap align="right" valign="top">unsigned int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___f_i_f_o.html#gf342a2e2ec195a30d6d8c9d95fbfbc30">apr_queue_size</a> (<a class="el" href="group___a_p_r___util___f_i_f_o.html#g8c74c22abf47b63555a2109b06f83abb">apr_queue_t</a> *queue)</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___f_i_f_o.html#g8757c7f87105e6ff4cf1ea5ac28dd26f">apr_queue_interrupt_all</a> (<a class="el" href="group___a_p_r___util___f_i_f_o.html#g8c74c22abf47b63555a2109b06f83abb">apr_queue_t</a> *queue)</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___f_i_f_o.html#gbb8115bceb96a41df3e21544ce79bc68">apr_queue_term</a> (<a class="el" href="group___a_p_r___util___f_i_f_o.html#g8c74c22abf47b63555a2109b06f83abb">apr_queue_t</a> *queue)</td></tr>
 
 </table>
 <hr><h2>Typedef Documentation</h2>
@@ -60,15 +62,57 @@
 </div>
 </div><p>
 <hr><h2>Function Documentation</h2>
-<a class="anchor" name="g60727407a451e3eb4f7cc9939fc5b179"></a><!-- doxytag: member="apr_queue.h::APU_DECLARE" ref="g60727407a451e3eb4f7cc9939fc5b179" args="(unsigned int) apr_queue_size(apr_queue_t *queue)" -->
+<a class="anchor" name="g9c8c5ec3d8779a6c2ffffb8b74f784c7"></a><!-- doxytag: member="apr_queue.h::apr_queue_create" ref="g9c8c5ec3d8779a6c2ffffb8b74f784c7" args="(apr_queue_t **queue, unsigned int queue_capacity, apr_pool_t *a)" -->
+<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_queue_create           </td>
+          <td>(</td>
+          <td class="paramtype"><a class="el" href="group___a_p_r___util___f_i_f_o.html#g8c74c22abf47b63555a2109b06f83abb">apr_queue_t</a> **&nbsp;</td>
+          <td class="paramname"> <em>queue</em>, </td>
+        </tr>
+        <tr>
+          <td class="paramkey"></td>
+          <td></td>
+          <td class="paramtype">unsigned int&nbsp;</td>
+          <td class="paramname"> <em>queue_capacity</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>a</em></td><td>&nbsp;</td>
+        </tr>
+        <tr>
+          <td></td>
+          <td>)</td>
+          <td></td><td></td><td></td>
+        </tr>
+      </table>
+</div>
+<div class="memdoc">
+
+<p>
+create a FIFO queue <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 new queue </td></tr>
+    <tr><td valign="top"></td><td valign="top"><em>queue_capacity</em>&nbsp;</td><td>maximum size of the queue </td></tr>
+    <tr><td valign="top"></td><td valign="top"><em>a</em>&nbsp;</td><td>pool to allocate queue from </td></tr>
+  </table>
+</dl>
+
+</div>
+</div><p>
+<a class="anchor" name="g8757c7f87105e6ff4cf1ea5ac28dd26f"></a><!-- doxytag: member="apr_queue.h::apr_queue_interrupt_all" ref="g8757c7f87105e6ff4cf1ea5ac28dd26f" args="(apr_queue_t *queue)" -->
 <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_queue_interrupt_all           </td>
           <td>(</td>
-          <td class="paramtype">unsigned&nbsp;</td>
-          <td class="paramname"> <em>int</em>          </td>
+          <td class="paramtype"><a class="el" href="group___a_p_r___util___f_i_f_o.html#g8c74c22abf47b63555a2109b06f83abb">apr_queue_t</a> *&nbsp;</td>
+          <td class="paramname"> <em>queue</em>          </td>
           <td>&nbsp;)&nbsp;</td>
           <td></td>
         </tr>
@@ -77,41 +121,80 @@
 <div class="memdoc">
 
 <p>
-returns the size of the queue.<p>
-<dl class="warning" compact><dt><b>Warning:</b></dt><dd>this is not threadsafe, and is intended for reporting/monitoring of the queue. </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>
-<dl class="return" compact><dt><b>Returns:</b></dt><dd>the size of the queue </dd></dl>
 
 </div>
 </div><p>
-<a class="anchor" name="g800ac20c5c4e08fbf81a0faae86faa80"></a><!-- doxytag: member="apr_queue.h::APU_DECLARE" ref="g800ac20c5c4e08fbf81a0faae86faa80" args="(apr_status_t) apr_queue_create(apr_queue_t **queue" -->
+<a class="anchor" name="g302387f5afb71d3c771b76448088bd34"></a><!-- doxytag: member="apr_queue.h::apr_queue_pop" ref="g302387f5afb71d3c771b76448088bd34" args="(apr_queue_t *queue, void **data)" -->
 <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_queue_pop           </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="group___a_p_r___util___f_i_f_o.html#g8c74c22abf47b63555a2109b06f83abb">apr_queue_t</a> *&nbsp;</td>
+          <td class="paramname"> <em>queue</em>, </td>
+        </tr>
+        <tr>
+          <td class="paramkey"></td>
+          <td></td>
+          <td class="paramtype">void **&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>
-create a FIFO queue <dl compact><dt><b>Parameters:</b></dt><dd>
+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 new queue </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>queue_capacity</em>&nbsp;</td><td>maximum size of the queue </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>a</em>&nbsp;</td><td>pool to allocate queue from</td></tr>
+    <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>
+
+</div>
+</div><p>
+<a class="anchor" name="g220fffb8eb2f23aa2fe626b64076df88"></a><!-- doxytag: member="apr_queue.h::apr_queue_push" ref="g220fffb8eb2f23aa2fe626b64076df88" args="(apr_queue_t *queue, void *data)" -->
+<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_queue_push           </td>
+          <td>(</td>
+          <td class="paramtype"><a class="el" href="group___a_p_r___util___f_i_f_o.html#g8c74c22abf47b63555a2109b06f83abb">apr_queue_t</a> *&nbsp;</td>
+          <td class="paramname"> <em>queue</em>, </td>
+        </tr>
+        <tr>
+          <td class="paramkey"></td>
+          <td></td>
+          <td class="paramtype">void *&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>
 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">
@@ -121,28 +204,90 @@
 </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>
+APR_SUCCESS on a successful push </dd></dl>
+
+</div>
+</div><p>
+<a class="anchor" name="gf342a2e2ec195a30d6d8c9d95fbfbc30"></a><!-- doxytag: member="apr_queue.h::apr_queue_size" ref="gf342a2e2ec195a30d6d8c9d95fbfbc30" args="(apr_queue_t *queue)" -->
+<div class="memitem">
+<div class="memproto">
+      <table class="memname">
+        <tr>
+          <td class="memname">unsigned int apr_queue_size           </td>
+          <td>(</td>
+          <td class="paramtype"><a class="el" href="group___a_p_r___util___f_i_f_o.html#g8c74c22abf47b63555a2109b06f83abb">apr_queue_t</a> *&nbsp;</td>
+          <td class="paramname"> <em>queue</em>          </td>
+          <td>&nbsp;)&nbsp;</td>
+          <td></td>
+        </tr>
+      </table>
+</div>
+<div class="memdoc">
+
+<p>
+returns the size of the queue.<p>
+<dl class="warning" compact><dt><b>Warning:</b></dt><dd>this is not threadsafe, and is intended for reporting/monitoring of the queue. </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>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 class="return" compact><dt><b>Returns:</b></dt><dd>the size of the queue </dd></dl>
+
+</div>
+</div><p>
+<a class="anchor" name="gbb8115bceb96a41df3e21544ce79bc68"></a><!-- doxytag: member="apr_queue.h::apr_queue_term" ref="gbb8115bceb96a41df3e21544ce79bc68" args="(apr_queue_t *queue)" -->
+<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_queue_term           </td>
+          <td>(</td>
+          <td class="paramtype"><a class="el" href="group___a_p_r___util___f_i_f_o.html#g8c74c22abf47b63555a2109b06f83abb">apr_queue_t</a> *&nbsp;</td>
+          <td class="paramname"> <em>queue</em>          </td>
+          <td>&nbsp;)&nbsp;</td>
+          <td></td>
+        </tr>
+      </table>
+</div>
+<div class="memdoc">
+
+<p>
+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>
-    <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>
+
+</div>
+</div><p>
+<a class="anchor" name="g128207222433384f286f61ec806f4af8"></a><!-- doxytag: member="apr_queue.h::apr_queue_trypop" ref="g128207222433384f286f61ec806f4af8" args="(apr_queue_t *queue, void **data)" -->
+<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_queue_trypop           </td>
+          <td>(</td>
+          <td class="paramtype"><a class="el" href="group___a_p_r___util___f_i_f_o.html#g8c74c22abf47b63555a2109b06f83abb">apr_queue_t</a> *&nbsp;</td>
+          <td class="paramname"> <em>queue</em>, </td>
+        </tr>
+        <tr>
+          <td class="paramkey"></td>
+          <td></td>
+          <td class="paramtype">void **&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>
 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">
@@ -153,24 +298,52 @@
 <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>
+APR_SUCCESS on a successful push </dd></dl>
+
+</div>
+</div><p>
+<a class="anchor" name="gba8216476d7e5abc3a5ec8a47adf96d5"></a><!-- doxytag: member="apr_queue.h::apr_queue_trypush" ref="gba8216476d7e5abc3a5ec8a47adf96d5" args="(apr_queue_t *queue, void *data)" -->
+<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_queue_trypush           </td>
+          <td>(</td>
+          <td class="paramtype"><a class="el" href="group___a_p_r___util___f_i_f_o.html#g8c74c22abf47b63555a2109b06f83abb">apr_queue_t</a> *&nbsp;</td>
+          <td class="paramname"> <em>queue</em>, </td>
+        </tr>
+        <tr>
+          <td class="paramkey"></td>
+          <td></td>
+          <td class="paramtype">void *&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>
+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>
 
 </div>
 </div><p>
 </div>
-<hr size="1"><address style="text-align: right;"><small>Generated on Mon Jun 15 09:45:30 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>

Modified: apr/site/trunk/docs/docs/apr/trunk/group___a_p_r___util___hook.html
URL: http://svn.apache.org/viewvc/apr/site/trunk/docs/docs/apr/trunk/group___a_p_r___util___hook.html?rev=794511&r1=794510&r2=794511&view=diff
==============================================================================
--- apr/site/trunk/docs/docs/apr/trunk/group___a_p_r___util___hook.html (original)
+++ apr/site/trunk/docs/docs/apr/trunk/group___a_p_r___util___hook.html Thu Jul 16 03:44:20 2009
@@ -55,24 +55,20 @@
 <tr><td class="memItemLeft" nowrap align="right" valign="top">#define&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___hook.html#ge3c7d2cf35e8c89828dfff7a85b0ed77">APR_HOOK_REALLY_LAST</a>&nbsp;&nbsp;&nbsp;30</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___hook.html#gcf87dbe12a026276bca80232961576e6">APU_DECLARE</a> (void) apr_hook_sort_register(const char *szHookName</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___hook.html#g04843fe00dc3c08c23130fef3ba1260c">apr_hook_sort_register</a> (const char *szHookName, <a class="el" href="structapr__array__header__t.html">apr_array_header_t</a> **aHooks)</td></tr>
 
-<tr><td colspan="2"><br><h2>Variables</h2></td></tr>
-<tr><td class="memItemLeft" nowrap align="right" valign="top">APU_DECLARE_DATA <a class="el" href="group__apr__pools.html#gf137f28edcf9a086cd6bc36c20d7cdfb">apr_pool_t</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___hook.html#gbef8cf5f8a4528192b0aa66200b09ccc">apr_hook_global_pool</a></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___hook.html#g1e0b6cf91dac5417c1b9cbd1b46b8991">apr_hook_sort_all</a> (void)</td></tr>
 
-<tr><td class="memItemLeft" nowrap align="right" valign="top">APU_DECLARE_DATA int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___hook.html#g26d9c49c3b7bd6717b7156c359d16f99">apr_hook_debug_enabled</a></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___hook.html#g1de31557683f53c2a07f73990962c585">apr_hook_debug_show</a> (const char *szName, const char *const *aszPre, const char *const *aszSucc)</td></tr>
 
-<tr><td class="memItemLeft" nowrap align="right" valign="top">APU_DECLARE_DATA const char *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___hook.html#g00ffe8fc20d32058fbdda6b3a4fe4fd3">apr_hook_debug_current</a></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___hook.html#g5d20451da75574c8433feb1bd5b2ce10">apr_hook_deregister_all</a> (void)</td></tr>
 
-<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="g242711e58a02557bca364aa506746d8b"></a><!-- doxytag: member="APR_Util_Hook::aHooks" ref="g242711e58a02557bca364aa506746d8b" args="" -->
-<a class="el" href="structapr__array__header__t.html">apr_array_header_t</a> **&nbsp;</td><td class="memItemRight" valign="bottom"><b>aHooks</b></td></tr>
+<tr><td colspan="2"><br><h2>Variables</h2></td></tr>
+<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="group__apr__pools.html#gf137f28edcf9a086cd6bc36c20d7cdfb">apr_pool_t</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___hook.html#g8911bb699a5f03ad3c36d579ca0eca23">apr_hook_global_pool</a></td></tr>
 
-<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="g8daee2cc4d5ba6e3b82b2f45cc2920a1"></a><!-- doxytag: member="APR_Util_Hook::aszPre" ref="g8daee2cc4d5ba6e3b82b2f45cc2920a1" args="" -->
-const char *const *&nbsp;</td><td class="memItemRight" valign="bottom"><b>aszPre</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___hook.html#g59309caeb9b47d921727530494f264be">apr_hook_debug_enabled</a></td></tr>
 
-<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="g4dedfeea57daba4a4579d174e94e5afc"></a><!-- doxytag: member="APR_Util_Hook::aszSucc" ref="g4dedfeea57daba4a4579d174e94e5afc" args="" -->
-const char *const const char <br class="typebreak">
-*const *&nbsp;</td><td class="memItemRight" valign="bottom"><b>aszSucc</b></td></tr>
+<tr><td class="memItemLeft" nowrap align="right" valign="top">const char *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___hook.html#g37be3c217439ceddbda16054b020a658">apr_hook_debug_current</a></td></tr>
 
 </table>
 <hr><h2>Define Documentation</h2>
@@ -534,17 +530,108 @@
 </div>
 </div><p>
 <hr><h2>Function Documentation</h2>
-<a class="anchor" name="gcf87dbe12a026276bca80232961576e6"></a><!-- doxytag: member="apr_hooks.h::APU_DECLARE" ref="gcf87dbe12a026276bca80232961576e6" args="(void) apr_hook_sort_register(const char *szHookName" -->
+<a class="anchor" name="g1de31557683f53c2a07f73990962c585"></a><!-- doxytag: member="apr_hooks.h::apr_hook_debug_show" ref="g1de31557683f53c2a07f73990962c585" args="(const char *szName, const char *const *aszPre, const char *const *aszSucc)" -->
+<div class="memitem">
+<div class="memproto">
+      <table class="memname">
+        <tr>
+          <td class="memname">void apr_hook_debug_show           </td>
+          <td>(</td>
+          <td class="paramtype">const char *&nbsp;</td>
+          <td class="paramname"> <em>szName</em>, </td>
+        </tr>
+        <tr>
+          <td class="paramkey"></td>
+          <td></td>
+          <td class="paramtype">const char *const *&nbsp;</td>
+          <td class="paramname"> <em>aszPre</em>, </td>
+        </tr>
+        <tr>
+          <td class="paramkey"></td>
+          <td></td>
+          <td class="paramtype">const char *const *&nbsp;</td>
+          <td class="paramname"> <em>aszSucc</em></td><td>&nbsp;</td>
+        </tr>
+        <tr>
+          <td></td>
+          <td>)</td>
+          <td></td><td></td><td></td>
+        </tr>
+      </table>
+</div>
+<div class="memdoc">
+
+<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>
+
+</div>
+</div><p>
+<a class="anchor" name="g5d20451da75574c8433feb1bd5b2ce10"></a><!-- doxytag: member="apr_hooks.h::apr_hook_deregister_all" ref="g5d20451da75574c8433feb1bd5b2ce10" args="(void)" -->
+<div class="memitem">
+<div class="memproto">
+      <table class="memname">
+        <tr>
+          <td class="memname">void apr_hook_deregister_all           </td>
+          <td>(</td>
+          <td class="paramtype">void&nbsp;</td>
+          <td class="paramname">          </td>
+          <td>&nbsp;)&nbsp;</td>
+          <td></td>
+        </tr>
+      </table>
+</div>
+<div class="memdoc">
+
+<p>
+Remove all currently registered functions. 
+</div>
+</div><p>
+<a class="anchor" name="g1e0b6cf91dac5417c1b9cbd1b46b8991"></a><!-- doxytag: member="apr_hooks.h::apr_hook_sort_all" ref="g1e0b6cf91dac5417c1b9cbd1b46b8991" args="(void)" -->
 <div class="memitem">
 <div class="memproto">
       <table class="memname">
         <tr>
-          <td class="memname">APU_DECLARE           </td>
+          <td class="memname">void apr_hook_sort_all           </td>
           <td>(</td>
           <td class="paramtype">void&nbsp;</td>
           <td class="paramname">          </td>
           <td>&nbsp;)&nbsp;</td>
-          <td> const</td>
+          <td></td>
+        </tr>
+      </table>
+</div>
+<div class="memdoc">
+
+<p>
+Sort all of the registerd functions for a given hook 
+</div>
+</div><p>
+<a class="anchor" name="g04843fe00dc3c08c23130fef3ba1260c"></a><!-- doxytag: member="apr_hooks.h::apr_hook_sort_register" ref="g04843fe00dc3c08c23130fef3ba1260c" args="(const char *szHookName, apr_array_header_t **aHooks)" -->
+<div class="memitem">
+<div class="memproto">
+      <table class="memname">
+        <tr>
+          <td class="memname">void apr_hook_sort_register           </td>
+          <td>(</td>
+          <td class="paramtype">const char *&nbsp;</td>
+          <td class="paramname"> <em>szHookName</em>, </td>
+        </tr>
+        <tr>
+          <td class="paramkey"></td>
+          <td></td>
+          <td class="paramtype"><a class="el" href="structapr__array__header__t.html">apr_array_header_t</a> **&nbsp;</td>
+          <td class="paramname"> <em>aHooks</em></td><td>&nbsp;</td>
+        </tr>
+        <tr>
+          <td></td>
+          <td>)</td>
+          <td></td><td></td><td></td>
         </tr>
       </table>
 </div>
@@ -554,27 +641,19 @@
 Register a hook function to be sorted <dl compact><dt><b>Parameters:</b></dt><dd>
   <table border="0" cellspacing="2" cellpadding="0">
     <tr><td valign="top"></td><td valign="top"><em>szHookName</em>&nbsp;</td><td>The name of the Hook the function is registered for </td></tr>
-    <tr><td valign="top"></td><td valign="top"><em>aHooks</em>&nbsp;</td><td>The array which stores all of the functions for this hook</td></tr>
-  </table>
-</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>
+    <tr><td valign="top"></td><td valign="top"><em>aHooks</em>&nbsp;</td><td>The array which stores all of the functions for this hook </td></tr>
   </table>
 </dl>
-Remove all currently registered functions. 
+
 </div>
 </div><p>
 <hr><h2>Variable Documentation</h2>
-<a class="anchor" name="g00ffe8fc20d32058fbdda6b3a4fe4fd3"></a><!-- doxytag: member="apr_hooks.h::apr_hook_debug_current" ref="g00ffe8fc20d32058fbdda6b3a4fe4fd3" args="" -->
+<a class="anchor" name="g37be3c217439ceddbda16054b020a658"></a><!-- doxytag: member="apr_hooks.h::apr_hook_debug_current" ref="g37be3c217439ceddbda16054b020a658" args="" -->
 <div class="memitem">
 <div class="memproto">
       <table class="memname">
         <tr>
-          <td class="memname">APU_DECLARE_DATA const char* <a class="el" href="group___a_p_r___util___hook.html#g00ffe8fc20d32058fbdda6b3a4fe4fd3">apr_hook_debug_current</a>          </td>
+          <td class="memname">const char* <a class="el" href="group___a_p_r___util___hook.html#g37be3c217439ceddbda16054b020a658">apr_hook_debug_current</a>          </td>
         </tr>
       </table>
 </div>
@@ -584,12 +663,12 @@
 The name of the module that is currently registering a function 
 </div>
 </div><p>
-<a class="anchor" name="g26d9c49c3b7bd6717b7156c359d16f99"></a><!-- doxytag: member="apr_hooks.h::apr_hook_debug_enabled" ref="g26d9c49c3b7bd6717b7156c359d16f99" args="" -->
+<a class="anchor" name="g59309caeb9b47d921727530494f264be"></a><!-- doxytag: member="apr_hooks.h::apr_hook_debug_enabled" ref="g59309caeb9b47d921727530494f264be" args="" -->
 <div class="memitem">
 <div class="memproto">
       <table class="memname">
         <tr>
-          <td class="memname">APU_DECLARE_DATA int <a class="el" href="group___a_p_r___util___hook.html#g26d9c49c3b7bd6717b7156c359d16f99">apr_hook_debug_enabled</a>          </td>
+          <td class="memname">int <a class="el" href="group___a_p_r___util___hook.html#g59309caeb9b47d921727530494f264be">apr_hook_debug_enabled</a>          </td>
         </tr>
       </table>
 </div>
@@ -599,12 +678,12 @@
 A global variable to determine if debugging information about the hooks functions should be printed 
 </div>
 </div><p>
-<a class="anchor" name="gbef8cf5f8a4528192b0aa66200b09ccc"></a><!-- doxytag: member="apr_hooks.h::apr_hook_global_pool" ref="gbef8cf5f8a4528192b0aa66200b09ccc" args="" -->
+<a class="anchor" name="g8911bb699a5f03ad3c36d579ca0eca23"></a><!-- doxytag: member="apr_hooks.h::apr_hook_global_pool" ref="g8911bb699a5f03ad3c36d579ca0eca23" args="" -->
 <div class="memitem">
 <div class="memproto">
       <table class="memname">
         <tr>
-          <td class="memname">APU_DECLARE_DATA <a class="el" href="group__apr__pools.html#gf137f28edcf9a086cd6bc36c20d7cdfb">apr_pool_t</a>* <a class="el" href="group___a_p_r___util___hook.html#gbef8cf5f8a4528192b0aa66200b09ccc">apr_hook_global_pool</a>          </td>
+          <td class="memname"><a class="el" href="group__apr__pools.html#gf137f28edcf9a086cd6bc36c20d7cdfb">apr_pool_t</a>* <a class="el" href="group___a_p_r___util___hook.html#g8911bb699a5f03ad3c36d579ca0eca23">apr_hook_global_pool</a>          </td>
         </tr>
       </table>
 </div>
@@ -615,7 +694,7 @@
 </div>
 </div><p>
 </div>
-<hr size="1"><address style="text-align: right;"><small>Generated on Mon Jun 15 09:45:30 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