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,150 @@
|
|
|
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: IO</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 />IO</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/utils_rb.html">lib/passenger/utils.rb</a>
|
|
61
|
+
</td>
|
|
62
|
+
</tr>
|
|
63
|
+
<tr>
|
|
64
|
+
<td>Parent:</td>
|
|
65
|
+
<td>
|
|
66
|
+
Object
|
|
67
|
+
</td>
|
|
68
|
+
</tr>
|
|
69
|
+
</table>
|
|
70
|
+
</td>
|
|
71
|
+
</tr>
|
|
72
|
+
</table>
|
|
73
|
+
<!-- banner header -->
|
|
74
|
+
|
|
75
|
+
<div id="bodyContent">
|
|
76
|
+
<div id="content">
|
|
77
|
+
|
|
78
|
+
|
|
79
|
+
|
|
80
|
+
|
|
81
|
+
<div class="sectiontitle">Methods</div>
|
|
82
|
+
<ul>
|
|
83
|
+
<li><a href="#M000004">recv_io</a></li>
|
|
84
|
+
<li><a href="#M000003">send_io</a></li>
|
|
85
|
+
</ul>
|
|
86
|
+
|
|
87
|
+
|
|
88
|
+
|
|
89
|
+
|
|
90
|
+
|
|
91
|
+
|
|
92
|
+
<div class="sectiontitle">Public Instance methods</div>
|
|
93
|
+
<div class="method">
|
|
94
|
+
<div class="title">
|
|
95
|
+
<a name="M000004"></a><b>recv_io</b>()
|
|
96
|
+
</div>
|
|
97
|
+
<div class="description">
|
|
98
|
+
<p>
|
|
99
|
+
Receive an <a href="IO.html">IO</a> object (i.e. a file descriptor) from
|
|
100
|
+
this <a href="IO.html">IO</a> channel. This only works if this <a
|
|
101
|
+
href="IO.html">IO</a> channel is a Unix socket.
|
|
102
|
+
</p>
|
|
103
|
+
<p>
|
|
104
|
+
Raises SystemCallError if something went wrong.
|
|
105
|
+
</p>
|
|
106
|
+
</div>
|
|
107
|
+
<div class="sourcecode">
|
|
108
|
+
<p class="source-link">[ <a href="javascript:toggleSource('M000004_source')" id="l_M000004_source">show source</a> ]</p>
|
|
109
|
+
<div id="M000004_source" class="dyn-source">
|
|
110
|
+
<pre>
|
|
111
|
+
<span class="ruby-comment cmt"># File lib/passenger/utils.rb, line 330</span>
|
|
112
|
+
330: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">recv_io</span>
|
|
113
|
+
331: <span class="ruby-keyword kw">return</span> <span class="ruby-constant">IO</span>.<span class="ruby-identifier">new</span>(<span class="ruby-constant">Passenger</span><span class="ruby-operator">::</span><span class="ruby-constant">NativeSupport</span>.<span class="ruby-identifier">recv_fd</span>(<span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">fileno</span>))
|
|
114
|
+
332: <span class="ruby-keyword kw">end</span>
|
|
115
|
+
</pre>
|
|
116
|
+
</div>
|
|
117
|
+
</div>
|
|
118
|
+
</div>
|
|
119
|
+
<div class="method">
|
|
120
|
+
<div class="title">
|
|
121
|
+
<a name="M000003"></a><b>send_io</b>(io)
|
|
122
|
+
</div>
|
|
123
|
+
<div class="description">
|
|
124
|
+
<p>
|
|
125
|
+
Send an <a href="IO.html">IO</a> object (i.e. a file descriptor) over this
|
|
126
|
+
<a href="IO.html">IO</a> channel. This only works if this <a
|
|
127
|
+
href="IO.html">IO</a> channel is a Unix socket.
|
|
128
|
+
</p>
|
|
129
|
+
<p>
|
|
130
|
+
Raises SystemCallError if something went wrong.
|
|
131
|
+
</p>
|
|
132
|
+
</div>
|
|
133
|
+
<div class="sourcecode">
|
|
134
|
+
<p class="source-link">[ <a href="javascript:toggleSource('M000003_source')" id="l_M000003_source">show source</a> ]</p>
|
|
135
|
+
<div id="M000003_source" class="dyn-source">
|
|
136
|
+
<pre>
|
|
137
|
+
<span class="ruby-comment cmt"># File lib/passenger/utils.rb, line 322</span>
|
|
138
|
+
322: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">send_io</span>(<span class="ruby-identifier">io</span>)
|
|
139
|
+
323: <span class="ruby-constant">Passenger</span><span class="ruby-operator">::</span><span class="ruby-constant">NativeSupport</span>.<span class="ruby-identifier">send_fd</span>(<span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">fileno</span>, <span class="ruby-identifier">io</span>.<span class="ruby-identifier">fileno</span>)
|
|
140
|
+
324: <span class="ruby-keyword kw">end</span>
|
|
141
|
+
</pre>
|
|
142
|
+
</div>
|
|
143
|
+
</div>
|
|
144
|
+
</div>
|
|
145
|
+
</div>
|
|
146
|
+
|
|
147
|
+
</div>
|
|
148
|
+
|
|
149
|
+
</body>
|
|
150
|
+
</html>
|
|
@@ -0,0 +1,136 @@
|
|
|
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</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</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/abstract_server_rb.html">lib/passenger/abstract_server.rb</a>
|
|
61
|
+
<a href="../files/lib/passenger/message_channel_rb.html">lib/passenger/message_channel.rb</a>
|
|
62
|
+
<a href="../files/lib/passenger/dependencies_rb.html">lib/passenger/dependencies.rb</a>
|
|
63
|
+
<a href="../files/lib/passenger/console_text_template_rb.html">lib/passenger/console_text_template.rb</a>
|
|
64
|
+
<a href="../files/lib/passenger/spawn_manager_rb.html">lib/passenger/spawn_manager.rb</a>
|
|
65
|
+
<a href="../files/lib/passenger/application_rb.html">lib/passenger/application.rb</a>
|
|
66
|
+
<a href="../files/lib/passenger/exceptions_rb.html">lib/passenger/exceptions.rb</a>
|
|
67
|
+
<a href="../files/lib/passenger/html_template_rb.html">lib/passenger/html_template.rb</a>
|
|
68
|
+
<a href="../files/lib/passenger/constants_rb.html">lib/passenger/constants.rb</a>
|
|
69
|
+
<a href="../files/lib/passenger/utils_rb.html">lib/passenger/utils.rb</a>
|
|
70
|
+
<a href="../files/lib/passenger/abstract_request_handler_rb.html">lib/passenger/abstract_request_handler.rb</a>
|
|
71
|
+
<a href="../files/ext/passenger/native_support_c.html">ext/passenger/native_support.c</a>
|
|
72
|
+
</td>
|
|
73
|
+
</tr>
|
|
74
|
+
</table>
|
|
75
|
+
</td>
|
|
76
|
+
</tr>
|
|
77
|
+
</table>
|
|
78
|
+
<!-- banner header -->
|
|
79
|
+
|
|
80
|
+
<div id="bodyContent">
|
|
81
|
+
<div id="content">
|
|
82
|
+
|
|
83
|
+
|
|
84
|
+
|
|
85
|
+
|
|
86
|
+
|
|
87
|
+
|
|
88
|
+
|
|
89
|
+
<div class="sectiontitle">Classes and Modules</div>
|
|
90
|
+
Module <a href="Passenger/NativeSupport.html" class="link">Passenger::NativeSupport</a><br />
|
|
91
|
+
Module <a href="Passenger/Utils.html" class="link">Passenger::Utils</a><br />
|
|
92
|
+
Class <a href="Passenger/AbstractRequestHandler.html" class="link">Passenger::AbstractRequestHandler</a><br />
|
|
93
|
+
Class <a href="Passenger/AbstractServer.html" class="link">Passenger::AbstractServer</a><br />
|
|
94
|
+
Class <a href="Passenger/AppInitError.html" class="link">Passenger::AppInitError</a><br />
|
|
95
|
+
Class <a href="Passenger/Application.html" class="link">Passenger::Application</a><br />
|
|
96
|
+
Class <a href="Passenger/ConsoleTextTemplate.html" class="link">Passenger::ConsoleTextTemplate</a><br />
|
|
97
|
+
Class <a href="Passenger/FrameworkInitError.html" class="link">Passenger::FrameworkInitError</a><br />
|
|
98
|
+
Class <a href="Passenger/HTMLTemplate.html" class="link">Passenger::HTMLTemplate</a><br />
|
|
99
|
+
Class <a href="Passenger/InitializationError.html" class="link">Passenger::InitializationError</a><br />
|
|
100
|
+
Class <a href="Passenger/MessageChannel.html" class="link">Passenger::MessageChannel</a><br />
|
|
101
|
+
Class <a href="Passenger/SpawnManager.html" class="link">Passenger::SpawnManager</a><br />
|
|
102
|
+
Class <a href="Passenger/UnknownError.html" class="link">Passenger::UnknownError</a><br />
|
|
103
|
+
Class <a href="Passenger/VersionNotFound.html" class="link">Passenger::VersionNotFound</a><br />
|
|
104
|
+
|
|
105
|
+
|
|
106
|
+
<div class="sectiontitle">Constants</div>
|
|
107
|
+
<table border='0' cellpadding='5'>
|
|
108
|
+
<tr valign='top'>
|
|
109
|
+
<td class="attr-name">FRAMEWORK_SPAWNER_MAX_IDLE_TIME</td>
|
|
110
|
+
<td>=</td>
|
|
111
|
+
<td class="attr-value">30 * 60</td>
|
|
112
|
+
</tr>
|
|
113
|
+
<tr valign='top'>
|
|
114
|
+
<td class="attr-name">APP_SPAWNER_MAX_IDLE_TIME</td>
|
|
115
|
+
<td>=</td>
|
|
116
|
+
<td class="attr-value">10 * 60</td>
|
|
117
|
+
</tr>
|
|
118
|
+
<tr valign='top'>
|
|
119
|
+
<td class="attr-name">SPAWNER_CLEAN_INTERVAL</td>
|
|
120
|
+
<td>=</td>
|
|
121
|
+
<td class="attr-value">[ FRAMEWORK_SPAWNER_MAX_IDLE_TIME, APP_SPAWNER_MAX_IDLE_TIME</td>
|
|
122
|
+
</tr>
|
|
123
|
+
<tr valign='top'>
|
|
124
|
+
<td class="attr-name">APP_SPAWNER_CLEAN_INTERVAL</td>
|
|
125
|
+
<td>=</td>
|
|
126
|
+
<td class="attr-value">APP_SPAWNER_MAX_IDLE_TIME + 5</td>
|
|
127
|
+
</tr>
|
|
128
|
+
</table>
|
|
129
|
+
|
|
130
|
+
|
|
131
|
+
</div>
|
|
132
|
+
|
|
133
|
+
</div>
|
|
134
|
+
|
|
135
|
+
</body>
|
|
136
|
+
</html>
|
|
@@ -0,0 +1,402 @@
|
|
|
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::AbstractRequestHandler</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::AbstractRequestHandler</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/abstract_request_handler_rb.html">lib/passenger/abstract_request_handler.rb</a>
|
|
61
|
+
</td>
|
|
62
|
+
</tr>
|
|
63
|
+
<tr>
|
|
64
|
+
<td>Parent:</td>
|
|
65
|
+
<td>
|
|
66
|
+
Object
|
|
67
|
+
</td>
|
|
68
|
+
</tr>
|
|
69
|
+
</table>
|
|
70
|
+
</td>
|
|
71
|
+
</tr>
|
|
72
|
+
</table>
|
|
73
|
+
<!-- banner header -->
|
|
74
|
+
|
|
75
|
+
<div id="bodyContent">
|
|
76
|
+
<div id="content">
|
|
77
|
+
|
|
78
|
+
<div class="description"><p>
|
|
79
|
+
The request handler is the layer which connects Apache with the underlying
|
|
80
|
+
application‘s request dispatcher (i.e. either Rails‘s
|
|
81
|
+
Dispatcher class or Rack). The request handler‘s job is to process
|
|
82
|
+
incoming HTTP requests using the currently loaded Ruby on Rails
|
|
83
|
+
application. HTTP requests are forwarded to the request handler by the web
|
|
84
|
+
server. HTTP responses generated by the RoR application are forwarded to
|
|
85
|
+
the web server, which, in turn, sends the response back to the HTTP client.
|
|
86
|
+
</p>
|
|
87
|
+
<p>
|
|
88
|
+
<a href="AbstractRequestHandler.html">AbstractRequestHandler</a> is an
|
|
89
|
+
abstract base class for easing the implementation of request handlers for
|
|
90
|
+
Rails and Rack.
|
|
91
|
+
</p>
|
|
92
|
+
<h2>Design decisions</h2>
|
|
93
|
+
<p>
|
|
94
|
+
Some design decisions are made because we want to decrease system
|
|
95
|
+
administrator maintenance overhead. These decisions are documented in this
|
|
96
|
+
section.
|
|
97
|
+
</p>
|
|
98
|
+
<h3>Abstract namespace Unix sockets</h3>
|
|
99
|
+
<p>
|
|
100
|
+
<a href="AbstractRequestHandler.html">AbstractRequestHandler</a> listens on
|
|
101
|
+
a Unix socket for incoming requests. If possible, <a
|
|
102
|
+
href="AbstractRequestHandler.html">AbstractRequestHandler</a> will try to
|
|
103
|
+
create a Unix socket on the _abstract namespace_, instead of on the
|
|
104
|
+
filesystem. If the RoR application crashes (segfault), or if it gets killed
|
|
105
|
+
by SIGKILL, or if the system loses power, then there will be no stale
|
|
106
|
+
socket files left on the filesystem. Unfortunately, abstract namespace Unix
|
|
107
|
+
sockets are only supported by Linux. On systems that do not support
|
|
108
|
+
abstract namespace Unix sockets, <a
|
|
109
|
+
href="AbstractRequestHandler.html">AbstractRequestHandler</a> will
|
|
110
|
+
automatically fallback to using regular Unix socket files.
|
|
111
|
+
</p>
|
|
112
|
+
<p>
|
|
113
|
+
It is possible to force <a
|
|
114
|
+
href="AbstractRequestHandler.html">AbstractRequestHandler</a> to use
|
|
115
|
+
regular Unix socket files by setting the environment variable
|
|
116
|
+
PASSENGER_NO_ABSTRACT_NAMESPACE_SOCKETS to 1.
|
|
117
|
+
</p>
|
|
118
|
+
<h3>Owner pipes</h3>
|
|
119
|
+
<p>
|
|
120
|
+
Because only the web server communicates directly with a request handler,
|
|
121
|
+
we want the request handler to exit if the web server has also exited. This
|
|
122
|
+
is implemented by using a so-called _owner pipe_. The writable part of the
|
|
123
|
+
pipe will be owned by the web server. <a
|
|
124
|
+
href="AbstractRequestHandler.html">AbstractRequestHandler</a> will
|
|
125
|
+
continuously check whether the other side of the pipe has been closed. If
|
|
126
|
+
so, then it knows that the web server has exited, and so the request
|
|
127
|
+
handler will exit as well. This works even if the web server gets killed by
|
|
128
|
+
SIGKILL.
|
|
129
|
+
</p>
|
|
130
|
+
<h2>Request format</h2>
|
|
131
|
+
<p>
|
|
132
|
+
Incoming "HTTP requests" are not true HTTP requests, i.e. their
|
|
133
|
+
binary representation do not conform to RFC 2616. Instead, the request
|
|
134
|
+
format is based on CGI, and is similar to that of SCGI.
|
|
135
|
+
</p>
|
|
136
|
+
<p>
|
|
137
|
+
The format consists of 3 parts:
|
|
138
|
+
</p>
|
|
139
|
+
<ul>
|
|
140
|
+
<li>A 32-bit big-endian integer, containing the size of the transformed
|
|
141
|
+
headers.
|
|
142
|
+
|
|
143
|
+
</li>
|
|
144
|
+
<li>The transformed HTTP headers.
|
|
145
|
+
|
|
146
|
+
</li>
|
|
147
|
+
<li>The verbatim (untransformed) HTTP request body.
|
|
148
|
+
|
|
149
|
+
</li>
|
|
150
|
+
</ul>
|
|
151
|
+
<p>
|
|
152
|
+
HTTP headers are transformed to a format that satisfies the following
|
|
153
|
+
grammar:
|
|
154
|
+
</p>
|
|
155
|
+
<pre>
|
|
156
|
+
headers ::= header*
|
|
157
|
+
header ::= name NUL value NUL
|
|
158
|
+
name ::= notnull+
|
|
159
|
+
value ::= notnull+
|
|
160
|
+
notnull ::= "\x01" | "\x02" | "\x02" | ... | "\xFF"
|
|
161
|
+
NUL = "\x00"
|
|
162
|
+
</pre>
|
|
163
|
+
<p>
|
|
164
|
+
The web server transforms the HTTP request to the aforementioned format,
|
|
165
|
+
and sends it to the request handler.
|
|
166
|
+
</p>
|
|
167
|
+
</div>
|
|
168
|
+
|
|
169
|
+
|
|
170
|
+
|
|
171
|
+
<div class="sectiontitle">Methods</div>
|
|
172
|
+
<ul>
|
|
173
|
+
<li><a href="#M000041">cleanup</a></li>
|
|
174
|
+
<li><a href="#M000043">main_loop</a></li>
|
|
175
|
+
<li><a href="#M000040">new</a></li>
|
|
176
|
+
<li><a href="#M000042">using_abstract_namespace?</a></li>
|
|
177
|
+
</ul>
|
|
178
|
+
|
|
179
|
+
<div class="sectiontitle">Included Modules</div>
|
|
180
|
+
<ul>
|
|
181
|
+
<li><a href="Utils.html">Utils</a></li>
|
|
182
|
+
</ul>
|
|
183
|
+
|
|
184
|
+
|
|
185
|
+
|
|
186
|
+
<div class="sectiontitle">Constants</div>
|
|
187
|
+
<table border='0' cellpadding='5'>
|
|
188
|
+
<tr valign='top'>
|
|
189
|
+
<td class="attr-name">HARD_TERMINATION_SIGNAL</td>
|
|
190
|
+
<td>=</td>
|
|
191
|
+
<td class="attr-value">"SIGTERM"</td>
|
|
192
|
+
</tr>
|
|
193
|
+
<tr valign='top'>
|
|
194
|
+
<td> </td>
|
|
195
|
+
<td colspan="2" class="attr-desc">
|
|
196
|
+
Signal which will cause the Rails application to exit immediately.
|
|
197
|
+
|
|
198
|
+
</td>
|
|
199
|
+
</tr>
|
|
200
|
+
<tr valign='top'>
|
|
201
|
+
<td class="attr-name">SOFT_TERMINATION_SIGNAL</td>
|
|
202
|
+
<td>=</td>
|
|
203
|
+
<td class="attr-value">"SIGUSR1"</td>
|
|
204
|
+
</tr>
|
|
205
|
+
<tr valign='top'>
|
|
206
|
+
<td> </td>
|
|
207
|
+
<td colspan="2" class="attr-desc">
|
|
208
|
+
Signal which will cause the Rails application to exit as soon as it‘s
|
|
209
|
+
done processing a request.
|
|
210
|
+
|
|
211
|
+
</td>
|
|
212
|
+
</tr>
|
|
213
|
+
<tr valign='top'>
|
|
214
|
+
<td class="attr-name">BACKLOG_SIZE</td>
|
|
215
|
+
<td>=</td>
|
|
216
|
+
<td class="attr-value">50</td>
|
|
217
|
+
</tr>
|
|
218
|
+
<tr valign='top'>
|
|
219
|
+
<td class="attr-name">MAX_HEADER_SIZE</td>
|
|
220
|
+
<td>=</td>
|
|
221
|
+
<td class="attr-value">128 * 1024</td>
|
|
222
|
+
</tr>
|
|
223
|
+
<tr valign='top'>
|
|
224
|
+
<td class="attr-name">PASSENGER_VERSION</td>
|
|
225
|
+
<td>=</td>
|
|
226
|
+
<td class="attr-value">determine_passenger_version</td>
|
|
227
|
+
</tr>
|
|
228
|
+
<tr valign='top'>
|
|
229
|
+
<td class="attr-name">PASSENGER_HEADER</td>
|
|
230
|
+
<td>=</td>
|
|
231
|
+
<td class="attr-value">determine_passenger_header</td>
|
|
232
|
+
</tr>
|
|
233
|
+
</table>
|
|
234
|
+
|
|
235
|
+
<div class="sectiontitle">Attributes</div>
|
|
236
|
+
<table border='0' cellpadding='5'>
|
|
237
|
+
<tr valign='top'>
|
|
238
|
+
<td class='attr-rw'>
|
|
239
|
+
[R]
|
|
240
|
+
</td>
|
|
241
|
+
<td class='attr-name'>socket_name</td>
|
|
242
|
+
<td class='attr-desc'>
|
|
243
|
+
The name of the socket on which the request handler accepts <a
|
|
244
|
+
href="AbstractRequestHandler.html#M000040">new</a> connections. This is
|
|
245
|
+
either a Unix socket filename, or the name for an abstract namespace Unix
|
|
246
|
+
socket.
|
|
247
|
+
|
|
248
|
+
<p>
|
|
249
|
+
If <tt>socket_name</tt> refers to an abstract namespace Unix socket, then
|
|
250
|
+
the name does <em>not</em> contain a leading null byte.
|
|
251
|
+
</p>
|
|
252
|
+
<p>
|
|
253
|
+
See also <a
|
|
254
|
+
href="AbstractRequestHandler.html#M000042">using_abstract_namespace?</a>
|
|
255
|
+
</p>
|
|
256
|
+
</td>
|
|
257
|
+
</tr>
|
|
258
|
+
</table>
|
|
259
|
+
|
|
260
|
+
<div class="sectiontitle">Public Class methods</div>
|
|
261
|
+
<div class="method">
|
|
262
|
+
<div class="title">
|
|
263
|
+
<a name="M000040"></a><b>new</b>(owner_pipe)
|
|
264
|
+
</div>
|
|
265
|
+
<div class="description">
|
|
266
|
+
<p>
|
|
267
|
+
Create a <a href="AbstractRequestHandler.html#M000040">new</a>
|
|
268
|
+
RequestHandler with the given owner pipe. <tt>owner_pipe</tt> must be the
|
|
269
|
+
readable part of a pipe <a href="../IO.html">IO</a> object.
|
|
270
|
+
</p>
|
|
271
|
+
</div>
|
|
272
|
+
<div class="sourcecode">
|
|
273
|
+
<p class="source-link">[ <a href="javascript:toggleSource('M000040_source')" id="l_M000040_source">show source</a> ]</p>
|
|
274
|
+
<div id="M000040_source" class="dyn-source">
|
|
275
|
+
<pre>
|
|
276
|
+
<span class="ruby-comment cmt"># File lib/passenger/abstract_request_handler.rb, line 120</span>
|
|
277
|
+
120: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-identifier">owner_pipe</span>)
|
|
278
|
+
121: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">abstract_namespace_sockets_allowed?</span>
|
|
279
|
+
122: <span class="ruby-ivar">@using_abstract_namespace</span> = <span class="ruby-identifier">create_unix_socket_on_abstract_namespace</span>
|
|
280
|
+
123: <span class="ruby-keyword kw">else</span>
|
|
281
|
+
124: <span class="ruby-ivar">@using_abstract_namespace</span> = <span class="ruby-keyword kw">false</span>
|
|
282
|
+
125: <span class="ruby-keyword kw">end</span>
|
|
283
|
+
126: <span class="ruby-keyword kw">if</span> <span class="ruby-operator">!</span><span class="ruby-ivar">@using_abstract_namespace</span>
|
|
284
|
+
127: <span class="ruby-identifier">create_unix_socket_on_filesystem</span>
|
|
285
|
+
128: <span class="ruby-keyword kw">end</span>
|
|
286
|
+
129: <span class="ruby-ivar">@socket</span>.<span class="ruby-identifier">fcntl</span>(<span class="ruby-constant">Fcntl</span><span class="ruby-operator">::</span><span class="ruby-constant">F_SETFD</span>, <span class="ruby-constant">Fcntl</span><span class="ruby-operator">::</span><span class="ruby-constant">FD_CLOEXEC</span>)
|
|
287
|
+
130: <span class="ruby-ivar">@owner_pipe</span> = <span class="ruby-identifier">owner_pipe</span>
|
|
288
|
+
131: <span class="ruby-ivar">@previous_signal_handlers</span> = {}
|
|
289
|
+
132: <span class="ruby-keyword kw">end</span>
|
|
290
|
+
</pre>
|
|
291
|
+
</div>
|
|
292
|
+
</div>
|
|
293
|
+
</div>
|
|
294
|
+
<div class="sectiontitle">Public Instance methods</div>
|
|
295
|
+
<div class="method">
|
|
296
|
+
<div class="title">
|
|
297
|
+
<a name="M000041"></a><b>cleanup</b>()
|
|
298
|
+
</div>
|
|
299
|
+
<div class="description">
|
|
300
|
+
<p>
|
|
301
|
+
Clean up temporary stuff created by the request handler. This method should
|
|
302
|
+
be called after the main loop has exited.
|
|
303
|
+
</p>
|
|
304
|
+
</div>
|
|
305
|
+
<div class="sourcecode">
|
|
306
|
+
<p class="source-link">[ <a href="javascript:toggleSource('M000041_source')" id="l_M000041_source">show source</a> ]</p>
|
|
307
|
+
<div id="M000041_source" class="dyn-source">
|
|
308
|
+
<pre>
|
|
309
|
+
<span class="ruby-comment cmt"># File lib/passenger/abstract_request_handler.rb, line 136</span>
|
|
310
|
+
136: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">cleanup</span>
|
|
311
|
+
137: <span class="ruby-ivar">@socket</span>.<span class="ruby-identifier">close</span> <span class="ruby-keyword kw">rescue</span> <span class="ruby-keyword kw">nil</span>
|
|
312
|
+
138: <span class="ruby-ivar">@owner_pipe</span>.<span class="ruby-identifier">close</span> <span class="ruby-keyword kw">rescue</span> <span class="ruby-keyword kw">nil</span>
|
|
313
|
+
139: <span class="ruby-keyword kw">if</span> <span class="ruby-operator">!</span><span class="ruby-identifier">using_abstract_namespace?</span>
|
|
314
|
+
140: <span class="ruby-constant">File</span>.<span class="ruby-identifier">unlink</span>(<span class="ruby-ivar">@socket_name</span>) <span class="ruby-keyword kw">rescue</span> <span class="ruby-keyword kw">nil</span>
|
|
315
|
+
141: <span class="ruby-keyword kw">end</span>
|
|
316
|
+
142: <span class="ruby-keyword kw">end</span>
|
|
317
|
+
</pre>
|
|
318
|
+
</div>
|
|
319
|
+
</div>
|
|
320
|
+
</div>
|
|
321
|
+
<div class="method">
|
|
322
|
+
<div class="title">
|
|
323
|
+
<a name="M000043"></a><b>main_loop</b>()
|
|
324
|
+
</div>
|
|
325
|
+
<div class="description">
|
|
326
|
+
<p>
|
|
327
|
+
Enter the request handler‘s main loop.
|
|
328
|
+
</p>
|
|
329
|
+
</div>
|
|
330
|
+
<div class="sourcecode">
|
|
331
|
+
<p class="source-link">[ <a href="javascript:toggleSource('M000043_source')" id="l_M000043_source">show source</a> ]</p>
|
|
332
|
+
<div id="M000043_source" class="dyn-source">
|
|
333
|
+
<pre>
|
|
334
|
+
<span class="ruby-comment cmt"># File lib/passenger/abstract_request_handler.rb, line 150</span>
|
|
335
|
+
150: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">main_loop</span>
|
|
336
|
+
151: <span class="ruby-identifier">reset_signal_handlers</span>
|
|
337
|
+
152: <span class="ruby-keyword kw">begin</span>
|
|
338
|
+
153: <span class="ruby-identifier">done</span> = <span class="ruby-keyword kw">false</span>
|
|
339
|
+
154: <span class="ruby-keyword kw">while</span> <span class="ruby-operator">!</span><span class="ruby-identifier">done</span>
|
|
340
|
+
155: <span class="ruby-identifier">client</span> = <span class="ruby-identifier">accept_connection</span>
|
|
341
|
+
156: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">client</span>.<span class="ruby-identifier">nil?</span>
|
|
342
|
+
157: <span class="ruby-keyword kw">break</span>
|
|
343
|
+
158: <span class="ruby-keyword kw">end</span>
|
|
344
|
+
159: <span class="ruby-identifier">trap</span> <span class="ruby-constant">SOFT_TERMINATION_SIGNAL</span> <span class="ruby-keyword kw">do</span>
|
|
345
|
+
160: <span class="ruby-identifier">done</span> = <span class="ruby-keyword kw">true</span>
|
|
346
|
+
161: <span class="ruby-keyword kw">end</span>
|
|
347
|
+
162: <span class="ruby-keyword kw">begin</span>
|
|
348
|
+
163: <span class="ruby-identifier">headers</span>, <span class="ruby-identifier">input</span> = <span class="ruby-identifier">parse_request</span>(<span class="ruby-identifier">client</span>)
|
|
349
|
+
164: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">headers</span>
|
|
350
|
+
165: <span class="ruby-identifier">process_request</span>(<span class="ruby-identifier">headers</span>, <span class="ruby-identifier">input</span>, <span class="ruby-identifier">client</span>)
|
|
351
|
+
166: <span class="ruby-keyword kw">end</span>
|
|
352
|
+
167: <span class="ruby-keyword kw">rescue</span> <span class="ruby-constant">IOError</span>, <span class="ruby-constant">SocketError</span>, <span class="ruby-constant">SystemCallError</span> =<span class="ruby-operator">></span> <span class="ruby-identifier">e</span>
|
|
353
|
+
168: <span class="ruby-identifier">print_exception</span>(<span class="ruby-value str">"Passenger RequestHandler"</span>, <span class="ruby-identifier">e</span>)
|
|
354
|
+
169: <span class="ruby-keyword kw">ensure</span>
|
|
355
|
+
170: <span class="ruby-identifier">client</span>.<span class="ruby-identifier">close</span> <span class="ruby-keyword kw">rescue</span> <span class="ruby-keyword kw">nil</span>
|
|
356
|
+
171: <span class="ruby-keyword kw">end</span>
|
|
357
|
+
172: <span class="ruby-identifier">trap</span> <span class="ruby-constant">SOFT_TERMINATION_SIGNAL</span>, <span class="ruby-constant">DEFAULT</span>
|
|
358
|
+
173: <span class="ruby-keyword kw">end</span>
|
|
359
|
+
174: <span class="ruby-keyword kw">rescue</span> <span class="ruby-constant">EOFError</span>
|
|
360
|
+
175: <span class="ruby-comment cmt"># Exit main loop.</span>
|
|
361
|
+
176: <span class="ruby-keyword kw">rescue</span> <span class="ruby-constant">Interrupt</span>
|
|
362
|
+
177: <span class="ruby-comment cmt"># Exit main loop.</span>
|
|
363
|
+
178: <span class="ruby-keyword kw">rescue</span> <span class="ruby-constant">SignalException</span> =<span class="ruby-operator">></span> <span class="ruby-identifier">signal</span>
|
|
364
|
+
179: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">signal</span>.<span class="ruby-identifier">message</span> <span class="ruby-operator">!=</span> <span class="ruby-constant">HARD_TERMINATION_SIGNAL</span> <span class="ruby-operator">&&</span>
|
|
365
|
+
180: <span class="ruby-identifier">signal</span>.<span class="ruby-identifier">message</span> <span class="ruby-operator">!=</span> <span class="ruby-constant">SOFT_TERMINATION_SIGNAL</span>
|
|
366
|
+
181: <span class="ruby-identifier">raise</span>
|
|
367
|
+
182: <span class="ruby-keyword kw">end</span>
|
|
368
|
+
183: <span class="ruby-keyword kw">ensure</span>
|
|
369
|
+
184: <span class="ruby-identifier">revert_signal_handlers</span>
|
|
370
|
+
185: <span class="ruby-keyword kw">end</span>
|
|
371
|
+
186: <span class="ruby-keyword kw">end</span>
|
|
372
|
+
</pre>
|
|
373
|
+
</div>
|
|
374
|
+
</div>
|
|
375
|
+
</div>
|
|
376
|
+
<div class="method">
|
|
377
|
+
<div class="title">
|
|
378
|
+
<a name="M000042"></a><b>using_abstract_namespace?</b>()
|
|
379
|
+
</div>
|
|
380
|
+
<div class="description">
|
|
381
|
+
<p>
|
|
382
|
+
Returns whether socket_name refers to an abstract namespace Unix socket.
|
|
383
|
+
</p>
|
|
384
|
+
</div>
|
|
385
|
+
<div class="sourcecode">
|
|
386
|
+
<p class="source-link">[ <a href="javascript:toggleSource('M000042_source')" id="l_M000042_source">show source</a> ]</p>
|
|
387
|
+
<div id="M000042_source" class="dyn-source">
|
|
388
|
+
<pre>
|
|
389
|
+
<span class="ruby-comment cmt"># File lib/passenger/abstract_request_handler.rb, line 145</span>
|
|
390
|
+
145: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">using_abstract_namespace?</span>
|
|
391
|
+
146: <span class="ruby-keyword kw">return</span> <span class="ruby-ivar">@using_abstract_namespace</span>
|
|
392
|
+
147: <span class="ruby-keyword kw">end</span>
|
|
393
|
+
</pre>
|
|
394
|
+
</div>
|
|
395
|
+
</div>
|
|
396
|
+
</div>
|
|
397
|
+
</div>
|
|
398
|
+
|
|
399
|
+
</div>
|
|
400
|
+
|
|
401
|
+
</body>
|
|
402
|
+
</html>
|