passenger 3.0.0.pre1 → 3.0.0.pre2

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.

Files changed (189) hide show
  1. data/DEVELOPERS.TXT +2 -2
  2. data/NEWS +2 -2
  3. data/Rakefile +1 -1
  4. data/build/packaging.rb +1 -1
  5. data/doc/Users guide Apache.html +22 -22
  6. data/doc/Users guide Apache.txt +2 -2
  7. data/doc/Users guide Nginx.html +14 -14
  8. data/doc/Users guide Nginx.txt +3 -2
  9. data/doc/Users guide Standalone.html +1 -1
  10. data/doc/cxxapi/Constants_8h_source.html +1 -1
  11. data/doc/cxxapi/ResourceLocator_8h_source.html +1 -1
  12. data/doc/rdoc/classes/ConditionVariable.html +215 -0
  13. data/doc/rdoc/classes/Exception.html +120 -0
  14. data/doc/rdoc/classes/GC.html +113 -0
  15. data/doc/rdoc/classes/IO.html +221 -0
  16. data/doc/rdoc/classes/PhusionPassenger.html +368 -0
  17. data/doc/rdoc/classes/PhusionPassenger/AbstractInstaller.html +180 -0
  18. data/doc/rdoc/classes/PhusionPassenger/AbstractRequestHandler.html +647 -0
  19. data/doc/rdoc/classes/PhusionPassenger/AbstractServer.html +654 -0
  20. data/doc/rdoc/classes/PhusionPassenger/AbstractServer/InvalidPassword.html +92 -0
  21. data/doc/rdoc/classes/PhusionPassenger/AbstractServer/ServerAlreadyStarted.html +97 -0
  22. data/doc/rdoc/classes/PhusionPassenger/AbstractServer/ServerError.html +96 -0
  23. data/doc/rdoc/classes/PhusionPassenger/AbstractServer/ServerNotStarted.html +97 -0
  24. data/doc/rdoc/classes/PhusionPassenger/AbstractServer/UnknownMessage.html +96 -0
  25. data/doc/rdoc/classes/PhusionPassenger/AbstractServerCollection.html +619 -0
  26. data/doc/rdoc/classes/PhusionPassenger/AdminTools.html +142 -0
  27. data/doc/rdoc/classes/PhusionPassenger/AdminTools/MemoryStats.html +368 -0
  28. data/doc/rdoc/classes/PhusionPassenger/AdminTools/MemoryStats/Process.html +231 -0
  29. data/doc/rdoc/classes/PhusionPassenger/AdminTools/ServerInstance.html +588 -0
  30. data/doc/rdoc/classes/PhusionPassenger/AdminTools/ServerInstance/CorruptedDirectoryError.html +92 -0
  31. data/doc/rdoc/classes/PhusionPassenger/AdminTools/ServerInstance/GenerationsAbsentError.html +92 -0
  32. data/doc/rdoc/classes/PhusionPassenger/AdminTools/ServerInstance/Group.html +147 -0
  33. data/doc/rdoc/classes/PhusionPassenger/AdminTools/ServerInstance/Process.html +279 -0
  34. data/doc/rdoc/classes/PhusionPassenger/AdminTools/ServerInstance/RoleDeniedError.html +92 -0
  35. data/doc/rdoc/classes/PhusionPassenger/AdminTools/ServerInstance/StaleDirectoryError.html +92 -0
  36. data/doc/rdoc/classes/PhusionPassenger/AdminTools/ServerInstance/Stats.html +123 -0
  37. data/doc/rdoc/classes/PhusionPassenger/AdminTools/ServerInstance/UnsupportedGenerationStructureVersionError.html +92 -0
  38. data/doc/rdoc/classes/PhusionPassenger/AnalyticsLogger.html +341 -0
  39. data/doc/rdoc/classes/PhusionPassenger/AnalyticsLogger/Log.html +294 -0
  40. data/doc/rdoc/classes/PhusionPassenger/AnalyticsLogger/SharedData.html +199 -0
  41. data/doc/rdoc/classes/PhusionPassenger/AppInitError.html +155 -0
  42. data/doc/rdoc/classes/PhusionPassenger/AppProcess.html +367 -0
  43. data/doc/rdoc/classes/PhusionPassenger/ClassicRails.html +95 -0
  44. data/doc/rdoc/classes/PhusionPassenger/ClassicRails/ApplicationSpawner.html +351 -0
  45. data/doc/rdoc/classes/PhusionPassenger/ClassicRails/ApplicationSpawner/Error.html +98 -0
  46. data/doc/rdoc/classes/PhusionPassenger/ClassicRails/CGIFixed.html +200 -0
  47. data/doc/rdoc/classes/PhusionPassenger/ClassicRails/FrameworkSpawner.html +410 -0
  48. data/doc/rdoc/classes/PhusionPassenger/ClassicRails/FrameworkSpawner/Error.html +98 -0
  49. data/doc/rdoc/classes/PhusionPassenger/ClassicRails/RequestHandler.html +156 -0
  50. data/doc/rdoc/classes/PhusionPassenger/ClassicRailsExtensions.html +115 -0
  51. data/doc/rdoc/classes/PhusionPassenger/ClassicRailsExtensions/AnalyticsLogging.html +202 -0
  52. data/doc/rdoc/classes/PhusionPassenger/ConsoleTextTemplate.html +172 -0
  53. data/doc/rdoc/classes/PhusionPassenger/DebugLogging.html +273 -0
  54. data/doc/rdoc/classes/PhusionPassenger/FrameworkInitError.html +145 -0
  55. data/doc/rdoc/classes/PhusionPassenger/HTMLTemplate.html +162 -0
  56. data/doc/rdoc/classes/PhusionPassenger/InitializationError.html +141 -0
  57. data/doc/rdoc/classes/PhusionPassenger/InvalidPath.html +92 -0
  58. data/doc/rdoc/classes/PhusionPassenger/MessageChannel.html +673 -0
  59. data/doc/rdoc/classes/PhusionPassenger/MessageChannel/InvalidHashError.html +92 -0
  60. data/doc/rdoc/classes/PhusionPassenger/MessageClient.html +415 -0
  61. data/doc/rdoc/classes/PhusionPassenger/NativeSupport.html +494 -0
  62. data/doc/rdoc/classes/PhusionPassenger/NativeSupport/FileSystemWatcher.html +96 -0
  63. data/doc/rdoc/classes/PhusionPassenger/Packaging.html +129 -0
  64. data/doc/rdoc/classes/PhusionPassenger/PlatformInfo.html +1758 -0
  65. data/doc/rdoc/classes/PhusionPassenger/Plugin.html +237 -0
  66. data/doc/rdoc/classes/PhusionPassenger/Rack.html +91 -0
  67. data/doc/rdoc/classes/PhusionPassenger/Rack/ApplicationSpawner.html +312 -0
  68. data/doc/rdoc/classes/PhusionPassenger/Rack/ApplicationSpawner/Error.html +98 -0
  69. data/doc/rdoc/classes/PhusionPassenger/Rack/RequestHandler.html +218 -0
  70. data/doc/rdoc/classes/PhusionPassenger/Rails3Extensions.html +114 -0
  71. data/doc/rdoc/classes/PhusionPassenger/Rails3Extensions/AnalyticsLogging.html +256 -0
  72. data/doc/rdoc/classes/PhusionPassenger/Rails3Extensions/AnalyticsLogging/ACExtension.html +139 -0
  73. data/doc/rdoc/classes/PhusionPassenger/Rails3Extensions/AnalyticsLogging/ASBenchmarkableExtension.html +118 -0
  74. data/doc/rdoc/classes/PhusionPassenger/Rails3Extensions/AnalyticsLogging/ExceptionLogger.html +135 -0
  75. data/doc/rdoc/classes/PhusionPassenger/SpawnManager.html +378 -0
  76. data/doc/rdoc/classes/PhusionPassenger/Standalone.html +111 -0
  77. data/doc/rdoc/classes/PhusionPassenger/Standalone/AppFinder.html +252 -0
  78. data/doc/rdoc/classes/PhusionPassenger/Standalone/Command.html +161 -0
  79. data/doc/rdoc/classes/PhusionPassenger/Standalone/ConfigFile.html +368 -0
  80. data/doc/rdoc/classes/PhusionPassenger/Standalone/ConfigFile/DisallowedContextError.html +132 -0
  81. data/doc/rdoc/classes/PhusionPassenger/Standalone/HelpCommand.html +151 -0
  82. data/doc/rdoc/classes/PhusionPassenger/Standalone/Main.html +189 -0
  83. data/doc/rdoc/classes/PhusionPassenger/Standalone/PackageRuntimeCommand.html +177 -0
  84. data/doc/rdoc/classes/PhusionPassenger/Standalone/RuntimeInstaller.html +341 -0
  85. data/doc/rdoc/classes/PhusionPassenger/Standalone/StartCommand.html +203 -0
  86. data/doc/rdoc/classes/PhusionPassenger/Standalone/StatusCommand.html +156 -0
  87. data/doc/rdoc/classes/PhusionPassenger/Standalone/StopCommand.html +168 -0
  88. data/doc/rdoc/classes/PhusionPassenger/Standalone/Utils.html +86 -0
  89. data/doc/rdoc/classes/PhusionPassenger/Standalone/VersionCommand.html +135 -0
  90. data/doc/rdoc/classes/PhusionPassenger/UnknownError.html +125 -0
  91. data/doc/rdoc/classes/PhusionPassenger/Utils.html +1468 -0
  92. data/doc/rdoc/classes/PhusionPassenger/Utils/FileSystemWatcher.html +204 -0
  93. data/doc/rdoc/classes/PhusionPassenger/Utils/FileSystemWatcher/DirInfo.html +171 -0
  94. data/doc/rdoc/classes/PhusionPassenger/Utils/FileSystemWatcher/FileInfo.html +140 -0
  95. data/doc/rdoc/classes/PhusionPassenger/Utils/HostsFileParser.html +260 -0
  96. data/doc/rdoc/classes/PhusionPassenger/Utils/PseudoIO.html +169 -0
  97. data/doc/rdoc/classes/PhusionPassenger/Utils/RewindableInput.html +265 -0
  98. data/doc/rdoc/classes/PhusionPassenger/Utils/RewindableInput/Tempfile.html +120 -0
  99. data/doc/rdoc/classes/PhusionPassenger/Utils/UnseekableSocket.html +561 -0
  100. data/doc/rdoc/classes/PhusionPassenger/VersionNotFound.html +140 -0
  101. data/doc/rdoc/classes/PhusionPassenger/WSGI.html +89 -0
  102. data/doc/rdoc/classes/PhusionPassenger/WSGI/ApplicationSpawner.html +182 -0
  103. data/doc/rdoc/classes/Process.html +115 -0
  104. data/doc/rdoc/classes/Signal.html +139 -0
  105. data/doc/rdoc/created.rid +1 -0
  106. data/doc/rdoc/files/DEVELOPERS_TXT.html +276 -0
  107. data/doc/rdoc/files/README.html +157 -0
  108. data/doc/rdoc/files/ext/phusion_passenger/native_support_c.html +92 -0
  109. data/doc/rdoc/files/lib/phusion_passenger/abstract_installer_rb.html +130 -0
  110. data/doc/rdoc/files/lib/phusion_passenger/abstract_request_handler_rb.html +135 -0
  111. data/doc/rdoc/files/lib/phusion_passenger/abstract_server_collection_rb.html +126 -0
  112. data/doc/rdoc/files/lib/phusion_passenger/abstract_server_rb.html +128 -0
  113. data/doc/rdoc/files/lib/phusion_passenger/admin_tools/memory_stats_rb.html +126 -0
  114. data/doc/rdoc/files/lib/phusion_passenger/admin_tools/server_instance_rb.html +132 -0
  115. data/doc/rdoc/files/lib/phusion_passenger/admin_tools_rb.html +122 -0
  116. data/doc/rdoc/files/lib/phusion_passenger/analytics_logger_rb.html +129 -0
  117. data/doc/rdoc/files/lib/phusion_passenger/app_process_rb.html +127 -0
  118. data/doc/rdoc/files/lib/phusion_passenger/classic_rails/application_spawner_rb.html +141 -0
  119. data/doc/rdoc/files/lib/phusion_passenger/classic_rails/cgi_fixed_rb.html +126 -0
  120. data/doc/rdoc/files/lib/phusion_passenger/classic_rails/framework_spawner_rb.html +146 -0
  121. data/doc/rdoc/files/lib/phusion_passenger/classic_rails/request_handler_rb.html +125 -0
  122. data/doc/rdoc/files/lib/phusion_passenger/classic_rails_extensions/init_rb.html +132 -0
  123. data/doc/rdoc/files/lib/phusion_passenger/console_text_template_rb.html +126 -0
  124. data/doc/rdoc/files/lib/phusion_passenger/constants_rb.html +122 -0
  125. data/doc/rdoc/files/lib/phusion_passenger/debug_logging_rb.html +122 -0
  126. data/doc/rdoc/files/lib/phusion_passenger/dependencies_rb.html +147 -0
  127. data/doc/rdoc/files/lib/phusion_passenger/exceptions_rb.html +122 -0
  128. data/doc/rdoc/files/lib/phusion_passenger/html_template_rb.html +127 -0
  129. data/doc/rdoc/files/lib/phusion_passenger/message_channel_rb.html +120 -0
  130. data/doc/rdoc/files/lib/phusion_passenger/message_client_rb.html +127 -0
  131. data/doc/rdoc/files/lib/phusion_passenger/native_support_rb.html +131 -0
  132. data/doc/rdoc/files/lib/phusion_passenger/packaging_rb.html +122 -0
  133. data/doc/rdoc/files/lib/phusion_passenger/platform_info/apache_rb.html +127 -0
  134. data/doc/rdoc/files/lib/phusion_passenger/platform_info/binary_compatibility_rb.html +129 -0
  135. data/doc/rdoc/files/lib/phusion_passenger/platform_info/compiler_rb.html +126 -0
  136. data/doc/rdoc/files/lib/phusion_passenger/platform_info/curl_rb.html +126 -0
  137. data/doc/rdoc/files/lib/phusion_passenger/platform_info/documentation_tools_rb.html +126 -0
  138. data/doc/rdoc/files/lib/phusion_passenger/platform_info/linux_rb.html +126 -0
  139. data/doc/rdoc/files/lib/phusion_passenger/platform_info/operating_system_rb.html +127 -0
  140. data/doc/rdoc/files/lib/phusion_passenger/platform_info/ruby_rb.html +128 -0
  141. data/doc/rdoc/files/lib/phusion_passenger/platform_info/zlib_rb.html +126 -0
  142. data/doc/rdoc/files/lib/phusion_passenger/platform_info_rb.html +122 -0
  143. data/doc/rdoc/files/lib/phusion_passenger/plugin_rb.html +127 -0
  144. data/doc/rdoc/files/lib/phusion_passenger/public_api_rb.html +127 -0
  145. data/doc/rdoc/files/lib/phusion_passenger/rack/application_spawner_rb.html +137 -0
  146. data/doc/rdoc/files/lib/phusion_passenger/rack/request_handler_rb.html +125 -0
  147. data/doc/rdoc/files/lib/phusion_passenger/rails3_extensions/init_rb.html +127 -0
  148. data/doc/rdoc/files/lib/phusion_passenger/simple_benchmarking_rb.html +122 -0
  149. data/doc/rdoc/files/lib/phusion_passenger/spawn_manager_rb.html +160 -0
  150. data/doc/rdoc/files/lib/phusion_passenger/standalone/app_finder_rb.html +127 -0
  151. data/doc/rdoc/files/lib/phusion_passenger/standalone/command_rb.html +135 -0
  152. data/doc/rdoc/files/lib/phusion_passenger/standalone/config_file_rb.html +126 -0
  153. data/doc/rdoc/files/lib/phusion_passenger/standalone/help_command_rb.html +126 -0
  154. data/doc/rdoc/files/lib/phusion_passenger/standalone/main_rb.html +126 -0
  155. data/doc/rdoc/files/lib/phusion_passenger/standalone/package_runtime_command_rb.html +127 -0
  156. data/doc/rdoc/files/lib/phusion_passenger/standalone/runtime_installer_rb.html +132 -0
  157. data/doc/rdoc/files/lib/phusion_passenger/standalone/start_command_rb.html +136 -0
  158. data/doc/rdoc/files/lib/phusion_passenger/standalone/status_command_rb.html +126 -0
  159. data/doc/rdoc/files/lib/phusion_passenger/standalone/stop_command_rb.html +126 -0
  160. data/doc/rdoc/files/lib/phusion_passenger/standalone/utils_rb.html +126 -0
  161. data/doc/rdoc/files/lib/phusion_passenger/standalone/version_command_rb.html +127 -0
  162. data/doc/rdoc/files/lib/phusion_passenger/utils/file_system_watcher_rb.html +126 -0
  163. data/doc/rdoc/files/lib/phusion_passenger/utils/hosts_file_parser_rb.html +120 -0
  164. data/doc/rdoc/files/lib/phusion_passenger/utils/rewindable_input_rb.html +100 -0
  165. data/doc/rdoc/files/lib/phusion_passenger/utils/tmpdir_rb.html +122 -0
  166. data/doc/rdoc/files/lib/phusion_passenger/utils/unseekable_socket_rb.html +126 -0
  167. data/doc/rdoc/files/lib/phusion_passenger/utils_rb.html +179 -0
  168. data/doc/rdoc/files/lib/phusion_passenger/wsgi/application_spawner_rb.html +132 -0
  169. data/doc/rdoc/fr_class_index.html +139 -0
  170. data/doc/rdoc/fr_file_index.html +109 -0
  171. data/doc/rdoc/fr_method_index.html +435 -0
  172. data/doc/rdoc/index.html +26 -0
  173. data/doc/rdoc/rdoc-style.css +187 -0
  174. data/ext/apache2/Configuration.hpp +1 -1
  175. data/ext/apache2/Hooks.cpp +24 -2
  176. data/ext/common/AgentsStarter.hpp +57 -20
  177. data/ext/common/Constants.h +1 -1
  178. data/ext/common/ResourceLocator.h +1 -1
  179. data/ext/common/Utils/MemZeroGuard.h +1 -1
  180. data/ext/phusion_passenger/native_support.c +1 -1
  181. data/lib/phusion_passenger.rb +2 -2
  182. data/lib/phusion_passenger/abstract_installer.rb +1 -1
  183. data/lib/phusion_passenger/platform_info/apache.rb +3 -0
  184. data/lib/phusion_passenger/platform_info/binary_compatibility.rb +3 -1
  185. data/lib/phusion_passenger/platform_info/compiler.rb +25 -2
  186. data/lib/phusion_passenger/platform_info/ruby.rb +88 -14
  187. data/lib/phusion_passenger/templates/standalone/config.erb +9 -16
  188. metadata +166 -5
  189. data/ext/common/Utils/foo.cpp +0 -10
@@ -0,0 +1,647 @@
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: PhusionPassenger::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 />PhusionPassenger::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/phusion_passenger/abstract_request_handler_rb.html">lib/phusion_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&#8216;s request dispatcher (i.e. either Rails&#8216;s
81
+ Dispatcher class or <a href="Rack.html">Rack</a>). The request
82
+ handler&#8216;s job is to process incoming HTTP requests using the
83
+ currently loaded Ruby on Rails application. HTTP requests are forwarded to
84
+ the request handler by the web server. HTTP responses generated by the RoR
85
+ application are forwarded to the web server, which, in turn, sends the
86
+ response back to the HTTP client.
87
+ </p>
88
+ <p>
89
+ <a href="AbstractRequestHandler.html">AbstractRequestHandler</a> is an
90
+ abstract base class for easing the implementation of request handlers for
91
+ Rails and <a href="Rack.html">Rack</a>.
92
+ </p>
93
+ <h2>Design decisions</h2>
94
+ <p>
95
+ Some design decisions are made because we want to decrease system
96
+ administrator maintenance overhead. These decisions are documented in this
97
+ section.
98
+ </p>
99
+ <h3>Owner pipes</h3>
100
+ <p>
101
+ Because only the web server communicates directly with a request handler,
102
+ we want the request handler to exit if the web server has also exited. This
103
+ is implemented by using a so-called _owner pipe_. The writable part of the
104
+ pipe will be passed to the web server* via a Unix socket, and the web
105
+ server will own that part of the pipe, while <a
106
+ href="AbstractRequestHandler.html">AbstractRequestHandler</a> owns the
107
+ readable part of the pipe. <a
108
+ href="AbstractRequestHandler.html">AbstractRequestHandler</a> will
109
+ continuously check whether the other side of the pipe has been closed. If
110
+ so, then it knows that the web server has exited, and so the request
111
+ handler will exit as well. This works even if the web server gets killed by
112
+ SIGKILL.
113
+ </p>
114
+ <ul>
115
+ <li>It might also be passed to the ApplicationPoolServerExecutable, if the web
116
+ server&#8216;s using ApplicationPoolServer instead of
117
+ StandardApplicationPool.
118
+
119
+ </li>
120
+ </ul>
121
+ <h2>Request format</h2>
122
+ <p>
123
+ Incoming &quot;HTTP requests&quot; are not true HTTP requests, i.e. their
124
+ binary representation do not conform to RFC 2616. Instead, the request
125
+ format is based on CGI, and is similar to that of SCGI.
126
+ </p>
127
+ <p>
128
+ The format consists of 3 parts:
129
+ </p>
130
+ <ul>
131
+ <li>A 32-bit big-endian integer, containing the size of the transformed
132
+ headers.
133
+
134
+ </li>
135
+ <li>The transformed HTTP headers.
136
+
137
+ </li>
138
+ <li>The verbatim (untransformed) HTTP request body.
139
+
140
+ </li>
141
+ </ul>
142
+ <p>
143
+ HTTP headers are transformed to a format that satisfies the following
144
+ grammar:
145
+ </p>
146
+ <pre>
147
+ headers ::= header*
148
+ header ::= name NUL value NUL
149
+ name ::= notnull+
150
+ value ::= notnull+
151
+ notnull ::= &quot;\x01&quot; | &quot;\x02&quot; | &quot;\x02&quot; | ... | &quot;\xFF&quot;
152
+ NUL = &quot;\x00&quot;
153
+ </pre>
154
+ <p>
155
+ The web server transforms the HTTP request to the aforementioned format,
156
+ and sends it to the request handler.
157
+ </p>
158
+ </div>
159
+
160
+
161
+
162
+ <div class="sectiontitle">Methods</div>
163
+ <ul>
164
+ <li><a href="#M000343">cleanup</a></li>
165
+ <li><a href="#M000345">main_loop</a></li>
166
+ <li><a href="#M000344">main_loop_running?</a></li>
167
+ <li><a href="#M000342">new</a></li>
168
+ <li><a href="#M000347">soft_shutdown</a></li>
169
+ <li><a href="#M000346">start_main_loop_thread</a></li>
170
+ </ul>
171
+
172
+ <div class="sectiontitle">Included Modules</div>
173
+ <ul>
174
+ <li><a href="DebugLogging.html">DebugLogging</a></li>
175
+ <li><a href="Utils.html">Utils</a></li>
176
+ </ul>
177
+
178
+
179
+
180
+ <div class="sectiontitle">Constants</div>
181
+ <table border='0' cellpadding='5'>
182
+ <tr valign='top'>
183
+ <td class="attr-name">HARD_TERMINATION_SIGNAL</td>
184
+ <td>=</td>
185
+ <td class="attr-value">&quot;SIGTERM&quot;</td>
186
+ </tr>
187
+ <tr valign='top'>
188
+ <td>&nbsp;</td>
189
+ <td colspan="2" class="attr-desc">
190
+ <a href="../Signal.html">Signal</a> which will cause the Rails application
191
+ to exit immediately.
192
+
193
+ </td>
194
+ </tr>
195
+ <tr valign='top'>
196
+ <td class="attr-name">SOFT_TERMINATION_SIGNAL</td>
197
+ <td>=</td>
198
+ <td class="attr-value">&quot;SIGUSR1&quot;</td>
199
+ </tr>
200
+ <tr valign='top'>
201
+ <td>&nbsp;</td>
202
+ <td colspan="2" class="attr-desc">
203
+ <a href="../Signal.html">Signal</a> which will cause the Rails application
204
+ to exit as soon as it&#8216;s done processing a request.
205
+
206
+ </td>
207
+ </tr>
208
+ <tr valign='top'>
209
+ <td class="attr-name">BACKLOG_SIZE</td>
210
+ <td>=</td>
211
+ <td class="attr-value">500</td>
212
+ </tr>
213
+ <tr valign='top'>
214
+ <td class="attr-name">MAX_HEADER_SIZE</td>
215
+ <td>=</td>
216
+ <td class="attr-value">128 * 1024</td>
217
+ </tr>
218
+ <tr valign='top'>
219
+ <td class="attr-name">OBJECT_SPACE_SUPPORTS_LIVE_OBJECTS</td>
220
+ <td>=</td>
221
+ <td class="attr-value">ObjectSpace.respond_to?(:live_objects)</td>
222
+ </tr>
223
+ <tr valign='top'>
224
+ <td class="attr-name">OBJECT_SPACE_SUPPORTS_ALLOCATED_OBJECTS</td>
225
+ <td>=</td>
226
+ <td class="attr-value">ObjectSpace.respond_to?(:allocated_objects)</td>
227
+ </tr>
228
+ <tr valign='top'>
229
+ <td class="attr-name">OBJECT_SPACE_SUPPORTS_COUNT_OBJECTS</td>
230
+ <td>=</td>
231
+ <td class="attr-value">ObjectSpace.respond_to?(:count_objects)</td>
232
+ </tr>
233
+ <tr valign='top'>
234
+ <td class="attr-name">GC_SUPPORTS_TIME</td>
235
+ <td>=</td>
236
+ <td class="attr-value">GC.respond_to?(:time)</td>
237
+ </tr>
238
+ <tr valign='top'>
239
+ <td class="attr-name">GC_SUPPORTS_CLEAR_STATS</td>
240
+ <td>=</td>
241
+ <td class="attr-value">GC.respond_to?(:clear_stats)</td>
242
+ </tr>
243
+ </table>
244
+
245
+ <div class="sectiontitle">Attributes</div>
246
+ <table border='0' cellpadding='5'>
247
+ <tr valign='top'>
248
+ <td class='attr-rw'>
249
+ [RW]
250
+ </td>
251
+ <td class='attr-name'>connect_password</td>
252
+ <td class='attr-desc'>
253
+ A password with which clients must authenticate. Default is
254
+ unauthenticated.
255
+
256
+ </td>
257
+ </tr>
258
+ <tr valign='top'>
259
+ <td class='attr-rw'>
260
+ [R]
261
+ </td>
262
+ <td class='attr-name'>iterations</td>
263
+ <td class='attr-desc'>
264
+ The number of times the main loop has iterated so far. Mostly useful for
265
+ unit test assertions.
266
+
267
+ </td>
268
+ </tr>
269
+ <tr valign='top'>
270
+ <td class='attr-rw'>
271
+ [RW]
272
+ </td>
273
+ <td class='attr-name'>memory_limit</td>
274
+ <td class='attr-desc'>
275
+ Specifies the maximum allowed memory usage, in MB. If after having
276
+ processed a request <a
277
+ href="AbstractRequestHandler.html">AbstractRequestHandler</a> detects that
278
+ memory usage has risen above this limit, then it will gracefully exit (that
279
+ is, exit after having processed all pending requests).
280
+
281
+ <p>
282
+ A value of 0 (the default) indicates that there&#8216;s no limit.
283
+ </p>
284
+ </td>
285
+ </tr>
286
+ <tr valign='top'>
287
+ <td class='attr-rw'>
288
+ [R]
289
+ </td>
290
+ <td class='attr-name'>processed_requests</td>
291
+ <td class='attr-desc'>
292
+ Number of requests processed so far. This includes requests that raised
293
+ exceptions.
294
+
295
+ </td>
296
+ </tr>
297
+ <tr valign='top'>
298
+ <td class='attr-rw'>
299
+ [R]
300
+ </td>
301
+ <td class='attr-name'>server_sockets</td>
302
+ <td class='attr-desc'>
303
+ A hash containing all server sockets that this request handler listens on.
304
+ The hash is in the form of:
305
+
306
+ <pre>
307
+ {
308
+ name1 =&gt; [socket_address1, socket_type1, socket1],
309
+ name2 =&gt; [socket_address2, socket_type2, socket2],
310
+ ...
311
+ }
312
+ </pre>
313
+ <p>
314
+ <tt>name</tt> is a Symbol. <tt>socket_addressx</tt> is the address of the
315
+ socket, <tt>socket_typex</tt> is the socket&#8216;s type (either
316
+ &#8216;unix&#8217; or &#8216;tcp&#8217;) and <tt>socketx</tt> is the actual
317
+ socket <a href="../IO.html">IO</a> objec. There&#8216;s guaranteed to be at
318
+ least one server socket, namely one with the name +:main+.
319
+ </p>
320
+ </td>
321
+ </tr>
322
+ <tr valign='top'>
323
+ <td class='attr-rw'>
324
+ [RW]
325
+ </td>
326
+ <td class='attr-name'>soft_termination_linger_time</td>
327
+ <td class='attr-desc'>
328
+ If a soft termination signal was received, then the main loop will quit the
329
+ given amount of seconds after the last time a connection was accepted.
330
+ Defaults to 3 seconds.
331
+
332
+ </td>
333
+ </tr>
334
+ </table>
335
+
336
+ <div class="sectiontitle">Public Class methods</div>
337
+ <div class="method">
338
+ <div class="title">
339
+ <a name="M000342"></a><b>new</b>(owner_pipe, options = {})
340
+ </div>
341
+ <div class="description">
342
+ <p>
343
+ Create a <a href="AbstractRequestHandler.html#M000342">new</a>
344
+ RequestHandler with the given owner pipe. <tt>owner_pipe</tt> must be the
345
+ readable part of a pipe <a href="../IO.html">IO</a> object.
346
+ </p>
347
+ <p>
348
+ Additionally, the following options may be given:
349
+ </p>
350
+ <ul>
351
+ <li>memory_limit: Used to set the <tt>memory_limit</tt> attribute.
352
+
353
+ </li>
354
+ <li>detach_key
355
+
356
+ </li>
357
+ <li>connect_password
358
+
359
+ </li>
360
+ <li>pool_account_username
361
+
362
+ </li>
363
+ <li>pool_account_password_base64
364
+
365
+ </li>
366
+ </ul>
367
+ </div>
368
+ <div class="sourcecode">
369
+ <p class="source-link">[ <a href="javascript:toggleSource('M000342_source')" id="l_M000342_source">show source</a> ]</p>
370
+ <div id="M000342_source" class="dyn-source">
371
+ <pre>
372
+ <span class="ruby-comment cmt"># File lib/phusion_passenger/abstract_request_handler.rb, line 170</span>
373
+ 170: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-identifier">owner_pipe</span>, <span class="ruby-identifier">options</span> = {})
374
+ 171: <span class="ruby-ivar">@server_sockets</span> = {}
375
+ 172:
376
+ 173: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">should_use_unix_sockets?</span>
377
+ 174: <span class="ruby-ivar">@main_socket_address</span>, <span class="ruby-ivar">@main_socket</span> = <span class="ruby-identifier">create_unix_socket_on_filesystem</span>
378
+ 175: <span class="ruby-ivar">@server_sockets</span>[<span class="ruby-identifier">:main</span>] = [<span class="ruby-ivar">@main_socket_address</span>, <span class="ruby-value str">'unix'</span>, <span class="ruby-ivar">@main_socket</span>]
379
+ 176: <span class="ruby-keyword kw">else</span>
380
+ 177: <span class="ruby-ivar">@main_socket_address</span>, <span class="ruby-ivar">@main_socket</span> = <span class="ruby-identifier">create_tcp_socket</span>
381
+ 178: <span class="ruby-ivar">@server_sockets</span>[<span class="ruby-identifier">:main</span>] = [<span class="ruby-ivar">@main_socket_address</span>, <span class="ruby-value str">'tcp'</span>, <span class="ruby-ivar">@main_socket</span>]
382
+ 179: <span class="ruby-keyword kw">end</span>
383
+ 180:
384
+ 181: <span class="ruby-ivar">@http_socket_address</span>, <span class="ruby-ivar">@http_socket</span> = <span class="ruby-identifier">create_tcp_socket</span>
385
+ 182: <span class="ruby-ivar">@server_sockets</span>[<span class="ruby-identifier">:http</span>] = [<span class="ruby-ivar">@http_socket_address</span>, <span class="ruby-value str">'tcp'</span>, <span class="ruby-ivar">@http_socket</span>]
386
+ 183:
387
+ 184: <span class="ruby-ivar">@owner_pipe</span> = <span class="ruby-identifier">owner_pipe</span>
388
+ 185: <span class="ruby-ivar">@options</span> = <span class="ruby-identifier">options</span>
389
+ 186: <span class="ruby-ivar">@previous_signal_handlers</span> = {}
390
+ 187: <span class="ruby-ivar">@main_loop_generation</span> = <span class="ruby-value">0</span>
391
+ 188: <span class="ruby-ivar">@main_loop_thread_lock</span> = <span class="ruby-constant">Mutex</span>.<span class="ruby-identifier">new</span>
392
+ 189: <span class="ruby-ivar">@main_loop_thread_cond</span> = <span class="ruby-constant">ConditionVariable</span>.<span class="ruby-identifier">new</span>
393
+ 190: <span class="ruby-ivar">@memory_limit</span> = <span class="ruby-identifier">options</span>[<span class="ruby-value str">&quot;memory_limit&quot;</span>] <span class="ruby-operator">||</span> <span class="ruby-value">0</span>
394
+ 191: <span class="ruby-ivar">@connect_password</span> = <span class="ruby-identifier">options</span>[<span class="ruby-value str">&quot;connect_password&quot;</span>]
395
+ 192: <span class="ruby-ivar">@detach_key</span> = <span class="ruby-identifier">options</span>[<span class="ruby-value str">&quot;detach_key&quot;</span>]
396
+ 193: <span class="ruby-ivar">@pool_account_username</span> = <span class="ruby-identifier">options</span>[<span class="ruby-value str">&quot;pool_account_username&quot;</span>]
397
+ 194: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">options</span>[<span class="ruby-value str">&quot;pool_account_password_base64&quot;</span>]
398
+ 195: <span class="ruby-ivar">@pool_account_password</span> = <span class="ruby-identifier">options</span>[<span class="ruby-value str">&quot;pool_account_password_base64&quot;</span>].<span class="ruby-identifier">unpack</span>(<span class="ruby-value str">'m'</span>).<span class="ruby-identifier">first</span>
399
+ 196: <span class="ruby-keyword kw">end</span>
400
+ 197: <span class="ruby-ivar">@analytics_logger</span> = <span class="ruby-identifier">options</span>[<span class="ruby-value str">&quot;analytics_logger&quot;</span>]
401
+ 198: <span class="ruby-ivar">@iterations</span> = <span class="ruby-value">0</span>
402
+ 199: <span class="ruby-ivar">@processed_requests</span> = <span class="ruby-value">0</span>
403
+ 200: <span class="ruby-ivar">@soft_termination_linger_time</span> = <span class="ruby-value">3</span>
404
+ 201: <span class="ruby-ivar">@main_loop_running</span> = <span class="ruby-keyword kw">false</span>
405
+ 202: <span class="ruby-ivar">@passenger_header</span> = <span class="ruby-identifier">determine_passenger_header</span>
406
+ 203:
407
+ 204: <span class="ruby-ivar">@debugger</span> = <span class="ruby-ivar">@options</span>[<span class="ruby-value str">&quot;debugger&quot;</span>]
408
+ 205: <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@debugger</span>
409
+ 206: <span class="ruby-ivar">@server_sockets</span>[<span class="ruby-identifier">:ruby_debug_cmd</span>] = [<span class="ruby-node">&quot;127.0.0.1:#{Debugger.cmd_port}&quot;</span>, <span class="ruby-value str">'tcp'</span>]
410
+ 207: <span class="ruby-ivar">@server_sockets</span>[<span class="ruby-identifier">:ruby_debug_ctrl</span>] = [<span class="ruby-node">&quot;127.0.0.1:#{Debugger.ctrl_port}&quot;</span>, <span class="ruby-value str">'tcp'</span>]
411
+ 208: <span class="ruby-keyword kw">end</span>
412
+ 209:
413
+ 210: <span class="ruby-comment cmt">#############</span>
414
+ 211: <span class="ruby-keyword kw">end</span>
415
+ </pre>
416
+ </div>
417
+ </div>
418
+ </div>
419
+ <div class="sectiontitle">Public Instance methods</div>
420
+ <div class="method">
421
+ <div class="title">
422
+ <a name="M000343"></a><b>cleanup</b>()
423
+ </div>
424
+ <div class="description">
425
+ <p>
426
+ Clean up temporary stuff created by the request handler.
427
+ </p>
428
+ <p>
429
+ If the main loop was started by <a
430
+ href="AbstractRequestHandler.html#M000345">#main_loop</a>, then this method
431
+ may only be called after the main loop has exited.
432
+ </p>
433
+ <p>
434
+ If the main loop was started by <a
435
+ href="AbstractRequestHandler.html#M000346">#start_main_loop_thread</a>,
436
+ then this method may be called at any time, and it will stop the main loop
437
+ thread.
438
+ </p>
439
+ </div>
440
+ <div class="sourcecode">
441
+ <p class="source-link">[ <a href="javascript:toggleSource('M000343_source')" id="l_M000343_source">show source</a> ]</p>
442
+ <div id="M000343_source" class="dyn-source">
443
+ <pre>
444
+ <span class="ruby-comment cmt"># File lib/phusion_passenger/abstract_request_handler.rb, line 220</span>
445
+ 220: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">cleanup</span>
446
+ 221: <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@main_loop_thread</span>
447
+ 222: <span class="ruby-ivar">@main_loop_thread_lock</span>.<span class="ruby-identifier">synchronize</span> <span class="ruby-keyword kw">do</span>
448
+ 223: <span class="ruby-ivar">@graceful_termination_pipe</span>[<span class="ruby-value">1</span>].<span class="ruby-identifier">close</span> <span class="ruby-keyword kw">rescue</span> <span class="ruby-keyword kw">nil</span>
449
+ 224: <span class="ruby-keyword kw">end</span>
450
+ 225: <span class="ruby-ivar">@main_loop_thread</span>.<span class="ruby-identifier">join</span>
451
+ 226: <span class="ruby-keyword kw">end</span>
452
+ 227: <span class="ruby-ivar">@server_sockets</span>.<span class="ruby-identifier">each_value</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">value</span><span class="ruby-operator">|</span>
453
+ 228: <span class="ruby-identifier">address</span>, <span class="ruby-identifier">type</span>, <span class="ruby-identifier">socket</span> = <span class="ruby-identifier">value</span>
454
+ 229: <span class="ruby-identifier">socket</span>.<span class="ruby-identifier">close</span> <span class="ruby-keyword kw">rescue</span> <span class="ruby-keyword kw">nil</span>
455
+ 230: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">type</span> <span class="ruby-operator">==</span> <span class="ruby-value str">'unix'</span>
456
+ 231: <span class="ruby-constant">File</span>.<span class="ruby-identifier">unlink</span>(<span class="ruby-identifier">address</span>) <span class="ruby-keyword kw">rescue</span> <span class="ruby-keyword kw">nil</span>
457
+ 232: <span class="ruby-keyword kw">end</span>
458
+ 233: <span class="ruby-keyword kw">end</span>
459
+ 234: <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>
460
+ 235: <span class="ruby-keyword kw">end</span>
461
+ </pre>
462
+ </div>
463
+ </div>
464
+ </div>
465
+ <div class="method">
466
+ <div class="title">
467
+ <a name="M000345"></a><b>main_loop</b>()
468
+ </div>
469
+ <div class="description">
470
+ <p>
471
+ Enter the request handler&#8216;s main loop.
472
+ </p>
473
+ </div>
474
+ <div class="sourcecode">
475
+ <p class="source-link">[ <a href="javascript:toggleSource('M000345_source')" id="l_M000345_source">show source</a> ]</p>
476
+ <div id="M000345_source" class="dyn-source">
477
+ <pre>
478
+ <span class="ruby-comment cmt"># File lib/phusion_passenger/abstract_request_handler.rb, line 243</span>
479
+ 243: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">main_loop</span>
480
+ 244: <span class="ruby-identifier">debug</span>(<span class="ruby-value str">&quot;Entering request handler main loop&quot;</span>)
481
+ 245: <span class="ruby-identifier">reset_signal_handlers</span>
482
+ 246: <span class="ruby-keyword kw">begin</span>
483
+ 247: <span class="ruby-ivar">@graceful_termination_pipe</span> = <span class="ruby-constant">IO</span>.<span class="ruby-identifier">pipe</span>
484
+ 248: <span class="ruby-ivar">@graceful_termination_pipe</span>[<span class="ruby-value">0</span>].<span class="ruby-identifier">close_on_exec!</span>
485
+ 249: <span class="ruby-ivar">@graceful_termination_pipe</span>[<span class="ruby-value">1</span>].<span class="ruby-identifier">close_on_exec!</span>
486
+ 250:
487
+ 251: <span class="ruby-ivar">@main_loop_thread_lock</span>.<span class="ruby-identifier">synchronize</span> <span class="ruby-keyword kw">do</span>
488
+ 252: <span class="ruby-ivar">@main_loop_generation</span> <span class="ruby-operator">+=</span> <span class="ruby-value">1</span>
489
+ 253: <span class="ruby-ivar">@main_loop_running</span> = <span class="ruby-keyword kw">true</span>
490
+ 254: <span class="ruby-ivar">@main_loop_thread_cond</span>.<span class="ruby-identifier">broadcast</span>
491
+ 255:
492
+ 256: <span class="ruby-ivar">@select_timeout</span> = <span class="ruby-keyword kw">nil</span>
493
+ 257:
494
+ 258: <span class="ruby-ivar">@selectable_sockets</span> = []
495
+ 259: <span class="ruby-ivar">@server_sockets</span>.<span class="ruby-identifier">each_value</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">value</span><span class="ruby-operator">|</span>
496
+ 260: <span class="ruby-identifier">socket</span> = <span class="ruby-identifier">value</span>[<span class="ruby-value">2</span>]
497
+ 261: <span class="ruby-ivar">@selectable_sockets</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">socket</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">socket</span>
498
+ 262: <span class="ruby-keyword kw">end</span>
499
+ 263: <span class="ruby-ivar">@selectable_sockets</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-ivar">@owner_pipe</span>
500
+ 264: <span class="ruby-ivar">@selectable_sockets</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-ivar">@graceful_termination_pipe</span>[<span class="ruby-value">0</span>]
501
+ 265: <span class="ruby-keyword kw">end</span>
502
+ 266:
503
+ 267: <span class="ruby-identifier">install_useful_signal_handlers</span>
504
+ 268: <span class="ruby-identifier">socket_wrapper</span> = <span class="ruby-constant">Utils</span><span class="ruby-operator">::</span><span class="ruby-constant">UnseekableSocket</span>.<span class="ruby-identifier">new</span>
505
+ 269: <span class="ruby-identifier">channel</span> = <span class="ruby-constant">MessageChannel</span>.<span class="ruby-identifier">new</span>
506
+ 270: <span class="ruby-identifier">buffer</span> = <span class="ruby-value str">''</span>
507
+ 271:
508
+ 272: <span class="ruby-keyword kw">while</span> <span class="ruby-keyword kw">true</span>
509
+ 273: <span class="ruby-ivar">@iterations</span> <span class="ruby-operator">+=</span> <span class="ruby-value">1</span>
510
+ 274: <span class="ruby-keyword kw">if</span> <span class="ruby-operator">!</span><span class="ruby-identifier">accept_and_process_next_request</span>(<span class="ruby-identifier">socket_wrapper</span>, <span class="ruby-identifier">channel</span>, <span class="ruby-identifier">buffer</span>)
511
+ 275: <span class="ruby-identifier">trace</span>(<span class="ruby-value">2</span>, <span class="ruby-value str">&quot;Request handler main loop exited normally&quot;</span>)
512
+ 276: <span class="ruby-keyword kw">break</span>
513
+ 277: <span class="ruby-keyword kw">end</span>
514
+ 278: <span class="ruby-ivar">@processed_requests</span> <span class="ruby-operator">+=</span> <span class="ruby-value">1</span>
515
+ 279: <span class="ruby-keyword kw">end</span>
516
+ 280: <span class="ruby-keyword kw">rescue</span> <span class="ruby-constant">EOFError</span>
517
+ 281: <span class="ruby-comment cmt"># Exit main loop.</span>
518
+ 282: <span class="ruby-identifier">trace</span>(<span class="ruby-value">2</span>, <span class="ruby-value str">&quot;Request handler main loop interrupted by EOFError exception&quot;</span>)
519
+ 283: <span class="ruby-keyword kw">rescue</span> <span class="ruby-constant">Interrupt</span>
520
+ 284: <span class="ruby-comment cmt"># Exit main loop.</span>
521
+ 285: <span class="ruby-identifier">trace</span>(<span class="ruby-value">2</span>, <span class="ruby-value str">&quot;Request handler main loop interrupted by Interrupt exception&quot;</span>)
522
+ 286: <span class="ruby-keyword kw">rescue</span> <span class="ruby-constant">SignalException</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">signal</span>
523
+ 287: <span class="ruby-identifier">trace</span>(<span class="ruby-value">2</span>, <span class="ruby-value str">&quot;Request handler main loop interrupted by SignalException&quot;</span>)
524
+ 288: <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">&amp;&amp;</span>
525
+ 289: <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>
526
+ 290: <span class="ruby-identifier">raise</span>
527
+ 291: <span class="ruby-keyword kw">end</span>
528
+ 292: <span class="ruby-keyword kw">rescue</span> <span class="ruby-constant">Exception</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">e</span>
529
+ 293: <span class="ruby-identifier">trace</span>(<span class="ruby-value">2</span>, <span class="ruby-node">&quot;Request handler main loop interrupted by #{e.class} exception&quot;</span>)
530
+ 294: <span class="ruby-identifier">raise</span>
531
+ 295: <span class="ruby-keyword kw">ensure</span>
532
+ 296: <span class="ruby-identifier">debug</span>(<span class="ruby-value str">&quot;Exiting request handler main loop&quot;</span>)
533
+ 297: <span class="ruby-identifier">revert_signal_handlers</span>
534
+ 298: <span class="ruby-ivar">@main_loop_thread_lock</span>.<span class="ruby-identifier">synchronize</span> <span class="ruby-keyword kw">do</span>
535
+ 299: <span class="ruby-ivar">@graceful_termination_pipe</span>[<span class="ruby-value">1</span>].<span class="ruby-identifier">close</span> <span class="ruby-keyword kw">rescue</span> <span class="ruby-keyword kw">nil</span>
536
+ 300: <span class="ruby-ivar">@graceful_termination_pipe</span>[<span class="ruby-value">0</span>].<span class="ruby-identifier">close</span> <span class="ruby-keyword kw">rescue</span> <span class="ruby-keyword kw">nil</span>
537
+ 301: <span class="ruby-ivar">@selectable_sockets</span> = []
538
+ 302: <span class="ruby-ivar">@main_loop_generation</span> <span class="ruby-operator">+=</span> <span class="ruby-value">1</span>
539
+ 303: <span class="ruby-ivar">@main_loop_running</span> = <span class="ruby-keyword kw">false</span>
540
+ 304: <span class="ruby-ivar">@main_loop_thread_cond</span>.<span class="ruby-identifier">broadcast</span>
541
+ 305: <span class="ruby-keyword kw">end</span>
542
+ 306: <span class="ruby-keyword kw">end</span>
543
+ 307: <span class="ruby-keyword kw">end</span>
544
+ </pre>
545
+ </div>
546
+ </div>
547
+ </div>
548
+ <div class="method">
549
+ <div class="title">
550
+ <a name="M000344"></a><b>main_loop_running?</b>()
551
+ </div>
552
+ <div class="description">
553
+ <p>
554
+ Check whether the main loop&#8216;s currently running.
555
+ </p>
556
+ </div>
557
+ <div class="sourcecode">
558
+ <p class="source-link">[ <a href="javascript:toggleSource('M000344_source')" id="l_M000344_source">show source</a> ]</p>
559
+ <div id="M000344_source" class="dyn-source">
560
+ <pre>
561
+ <span class="ruby-comment cmt"># File lib/phusion_passenger/abstract_request_handler.rb, line 238</span>
562
+ 238: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">main_loop_running?</span>
563
+ 239: <span class="ruby-keyword kw">return</span> <span class="ruby-ivar">@main_loop_running</span>
564
+ 240: <span class="ruby-keyword kw">end</span>
565
+ </pre>
566
+ </div>
567
+ </div>
568
+ </div>
569
+ <div class="method">
570
+ <div class="title">
571
+ <a name="M000347"></a><b>soft_shutdown</b>()
572
+ </div>
573
+ <div class="description">
574
+ <p>
575
+ Remove this request handler from the application pool so that no <a
576
+ href="AbstractRequestHandler.html#M000342">new</a> connections will come
577
+ in. Then make the main loop quit a few seconds after the last time a
578
+ connection came in. This all is to ensure that no connections come in while
579
+ we&#8216;re shutting down.
580
+ </p>
581
+ <p>
582
+ May only be called while the main loop is running. May be called from any
583
+ thread.
584
+ </p>
585
+ </div>
586
+ <div class="sourcecode">
587
+ <p class="source-link">[ <a href="javascript:toggleSource('M000347_source')" id="l_M000347_source">show source</a> ]</p>
588
+ <div id="M000347_source" class="dyn-source">
589
+ <pre>
590
+ <span class="ruby-comment cmt"># File lib/phusion_passenger/abstract_request_handler.rb, line 333</span>
591
+ 333: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">soft_shutdown</span>
592
+ 334: <span class="ruby-ivar">@select_timeout</span> = <span class="ruby-ivar">@soft_termination_linger_time</span>
593
+ 335: <span class="ruby-ivar">@graceful_termination_pipe</span>[<span class="ruby-value">1</span>].<span class="ruby-identifier">close</span> <span class="ruby-keyword kw">rescue</span> <span class="ruby-keyword kw">nil</span>
594
+ 336: <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@detach_key</span> <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-ivar">@pool_account_username</span> <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-ivar">@pool_account_password</span>
595
+ 337: <span class="ruby-identifier">client</span> = <span class="ruby-constant">MessageClient</span>.<span class="ruby-identifier">new</span>(<span class="ruby-ivar">@pool_account_username</span>, <span class="ruby-ivar">@pool_account_password</span>)
596
+ 338: <span class="ruby-keyword kw">begin</span>
597
+ 339: <span class="ruby-identifier">client</span>.<span class="ruby-identifier">detach</span>(<span class="ruby-ivar">@detach_key</span>)
598
+ 340: <span class="ruby-keyword kw">ensure</span>
599
+ 341: <span class="ruby-identifier">client</span>.<span class="ruby-identifier">close</span>
600
+ 342: <span class="ruby-keyword kw">end</span>
601
+ 343: <span class="ruby-keyword kw">end</span>
602
+ 344: <span class="ruby-keyword kw">end</span>
603
+ </pre>
604
+ </div>
605
+ </div>
606
+ </div>
607
+ <div class="method">
608
+ <div class="title">
609
+ <a name="M000346"></a><b>start_main_loop_thread</b>()
610
+ </div>
611
+ <div class="description">
612
+ <p>
613
+ Start the main loop in a <a
614
+ href="AbstractRequestHandler.html#M000342">new</a> thread. This thread will
615
+ be stopped by <a href="AbstractRequestHandler.html#M000343">#cleanup</a>.
616
+ </p>
617
+ </div>
618
+ <div class="sourcecode">
619
+ <p class="source-link">[ <a href="javascript:toggleSource('M000346_source')" id="l_M000346_source">show source</a> ]</p>
620
+ <div id="M000346_source" class="dyn-source">
621
+ <pre>
622
+ <span class="ruby-comment cmt"># File lib/phusion_passenger/abstract_request_handler.rb, line 310</span>
623
+ 310: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">start_main_loop_thread</span>
624
+ 311: <span class="ruby-identifier">current_generation</span> = <span class="ruby-ivar">@main_loop_generation</span>
625
+ 312: <span class="ruby-ivar">@main_loop_thread</span> = <span class="ruby-constant">Thread</span>.<span class="ruby-identifier">new</span> <span class="ruby-keyword kw">do</span>
626
+ 313: <span class="ruby-keyword kw">begin</span>
627
+ 314: <span class="ruby-identifier">main_loop</span>
628
+ 315: <span class="ruby-keyword kw">rescue</span> <span class="ruby-constant">Exception</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">e</span>
629
+ 316: <span class="ruby-identifier">print_exception</span>(<span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">class</span>, <span class="ruby-identifier">e</span>)
630
+ 317: <span class="ruby-keyword kw">end</span>
631
+ 318: <span class="ruby-keyword kw">end</span>
632
+ 319: <span class="ruby-ivar">@main_loop_thread_lock</span>.<span class="ruby-identifier">synchronize</span> <span class="ruby-keyword kw">do</span>
633
+ 320: <span class="ruby-keyword kw">while</span> <span class="ruby-ivar">@main_loop_generation</span> <span class="ruby-operator">==</span> <span class="ruby-identifier">current_generation</span>
634
+ 321: <span class="ruby-ivar">@main_loop_thread_cond</span>.<span class="ruby-identifier">wait</span>(<span class="ruby-ivar">@main_loop_thread_lock</span>)
635
+ 322: <span class="ruby-keyword kw">end</span>
636
+ 323: <span class="ruby-keyword kw">end</span>
637
+ 324: <span class="ruby-keyword kw">end</span>
638
+ </pre>
639
+ </div>
640
+ </div>
641
+ </div>
642
+ </div>
643
+
644
+ </div>
645
+
646
+ </body>
647
+ </html>