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
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
|
<!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: SpawnManager.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 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 List</span></a></li>
</ul>
</div>
<h1>SpawnManager.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 & 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_SPAWN_MANAGER_H_</span>
<a name="l00026"></a>00026 <span class="preprocessor"></span><span class="preprocessor">#define _PASSENGER_SPAWN_MANAGER_H_</span>
<a name="l00027"></a>00027 <span class="preprocessor"></span>
<a name="l00028"></a>00028 <span class="preprocessor">#include <string></span>
<a name="l00029"></a>00029 <span class="preprocessor">#include <vector></span>
<a name="l00030"></a>00030 <span class="preprocessor">#include <boost/shared_ptr.hpp></span>
<a name="l00031"></a>00031 <span class="preprocessor">#include <boost/thread.hpp></span>
<a name="l00032"></a>00032 <span class="preprocessor">#include <boost/function.hpp></span>
<a name="l00033"></a>00033 <span class="preprocessor">#include <oxt/system_calls.hpp></span>
<a name="l00034"></a>00034 <span class="preprocessor">#include <oxt/backtrace.hpp></span>
<a name="l00035"></a>00035
<a name="l00036"></a>00036 <span class="preprocessor">#include <sys/types.h></span>
<a name="l00037"></a>00037 <span class="preprocessor">#include <sys/wait.h></span>
<a name="l00038"></a>00038 <span class="preprocessor">#include <sys/stat.h></span>
<a name="l00039"></a>00039 <span class="preprocessor">#include <arpa/inet.h></span>
<a name="l00040"></a>00040 <span class="preprocessor">#include <cstdio></span>
<a name="l00041"></a>00041 <span class="preprocessor">#include <cstdarg></span>
<a name="l00042"></a>00042 <span class="preprocessor">#include <unistd.h></span>
<a name="l00043"></a>00043 <span class="preprocessor">#include <errno.h></span>
<a name="l00044"></a>00044 <span class="preprocessor">#include <grp.h></span>
<a name="l00045"></a>00045 <span class="preprocessor">#include <pwd.h></span>
<a name="l00046"></a>00046 <span class="preprocessor">#include <signal.h></span>
<a name="l00047"></a>00047
<a name="l00048"></a>00048 <span class="preprocessor">#include "AbstractSpawnManager.h"</span>
<a name="l00049"></a>00049 <span class="preprocessor">#include "ServerInstanceDir.h"</span>
<a name="l00050"></a>00050 <span class="preprocessor">#include "FileDescriptor.h"</span>
<a name="l00051"></a>00051 <span class="preprocessor">#include "Constants.h"</span>
<a name="l00052"></a>00052 <span class="preprocessor">#include "MessageChannel.h"</span>
<a name="l00053"></a>00053 <span class="preprocessor">#include "AccountsDatabase.h"</span>
<a name="l00054"></a>00054 <span class="preprocessor">#include "RandomGenerator.h"</span>
<a name="l00055"></a>00055 <span class="preprocessor">#include "Exceptions.h"</span>
<a name="l00056"></a>00056 <span class="preprocessor">#include "Logging.h"</span>
<a name="l00057"></a>00057 <span class="preprocessor">#include "Utils/Base64.h"</span>
<a name="l00058"></a>00058
<a name="l00059"></a>00059 <span class="keyword">namespace </span>Passenger {
<a name="l00060"></a>00060
<a name="l00061"></a>00061 <span class="keyword">using namespace </span>std;
<a name="l00062"></a>00062 <span class="keyword">using namespace </span>boost;
<a name="l00063"></a>00063 <span class="keyword">using namespace </span>oxt;
<a name="l00064"></a>00064 <span class="comment"></span>
<a name="l00065"></a>00065 <span class="comment">/**</span>
<a name="l00066"></a>00066 <span class="comment"> * An AbstractSpawnManager implementation.</span>
<a name="l00067"></a>00067 <span class="comment"> *</span>
<a name="l00068"></a>00068 <span class="comment"> * Internally, this class makes use of a spawn server, which is written in Ruby. This server</span>
<a name="l00069"></a>00069 <span class="comment"> * is automatically started when a SpawnManager instance is created, and automatically</span>
<a name="l00070"></a>00070 <span class="comment"> * shutdown when that instance is destroyed. The existance of the spawn server is almost</span>
<a name="l00071"></a>00071 <span class="comment"> * totally transparent to users of this class. Spawn requests are sent to the server,</span>
<a name="l00072"></a>00072 <span class="comment"> * and details about the spawned process is returned.</span>
<a name="l00073"></a>00073 <span class="comment"> *</span>
<a name="l00074"></a>00074 <span class="comment"> * If the spawn server dies during the middle of an operation, it will be restarted.</span>
<a name="l00075"></a>00075 <span class="comment"> * See spawn() for full details.</span>
<a name="l00076"></a>00076 <span class="comment"> *</span>
<a name="l00077"></a>00077 <span class="comment"> * The communication channel with the server is anonymous, i.e. no other processes</span>
<a name="l00078"></a>00078 <span class="comment"> * can access the communication channel, so communication is guaranteed to be safe</span>
<a name="l00079"></a>00079 <span class="comment"> * (unless, of course, if the spawn server itself is a trojan).</span>
<a name="l00080"></a>00080 <span class="comment"> *</span>
<a name="l00081"></a>00081 <span class="comment"> * The server will try to keep the spawning time as small as possible, by keeping</span>
<a name="l00082"></a>00082 <span class="comment"> * corresponding Ruby on Rails frameworks and application code in memory. So the second</span>
<a name="l00083"></a>00083 <span class="comment"> * time a process of the same application is spawned, the spawn time is significantly</span>
<a name="l00084"></a>00084 <span class="comment"> * lower than the first time. Nevertheless, spawning is a relatively expensive operation</span>
<a name="l00085"></a>00085 <span class="comment"> * (compared to the processing of a typical HTTP request/response), and so should be</span>
<a name="l00086"></a>00086 <span class="comment"> * avoided whenever possible.</span>
<a name="l00087"></a>00087 <span class="comment"> *</span>
<a name="l00088"></a>00088 <span class="comment"> * See the documentation of the spawn server for full implementation details.</span>
<a name="l00089"></a>00089 <span class="comment"> *</span>
<a name="l00090"></a>00090 <span class="comment"> * @ingroup Support</span>
<a name="l00091"></a>00091 <span class="comment"> */</span>
<a name="l00092"></a><a class="code" href="classPassenger_1_1SpawnManager.html">00092</a> <span class="keyword">class </span><a class="code" href="classPassenger_1_1SpawnManager.html" title="An AbstractSpawnManager implementation.">SpawnManager</a>: <span class="keyword">public</span> <a class="code" href="classPassenger_1_1AbstractSpawnManager.html" title="Spawning of application processes.">AbstractSpawnManager</a> {
<a name="l00093"></a>00093 <span class="keyword">private</span>:
<a name="l00094"></a>00094 <span class="keyword">static</span> <span class="keyword">const</span> <span class="keywordtype">int</span> SERVER_SOCKET_FD = 3;
<a name="l00095"></a>00095 <span class="keyword">static</span> <span class="keyword">const</span> <span class="keywordtype">int</span> OWNER_SOCKET_FD = 4;
<a name="l00096"></a>00096 <span class="keyword">static</span> <span class="keyword">const</span> <span class="keywordtype">int</span> HIGHEST_FD = OWNER_SOCKET_FD;
<a name="l00097"></a>00097
<a name="l00098"></a>00098 <span class="keywordtype">string</span> spawnServerCommand;
<a name="l00099"></a>00099 ServerInstanceDir::GenerationPtr generation;
<a name="l00100"></a>00100 AccountsDatabasePtr accountsDatabase;
<a name="l00101"></a>00101 <span class="keywordtype">string</span> rubyCommand;
<a name="l00102"></a>00102 <span class="keywordtype">string</span> loggingAgentAddress;
<a name="l00103"></a>00103 <span class="keywordtype">string</span> loggingAgentUsername;
<a name="l00104"></a>00104 <span class="keywordtype">string</span> loggingAgentPassword;
<a name="l00105"></a>00105
<a name="l00106"></a>00106 boost::mutex lock;
<a name="l00107"></a>00107 <a class="code" href="classPassenger_1_1RandomGenerator.html" title="A random data generator.">RandomGenerator</a> random;
<a name="l00108"></a>00108
<a name="l00109"></a>00109 pid_t pid;
<a name="l00110"></a>00110 <a class="code" href="classPassenger_1_1FileDescriptor.html" title="Wrapper class around a file descriptor integer, for RAII behavior.">FileDescriptor</a> ownerSocket;
<a name="l00111"></a>00111 <span class="keywordtype">string</span> socketFilename;
<a name="l00112"></a>00112 <span class="keywordtype">string</span> socketPassword;
<a name="l00113"></a>00113 <span class="keywordtype">bool</span> serverNeedsRestart;
<a name="l00114"></a>00114
<a name="l00115"></a>00115 <span class="keyword">static</span> <span class="keywordtype">void</span> deleteAccount(AccountsDatabasePtr accountsDatabase, <span class="keyword">const</span> <span class="keywordtype">string</span> &username) {
<a name="l00116"></a>00116 accountsDatabase->remove(username);
<a name="l00117"></a>00117 }
<a name="l00118"></a>00118 <span class="comment"></span>
<a name="l00119"></a>00119 <span class="comment"> /**</span>
<a name="l00120"></a>00120 <span class="comment"> * Restarts the spawn server.</span>
<a name="l00121"></a>00121 <span class="comment"> *</span>
<a name="l00122"></a>00122 <span class="comment"> * @pre System call interruption is disabled.</span>
<a name="l00123"></a>00123 <span class="comment"> * @throws RuntimeException An error occurred while creating a Unix server socket.</span>
<a name="l00124"></a>00124 <span class="comment"> * @throws SystemException An error occured while trying to setup the spawn server.</span>
<a name="l00125"></a>00125 <span class="comment"> * @throws IOException An error occurred while generating random data.</span>
<a name="l00126"></a>00126 <span class="comment"> */</span>
<a name="l00127"></a>00127 <span class="keywordtype">void</span> restartServer() {
<a name="l00128"></a>00128 TRACE_POINT();
<a name="l00129"></a>00129 <span class="keywordflow">if</span> (pid != 0) {
<a name="l00130"></a>00130 UPDATE_TRACE_POINT();
<a name="l00131"></a>00131 ownerSocket.<a class="code" href="classPassenger_1_1FileDescriptor.html#d7c1a99531181878cbab74a7400c5432" title="Close the underlying file descriptor.">close</a>();
<a name="l00132"></a>00132
<a name="l00133"></a>00133 <span class="comment">/* Wait at most 5 seconds for the spawn server to exit.</span>
<a name="l00134"></a>00134 <span class="comment"> * If that doesn't work, kill it, then wait at most 5 seconds</span>
<a name="l00135"></a>00135 <span class="comment"> * for it to exit.</span>
<a name="l00136"></a>00136 <span class="comment"> */</span>
<a name="l00137"></a>00137 time_t begin = syscalls::time(NULL);
<a name="l00138"></a>00138 <span class="keywordtype">bool</span> done = <span class="keyword">false</span>;
<a name="l00139"></a>00139 <span class="keywordflow">while</span> (!done && syscalls::time(NULL) - begin < 5) {
<a name="l00140"></a>00140 <span class="keywordflow">if</span> (syscalls::waitpid(pid, NULL, WNOHANG) > 0) {
<a name="l00141"></a>00141 done = <span class="keyword">true</span>;
<a name="l00142"></a>00142 } <span class="keywordflow">else</span> {
<a name="l00143"></a>00143 syscalls::usleep(100000);
<a name="l00144"></a>00144 }
<a name="l00145"></a>00145 }
<a name="l00146"></a>00146 UPDATE_TRACE_POINT();
<a name="l00147"></a>00147 <span class="keywordflow">if</span> (!done) {
<a name="l00148"></a>00148 UPDATE_TRACE_POINT();
<a name="l00149"></a>00149 P_TRACE(2, <span class="stringliteral">"Spawn server did not exit in time, killing it..."</span>);
<a name="l00150"></a>00150 syscalls::kill(pid, SIGTERM);
<a name="l00151"></a>00151 begin = syscalls::time(NULL);
<a name="l00152"></a>00152 <span class="keywordflow">while</span> (syscalls::time(NULL) - begin < 5) {
<a name="l00153"></a>00153 <span class="keywordflow">if</span> (syscalls::waitpid(pid, NULL, WNOHANG) > 0) {
<a name="l00154"></a>00154 <span class="keywordflow">break</span>;
<a name="l00155"></a>00155 } <span class="keywordflow">else</span> {
<a name="l00156"></a>00156 syscalls::usleep(100000);
<a name="l00157"></a>00157 }
<a name="l00158"></a>00158 }
<a name="l00159"></a>00159 }
<a name="l00160"></a>00160 pid = 0;
<a name="l00161"></a>00161 }
<a name="l00162"></a>00162
<a name="l00163"></a>00163 <a class="code" href="classPassenger_1_1FileDescriptor.html" title="Wrapper class around a file descriptor integer, for RAII behavior.">FileDescriptor</a> serverSocket;
<a name="l00164"></a>00164 <span class="keywordtype">string</span> socketFilename;
<a name="l00165"></a>00165 <span class="keywordtype">string</span> socketPassword;
<a name="l00166"></a>00166 <span class="keywordtype">int</span> ret, fds[2];
<a name="l00167"></a>00167
<a name="l00168"></a>00168 UPDATE_TRACE_POINT();
<a name="l00169"></a>00169 socketFilename = generation->getPath() + <span class="stringliteral">"/spawn-server/socket."</span> +
<a name="l00170"></a>00170 <a class="code" href="group__Support.html#gf6fab368d70c18fdf16bf5a24f630407" title="Convert anything to a string.">toString</a>(getpid()) + <span class="stringliteral">"."</span> +
<a name="l00171"></a>00171 <a class="code" href="group__Support.html#gf6fab368d70c18fdf16bf5a24f630407" title="Convert anything to a string.">toString</a>((<span class="keywordtype">unsigned</span> <span class="keywordtype">long</span> <span class="keywordtype">long</span>) <span class="keyword">this</span>);
<a name="l00172"></a>00172 socketPassword = Base64::encode(random.<a class="code" href="classPassenger_1_1RandomGenerator.html#02cdc94154658d63241f7d65d9d2d865">generateByteString</a>(32));
<a name="l00173"></a>00173 serverSocket = <a class="code" href="group__Support.html#g5d3b342a34d81e7506744e90ee2f9b8b" title="Create a new Unix server socket which is bounded to filename.">createUnixServer</a>(socketFilename.c_str());
<a name="l00174"></a>00174 <span class="keywordflow">do</span> {
<a name="l00175"></a>00175 ret = chmod(socketFilename.c_str(), S_IRUSR | S_IWUSR | S_IXUSR);
<a name="l00176"></a>00176 } <span class="keywordflow">while</span> (ret == -1 && errno == EINTR);
<a name="l00177"></a>00177 <span class="keywordflow">if</span> (ret == -1) {
<a name="l00178"></a>00178 <span class="keywordtype">int</span> e = errno;
<a name="l00179"></a>00179 syscalls::unlink(socketFilename.c_str());
<a name="l00180"></a>00180 <span class="keywordflow">throw</span> <a class="code" href="classPassenger_1_1FileSystemException.html" title="A filesystem error, as returned by the operating system.">FileSystemException</a>(<span class="stringliteral">"Cannot set permissions on '"</span> + socketFilename + <span class="stringliteral">"'"</span>,
<a name="l00181"></a>00181 e, socketFilename);
<a name="l00182"></a>00182 }
<a name="l00183"></a>00183
<a name="l00184"></a>00184 <span class="keywordflow">if</span> (syscalls::socketpair(AF_UNIX, SOCK_STREAM, 0, fds) == -1) {
<a name="l00185"></a>00185 <span class="keywordtype">int</span> e = errno;
<a name="l00186"></a>00186 syscalls::unlink(socketFilename.c_str());
<a name="l00187"></a>00187 <span class="keywordflow">throw</span> <a class="code" href="classPassenger_1_1SystemException.html" title="Represents an error returned by a system call or a standard library call.">SystemException</a>(<span class="stringliteral">"Cannot create a Unix socket"</span>, e);
<a name="l00188"></a>00188 }
<a name="l00189"></a>00189
<a name="l00190"></a>00190 UPDATE_TRACE_POINT();
<a name="l00191"></a>00191 pid = syscalls::fork();
<a name="l00192"></a>00192 <span class="keywordflow">if</span> (pid == 0) {
<a name="l00193"></a>00193 dup2(serverSocket, HIGHEST_FD + 1);
<a name="l00194"></a>00194 dup2(fds[1], HIGHEST_FD + 2);
<a name="l00195"></a>00195 dup2(HIGHEST_FD + 1, SERVER_SOCKET_FD);
<a name="l00196"></a>00196 dup2(HIGHEST_FD + 2, OWNER_SOCKET_FD);
<a name="l00197"></a>00197
<a name="l00198"></a>00198 <span class="comment">// Close all unnecessary file descriptors</span>
<a name="l00199"></a>00199 <span class="keywordflow">for</span> (<span class="keywordtype">long</span> i = sysconf(_SC_OPEN_MAX) - 1; i > HIGHEST_FD; i--) {
<a name="l00200"></a>00200 close(i);
<a name="l00201"></a>00201 }
<a name="l00202"></a>00202
<a name="l00203"></a>00203 execlp(rubyCommand.c_str(),
<a name="l00204"></a>00204 rubyCommand.c_str(),
<a name="l00205"></a>00205 spawnServerCommand.c_str(),
<a name="l00206"></a>00206 <span class="comment">/* The spawn server changes the process names of the subservers</span>
<a name="l00207"></a>00207 <span class="comment"> * that it starts, for better usability. However, the process name length</span>
<a name="l00208"></a>00208 <span class="comment"> * (as shown by ps) is limited. Here, we try to expand that limit by</span>
<a name="l00209"></a>00209 <span class="comment"> * deliberately passing a useless whitespace string to the spawn server.</span>
<a name="l00210"></a>00210 <span class="comment"> * This argument is ignored by the spawn server. This works on some</span>
<a name="l00211"></a>00211 <span class="comment"> * systems, such as Ubuntu Linux.</span>
<a name="l00212"></a>00212 <span class="comment"> */</span>
<a name="l00213"></a>00213 <span class="stringliteral">" "</span>,
<a name="l00214"></a>00214 (<span class="keywordtype">char</span> *) NULL);
<a name="l00215"></a>00215 <span class="keywordtype">int</span> e = errno;
<a name="l00216"></a>00216 fprintf(stderr, <span class="stringliteral">"*** Passenger ERROR (%s:%d):\n"</span>
<a name="l00217"></a>00217 <span class="stringliteral">"Could not start the spawn server: %s: %s (%d)\n"</span>,
<a name="l00218"></a>00218 __FILE__, __LINE__,
<a name="l00219"></a>00219 rubyCommand.c_str(), strerror(e), e);
<a name="l00220"></a>00220 fflush(stderr);
<a name="l00221"></a>00221 _exit(1);
<a name="l00222"></a>00222 } <span class="keywordflow">else</span> <span class="keywordflow">if</span> (pid == -1) {
<a name="l00223"></a>00223 <span class="keywordtype">int</span> e = errno;
<a name="l00224"></a>00224 syscalls::unlink(socketFilename.c_str());
<a name="l00225"></a>00225 syscalls::close(fds[0]);
<a name="l00226"></a>00226 syscalls::close(fds[1]);
<a name="l00227"></a>00227 pid = 0;
<a name="l00228"></a>00228 <span class="keywordflow">throw</span> <a class="code" href="classPassenger_1_1SystemException.html" title="Represents an error returned by a system call or a standard library call.">SystemException</a>(<span class="stringliteral">"Unable to fork a process"</span>, e);
<a name="l00229"></a>00229 } <span class="keywordflow">else</span> {
<a name="l00230"></a>00230 <a class="code" href="classPassenger_1_1FileDescriptor.html" title="Wrapper class around a file descriptor integer, for RAII behavior.">FileDescriptor</a> ownerSocket = fds[0];
<a name="l00231"></a>00231 syscalls::close(fds[1]);
<a name="l00232"></a>00232 serverSocket.close();
<a name="l00233"></a>00233
<a name="l00234"></a>00234 <span class="comment">// Pass arguments to spawn server.</span>
<a name="l00235"></a>00235 <a class="code" href="classPassenger_1_1MessageChannel.html" title="Convenience class for I/O operations on file descriptors.">MessageChannel</a> ownerSocketChannel(ownerSocket);
<a name="l00236"></a>00236 ownerSocketChannel.<a class="code" href="classPassenger_1_1MessageChannel.html#069314e4c7e1fe8c8ab36e16d2cc5fef" title="Send a block of data over the underlying file descriptor.">writeRaw</a>(socketFilename + <span class="stringliteral">"\n"</span>);
<a name="l00237"></a>00237 ownerSocketChannel.<a class="code" href="classPassenger_1_1MessageChannel.html#069314e4c7e1fe8c8ab36e16d2cc5fef" title="Send a block of data over the underlying file descriptor.">writeRaw</a>(socketPassword + <span class="stringliteral">"\n"</span>);
<a name="l00238"></a>00238 ownerSocketChannel.<a class="code" href="classPassenger_1_1MessageChannel.html#069314e4c7e1fe8c8ab36e16d2cc5fef" title="Send a block of data over the underlying file descriptor.">writeRaw</a>(generation->getPath() + <span class="stringliteral">"\n"</span>);
<a name="l00239"></a>00239 ownerSocketChannel.<a class="code" href="classPassenger_1_1MessageChannel.html#069314e4c7e1fe8c8ab36e16d2cc5fef" title="Send a block of data over the underlying file descriptor.">writeRaw</a>(loggingAgentAddress + <span class="stringliteral">"\n"</span>);
<a name="l00240"></a>00240 ownerSocketChannel.<a class="code" href="classPassenger_1_1MessageChannel.html#069314e4c7e1fe8c8ab36e16d2cc5fef" title="Send a block of data over the underlying file descriptor.">writeRaw</a>(loggingAgentUsername + <span class="stringliteral">"\n"</span>);
<a name="l00241"></a>00241 ownerSocketChannel.<a class="code" href="classPassenger_1_1MessageChannel.html#069314e4c7e1fe8c8ab36e16d2cc5fef" title="Send a block of data over the underlying file descriptor.">writeRaw</a>(Base64::encode(loggingAgentPassword) + <span class="stringliteral">"\n"</span>);
<a name="l00242"></a>00242
<a name="l00243"></a>00243 this->ownerSocket = ownerSocket;
<a name="l00244"></a>00244 this->socketFilename = socketFilename;
<a name="l00245"></a>00245 this->socketPassword = socketPassword;
<a name="l00246"></a>00246 <a class="code" href="classPassenger_1_1SpawnManager.html#b4dfcb11c58b07d8144b18dd99abed45" title="A method which is called after the spawn server has started.">spawnServerStarted</a>();
<a name="l00247"></a>00247 }
<a name="l00248"></a>00248 }
<a name="l00249"></a>00249 <span class="comment"></span>
<a name="l00250"></a>00250 <span class="comment"> /**</span>
<a name="l00251"></a>00251 <span class="comment"> * Connects to the spawn server and returns the connection.</span>
<a name="l00252"></a>00252 <span class="comment"> *</span>
<a name="l00253"></a>00253 <span class="comment"> * @throws RuntimeException</span>
<a name="l00254"></a>00254 <span class="comment"> * @throws SystemException</span>
<a name="l00255"></a>00255 <span class="comment"> * @throws boost::thread_interrupted</span>
<a name="l00256"></a>00256 <span class="comment"> */</span>
<a name="l00257"></a>00257 <a class="code" href="classPassenger_1_1FileDescriptor.html" title="Wrapper class around a file descriptor integer, for RAII behavior.">FileDescriptor</a> connect()<span class="keyword"> const </span>{
<a name="l00258"></a>00258 TRACE_POINT();
<a name="l00259"></a>00259 <a class="code" href="classPassenger_1_1FileDescriptor.html" title="Wrapper class around a file descriptor integer, for RAII behavior.">FileDescriptor</a> fd = <a class="code" href="group__Support.html#gae3993db9dfa0b05c97b67ccefd2b619" title="Connect to a Unix server socket at filename.">connectToUnixServer</a>(socketFilename.c_str());
<a name="l00260"></a>00260 <a class="code" href="classPassenger_1_1MessageChannel.html" title="Convenience class for I/O operations on file descriptors.">MessageChannel</a> channel(fd);
<a name="l00261"></a>00261 UPDATE_TRACE_POINT();
<a name="l00262"></a>00262 channel.writeScalar(socketPassword);
<a name="l00263"></a>00263 <span class="keywordflow">return</span> fd;
<a name="l00264"></a>00264 }
<a name="l00265"></a>00265 <span class="comment"></span>
<a name="l00266"></a>00266 <span class="comment"> /**</span>
<a name="l00267"></a>00267 <span class="comment"> * Send the spawn command to the spawn server.</span>
<a name="l00268"></a>00268 <span class="comment"> *</span>
<a name="l00269"></a>00269 <span class="comment"> * @param PoolOptions The spawn options to use.</span>
<a name="l00270"></a>00270 <span class="comment"> * @return A Process smart pointer, representing the spawned process.</span>
<a name="l00271"></a>00271 <span class="comment"> * @throws SpawnException Something went wrong.</span>
<a name="l00272"></a>00272 <span class="comment"> * @throws Anything thrown by options.environmentVariables->getItems().</span>
<a name="l00273"></a>00273 <span class="comment"> * @throws boost::thread_interrupted</span>
<a name="l00274"></a>00274 <span class="comment"> */</span>
<a name="l00275"></a>00275 <a class="code" href="namespacePassenger.html#ced1f248465136b313c6dec5fe6ca492" title="Convenient alias for Process smart pointer.">ProcessPtr</a> sendSpawnCommand(<span class="keyword">const</span> <a class="code" href="structPassenger_1_1PoolOptions.html" title="This struct encapsulates information for ApplicationPool::get() and for SpawnManager::spawn()...">PoolOptions</a> &options) {
<a name="l00276"></a>00276 TRACE_POINT();
<a name="l00277"></a>00277 <a class="code" href="classPassenger_1_1FileDescriptor.html" title="Wrapper class around a file descriptor integer, for RAII behavior.">FileDescriptor</a> connection;
<a name="l00278"></a>00278 <a class="code" href="classPassenger_1_1MessageChannel.html" title="Convenience class for I/O operations on file descriptors.">MessageChannel</a> channel;
<a name="l00279"></a>00279
<a name="l00280"></a>00280 <span class="keywordflow">try</span> {
<a name="l00281"></a>00281 connection = connect();
<a name="l00282"></a>00282 channel = <a class="code" href="classPassenger_1_1MessageChannel.html" title="Convenience class for I/O operations on file descriptors.">MessageChannel</a>(connection);
<a name="l00283"></a>00283 } <span class="keywordflow">catch</span> (<span class="keyword">const</span> <a class="code" href="classPassenger_1_1SystemException.html" title="Represents an error returned by a system call or a standard library call.">SystemException</a> &e) {
<a name="l00284"></a>00284 <span class="keywordflow">throw</span> <a class="code" href="classPassenger_1_1SpawnException.html" title="Thrown when SpawnManager or ApplicationPool fails to spawn an application instance...">SpawnException</a>(<span class="keywordtype">string</span>(<span class="stringliteral">"Could not connect to the spawn server: "</span>) +
<a name="l00285"></a>00285 e.<a class="code" href="classPassenger_1_1SystemException.html#0ef41d755fea2c9b1db2252e7c418dc8" title="Returns the system&#39;s error message.">sys</a>());
<a name="l00286"></a>00286 } <span class="keywordflow">catch</span> (<span class="keyword">const</span> std::exception &e) {
<a name="l00287"></a>00287 <span class="keywordflow">throw</span> <a class="code" href="classPassenger_1_1SpawnException.html" title="Thrown when SpawnManager or ApplicationPool fails to spawn an application instance...">SpawnException</a>(<span class="keywordtype">string</span>(<span class="stringliteral">"Could not connect to the spawn server: "</span>) +
<a name="l00288"></a>00288 e.what());
<a name="l00289"></a>00289 }
<a name="l00290"></a>00290
<a name="l00291"></a>00291 UPDATE_TRACE_POINT();
<a name="l00292"></a>00292 vector<string> args;
<a name="l00293"></a>00293 <span class="keywordtype">string</span> appRoot;
<a name="l00294"></a>00294 pid_t appPid;
<a name="l00295"></a>00295 <span class="keywordtype">int</span> i, nServerSockets, ownerPipe;
<a name="l00296"></a>00296 Process::SocketInfoMap serverSockets;
<a name="l00297"></a>00297 <span class="keywordtype">string</span> detachKey = Base64::encode(random.<a class="code" href="classPassenger_1_1RandomGenerator.html#02cdc94154658d63241f7d65d9d2d865">generateByteString</a>(32));
<a name="l00298"></a>00298 <span class="comment">// The connect password must be a URL-friendly string because users will</span>
<a name="l00299"></a>00299 <span class="comment">// insert it in HTTP headers.</span>
<a name="l00300"></a>00300 <span class="keywordtype">string</span> connectPassword = Base64::encodeForUrl(random.<a class="code" href="classPassenger_1_1RandomGenerator.html#02cdc94154658d63241f7d65d9d2d865">generateByteString</a>(32));
<a name="l00301"></a>00301 AccountPtr account;
<a name="l00302"></a>00302 function<void ()> destructionCallback;
<a name="l00303"></a>00303
<a name="l00304"></a>00304 <span class="keywordflow">try</span> {
<a name="l00305"></a>00305 args.push_back(<span class="stringliteral">"spawn_application"</span>);
<a name="l00306"></a>00306 options.<a class="code" href="structPassenger_1_1PoolOptions.html#437e077b0ab037f4e86680e9164a694e" title="Append the information in this PoolOptions object to the given string vector.">toVector</a>(args);
<a name="l00307"></a>00307
<a name="l00308"></a>00308 args.push_back(<span class="stringliteral">"detach_key"</span>);
<a name="l00309"></a>00309 args.push_back(detachKey);
<a name="l00310"></a>00310 args.push_back(<span class="stringliteral">"connect_password"</span>);
<a name="l00311"></a>00311 args.push_back(connectPassword);
<a name="l00312"></a>00312 <span class="keywordflow">if</span> (accountsDatabase != NULL) {
<a name="l00313"></a>00313 <span class="keywordtype">string</span> username = <span class="stringliteral">"_backend-"</span> + <a class="code" href="group__Support.html#gf6fab368d70c18fdf16bf5a24f630407" title="Convert anything to a string.">toString</a>(accountsDatabase->getUniqueNumber());
<a name="l00314"></a>00314 <span class="keywordtype">string</span> password = random.<a class="code" href="classPassenger_1_1RandomGenerator.html#02cdc94154658d63241f7d65d9d2d865">generateByteString</a>(MESSAGE_SERVER_MAX_PASSWORD_SIZE);
<a name="l00315"></a>00315 account = accountsDatabase->add(username, password, <span class="keyword">false</span>, options.<a class="code" href="structPassenger_1_1PoolOptions.html#45665fffc8a20ea60a3fcafaff8627ab" title="Any rights that the spawned application process may have.">rights</a>);
<a name="l00316"></a>00316 destructionCallback = boost::bind(&SpawnManager::deleteAccount,
<a name="l00317"></a>00317 accountsDatabase, username);
<a name="l00318"></a>00318
<a name="l00319"></a>00319 args.push_back(<span class="stringliteral">"pool_account_username"</span>);
<a name="l00320"></a>00320 args.push_back(username);
<a name="l00321"></a>00321 args.push_back(<span class="stringliteral">"pool_account_password_base64"</span>);
<a name="l00322"></a>00322 args.push_back(Base64::encode(password));
<a name="l00323"></a>00323 }
<a name="l00324"></a>00324
<a name="l00325"></a>00325 channel.<a class="code" href="classPassenger_1_1MessageChannel.html#150f68bc47e060dcc6ca35bee047914d" title="Send an array message, which consists of the given elements, over the underlying...">write</a>(args);
<a name="l00326"></a>00326 } <span class="keywordflow">catch</span> (<span class="keyword">const</span> <a class="code" href="classPassenger_1_1SystemException.html" title="Represents an error returned by a system call or a standard library call.">SystemException</a> &e) {
<a name="l00327"></a>00327 <span class="keywordflow">throw</span> <a class="code" href="classPassenger_1_1SpawnException.html" title="Thrown when SpawnManager or ApplicationPool fails to spawn an application instance...">SpawnException</a>(<span class="keywordtype">string</span>(<span class="stringliteral">"Could not write 'spawn_application' "</span>
<a name="l00328"></a>00328 <span class="stringliteral">"command to the spawn server: "</span>) + e.<a class="code" href="classPassenger_1_1SystemException.html#0ef41d755fea2c9b1db2252e7c418dc8" title="Returns the system&#39;s error message.">sys</a>());
<a name="l00329"></a>00329 }
<a name="l00330"></a>00330
<a name="l00331"></a>00331 <span class="keywordflow">try</span> {
<a name="l00332"></a>00332 UPDATE_TRACE_POINT();
<a name="l00333"></a>00333 <span class="comment">// Read status.</span>
<a name="l00334"></a>00334 <span class="keywordflow">if</span> (!channel.<a class="code" href="classPassenger_1_1MessageChannel.html#129659b60d1a663337873d2af944431e" title="Read an array message from the underlying file descriptor.">read</a>(args)) {
<a name="l00335"></a>00335 <span class="keywordflow">throw</span> <a class="code" href="classPassenger_1_1SpawnException.html" title="Thrown when SpawnManager or ApplicationPool fails to spawn an application instance...">SpawnException</a>(<span class="stringliteral">"The spawn server has exited unexpectedly."</span>);
<a name="l00336"></a>00336 }
<a name="l00337"></a>00337 <span class="keywordflow">if</span> (args.size() != 1) {
<a name="l00338"></a>00338 <span class="keywordflow">throw</span> <a class="code" href="classPassenger_1_1SpawnException.html" title="Thrown when SpawnManager or ApplicationPool fails to spawn an application instance...">SpawnException</a>(<span class="stringliteral">"The spawn server sent an invalid message."</span>);
<a name="l00339"></a>00339 }
<a name="l00340"></a>00340 <span class="keywordflow">if</span> (args[0] == <span class="stringliteral">"error_page"</span>) {
<a name="l00341"></a>00341 UPDATE_TRACE_POINT();
<a name="l00342"></a>00342 <span class="keywordtype">string</span> errorPage;
<a name="l00343"></a>00343
<a name="l00344"></a>00344 <span class="keywordflow">if</span> (!channel.<a class="code" href="classPassenger_1_1MessageChannel.html#1f3cf672b566166ed920c2bba4d19604" title="Read a scalar message from the underlying file descriptor.">readScalar</a>(errorPage)) {
<a name="l00345"></a>00345 <span class="keywordflow">throw</span> <a class="code" href="classPassenger_1_1SpawnException.html" title="Thrown when SpawnManager or ApplicationPool fails to spawn an application instance...">SpawnException</a>(<span class="stringliteral">"The spawn server has exited unexpectedly."</span>);
<a name="l00346"></a>00346 }
<a name="l00347"></a>00347 <span class="keywordflow">throw</span> <a class="code" href="classPassenger_1_1SpawnException.html" title="Thrown when SpawnManager or ApplicationPool fails to spawn an application instance...">SpawnException</a>(<span class="stringliteral">"An error occured while spawning the application."</span>,
<a name="l00348"></a>00348 errorPage);
<a name="l00349"></a>00349 } <span class="keywordflow">else</span> <span class="keywordflow">if</span> (args[0] != <span class="stringliteral">"ok"</span>) {
<a name="l00350"></a>00350 <span class="keywordflow">throw</span> <a class="code" href="classPassenger_1_1SpawnException.html" title="Thrown when SpawnManager or ApplicationPool fails to spawn an application instance...">SpawnException</a>(<span class="stringliteral">"The spawn server sent an invalid message."</span>);
<a name="l00351"></a>00351 }
<a name="l00352"></a>00352
<a name="l00353"></a>00353 <span class="comment">// Read application info.</span>
<a name="l00354"></a>00354 UPDATE_TRACE_POINT();
<a name="l00355"></a>00355 <span class="keywordflow">if</span> (!channel.<a class="code" href="classPassenger_1_1MessageChannel.html#129659b60d1a663337873d2af944431e" title="Read an array message from the underlying file descriptor.">read</a>(args)) {
<a name="l00356"></a>00356 <span class="keywordflow">throw</span> <a class="code" href="classPassenger_1_1SpawnException.html" title="Thrown when SpawnManager or ApplicationPool fails to spawn an application instance...">SpawnException</a>(<span class="stringliteral">"The spawn server has exited unexpectedly."</span>);
<a name="l00357"></a>00357 }
<a name="l00358"></a>00358 <span class="keywordflow">if</span> (args.size() != 3) {
<a name="l00359"></a>00359 <span class="keywordflow">throw</span> <a class="code" href="classPassenger_1_1SpawnException.html" title="Thrown when SpawnManager or ApplicationPool fails to spawn an application instance...">SpawnException</a>(<span class="stringliteral">"The spawn server sent an invalid message."</span>);
<a name="l00360"></a>00360 }
<a name="l00361"></a>00361
<a name="l00362"></a>00362 appRoot = args[0];
<a name="l00363"></a>00363 appPid = (pid_t) atoll(args[1].c_str());
<a name="l00364"></a>00364 nServerSockets = <a class="code" href="group__Support.html#g73b17b509ee44938a56bf16cbf82fb48" title="Converts the given string to an integer.">atoi</a>(args[2]);
<a name="l00365"></a>00365
<a name="l00366"></a>00366 UPDATE_TRACE_POINT();
<a name="l00367"></a>00367 <span class="keywordflow">for</span> (i = 0; i < nServerSockets; i++) {
<a name="l00368"></a>00368 <span class="keywordflow">if</span> (!channel.<a class="code" href="classPassenger_1_1MessageChannel.html#129659b60d1a663337873d2af944431e" title="Read an array message from the underlying file descriptor.">read</a>(args)) {
<a name="l00369"></a>00369 <span class="keywordflow">throw</span> <a class="code" href="classPassenger_1_1SpawnException.html" title="Thrown when SpawnManager or ApplicationPool fails to spawn an application instance...">SpawnException</a>(<span class="stringliteral">"The spawn server has exited unexpectedly."</span>);
<a name="l00370"></a>00370 }
<a name="l00371"></a>00371 <span class="keywordflow">if</span> (args.size() != 3) {
<a name="l00372"></a>00372 <span class="keywordflow">throw</span> <a class="code" href="classPassenger_1_1SpawnException.html" title="Thrown when SpawnManager or ApplicationPool fails to spawn an application instance...">SpawnException</a>(<span class="stringliteral">"The spawn server sent an invalid message."</span>);
<a name="l00373"></a>00373 }
<a name="l00374"></a>00374 serverSockets[args[0]] = Process::SocketInfo(args[1], args[2]);
<a name="l00375"></a>00375 }
<a name="l00376"></a>00376 <span class="keywordflow">if</span> (serverSockets.find(<span class="stringliteral">"main"</span>) == serverSockets.end()) {
<a name="l00377"></a>00377 UPDATE_TRACE_POINT();
<a name="l00378"></a>00378 <span class="keywordflow">throw</span> <a class="code" href="classPassenger_1_1SpawnException.html" title="Thrown when SpawnManager or ApplicationPool fails to spawn an application instance...">SpawnException</a>(<span class="stringliteral">"The spawn server sent an invalid message."</span>);
<a name="l00379"></a>00379 }
<a name="l00380"></a>00380 } <span class="keywordflow">catch</span> (<span class="keyword">const</span> <a class="code" href="classPassenger_1_1SystemException.html" title="Represents an error returned by a system call or a standard library call.">SystemException</a> &e) {
<a name="l00381"></a>00381 <span class="keywordflow">throw</span> <a class="code" href="classPassenger_1_1SpawnException.html" title="Thrown when SpawnManager or ApplicationPool fails to spawn an application instance...">SpawnException</a>(<span class="keywordtype">string</span>(<span class="stringliteral">"Could not read from the spawn server: "</span>) + e.<a class="code" href="classPassenger_1_1SystemException.html#0ef41d755fea2c9b1db2252e7c418dc8" title="Returns the system&#39;s error message.">sys</a>());
<a name="l00382"></a>00382 }
<a name="l00383"></a>00383
<a name="l00384"></a>00384 UPDATE_TRACE_POINT();
<a name="l00385"></a>00385 <span class="keywordflow">try</span> {
<a name="l00386"></a>00386 ownerPipe = channel.<a class="code" href="classPassenger_1_1MessageChannel.html#1a28ba9d078f38f2831673092ac9dcbc" title="Receive a file descriptor, which had been passed over the underlying file descriptor...">readFileDescriptor</a>();
<a name="l00387"></a>00387 } <span class="keywordflow">catch</span> (<span class="keyword">const</span> <a class="code" href="classPassenger_1_1SystemException.html" title="Represents an error returned by a system call or a standard library call.">SystemException</a> &e) {
<a name="l00388"></a>00388 <span class="keywordflow">throw</span> <a class="code" href="classPassenger_1_1SpawnException.html" title="Thrown when SpawnManager or ApplicationPool fails to spawn an application instance...">SpawnException</a>(<span class="keywordtype">string</span>(<span class="stringliteral">"Could not receive the spawned "</span>
<a name="l00389"></a>00389 <span class="stringliteral">"application's owner pipe from the spawn server: "</span>) +
<a name="l00390"></a>00390 e.<a class="code" href="classPassenger_1_1SystemException.html#0ef41d755fea2c9b1db2252e7c418dc8" title="Returns the system&#39;s error message.">sys</a>());
<a name="l00391"></a>00391 } <span class="keywordflow">catch</span> (<span class="keyword">const</span> <a class="code" href="classPassenger_1_1IOException.html" title="Represents an error that occured during an I/O operation.">IOException</a> &e) {
<a name="l00392"></a>00392 <span class="keywordflow">throw</span> <a class="code" href="classPassenger_1_1SpawnException.html" title="Thrown when SpawnManager or ApplicationPool fails to spawn an application instance...">SpawnException</a>(<span class="keywordtype">string</span>(<span class="stringliteral">"Could not receive the spawned "</span>
<a name="l00393"></a>00393 <span class="stringliteral">"application's owner pipe from the spawn server: "</span>) +
<a name="l00394"></a>00394 e.<a class="code" href="classPassenger_1_1IOException.html#1b65d0fdb9bc5136f5b7df759c14768a">what</a>());
<a name="l00395"></a>00395 }
<a name="l00396"></a>00396
<a name="l00397"></a>00397 UPDATE_TRACE_POINT();
<a name="l00398"></a>00398 <span class="keywordflow">return</span> <a class="code" href="namespacePassenger.html#ced1f248465136b313c6dec5fe6ca492" title="Convenient alias for Process smart pointer.">ProcessPtr</a>(<span class="keyword">new</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>(appRoot, appPid, ownerPipe, serverSockets,
<a name="l00399"></a>00399 detachKey, connectPassword, destructionCallback));
<a name="l00400"></a>00400 }
<a name="l00401"></a>00401 <span class="comment"></span>
<a name="l00402"></a>00402 <span class="comment"> /**</span>
<a name="l00403"></a>00403 <span class="comment"> * @throws boost::thread_interrupted</span>
<a name="l00404"></a>00404 <span class="comment"> * @throws Anything thrown by options.environmentVariables->getItems().</span>
<a name="l00405"></a>00405 <span class="comment"> */</span>
<a name="l00406"></a>00406 <a class="code" href="namespacePassenger.html#ced1f248465136b313c6dec5fe6ca492" title="Convenient alias for Process smart pointer.">ProcessPtr</a>
<a name="l00407"></a>00407 handleSpawnException(<span class="keyword">const</span> <a class="code" href="classPassenger_1_1SpawnException.html" title="Thrown when SpawnManager or ApplicationPool fails to spawn an application instance...">SpawnException</a> &e, <span class="keyword">const</span> <a class="code" href="structPassenger_1_1PoolOptions.html" title="This struct encapsulates information for ApplicationPool::get() and for SpawnManager::spawn()...">PoolOptions</a> &options) {
<a name="l00408"></a>00408 TRACE_POINT();
<a name="l00409"></a>00409 <span class="keywordtype">bool</span> restarted;
<a name="l00410"></a>00410 <span class="keywordflow">try</span> {
<a name="l00411"></a>00411 P_DEBUG(<span class="stringliteral">"Spawn server died. Attempting to restart it..."</span>);
<a name="l00412"></a>00412 this_thread::disable_syscall_interruption dsi;
<a name="l00413"></a>00413 restartServer();
<a name="l00414"></a>00414 P_DEBUG(<span class="stringliteral">"Restart seems to be successful."</span>);
<a name="l00415"></a>00415 restarted = <span class="keyword">true</span>;
<a name="l00416"></a>00416 } <span class="keywordflow">catch</span> (<span class="keyword">const</span> <a class="code" href="classPassenger_1_1IOException.html" title="Represents an error that occured during an I/O operation.">IOException</a> &e) {
<a name="l00417"></a>00417 P_DEBUG(<span class="stringliteral">"Restart failed: "</span> << e.<a class="code" href="classPassenger_1_1IOException.html#1b65d0fdb9bc5136f5b7df759c14768a">what</a>());
<a name="l00418"></a>00418 restarted = <span class="keyword">false</span>;
<a name="l00419"></a>00419 } <span class="keywordflow">catch</span> (<span class="keyword">const</span> <a class="code" href="classPassenger_1_1SystemException.html" title="Represents an error returned by a system call or a standard library call.">SystemException</a> &e) {
<a name="l00420"></a>00420 P_DEBUG(<span class="stringliteral">"Restart failed: "</span> << e.<a class="code" href="classPassenger_1_1SystemException.html#ee405d1078ff3aa1045bc60b1c93d7a3">what</a>());
<a name="l00421"></a>00421 restarted = <span class="keyword">false</span>;
<a name="l00422"></a>00422 }
<a name="l00423"></a>00423 <span class="keywordflow">if</span> (restarted) {
<a name="l00424"></a>00424 <span class="keywordflow">return</span> sendSpawnCommand(options);
<a name="l00425"></a>00425 } <span class="keywordflow">else</span> {
<a name="l00426"></a>00426 <span class="keywordflow">throw</span> <a class="code" href="classPassenger_1_1SpawnException.html" title="Thrown when SpawnManager or ApplicationPool fails to spawn an application instance...">SpawnException</a>(<span class="stringliteral">"The spawn server died unexpectedly, and restarting it failed."</span>);
<a name="l00427"></a>00427 }
<a name="l00428"></a>00428 }
<a name="l00429"></a>00429 <span class="comment"></span>
<a name="l00430"></a>00430 <span class="comment"> /**</span>
<a name="l00431"></a>00431 <span class="comment"> * Send the reload command to the spawn server.</span>
<a name="l00432"></a>00432 <span class="comment"> *</span>
<a name="l00433"></a>00433 <span class="comment"> * @param appRoot The application root to reload.</span>
<a name="l00434"></a>00434 <span class="comment"> * @throws RuntimeException </span>
<a name="l00435"></a>00435 <span class="comment"> * @throws SystemException</span>
<a name="l00436"></a>00436 <span class="comment"> * @throws boost::thread_interrupted</span>
<a name="l00437"></a>00437 <span class="comment"> */</span>
<a name="l00438"></a>00438 <span class="keywordtype">void</span> sendReloadCommand(<span class="keyword">const</span> <span class="keywordtype">string</span> &appRoot) {
<a name="l00439"></a>00439 TRACE_POINT();
<a name="l00440"></a>00440 <a class="code" href="classPassenger_1_1FileDescriptor.html" title="Wrapper class around a file descriptor integer, for RAII behavior.">FileDescriptor</a> connection;
<a name="l00441"></a>00441 <a class="code" href="classPassenger_1_1MessageChannel.html" title="Convenience class for I/O operations on file descriptors.">MessageChannel</a> channel;
<a name="l00442"></a>00442
<a name="l00443"></a>00443 <span class="keywordflow">try</span> {
<a name="l00444"></a>00444 connection = connect();
<a name="l00445"></a>00445 channel = <a class="code" href="classPassenger_1_1MessageChannel.html" title="Convenience class for I/O operations on file descriptors.">MessageChannel</a>(connection);
<a name="l00446"></a>00446 } <span class="keywordflow">catch</span> (<a class="code" href="classPassenger_1_1SystemException.html" title="Represents an error returned by a system call or a standard library call.">SystemException</a> &e) {
<a name="l00447"></a>00447 e.<a class="code" href="classPassenger_1_1SystemException.html#6fc359f27a084158b7111ef35bec114f">setBriefMessage</a>(<span class="stringliteral">"Could not connect to the spawn server"</span>);
<a name="l00448"></a>00448 <span class="keywordflow">throw</span>;
<a name="l00449"></a>00449 } <span class="keywordflow">catch</span> (<span class="keyword">const</span> <a class="code" href="classPassenger_1_1RuntimeException.html" title="A generic runtime exception.">RuntimeException</a> &e) {
<a name="l00450"></a>00450 <span class="keywordflow">throw</span> <a class="code" href="classPassenger_1_1RuntimeException.html" title="A generic runtime exception.">RuntimeException</a>(<span class="keywordtype">string</span>(<span class="stringliteral">"Could not connect to the spawn server: "</span>) +
<a name="l00451"></a>00451 e.<a class="code" href="classPassenger_1_1RuntimeException.html#b8fc54bfa94be7e6435af440f9fd72d0">what</a>());
<a name="l00452"></a>00452 }
<a name="l00453"></a>00453
<a name="l00454"></a>00454 <span class="keywordflow">try</span> {
<a name="l00455"></a>00455 channel.<a class="code" href="classPassenger_1_1MessageChannel.html#150f68bc47e060dcc6ca35bee047914d" title="Send an array message, which consists of the given elements, over the underlying...">write</a>(<span class="stringliteral">"reload"</span>, appRoot.c_str(), NULL);
<a name="l00456"></a>00456 } <span class="keywordflow">catch</span> (<a class="code" href="classPassenger_1_1SystemException.html" title="Represents an error returned by a system call or a standard library call.">SystemException</a> &e) {
<a name="l00457"></a>00457 e.<a class="code" href="classPassenger_1_1SystemException.html#6fc359f27a084158b7111ef35bec114f">setBriefMessage</a>(<span class="stringliteral">"Could not write 'reload' command to the spawn server"</span>);
<a name="l00458"></a>00458 <span class="keywordflow">throw</span>;
<a name="l00459"></a>00459 }
<a name="l00460"></a>00460 }
<a name="l00461"></a>00461
<a name="l00462"></a>00462 <span class="keywordtype">void</span> handleReloadException(<span class="keyword">const</span> <a class="code" href="classPassenger_1_1SystemException.html" title="Represents an error returned by a system call or a standard library call.">SystemException</a> &e, <span class="keyword">const</span> <span class="keywordtype">string</span> &appRoot) {
<a name="l00463"></a>00463 TRACE_POINT();
<a name="l00464"></a>00464 <span class="keywordtype">bool</span> restarted;
<a name="l00465"></a>00465 <span class="keywordflow">try</span> {
<a name="l00466"></a>00466 P_DEBUG(<span class="stringliteral">"Spawn server died. Attempting to restart it..."</span>);
<a name="l00467"></a>00467 restartServer();
<a name="l00468"></a>00468 P_DEBUG(<span class="stringliteral">"Restart seems to be successful."</span>);
<a name="l00469"></a>00469 restarted = <span class="keyword">true</span>;
<a name="l00470"></a>00470 } <span class="keywordflow">catch</span> (<span class="keyword">const</span> <a class="code" href="classPassenger_1_1IOException.html" title="Represents an error that occured during an I/O operation.">IOException</a> &e) {
<a name="l00471"></a>00471 P_DEBUG(<span class="stringliteral">"Restart failed: "</span> << e.<a class="code" href="classPassenger_1_1IOException.html#1b65d0fdb9bc5136f5b7df759c14768a">what</a>());
<a name="l00472"></a>00472 restarted = <span class="keyword">false</span>;
<a name="l00473"></a>00473 } <span class="keywordflow">catch</span> (<span class="keyword">const</span> <a class="code" href="classPassenger_1_1SystemException.html" title="Represents an error returned by a system call or a standard library call.">SystemException</a> &e) {
<a name="l00474"></a>00474 P_DEBUG(<span class="stringliteral">"Restart failed: "</span> << e.<a class="code" href="classPassenger_1_1SystemException.html#ee405d1078ff3aa1045bc60b1c93d7a3">what</a>());
<a name="l00475"></a>00475 restarted = <span class="keyword">false</span>;
<a name="l00476"></a>00476 }
<a name="l00477"></a>00477 <span class="keywordflow">if</span> (restarted) {
<a name="l00478"></a>00478 <span class="keywordflow">return</span> sendReloadCommand(appRoot);
<a name="l00479"></a>00479 } <span class="keywordflow">else</span> {
<a name="l00480"></a>00480 <span class="keywordflow">throw</span> <a class="code" href="classPassenger_1_1SpawnException.html" title="Thrown when SpawnManager or ApplicationPool fails to spawn an application instance...">SpawnException</a>(<span class="stringliteral">"The spawn server died unexpectedly, and restarting it failed."</span>);
<a name="l00481"></a>00481 }
<a name="l00482"></a>00482 }
<a name="l00483"></a>00483
<a name="l00484"></a>00484 <a class="code" href="classPassenger_1_1IOException.html" title="Represents an error that occured during an I/O operation.">IOException</a> prependMessageToException(<span class="keyword">const</span> <a class="code" href="classPassenger_1_1IOException.html" title="Represents an error that occured during an I/O operation.">IOException</a> &e, <span class="keyword">const</span> <span class="keywordtype">string</span> &message) {
<a name="l00485"></a>00485 <span class="keywordflow">return</span> <a class="code" href="classPassenger_1_1IOException.html" title="Represents an error that occured during an I/O operation.">IOException</a>(message + <span class="stringliteral">": "</span> + e.<a class="code" href="classPassenger_1_1IOException.html#1b65d0fdb9bc5136f5b7df759c14768a">what</a>());
<a name="l00486"></a>00486 }
<a name="l00487"></a>00487
<a name="l00488"></a>00488 <a class="code" href="classPassenger_1_1SystemException.html" title="Represents an error returned by a system call or a standard library call.">SystemException</a> prependMessageToException(<span class="keyword">const</span> <a class="code" href="classPassenger_1_1SystemException.html" title="Represents an error returned by a system call or a standard library call.">SystemException</a> &e, <span class="keyword">const</span> <span class="keywordtype">string</span> &message) {
<a name="l00489"></a>00489 <span class="keywordflow">return</span> <a class="code" href="classPassenger_1_1SystemException.html" title="Represents an error returned by a system call or a standard library call.">SystemException</a>(message + <span class="stringliteral">": "</span> + e.<a class="code" href="classPassenger_1_1SystemException.html#84fa2ab4f5b7b96704734fcdfdaa0269" title="Returns a brief version of the exception message.">brief</a>(), e.<a class="code" href="classPassenger_1_1SystemException.html#ee7a6672bf79b72a4c3ee70c57d6a47c" title="The value of errno at the time the error occured.">code</a>());
<a name="l00490"></a>00490 }
<a name="l00491"></a>00491
<a name="l00492"></a>00492 <span class="keyword">protected</span>:<span class="comment"></span>
<a name="l00493"></a>00493 <span class="comment"> /**</span>
<a name="l00494"></a>00494 <span class="comment"> * A method which is called after the spawn server has started.</span>
<a name="l00495"></a>00495 <span class="comment"> * It doesn't do anything by default and serves as a hook for unit tests.</span>
<a name="l00496"></a>00496 <span class="comment"> */</span>
<a name="l00497"></a><a class="code" href="classPassenger_1_1SpawnManager.html#b4dfcb11c58b07d8144b18dd99abed45">00497</a> <span class="keyword">virtual</span> <span class="keywordtype">void</span> <a class="code" href="classPassenger_1_1SpawnManager.html#b4dfcb11c58b07d8144b18dd99abed45" title="A method which is called after the spawn server has started.">spawnServerStarted</a>() { }
<a name="l00498"></a>00498
<a name="l00499"></a>00499 <span class="keyword">public</span>:<span class="comment"></span>
<a name="l00500"></a>00500 <span class="comment"> /**</span>
<a name="l00501"></a>00501 <span class="comment"> * Construct a new SpawnManager.</span>
<a name="l00502"></a>00502 <span class="comment"> *</span>
<a name="l00503"></a>00503 <span class="comment"> * @param spawnServerCommand The filename of the spawn server to use.</span>
<a name="l00504"></a>00504 <span class="comment"> * @param generation The server instance dir generation in which</span>
<a name="l00505"></a>00505 <span class="comment"> * generation-specific are stored.</span>
<a name="l00506"></a>00506 <span class="comment"> * @param accountsDatabase An accounts database. SpawnManager will automatically</span>
<a name="l00507"></a>00507 <span class="comment"> * create a new account for each spawned process, assigning</span>
<a name="l00508"></a>00508 <span class="comment"> * it the rights as set in the PoolOptions object. This</span>
<a name="l00509"></a>00509 <span class="comment"> * account is also automatically deleted when no longer needed.</span>
<a name="l00510"></a>00510 <span class="comment"> * May be a null pointer.</span>
<a name="l00511"></a>00511 <span class="comment"> * @param rubyCommand The Ruby interpreter's command.</span>
<a name="l00512"></a>00512 <span class="comment"> * @throws RuntimeException An error occurred while creating a Unix server socket.</span>
<a name="l00513"></a>00513 <span class="comment"> * @throws SystemException An error occured while trying to setup the spawn server.</span>
<a name="l00514"></a>00514 <span class="comment"> * @throws IOException An error occurred while generating random data.</span>
<a name="l00515"></a>00515 <span class="comment"> */</span>
<a name="l00516"></a><a class="code" href="classPassenger_1_1SpawnManager.html#5805c2919457e5bcb0eaf4f7107ba555">00516</a> <a class="code" href="classPassenger_1_1SpawnManager.html#5805c2919457e5bcb0eaf4f7107ba555" title="Construct a new SpawnManager.">SpawnManager</a>(<span class="keyword">const</span> <span class="keywordtype">string</span> &spawnServerCommand,
<a name="l00517"></a>00517 <span class="keyword">const</span> ServerInstanceDir::GenerationPtr &generation,
<a name="l00518"></a>00518 <span class="keyword">const</span> AccountsDatabasePtr &accountsDatabase = AccountsDatabasePtr(),
<a name="l00519"></a>00519 <span class="keyword">const</span> <span class="keywordtype">string</span> &rubyCommand = <span class="stringliteral">"ruby"</span>,
<a name="l00520"></a>00520 <span class="keyword">const</span> <span class="keywordtype">string</span> &loggingAgentAddress = <span class="stringliteral">""</span>,
<a name="l00521"></a>00521 <span class="keyword">const</span> <span class="keywordtype">string</span> &loggingAgentUsername = <span class="stringliteral">""</span>,
<a name="l00522"></a>00522 <span class="keyword">const</span> <span class="keywordtype">string</span> &loggingAgentPassword = <span class="stringliteral">""</span>
<a name="l00523"></a>00523 ) {
<a name="l00524"></a>00524 TRACE_POINT();
<a name="l00525"></a>00525 this->spawnServerCommand = spawnServerCommand;
<a name="l00526"></a>00526 this->generation = generation;
<a name="l00527"></a>00527 this->accountsDatabase = accountsDatabase;
<a name="l00528"></a>00528 this->rubyCommand = rubyCommand;
<a name="l00529"></a>00529 this->loggingAgentAddress = loggingAgentAddress;
<a name="l00530"></a>00530 this->loggingAgentUsername = loggingAgentUsername;
<a name="l00531"></a>00531 this->loggingAgentPassword = loggingAgentPassword;
<a name="l00532"></a>00532 pid = 0;
<a name="l00533"></a>00533 this_thread::disable_interruption di;
<a name="l00534"></a>00534 this_thread::disable_syscall_interruption dsi;
<a name="l00535"></a>00535 <span class="keywordflow">try</span> {
<a name="l00536"></a>00536 restartServer();
<a name="l00537"></a>00537 } <span class="keywordflow">catch</span> (<span class="keyword">const</span> <a class="code" href="classPassenger_1_1IOException.html" title="Represents an error that occured during an I/O operation.">IOException</a> &e) {
<a name="l00538"></a>00538 <span class="keywordflow">throw</span> prependMessageToException(e, <span class="stringliteral">"Could not start the spawn server"</span>);
<a name="l00539"></a>00539 } <span class="keywordflow">catch</span> (<span class="keyword">const</span> <a class="code" href="classPassenger_1_1SystemException.html" title="Represents an error returned by a system call or a standard library call.">SystemException</a> &e) {
<a name="l00540"></a>00540 <span class="keywordflow">throw</span> prependMessageToException(e, <span class="stringliteral">"Could not start the spawn server"</span>);
<a name="l00541"></a>00541 }
<a name="l00542"></a>00542 }
<a name="l00543"></a>00543
<a name="l00544"></a>00544 <span class="keyword">virtual</span> ~<a class="code" href="classPassenger_1_1SpawnManager.html" title="An AbstractSpawnManager implementation.">SpawnManager</a>() {
<a name="l00545"></a>00545 TRACE_POINT();
<a name="l00546"></a>00546 <span class="keywordflow">if</span> (pid != 0) {
<a name="l00547"></a>00547 UPDATE_TRACE_POINT();
<a name="l00548"></a>00548 this_thread::disable_interruption di;
<a name="l00549"></a>00549 this_thread::disable_syscall_interruption dsi;
<a name="l00550"></a>00550 syscalls::unlink(socketFilename.c_str());
<a name="l00551"></a>00551 ownerSocket.<a class="code" href="classPassenger_1_1FileDescriptor.html#d7c1a99531181878cbab74a7400c5432" title="Close the underlying file descriptor.">close</a>();
<a name="l00552"></a>00552 syscalls::waitpid(pid, NULL, 0);
<a name="l00553"></a>00553 }
<a name="l00554"></a>00554 }
<a name="l00555"></a>00555
<a name="l00556"></a><a class="code" href="classPassenger_1_1SpawnManager.html#88a94ba4d41dab492cb1dc8a0f998973">00556</a> <span class="keyword">virtual</span> <a class="code" href="namespacePassenger.html#ced1f248465136b313c6dec5fe6ca492" title="Convenient alias for Process smart pointer.">ProcessPtr</a> <a class="code" href="classPassenger_1_1SpawnManager.html#88a94ba4d41dab492cb1dc8a0f998973" title="Spawn a new application process.">spawn</a>(<span class="keyword">const</span> <a class="code" href="structPassenger_1_1PoolOptions.html" title="This struct encapsulates information for ApplicationPool::get() and for SpawnManager::spawn()...">PoolOptions</a> &options) {
<a name="l00557"></a>00557 TRACE_POINT();
<a name="l00558"></a>00558 boost::mutex::scoped_lock l(lock);
<a name="l00559"></a>00559 <span class="keywordflow">try</span> {
<a name="l00560"></a>00560 <span class="keywordflow">return</span> sendSpawnCommand(options);
<a name="l00561"></a>00561 } <span class="keywordflow">catch</span> (<span class="keyword">const</span> <a class="code" href="classPassenger_1_1SpawnException.html" title="Thrown when SpawnManager or ApplicationPool fails to spawn an application instance...">SpawnException</a> &e) {
<a name="l00562"></a>00562 <span class="keywordflow">if</span> (e.<a class="code" href="classPassenger_1_1SpawnException.html#e65dc272e183fd9e5637a4091cc6bbf4" title="Check whether an error page is available.">hasErrorPage</a>()) {
<a name="l00563"></a>00563 <span class="keywordflow">throw</span>;
<a name="l00564"></a>00564 } <span class="keywordflow">else</span> {
<a name="l00565"></a>00565 <span class="keywordflow">return</span> handleSpawnException(e, options);
<a name="l00566"></a>00566 }
<a name="l00567"></a>00567 }
<a name="l00568"></a>00568 }
<a name="l00569"></a>00569
<a name="l00570"></a><a class="code" href="classPassenger_1_1SpawnManager.html#ad71b2ea9431f3286f23a6e6f80e0981">00570</a> <span class="keyword">virtual</span> <span class="keywordtype">void</span> <a class="code" href="classPassenger_1_1SpawnManager.html#ad71b2ea9431f3286f23a6e6f80e0981" title="Shutdown the ApplicationSpawner server that&#39;s running at the given application...">reload</a>(<span class="keyword">const</span> <span class="keywordtype">string</span> &appRoot) {
<a name="l00571"></a>00571 TRACE_POINT();
<a name="l00572"></a>00572 this_thread::disable_interruption di;
<a name="l00573"></a>00573 this_thread::disable_syscall_interruption dsi;
<a name="l00574"></a>00574 <span class="keywordflow">try</span> {
<a name="l00575"></a>00575 <span class="keywordflow">return</span> sendReloadCommand(appRoot);
<a name="l00576"></a>00576 } <span class="keywordflow">catch</span> (<span class="keyword">const</span> <a class="code" href="classPassenger_1_1SystemException.html" title="Represents an error returned by a system call or a standard library call.">SystemException</a> &e) {
<a name="l00577"></a>00577 <span class="keywordflow">return</span> handleReloadException(e, appRoot);
<a name="l00578"></a>00578 }
<a name="l00579"></a>00579 }
<a name="l00580"></a>00580
<a name="l00581"></a><a class="code" href="classPassenger_1_1SpawnManager.html#9210212c23c5a8ee5ee4dd5c9dcdf57d">00581</a> <span class="keyword">virtual</span> <span class="keywordtype">void</span> <a class="code" href="classPassenger_1_1SpawnManager.html#9210212c23c5a8ee5ee4dd5c9dcdf57d" title="Forcefully kill the spawn server.">killSpawnServer</a>()<span class="keyword"> const </span>{
<a name="l00582"></a>00582 kill(pid, SIGKILL);
<a name="l00583"></a>00583 }
<a name="l00584"></a>00584
<a name="l00585"></a><a class="code" href="classPassenger_1_1SpawnManager.html#f34df8cfccfc64507999f1b48bc5a126">00585</a> <span class="keyword">virtual</span> pid_t <a class="code" href="classPassenger_1_1SpawnManager.html#f34df8cfccfc64507999f1b48bc5a126" title="Returns the spawn server&#39;s PID.">getServerPid</a>()<span class="keyword"> const </span>{
<a name="l00586"></a>00586 <span class="keywordflow">return</span> pid;
<a name="l00587"></a>00587 }
<a name="l00588"></a>00588 };
<a name="l00589"></a>00589 <span class="comment"></span>
<a name="l00590"></a>00590 <span class="comment">/** Convenient alias for SpawnManager smart pointer. */</span>
<a name="l00591"></a><a class="code" href="namespacePassenger.html#6ab2d566ff87a2676c23d8aa40204587">00591</a> <span class="keyword">typedef</span> shared_ptr<SpawnManager> <a class="code" href="namespacePassenger.html#6ab2d566ff87a2676c23d8aa40204587" title="Convenient alias for SpawnManager smart pointer.">SpawnManagerPtr</a>;
<a name="l00592"></a>00592
<a name="l00593"></a>00593 } <span class="comment">// namespace Passenger</span>
<a name="l00594"></a>00594
<a name="l00595"></a>00595 <span class="preprocessor">#endif </span><span class="comment">/* _PASSENGER_SPAWN_MANAGER_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
<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>
|
