apr-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From jerenkra...@apache.org
Subject svn commit: r151768 [31/47] - in apr/site/trunk/docs/docs/apr: ./ iconv/ util/
Date Mon, 07 Feb 2005 23:12:15 GMT
Modified: apr/site/trunk/docs/docs/apr/apr__portable_8h.html
URL: http://svn.apache.org/viewcvs/apr/site/trunk/docs/docs/apr/apr__portable_8h.html?view=diff&r1=151767&r2=151768
==============================================================================
--- apr/site/trunk/docs/docs/apr/apr__portable_8h.html (original)
+++ apr/site/trunk/docs/docs/apr/apr__portable_8h.html Mon Feb  7 15:10:17 2005
@@ -3,9 +3,10 @@
 <title>Apache Portable Runtime: apr_portable.h File Reference</title>
 <link href="doxygen.css" rel="stylesheet" type="text/css">
 </head><body>
-<!-- Generated by Doxygen 1.3.8 -->
+<!-- Generated by Doxygen 1.3.7 -->
 <div class="qindex"><a class="qindex" href="index.html">Main&nbsp;Page</a> | <a class="qindex" href="modules.html">Modules</a> | <a class="qindex" href="annotated.html">Data&nbsp;Structures</a> | <a class="qindex" href="files.html">File&nbsp;List</a> | <a class="qindex" href="functions.html">Data&nbsp;Fields</a> | <a class="qindex" href="globals.html">Globals</a> | <a class="qindex" href="pages.html">Related&nbsp;Pages</a></div>
-<h1>apr_portable.h File Reference</h1>APR Portability Routines. <a href="#_details">More...</a>
+<h1>apr_portable.h File Reference</h1>APR Portability Routines.  
+<a href="#_details">More...</a>
 <p>
 <code>#include "apr.h"</code><br>
 <code>#include "<a class="el" href="apr__pools_8h-source.html">apr_pools.h</a>"</code><br>
@@ -54,7 +55,7 @@
 <tr><td class="memItemLeft" nowrap align=right valign=top><a class="anchor" name="ga9" doxytag="apr_portable.h::apr_os_sock_info_t" ></a>
 typedef <a class="el" href="structapr__os__sock__info__t.html">apr_os_sock_info_t</a>&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="group__apr__portabile.html#ga9">apr_os_sock_info_t</a></td></tr>
 
-<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">alias for local OS socket <br></td></tr>
+<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">alias for local OS socket <br><br></td></tr>
 <tr><td colspan=2><br><h2>Functions</h2></td></tr>
 <tr><td class="memItemLeft" nowrap align=right valign=top><a class="el" href="group__apr__errno.html#ga0">apr_status_t</a>&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="group__apr__portabile.html#ga10">apr_os_file_get</a> (<a class="el" href="group__apr__portabile.html#ga0">apr_os_file_t</a> *thefile, <a class="el" href="group__apr__file__io.html#ga2">apr_file_t</a> *file)</td></tr>
 
@@ -114,8 +115,8 @@
 <hr><a name="_details"></a><h2>Detailed Description</h2>
 APR Portability Routines. 
 <p>
-<hr size="1"><address style="align: right;"><small>Generated on Wed Sep 1 21:36:05 2004 for Apache Portable Runtime by
+<hr size="1"><address style="align: right;"><small>Generated on Mon Feb 7 13:18:25 2005 for Apache Portable Runtime by
 <a href="http://www.doxygen.org/index.html">
-<img src="doxygen.png" alt="doxygen" align="middle" border=0 ></a> 1.3.8 </small></address>
+<img src="doxygen.png" alt="doxygen" align="middle" border=0 ></a> 1.3.7 </small></address>
 </body>
 </html>

Modified: apr/site/trunk/docs/docs/apr/apr__proc__mutex_8h-source.html
URL: http://svn.apache.org/viewcvs/apr/site/trunk/docs/docs/apr/apr__proc__mutex_8h-source.html?view=diff&r1=151767&r2=151768
==============================================================================
--- apr/site/trunk/docs/docs/apr/apr__proc__mutex_8h-source.html (original)
+++ apr/site/trunk/docs/docs/apr/apr__proc__mutex_8h-source.html Mon Feb  7 15:10:17 2005
@@ -3,175 +3,176 @@
 <title>Apache Portable Runtime: apr_proc_mutex.h Source File</title>
 <link href="doxygen.css" rel="stylesheet" type="text/css">
 </head><body>
-<!-- Generated by Doxygen 1.3.8 -->
+<!-- Generated by Doxygen 1.3.7 -->
 <div class="qindex"><a class="qindex" href="index.html">Main&nbsp;Page</a> | <a class="qindex" href="modules.html">Modules</a> | <a class="qindex" href="annotated.html">Data&nbsp;Structures</a> | <a class="qindex" href="files.html">File&nbsp;List</a> | <a class="qindex" href="functions.html">Data&nbsp;Fields</a> | <a class="qindex" href="globals.html">Globals</a> | <a class="qindex" href="pages.html">Related&nbsp;Pages</a></div>
-<h1>apr_proc_mutex.h</h1><a href="apr__proc__mutex_8h.html">Go to the documentation of this file.</a><pre class="fragment"><div>00001 <span class="comment">/* Copyright 2000-2004 The Apache Software Foundation</span>
-00002 <span class="comment"> *</span>
-00003 <span class="comment"> * Licensed under the Apache License, Version 2.0 (the "License");</span>
-00004 <span class="comment"> * you may not use this file except in compliance with the License.</span>
-00005 <span class="comment"> * You may obtain a copy of the License at</span>
-00006 <span class="comment"> *</span>
-00007 <span class="comment"> *     http://www.apache.org/licenses/LICENSE-2.0</span>
-00008 <span class="comment"> *</span>
-00009 <span class="comment"> * Unless required by applicable law or agreed to in writing, software</span>
-00010 <span class="comment"> * distributed under the License is distributed on an "AS IS" BASIS,</span>
-00011 <span class="comment"> * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.</span>
-00012 <span class="comment"> * See the License for the specific language governing permissions and</span>
-00013 <span class="comment"> * limitations under the License.</span>
-00014 <span class="comment"> */</span>
-00015 
-00016 <span class="preprocessor">#ifndef APR_PROC_MUTEX_H</span>
-00017 <span class="preprocessor"></span><span class="preprocessor">#define APR_PROC_MUTEX_H</span>
-00018 <span class="preprocessor"></span><span class="comment"></span>
-00019 <span class="comment">/**</span>
-00020 <span class="comment"> * @file apr_proc_mutex.h</span>
-00021 <span class="comment"> * @brief APR Process Locking Routines</span>
-00022 <span class="comment"> */</span>
-00023 
-00024 <span class="preprocessor">#include "apr.h"</span>
-00025 <span class="preprocessor">#include "<a class="code" href="apr__pools_8h.html">apr_pools.h</a>"</span>
-00026 <span class="preprocessor">#include "<a class="code" href="apr__errno_8h.html">apr_errno.h</a>"</span>
-00027 
-00028 <span class="preprocessor">#ifdef __cplusplus</span>
-00029 <span class="preprocessor"></span><span class="keyword">extern</span> <span class="stringliteral">"C"</span> {
-00030 <span class="preprocessor">#endif </span><span class="comment">/* __cplusplus */</span>
-00031 <span class="comment"></span>
-00032 <span class="comment">/**</span>
-00033 <span class="comment"> * @defgroup apr_proc_mutex Process Locking Routines</span>
-00034 <span class="comment"> * @ingroup APR </span>
-00035 <span class="comment"> * @{</span>
-00036 <span class="comment"> */</span>
-00037 <span class="comment"></span>
-00038 <span class="comment">/** </span>
-00039 <span class="comment"> * Enumerated potential types for APR process locking methods</span>
-00040 <span class="comment"> * @warning Check APR_HAS_foo_SERIALIZE defines to see if the platform supports</span>
-00041 <span class="comment"> *          APR_LOCK_foo.  Only APR_LOCK_DEFAULT is portable.</span>
-00042 <span class="comment"> */</span>
-<a name="l00043"></a><a class="code" href="group__apr__proc__mutex.html#ga12">00043</a> <span class="keyword">typedef</span> <span class="keyword">enum</span> {
-00044     <a class="code" href="group__apr__proc__mutex.html#gga12a1">APR_LOCK_FCNTL</a>,         <span class="comment">/**&lt; fcntl() */</span>
-00045     <a class="code" href="group__apr__proc__mutex.html#gga12a2">APR_LOCK_FLOCK</a>,         <span class="comment">/**&lt; flock() */</span>
-00046     <a class="code" href="group__apr__proc__mutex.html#gga12a3">APR_LOCK_SYSVSEM</a>,       <span class="comment">/**&lt; System V Semaphores */</span>
-00047     <a class="code" href="group__apr__proc__mutex.html#gga12a4">APR_LOCK_PROC_PTHREAD</a>,  <span class="comment">/**&lt; POSIX pthread process-based locking */</span>
-00048     <a class="code" href="group__apr__proc__mutex.html#gga12a5">APR_LOCK_POSIXSEM</a>,      <span class="comment">/**&lt; POSIX semaphore process-based locking */</span>
-00049     <a class="code" href="group__apr__proc__mutex.html#gga12a6">APR_LOCK_DEFAULT</a>        <span class="comment">/**&lt; Use the default process lock */</span>
-00050 } <a class="code" href="group__apr__proc__mutex.html#ga12">apr_lockmech_e</a>;
-00051 <span class="comment"></span>
-00052 <span class="comment">/** Opaque structure representing a process mutex. */</span>
-<a name="l00053"></a><a class="code" href="group__apr__proc__mutex.html#ga0">00053</a> <span class="keyword">typedef</span> <span class="keyword">struct </span><a class="code" href="group__apr__proc__mutex.html#ga0">apr_proc_mutex_t</a> <a class="code" href="group__apr__proc__mutex.html#ga0">apr_proc_mutex_t</a>;
-00054 
-00055 <span class="comment">/*   Function definitions */</span>
-00056 <span class="comment"></span>
-00057 <span class="comment">/**</span>
-00058 <span class="comment"> * Create and initialize a mutex that can be used to synchronize processes.</span>
-00059 <span class="comment"> * @param mutex the memory address where the newly created mutex will be</span>
-00060 <span class="comment"> *        stored.</span>
-00061 <span class="comment"> * @param fname A file name to use if the lock mechanism requires one.  This</span>
-00062 <span class="comment"> *        argument should always be provided.  The lock code itself will</span>
-00063 <span class="comment"> *        determine if it should be used.</span>
-00064 <span class="comment"> * @param mech The mechanism to use for the interprocess lock, if any; one of</span>
-00065 <span class="comment"> * &lt;PRE&gt;</span>
-00066 <span class="comment"> *            APR_LOCK_FCNTL</span>
-00067 <span class="comment"> *            APR_LOCK_FLOCK</span>
-00068 <span class="comment"> *            APR_LOCK_SYSVSEM</span>
-00069 <span class="comment"> *            APR_LOCK_POSIXSEM</span>
-00070 <span class="comment"> *            APR_LOCK_PROC_PTHREAD</span>
-00071 <span class="comment"> *            APR_LOCK_DEFAULT     pick the default mechanism for the platform</span>
-00072 <span class="comment"> * &lt;/PRE&gt;</span>
-00073 <span class="comment"> * @param pool the pool from which to allocate the mutex.</span>
-00074 <span class="comment"> * @see apr_lockmech_e</span>
-00075 <span class="comment"> * @warning Check APR_HAS_foo_SERIALIZE defines to see if the platform supports</span>
-00076 <span class="comment"> *          APR_LOCK_foo.  Only APR_LOCK_DEFAULT is portable.</span>
-00077 <span class="comment"> */</span>
-00078 APR_DECLARE(<a class="code" href="group__apr__errno.html#ga0">apr_status_t</a>) apr_proc_mutex_create(apr_proc_mutex_t **mutex,
-00079                                                 const <span class="keywordtype">char</span> *fname,
-00080                                                 apr_lockmech_e mech,
-00081                                                 <a class="code" href="group__apr__pools.html#ga0">apr_pool_t</a> *pool);
-00082 <span class="comment"></span>
-00083 <span class="comment">/**</span>
-00084 <span class="comment"> * Re-open a mutex in a child process.</span>
-00085 <span class="comment"> * @param mutex The newly re-opened mutex structure.</span>
-00086 <span class="comment"> * @param fname A file name to use if the mutex mechanism requires one.  This</span>
-00087 <span class="comment"> *              argument should always be provided.  The mutex code itself will</span>
-00088 <span class="comment"> *              determine if it should be used.  This filename should be the </span>
-00089 <span class="comment"> *              same one that was passed to apr_proc_mutex_create().</span>
-00090 <span class="comment"> * @param pool The pool to operate on.</span>
-00091 <span class="comment"> * @remark This function must be called to maintain portability, even</span>
-00092 <span class="comment"> *         if the underlying lock mechanism does not require it.</span>
-00093 <span class="comment"> */</span>
-00094 APR_DECLARE(<a class="code" href="group__apr__errno.html#ga0">apr_status_t</a>) apr_proc_mutex_child_init(apr_proc_mutex_t **mutex,
-00095                                                     const <span class="keywordtype">char</span> *fname,
-00096                                                     <a class="code" href="group__apr__pools.html#ga0">apr_pool_t</a> *pool);
-00097 <span class="comment"></span>
-00098 <span class="comment">/**</span>
-00099 <span class="comment"> * Acquire the lock for the given mutex. If the mutex is already locked,</span>
-00100 <span class="comment"> * the current thread will be put to sleep until the lock becomes available.</span>
-00101 <span class="comment"> * @param mutex the mutex on which to acquire the lock.</span>
-00102 <span class="comment"> */</span>
-00103 APR_DECLARE(<a class="code" href="group__apr__errno.html#ga0">apr_status_t</a>) apr_proc_mutex_lock(apr_proc_mutex_t *mutex);
-00104 <span class="comment"></span>
-00105 <span class="comment">/**</span>
-00106 <span class="comment"> * Attempt to acquire the lock for the given mutex. If the mutex has already</span>
-00107 <span class="comment"> * been acquired, the call returns immediately with APR_EBUSY. Note: it</span>
-00108 <span class="comment"> * is important that the APR_STATUS_IS_EBUSY(s) macro be used to determine</span>
-00109 <span class="comment"> * if the return value was APR_EBUSY, for portability reasons.</span>
-00110 <span class="comment"> * @param mutex the mutex on which to attempt the lock acquiring.</span>
-00111 <span class="comment"> */</span>
-00112 APR_DECLARE(<a class="code" href="group__apr__errno.html#ga0">apr_status_t</a>) apr_proc_mutex_trylock(apr_proc_mutex_t *mutex);
-00113 <span class="comment"></span>
-00114 <span class="comment">/**</span>
-00115 <span class="comment"> * Release the lock for the given mutex.</span>
-00116 <span class="comment"> * @param mutex the mutex from which to release the lock.</span>
-00117 <span class="comment"> */</span>
-00118 APR_DECLARE(<a class="code" href="group__apr__errno.html#ga0">apr_status_t</a>) apr_proc_mutex_unlock(apr_proc_mutex_t *mutex);
-00119 <span class="comment"></span>
-00120 <span class="comment">/**</span>
-00121 <span class="comment"> * Destroy the mutex and free the memory associated with the lock.</span>
-00122 <span class="comment"> * @param mutex the mutex to destroy.</span>
-00123 <span class="comment"> */</span>
-00124 APR_DECLARE(<a class="code" href="group__apr__errno.html#ga0">apr_status_t</a>) apr_proc_mutex_destroy(apr_proc_mutex_t *mutex);
-00125 <span class="comment"></span>
-00126 <span class="comment">/**</span>
-00127 <span class="comment"> * Destroy the mutex and free the memory associated with the lock.</span>
-00128 <span class="comment"> * @param mutex the mutex to destroy.</span>
-00129 <span class="comment"> * @note This function is generally used to kill a cleanup on an already</span>
-00130 <span class="comment"> *       created mutex</span>
-00131 <span class="comment"> */</span>
-00132 APR_DECLARE(<a class="code" href="group__apr__errno.html#ga0">apr_status_t</a>) apr_proc_mutex_cleanup(<span class="keywordtype">void</span> *mutex);
-00133 <span class="comment"></span>
-00134 <span class="comment">/**</span>
-00135 <span class="comment"> * Return the name of the lockfile for the mutex, or NULL</span>
-00136 <span class="comment"> * if the mutex doesn't use a lock file</span>
-00137 <span class="comment"> */</span>
-00138 
-00139 APR_DECLARE(const <span class="keywordtype">char</span> *) apr_proc_mutex_lockfile(apr_proc_mutex_t *mutex);
-00140 <span class="comment"></span>
-00141 <span class="comment">/**</span>
-00142 <span class="comment"> * Display the name of the mutex, as it relates to the actual method used.</span>
-00143 <span class="comment"> * This matches the valid options for Apache's AcceptMutex directive</span>
-00144 <span class="comment"> * @param mutex the name of the mutex</span>
-00145 <span class="comment"> */</span>
-00146 APR_DECLARE(const <span class="keywordtype">char</span> *) apr_proc_mutex_name(apr_proc_mutex_t *mutex);
-00147 <span class="comment"></span>
-00148 <span class="comment">/**</span>
-00149 <span class="comment"> * Display the name of the default mutex: APR_LOCK_DEFAULT</span>
-00150 <span class="comment"> */</span>
-00151 APR_DECLARE(const <span class="keywordtype">char</span> *) apr_proc_mutex_defname(<span class="keywordtype">void</span>);
-00152 <span class="comment"></span>
-00153 <span class="comment">/**</span>
-00154 <span class="comment"> * Get the pool used by this proc_mutex.</span>
-00155 <span class="comment"> * @return apr_pool_t the pool</span>
-00156 <span class="comment"> */</span>
-00157 APR_POOL_DECLARE_ACCESSOR(proc_mutex);
-00158 <span class="comment"></span>
-00159 <span class="comment">/** @} */</span>
-00160 
-00161 #ifdef __cplusplus
-00162 }
-00163 #endif
-00164 
-00165 #endif  <span class="comment">/* ! APR_PROC_MUTEX_H */</span>
-</div></pre><hr size="1"><address style="align: right;"><small>Generated on Wed Sep 1 21:36:05 2004 for Apache Portable Runtime by
+<h1>apr_proc_mutex.h</h1><a href="apr__proc__mutex_8h.html">Go to the documentation of this file.</a><pre class="fragment"><div>00001 <span class="comment">/* Copyright 2000-2005 The Apache Software Foundation or its licensors, as</span>
+00002 <span class="comment"> * applicable.</span>
+00003 <span class="comment"> *</span>
+00004 <span class="comment"> * Licensed under the Apache License, Version 2.0 (the "License");</span>
+00005 <span class="comment"> * you may not use this file except in compliance with the License.</span>
+00006 <span class="comment"> * You may obtain a copy of the License at</span>
+00007 <span class="comment"> *</span>
+00008 <span class="comment"> *     http://www.apache.org/licenses/LICENSE-2.0</span>
+00009 <span class="comment"> *</span>
+00010 <span class="comment"> * Unless required by applicable law or agreed to in writing, software</span>
+00011 <span class="comment"> * distributed under the License is distributed on an "AS IS" BASIS,</span>
+00012 <span class="comment"> * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.</span>
+00013 <span class="comment"> * See the License for the specific language governing permissions and</span>
+00014 <span class="comment"> * limitations under the License.</span>
+00015 <span class="comment"> */</span>
+00016 
+00017 <span class="preprocessor">#ifndef APR_PROC_MUTEX_H</span>
+00018 <span class="preprocessor"></span><span class="preprocessor">#define APR_PROC_MUTEX_H</span>
+00019 <span class="preprocessor"></span><span class="comment"></span>
+00020 <span class="comment">/**</span>
+00021 <span class="comment"> * @file apr_proc_mutex.h</span>
+00022 <span class="comment"> * @brief APR Process Locking Routines</span>
+00023 <span class="comment"> */</span>
+00024 
+00025 <span class="preprocessor">#include "apr.h"</span>
+00026 <span class="preprocessor">#include "<a class="code" href="apr__pools_8h.html">apr_pools.h</a>"</span>
+00027 <span class="preprocessor">#include "<a class="code" href="apr__errno_8h.html">apr_errno.h</a>"</span>
+00028 
+00029 <span class="preprocessor">#ifdef __cplusplus</span>
+00030 <span class="preprocessor"></span><span class="keyword">extern</span> <span class="stringliteral">"C"</span> {
+00031 <span class="preprocessor">#endif </span><span class="comment">/* __cplusplus */</span>
+00032 <span class="comment"></span>
+00033 <span class="comment">/**</span>
+00034 <span class="comment"> * @defgroup apr_proc_mutex Process Locking Routines</span>
+00035 <span class="comment"> * @ingroup APR </span>
+00036 <span class="comment"> * @{</span>
+00037 <span class="comment"> */</span>
+00038 <span class="comment"></span>
+00039 <span class="comment">/** </span>
+00040 <span class="comment"> * Enumerated potential types for APR process locking methods</span>
+00041 <span class="comment"> * @warning Check APR_HAS_foo_SERIALIZE defines to see if the platform supports</span>
+00042 <span class="comment"> *          APR_LOCK_foo.  Only APR_LOCK_DEFAULT is portable.</span>
+00043 <span class="comment"> */</span>
+<a name="l00044"></a><a class="code" href="group__apr__proc__mutex.html#ga12">00044</a> <span class="keyword">typedef</span> <span class="keyword">enum</span> {
+00045     <a class="code" href="group__apr__proc__mutex.html#gga12a1">APR_LOCK_FCNTL</a>,         <span class="comment">/**&lt; fcntl() */</span>
+00046     <a class="code" href="group__apr__proc__mutex.html#gga12a2">APR_LOCK_FLOCK</a>,         <span class="comment">/**&lt; flock() */</span>
+00047     <a class="code" href="group__apr__proc__mutex.html#gga12a3">APR_LOCK_SYSVSEM</a>,       <span class="comment">/**&lt; System V Semaphores */</span>
+00048     <a class="code" href="group__apr__proc__mutex.html#gga12a4">APR_LOCK_PROC_PTHREAD</a>,  <span class="comment">/**&lt; POSIX pthread process-based locking */</span>
+00049     <a class="code" href="group__apr__proc__mutex.html#gga12a5">APR_LOCK_POSIXSEM</a>,      <span class="comment">/**&lt; POSIX semaphore process-based locking */</span>
+00050     <a class="code" href="group__apr__proc__mutex.html#gga12a6">APR_LOCK_DEFAULT</a>        <span class="comment">/**&lt; Use the default process lock */</span>
+00051 } <a class="code" href="group__apr__proc__mutex.html#ga12">apr_lockmech_e</a>;
+00052 <span class="comment"></span>
+00053 <span class="comment">/** Opaque structure representing a process mutex. */</span>
+<a name="l00054"></a><a class="code" href="group__apr__proc__mutex.html#ga0">00054</a> <span class="keyword">typedef</span> <span class="keyword">struct </span><a class="code" href="group__apr__proc__mutex.html#ga0">apr_proc_mutex_t</a> <a class="code" href="group__apr__proc__mutex.html#ga0">apr_proc_mutex_t</a>;
+00055 
+00056 <span class="comment">/*   Function definitions */</span>
+00057 <span class="comment"></span>
+00058 <span class="comment">/**</span>
+00059 <span class="comment"> * Create and initialize a mutex that can be used to synchronize processes.</span>
+00060 <span class="comment"> * @param mutex the memory address where the newly created mutex will be</span>
+00061 <span class="comment"> *        stored.</span>
+00062 <span class="comment"> * @param fname A file name to use if the lock mechanism requires one.  This</span>
+00063 <span class="comment"> *        argument should always be provided.  The lock code itself will</span>
+00064 <span class="comment"> *        determine if it should be used.</span>
+00065 <span class="comment"> * @param mech The mechanism to use for the interprocess lock, if any; one of</span>
+00066 <span class="comment"> * &lt;PRE&gt;</span>
+00067 <span class="comment"> *            APR_LOCK_FCNTL</span>
+00068 <span class="comment"> *            APR_LOCK_FLOCK</span>
+00069 <span class="comment"> *            APR_LOCK_SYSVSEM</span>
+00070 <span class="comment"> *            APR_LOCK_POSIXSEM</span>
+00071 <span class="comment"> *            APR_LOCK_PROC_PTHREAD</span>
+00072 <span class="comment"> *            APR_LOCK_DEFAULT     pick the default mechanism for the platform</span>
+00073 <span class="comment"> * &lt;/PRE&gt;</span>
+00074 <span class="comment"> * @param pool the pool from which to allocate the mutex.</span>
+00075 <span class="comment"> * @see apr_lockmech_e</span>
+00076 <span class="comment"> * @warning Check APR_HAS_foo_SERIALIZE defines to see if the platform supports</span>
+00077 <span class="comment"> *          APR_LOCK_foo.  Only APR_LOCK_DEFAULT is portable.</span>
+00078 <span class="comment"> */</span>
+00079 APR_DECLARE(apr_status_t) apr_proc_mutex_create(apr_proc_mutex_t **mutex,
+00080                                                 const <span class="keywordtype">char</span> *fname,
+00081                                                 apr_lockmech_e mech,
+00082                                                 apr_pool_t *pool);
+00083 <span class="comment"></span>
+00084 <span class="comment">/**</span>
+00085 <span class="comment"> * Re-open a mutex in a child process.</span>
+00086 <span class="comment"> * @param mutex The newly re-opened mutex structure.</span>
+00087 <span class="comment"> * @param fname A file name to use if the mutex mechanism requires one.  This</span>
+00088 <span class="comment"> *              argument should always be provided.  The mutex code itself will</span>
+00089 <span class="comment"> *              determine if it should be used.  This filename should be the </span>
+00090 <span class="comment"> *              same one that was passed to apr_proc_mutex_create().</span>
+00091 <span class="comment"> * @param pool The pool to operate on.</span>
+00092 <span class="comment"> * @remark This function must be called to maintain portability, even</span>
+00093 <span class="comment"> *         if the underlying lock mechanism does not require it.</span>
+00094 <span class="comment"> */</span>
+00095 APR_DECLARE(apr_status_t) apr_proc_mutex_child_init(apr_proc_mutex_t **mutex,
+00096                                                     const <span class="keywordtype">char</span> *fname,
+00097                                                     apr_pool_t *pool);
+00098 <span class="comment"></span>
+00099 <span class="comment">/**</span>
+00100 <span class="comment"> * Acquire the lock for the given mutex. If the mutex is already locked,</span>
+00101 <span class="comment"> * the current thread will be put to sleep until the lock becomes available.</span>
+00102 <span class="comment"> * @param mutex the mutex on which to acquire the lock.</span>
+00103 <span class="comment"> */</span>
+00104 APR_DECLARE(apr_status_t) apr_proc_mutex_lock(apr_proc_mutex_t *mutex);
+00105 <span class="comment"></span>
+00106 <span class="comment">/**</span>
+00107 <span class="comment"> * Attempt to acquire the lock for the given mutex. If the mutex has already</span>
+00108 <span class="comment"> * been acquired, the call returns immediately with APR_EBUSY. Note: it</span>
+00109 <span class="comment"> * is important that the APR_STATUS_IS_EBUSY(s) macro be used to determine</span>
+00110 <span class="comment"> * if the return value was APR_EBUSY, for portability reasons.</span>
+00111 <span class="comment"> * @param mutex the mutex on which to attempt the lock acquiring.</span>
+00112 <span class="comment"> */</span>
+00113 APR_DECLARE(apr_status_t) apr_proc_mutex_trylock(apr_proc_mutex_t *mutex);
+00114 <span class="comment"></span>
+00115 <span class="comment">/**</span>
+00116 <span class="comment"> * Release the lock for the given mutex.</span>
+00117 <span class="comment"> * @param mutex the mutex from which to release the lock.</span>
+00118 <span class="comment"> */</span>
+00119 APR_DECLARE(apr_status_t) apr_proc_mutex_unlock(apr_proc_mutex_t *mutex);
+00120 <span class="comment"></span>
+00121 <span class="comment">/**</span>
+00122 <span class="comment"> * Destroy the mutex and free the memory associated with the lock.</span>
+00123 <span class="comment"> * @param mutex the mutex to destroy.</span>
+00124 <span class="comment"> */</span>
+00125 APR_DECLARE(apr_status_t) apr_proc_mutex_destroy(apr_proc_mutex_t *mutex);
+00126 <span class="comment"></span>
+00127 <span class="comment">/**</span>
+00128 <span class="comment"> * Destroy the mutex and free the memory associated with the lock.</span>
+00129 <span class="comment"> * @param mutex the mutex to destroy.</span>
+00130 <span class="comment"> * @note This function is generally used to kill a cleanup on an already</span>
+00131 <span class="comment"> *       created mutex</span>
+00132 <span class="comment"> */</span>
+00133 APR_DECLARE(apr_status_t) apr_proc_mutex_cleanup(<span class="keywordtype">void</span> *mutex);
+00134 <span class="comment"></span>
+00135 <span class="comment">/**</span>
+00136 <span class="comment"> * Return the name of the lockfile for the mutex, or NULL</span>
+00137 <span class="comment"> * if the mutex doesn't use a lock file</span>
+00138 <span class="comment"> */</span>
+00139 
+00140 APR_DECLARE(const <span class="keywordtype">char</span> *) apr_proc_mutex_lockfile(apr_proc_mutex_t *mutex);
+00141 <span class="comment"></span>
+00142 <span class="comment">/**</span>
+00143 <span class="comment"> * Display the name of the mutex, as it relates to the actual method used.</span>
+00144 <span class="comment"> * This matches the valid options for Apache's AcceptMutex directive</span>
+00145 <span class="comment"> * @param mutex the name of the mutex</span>
+00146 <span class="comment"> */</span>
+00147 APR_DECLARE(const <span class="keywordtype">char</span> *) apr_proc_mutex_name(apr_proc_mutex_t *mutex);
+00148 <span class="comment"></span>
+00149 <span class="comment">/**</span>
+00150 <span class="comment"> * Display the name of the default mutex: APR_LOCK_DEFAULT</span>
+00151 <span class="comment"> */</span>
+00152 APR_DECLARE(const <span class="keywordtype">char</span> *) apr_proc_mutex_defname(<span class="keywordtype">void</span>);
+00153 <span class="comment"></span>
+00154 <span class="comment">/**</span>
+00155 <span class="comment"> * Get the pool used by this proc_mutex.</span>
+00156 <span class="comment"> * @return apr_pool_t the pool</span>
+00157 <span class="comment"> */</span>
+00158 APR_POOL_DECLARE_ACCESSOR(proc_mutex);
+00159 <span class="comment"></span>
+00160 <span class="comment">/** @} */</span>
+00161 
+00162 #ifdef __cplusplus
+00163 }
+00164 #endif
+00165 
+00166 #endif  <span class="comment">/* ! APR_PROC_MUTEX_H */</span>
+</div></pre><hr size="1"><address style="align: right;"><small>Generated on Mon Feb 7 13:18:25 2005 for Apache Portable Runtime by
 <a href="http://www.doxygen.org/index.html">
-<img src="doxygen.png" alt="doxygen" align="middle" border=0 ></a> 1.3.8 </small></address>
+<img src="doxygen.png" alt="doxygen" align="middle" border=0 ></a> 1.3.7 </small></address>
 </body>
 </html>

Modified: apr/site/trunk/docs/docs/apr/apr__proc__mutex_8h.html
URL: http://svn.apache.org/viewcvs/apr/site/trunk/docs/docs/apr/apr__proc__mutex_8h.html?view=diff&r1=151767&r2=151768
==============================================================================
--- apr/site/trunk/docs/docs/apr/apr__proc__mutex_8h.html (original)
+++ apr/site/trunk/docs/docs/apr/apr__proc__mutex_8h.html Mon Feb  7 15:10:17 2005
@@ -3,9 +3,10 @@
 <title>Apache Portable Runtime: apr_proc_mutex.h File Reference</title>
 <link href="doxygen.css" rel="stylesheet" type="text/css">
 </head><body>
-<!-- Generated by Doxygen 1.3.8 -->
+<!-- Generated by Doxygen 1.3.7 -->
 <div class="qindex"><a class="qindex" href="index.html">Main&nbsp;Page</a> | <a class="qindex" href="modules.html">Modules</a> | <a class="qindex" href="annotated.html">Data&nbsp;Structures</a> | <a class="qindex" href="files.html">File&nbsp;List</a> | <a class="qindex" href="functions.html">Data&nbsp;Fields</a> | <a class="qindex" href="globals.html">Globals</a> | <a class="qindex" href="pages.html">Related&nbsp;Pages</a></div>
-<h1>apr_proc_mutex.h File Reference</h1>APR Process Locking Routines. <a href="#_details">More...</a>
+<h1>apr_proc_mutex.h File Reference</h1>APR Process Locking Routines.  
+<a href="#_details">More...</a>
 <p>
 <code>#include "apr.h"</code><br>
 <code>#include "<a class="el" href="apr__pools_8h-source.html">apr_pools.h</a>"</code><br>
@@ -56,8 +57,8 @@
 <hr><a name="_details"></a><h2>Detailed Description</h2>
 APR Process Locking Routines. 
 <p>
-<hr size="1"><address style="align: right;"><small>Generated on Wed Sep 1 21:36:05 2004 for Apache Portable Runtime by
+<hr size="1"><address style="align: right;"><small>Generated on Mon Feb 7 13:18:25 2005 for Apache Portable Runtime by
 <a href="http://www.doxygen.org/index.html">
-<img src="doxygen.png" alt="doxygen" align="middle" border=0 ></a> 1.3.8 </small></address>
+<img src="doxygen.png" alt="doxygen" align="middle" border=0 ></a> 1.3.7 </small></address>
 </body>
 </html>

Modified: apr/site/trunk/docs/docs/apr/apr__random_8h-source.html
URL: http://svn.apache.org/viewcvs/apr/site/trunk/docs/docs/apr/apr__random_8h-source.html?view=diff&r1=151767&r2=151768
==============================================================================
--- apr/site/trunk/docs/docs/apr/apr__random_8h-source.html (original)
+++ apr/site/trunk/docs/docs/apr/apr__random_8h-source.html Mon Feb  7 15:10:17 2005
@@ -3,83 +3,84 @@
 <title>Apache Portable Runtime: apr_random.h Source File</title>
 <link href="doxygen.css" rel="stylesheet" type="text/css">
 </head><body>
-<!-- Generated by Doxygen 1.3.8 -->
+<!-- Generated by Doxygen 1.3.7 -->
 <div class="qindex"><a class="qindex" href="index.html">Main&nbsp;Page</a> | <a class="qindex" href="modules.html">Modules</a> | <a class="qindex" href="annotated.html">Data&nbsp;Structures</a> | <a class="qindex" href="files.html">File&nbsp;List</a> | <a class="qindex" href="functions.html">Data&nbsp;Fields</a> | <a class="qindex" href="globals.html">Globals</a> | <a class="qindex" href="pages.html">Related&nbsp;Pages</a></div>
-<h1>apr_random.h</h1><pre class="fragment"><div>00001 <span class="comment">/* Copyright 2000-2004 The Apache Software Foundation</span>
-00002 <span class="comment"> *</span>
-00003 <span class="comment"> * Licensed under the Apache License, Version 2.0 (the "License");</span>
-00004 <span class="comment"> * you may not use this file except in compliance with the License.</span>
-00005 <span class="comment"> * You may obtain a copy of the License at</span>
-00006 <span class="comment"> *</span>
-00007 <span class="comment"> *     http://www.apache.org/licenses/LICENSE-2.0</span>
-00008 <span class="comment"> *</span>
-00009 <span class="comment"> * Unless required by applicable law or agreed to in writing, software</span>
-00010 <span class="comment"> * distributed under the License is distributed on an "AS IS" BASIS,</span>
-00011 <span class="comment"> * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.</span>
-00012 <span class="comment"> * See the License for the specific language governing permissions and</span>
-00013 <span class="comment"> * limitations under the License.</span>
-00014 <span class="comment"> */</span>
-00015 
-00016 <span class="preprocessor">#ifndef APR_RANDOM_H</span>
-00017 <span class="preprocessor"></span><span class="preprocessor">#define APR_RANDOM_H</span>
-00018 <span class="preprocessor"></span>
-00019 <span class="preprocessor">#include &lt;<a class="code" href="apr__pools_8h.html">apr_pools.h</a>&gt;</span>
-00020 
-00021 <span class="keyword">typedef</span> <span class="keyword">struct </span>apr_crypto_hash_t apr_crypto_hash_t;
-00022 
-00023 <span class="keyword">typedef</span> <span class="keywordtype">void</span> apr_crypto_hash_init_t(apr_crypto_hash_t *hash);
-00024 <span class="keyword">typedef</span> <span class="keywordtype">void</span> apr_crypto_hash_add_t(apr_crypto_hash_t *hash,<span class="keyword">const</span> <span class="keywordtype">void</span> *data,
-00025                                    apr_size_t bytes);
-00026 <span class="keyword">typedef</span> <span class="keywordtype">void</span> apr_crypto_hash_finish_t(apr_crypto_hash_t *hash,
-00027                                       <span class="keywordtype">unsigned</span> <span class="keywordtype">char</span> *result);
-00028 
-00029 <span class="comment">/* FIXME: make this opaque */</span>
-00030 <span class="keyword">struct </span>apr_crypto_hash_t {
-00031     apr_crypto_hash_init_t *init;
-00032     apr_crypto_hash_add_t *add;
-00033     apr_crypto_hash_finish_t *finish;
-00034     apr_size_t size;
-00035     <span class="keywordtype">void</span> *data;
-00036 };
-00037 
-00038 APR_DECLARE(apr_crypto_hash_t *) apr_crypto_sha256_new(<a class="code" href="group__apr__pools.html#ga0">apr_pool_t</a> *p);
-00039 
-00040 typedef struct apr_random_t apr_random_t;
-00041 
-00042 APR_DECLARE(<span class="keywordtype">void</span>) apr_random_init(apr_random_t *g,<a class="code" href="group__apr__pools.html#ga0">apr_pool_t</a> *p,
-00043                                   apr_crypto_hash_t *pool_hash,
-00044                                   apr_crypto_hash_t *key_hash,
-00045                                   apr_crypto_hash_t *prng_hash);
-00046 APR_DECLARE(apr_random_t *) apr_random_standard_new(<a class="code" href="group__apr__pools.html#ga0">apr_pool_t</a> *p);
-00047 APR_DECLARE(<span class="keywordtype">void</span>) apr_random_add_entropy(apr_random_t *g,
-00048                                          const <span class="keywordtype">void</span> *entropy_,
-00049                                          apr_size_t bytes);
-00050 APR_DECLARE(<a class="code" href="group__apr__errno.html#ga0">apr_status_t</a>) apr_random_insecure_bytes(apr_random_t *g,
-00051                                                     <span class="keywordtype">void</span> *random,
-00052                                                     apr_size_t bytes);
-00053 APR_DECLARE(<a class="code" href="group__apr__errno.html#ga0">apr_status_t</a>) apr_random_secure_bytes(apr_random_t *g,
-00054                                                   <span class="keywordtype">void</span> *random,
-00055                                                   apr_size_t bytes);
-00056 APR_DECLARE(<span class="keywordtype">void</span>) apr_random_barrier(apr_random_t *g);
-00057 APR_DECLARE(<a class="code" href="group__apr__errno.html#ga0">apr_status_t</a>) apr_random_secure_ready(apr_random_t *r);
-00058 APR_DECLARE(<a class="code" href="group__apr__errno.html#ga0">apr_status_t</a>) apr_random_insecure_ready(apr_random_t *r);
-00059 
-00060 <span class="comment">/* Call this in the child after forking to mix the randomness</span>
-00061 <span class="comment">   pools. Note that its generally a bad idea to fork a process with a</span>
-00062 <span class="comment">   real PRNG in it - better to have the PRNG externally and get the</span>
-00063 <span class="comment">   randomness from there. However, if you really must do it, then you</span>
-00064 <span class="comment">   should supply all your entropy to all the PRNGs - don't worry, they</span>
-00065 <span class="comment">   won't produce the same output.</span>
-00066 <span class="comment"></span>
-00067 <span class="comment">   Note that apr_proc_fork() calls this for you, so only weird</span>
-00068 <span class="comment">   applications need ever call it themselves.</span>
-00069 <span class="comment">*/</span>
-00070 struct <a class="code" href="structapr__proc__t.html">apr_proc_t</a>;
-00071 APR_DECLARE(<span class="keywordtype">void</span>) apr_random_after_fork(struct apr_proc_t *proc);
-00072 
-00073 #endif <span class="comment">/* ndef APR_RANDOM_H */</span>
-</div></pre><hr size="1"><address style="align: right;"><small>Generated on Wed Sep 1 21:36:05 2004 for Apache Portable Runtime by
+<h1>apr_random.h</h1><pre class="fragment"><div>00001 <span class="comment">/* Copyright 2000-2005 The Apache Software Foundation or its licensors, as</span>
+00002 <span class="comment"> * applicable.</span>
+00003 <span class="comment"> *</span>
+00004 <span class="comment"> * Licensed under the Apache License, Version 2.0 (the "License");</span>
+00005 <span class="comment"> * you may not use this file except in compliance with the License.</span>
+00006 <span class="comment"> * You may obtain a copy of the License at</span>
+00007 <span class="comment"> *</span>
+00008 <span class="comment"> *     http://www.apache.org/licenses/LICENSE-2.0</span>
+00009 <span class="comment"> *</span>
+00010 <span class="comment"> * Unless required by applicable law or agreed to in writing, software</span>
+00011 <span class="comment"> * distributed under the License is distributed on an "AS IS" BASIS,</span>
+00012 <span class="comment"> * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.</span>
+00013 <span class="comment"> * See the License for the specific language governing permissions and</span>
+00014 <span class="comment"> * limitations under the License.</span>
+00015 <span class="comment"> */</span>
+00016 
+00017 <span class="preprocessor">#ifndef APR_RANDOM_H</span>
+00018 <span class="preprocessor"></span><span class="preprocessor">#define APR_RANDOM_H</span>
+00019 <span class="preprocessor"></span>
+00020 <span class="preprocessor">#include &lt;<a class="code" href="apr__pools_8h.html">apr_pools.h</a>&gt;</span>
+00021 
+00022 <span class="keyword">typedef</span> <span class="keyword">struct </span>apr_crypto_hash_t apr_crypto_hash_t;
+00023 
+00024 <span class="keyword">typedef</span> <span class="keywordtype">void</span> apr_crypto_hash_init_t(apr_crypto_hash_t *hash);
+00025 <span class="keyword">typedef</span> <span class="keywordtype">void</span> apr_crypto_hash_add_t(apr_crypto_hash_t *hash,<span class="keyword">const</span> <span class="keywordtype">void</span> *data,
+00026                                    apr_size_t bytes);
+00027 <span class="keyword">typedef</span> <span class="keywordtype">void</span> apr_crypto_hash_finish_t(apr_crypto_hash_t *hash,
+00028                                       <span class="keywordtype">unsigned</span> <span class="keywordtype">char</span> *result);
+00029 
+00030 <span class="comment">/* FIXME: make this opaque */</span>
+00031 <span class="keyword">struct </span>apr_crypto_hash_t {
+00032     apr_crypto_hash_init_t *init;
+00033     apr_crypto_hash_add_t *add;
+00034     apr_crypto_hash_finish_t *finish;
+00035     apr_size_t size;
+00036     <span class="keywordtype">void</span> *data;
+00037 };
+00038 
+00039 APR_DECLARE(apr_crypto_hash_t *) apr_crypto_sha256_new(apr_pool_t *p);
+00040 
+00041 typedef struct apr_random_t apr_random_t;
+00042 
+00043 APR_DECLARE(<span class="keywordtype">void</span>) apr_random_init(apr_random_t *g,apr_pool_t *p,
+00044                                   apr_crypto_hash_t *pool_hash,
+00045                                   apr_crypto_hash_t *key_hash,
+00046                                   apr_crypto_hash_t *prng_hash);
+00047 APR_DECLARE(apr_random_t *) apr_random_standard_new(apr_pool_t *p);
+00048 APR_DECLARE(<span class="keywordtype">void</span>) apr_random_add_entropy(apr_random_t *g,
+00049                                          const <span class="keywordtype">void</span> *entropy_,
+00050                                          apr_size_t bytes);
+00051 APR_DECLARE(apr_status_t) apr_random_insecure_bytes(apr_random_t *g,
+00052                                                     <span class="keywordtype">void</span> *random,
+00053                                                     apr_size_t bytes);
+00054 APR_DECLARE(apr_status_t) apr_random_secure_bytes(apr_random_t *g,
+00055                                                   <span class="keywordtype">void</span> *random,
+00056                                                   apr_size_t bytes);
+00057 APR_DECLARE(<span class="keywordtype">void</span>) apr_random_barrier(apr_random_t *g);
+00058 APR_DECLARE(apr_status_t) apr_random_secure_ready(apr_random_t *r);
+00059 APR_DECLARE(apr_status_t) apr_random_insecure_ready(apr_random_t *r);
+00060 
+00061 <span class="comment">/* Call this in the child after forking to mix the randomness</span>
+00062 <span class="comment">   pools. Note that its generally a bad idea to fork a process with a</span>
+00063 <span class="comment">   real PRNG in it - better to have the PRNG externally and get the</span>
+00064 <span class="comment">   randomness from there. However, if you really must do it, then you</span>
+00065 <span class="comment">   should supply all your entropy to all the PRNGs - don't worry, they</span>
+00066 <span class="comment">   won't produce the same output.</span>
+00067 <span class="comment"></span>
+00068 <span class="comment">   Note that apr_proc_fork() calls this for you, so only weird</span>
+00069 <span class="comment">   applications need ever call it themselves.</span>
+00070 <span class="comment">*/</span>
+00071 struct <a class="code" href="structapr__proc__t.html">apr_proc_t</a>;
+00072 APR_DECLARE(<span class="keywordtype">void</span>) apr_random_after_fork(struct apr_proc_t *proc);
+00073 
+00074 #endif <span class="comment">/* ndef APR_RANDOM_H */</span>
+</div></pre><hr size="1"><address style="align: right;"><small>Generated on Mon Feb 7 13:18:25 2005 for Apache Portable Runtime by
 <a href="http://www.doxygen.org/index.html">
-<img src="doxygen.png" alt="doxygen" align="middle" border=0 ></a> 1.3.8 </small></address>
+<img src="doxygen.png" alt="doxygen" align="middle" border=0 ></a> 1.3.7 </small></address>
 </body>
 </html>



Mime
View raw message