passenger 2.0.3 → 2.0.4
Sign up to get free protection for your applications and to get access to all the features.
Potentially problematic release.
This version of passenger might be problematic. Click here for more details.
- data/Rakefile +8 -5
- data/bin/passenger-install-apache2-module +6 -1
- data/doc/ApplicationPool algorithm.txt +23 -5
- data/doc/Architectural overview.html +778 -0
- data/doc/Security of user switching support.html +1 -1
- data/doc/Users guide.html +113 -31
- data/doc/Users guide.txt +104 -10
- data/doc/cxxapi/ApplicationPoolServer_8h-source.html +683 -0
- data/doc/cxxapi/ApplicationPool_8h-source.html +224 -0
- data/doc/cxxapi/Application_8h-source.html +448 -0
- data/doc/cxxapi/Bucket_8h-source.html +61 -0
- data/doc/cxxapi/Configuration_8h-source.html +195 -0
- data/doc/cxxapi/DummySpawnManager_8h-source.html +126 -0
- data/doc/cxxapi/Exceptions_8h-source.html +244 -0
- data/doc/cxxapi/Hooks_8h-source.html +63 -0
- data/doc/cxxapi/Logging_8h-source.html +136 -0
- data/doc/cxxapi/MessageChannel_8h-source.html +524 -0
- data/doc/cxxapi/SpawnManager_8h-source.html +593 -0
- data/doc/cxxapi/StandardApplicationPool_8h-source.html +732 -0
- data/doc/cxxapi/System_8h-source.html +251 -0
- data/doc/cxxapi/Utils_8h-source.html +283 -0
- data/doc/cxxapi/annotated.html +59 -0
- data/doc/cxxapi/classClient-members.html +35 -0
- data/doc/cxxapi/classClient.html +117 -0
- data/doc/cxxapi/classDirectoryMapper-members.html +38 -0
- data/doc/cxxapi/classDirectoryMapper.html +203 -0
- data/doc/cxxapi/classHooks-members.html +33 -0
- data/doc/cxxapi/classHooks.html +43 -0
- data/doc/cxxapi/classPassenger_1_1Application-members.html +38 -0
- data/doc/cxxapi/classPassenger_1_1Application.html +229 -0
- data/doc/cxxapi/classPassenger_1_1ApplicationPool-members.html +41 -0
- data/doc/cxxapi/classPassenger_1_1ApplicationPool.html +359 -0
- data/doc/cxxapi/classPassenger_1_1ApplicationPoolServer-members.html +36 -0
- data/doc/cxxapi/classPassenger_1_1ApplicationPoolServer.html +225 -0
- data/doc/cxxapi/classPassenger_1_1ApplicationPool__inherit__graph.map +1 -0
- data/doc/cxxapi/classPassenger_1_1ApplicationPool__inherit__graph.md5 +1 -0
- data/doc/cxxapi/classPassenger_1_1ApplicationPool__inherit__graph.png +0 -0
- data/doc/cxxapi/classPassenger_1_1Application_1_1Session-members.html +43 -0
- data/doc/cxxapi/classPassenger_1_1Application_1_1Session.html +329 -0
- data/doc/cxxapi/classPassenger_1_1BusyException-members.html +33 -0
- data/doc/cxxapi/classPassenger_1_1BusyException.html +47 -0
- data/doc/cxxapi/classPassenger_1_1ConfigurationException-members.html +33 -0
- data/doc/cxxapi/classPassenger_1_1ConfigurationException.html +44 -0
- data/doc/cxxapi/classPassenger_1_1DummySpawnManager-members.html +33 -0
- data/doc/cxxapi/classPassenger_1_1DummySpawnManager.html +51 -0
- data/doc/cxxapi/classPassenger_1_1FileNotFoundException-members.html +33 -0
- data/doc/cxxapi/classPassenger_1_1FileNotFoundException.html +51 -0
- data/doc/cxxapi/classPassenger_1_1FileNotFoundException__inherit__graph.map +1 -0
- data/doc/cxxapi/classPassenger_1_1FileNotFoundException__inherit__graph.md5 +1 -0
- data/doc/cxxapi/classPassenger_1_1FileNotFoundException__inherit__graph.png +0 -0
- data/doc/cxxapi/classPassenger_1_1FileSystemException-members.html +38 -0
- data/doc/cxxapi/classPassenger_1_1FileSystemException.html +61 -0
- data/doc/cxxapi/classPassenger_1_1FileSystemException__inherit__graph.map +1 -0
- data/doc/cxxapi/classPassenger_1_1FileSystemException__inherit__graph.md5 +1 -0
- data/doc/cxxapi/classPassenger_1_1FileSystemException__inherit__graph.png +0 -0
- data/doc/cxxapi/classPassenger_1_1IOException-members.html +33 -0
- data/doc/cxxapi/classPassenger_1_1IOException.html +54 -0
- data/doc/cxxapi/classPassenger_1_1IOException__inherit__graph.map +1 -0
- data/doc/cxxapi/classPassenger_1_1IOException__inherit__graph.md5 +1 -0
- data/doc/cxxapi/classPassenger_1_1IOException__inherit__graph.png +0 -0
- data/doc/cxxapi/classPassenger_1_1MessageChannel-members.html +47 -0
- data/doc/cxxapi/classPassenger_1_1MessageChannel.html +591 -0
- data/doc/cxxapi/classPassenger_1_1SpawnException-members.html +35 -0
- data/doc/cxxapi/classPassenger_1_1SpawnException.html +77 -0
- data/doc/cxxapi/classPassenger_1_1SpawnManager-members.html +37 -0
- data/doc/cxxapi/classPassenger_1_1SpawnManager.html +255 -0
- data/doc/cxxapi/classPassenger_1_1StandardApplicationPool-members.html +43 -0
- data/doc/cxxapi/classPassenger_1_1StandardApplicationPool.html +400 -0
- data/doc/cxxapi/classPassenger_1_1StandardApplicationPool__inherit__graph.map +1 -0
- data/doc/cxxapi/classPassenger_1_1StandardApplicationPool__inherit__graph.md5 +1 -0
- data/doc/cxxapi/classPassenger_1_1StandardApplicationPool__inherit__graph.png +0 -0
- data/doc/cxxapi/classPassenger_1_1SystemException-members.html +37 -0
- data/doc/cxxapi/classPassenger_1_1SystemException.html +154 -0
- data/doc/cxxapi/classPassenger_1_1SystemException__inherit__graph.map +1 -0
- data/doc/cxxapi/classPassenger_1_1SystemException__inherit__graph.md5 +1 -0
- data/doc/cxxapi/classPassenger_1_1SystemException__inherit__graph.png +0 -0
- data/doc/cxxapi/classPassenger_1_1TempFile-members.html +36 -0
- data/doc/cxxapi/classPassenger_1_1TempFile.html +128 -0
- data/doc/cxxapi/classPassenger_1_1Thread-members.html +35 -0
- data/doc/cxxapi/classPassenger_1_1Thread.html +100 -0
- data/doc/cxxapi/classboost_1_1this__thread_1_1disable__syscall__interruption-members.html +33 -0
- data/doc/cxxapi/classboost_1_1this__thread_1_1disable__syscall__interruption.html +46 -0
- data/doc/cxxapi/classboost_1_1this__thread_1_1enable__syscall__interruption-members.html +33 -0
- data/doc/cxxapi/classboost_1_1this__thread_1_1enable__syscall__interruption.html +44 -0
- data/doc/cxxapi/classboost_1_1this__thread_1_1restore__syscall__interruption-members.html +33 -0
- data/doc/cxxapi/classboost_1_1this__thread_1_1restore__syscall__interruption.html +44 -0
- data/doc/cxxapi/definitions_8h-source.html +28 -0
- data/doc/cxxapi/doxygen.css +433 -0
- data/doc/cxxapi/doxygen.png +0 -0
- data/doc/cxxapi/files.html +42 -0
- data/doc/cxxapi/ftv2blank.png +0 -0
- data/doc/cxxapi/ftv2doc.png +0 -0
- data/doc/cxxapi/ftv2folderclosed.png +0 -0
- data/doc/cxxapi/ftv2folderopen.png +0 -0
- data/doc/cxxapi/ftv2lastnode.png +0 -0
- data/doc/cxxapi/ftv2link.png +0 -0
- data/doc/cxxapi/ftv2mlastnode.png +0 -0
- data/doc/cxxapi/ftv2mnode.png +0 -0
- data/doc/cxxapi/ftv2node.png +0 -0
- data/doc/cxxapi/ftv2plastnode.png +0 -0
- data/doc/cxxapi/ftv2pnode.png +0 -0
- data/doc/cxxapi/ftv2vertline.png +0 -0
- data/doc/cxxapi/functions.html +215 -0
- data/doc/cxxapi/functions_func.html +210 -0
- data/doc/cxxapi/functions_type.html +46 -0
- data/doc/cxxapi/functions_vars.html +48 -0
- data/doc/cxxapi/graph_legend.dot +22 -0
- data/doc/cxxapi/graph_legend.html +87 -0
- data/doc/cxxapi/graph_legend.png +0 -0
- data/doc/cxxapi/group__Configuration.html +236 -0
- data/doc/cxxapi/group__Configuration.png +0 -0
- data/doc/cxxapi/group__Core.html +51 -0
- data/doc/cxxapi/group__Core.png +0 -0
- data/doc/cxxapi/group__Exceptions.html +43 -0
- data/doc/cxxapi/group__Hooks.html +46 -0
- data/doc/cxxapi/group__Hooks.png +0 -0
- data/doc/cxxapi/group__Support.html +406 -0
- data/doc/cxxapi/hierarchy.html +67 -0
- data/doc/cxxapi/index.html +11 -0
- data/doc/cxxapi/inherit__graph__0.map +1 -0
- data/doc/cxxapi/inherit__graph__0.md5 +1 -0
- data/doc/cxxapi/inherit__graph__0.png +0 -0
- data/doc/cxxapi/inherit__graph__1.map +1 -0
- data/doc/cxxapi/inherit__graph__1.md5 +1 -0
- data/doc/cxxapi/inherit__graph__1.png +0 -0
- data/doc/cxxapi/inherit__graph__10.map +1 -0
- data/doc/cxxapi/inherit__graph__10.md5 +1 -0
- data/doc/cxxapi/inherit__graph__10.png +0 -0
- data/doc/cxxapi/inherit__graph__11.map +1 -0
- data/doc/cxxapi/inherit__graph__11.md5 +1 -0
- data/doc/cxxapi/inherit__graph__11.png +0 -0
- data/doc/cxxapi/inherit__graph__12.map +1 -0
- data/doc/cxxapi/inherit__graph__12.md5 +1 -0
- data/doc/cxxapi/inherit__graph__12.png +0 -0
- data/doc/cxxapi/inherit__graph__13.map +1 -0
- data/doc/cxxapi/inherit__graph__13.md5 +1 -0
- data/doc/cxxapi/inherit__graph__13.png +0 -0
- data/doc/cxxapi/inherit__graph__14.map +2 -0
- data/doc/cxxapi/inherit__graph__14.md5 +1 -0
- data/doc/cxxapi/inherit__graph__14.png +0 -0
- data/doc/cxxapi/inherit__graph__15.map +1 -0
- data/doc/cxxapi/inherit__graph__15.md5 +1 -0
- data/doc/cxxapi/inherit__graph__15.png +0 -0
- data/doc/cxxapi/inherit__graph__16.map +1 -0
- data/doc/cxxapi/inherit__graph__16.md5 +1 -0
- data/doc/cxxapi/inherit__graph__16.png +0 -0
- data/doc/cxxapi/inherit__graph__17.map +1 -0
- data/doc/cxxapi/inherit__graph__17.md5 +1 -0
- data/doc/cxxapi/inherit__graph__17.png +0 -0
- data/doc/cxxapi/inherit__graph__18.map +1 -0
- data/doc/cxxapi/inherit__graph__18.md5 +1 -0
- data/doc/cxxapi/inherit__graph__18.png +0 -0
- data/doc/cxxapi/inherit__graph__19.map +2 -0
- data/doc/cxxapi/inherit__graph__19.md5 +1 -0
- data/doc/cxxapi/inherit__graph__19.png +0 -0
- data/doc/cxxapi/inherit__graph__2.map +1 -0
- data/doc/cxxapi/inherit__graph__2.md5 +1 -0
- data/doc/cxxapi/inherit__graph__2.png +0 -0
- data/doc/cxxapi/inherit__graph__20.map +1 -0
- data/doc/cxxapi/inherit__graph__20.md5 +1 -0
- data/doc/cxxapi/inherit__graph__20.png +0 -0
- data/doc/cxxapi/inherit__graph__21.map +1 -0
- data/doc/cxxapi/inherit__graph__21.md5 +1 -0
- data/doc/cxxapi/inherit__graph__21.png +0 -0
- data/doc/cxxapi/inherit__graph__3.map +1 -0
- data/doc/cxxapi/inherit__graph__3.md5 +1 -0
- data/doc/cxxapi/inherit__graph__3.png +0 -0
- data/doc/cxxapi/inherit__graph__4.map +1 -0
- data/doc/cxxapi/inherit__graph__4.md5 +1 -0
- data/doc/cxxapi/inherit__graph__4.png +0 -0
- data/doc/cxxapi/inherit__graph__5.map +1 -0
- data/doc/cxxapi/inherit__graph__5.md5 +1 -0
- data/doc/cxxapi/inherit__graph__5.png +0 -0
- data/doc/cxxapi/inherit__graph__6.map +1 -0
- data/doc/cxxapi/inherit__graph__6.md5 +1 -0
- data/doc/cxxapi/inherit__graph__6.png +0 -0
- data/doc/cxxapi/inherit__graph__7.map +1 -0
- data/doc/cxxapi/inherit__graph__7.md5 +1 -0
- data/doc/cxxapi/inherit__graph__7.png +0 -0
- data/doc/cxxapi/inherit__graph__8.map +1 -0
- data/doc/cxxapi/inherit__graph__8.md5 +1 -0
- data/doc/cxxapi/inherit__graph__8.png +0 -0
- data/doc/cxxapi/inherit__graph__9.map +2 -0
- data/doc/cxxapi/inherit__graph__9.md5 +1 -0
- data/doc/cxxapi/inherit__graph__9.png +0 -0
- data/doc/cxxapi/inherits.html +102 -0
- data/doc/cxxapi/main.html +27 -0
- data/doc/cxxapi/modules.html +34 -0
- data/doc/cxxapi/namespacePassenger.html +208 -0
- data/doc/cxxapi/namespacePassenger_1_1InterruptableCalls.html +43 -0
- data/doc/cxxapi/namespacemembers.html +70 -0
- data/doc/cxxapi/namespacemembers_func.html +66 -0
- data/doc/cxxapi/namespacemembers_type.html +46 -0
- data/doc/cxxapi/namespaces.html +35 -0
- data/doc/cxxapi/structPassenger_1_1AnythingToString-members.html +33 -0
- data/doc/cxxapi/structPassenger_1_1AnythingToString.html +49 -0
- data/doc/cxxapi/structPassenger_1_1AnythingToString_3_01vector_3_01string_01_4_01_4-members.html +33 -0
- data/doc/cxxapi/structPassenger_1_1AnythingToString_3_01vector_3_01string_01_4_01_4.html +49 -0
- data/doc/cxxapi/tab_b.gif +0 -0
- data/doc/cxxapi/tab_l.gif +0 -0
- data/doc/cxxapi/tab_r.gif +0 -0
- data/doc/cxxapi/tabs.css +102 -0
- data/doc/cxxapi/tree.html +167 -0
- data/doc/rdoc/classes/ConditionVariable.html +160 -0
- data/doc/rdoc/classes/Exception.html +120 -0
- data/doc/rdoc/classes/GC.html +113 -0
- data/doc/rdoc/classes/IO.html +150 -0
- data/doc/rdoc/classes/Passenger.html +136 -0
- data/doc/rdoc/classes/Passenger/AbstractRequestHandler.html +402 -0
- data/doc/rdoc/classes/Passenger/AbstractServer.html +649 -0
- data/doc/rdoc/classes/Passenger/AbstractServer/ServerAlreadyStarted.html +97 -0
- data/doc/rdoc/classes/Passenger/AbstractServer/ServerError.html +96 -0
- data/doc/rdoc/classes/Passenger/AbstractServer/ServerNotStarted.html +97 -0
- data/doc/rdoc/classes/Passenger/AbstractServer/UnknownMessage.html +96 -0
- data/doc/rdoc/classes/Passenger/AppInitError.html +137 -0
- data/doc/rdoc/classes/Passenger/Application.html +298 -0
- data/doc/rdoc/classes/Passenger/ConsoleTextTemplate.html +172 -0
- data/doc/rdoc/classes/Passenger/FrameworkInitError.html +143 -0
- data/doc/rdoc/classes/Passenger/HTMLTemplate.html +175 -0
- data/doc/rdoc/classes/Passenger/InitializationError.html +141 -0
- data/doc/rdoc/classes/Passenger/MessageChannel.html +488 -0
- data/doc/rdoc/classes/Passenger/NativeSupport.html +320 -0
- data/doc/rdoc/classes/Passenger/SpawnManager.html +375 -0
- data/doc/rdoc/classes/Passenger/UnknownError.html +125 -0
- data/doc/rdoc/classes/Passenger/Utils.html +578 -0
- data/doc/rdoc/classes/Passenger/VersionNotFound.html +140 -0
- data/doc/rdoc/classes/PlatformInfo.html +302 -0
- data/doc/rdoc/classes/RakeExtensions.html +197 -0
- data/doc/rdoc/created.rid +1 -0
- data/doc/rdoc/files/DEVELOPERS_TXT.html +230 -0
- data/doc/rdoc/files/README.html +150 -0
- data/doc/rdoc/files/ext/passenger/native_support_c.html +92 -0
- data/doc/rdoc/files/lib/passenger/abstract_request_handler_rb.html +126 -0
- data/doc/rdoc/files/lib/passenger/abstract_server_rb.html +127 -0
- data/doc/rdoc/files/lib/passenger/application_rb.html +123 -0
- data/doc/rdoc/files/lib/passenger/console_text_template_rb.html +122 -0
- data/doc/rdoc/files/lib/passenger/constants_rb.html +114 -0
- data/doc/rdoc/files/lib/passenger/dependencies_rb.html +130 -0
- data/doc/rdoc/files/lib/passenger/exceptions_rb.html +118 -0
- data/doc/rdoc/files/lib/passenger/html_template_rb.html +122 -0
- data/doc/rdoc/files/lib/passenger/message_channel_rb.html +118 -0
- data/doc/rdoc/files/lib/passenger/platform_info_rb.html +122 -0
- data/doc/rdoc/files/lib/passenger/simple_benchmarking_rb.html +118 -0
- data/doc/rdoc/files/lib/passenger/spawn_manager_rb.html +139 -0
- data/doc/rdoc/files/lib/passenger/utils_rb.html +130 -0
- data/doc/rdoc/files/lib/rake/extensions_rb.html +122 -0
- data/doc/rdoc/fr_class_index.html +71 -0
- data/doc/rdoc/fr_file_index.html +63 -0
- data/doc/rdoc/fr_method_index.html +120 -0
- data/doc/rdoc/index.html +26 -0
- data/doc/rdoc/rdoc-style.css +187 -0
- data/ext/apache2/ApplicationPool.h +12 -0
- data/ext/apache2/ApplicationPoolServer.h +6 -0
- data/ext/apache2/ApplicationPoolServerExecutable.cpp +6 -0
- data/ext/apache2/Bucket.cpp +63 -69
- data/ext/apache2/Bucket.h +2 -0
- data/ext/apache2/Configuration.cpp +24 -0
- data/ext/apache2/Configuration.h +16 -1
- data/ext/apache2/Hooks.cpp +5 -3
- data/ext/apache2/StandardApplicationPool.h +30 -11
- data/lib/passenger/abstract_request_handler.rb +3 -0
- data/lib/passenger/abstract_server.rb +3 -3
- data/lib/passenger/application.rb +4 -2
- data/lib/passenger/dependencies.rb +10 -1
- data/lib/passenger/platform_info.rb +40 -1
- data/lib/passenger/rack/request_handler.rb +4 -2
- data/lib/passenger/railz/application_spawner.rb +7 -1
- data/lib/passenger/utils.rb +6 -8
- data/lib/rake/gempackagetask.rb +0 -6
- data/lib/rake/rdoctask.rb +84 -23
- data/test/ApplicationPoolTest.cpp +36 -0
- data/test/ruby/rails/minimal_spawner_spec.rb +8 -0
- data/test/ruby/utils_spec.rb +33 -0
- data/test/stub/rails_apps/foobar/config/environments/production.rb +0 -1
- metadata +262 -5
|
@@ -0,0 +1,593 @@
|
|
|
1
|
+
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
2
|
+
<html><head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
|
|
3
|
+
<title>Passenger: SpawnManager.h Source File</title>
|
|
4
|
+
<link href="doxygen.css" rel="stylesheet" type="text/css">
|
|
5
|
+
<link href="tabs.css" rel="stylesheet" type="text/css">
|
|
6
|
+
</head><body>
|
|
7
|
+
<!-- Generated by Doxygen 1.5.5 -->
|
|
8
|
+
<div class="navigation" id="top">
|
|
9
|
+
<div class="tabs">
|
|
10
|
+
<ul>
|
|
11
|
+
<li><a href="main.html"><span>Main Page</span></a></li>
|
|
12
|
+
<li><a href="modules.html"><span>Modules</span></a></li>
|
|
13
|
+
<li><a href="namespaces.html"><span>Namespaces</span></a></li>
|
|
14
|
+
<li><a href="annotated.html"><span>Classes</span></a></li>
|
|
15
|
+
<li class="current"><a href="files.html"><span>Files</span></a></li>
|
|
16
|
+
</ul>
|
|
17
|
+
</div>
|
|
18
|
+
<h1>SpawnManager.h</h1><div class="fragment"><pre class="fragment"><a name="l00001"></a>00001 <span class="comment">/*</span>
|
|
19
|
+
<a name="l00002"></a>00002 <span class="comment"> * Phusion Passenger - http://www.modrails.com/</span>
|
|
20
|
+
<a name="l00003"></a>00003 <span class="comment"> * Copyright (C) 2008 Phusion</span>
|
|
21
|
+
<a name="l00004"></a>00004 <span class="comment"> *</span>
|
|
22
|
+
<a name="l00005"></a>00005 <span class="comment"> * Phusion Passenger is a trademark of Hongli Lai & Ninh Bui.</span>
|
|
23
|
+
<a name="l00006"></a>00006 <span class="comment"> *</span>
|
|
24
|
+
<a name="l00007"></a>00007 <span class="comment"> * This program is free software; you can redistribute it and/or modify</span>
|
|
25
|
+
<a name="l00008"></a>00008 <span class="comment"> * it under the terms of the GNU General Public License as published by</span>
|
|
26
|
+
<a name="l00009"></a>00009 <span class="comment"> * the Free Software Foundation; version 2 of the License.</span>
|
|
27
|
+
<a name="l00010"></a>00010 <span class="comment"> *</span>
|
|
28
|
+
<a name="l00011"></a>00011 <span class="comment"> * This program is distributed in the hope that it will be useful,</span>
|
|
29
|
+
<a name="l00012"></a>00012 <span class="comment"> * but WITHOUT ANY WARRANTY; without even the implied warranty of</span>
|
|
30
|
+
<a name="l00013"></a>00013 <span class="comment"> * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the</span>
|
|
31
|
+
<a name="l00014"></a>00014 <span class="comment"> * GNU General Public License for more details.</span>
|
|
32
|
+
<a name="l00015"></a>00015 <span class="comment"> *</span>
|
|
33
|
+
<a name="l00016"></a>00016 <span class="comment"> * You should have received a copy of the GNU General Public License along</span>
|
|
34
|
+
<a name="l00017"></a>00017 <span class="comment"> * with this program; if not, write to the Free Software Foundation, Inc.,</span>
|
|
35
|
+
<a name="l00018"></a>00018 <span class="comment"> * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.</span>
|
|
36
|
+
<a name="l00019"></a>00019 <span class="comment"> */</span>
|
|
37
|
+
<a name="l00020"></a>00020 <span class="preprocessor">#ifndef _PASSENGER_SPAWN_MANAGER_H_</span>
|
|
38
|
+
<a name="l00021"></a>00021 <span class="preprocessor"></span><span class="preprocessor">#define _PASSENGER_SPAWN_MANAGER_H_</span>
|
|
39
|
+
<a name="l00022"></a>00022 <span class="preprocessor"></span>
|
|
40
|
+
<a name="l00023"></a>00023 <span class="preprocessor">#include <string></span>
|
|
41
|
+
<a name="l00024"></a>00024 <span class="preprocessor">#include <list></span>
|
|
42
|
+
<a name="l00025"></a>00025 <span class="preprocessor">#include <boost/shared_ptr.hpp></span>
|
|
43
|
+
<a name="l00026"></a>00026 <span class="preprocessor">#include <boost/thread.hpp></span>
|
|
44
|
+
<a name="l00027"></a>00027
|
|
45
|
+
<a name="l00028"></a>00028 <span class="preprocessor">#include <sys/types.h></span>
|
|
46
|
+
<a name="l00029"></a>00029 <span class="preprocessor">#include <sys/wait.h></span>
|
|
47
|
+
<a name="l00030"></a>00030 <span class="preprocessor">#include <sys/stat.h></span>
|
|
48
|
+
<a name="l00031"></a>00031 <span class="preprocessor">#include <arpa/inet.h></span>
|
|
49
|
+
<a name="l00032"></a>00032 <span class="preprocessor">#include <cstdio></span>
|
|
50
|
+
<a name="l00033"></a>00033 <span class="preprocessor">#include <cstdarg></span>
|
|
51
|
+
<a name="l00034"></a>00034 <span class="preprocessor">#include <unistd.h></span>
|
|
52
|
+
<a name="l00035"></a>00035 <span class="preprocessor">#include <errno.h></span>
|
|
53
|
+
<a name="l00036"></a>00036 <span class="preprocessor">#include <pwd.h></span>
|
|
54
|
+
<a name="l00037"></a>00037 <span class="preprocessor">#include <signal.h></span>
|
|
55
|
+
<a name="l00038"></a>00038
|
|
56
|
+
<a name="l00039"></a>00039 <span class="preprocessor">#include "Application.h"</span>
|
|
57
|
+
<a name="l00040"></a>00040 <span class="preprocessor">#include "MessageChannel.h"</span>
|
|
58
|
+
<a name="l00041"></a>00041 <span class="preprocessor">#include "Exceptions.h"</span>
|
|
59
|
+
<a name="l00042"></a>00042 <span class="preprocessor">#include "Logging.h"</span>
|
|
60
|
+
<a name="l00043"></a>00043 <span class="preprocessor">#include "System.h"</span>
|
|
61
|
+
<a name="l00044"></a>00044
|
|
62
|
+
<a name="l00045"></a>00045 <span class="keyword">namespace </span>Passenger {
|
|
63
|
+
<a name="l00046"></a>00046
|
|
64
|
+
<a name="l00047"></a>00047 <span class="keyword">using namespace </span>std;
|
|
65
|
+
<a name="l00048"></a>00048 <span class="keyword">using namespace </span>boost;
|
|
66
|
+
<a name="l00049"></a>00049 <span class="comment"></span>
|
|
67
|
+
<a name="l00050"></a>00050 <span class="comment">/**</span>
|
|
68
|
+
<a name="l00051"></a>00051 <span class="comment"> * @brief Spawning of Ruby on Rails/Rack application instances.</span>
|
|
69
|
+
<a name="l00052"></a>00052 <span class="comment"> *</span>
|
|
70
|
+
<a name="l00053"></a>00053 <span class="comment"> * This class is responsible for spawning new instances of Ruby on Rails or</span>
|
|
71
|
+
<a name="l00054"></a>00054 <span class="comment"> * Rack applications. Use the spawn() method to do so.</span>
|
|
72
|
+
<a name="l00055"></a>00055 <span class="comment"> *</span>
|
|
73
|
+
<a name="l00056"></a>00056 <span class="comment"> * @note This class is fully thread-safe.</span>
|
|
74
|
+
<a name="l00057"></a>00057 <span class="comment"> *</span>
|
|
75
|
+
<a name="l00058"></a>00058 <span class="comment"> * <h2>Implementation details</h2></span>
|
|
76
|
+
<a name="l00059"></a>00059 <span class="comment"> * Internally, this class makes use of a spawn server, which is written in Ruby. This server</span>
|
|
77
|
+
<a name="l00060"></a>00060 <span class="comment"> * is automatically started when a SpawnManager instance is created, and automatically</span>
|
|
78
|
+
<a name="l00061"></a>00061 <span class="comment"> * shutdown when that instance is destroyed. The existance of the spawn server is almost</span>
|
|
79
|
+
<a name="l00062"></a>00062 <span class="comment"> * totally transparent to users of this class. Spawn requests are sent to the server,</span>
|
|
80
|
+
<a name="l00063"></a>00063 <span class="comment"> * and details about the spawned process is returned.</span>
|
|
81
|
+
<a name="l00064"></a>00064 <span class="comment"> *</span>
|
|
82
|
+
<a name="l00065"></a>00065 <span class="comment"> * If the spawn server dies during the middle of an operation, it will be restarted.</span>
|
|
83
|
+
<a name="l00066"></a>00066 <span class="comment"> * See spawn() for full details.</span>
|
|
84
|
+
<a name="l00067"></a>00067 <span class="comment"> *</span>
|
|
85
|
+
<a name="l00068"></a>00068 <span class="comment"> * The communication channel with the server is anonymous, i.e. no other processes</span>
|
|
86
|
+
<a name="l00069"></a>00069 <span class="comment"> * can access the communication channel, so communication is guaranteed to be safe</span>
|
|
87
|
+
<a name="l00070"></a>00070 <span class="comment"> * (unless, of course, if the spawn server itself is a trojan).</span>
|
|
88
|
+
<a name="l00071"></a>00071 <span class="comment"> *</span>
|
|
89
|
+
<a name="l00072"></a>00072 <span class="comment"> * The server will try to keep the spawning time as small as possible, by keeping</span>
|
|
90
|
+
<a name="l00073"></a>00073 <span class="comment"> * corresponding Ruby on Rails frameworks and application code in memory. So the second</span>
|
|
91
|
+
<a name="l00074"></a>00074 <span class="comment"> * time an instance of the same application is spawned, the spawn time is significantly</span>
|
|
92
|
+
<a name="l00075"></a>00075 <span class="comment"> * lower than the first time. Nevertheless, spawning is a relatively expensive operation</span>
|
|
93
|
+
<a name="l00076"></a>00076 <span class="comment"> * (compared to the processing of a typical HTTP request/response), and so should be</span>
|
|
94
|
+
<a name="l00077"></a>00077 <span class="comment"> * avoided whenever possible.</span>
|
|
95
|
+
<a name="l00078"></a>00078 <span class="comment"> *</span>
|
|
96
|
+
<a name="l00079"></a>00079 <span class="comment"> * See the documentation of the spawn server for full implementation details.</span>
|
|
97
|
+
<a name="l00080"></a>00080 <span class="comment"> *</span>
|
|
98
|
+
<a name="l00081"></a>00081 <span class="comment"> * @ingroup Support</span>
|
|
99
|
+
<a name="l00082"></a>00082 <span class="comment"> */</span>
|
|
100
|
+
<a name="l00083"></a><a class="code" href="classPassenger_1_1SpawnManager.html">00083</a> <span class="keyword">class </span><a class="code" href="classPassenger_1_1SpawnManager.html" title="Spawning of Ruby on Rails/Rack application instances.">SpawnManager</a> {
|
|
101
|
+
<a name="l00084"></a>00084 <span class="keyword">private</span>:
|
|
102
|
+
<a name="l00085"></a>00085 <span class="keyword">static</span> <span class="keyword">const</span> <span class="keywordtype">int</span> SPAWN_SERVER_INPUT_FD = 3;
|
|
103
|
+
<a name="l00086"></a>00086
|
|
104
|
+
<a name="l00087"></a>00087 <span class="keywordtype">string</span> spawnServerCommand;
|
|
105
|
+
<a name="l00088"></a>00088 <span class="keywordtype">string</span> logFile;
|
|
106
|
+
<a name="l00089"></a>00089 <span class="keywordtype">string</span> rubyCommand;
|
|
107
|
+
<a name="l00090"></a>00090 <span class="keywordtype">string</span> user;
|
|
108
|
+
<a name="l00091"></a>00091
|
|
109
|
+
<a name="l00092"></a>00092 mutex lock;
|
|
110
|
+
<a name="l00093"></a>00093
|
|
111
|
+
<a name="l00094"></a>00094 <a class="code" href="classPassenger_1_1MessageChannel.html" title="Convenience class for I/O operations on file descriptors.">MessageChannel</a> channel;
|
|
112
|
+
<a name="l00095"></a>00095 pid_t pid;
|
|
113
|
+
<a name="l00096"></a>00096 <span class="keywordtype">bool</span> serverNeedsRestart;
|
|
114
|
+
<a name="l00097"></a>00097 <span class="comment"></span>
|
|
115
|
+
<a name="l00098"></a>00098 <span class="comment"> /**</span>
|
|
116
|
+
<a name="l00099"></a>00099 <span class="comment"> * Restarts the spawn server.</span>
|
|
117
|
+
<a name="l00100"></a>00100 <span class="comment"> *</span>
|
|
118
|
+
<a name="l00101"></a>00101 <span class="comment"> * @pre System call interruption is disabled.</span>
|
|
119
|
+
<a name="l00102"></a>00102 <span class="comment"> * @throws SystemException An error occured while trying to setup the spawn server.</span>
|
|
120
|
+
<a name="l00103"></a>00103 <span class="comment"> * @throws IOException The specified log file could not be opened.</span>
|
|
121
|
+
<a name="l00104"></a>00104 <span class="comment"> */</span>
|
|
122
|
+
<a name="l00105"></a>00105 <span class="keywordtype">void</span> restartServer() {
|
|
123
|
+
<a name="l00106"></a>00106 <span class="keywordflow">if</span> (pid != 0) {
|
|
124
|
+
<a name="l00107"></a>00107 channel.<a class="code" href="classPassenger_1_1MessageChannel.html#06309e208fc5e10642a2e9bbe0f351eb" title="Close the underlying file descriptor.">close</a>();
|
|
125
|
+
<a name="l00108"></a>00108
|
|
126
|
+
<a name="l00109"></a>00109 <span class="comment">// Wait at most 5 seconds for the spawn server to exit.</span>
|
|
127
|
+
<a name="l00110"></a>00110 <span class="comment">// If that doesn't work, kill it, then wait at most 5 seconds</span>
|
|
128
|
+
<a name="l00111"></a>00111 <span class="comment">// for it to exit.</span>
|
|
129
|
+
<a name="l00112"></a>00112 time_t begin = InterruptableCalls::time(NULL);
|
|
130
|
+
<a name="l00113"></a>00113 <span class="keywordtype">bool</span> done = <span class="keyword">false</span>;
|
|
131
|
+
<a name="l00114"></a>00114 <span class="keywordflow">while</span> (!done && InterruptableCalls::time(NULL) - begin < 5) {
|
|
132
|
+
<a name="l00115"></a>00115 <span class="keywordflow">if</span> (InterruptableCalls::waitpid(pid, NULL, WNOHANG) > 0) {
|
|
133
|
+
<a name="l00116"></a>00116 done = <span class="keyword">true</span>;
|
|
134
|
+
<a name="l00117"></a>00117 } <span class="keywordflow">else</span> {
|
|
135
|
+
<a name="l00118"></a>00118 InterruptableCalls::usleep(100000);
|
|
136
|
+
<a name="l00119"></a>00119 }
|
|
137
|
+
<a name="l00120"></a>00120 }
|
|
138
|
+
<a name="l00121"></a>00121 <span class="keywordflow">if</span> (!done) {
|
|
139
|
+
<a name="l00122"></a>00122 P_TRACE(2, <span class="stringliteral">"Spawn server did not exit in time, killing it..."</span>);
|
|
140
|
+
<a name="l00123"></a>00123 InterruptableCalls::kill(pid, SIGTERM);
|
|
141
|
+
<a name="l00124"></a>00124 begin = InterruptableCalls::time(NULL);
|
|
142
|
+
<a name="l00125"></a>00125 <span class="keywordflow">while</span> (InterruptableCalls::time(NULL) - begin < 5) {
|
|
143
|
+
<a name="l00126"></a>00126 <span class="keywordflow">if</span> (InterruptableCalls::waitpid(pid, NULL, WNOHANG) > 0) {
|
|
144
|
+
<a name="l00127"></a>00127 <span class="keywordflow">break</span>;
|
|
145
|
+
<a name="l00128"></a>00128 } <span class="keywordflow">else</span> {
|
|
146
|
+
<a name="l00129"></a>00129 InterruptableCalls::usleep(100000);
|
|
147
|
+
<a name="l00130"></a>00130 }
|
|
148
|
+
<a name="l00131"></a>00131 }
|
|
149
|
+
<a name="l00132"></a>00132 P_TRACE(2, <span class="stringliteral">"Spawn server has exited."</span>);
|
|
150
|
+
<a name="l00133"></a>00133 }
|
|
151
|
+
<a name="l00134"></a>00134 pid = 0;
|
|
152
|
+
<a name="l00135"></a>00135 }
|
|
153
|
+
<a name="l00136"></a>00136
|
|
154
|
+
<a name="l00137"></a>00137 <span class="keywordtype">int</span> fds[2];
|
|
155
|
+
<a name="l00138"></a>00138 FILE *logFileHandle = NULL;
|
|
156
|
+
<a name="l00139"></a>00139
|
|
157
|
+
<a name="l00140"></a>00140 serverNeedsRestart = <span class="keyword">true</span>;
|
|
158
|
+
<a name="l00141"></a>00141 <span class="keywordflow">if</span> (InterruptableCalls::socketpair(AF_UNIX, SOCK_STREAM, 0, fds) == -1) {
|
|
159
|
+
<a name="l00142"></a>00142 <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>, errno);
|
|
160
|
+
<a name="l00143"></a>00143 }
|
|
161
|
+
<a name="l00144"></a>00144 <span class="keywordflow">if</span> (!logFile.empty()) {
|
|
162
|
+
<a name="l00145"></a>00145 logFileHandle = InterruptableCalls::fopen(logFile.c_str(), <span class="stringliteral">"a"</span>);
|
|
163
|
+
<a name="l00146"></a>00146 <span class="keywordflow">if</span> (logFileHandle == NULL) {
|
|
164
|
+
<a name="l00147"></a>00147 <span class="keywordtype">string</span> message(<span class="stringliteral">"Cannot open log file '"</span>);
|
|
165
|
+
<a name="l00148"></a>00148 message.append(logFile);
|
|
166
|
+
<a name="l00149"></a>00149 message.append(<span class="stringliteral">"' for writing."</span>);
|
|
167
|
+
<a name="l00150"></a>00150 <span class="keywordflow">throw</span> <a class="code" href="classPassenger_1_1IOException.html" title="Represents an error that occured during an I/O operation.">IOException</a>(message);
|
|
168
|
+
<a name="l00151"></a>00151 }
|
|
169
|
+
<a name="l00152"></a>00152 }
|
|
170
|
+
<a name="l00153"></a>00153
|
|
171
|
+
<a name="l00154"></a>00154 pid = InterruptableCalls::fork();
|
|
172
|
+
<a name="l00155"></a>00155 <span class="keywordflow">if</span> (pid == 0) {
|
|
173
|
+
<a name="l00156"></a>00156 <span class="keywordflow">if</span> (!logFile.empty()) {
|
|
174
|
+
<a name="l00157"></a>00157 dup2(fileno(logFileHandle), STDERR_FILENO);
|
|
175
|
+
<a name="l00158"></a>00158 fclose(logFileHandle);
|
|
176
|
+
<a name="l00159"></a>00159 }
|
|
177
|
+
<a name="l00160"></a>00160 dup2(STDERR_FILENO, STDOUT_FILENO);
|
|
178
|
+
<a name="l00161"></a>00161 dup2(fds[1], SPAWN_SERVER_INPUT_FD);
|
|
179
|
+
<a name="l00162"></a>00162
|
|
180
|
+
<a name="l00163"></a>00163 <span class="comment">// Close all unnecessary file descriptors</span>
|
|
181
|
+
<a name="l00164"></a>00164 <span class="keywordflow">for</span> (<span class="keywordtype">long</span> i = sysconf(_SC_OPEN_MAX) - 1; i > SPAWN_SERVER_INPUT_FD; i--) {
|
|
182
|
+
<a name="l00165"></a>00165 close(i);
|
|
183
|
+
<a name="l00166"></a>00166 }
|
|
184
|
+
<a name="l00167"></a>00167
|
|
185
|
+
<a name="l00168"></a>00168 <span class="keywordflow">if</span> (!user.empty()) {
|
|
186
|
+
<a name="l00169"></a>00169 <span class="keyword">struct </span>passwd *entry = getpwnam(user.c_str());
|
|
187
|
+
<a name="l00170"></a>00170 <span class="keywordflow">if</span> (entry != NULL) {
|
|
188
|
+
<a name="l00171"></a>00171 <span class="keywordflow">if</span> (setgid(entry->pw_gid) != 0) {
|
|
189
|
+
<a name="l00172"></a>00172 <span class="keywordtype">int</span> e = errno;
|
|
190
|
+
<a name="l00173"></a>00173 fprintf(stderr, <span class="stringliteral">"*** Passenger: cannot run spawn "</span>
|
|
191
|
+
<a name="l00174"></a>00174 <span class="stringliteral">"manager as group %d: %s (%d)\n"</span>,
|
|
192
|
+
<a name="l00175"></a>00175 entry->pw_gid,
|
|
193
|
+
<a name="l00176"></a>00176 strerror(e),
|
|
194
|
+
<a name="l00177"></a>00177 e);
|
|
195
|
+
<a name="l00178"></a>00178 }
|
|
196
|
+
<a name="l00179"></a>00179 <span class="keywordflow">if</span> (setuid(entry->pw_uid) != 0) {
|
|
197
|
+
<a name="l00180"></a>00180 <span class="keywordtype">int</span> e = errno;
|
|
198
|
+
<a name="l00181"></a>00181 fprintf(stderr, <span class="stringliteral">"*** Passenger: cannot run spawn "</span>
|
|
199
|
+
<a name="l00182"></a>00182 <span class="stringliteral">"manager as user %s (%d): %s (%d)\n"</span>,
|
|
200
|
+
<a name="l00183"></a>00183 user.c_str(), entry->pw_uid,
|
|
201
|
+
<a name="l00184"></a>00184 strerror(e),
|
|
202
|
+
<a name="l00185"></a>00185 e);
|
|
203
|
+
<a name="l00186"></a>00186 }
|
|
204
|
+
<a name="l00187"></a>00187 } <span class="keywordflow">else</span> {
|
|
205
|
+
<a name="l00188"></a>00188 fprintf(stderr, <span class="stringliteral">"*** Passenger: cannot run spawn manager "</span>
|
|
206
|
+
<a name="l00189"></a>00189 <span class="stringliteral">"as nonexistant user '%s'.\n"</span>,
|
|
207
|
+
<a name="l00190"></a>00190 user.c_str());
|
|
208
|
+
<a name="l00191"></a>00191 }
|
|
209
|
+
<a name="l00192"></a>00192 fflush(stderr);
|
|
210
|
+
<a name="l00193"></a>00193 }
|
|
211
|
+
<a name="l00194"></a>00194
|
|
212
|
+
<a name="l00195"></a>00195 execlp(rubyCommand.c_str(),
|
|
213
|
+
<a name="l00196"></a>00196 rubyCommand.c_str(),
|
|
214
|
+
<a name="l00197"></a>00197 spawnServerCommand.c_str(),
|
|
215
|
+
<a name="l00198"></a>00198 <span class="comment">// The spawn server changes the process names of the subservers</span>
|
|
216
|
+
<a name="l00199"></a>00199 <span class="comment">// that it starts, for better usability. However, the process name length</span>
|
|
217
|
+
<a name="l00200"></a>00200 <span class="comment">// (as shown by ps) is limited. Here, we try to expand that limit by</span>
|
|
218
|
+
<a name="l00201"></a>00201 <span class="comment">// deliberately passing a useless whitespace string to the spawn server.</span>
|
|
219
|
+
<a name="l00202"></a>00202 <span class="comment">// This argument is ignored by the spawn server. This works on some</span>
|
|
220
|
+
<a name="l00203"></a>00203 <span class="comment">// systems, such as Ubuntu Linux.</span>
|
|
221
|
+
<a name="l00204"></a>00204 <span class="stringliteral">" "</span>,
|
|
222
|
+
<a name="l00205"></a>00205 NULL);
|
|
223
|
+
<a name="l00206"></a>00206 <span class="keywordtype">int</span> e = errno;
|
|
224
|
+
<a name="l00207"></a>00207 fprintf(stderr, <span class="stringliteral">"*** Passenger ERROR: Could not start the spawn server: %s: %s (%d)\n"</span>,
|
|
225
|
+
<a name="l00208"></a>00208 rubyCommand.c_str(), strerror(e), e);
|
|
226
|
+
<a name="l00209"></a>00209 fflush(stderr);
|
|
227
|
+
<a name="l00210"></a>00210 _exit(1);
|
|
228
|
+
<a name="l00211"></a>00211 } <span class="keywordflow">else</span> <span class="keywordflow">if</span> (pid == -1) {
|
|
229
|
+
<a name="l00212"></a>00212 <span class="keywordtype">int</span> e = errno;
|
|
230
|
+
<a name="l00213"></a>00213 InterruptableCalls::close(fds[0]);
|
|
231
|
+
<a name="l00214"></a>00214 InterruptableCalls::close(fds[1]);
|
|
232
|
+
<a name="l00215"></a>00215 <span class="keywordflow">if</span> (logFileHandle != NULL) {
|
|
233
|
+
<a name="l00216"></a>00216 InterruptableCalls::fclose(logFileHandle);
|
|
234
|
+
<a name="l00217"></a>00217 }
|
|
235
|
+
<a name="l00218"></a>00218 pid = 0;
|
|
236
|
+
<a name="l00219"></a>00219 <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);
|
|
237
|
+
<a name="l00220"></a>00220 } <span class="keywordflow">else</span> {
|
|
238
|
+
<a name="l00221"></a>00221 InterruptableCalls::close(fds[1]);
|
|
239
|
+
<a name="l00222"></a>00222 <span class="keywordflow">if</span> (!logFile.empty()) {
|
|
240
|
+
<a name="l00223"></a>00223 InterruptableCalls::fclose(logFileHandle);
|
|
241
|
+
<a name="l00224"></a>00224 }
|
|
242
|
+
<a name="l00225"></a>00225 channel = <a class="code" href="classPassenger_1_1MessageChannel.html" title="Convenience class for I/O operations on file descriptors.">MessageChannel</a>(fds[0]);
|
|
243
|
+
<a name="l00226"></a>00226 serverNeedsRestart = <span class="keyword">false</span>;
|
|
244
|
+
<a name="l00227"></a>00227
|
|
245
|
+
<a name="l00228"></a>00228 <span class="preprocessor"> #ifdef TESTING_SPAWN_MANAGER</span>
|
|
246
|
+
<a name="l00229"></a>00229 <span class="preprocessor"></span> <span class="keywordflow">if</span> (nextRestartShouldFail) {
|
|
247
|
+
<a name="l00230"></a>00230 InterruptableCalls::kill(pid, SIGTERM);
|
|
248
|
+
<a name="l00231"></a>00231 InterruptableCalls::usleep(500000);
|
|
249
|
+
<a name="l00232"></a>00232 }
|
|
250
|
+
<a name="l00233"></a>00233 <span class="preprocessor"> #endif</span>
|
|
251
|
+
<a name="l00234"></a>00234 <span class="preprocessor"></span> }
|
|
252
|
+
<a name="l00235"></a>00235 }
|
|
253
|
+
<a name="l00236"></a>00236 <span class="comment"></span>
|
|
254
|
+
<a name="l00237"></a>00237 <span class="comment"> /**</span>
|
|
255
|
+
<a name="l00238"></a>00238 <span class="comment"> * Send the spawn command to the spawn server.</span>
|
|
256
|
+
<a name="l00239"></a>00239 <span class="comment"> *</span>
|
|
257
|
+
<a name="l00240"></a>00240 <span class="comment"> * @param appRoot The application root of the application to spawn.</span>
|
|
258
|
+
<a name="l00241"></a>00241 <span class="comment"> * @param lowerPrivilege Whether to lower the application's privileges.</span>
|
|
259
|
+
<a name="l00242"></a>00242 <span class="comment"> * @param lowestUser The user to fallback to if lowering privilege fails.</span>
|
|
260
|
+
<a name="l00243"></a>00243 <span class="comment"> * @param environment The RAILS_ENV/RACK_ENV environment that should be used.</span>
|
|
261
|
+
<a name="l00244"></a>00244 <span class="comment"> * @param spawnMethod The spawn method to use.</span>
|
|
262
|
+
<a name="l00245"></a>00245 <span class="comment"> * @param appType The application type.</span>
|
|
263
|
+
<a name="l00246"></a>00246 <span class="comment"> * @return An Application smart pointer, representing the spawned application.</span>
|
|
264
|
+
<a name="l00247"></a>00247 <span class="comment"> * @throws SpawnException Something went wrong.</span>
|
|
265
|
+
<a name="l00248"></a>00248 <span class="comment"> */</span>
|
|
266
|
+
<a name="l00249"></a>00249 <a class="code" href="namespacePassenger.html#6a15fd5e8765802a0b8b077e15297e18" title="Convenient alias for Application smart pointer.">ApplicationPtr</a> sendSpawnCommand(
|
|
267
|
+
<a name="l00250"></a>00250 <span class="keyword">const</span> <span class="keywordtype">string</span> &appRoot,
|
|
268
|
+
<a name="l00251"></a>00251 <span class="keywordtype">bool</span> lowerPrivilege,
|
|
269
|
+
<a name="l00252"></a>00252 <span class="keyword">const</span> <span class="keywordtype">string</span> &lowestUser,
|
|
270
|
+
<a name="l00253"></a>00253 <span class="keyword">const</span> <span class="keywordtype">string</span> &environment,
|
|
271
|
+
<a name="l00254"></a>00254 <span class="keyword">const</span> <span class="keywordtype">string</span> &spawnMethod,
|
|
272
|
+
<a name="l00255"></a>00255 <span class="keyword">const</span> <span class="keywordtype">string</span> &appType
|
|
273
|
+
<a name="l00256"></a>00256 ) {
|
|
274
|
+
<a name="l00257"></a>00257 vector<string> args;
|
|
275
|
+
<a name="l00258"></a>00258 <span class="keywordtype">int</span> ownerPipe;
|
|
276
|
+
<a name="l00259"></a>00259
|
|
277
|
+
<a name="l00260"></a>00260 <span class="keywordflow">try</span> {
|
|
278
|
+
<a name="l00261"></a>00261 channel.<a class="code" href="classPassenger_1_1MessageChannel.html#9ad7a978cf8409e01ab2f0a2b6be5a0a" title="Send an array message, which consists of the given elements, over the underlying...">write</a>(<span class="stringliteral">"spawn_application"</span>,
|
|
279
|
+
<a name="l00262"></a>00262 appRoot.c_str(),
|
|
280
|
+
<a name="l00263"></a>00263 (lowerPrivilege) ? <span class="stringliteral">"true"</span> : <span class="stringliteral">"false"</span>,
|
|
281
|
+
<a name="l00264"></a>00264 lowestUser.c_str(),
|
|
282
|
+
<a name="l00265"></a>00265 environment.c_str(),
|
|
283
|
+
<a name="l00266"></a>00266 spawnMethod.c_str(),
|
|
284
|
+
<a name="l00267"></a>00267 appType.c_str(),
|
|
285
|
+
<a name="l00268"></a>00268 NULL);
|
|
286
|
+
<a name="l00269"></a>00269 } <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) {
|
|
287
|
+
<a name="l00270"></a>00270 <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>
|
|
288
|
+
<a name="l00271"></a>00271 <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>());
|
|
289
|
+
<a name="l00272"></a>00272 }
|
|
290
|
+
<a name="l00273"></a>00273
|
|
291
|
+
<a name="l00274"></a>00274 <span class="keywordflow">try</span> {
|
|
292
|
+
<a name="l00275"></a>00275 <span class="comment">// Read status.</span>
|
|
293
|
+
<a name="l00276"></a>00276 <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)) {
|
|
294
|
+
<a name="l00277"></a>00277 <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>);
|
|
295
|
+
<a name="l00278"></a>00278 }
|
|
296
|
+
<a name="l00279"></a>00279 <span class="keywordflow">if</span> (args.size() != 1) {
|
|
297
|
+
<a name="l00280"></a>00280 <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>);
|
|
298
|
+
<a name="l00281"></a>00281 }
|
|
299
|
+
<a name="l00282"></a>00282 <span class="keywordflow">if</span> (args[0] == <span class="stringliteral">"error_page"</span>) {
|
|
300
|
+
<a name="l00283"></a>00283 <span class="keywordtype">string</span> errorPage;
|
|
301
|
+
<a name="l00284"></a>00284
|
|
302
|
+
<a name="l00285"></a>00285 <span class="keywordflow">if</span> (!channel.<a class="code" href="classPassenger_1_1MessageChannel.html#4ce6a0e751b5e3563bee583c231569bc" title="Read a scalar message from the underlying file descriptor.">readScalar</a>(errorPage)) {
|
|
303
|
+
<a name="l00286"></a>00286 <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>);
|
|
304
|
+
<a name="l00287"></a>00287 }
|
|
305
|
+
<a name="l00288"></a>00288 <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>,
|
|
306
|
+
<a name="l00289"></a>00289 errorPage);
|
|
307
|
+
<a name="l00290"></a>00290 } <span class="keywordflow">else</span> <span class="keywordflow">if</span> (args[0] != <span class="stringliteral">"ok"</span>) {
|
|
308
|
+
<a name="l00291"></a>00291 <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>);
|
|
309
|
+
<a name="l00292"></a>00292 }
|
|
310
|
+
<a name="l00293"></a>00293
|
|
311
|
+
<a name="l00294"></a>00294 <span class="comment">// Read application info.</span>
|
|
312
|
+
<a name="l00295"></a>00295 <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)) {
|
|
313
|
+
<a name="l00296"></a>00296 <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>);
|
|
314
|
+
<a name="l00297"></a>00297 }
|
|
315
|
+
<a name="l00298"></a>00298 } <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) {
|
|
316
|
+
<a name="l00299"></a>00299 <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>());
|
|
317
|
+
<a name="l00300"></a>00300 }
|
|
318
|
+
<a name="l00301"></a>00301
|
|
319
|
+
<a name="l00302"></a>00302 <span class="keywordflow">try</span> {
|
|
320
|
+
<a name="l00303"></a>00303 ownerPipe = channel.<a class="code" href="classPassenger_1_1MessageChannel.html#1561b7e4a0f4d39ea431f456e5655488" title="Receive a file descriptor, which had been passed over the underlying file descriptor...">readFileDescriptor</a>();
|
|
321
|
+
<a name="l00304"></a>00304 } <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) {
|
|
322
|
+
<a name="l00305"></a>00305 <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>
|
|
323
|
+
<a name="l00306"></a>00306 <span class="stringliteral">"application's owner pipe from the spawn server: "</span>) +
|
|
324
|
+
<a name="l00307"></a>00307 e.<a class="code" href="classPassenger_1_1SystemException.html#0ef41d755fea2c9b1db2252e7c418dc8" title="Returns the system&#39;s error message.">sys</a>());
|
|
325
|
+
<a name="l00308"></a>00308 } <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) {
|
|
326
|
+
<a name="l00309"></a>00309 <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>
|
|
327
|
+
<a name="l00310"></a>00310 <span class="stringliteral">"application's owner pipe from the spawn server: "</span>) +
|
|
328
|
+
<a name="l00311"></a>00311 e.<a class="code" href="classPassenger_1_1IOException.html#1b65d0fdb9bc5136f5b7df759c14768a">what</a>());
|
|
329
|
+
<a name="l00312"></a>00312 }
|
|
330
|
+
<a name="l00313"></a>00313
|
|
331
|
+
<a name="l00314"></a>00314 <span class="keywordflow">if</span> (args.size() != 3) {
|
|
332
|
+
<a name="l00315"></a>00315 InterruptableCalls::close(ownerPipe);
|
|
333
|
+
<a name="l00316"></a>00316 <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>);
|
|
334
|
+
<a name="l00317"></a>00317 }
|
|
335
|
+
<a name="l00318"></a>00318
|
|
336
|
+
<a name="l00319"></a>00319 pid_t pid = <a class="code" href="group__Support.html#g73b17b509ee44938a56bf16cbf82fb48" title="Converts the given string to an integer.">atoi</a>(args[0]);
|
|
337
|
+
<a name="l00320"></a>00320 <span class="keywordtype">bool</span> usingAbstractNamespace = args[2] == <span class="stringliteral">"true"</span>;
|
|
338
|
+
<a name="l00321"></a>00321
|
|
339
|
+
<a name="l00322"></a>00322 <span class="keywordflow">if</span> (!usingAbstractNamespace) {
|
|
340
|
+
<a name="l00323"></a>00323 <span class="keywordtype">int</span> ret;
|
|
341
|
+
<a name="l00324"></a>00324 <span class="keywordflow">do</span> {
|
|
342
|
+
<a name="l00325"></a>00325 ret = chmod(args[1].c_str(), S_IRUSR | S_IWUSR);
|
|
343
|
+
<a name="l00326"></a>00326 } <span class="keywordflow">while</span> (ret == -1 && errno == EINTR);
|
|
344
|
+
<a name="l00327"></a>00327 <span class="keywordflow">do</span> {
|
|
345
|
+
<a name="l00328"></a>00328 ret = chown(args[1].c_str(), getuid(), getgid());
|
|
346
|
+
<a name="l00329"></a>00329 } <span class="keywordflow">while</span> (ret == -1 && errno == EINTR);
|
|
347
|
+
<a name="l00330"></a>00330 }
|
|
348
|
+
<a name="l00331"></a>00331 <span class="keywordflow">return</span> <a class="code" href="namespacePassenger.html#6a15fd5e8765802a0b8b077e15297e18" title="Convenient alias for Application smart pointer.">ApplicationPtr</a>(<span class="keyword">new</span> <a class="code" href="classPassenger_1_1Application.html" title="Represents a single Ruby on Rails or Rack application instance.">Application</a>(appRoot, pid, args[1],
|
|
349
|
+
<a name="l00332"></a>00332 usingAbstractNamespace, ownerPipe));
|
|
350
|
+
<a name="l00333"></a>00333 }
|
|
351
|
+
<a name="l00334"></a>00334 <span class="comment"></span>
|
|
352
|
+
<a name="l00335"></a>00335 <span class="comment"> /**</span>
|
|
353
|
+
<a name="l00336"></a>00336 <span class="comment"> * @throws boost::thread_interrupted</span>
|
|
354
|
+
<a name="l00337"></a>00337 <span class="comment"> */</span>
|
|
355
|
+
<a name="l00338"></a>00338 <a class="code" href="namespacePassenger.html#6a15fd5e8765802a0b8b077e15297e18" title="Convenient alias for Application smart pointer.">ApplicationPtr</a>
|
|
356
|
+
<a name="l00339"></a>00339 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> <span class="keywordtype">string</span> &appRoot,
|
|
357
|
+
<a name="l00340"></a>00340 <span class="keywordtype">bool</span> lowerPrivilege, <span class="keyword">const</span> <span class="keywordtype">string</span> &lowestUser,
|
|
358
|
+
<a name="l00341"></a>00341 <span class="keyword">const</span> <span class="keywordtype">string</span> &environment, <span class="keyword">const</span> <span class="keywordtype">string</span> &spawnMethod,
|
|
359
|
+
<a name="l00342"></a>00342 <span class="keyword">const</span> <span class="keywordtype">string</span> &appType) {
|
|
360
|
+
<a name="l00343"></a>00343 <span class="keywordtype">bool</span> restarted;
|
|
361
|
+
<a name="l00344"></a>00344 <span class="keywordflow">try</span> {
|
|
362
|
+
<a name="l00345"></a>00345 P_DEBUG(<span class="stringliteral">"Spawn server died. Attempting to restart it..."</span>);
|
|
363
|
+
<a name="l00346"></a>00346 <a class="code" href="classboost_1_1this__thread_1_1disable__syscall__interruption.html" title="Create this struct on the stack to temporarily disable system call interruption,...">this_thread::disable_syscall_interruption</a> dsi;
|
|
364
|
+
<a name="l00347"></a>00347 restartServer();
|
|
365
|
+
<a name="l00348"></a>00348 P_DEBUG(<span class="stringliteral">"Restart seems to be successful."</span>);
|
|
366
|
+
<a name="l00349"></a>00349 restarted = <span class="keyword">true</span>;
|
|
367
|
+
<a name="l00350"></a>00350 } <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) {
|
|
368
|
+
<a name="l00351"></a>00351 P_DEBUG(<span class="stringliteral">"Restart failed: "</span> << e.<a class="code" href="classPassenger_1_1IOException.html#1b65d0fdb9bc5136f5b7df759c14768a">what</a>());
|
|
369
|
+
<a name="l00352"></a>00352 restarted = <span class="keyword">false</span>;
|
|
370
|
+
<a name="l00353"></a>00353 } <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) {
|
|
371
|
+
<a name="l00354"></a>00354 P_DEBUG(<span class="stringliteral">"Restart failed: "</span> << e.<a class="code" href="classPassenger_1_1SystemException.html#ee405d1078ff3aa1045bc60b1c93d7a3">what</a>());
|
|
372
|
+
<a name="l00355"></a>00355 restarted = <span class="keyword">false</span>;
|
|
373
|
+
<a name="l00356"></a>00356 }
|
|
374
|
+
<a name="l00357"></a>00357 <span class="keywordflow">if</span> (restarted) {
|
|
375
|
+
<a name="l00358"></a>00358 <span class="keywordflow">return</span> sendSpawnCommand(appRoot, lowerPrivilege, lowestUser,
|
|
376
|
+
<a name="l00359"></a>00359 environment, spawnMethod, appType);
|
|
377
|
+
<a name="l00360"></a>00360 } <span class="keywordflow">else</span> {
|
|
378
|
+
<a name="l00361"></a>00361 <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>);
|
|
379
|
+
<a name="l00362"></a>00362 }
|
|
380
|
+
<a name="l00363"></a>00363 }
|
|
381
|
+
<a name="l00364"></a>00364 <span class="comment"></span>
|
|
382
|
+
<a name="l00365"></a>00365 <span class="comment"> /**</span>
|
|
383
|
+
<a name="l00366"></a>00366 <span class="comment"> * Send the reload command to the spawn server.</span>
|
|
384
|
+
<a name="l00367"></a>00367 <span class="comment"> *</span>
|
|
385
|
+
<a name="l00368"></a>00368 <span class="comment"> * @param appRoot The application root to reload.</span>
|
|
386
|
+
<a name="l00369"></a>00369 <span class="comment"> * @throws SystemException Something went wrong.</span>
|
|
387
|
+
<a name="l00370"></a>00370 <span class="comment"> */</span>
|
|
388
|
+
<a name="l00371"></a>00371 <span class="keywordtype">void</span> sendReloadCommand(<span class="keyword">const</span> <span class="keywordtype">string</span> &appRoot) {
|
|
389
|
+
<a name="l00372"></a>00372 <span class="keywordflow">try</span> {
|
|
390
|
+
<a name="l00373"></a>00373 channel.<a class="code" href="classPassenger_1_1MessageChannel.html#9ad7a978cf8409e01ab2f0a2b6be5a0a" 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);
|
|
391
|
+
<a name="l00374"></a>00374 } <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) {
|
|
392
|
+
<a name="l00375"></a>00375 <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">"Could not write 'reload' command "</span>
|
|
393
|
+
<a name="l00376"></a>00376 <span class="stringliteral">"to the spawn server"</span>, e.<a class="code" href="classPassenger_1_1SystemException.html#ee7a6672bf79b72a4c3ee70c57d6a47c" title="The value of errno at the time the error occured.">code</a>());
|
|
394
|
+
<a name="l00377"></a>00377 }
|
|
395
|
+
<a name="l00378"></a>00378 }
|
|
396
|
+
<a name="l00379"></a>00379
|
|
397
|
+
<a name="l00380"></a>00380 <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) {
|
|
398
|
+
<a name="l00381"></a>00381 <span class="keywordtype">bool</span> restarted;
|
|
399
|
+
<a name="l00382"></a>00382 <span class="keywordflow">try</span> {
|
|
400
|
+
<a name="l00383"></a>00383 P_DEBUG(<span class="stringliteral">"Spawn server died. Attempting to restart it..."</span>);
|
|
401
|
+
<a name="l00384"></a>00384 restartServer();
|
|
402
|
+
<a name="l00385"></a>00385 P_DEBUG(<span class="stringliteral">"Restart seems to be successful."</span>);
|
|
403
|
+
<a name="l00386"></a>00386 restarted = <span class="keyword">true</span>;
|
|
404
|
+
<a name="l00387"></a>00387 } <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) {
|
|
405
|
+
<a name="l00388"></a>00388 P_DEBUG(<span class="stringliteral">"Restart failed: "</span> << e.<a class="code" href="classPassenger_1_1IOException.html#1b65d0fdb9bc5136f5b7df759c14768a">what</a>());
|
|
406
|
+
<a name="l00389"></a>00389 restarted = <span class="keyword">false</span>;
|
|
407
|
+
<a name="l00390"></a>00390 } <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) {
|
|
408
|
+
<a name="l00391"></a>00391 P_DEBUG(<span class="stringliteral">"Restart failed: "</span> << e.<a class="code" href="classPassenger_1_1SystemException.html#ee405d1078ff3aa1045bc60b1c93d7a3">what</a>());
|
|
409
|
+
<a name="l00392"></a>00392 restarted = <span class="keyword">false</span>;
|
|
410
|
+
<a name="l00393"></a>00393 }
|
|
411
|
+
<a name="l00394"></a>00394 <span class="keywordflow">if</span> (restarted) {
|
|
412
|
+
<a name="l00395"></a>00395 <span class="keywordflow">return</span> sendReloadCommand(appRoot);
|
|
413
|
+
<a name="l00396"></a>00396 } <span class="keywordflow">else</span> {
|
|
414
|
+
<a name="l00397"></a>00397 <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>);
|
|
415
|
+
<a name="l00398"></a>00398 }
|
|
416
|
+
<a name="l00399"></a>00399 }
|
|
417
|
+
<a name="l00400"></a>00400
|
|
418
|
+
<a name="l00401"></a>00401 <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) {
|
|
419
|
+
<a name="l00402"></a>00402 <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>());
|
|
420
|
+
<a name="l00403"></a>00403 }
|
|
421
|
+
<a name="l00404"></a>00404
|
|
422
|
+
<a name="l00405"></a>00405 <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) {
|
|
423
|
+
<a name="l00406"></a>00406 <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>());
|
|
424
|
+
<a name="l00407"></a>00407 }
|
|
425
|
+
<a name="l00408"></a>00408
|
|
426
|
+
<a name="l00409"></a>00409 <span class="keyword">public</span>:
|
|
427
|
+
<a name="l00410"></a>00410 <span class="preprocessor"> #ifdef TESTING_SPAWN_MANAGER</span>
|
|
428
|
+
<a name="l00411"></a>00411 <span class="preprocessor"></span> <span class="keywordtype">bool</span> nextRestartShouldFail;
|
|
429
|
+
<a name="l00412"></a>00412 <span class="preprocessor"> #endif</span>
|
|
430
|
+
<a name="l00413"></a>00413 <span class="preprocessor"></span><span class="comment"></span>
|
|
431
|
+
<a name="l00414"></a>00414 <span class="comment"> /**</span>
|
|
432
|
+
<a name="l00415"></a>00415 <span class="comment"> * Construct a new SpawnManager.</span>
|
|
433
|
+
<a name="l00416"></a>00416 <span class="comment"> *</span>
|
|
434
|
+
<a name="l00417"></a>00417 <span class="comment"> * @param spawnServerCommand The filename of the spawn server to use.</span>
|
|
435
|
+
<a name="l00418"></a>00418 <span class="comment"> * @param logFile Specify a log file that the spawn server should use.</span>
|
|
436
|
+
<a name="l00419"></a>00419 <span class="comment"> * Messages on its standard output and standard error channels</span>
|
|
437
|
+
<a name="l00420"></a>00420 <span class="comment"> * will be written to this log file. If an empty string is</span>
|
|
438
|
+
<a name="l00421"></a>00421 <span class="comment"> * specified, no log file will be used, and the spawn server</span>
|
|
439
|
+
<a name="l00422"></a>00422 <span class="comment"> * will use the same standard output/error channels as the</span>
|
|
440
|
+
<a name="l00423"></a>00423 <span class="comment"> * current process.</span>
|
|
441
|
+
<a name="l00424"></a>00424 <span class="comment"> * @param rubyCommand The Ruby interpreter's command.</span>
|
|
442
|
+
<a name="l00425"></a>00425 <span class="comment"> * @param user The user that the spawn manager should run as. This</span>
|
|
443
|
+
<a name="l00426"></a>00426 <span class="comment"> * parameter only has effect if the current process is</span>
|
|
444
|
+
<a name="l00427"></a>00427 <span class="comment"> * running as root. If the empty string is given, or if</span>
|
|
445
|
+
<a name="l00428"></a>00428 <span class="comment"> * the <tt>user</tt> is not a valid username, then</span>
|
|
446
|
+
<a name="l00429"></a>00429 <span class="comment"> * the spawn manager will be run as the current user.</span>
|
|
447
|
+
<a name="l00430"></a>00430 <span class="comment"> * @throws SystemException An error occured while trying to setup the spawn server.</span>
|
|
448
|
+
<a name="l00431"></a>00431 <span class="comment"> * @throws IOException The specified log file could not be opened.</span>
|
|
449
|
+
<a name="l00432"></a>00432 <span class="comment"> */</span>
|
|
450
|
+
<a name="l00433"></a><a class="code" href="classPassenger_1_1SpawnManager.html#fdefbbbad39833912ae7f9f106083099">00433</a> <a class="code" href="classPassenger_1_1SpawnManager.html#fdefbbbad39833912ae7f9f106083099" title="Construct a new SpawnManager.">SpawnManager</a>(<span class="keyword">const</span> <span class="keywordtype">string</span> &spawnServerCommand,
|
|
451
|
+
<a name="l00434"></a>00434 <span class="keyword">const</span> <span class="keywordtype">string</span> &logFile = <span class="stringliteral">""</span>,
|
|
452
|
+
<a name="l00435"></a>00435 <span class="keyword">const</span> <span class="keywordtype">string</span> &rubyCommand = <span class="stringliteral">"ruby"</span>,
|
|
453
|
+
<a name="l00436"></a>00436 <span class="keyword">const</span> <span class="keywordtype">string</span> &user = <span class="stringliteral">""</span>) {
|
|
454
|
+
<a name="l00437"></a>00437 this->spawnServerCommand = spawnServerCommand;
|
|
455
|
+
<a name="l00438"></a>00438 this->logFile = logFile;
|
|
456
|
+
<a name="l00439"></a>00439 this->rubyCommand = rubyCommand;
|
|
457
|
+
<a name="l00440"></a>00440 this->user = user;
|
|
458
|
+
<a name="l00441"></a>00441 pid = 0;
|
|
459
|
+
<a name="l00442"></a>00442 <span class="preprocessor"> #ifdef TESTING_SPAWN_MANAGER</span>
|
|
460
|
+
<a name="l00443"></a>00443 <span class="preprocessor"></span> nextRestartShouldFail = <span class="keyword">false</span>;
|
|
461
|
+
<a name="l00444"></a>00444 <span class="preprocessor"> #endif</span>
|
|
462
|
+
<a name="l00445"></a>00445 <span class="preprocessor"></span> this_thread::disable_interruption di;
|
|
463
|
+
<a name="l00446"></a>00446 <a class="code" href="classboost_1_1this__thread_1_1disable__syscall__interruption.html" title="Create this struct on the stack to temporarily disable system call interruption,...">this_thread::disable_syscall_interruption</a> dsi;
|
|
464
|
+
<a name="l00447"></a>00447 <span class="keywordflow">try</span> {
|
|
465
|
+
<a name="l00448"></a>00448 restartServer();
|
|
466
|
+
<a name="l00449"></a>00449 } <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) {
|
|
467
|
+
<a name="l00450"></a>00450 <span class="keywordflow">throw</span> prependMessageToException(e, <span class="stringliteral">"Could not start the spawn server"</span>);
|
|
468
|
+
<a name="l00451"></a>00451 } <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) {
|
|
469
|
+
<a name="l00452"></a>00452 <span class="keywordflow">throw</span> prependMessageToException(e, <span class="stringliteral">"Could not start the spawn server"</span>);
|
|
470
|
+
<a name="l00453"></a>00453 }
|
|
471
|
+
<a name="l00454"></a>00454 }
|
|
472
|
+
<a name="l00455"></a>00455
|
|
473
|
+
<a name="l00456"></a>00456 ~<a class="code" href="classPassenger_1_1SpawnManager.html" title="Spawning of Ruby on Rails/Rack application instances.">SpawnManager</a>() throw() {
|
|
474
|
+
<a name="l00457"></a>00457 <span class="keywordflow">if</span> (pid != 0) {
|
|
475
|
+
<a name="l00458"></a>00458 this_thread::disable_interruption di;
|
|
476
|
+
<a name="l00459"></a>00459 <a class="code" href="classboost_1_1this__thread_1_1disable__syscall__interruption.html" title="Create this struct on the stack to temporarily disable system call interruption,...">this_thread::disable_syscall_interruption</a> dsi;
|
|
477
|
+
<a name="l00460"></a>00460 P_TRACE(2, <span class="stringliteral">"Shutting down spawn manager (PID "</span> << pid << <span class="stringliteral">")."</span>);
|
|
478
|
+
<a name="l00461"></a>00461 channel.<a class="code" href="classPassenger_1_1MessageChannel.html#06309e208fc5e10642a2e9bbe0f351eb" title="Close the underlying file descriptor.">close</a>();
|
|
479
|
+
<a name="l00462"></a>00462 InterruptableCalls::waitpid(pid, NULL, 0);
|
|
480
|
+
<a name="l00463"></a>00463 P_TRACE(2, <span class="stringliteral">"Spawn manager exited."</span>);
|
|
481
|
+
<a name="l00464"></a>00464 }
|
|
482
|
+
<a name="l00465"></a>00465 }
|
|
483
|
+
<a name="l00466"></a>00466 <span class="comment"></span>
|
|
484
|
+
<a name="l00467"></a>00467 <span class="comment"> /**</span>
|
|
485
|
+
<a name="l00468"></a>00468 <span class="comment"> * Spawn a new instance of a Ruby on Rails or Rack application.</span>
|
|
486
|
+
<a name="l00469"></a>00469 <span class="comment"> *</span>
|
|
487
|
+
<a name="l00470"></a>00470 <span class="comment"> * If the spawn server died during the spawning process, then the server</span>
|
|
488
|
+
<a name="l00471"></a>00471 <span class="comment"> * will be automatically restarted, and another spawn attempt will be made.</span>
|
|
489
|
+
<a name="l00472"></a>00472 <span class="comment"> * If restarting the server fails, or if the second spawn attempt fails,</span>
|
|
490
|
+
<a name="l00473"></a>00473 <span class="comment"> * then an exception will be thrown.</span>
|
|
491
|
+
<a name="l00474"></a>00474 <span class="comment"> *</span>
|
|
492
|
+
<a name="l00475"></a>00475 <span class="comment"> * If <tt>lowerPrivilege</tt> is true, then it will be attempt to</span>
|
|
493
|
+
<a name="l00476"></a>00476 <span class="comment"> * switch the spawned application instance to the user who owns the</span>
|
|
494
|
+
<a name="l00477"></a>00477 <span class="comment"> * application's <tt>config/environment.rb</tt>, and to the default</span>
|
|
495
|
+
<a name="l00478"></a>00478 <span class="comment"> * group of that user.</span>
|
|
496
|
+
<a name="l00479"></a>00479 <span class="comment"> *</span>
|
|
497
|
+
<a name="l00480"></a>00480 <span class="comment"> * If that user doesn't exist on the system, or if that user is root,</span>
|
|
498
|
+
<a name="l00481"></a>00481 <span class="comment"> * then it will be attempted to switch to the username given by</span>
|
|
499
|
+
<a name="l00482"></a>00482 <span class="comment"> * <tt>lowestUser</tt> (and to the default group of that user).</span>
|
|
500
|
+
<a name="l00483"></a>00483 <span class="comment"> * If <tt>lowestUser</tt> doesn't exist either, or if switching user failed</span>
|
|
501
|
+
<a name="l00484"></a>00484 <span class="comment"> * (because the spawn server process does not have the privilege to do so),</span>
|
|
502
|
+
<a name="l00485"></a>00485 <span class="comment"> * then the application will be spawned anyway, without reporting an error.</span>
|
|
503
|
+
<a name="l00486"></a>00486 <span class="comment"> *</span>
|
|
504
|
+
<a name="l00487"></a>00487 <span class="comment"> * It goes without saying that lowering privilege is only possible if</span>
|
|
505
|
+
<a name="l00488"></a>00488 <span class="comment"> * the spawn server is running as root (and thus, by induction, that</span>
|
|
506
|
+
<a name="l00489"></a>00489 <span class="comment"> * Passenger and Apache's control process are also running as root).</span>
|
|
507
|
+
<a name="l00490"></a>00490 <span class="comment"> * Note that if Apache is listening on port 80, then its control process must</span>
|
|
508
|
+
<a name="l00491"></a>00491 <span class="comment"> * be running as root. See "doc/Security of user switching.txt" for</span>
|
|
509
|
+
<a name="l00492"></a>00492 <span class="comment"> * a detailed explanation.</span>
|
|
510
|
+
<a name="l00493"></a>00493 <span class="comment"> *</span>
|
|
511
|
+
<a name="l00494"></a>00494 <span class="comment"> * @param appRoot The application root of a RoR application, i.e. the folder that</span>
|
|
512
|
+
<a name="l00495"></a>00495 <span class="comment"> * contains 'app/', 'public/', 'config/', etc. This must be a valid directory,</span>
|
|
513
|
+
<a name="l00496"></a>00496 <span class="comment"> * but the path does not have to be absolute.</span>
|
|
514
|
+
<a name="l00497"></a>00497 <span class="comment"> * @param lowerPrivilege Whether to lower the application's privileges.</span>
|
|
515
|
+
<a name="l00498"></a>00498 <span class="comment"> * @param lowestUser The user to fallback to if lowering privilege fails.</span>
|
|
516
|
+
<a name="l00499"></a>00499 <span class="comment"> * @param environment The RAILS_ENV/RACK_ENV environment that should be used. May not be empty.</span>
|
|
517
|
+
<a name="l00500"></a>00500 <span class="comment"> * @param spawnMethod The spawn method to use. Either "smart" or "conservative".</span>
|
|
518
|
+
<a name="l00501"></a>00501 <span class="comment"> * See the Ruby class SpawnManager for details.</span>
|
|
519
|
+
<a name="l00502"></a>00502 <span class="comment"> * @param appType The application type. Either "rails" or "rack".</span>
|
|
520
|
+
<a name="l00503"></a>00503 <span class="comment"> * @return A smart pointer to an Application object, which represents the application</span>
|
|
521
|
+
<a name="l00504"></a>00504 <span class="comment"> * instance that has been spawned. Use this object to communicate with the</span>
|
|
522
|
+
<a name="l00505"></a>00505 <span class="comment"> * spawned application.</span>
|
|
523
|
+
<a name="l00506"></a>00506 <span class="comment"> * @throws SpawnException Something went wrong.</span>
|
|
524
|
+
<a name="l00507"></a>00507 <span class="comment"> * @throws boost::thread_interrupted</span>
|
|
525
|
+
<a name="l00508"></a>00508 <span class="comment"> */</span>
|
|
526
|
+
<a name="l00509"></a><a class="code" href="classPassenger_1_1SpawnManager.html#1bafa97204ea49a88b66272be3377d53">00509</a> <a class="code" href="namespacePassenger.html#6a15fd5e8765802a0b8b077e15297e18" title="Convenient alias for Application smart pointer.">ApplicationPtr</a> <a class="code" href="classPassenger_1_1SpawnManager.html#1bafa97204ea49a88b66272be3377d53" title="Spawn a new instance of a Ruby on Rails or Rack application.">spawn</a>(
|
|
527
|
+
<a name="l00510"></a>00510 <span class="keyword">const</span> <span class="keywordtype">string</span> &appRoot,
|
|
528
|
+
<a name="l00511"></a>00511 <span class="keywordtype">bool</span> lowerPrivilege = <span class="keyword">true</span>,
|
|
529
|
+
<a name="l00512"></a>00512 <span class="keyword">const</span> <span class="keywordtype">string</span> &lowestUser = <span class="stringliteral">"nobody"</span>,
|
|
530
|
+
<a name="l00513"></a>00513 <span class="keyword">const</span> <span class="keywordtype">string</span> &environment = <span class="stringliteral">"production"</span>,
|
|
531
|
+
<a name="l00514"></a>00514 <span class="keyword">const</span> <span class="keywordtype">string</span> &spawnMethod = <span class="stringliteral">"smart"</span>,
|
|
532
|
+
<a name="l00515"></a>00515 <span class="keyword">const</span> <span class="keywordtype">string</span> &appType = <span class="stringliteral">"rails"</span>
|
|
533
|
+
<a name="l00516"></a>00516 ) {
|
|
534
|
+
<a name="l00517"></a>00517 mutex::scoped_lock l(lock);
|
|
535
|
+
<a name="l00518"></a>00518 <span class="keywordflow">try</span> {
|
|
536
|
+
<a name="l00519"></a>00519 <span class="keywordflow">return</span> sendSpawnCommand(appRoot, lowerPrivilege, lowestUser,
|
|
537
|
+
<a name="l00520"></a>00520 environment, spawnMethod, appType);
|
|
538
|
+
<a name="l00521"></a>00521 } <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) {
|
|
539
|
+
<a name="l00522"></a>00522 <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>()) {
|
|
540
|
+
<a name="l00523"></a>00523 <span class="keywordflow">throw</span>;
|
|
541
|
+
<a name="l00524"></a>00524 } <span class="keywordflow">else</span> {
|
|
542
|
+
<a name="l00525"></a>00525 <span class="keywordflow">return</span> handleSpawnException(e, appRoot, lowerPrivilege,
|
|
543
|
+
<a name="l00526"></a>00526 lowestUser, environment, spawnMethod, appType);
|
|
544
|
+
<a name="l00527"></a>00527 }
|
|
545
|
+
<a name="l00528"></a>00528 }
|
|
546
|
+
<a name="l00529"></a>00529 }
|
|
547
|
+
<a name="l00530"></a>00530 <span class="comment"></span>
|
|
548
|
+
<a name="l00531"></a>00531 <span class="comment"> /**</span>
|
|
549
|
+
<a name="l00532"></a>00532 <span class="comment"> * Remove the cached application instances at the given application root.</span>
|
|
550
|
+
<a name="l00533"></a>00533 <span class="comment"> *</span>
|
|
551
|
+
<a name="l00534"></a>00534 <span class="comment"> * Application code might be cached in memory. But once it a while, it will</span>
|
|
552
|
+
<a name="l00535"></a>00535 <span class="comment"> * be necessary to reload the code for an application, such as after</span>
|
|
553
|
+
<a name="l00536"></a>00536 <span class="comment"> * deploying a new version of the application. This method makes sure that</span>
|
|
554
|
+
<a name="l00537"></a>00537 <span class="comment"> * any cached application code is removed, so that the next time an</span>
|
|
555
|
+
<a name="l00538"></a>00538 <span class="comment"> * application instance is spawned, the application code will be freshly</span>
|
|
556
|
+
<a name="l00539"></a>00539 <span class="comment"> * loaded into memory.</span>
|
|
557
|
+
<a name="l00540"></a>00540 <span class="comment"> *</span>
|
|
558
|
+
<a name="l00541"></a>00541 <span class="comment"> * @throws SystemException Unable to communicate with the spawn server,</span>
|
|
559
|
+
<a name="l00542"></a>00542 <span class="comment"> * even after a restart.</span>
|
|
560
|
+
<a name="l00543"></a>00543 <span class="comment"> * @throws SpawnException The spawn server died unexpectedly, and a</span>
|
|
561
|
+
<a name="l00544"></a>00544 <span class="comment"> * restart was attempted, but it failed.</span>
|
|
562
|
+
<a name="l00545"></a>00545 <span class="comment"> */</span>
|
|
563
|
+
<a name="l00546"></a><a class="code" href="classPassenger_1_1SpawnManager.html#2e85c43042b9556ca2fd74b8d28956ce">00546</a> <span class="keywordtype">void</span> <a class="code" href="classPassenger_1_1SpawnManager.html#2e85c43042b9556ca2fd74b8d28956ce" title="Remove the cached application instances at the given application root.">reload</a>(<span class="keyword">const</span> <span class="keywordtype">string</span> &appRoot) {
|
|
564
|
+
<a name="l00547"></a>00547 this_thread::disable_interruption di;
|
|
565
|
+
<a name="l00548"></a>00548 <a class="code" href="classboost_1_1this__thread_1_1disable__syscall__interruption.html" title="Create this struct on the stack to temporarily disable system call interruption,...">this_thread::disable_syscall_interruption</a> dsi;
|
|
566
|
+
<a name="l00549"></a>00549 <span class="keywordflow">try</span> {
|
|
567
|
+
<a name="l00550"></a>00550 <span class="keywordflow">return</span> sendReloadCommand(appRoot);
|
|
568
|
+
<a name="l00551"></a>00551 } <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) {
|
|
569
|
+
<a name="l00552"></a>00552 <span class="keywordflow">return</span> handleReloadException(e, appRoot);
|
|
570
|
+
<a name="l00553"></a>00553 }
|
|
571
|
+
<a name="l00554"></a>00554 }
|
|
572
|
+
<a name="l00555"></a>00555 <span class="comment"></span>
|
|
573
|
+
<a name="l00556"></a>00556 <span class="comment"> /**</span>
|
|
574
|
+
<a name="l00557"></a>00557 <span class="comment"> * Get the Process ID of the spawn server. This method is used in the unit tests</span>
|
|
575
|
+
<a name="l00558"></a>00558 <span class="comment"> * and should not be used directly.</span>
|
|
576
|
+
<a name="l00559"></a>00559 <span class="comment"> */</span>
|
|
577
|
+
<a name="l00560"></a><a class="code" href="classPassenger_1_1SpawnManager.html#1f77e2e7e6cb464028c13a29f983ad8e">00560</a> pid_t <a class="code" href="classPassenger_1_1SpawnManager.html#1f77e2e7e6cb464028c13a29f983ad8e" title="Get the Process ID of the spawn server.">getServerPid</a>()<span class="keyword"> const </span>{
|
|
578
|
+
<a name="l00561"></a>00561 <span class="keywordflow">return</span> pid;
|
|
579
|
+
<a name="l00562"></a>00562 }
|
|
580
|
+
<a name="l00563"></a>00563 };
|
|
581
|
+
<a name="l00564"></a>00564 <span class="comment"></span>
|
|
582
|
+
<a name="l00565"></a>00565 <span class="comment">/** Convenient alias for SpawnManager smart pointer. */</span>
|
|
583
|
+
<a name="l00566"></a><a class="code" href="namespacePassenger.html#6ab2d566ff87a2676c23d8aa40204587">00566</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>;
|
|
584
|
+
<a name="l00567"></a>00567
|
|
585
|
+
<a name="l00568"></a>00568 } <span class="comment">// namespace Passenger</span>
|
|
586
|
+
<a name="l00569"></a>00569
|
|
587
|
+
<a name="l00570"></a>00570 <span class="preprocessor">#endif </span><span class="comment">/* _PASSENGER_SPAWN_MANAGER_H_ */</span>
|
|
588
|
+
</pre></div></div>
|
|
589
|
+
<hr size="1"><address style="text-align: right;"><small>Generated on Mon Dec 1 14:27:22 2008 for Passenger by
|
|
590
|
+
<a href="http://www.doxygen.org/index.html">
|
|
591
|
+
<img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.5 </small></address>
|
|
592
|
+
</body>
|
|
593
|
+
</html>
|