File: Process_8h-source.html

package info (click to toggle)
passenger 2.2.11debian-2
  • links: PTS, VCS
  • area: main
  • in suites: squeeze
  • size: 11,576 kB
  • ctags: 28,138
  • sloc: cpp: 66,323; ruby: 9,646; ansic: 2,425; python: 141; sh: 56; makefile: 29
file content (272 lines) | stat: -rw-r--r-- 27,031 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
<!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: Process.h Source File</title>
<link href="tabs.css" rel="stylesheet" type="text/css">
<link href="doxygen.css" rel="stylesheet" type="text/css">
</head><body>
<!-- Generated by Doxygen 1.5.8 -->
<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="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>
  </div>
  <div class="tabs">
    <ul>
      <li><a href="files.html"><span>File&nbsp;List</span></a></li>
    </ul>
  </div>
<h1>Process.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) 2010 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"> *  Permission is hereby granted, free of charge, to any person obtaining a copy</span>
<a name="l00008"></a>00008 <span class="comment"> *  of this software and associated documentation files (the "Software"), to deal</span>
<a name="l00009"></a>00009 <span class="comment"> *  in the Software without restriction, including without limitation the rights</span>
<a name="l00010"></a>00010 <span class="comment"> *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell</span>
<a name="l00011"></a>00011 <span class="comment"> *  copies of the Software, and to permit persons to whom the Software is</span>
<a name="l00012"></a>00012 <span class="comment"> *  furnished to do so, subject to the following conditions:</span>
<a name="l00013"></a>00013 <span class="comment"> *</span>
<a name="l00014"></a>00014 <span class="comment"> *  The above copyright notice and this permission notice shall be included in</span>
<a name="l00015"></a>00015 <span class="comment"> *  all copies or substantial portions of the Software.</span>
<a name="l00016"></a>00016 <span class="comment"> *</span>
<a name="l00017"></a>00017 <span class="comment"> *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR</span>
<a name="l00018"></a>00018 <span class="comment"> *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,</span>
<a name="l00019"></a>00019 <span class="comment"> *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE</span>
<a name="l00020"></a>00020 <span class="comment"> *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER</span>
<a name="l00021"></a>00021 <span class="comment"> *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,</span>
<a name="l00022"></a>00022 <span class="comment"> *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN</span>
<a name="l00023"></a>00023 <span class="comment"> *  THE SOFTWARE.</span>
<a name="l00024"></a>00024 <span class="comment"> */</span>
<a name="l00025"></a>00025 <span class="preprocessor">#ifndef _PASSENGER_PROCESS_H_</span>
<a name="l00026"></a>00026 <span class="preprocessor"></span><span class="preprocessor">#define _PASSENGER_PROCESS_H_</span>
<a name="l00027"></a>00027 <span class="preprocessor"></span>
<a name="l00028"></a>00028 <span class="preprocessor">#include &lt;boost/shared_ptr.hpp&gt;</span>
<a name="l00029"></a>00029 <span class="preprocessor">#include &lt;boost/function.hpp&gt;</span>
<a name="l00030"></a>00030 <span class="preprocessor">#include &lt;oxt/system_calls.hpp&gt;</span>
<a name="l00031"></a>00031 <span class="preprocessor">#include &lt;oxt/backtrace.hpp&gt;</span>
<a name="l00032"></a>00032 <span class="preprocessor">#include &lt;string&gt;</span>
<a name="l00033"></a>00033 <span class="preprocessor">#include &lt;map&gt;</span>
<a name="l00034"></a>00034 
<a name="l00035"></a>00035 <span class="preprocessor">#include &lt;sys/types.h&gt;</span>
<a name="l00036"></a>00036 <span class="preprocessor">#include &lt;unistd.h&gt;</span>
<a name="l00037"></a>00037 <span class="preprocessor">#include &lt;errno.h&gt;</span>
<a name="l00038"></a>00038 
<a name="l00039"></a>00039 <span class="preprocessor">#include "Session.h"</span>
<a name="l00040"></a>00040 <span class="preprocessor">#include "MessageChannel.h"</span>
<a name="l00041"></a>00041 <span class="preprocessor">#include "Exceptions.h"</span>
<a name="l00042"></a>00042 <span class="preprocessor">#include "Logging.h"</span>
<a name="l00043"></a>00043 <span class="preprocessor">#include "Utils.h"</span>
<a name="l00044"></a>00044 
<a name="l00045"></a>00045 <span class="keyword">namespace </span>Passenger {
<a name="l00046"></a>00046 
<a name="l00047"></a>00047 <span class="keyword">using namespace </span>std;
<a name="l00048"></a>00048 <span class="keyword">using namespace </span>boost;
<a name="l00049"></a>00049 <span class="comment"></span>
<a name="l00050"></a>00050 <span class="comment">/**</span>
<a name="l00051"></a>00051 <span class="comment"> * Represents a single application process, as spawned by SpawnManager</span>
<a name="l00052"></a>00052 <span class="comment"> * or by ApplicationPool::Interface::get().</span>
<a name="l00053"></a>00053 <span class="comment"> *</span>
<a name="l00054"></a>00054 <span class="comment"> * @ingroup Support</span>
<a name="l00055"></a>00055 <span class="comment"> */</span>
<a name="l00056"></a><a class="code" href="classPassenger_1_1Process.html">00056</a> <span class="keyword">class </span><a class="code" href="classPassenger_1_1Process.html" title="Represents a single application process, as spawned by SpawnManager or by ApplicationPool::Interface...">Process</a> {
<a name="l00057"></a>00057 <span class="keyword">public</span>:
<a name="l00058"></a>00058         <span class="keyword">struct </span>SocketInfo {
<a name="l00059"></a>00059                 <span class="keywordtype">string</span> address;
<a name="l00060"></a>00060                 <span class="keywordtype">string</span> type;
<a name="l00061"></a>00061                 
<a name="l00062"></a>00062                 SocketInfo() {}
<a name="l00063"></a>00063                 
<a name="l00064"></a>00064                 SocketInfo(<span class="keyword">const</span> <span class="keywordtype">string</span> &amp;address, <span class="keyword">const</span> <span class="keywordtype">string</span> &amp;type) {
<a name="l00065"></a>00065                         this-&gt;address = address;
<a name="l00066"></a>00066                         this-&gt;type    = type;
<a name="l00067"></a>00067                 }
<a name="l00068"></a>00068         };
<a name="l00069"></a>00069         
<a name="l00070"></a>00070         <span class="keyword">typedef</span> map&lt;string, SocketInfo&gt; SocketInfoMap;
<a name="l00071"></a>00071         
<a name="l00072"></a>00072 <span class="keyword">private</span>:
<a name="l00073"></a>00073         <span class="keywordtype">string</span> appRoot;
<a name="l00074"></a>00074         pid_t pid;
<a name="l00075"></a>00075         <span class="keywordtype">int</span> ownerPipe;
<a name="l00076"></a>00076         <span class="keywordtype">string</span> detachKey;
<a name="l00077"></a>00077         <span class="keywordtype">string</span> connectPassword;
<a name="l00078"></a>00078         SocketInfoMap serverSockets;
<a name="l00079"></a>00079         SocketInfo *mainServerSocket;
<a name="l00080"></a>00080         function&lt;void ()&gt; destructionCallback;
<a name="l00081"></a>00081         
<a name="l00082"></a>00082 <span class="keyword">public</span>:<span class="comment"></span>
<a name="l00083"></a>00083 <span class="comment">        /**</span>
<a name="l00084"></a>00084 <span class="comment">         * Construct a new Process object.</span>
<a name="l00085"></a>00085 <span class="comment">         *</span>
<a name="l00086"></a>00086 <span class="comment">         * @param appRoot The application root of an application.</span>
<a name="l00087"></a>00087 <span class="comment">         *             This must be a valid directory, but the path does not have to be absolute.</span>
<a name="l00088"></a>00088 <span class="comment">         * @param pid The process ID of this application process.</span>
<a name="l00089"></a>00089 <span class="comment">         * @param ownerPipe The owner pipe of this application process.</span>
<a name="l00090"></a>00090 <span class="comment">         * @param serverSockets All the server sockets that this process listens on.</span>
<a name="l00091"></a>00091 <span class="comment">         *                      There must a server socket with the name 'main'.</span>
<a name="l00092"></a>00092 <span class="comment">         * @param detachKey A detach key. Used by the ApplicationPool algorithm.</span>
<a name="l00093"></a>00093 <span class="comment">         * @param connectPassword The password to use when connecting to this process.</span>
<a name="l00094"></a>00094 <span class="comment">         *                        Must be valid ASCII.</span>
<a name="l00095"></a>00095 <span class="comment">         * @param destructionCallback A callback to be called when this Process is destroyed.</span>
<a name="l00096"></a>00096 <span class="comment">         * @throws ArgumentException If serverSockets has no socket named 'main'.</span>
<a name="l00097"></a>00097 <span class="comment">         */</span>
<a name="l00098"></a><a class="code" href="classPassenger_1_1Process.html#cbc73466ae557c68cf040fcce925096c">00098</a>         <a class="code" href="classPassenger_1_1Process.html#cbc73466ae557c68cf040fcce925096c" title="Construct a new Process object.">Process</a>(<span class="keyword">const</span> <span class="keywordtype">string</span> &amp;appRoot, pid_t pid, <span class="keywordtype">int</span> ownerPipe, <span class="keyword">const</span> SocketInfoMap &amp;serverSockets,
<a name="l00099"></a>00099                 <span class="keyword">const</span> <span class="keywordtype">string</span> &amp;detachKey, <span class="keyword">const</span> <span class="keywordtype">string</span> &amp;connectPassword,
<a name="l00100"></a>00100                 <span class="keyword">const</span> function&lt;<span class="keywordtype">void</span> ()&gt; &amp;destructionCallback = function&lt;<span class="keywordtype">void</span> ()&gt;())
<a name="l00101"></a>00101         {
<a name="l00102"></a>00102                 this-&gt;appRoot         = appRoot;
<a name="l00103"></a>00103                 this-&gt;pid             = pid;
<a name="l00104"></a>00104                 this-&gt;ownerPipe       = ownerPipe;
<a name="l00105"></a>00105                 this-&gt;serverSockets   = serverSockets;
<a name="l00106"></a>00106                 this-&gt;detachKey       = detachKey;
<a name="l00107"></a>00107                 this-&gt;connectPassword = connectPassword;
<a name="l00108"></a>00108                 this-&gt;destructionCallback = destructionCallback;
<a name="l00109"></a>00109                 <span class="keywordflow">if</span> (serverSockets.find(<span class="stringliteral">"main"</span>) == serverSockets.end()) {
<a name="l00110"></a>00110                         TRACE_POINT();
<a name="l00111"></a>00111                         <span class="keywordflow">throw</span> <a class="code" href="classPassenger_1_1ArgumentException.html" title="Indicates that a specified argument is incorrect or violates a requirement.">ArgumentException</a>(<span class="stringliteral">"There must be a server socket named 'main'."</span>);
<a name="l00112"></a>00112                 }
<a name="l00113"></a>00113                 mainServerSocket = &amp;this-&gt;serverSockets[<span class="stringliteral">"main"</span>];
<a name="l00114"></a>00114                 P_TRACE(3, <span class="stringliteral">"Application process "</span> &lt;&lt; <span class="keyword">this</span> &lt;&lt; <span class="stringliteral">": created."</span>);
<a name="l00115"></a>00115         }
<a name="l00116"></a>00116         
<a name="l00117"></a>00117         <span class="keyword">virtual</span> ~<a class="code" href="classPassenger_1_1Process.html" title="Represents a single application process, as spawned by SpawnManager or by ApplicationPool::Interface...">Process</a>() {
<a name="l00118"></a>00118                 TRACE_POINT();
<a name="l00119"></a>00119                 SocketInfoMap::const_iterator it;
<a name="l00120"></a>00120                 <span class="keywordtype">int</span> ret;
<a name="l00121"></a>00121                 
<a name="l00122"></a>00122                 <span class="keywordflow">if</span> (ownerPipe != -1) {
<a name="l00123"></a>00123                         <span class="keywordflow">do</span> {
<a name="l00124"></a>00124                                 ret = close(ownerPipe);
<a name="l00125"></a>00125                         } <span class="keywordflow">while</span> (ret == -1 &amp;&amp; errno == EINTR);
<a name="l00126"></a>00126                 }
<a name="l00127"></a>00127                 <span class="keywordflow">for</span> (it = serverSockets.begin(); it != serverSockets.end(); it++) {
<a name="l00128"></a>00128                         <span class="keyword">const</span> SocketInfo &amp;info = it-&gt;second;
<a name="l00129"></a>00129                         <span class="keywordflow">if</span> (info.type == <span class="stringliteral">"unix"</span>) {
<a name="l00130"></a>00130                                 <span class="keywordflow">do</span> {
<a name="l00131"></a>00131                                         ret = unlink(info.address.c_str());
<a name="l00132"></a>00132                                 } <span class="keywordflow">while</span> (ret == -1 &amp;&amp; errno == EINTR);
<a name="l00133"></a>00133                         }
<a name="l00134"></a>00134                 }
<a name="l00135"></a>00135                 P_TRACE(3, <span class="stringliteral">"Application process "</span> &lt;&lt; <span class="keyword">this</span> &lt;&lt; <span class="stringliteral">": destroyed."</span>);
<a name="l00136"></a>00136                 
<a name="l00137"></a>00137                 <span class="keywordflow">if</span> (destructionCallback) {
<a name="l00138"></a>00138                         destructionCallback();
<a name="l00139"></a>00139                 }
<a name="l00140"></a>00140         }
<a name="l00141"></a>00141         <span class="comment"></span>
<a name="l00142"></a>00142 <span class="comment">        /**</span>
<a name="l00143"></a>00143 <span class="comment">         * Returns the application root for this application process. See</span>
<a name="l00144"></a>00144 <span class="comment">         * the constructor for information about the application root.</span>
<a name="l00145"></a>00145 <span class="comment">         */</span>
<a name="l00146"></a><a class="code" href="classPassenger_1_1Process.html#ce9e949fa460ce09228cc08d76fc38e7">00146</a>         <span class="keywordtype">string</span> <a class="code" href="classPassenger_1_1Process.html#ce9e949fa460ce09228cc08d76fc38e7" title="Returns the application root for this application process.">getAppRoot</a>()<span class="keyword"> const </span>{
<a name="l00147"></a>00147                 <span class="keywordflow">return</span> appRoot;
<a name="l00148"></a>00148         }
<a name="l00149"></a>00149         <span class="comment"></span>
<a name="l00150"></a>00150 <span class="comment">        /**</span>
<a name="l00151"></a>00151 <span class="comment">         * Returns the process ID of this application process.</span>
<a name="l00152"></a>00152 <span class="comment">         */</span>
<a name="l00153"></a><a class="code" href="classPassenger_1_1Process.html#fc1b82c05e963fee7e58445b152ca784">00153</a>         pid_t <a class="code" href="classPassenger_1_1Process.html#fc1b82c05e963fee7e58445b152ca784" title="Returns the process ID of this application process.">getPid</a>()<span class="keyword"> const </span>{
<a name="l00154"></a>00154                 <span class="keywordflow">return</span> pid;
<a name="l00155"></a>00155         }
<a name="l00156"></a>00156         <span class="comment"></span>
<a name="l00157"></a>00157 <span class="comment">        /**</span>
<a name="l00158"></a>00158 <span class="comment">         * Returns this process's detach key.</span>
<a name="l00159"></a>00159 <span class="comment">         */</span>
<a name="l00160"></a><a class="code" href="classPassenger_1_1Process.html#308fa4c3bf80e4d3d48a3c833b9e3205">00160</a>         <span class="keywordtype">string</span> <a class="code" href="classPassenger_1_1Process.html#308fa4c3bf80e4d3d48a3c833b9e3205" title="Returns this process&amp;#39;s detach key.">getDetachKey</a>()<span class="keyword"> const </span>{
<a name="l00161"></a>00161                 <span class="keywordflow">return</span> detachKey;
<a name="l00162"></a>00162         }
<a name="l00163"></a>00163         <span class="comment"></span>
<a name="l00164"></a>00164 <span class="comment">        /**</span>
<a name="l00165"></a>00165 <span class="comment">         * Returns this process's connect password. This password is</span>
<a name="l00166"></a>00166 <span class="comment">         * guaranteed to be valid ASCII.</span>
<a name="l00167"></a>00167 <span class="comment">         */</span>
<a name="l00168"></a><a class="code" href="classPassenger_1_1Process.html#002791d7909d4d7a6566eb26ec491552">00168</a>         <span class="keywordtype">string</span> <a class="code" href="classPassenger_1_1Process.html#002791d7909d4d7a6566eb26ec491552" title="Returns this process&amp;#39;s connect password.">getConnectPassword</a>()<span class="keyword"> const </span>{
<a name="l00169"></a>00169                 <span class="keywordflow">return</span> connectPassword;
<a name="l00170"></a>00170         }
<a name="l00171"></a>00171         <span class="comment"></span>
<a name="l00172"></a>00172 <span class="comment">        /**</span>
<a name="l00173"></a>00173 <span class="comment">         * Returns a map containing all server sockets that this process</span>
<a name="l00174"></a>00174 <span class="comment">         * listens on.</span>
<a name="l00175"></a>00175 <span class="comment">         */</span>
<a name="l00176"></a><a class="code" href="classPassenger_1_1Process.html#fe06f5be540203452a5e787da15ee5e4">00176</a>         <span class="keyword">const</span> SocketInfoMap *<a class="code" href="classPassenger_1_1Process.html#fe06f5be540203452a5e787da15ee5e4" title="Returns a map containing all server sockets that this process listens on.">getServerSockets</a>()<span class="keyword"> const </span>{
<a name="l00177"></a>00177                 <span class="keywordflow">return</span> &amp;serverSockets;
<a name="l00178"></a>00178         }
<a name="l00179"></a>00179         <span class="comment"></span>
<a name="l00180"></a>00180 <span class="comment">        /**</span>
<a name="l00181"></a>00181 <span class="comment">         * Request a new session from this application process by connecting to its</span>
<a name="l00182"></a>00182 <span class="comment">         * main server socket. This session represents the life time of a single</span>
<a name="l00183"></a>00183 <span class="comment">         * request/response pair, and can be used to send the request data to the</span>
<a name="l00184"></a>00184 <span class="comment">         * application process, as well as receiving the response data.</span>
<a name="l00185"></a>00185 <span class="comment">         *</span>
<a name="l00186"></a>00186 <span class="comment">         * The use of connect() is demonstrated in the following example.</span>
<a name="l00187"></a>00187 <span class="comment">         * @code</span>
<a name="l00188"></a>00188 <span class="comment">         *   // Request a new session from the process.</span>
<a name="l00189"></a>00189 <span class="comment">         *   SessionPtr session = process-&gt;newSession(...);</span>
<a name="l00190"></a>00190 <span class="comment">         *   </span>
<a name="l00191"></a>00191 <span class="comment">         *   // Send the request headers and request body data.</span>
<a name="l00192"></a>00192 <span class="comment">         *   session-&gt;sendHeaders(...);</span>
<a name="l00193"></a>00193 <span class="comment">         *   session-&gt;sendBodyBlock(...);</span>
<a name="l00194"></a>00194 <span class="comment">         *   // Done sending data, so we close the writer channel.</span>
<a name="l00195"></a>00195 <span class="comment">         *   session-&gt;shutdownWriter();</span>
<a name="l00196"></a>00196 <span class="comment">         *</span>
<a name="l00197"></a>00197 <span class="comment">         *   // Now read the HTTP response.</span>
<a name="l00198"></a>00198 <span class="comment">         *   string responseData = readAllDataFromSocket(session-&gt;getReader());</span>
<a name="l00199"></a>00199 <span class="comment">         *   // Done reading data, so we close the reader channel.</span>
<a name="l00200"></a>00200 <span class="comment">         *   session-&gt;shutdownReader();</span>
<a name="l00201"></a>00201 <span class="comment">         *</span>
<a name="l00202"></a>00202 <span class="comment">         *   // This session has now finished, so we close the session by resetting</span>
<a name="l00203"></a>00203 <span class="comment">         *   // the smart pointer to NULL (thereby destroying the Session object).</span>
<a name="l00204"></a>00204 <span class="comment">         *   session.reset();</span>
<a name="l00205"></a>00205 <span class="comment">         *</span>
<a name="l00206"></a>00206 <span class="comment">         *   // We can connect to a Process multiple times. Just make sure</span>
<a name="l00207"></a>00207 <span class="comment">         *   // the previous session is closed.</span>
<a name="l00208"></a>00208 <span class="comment">         *   session = process-&gt;newSession(...);</span>
<a name="l00209"></a>00209 <span class="comment">         * @endcode</span>
<a name="l00210"></a>00210 <span class="comment">         *</span>
<a name="l00211"></a>00211 <span class="comment">         * You &lt;b&gt;must&lt;/b&gt; close a session when you no longer need it. If you</span>
<a name="l00212"></a>00212 <span class="comment">         * call connect() without having properly closed a previous session,</span>
<a name="l00213"></a>00213 <span class="comment">         * you might cause a deadlock because the application process may be</span>
<a name="l00214"></a>00214 <span class="comment">         * waiting for you to close the previous session.</span>
<a name="l00215"></a>00215 <span class="comment">         *</span>
<a name="l00216"></a>00216 <span class="comment">         * @param closeCallback A function which will be called when the session has been closed.</span>
<a name="l00217"></a>00217 <span class="comment">         * @param initiateNow Whether the session should be initiated immediately.</span>
<a name="l00218"></a>00218 <span class="comment">         *                    If set to false then you must call &lt;tt&gt;initiate()&lt;/tt&gt; on</span>
<a name="l00219"></a>00219 <span class="comment">         *                    the session before it's usable.</span>
<a name="l00220"></a>00220 <span class="comment">         * @return A smart pointer to a Session object, which represents the created session.</span>
<a name="l00221"></a>00221 <span class="comment">         * @post result-&gt;initiated() == initiateNow</span>
<a name="l00222"></a>00222 <span class="comment">         * @throws SystemException Something went wrong during session initiation.</span>
<a name="l00223"></a>00223 <span class="comment">         * @throws IOException Something went wrong during session initiation.</span>
<a name="l00224"></a>00224 <span class="comment">         * @throws boost::thread_interrupted</span>
<a name="l00225"></a>00225 <span class="comment">         */</span>
<a name="l00226"></a><a class="code" href="classPassenger_1_1Process.html#a5bd9ad8220bf64e5edf3d025004547a">00226</a>         SessionPtr <a class="code" href="classPassenger_1_1Process.html#a5bd9ad8220bf64e5edf3d025004547a" title="Request a new session from this application process by connecting to its main server...">newSession</a>(<span class="keyword">const</span> function&lt;<span class="keywordtype">void</span>()&gt; &amp;closeCallback = function&lt;<span class="keywordtype">void</span>()&gt;(),
<a name="l00227"></a>00227                               <span class="keywordtype">bool</span> initiateNow = <span class="keyword">true</span>)
<a name="l00228"></a>00228         {
<a name="l00229"></a>00229                 SessionPtr session(<span class="keyword">new</span> <a class="code" href="classPassenger_1_1StandardSession.html" title="A &amp;quot;standard&amp;quot; implementation of Session.">StandardSession</a>(pid, closeCallback,
<a name="l00230"></a>00230                         mainServerSocket-&gt;type, mainServerSocket-&gt;address,
<a name="l00231"></a>00231                         detachKey, connectPassword));
<a name="l00232"></a>00232                 <span class="keywordflow">if</span> (initiateNow) {
<a name="l00233"></a>00233                         session-&gt;initiate();
<a name="l00234"></a>00234                 }
<a name="l00235"></a>00235                 <span class="keywordflow">return</span> session;
<a name="l00236"></a>00236         }
<a name="l00237"></a>00237 };
<a name="l00238"></a>00238 <span class="comment"></span>
<a name="l00239"></a>00239 <span class="comment">/** Convenient alias for Process smart pointer. */</span>
<a name="l00240"></a><a class="code" href="namespacePassenger.html#ced1f248465136b313c6dec5fe6ca492">00240</a> <span class="keyword">typedef</span> shared_ptr&lt;Process&gt; <a class="code" href="namespacePassenger.html#ced1f248465136b313c6dec5fe6ca492" title="Convenient alias for Process smart pointer.">ProcessPtr</a>;
<a name="l00241"></a>00241 
<a name="l00242"></a>00242 } <span class="comment">// namespace Passenger</span>
<a name="l00243"></a>00243 
<a name="l00244"></a>00244 <span class="preprocessor">#endif </span><span class="comment">/* _PASSENGER_PROCESS_H_ */</span>
</pre></div></div>
<hr size="1"><address style="text-align: right;"><small>Generated on Sun Feb 21 12:22:46 2010 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.8 </small></address>
</body>
</html>