passenger 3.0.5 → 3.0.6

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 (198) hide show
  1. data/NEWS +19 -1
  2. data/build/packaging.rb +0 -1
  3. data/doc/cxxapi/Constants_8h_source.html +1 -1
  4. data/doc/cxxapi/Logging_8h_source.html +3 -3
  5. data/doc/cxxapi/MessageChannel_8h_source.html +2 -2
  6. data/doc/cxxapi/Utils_8h_source.html +407 -397
  7. data/doc/cxxapi/namespacePassenger.html +32 -0
  8. data/doc/cxxapi/namespacemembers.html +56 -1
  9. data/doc/cxxapi/namespacemembers_func.html +3 -0
  10. data/doc/cxxapi/ngx__http__passenger__module_8h_source.html +5 -5
  11. data/ext/apache2/Hooks.cpp +1 -1
  12. data/ext/common/AgentBase.cpp +86 -11
  13. data/ext/common/Constants.h +1 -1
  14. data/ext/common/Logging.h +3 -3
  15. data/ext/common/LoggingAgent/FilterSupport.h +1 -0
  16. data/ext/common/LoggingAgent/Main.cpp +8 -1
  17. data/ext/common/MessageChannel.h +2 -2
  18. data/ext/common/Utils.cpp +27 -3
  19. data/ext/common/Utils.h +10 -0
  20. data/ext/common/Watchdog.cpp +27 -1
  21. data/ext/nginx/HelperAgent.cpp +8 -8
  22. data/ext/oxt/thread.hpp +2 -2
  23. data/lib/phusion_passenger.rb +1 -1
  24. data/lib/phusion_passenger/abstract_installer.rb +6 -0
  25. data/lib/phusion_passenger/abstract_request_handler.rb +13 -2
  26. data/lib/phusion_passenger/analytics_logger.rb +15 -4
  27. data/lib/phusion_passenger/dependencies.rb +11 -26
  28. data/lib/phusion_passenger/platform_info.rb +96 -5
  29. data/lib/phusion_passenger/platform_info/apache.rb +13 -3
  30. data/lib/phusion_passenger/platform_info/compiler.rb +5 -0
  31. data/lib/phusion_passenger/rack/application_spawner.rb +3 -2
  32. data/lib/phusion_passenger/standalone/runtime_installer.rb +0 -1
  33. data/lib/phusion_passenger/standalone/start_command.rb +15 -8
  34. data/lib/phusion_passenger/templates/standalone/config.erb +1 -0
  35. metadata +5 -182
  36. data/doc/rdoc/classes/ConditionVariable.html +0 -215
  37. data/doc/rdoc/classes/Exception.html +0 -120
  38. data/doc/rdoc/classes/GC.html +0 -113
  39. data/doc/rdoc/classes/IO.html +0 -221
  40. data/doc/rdoc/classes/PhusionPassenger.html +0 -397
  41. data/doc/rdoc/classes/PhusionPassenger/AbstractInstaller.html +0 -180
  42. data/doc/rdoc/classes/PhusionPassenger/AbstractRequestHandler.html +0 -647
  43. data/doc/rdoc/classes/PhusionPassenger/AbstractServer.html +0 -654
  44. data/doc/rdoc/classes/PhusionPassenger/AbstractServer/InvalidPassword.html +0 -92
  45. data/doc/rdoc/classes/PhusionPassenger/AbstractServer/ServerAlreadyStarted.html +0 -97
  46. data/doc/rdoc/classes/PhusionPassenger/AbstractServer/ServerError.html +0 -96
  47. data/doc/rdoc/classes/PhusionPassenger/AbstractServer/ServerNotStarted.html +0 -97
  48. data/doc/rdoc/classes/PhusionPassenger/AbstractServer/UnknownMessage.html +0 -96
  49. data/doc/rdoc/classes/PhusionPassenger/AbstractServerCollection.html +0 -619
  50. data/doc/rdoc/classes/PhusionPassenger/AdminTools.html +0 -142
  51. data/doc/rdoc/classes/PhusionPassenger/AdminTools/MemoryStats.html +0 -368
  52. data/doc/rdoc/classes/PhusionPassenger/AdminTools/MemoryStats/Process.html +0 -231
  53. data/doc/rdoc/classes/PhusionPassenger/AdminTools/ServerInstance.html +0 -588
  54. data/doc/rdoc/classes/PhusionPassenger/AdminTools/ServerInstance/CorruptedDirectoryError.html +0 -92
  55. data/doc/rdoc/classes/PhusionPassenger/AdminTools/ServerInstance/GenerationsAbsentError.html +0 -92
  56. data/doc/rdoc/classes/PhusionPassenger/AdminTools/ServerInstance/Group.html +0 -147
  57. data/doc/rdoc/classes/PhusionPassenger/AdminTools/ServerInstance/Process.html +0 -279
  58. data/doc/rdoc/classes/PhusionPassenger/AdminTools/ServerInstance/RoleDeniedError.html +0 -92
  59. data/doc/rdoc/classes/PhusionPassenger/AdminTools/ServerInstance/StaleDirectoryError.html +0 -92
  60. data/doc/rdoc/classes/PhusionPassenger/AdminTools/ServerInstance/Stats.html +0 -123
  61. data/doc/rdoc/classes/PhusionPassenger/AdminTools/ServerInstance/UnsupportedGenerationStructureVersionError.html +0 -92
  62. data/doc/rdoc/classes/PhusionPassenger/AnalyticsLogger.html +0 -368
  63. data/doc/rdoc/classes/PhusionPassenger/AnalyticsLogger/Lock.html +0 -194
  64. data/doc/rdoc/classes/PhusionPassenger/AnalyticsLogger/Log.html +0 -299
  65. data/doc/rdoc/classes/PhusionPassenger/AnalyticsLogger/SharedData.html +0 -206
  66. data/doc/rdoc/classes/PhusionPassenger/AppInitError.html +0 -155
  67. data/doc/rdoc/classes/PhusionPassenger/AppProcess.html +0 -367
  68. data/doc/rdoc/classes/PhusionPassenger/ClassicRails.html +0 -95
  69. data/doc/rdoc/classes/PhusionPassenger/ClassicRails/ApplicationSpawner.html +0 -351
  70. data/doc/rdoc/classes/PhusionPassenger/ClassicRails/ApplicationSpawner/Error.html +0 -98
  71. data/doc/rdoc/classes/PhusionPassenger/ClassicRails/CGIFixed.html +0 -200
  72. data/doc/rdoc/classes/PhusionPassenger/ClassicRails/FrameworkSpawner.html +0 -410
  73. data/doc/rdoc/classes/PhusionPassenger/ClassicRails/FrameworkSpawner/Error.html +0 -98
  74. data/doc/rdoc/classes/PhusionPassenger/ClassicRails/RequestHandler.html +0 -156
  75. data/doc/rdoc/classes/PhusionPassenger/ClassicRailsExtensions.html +0 -115
  76. data/doc/rdoc/classes/PhusionPassenger/ClassicRailsExtensions/AnalyticsLogging.html +0 -202
  77. data/doc/rdoc/classes/PhusionPassenger/ConsoleTextTemplate.html +0 -172
  78. data/doc/rdoc/classes/PhusionPassenger/DebugLogging.html +0 -273
  79. data/doc/rdoc/classes/PhusionPassenger/FrameworkInitError.html +0 -145
  80. data/doc/rdoc/classes/PhusionPassenger/HTMLTemplate.html +0 -162
  81. data/doc/rdoc/classes/PhusionPassenger/InitializationError.html +0 -141
  82. data/doc/rdoc/classes/PhusionPassenger/InvalidPath.html +0 -92
  83. data/doc/rdoc/classes/PhusionPassenger/MessageChannel.html +0 -673
  84. data/doc/rdoc/classes/PhusionPassenger/MessageChannel/InvalidHashError.html +0 -92
  85. data/doc/rdoc/classes/PhusionPassenger/MessageClient.html +0 -415
  86. data/doc/rdoc/classes/PhusionPassenger/NativeSupportLoader.html +0 -134
  87. data/doc/rdoc/classes/PhusionPassenger/Packaging.html +0 -129
  88. data/doc/rdoc/classes/PhusionPassenger/PlatformInfo.html +0 -1972
  89. data/doc/rdoc/classes/PhusionPassenger/Plugin.html +0 -237
  90. data/doc/rdoc/classes/PhusionPassenger/Rack.html +0 -91
  91. data/doc/rdoc/classes/PhusionPassenger/Rack/ApplicationSpawner.html +0 -312
  92. data/doc/rdoc/classes/PhusionPassenger/Rack/ApplicationSpawner/Error.html +0 -98
  93. data/doc/rdoc/classes/PhusionPassenger/Rack/RequestHandler.html +0 -218
  94. data/doc/rdoc/classes/PhusionPassenger/Rails3Extensions.html +0 -114
  95. data/doc/rdoc/classes/PhusionPassenger/Rails3Extensions/AnalyticsLogging.html +0 -259
  96. data/doc/rdoc/classes/PhusionPassenger/Rails3Extensions/AnalyticsLogging/ACExtension.html +0 -139
  97. data/doc/rdoc/classes/PhusionPassenger/Rails3Extensions/AnalyticsLogging/ASBenchmarkableExtension.html +0 -118
  98. data/doc/rdoc/classes/PhusionPassenger/Rails3Extensions/AnalyticsLogging/ExceptionLogger.html +0 -135
  99. data/doc/rdoc/classes/PhusionPassenger/SpawnManager.html +0 -378
  100. data/doc/rdoc/classes/PhusionPassenger/Standalone.html +0 -111
  101. data/doc/rdoc/classes/PhusionPassenger/Standalone/AppFinder.html +0 -252
  102. data/doc/rdoc/classes/PhusionPassenger/Standalone/Command.html +0 -161
  103. data/doc/rdoc/classes/PhusionPassenger/Standalone/ConfigFile.html +0 -368
  104. data/doc/rdoc/classes/PhusionPassenger/Standalone/ConfigFile/DisallowedContextError.html +0 -132
  105. data/doc/rdoc/classes/PhusionPassenger/Standalone/HelpCommand.html +0 -151
  106. data/doc/rdoc/classes/PhusionPassenger/Standalone/Main.html +0 -189
  107. data/doc/rdoc/classes/PhusionPassenger/Standalone/PackageRuntimeCommand.html +0 -177
  108. data/doc/rdoc/classes/PhusionPassenger/Standalone/RuntimeInstaller.html +0 -341
  109. data/doc/rdoc/classes/PhusionPassenger/Standalone/StartCommand.html +0 -203
  110. data/doc/rdoc/classes/PhusionPassenger/Standalone/StatusCommand.html +0 -156
  111. data/doc/rdoc/classes/PhusionPassenger/Standalone/StopCommand.html +0 -168
  112. data/doc/rdoc/classes/PhusionPassenger/Standalone/Utils.html +0 -86
  113. data/doc/rdoc/classes/PhusionPassenger/Standalone/VersionCommand.html +0 -135
  114. data/doc/rdoc/classes/PhusionPassenger/UnknownError.html +0 -125
  115. data/doc/rdoc/classes/PhusionPassenger/Utils.html +0 -1543
  116. data/doc/rdoc/classes/PhusionPassenger/Utils/FileSystemWatcher.html +0 -204
  117. data/doc/rdoc/classes/PhusionPassenger/Utils/FileSystemWatcher/DirInfo.html +0 -171
  118. data/doc/rdoc/classes/PhusionPassenger/Utils/FileSystemWatcher/FileInfo.html +0 -140
  119. data/doc/rdoc/classes/PhusionPassenger/Utils/HostsFileParser.html +0 -260
  120. data/doc/rdoc/classes/PhusionPassenger/Utils/PseudoIO.html +0 -194
  121. data/doc/rdoc/classes/PhusionPassenger/Utils/RewindableInput.html +0 -265
  122. data/doc/rdoc/classes/PhusionPassenger/Utils/RewindableInput/Tempfile.html +0 -120
  123. data/doc/rdoc/classes/PhusionPassenger/Utils/UnseekableSocket.html +0 -561
  124. data/doc/rdoc/classes/PhusionPassenger/VersionNotFound.html +0 -140
  125. data/doc/rdoc/classes/PhusionPassenger/WSGI.html +0 -89
  126. data/doc/rdoc/classes/PhusionPassenger/WSGI/ApplicationSpawner.html +0 -182
  127. data/doc/rdoc/classes/Process.html +0 -115
  128. data/doc/rdoc/classes/Signal.html +0 -139
  129. data/doc/rdoc/created.rid +0 -1
  130. data/doc/rdoc/files/DEVELOPERS_TXT.html +0 -280
  131. data/doc/rdoc/files/README.html +0 -157
  132. data/doc/rdoc/files/lib/phusion_passenger/abstract_installer_rb.html +0 -130
  133. data/doc/rdoc/files/lib/phusion_passenger/abstract_request_handler_rb.html +0 -135
  134. data/doc/rdoc/files/lib/phusion_passenger/abstract_server_collection_rb.html +0 -126
  135. data/doc/rdoc/files/lib/phusion_passenger/abstract_server_rb.html +0 -128
  136. data/doc/rdoc/files/lib/phusion_passenger/admin_tools/memory_stats_rb.html +0 -126
  137. data/doc/rdoc/files/lib/phusion_passenger/admin_tools/server_instance_rb.html +0 -132
  138. data/doc/rdoc/files/lib/phusion_passenger/admin_tools_rb.html +0 -122
  139. data/doc/rdoc/files/lib/phusion_passenger/analytics_logger_rb.html +0 -129
  140. data/doc/rdoc/files/lib/phusion_passenger/app_process_rb.html +0 -127
  141. data/doc/rdoc/files/lib/phusion_passenger/classic_rails/application_spawner_rb.html +0 -141
  142. data/doc/rdoc/files/lib/phusion_passenger/classic_rails/cgi_fixed_rb.html +0 -126
  143. data/doc/rdoc/files/lib/phusion_passenger/classic_rails/framework_spawner_rb.html +0 -146
  144. data/doc/rdoc/files/lib/phusion_passenger/classic_rails/request_handler_rb.html +0 -125
  145. data/doc/rdoc/files/lib/phusion_passenger/classic_rails_extensions/init_rb.html +0 -132
  146. data/doc/rdoc/files/lib/phusion_passenger/console_text_template_rb.html +0 -126
  147. data/doc/rdoc/files/lib/phusion_passenger/constants_rb.html +0 -122
  148. data/doc/rdoc/files/lib/phusion_passenger/debug_logging_rb.html +0 -122
  149. data/doc/rdoc/files/lib/phusion_passenger/dependencies_rb.html +0 -147
  150. data/doc/rdoc/files/lib/phusion_passenger/exceptions_rb.html +0 -122
  151. data/doc/rdoc/files/lib/phusion_passenger/html_template_rb.html +0 -127
  152. data/doc/rdoc/files/lib/phusion_passenger/message_channel_rb.html +0 -120
  153. data/doc/rdoc/files/lib/phusion_passenger/message_client_rb.html +0 -127
  154. data/doc/rdoc/files/lib/phusion_passenger/native_support_rb.html +0 -132
  155. data/doc/rdoc/files/lib/phusion_passenger/packaging_rb.html +0 -122
  156. data/doc/rdoc/files/lib/phusion_passenger/platform_info/apache_rb.html +0 -127
  157. data/doc/rdoc/files/lib/phusion_passenger/platform_info/binary_compatibility_rb.html +0 -129
  158. data/doc/rdoc/files/lib/phusion_passenger/platform_info/compiler_rb.html +0 -127
  159. data/doc/rdoc/files/lib/phusion_passenger/platform_info/curl_rb.html +0 -126
  160. data/doc/rdoc/files/lib/phusion_passenger/platform_info/documentation_tools_rb.html +0 -126
  161. data/doc/rdoc/files/lib/phusion_passenger/platform_info/linux_rb.html +0 -126
  162. data/doc/rdoc/files/lib/phusion_passenger/platform_info/operating_system_rb.html +0 -127
  163. data/doc/rdoc/files/lib/phusion_passenger/platform_info/ruby_rb.html +0 -128
  164. data/doc/rdoc/files/lib/phusion_passenger/platform_info/zlib_rb.html +0 -126
  165. data/doc/rdoc/files/lib/phusion_passenger/platform_info_rb.html +0 -122
  166. data/doc/rdoc/files/lib/phusion_passenger/plugin_rb.html +0 -127
  167. data/doc/rdoc/files/lib/phusion_passenger/public_api_rb.html +0 -127
  168. data/doc/rdoc/files/lib/phusion_passenger/rack/application_spawner_rb.html +0 -137
  169. data/doc/rdoc/files/lib/phusion_passenger/rack/request_handler_rb.html +0 -125
  170. data/doc/rdoc/files/lib/phusion_passenger/rails3_extensions/init_rb.html +0 -127
  171. data/doc/rdoc/files/lib/phusion_passenger/simple_benchmarking_rb.html +0 -122
  172. data/doc/rdoc/files/lib/phusion_passenger/spawn_manager_rb.html +0 -160
  173. data/doc/rdoc/files/lib/phusion_passenger/standalone/app_finder_rb.html +0 -127
  174. data/doc/rdoc/files/lib/phusion_passenger/standalone/command_rb.html +0 -136
  175. data/doc/rdoc/files/lib/phusion_passenger/standalone/config_file_rb.html +0 -126
  176. data/doc/rdoc/files/lib/phusion_passenger/standalone/help_command_rb.html +0 -126
  177. data/doc/rdoc/files/lib/phusion_passenger/standalone/main_rb.html +0 -126
  178. data/doc/rdoc/files/lib/phusion_passenger/standalone/package_runtime_command_rb.html +0 -127
  179. data/doc/rdoc/files/lib/phusion_passenger/standalone/runtime_installer_rb.html +0 -133
  180. data/doc/rdoc/files/lib/phusion_passenger/standalone/start_command_rb.html +0 -136
  181. data/doc/rdoc/files/lib/phusion_passenger/standalone/status_command_rb.html +0 -126
  182. data/doc/rdoc/files/lib/phusion_passenger/standalone/stop_command_rb.html +0 -126
  183. data/doc/rdoc/files/lib/phusion_passenger/standalone/utils_rb.html +0 -126
  184. data/doc/rdoc/files/lib/phusion_passenger/standalone/version_command_rb.html +0 -127
  185. data/doc/rdoc/files/lib/phusion_passenger/utils/file_system_watcher_rb.html +0 -126
  186. data/doc/rdoc/files/lib/phusion_passenger/utils/hosts_file_parser_rb.html +0 -120
  187. data/doc/rdoc/files/lib/phusion_passenger/utils/rewindable_input_rb.html +0 -100
  188. data/doc/rdoc/files/lib/phusion_passenger/utils/tmpdir_rb.html +0 -122
  189. data/doc/rdoc/files/lib/phusion_passenger/utils/unseekable_socket_rb.html +0 -126
  190. data/doc/rdoc/files/lib/phusion_passenger/utils_rb.html +0 -179
  191. data/doc/rdoc/files/lib/phusion_passenger/wsgi/application_spawner_rb.html +0 -132
  192. data/doc/rdoc/fr_class_index.html +0 -139
  193. data/doc/rdoc/fr_file_index.html +0 -108
  194. data/doc/rdoc/fr_method_index.html +0 -439
  195. data/doc/rdoc/index.html +0 -26
  196. data/doc/rdoc/rdoc-style.css +0 -187
  197. data/ext/common/libboost_oxt/aggregate.cpp +0 -10
  198. data/ext/common/libpassenger_common/aggregate.cpp +0 -16
@@ -1,647 +0,0 @@
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="#M000347">cleanup</a></li>
165
- <li><a href="#M000349">main_loop</a></li>
166
- <li><a href="#M000348">main_loop_running?</a></li>
167
- <li><a href="#M000346">new</a></li>
168
- <li><a href="#M000351">soft_shutdown</a></li>
169
- <li><a href="#M000350">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="M000346"></a><b>new</b>(owner_pipe, options = {})
340
- </div>
341
- <div class="description">
342
- <p>
343
- Create a <a href="AbstractRequestHandler.html#M000346">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('M000346_source')" id="l_M000346_source">show source</a> ]</p>
370
- <div id="M000346_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="M000347"></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#M000349">#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#M000350">#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('M000347_source')" id="l_M000347_source">show source</a> ]</p>
442
- <div id="M000347_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="M000349"></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('M000349_source')" id="l_M000349_source">show source</a> ]</p>
476
- <div id="M000349_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="M000348"></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('M000348_source')" id="l_M000348_source">show source</a> ]</p>
559
- <div id="M000348_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="M000351"></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#M000346">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('M000351_source')" id="l_M000351_source">show source</a> ]</p>
588
- <div id="M000351_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="M000350"></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#M000346">new</a> thread. This thread will
615
- be stopped by <a href="AbstractRequestHandler.html#M000347">#cleanup</a>.
616
- </p>
617
- </div>
618
- <div class="sourcecode">
619
- <p class="source-link">[ <a href="javascript:toggleSource('M000350_source')" id="l_M000350_source">show source</a> ]</p>
620
- <div id="M000350_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>