passenger 2.0.6 → 2.1.2

data/doc/cxxapi/Bucket_8h-source.html

@@ -10,7 +10,6 @@
     <ul>
       <li><a href="main.html"><span>Main&nbsp;Page</span></a></li>
       <li><a href="modules.html"><span>Modules</span></a></li>
-      <li><a href="namespaces.html"><span>Namespaces</span></a></li>
       <li><a href="annotated.html"><span>Classes</span></a></li>
       <li class="current"><a href="files.html"><span>Files</span></a></li>
     </ul>
@@ -38,23 +37,30 @@
 <a name="l00021"></a>00021 <span class="preprocessor"></span><span class="preprocessor">#define _PASSENGER_BUCKET_H_</span>
 <a name="l00022"></a>00022 <span class="preprocessor"></span><span class="comment"></span>
 <a name="l00023"></a>00023 <span class="comment">/**</span>
-<a name="l00024"></a>00024 <span class="comment"> * apr_bucket_pipe closes a pipe's file descriptor when it has reached end-of-stream,</span>
-<a name="l00025"></a>00025 <span class="comment"> * but not when an error has occurred. That behavior conflicts with Phusion Passenger's</span>
-<a name="l00026"></a>00026 <span class="comment"> * file descriptor management code.</span>
+<a name="l00024"></a>00024 <span class="comment"> * apr_bucket_pipe closes a pipe's file descriptor when it has reached</span>
+<a name="l00025"></a>00025 <span class="comment"> * end-of-stream, but not when an error has occurred. This behavior is</span>
+<a name="l00026"></a>00026 <span class="comment"> * undesirable because it can easily cause file descriptor leaks.</span>
 <a name="l00027"></a>00027 <span class="comment"> *</span>
-<a name="l00028"></a>00028 <span class="comment"> * passenger_bucket is like apr_bucket_pipe, but never closes the pipe's file descriptor.</span>
-<a name="l00029"></a>00029 <span class="comment"> * It also ignores the APR_NONBLOCK_READ because that's known to cause strange</span>
-<a name="l00030"></a>00030 <span class="comment"> * I/O problems.</span>
-<a name="l00031"></a>00031 <span class="comment"> */</span>
-<a name="l00032"></a>00032 
-<a name="l00033"></a>00033 <span class="preprocessor">#include "apr_buckets.h"</span>
-<a name="l00034"></a>00034 
-<a name="l00035"></a>00035 apr_bucket *passenger_bucket_create(apr_file_t *pipe, apr_bucket_alloc_t *list);
+<a name="l00028"></a>00028 <span class="comment"> * passenger_bucket is like apr_bucket_pipe, but it also holds a reference to</span>
+<a name="l00029"></a>00029 <span class="comment"> * a Session. When a read error has occured or when end-of-stream has been</span>
+<a name="l00030"></a>00030 <span class="comment"> * reached, the Session will be dereferenced, so that the underlying file</span>
+<a name="l00031"></a>00031 <span class="comment"> * descriptor is closed.</span>
+<a name="l00032"></a>00032 <span class="comment"> *</span>
+<a name="l00033"></a>00033 <span class="comment"> * passenger_bucket also ignores the APR_NONBLOCK_READ flag because that's</span>
+<a name="l00034"></a>00034 <span class="comment"> * known to cause strange I/O problems.</span>
+<a name="l00035"></a>00035 <span class="comment"> */</span>
 <a name="l00036"></a>00036 
-<a name="l00037"></a>00037 <span class="preprocessor">#endif </span><span class="comment">/* _PASSENGER_BUCKET_H_ */</span>
-<a name="l00038"></a>00038 
+<a name="l00037"></a>00037 <span class="preprocessor">#include &lt;apr_buckets.h&gt;</span>
+<a name="l00038"></a>00038 <span class="preprocessor">#include "Application.h"</span>
+<a name="l00039"></a>00039 
+<a name="l00040"></a>00040 apr_bucket *passenger_bucket_create(<a class="code" href="classPassenger_1_1Application.html#d14f673494991460b16246a527ad8ad9" title="Convenient alias for Session smart pointer.">Passenger::Application::SessionPtr</a> session,
+<a name="l00041"></a>00041                                     apr_file_t *pipe,
+<a name="l00042"></a>00042                                     apr_bucket_alloc_t *list);
+<a name="l00043"></a>00043 
+<a name="l00044"></a>00044 <span class="preprocessor">#endif </span><span class="comment">/* _PASSENGER_BUCKET_H_ */</span>
+<a name="l00045"></a>00045 
 </pre></div></div>
-<hr size="1"><address style="text-align: right;"><small>Generated on Mon Dec 15 15:27:24 2008 for Passenger by&nbsp;
+<hr size="1"><address style="text-align: right;"><small>Generated on Fri Mar 13 19:24:32 2009 for Passenger by&nbsp;
 <a href="http://www.doxygen.org/index.html">
 <img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.5 </small></address>
 </body>

data/doc/cxxapi/CachedFileStat_8h-source.html

@@ -0,0 +1,191 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html><head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
+<title>Passenger: CachedFileStat.h Source File</title>
+<link href="doxygen.css" rel="stylesheet" type="text/css">
+<link href="tabs.css" rel="stylesheet" type="text/css">
+</head><body>
+<!-- Generated by Doxygen 1.5.5 -->
+<div class="navigation" id="top">
+  <div class="tabs">
+    <ul>
+      <li><a href="main.html"><span>Main&nbsp;Page</span></a></li>
+      <li><a href="modules.html"><span>Modules</span></a></li>
+      <li><a href="annotated.html"><span>Classes</span></a></li>
+      <li class="current"><a href="files.html"><span>Files</span></a></li>
+    </ul>
+  </div>
+<h1>CachedFileStat.h</h1><div class="fragment"><pre class="fragment"><a name="l00001"></a>00001 <span class="comment">/*</span>
+<a name="l00002"></a>00002 <span class="comment"> *  Phusion Passenger - http://www.modrails.com/</span>
+<a name="l00003"></a>00003 <span class="comment"> *  Copyright (C) 2009  Phusion</span>
+<a name="l00004"></a>00004 <span class="comment"> *</span>
+<a name="l00005"></a>00005 <span class="comment"> *  Phusion Passenger is a trademark of Hongli Lai &amp; Ninh Bui.</span>
+<a name="l00006"></a>00006 <span class="comment"> *</span>
+<a name="l00007"></a>00007 <span class="comment"> *  This program is free software; you can redistribute it and/or modify</span>
+<a name="l00008"></a>00008 <span class="comment"> *  it under the terms of the GNU General Public License as published by</span>
+<a name="l00009"></a>00009 <span class="comment"> *  the Free Software Foundation; version 2 of the License.</span>
+<a name="l00010"></a>00010 <span class="comment"> *</span>
+<a name="l00011"></a>00011 <span class="comment"> *  This program is distributed in the hope that it will be useful,</span>
+<a name="l00012"></a>00012 <span class="comment"> *  but WITHOUT ANY WARRANTY; without even the implied warranty of</span>
+<a name="l00013"></a>00013 <span class="comment"> *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the</span>
+<a name="l00014"></a>00014 <span class="comment"> *  GNU General Public License for more details.</span>
+<a name="l00015"></a>00015 <span class="comment"> *</span>
+<a name="l00016"></a>00016 <span class="comment"> *  You should have received a copy of the GNU General Public License along</span>
+<a name="l00017"></a>00017 <span class="comment"> *  with this program; if not, write to the Free Software Foundation, Inc.,</span>
+<a name="l00018"></a>00018 <span class="comment"> *  51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.</span>
+<a name="l00019"></a>00019 <span class="comment"> */</span>
+<a name="l00020"></a>00020 <span class="preprocessor">#ifndef _PASSENGER_CACHED_FILE_STAT_H_</span>
+<a name="l00021"></a>00021 <span class="preprocessor"></span><span class="preprocessor">#define _PASSENGER_CACHED_FILE_STAT_H_</span>
+<a name="l00022"></a>00022 <span class="preprocessor"></span>
+<a name="l00023"></a>00023 <span class="preprocessor">#include &lt;sys/types.h&gt;</span>
+<a name="l00024"></a>00024 <span class="preprocessor">#include &lt;sys/stat.h&gt;</span>
+<a name="l00025"></a>00025 <span class="preprocessor">#include &lt;unistd.h&gt;</span>
+<a name="l00026"></a>00026 <span class="preprocessor">#include &lt;time.h&gt;</span>
+<a name="l00027"></a>00027 
+<a name="l00028"></a>00028 <span class="preprocessor">#ifdef __cplusplus</span>
+<a name="l00029"></a>00029 <span class="preprocessor"></span>
+<a name="l00030"></a>00030 <span class="preprocessor">#include &lt;errno.h&gt;</span>
+<a name="l00031"></a>00031 <span class="preprocessor">#include &lt;string&gt;</span>
+<a name="l00032"></a>00032 <span class="preprocessor">#include &lt;oxt/system_calls.hpp&gt;</span>
+<a name="l00033"></a>00033 
+<a name="l00034"></a>00034 <span class="preprocessor">#include "SystemTime.h"</span>
+<a name="l00035"></a>00035 
+<a name="l00036"></a>00036 <span class="keyword">namespace </span>Passenger {
+<a name="l00037"></a>00037 
+<a name="l00038"></a>00038 <span class="keyword">using namespace </span>std;
+<a name="l00039"></a>00039 <span class="keyword">using namespace </span>oxt;
+<a name="l00040"></a>00040 <span class="comment"></span>
+<a name="l00041"></a>00041 <span class="comment">/**</span>
+<a name="l00042"></a>00042 <span class="comment"> * CachedFileStat allows one to stat() a file at a throttled rate, in order</span>
+<a name="l00043"></a>00043 <span class="comment"> * to minimize stress on the filesystem. It does this by caching the old stat</span>
+<a name="l00044"></a>00044 <span class="comment"> * data for a specified amount of time.</span>
+<a name="l00045"></a>00045 <span class="comment"> */</span>
+<a name="l00046"></a>00046 <span class="keyword">class </span>CachedFileStat {
+<a name="l00047"></a>00047 <span class="keyword">private</span>:<span class="comment"></span>
+<a name="l00048"></a>00048 <span class="comment">        /** The last return value of stat(). */</span>
+<a name="l00049"></a>00049         <span class="keywordtype">int</span> last_result;
+<a name="l00050"></a>00050 <span class="comment"></span>
+<a name="l00051"></a>00051 <span class="comment">        /** The errno set by the last stat() call. */</span>
+<a name="l00052"></a>00052         <span class="keywordtype">int</span> last_errno;
+<a name="l00053"></a>00053 <span class="comment"></span>
+<a name="l00054"></a>00054 <span class="comment">        /** The filename of the file to stat. */</span>
+<a name="l00055"></a>00055         <span class="keywordtype">string</span> filename;
+<a name="l00056"></a>00056 <span class="comment"></span>
+<a name="l00057"></a>00057 <span class="comment">        /** The last time a stat() was performed. */</span>
+<a name="l00058"></a>00058         time_t last_time;
+<a name="l00059"></a>00059         <span class="comment"></span>
+<a name="l00060"></a>00060 <span class="comment">        /**</span>
+<a name="l00061"></a>00061 <span class="comment">         * Checks whether &lt;em&gt;interval&lt;/em&gt; seconds have elapsed since &lt;em&gt;begin&lt;/em&gt;</span>
+<a name="l00062"></a>00062 <span class="comment">         * The current time is returned via the &lt;tt&gt;currentTime&lt;/tt&gt; argument,</span>
+<a name="l00063"></a>00063 <span class="comment">         * so that the caller doesn't have to call time() again if it needs the current</span>
+<a name="l00064"></a>00064 <span class="comment">         * time.</span>
+<a name="l00065"></a>00065 <span class="comment">         *</span>
+<a name="l00066"></a>00066 <span class="comment">         * @pre begin &lt;= time(NULL)</span>
+<a name="l00067"></a>00067 <span class="comment">         * @return Whether &lt;tt&gt;interval&lt;/tt&gt; seconds have elapsed since &lt;tt&gt;begin&lt;/tt&gt;.</span>
+<a name="l00068"></a>00068 <span class="comment">         * @throws SystemException Something went wrong while retrieving the time.</span>
+<a name="l00069"></a>00069 <span class="comment">         * @throws boost::thread_interrupted</span>
+<a name="l00070"></a>00070 <span class="comment">         */</span>
+<a name="l00071"></a>00071         <span class="keywordtype">bool</span> expired(time_t begin, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> interval, time_t &amp;currentTime) {
+<a name="l00072"></a>00072                 currentTime = <a class="code" href="classPassenger_1_1SystemTime.html#d643b3e5748ee929e013517e6aca046c" title="Returns the time since the Epoch, measured in seconds.">SystemTime::get</a>();
+<a name="l00073"></a>00073                 <span class="keywordflow">return</span> (<span class="keywordtype">unsigned</span> <span class="keywordtype">int</span>) (currentTime - begin) &gt;= interval;
+<a name="l00074"></a>00074         }
+<a name="l00075"></a>00075 
+<a name="l00076"></a>00076 <span class="keyword">public</span>:<span class="comment"></span>
+<a name="l00077"></a>00077 <span class="comment">        /** The cached stat info. */</span>
+<a name="l00078"></a>00078         <span class="keyword">struct </span>stat info;
+<a name="l00079"></a>00079         <span class="comment"></span>
+<a name="l00080"></a>00080 <span class="comment">        /**</span>
+<a name="l00081"></a>00081 <span class="comment">         * Creates a new CachedFileStat object. The file will not be</span>
+<a name="l00082"></a>00082 <span class="comment">         * stat()ted until you call refresh().</span>
+<a name="l00083"></a>00083 <span class="comment">         *</span>
+<a name="l00084"></a>00084 <span class="comment">         * @param filename The file to stat.</span>
+<a name="l00085"></a>00085 <span class="comment">         */</span>
+<a name="l00086"></a>00086         CachedFileStat(<span class="keyword">const</span> <span class="keywordtype">string</span> &amp;filename) {
+<a name="l00087"></a>00087                 memset(&amp;info, 0, <span class="keyword">sizeof</span>(<span class="keyword">struct</span> stat));
+<a name="l00088"></a>00088                 last_result = -1;
+<a name="l00089"></a>00089                 last_errno = 0;
+<a name="l00090"></a>00090                 this-&gt;filename = filename;
+<a name="l00091"></a>00091                 last_time = 0;
+<a name="l00092"></a>00092         }
+<a name="l00093"></a>00093         <span class="comment"></span>
+<a name="l00094"></a>00094 <span class="comment">        /**</span>
+<a name="l00095"></a>00095 <span class="comment">         * Re-stat() the file, if necessary. If &lt;tt&gt;throttleRate&lt;/tt&gt; seconds have</span>
+<a name="l00096"></a>00096 <span class="comment">         * passed since the last time stat() was called, then the file will be</span>
+<a name="l00097"></a>00097 <span class="comment">         * re-stat()ted.</span>
+<a name="l00098"></a>00098 <span class="comment">         *</span>
+<a name="l00099"></a>00099 <span class="comment">         * The stat information, which may either be the result of a new stat() call</span>
+<a name="l00100"></a>00100 <span class="comment">         * or just the old cached information, is be available in the &lt;tt&gt;info&lt;/tt&gt;</span>
+<a name="l00101"></a>00101 <span class="comment">         * member.</span>
+<a name="l00102"></a>00102 <span class="comment">         *</span>
+<a name="l00103"></a>00103 <span class="comment">         * @return 0 if the stat() call succeeded or if no stat() was performed,</span>
+<a name="l00104"></a>00104 <span class="comment">         *         -1 if something went wrong while statting the file. In the latter</span>
+<a name="l00105"></a>00105 <span class="comment">         *         case, &lt;tt&gt;errno&lt;/tt&gt; will be populated with an appropriate error code.</span>
+<a name="l00106"></a>00106 <span class="comment">         * @throws SystemException Something went wrong while retrieving the system time.</span>
+<a name="l00107"></a>00107 <span class="comment">         * @throws boost::thread_interrupted</span>
+<a name="l00108"></a>00108 <span class="comment">         */</span>
+<a name="l00109"></a>00109         <span class="keywordtype">int</span> refresh(<span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> throttleRate) {
+<a name="l00110"></a>00110                 time_t currentTime;
+<a name="l00111"></a>00111                 <span class="keywordtype">int</span> ret;
+<a name="l00112"></a>00112                 
+<a name="l00113"></a>00113                 <span class="keywordflow">if</span> (expired(last_time, throttleRate, currentTime)) {
+<a name="l00114"></a>00114                         ret = stat(filename.c_str(), &amp;info);
+<a name="l00115"></a>00115                         <span class="keywordflow">if</span> (ret == -1 &amp;&amp; errno == EINTR) {
+<a name="l00116"></a>00116                                 <span class="comment">/* If the stat() call was interrupted, then don't</span>
+<a name="l00117"></a>00117 <span class="comment">                                 * update any state so that the caller can call</span>
+<a name="l00118"></a>00118 <span class="comment">                                 * this function again without us returning a</span>
+<a name="l00119"></a>00119 <span class="comment">                                 * cached EINTR error.</span>
+<a name="l00120"></a>00120 <span class="comment">                                 */</span>
+<a name="l00121"></a>00121                                 <span class="keywordflow">return</span> -1;
+<a name="l00122"></a>00122                         } <span class="keywordflow">else</span> {
+<a name="l00123"></a>00123                                 last_result = ret;
+<a name="l00124"></a>00124                                 last_errno = errno;
+<a name="l00125"></a>00125                                 last_time = currentTime;
+<a name="l00126"></a>00126                                 <span class="keywordflow">return</span> ret;
+<a name="l00127"></a>00127                         }
+<a name="l00128"></a>00128                 } <span class="keywordflow">else</span> {
+<a name="l00129"></a>00129                         errno = last_errno;
+<a name="l00130"></a>00130                         <span class="keywordflow">return</span> last_result;
+<a name="l00131"></a>00131                 }
+<a name="l00132"></a>00132         }
+<a name="l00133"></a>00133 };
+<a name="l00134"></a>00134 
+<a name="l00135"></a>00135 } <span class="comment">// namespace Passenger</span>
+<a name="l00136"></a>00136 
+<a name="l00137"></a>00137 <span class="preprocessor">#endif </span><span class="comment">/* __cplusplus */</span>
+<a name="l00138"></a>00138 
+<a name="l00139"></a>00139 
+<a name="l00140"></a>00140 <span class="preprocessor">#ifdef __cplusplus</span>
+<a name="l00141"></a>00141 <span class="preprocessor"></span>        <span class="keyword">extern</span> <span class="stringliteral">"C"</span> {
+<a name="l00142"></a>00142 <span class="preprocessor">#endif</span>
+<a name="l00143"></a>00143 <span class="preprocessor"></span><span class="comment"></span>
+<a name="l00144"></a>00144 <span class="comment">/**</span>
+<a name="l00145"></a>00145 <span class="comment"> * CachedMultiFileStat allows one to stat() files at a throttled rate, in order</span>
+<a name="l00146"></a>00146 <span class="comment"> * to minimize stress on the filesystem. It does this by caching the old stat</span>
+<a name="l00147"></a>00147 <span class="comment"> * data for a specified amount of time.</span>
+<a name="l00148"></a>00148 <span class="comment"> *</span>
+<a name="l00149"></a>00149 <span class="comment"> * Unlike CachedFileStat, which can only stat() one specific file per</span>
+<a name="l00150"></a>00150 <span class="comment"> * CachedFileStat object, CachedMultiFileStat can stat() any file. The</span>
+<a name="l00151"></a>00151 <span class="comment"> * number of cached stat() information is limited by the given cache size.</span>
+<a name="l00152"></a>00152 <span class="comment"> *</span>
+<a name="l00153"></a>00153 <span class="comment"> * This class is fully thread-safe.</span>
+<a name="l00154"></a>00154 <span class="comment"> */</span>
+<a name="l00155"></a>00155 <span class="keyword">typedef</span> <span class="keyword">struct </span>CachedMultiFileStat CachedMultiFileStat;
+<a name="l00156"></a>00156 
+<a name="l00157"></a>00157 CachedMultiFileStat *cached_multi_file_stat_new(<span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> max_size);
+<a name="l00158"></a>00158 <span class="keywordtype">void</span> cached_multi_file_stat_free(CachedMultiFileStat *mstat);
+<a name="l00159"></a>00159 <span class="keywordtype">int</span>  cached_multi_file_stat_perform(CachedMultiFileStat *mstat,
+<a name="l00160"></a>00160                                     <span class="keyword">const</span> <span class="keywordtype">char</span> *filename,
+<a name="l00161"></a>00161                                     <span class="keyword">struct</span> stat *buf,
+<a name="l00162"></a>00162                                     <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> throttle_rate);
+<a name="l00163"></a>00163 
+<a name="l00164"></a>00164 <span class="preprocessor">#ifdef __cplusplus</span>
+<a name="l00165"></a>00165 <span class="preprocessor"></span>        }
+<a name="l00166"></a>00166 <span class="preprocessor">#endif</span>
+<a name="l00167"></a>00167 <span class="preprocessor"></span>
+<a name="l00168"></a>00168 <span class="preprocessor">#endif </span><span class="comment">/* _PASSENGER_CACHED_FILE_STAT_H_ */</span>
+<a name="l00169"></a>00169 
+</pre></div></div>
+<hr size="1"><address style="text-align: right;"><small>Generated on Fri Mar 13 19:24:32 2009 for Passenger by&nbsp;
+<a href="http://www.doxygen.org/index.html">
+<img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.5 </small></address>
+</body>
+</html>

data/doc/cxxapi/Configuration_8h-source.html

@@ -10,7 +10,6 @@
     <ul>
       <li><a href="main.html"><span>Main&nbsp;Page</span></a></li>
       <li><a href="modules.html"><span>Modules</span></a></li>
-      <li><a href="namespaces.html"><span>Namespaces</span></a></li>
       <li><a href="annotated.html"><span>Classes</span></a></li>
       <li class="current"><a href="files.html"><span>Files</span></a></li>
     </ul>
@@ -37,158 +36,321 @@
 <a name="l00020"></a>00020 <span class="preprocessor">#ifndef _PASSENGER_CONFIGURATION_H_</span>
 <a name="l00021"></a>00021 <span class="preprocessor"></span><span class="preprocessor">#define _PASSENGER_CONFIGURATION_H_</span>
 <a name="l00022"></a>00022 <span class="preprocessor"></span>
-<a name="l00023"></a>00023 <span class="preprocessor">#include &lt;apr_pools.h&gt;</span>
-<a name="l00024"></a>00024 <span class="preprocessor">#include &lt;httpd.h&gt;</span>
-<a name="l00025"></a>00025 <span class="preprocessor">#include &lt;http_config.h&gt;</span>
-<a name="l00026"></a>00026 <span class="comment"></span>
-<a name="l00027"></a>00027 <span class="comment">/**</span>
-<a name="l00028"></a>00028 <span class="comment"> * @defgroup Configuration Apache module configuration</span>
-<a name="l00029"></a>00029 <span class="comment"> * @ingroup Core</span>
-<a name="l00030"></a>00030 <span class="comment"> * @{</span>
-<a name="l00031"></a>00031 <span class="comment"> */</span>
-<a name="l00032"></a>00032 <span class="comment"></span>
-<a name="l00033"></a>00033 <span class="comment">/** Module version number. */</span>
-<a name="l00034"></a><a class="code" href="group__Configuration.html#ga19398896775408d6ab7fd8ce2acd992">00034</a> <span class="preprocessor">#define PASSENGER_VERSION "2.0.6"</span>
-<a name="l00035"></a>00035 <span class="preprocessor"></span>
-<a name="l00036"></a>00036 <span class="preprocessor">#ifdef __cplusplus</span>
-<a name="l00037"></a>00037 <span class="preprocessor"></span><span class="preprocessor">        #include &lt;set&gt;</span>
-<a name="l00038"></a>00038 <span class="preprocessor">        #include &lt;string&gt;</span>
-<a name="l00039"></a>00039 
-<a name="l00040"></a>00040         <span class="keyword">namespace </span>Passenger {
-<a name="l00041"></a>00041         
-<a name="l00042"></a>00042                 <span class="keyword">using namespace </span>std;
-<a name="l00043"></a>00043                 <span class="comment"></span>
-<a name="l00044"></a>00044 <span class="comment">                /**</span>
-<a name="l00045"></a>00045 <span class="comment">                 * Per-directory configuration information.</span>
-<a name="l00046"></a>00046 <span class="comment">                 */</span>
-<a name="l00047"></a>00047                 <span class="keyword">struct </span>DirConfig {
-<a name="l00048"></a>00048                         <span class="keyword">enum</span> Threeway { ENABLED, DISABLED, UNSET };
-<a name="l00049"></a>00049                         
-<a name="l00050"></a>00050                         std::set&lt;std::string&gt; railsBaseURIs;
-<a name="l00051"></a>00051                         std::set&lt;std::string&gt; rackBaseURIs;
-<a name="l00052"></a>00052                         <span class="comment"></span>
-<a name="l00053"></a>00053 <span class="comment">                        /** Whether to autodetect Rails applications. */</span>
-<a name="l00054"></a>00054                         Threeway autoDetectRails;
-<a name="l00055"></a>00055                         <span class="comment"></span>
-<a name="l00056"></a>00056 <span class="comment">                        /** Whether to autodetect Rack applications. */</span>
-<a name="l00057"></a>00057                         Threeway autoDetectRack;
-<a name="l00058"></a>00058                         <span class="comment"></span>
-<a name="l00059"></a>00059 <span class="comment">                        /** Whether to autodetect WSGI applications. */</span>
-<a name="l00060"></a>00060                         Threeway autoDetectWSGI;
-<a name="l00061"></a>00061                         <span class="comment"></span>
-<a name="l00062"></a>00062 <span class="comment">                        /** Whether mod_rewrite should be allowed for Rails applications. */</span>
-<a name="l00063"></a>00063                         Threeway allowModRewrite;
-<a name="l00064"></a>00064                         <span class="comment"></span>
-<a name="l00065"></a>00065 <span class="comment">                        /** The environment (i.e. value for RAILS_ENV) under which</span>
-<a name="l00066"></a>00066 <span class="comment">                         * Rails applications should operate. */</span>
-<a name="l00067"></a>00067                         <span class="keyword">const</span> <span class="keywordtype">char</span> *railsEnv;
+<a name="l00023"></a>00023 <span class="preprocessor">#include "Utils.h"</span>
+<a name="l00024"></a>00024 <span class="preprocessor">#include "MessageChannel.h"</span>
+<a name="l00025"></a>00025 
+<a name="l00026"></a>00026 <span class="comment">/* The APR headers must come after the Passenger headers. See Hooks.cpp</span>
+<a name="l00027"></a>00027 <span class="comment"> * to learn why.</span>
+<a name="l00028"></a>00028 <span class="comment"> *</span>
+<a name="l00029"></a>00029 <span class="comment"> * MessageChannel.h must be included -- even though we don't actually use</span>
+<a name="l00030"></a>00030 <span class="comment"> * MessageChannel.h in here, it's necessary to make sure that apr_want.h</span>
+<a name="l00031"></a>00031 <span class="comment"> * doesn't b0rk on 'struct iovec'.</span>
+<a name="l00032"></a>00032 <span class="comment"> */</span>
+<a name="l00033"></a>00033 <span class="preprocessor">#include &lt;apr_pools.h&gt;</span>
+<a name="l00034"></a>00034 <span class="preprocessor">#include &lt;httpd.h&gt;</span>
+<a name="l00035"></a>00035 <span class="preprocessor">#include &lt;http_config.h&gt;</span>
+<a name="l00036"></a>00036 <span class="comment"></span>
+<a name="l00037"></a>00037 <span class="comment">/**</span>
+<a name="l00038"></a>00038 <span class="comment"> * @defgroup Configuration Apache module configuration</span>
+<a name="l00039"></a>00039 <span class="comment"> * @ingroup Core</span>
+<a name="l00040"></a>00040 <span class="comment"> * @{</span>
+<a name="l00041"></a>00041 <span class="comment"> */</span>
+<a name="l00042"></a>00042 <span class="comment"></span>
+<a name="l00043"></a>00043 <span class="comment">/** Module version number. */</span>
+<a name="l00044"></a><a class="code" href="group__Configuration.html#ga19398896775408d6ab7fd8ce2acd992">00044</a> <span class="preprocessor">#define PASSENGER_VERSION "2.1.2"</span>
+<a name="l00045"></a>00045 <span class="preprocessor"></span>
+<a name="l00046"></a>00046 <span class="preprocessor">#ifdef __cplusplus</span>
+<a name="l00047"></a>00047 <span class="preprocessor"></span><span class="preprocessor">        #include &lt;set&gt;</span>
+<a name="l00048"></a>00048 <span class="preprocessor">        #include &lt;string&gt;</span>
+<a name="l00049"></a>00049 
+<a name="l00050"></a>00050         <span class="keyword">namespace </span>Passenger {
+<a name="l00051"></a>00051         
+<a name="l00052"></a>00052                 <span class="keyword">using namespace </span>std;
+<a name="l00053"></a>00053                 <span class="comment"></span>
+<a name="l00054"></a>00054 <span class="comment">                /**</span>
+<a name="l00055"></a>00055 <span class="comment">                 * Per-directory configuration information.</span>
+<a name="l00056"></a>00056 <span class="comment">                 *</span>
+<a name="l00057"></a>00057 <span class="comment">                 * Use the getter methods to query information, because those will return</span>
+<a name="l00058"></a>00058 <span class="comment">                 * the default value if the value is not specified.</span>
+<a name="l00059"></a>00059 <span class="comment">                 */</span>
+<a name="l00060"></a>00060                 <span class="keyword">struct </span>DirConfig {
+<a name="l00061"></a>00061                         <span class="keyword">enum</span> Threeway { ENABLED, DISABLED, UNSET };
+<a name="l00062"></a>00062                         <span class="keyword">enum</span> SpawnMethod { SM_UNSET, SM_SMART, SM_SMART_LV2, SM_CONSERVATIVE };
+<a name="l00063"></a>00063                         
+<a name="l00064"></a>00064                         Threeway enabled;
+<a name="l00065"></a>00065                         
+<a name="l00066"></a>00066                         std::set&lt;std::string&gt; railsBaseURIs;
+<a name="l00067"></a>00067                         std::set&lt;std::string&gt; rackBaseURIs;
 <a name="l00068"></a>00068                         <span class="comment"></span>
-<a name="l00069"></a>00069 <span class="comment">                        /** The environment (i.e. value for RACK_ENV) under which</span>
-<a name="l00070"></a>00070 <span class="comment">                         * Rack applications should operate. */</span>
-<a name="l00071"></a>00071                         <span class="keyword">const</span> <span class="keywordtype">char</span> *rackEnv;
-<a name="l00072"></a>00072                         
-<a name="l00073"></a>00073                         <span class="keyword">enum</span> SpawnMethod { SM_UNSET, SM_SMART, SM_CONSERVATIVE };<span class="comment"></span>
-<a name="l00074"></a>00074 <span class="comment">                        /** The Rails spawn method to use. */</span>
-<a name="l00075"></a>00075                         SpawnMethod spawnMethod;
-<a name="l00076"></a>00076                 };
-<a name="l00077"></a>00077                 <span class="comment"></span>
-<a name="l00078"></a>00078 <span class="comment">                /**</span>
-<a name="l00079"></a>00079 <span class="comment">                 * Server-wide (global, not per-virtual host) configuration information.</span>
-<a name="l00080"></a>00080 <span class="comment">                 */</span>
-<a name="l00081"></a>00081                 <span class="keyword">struct </span>ServerConfig {<span class="comment"></span>
-<a name="l00082"></a>00082 <span class="comment">                        /** The filename of the Ruby interpreter to use. */</span>
-<a name="l00083"></a>00083                         <span class="keyword">const</span> <span class="keywordtype">char</span> *ruby;
+<a name="l00069"></a>00069 <span class="comment">                        /** Whether to autodetect Rails applications. */</span>
+<a name="l00070"></a>00070                         Threeway autoDetectRails;
+<a name="l00071"></a>00071                         <span class="comment"></span>
+<a name="l00072"></a>00072 <span class="comment">                        /** Whether to autodetect Rack applications. */</span>
+<a name="l00073"></a>00073                         Threeway autoDetectRack;
+<a name="l00074"></a>00074                         <span class="comment"></span>
+<a name="l00075"></a>00075 <span class="comment">                        /** Whether to autodetect WSGI applications. */</span>
+<a name="l00076"></a>00076                         Threeway autoDetectWSGI;
+<a name="l00077"></a>00077                         <span class="comment"></span>
+<a name="l00078"></a>00078 <span class="comment">                        /** Whether mod_rewrite should be allowed for Rails applications. */</span>
+<a name="l00079"></a>00079                         Threeway allowModRewrite;
+<a name="l00080"></a>00080                         <span class="comment"></span>
+<a name="l00081"></a>00081 <span class="comment">                        /** The environment (i.e. value for RAILS_ENV) under which</span>
+<a name="l00082"></a>00082 <span class="comment">                         * Rails applications should operate. */</span>
+<a name="l00083"></a>00083                         <span class="keyword">const</span> <span class="keywordtype">char</span> *railsEnv;
 <a name="l00084"></a>00084                         <span class="comment"></span>
-<a name="l00085"></a>00085 <span class="comment">                        /** The Passenger root folder. */</span>
-<a name="l00086"></a>00086                         <span class="keyword">const</span> <span class="keywordtype">char</span> *root;
-<a name="l00087"></a>00087                         <span class="comment"></span>
-<a name="l00088"></a>00088 <span class="comment">                        /** The log verbosity. */</span>
-<a name="l00089"></a>00089                         <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> logLevel;
-<a name="l00090"></a>00090                         <span class="comment"></span>
-<a name="l00091"></a>00091 <span class="comment">                        /** The maximum number of simultaneously alive application</span>
-<a name="l00092"></a>00092 <span class="comment">                         * instances. */</span>
-<a name="l00093"></a>00093                         <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> maxPoolSize;
-<a name="l00094"></a>00094                         <span class="comment"></span>
-<a name="l00095"></a>00095 <span class="comment">                        /** Whether the maxPoolSize option was explicitly specified in</span>
-<a name="l00096"></a>00096 <span class="comment">                         * this server config. */</span>
-<a name="l00097"></a>00097                         <span class="keywordtype">bool</span> maxPoolSizeSpecified;
+<a name="l00085"></a>00085 <span class="comment">                        /** The path to the application's root (for example: RAILS_ROOT</span>
+<a name="l00086"></a>00086 <span class="comment">                         * for Rails applications, directory containing 'config.ru'</span>
+<a name="l00087"></a>00087 <span class="comment">                         * for Rack applications). If this value is NULL, the default</span>
+<a name="l00088"></a>00088 <span class="comment">                         * autodetected path will be used.</span>
+<a name="l00089"></a>00089 <span class="comment">                         */</span>
+<a name="l00090"></a>00090                         <span class="keyword">const</span> <span class="keywordtype">char</span> *appRoot;
+<a name="l00091"></a>00091                         <span class="comment"></span>
+<a name="l00092"></a>00092 <span class="comment">                        /** The environment (i.e. value for RACK_ENV) under which</span>
+<a name="l00093"></a>00093 <span class="comment">                         * Rack applications should operate. */</span>
+<a name="l00094"></a>00094                         <span class="keyword">const</span> <span class="keywordtype">char</span> *rackEnv;
+<a name="l00095"></a>00095                         <span class="comment"></span>
+<a name="l00096"></a>00096 <span class="comment">                        /** The Rails spawn method to use. */</span>
+<a name="l00097"></a>00097                         SpawnMethod spawnMethod;
 <a name="l00098"></a>00098                         <span class="comment"></span>
-<a name="l00099"></a>00099 <span class="comment">                        /** The maximum number of simultaneously alive Rails application</span>
-<a name="l00100"></a>00100 <span class="comment">                         * that a single Rails application may occupy. */</span>
-<a name="l00101"></a>00101                         <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> maxInstancesPerApp;
-<a name="l00102"></a>00102                         <span class="comment"></span>
-<a name="l00103"></a>00103 <span class="comment">                        /** Whether the maxInstancesPerApp option was explicitly specified in</span>
-<a name="l00104"></a>00104 <span class="comment">                         * this server config. */</span>
-<a name="l00105"></a>00105                         <span class="keywordtype">bool</span> maxInstancesPerAppSpecified;
-<a name="l00106"></a>00106                         <span class="comment"></span>
-<a name="l00107"></a>00107 <span class="comment">                        /** The maximum number of seconds that an application may be</span>
-<a name="l00108"></a>00108 <span class="comment">                         * idle before it gets terminated. */</span>
-<a name="l00109"></a>00109                         <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> poolIdleTime;
-<a name="l00110"></a>00110                         <span class="comment"></span>
-<a name="l00111"></a>00111 <span class="comment">                        /** Whether the poolIdleTime option was explicitly specified in</span>
-<a name="l00112"></a>00112 <span class="comment">                         * this server config. */</span>
-<a name="l00113"></a>00113                         <span class="keywordtype">bool</span> poolIdleTimeSpecified;
-<a name="l00114"></a>00114                         <span class="comment"></span>
-<a name="l00115"></a>00115 <span class="comment">                        /** Whether global queuing should be used. */</span>
-<a name="l00116"></a>00116                         <span class="keywordtype">bool</span> useGlobalQueue;
-<a name="l00117"></a>00117                         <span class="comment"></span>
-<a name="l00118"></a>00118 <span class="comment">                        /** Whether the useGlobalQueue option was explicitly specified</span>
-<a name="l00119"></a>00119 <span class="comment">                         * in this server config. */</span>
-<a name="l00120"></a>00120                         <span class="keywordtype">bool</span> useGlobalQueueSpecified;
-<a name="l00121"></a>00121                         <span class="comment"></span>
-<a name="l00122"></a>00122 <span class="comment">                        /** Whether user switching support is enabled. */</span>
-<a name="l00123"></a>00123                         <span class="keywordtype">bool</span> userSwitching;
-<a name="l00124"></a>00124                         <span class="comment"></span>
-<a name="l00125"></a>00125 <span class="comment">                        /** Whether the userSwitching option was explicitly specified in</span>
-<a name="l00126"></a>00126 <span class="comment">                         * this server config. */</span>
-<a name="l00127"></a>00127                         <span class="keywordtype">bool</span> userSwitchingSpecified;
-<a name="l00128"></a>00128 <span class="comment"></span>
-<a name="l00129"></a>00129 <span class="comment">                        /** The user that applications must run as if user switching</span>
-<a name="l00130"></a>00130 <span class="comment">                         * fails or is disabled. NULL means the option is not specified.</span>
-<a name="l00131"></a>00131 <span class="comment">                         */</span>
-<a name="l00132"></a>00132                         <span class="keyword">const</span> <span class="keywordtype">char</span> *defaultUser;
-<a name="l00133"></a>00133                         
-<a name="l00134"></a>00134                         <span class="keywordtype">bool</span> getUseGlobalQueue()<span class="keyword"> const </span>{
-<a name="l00135"></a>00135                                 <span class="keywordflow">if</span> (useGlobalQueueSpecified) {
-<a name="l00136"></a>00136                                         <span class="keywordflow">return</span> useGlobalQueue;
-<a name="l00137"></a>00137                                 } <span class="keywordflow">else</span> {
-<a name="l00138"></a>00138                                         <span class="keywordflow">return</span> <span class="keyword">false</span>;
-<a name="l00139"></a>00139                                 }
-<a name="l00140"></a>00140                         }
-<a name="l00141"></a>00141                 };
-<a name="l00142"></a>00142         }
-<a name="l00143"></a>00143 
-<a name="l00144"></a>00144         <span class="keyword">extern</span> <span class="stringliteral">"C"</span> {
-<a name="l00145"></a>00145 <span class="preprocessor">#endif</span>
-<a name="l00146"></a>00146 <span class="preprocessor"></span><span class="comment"></span>
-<a name="l00147"></a>00147 <span class="comment">/** Configuration hook for per-directory configuration structure creation. */</span>
-<a name="l00148"></a>00148 <span class="keywordtype">void</span> *<a class="code" href="group__Configuration.html#g92dc583c1fa5f8025149799e356a6c78" title="Configuration hook for per-directory configuration structure creation.">passenger_config_create_dir</a>(apr_pool_t *p, <span class="keywordtype">char</span> *dirspec);
-<a name="l00149"></a>00149 <span class="comment"></span>
-<a name="l00150"></a>00150 <span class="comment">/** Configuration hook for per-directory configuration structure merging. */</span>
-<a name="l00151"></a>00151 <span class="keywordtype">void</span> *<a class="code" href="group__Configuration.html#g17787a036ef3f4dc46ae0acc9da2c7b0" title="Configuration hook for per-directory configuration structure merging.">passenger_config_merge_dir</a>(apr_pool_t *p, <span class="keywordtype">void</span> *basev, <span class="keywordtype">void</span> *addv);
-<a name="l00152"></a>00152 <span class="comment"></span>
-<a name="l00153"></a>00153 <span class="comment">/** Configuration hook for per-server configuration structure creation. */</span>
-<a name="l00154"></a>00154 <span class="keywordtype">void</span> *<a class="code" href="group__Configuration.html#ga93bd8d426649b4e86da38eb67a49178" title="Configuration hook for per-server configuration structure creation.">passenger_config_create_server</a>(apr_pool_t *p, server_rec *s);
-<a name="l00155"></a>00155 <span class="comment"></span>
-<a name="l00156"></a>00156 <span class="comment">/** Configuration hook for per-server configuration structure merging. */</span>
-<a name="l00157"></a>00157 <span class="keywordtype">void</span> *<a class="code" href="group__Configuration.html#g95c963a61867190928d912779952b15e" title="Configuration hook for per-server configuration structure merging.">passenger_config_merge_server</a>(apr_pool_t *p, <span class="keywordtype">void</span> *basev, <span class="keywordtype">void</span> *overridesv);
-<a name="l00158"></a>00158 
-<a name="l00159"></a>00159 <span class="keywordtype">void</span> passenger_config_merge_all_servers(apr_pool_t *pool, server_rec *main_server);
-<a name="l00160"></a>00160 <span class="comment"></span>
-<a name="l00161"></a>00161 <span class="comment">/** Apache module commands array. */</span>
-<a name="l00162"></a>00162 <span class="keyword">extern</span> <span class="keyword">const</span> command_rec <a class="code" href="group__Configuration.html#g21954abbf4018583acb9d8daef3dfd95" title="Apache module commands array.">passenger_commands</a>[];
-<a name="l00163"></a>00163 
-<a name="l00164"></a>00164 <span class="preprocessor">#ifdef __cplusplus</span>
-<a name="l00165"></a>00165 <span class="preprocessor"></span>        }
-<a name="l00166"></a>00166 <span class="preprocessor">#endif</span>
-<a name="l00167"></a>00167 <span class="preprocessor"></span><span class="comment"></span>
-<a name="l00168"></a>00168 <span class="comment">/**</span>
-<a name="l00169"></a>00169 <span class="comment"> * @}</span>
-<a name="l00170"></a>00170 <span class="comment"> */</span>
-<a name="l00171"></a>00171 
-<a name="l00172"></a>00172 <span class="preprocessor">#endif </span><span class="comment">/* _PASSENGER_CONFIGURATION_H_ */</span>
+<a name="l00099"></a>00099 <span class="comment">                        /**</span>
+<a name="l00100"></a>00100 <span class="comment">                         * The idle timeout, in seconds, of Rails framework spawners.</span>
+<a name="l00101"></a>00101 <span class="comment">                         * May also be 0 (which indicates that the framework spawner should</span>
+<a name="l00102"></a>00102 <span class="comment">                         * never idle timeout) or -1 (which means that the value is not specified).</span>
+<a name="l00103"></a>00103 <span class="comment">                         */</span>
+<a name="l00104"></a>00104                         <span class="keywordtype">long</span> frameworkSpawnerTimeout;
+<a name="l00105"></a>00105                         <span class="comment"></span>
+<a name="l00106"></a>00106 <span class="comment">                        /**</span>
+<a name="l00107"></a>00107 <span class="comment">                         * The idle timeout, in seconds, of Rails application spawners.</span>
+<a name="l00108"></a>00108 <span class="comment">                         * May also be 0 (which indicates that the application spawner should</span>
+<a name="l00109"></a>00109 <span class="comment">                         * never idle timeout) or -1 (which means that the value is not specified).</span>
+<a name="l00110"></a>00110 <span class="comment">                         */</span>
+<a name="l00111"></a>00111                         <span class="keywordtype">long</span> appSpawnerTimeout;
+<a name="l00112"></a>00112                         <span class="comment"></span>
+<a name="l00113"></a>00113 <span class="comment">                        /**</span>
+<a name="l00114"></a>00114 <span class="comment">                         * The maximum number of requests that the spawned application may process</span>
+<a name="l00115"></a>00115 <span class="comment">                         * before exiting. A value of 0 means unlimited.</span>
+<a name="l00116"></a>00116 <span class="comment">                         */</span>
+<a name="l00117"></a>00117                         <span class="keywordtype">unsigned</span> <span class="keywordtype">long</span> maxRequests;
+<a name="l00118"></a>00118                         <span class="comment"></span>
+<a name="l00119"></a>00119 <span class="comment">                        /** Indicates whether the maxRequests option was explicitly specified</span>
+<a name="l00120"></a>00120 <span class="comment">                         * in the directory configuration. */</span>
+<a name="l00121"></a>00121                         <span class="keywordtype">bool</span> maxRequestsSpecified;
+<a name="l00122"></a>00122                         <span class="comment"></span>
+<a name="l00123"></a>00123 <span class="comment">                        /**</span>
+<a name="l00124"></a>00124 <span class="comment">                         * The maximum amount of memory (in MB) the spawned application may use.</span>
+<a name="l00125"></a>00125 <span class="comment">                         * A value of 0 means unlimited.</span>
+<a name="l00126"></a>00126 <span class="comment">                         */</span>
+<a name="l00127"></a>00127                         <span class="keywordtype">unsigned</span> <span class="keywordtype">long</span> memoryLimit;
+<a name="l00128"></a>00128                         <span class="comment"></span>
+<a name="l00129"></a>00129 <span class="comment">                        /** Indicates whether the memoryLimit option was explicitly specified</span>
+<a name="l00130"></a>00130 <span class="comment">                         * in the directory configuration. */</span>
+<a name="l00131"></a>00131                         <span class="keywordtype">bool</span> memoryLimitSpecified;
+<a name="l00132"></a>00132                         
+<a name="l00133"></a>00133                         Threeway highPerformance;
+<a name="l00134"></a>00134                         <span class="comment"></span>
+<a name="l00135"></a>00135 <span class="comment">                        /** Whether global queuing should be used. */</span>
+<a name="l00136"></a>00136                         Threeway useGlobalQueue;
+<a name="l00137"></a>00137                         <span class="comment"></span>
+<a name="l00138"></a>00138 <span class="comment">                        /**</span>
+<a name="l00139"></a>00139 <span class="comment">                         * Throttle the number of stat() calls on files like</span>
+<a name="l00140"></a>00140 <span class="comment">                         * restart.txt to the once per given number of seconds.</span>
+<a name="l00141"></a>00141 <span class="comment">                         */</span>
+<a name="l00142"></a>00142                         <span class="keywordtype">unsigned</span> <span class="keywordtype">long</span> statThrottleRate;
+<a name="l00143"></a>00143                         <span class="comment"></span>
+<a name="l00144"></a>00144 <span class="comment">                        /** Indicates whether the statThrottleRate option was</span>
+<a name="l00145"></a>00145 <span class="comment">                         * explicitly specified in the directory configuration. */</span>
+<a name="l00146"></a>00146                         <span class="keywordtype">bool</span> statThrottleRateSpecified;
+<a name="l00147"></a>00147                         <span class="comment"></span>
+<a name="l00148"></a>00148 <span class="comment">                        /** The directory in which Passenger should look for</span>
+<a name="l00149"></a>00149 <span class="comment">                         * restart.txt. NULL means that the default directory</span>
+<a name="l00150"></a>00150 <span class="comment">                         * should be used.</span>
+<a name="l00151"></a>00151 <span class="comment">                         */</span>
+<a name="l00152"></a>00152                         <span class="keyword">const</span> <span class="keywordtype">char</span> *restartDir;
+<a name="l00153"></a>00153                         
+<a name="l00154"></a>00154                         <span class="comment">/*************************************/</span>
+<a name="l00155"></a>00155                         
+<a name="l00156"></a>00156                         <span class="keywordtype">bool</span> isEnabled()<span class="keyword"> const </span>{
+<a name="l00157"></a>00157                                 <span class="keywordflow">return</span> enabled != DISABLED;
+<a name="l00158"></a>00158                         }
+<a name="l00159"></a>00159                         
+<a name="l00160"></a>00160                         <span class="keywordtype">string</span> getAppRoot(<span class="keyword">const</span> <span class="keywordtype">char</span> *documentRoot)<span class="keyword"> const </span>{
+<a name="l00161"></a>00161                                 <span class="keywordflow">if</span> (appRoot == NULL) {
+<a name="l00162"></a>00162                                         <span class="keywordflow">return</span> string(documentRoot).append(<span class="stringliteral">"/.."</span>);
+<a name="l00163"></a>00163                                 } <span class="keywordflow">else</span> {
+<a name="l00164"></a>00164                                         <span class="keywordflow">return</span> appRoot;
+<a name="l00165"></a>00165                                 }
+<a name="l00166"></a>00166                         }
+<a name="l00167"></a>00167                         
+<a name="l00168"></a>00168                         <span class="keyword">const</span> <span class="keywordtype">char</span> *getRailsEnv()<span class="keyword"> const </span>{
+<a name="l00169"></a>00169                                 <span class="keywordflow">if</span> (railsEnv != NULL) {
+<a name="l00170"></a>00170                                         <span class="keywordflow">return</span> railsEnv;
+<a name="l00171"></a>00171                                 } <span class="keywordflow">else</span> {
+<a name="l00172"></a>00172                                         <span class="keywordflow">return</span> <span class="stringliteral">"production"</span>;
+<a name="l00173"></a>00173                                 }
+<a name="l00174"></a>00174                         }
+<a name="l00175"></a>00175                         
+<a name="l00176"></a>00176                         <span class="keyword">const</span> <span class="keywordtype">char</span> *getRackEnv()<span class="keyword"> const </span>{
+<a name="l00177"></a>00177                                 <span class="keywordflow">if</span> (rackEnv != NULL) {
+<a name="l00178"></a>00178                                         <span class="keywordflow">return</span> rackEnv;
+<a name="l00179"></a>00179                                 } <span class="keywordflow">else</span> {
+<a name="l00180"></a>00180                                         <span class="keywordflow">return</span> <span class="stringliteral">"production"</span>;
+<a name="l00181"></a>00181                                 }
+<a name="l00182"></a>00182                         }
+<a name="l00183"></a>00183                         
+<a name="l00184"></a>00184                         <span class="keyword">const</span> <span class="keywordtype">char</span> *getSpawnMethodString() {
+<a name="l00185"></a>00185                                 <span class="keywordflow">switch</span> (spawnMethod) {
+<a name="l00186"></a>00186                                 <span class="keywordflow">case</span> SM_SMART:
+<a name="l00187"></a>00187                                         <span class="keywordflow">return</span> <span class="stringliteral">"smart"</span>;
+<a name="l00188"></a>00188                                 <span class="keywordflow">case</span> SM_SMART_LV2:
+<a name="l00189"></a>00189                                         <span class="keywordflow">return</span> <span class="stringliteral">"smart-lv2"</span>;
+<a name="l00190"></a>00190                                 <span class="keywordflow">case</span> SM_CONSERVATIVE:
+<a name="l00191"></a>00191                                         <span class="keywordflow">return</span> <span class="stringliteral">"conservative"</span>;
+<a name="l00192"></a>00192                                 <span class="keywordflow">default</span>:
+<a name="l00193"></a>00193                                         <span class="keywordflow">return</span> <span class="stringliteral">"smart-lv2"</span>;
+<a name="l00194"></a>00194                                 }
+<a name="l00195"></a>00195                         }
+<a name="l00196"></a>00196                         
+<a name="l00197"></a>00197                         <span class="keywordtype">unsigned</span> <span class="keywordtype">long</span> getMaxRequests() {
+<a name="l00198"></a>00198                                 <span class="keywordflow">if</span> (maxRequestsSpecified) {
+<a name="l00199"></a>00199                                         <span class="keywordflow">return</span> maxRequests;
+<a name="l00200"></a>00200                                 } <span class="keywordflow">else</span> {
+<a name="l00201"></a>00201                                         <span class="keywordflow">return</span> 0;
+<a name="l00202"></a>00202                                 }
+<a name="l00203"></a>00203                         }
+<a name="l00204"></a>00204                         
+<a name="l00205"></a>00205                         <span class="keywordtype">unsigned</span> <span class="keywordtype">long</span> getMemoryLimit() {
+<a name="l00206"></a>00206                                 <span class="keywordflow">if</span> (memoryLimitSpecified) {
+<a name="l00207"></a>00207                                         <span class="keywordflow">return</span> memoryLimit;
+<a name="l00208"></a>00208                                 } <span class="keywordflow">else</span> {
+<a name="l00209"></a>00209                                         <span class="keywordflow">return</span> 200;
+<a name="l00210"></a>00210                                 }
+<a name="l00211"></a>00211                         }
+<a name="l00212"></a>00212                         
+<a name="l00213"></a>00213                         <span class="keywordtype">bool</span> highPerformanceMode()<span class="keyword"> const </span>{
+<a name="l00214"></a>00214                                 <span class="keywordflow">return</span> highPerformance == ENABLED;
+<a name="l00215"></a>00215                         }
+<a name="l00216"></a>00216                         
+<a name="l00217"></a>00217                         <span class="keywordtype">bool</span> usingGlobalQueue()<span class="keyword"> const </span>{
+<a name="l00218"></a>00218                                 <span class="keywordflow">return</span> useGlobalQueue == ENABLED;
+<a name="l00219"></a>00219                         }
+<a name="l00220"></a>00220                         
+<a name="l00221"></a>00221                         <span class="keywordtype">unsigned</span> <span class="keywordtype">long</span> getStatThrottleRate()<span class="keyword"> const </span>{
+<a name="l00222"></a>00222                                 <span class="keywordflow">if</span> (statThrottleRateSpecified) {
+<a name="l00223"></a>00223                                         <span class="keywordflow">return</span> statThrottleRate;
+<a name="l00224"></a>00224                                 } <span class="keywordflow">else</span> {
+<a name="l00225"></a>00225                                         <span class="keywordflow">return</span> 0;
+<a name="l00226"></a>00226                                 }
+<a name="l00227"></a>00227                         }
+<a name="l00228"></a>00228                         
+<a name="l00229"></a>00229                         <span class="keyword">const</span> <span class="keywordtype">char</span> *getRestartDir()<span class="keyword"> const </span>{
+<a name="l00230"></a>00230                                 <span class="keywordflow">if</span> (restartDir != NULL) {
+<a name="l00231"></a>00231                                         <span class="keywordflow">return</span> restartDir;
+<a name="l00232"></a>00232                                 } <span class="keywordflow">else</span> {
+<a name="l00233"></a>00233                                         <span class="keywordflow">return</span> <span class="stringliteral">""</span>;
+<a name="l00234"></a>00234                                 }
+<a name="l00235"></a>00235                         }
+<a name="l00236"></a>00236                         
+<a name="l00237"></a>00237                         <span class="comment">/*************************************/</span>
+<a name="l00238"></a>00238                 };
+<a name="l00239"></a>00239                 <span class="comment"></span>
+<a name="l00240"></a>00240 <span class="comment">                /**</span>
+<a name="l00241"></a>00241 <span class="comment">                 * Server-wide (global, not per-virtual host) configuration information.</span>
+<a name="l00242"></a>00242 <span class="comment">                 *</span>
+<a name="l00243"></a>00243 <span class="comment">                 * Use the getter methods to query information, because those will return</span>
+<a name="l00244"></a>00244 <span class="comment">                 * the default value if the value is not specified.</span>
+<a name="l00245"></a>00245 <span class="comment">                 */</span>
+<a name="l00246"></a>00246                 <span class="keyword">struct </span>ServerConfig {<span class="comment"></span>
+<a name="l00247"></a>00247 <span class="comment">                        /** The filename of the Ruby interpreter to use. */</span>
+<a name="l00248"></a>00248                         <span class="keyword">const</span> <span class="keywordtype">char</span> *ruby;
+<a name="l00249"></a>00249                         <span class="comment"></span>
+<a name="l00250"></a>00250 <span class="comment">                        /** The Passenger root folder. */</span>
+<a name="l00251"></a>00251                         <span class="keyword">const</span> <span class="keywordtype">char</span> *root;
+<a name="l00252"></a>00252                         <span class="comment"></span>
+<a name="l00253"></a>00253 <span class="comment">                        /** The log verbosity. */</span>
+<a name="l00254"></a>00254                         <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> logLevel;
+<a name="l00255"></a>00255                         <span class="comment"></span>
+<a name="l00256"></a>00256 <span class="comment">                        /** The maximum number of simultaneously alive application</span>
+<a name="l00257"></a>00257 <span class="comment">                         * instances. */</span>
+<a name="l00258"></a>00258                         <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> maxPoolSize;
+<a name="l00259"></a>00259                         <span class="comment"></span>
+<a name="l00260"></a>00260 <span class="comment">                        /** Whether the maxPoolSize option was explicitly specified in</span>
+<a name="l00261"></a>00261 <span class="comment">                         * this server config. */</span>
+<a name="l00262"></a>00262                         <span class="keywordtype">bool</span> maxPoolSizeSpecified;
+<a name="l00263"></a>00263                         <span class="comment"></span>
+<a name="l00264"></a>00264 <span class="comment">                        /** The maximum number of simultaneously alive Rails application</span>
+<a name="l00265"></a>00265 <span class="comment">                         * that a single Rails application may occupy. */</span>
+<a name="l00266"></a>00266                         <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> maxInstancesPerApp;
+<a name="l00267"></a>00267                         <span class="comment"></span>
+<a name="l00268"></a>00268 <span class="comment">                        /** Whether the maxInstancesPerApp option was explicitly specified in</span>
+<a name="l00269"></a>00269 <span class="comment">                         * this server config. */</span>
+<a name="l00270"></a>00270                         <span class="keywordtype">bool</span> maxInstancesPerAppSpecified;
+<a name="l00271"></a>00271                         <span class="comment"></span>
+<a name="l00272"></a>00272 <span class="comment">                        /** The maximum number of seconds that an application may be</span>
+<a name="l00273"></a>00273 <span class="comment">                         * idle before it gets terminated. */</span>
+<a name="l00274"></a>00274                         <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> poolIdleTime;
+<a name="l00275"></a>00275                         <span class="comment"></span>
+<a name="l00276"></a>00276 <span class="comment">                        /** Whether the poolIdleTime option was explicitly specified in</span>
+<a name="l00277"></a>00277 <span class="comment">                         * this server config. */</span>
+<a name="l00278"></a>00278                         <span class="keywordtype">bool</span> poolIdleTimeSpecified;
+<a name="l00279"></a>00279                         <span class="comment"></span>
+<a name="l00280"></a>00280 <span class="comment">                        /** Whether user switching support is enabled. */</span>
+<a name="l00281"></a>00281                         <span class="keywordtype">bool</span> userSwitching;
+<a name="l00282"></a>00282                         <span class="comment"></span>
+<a name="l00283"></a>00283 <span class="comment">                        /** Whether the userSwitching option was explicitly specified in</span>
+<a name="l00284"></a>00284 <span class="comment">                         * this server config. */</span>
+<a name="l00285"></a>00285                         <span class="keywordtype">bool</span> userSwitchingSpecified;
+<a name="l00286"></a>00286 <span class="comment"></span>
+<a name="l00287"></a>00287 <span class="comment">                        /** The user that applications must run as if user switching</span>
+<a name="l00288"></a>00288 <span class="comment">                         * fails or is disabled. NULL means the option is not specified.</span>
+<a name="l00289"></a>00289 <span class="comment">                         */</span>
+<a name="l00290"></a>00290                         <span class="keyword">const</span> <span class="keywordtype">char</span> *defaultUser;
+<a name="l00291"></a>00291                         <span class="comment"></span>
+<a name="l00292"></a>00292 <span class="comment">                        /** The temp directory that Passenger should use. NULL</span>
+<a name="l00293"></a>00293 <span class="comment">                         * means unspecified.</span>
+<a name="l00294"></a>00294 <span class="comment">                         */</span>
+<a name="l00295"></a>00295                         <span class="keyword">const</span> <span class="keywordtype">char</span> *tempDir;
+<a name="l00296"></a>00296                         
+<a name="l00297"></a>00297                         <span class="keyword">const</span> <span class="keywordtype">char</span> *getDefaultUser()<span class="keyword"> const </span>{
+<a name="l00298"></a>00298                                 <span class="keywordflow">if</span> (defaultUser != NULL) {
+<a name="l00299"></a>00299                                         <span class="keywordflow">return</span> defaultUser;
+<a name="l00300"></a>00300                                 } <span class="keywordflow">else</span> {
+<a name="l00301"></a>00301                                         <span class="keywordflow">return</span> <span class="stringliteral">"nobody"</span>;
+<a name="l00302"></a>00302                                 }
+<a name="l00303"></a>00303                         }
+<a name="l00304"></a>00304                 };
+<a name="l00305"></a>00305         }
+<a name="l00306"></a>00306 
+<a name="l00307"></a>00307         <span class="keyword">extern</span> <span class="stringliteral">"C"</span> {
+<a name="l00308"></a>00308 <span class="preprocessor">#endif</span>
+<a name="l00309"></a>00309 <span class="preprocessor"></span><span class="comment"></span>
+<a name="l00310"></a>00310 <span class="comment">/** Configuration hook for per-directory configuration structure creation. */</span>
+<a name="l00311"></a>00311 <span class="keywordtype">void</span> *<a class="code" href="group__Configuration.html#g92dc583c1fa5f8025149799e356a6c78" title="Configuration hook for per-directory configuration structure creation.">passenger_config_create_dir</a>(apr_pool_t *p, <span class="keywordtype">char</span> *dirspec);
+<a name="l00312"></a>00312 <span class="comment"></span>
+<a name="l00313"></a>00313 <span class="comment">/** Configuration hook for per-directory configuration structure merging. */</span>
+<a name="l00314"></a>00314 <span class="keywordtype">void</span> *<a class="code" href="group__Configuration.html#g17787a036ef3f4dc46ae0acc9da2c7b0" title="Configuration hook for per-directory configuration structure merging.">passenger_config_merge_dir</a>(apr_pool_t *p, <span class="keywordtype">void</span> *basev, <span class="keywordtype">void</span> *addv);
+<a name="l00315"></a>00315 <span class="comment"></span>
+<a name="l00316"></a>00316 <span class="comment">/** Configuration hook for per-server configuration structure creation. */</span>
+<a name="l00317"></a>00317 <span class="keywordtype">void</span> *<a class="code" href="group__Configuration.html#ga93bd8d426649b4e86da38eb67a49178" title="Configuration hook for per-server configuration structure creation.">passenger_config_create_server</a>(apr_pool_t *p, server_rec *s);
+<a name="l00318"></a>00318 <span class="comment"></span>
+<a name="l00319"></a>00319 <span class="comment">/** Configuration hook for per-server configuration structure merging. */</span>
+<a name="l00320"></a>00320 <span class="keywordtype">void</span> *<a class="code" href="group__Configuration.html#g95c963a61867190928d912779952b15e" title="Configuration hook for per-server configuration structure merging.">passenger_config_merge_server</a>(apr_pool_t *p, <span class="keywordtype">void</span> *basev, <span class="keywordtype">void</span> *overridesv);
+<a name="l00321"></a>00321 
+<a name="l00322"></a>00322 <span class="keywordtype">void</span> passenger_config_merge_all_servers(apr_pool_t *pool, server_rec *main_server);
+<a name="l00323"></a>00323 <span class="comment"></span>
+<a name="l00324"></a>00324 <span class="comment">/** Apache module commands array. */</span>
+<a name="l00325"></a>00325 <span class="keyword">extern</span> <span class="keyword">const</span> command_rec <a class="code" href="group__Configuration.html#g21954abbf4018583acb9d8daef3dfd95" title="Apache module commands array.">passenger_commands</a>[];
+<a name="l00326"></a>00326 
+<a name="l00327"></a>00327 <span class="preprocessor">#ifdef __cplusplus</span>
+<a name="l00328"></a>00328 <span class="preprocessor"></span>        }
+<a name="l00329"></a>00329 <span class="preprocessor">#endif</span>
+<a name="l00330"></a>00330 <span class="preprocessor"></span><span class="comment"></span>
+<a name="l00331"></a>00331 <span class="comment">/**</span>
+<a name="l00332"></a>00332 <span class="comment"> * @}</span>
+<a name="l00333"></a>00333 <span class="comment"> */</span>
+<a name="l00334"></a>00334 
+<a name="l00335"></a>00335 <span class="preprocessor">#endif </span><span class="comment">/* _PASSENGER_CONFIGURATION_H_ */</span>
 </pre></div></div>
-<hr size="1"><address style="text-align: right;"><small>Generated on Mon Dec 15 15:27:24 2008 for Passenger by&nbsp;
+<hr size="1"><address style="text-align: right;"><small>Generated on Fri Mar 13 19:24:32 2009 for Passenger by&nbsp;
 <a href="http://www.doxygen.org/index.html">
 <img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.5 </small></address>
 </body>