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,320 @@
|
|
|
1
|
+
<?xml version="1.0" encoding="iso-8859-1"?>
|
|
2
|
+
<!DOCTYPE html
|
|
3
|
+
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
|
|
4
|
+
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
|
5
|
+
<html>
|
|
6
|
+
<head>
|
|
7
|
+
<title>Module: Passenger::NativeSupport</title>
|
|
8
|
+
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
|
|
9
|
+
<link rel="stylesheet" href="../.././rdoc-style.css" type="text/css" media="screen" />
|
|
10
|
+
|
|
11
|
+
<script language="JavaScript" type="text/javascript">
|
|
12
|
+
// <![CDATA[
|
|
13
|
+
|
|
14
|
+
function toggleSource( id )
|
|
15
|
+
{
|
|
16
|
+
var elem
|
|
17
|
+
var link
|
|
18
|
+
|
|
19
|
+
if( document.getElementById )
|
|
20
|
+
{
|
|
21
|
+
elem = document.getElementById( id )
|
|
22
|
+
link = document.getElementById( "l_" + id )
|
|
23
|
+
}
|
|
24
|
+
else if ( document.all )
|
|
25
|
+
{
|
|
26
|
+
elem = eval( "document.all." + id )
|
|
27
|
+
link = eval( "document.all.l_" + id )
|
|
28
|
+
}
|
|
29
|
+
else
|
|
30
|
+
return false;
|
|
31
|
+
|
|
32
|
+
if( elem.style.display == "block" )
|
|
33
|
+
{
|
|
34
|
+
elem.style.display = "none"
|
|
35
|
+
link.innerHTML = "show source"
|
|
36
|
+
}
|
|
37
|
+
else
|
|
38
|
+
{
|
|
39
|
+
elem.style.display = "block"
|
|
40
|
+
link.innerHTML = "hide source"
|
|
41
|
+
}
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
function openCode( url )
|
|
45
|
+
{
|
|
46
|
+
window.open( url, "SOURCE_CODE", "resizable=yes,scrollbars=yes,toolbar=no,status=no,height=480,width=750" ).focus();
|
|
47
|
+
}
|
|
48
|
+
// ]]>
|
|
49
|
+
</script>
|
|
50
|
+
</head>
|
|
51
|
+
|
|
52
|
+
<body>
|
|
53
|
+
<table width="100%" border='0' cellpadding='0' cellspacing='0' class='banner'><tr>
|
|
54
|
+
<td class="file-title"><span class="file-title-prefix">Module</span><br />Passenger::NativeSupport</td>
|
|
55
|
+
<td align="right">
|
|
56
|
+
<table cellspacing="0" cellpadding="2">
|
|
57
|
+
<tr valign="top">
|
|
58
|
+
<td>In:</td>
|
|
59
|
+
<td>
|
|
60
|
+
<a href="../../files/ext/passenger/native_support_c.html">ext/passenger/native_support.c</a>
|
|
61
|
+
</td>
|
|
62
|
+
</tr>
|
|
63
|
+
</table>
|
|
64
|
+
</td>
|
|
65
|
+
</tr>
|
|
66
|
+
</table>
|
|
67
|
+
<!-- banner header -->
|
|
68
|
+
|
|
69
|
+
<div id="bodyContent">
|
|
70
|
+
<div id="content">
|
|
71
|
+
|
|
72
|
+
<div class="description"><p>
|
|
73
|
+
Utility functions for accessing system functionality.
|
|
74
|
+
</p>
|
|
75
|
+
</div>
|
|
76
|
+
|
|
77
|
+
|
|
78
|
+
|
|
79
|
+
<div class="sectiontitle">Methods</div>
|
|
80
|
+
<ul>
|
|
81
|
+
<li><a href="#M000012">accept</a></li>
|
|
82
|
+
<li><a href="#M000013">close_all_file_descriptors</a></li>
|
|
83
|
+
<li><a href="#M000011">create_unix_socket</a></li>
|
|
84
|
+
<li><a href="#M000010">recv_fd</a></li>
|
|
85
|
+
<li><a href="#M000009">send_fd</a></li>
|
|
86
|
+
</ul>
|
|
87
|
+
|
|
88
|
+
|
|
89
|
+
|
|
90
|
+
|
|
91
|
+
<div class="sectiontitle">Constants</div>
|
|
92
|
+
<table border='0' cellpadding='5'>
|
|
93
|
+
<tr valign='top'>
|
|
94
|
+
<td class="attr-name">UNIX_PATH_MAX</td>
|
|
95
|
+
<td>=</td>
|
|
96
|
+
<td class="attr-value">INT2NUM(sizeof(addr.sun_path))</td>
|
|
97
|
+
</tr>
|
|
98
|
+
<tr valign='top'>
|
|
99
|
+
<td> </td>
|
|
100
|
+
<td colspan="2" class="attr-desc">
|
|
101
|
+
The maximum length of a Unix socket path, including terminating null.
|
|
102
|
+
|
|
103
|
+
</td>
|
|
104
|
+
</tr>
|
|
105
|
+
</table>
|
|
106
|
+
|
|
107
|
+
|
|
108
|
+
<div class="sectiontitle">Public Class methods</div>
|
|
109
|
+
<div class="method">
|
|
110
|
+
<div class="title">
|
|
111
|
+
<a name="M000012"></a><b> accept(fileno)<br />
|
|
112
|
+
</b>
|
|
113
|
+
</div>
|
|
114
|
+
<div class="description">
|
|
115
|
+
<p>
|
|
116
|
+
Accept a new client from the given socket.
|
|
117
|
+
</p>
|
|
118
|
+
<ul>
|
|
119
|
+
<li><tt>fileno</tt> (integer): The file descriptor of the server socket.
|
|
120
|
+
|
|
121
|
+
</li>
|
|
122
|
+
<li>Returns: The accepted client‘s file descriptor.
|
|
123
|
+
|
|
124
|
+
</li>
|
|
125
|
+
<li>Raises <tt>SystemCallError</tt> if something went wrong.
|
|
126
|
+
|
|
127
|
+
</li>
|
|
128
|
+
</ul>
|
|
129
|
+
</div>
|
|
130
|
+
<div class="sourcecode">
|
|
131
|
+
<p class="source-link">[ <a href="javascript:toggleSource('M000012_source')" id="l_M000012_source">show source</a> ]</p>
|
|
132
|
+
<div id="M000012_source" class="dyn-source">
|
|
133
|
+
<pre>
|
|
134
|
+
/*
|
|
135
|
+
* call-seq: accept(fileno)
|
|
136
|
+
*
|
|
137
|
+
* Accept a new client from the given socket.
|
|
138
|
+
*
|
|
139
|
+
* - +fileno+ (integer): The file descriptor of the server socket.
|
|
140
|
+
* - Returns: The accepted client's file descriptor.
|
|
141
|
+
* - Raises +SystemCallError+ if something went wrong.
|
|
142
|
+
*/
|
|
143
|
+
static VALUE
|
|
144
|
+
f_accept(VALUE self, VALUE fileno) {
|
|
145
|
+
|
|
146
|
+
</pre>
|
|
147
|
+
</div>
|
|
148
|
+
</div>
|
|
149
|
+
</div>
|
|
150
|
+
<div class="method">
|
|
151
|
+
<div class="title">
|
|
152
|
+
<a name="M000013"></a><b> close_all_file_descriptors(exceptions)<br />
|
|
153
|
+
</b>
|
|
154
|
+
</div>
|
|
155
|
+
<div class="description">
|
|
156
|
+
<p>
|
|
157
|
+
Close all file descriptors, except those given in the <tt>exceptions</tt>
|
|
158
|
+
array. For example, the following would close all file descriptors except
|
|
159
|
+
standard input (0) and standard output (1).
|
|
160
|
+
</p>
|
|
161
|
+
<pre>
|
|
162
|
+
close_all_file_descriptors([0, 1])
|
|
163
|
+
</pre>
|
|
164
|
+
</div>
|
|
165
|
+
<div class="sourcecode">
|
|
166
|
+
<p class="source-link">[ <a href="javascript:toggleSource('M000013_source')" id="l_M000013_source">show source</a> ]</p>
|
|
167
|
+
<div id="M000013_source" class="dyn-source">
|
|
168
|
+
<pre>
|
|
169
|
+
/*
|
|
170
|
+
* call-seq: close_all_file_descriptors(exceptions)
|
|
171
|
+
*
|
|
172
|
+
* Close all file descriptors, except those given in the +exceptions+ array.
|
|
173
|
+
* For example, the following would close all file descriptors except standard
|
|
174
|
+
* input (0) and standard output (1).
|
|
175
|
+
*
|
|
176
|
+
* close_all_file_descriptors([0, 1])
|
|
177
|
+
*/
|
|
178
|
+
static VALUE
|
|
179
|
+
close_all_file_descriptors(VALUE self, VALUE exceptions) {
|
|
180
|
+
|
|
181
|
+
</pre>
|
|
182
|
+
</div>
|
|
183
|
+
</div>
|
|
184
|
+
</div>
|
|
185
|
+
<div class="method">
|
|
186
|
+
<div class="title">
|
|
187
|
+
<a name="M000011"></a><b> create_unix_socket(filename, backlog)<br />
|
|
188
|
+
</b>
|
|
189
|
+
</div>
|
|
190
|
+
<div class="description">
|
|
191
|
+
<p>
|
|
192
|
+
Create a SOCK_STREAM server Unix socket. Unlike Ruby‘s UNIXServer
|
|
193
|
+
class, this function is also able to create Unix sockets on the abstract
|
|
194
|
+
namespace by prepending the filename with a null byte.
|
|
195
|
+
</p>
|
|
196
|
+
<ul>
|
|
197
|
+
<li><tt>filename</tt> (string): The filename of the Unix socket to create.
|
|
198
|
+
|
|
199
|
+
</li>
|
|
200
|
+
<li><tt>backlog</tt> (integer): The backlog to use for listening on the socket.
|
|
201
|
+
|
|
202
|
+
</li>
|
|
203
|
+
<li>Returns: The file descriptor of the created Unix socket, as an integer.
|
|
204
|
+
|
|
205
|
+
</li>
|
|
206
|
+
<li>Raises <tt>SystemCallError</tt> if something went wrong.
|
|
207
|
+
|
|
208
|
+
</li>
|
|
209
|
+
</ul>
|
|
210
|
+
</div>
|
|
211
|
+
<div class="sourcecode">
|
|
212
|
+
<p class="source-link">[ <a href="javascript:toggleSource('M000011_source')" id="l_M000011_source">show source</a> ]</p>
|
|
213
|
+
<div id="M000011_source" class="dyn-source">
|
|
214
|
+
<pre>
|
|
215
|
+
/*
|
|
216
|
+
* call-seq: create_unix_socket(filename, backlog)
|
|
217
|
+
*
|
|
218
|
+
* Create a SOCK_STREAM server Unix socket. Unlike Ruby's UNIXServer class,
|
|
219
|
+
* this function is also able to create Unix sockets on the abstract namespace
|
|
220
|
+
* by prepending the filename with a null byte.
|
|
221
|
+
*
|
|
222
|
+
* - +filename+ (string): The filename of the Unix socket to create.
|
|
223
|
+
* - +backlog+ (integer): The backlog to use for listening on the socket.
|
|
224
|
+
* - Returns: The file descriptor of the created Unix socket, as an integer.
|
|
225
|
+
* - Raises +SystemCallError+ if something went wrong.
|
|
226
|
+
*/
|
|
227
|
+
static VALUE
|
|
228
|
+
create_unix_socket(VALUE self, VALUE filename, VALUE backlog) {
|
|
229
|
+
|
|
230
|
+
</pre>
|
|
231
|
+
</div>
|
|
232
|
+
</div>
|
|
233
|
+
</div>
|
|
234
|
+
<div class="method">
|
|
235
|
+
<div class="title">
|
|
236
|
+
<a name="M000010"></a><b> recv_fd(socket_fd)<br />
|
|
237
|
+
</b>
|
|
238
|
+
</div>
|
|
239
|
+
<div class="description">
|
|
240
|
+
<p>
|
|
241
|
+
Receive a file descriptor from the given Unix socket. Returns the received
|
|
242
|
+
file descriptor as an integer. Raises <tt>SystemCallError</tt> if something
|
|
243
|
+
went wrong.
|
|
244
|
+
</p>
|
|
245
|
+
<p>
|
|
246
|
+
You do not have call this method directly. A convenience wrapper is
|
|
247
|
+
provided by <a href="../IO.html#M000004">IO#recv_io</a>.
|
|
248
|
+
</p>
|
|
249
|
+
</div>
|
|
250
|
+
<div class="sourcecode">
|
|
251
|
+
<p class="source-link">[ <a href="javascript:toggleSource('M000010_source')" id="l_M000010_source">show source</a> ]</p>
|
|
252
|
+
<div id="M000010_source" class="dyn-source">
|
|
253
|
+
<pre>
|
|
254
|
+
/*
|
|
255
|
+
* call-seq: recv_fd(socket_fd)
|
|
256
|
+
*
|
|
257
|
+
* Receive a file descriptor from the given Unix socket. Returns the received
|
|
258
|
+
* file descriptor as an integer. Raises +SystemCallError+ if something went
|
|
259
|
+
* wrong.
|
|
260
|
+
*
|
|
261
|
+
* You do not have call this method directly. A convenience wrapper is
|
|
262
|
+
* provided by IO#recv_io.
|
|
263
|
+
*/
|
|
264
|
+
static VALUE
|
|
265
|
+
recv_fd(VALUE self, VALUE socket_fd) {
|
|
266
|
+
|
|
267
|
+
</pre>
|
|
268
|
+
</div>
|
|
269
|
+
</div>
|
|
270
|
+
</div>
|
|
271
|
+
<div class="method">
|
|
272
|
+
<div class="title">
|
|
273
|
+
<a name="M000009"></a><b> send_fd(socket_fd, fd_to_send)<br />
|
|
274
|
+
</b>
|
|
275
|
+
</div>
|
|
276
|
+
<div class="description">
|
|
277
|
+
<p>
|
|
278
|
+
Send a file descriptor over the given Unix socket. You do not have to call
|
|
279
|
+
this function directly. A convenience wrapper is provided by <a
|
|
280
|
+
href="../IO.html#M000003">IO#send_io</a>.
|
|
281
|
+
</p>
|
|
282
|
+
<ul>
|
|
283
|
+
<li><tt>socket_fd</tt> (integer): The file descriptor of the socket.
|
|
284
|
+
|
|
285
|
+
</li>
|
|
286
|
+
<li><tt>fd_to_send</tt> (integer): The file descriptor to send.
|
|
287
|
+
|
|
288
|
+
</li>
|
|
289
|
+
<li>Raises <tt>SystemCallError</tt> if something went wrong.
|
|
290
|
+
|
|
291
|
+
</li>
|
|
292
|
+
</ul>
|
|
293
|
+
</div>
|
|
294
|
+
<div class="sourcecode">
|
|
295
|
+
<p class="source-link">[ <a href="javascript:toggleSource('M000009_source')" id="l_M000009_source">show source</a> ]</p>
|
|
296
|
+
<div id="M000009_source" class="dyn-source">
|
|
297
|
+
<pre>
|
|
298
|
+
/*
|
|
299
|
+
* call-seq: send_fd(socket_fd, fd_to_send)
|
|
300
|
+
*
|
|
301
|
+
* Send a file descriptor over the given Unix socket. You do not have to call
|
|
302
|
+
* this function directly. A convenience wrapper is provided by IO#send_io.
|
|
303
|
+
*
|
|
304
|
+
* - +socket_fd+ (integer): The file descriptor of the socket.
|
|
305
|
+
* - +fd_to_send+ (integer): The file descriptor to send.
|
|
306
|
+
* - Raises +SystemCallError+ if something went wrong.
|
|
307
|
+
*/
|
|
308
|
+
static VALUE
|
|
309
|
+
send_fd(VALUE self, VALUE socket_fd, VALUE fd_to_send) {
|
|
310
|
+
|
|
311
|
+
</pre>
|
|
312
|
+
</div>
|
|
313
|
+
</div>
|
|
314
|
+
</div>
|
|
315
|
+
</div>
|
|
316
|
+
|
|
317
|
+
</div>
|
|
318
|
+
|
|
319
|
+
</body>
|
|
320
|
+
</html>
|
|
@@ -0,0 +1,375 @@
|
|
|
1
|
+
<?xml version="1.0" encoding="iso-8859-1"?>
|
|
2
|
+
<!DOCTYPE html
|
|
3
|
+
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
|
|
4
|
+
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
|
5
|
+
<html>
|
|
6
|
+
<head>
|
|
7
|
+
<title>Class: Passenger::SpawnManager</title>
|
|
8
|
+
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
|
|
9
|
+
<link rel="stylesheet" href="../.././rdoc-style.css" type="text/css" media="screen" />
|
|
10
|
+
|
|
11
|
+
<script language="JavaScript" type="text/javascript">
|
|
12
|
+
// <![CDATA[
|
|
13
|
+
|
|
14
|
+
function toggleSource( id )
|
|
15
|
+
{
|
|
16
|
+
var elem
|
|
17
|
+
var link
|
|
18
|
+
|
|
19
|
+
if( document.getElementById )
|
|
20
|
+
{
|
|
21
|
+
elem = document.getElementById( id )
|
|
22
|
+
link = document.getElementById( "l_" + id )
|
|
23
|
+
}
|
|
24
|
+
else if ( document.all )
|
|
25
|
+
{
|
|
26
|
+
elem = eval( "document.all." + id )
|
|
27
|
+
link = eval( "document.all.l_" + id )
|
|
28
|
+
}
|
|
29
|
+
else
|
|
30
|
+
return false;
|
|
31
|
+
|
|
32
|
+
if( elem.style.display == "block" )
|
|
33
|
+
{
|
|
34
|
+
elem.style.display = "none"
|
|
35
|
+
link.innerHTML = "show source"
|
|
36
|
+
}
|
|
37
|
+
else
|
|
38
|
+
{
|
|
39
|
+
elem.style.display = "block"
|
|
40
|
+
link.innerHTML = "hide source"
|
|
41
|
+
}
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
function openCode( url )
|
|
45
|
+
{
|
|
46
|
+
window.open( url, "SOURCE_CODE", "resizable=yes,scrollbars=yes,toolbar=no,status=no,height=480,width=750" ).focus();
|
|
47
|
+
}
|
|
48
|
+
// ]]>
|
|
49
|
+
</script>
|
|
50
|
+
</head>
|
|
51
|
+
|
|
52
|
+
<body>
|
|
53
|
+
<table width="100%" border='0' cellpadding='0' cellspacing='0' class='banner'><tr>
|
|
54
|
+
<td class="file-title"><span class="file-title-prefix">Class</span><br />Passenger::SpawnManager</td>
|
|
55
|
+
<td align="right">
|
|
56
|
+
<table cellspacing="0" cellpadding="2">
|
|
57
|
+
<tr valign="top">
|
|
58
|
+
<td>In:</td>
|
|
59
|
+
<td>
|
|
60
|
+
<a href="../../files/lib/passenger/spawn_manager_rb.html">lib/passenger/spawn_manager.rb</a>
|
|
61
|
+
</td>
|
|
62
|
+
</tr>
|
|
63
|
+
<tr>
|
|
64
|
+
<td>Parent:</td>
|
|
65
|
+
<td>
|
|
66
|
+
<a href="AbstractServer.html">
|
|
67
|
+
AbstractServer
|
|
68
|
+
</a>
|
|
69
|
+
</td>
|
|
70
|
+
</tr>
|
|
71
|
+
</table>
|
|
72
|
+
</td>
|
|
73
|
+
</tr>
|
|
74
|
+
</table>
|
|
75
|
+
<!-- banner header -->
|
|
76
|
+
|
|
77
|
+
<div id="bodyContent">
|
|
78
|
+
<div id="content">
|
|
79
|
+
|
|
80
|
+
<div class="description"><p>
|
|
81
|
+
The spawn manager is capable of spawning Ruby on Rails or Rack application
|
|
82
|
+
instances. It acts like a simple fascade for the rest of the spawn manager
|
|
83
|
+
system.
|
|
84
|
+
</p>
|
|
85
|
+
<p>
|
|
86
|
+
<b>Note</b>: <a href="SpawnManager.html">SpawnManager</a> may only be
|
|
87
|
+
started synchronously with <a
|
|
88
|
+
href="AbstractServer.html#M000054">AbstractServer#start_synchronously</a>.
|
|
89
|
+
Starting asynchronously has not been tested. Don‘t forget to call <a
|
|
90
|
+
href="SpawnManager.html#M000047">cleanup</a> after the server‘s main
|
|
91
|
+
loop has finished.
|
|
92
|
+
</p>
|
|
93
|
+
<h2>Ruby on Rails optimizations ===</h2>
|
|
94
|
+
<p>
|
|
95
|
+
Spawning a Ruby on Rails application is usually slow. But <a
|
|
96
|
+
href="SpawnManager.html">SpawnManager</a> will preload and cache Ruby on
|
|
97
|
+
Rails frameworks, as well as application code, so subsequent spawns will be
|
|
98
|
+
very fast.
|
|
99
|
+
</p>
|
|
100
|
+
<p>
|
|
101
|
+
Internally, <a href="SpawnManager.html">SpawnManager</a> uses
|
|
102
|
+
Railz::FrameworkSpawner to preload and cache Ruby on Rails frameworks.
|
|
103
|
+
Railz::FrameworkSpawner, in turn, uses Railz::ApplicationSpawner to preload
|
|
104
|
+
and cache application code.
|
|
105
|
+
</p>
|
|
106
|
+
<p>
|
|
107
|
+
In case you‘re wondering why the namespace is "Railz" and
|
|
108
|
+
not "Rails": it‘s to work around an obscure bug in
|
|
109
|
+
ActiveSupport‘s Dispatcher.
|
|
110
|
+
</p>
|
|
111
|
+
</div>
|
|
112
|
+
|
|
113
|
+
|
|
114
|
+
|
|
115
|
+
<div class="sectiontitle">Methods</div>
|
|
116
|
+
<ul>
|
|
117
|
+
<li><a href="#M000047">cleanup</a></li>
|
|
118
|
+
<li><a href="#M000044">new</a></li>
|
|
119
|
+
<li><a href="#M000046">reload</a></li>
|
|
120
|
+
<li><a href="#M000045">spawn_application</a></li>
|
|
121
|
+
</ul>
|
|
122
|
+
|
|
123
|
+
<div class="sectiontitle">Included Modules</div>
|
|
124
|
+
<ul>
|
|
125
|
+
<li><a href="Utils.html">Utils</a></li>
|
|
126
|
+
</ul>
|
|
127
|
+
|
|
128
|
+
|
|
129
|
+
|
|
130
|
+
|
|
131
|
+
|
|
132
|
+
<div class="sectiontitle">Public Class methods</div>
|
|
133
|
+
<div class="method">
|
|
134
|
+
<div class="title">
|
|
135
|
+
<a name="M000044"></a><b>new</b>()
|
|
136
|
+
</div>
|
|
137
|
+
<div class="sourcecode">
|
|
138
|
+
<p class="source-link">[ <a href="javascript:toggleSource('M000044_source')" id="l_M000044_source">show source</a> ]</p>
|
|
139
|
+
<div id="M000044_source" class="dyn-source">
|
|
140
|
+
<pre>
|
|
141
|
+
<span class="ruby-comment cmt"># File lib/passenger/spawn_manager.rb, line 48</span>
|
|
142
|
+
48: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>
|
|
143
|
+
49: <span class="ruby-keyword kw">super</span>()
|
|
144
|
+
50: <span class="ruby-ivar">@spawners</span> = {}
|
|
145
|
+
51: <span class="ruby-ivar">@lock</span> = <span class="ruby-constant">Mutex</span>.<span class="ruby-identifier">new</span>
|
|
146
|
+
52: <span class="ruby-ivar">@cond</span> = <span class="ruby-constant">ConditionVariable</span>.<span class="ruby-identifier">new</span>
|
|
147
|
+
53: <span class="ruby-ivar">@cleaner_thread</span> = <span class="ruby-constant">Thread</span>.<span class="ruby-identifier">new</span> <span class="ruby-keyword kw">do</span>
|
|
148
|
+
54: <span class="ruby-identifier">cleaner_thread_main</span>
|
|
149
|
+
55: <span class="ruby-keyword kw">end</span>
|
|
150
|
+
56: <span class="ruby-identifier">define_message_handler</span>(<span class="ruby-identifier">:spawn_application</span>, <span class="ruby-identifier">:handle_spawn_application</span>)
|
|
151
|
+
57: <span class="ruby-identifier">define_message_handler</span>(<span class="ruby-identifier">:reload</span>, <span class="ruby-identifier">:handle_reload</span>)
|
|
152
|
+
58: <span class="ruby-identifier">define_signal_handler</span>(<span class="ruby-value str">'SIGHUP'</span>, <span class="ruby-identifier">:reload</span>)
|
|
153
|
+
59:
|
|
154
|
+
60: <span class="ruby-constant">GC</span>.<span class="ruby-identifier">start</span>
|
|
155
|
+
61: <span class="ruby-keyword kw">if</span> <span class="ruby-constant">GC</span>.<span class="ruby-identifier">copy_on_write_friendly?</span>
|
|
156
|
+
62: <span class="ruby-comment cmt"># Preload libraries for copy-on-write semantics.</span>
|
|
157
|
+
63: <span class="ruby-identifier">require</span> <span class="ruby-value str">'base64'</span>
|
|
158
|
+
64: <span class="ruby-identifier">require</span> <span class="ruby-value str">'passenger/application'</span>
|
|
159
|
+
65: <span class="ruby-identifier">require</span> <span class="ruby-value str">'passenger/railz/framework_spawner'</span>
|
|
160
|
+
66: <span class="ruby-identifier">require</span> <span class="ruby-value str">'passenger/railz/application_spawner'</span>
|
|
161
|
+
67: <span class="ruby-identifier">require</span> <span class="ruby-value str">'passenger/rack/application_spawner'</span>
|
|
162
|
+
68: <span class="ruby-identifier">require</span> <span class="ruby-value str">'passenger/html_template'</span>
|
|
163
|
+
69: <span class="ruby-identifier">require</span> <span class="ruby-value str">'passenger/platform_info'</span>
|
|
164
|
+
70: <span class="ruby-identifier">require</span> <span class="ruby-value str">'passenger/exceptions'</span>
|
|
165
|
+
71:
|
|
166
|
+
72: <span class="ruby-comment cmt"># Commonly used libraries.</span>
|
|
167
|
+
73: [<span class="ruby-value str">'mysql'</span>, <span class="ruby-value str">'sqlite3'</span>].<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">lib</span><span class="ruby-operator">|</span>
|
|
168
|
+
74: <span class="ruby-identifier">require</span> <span class="ruby-identifier">lib</span>
|
|
169
|
+
75: <span class="ruby-keyword kw">end</span>
|
|
170
|
+
76: <span class="ruby-keyword kw">end</span>
|
|
171
|
+
77: <span class="ruby-keyword kw">end</span>
|
|
172
|
+
</pre>
|
|
173
|
+
</div>
|
|
174
|
+
</div>
|
|
175
|
+
</div>
|
|
176
|
+
<div class="sectiontitle">Public Instance methods</div>
|
|
177
|
+
<div class="method">
|
|
178
|
+
<div class="title">
|
|
179
|
+
<a name="M000047"></a><b>cleanup</b>()
|
|
180
|
+
</div>
|
|
181
|
+
<div class="description">
|
|
182
|
+
<p>
|
|
183
|
+
Cleanup resources. Should be called when this <a
|
|
184
|
+
href="SpawnManager.html">SpawnManager</a> is no longer needed.
|
|
185
|
+
</p>
|
|
186
|
+
</div>
|
|
187
|
+
<div class="sourcecode">
|
|
188
|
+
<p class="source-link">[ <a href="javascript:toggleSource('M000047_source')" id="l_M000047_source">show source</a> ]</p>
|
|
189
|
+
<div id="M000047_source" class="dyn-source">
|
|
190
|
+
<pre>
|
|
191
|
+
<span class="ruby-comment cmt"># File lib/passenger/spawn_manager.rb, line 169</span>
|
|
192
|
+
169: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">cleanup</span>
|
|
193
|
+
170: <span class="ruby-ivar">@lock</span>.<span class="ruby-identifier">synchronize</span> <span class="ruby-keyword kw">do</span>
|
|
194
|
+
171: <span class="ruby-ivar">@cond</span>.<span class="ruby-identifier">signal</span>
|
|
195
|
+
172: <span class="ruby-keyword kw">end</span>
|
|
196
|
+
173: <span class="ruby-ivar">@cleaner_thread</span>.<span class="ruby-identifier">join</span>
|
|
197
|
+
174: <span class="ruby-ivar">@lock</span>.<span class="ruby-identifier">synchronize</span> <span class="ruby-keyword kw">do</span>
|
|
198
|
+
175: <span class="ruby-ivar">@spawners</span>.<span class="ruby-identifier">each_value</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">spawner</span><span class="ruby-operator">|</span>
|
|
199
|
+
176: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">spawner</span>.<span class="ruby-identifier">started?</span>
|
|
200
|
+
177: <span class="ruby-identifier">spawner</span>.<span class="ruby-identifier">stop</span>
|
|
201
|
+
178: <span class="ruby-keyword kw">end</span>
|
|
202
|
+
179: <span class="ruby-keyword kw">end</span>
|
|
203
|
+
180: <span class="ruby-ivar">@spawners</span>.<span class="ruby-identifier">clear</span>
|
|
204
|
+
181: <span class="ruby-keyword kw">end</span>
|
|
205
|
+
182: <span class="ruby-keyword kw">end</span>
|
|
206
|
+
</pre>
|
|
207
|
+
</div>
|
|
208
|
+
</div>
|
|
209
|
+
</div>
|
|
210
|
+
<div class="method">
|
|
211
|
+
<div class="title">
|
|
212
|
+
<a name="M000046"></a><b>reload</b>(app_root = nil)
|
|
213
|
+
</div>
|
|
214
|
+
<div class="description">
|
|
215
|
+
<p>
|
|
216
|
+
Remove the cached application instances at the given application root. If
|
|
217
|
+
nil is specified as application root, then all cached application instances
|
|
218
|
+
will be removed, no matter the application root.
|
|
219
|
+
</p>
|
|
220
|
+
<p>
|
|
221
|
+
<b>Long description:</b> <a href="Application.html">Application</a> code
|
|
222
|
+
might be cached in memory. But once it a while, it will be necessary to <a
|
|
223
|
+
href="SpawnManager.html#M000046">reload</a> the code for an application,
|
|
224
|
+
such as after deploying a <a href="SpawnManager.html#M000044">new</a>
|
|
225
|
+
version of the application. This method makes sure that any cached
|
|
226
|
+
application code is removed, so that the next time an application instance
|
|
227
|
+
is spawned, the application code will be freshly loaded into memory.
|
|
228
|
+
</p>
|
|
229
|
+
<p>
|
|
230
|
+
Raises AbstractServer::SpawnError if something went wrong.
|
|
231
|
+
</p>
|
|
232
|
+
</div>
|
|
233
|
+
<div class="sourcecode">
|
|
234
|
+
<p class="source-link">[ <a href="javascript:toggleSource('M000046_source')" id="l_M000046_source">show source</a> ]</p>
|
|
235
|
+
<div id="M000046_source" class="dyn-source">
|
|
236
|
+
<pre>
|
|
237
|
+
<span class="ruby-comment cmt"># File lib/passenger/spawn_manager.rb, line 140</span>
|
|
238
|
+
140: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">reload</span>(<span class="ruby-identifier">app_root</span> = <span class="ruby-keyword kw">nil</span>)
|
|
239
|
+
141: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">app_root</span>
|
|
240
|
+
142: <span class="ruby-keyword kw">begin</span>
|
|
241
|
+
143: <span class="ruby-identifier">app_root</span> = <span class="ruby-identifier">normalize_path</span>(<span class="ruby-identifier">app_root</span>)
|
|
242
|
+
144: <span class="ruby-keyword kw">rescue</span> <span class="ruby-constant">ArgumentError</span>
|
|
243
|
+
145: <span class="ruby-keyword kw">end</span>
|
|
244
|
+
146: <span class="ruby-keyword kw">end</span>
|
|
245
|
+
147: <span class="ruby-ivar">@lock</span>.<span class="ruby-identifier">synchronize</span> <span class="ruby-keyword kw">do</span>
|
|
246
|
+
148: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">app_root</span>
|
|
247
|
+
149: <span class="ruby-comment cmt"># Delete associated ApplicationSpawner.</span>
|
|
248
|
+
150: <span class="ruby-identifier">key</span> = <span class="ruby-node">"app:#{app_root}"</span>
|
|
249
|
+
151: <span class="ruby-identifier">spawner</span> = <span class="ruby-ivar">@spawners</span>[<span class="ruby-identifier">key</span>]
|
|
250
|
+
152: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">spawner</span>
|
|
251
|
+
153: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">spawner</span>.<span class="ruby-identifier">started?</span>
|
|
252
|
+
154: <span class="ruby-identifier">spawner</span>.<span class="ruby-identifier">stop</span>
|
|
253
|
+
155: <span class="ruby-keyword kw">end</span>
|
|
254
|
+
156: <span class="ruby-ivar">@spawners</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-identifier">key</span>)
|
|
255
|
+
157: <span class="ruby-keyword kw">end</span>
|
|
256
|
+
158: <span class="ruby-keyword kw">end</span>
|
|
257
|
+
159: <span class="ruby-ivar">@spawners</span>.<span class="ruby-identifier">each_value</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">spawner</span><span class="ruby-operator">|</span>
|
|
258
|
+
160: <span class="ruby-comment cmt"># Reload FrameworkSpawners.</span>
|
|
259
|
+
161: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">spawner</span>.<span class="ruby-identifier">respond_to?</span>(<span class="ruby-identifier">:reload</span>)
|
|
260
|
+
162: <span class="ruby-identifier">spawner</span>.<span class="ruby-identifier">reload</span>(<span class="ruby-identifier">app_root</span>)
|
|
261
|
+
163: <span class="ruby-keyword kw">end</span>
|
|
262
|
+
164: <span class="ruby-keyword kw">end</span>
|
|
263
|
+
165: <span class="ruby-keyword kw">end</span>
|
|
264
|
+
166: <span class="ruby-keyword kw">end</span>
|
|
265
|
+
</pre>
|
|
266
|
+
</div>
|
|
267
|
+
</div>
|
|
268
|
+
</div>
|
|
269
|
+
<div class="method">
|
|
270
|
+
<div class="title">
|
|
271
|
+
<a name="M000045"></a><b>spawn_application</b>(app_root, lower_privilege = true, lowest_user = "nobody", environment = "production", spawn_method = "smart", app_type = "rails")
|
|
272
|
+
</div>
|
|
273
|
+
<div class="description">
|
|
274
|
+
<p>
|
|
275
|
+
Spawn a RoR application When successful, an <a
|
|
276
|
+
href="Application.html">Application</a> object will be returned, which
|
|
277
|
+
represents the spawned RoR application.
|
|
278
|
+
</p>
|
|
279
|
+
<p>
|
|
280
|
+
See Railz::ApplicationSpawner.new for an explanation of the
|
|
281
|
+
<tt>lower_privilege</tt>, <tt>lowest_user</tt> and <tt>environment</tt>
|
|
282
|
+
parameters.
|
|
283
|
+
</p>
|
|
284
|
+
<p>
|
|
285
|
+
The <tt>spawn_method</tt> argument may be one of "smart" or
|
|
286
|
+
"conservative". When "smart" is specified (the
|
|
287
|
+
default), <a href="SpawnManager.html">SpawnManager</a> will internally
|
|
288
|
+
cache the code of applications, in order to speed up future spawning
|
|
289
|
+
attempts. This implies that, if you‘ve changed the
|
|
290
|
+
application‘s code, you must do one of these things:
|
|
291
|
+
</p>
|
|
292
|
+
<ul>
|
|
293
|
+
<li>Restart this <a href="SpawnManager.html">SpawnManager</a> by calling <a
|
|
294
|
+
href="AbstractServer.html#M000055">AbstractServer#stop</a>, then <a
|
|
295
|
+
href="AbstractServer.html#M000053">AbstractServer#start</a>.
|
|
296
|
+
|
|
297
|
+
</li>
|
|
298
|
+
<li>Reload the application by calling <a
|
|
299
|
+
href="SpawnManager.html#M000046">reload</a> with the correct app_root
|
|
300
|
+
argument.
|
|
301
|
+
|
|
302
|
+
</li>
|
|
303
|
+
</ul>
|
|
304
|
+
<p>
|
|
305
|
+
Caching however can be incompatible with some applications.
|
|
306
|
+
</p>
|
|
307
|
+
<p>
|
|
308
|
+
The "conservative" spawning method does not involve any caching
|
|
309
|
+
at all. Spawning will be slower, but is guaranteed to be compatible with
|
|
310
|
+
all applications.
|
|
311
|
+
</p>
|
|
312
|
+
<p>
|
|
313
|
+
Raises:
|
|
314
|
+
</p>
|
|
315
|
+
<ul>
|
|
316
|
+
<li>ArgumentError: <tt>app_root</tt> doesn‘t appear to be a valid Ruby on
|
|
317
|
+
Rails application root.
|
|
318
|
+
|
|
319
|
+
</li>
|
|
320
|
+
<li><a href="VersionNotFound.html">VersionNotFound</a>: The Ruby on Rails
|
|
321
|
+
framework version that the given application requires is not installed.
|
|
322
|
+
|
|
323
|
+
</li>
|
|
324
|
+
<li><a href="AbstractServer/ServerError.html">AbstractServer::ServerError</a>:
|
|
325
|
+
One of the server processes exited unexpectedly.
|
|
326
|
+
|
|
327
|
+
</li>
|
|
328
|
+
<li><a href="FrameworkInitError.html">FrameworkInitError</a>: The Ruby on Rails
|
|
329
|
+
framework that the application requires could not be loaded.
|
|
330
|
+
|
|
331
|
+
</li>
|
|
332
|
+
<li><a href="AppInitError.html">AppInitError</a>: The application raised an
|
|
333
|
+
exception or called exit() during startup.
|
|
334
|
+
|
|
335
|
+
</li>
|
|
336
|
+
</ul>
|
|
337
|
+
</div>
|
|
338
|
+
<div class="sourcecode">
|
|
339
|
+
<p class="source-link">[ <a href="javascript:toggleSource('M000045_source')" id="l_M000045_source">show source</a> ]</p>
|
|
340
|
+
<div id="M000045_source" class="dyn-source">
|
|
341
|
+
<pre>
|
|
342
|
+
<span class="ruby-comment cmt"># File lib/passenger/spawn_manager.rb, line 103</span>
|
|
343
|
+
103: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">spawn_application</span>(<span class="ruby-identifier">app_root</span>, <span class="ruby-identifier">lower_privilege</span> = <span class="ruby-keyword kw">true</span>, <span class="ruby-identifier">lowest_user</span> = <span class="ruby-value str">"nobody"</span>,
|
|
344
|
+
104: <span class="ruby-identifier">environment</span> = <span class="ruby-value str">"production"</span>, <span class="ruby-identifier">spawn_method</span> = <span class="ruby-value str">"smart"</span>,
|
|
345
|
+
105: <span class="ruby-identifier">app_type</span> = <span class="ruby-value str">"rails"</span>)
|
|
346
|
+
106: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">app_type</span> <span class="ruby-operator">==</span> <span class="ruby-value str">"rack"</span>
|
|
347
|
+
107: <span class="ruby-keyword kw">if</span> <span class="ruby-operator">!</span><span class="ruby-keyword kw">defined?</span>(<span class="ruby-constant">Rack</span><span class="ruby-operator">::</span><span class="ruby-constant">ApplicationSpawner</span>)
|
|
348
|
+
108: <span class="ruby-identifier">require</span> <span class="ruby-value str">'passenger/rack/application_spawner'</span>
|
|
349
|
+
109: <span class="ruby-keyword kw">end</span>
|
|
350
|
+
110: <span class="ruby-keyword kw">return</span> <span class="ruby-constant">Rack</span><span class="ruby-operator">::</span><span class="ruby-constant">ApplicationSpawner</span>.<span class="ruby-identifier">spawn_application</span>(<span class="ruby-identifier">app_root</span>,
|
|
351
|
+
111: <span class="ruby-identifier">lower_privilege</span>, <span class="ruby-identifier">lowest_user</span>, <span class="ruby-identifier">environment</span>)
|
|
352
|
+
112: <span class="ruby-keyword kw">elsif</span> <span class="ruby-identifier">app_type</span> <span class="ruby-operator">==</span> <span class="ruby-value str">"wsgi"</span>
|
|
353
|
+
113: <span class="ruby-identifier">require</span> <span class="ruby-value str">'passenger/wsgi/application_spawner'</span>
|
|
354
|
+
114: <span class="ruby-keyword kw">return</span> <span class="ruby-constant">WSGI</span><span class="ruby-operator">::</span><span class="ruby-constant">ApplicationSpawner</span>.<span class="ruby-identifier">spawn_application</span>(<span class="ruby-identifier">app_root</span>,
|
|
355
|
+
115: <span class="ruby-identifier">lower_privilege</span>, <span class="ruby-identifier">lowest_user</span>, <span class="ruby-identifier">environment</span>)
|
|
356
|
+
116: <span class="ruby-keyword kw">else</span>
|
|
357
|
+
117: <span class="ruby-keyword kw">if</span> <span class="ruby-operator">!</span><span class="ruby-keyword kw">defined?</span>(<span class="ruby-constant">Railz</span><span class="ruby-operator">::</span><span class="ruby-constant">FrameworkSpawner</span>)
|
|
358
|
+
118: <span class="ruby-identifier">require</span> <span class="ruby-value str">'passenger/application'</span>
|
|
359
|
+
119: <span class="ruby-identifier">require</span> <span class="ruby-value str">'passenger/railz/framework_spawner'</span>
|
|
360
|
+
120: <span class="ruby-identifier">require</span> <span class="ruby-value str">'passenger/railz/application_spawner'</span>
|
|
361
|
+
121: <span class="ruby-keyword kw">end</span>
|
|
362
|
+
122: <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">spawn_rails_application</span>(<span class="ruby-identifier">app_root</span>, <span class="ruby-identifier">lower_privilege</span>, <span class="ruby-identifier">lowest_user</span>,
|
|
363
|
+
123: <span class="ruby-identifier">environment</span>, <span class="ruby-identifier">spawn_method</span>)
|
|
364
|
+
124: <span class="ruby-keyword kw">end</span>
|
|
365
|
+
125: <span class="ruby-keyword kw">end</span>
|
|
366
|
+
</pre>
|
|
367
|
+
</div>
|
|
368
|
+
</div>
|
|
369
|
+
</div>
|
|
370
|
+
</div>
|
|
371
|
+
|
|
372
|
+
</div>
|
|
373
|
+
|
|
374
|
+
</body>
|
|
375
|
+
</html>
|