passenger 2.2.12 → 2.2.13

Sign up to get free protection for your applications and to get access to all the features.

Potentially problematic release.


This version of passenger might be problematic. Click here for more details.

@@ -0,0 +1,326 @@
1
+ <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
2
+ <html xmlns="http://www.w3.org/1999/xhtml">
3
+ <head>
4
+ <meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
5
+ <title>Passenger: DirectoryMapper.h Source File</title>
6
+ <link href="tabs.css" rel="stylesheet" type="text/css"/>
7
+ <link href="doxygen.css" rel="stylesheet" type="text/css"/>
8
+ </head>
9
+ <body>
10
+ <!-- Generated by Doxygen 1.6.2 -->
11
+ <div class="navigation" id="top">
12
+ <div class="tabs">
13
+ <ul>
14
+ <li><a href="main.html"><span>Main&nbsp;Page</span></a></li>
15
+ <li><a href="modules.html"><span>Modules</span></a></li>
16
+ <li><a href="annotated.html"><span>Classes</span></a></li>
17
+ <li class="current"><a href="files.html"><span>Files</span></a></li>
18
+ </ul>
19
+ </div>
20
+ <div class="tabs">
21
+ <ul>
22
+ <li><a href="files.html"><span>File&nbsp;List</span></a></li>
23
+ </ul>
24
+ </div>
25
+ <h1>DirectoryMapper.h</h1><div class="fragment"><pre class="fragment"><a name="l00001"></a>00001 <span class="comment">/*</span>
26
+ <a name="l00002"></a>00002 <span class="comment"> * Phusion Passenger - http://www.modrails.com/</span>
27
+ <a name="l00003"></a>00003 <span class="comment"> * Copyright (c) 2008, 2009 Phusion</span>
28
+ <a name="l00004"></a>00004 <span class="comment"> *</span>
29
+ <a name="l00005"></a>00005 <span class="comment"> * &quot;Phusion Passenger&quot; is a trademark of Hongli Lai &amp; Ninh Bui.</span>
30
+ <a name="l00006"></a>00006 <span class="comment"> *</span>
31
+ <a name="l00007"></a>00007 <span class="comment"> * Permission is hereby granted, free of charge, to any person obtaining a copy</span>
32
+ <a name="l00008"></a>00008 <span class="comment"> * of this software and associated documentation files (the &quot;Software&quot;), to deal</span>
33
+ <a name="l00009"></a>00009 <span class="comment"> * in the Software without restriction, including without limitation the rights</span>
34
+ <a name="l00010"></a>00010 <span class="comment"> * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell</span>
35
+ <a name="l00011"></a>00011 <span class="comment"> * copies of the Software, and to permit persons to whom the Software is</span>
36
+ <a name="l00012"></a>00012 <span class="comment"> * furnished to do so, subject to the following conditions:</span>
37
+ <a name="l00013"></a>00013 <span class="comment"> *</span>
38
+ <a name="l00014"></a>00014 <span class="comment"> * The above copyright notice and this permission notice shall be included in</span>
39
+ <a name="l00015"></a>00015 <span class="comment"> * all copies or substantial portions of the Software.</span>
40
+ <a name="l00016"></a>00016 <span class="comment"> *</span>
41
+ <a name="l00017"></a>00017 <span class="comment"> * THE SOFTWARE IS PROVIDED &quot;AS IS&quot;, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR</span>
42
+ <a name="l00018"></a>00018 <span class="comment"> * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,</span>
43
+ <a name="l00019"></a>00019 <span class="comment"> * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE</span>
44
+ <a name="l00020"></a>00020 <span class="comment"> * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER</span>
45
+ <a name="l00021"></a>00021 <span class="comment"> * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,</span>
46
+ <a name="l00022"></a>00022 <span class="comment"> * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN</span>
47
+ <a name="l00023"></a>00023 <span class="comment"> * THE SOFTWARE.</span>
48
+ <a name="l00024"></a>00024 <span class="comment"> */</span>
49
+ <a name="l00025"></a>00025 <span class="preprocessor">#ifndef _PASSENGER_DIRECTORY_MAPPER_H_</span>
50
+ <a name="l00026"></a>00026 <span class="preprocessor"></span><span class="preprocessor">#define _PASSENGER_DIRECTORY_MAPPER_H_</span>
51
+ <a name="l00027"></a>00027 <span class="preprocessor"></span>
52
+ <a name="l00028"></a>00028 <span class="preprocessor">#include &lt;string&gt;</span>
53
+ <a name="l00029"></a>00029 <span class="preprocessor">#include &lt;set&gt;</span>
54
+ <a name="l00030"></a>00030 <span class="preprocessor">#include &lt;cstring&gt;</span>
55
+ <a name="l00031"></a>00031
56
+ <a name="l00032"></a>00032 <span class="preprocessor">#include &lt;oxt/backtrace.hpp&gt;</span>
57
+ <a name="l00033"></a>00033
58
+ <a name="l00034"></a>00034 <span class="preprocessor">#include &quot;CachedFileStat.hpp&quot;</span>
59
+ <a name="l00035"></a>00035 <span class="preprocessor">#include &quot;Configuration.h&quot;</span>
60
+ <a name="l00036"></a>00036 <span class="preprocessor">#include &quot;Utils.h&quot;</span>
61
+ <a name="l00037"></a>00037
62
+ <a name="l00038"></a>00038 <span class="comment">// The Apache/APR headers *must* come after the Boost headers, otherwise</span>
63
+ <a name="l00039"></a>00039 <span class="comment">// compilation will fail on OpenBSD.</span>
64
+ <a name="l00040"></a>00040 <span class="preprocessor">#include &lt;httpd.h&gt;</span>
65
+ <a name="l00041"></a>00041 <span class="preprocessor">#include &lt;http_core.h&gt;</span>
66
+ <a name="l00042"></a>00042
67
+ <a name="l00043"></a>00043 <span class="keyword">namespace </span>Passenger {
68
+ <a name="l00044"></a>00044
69
+ <a name="l00045"></a>00045 <span class="keyword">using namespace </span>std;
70
+ <a name="l00046"></a>00046 <span class="keyword">using namespace </span>oxt;
71
+ <a name="l00047"></a>00047 <span class="comment"></span>
72
+ <a name="l00048"></a>00048 <span class="comment">/**</span>
73
+ <a name="l00049"></a>00049 <span class="comment"> * Utility class for determining URI-to-application directory mappings.</span>
74
+ <a name="l00050"></a>00050 <span class="comment"> * Given a URI, it will determine whether that URI belongs to a Phusion</span>
75
+ <a name="l00051"></a>00051 <span class="comment"> * Passenger-handled application, what the base URI of that application is,</span>
76
+ <a name="l00052"></a>00052 <span class="comment"> * and what the associated &#39;public&#39; directory is.</span>
77
+ <a name="l00053"></a>00053 <span class="comment"> *</span>
78
+ <a name="l00054"></a>00054 <span class="comment"> * @note This class is not thread-safe, but is reentrant.</span>
79
+ <a name="l00055"></a>00055 <span class="comment"> * @ingroup Core</span>
80
+ <a name="l00056"></a>00056 <span class="comment"> */</span>
81
+ <a name="l00057"></a><a class="code" href="classPassenger_1_1DirectoryMapper.html">00057</a> <span class="keyword">class </span><a class="code" href="classPassenger_1_1DirectoryMapper.html" title="Utility class for determining URI-to-application directory mappings.">DirectoryMapper</a> {
82
+ <a name="l00058"></a>00058 <span class="keyword">public</span>:
83
+ <a name="l00059"></a>00059 <span class="keyword">enum</span> ApplicationType {
84
+ <a name="l00060"></a>00060 NONE,
85
+ <a name="l00061"></a>00061 RAILS,
86
+ <a name="l00062"></a>00062 RACK,
87
+ <a name="l00063"></a>00063 WSGI
88
+ <a name="l00064"></a>00064 };
89
+ <a name="l00065"></a>00065
90
+ <a name="l00066"></a>00066 <span class="keyword">private</span>:
91
+ <a name="l00067"></a>00067 DirConfig *config;
92
+ <a name="l00068"></a>00068 request_rec *r;
93
+ <a name="l00069"></a>00069 CachedFileStat *cstat;
94
+ <a name="l00070"></a>00070 <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> throttleRate;
95
+ <a name="l00071"></a>00071 <span class="keywordtype">bool</span> baseURIKnown;
96
+ <a name="l00072"></a>00072 <span class="keyword">const</span> <span class="keywordtype">char</span> *baseURI;
97
+ <a name="l00073"></a>00073 ApplicationType appType;
98
+ <a name="l00074"></a>00074
99
+ <a name="l00075"></a>00075 <span class="keyword">inline</span> <span class="keywordtype">bool</span> shouldAutoDetectRails() {
100
+ <a name="l00076"></a>00076 <span class="keywordflow">return</span> config-&gt;autoDetectRails == DirConfig::ENABLED ||
101
+ <a name="l00077"></a>00077 config-&gt;autoDetectRails == DirConfig::UNSET;
102
+ <a name="l00078"></a>00078 }
103
+ <a name="l00079"></a>00079
104
+ <a name="l00080"></a>00080 <span class="keyword">inline</span> <span class="keywordtype">bool</span> shouldAutoDetectRack() {
105
+ <a name="l00081"></a>00081 <span class="keywordflow">return</span> config-&gt;autoDetectRack == DirConfig::ENABLED ||
106
+ <a name="l00082"></a>00082 config-&gt;autoDetectRack == DirConfig::UNSET;
107
+ <a name="l00083"></a>00083 }
108
+ <a name="l00084"></a>00084
109
+ <a name="l00085"></a>00085 <span class="keyword">inline</span> <span class="keywordtype">bool</span> shouldAutoDetectWSGI() {
110
+ <a name="l00086"></a>00086 <span class="keywordflow">return</span> config-&gt;autoDetectWSGI == DirConfig::ENABLED ||
111
+ <a name="l00087"></a>00087 config-&gt;autoDetectWSGI == DirConfig::UNSET;
112
+ <a name="l00088"></a>00088 }
113
+ <a name="l00089"></a>00089
114
+ <a name="l00090"></a>00090 <span class="keyword">public</span>:<span class="comment"></span>
115
+ <a name="l00091"></a>00091 <span class="comment"> /**</span>
116
+ <a name="l00092"></a>00092 <span class="comment"> * Create a new DirectoryMapper object.</span>
117
+ <a name="l00093"></a>00093 <span class="comment"> *</span>
118
+ <a name="l00094"></a>00094 <span class="comment"> * @param cstat A CachedFileStat object used for statting files.</span>
119
+ <a name="l00095"></a>00095 <span class="comment"> * @param throttleRate A throttling rate for cstat.</span>
120
+ <a name="l00096"></a>00096 <span class="comment"> * @warning Do not use this object after the destruction of &lt;tt&gt;r&lt;/tt&gt;,</span>
121
+ <a name="l00097"></a>00097 <span class="comment"> * &lt;tt&gt;config&lt;/tt&gt; or &lt;tt&gt;cstat&lt;/tt&gt;.</span>
122
+ <a name="l00098"></a>00098 <span class="comment"> */</span>
123
+ <a name="l00099"></a><a class="code" href="classPassenger_1_1DirectoryMapper.html#aeccfaf22dab9e78299309ea366b7447b">00099</a> <a class="code" href="classPassenger_1_1DirectoryMapper.html#aeccfaf22dab9e78299309ea366b7447b" title="Create a new DirectoryMapper object.">DirectoryMapper</a>(request_rec *r, DirConfig *config,
124
+ <a name="l00100"></a>00100 CachedFileStat *cstat, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> throttleRate) {
125
+ <a name="l00101"></a>00101 this-&gt;r = r;
126
+ <a name="l00102"></a>00102 this-&gt;config = config;
127
+ <a name="l00103"></a>00103 this-&gt;cstat = cstat;
128
+ <a name="l00104"></a>00104 this-&gt;throttleRate = throttleRate;
129
+ <a name="l00105"></a>00105 appType = NONE;
130
+ <a name="l00106"></a>00106 baseURIKnown = <span class="keyword">false</span>;
131
+ <a name="l00107"></a>00107 baseURI = NULL;
132
+ <a name="l00108"></a>00108 }
133
+ <a name="l00109"></a>00109 <span class="comment"></span>
134
+ <a name="l00110"></a>00110 <span class="comment"> /**</span>
135
+ <a name="l00111"></a>00111 <span class="comment"> * Determine whether the given HTTP request falls under one of the specified</span>
136
+ <a name="l00112"></a>00112 <span class="comment"> * RailsBaseURIs or RackBaseURIs. If yes, then the first matching base URI will</span>
137
+ <a name="l00113"></a>00113 <span class="comment"> * be returned.</span>
138
+ <a name="l00114"></a>00114 <span class="comment"> *</span>
139
+ <a name="l00115"></a>00115 <span class="comment"> * If Rails/Rack autodetection was enabled in the configuration, and the document</span>
140
+ <a name="l00116"></a>00116 <span class="comment"> * root seems to be a valid Rails/Rack &#39;public&#39; folder, then this method will</span>
141
+ <a name="l00117"></a>00117 <span class="comment"> * return &quot;/&quot;.</span>
142
+ <a name="l00118"></a>00118 <span class="comment"> *</span>
143
+ <a name="l00119"></a>00119 <span class="comment"> * Otherwise, NULL will be returned.</span>
144
+ <a name="l00120"></a>00120 <span class="comment"> *</span>
145
+ <a name="l00121"></a>00121 <span class="comment"> * @throws FileSystemException This method might also examine the filesystem in</span>
146
+ <a name="l00122"></a>00122 <span class="comment"> * order to detect the application&#39;s type. During that process, a</span>
147
+ <a name="l00123"></a>00123 <span class="comment"> * FileSystemException might be thrown.</span>
148
+ <a name="l00124"></a>00124 <span class="comment"> * @warning The return value may only be used as long as &lt;tt&gt;config&lt;/tt&gt;</span>
149
+ <a name="l00125"></a>00125 <span class="comment"> * hasn&#39;t been destroyed.</span>
150
+ <a name="l00126"></a>00126 <span class="comment"> */</span>
151
+ <a name="l00127"></a><a class="code" href="classPassenger_1_1DirectoryMapper.html#a2da887c077fc2460dea204783470e821">00127</a> <span class="keyword">const</span> <span class="keywordtype">char</span> *<a class="code" href="classPassenger_1_1DirectoryMapper.html#a2da887c077fc2460dea204783470e821" title="Determine whether the given HTTP request falls under one of the specified RailsBaseURIs...">getBaseURI</a>() {
152
+ <a name="l00128"></a>00128 TRACE_POINT();
153
+ <a name="l00129"></a>00129 <span class="keywordflow">if</span> (baseURIKnown) {
154
+ <a name="l00130"></a>00130 <span class="keywordflow">return</span> baseURI;
155
+ <a name="l00131"></a>00131 }
156
+ <a name="l00132"></a>00132
157
+ <a name="l00133"></a>00133 set&lt;string&gt;::const_iterator it;
158
+ <a name="l00134"></a>00134 <span class="keyword">const</span> <span class="keywordtype">char</span> *uri = r-&gt;uri;
159
+ <a name="l00135"></a>00135 <span class="keywordtype">size_t</span> uri_len = strlen(uri);
160
+ <a name="l00136"></a>00136
161
+ <a name="l00137"></a>00137 <span class="keywordflow">if</span> (uri_len == 0 || uri[0] != <span class="charliteral">&#39;/&#39;</span>) {
162
+ <a name="l00138"></a>00138 baseURIKnown = <span class="keyword">true</span>;
163
+ <a name="l00139"></a>00139 <span class="keywordflow">return</span> NULL;
164
+ <a name="l00140"></a>00140 }
165
+ <a name="l00141"></a>00141
166
+ <a name="l00142"></a>00142 UPDATE_TRACE_POINT();
167
+ <a name="l00143"></a>00143 <span class="keywordflow">for</span> (it = config-&gt;railsBaseURIs.begin(); it != config-&gt;railsBaseURIs.end(); it++) {
168
+ <a name="l00144"></a>00144 <span class="keyword">const</span> <span class="keywordtype">string</span> &amp;base(*it);
169
+ <a name="l00145"></a>00145 <span class="keywordflow">if</span> ( base == <span class="stringliteral">&quot;/&quot;</span>
170
+ <a name="l00146"></a>00146 || ( uri_len == base.size() &amp;&amp; memcmp(uri, base.c_str(), uri_len) == 0 )
171
+ <a name="l00147"></a>00147 || ( uri_len &gt; base.size() &amp;&amp; memcmp(uri, base.c_str(), base.size()) == 0
172
+ <a name="l00148"></a>00148 &amp;&amp; uri[base.size()] == <span class="charliteral">&#39;/&#39;</span> )
173
+ <a name="l00149"></a>00149 ) {
174
+ <a name="l00150"></a>00150 baseURIKnown = <span class="keyword">true</span>;
175
+ <a name="l00151"></a>00151 baseURI = base.c_str();
176
+ <a name="l00152"></a>00152 appType = RAILS;
177
+ <a name="l00153"></a>00153 <span class="keywordflow">return</span> baseURI;
178
+ <a name="l00154"></a>00154 }
179
+ <a name="l00155"></a>00155 }
180
+ <a name="l00156"></a>00156
181
+ <a name="l00157"></a>00157 UPDATE_TRACE_POINT();
182
+ <a name="l00158"></a>00158 <span class="keywordflow">for</span> (it = config-&gt;rackBaseURIs.begin(); it != config-&gt;rackBaseURIs.end(); it++) {
183
+ <a name="l00159"></a>00159 <span class="keyword">const</span> <span class="keywordtype">string</span> &amp;base(*it);
184
+ <a name="l00160"></a>00160 <span class="keywordflow">if</span> ( base == <span class="stringliteral">&quot;/&quot;</span>
185
+ <a name="l00161"></a>00161 || ( uri_len == base.size() &amp;&amp; memcmp(uri, base.c_str(), uri_len) == 0 )
186
+ <a name="l00162"></a>00162 || ( uri_len &gt; base.size() &amp;&amp; memcmp(uri, base.c_str(), base.size()) == 0
187
+ <a name="l00163"></a>00163 &amp;&amp; uri[base.size()] == <span class="charliteral">&#39;/&#39;</span> )
188
+ <a name="l00164"></a>00164 ) {
189
+ <a name="l00165"></a>00165 baseURIKnown = <span class="keyword">true</span>;
190
+ <a name="l00166"></a>00166 baseURI = base.c_str();
191
+ <a name="l00167"></a>00167 appType = RACK;
192
+ <a name="l00168"></a>00168 <span class="keywordflow">return</span> baseURI;
193
+ <a name="l00169"></a>00169 }
194
+ <a name="l00170"></a>00170 }
195
+ <a name="l00171"></a>00171
196
+ <a name="l00172"></a>00172 UPDATE_TRACE_POINT();
197
+ <a name="l00173"></a>00173 <span class="keywordflow">if</span> (shouldAutoDetectRack()
198
+ <a name="l00174"></a>00174 &amp;&amp; verifyRackDir(config-&gt;getAppRoot(ap_document_root(r)), cstat, throttleRate)) {
199
+ <a name="l00175"></a>00175 baseURIKnown = <span class="keyword">true</span>;
200
+ <a name="l00176"></a>00176 baseURI = <span class="stringliteral">&quot;/&quot;</span>;
201
+ <a name="l00177"></a>00177 appType = RACK;
202
+ <a name="l00178"></a>00178 <span class="keywordflow">return</span> baseURI;
203
+ <a name="l00179"></a>00179 }
204
+ <a name="l00180"></a>00180
205
+ <a name="l00181"></a>00181 UPDATE_TRACE_POINT();
206
+ <a name="l00182"></a>00182 <span class="keywordflow">if</span> (shouldAutoDetectRails()
207
+ <a name="l00183"></a>00183 &amp;&amp; verifyRailsDir(config-&gt;getAppRoot(ap_document_root(r)), cstat, throttleRate)) {
208
+ <a name="l00184"></a>00184 baseURIKnown = <span class="keyword">true</span>;
209
+ <a name="l00185"></a>00185 baseURI = <span class="stringliteral">&quot;/&quot;</span>;
210
+ <a name="l00186"></a>00186 appType = RAILS;
211
+ <a name="l00187"></a>00187 <span class="keywordflow">return</span> baseURI;
212
+ <a name="l00188"></a>00188 }
213
+ <a name="l00189"></a>00189
214
+ <a name="l00190"></a>00190 UPDATE_TRACE_POINT();
215
+ <a name="l00191"></a>00191 <span class="keywordflow">if</span> (shouldAutoDetectWSGI()
216
+ <a name="l00192"></a>00192 &amp;&amp; verifyWSGIDir(config-&gt;getAppRoot(ap_document_root(r)), cstat, throttleRate)) {
217
+ <a name="l00193"></a>00193 baseURIKnown = <span class="keyword">true</span>;
218
+ <a name="l00194"></a>00194 baseURI = <span class="stringliteral">&quot;/&quot;</span>;
219
+ <a name="l00195"></a>00195 appType = WSGI;
220
+ <a name="l00196"></a>00196 <span class="keywordflow">return</span> baseURI;
221
+ <a name="l00197"></a>00197 }
222
+ <a name="l00198"></a>00198
223
+ <a name="l00199"></a>00199 baseURIKnown = <span class="keyword">true</span>;
224
+ <a name="l00200"></a>00200 <span class="keywordflow">return</span> NULL;
225
+ <a name="l00201"></a>00201 }
226
+ <a name="l00202"></a>00202 <span class="comment"></span>
227
+ <a name="l00203"></a>00203 <span class="comment"> /**</span>
228
+ <a name="l00204"></a>00204 <span class="comment"> * Returns the filename of the &#39;public&#39; directory of the Rails/Rack application</span>
229
+ <a name="l00205"></a>00205 <span class="comment"> * that&#39;s associated with the HTTP request.</span>
230
+ <a name="l00206"></a>00206 <span class="comment"> *</span>
231
+ <a name="l00207"></a>00207 <span class="comment"> * Returns an empty string if the document root of the HTTP request</span>
232
+ <a name="l00208"></a>00208 <span class="comment"> * cannot be determined, or if it isn&#39;t a valid folder.</span>
233
+ <a name="l00209"></a>00209 <span class="comment"> *</span>
234
+ <a name="l00210"></a>00210 <span class="comment"> * @throws FileSystemException An error occured while examening the filesystem.</span>
235
+ <a name="l00211"></a>00211 <span class="comment"> */</span>
236
+ <a name="l00212"></a><a class="code" href="classPassenger_1_1DirectoryMapper.html#aef969f27622fb215990a870076648aa1">00212</a> <span class="keywordtype">string</span> <a class="code" href="classPassenger_1_1DirectoryMapper.html#aef969f27622fb215990a870076648aa1" title="Returns the filename of the &amp;#39;public&amp;#39; directory of the Rails/Rack application...">getPublicDirectory</a>() {
237
+ <a name="l00213"></a>00213 <span class="keywordflow">if</span> (!baseURIKnown) {
238
+ <a name="l00214"></a>00214 <a class="code" href="classPassenger_1_1DirectoryMapper.html#a2da887c077fc2460dea204783470e821" title="Determine whether the given HTTP request falls under one of the specified RailsBaseURIs...">getBaseURI</a>();
239
+ <a name="l00215"></a>00215 }
240
+ <a name="l00216"></a>00216 <span class="keywordflow">if</span> (baseURI == NULL) {
241
+ <a name="l00217"></a>00217 <span class="keywordflow">return</span> <span class="stringliteral">&quot;&quot;</span>;
242
+ <a name="l00218"></a>00218 }
243
+ <a name="l00219"></a>00219
244
+ <a name="l00220"></a>00220 <span class="keyword">const</span> <span class="keywordtype">char</span> *docRoot = ap_document_root(r);
245
+ <a name="l00221"></a>00221 <span class="keywordtype">size_t</span> len = strlen(docRoot);
246
+ <a name="l00222"></a>00222 <span class="keywordflow">if</span> (len &gt; 0) {
247
+ <a name="l00223"></a>00223 <span class="keywordtype">string</span> path;
248
+ <a name="l00224"></a>00224 <span class="keywordflow">if</span> (docRoot[len - 1] == <span class="charliteral">&#39;/&#39;</span>) {
249
+ <a name="l00225"></a>00225 path.assign(docRoot, len - 1);
250
+ <a name="l00226"></a>00226 } <span class="keywordflow">else</span> {
251
+ <a name="l00227"></a>00227 path.assign(docRoot, len);
252
+ <a name="l00228"></a>00228 }
253
+ <a name="l00229"></a>00229 <span class="keywordflow">if</span> (strcmp(baseURI, <span class="stringliteral">&quot;/&quot;</span>) != 0) {
254
+ <a name="l00230"></a>00230 <span class="comment">/* Application is deployed in a sub-URI.</span>
255
+ <a name="l00231"></a>00231 <span class="comment"> * This is probably a symlink, so let&#39;s resolve it.</span>
256
+ <a name="l00232"></a>00232 <span class="comment"> */</span>
257
+ <a name="l00233"></a>00233 path.append(baseURI);
258
+ <a name="l00234"></a>00234 path = resolveSymlink(path);
259
+ <a name="l00235"></a>00235 }
260
+ <a name="l00236"></a>00236 <span class="keywordflow">return</span> path;
261
+ <a name="l00237"></a>00237 } <span class="keywordflow">else</span> {
262
+ <a name="l00238"></a>00238 <span class="keywordflow">return</span> <span class="stringliteral">&quot;&quot;</span>;
263
+ <a name="l00239"></a>00239 }
264
+ <a name="l00240"></a>00240 }
265
+ <a name="l00241"></a>00241 <span class="comment"></span>
266
+ <a name="l00242"></a>00242 <span class="comment"> /**</span>
267
+ <a name="l00243"></a>00243 <span class="comment"> * Returns the application type that&#39;s associated with the HTTP request.</span>
268
+ <a name="l00244"></a>00244 <span class="comment"> *</span>
269
+ <a name="l00245"></a>00245 <span class="comment"> * @throws FileSystemException An error occured while examening the filesystem.</span>
270
+ <a name="l00246"></a>00246 <span class="comment"> */</span>
271
+ <a name="l00247"></a><a class="code" href="classPassenger_1_1DirectoryMapper.html#aba438d86ca263972a47540956bf11ec1">00247</a> ApplicationType <a class="code" href="classPassenger_1_1DirectoryMapper.html#aba438d86ca263972a47540956bf11ec1" title="Returns the application type that&amp;#39;s associated with the HTTP request.">getApplicationType</a>() {
272
+ <a name="l00248"></a>00248 <span class="keywordflow">if</span> (!baseURIKnown) {
273
+ <a name="l00249"></a>00249 <a class="code" href="classPassenger_1_1DirectoryMapper.html#a2da887c077fc2460dea204783470e821" title="Determine whether the given HTTP request falls under one of the specified RailsBaseURIs...">getBaseURI</a>();
274
+ <a name="l00250"></a>00250 }
275
+ <a name="l00251"></a>00251 <span class="keywordflow">return</span> appType;
276
+ <a name="l00252"></a>00252 }
277
+ <a name="l00253"></a>00253 <span class="comment"></span>
278
+ <a name="l00254"></a>00254 <span class="comment"> /**</span>
279
+ <a name="l00255"></a>00255 <span class="comment"> * Returns the application type (as a string) that&#39;s associated</span>
280
+ <a name="l00256"></a>00256 <span class="comment"> * with the HTTP request.</span>
281
+ <a name="l00257"></a>00257 <span class="comment"> *</span>
282
+ <a name="l00258"></a>00258 <span class="comment"> * @throws FileSystemException An error occured while examening the filesystem.</span>
283
+ <a name="l00259"></a>00259 <span class="comment"> */</span>
284
+ <a name="l00260"></a><a class="code" href="classPassenger_1_1DirectoryMapper.html#ac46f0e74ffd05b7fe9924dd99a057cf7">00260</a> <span class="keyword">const</span> <span class="keywordtype">char</span> *<a class="code" href="classPassenger_1_1DirectoryMapper.html#ac46f0e74ffd05b7fe9924dd99a057cf7" title="Returns the application type (as a string) that&amp;#39;s associated with the HTTP request...">getApplicationTypeString</a>() {
285
+ <a name="l00261"></a>00261 <span class="keywordflow">if</span> (!baseURIKnown) {
286
+ <a name="l00262"></a>00262 <a class="code" href="classPassenger_1_1DirectoryMapper.html#a2da887c077fc2460dea204783470e821" title="Determine whether the given HTTP request falls under one of the specified RailsBaseURIs...">getBaseURI</a>();
287
+ <a name="l00263"></a>00263 }
288
+ <a name="l00264"></a>00264 <span class="keywordflow">switch</span> (appType) {
289
+ <a name="l00265"></a>00265 <span class="keywordflow">case</span> RAILS:
290
+ <a name="l00266"></a>00266 <span class="keywordflow">return</span> <span class="stringliteral">&quot;rails&quot;</span>;
291
+ <a name="l00267"></a>00267 <span class="keywordflow">case</span> RACK:
292
+ <a name="l00268"></a>00268 <span class="keywordflow">return</span> <span class="stringliteral">&quot;rack&quot;</span>;
293
+ <a name="l00269"></a>00269 <span class="keywordflow">case</span> WSGI:
294
+ <a name="l00270"></a>00270 <span class="keywordflow">return</span> <span class="stringliteral">&quot;wsgi&quot;</span>;
295
+ <a name="l00271"></a>00271 <span class="keywordflow">default</span>:
296
+ <a name="l00272"></a>00272 <span class="keywordflow">return</span> NULL;
297
+ <a name="l00273"></a>00273 };
298
+ <a name="l00274"></a>00274 }
299
+ <a name="l00275"></a>00275 <span class="comment"></span>
300
+ <a name="l00276"></a>00276 <span class="comment"> /**</span>
301
+ <a name="l00277"></a>00277 <span class="comment"> * Returns the environment under which the application should be spawned.</span>
302
+ <a name="l00278"></a>00278 <span class="comment"> *</span>
303
+ <a name="l00279"></a>00279 <span class="comment"> * @throws FileSystemException An error occured while examening the filesystem.</span>
304
+ <a name="l00280"></a>00280 <span class="comment"> */</span>
305
+ <a name="l00281"></a><a class="code" href="classPassenger_1_1DirectoryMapper.html#af5091e3cef3878e160e5d3b2181d82fb">00281</a> <span class="keyword">const</span> <span class="keywordtype">char</span> *<a class="code" href="classPassenger_1_1DirectoryMapper.html#af5091e3cef3878e160e5d3b2181d82fb" title="Returns the environment under which the application should be spawned.">getEnvironment</a>() {
306
+ <a name="l00282"></a>00282 <span class="keywordflow">switch</span> (<a class="code" href="classPassenger_1_1DirectoryMapper.html#aba438d86ca263972a47540956bf11ec1" title="Returns the application type that&amp;#39;s associated with the HTTP request.">getApplicationType</a>()) {
307
+ <a name="l00283"></a>00283 <span class="keywordflow">case</span> RAILS:
308
+ <a name="l00284"></a>00284 <span class="keywordflow">return</span> config-&gt;getRailsEnv();
309
+ <a name="l00285"></a>00285 <span class="keywordflow">case</span> RACK:
310
+ <a name="l00286"></a>00286 <span class="keywordflow">return</span> config-&gt;getRackEnv();
311
+ <a name="l00287"></a>00287 <span class="keywordflow">default</span>:
312
+ <a name="l00288"></a>00288 <span class="keywordflow">return</span> <span class="stringliteral">&quot;production&quot;</span>;
313
+ <a name="l00289"></a>00289 }
314
+ <a name="l00290"></a>00290 }
315
+ <a name="l00291"></a>00291 };
316
+ <a name="l00292"></a>00292
317
+ <a name="l00293"></a>00293 } <span class="comment">// namespace Passenger</span>
318
+ <a name="l00294"></a>00294
319
+ <a name="l00295"></a>00295 <span class="preprocessor">#endif </span><span class="comment">/* _PASSENGER_DIRECTORY_MAPPER_H_ */</span>
320
+ <a name="l00296"></a>00296
321
+ </pre></div></div>
322
+ <hr size="1"/><address style="text-align: right;"><small>Generated by&nbsp;
323
+ <a href="http://www.doxygen.org/index.html">
324
+ <img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.6.2 </small></address>
325
+ </body>
326
+ </html>
@@ -0,0 +1,75 @@
1
+ <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
2
+ <html xmlns="http://www.w3.org/1999/xhtml">
3
+ <head>
4
+ <meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
5
+ <title>Passenger: Hooks.h Source File</title>
6
+ <link href="tabs.css" rel="stylesheet" type="text/css"/>
7
+ <link href="doxygen.css" rel="stylesheet" type="text/css"/>
8
+ </head>
9
+ <body>
10
+ <!-- Generated by Doxygen 1.6.2 -->
11
+ <div class="navigation" id="top">
12
+ <div class="tabs">
13
+ <ul>
14
+ <li><a href="main.html"><span>Main&nbsp;Page</span></a></li>
15
+ <li><a href="modules.html"><span>Modules</span></a></li>
16
+ <li><a href="annotated.html"><span>Classes</span></a></li>
17
+ <li class="current"><a href="files.html"><span>Files</span></a></li>
18
+ </ul>
19
+ </div>
20
+ <div class="tabs">
21
+ <ul>
22
+ <li><a href="files.html"><span>File&nbsp;List</span></a></li>
23
+ </ul>
24
+ </div>
25
+ <h1>Hooks.h</h1><div class="fragment"><pre class="fragment"><a name="l00001"></a>00001 <span class="comment">/*</span>
26
+ <a name="l00002"></a>00002 <span class="comment"> * Phusion Passenger - http://www.modrails.com/</span>
27
+ <a name="l00003"></a>00003 <span class="comment"> * Copyright (c) 2008, 2009 Phusion</span>
28
+ <a name="l00004"></a>00004 <span class="comment"> *</span>
29
+ <a name="l00005"></a>00005 <span class="comment"> * &quot;Phusion Passenger&quot; is a trademark of Hongli Lai &amp; Ninh Bui.</span>
30
+ <a name="l00006"></a>00006 <span class="comment"> *</span>
31
+ <a name="l00007"></a>00007 <span class="comment"> * Permission is hereby granted, free of charge, to any person obtaining a copy</span>
32
+ <a name="l00008"></a>00008 <span class="comment"> * of this software and associated documentation files (the &quot;Software&quot;), to deal</span>
33
+ <a name="l00009"></a>00009 <span class="comment"> * in the Software without restriction, including without limitation the rights</span>
34
+ <a name="l00010"></a>00010 <span class="comment"> * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell</span>
35
+ <a name="l00011"></a>00011 <span class="comment"> * copies of the Software, and to permit persons to whom the Software is</span>
36
+ <a name="l00012"></a>00012 <span class="comment"> * furnished to do so, subject to the following conditions:</span>
37
+ <a name="l00013"></a>00013 <span class="comment"> *</span>
38
+ <a name="l00014"></a>00014 <span class="comment"> * The above copyright notice and this permission notice shall be included in</span>
39
+ <a name="l00015"></a>00015 <span class="comment"> * all copies or substantial portions of the Software.</span>
40
+ <a name="l00016"></a>00016 <span class="comment"> *</span>
41
+ <a name="l00017"></a>00017 <span class="comment"> * THE SOFTWARE IS PROVIDED &quot;AS IS&quot;, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR</span>
42
+ <a name="l00018"></a>00018 <span class="comment"> * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,</span>
43
+ <a name="l00019"></a>00019 <span class="comment"> * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE</span>
44
+ <a name="l00020"></a>00020 <span class="comment"> * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER</span>
45
+ <a name="l00021"></a>00021 <span class="comment"> * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,</span>
46
+ <a name="l00022"></a>00022 <span class="comment"> * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN</span>
47
+ <a name="l00023"></a>00023 <span class="comment"> * THE SOFTWARE.</span>
48
+ <a name="l00024"></a>00024 <span class="comment"> */</span>
49
+ <a name="l00025"></a>00025 <span class="preprocessor">#ifndef _PASSENGER_HOOKS_H_</span>
50
+ <a name="l00026"></a>00026 <span class="preprocessor"></span><span class="preprocessor">#define _PASSENGER_HOOKS_H_</span>
51
+ <a name="l00027"></a>00027 <span class="preprocessor"></span>
52
+ <a name="l00028"></a>00028 <span class="preprocessor">#include &lt;apr_pools.h&gt;</span>
53
+ <a name="l00029"></a>00029
54
+ <a name="l00030"></a>00030 <span class="preprocessor">#ifdef __cplusplus</span>
55
+ <a name="l00031"></a>00031 <span class="preprocessor"></span><span class="keyword">extern</span> <span class="stringliteral">&quot;C&quot;</span> {
56
+ <a name="l00032"></a>00032 <span class="preprocessor">#endif</span>
57
+ <a name="l00033"></a>00033 <span class="preprocessor"></span><span class="comment"></span>
58
+ <a name="l00034"></a>00034 <span class="comment">/**</span>
59
+ <a name="l00035"></a>00035 <span class="comment"> * @defgroup Hooks Apache hooks</span>
60
+ <a name="l00036"></a>00036 <span class="comment"> * @ingroup Core</span>
61
+ <a name="l00037"></a>00037 <span class="comment"> */</span>
62
+ <a name="l00038"></a>00038
63
+ <a name="l00039"></a>00039 <span class="keyword">extern</span> <span class="keywordtype">void</span> passenger_register_hooks(apr_pool_t *p);
64
+ <a name="l00040"></a>00040
65
+ <a name="l00041"></a>00041 <span class="preprocessor">#ifdef __cplusplus</span>
66
+ <a name="l00042"></a>00042 <span class="preprocessor"></span>}
67
+ <a name="l00043"></a>00043 <span class="preprocessor">#endif</span>
68
+ <a name="l00044"></a>00044 <span class="preprocessor"></span>
69
+ <a name="l00045"></a>00045 <span class="preprocessor">#endif </span><span class="comment">/* _PASSENGER_HOOKS_H_ */</span>
70
+ </pre></div></div>
71
+ <hr size="1"/><address style="text-align: right;"><small>Generated by&nbsp;
72
+ <a href="http://www.doxygen.org/index.html">
73
+ <img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.6.2 </small></address>
74
+ </body>
75
+ </html>
@@ -0,0 +1,35 @@
1
+ <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
2
+ <html xmlns="http://www.w3.org/1999/xhtml">
3
+ <head>
4
+ <meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
5
+ <title>Passenger: definitions.h Source File</title>
6
+ <link href="tabs.css" rel="stylesheet" type="text/css"/>
7
+ <link href="doxygen.css" rel="stylesheet" type="text/css"/>
8
+ </head>
9
+ <body>
10
+ <!-- Generated by Doxygen 1.6.2 -->
11
+ <div class="navigation" id="top">
12
+ <div class="tabs">
13
+ <ul>
14
+ <li><a href="main.html"><span>Main&nbsp;Page</span></a></li>
15
+ <li><a href="modules.html"><span>Modules</span></a></li>
16
+ <li><a href="annotated.html"><span>Classes</span></a></li>
17
+ <li class="current"><a href="files.html"><span>Files</span></a></li>
18
+ </ul>
19
+ </div>
20
+ <div class="tabs">
21
+ <ul>
22
+ <li><a href="files.html"><span>File&nbsp;List</span></a></li>
23
+ </ul>
24
+ </div>
25
+ <h1>definitions.h</h1><div class="fragment"><pre class="fragment"><a name="l00001"></a>00001 <span class="comment">// Some definitions for Doxygen.</span><span class="comment"></span>
26
+ <a name="l00002"></a>00002 <span class="comment">/**</span>
27
+ <a name="l00003"></a>00003 <span class="comment">@defgroup Core Core Apache-related classes and functions</span>
28
+ <a name="l00004"></a>00004 <span class="comment">@defgroup Support Apache-independent support classes and function</span>
29
+ <a name="l00005"></a>00005 <span class="comment">*/</span>
30
+ </pre></div></div>
31
+ <hr size="1"/><address style="text-align: right;"><small>Generated by&nbsp;
32
+ <a href="http://www.doxygen.org/index.html">
33
+ <img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.6.2 </small></address>
34
+ </body>
35
+ </html>
@@ -0,0 +1,3 @@
1
+ <map id="structs" name="structs">
2
+ <area shape="rect" id="node1" href="$group__Core.html" title="Core Apache&#45;related classes and functions" alt="" coords="5,5,315,35"/>
3
+ </map>
@@ -0,0 +1,4 @@
1
+ <map id="structs" name="structs">
2
+ <area shape="rect" id="node2" href="$group__Hooks.html" title="Apache hooks" alt="" coords="415,5,527,35"/>
3
+ <area shape="rect" id="node3" href="$group__Configuration.html" title="Apache module configuration" alt="" coords="363,59,579,88"/>
4
+ </map>