You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@apr.apache.org by je...@apache.org on 2005/02/08 00:12:29 UTC
svn commit: r151768 [39/47] - in apr/site/trunk/docs/docs/apr: ./ iconv/
util/
Modified: apr/site/trunk/docs/docs/apr/apr__time_8h-source.html
URL: http://svn.apache.org/viewcvs/apr/site/trunk/docs/docs/apr/apr__time_8h-source.html?view=diff&r1=151767&r2=151768
==============================================================================
--- apr/site/trunk/docs/docs/apr/apr__time_8h-source.html (original)
+++ apr/site/trunk/docs/docs/apr/apr__time_8h-source.html Mon Feb 7 15:10:17 2005
@@ -3,241 +3,242 @@
<title>Apache Portable Runtime: apr_time.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 Page</a> | <a class="qindex" href="modules.html">Modules</a> | <a class="qindex" href="annotated.html">Data Structures</a> | <a class="qindex" href="files.html">File List</a> | <a class="qindex" href="functions.html">Data Fields</a> | <a class="qindex" href="globals.html">Globals</a> | <a class="qindex" href="pages.html">Related Pages</a></div>
-<h1>apr_time.h</h1><a href="apr__time_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_TIME_H</span>
-00017 <span class="preprocessor"></span><span class="preprocessor">#define APR_TIME_H</span>
-00018 <span class="preprocessor"></span><span class="comment"></span>
-00019 <span class="comment">/**</span>
-00020 <span class="comment"> * @file apr_time.h</span>
-00021 <span class="comment"> * @brief APR Time Library</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_time Time 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">/** month names */</span>
-00039 APR_DECLARE_DATA <span class="keyword">extern</span> <span class="keyword">const</span> <span class="keywordtype">char</span> <a class="code" href="group__apr__time.html#ga0">apr_month_snames</a>[12][4];<span class="comment"></span>
-00040 <span class="comment">/** day names */</span>
-00041 APR_DECLARE_DATA <span class="keyword">extern</span> <span class="keyword">const</span> <span class="keywordtype">char</span> <a class="code" href="group__apr__time.html#ga1">apr_day_snames</a>[7][4];
-00042
-00043 <span class="comment"></span>
-00044 <span class="comment">/** number of microseconds since 00:00:00 january 1, 1970 UTC */</span>
-<a name="l00045"></a><a class="code" href="group__apr__time.html#ga2">00045</a> <span class="keyword">typedef</span> apr_int64_t <a class="code" href="group__apr__time.html#ga2">apr_time_t</a>;
-00046
-00047 <span class="comment"></span>
-00048 <span class="comment">/** mechanism to properly type apr_time_t literals */</span>
-<a name="l00049"></a><a class="code" href="group__apr__time.html#ga18">00049</a> <span class="preprocessor">#define APR_TIME_C(val) APR_INT64_C(val)</span>
-00050 <span class="preprocessor"></span><span class="comment"></span>
-00051 <span class="comment">/** mechanism to properly print apr_time_t values */</span>
-<a name="l00052"></a><a class="code" href="group__apr__time.html#ga19">00052</a> <span class="preprocessor">#define APR_TIME_T_FMT APR_INT64_T_FMT</span>
-00053 <span class="preprocessor"></span><span class="comment"></span>
-00054 <span class="comment">/** intervals for I/O timeouts, in microseconds */</span>
-<a name="l00055"></a><a class="code" href="group__apr__time.html#ga3">00055</a> <span class="keyword">typedef</span> apr_int64_t <a class="code" href="group__apr__time.html#ga3">apr_interval_time_t</a>;<span class="comment"></span>
-00056 <span class="comment">/** short interval for I/O timeouts, in microseconds */</span>
-<a name="l00057"></a><a class="code" href="group__apr__time.html#ga4">00057</a> <span class="keyword">typedef</span> apr_int32_t <a class="code" href="group__apr__time.html#ga4">apr_short_interval_time_t</a>;
-00058 <span class="comment"></span>
-00059 <span class="comment">/** number of microseconds per second */</span>
-<a name="l00060"></a><a class="code" href="group__apr__time.html#ga20">00060</a> <span class="preprocessor">#define APR_USEC_PER_SEC APR_TIME_C(1000000)</span>
-00061 <span class="preprocessor"></span><span class="comment"></span>
-00062 <span class="comment">/** @return apr_time_t as a second */</span>
-<a name="l00063"></a><a class="code" href="group__apr__time.html#ga21">00063</a> <span class="preprocessor">#define apr_time_sec(time) ((time) / APR_USEC_PER_SEC)</span>
-00064 <span class="preprocessor"></span><span class="comment"></span>
-00065 <span class="comment">/** @return apr_time_t as a usec */</span>
-<a name="l00066"></a><a class="code" href="group__apr__time.html#ga22">00066</a> <span class="preprocessor">#define apr_time_usec(time) ((time) % APR_USEC_PER_SEC)</span>
-00067 <span class="preprocessor"></span><span class="comment"></span>
-00068 <span class="comment">/** @return apr_time_t as a msec */</span>
-<a name="l00069"></a><a class="code" href="group__apr__time.html#ga23">00069</a> <span class="preprocessor">#define apr_time_msec(time) (((time) / 1000) % 1000)</span>
-00070 <span class="preprocessor"></span><span class="comment"></span>
-00071 <span class="comment">/** @return apr_time_t as a msec */</span>
-<a name="l00072"></a><a class="code" href="group__apr__time.html#ga24">00072</a> <span class="preprocessor">#define apr_time_as_msec(time) ((time) / 1000)</span>
-00073 <span class="preprocessor"></span><span class="comment"></span>
-00074 <span class="comment">/** @return a second as an apr_time_t */</span>
-<a name="l00075"></a><a class="code" href="group__apr__time.html#ga25">00075</a> <span class="preprocessor">#define apr_time_from_sec(sec) ((apr_time_t)(sec) * APR_USEC_PER_SEC)</span>
-00076 <span class="preprocessor"></span><span class="comment"></span>
-00077 <span class="comment">/** @return a second and usec combination as an apr_time_t */</span>
-<a name="l00078"></a><a class="code" href="group__apr__time.html#ga26">00078</a> <span class="preprocessor">#define apr_time_make(sec, usec) ((apr_time_t)(sec) * APR_USEC_PER_SEC \</span>
-00079 <span class="preprocessor"> + (apr_time_t)(usec))</span>
-00080 <span class="preprocessor"></span><span class="comment"></span>
-00081 <span class="comment">/**</span>
-00082 <span class="comment"> * @return the current time</span>
-00083 <span class="comment"> */</span>
-00084 APR_DECLARE(apr_time_t) apr_time_now(<span class="keywordtype">void</span>);
-00085 <span class="comment"></span>
-00086 <span class="comment">/** @see apr_time_exp_t */</span>
-<a name="l00087"></a><a class="code" href="group__apr__time.html#ga5">00087</a> typedef struct <a class="code" href="structapr__time__exp__t.html">apr_time_exp_t</a> <a class="code" href="structapr__time__exp__t.html">apr_time_exp_t</a>;
-00088 <span class="comment"></span>
-00089 <span class="comment">/**</span>
-00090 <span class="comment"> * a structure similar to ANSI struct tm with the following differences:</span>
-00091 <span class="comment"> * - tm_usec isn't an ANSI field</span>
-00092 <span class="comment"> * - tm_gmtoff isn't an ANSI field (it's a bsdism)</span>
-00093 <span class="comment"> */</span>
-<a name="l00094"></a><a class="code" href="structapr__time__exp__t.html">00094</a> struct apr_time_exp_t {<span class="comment"></span>
-00095 <span class="comment"> /** microseconds past tm_sec */</span>
-<a name="l00096"></a><a class="code" href="structapr__time__exp__t.html#o0">00096</a> apr_int32_t tm_usec;<span class="comment"></span>
-00097 <span class="comment"> /** (0-61) seconds past tm_min */</span>
-<a name="l00098"></a><a class="code" href="structapr__time__exp__t.html#o1">00098</a> apr_int32_t tm_sec;<span class="comment"></span>
-00099 <span class="comment"> /** (0-59) minutes past tm_hour */</span>
-<a name="l00100"></a><a class="code" href="structapr__time__exp__t.html#o2">00100</a> apr_int32_t tm_min;<span class="comment"></span>
-00101 <span class="comment"> /** (0-23) hours past midnight */</span>
-<a name="l00102"></a><a class="code" href="structapr__time__exp__t.html#o3">00102</a> apr_int32_t tm_hour;<span class="comment"></span>
-00103 <span class="comment"> /** (1-31) day of the month */</span>
-<a name="l00104"></a><a class="code" href="structapr__time__exp__t.html#o4">00104</a> apr_int32_t tm_mday;<span class="comment"></span>
-00105 <span class="comment"> /** (0-11) month of the year */</span>
-<a name="l00106"></a><a class="code" href="structapr__time__exp__t.html#o5">00106</a> apr_int32_t tm_mon;<span class="comment"></span>
-00107 <span class="comment"> /** year since 1900 */</span>
-<a name="l00108"></a><a class="code" href="structapr__time__exp__t.html#o6">00108</a> apr_int32_t tm_year;<span class="comment"></span>
-00109 <span class="comment"> /** (0-6) days since sunday */</span>
-<a name="l00110"></a><a class="code" href="structapr__time__exp__t.html#o7">00110</a> apr_int32_t tm_wday;<span class="comment"></span>
-00111 <span class="comment"> /** (0-365) days since jan 1 */</span>
-<a name="l00112"></a><a class="code" href="structapr__time__exp__t.html#o8">00112</a> apr_int32_t tm_yday;<span class="comment"></span>
-00113 <span class="comment"> /** daylight saving time */</span>
-<a name="l00114"></a><a class="code" href="structapr__time__exp__t.html#o9">00114</a> apr_int32_t tm_isdst;<span class="comment"></span>
-00115 <span class="comment"> /** seconds east of UTC */</span>
-<a name="l00116"></a><a class="code" href="structapr__time__exp__t.html#o10">00116</a> apr_int32_t tm_gmtoff;
-00117 };
-00118 <span class="comment"></span>
-00119 <span class="comment">/**</span>
-00120 <span class="comment"> * convert an ansi time_t to an apr_time_t</span>
-00121 <span class="comment"> * @param result the resulting apr_time_t</span>
-00122 <span class="comment"> * @param input the time_t to convert</span>
-00123 <span class="comment"> */</span>
-00124 APR_DECLARE(<a class="code" href="group__apr__errno.html#ga0">apr_status_t</a>) apr_time_ansi_put(apr_time_t *result,
-00125 time_t input);
-00126 <span class="comment"></span>
-00127 <span class="comment">/**</span>
-00128 <span class="comment"> * convert a time to its human readable components using an offset</span>
-00129 <span class="comment"> * from GMT</span>
-00130 <span class="comment"> * @param result the exploded time</span>
-00131 <span class="comment"> * @param input the time to explode</span>
-00132 <span class="comment"> * @param offs the number of seconds offset to apply</span>
-00133 <span class="comment"> */</span>
-00134 APR_DECLARE(<a class="code" href="group__apr__errno.html#ga0">apr_status_t</a>) apr_time_exp_tz(<a class="code" href="structapr__time__exp__t.html">apr_time_exp_t</a> *result,
-00135 apr_time_t input,
-00136 apr_int32_t offs);
-00137 <span class="comment"></span>
-00138 <span class="comment">/**</span>
-00139 <span class="comment"> * convert a time to its human readable components in GMT timezone</span>
-00140 <span class="comment"> * @param result the exploded time</span>
-00141 <span class="comment"> * @param input the time to explode</span>
-00142 <span class="comment"> */</span>
-00143 APR_DECLARE(<a class="code" href="group__apr__errno.html#ga0">apr_status_t</a>) apr_time_exp_gmt(<a class="code" href="structapr__time__exp__t.html">apr_time_exp_t</a> *result,
-00144 apr_time_t input);
-00145 <span class="comment"></span>
-00146 <span class="comment">/**</span>
-00147 <span class="comment"> * convert a time to its human readable components in local timezone</span>
-00148 <span class="comment"> * @param result the exploded time</span>
-00149 <span class="comment"> * @param input the time to explode</span>
-00150 <span class="comment"> */</span>
-00151 APR_DECLARE(<a class="code" href="group__apr__errno.html#ga0">apr_status_t</a>) apr_time_exp_lt(<a class="code" href="structapr__time__exp__t.html">apr_time_exp_t</a> *result,
-00152 apr_time_t input);
-00153 <span class="comment"></span>
-00154 <span class="comment">/**</span>
-00155 <span class="comment"> * Convert time value from human readable format to a numeric apr_time_t </span>
-00156 <span class="comment"> * e.g. elapsed usec since epoch</span>
-00157 <span class="comment"> * @param result the resulting imploded time</span>
-00158 <span class="comment"> * @param input the input exploded time</span>
-00159 <span class="comment"> */</span>
-00160 APR_DECLARE(<a class="code" href="group__apr__errno.html#ga0">apr_status_t</a>) apr_time_exp_get(apr_time_t *result,
-00161 <a class="code" href="structapr__time__exp__t.html">apr_time_exp_t</a> *input);
-00162 <span class="comment"></span>
-00163 <span class="comment">/**</span>
-00164 <span class="comment"> * Convert time value from human readable format to a numeric apr_time_t that</span>
-00165 <span class="comment"> * always represents GMT</span>
-00166 <span class="comment"> * @param result the resulting imploded time</span>
-00167 <span class="comment"> * @param input the input exploded time</span>
-00168 <span class="comment"> */</span>
-00169 APR_DECLARE(<a class="code" href="group__apr__errno.html#ga0">apr_status_t</a>) apr_time_exp_gmt_get(apr_time_t *result,
-00170 <a class="code" href="structapr__time__exp__t.html">apr_time_exp_t</a> *input);
-00171 <span class="comment"></span>
-00172 <span class="comment">/**</span>
-00173 <span class="comment"> * Sleep for the specified number of micro-seconds.</span>
-00174 <span class="comment"> * @param t desired amount of time to sleep.</span>
-00175 <span class="comment"> * @warning May sleep for longer than the specified time. </span>
-00176 <span class="comment"> */</span>
-00177 APR_DECLARE(<span class="keywordtype">void</span>) apr_sleep(apr_interval_time_t t);
-00178 <span class="comment"></span>
-00179 <span class="comment">/** length of a RFC822 Date */</span>
-<a name="l00180"></a><a class="code" href="group__apr__time.html#ga27">00180</a> #define APR_RFC822_DATE_LEN (30)<span class="comment"></span>
-00181 <span class="comment">/**</span>
-00182 <span class="comment"> * apr_rfc822_date formats dates in the RFC822</span>
-00183 <span class="comment"> * format in an efficient manner. It is a fixed length</span>
-00184 <span class="comment"> * format which requires the indicated amount of storage,</span>
-00185 <span class="comment"> * including the trailing NUL terminator.</span>
-00186 <span class="comment"> * @param date_str String to write to.</span>
-00187 <span class="comment"> * @param t the time to convert </span>
-00188 <span class="comment"> */</span>
-00189 APR_DECLARE(<a class="code" href="group__apr__errno.html#ga0">apr_status_t</a>) apr_rfc822_date(<span class="keywordtype">char</span> *date_str, apr_time_t t);
-00190 <span class="comment"></span>
-00191 <span class="comment">/** length of a CTIME date */</span>
-<a name="l00192"></a><a class="code" href="group__apr__time.html#ga28">00192</a> #define APR_CTIME_LEN (25)<span class="comment"></span>
-00193 <span class="comment">/**</span>
-00194 <span class="comment"> * apr_ctime formats dates in the ctime() format</span>
-00195 <span class="comment"> * in an efficient manner. it is a fixed length format</span>
-00196 <span class="comment"> * and requires the indicated amount of storage including</span>
-00197 <span class="comment"> * the trailing NUL terminator.</span>
-00198 <span class="comment"> * Unlike ANSI/ISO C ctime(), apr_ctime() does not include</span>
-00199 <span class="comment"> * a \n at the end of the string.</span>
-00200 <span class="comment"> * @param date_str String to write to.</span>
-00201 <span class="comment"> * @param t the time to convert </span>
-00202 <span class="comment"> */</span>
-00203 APR_DECLARE(<a class="code" href="group__apr__errno.html#ga0">apr_status_t</a>) apr_ctime(<span class="keywordtype">char</span> *date_str, apr_time_t t);
-00204 <span class="comment"></span>
-00205 <span class="comment">/**</span>
-00206 <span class="comment"> * formats the exploded time according to the format specified</span>
-00207 <span class="comment"> * @param s string to write to</span>
-00208 <span class="comment"> * @param retsize The length of the returned string</span>
-00209 <span class="comment"> * @param max The maximum length of the string</span>
-00210 <span class="comment"> * @param format The format for the time string</span>
-00211 <span class="comment"> * @param tm The time to convert</span>
-00212 <span class="comment"> */</span>
-00213 APR_DECLARE(<a class="code" href="group__apr__errno.html#ga0">apr_status_t</a>) apr_strftime(<span class="keywordtype">char</span> *s, apr_size_t *retsize,
-00214 apr_size_t max, const <span class="keywordtype">char</span> *format,
-00215 <a class="code" href="structapr__time__exp__t.html">apr_time_exp_t</a> *tm);
-00216 <span class="comment"></span>
-00217 <span class="comment">/**</span>
-00218 <span class="comment"> * Improve the clock resolution for the lifetime of the given pool.</span>
-00219 <span class="comment"> * Generally this is only desireable on benchmarking and other very</span>
-00220 <span class="comment"> * time-sensitive applications, and has no impact on most platforms.</span>
-00221 <span class="comment"> * @param p The pool to associate the finer clock resolution </span>
-00222 <span class="comment"> */</span>
-00223 APR_DECLARE(<span class="keywordtype">void</span>) apr_time_clock_hires(<a class="code" href="group__apr__pools.html#ga0">apr_pool_t</a> *p);
-00224 <span class="comment"></span>
-00225 <span class="comment">/** @} */</span>
-00226
-00227 #ifdef __cplusplus
-00228 }
-00229 #endif
-00230
-00231 #endif <span class="comment">/* ! APR_TIME_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_time.h</h1><a href="apr__time_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_TIME_H</span>
+00018 <span class="preprocessor"></span><span class="preprocessor">#define APR_TIME_H</span>
+00019 <span class="preprocessor"></span><span class="comment"></span>
+00020 <span class="comment">/**</span>
+00021 <span class="comment"> * @file apr_time.h</span>
+00022 <span class="comment"> * @brief APR Time Library</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_time Time 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">/** month names */</span>
+<a name="l00040"></a><a class="code" href="group__apr__time.html#ga0">00040</a> APR_DECLARE_DATA <span class="keyword">extern</span> <span class="keyword">const</span> <span class="keywordtype">char</span> <a class="code" href="group__apr__time.html#ga0">apr_month_snames</a>[12][4];<span class="comment"></span>
+00041 <span class="comment">/** day names */</span>
+<a name="l00042"></a><a class="code" href="group__apr__time.html#ga1">00042</a> APR_DECLARE_DATA <span class="keyword">extern</span> <span class="keyword">const</span> <span class="keywordtype">char</span> <a class="code" href="group__apr__time.html#ga1">apr_day_snames</a>[7][4];
+00043
+00044 <span class="comment"></span>
+00045 <span class="comment">/** number of microseconds since 00:00:00 january 1, 1970 UTC */</span>
+<a name="l00046"></a><a class="code" href="group__apr__time.html#ga2">00046</a> <span class="keyword">typedef</span> apr_int64_t <a class="code" href="group__apr__time.html#ga2">apr_time_t</a>;
+00047
+00048 <span class="comment"></span>
+00049 <span class="comment">/** mechanism to properly type apr_time_t literals */</span>
+<a name="l00050"></a><a class="code" href="group__apr__time.html#ga18">00050</a> <span class="preprocessor">#define APR_TIME_C(val) APR_INT64_C(val)</span>
+00051 <span class="preprocessor"></span><span class="comment"></span>
+00052 <span class="comment">/** mechanism to properly print apr_time_t values */</span>
+<a name="l00053"></a><a class="code" href="group__apr__time.html#ga19">00053</a> <span class="preprocessor">#define APR_TIME_T_FMT APR_INT64_T_FMT</span>
+00054 <span class="preprocessor"></span><span class="comment"></span>
+00055 <span class="comment">/** intervals for I/O timeouts, in microseconds */</span>
+<a name="l00056"></a><a class="code" href="group__apr__time.html#ga3">00056</a> <span class="keyword">typedef</span> apr_int64_t <a class="code" href="group__apr__time.html#ga3">apr_interval_time_t</a>;<span class="comment"></span>
+00057 <span class="comment">/** short interval for I/O timeouts, in microseconds */</span>
+<a name="l00058"></a><a class="code" href="group__apr__time.html#ga4">00058</a> <span class="keyword">typedef</span> apr_int32_t <a class="code" href="group__apr__time.html#ga4">apr_short_interval_time_t</a>;
+00059 <span class="comment"></span>
+00060 <span class="comment">/** number of microseconds per second */</span>
+<a name="l00061"></a><a class="code" href="group__apr__time.html#ga20">00061</a> <span class="preprocessor">#define APR_USEC_PER_SEC APR_TIME_C(1000000)</span>
+00062 <span class="preprocessor"></span><span class="comment"></span>
+00063 <span class="comment">/** @return apr_time_t as a second */</span>
+<a name="l00064"></a><a class="code" href="group__apr__time.html#ga21">00064</a> <span class="preprocessor">#define apr_time_sec(time) ((time) / APR_USEC_PER_SEC)</span>
+00065 <span class="preprocessor"></span><span class="comment"></span>
+00066 <span class="comment">/** @return apr_time_t as a usec */</span>
+<a name="l00067"></a><a class="code" href="group__apr__time.html#ga22">00067</a> <span class="preprocessor">#define apr_time_usec(time) ((time) % APR_USEC_PER_SEC)</span>
+00068 <span class="preprocessor"></span><span class="comment"></span>
+00069 <span class="comment">/** @return apr_time_t as a msec */</span>
+<a name="l00070"></a><a class="code" href="group__apr__time.html#ga23">00070</a> <span class="preprocessor">#define apr_time_msec(time) (((time) / 1000) % 1000)</span>
+00071 <span class="preprocessor"></span><span class="comment"></span>
+00072 <span class="comment">/** @return apr_time_t as a msec */</span>
+<a name="l00073"></a><a class="code" href="group__apr__time.html#ga24">00073</a> <span class="preprocessor">#define apr_time_as_msec(time) ((time) / 1000)</span>
+00074 <span class="preprocessor"></span><span class="comment"></span>
+00075 <span class="comment">/** @return a second as an apr_time_t */</span>
+<a name="l00076"></a><a class="code" href="group__apr__time.html#ga25">00076</a> <span class="preprocessor">#define apr_time_from_sec(sec) ((apr_time_t)(sec) * APR_USEC_PER_SEC)</span>
+00077 <span class="preprocessor"></span><span class="comment"></span>
+00078 <span class="comment">/** @return a second and usec combination as an apr_time_t */</span>
+<a name="l00079"></a><a class="code" href="group__apr__time.html#ga26">00079</a> <span class="preprocessor">#define apr_time_make(sec, usec) ((apr_time_t)(sec) * APR_USEC_PER_SEC \</span>
+00080 <span class="preprocessor"> + (apr_time_t)(usec))</span>
+00081 <span class="preprocessor"></span><span class="comment"></span>
+00082 <span class="comment">/**</span>
+00083 <span class="comment"> * @return the current time</span>
+00084 <span class="comment"> */</span>
+00085 APR_DECLARE(apr_time_t) apr_time_now(<span class="keywordtype">void</span>);
+00086 <span class="comment"></span>
+00087 <span class="comment">/** @see apr_time_exp_t */</span>
+<a name="l00088"></a><a class="code" href="group__apr__time.html#ga5">00088</a> typedef struct <a class="code" href="structapr__time__exp__t.html">apr_time_exp_t</a> <a class="code" href="structapr__time__exp__t.html">apr_time_exp_t</a>;
+00089 <span class="comment"></span>
+00090 <span class="comment">/**</span>
+00091 <span class="comment"> * a structure similar to ANSI struct tm with the following differences:</span>
+00092 <span class="comment"> * - tm_usec isn't an ANSI field</span>
+00093 <span class="comment"> * - tm_gmtoff isn't an ANSI field (it's a bsdism)</span>
+00094 <span class="comment"> */</span>
+<a name="l00095"></a><a class="code" href="structapr__time__exp__t.html">00095</a> struct apr_time_exp_t {<span class="comment"></span>
+00096 <span class="comment"> /** microseconds past tm_sec */</span>
+<a name="l00097"></a><a class="code" href="structapr__time__exp__t.html#o0">00097</a> apr_int32_t tm_usec;<span class="comment"></span>
+00098 <span class="comment"> /** (0-61) seconds past tm_min */</span>
+<a name="l00099"></a><a class="code" href="structapr__time__exp__t.html#o1">00099</a> apr_int32_t tm_sec;<span class="comment"></span>
+00100 <span class="comment"> /** (0-59) minutes past tm_hour */</span>
+<a name="l00101"></a><a class="code" href="structapr__time__exp__t.html#o2">00101</a> apr_int32_t tm_min;<span class="comment"></span>
+00102 <span class="comment"> /** (0-23) hours past midnight */</span>
+<a name="l00103"></a><a class="code" href="structapr__time__exp__t.html#o3">00103</a> apr_int32_t tm_hour;<span class="comment"></span>
+00104 <span class="comment"> /** (1-31) day of the month */</span>
+<a name="l00105"></a><a class="code" href="structapr__time__exp__t.html#o4">00105</a> apr_int32_t tm_mday;<span class="comment"></span>
+00106 <span class="comment"> /** (0-11) month of the year */</span>
+<a name="l00107"></a><a class="code" href="structapr__time__exp__t.html#o5">00107</a> apr_int32_t tm_mon;<span class="comment"></span>
+00108 <span class="comment"> /** year since 1900 */</span>
+<a name="l00109"></a><a class="code" href="structapr__time__exp__t.html#o6">00109</a> apr_int32_t tm_year;<span class="comment"></span>
+00110 <span class="comment"> /** (0-6) days since sunday */</span>
+<a name="l00111"></a><a class="code" href="structapr__time__exp__t.html#o7">00111</a> apr_int32_t tm_wday;<span class="comment"></span>
+00112 <span class="comment"> /** (0-365) days since jan 1 */</span>
+<a name="l00113"></a><a class="code" href="structapr__time__exp__t.html#o8">00113</a> apr_int32_t tm_yday;<span class="comment"></span>
+00114 <span class="comment"> /** daylight saving time */</span>
+<a name="l00115"></a><a class="code" href="structapr__time__exp__t.html#o9">00115</a> apr_int32_t tm_isdst;<span class="comment"></span>
+00116 <span class="comment"> /** seconds east of UTC */</span>
+<a name="l00117"></a><a class="code" href="structapr__time__exp__t.html#o10">00117</a> apr_int32_t tm_gmtoff;
+00118 };
+00119 <span class="comment"></span>
+00120 <span class="comment">/**</span>
+00121 <span class="comment"> * convert an ansi time_t to an apr_time_t</span>
+00122 <span class="comment"> * @param result the resulting apr_time_t</span>
+00123 <span class="comment"> * @param input the time_t to convert</span>
+00124 <span class="comment"> */</span>
+00125 APR_DECLARE(apr_status_t) apr_time_ansi_put(apr_time_t *result,
+00126 time_t input);
+00127 <span class="comment"></span>
+00128 <span class="comment">/**</span>
+00129 <span class="comment"> * convert a time to its human readable components using an offset</span>
+00130 <span class="comment"> * from GMT</span>
+00131 <span class="comment"> * @param result the exploded time</span>
+00132 <span class="comment"> * @param input the time to explode</span>
+00133 <span class="comment"> * @param offs the number of seconds offset to apply</span>
+00134 <span class="comment"> */</span>
+00135 APR_DECLARE(apr_status_t) apr_time_exp_tz(<a class="code" href="structapr__time__exp__t.html">apr_time_exp_t</a> *result,
+00136 apr_time_t input,
+00137 apr_int32_t offs);
+00138 <span class="comment"></span>
+00139 <span class="comment">/**</span>
+00140 <span class="comment"> * convert a time to its human readable components in GMT timezone</span>
+00141 <span class="comment"> * @param result the exploded time</span>
+00142 <span class="comment"> * @param input the time to explode</span>
+00143 <span class="comment"> */</span>
+00144 APR_DECLARE(apr_status_t) apr_time_exp_gmt(<a class="code" href="structapr__time__exp__t.html">apr_time_exp_t</a> *result,
+00145 apr_time_t input);
+00146 <span class="comment"></span>
+00147 <span class="comment">/**</span>
+00148 <span class="comment"> * convert a time to its human readable components in local timezone</span>
+00149 <span class="comment"> * @param result the exploded time</span>
+00150 <span class="comment"> * @param input the time to explode</span>
+00151 <span class="comment"> */</span>
+00152 APR_DECLARE(apr_status_t) apr_time_exp_lt(<a class="code" href="structapr__time__exp__t.html">apr_time_exp_t</a> *result,
+00153 apr_time_t input);
+00154 <span class="comment"></span>
+00155 <span class="comment">/**</span>
+00156 <span class="comment"> * Convert time value from human readable format to a numeric apr_time_t </span>
+00157 <span class="comment"> * e.g. elapsed usec since epoch</span>
+00158 <span class="comment"> * @param result the resulting imploded time</span>
+00159 <span class="comment"> * @param input the input exploded time</span>
+00160 <span class="comment"> */</span>
+00161 APR_DECLARE(apr_status_t) apr_time_exp_get(apr_time_t *result,
+00162 <a class="code" href="structapr__time__exp__t.html">apr_time_exp_t</a> *input);
+00163 <span class="comment"></span>
+00164 <span class="comment">/**</span>
+00165 <span class="comment"> * Convert time value from human readable format to a numeric apr_time_t that</span>
+00166 <span class="comment"> * always represents GMT</span>
+00167 <span class="comment"> * @param result the resulting imploded time</span>
+00168 <span class="comment"> * @param input the input exploded time</span>
+00169 <span class="comment"> */</span>
+00170 APR_DECLARE(apr_status_t) apr_time_exp_gmt_get(apr_time_t *result,
+00171 <a class="code" href="structapr__time__exp__t.html">apr_time_exp_t</a> *input);
+00172 <span class="comment"></span>
+00173 <span class="comment">/**</span>
+00174 <span class="comment"> * Sleep for the specified number of micro-seconds.</span>
+00175 <span class="comment"> * @param t desired amount of time to sleep.</span>
+00176 <span class="comment"> * @warning May sleep for longer than the specified time. </span>
+00177 <span class="comment"> */</span>
+00178 APR_DECLARE(<span class="keywordtype">void</span>) apr_sleep(apr_interval_time_t t);
+00179 <span class="comment"></span>
+00180 <span class="comment">/** length of a RFC822 Date */</span>
+<a name="l00181"></a><a class="code" href="group__apr__time.html#ga27">00181</a> #define APR_RFC822_DATE_LEN (30)<span class="comment"></span>
+00182 <span class="comment">/**</span>
+00183 <span class="comment"> * apr_rfc822_date formats dates in the RFC822</span>
+00184 <span class="comment"> * format in an efficient manner. It is a fixed length</span>
+00185 <span class="comment"> * format which requires the indicated amount of storage,</span>
+00186 <span class="comment"> * including the trailing NUL terminator.</span>
+00187 <span class="comment"> * @param date_str String to write to.</span>
+00188 <span class="comment"> * @param t the time to convert </span>
+00189 <span class="comment"> */</span>
+00190 APR_DECLARE(apr_status_t) apr_rfc822_date(<span class="keywordtype">char</span> *date_str, apr_time_t t);
+00191 <span class="comment"></span>
+00192 <span class="comment">/** length of a CTIME date */</span>
+<a name="l00193"></a><a class="code" href="group__apr__time.html#ga28">00193</a> #define APR_CTIME_LEN (25)<span class="comment"></span>
+00194 <span class="comment">/**</span>
+00195 <span class="comment"> * apr_ctime formats dates in the ctime() format</span>
+00196 <span class="comment"> * in an efficient manner. it is a fixed length format</span>
+00197 <span class="comment"> * and requires the indicated amount of storage including</span>
+00198 <span class="comment"> * the trailing NUL terminator.</span>
+00199 <span class="comment"> * Unlike ANSI/ISO C ctime(), apr_ctime() does not include</span>
+00200 <span class="comment"> * a \n at the end of the string.</span>
+00201 <span class="comment"> * @param date_str String to write to.</span>
+00202 <span class="comment"> * @param t the time to convert </span>
+00203 <span class="comment"> */</span>
+00204 APR_DECLARE(apr_status_t) apr_ctime(<span class="keywordtype">char</span> *date_str, apr_time_t t);
+00205 <span class="comment"></span>
+00206 <span class="comment">/**</span>
+00207 <span class="comment"> * formats the exploded time according to the format specified</span>
+00208 <span class="comment"> * @param s string to write to</span>
+00209 <span class="comment"> * @param retsize The length of the returned string</span>
+00210 <span class="comment"> * @param max The maximum length of the string</span>
+00211 <span class="comment"> * @param format The format for the time string</span>
+00212 <span class="comment"> * @param tm The time to convert</span>
+00213 <span class="comment"> */</span>
+00214 APR_DECLARE(apr_status_t) apr_strftime(<span class="keywordtype">char</span> *s, apr_size_t *retsize,
+00215 apr_size_t max, const <span class="keywordtype">char</span> *format,
+00216 <a class="code" href="structapr__time__exp__t.html">apr_time_exp_t</a> *tm);
+00217 <span class="comment"></span>
+00218 <span class="comment">/**</span>
+00219 <span class="comment"> * Improve the clock resolution for the lifetime of the given pool.</span>
+00220 <span class="comment"> * Generally this is only desireable on benchmarking and other very</span>
+00221 <span class="comment"> * time-sensitive applications, and has no impact on most platforms.</span>
+00222 <span class="comment"> * @param p The pool to associate the finer clock resolution </span>
+00223 <span class="comment"> */</span>
+00224 APR_DECLARE(<span class="keywordtype">void</span>) apr_time_clock_hires(apr_pool_t *p);
+00225 <span class="comment"></span>
+00226 <span class="comment">/** @} */</span>
+00227
+00228 #ifdef __cplusplus
+00229 }
+00230 #endif
+00231
+00232 #endif <span class="comment">/* ! APR_TIME_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__time_8h.html
URL: http://svn.apache.org/viewcvs/apr/site/trunk/docs/docs/apr/apr__time_8h.html?view=diff&r1=151767&r2=151768
==============================================================================
--- apr/site/trunk/docs/docs/apr/apr__time_8h.html (original)
+++ apr/site/trunk/docs/docs/apr/apr__time_8h.html Mon Feb 7 15:10:17 2005
@@ -3,9 +3,10 @@
<title>Apache Portable Runtime: apr_time.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 Page</a> | <a class="qindex" href="modules.html">Modules</a> | <a class="qindex" href="annotated.html">Data Structures</a> | <a class="qindex" href="files.html">File List</a> | <a class="qindex" href="functions.html">Data Fields</a> | <a class="qindex" href="globals.html">Globals</a> | <a class="qindex" href="pages.html">Related Pages</a></div>
-<h1>apr_time.h File Reference</h1>APR Time Library. <a href="#_details">More...</a>
+<h1>apr_time.h File Reference</h1>APR Time Library.
+<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>
@@ -83,8 +84,8 @@
<hr><a name="_details"></a><h2>Detailed Description</h2>
APR Time Library.
<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__user_8h-source.html
URL: http://svn.apache.org/viewcvs/apr/site/trunk/docs/docs/apr/apr__user_8h-source.html?view=diff&r1=151767&r2=151768
==============================================================================
--- apr/site/trunk/docs/docs/apr/apr__user_8h-source.html (original)
+++ apr/site/trunk/docs/docs/apr/apr__user_8h-source.html Mon Feb 7 15:10:17 2005
@@ -3,167 +3,168 @@
<title>Apache Portable Runtime: apr_user.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 Page</a> | <a class="qindex" href="modules.html">Modules</a> | <a class="qindex" href="annotated.html">Data Structures</a> | <a class="qindex" href="files.html">File List</a> | <a class="qindex" href="functions.html">Data Fields</a> | <a class="qindex" href="globals.html">Globals</a> | <a class="qindex" href="pages.html">Related Pages</a></div>
-<h1>apr_user.h</h1><a href="apr__user_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_USER_H</span>
-00017 <span class="preprocessor"></span><span class="preprocessor">#define APR_USER_H</span>
-00018 <span class="preprocessor"></span><span class="comment"></span>
-00019 <span class="comment">/**</span>
-00020 <span class="comment"> * @file apr_user.h</span>
-00021 <span class="comment"> * @brief APR User ID Services </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__errno_8h.html">apr_errno.h</a>"</span>
-00026 <span class="preprocessor">#include "<a class="code" href="apr__pools_8h.html">apr_pools.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_user User and Group ID Services</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"> * Structure for determining user ownership.</span>
-00040 <span class="comment"> */</span>
-00041 <span class="preprocessor">#ifdef WIN32</span>
-00042 <span class="preprocessor"></span><span class="keyword">typedef</span> PSID <a class="code" href="group__apr__user.html#ga0">apr_uid_t</a>;
-00043 <span class="preprocessor">#else</span>
-<a name="l00044"></a><a class="code" href="group__apr__user.html#ga0">00044</a> <span class="preprocessor"></span><span class="keyword">typedef</span> uid_t <a class="code" href="group__apr__user.html#ga0">apr_uid_t</a>;
-00045 <span class="preprocessor">#endif</span>
-00046 <span class="preprocessor"></span><span class="comment"></span>
-00047 <span class="comment">/**</span>
-00048 <span class="comment"> * Structure for determining group ownership.</span>
-00049 <span class="comment"> */</span>
-00050 <span class="preprocessor">#ifdef WIN32</span>
-00051 <span class="preprocessor"></span><span class="keyword">typedef</span> PSID <a class="code" href="group__apr__user.html#ga1">apr_gid_t</a>;
-00052 <span class="preprocessor">#else</span>
-<a name="l00053"></a><a class="code" href="group__apr__user.html#ga1">00053</a> <span class="preprocessor"></span><span class="keyword">typedef</span> gid_t <a class="code" href="group__apr__user.html#ga1">apr_gid_t</a>;
-00054 <span class="preprocessor">#endif</span>
-00055 <span class="preprocessor"></span>
-00056 <span class="preprocessor">#if APR_HAS_USER </span>
-00057 <span class="preprocessor"></span><span class="comment"></span>
-00058 <span class="comment">/**</span>
-00059 <span class="comment"> * Get the userid (and groupid) of the calling process</span>
-00060 <span class="comment"> * @param userid Returns the user id</span>
-00061 <span class="comment"> * @param groupid Returns the user's group id</span>
-00062 <span class="comment"> * @param p The pool from which to allocate working space</span>
-00063 <span class="comment"> * @remark This function is available only if APR_HAS_USER is defined.</span>
-00064 <span class="comment"> */</span>
-00065 APR_DECLARE(<a class="code" href="group__apr__errno.html#ga0">apr_status_t</a>) apr_uid_current(apr_uid_t *userid,
-00066 apr_gid_t *groupid,
-00067 <a class="code" href="group__apr__pools.html#ga0">apr_pool_t</a> *p);
-00068 <span class="comment"></span>
-00069 <span class="comment">/**</span>
-00070 <span class="comment"> * Get the user name for a specified userid</span>
-00071 <span class="comment"> * @param username Pointer to new string containing user name (on output)</span>
-00072 <span class="comment"> * @param userid The userid</span>
-00073 <span class="comment"> * @param p The pool from which to allocate the string</span>
-00074 <span class="comment"> * @remark This function is available only if APR_HAS_USER is defined.</span>
-00075 <span class="comment"> */</span>
-00076 APR_DECLARE(<a class="code" href="group__apr__errno.html#ga0">apr_status_t</a>) apr_uid_name_get(<span class="keywordtype">char</span> **username, apr_uid_t userid,
-00077 <a class="code" href="group__apr__pools.html#ga0">apr_pool_t</a> *p);
-00078 <span class="comment"></span>
-00079 <span class="comment">/**</span>
-00080 <span class="comment"> * Get the userid (and groupid) for the specified username</span>
-00081 <span class="comment"> * @param userid Returns the user id</span>
-00082 <span class="comment"> * @param groupid Returns the user's group id</span>
-00083 <span class="comment"> * @param username The username to lookup</span>
-00084 <span class="comment"> * @param p The pool from which to allocate working space</span>
-00085 <span class="comment"> * @remark This function is available only if APR_HAS_USER is defined.</span>
-00086 <span class="comment"> */</span>
-00087 APR_DECLARE(<a class="code" href="group__apr__errno.html#ga0">apr_status_t</a>) apr_uid_get(apr_uid_t *userid, apr_gid_t *groupid,
-00088 const <span class="keywordtype">char</span> *username, <a class="code" href="group__apr__pools.html#ga0">apr_pool_t</a> *p);
-00089 <span class="comment"></span>
-00090 <span class="comment">/**</span>
-00091 <span class="comment"> * Get the home directory for the named user</span>
-00092 <span class="comment"> * @param dirname Pointer to new string containing directory name (on output)</span>
-00093 <span class="comment"> * @param username The named user</span>
-00094 <span class="comment"> * @param p The pool from which to allocate the string</span>
-00095 <span class="comment"> * @remark This function is available only if APR_HAS_USER is defined.</span>
-00096 <span class="comment"> */</span>
-00097 APR_DECLARE(<a class="code" href="group__apr__errno.html#ga0">apr_status_t</a>) apr_uid_homepath_get(<span class="keywordtype">char</span> **dirname,
-00098 const <span class="keywordtype">char</span> *username,
-00099 <a class="code" href="group__apr__pools.html#ga0">apr_pool_t</a> *p);
-00100 <span class="comment"></span>
-00101 <span class="comment">/**</span>
-00102 <span class="comment"> * Compare two user identifiers for equality.</span>
-00103 <span class="comment"> * @param left One uid to test</span>
-00104 <span class="comment"> * @param right Another uid to test</span>
-00105 <span class="comment"> * @return APR_SUCCESS if the apr_uid_t strutures identify the same user,</span>
-00106 <span class="comment"> * APR_EMISMATCH if not, APR_BADARG if an apr_uid_t is invalid.</span>
-00107 <span class="comment"> * @remark This function is available only if APR_HAS_USER is defined.</span>
-00108 <span class="comment"> */</span>
-00109 #if defined(WIN32)
-00110 APR_DECLARE(<a class="code" href="group__apr__errno.html#ga0">apr_status_t</a>) apr_uid_compare(apr_uid_t left, apr_uid_t right);
-00111 #else
-00112 #define apr_uid_compare(left,right) (((left) == (right)) ? APR_SUCCESS : APR_EMISMATCH)
-00113 #endif
-00114 <span class="comment"></span>
-00115 <span class="comment">/**</span>
-00116 <span class="comment"> * Get the group name for a specified groupid</span>
-00117 <span class="comment"> * @param groupname Pointer to new string containing group name (on output)</span>
-00118 <span class="comment"> * @param groupid The groupid</span>
-00119 <span class="comment"> * @param p The pool from which to allocate the string</span>
-00120 <span class="comment"> * @remark This function is available only if APR_HAS_USER is defined.</span>
-00121 <span class="comment"> */</span>
-00122 APR_DECLARE(<a class="code" href="group__apr__errno.html#ga0">apr_status_t</a>) apr_gid_name_get(<span class="keywordtype">char</span> **groupname,
-00123 apr_gid_t groupid, <a class="code" href="group__apr__pools.html#ga0">apr_pool_t</a> *p);
-00124 <span class="comment"></span>
-00125 <span class="comment">/**</span>
-00126 <span class="comment"> * Get the groupid for a specified group name</span>
-00127 <span class="comment"> * @param groupid Pointer to the group id (on output)</span>
-00128 <span class="comment"> * @param groupname The group name to look up</span>
-00129 <span class="comment"> * @param p The pool from which to allocate the string</span>
-00130 <span class="comment"> * @remark This function is available only if APR_HAS_USER is defined.</span>
-00131 <span class="comment"> */</span>
-00132 APR_DECLARE(<a class="code" href="group__apr__errno.html#ga0">apr_status_t</a>) apr_gid_get(apr_gid_t *groupid,
-00133 const <span class="keywordtype">char</span> *groupname, <a class="code" href="group__apr__pools.html#ga0">apr_pool_t</a> *p);
-00134 <span class="comment"></span>
-00135 <span class="comment">/**</span>
-00136 <span class="comment"> * Compare two group identifiers for equality.</span>
-00137 <span class="comment"> * @param left One gid to test</span>
-00138 <span class="comment"> * @param right Another gid to test</span>
-00139 <span class="comment"> * @return APR_SUCCESS if the apr_gid_t strutures identify the same group,</span>
-00140 <span class="comment"> * APR_EMISMATCH if not, APR_BADARG if an apr_gid_t is invalid.</span>
-00141 <span class="comment"> * @remark This function is available only if APR_HAS_USER is defined.</span>
-00142 <span class="comment"> */</span>
-00143 #if defined(WIN32)
-00144 APR_DECLARE(<a class="code" href="group__apr__errno.html#ga0">apr_status_t</a>) apr_gid_compare(apr_gid_t left, apr_gid_t right);
-00145 #else
-00146 #define apr_gid_compare(left,right) (((left) == (right)) ? APR_SUCCESS : APR_EMISMATCH)
-00147 #endif
-00148
-00149 #endif <span class="comment">/* ! APR_HAS_USER */</span>
-00150 <span class="comment"></span>
-00151 <span class="comment">/** @} */</span>
-00152
-00153 #ifdef __cplusplus
-00154 }
-00155 #endif
-00156
-00157 #endif <span class="comment">/* ! APR_USER_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_user.h</h1><a href="apr__user_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_USER_H</span>
+00018 <span class="preprocessor"></span><span class="preprocessor">#define APR_USER_H</span>
+00019 <span class="preprocessor"></span><span class="comment"></span>
+00020 <span class="comment">/**</span>
+00021 <span class="comment"> * @file apr_user.h</span>
+00022 <span class="comment"> * @brief APR User ID Services </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__errno_8h.html">apr_errno.h</a>"</span>
+00027 <span class="preprocessor">#include "<a class="code" href="apr__pools_8h.html">apr_pools.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_user User and Group ID Services</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"> * Structure for determining user ownership.</span>
+00041 <span class="comment"> */</span>
+00042 <span class="preprocessor">#ifdef WIN32</span>
+00043 <span class="preprocessor"></span><span class="keyword">typedef</span> PSID <a class="code" href="group__apr__user.html#ga0">apr_uid_t</a>;
+00044 <span class="preprocessor">#else</span>
+<a name="l00045"></a><a class="code" href="group__apr__user.html#ga0">00045</a> <span class="preprocessor"></span><span class="keyword">typedef</span> uid_t <a class="code" href="group__apr__user.html#ga0">apr_uid_t</a>;
+00046 <span class="preprocessor">#endif</span>
+00047 <span class="preprocessor"></span><span class="comment"></span>
+00048 <span class="comment">/**</span>
+00049 <span class="comment"> * Structure for determining group ownership.</span>
+00050 <span class="comment"> */</span>
+00051 <span class="preprocessor">#ifdef WIN32</span>
+00052 <span class="preprocessor"></span><span class="keyword">typedef</span> PSID <a class="code" href="group__apr__user.html#ga1">apr_gid_t</a>;
+00053 <span class="preprocessor">#else</span>
+<a name="l00054"></a><a class="code" href="group__apr__user.html#ga1">00054</a> <span class="preprocessor"></span><span class="keyword">typedef</span> gid_t <a class="code" href="group__apr__user.html#ga1">apr_gid_t</a>;
+00055 <span class="preprocessor">#endif</span>
+00056 <span class="preprocessor"></span>
+00057 <span class="preprocessor">#if APR_HAS_USER </span>
+00058 <span class="preprocessor"></span><span class="comment"></span>
+00059 <span class="comment">/**</span>
+00060 <span class="comment"> * Get the userid (and groupid) of the calling process</span>
+00061 <span class="comment"> * @param userid Returns the user id</span>
+00062 <span class="comment"> * @param groupid Returns the user's group id</span>
+00063 <span class="comment"> * @param p The pool from which to allocate working space</span>
+00064 <span class="comment"> * @remark This function is available only if APR_HAS_USER is defined.</span>
+00065 <span class="comment"> */</span>
+00066 APR_DECLARE(apr_status_t) apr_uid_current(apr_uid_t *userid,
+00067 apr_gid_t *groupid,
+00068 apr_pool_t *p);
+00069 <span class="comment"></span>
+00070 <span class="comment">/**</span>
+00071 <span class="comment"> * Get the user name for a specified userid</span>
+00072 <span class="comment"> * @param username Pointer to new string containing user name (on output)</span>
+00073 <span class="comment"> * @param userid The userid</span>
+00074 <span class="comment"> * @param p The pool from which to allocate the string</span>
+00075 <span class="comment"> * @remark This function is available only if APR_HAS_USER is defined.</span>
+00076 <span class="comment"> */</span>
+00077 APR_DECLARE(apr_status_t) apr_uid_name_get(<span class="keywordtype">char</span> **username, apr_uid_t userid,
+00078 apr_pool_t *p);
+00079 <span class="comment"></span>
+00080 <span class="comment">/**</span>
+00081 <span class="comment"> * Get the userid (and groupid) for the specified username</span>
+00082 <span class="comment"> * @param userid Returns the user id</span>
+00083 <span class="comment"> * @param groupid Returns the user's group id</span>
+00084 <span class="comment"> * @param username The username to lookup</span>
+00085 <span class="comment"> * @param p The pool from which to allocate working space</span>
+00086 <span class="comment"> * @remark This function is available only if APR_HAS_USER is defined.</span>
+00087 <span class="comment"> */</span>
+00088 APR_DECLARE(apr_status_t) apr_uid_get(apr_uid_t *userid, apr_gid_t *groupid,
+00089 const <span class="keywordtype">char</span> *username, apr_pool_t *p);
+00090 <span class="comment"></span>
+00091 <span class="comment">/**</span>
+00092 <span class="comment"> * Get the home directory for the named user</span>
+00093 <span class="comment"> * @param dirname Pointer to new string containing directory name (on output)</span>
+00094 <span class="comment"> * @param username The named user</span>
+00095 <span class="comment"> * @param p The pool from which to allocate the string</span>
+00096 <span class="comment"> * @remark This function is available only if APR_HAS_USER is defined.</span>
+00097 <span class="comment"> */</span>
+00098 APR_DECLARE(apr_status_t) apr_uid_homepath_get(<span class="keywordtype">char</span> **dirname,
+00099 const <span class="keywordtype">char</span> *username,
+00100 apr_pool_t *p);
+00101 <span class="comment"></span>
+00102 <span class="comment">/**</span>
+00103 <span class="comment"> * Compare two user identifiers for equality.</span>
+00104 <span class="comment"> * @param left One uid to test</span>
+00105 <span class="comment"> * @param right Another uid to test</span>
+00106 <span class="comment"> * @return APR_SUCCESS if the apr_uid_t strutures identify the same user,</span>
+00107 <span class="comment"> * APR_EMISMATCH if not, APR_BADARG if an apr_uid_t is invalid.</span>
+00108 <span class="comment"> * @remark This function is available only if APR_HAS_USER is defined.</span>
+00109 <span class="comment"> */</span>
+00110 #if defined(WIN32)
+00111 APR_DECLARE(apr_status_t) apr_uid_compare(apr_uid_t left, apr_uid_t right);
+00112 #else
+00113 #define apr_uid_compare(left,right) (((left) == (right)) ? APR_SUCCESS : APR_EMISMATCH)
+00114 #endif
+00115 <span class="comment"></span>
+00116 <span class="comment">/**</span>
+00117 <span class="comment"> * Get the group name for a specified groupid</span>
+00118 <span class="comment"> * @param groupname Pointer to new string containing group name (on output)</span>
+00119 <span class="comment"> * @param groupid The groupid</span>
+00120 <span class="comment"> * @param p The pool from which to allocate the string</span>
+00121 <span class="comment"> * @remark This function is available only if APR_HAS_USER is defined.</span>
+00122 <span class="comment"> */</span>
+00123 APR_DECLARE(apr_status_t) apr_gid_name_get(<span class="keywordtype">char</span> **groupname,
+00124 apr_gid_t groupid, apr_pool_t *p);
+00125 <span class="comment"></span>
+00126 <span class="comment">/**</span>
+00127 <span class="comment"> * Get the groupid for a specified group name</span>
+00128 <span class="comment"> * @param groupid Pointer to the group id (on output)</span>
+00129 <span class="comment"> * @param groupname The group name to look up</span>
+00130 <span class="comment"> * @param p The pool from which to allocate the string</span>
+00131 <span class="comment"> * @remark This function is available only if APR_HAS_USER is defined.</span>
+00132 <span class="comment"> */</span>
+00133 APR_DECLARE(apr_status_t) apr_gid_get(apr_gid_t *groupid,
+00134 const <span class="keywordtype">char</span> *groupname, apr_pool_t *p);
+00135 <span class="comment"></span>
+00136 <span class="comment">/**</span>
+00137 <span class="comment"> * Compare two group identifiers for equality.</span>
+00138 <span class="comment"> * @param left One gid to test</span>
+00139 <span class="comment"> * @param right Another gid to test</span>
+00140 <span class="comment"> * @return APR_SUCCESS if the apr_gid_t strutures identify the same group,</span>
+00141 <span class="comment"> * APR_EMISMATCH if not, APR_BADARG if an apr_gid_t is invalid.</span>
+00142 <span class="comment"> * @remark This function is available only if APR_HAS_USER is defined.</span>
+00143 <span class="comment"> */</span>
+00144 #if defined(WIN32)
+00145 APR_DECLARE(apr_status_t) apr_gid_compare(apr_gid_t left, apr_gid_t right);
+00146 #else
+00147 #define apr_gid_compare(left,right) (((left) == (right)) ? APR_SUCCESS : APR_EMISMATCH)
+00148 #endif
+00149
+00150 #endif <span class="comment">/* ! APR_HAS_USER */</span>
+00151 <span class="comment"></span>
+00152 <span class="comment">/** @} */</span>
+00153
+00154 #ifdef __cplusplus
+00155 }
+00156 #endif
+00157
+00158 #endif <span class="comment">/* ! APR_USER_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__user_8h.html
URL: http://svn.apache.org/viewcvs/apr/site/trunk/docs/docs/apr/apr__user_8h.html?view=diff&r1=151767&r2=151768
==============================================================================
--- apr/site/trunk/docs/docs/apr/apr__user_8h.html (original)
+++ apr/site/trunk/docs/docs/apr/apr__user_8h.html Mon Feb 7 15:10:17 2005
@@ -3,9 +3,10 @@
<title>Apache Portable Runtime: apr_user.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 Page</a> | <a class="qindex" href="modules.html">Modules</a> | <a class="qindex" href="annotated.html">Data Structures</a> | <a class="qindex" href="files.html">File List</a> | <a class="qindex" href="functions.html">Data Fields</a> | <a class="qindex" href="globals.html">Globals</a> | <a class="qindex" href="pages.html">Related Pages</a></div>
-<h1>apr_user.h File Reference</h1>APR User ID Services. <a href="#_details">More...</a>
+<h1>apr_user.h File Reference</h1>APR User ID Services.
+<a href="#_details">More...</a>
<p>
<code>#include "apr.h"</code><br>
<code>#include "<a class="el" href="apr__errno_8h-source.html">apr_errno.h</a>"</code><br>
@@ -23,8 +24,8 @@
<hr><a name="_details"></a><h2>Detailed Description</h2>
APR User ID Services.
<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__version_8h-source.html
URL: http://svn.apache.org/viewcvs/apr/site/trunk/docs/docs/apr/apr__version_8h-source.html?view=diff&r1=151767&r2=151768
==============================================================================
--- apr/site/trunk/docs/docs/apr/apr__version_8h-source.html (original)
+++ apr/site/trunk/docs/docs/apr/apr__version_8h-source.html Mon Feb 7 15:10:17 2005
@@ -3,123 +3,124 @@
<title>Apache Portable Runtime: apr_version.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 Page</a> | <a class="qindex" href="modules.html">Modules</a> | <a class="qindex" href="annotated.html">Data Structures</a> | <a class="qindex" href="files.html">File List</a> | <a class="qindex" href="functions.html">Data Fields</a> | <a class="qindex" href="globals.html">Globals</a> | <a class="qindex" href="pages.html">Related Pages</a></div>
-<h1>apr_version.h</h1><a href="apr__version_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_VERSION_H</span>
-00017 <span class="preprocessor"></span><span class="preprocessor">#define APR_VERSION_H</span>
-00018 <span class="preprocessor"></span>
-00019 <span class="preprocessor">#include "apr.h"</span>
-00020
-00021 <span class="preprocessor">#ifdef __cplusplus</span>
-00022 <span class="preprocessor"></span><span class="keyword">extern</span> <span class="stringliteral">"C"</span> {
-00023 <span class="preprocessor">#endif</span>
-00024 <span class="preprocessor"></span><span class="comment"></span>
-00025 <span class="comment">/**</span>
-00026 <span class="comment"> * @file apr_version.h</span>
-00027 <span class="comment"> * @brief APR Versioning Interface</span>
-00028 <span class="comment"> * </span>
-00029 <span class="comment"> * APR's Version</span>
-00030 <span class="comment"> *</span>
-00031 <span class="comment"> * There are several different mechanisms for accessing the version. There</span>
-00032 <span class="comment"> * is a string form, and a set of numbers; in addition, there are constants</span>
-00033 <span class="comment"> * which can be compiled into your application, and you can query the library</span>
-00034 <span class="comment"> * being used for its actual version.</span>
-00035 <span class="comment"> *</span>
-00036 <span class="comment"> * Note that it is possible for an application to detect that it has been</span>
-00037 <span class="comment"> * compiled against a different version of APR by use of the compile-time</span>
-00038 <span class="comment"> * constants and the use of the run-time query function.</span>
-00039 <span class="comment"> *</span>
-00040 <span class="comment"> * APR version numbering follows the guidelines specified in:</span>
-00041 <span class="comment"> *</span>
-00042 <span class="comment"> * http://apr.apache.org/versioning.html</span>
-00043 <span class="comment"> */</span>
-00044
-00045 <span class="comment">/* The numeric compile-time version constants. These constants are the</span>
-00046 <span class="comment"> * authoritative version numbers for APR. </span>
-00047 <span class="comment"> */</span>
-00048 <span class="comment"></span>
-00049 <span class="comment">/** major version </span>
-00050 <span class="comment"> * Major API changes that could cause compatibility problems for older</span>
-00051 <span class="comment"> * programs such as structure size changes. No binary compatibility is</span>
-00052 <span class="comment"> * possible across a change in the major version.</span>
-00053 <span class="comment"> */</span>
-<a name="l00054"></a><a class="code" href="apr__version_8h.html#a0">00054</a> <span class="preprocessor">#define APR_MAJOR_VERSION 1</span>
-00055 <span class="preprocessor"></span><span class="comment"></span>
-00056 <span class="comment">/** </span>
-00057 <span class="comment"> * Minor API changes that do not cause binary compatibility problems.</span>
-00058 <span class="comment"> * Should be reset to 0 when upgrading APR_MAJOR_VERSION</span>
-00059 <span class="comment"> */</span>
-<a name="l00060"></a><a class="code" href="apr__version_8h.html#a1">00060</a> <span class="preprocessor">#define APR_MINOR_VERSION 0</span>
-00061 <span class="preprocessor"></span><span class="comment"></span>
-00062 <span class="comment">/** patch level */</span>
-<a name="l00063"></a><a class="code" href="apr__version_8h.html#a2">00063</a> <span class="preprocessor">#define APR_PATCH_VERSION 1</span>
-00064 <span class="preprocessor"></span><span class="comment"></span>
-00065 <span class="comment">/**</span>
-00066 <span class="comment"> * This symbol is defined for internal, "development" copies of APR.</span>
-00067 <span class="comment"> * This symbol should be #undef'd for releases.</span>
-00068 <span class="comment"> */</span>
-<a name="l00069"></a><a class="code" href="apr__version_8h.html#a3">00069</a> <span class="preprocessor">#define APR_IS_DEV_VERSION</span>
-00070 <span class="preprocessor"></span><span class="comment"></span>
-00071 <span class="comment">/** The formatted string of APR's version */</span>
-<a name="l00072"></a><a class="code" href="apr__version_8h.html#a4">00072</a> <span class="preprocessor">#define APR_VERSION_STRING \</span>
-00073 <span class="preprocessor"> APR_STRINGIFY(APR_MAJOR_VERSION) "." \</span>
-00074 <span class="preprocessor"> APR_STRINGIFY(APR_MINOR_VERSION) "." \</span>
-00075 <span class="preprocessor"> APR_STRINGIFY(APR_PATCH_VERSION) \</span>
-00076 <span class="preprocessor"> APR_IS_DEV_STRING</span>
-00077 <span class="preprocessor"></span>
-00078 <span class="comment"></span>
-00079 <span class="comment">/** </span>
-00080 <span class="comment"> * The numeric version information is broken out into fields within this </span>
-00081 <span class="comment"> * structure. </span>
-00082 <span class="comment"> */</span>
-<a name="l00083"></a><a class="code" href="structapr__version__t.html">00083</a> <span class="keyword">typedef</span> <span class="keyword">struct </span>{
-<a name="l00084"></a><a class="code" href="structapr__version__t.html#o0">00084</a> <span class="keywordtype">int</span> major; <span class="comment">/**< major number */</span>
-<a name="l00085"></a><a class="code" href="structapr__version__t.html#o1">00085</a> <span class="keywordtype">int</span> minor; <span class="comment">/**< minor number */</span>
-<a name="l00086"></a><a class="code" href="structapr__version__t.html#o2">00086</a> <span class="keywordtype">int</span> patch; <span class="comment">/**< patch number */</span>
-<a name="l00087"></a><a class="code" href="structapr__version__t.html#o3">00087</a> <span class="keywordtype">int</span> is_dev; <span class="comment">/**< is development (1 or 0) */</span>
-00088 } <a class="code" href="structapr__version__t.html">apr_version_t</a>;
-00089 <span class="comment"></span>
-00090 <span class="comment">/**</span>
-00091 <span class="comment"> * Return APR's version information information in a numeric form.</span>
-00092 <span class="comment"> *</span>
-00093 <span class="comment"> * @param pvsn Pointer to a version structure for returning the version</span>
-00094 <span class="comment"> * information.</span>
-00095 <span class="comment"> */</span>
-00096 APR_DECLARE(<span class="keywordtype">void</span>) apr_version(<a class="code" href="structapr__version__t.html">apr_version_t</a> *pvsn);
-00097 <span class="comment"></span>
-00098 <span class="comment">/** Return APR's version information as a string. */</span>
-00099 APR_DECLARE(const <span class="keywordtype">char</span> *) apr_version_string(<span class="keywordtype">void</span>);
-00100
-00101 <span class="comment"></span>
-00102 <span class="comment">/** Internal: string form of the "is dev" flag */</span>
-00103 #ifdef APR_IS_DEV_VERSION
-<a name="l00104"></a><a class="code" href="apr__version_8h.html#a5">00104</a> #define APR_IS_DEV_STRING "-dev"
-00105 #else
-00106 #define APR_IS_DEV_STRING ""
-00107 #endif
-00108
-00109 #ifdef __cplusplus
-00110 }
-00111 #endif
-00112
-00113 #endif <span class="comment">/* APR_VERSION_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_version.h</h1><a href="apr__version_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_VERSION_H</span>
+00018 <span class="preprocessor"></span><span class="preprocessor">#define APR_VERSION_H</span>
+00019 <span class="preprocessor"></span>
+00020 <span class="preprocessor">#include "apr.h"</span>
+00021
+00022 <span class="preprocessor">#ifdef __cplusplus</span>
+00023 <span class="preprocessor"></span><span class="keyword">extern</span> <span class="stringliteral">"C"</span> {
+00024 <span class="preprocessor">#endif</span>
+00025 <span class="preprocessor"></span><span class="comment"></span>
+00026 <span class="comment">/**</span>
+00027 <span class="comment"> * @file apr_version.h</span>
+00028 <span class="comment"> * @brief APR Versioning Interface</span>
+00029 <span class="comment"> * </span>
+00030 <span class="comment"> * APR's Version</span>
+00031 <span class="comment"> *</span>
+00032 <span class="comment"> * There are several different mechanisms for accessing the version. There</span>
+00033 <span class="comment"> * is a string form, and a set of numbers; in addition, there are constants</span>
+00034 <span class="comment"> * which can be compiled into your application, and you can query the library</span>
+00035 <span class="comment"> * being used for its actual version.</span>
+00036 <span class="comment"> *</span>
+00037 <span class="comment"> * Note that it is possible for an application to detect that it has been</span>
+00038 <span class="comment"> * compiled against a different version of APR by use of the compile-time</span>
+00039 <span class="comment"> * constants and the use of the run-time query function.</span>
+00040 <span class="comment"> *</span>
+00041 <span class="comment"> * APR version numbering follows the guidelines specified in:</span>
+00042 <span class="comment"> *</span>
+00043 <span class="comment"> * http://apr.apache.org/versioning.html</span>
+00044 <span class="comment"> */</span>
+00045
+00046 <span class="comment">/* The numeric compile-time version constants. These constants are the</span>
+00047 <span class="comment"> * authoritative version numbers for APR. </span>
+00048 <span class="comment"> */</span>
+00049 <span class="comment"></span>
+00050 <span class="comment">/** major version </span>
+00051 <span class="comment"> * Major API changes that could cause compatibility problems for older</span>
+00052 <span class="comment"> * programs such as structure size changes. No binary compatibility is</span>
+00053 <span class="comment"> * possible across a change in the major version.</span>
+00054 <span class="comment"> */</span>
+<a name="l00055"></a><a class="code" href="apr__version_8h.html#a0">00055</a> <span class="preprocessor">#define APR_MAJOR_VERSION 1</span>
+00056 <span class="preprocessor"></span><span class="comment"></span>
+00057 <span class="comment">/** </span>
+00058 <span class="comment"> * Minor API changes that do not cause binary compatibility problems.</span>
+00059 <span class="comment"> * Should be reset to 0 when upgrading APR_MAJOR_VERSION</span>
+00060 <span class="comment"> */</span>
+<a name="l00061"></a><a class="code" href="apr__version_8h.html#a1">00061</a> <span class="preprocessor">#define APR_MINOR_VERSION 2</span>
+00062 <span class="preprocessor"></span><span class="comment"></span>
+00063 <span class="comment">/** patch level */</span>
+<a name="l00064"></a><a class="code" href="apr__version_8h.html#a2">00064</a> <span class="preprocessor">#define APR_PATCH_VERSION 0</span>
+00065 <span class="preprocessor"></span><span class="comment"></span>
+00066 <span class="comment">/**</span>
+00067 <span class="comment"> * This symbol is defined for internal, "development" copies of APR.</span>
+00068 <span class="comment"> * This symbol should be #undef'd for releases.</span>
+00069 <span class="comment"> */</span>
+<a name="l00070"></a><a class="code" href="apr__version_8h.html#a3">00070</a> <span class="preprocessor">#define APR_IS_DEV_VERSION</span>
+00071 <span class="preprocessor"></span><span class="comment"></span>
+00072 <span class="comment">/** The formatted string of APR's version */</span>
+<a name="l00073"></a><a class="code" href="apr__version_8h.html#a4">00073</a> <span class="preprocessor">#define APR_VERSION_STRING \</span>
+00074 <span class="preprocessor"> APR_STRINGIFY(APR_MAJOR_VERSION) "." \</span>
+00075 <span class="preprocessor"> APR_STRINGIFY(APR_MINOR_VERSION) "." \</span>
+00076 <span class="preprocessor"> APR_STRINGIFY(APR_PATCH_VERSION) \</span>
+00077 <span class="preprocessor"> APR_IS_DEV_STRING</span>
+00078 <span class="preprocessor"></span>
+00079 <span class="comment"></span>
+00080 <span class="comment">/** </span>
+00081 <span class="comment"> * The numeric version information is broken out into fields within this </span>
+00082 <span class="comment"> * structure. </span>
+00083 <span class="comment"> */</span>
+<a name="l00084"></a><a class="code" href="structapr__version__t.html">00084</a> <span class="keyword">typedef</span> <span class="keyword">struct </span>{
+<a name="l00085"></a><a class="code" href="structapr__version__t.html#o0">00085</a> <span class="keywordtype">int</span> major; <span class="comment">/**< major number */</span>
+<a name="l00086"></a><a class="code" href="structapr__version__t.html#o1">00086</a> <span class="keywordtype">int</span> minor; <span class="comment">/**< minor number */</span>
+<a name="l00087"></a><a class="code" href="structapr__version__t.html#o2">00087</a> <span class="keywordtype">int</span> patch; <span class="comment">/**< patch number */</span>
+<a name="l00088"></a><a class="code" href="structapr__version__t.html#o3">00088</a> <span class="keywordtype">int</span> is_dev; <span class="comment">/**< is development (1 or 0) */</span>
+00089 } <a class="code" href="structapr__version__t.html">apr_version_t</a>;
+00090 <span class="comment"></span>
+00091 <span class="comment">/**</span>
+00092 <span class="comment"> * Return APR's version information information in a numeric form.</span>
+00093 <span class="comment"> *</span>
+00094 <span class="comment"> * @param pvsn Pointer to a version structure for returning the version</span>
+00095 <span class="comment"> * information.</span>
+00096 <span class="comment"> */</span>
+00097 APR_DECLARE(<span class="keywordtype">void</span>) apr_version(<a class="code" href="structapr__version__t.html">apr_version_t</a> *pvsn);
+00098 <span class="comment"></span>
+00099 <span class="comment">/** Return APR's version information as a string. */</span>
+00100 APR_DECLARE(const <span class="keywordtype">char</span> *) apr_version_string(<span class="keywordtype">void</span>);
+00101
+00102 <span class="comment"></span>
+00103 <span class="comment">/** Internal: string form of the "is dev" flag */</span>
+00104 #ifdef APR_IS_DEV_VERSION
+<a name="l00105"></a><a class="code" href="apr__version_8h.html#a5">00105</a> #define APR_IS_DEV_STRING "-dev"
+00106 #else
+00107 #define APR_IS_DEV_STRING ""
+00108 #endif
+00109
+00110 #ifdef __cplusplus
+00111 }
+00112 #endif
+00113
+00114 #endif <span class="comment">/* APR_VERSION_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>