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,162 +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::HTMLTemplate</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::HTMLTemplate</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/html_template_rb.html">lib/phusion_passenger/html_template.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
- A convenience utility class for rendering our error pages.
80
- </p>
81
- </div>
82
-
83
-
84
-
85
- <div class="sectiontitle">Methods</div>
86
- <ul>
87
- <li><a href="#M000331">[]=</a></li>
88
- <li><a href="#M000330">new</a></li>
89
- <li><a href="#M000332">result</a></li>
90
- </ul>
91
-
92
- <div class="sectiontitle">Included Modules</div>
93
- <ul>
94
- <li>ERB::Util</li>
95
- </ul>
96
-
97
-
98
-
99
-
100
-
101
- <div class="sectiontitle">Public Class methods</div>
102
- <div class="method">
103
- <div class="title">
104
- <a name="M000330"></a><b>new</b>(template_name, options = {})
105
- </div>
106
- <div class="sourcecode">
107
- <p class="source-link">[ <a href="javascript:toggleSource('M000330_source')" id="l_M000330_source">show source</a> ]</p>
108
- <div id="M000330_source" class="dyn-source">
109
- <pre>
110
- <span class="ruby-comment cmt"># File lib/phusion_passenger/html_template.rb, line 31</span>
111
- 31: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-identifier">template_name</span>, <span class="ruby-identifier">options</span> = {})
112
- 32: <span class="ruby-ivar">@buffer</span> = <span class="ruby-value str">''</span>
113
- 33: <span class="ruby-ivar">@template</span> = <span class="ruby-constant">ERB</span>.<span class="ruby-identifier">new</span>(<span class="ruby-constant">File</span>.<span class="ruby-identifier">read</span>(<span class="ruby-node">&quot;#{TEMPLATES_DIR}/#{template_name}.html.erb&quot;</span>),
114
- 34: <span class="ruby-keyword kw">nil</span>, <span class="ruby-keyword kw">nil</span>, <span class="ruby-value str">'@buffer'</span>)
115
- 35: <span class="ruby-identifier">options</span>.<span class="ruby-identifier">each_pair</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">name</span>, <span class="ruby-identifier">value</span><span class="ruby-operator">|</span>
116
- 36: <span class="ruby-keyword kw">self</span>[<span class="ruby-identifier">name</span>] = <span class="ruby-identifier">value</span>
117
- 37: <span class="ruby-keyword kw">end</span>
118
- 38: <span class="ruby-keyword kw">end</span>
119
- </pre>
120
- </div>
121
- </div>
122
- </div>
123
- <div class="sectiontitle">Public Instance methods</div>
124
- <div class="method">
125
- <div class="title">
126
- <a name="M000331"></a><b>[]=</b>(name, value)
127
- </div>
128
- <div class="sourcecode">
129
- <p class="source-link">[ <a href="javascript:toggleSource('M000331_source')" id="l_M000331_source">show source</a> ]</p>
130
- <div id="M000331_source" class="dyn-source">
131
- <pre>
132
- <span class="ruby-comment cmt"># File lib/phusion_passenger/html_template.rb, line 40</span>
133
- 40: <span class="ruby-keyword kw">def</span> <span class="ruby-operator">[]=</span>(<span class="ruby-identifier">name</span>, <span class="ruby-identifier">value</span>)
134
- 41: <span class="ruby-identifier">instance_variable_set</span>(<span class="ruby-node">&quot;@#{name}&quot;</span>.<span class="ruby-identifier">to_sym</span>, <span class="ruby-identifier">value</span>)
135
- 42: <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">self</span>
136
- 43: <span class="ruby-keyword kw">end</span>
137
- </pre>
138
- </div>
139
- </div>
140
- </div>
141
- <div class="method">
142
- <div class="title">
143
- <a name="M000332"></a><b>result</b>()
144
- </div>
145
- <div class="sourcecode">
146
- <p class="source-link">[ <a href="javascript:toggleSource('M000332_source')" id="l_M000332_source">show source</a> ]</p>
147
- <div id="M000332_source" class="dyn-source">
148
- <pre>
149
- <span class="ruby-comment cmt"># File lib/phusion_passenger/html_template.rb, line 45</span>
150
- 45: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">result</span>
151
- 46: <span class="ruby-keyword kw">return</span> <span class="ruby-ivar">@template</span>.<span class="ruby-identifier">result</span>(<span class="ruby-identifier">binding</span>)
152
- 47: <span class="ruby-keyword kw">end</span>
153
- </pre>
154
- </div>
155
- </div>
156
- </div>
157
- </div>
158
-
159
- </div>
160
-
161
- </body>
162
- </html>
@@ -1,141 +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::InitializationError</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::InitializationError</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/exceptions_rb.html">lib/phusion_passenger/exceptions.rb</a>
61
- </td>
62
- </tr>
63
- <tr>
64
- <td>Parent:</td>
65
- <td>
66
- StandardError
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
- An abstract base class for <a href="AppInitError.html">AppInitError</a> and
80
- <a href="FrameworkInitError.html">FrameworkInitError</a>. This represents
81
- the failure when initializing something.
82
- </p>
83
- </div>
84
-
85
-
86
-
87
- <div class="sectiontitle">Methods</div>
88
- <ul>
89
- <li><a href="#M000390">new</a></li>
90
- </ul>
91
-
92
-
93
-
94
-
95
-
96
- <div class="sectiontitle">Attributes</div>
97
- <table border='0' cellpadding='5'>
98
- <tr valign='top'>
99
- <td class='attr-rw'>
100
- [RW]
101
- </td>
102
- <td class='attr-name'>child_exception</td>
103
- <td class='attr-desc'>
104
- The exception that caused initialization to fail. This may be nil.
105
-
106
- </td>
107
- </tr>
108
- </table>
109
-
110
- <div class="sectiontitle">Public Class methods</div>
111
- <div class="method">
112
- <div class="title">
113
- <a name="M000390"></a><b>new</b>(message, child_exception = nil)
114
- </div>
115
- <div class="description">
116
- <p>
117
- Create a <a href="InitializationError.html#M000390">new</a> <a
118
- href="InitializationError.html">InitializationError</a>. <tt>message</tt>
119
- is the error message, and <tt>child_exception</tt> is the exception that
120
- caused initialization to fail.
121
- </p>
122
- </div>
123
- <div class="sourcecode">
124
- <p class="source-link">[ <a href="javascript:toggleSource('M000390_source')" id="l_M000390_source">show source</a> ]</p>
125
- <div id="M000390_source" class="dyn-source">
126
- <pre>
127
- <span class="ruby-comment cmt"># File lib/phusion_passenger/exceptions.rb, line 48</span>
128
- 48: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-identifier">message</span>, <span class="ruby-identifier">child_exception</span> = <span class="ruby-keyword kw">nil</span>)
129
- 49: <span class="ruby-keyword kw">super</span>(<span class="ruby-identifier">message</span>)
130
- 50: <span class="ruby-ivar">@child_exception</span> = <span class="ruby-identifier">child_exception</span>
131
- 51: <span class="ruby-keyword kw">end</span>
132
- </pre>
133
- </div>
134
- </div>
135
- </div>
136
- </div>
137
-
138
- </div>
139
-
140
- </body>
141
- </html>
@@ -1,92 +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::InvalidPath</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::InvalidPath</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/exceptions_rb.html">lib/phusion_passenger/exceptions.rb</a>
61
- </td>
62
- </tr>
63
- <tr>
64
- <td>Parent:</td>
65
- <td>
66
- StandardError
67
- </td>
68
- </tr>
69
- </table>
70
- </td>
71
- </tr>
72
- </table>
73
- <!-- banner header -->
74
-
75
- <div id="bodyContent">
76
- <div id="content">
77
-
78
-
79
-
80
-
81
-
82
-
83
-
84
-
85
-
86
-
87
- </div>
88
-
89
- </div>
90
-
91
- </body>
92
- </html>
@@ -1,673 +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::MessageChannel</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::MessageChannel</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/message_channel_rb.html">lib/phusion_passenger/message_channel.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
- This class provides convenience methods for:
80
- </p>
81
- <ul>
82
- <li>sending and receiving raw data over an <a href="../IO.html">IO</a> channel.
83
-
84
- </li>
85
- <li>sending and receiving messages over an <a href="../IO.html">IO</a> channel.
86
-
87
- </li>
88
- <li>file descriptor (<a href="../IO.html">IO</a> object) passing over a Unix
89
- socket.
90
-
91
- </li>
92
- </ul>
93
- <p>
94
- All of these methods use exceptions for error reporting.
95
- </p>
96
- <p>
97
- There are two kinds of messages:
98
- </p>
99
- <dl>
100
- <dt> Array messages </dt><dd>These are just a list of strings, and the message itself has a specific
101
- length. The contained strings may not contain NUL characters
102
- (<tt>&#8217;\0&#8216;</tt>). Note that an array message must have at least
103
- one element.
104
-
105
- </dd>
106
- <dt> Scalar messages </dt><dd>These are byte strings which may contain arbitrary binary data. Scalar
107
- messages also have a specific length.
108
-
109
- </dd>
110
- </dl>
111
- <p>
112
- The protocol is designed to be low overhead, easy to implement and easy to
113
- parse.
114
- </p>
115
- <p>
116
- <a href="MessageChannel.html">MessageChannel</a> is to be wrapped around an
117
- <a href="../IO.html">IO</a> object. For example:
118
- </p>
119
- <pre>
120
- a, b = IO.pipe
121
- channel1 = MessageChannel.new(a)
122
- channel2 = MessageChannel.new(b)
123
-
124
- # Send an array message.
125
- channel2.write(&quot;hello&quot;, &quot;world !!&quot;)
126
- channel1.read # =&gt; [&quot;hello&quot;, &quot;world !!&quot;]
127
-
128
- # Send a scalar message.
129
- channel2.write_scalar(&quot;some long string which can contain arbitrary binary data&quot;)
130
- channel1.read_scalar
131
- </pre>
132
- <p>
133
- The life time of a <a href="MessageChannel.html">MessageChannel</a> is
134
- independent from that of the wrapped <a href="../IO.html">IO</a> object. If
135
- a <a href="MessageChannel.html">MessageChannel</a> object is destroyed, the
136
- underlying <a href="../IO.html">IO</a> object is not automatically closed.
137
- Call <a href="MessageChannel.html#M000367">close</a>() if you want to <a
138
- href="MessageChannel.html#M000367">close</a> the underlying <a
139
- href="../IO.html">IO</a> object.
140
- </p>
141
- <p>
142
- Note: Be careful with mixing the sending/receiving of array messages,
143
- scalar messages and <a href="../IO.html">IO</a> objects. If you send a
144
- collection of any of these in a specific order, then the receiving side
145
- must receive them in the exact some order. So suppose you first send a
146
- message, then an <a href="../IO.html">IO</a> object, then a scalar, then
147
- the receiving side must first receive a message, then an <a
148
- href="../IO.html">IO</a> object, then a scalar. If the receiving side does
149
- things in the wrong order then bad things will happen.
150
- </p>
151
- </div>
152
-
153
-
154
-
155
- <div class="sectiontitle">Methods</div>
156
- <ul>
157
- <li><a href="#M000367">close</a></li>
158
- <li><a href="#M000368">closed?</a></li>
159
- <li><a href="#M000366">fileno</a></li>
160
- <li><a href="#M000358">new</a></li>
161
- <li><a href="#M000359">read</a></li>
162
- <li><a href="#M000360">read_hash</a></li>
163
- <li><a href="#M000361">read_scalar</a></li>
164
- <li><a href="#M000364">recv_io</a></li>
165
- <li><a href="#M000365">send_io</a></li>
166
- <li><a href="#M000362">write</a></li>
167
- <li><a href="#M000363">write_scalar</a></li>
168
- </ul>
169
-
170
-
171
-
172
- <div class="sectiontitle">Classes and Modules</div>
173
- Class <a href="MessageChannel/InvalidHashError.html" class="link">PhusionPassenger::MessageChannel::InvalidHashError</a><br />
174
-
175
-
176
-
177
- <div class="sectiontitle">Attributes</div>
178
- <table border='0' cellpadding='5'>
179
- <tr valign='top'>
180
- <td class='attr-rw'>
181
- [RW]
182
- </td>
183
- <td class='attr-name'>io</td>
184
- <td class='attr-desc'>
185
- The wrapped <a href="../IO.html">IO</a> object.
186
-
187
- </td>
188
- </tr>
189
- </table>
190
-
191
- <div class="sectiontitle">Public Class methods</div>
192
- <div class="method">
193
- <div class="title">
194
- <a name="M000358"></a><b>new</b>(io = nil)
195
- </div>
196
- <div class="description">
197
- <p>
198
- Create a <a href="MessageChannel.html#M000358">new</a> <a
199
- href="MessageChannel.html">MessageChannel</a> by wrapping the given <a
200
- href="../IO.html">IO</a> object.
201
- </p>
202
- </div>
203
- <div class="sourcecode">
204
- <p class="source-link">[ <a href="javascript:toggleSource('M000358_source')" id="l_M000358_source">show source</a> ]</p>
205
- <div id="M000358_source" class="dyn-source">
206
- <pre>
207
- <span class="ruby-comment cmt"># File lib/phusion_passenger/message_channel.rb, line 88</span>
208
- 88: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-identifier">io</span> = <span class="ruby-keyword kw">nil</span>)
209
- 89: <span class="ruby-ivar">@io</span> = <span class="ruby-identifier">io</span>
210
- 90: <span class="ruby-comment cmt"># Make it binary just in case.</span>
211
- 91: <span class="ruby-ivar">@io</span>.<span class="ruby-identifier">binmode</span> <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@io</span>
212
- 92: <span class="ruby-keyword kw">end</span>
213
- </pre>
214
- </div>
215
- </div>
216
- </div>
217
- <div class="sectiontitle">Public Instance methods</div>
218
- <div class="method">
219
- <div class="title">
220
- <a name="M000367"></a><b>close</b>()
221
- </div>
222
- <div class="description">
223
- <p>
224
- Close the underlying <a href="../IO.html">IO</a> stream. Might raise
225
- SystemCallError or IOError when something goes wrong.
226
- </p>
227
- </div>
228
- <div class="sourcecode">
229
- <p class="source-link">[ <a href="javascript:toggleSource('M000367_source')" id="l_M000367_source">show source</a> ]</p>
230
- <div id="M000367_source" class="dyn-source">
231
- <pre>
232
- <span class="ruby-comment cmt"># File lib/phusion_passenger/message_channel.rb, line 360</span>
233
- 360: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">close</span>
234
- 361: <span class="ruby-ivar">@io</span>.<span class="ruby-identifier">close</span>
235
- 362: <span class="ruby-keyword kw">end</span>
236
- </pre>
237
- </div>
238
- </div>
239
- </div>
240
- <div class="method">
241
- <div class="title">
242
- <a name="M000368"></a><b>closed?</b>()
243
- </div>
244
- <div class="description">
245
- <p>
246
- Checks whether the underlying <a href="../IO.html">IO</a> stream is closed.
247
- </p>
248
- </div>
249
- <div class="sourcecode">
250
- <p class="source-link">[ <a href="javascript:toggleSource('M000368_source')" id="l_M000368_source">show source</a> ]</p>
251
- <div id="M000368_source" class="dyn-source">
252
- <pre>
253
- <span class="ruby-comment cmt"># File lib/phusion_passenger/message_channel.rb, line 365</span>
254
- 365: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">closed?</span>
255
- 366: <span class="ruby-keyword kw">return</span> <span class="ruby-ivar">@io</span>.<span class="ruby-identifier">closed?</span>
256
- 367: <span class="ruby-keyword kw">end</span>
257
- </pre>
258
- </div>
259
- </div>
260
- </div>
261
- <div class="method">
262
- <div class="title">
263
- <a name="M000366"></a><b>fileno</b>()
264
- </div>
265
- <div class="description">
266
- <p>
267
- Return the file descriptor of the underlying <a href="../IO.html">IO</a>
268
- object.
269
- </p>
270
- </div>
271
- <div class="sourcecode">
272
- <p class="source-link">[ <a href="javascript:toggleSource('M000366_source')" id="l_M000366_source">show source</a> ]</p>
273
- <div id="M000366_source" class="dyn-source">
274
- <pre>
275
- <span class="ruby-comment cmt"># File lib/phusion_passenger/message_channel.rb, line 354</span>
276
- 354: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">fileno</span>
277
- 355: <span class="ruby-keyword kw">return</span> <span class="ruby-ivar">@io</span>.<span class="ruby-identifier">fileno</span>
278
- 356: <span class="ruby-keyword kw">end</span>
279
- </pre>
280
- </div>
281
- </div>
282
- </div>
283
- <div class="method">
284
- <div class="title">
285
- <a name="M000359"></a><b>read</b>()
286
- </div>
287
- <div class="description">
288
- <p>
289
- Read an array message from the underlying file descriptor. Returns the
290
- array message as an array, or nil when end-of-stream has been reached.
291
- </p>
292
- <p>
293
- Might raise SystemCallError, IOError or SocketError when something goes
294
- wrong.
295
- </p>
296
- </div>
297
- <div class="sourcecode">
298
- <p class="source-link">[ <a href="javascript:toggleSource('M000359_source')" id="l_M000359_source">show source</a> ]</p>
299
- <div id="M000359_source" class="dyn-source">
300
- <pre>
301
- <span class="ruby-comment cmt"># File lib/phusion_passenger/message_channel.rb, line 100</span>
302
- 100: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">read</span>
303
- 101: <span class="ruby-identifier">buffer</span> = <span class="ruby-identifier">new_buffer</span>
304
- 102: <span class="ruby-keyword kw">if</span> <span class="ruby-operator">!</span><span class="ruby-ivar">@io</span>.<span class="ruby-identifier">read</span>(<span class="ruby-constant">HEADER_SIZE</span>, <span class="ruby-identifier">buffer</span>)
305
- 103: <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">nil</span>
306
- 104: <span class="ruby-keyword kw">end</span>
307
- 105: <span class="ruby-keyword kw">while</span> <span class="ruby-identifier">buffer</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator">&lt;</span> <span class="ruby-constant">HEADER_SIZE</span>
308
- 106: <span class="ruby-identifier">tmp</span> = <span class="ruby-ivar">@io</span>.<span class="ruby-identifier">read</span>(<span class="ruby-constant">HEADER_SIZE</span> <span class="ruby-operator">-</span> <span class="ruby-identifier">buffer</span>.<span class="ruby-identifier">size</span>)
309
- 107: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">tmp</span>.<span class="ruby-identifier">empty?</span>
310
- 108: <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">nil</span>
311
- 109: <span class="ruby-keyword kw">else</span>
312
- 110: <span class="ruby-identifier">buffer</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">tmp</span>
313
- 111: <span class="ruby-keyword kw">end</span>
314
- 112: <span class="ruby-keyword kw">end</span>
315
- 113:
316
- 114: <span class="ruby-identifier">chunk_size</span> = <span class="ruby-identifier">buffer</span>.<span class="ruby-identifier">unpack</span>(<span class="ruby-constant">UINT16_PACK_FORMAT</span>)[<span class="ruby-value">0</span>]
317
- 115: <span class="ruby-keyword kw">if</span> <span class="ruby-operator">!</span><span class="ruby-ivar">@io</span>.<span class="ruby-identifier">read</span>(<span class="ruby-identifier">chunk_size</span>, <span class="ruby-identifier">buffer</span>)
318
- 116: <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">nil</span>
319
- 117: <span class="ruby-keyword kw">end</span>
320
- 118: <span class="ruby-keyword kw">while</span> <span class="ruby-identifier">buffer</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator">&lt;</span> <span class="ruby-identifier">chunk_size</span>
321
- 119: <span class="ruby-identifier">tmp</span> = <span class="ruby-ivar">@io</span>.<span class="ruby-identifier">read</span>(<span class="ruby-identifier">chunk_size</span> <span class="ruby-operator">-</span> <span class="ruby-identifier">buffer</span>.<span class="ruby-identifier">size</span>)
322
- 120: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">tmp</span>.<span class="ruby-identifier">empty?</span>
323
- 121: <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">nil</span>
324
- 122: <span class="ruby-keyword kw">else</span>
325
- 123: <span class="ruby-identifier">buffer</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">tmp</span>
326
- 124: <span class="ruby-keyword kw">end</span>
327
- 125: <span class="ruby-keyword kw">end</span>
328
- 126:
329
- 127: <span class="ruby-identifier">message</span> = []
330
- 128: <span class="ruby-identifier">offset</span> = <span class="ruby-value">0</span>
331
- 129: <span class="ruby-identifier">delimiter_pos</span> = <span class="ruby-identifier">buffer</span>.<span class="ruby-identifier">index</span>(<span class="ruby-constant">DELIMITER</span>, <span class="ruby-identifier">offset</span>)
332
- 130: <span class="ruby-keyword kw">while</span> <span class="ruby-operator">!</span><span class="ruby-identifier">delimiter_pos</span>.<span class="ruby-identifier">nil?</span>
333
- 131: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">delimiter_pos</span> <span class="ruby-operator">==</span> <span class="ruby-value">0</span>
334
- 132: <span class="ruby-identifier">message</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-value str">&quot;&quot;</span>
335
- 133: <span class="ruby-keyword kw">else</span>
336
- 134: <span class="ruby-identifier">message</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">buffer</span>[<span class="ruby-identifier">offset</span> <span class="ruby-operator">..</span> <span class="ruby-identifier">delimiter_pos</span> <span class="ruby-operator">-</span> <span class="ruby-value">1</span>]
337
- 135: <span class="ruby-keyword kw">end</span>
338
- 136: <span class="ruby-identifier">offset</span> = <span class="ruby-identifier">delimiter_pos</span> <span class="ruby-operator">+</span> <span class="ruby-value">1</span>
339
- 137: <span class="ruby-identifier">delimiter_pos</span> = <span class="ruby-identifier">buffer</span>.<span class="ruby-identifier">index</span>(<span class="ruby-constant">DELIMITER</span>, <span class="ruby-identifier">offset</span>)
340
- 138: <span class="ruby-keyword kw">end</span>
341
- 139: <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">message</span>
342
- 140: <span class="ruby-keyword kw">rescue</span> <span class="ruby-constant">Errno</span><span class="ruby-operator">::</span><span class="ruby-constant">ECONNRESET</span>
343
- 141: <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">nil</span>
344
- 142: <span class="ruby-keyword kw">end</span>
345
- </pre>
346
- </div>
347
- </div>
348
- </div>
349
- <div class="method">
350
- <div class="title">
351
- <a name="M000360"></a><b>read_hash</b>()
352
- </div>
353
- <div class="description">
354
- <p>
355
- Read an array message from the underlying file descriptor and return the
356
- result as a hash instead of an array. This assumes that the array message
357
- has an even number of elements. Returns nil when end-of-stream has been
358
- reached.
359
- </p>
360
- <p>
361
- Might raise SystemCallError, IOError or SocketError when something goes
362
- wrong.
363
- </p>
364
- </div>
365
- <div class="sourcecode">
366
- <p class="source-link">[ <a href="javascript:toggleSource('M000360_source')" id="l_M000360_source">show source</a> ]</p>
367
- <div id="M000360_source" class="dyn-source">
368
- <pre>
369
- <span class="ruby-comment cmt"># File lib/phusion_passenger/message_channel.rb, line 151</span>
370
- 151: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">read_hash</span>
371
- 152: <span class="ruby-identifier">buffer</span> = <span class="ruby-identifier">new_buffer</span>
372
- 153: <span class="ruby-keyword kw">if</span> <span class="ruby-operator">!</span><span class="ruby-ivar">@io</span>.<span class="ruby-identifier">read</span>(<span class="ruby-constant">HEADER_SIZE</span>, <span class="ruby-identifier">buffer</span>)
373
- 154: <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">nil</span>
374
- 155: <span class="ruby-keyword kw">end</span>
375
- 156: <span class="ruby-keyword kw">while</span> <span class="ruby-identifier">buffer</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator">&lt;</span> <span class="ruby-constant">HEADER_SIZE</span>
376
- 157: <span class="ruby-identifier">tmp</span> = <span class="ruby-ivar">@io</span>.<span class="ruby-identifier">read</span>(<span class="ruby-constant">HEADER_SIZE</span> <span class="ruby-operator">-</span> <span class="ruby-identifier">buffer</span>.<span class="ruby-identifier">size</span>)
377
- 158: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">tmp</span>.<span class="ruby-identifier">empty?</span>
378
- 159: <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">nil</span>
379
- 160: <span class="ruby-keyword kw">else</span>
380
- 161: <span class="ruby-identifier">buffer</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">tmp</span>
381
- 162: <span class="ruby-keyword kw">end</span>
382
- 163: <span class="ruby-keyword kw">end</span>
383
- 164:
384
- 165: <span class="ruby-identifier">chunk_size</span> = <span class="ruby-identifier">buffer</span>.<span class="ruby-identifier">unpack</span>(<span class="ruby-constant">UINT16_PACK_FORMAT</span>)[<span class="ruby-value">0</span>]
385
- 166: <span class="ruby-keyword kw">if</span> <span class="ruby-operator">!</span><span class="ruby-ivar">@io</span>.<span class="ruby-identifier">read</span>(<span class="ruby-identifier">chunk_size</span>, <span class="ruby-identifier">buffer</span>)
386
- 167: <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">nil</span>
387
- 168: <span class="ruby-keyword kw">end</span>
388
- 169: <span class="ruby-keyword kw">while</span> <span class="ruby-identifier">buffer</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator">&lt;</span> <span class="ruby-identifier">chunk_size</span>
389
- 170: <span class="ruby-identifier">tmp</span> = <span class="ruby-ivar">@io</span>.<span class="ruby-identifier">read</span>(<span class="ruby-identifier">chunk_size</span> <span class="ruby-operator">-</span> <span class="ruby-identifier">buffer</span>.<span class="ruby-identifier">size</span>)
390
- 171: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">tmp</span>.<span class="ruby-identifier">empty?</span>
391
- 172: <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">nil</span>
392
- 173: <span class="ruby-keyword kw">else</span>
393
- 174: <span class="ruby-identifier">buffer</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">tmp</span>
394
- 175: <span class="ruby-keyword kw">end</span>
395
- 176: <span class="ruby-keyword kw">end</span>
396
- 177:
397
- 178: <span class="ruby-identifier">result</span> = {}
398
- 179: <span class="ruby-identifier">offset</span> = <span class="ruby-value">0</span>
399
- 180: <span class="ruby-identifier">delimiter_pos</span> = <span class="ruby-identifier">buffer</span>.<span class="ruby-identifier">index</span>(<span class="ruby-constant">DELIMITER</span>, <span class="ruby-identifier">offset</span>)
400
- 181: <span class="ruby-keyword kw">while</span> <span class="ruby-operator">!</span><span class="ruby-identifier">delimiter_pos</span>.<span class="ruby-identifier">nil?</span>
401
- 182: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">delimiter_pos</span> <span class="ruby-operator">==</span> <span class="ruby-value">0</span>
402
- 183: <span class="ruby-identifier">name</span> = <span class="ruby-value str">&quot;&quot;</span>
403
- 184: <span class="ruby-keyword kw">else</span>
404
- 185: <span class="ruby-identifier">name</span> = <span class="ruby-identifier">buffer</span>[<span class="ruby-identifier">offset</span> <span class="ruby-operator">..</span> <span class="ruby-identifier">delimiter_pos</span> <span class="ruby-operator">-</span> <span class="ruby-value">1</span>]
405
- 186: <span class="ruby-keyword kw">end</span>
406
- 187:
407
- 188: <span class="ruby-identifier">offset</span> = <span class="ruby-identifier">delimiter_pos</span> <span class="ruby-operator">+</span> <span class="ruby-value">1</span>
408
- 189: <span class="ruby-identifier">delimiter_pos</span> = <span class="ruby-identifier">buffer</span>.<span class="ruby-identifier">index</span>(<span class="ruby-constant">DELIMITER</span>, <span class="ruby-identifier">offset</span>)
409
- 190: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">delimiter_pos</span>.<span class="ruby-identifier">nil?</span>
410
- 191: <span class="ruby-identifier">raise</span> <span class="ruby-constant">InvalidHashError</span>
411
- 192: <span class="ruby-keyword kw">elsif</span> <span class="ruby-identifier">delimiter_pos</span> <span class="ruby-operator">==</span> <span class="ruby-value">0</span>
412
- 193: <span class="ruby-identifier">value</span> = <span class="ruby-value str">&quot;&quot;</span>
413
- 194: <span class="ruby-keyword kw">else</span>
414
- 195: <span class="ruby-identifier">value</span> = <span class="ruby-identifier">buffer</span>[<span class="ruby-identifier">offset</span> <span class="ruby-operator">..</span> <span class="ruby-identifier">delimiter_pos</span> <span class="ruby-operator">-</span> <span class="ruby-value">1</span>]
415
- 196: <span class="ruby-keyword kw">end</span>
416
- 197:
417
- 198: <span class="ruby-identifier">result</span>[<span class="ruby-identifier">name</span>] = <span class="ruby-identifier">value</span>
418
- 199: <span class="ruby-identifier">offset</span> = <span class="ruby-identifier">delimiter_pos</span> <span class="ruby-operator">+</span> <span class="ruby-value">1</span>
419
- 200: <span class="ruby-identifier">delimiter_pos</span> = <span class="ruby-identifier">buffer</span>.<span class="ruby-identifier">index</span>(<span class="ruby-constant">DELIMITER</span>, <span class="ruby-identifier">offset</span>)
420
- 201: <span class="ruby-keyword kw">end</span>
421
- 202: <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">result</span>
422
- 203: <span class="ruby-keyword kw">rescue</span> <span class="ruby-constant">Errno</span><span class="ruby-operator">::</span><span class="ruby-constant">ECONNRESET</span>
423
- 204: <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">nil</span>
424
- 205: <span class="ruby-keyword kw">end</span>
425
- </pre>
426
- </div>
427
- </div>
428
- </div>
429
- <div class="method">
430
- <div class="title">
431
- <a name="M000361"></a><b>read_scalar</b>(buffer = new_buffer, max_size = nil)
432
- </div>
433
- <div class="description">
434
- <p>
435
- Read a scalar message from the underlying <a href="../IO.html">IO</a>
436
- object. Returns the <a href="MessageChannel.html#M000359">read</a> message,
437
- or nil on end-of-stream.
438
- </p>
439
- <p>
440
- Might raise SystemCallError, IOError or SocketError when something goes
441
- wrong.
442
- </p>
443
- <p>
444
- The <tt>buffer</tt> argument specifies a buffer in which <a
445
- href="MessageChannel.html#M000361">#read_scalar</a> stores the <a
446
- href="MessageChannel.html#M000359">read</a> data. It is good practice to
447
- reuse existing buffers in order to minimize stress on the garbage
448
- collector.
449
- </p>
450
- <p>
451
- The <tt>max_size</tt> argument allows one to specify the maximum allowed
452
- size for the scalar message. If the received scalar message&#8216;s size is
453
- larger than <tt>max_size</tt>, then a SecurityError will be raised.
454
- </p>
455
- </div>
456
- <div class="sourcecode">
457
- <p class="source-link">[ <a href="javascript:toggleSource('M000361_source')" id="l_M000361_source">show source</a> ]</p>
458
- <div id="M000361_source" class="dyn-source">
459
- <pre>
460
- <span class="ruby-comment cmt"># File lib/phusion_passenger/message_channel.rb, line 220</span>
461
- 220: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">read_scalar</span>(<span class="ruby-identifier">buffer</span> = <span class="ruby-identifier">new_buffer</span>, <span class="ruby-identifier">max_size</span> = <span class="ruby-keyword kw">nil</span>)
462
- 221: <span class="ruby-keyword kw">if</span> <span class="ruby-operator">!</span><span class="ruby-ivar">@io</span>.<span class="ruby-identifier">read</span>(<span class="ruby-value">4</span>, <span class="ruby-identifier">buffer</span>)
463
- 222: <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">nil</span>
464
- 223: <span class="ruby-keyword kw">end</span>
465
- 224: <span class="ruby-keyword kw">while</span> <span class="ruby-identifier">buffer</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator">&lt;</span> <span class="ruby-value">4</span>
466
- 225: <span class="ruby-identifier">tmp</span> = <span class="ruby-ivar">@io</span>.<span class="ruby-identifier">read</span>(<span class="ruby-value">4</span> <span class="ruby-operator">-</span> <span class="ruby-identifier">buffer</span>.<span class="ruby-identifier">size</span>)
467
- 226: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">tmp</span>.<span class="ruby-identifier">empty?</span>
468
- 227: <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">nil</span>
469
- 228: <span class="ruby-keyword kw">else</span>
470
- 229: <span class="ruby-identifier">buffer</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">tmp</span>
471
- 230: <span class="ruby-keyword kw">end</span>
472
- 231: <span class="ruby-keyword kw">end</span>
473
- 232:
474
- 233: <span class="ruby-identifier">size</span> = <span class="ruby-identifier">buffer</span>.<span class="ruby-identifier">unpack</span>(<span class="ruby-constant">UINT32_PACK_FORMAT</span>)[<span class="ruby-value">0</span>]
475
- 234: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">size</span> <span class="ruby-operator">==</span> <span class="ruby-value">0</span>
476
- 235: <span class="ruby-identifier">buffer</span>.<span class="ruby-identifier">replace</span>(<span class="ruby-value str">''</span>)
477
- 236: <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">buffer</span>
478
- 237: <span class="ruby-keyword kw">else</span>
479
- 238: <span class="ruby-keyword kw">if</span> <span class="ruby-operator">!</span><span class="ruby-identifier">max_size</span>.<span class="ruby-identifier">nil?</span> <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-identifier">size</span> <span class="ruby-operator">&gt;</span> <span class="ruby-identifier">max_size</span>
480
- 239: <span class="ruby-identifier">raise</span> <span class="ruby-constant">SecurityError</span>, <span class="ruby-node">&quot;Scalar message size (#{size}) &quot;</span> <span class="ruby-operator">&lt;&lt;</span>
481
- 240: <span class="ruby-node">&quot;exceeds maximum allowed size (#{max_size}).&quot;</span>
482
- 241: <span class="ruby-keyword kw">end</span>
483
- 242: <span class="ruby-keyword kw">if</span> <span class="ruby-operator">!</span><span class="ruby-ivar">@io</span>.<span class="ruby-identifier">read</span>(<span class="ruby-identifier">size</span>, <span class="ruby-identifier">buffer</span>)
484
- 243: <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">nil</span>
485
- 244: <span class="ruby-keyword kw">end</span>
486
- 245: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">buffer</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator">&lt;</span> <span class="ruby-identifier">size</span>
487
- 246: <span class="ruby-identifier">tmp</span> = <span class="ruby-value str">''</span>
488
- 247: <span class="ruby-keyword kw">while</span> <span class="ruby-identifier">buffer</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator">&lt;</span> <span class="ruby-identifier">size</span>
489
- 248: <span class="ruby-keyword kw">if</span> <span class="ruby-operator">!</span><span class="ruby-ivar">@io</span>.<span class="ruby-identifier">read</span>(<span class="ruby-identifier">size</span> <span class="ruby-operator">-</span> <span class="ruby-identifier">buffer</span>.<span class="ruby-identifier">size</span>, <span class="ruby-identifier">tmp</span>)
490
- 249: <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">nil</span>
491
- 250: <span class="ruby-keyword kw">else</span>
492
- 251: <span class="ruby-identifier">buffer</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">tmp</span>
493
- 252: <span class="ruby-keyword kw">end</span>
494
- 253: <span class="ruby-keyword kw">end</span>
495
- 254: <span class="ruby-keyword kw">end</span>
496
- 255: <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">buffer</span>
497
- 256: <span class="ruby-keyword kw">end</span>
498
- 257: <span class="ruby-keyword kw">rescue</span> <span class="ruby-constant">Errno</span><span class="ruby-operator">::</span><span class="ruby-constant">ECONNRESET</span>
499
- 258: <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">nil</span>
500
- 259: <span class="ruby-keyword kw">end</span>
501
- </pre>
502
- </div>
503
- </div>
504
- </div>
505
- <div class="method">
506
- <div class="title">
507
- <a name="M000364"></a><b>recv_io</b>(klass = IO, negotiate = true)
508
- </div>
509
- <div class="description">
510
- <p>
511
- Receive an <a href="../IO.html">IO</a> object (a file descriptor) from the
512
- channel. The other side must have sent an <a href="../IO.html">IO</a>
513
- object by calling <a href="MessageChannel.html#M000365">send_io</a>(). Note
514
- that this only works on Unix sockets.
515
- </p>
516
- <p>
517
- Might raise SystemCallError, IOError or SocketError when something goes
518
- wrong.
519
- </p>
520
- </div>
521
- <div class="sourcecode">
522
- <p class="source-link">[ <a href="javascript:toggleSource('M000364_source')" id="l_M000364_source">show source</a> ]</p>
523
- <div id="M000364_source" class="dyn-source">
524
- <pre>
525
- <span class="ruby-comment cmt"># File lib/phusion_passenger/message_channel.rb, line 297</span>
526
- 297: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">recv_io</span>(<span class="ruby-identifier">klass</span> = <span class="ruby-constant">IO</span>, <span class="ruby-identifier">negotiate</span> = <span class="ruby-keyword kw">true</span>)
527
- 298: <span class="ruby-identifier">write</span>(<span class="ruby-value str">&quot;pass IO&quot;</span>) <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">negotiate</span>
528
- 299: <span class="ruby-identifier">io</span> = <span class="ruby-ivar">@io</span>.<span class="ruby-identifier">recv_io</span>(<span class="ruby-identifier">klass</span>)
529
- 300: <span class="ruby-identifier">write</span>(<span class="ruby-value str">&quot;got IO&quot;</span>) <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">negotiate</span>
530
- 301: <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">io</span>
531
- 302: <span class="ruby-keyword kw">end</span>
532
- </pre>
533
- </div>
534
- </div>
535
- </div>
536
- <div class="method">
537
- <div class="title">
538
- <a name="M000365"></a><b>send_io</b>(io)
539
- </div>
540
- <div class="description">
541
- <p>
542
- Send an <a href="../IO.html">IO</a> object (a file descriptor) over the
543
- channel. The other side must receive the <a href="../IO.html">IO</a> object
544
- by calling <a href="MessageChannel.html#M000364">recv_io</a>(). Note that
545
- this only works on Unix sockets.
546
- </p>
547
- <p>
548
- Might raise SystemCallError, IOError or SocketError when something goes
549
- wrong.
550
- </p>
551
- </div>
552
- <div class="sourcecode">
553
- <p class="source-link">[ <a href="javascript:toggleSource('M000365_source')" id="l_M000365_source">show source</a> ]</p>
554
- <div id="M000365_source" class="dyn-source">
555
- <pre>
556
- <span class="ruby-comment cmt"># File lib/phusion_passenger/message_channel.rb, line 310</span>
557
- 310: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">send_io</span>(<span class="ruby-identifier">io</span>)
558
- 311: <span class="ruby-comment cmt"># We read a message before actually calling #send_io</span>
559
- 312: <span class="ruby-comment cmt"># in order to prevent the other side from accidentally</span>
560
- 313: <span class="ruby-comment cmt"># read()ing past the normal data and reading our file</span>
561
- 314: <span class="ruby-comment cmt"># descriptor too.</span>
562
- 315: <span class="ruby-comment cmt">#</span>
563
- 316: <span class="ruby-comment cmt"># For example suppose that side A looks like this:</span>
564
- 317: <span class="ruby-comment cmt">#</span>
565
- 318: <span class="ruby-comment cmt"># read(fd, buf, 1024)</span>
566
- 319: <span class="ruby-comment cmt"># read_io(fd)</span>
567
- 320: <span class="ruby-comment cmt">#</span>
568
- 321: <span class="ruby-comment cmt"># and side B:</span>
569
- 322: <span class="ruby-comment cmt">#</span>
570
- 323: <span class="ruby-comment cmt"># write(fd, buf, 100)</span>
571
- 324: <span class="ruby-comment cmt"># send_io(fd_to_pass)</span>
572
- 325: <span class="ruby-comment cmt">#</span>
573
- 326: <span class="ruby-comment cmt"># If B completes both write() and send_io(), then A's read() call</span>
574
- 327: <span class="ruby-comment cmt"># reads past the 100 bytes that B sent. On some platforms, like</span>
575
- 328: <span class="ruby-comment cmt"># Linux, this will cause read_io() to fail. And it just so happens</span>
576
- 329: <span class="ruby-comment cmt"># that Ruby's IO#read method slurps more than just the given amount</span>
577
- 330: <span class="ruby-comment cmt"># of bytes.</span>
578
- 331: <span class="ruby-identifier">result</span> = <span class="ruby-identifier">read</span>
579
- 332: <span class="ruby-keyword kw">if</span> <span class="ruby-operator">!</span><span class="ruby-identifier">result</span>
580
- 333: <span class="ruby-identifier">raise</span> <span class="ruby-constant">EOFError</span>, <span class="ruby-value str">&quot;End of stream&quot;</span>
581
- 334: <span class="ruby-keyword kw">elsif</span> <span class="ruby-identifier">result</span> <span class="ruby-operator">!=</span> [<span class="ruby-value str">&quot;pass IO&quot;</span>]
582
- 335: <span class="ruby-identifier">raise</span> <span class="ruby-constant">IOError</span>, <span class="ruby-value str">&quot;IO passing pre-negotiation header expected&quot;</span>
583
- 336: <span class="ruby-keyword kw">else</span>
584
- 337: <span class="ruby-ivar">@io</span>.<span class="ruby-identifier">send_io</span>(<span class="ruby-identifier">io</span>)
585
- 338: <span class="ruby-comment cmt"># Once you've sent the IO you expect to be able to close it on the</span>
586
- 339: <span class="ruby-comment cmt"># sender's side, even if the other side hasn't read the IO yet.</span>
587
- 340: <span class="ruby-comment cmt"># Not so: on some operating systems (I'm looking at you OS X) this</span>
588
- 341: <span class="ruby-comment cmt"># can cause the receiving side to receive a bad file descriptor.</span>
589
- 342: <span class="ruby-comment cmt"># The post negotiation protocol ensures that we block until the</span>
590
- 343: <span class="ruby-comment cmt"># other side has really received the IO.</span>
591
- 344: <span class="ruby-identifier">result</span> = <span class="ruby-identifier">read</span>
592
- 345: <span class="ruby-keyword kw">if</span> <span class="ruby-operator">!</span><span class="ruby-identifier">result</span>
593
- 346: <span class="ruby-identifier">raise</span> <span class="ruby-constant">EOFError</span>, <span class="ruby-value str">&quot;End of stream&quot;</span>
594
- 347: <span class="ruby-keyword kw">elsif</span> <span class="ruby-identifier">result</span> <span class="ruby-operator">!=</span> [<span class="ruby-value str">&quot;got IO&quot;</span>]
595
- 348: <span class="ruby-identifier">raise</span> <span class="ruby-constant">IOError</span>, <span class="ruby-value str">&quot;IO passing post-negotiation header expected&quot;</span>
596
- 349: <span class="ruby-keyword kw">end</span>
597
- 350: <span class="ruby-keyword kw">end</span>
598
- 351: <span class="ruby-keyword kw">end</span>
599
- </pre>
600
- </div>
601
- </div>
602
- </div>
603
- <div class="method">
604
- <div class="title">
605
- <a name="M000362"></a><b>write</b>(name, *args)
606
- </div>
607
- <div class="description">
608
- <p>
609
- Send an array message, which consists of the given elements, over the
610
- underlying file descriptor. <em>name</em> is the first element in the
611
- message, and <em>args</em> are the other elements. These arguments will
612
- internally be converted to strings by calling to_s().
613
- </p>
614
- <p>
615
- Might raise SystemCallError, IOError or SocketError when something goes
616
- wrong.
617
- </p>
618
- </div>
619
- <div class="sourcecode">
620
- <p class="source-link">[ <a href="javascript:toggleSource('M000362_source')" id="l_M000362_source">show source</a> ]</p>
621
- <div id="M000362_source" class="dyn-source">
622
- <pre>
623
- <span class="ruby-comment cmt"># File lib/phusion_passenger/message_channel.rb, line 268</span>
624
- 268: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">write</span>(<span class="ruby-identifier">name</span>, <span class="ruby-operator">*</span><span class="ruby-identifier">args</span>)
625
- 269: <span class="ruby-identifier">check_argument</span>(<span class="ruby-identifier">name</span>)
626
- 270: <span class="ruby-identifier">args</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">arg</span><span class="ruby-operator">|</span>
627
- 271: <span class="ruby-identifier">check_argument</span>(<span class="ruby-identifier">arg</span>)
628
- 272: <span class="ruby-keyword kw">end</span>
629
- 273:
630
- 274: <span class="ruby-identifier">message</span> = <span class="ruby-node">&quot;#{name}#{DELIMITER}&quot;</span>
631
- 275: <span class="ruby-identifier">args</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">arg</span><span class="ruby-operator">|</span>
632
- 276: <span class="ruby-identifier">message</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">arg</span>.<span class="ruby-identifier">to_s</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-constant">DELIMITER</span>
633
- 277: <span class="ruby-keyword kw">end</span>
634
- 278: <span class="ruby-ivar">@io</span>.<span class="ruby-identifier">write</span>([<span class="ruby-identifier">message</span>.<span class="ruby-identifier">size</span>].<span class="ruby-identifier">pack</span>(<span class="ruby-value str">'n'</span>) <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">message</span>)
635
- 279: <span class="ruby-ivar">@io</span>.<span class="ruby-identifier">flush</span>
636
- 280: <span class="ruby-keyword kw">end</span>
637
- </pre>
638
- </div>
639
- </div>
640
- </div>
641
- <div class="method">
642
- <div class="title">
643
- <a name="M000363"></a><b>write_scalar</b>(data)
644
- </div>
645
- <div class="description">
646
- <p>
647
- Send a scalar message over the underlying <a href="../IO.html">IO</a>
648
- object.
649
- </p>
650
- <p>
651
- Might raise SystemCallError, IOError or SocketError when something goes
652
- wrong.
653
- </p>
654
- </div>
655
- <div class="sourcecode">
656
- <p class="source-link">[ <a href="javascript:toggleSource('M000363_source')" id="l_M000363_source">show source</a> ]</p>
657
- <div id="M000363_source" class="dyn-source">
658
- <pre>
659
- <span class="ruby-comment cmt"># File lib/phusion_passenger/message_channel.rb, line 286</span>
660
- 286: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">write_scalar</span>(<span class="ruby-identifier">data</span>)
661
- 287: <span class="ruby-ivar">@io</span>.<span class="ruby-identifier">write</span>([<span class="ruby-identifier">data</span>.<span class="ruby-identifier">size</span>].<span class="ruby-identifier">pack</span>(<span class="ruby-value str">'N'</span>) <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">data</span>)
662
- 288: <span class="ruby-ivar">@io</span>.<span class="ruby-identifier">flush</span>
663
- 289: <span class="ruby-keyword kw">end</span>
664
- </pre>
665
- </div>
666
- </div>
667
- </div>
668
- </div>
669
-
670
- </div>
671
-
672
- </body>
673
- </html>