passenger 3.0.7 → 3.0.8

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 (439) hide show
  1. data/NEWS +27 -0
  2. data/README +1 -1
  3. data/bin/passenger-install-nginx-module +3 -1
  4. data/build/config.rb +2 -1
  5. data/build/cxx_tests.rb +7 -3
  6. data/build/documentation.rb +5 -40
  7. data/build/nginx.rb +0 -1
  8. data/build/packaging.rb +0 -6
  9. data/build/rake_extensions.rb +5 -0
  10. data/doc/Architectural overview.html +344 -77
  11. data/doc/Security of user switching support.html +338 -71
  12. data/doc/Users guide Apache with comments.html +4830 -0
  13. data/doc/Users guide Apache.html +695 -428
  14. data/doc/Users guide Apache.idmap.txt +80 -0
  15. data/doc/Users guide Apache.txt +5 -5
  16. data/doc/Users guide Nginx.html +591 -313
  17. data/doc/Users guide Nginx.txt +9 -3
  18. data/doc/Users guide Standalone.html +344 -77
  19. data/ext/boost/src/pthread/thread.cpp +1 -1
  20. data/ext/common/AccountsDatabase.h +1 -1
  21. data/ext/common/Constants.h +2 -2
  22. data/ext/common/Logging.h +2 -1
  23. data/ext/common/LoggingAgent/FilterSupport.h +107 -3
  24. data/ext/common/Session.h +1 -1
  25. data/ext/common/Utils.cpp +2 -0
  26. data/ext/common/Utils/Dechunker.h +232 -0
  27. data/ext/common/Utils/HttpHeaderBufferer.h +165 -0
  28. data/ext/common/Utils/StrIntUtils.cpp +51 -15
  29. data/ext/common/Utils/StrIntUtils.h +3 -0
  30. data/ext/common/Utils/StreamBoyerMooreHorspool.h +506 -0
  31. data/ext/nginx/Configuration.c +36 -282
  32. data/ext/nginx/ContentHandler.c +17 -0
  33. data/ext/nginx/HelperAgent.cpp +397 -39
  34. data/ext/oxt/tracable_exception.cpp +3 -1
  35. data/ext/ruby/extconf.rb +1 -0
  36. data/ext/ruby/passenger_native_support.c +3 -0
  37. data/helper-scripts/prespawn +113 -31
  38. data/lib/phusion_passenger.rb +2 -2
  39. data/lib/phusion_passenger/standalone/runtime_installer.rb +3 -2
  40. data/lib/phusion_passenger/standalone/start_command.rb +12 -12
  41. data/test/cxx/DechunkerTest.cpp +216 -0
  42. data/test/cxx/FilterSupportTest.cpp +31 -4
  43. data/test/cxx/HttpHeaderBuffererTest.cpp +203 -0
  44. data/test/cxx/UtilsTest.cpp +46 -3
  45. data/test/integration_tests/hello_world_rack_spec.rb +7 -0
  46. data/test/stub/rack/config.ru +6 -1
  47. data/test/stub/rails_apps/1.2/empty/public/dispatch.cgi +1 -1
  48. data/test/stub/rails_apps/1.2/empty/public/dispatch.fcgi +1 -1
  49. data/test/stub/rails_apps/1.2/empty/public/dispatch.rb +1 -1
  50. data/test/stub/rails_apps/2.0/empty/public/dispatch.cgi +1 -1
  51. data/test/stub/rails_apps/2.0/empty/public/dispatch.fcgi +1 -1
  52. data/test/stub/rails_apps/2.0/empty/public/dispatch.rb +1 -1
  53. data/test/stub/rails_apps/2.2/empty/public/dispatch.cgi +1 -1
  54. data/test/stub/rails_apps/2.2/empty/public/dispatch.fcgi +1 -1
  55. data/test/stub/rails_apps/2.2/empty/public/dispatch.rb +1 -1
  56. metadata +20 -403
  57. data/doc/Doxyfile +0 -241
  58. data/doc/cxxapi/AbstractSpawnManager_8h_source.html +0 -141
  59. data/doc/cxxapi/Account_8h_source.html +0 -206
  60. data/doc/cxxapi/AccountsDatabase_8h_source.html +0 -161
  61. data/doc/cxxapi/AgentBase_8h_source.html +0 -70
  62. data/doc/cxxapi/AgentsStarter_8h_source.html +0 -112
  63. data/doc/cxxapi/BCrypt_8h_source.html +0 -104
  64. data/doc/cxxapi/Blowfish_8h_source.html +0 -134
  65. data/doc/cxxapi/Bucket_8h_source.html +0 -118
  66. data/doc/cxxapi/Constants_8h_source.html +0 -79
  67. data/doc/cxxapi/ContentHandler_8h_source.html +0 -95
  68. data/doc/cxxapi/DirectoryMapper_8h_source.html +0 -311
  69. data/doc/cxxapi/EventedClient_8h_source.html +0 -733
  70. data/doc/cxxapi/EventedMessageServer_8h_source.html +0 -358
  71. data/doc/cxxapi/EventedServer_8h_source.html +0 -326
  72. data/doc/cxxapi/Exceptions_8h_source.html +0 -393
  73. data/doc/cxxapi/FileDescriptor_8h_source.html +0 -324
  74. data/doc/cxxapi/Hooks_8h_source.html +0 -76
  75. data/doc/cxxapi/HttpStatusExtractor_8h_source.html +0 -382
  76. data/doc/cxxapi/IniFile_8h_source.html +0 -527
  77. data/doc/cxxapi/Logging_8h_source.html +0 -796
  78. data/doc/cxxapi/MessageChannel_8h_source.html +0 -776
  79. data/doc/cxxapi/MessageClient_8h_source.html +0 -328
  80. data/doc/cxxapi/MessageReadersWriters_8h_source.html +0 -539
  81. data/doc/cxxapi/MessageServer_8h_source.html +0 -612
  82. data/doc/cxxapi/PoolOptions_8h_source.html +0 -549
  83. data/doc/cxxapi/Process_8h_source.html +0 -286
  84. data/doc/cxxapi/RandomGenerator_8h_source.html +0 -191
  85. data/doc/cxxapi/ResourceLocator_8h_source.html +0 -166
  86. data/doc/cxxapi/SafeLibev_8h_source.html +0 -180
  87. data/doc/cxxapi/ScgiRequestParser_8h_source.html +0 -406
  88. data/doc/cxxapi/ServerInstanceDir_8h_source.html +0 -378
  89. data/doc/cxxapi/Session_8h_source.html +0 -501
  90. data/doc/cxxapi/SpawnManager_8h_source.html +0 -647
  91. data/doc/cxxapi/StaticContentHandler_8h_source.html +0 -69
  92. data/doc/cxxapi/StaticString_8h_source.html +0 -329
  93. data/doc/cxxapi/StringListCreator_8h_source.html +0 -114
  94. data/doc/cxxapi/Utils_8h_source.html +0 -469
  95. data/doc/cxxapi/annotated.html +0 -87
  96. data/doc/cxxapi/apache2_2Configuration_8h_source.html +0 -82
  97. data/doc/cxxapi/classAgentWatcher-members.html +0 -54
  98. data/doc/cxxapi/classAgentWatcher.html +0 -419
  99. data/doc/cxxapi/classClient-members.html +0 -38
  100. data/doc/cxxapi/classClient.html +0 -123
  101. data/doc/cxxapi/classHooks-members.html +0 -40
  102. data/doc/cxxapi/classHooks.html +0 -153
  103. data/doc/cxxapi/classPassenger_1_1AbstractSpawnManager-members.html +0 -40
  104. data/doc/cxxapi/classPassenger_1_1AbstractSpawnManager.html +0 -187
  105. data/doc/cxxapi/classPassenger_1_1AbstractSpawnManager__inherit__graph.map +0 -3
  106. data/doc/cxxapi/classPassenger_1_1AbstractSpawnManager__inherit__graph.md5 +0 -1
  107. data/doc/cxxapi/classPassenger_1_1AbstractSpawnManager__inherit__graph.png +0 -0
  108. data/doc/cxxapi/classPassenger_1_1ArgumentException-members.html +0 -36
  109. data/doc/cxxapi/classPassenger_1_1ArgumentException.html +0 -56
  110. data/doc/cxxapi/classPassenger_1_1ArrayMessage-members.html +0 -37
  111. data/doc/cxxapi/classPassenger_1_1ArrayMessage.html +0 -113
  112. data/doc/cxxapi/classPassenger_1_1BufferedUpload-members.html +0 -38
  113. data/doc/cxxapi/classPassenger_1_1BufferedUpload.html +0 -112
  114. data/doc/cxxapi/classPassenger_1_1BusyException-members.html +0 -36
  115. data/doc/cxxapi/classPassenger_1_1BusyException.html +0 -54
  116. data/doc/cxxapi/classPassenger_1_1ConfigurationException-members.html +0 -36
  117. data/doc/cxxapi/classPassenger_1_1ConfigurationException.html +0 -51
  118. data/doc/cxxapi/classPassenger_1_1DirectoryMapper-members.html +0 -41
  119. data/doc/cxxapi/classPassenger_1_1DirectoryMapper.html +0 -223
  120. data/doc/cxxapi/classPassenger_1_1EOFException-members.html +0 -36
  121. data/doc/cxxapi/classPassenger_1_1EOFException.html +0 -61
  122. data/doc/cxxapi/classPassenger_1_1EOFException__inherit__graph.map +0 -3
  123. data/doc/cxxapi/classPassenger_1_1EOFException__inherit__graph.md5 +0 -1
  124. data/doc/cxxapi/classPassenger_1_1EOFException__inherit__graph.png +0 -0
  125. data/doc/cxxapi/classPassenger_1_1EventFd-members.html +0 -36
  126. data/doc/cxxapi/classPassenger_1_1EventFd.html +0 -52
  127. data/doc/cxxapi/classPassenger_1_1EventedClient-members.html +0 -59
  128. data/doc/cxxapi/classPassenger_1_1EventedClient.html +0 -531
  129. data/doc/cxxapi/classPassenger_1_1EventedMessageServer-members.html +0 -37
  130. data/doc/cxxapi/classPassenger_1_1EventedMessageServer.html +0 -59
  131. data/doc/cxxapi/classPassenger_1_1EventedMessageServer__inherit__graph.map +0 -3
  132. data/doc/cxxapi/classPassenger_1_1EventedMessageServer__inherit__graph.md5 +0 -1
  133. data/doc/cxxapi/classPassenger_1_1EventedMessageServer__inherit__graph.png +0 -0
  134. data/doc/cxxapi/classPassenger_1_1EventedServer-members.html +0 -37
  135. data/doc/cxxapi/classPassenger_1_1EventedServer.html +0 -93
  136. data/doc/cxxapi/classPassenger_1_1EventedServer__inherit__graph.map +0 -3
  137. data/doc/cxxapi/classPassenger_1_1EventedServer__inherit__graph.md5 +0 -1
  138. data/doc/cxxapi/classPassenger_1_1EventedServer__inherit__graph.png +0 -0
  139. data/doc/cxxapi/classPassenger_1_1FileDescriptor-members.html +0 -41
  140. data/doc/cxxapi/classPassenger_1_1FileDescriptor.html +0 -178
  141. data/doc/cxxapi/classPassenger_1_1FileDescriptorPair-members.html +0 -36
  142. data/doc/cxxapi/classPassenger_1_1FileDescriptorPair.html +0 -52
  143. data/doc/cxxapi/classPassenger_1_1FileNotFoundException-members.html +0 -36
  144. data/doc/cxxapi/classPassenger_1_1FileNotFoundException.html +0 -58
  145. data/doc/cxxapi/classPassenger_1_1FileNotFoundException__inherit__graph.map +0 -3
  146. data/doc/cxxapi/classPassenger_1_1FileNotFoundException__inherit__graph.md5 +0 -1
  147. data/doc/cxxapi/classPassenger_1_1FileNotFoundException__inherit__graph.png +0 -0
  148. data/doc/cxxapi/classPassenger_1_1FileSystemException-members.html +0 -41
  149. data/doc/cxxapi/classPassenger_1_1FileSystemException.html +0 -66
  150. data/doc/cxxapi/classPassenger_1_1FileSystemException__inherit__graph.map +0 -3
  151. data/doc/cxxapi/classPassenger_1_1FileSystemException__inherit__graph.md5 +0 -1
  152. data/doc/cxxapi/classPassenger_1_1FileSystemException__inherit__graph.png +0 -0
  153. data/doc/cxxapi/classPassenger_1_1HttpStatusExtractor-members.html +0 -39
  154. data/doc/cxxapi/classPassenger_1_1HttpStatusExtractor.html +0 -128
  155. data/doc/cxxapi/classPassenger_1_1IOException-members.html +0 -36
  156. data/doc/cxxapi/classPassenger_1_1IOException.html +0 -61
  157. data/doc/cxxapi/classPassenger_1_1IOException__inherit__graph.map +0 -4
  158. data/doc/cxxapi/classPassenger_1_1IOException__inherit__graph.md5 +0 -1
  159. data/doc/cxxapi/classPassenger_1_1IOException__inherit__graph.png +0 -0
  160. data/doc/cxxapi/classPassenger_1_1MessageChannel-members.html +0 -57
  161. data/doc/cxxapi/classPassenger_1_1MessageChannel.html +0 -839
  162. data/doc/cxxapi/classPassenger_1_1MessageServer-members.html +0 -49
  163. data/doc/cxxapi/classPassenger_1_1MessageServer.html +0 -407
  164. data/doc/cxxapi/classPassenger_1_1MessageServer_1_1ClientContext-members.html +0 -36
  165. data/doc/cxxapi/classPassenger_1_1MessageServer_1_1ClientContext.html +0 -58
  166. data/doc/cxxapi/classPassenger_1_1MessageServer_1_1ClientContext__inherit__graph.map +0 -3
  167. data/doc/cxxapi/classPassenger_1_1MessageServer_1_1ClientContext__inherit__graph.md5 +0 -1
  168. data/doc/cxxapi/classPassenger_1_1MessageServer_1_1ClientContext__inherit__graph.png +0 -0
  169. data/doc/cxxapi/classPassenger_1_1MessageServer_1_1CommonClientContext-members.html +0 -41
  170. data/doc/cxxapi/classPassenger_1_1MessageServer_1_1CommonClientContext.html +0 -165
  171. data/doc/cxxapi/classPassenger_1_1MessageServer_1_1CommonClientContext__inherit__graph.map +0 -3
  172. data/doc/cxxapi/classPassenger_1_1MessageServer_1_1CommonClientContext__inherit__graph.md5 +0 -1
  173. data/doc/cxxapi/classPassenger_1_1MessageServer_1_1CommonClientContext__inherit__graph.png +0 -0
  174. data/doc/cxxapi/classPassenger_1_1MessageServer_1_1Handler-members.html +0 -39
  175. data/doc/cxxapi/classPassenger_1_1MessageServer_1_1Handler.html +0 -173
  176. data/doc/cxxapi/classPassenger_1_1Process-members.html +0 -44
  177. data/doc/cxxapi/classPassenger_1_1Process.html +0 -290
  178. data/doc/cxxapi/classPassenger_1_1RandomGenerator-members.html +0 -37
  179. data/doc/cxxapi/classPassenger_1_1RandomGenerator.html +0 -79
  180. data/doc/cxxapi/classPassenger_1_1ResourceLocator-members.html +0 -36
  181. data/doc/cxxapi/classPassenger_1_1ResourceLocator.html +0 -51
  182. data/doc/cxxapi/classPassenger_1_1RuntimeException-members.html +0 -36
  183. data/doc/cxxapi/classPassenger_1_1RuntimeException.html +0 -54
  184. data/doc/cxxapi/classPassenger_1_1SafeLibev-members.html +0 -36
  185. data/doc/cxxapi/classPassenger_1_1SafeLibev.html +0 -51
  186. data/doc/cxxapi/classPassenger_1_1ScalarMessage-members.html +0 -37
  187. data/doc/cxxapi/classPassenger_1_1ScalarMessage.html +0 -76
  188. data/doc/cxxapi/classPassenger_1_1ScgiRequestParser-members.html +0 -50
  189. data/doc/cxxapi/classPassenger_1_1ScgiRequestParser.html +0 -285
  190. data/doc/cxxapi/classPassenger_1_1SecurityException-members.html +0 -36
  191. data/doc/cxxapi/classPassenger_1_1SecurityException.html +0 -56
  192. data/doc/cxxapi/classPassenger_1_1Session-members.html +0 -53
  193. data/doc/cxxapi/classPassenger_1_1Session.html +0 -556
  194. data/doc/cxxapi/classPassenger_1_1Session__inherit__graph.map +0 -3
  195. data/doc/cxxapi/classPassenger_1_1Session__inherit__graph.md5 +0 -1
  196. data/doc/cxxapi/classPassenger_1_1Session__inherit__graph.png +0 -0
  197. data/doc/cxxapi/classPassenger_1_1SpawnException-members.html +0 -39
  198. data/doc/cxxapi/classPassenger_1_1SpawnException.html +0 -101
  199. data/doc/cxxapi/classPassenger_1_1SpawnManager-members.html +0 -42
  200. data/doc/cxxapi/classPassenger_1_1SpawnManager.html +0 -292
  201. data/doc/cxxapi/classPassenger_1_1SpawnManager__inherit__graph.map +0 -3
  202. data/doc/cxxapi/classPassenger_1_1SpawnManager__inherit__graph.md5 +0 -1
  203. data/doc/cxxapi/classPassenger_1_1SpawnManager__inherit__graph.png +0 -0
  204. data/doc/cxxapi/classPassenger_1_1StandardSession-members.html +0 -54
  205. data/doc/cxxapi/classPassenger_1_1StandardSession.html +0 -394
  206. data/doc/cxxapi/classPassenger_1_1StandardSession__inherit__graph.map +0 -3
  207. data/doc/cxxapi/classPassenger_1_1StandardSession__inherit__graph.md5 +0 -1
  208. data/doc/cxxapi/classPassenger_1_1StandardSession__inherit__graph.png +0 -0
  209. data/doc/cxxapi/classPassenger_1_1StaticString-members.html +0 -36
  210. data/doc/cxxapi/classPassenger_1_1StaticString.html +0 -56
  211. data/doc/cxxapi/classPassenger_1_1SyntaxError-members.html +0 -36
  212. data/doc/cxxapi/classPassenger_1_1SyntaxError.html +0 -54
  213. data/doc/cxxapi/classPassenger_1_1SystemException-members.html +0 -40
  214. data/doc/cxxapi/classPassenger_1_1SystemException.html +0 -155
  215. data/doc/cxxapi/classPassenger_1_1SystemException__inherit__graph.map +0 -4
  216. data/doc/cxxapi/classPassenger_1_1SystemException__inherit__graph.md5 +0 -1
  217. data/doc/cxxapi/classPassenger_1_1SystemException__inherit__graph.png +0 -0
  218. data/doc/cxxapi/classPassenger_1_1TimeRetrievalException-members.html +0 -40
  219. data/doc/cxxapi/classPassenger_1_1TimeRetrievalException.html +0 -61
  220. data/doc/cxxapi/classPassenger_1_1TimeRetrievalException__inherit__graph.map +0 -3
  221. data/doc/cxxapi/classPassenger_1_1TimeRetrievalException__inherit__graph.md5 +0 -1
  222. data/doc/cxxapi/classPassenger_1_1TimeRetrievalException__inherit__graph.png +0 -0
  223. data/doc/cxxapi/classPassenger_1_1TimeoutException-members.html +0 -36
  224. data/doc/cxxapi/classPassenger_1_1TimeoutException.html +0 -54
  225. data/doc/cxxapi/classPassenger_1_1Uint16Message-members.html +0 -36
  226. data/doc/cxxapi/classPassenger_1_1Uint16Message.html +0 -51
  227. data/doc/cxxapi/classPassenger_1_1Uint32Message-members.html +0 -36
  228. data/doc/cxxapi/classPassenger_1_1Uint32Message.html +0 -51
  229. data/doc/cxxapi/classServer-members.html +0 -36
  230. data/doc/cxxapi/classServer.html +0 -49
  231. data/doc/cxxapi/classServerInstanceDirToucher-members.html +0 -36
  232. data/doc/cxxapi/classServerInstanceDirToucher.html +0 -47
  233. data/doc/cxxapi/classes.html +0 -52
  234. data/doc/cxxapi/definitions_8h_source.html +0 -36
  235. data/doc/cxxapi/doxygen.css +0 -532
  236. data/doc/cxxapi/doxygen.png +0 -0
  237. data/doc/cxxapi/files.html +0 -76
  238. data/doc/cxxapi/ftv2blank.png +0 -0
  239. data/doc/cxxapi/ftv2doc.png +0 -0
  240. data/doc/cxxapi/ftv2folderclosed.png +0 -0
  241. data/doc/cxxapi/ftv2folderopen.png +0 -0
  242. data/doc/cxxapi/ftv2lastnode.png +0 -0
  243. data/doc/cxxapi/ftv2link.png +0 -0
  244. data/doc/cxxapi/ftv2mlastnode.png +0 -0
  245. data/doc/cxxapi/ftv2mnode.png +0 -0
  246. data/doc/cxxapi/ftv2node.png +0 -0
  247. data/doc/cxxapi/ftv2plastnode.png +0 -0
  248. data/doc/cxxapi/ftv2pnode.png +0 -0
  249. data/doc/cxxapi/ftv2vertline.png +0 -0
  250. data/doc/cxxapi/functions.html +0 -103
  251. data/doc/cxxapi/functions_0x62.html +0 -82
  252. data/doc/cxxapi/functions_0x63.html +0 -102
  253. data/doc/cxxapi/functions_0x64.html +0 -102
  254. data/doc/cxxapi/functions_0x65.html +0 -88
  255. data/doc/cxxapi/functions_0x66.html +0 -100
  256. data/doc/cxxapi/functions_0x67.html +0 -167
  257. data/doc/cxxapi/functions_0x68.html +0 -88
  258. data/doc/cxxapi/functions_0x69.html +0 -96
  259. data/doc/cxxapi/functions_0x6b.html +0 -80
  260. data/doc/cxxapi/functions_0x6c.html +0 -88
  261. data/doc/cxxapi/functions_0x6d.html +0 -88
  262. data/doc/cxxapi/functions_0x6e.html +0 -86
  263. data/doc/cxxapi/functions_0x6f.html +0 -94
  264. data/doc/cxxapi/functions_0x70.html +0 -94
  265. data/doc/cxxapi/functions_0x72.html +0 -110
  266. data/doc/cxxapi/functions_0x73.html +0 -171
  267. data/doc/cxxapi/functions_0x74.html +0 -85
  268. data/doc/cxxapi/functions_0x75.html +0 -85
  269. data/doc/cxxapi/functions_0x77.html +0 -92
  270. data/doc/cxxapi/functions_0x7e.html +0 -79
  271. data/doc/cxxapi/functions_enum.html +0 -49
  272. data/doc/cxxapi/functions_eval.html +0 -67
  273. data/doc/cxxapi/functions_func.html +0 -531
  274. data/doc/cxxapi/functions_vars.html +0 -278
  275. data/doc/cxxapi/graph_legend.dot +0 -22
  276. data/doc/cxxapi/graph_legend.html +0 -92
  277. data/doc/cxxapi/graph_legend.png +0 -0
  278. data/doc/cxxapi/group__Core.html +0 -46
  279. data/doc/cxxapi/group__Core.map +0 -3
  280. data/doc/cxxapi/group__Core.png +0 -0
  281. data/doc/cxxapi/group__Exceptions.html +0 -53
  282. data/doc/cxxapi/group__Hooks.html +0 -42
  283. data/doc/cxxapi/group__Hooks.map +0 -3
  284. data/doc/cxxapi/group__Hooks.png +0 -0
  285. data/doc/cxxapi/group__Support.html +0 -538
  286. data/doc/cxxapi/hierarchy.html +0 -101
  287. data/doc/cxxapi/index.html +0 -16
  288. data/doc/cxxapi/inherit__graph__0.map +0 -3
  289. data/doc/cxxapi/inherit__graph__0.md5 +0 -1
  290. data/doc/cxxapi/inherit__graph__0.png +0 -0
  291. data/doc/cxxapi/inherit__graph__1.map +0 -3
  292. data/doc/cxxapi/inherit__graph__1.md5 +0 -1
  293. data/doc/cxxapi/inherit__graph__1.png +0 -0
  294. data/doc/cxxapi/inherit__graph__10.map +0 -3
  295. data/doc/cxxapi/inherit__graph__10.md5 +0 -1
  296. data/doc/cxxapi/inherit__graph__10.png +0 -0
  297. data/doc/cxxapi/inherit__graph__11.map +0 -4
  298. data/doc/cxxapi/inherit__graph__11.md5 +0 -1
  299. data/doc/cxxapi/inherit__graph__11.png +0 -0
  300. data/doc/cxxapi/inherit__graph__12.map +0 -3
  301. data/doc/cxxapi/inherit__graph__12.md5 +0 -1
  302. data/doc/cxxapi/inherit__graph__12.png +0 -0
  303. data/doc/cxxapi/inherit__graph__13.map +0 -3
  304. data/doc/cxxapi/inherit__graph__13.md5 +0 -1
  305. data/doc/cxxapi/inherit__graph__13.png +0 -0
  306. data/doc/cxxapi/inherit__graph__14.map +0 -3
  307. data/doc/cxxapi/inherit__graph__14.md5 +0 -1
  308. data/doc/cxxapi/inherit__graph__14.png +0 -0
  309. data/doc/cxxapi/inherit__graph__15.map +0 -3
  310. data/doc/cxxapi/inherit__graph__15.md5 +0 -1
  311. data/doc/cxxapi/inherit__graph__15.png +0 -0
  312. data/doc/cxxapi/inherit__graph__16.map +0 -5
  313. data/doc/cxxapi/inherit__graph__16.md5 +0 -1
  314. data/doc/cxxapi/inherit__graph__16.png +0 -0
  315. data/doc/cxxapi/inherit__graph__17.map +0 -3
  316. data/doc/cxxapi/inherit__graph__17.md5 +0 -1
  317. data/doc/cxxapi/inherit__graph__17.png +0 -0
  318. data/doc/cxxapi/inherit__graph__18.map +0 -3
  319. data/doc/cxxapi/inherit__graph__18.md5 +0 -1
  320. data/doc/cxxapi/inherit__graph__18.png +0 -0
  321. data/doc/cxxapi/inherit__graph__19.map +0 -4
  322. data/doc/cxxapi/inherit__graph__19.md5 +0 -1
  323. data/doc/cxxapi/inherit__graph__19.png +0 -0
  324. data/doc/cxxapi/inherit__graph__2.map +0 -3
  325. data/doc/cxxapi/inherit__graph__2.md5 +0 -1
  326. data/doc/cxxapi/inherit__graph__2.png +0 -0
  327. data/doc/cxxapi/inherit__graph__20.map +0 -3
  328. data/doc/cxxapi/inherit__graph__20.md5 +0 -1
  329. data/doc/cxxapi/inherit__graph__20.png +0 -0
  330. data/doc/cxxapi/inherit__graph__21.map +0 -3
  331. data/doc/cxxapi/inherit__graph__21.md5 +0 -1
  332. data/doc/cxxapi/inherit__graph__21.png +0 -0
  333. data/doc/cxxapi/inherit__graph__22.map +0 -3
  334. data/doc/cxxapi/inherit__graph__22.md5 +0 -1
  335. data/doc/cxxapi/inherit__graph__22.png +0 -0
  336. data/doc/cxxapi/inherit__graph__23.map +0 -3
  337. data/doc/cxxapi/inherit__graph__23.md5 +0 -1
  338. data/doc/cxxapi/inherit__graph__23.png +0 -0
  339. data/doc/cxxapi/inherit__graph__24.map +0 -3
  340. data/doc/cxxapi/inherit__graph__24.md5 +0 -1
  341. data/doc/cxxapi/inherit__graph__24.png +0 -0
  342. data/doc/cxxapi/inherit__graph__25.map +0 -3
  343. data/doc/cxxapi/inherit__graph__25.md5 +0 -1
  344. data/doc/cxxapi/inherit__graph__25.png +0 -0
  345. data/doc/cxxapi/inherit__graph__26.map +0 -3
  346. data/doc/cxxapi/inherit__graph__26.md5 +0 -1
  347. data/doc/cxxapi/inherit__graph__26.png +0 -0
  348. data/doc/cxxapi/inherit__graph__27.map +0 -3
  349. data/doc/cxxapi/inherit__graph__27.md5 +0 -1
  350. data/doc/cxxapi/inherit__graph__27.png +0 -0
  351. data/doc/cxxapi/inherit__graph__28.map +0 -3
  352. data/doc/cxxapi/inherit__graph__28.md5 +0 -1
  353. data/doc/cxxapi/inherit__graph__28.png +0 -0
  354. data/doc/cxxapi/inherit__graph__29.map +0 -3
  355. data/doc/cxxapi/inherit__graph__29.md5 +0 -1
  356. data/doc/cxxapi/inherit__graph__29.png +0 -0
  357. data/doc/cxxapi/inherit__graph__3.map +0 -4
  358. data/doc/cxxapi/inherit__graph__3.md5 +0 -1
  359. data/doc/cxxapi/inherit__graph__3.png +0 -0
  360. data/doc/cxxapi/inherit__graph__30.map +0 -3
  361. data/doc/cxxapi/inherit__graph__30.md5 +0 -1
  362. data/doc/cxxapi/inherit__graph__30.png +0 -0
  363. data/doc/cxxapi/inherit__graph__31.map +0 -4
  364. data/doc/cxxapi/inherit__graph__31.md5 +0 -1
  365. data/doc/cxxapi/inherit__graph__31.png +0 -0
  366. data/doc/cxxapi/inherit__graph__32.map +0 -3
  367. data/doc/cxxapi/inherit__graph__32.md5 +0 -1
  368. data/doc/cxxapi/inherit__graph__32.png +0 -0
  369. data/doc/cxxapi/inherit__graph__33.map +0 -3
  370. data/doc/cxxapi/inherit__graph__33.md5 +0 -1
  371. data/doc/cxxapi/inherit__graph__33.png +0 -0
  372. data/doc/cxxapi/inherit__graph__34.map +0 -3
  373. data/doc/cxxapi/inherit__graph__34.md5 +0 -1
  374. data/doc/cxxapi/inherit__graph__34.png +0 -0
  375. data/doc/cxxapi/inherit__graph__35.map +0 -3
  376. data/doc/cxxapi/inherit__graph__35.md5 +0 -1
  377. data/doc/cxxapi/inherit__graph__35.png +0 -0
  378. data/doc/cxxapi/inherit__graph__36.map +0 -5
  379. data/doc/cxxapi/inherit__graph__36.md5 +0 -1
  380. data/doc/cxxapi/inherit__graph__36.png +0 -0
  381. data/doc/cxxapi/inherit__graph__37.map +0 -3
  382. data/doc/cxxapi/inherit__graph__37.md5 +0 -1
  383. data/doc/cxxapi/inherit__graph__37.png +0 -0
  384. data/doc/cxxapi/inherit__graph__38.map +0 -3
  385. data/doc/cxxapi/inherit__graph__38.md5 +0 -1
  386. data/doc/cxxapi/inherit__graph__38.png +0 -0
  387. data/doc/cxxapi/inherit__graph__39.map +0 -3
  388. data/doc/cxxapi/inherit__graph__39.md5 +0 -1
  389. data/doc/cxxapi/inherit__graph__39.png +0 -0
  390. data/doc/cxxapi/inherit__graph__4.map +0 -3
  391. data/doc/cxxapi/inherit__graph__4.md5 +0 -1
  392. data/doc/cxxapi/inherit__graph__4.png +0 -0
  393. data/doc/cxxapi/inherit__graph__40.map +0 -3
  394. data/doc/cxxapi/inherit__graph__40.md5 +0 -1
  395. data/doc/cxxapi/inherit__graph__40.png +0 -0
  396. data/doc/cxxapi/inherit__graph__41.map +0 -3
  397. data/doc/cxxapi/inherit__graph__41.md5 +0 -1
  398. data/doc/cxxapi/inherit__graph__41.png +0 -0
  399. data/doc/cxxapi/inherit__graph__5.map +0 -3
  400. data/doc/cxxapi/inherit__graph__5.md5 +0 -1
  401. data/doc/cxxapi/inherit__graph__5.png +0 -0
  402. data/doc/cxxapi/inherit__graph__6.map +0 -3
  403. data/doc/cxxapi/inherit__graph__6.md5 +0 -1
  404. data/doc/cxxapi/inherit__graph__6.png +0 -0
  405. data/doc/cxxapi/inherit__graph__7.map +0 -3
  406. data/doc/cxxapi/inherit__graph__7.md5 +0 -1
  407. data/doc/cxxapi/inherit__graph__7.png +0 -0
  408. data/doc/cxxapi/inherit__graph__8.map +0 -3
  409. data/doc/cxxapi/inherit__graph__8.md5 +0 -1
  410. data/doc/cxxapi/inherit__graph__8.png +0 -0
  411. data/doc/cxxapi/inherit__graph__9.map +0 -3
  412. data/doc/cxxapi/inherit__graph__9.md5 +0 -1
  413. data/doc/cxxapi/inherit__graph__9.png +0 -0
  414. data/doc/cxxapi/inherits.html +0 -165
  415. data/doc/cxxapi/main.html +0 -28
  416. data/doc/cxxapi/modules.html +0 -36
  417. data/doc/cxxapi/namespacePassenger.html +0 -585
  418. data/doc/cxxapi/namespacemembers.html +0 -190
  419. data/doc/cxxapi/namespacemembers_enum.html +0 -48
  420. data/doc/cxxapi/namespacemembers_eval.html +0 -57
  421. data/doc/cxxapi/namespacemembers_func.html +0 -114
  422. data/doc/cxxapi/namespacemembers_type.html +0 -54
  423. data/doc/cxxapi/namespaces.html +0 -37
  424. data/doc/cxxapi/nginx_2Configuration_8h_source.html +0 -126
  425. data/doc/cxxapi/ngx__http__passenger__module_8h_source.html +0 -95
  426. data/doc/cxxapi/structPassenger_1_1MessageServer_1_1DisconnectEventBroadcastGuard-members.html +0 -36
  427. data/doc/cxxapi/structPassenger_1_1MessageServer_1_1DisconnectEventBroadcastGuard.html +0 -51
  428. data/doc/cxxapi/structPassenger_1_1PoolOptions-members.html +0 -67
  429. data/doc/cxxapi/structPassenger_1_1PoolOptions.html +0 -647
  430. data/doc/cxxapi/structPassenger_1_1StaticString_1_1Hash-members.html +0 -36
  431. data/doc/cxxapi/structPassenger_1_1StaticString_1_1Hash.html +0 -51
  432. data/doc/cxxapi/tab_b.gif +0 -0
  433. data/doc/cxxapi/tab_l.gif +0 -0
  434. data/doc/cxxapi/tab_r.gif +0 -0
  435. data/doc/cxxapi/tabs.css +0 -105
  436. data/doc/cxxapi/tree.html +0 -249
  437. data/doc/template/horo.rb +0 -613
  438. data/ext/libev/config.h +0 -122
  439. data/ext/nginx/HttpStatusExtractor.h +0 -351
data/doc/cxxapi/classPassenger_1_1IOException-members.html DELETED
@@ -1,36 +0,0 @@
1
- <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
2
- <html xmlns="http://www.w3.org/1999/xhtml">
3
- <head>
4
- <meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
5
- <title>Passenger: Member List</title>
6
- <link href="tabs.css" rel="stylesheet" type="text/css"/>
7
- <link href="doxygen.css" rel="stylesheet" type="text/css"/>
8
- </head>
9
- <body>
10
- <!-- Generated by Doxygen 1.6.2 -->
11
- <div class="navigation" id="top">
12
- <div class="tabs">
13
- <ul>
14
- <li><a href="main.html"><span>Main&nbsp;Page</span></a></li>
15
- <li><a href="modules.html"><span>Modules</span></a></li>
16
- <li><a href="namespaces.html"><span>Namespaces</span></a></li>
17
- <li class="current"><a href="annotated.html"><span>Classes</span></a></li>
18
- <li><a href="files.html"><span>Files</span></a></li>
19
- </ul>
20
- </div>
21
- <div class="tabs">
22
- <ul>
23
- <li><a href="annotated.html"><span>Class&nbsp;List</span></a></li>
24
- <li><a href="hierarchy.html"><span>Class&nbsp;Hierarchy</span></a></li>
25
- <li><a href="functions.html"><span>Class&nbsp;Members</span></a></li>
26
- </ul>
27
- </div>
28
- </div>
29
- <div class="contents">
30
- <h1>Passenger::IOException Member List</h1>This is the complete list of members for <a class="el" href="classPassenger_1_1IOException.html">Passenger::IOException</a>, including all inherited members.<table>
31
- </table></div>
32
- <hr size="1"/><address style="text-align: right;"><small>Generated by&nbsp;
33
- <a href="http://www.doxygen.org/index.html">
34
- <img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.6.2 </small></address>
35
- </body>
36
- </html>
data/doc/cxxapi/classPassenger_1_1IOException.html DELETED
@@ -1,61 +0,0 @@
1
- <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
2
- <html xmlns="http://www.w3.org/1999/xhtml">
3
- <head>
4
- <meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
5
- <title>Passenger: Passenger::IOException Class Reference</title>
6
- <link href="tabs.css" rel="stylesheet" type="text/css"/>
7
- <link href="doxygen.css" rel="stylesheet" type="text/css"/>
8
- </head>
9
- <body>
10
- <!-- Generated by Doxygen 1.6.2 -->
11
- <div class="navigation" id="top">
12
- <div class="tabs">
13
- <ul>
14
- <li><a href="main.html"><span>Main&nbsp;Page</span></a></li>
15
- <li><a href="modules.html"><span>Modules</span></a></li>
16
- <li><a href="namespaces.html"><span>Namespaces</span></a></li>
17
- <li class="current"><a href="annotated.html"><span>Classes</span></a></li>
18
- <li><a href="files.html"><span>Files</span></a></li>
19
- </ul>
20
- </div>
21
- <div class="tabs">
22
- <ul>
23
- <li><a href="annotated.html"><span>Class&nbsp;List</span></a></li>
24
- <li><a href="hierarchy.html"><span>Class&nbsp;Hierarchy</span></a></li>
25
- <li><a href="functions.html"><span>Class&nbsp;Members</span></a></li>
26
- </ul>
27
- </div>
28
- <div class="navpath"><a class="el" href="namespacePassenger.html">Passenger</a>::<a class="el" href="classPassenger_1_1IOException.html">IOException</a>
29
- </div>
30
- </div>
31
- <div class="contents">
32
- <h1>Passenger::IOException Class Reference<br/>
33
- <small>
34
- [<a class="el" href="group__Exceptions.html">Exceptions</a>]</small>
35
- </h1><!-- doxytag: class="Passenger::IOException" -->
36
- <p>Represents an error that occured during an I/O operation.
37
- <a href="#_details">More...</a></p>
38
-
39
- <p><code>#include &lt;<a class="el" href="Exceptions_8h_source.html">Exceptions.h</a>&gt;</code></p>
40
- <div class="dynheader">
41
- Inheritance diagram for Passenger::IOException:</div>
42
- <div class="dynsection">
43
- <div class="center"><img src="classPassenger_1_1IOException__inherit__graph.png" border="0" usemap="#Passenger_1_1IOException_inherit__map" alt="Inheritance graph"/></div>
44
- <map name="Passenger_1_1IOException_inherit__map" id="Passenger_1_1IOException_inherit__map">
45
- <area shape="rect" id="node3" href="classPassenger_1_1EOFException.html" title="An unexpected end&#45;of&#45;file I/O error." alt="" coords="5,83,189,112"/><area shape="rect" id="node5" href="classPassenger_1_1FileNotFoundException.html" title="Thrown when a certain file cannot be found." alt="" coords="213,83,453,112"/></map>
46
- <center><span class="legend">[<a target="top" href="graph_legend.html">legend</a>]</span></center></div>
47
-
48
- <p><a href="classPassenger_1_1IOException-members.html">List of all members.</a></p>
49
- <table border="0" cellpadding="0" cellspacing="0">
50
- </table>
51
- <hr/><a name="_details"></a><h2>Detailed Description</h2>
52
- <p>Represents an error that occured during an I/O operation. </p>
53
- <hr/>The documentation for this class was generated from the following file:<ul>
54
- <li><a class="el" href="Exceptions_8h_source.html">Exceptions.h</a></li>
55
- </ul>
56
- </div>
57
- <hr size="1"/><address style="text-align: right;"><small>Generated by&nbsp;
58
- <a href="http://www.doxygen.org/index.html">
59
- <img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.6.2 </small></address>
60
- </body>
61
- </html>
data/doc/cxxapi/classPassenger_1_1IOException__inherit__graph.map DELETED
@@ -1,4 +0,0 @@
1
- <map id="G" name="G">
2
- <area shape="rect" id="node3" href="$classPassenger_1_1EOFException.html" title="An unexpected end&#45;of&#45;file I/O error." alt="" coords="5,83,189,112"/>
3
- <area shape="rect" id="node5" href="$classPassenger_1_1FileNotFoundException.html" title="Thrown when a certain file cannot be found." alt="" coords="213,83,453,112"/>
4
- </map>
data/doc/cxxapi/classPassenger_1_1IOException__inherit__graph.md5 DELETED
@@ -1 +0,0 @@
1
- f3ec4ae49cbd78fe1ed4bbe04443cd9c
data/doc/cxxapi/classPassenger_1_1MessageChannel-members.html DELETED
@@ -1,57 +0,0 @@
1
- <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
2
- <html xmlns="http://www.w3.org/1999/xhtml">
3
- <head>
4
- <meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
5
- <title>Passenger: Member List</title>
6
- <link href="tabs.css" rel="stylesheet" type="text/css"/>
7
- <link href="doxygen.css" rel="stylesheet" type="text/css"/>
8
- </head>
9
- <body>
10
- <!-- Generated by Doxygen 1.6.2 -->
11
- <div class="navigation" id="top">
12
- <div class="tabs">
13
- <ul>
14
- <li><a href="main.html"><span>Main&nbsp;Page</span></a></li>
15
- <li><a href="modules.html"><span>Modules</span></a></li>
16
- <li><a href="namespaces.html"><span>Namespaces</span></a></li>
17
- <li class="current"><a href="annotated.html"><span>Classes</span></a></li>
18
- <li><a href="files.html"><span>Files</span></a></li>
19
- </ul>
20
- </div>
21
- <div class="tabs">
22
- <ul>
23
- <li><a href="annotated.html"><span>Class&nbsp;List</span></a></li>
24
- <li><a href="hierarchy.html"><span>Class&nbsp;Hierarchy</span></a></li>
25
- <li><a href="functions.html"><span>Class&nbsp;Members</span></a></li>
26
- </ul>
27
- </div>
28
- </div>
29
- <div class="contents">
30
- <h1>Passenger::MessageChannel Member List</h1>This is the complete list of members for <a class="el" href="classPassenger_1_1MessageChannel.html">Passenger::MessageChannel</a>, including all inherited members.<table>
31
- <tr class="memlist"><td><a class="el" href="classPassenger_1_1MessageChannel.html#a06309e208fc5e10642a2e9bbe0f351eb">close</a>()</td><td><a class="el" href="classPassenger_1_1MessageChannel.html">Passenger::MessageChannel</a></td><td><code> [inline]</code></td></tr>
32
- <tr class="memlist"><td><a class="el" href="classPassenger_1_1MessageChannel.html#aa5ee9617bb17bdeaba30b757ecffa1b5">connected</a>() const </td><td><a class="el" href="classPassenger_1_1MessageChannel.html">Passenger::MessageChannel</a></td><td><code> [inline]</code></td></tr>
33
- <tr class="memlist"><td><a class="el" href="classPassenger_1_1MessageChannel.html#a0b1e25dd75783d9753f8a0d1dd42606a">filenum</a>() const </td><td><a class="el" href="classPassenger_1_1MessageChannel.html">Passenger::MessageChannel</a></td><td><code> [inline]</code></td></tr>
34
- <tr class="memlist"><td><a class="el" href="classPassenger_1_1MessageChannel.html#a73e7c9a8e421d29558838176aff02ca4">MessageChannel</a>()</td><td><a class="el" href="classPassenger_1_1MessageChannel.html">Passenger::MessageChannel</a></td><td><code> [inline]</code></td></tr>
35
- <tr class="memlist"><td><a class="el" href="classPassenger_1_1MessageChannel.html#a486b6e74c4d0973eefbcfde65f898ca7">MessageChannel</a>(int fd)</td><td><a class="el" href="classPassenger_1_1MessageChannel.html">Passenger::MessageChannel</a></td><td><code> [inline]</code></td></tr>
36
- <tr class="memlist"><td><a class="el" href="classPassenger_1_1MessageChannel.html#a129659b60d1a663337873d2af944431e">read</a>(vector&lt; string &gt; &amp;args)</td><td><a class="el" href="classPassenger_1_1MessageChannel.html">Passenger::MessageChannel</a></td><td><code> [inline]</code></td></tr>
37
- <tr class="memlist"><td><a class="el" href="classPassenger_1_1MessageChannel.html#a1a28ba9d078f38f2831673092ac9dcbc">readFileDescriptor</a>(bool negotiate=true)</td><td><a class="el" href="classPassenger_1_1MessageChannel.html">Passenger::MessageChannel</a></td><td><code> [inline]</code></td></tr>
38
- <tr class="memlist"><td><a class="el" href="classPassenger_1_1MessageChannel.html#ab471dc1888f030e20ed23068a160ec2a">readRaw</a>(void *buf, unsigned int size, unsigned long long *timeout=NULL)</td><td><a class="el" href="classPassenger_1_1MessageChannel.html">Passenger::MessageChannel</a></td><td><code> [inline]</code></td></tr>
39
- <tr class="memlist"><td><a class="el" href="classPassenger_1_1MessageChannel.html#a1f3cf672b566166ed920c2bba4d19604">readScalar</a>(string &amp;output, unsigned int maxSize=0, unsigned long long *timeout=NULL)</td><td><a class="el" href="classPassenger_1_1MessageChannel.html">Passenger::MessageChannel</a></td><td><code> [inline]</code></td></tr>
40
- <tr class="memlist"><td><a class="el" href="classPassenger_1_1MessageChannel.html#a7b0c67852ea8ab455af75b1037c7f8b6">readUint32</a>(unsigned int &amp;value, unsigned long long *timeout=NULL)</td><td><a class="el" href="classPassenger_1_1MessageChannel.html">Passenger::MessageChannel</a></td><td><code> [inline]</code></td></tr>
41
- <tr class="memlist"><td><a class="el" href="classPassenger_1_1MessageChannel.html#aeb69bffbbb148c9bc8662e20b416c4e2">setReadTimeout</a>(unsigned int msec)</td><td><a class="el" href="classPassenger_1_1MessageChannel.html">Passenger::MessageChannel</a></td><td><code> [inline]</code></td></tr>
42
- <tr class="memlist"><td><a class="el" href="classPassenger_1_1MessageChannel.html#a77c5d7c47f387cf43992ebeb14e3c6c7">setWriteTimeout</a>(unsigned int msec)</td><td><a class="el" href="classPassenger_1_1MessageChannel.html">Passenger::MessageChannel</a></td><td><code> [inline]</code></td></tr>
43
- <tr class="memlist"><td><a class="el" href="classPassenger_1_1MessageChannel.html#a150f68bc47e060dcc6ca35bee047914d">write</a>(const StringArrayType &amp;args)</td><td><a class="el" href="classPassenger_1_1MessageChannel.html">Passenger::MessageChannel</a></td><td><code> [inline]</code></td></tr>
44
- <tr class="memlist"><td><a class="el" href="classPassenger_1_1MessageChannel.html#a9ad7a978cf8409e01ab2f0a2b6be5a0a">write</a>(const list&lt; string &gt; &amp;args)</td><td><a class="el" href="classPassenger_1_1MessageChannel.html">Passenger::MessageChannel</a></td><td><code> [inline]</code></td></tr>
45
- <tr class="memlist"><td><a class="el" href="classPassenger_1_1MessageChannel.html#a6a9bc5d72715cb7ba0e437c8851ef487">write</a>(const vector&lt; string &gt; &amp;args)</td><td><a class="el" href="classPassenger_1_1MessageChannel.html">Passenger::MessageChannel</a></td><td><code> [inline]</code></td></tr>
46
- <tr class="memlist"><td><a class="el" href="classPassenger_1_1MessageChannel.html#a70cc924c1ce7e2cedcbab61155d3aec9">write</a>(const char *name, va_list &amp;ap)</td><td><a class="el" href="classPassenger_1_1MessageChannel.html">Passenger::MessageChannel</a></td><td><code> [inline]</code></td></tr>
47
- <tr class="memlist"><td><a class="el" href="classPassenger_1_1MessageChannel.html#a12cce3364023eacbe4fe09006cf3d38d">write</a>(const char *name,...)</td><td><a class="el" href="classPassenger_1_1MessageChannel.html">Passenger::MessageChannel</a></td><td><code> [inline]</code></td></tr>
48
- <tr class="memlist"><td><a class="el" href="classPassenger_1_1MessageChannel.html#ae0c558e07dcc91900016773b2bec38d8">writeFileDescriptor</a>(int fileDescriptor, bool negotiate=true)</td><td><a class="el" href="classPassenger_1_1MessageChannel.html">Passenger::MessageChannel</a></td><td><code> [inline]</code></td></tr>
49
- <tr class="memlist"><td><a class="el" href="classPassenger_1_1MessageChannel.html#a44e01a783c48abadeea0d915b9893bfb">writeScalar</a>(const string &amp;str)</td><td><a class="el" href="classPassenger_1_1MessageChannel.html">Passenger::MessageChannel</a></td><td><code> [inline]</code></td></tr>
50
- <tr class="memlist"><td><a class="el" href="classPassenger_1_1MessageChannel.html#a80977020ef895f3ea790c5d28a333dda">writeScalar</a>(const char *data, unsigned int size)</td><td><a class="el" href="classPassenger_1_1MessageChannel.html">Passenger::MessageChannel</a></td><td><code> [inline]</code></td></tr>
51
- <tr class="memlist"><td><a class="el" href="classPassenger_1_1MessageChannel.html#abf02c51a74477650de8d5d5db661063b">writeUint32</a>(unsigned int value)</td><td><a class="el" href="classPassenger_1_1MessageChannel.html">Passenger::MessageChannel</a></td><td><code> [inline]</code></td></tr>
52
- </table></div>
53
- <hr size="1"/><address style="text-align: right;"><small>Generated by&nbsp;
54
- <a href="http://www.doxygen.org/index.html">
55
- <img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.6.2 </small></address>
56
- </body>
57
- </html>
data/doc/cxxapi/classPassenger_1_1MessageChannel.html DELETED
@@ -1,839 +0,0 @@
1
- <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
2
- <html xmlns="http://www.w3.org/1999/xhtml">
3
- <head>
4
- <meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
5
- <title>Passenger: Passenger::MessageChannel Class Reference</title>
6
- <link href="tabs.css" rel="stylesheet" type="text/css"/>
7
- <link href="doxygen.css" rel="stylesheet" type="text/css"/>
8
- </head>
9
- <body>
10
- <!-- Generated by Doxygen 1.6.2 -->
11
- <div class="navigation" id="top">
12
- <div class="tabs">
13
- <ul>
14
- <li><a href="main.html"><span>Main&nbsp;Page</span></a></li>
15
- <li><a href="modules.html"><span>Modules</span></a></li>
16
- <li><a href="namespaces.html"><span>Namespaces</span></a></li>
17
- <li class="current"><a href="annotated.html"><span>Classes</span></a></li>
18
- <li><a href="files.html"><span>Files</span></a></li>
19
- </ul>
20
- </div>
21
- <div class="tabs">
22
- <ul>
23
- <li><a href="annotated.html"><span>Class&nbsp;List</span></a></li>
24
- <li><a href="hierarchy.html"><span>Class&nbsp;Hierarchy</span></a></li>
25
- <li><a href="functions.html"><span>Class&nbsp;Members</span></a></li>
26
- </ul>
27
- </div>
28
- <div class="navpath"><a class="el" href="namespacePassenger.html">Passenger</a>::<a class="el" href="classPassenger_1_1MessageChannel.html">MessageChannel</a>
29
- </div>
30
- </div>
31
- <div class="contents">
32
- <h1>Passenger::MessageChannel Class Reference<br/>
33
- <small>
34
- [<a class="el" href="group__Support.html">Apache-independent support classes and function</a>]</small>
35
- </h1><!-- doxytag: class="Passenger::MessageChannel" -->
36
- <p>Convenience class for I/O operations on file descriptors.
37
- <a href="#_details">More...</a></p>
38
-
39
- <p><code>#include &lt;<a class="el" href="MessageChannel_8h_source.html">MessageChannel.h</a>&gt;</code></p>
40
-
41
- <p><a href="classPassenger_1_1MessageChannel-members.html">List of all members.</a></p>
42
- <table border="0" cellpadding="0" cellspacing="0">
43
- <tr><td colspan="2"><h2>Public Member Functions</h2></td></tr>
44
- <tr><td class="memItemLeft" align="right" valign="top">&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPassenger_1_1MessageChannel.html#a73e7c9a8e421d29558838176aff02ca4">MessageChannel</a> ()</td></tr>
45
- <tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Construct a new <a class="el" href="classPassenger_1_1MessageChannel.html" title="Convenience class for I/O operations on file descriptors.">MessageChannel</a> with no underlying file descriptor. <a href="#a73e7c9a8e421d29558838176aff02ca4"></a><br/></td></tr>
46
- <tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a486b6e74c4d0973eefbcfde65f898ca7"></a><!-- doxytag: member="Passenger::MessageChannel::MessageChannel" ref="a486b6e74c4d0973eefbcfde65f898ca7" args="(int fd)" -->
47
- &nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPassenger_1_1MessageChannel.html#a486b6e74c4d0973eefbcfde65f898ca7">MessageChannel</a> (int fd)</td></tr>
48
- <tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Construct a new <a class="el" href="classPassenger_1_1MessageChannel.html" title="Convenience class for I/O operations on file descriptors.">MessageChannel</a> with the given file descriptor. <br/></td></tr>
49
- <tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPassenger_1_1MessageChannel.html#a0b1e25dd75783d9753f8a0d1dd42606a">filenum</a> () const </td></tr>
50
- <tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Returns the underlying file descriptor. <a href="#a0b1e25dd75783d9753f8a0d1dd42606a"></a><br/></td></tr>
51
- <tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="aa5ee9617bb17bdeaba30b757ecffa1b5"></a><!-- doxytag: member="Passenger::MessageChannel::connected" ref="aa5ee9617bb17bdeaba30b757ecffa1b5" args="() const " -->
52
- bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPassenger_1_1MessageChannel.html#aa5ee9617bb17bdeaba30b757ecffa1b5">connected</a> () const </td></tr>
53
- <tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Returns whether <a class="el" href="classPassenger_1_1MessageChannel.html#a06309e208fc5e10642a2e9bbe0f351eb" title="Close the underlying file descriptor.">close()</a> has been called. <br/></td></tr>
54
- <tr><td class="memItemLeft" align="right" valign="top">void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPassenger_1_1MessageChannel.html#a06309e208fc5e10642a2e9bbe0f351eb">close</a> ()</td></tr>
55
- <tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Close the underlying file descriptor. <a href="#a06309e208fc5e10642a2e9bbe0f351eb"></a><br/></td></tr>
56
- <tr><td class="memTemplParams" colspan="2">template&lt;typename StringArrayType , typename StringArrayConstIteratorType &gt; </td></tr>
57
- <tr><td class="memTemplItemLeft" align="right" valign="top">void&nbsp;</td><td class="memTemplItemRight" valign="bottom"><a class="el" href="classPassenger_1_1MessageChannel.html#a150f68bc47e060dcc6ca35bee047914d">write</a> (const StringArrayType &amp;args)</td></tr>
58
- <tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Send an array message, which consists of the given elements, over the underlying file descriptor. <a href="#a150f68bc47e060dcc6ca35bee047914d"></a><br/></td></tr>
59
- <tr><td class="memItemLeft" align="right" valign="top">void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPassenger_1_1MessageChannel.html#a9ad7a978cf8409e01ab2f0a2b6be5a0a">write</a> (const list&lt; string &gt; &amp;args)</td></tr>
60
- <tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Send an array message, which consists of the given elements, over the underlying file descriptor. <a href="#a9ad7a978cf8409e01ab2f0a2b6be5a0a"></a><br/></td></tr>
61
- <tr><td class="memItemLeft" align="right" valign="top">void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPassenger_1_1MessageChannel.html#a6a9bc5d72715cb7ba0e437c8851ef487">write</a> (const vector&lt; string &gt; &amp;args)</td></tr>
62
- <tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Send an array message, which consists of the given elements, over the underlying file descriptor. <a href="#a6a9bc5d72715cb7ba0e437c8851ef487"></a><br/></td></tr>
63
- <tr><td class="memItemLeft" align="right" valign="top">void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPassenger_1_1MessageChannel.html#a70cc924c1ce7e2cedcbab61155d3aec9">write</a> (const char *name, va_list &amp;ap)</td></tr>
64
- <tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Send an array message, which consists of the given strings, over the underlying file descriptor. <a href="#a70cc924c1ce7e2cedcbab61155d3aec9"></a><br/></td></tr>
65
- <tr><td class="memItemLeft" align="right" valign="top">void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPassenger_1_1MessageChannel.html#a12cce3364023eacbe4fe09006cf3d38d">write</a> (const char *name,...)</td></tr>
66
- <tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Send an array message, which consists of the given strings, over the underlying file descriptor. <a href="#a12cce3364023eacbe4fe09006cf3d38d"></a><br/></td></tr>
67
- <tr><td class="memItemLeft" align="right" valign="top">void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPassenger_1_1MessageChannel.html#abf02c51a74477650de8d5d5db661063b">writeUint32</a> (unsigned int value)</td></tr>
68
- <tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Write a 32-bit big-endian unsigned integer to the underlying file descriptor. <a href="#abf02c51a74477650de8d5d5db661063b"></a><br/></td></tr>
69
- <tr><td class="memItemLeft" align="right" valign="top">void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPassenger_1_1MessageChannel.html#a44e01a783c48abadeea0d915b9893bfb">writeScalar</a> (const string &amp;str)</td></tr>
70
- <tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Write a scalar message to the underlying file descriptor. <a href="#a44e01a783c48abadeea0d915b9893bfb"></a><br/></td></tr>
71
- <tr><td class="memItemLeft" align="right" valign="top">void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPassenger_1_1MessageChannel.html#a80977020ef895f3ea790c5d28a333dda">writeScalar</a> (const char *data, unsigned int size)</td></tr>
72
- <tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Write a scalar message to the underlying file descriptor. <a href="#a80977020ef895f3ea790c5d28a333dda"></a><br/></td></tr>
73
- <tr><td class="memItemLeft" align="right" valign="top">void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPassenger_1_1MessageChannel.html#ae0c558e07dcc91900016773b2bec38d8">writeFileDescriptor</a> (int fileDescriptor, bool negotiate=true)</td></tr>
74
- <tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Pass a file descriptor. <a href="#ae0c558e07dcc91900016773b2bec38d8"></a><br/></td></tr>
75
- <tr><td class="memItemLeft" align="right" valign="top">bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPassenger_1_1MessageChannel.html#a129659b60d1a663337873d2af944431e">read</a> (vector&lt; string &gt; &amp;args)</td></tr>
76
- <tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Read an array message from the underlying file descriptor. <a href="#a129659b60d1a663337873d2af944431e"></a><br/></td></tr>
77
- <tr><td class="memItemLeft" align="right" valign="top">bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPassenger_1_1MessageChannel.html#a7b0c67852ea8ab455af75b1037c7f8b6">readUint32</a> (unsigned int &amp;value, unsigned long long *timeout=NULL)</td></tr>
78
- <tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Read a 32-bit big-endian unsigned integer from the underlying file descriptor. <a href="#a7b0c67852ea8ab455af75b1037c7f8b6"></a><br/></td></tr>
79
- <tr><td class="memItemLeft" align="right" valign="top">bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPassenger_1_1MessageChannel.html#a1f3cf672b566166ed920c2bba4d19604">readScalar</a> (string &amp;output, unsigned int maxSize=0, unsigned long long *timeout=NULL)</td></tr>
80
- <tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Read a scalar message from the underlying file descriptor. <a href="#a1f3cf672b566166ed920c2bba4d19604"></a><br/></td></tr>
81
- <tr><td class="memItemLeft" align="right" valign="top">bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPassenger_1_1MessageChannel.html#ab471dc1888f030e20ed23068a160ec2a">readRaw</a> (void *buf, unsigned int size, unsigned long long *timeout=NULL)</td></tr>
82
- <tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Read exactly <code>size</code> bytes of data from the underlying file descriptor, and put the result in <code>buf</code>. <a href="#ab471dc1888f030e20ed23068a160ec2a"></a><br/></td></tr>
83
- <tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPassenger_1_1MessageChannel.html#a1a28ba9d078f38f2831673092ac9dcbc">readFileDescriptor</a> (bool negotiate=true)</td></tr>
84
- <tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Receive a file descriptor, which had been passed over the underlying file descriptor. <a href="#a1a28ba9d078f38f2831673092ac9dcbc"></a><br/></td></tr>
85
- <tr><td class="memItemLeft" align="right" valign="top">void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPassenger_1_1MessageChannel.html#aeb69bffbbb148c9bc8662e20b416c4e2">setReadTimeout</a> (unsigned int msec)</td></tr>
86
- <tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Set the timeout value for reading data from this channel. <a href="#aeb69bffbbb148c9bc8662e20b416c4e2"></a><br/></td></tr>
87
- <tr><td class="memItemLeft" align="right" valign="top">void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPassenger_1_1MessageChannel.html#a77c5d7c47f387cf43992ebeb14e3c6c7">setWriteTimeout</a> (unsigned int msec)</td></tr>
88
- <tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Set the timeout value for writing data to this channel. <a href="#a77c5d7c47f387cf43992ebeb14e3c6c7"></a><br/></td></tr>
89
- </table>
90
- <hr/><a name="_details"></a><h2>Detailed Description</h2>
91
- <p>Convenience class for I/O operations on file descriptors. </p>
92
- <p>This class provides convenience methods for:</p>
93
- <ul>
94
- <li>sending and receiving raw data over a file descriptor.</li>
95
- <li>sending and receiving messages over a file descriptor.</li>
96
- <li>file descriptor passing over a Unix socket.</li>
97
- <li>data size limit enforcement and time constraint enforcement. All of these methods use exceptions for error reporting.</li>
98
- </ul>
99
- <p>There are two kinds of messages:</p>
100
- <ul>
101
- <li>Array messages. These are just a list of strings, and the message itself has a specific length. The contained strings may not contain NUL characters (<code>'\0'</code>). Note that an array message must have at least one element.</li>
102
- <li>Scalar messages. These are byte strings which may contain arbitrary binary data. Scalar messages also have a specific length. The protocol is designed to be low overhead, easy to implement and easy to parse.</li>
103
- </ul>
104
- <p><a class="el" href="classPassenger_1_1MessageChannel.html" title="Convenience class for I/O operations on file descriptors.">MessageChannel</a> is to be wrapped around a file descriptor. For example: </p>
105
- <div class="fragment"><pre class="fragment"> <span class="keywordtype">int</span> p[2];
106
- pipe(p);
107
- <a class="code" href="classPassenger_1_1MessageChannel.html#a73e7c9a8e421d29558838176aff02ca4" title="Construct a new MessageChannel with no underlying file descriptor.">MessageChannel</a> channel1(p[0]);
108
- <a class="code" href="classPassenger_1_1MessageChannel.html#a73e7c9a8e421d29558838176aff02ca4" title="Construct a new MessageChannel with no underlying file descriptor.">MessageChannel</a> channel2(p[1]);
109
-
110
- <span class="comment">// Send an array message.</span>
111
- channel2.write(<span class="stringliteral">&quot;hello&quot;</span>, <span class="stringliteral">&quot;world !!&quot;</span>, NULL);
112
- list&lt;string&gt; args;
113
- channel1.read(args); <span class="comment">// args now contains { &quot;hello&quot;, &quot;world !!&quot; }</span>
114
-
115
- <span class="comment">// Send a scalar message.</span>
116
- channel2.writeScalar(<span class="stringliteral">&quot;some long string which can contain arbitrary binary data&quot;</span>);
117
- <span class="keywordtype">string</span> str;
118
- channel1.readScalar(str);
119
- </pre></div><p>The life time of a <a class="el" href="classPassenger_1_1MessageChannel.html" title="Convenience class for I/O operations on file descriptors.">MessageChannel</a> is independent from that of the wrapped file descriptor. If a <a class="el" href="classPassenger_1_1MessageChannel.html" title="Convenience class for I/O operations on file descriptors.">MessageChannel</a> object is destroyed, the file descriptor is not automatically closed. Call <a class="el" href="classPassenger_1_1MessageChannel.html#a06309e208fc5e10642a2e9bbe0f351eb" title="Close the underlying file descriptor.">close()</a> if you want to close the file descriptor.</p>
120
- <dl class="note"><dt><b>Note:</b></dt><dd>I/O operations are not buffered. </dd>
121
- <dd>
122
- Be careful with mixing the sending/receiving of array messages, scalar messages and file descriptors. If you send a collection of any of these in a specific order, then the receiving side must receive them in the exact some order. So suppose you first send a message, then a file descriptor, then a scalar, then the receiving side must first receive a message, then a file descriptor, then a scalar. If the receiving side does things in the wrong order then bad things will happen. </dd>
123
- <dd>
124
- <a class="el" href="classPassenger_1_1MessageChannel.html" title="Convenience class for I/O operations on file descriptors.">MessageChannel</a> is not thread-safe, but is reentrant. </dd>
125
- <dd>
126
- Some methods throw <a class="el" href="classPassenger_1_1SecurityException.html" title="Represents some kind of security error.">SecurityException</a> and <a class="el" href="classPassenger_1_1TimeoutException.html" title="An exception indicating that some timeout expired.">TimeoutException</a>. When these exceptions are thrown, the channel will be left in an inconsistent state because only parts of the data have been read. You should close the channel after having caught these exceptions. </dd></dl>
127
- <hr/><h2>Constructor &amp; Destructor Documentation</h2>
128
- <a class="anchor" id="a73e7c9a8e421d29558838176aff02ca4"></a><!-- doxytag: member="Passenger::MessageChannel::MessageChannel" ref="a73e7c9a8e421d29558838176aff02ca4" args="()" -->
129
- <div class="memitem">
130
- <div class="memproto">
131
- <table class="memname">
132
- <tr>
133
- <td class="memname">Passenger::MessageChannel::MessageChannel </td>
134
- <td>(</td>
135
- <td class="paramname"></td>
136
- <td>&nbsp;)&nbsp;</td>
137
- <td><code> [inline]</code></td>
138
- </tr>
139
- </table>
140
- </div>
141
- <div class="memdoc">
142
-
143
- <p>Construct a new <a class="el" href="classPassenger_1_1MessageChannel.html" title="Convenience class for I/O operations on file descriptors.">MessageChannel</a> with no underlying file descriptor. </p>
144
- <p>Thus the resulting <a class="el" href="classPassenger_1_1MessageChannel.html" title="Convenience class for I/O operations on file descriptors.">MessageChannel</a> object will not be usable. This constructor exists to allow one to declare an "empty" <a class="el" href="classPassenger_1_1MessageChannel.html" title="Convenience class for I/O operations on file descriptors.">MessageChannel</a> variable which is to be initialized later. </p>
145
-
146
- </div>
147
- </div>
148
- <hr/><h2>Member Function Documentation</h2>
149
- <a class="anchor" id="a06309e208fc5e10642a2e9bbe0f351eb"></a><!-- doxytag: member="Passenger::MessageChannel::close" ref="a06309e208fc5e10642a2e9bbe0f351eb" args="()" -->
150
- <div class="memitem">
151
- <div class="memproto">
152
- <table class="memname">
153
- <tr>
154
- <td class="memname">void Passenger::MessageChannel::close </td>
155
- <td>(</td>
156
- <td class="paramname"></td>
157
- <td>&nbsp;)&nbsp;</td>
158
- <td><code> [inline]</code></td>
159
- </tr>
160
- </table>
161
- </div>
162
- <div class="memdoc">
163
-
164
- <p>Close the underlying file descriptor. </p>
165
- <p>If this method is called multiple times, the file descriptor will only be closed the first time.</p>
166
- <dl><dt><b>Exceptions:</b></dt><dd>
167
- <table border="0" cellspacing="2" cellpadding="0">
168
- <tr><td valign="top"></td><td valign="top"><em><a class="el" href="classPassenger_1_1SystemException.html" title="Represents an error returned by a system call or a standard library call.">SystemException</a></em>&nbsp;</td><td></td></tr>
169
- <tr><td valign="top"></td><td valign="top"><em>boost::thread_interrupted</em>&nbsp;</td><td></td></tr>
170
- </table>
171
- </dd>
172
- </dl>
173
- <dl class="post"><dt><b>Postcondition:</b></dt><dd><a class="el" href="classPassenger_1_1MessageChannel.html#a0b1e25dd75783d9753f8a0d1dd42606a" title="Returns the underlying file descriptor.">filenum()</a> == -1 </dd>
174
- <dd>
175
- !connected() </dd></dl>
176
-
177
- </div>
178
- </div>
179
- <a class="anchor" id="a0b1e25dd75783d9753f8a0d1dd42606a"></a><!-- doxytag: member="Passenger::MessageChannel::filenum" ref="a0b1e25dd75783d9753f8a0d1dd42606a" args="() const " -->
180
- <div class="memitem">
181
- <div class="memproto">
182
- <table class="memname">
183
- <tr>
184
- <td class="memname">int Passenger::MessageChannel::filenum </td>
185
- <td>(</td>
186
- <td class="paramname"></td>
187
- <td>&nbsp;)&nbsp;</td>
188
- <td> const<code> [inline]</code></td>
189
- </tr>
190
- </table>
191
- </div>
192
- <div class="memdoc">
193
-
194
- <p>Returns the underlying file descriptor. </p>
195
- <p>-1 if it has already been closed. </p>
196
-
197
- </div>
198
- </div>
199
- <a class="anchor" id="a129659b60d1a663337873d2af944431e"></a><!-- doxytag: member="Passenger::MessageChannel::read" ref="a129659b60d1a663337873d2af944431e" args="(vector&lt; string &gt; &amp;args)" -->
200
- <div class="memitem">
201
- <div class="memproto">
202
- <table class="memname">
203
- <tr>
204
- <td class="memname">bool Passenger::MessageChannel::read </td>
205
- <td>(</td>
206
- <td class="paramtype">vector&lt; string &gt; &amp;&nbsp;</td>
207
- <td class="paramname"> <em>args</em></td>
208
- <td>&nbsp;)&nbsp;</td>
209
- <td><code> [inline]</code></td>
210
- </tr>
211
- </table>
212
- </div>
213
- <div class="memdoc">
214
-
215
- <p>Read an array message from the underlying file descriptor. </p>
216
- <dl><dt><b>Parameters:</b></dt><dd>
217
- <table border="0" cellspacing="2" cellpadding="0">
218
- <tr><td valign="top"></td><td valign="top"><em>args</em>&nbsp;</td><td>The message will be put in this variable. </td></tr>
219
- </table>
220
- </dd>
221
- </dl>
222
- <dl class="return"><dt><b>Returns:</b></dt><dd>Whether end-of-file has been reached. If so, then the contents of <code>args</code> will be undefined. </dd></dl>
223
- <dl><dt><b>Exceptions:</b></dt><dd>
224
- <table border="0" cellspacing="2" cellpadding="0">
225
- <tr><td valign="top"></td><td valign="top"><em><a class="el" href="classPassenger_1_1SystemException.html" title="Represents an error returned by a system call or a standard library call.">SystemException</a></em>&nbsp;</td><td>If an error occured while receiving the message. </td></tr>
226
- <tr><td valign="top"></td><td valign="top"><em>boost::thread_interrupted</em>&nbsp;</td><td></td></tr>
227
- </table>
228
- </dd>
229
- </dl>
230
- <dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classPassenger_1_1MessageChannel.html#a150f68bc47e060dcc6ca35bee047914d" title="Send an array message, which consists of the given elements, over the underlying...">write()</a> </dd></dl>
231
-
232
- </div>
233
- </div>
234
- <a class="anchor" id="a1a28ba9d078f38f2831673092ac9dcbc"></a><!-- doxytag: member="Passenger::MessageChannel::readFileDescriptor" ref="a1a28ba9d078f38f2831673092ac9dcbc" args="(bool negotiate=true)" -->
235
- <div class="memitem">
236
- <div class="memproto">
237
- <table class="memname">
238
- <tr>
239
- <td class="memname">int Passenger::MessageChannel::readFileDescriptor </td>
240
- <td>(</td>
241
- <td class="paramtype">bool&nbsp;</td>
242
- <td class="paramname"> <em>negotiate</em> = <code>true</code></td>
243
- <td>&nbsp;)&nbsp;</td>
244
- <td><code> [inline]</code></td>
245
- </tr>
246
- </table>
247
- </div>
248
- <div class="memdoc">
249
-
250
- <p>Receive a file descriptor, which had been passed over the underlying file descriptor. </p>
251
- <dl><dt><b>Parameters:</b></dt><dd>
252
- <table border="0" cellspacing="2" cellpadding="0">
253
- <tr><td valign="top"></td><td valign="top"><em>negotiate</em>&nbsp;</td><td>See Ruby's MessageChannel::send_io method's comments. </td></tr>
254
- </table>
255
- </dd>
256
- </dl>
257
- <dl class="return"><dt><b>Returns:</b></dt><dd>The passed file descriptor. </dd></dl>
258
- <dl><dt><b>Exceptions:</b></dt><dd>
259
- <table border="0" cellspacing="2" cellpadding="0">
260
- <tr><td valign="top"></td><td valign="top"><em><a class="el" href="classPassenger_1_1SystemException.html" title="Represents an error returned by a system call or a standard library call.">SystemException</a></em>&nbsp;</td><td>If something went wrong during the receiving of a file descriptor. Perhaps the underlying file descriptor isn't a Unix socket. </td></tr>
261
- <tr><td valign="top"></td><td valign="top"><em><a class="el" href="classPassenger_1_1IOException.html" title="Represents an error that occured during an I/O operation.">IOException</a></em>&nbsp;</td><td>Whatever was received doesn't seem to be a file descriptor. </td></tr>
262
- <tr><td valign="top"></td><td valign="top"><em>boost::thread_interrupted</em>&nbsp;</td><td></td></tr>
263
- </table>
264
- </dd>
265
- </dl>
266
-
267
- </div>
268
- </div>
269
- <a class="anchor" id="ab471dc1888f030e20ed23068a160ec2a"></a><!-- doxytag: member="Passenger::MessageChannel::readRaw" ref="ab471dc1888f030e20ed23068a160ec2a" args="(void *buf, unsigned int size, unsigned long long *timeout=NULL)" -->
270
- <div class="memitem">
271
- <div class="memproto">
272
- <table class="memname">
273
- <tr>
274
- <td class="memname">bool Passenger::MessageChannel::readRaw </td>
275
- <td>(</td>
276
- <td class="paramtype">void *&nbsp;</td>
277
- <td class="paramname"> <em>buf</em>, </td>
278
- </tr>
279
- <tr>
280
- <td class="paramkey"></td>
281
- <td></td>
282
- <td class="paramtype">unsigned int&nbsp;</td>
283
- <td class="paramname"> <em>size</em>, </td>
284
- </tr>
285
- <tr>
286
- <td class="paramkey"></td>
287
- <td></td>
288
- <td class="paramtype">unsigned long long *&nbsp;</td>
289
- <td class="paramname"> <em>timeout</em> = <code>NULL</code></td><td>&nbsp;</td>
290
- </tr>
291
- <tr>
292
- <td></td>
293
- <td>)</td>
294
- <td></td><td></td><td><code> [inline]</code></td>
295
- </tr>
296
- </table>
297
- </div>
298
- <div class="memdoc">
299
-
300
- <p>Read exactly <code>size</code> bytes of data from the underlying file descriptor, and put the result in <code>buf</code>. </p>
301
- <p>If end-of-file has been reached, or if end-of-file was encountered before <code>size</code> bytes have been read, then <code>false</code> will be returned. Otherwise (i.e. if the read was successful), <code>true</code> will be returned.</p>
302
- <dl><dt><b>Parameters:</b></dt><dd>
303
- <table border="0" cellspacing="2" cellpadding="0">
304
- <tr><td valign="top"></td><td valign="top"><em>buf</em>&nbsp;</td><td>The buffer to place the read data in. This buffer must be at least <code>size</code> bytes long. </td></tr>
305
- <tr><td valign="top"></td><td valign="top"><em>size</em>&nbsp;</td><td>The number of bytes to read. </td></tr>
306
- <tr><td valign="top"></td><td valign="top"><em>timeout</em>&nbsp;</td><td>A pointer to an integer, which specifies the maximum number of milliseconds that may be spent on reading the <code>size</code> bytes of data. If the timeout expired then <a class="el" href="classPassenger_1_1TimeoutException.html" title="An exception indicating that some timeout expired.">TimeoutException</a> will be thrown. If this function returns without throwing an exception, then the total number of milliseconds spent on reading will be deducted from <code>timeout</code>. Pass NULL if you do not want to enforce a timeout. </td></tr>
307
- </table>
308
- </dd>
309
- </dl>
310
- <dl class="return"><dt><b>Returns:</b></dt><dd>Whether reading was successful or whether EOF was reached. </dd></dl>
311
- <dl class="pre"><dt><b>Precondition:</b></dt><dd>buf != NULL </dd></dl>
312
- <dl><dt><b>Exceptions:</b></dt><dd>
313
- <table border="0" cellspacing="2" cellpadding="0">
314
- <tr><td valign="top"></td><td valign="top"><em><a class="el" href="classPassenger_1_1SystemException.html" title="Represents an error returned by a system call or a standard library call.">SystemException</a></em>&nbsp;</td><td>Something went wrong during reading. </td></tr>
315
- <tr><td valign="top"></td><td valign="top"><em><a class="el" href="classPassenger_1_1TimeoutException.html" title="An exception indicating that some timeout expired.">TimeoutException</a></em>&nbsp;</td><td>Unable to read <code>size</code> bytes of data within <code>timeout</code> milliseconds. </td></tr>
316
- <tr><td valign="top"></td><td valign="top"><em>boost::thread_interrupted</em>&nbsp;</td><td></td></tr>
317
- </table>
318
- </dd>
319
- </dl>
320
-
321
- </div>
322
- </div>
323
- <a class="anchor" id="a1f3cf672b566166ed920c2bba4d19604"></a><!-- doxytag: member="Passenger::MessageChannel::readScalar" ref="a1f3cf672b566166ed920c2bba4d19604" args="(string &amp;output, unsigned int maxSize=0, unsigned long long *timeout=NULL)" -->
324
- <div class="memitem">
325
- <div class="memproto">
326
- <table class="memname">
327
- <tr>
328
- <td class="memname">bool Passenger::MessageChannel::readScalar </td>
329
- <td>(</td>
330
- <td class="paramtype">string &amp;&nbsp;</td>
331
- <td class="paramname"> <em>output</em>, </td>
332
- </tr>
333
- <tr>
334
- <td class="paramkey"></td>
335
- <td></td>
336
- <td class="paramtype">unsigned int&nbsp;</td>
337
- <td class="paramname"> <em>maxSize</em> = <code>0</code>, </td>
338
- </tr>
339
- <tr>
340
- <td class="paramkey"></td>
341
- <td></td>
342
- <td class="paramtype">unsigned long long *&nbsp;</td>
343
- <td class="paramname"> <em>timeout</em> = <code>NULL</code></td><td>&nbsp;</td>
344
- </tr>
345
- <tr>
346
- <td></td>
347
- <td>)</td>
348
- <td></td><td></td><td><code> [inline]</code></td>
349
- </tr>
350
- </table>
351
- </div>
352
- <div class="memdoc">
353
-
354
- <p>Read a scalar message from the underlying file descriptor. </p>
355
- <dl><dt><b>Parameters:</b></dt><dd>
356
- <table border="0" cellspacing="2" cellpadding="0">
357
- <tr><td valign="top"></td><td valign="top"><em>output</em>&nbsp;</td><td>The message will be put in here. </td></tr>
358
- <tr><td valign="top"></td><td valign="top"><em>maxSize</em>&nbsp;</td><td>The maximum number of bytes that may be read. If the scalar to read is larger than this, then a <a class="el" href="classPassenger_1_1SecurityException.html" title="Represents some kind of security error.">SecurityException</a> will be thrown. Set to 0 for no size limit. </td></tr>
359
- <tr><td valign="top"></td><td valign="top"><em>timeout</em>&nbsp;</td><td>A pointer to an integer, representing the maximum number of milliseconds to spend on reading the entire scalar. A <a class="el" href="classPassenger_1_1TimeoutException.html" title="An exception indicating that some timeout expired.">TimeoutException</a> will be thrown if unable to read the entire scalar within this time period. If no exception is thrown, the the amount of time spent on waiting will be deducted from <code>*timeout</code>. Pass NULL if you do not want to enforce any time limits. </td></tr>
360
- </table>
361
- </dd>
362
- </dl>
363
- <dl class="return"><dt><b>Returns:</b></dt><dd>Whether end-of-file was reached during reading. </dd></dl>
364
- <dl><dt><b>Exceptions:</b></dt><dd>
365
- <table border="0" cellspacing="2" cellpadding="0">
366
- <tr><td valign="top"></td><td valign="top"><em><a class="el" href="classPassenger_1_1SystemException.html" title="Represents an error returned by a system call or a standard library call.">SystemException</a></em>&nbsp;</td><td>An error occured while reading data from the file descriptor. </td></tr>
367
- <tr><td valign="top"></td><td valign="top"><em><a class="el" href="classPassenger_1_1SecurityException.html" title="Represents some kind of security error.">SecurityException</a></em>&nbsp;</td><td>There is more data to read than allowed by maxSize. </td></tr>
368
- <tr><td valign="top"></td><td valign="top"><em><a class="el" href="classPassenger_1_1TimeoutException.html" title="An exception indicating that some timeout expired.">TimeoutException</a></em>&nbsp;</td><td>Unable to read the entire scalar within <code>timeout</code> milliseconds. </td></tr>
369
- <tr><td valign="top"></td><td valign="top"><em>boost::thread_interrupted</em>&nbsp;</td><td></td></tr>
370
- </table>
371
- </dd>
372
- </dl>
373
- <dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classPassenger_1_1MessageChannel.html#a44e01a783c48abadeea0d915b9893bfb" title="Write a scalar message to the underlying file descriptor.">writeScalar()</a> </dd></dl>
374
-
375
- </div>
376
- </div>
377
- <a class="anchor" id="a7b0c67852ea8ab455af75b1037c7f8b6"></a><!-- doxytag: member="Passenger::MessageChannel::readUint32" ref="a7b0c67852ea8ab455af75b1037c7f8b6" args="(unsigned int &amp;value, unsigned long long *timeout=NULL)" -->
378
- <div class="memitem">
379
- <div class="memproto">
380
- <table class="memname">
381
- <tr>
382
- <td class="memname">bool Passenger::MessageChannel::readUint32 </td>
383
- <td>(</td>
384
- <td class="paramtype">unsigned int &amp;&nbsp;</td>
385
- <td class="paramname"> <em>value</em>, </td>
386
- </tr>
387
- <tr>
388
- <td class="paramkey"></td>
389
- <td></td>
390
- <td class="paramtype">unsigned long long *&nbsp;</td>
391
- <td class="paramname"> <em>timeout</em> = <code>NULL</code></td><td>&nbsp;</td>
392
- </tr>
393
- <tr>
394
- <td></td>
395
- <td>)</td>
396
- <td></td><td></td><td><code> [inline]</code></td>
397
- </tr>
398
- </table>
399
- </div>
400
- <div class="memdoc">
401
-
402
- <p>Read a 32-bit big-endian unsigned integer from the underlying file descriptor. </p>
403
- <dl><dt><b>Parameters:</b></dt><dd>
404
- <table border="0" cellspacing="2" cellpadding="0">
405
- <tr><td valign="top"></td><td valign="top"><em>value</em>&nbsp;</td><td>Upon success, the read value will be stored in here. </td></tr>
406
- <tr><td valign="top"></td><td valign="top"><em>timeout</em>&nbsp;</td><td>A pointer to an integer, representing the maximum number of milliseconds to spend on reading the entire integer. A <a class="el" href="classPassenger_1_1TimeoutException.html" title="An exception indicating that some timeout expired.">TimeoutException</a> will be thrown if the timeout expires. If no exception is thrown, the the amount of time spent on waiting will be deducted from <code>*timeout</code>. Pass NULL if you do not want to enforce any time limits. </td></tr>
407
- </table>
408
- </dd>
409
- </dl>
410
- <dl class="return"><dt><b>Returns:</b></dt><dd>True if a value was read, false if EOF was reached before all data can be read. </dd></dl>
411
- <dl><dt><b>Exceptions:</b></dt><dd>
412
- <table border="0" cellspacing="2" cellpadding="0">
413
- <tr><td valign="top"></td><td valign="top"><em><a class="el" href="classPassenger_1_1SystemException.html" title="Represents an error returned by a system call or a standard library call.">SystemException</a></em>&nbsp;</td><td>An error occurred while reading data from the file descriptor. </td></tr>
414
- <tr><td valign="top"></td><td valign="top"><em>boost::thread_interrupted</em>&nbsp;</td><td></td></tr>
415
- </table>
416
- </dd>
417
- </dl>
418
-
419
- </div>
420
- </div>
421
- <a class="anchor" id="aeb69bffbbb148c9bc8662e20b416c4e2"></a><!-- doxytag: member="Passenger::MessageChannel::setReadTimeout" ref="aeb69bffbbb148c9bc8662e20b416c4e2" args="(unsigned int msec)" -->
422
- <div class="memitem">
423
- <div class="memproto">
424
- <table class="memname">
425
- <tr>
426
- <td class="memname">void Passenger::MessageChannel::setReadTimeout </td>
427
- <td>(</td>
428
- <td class="paramtype">unsigned int&nbsp;</td>
429
- <td class="paramname"> <em>msec</em></td>
430
- <td>&nbsp;)&nbsp;</td>
431
- <td><code> [inline]</code></td>
432
- </tr>
433
- </table>
434
- </div>
435
- <div class="memdoc">
436
-
437
- <p>Set the timeout value for reading data from this channel. </p>
438
- <p>If no data can be read within the timeout period, then a <a class="el" href="classPassenger_1_1SystemException.html" title="Represents an error returned by a system call or a standard library call.">SystemException</a> will be thrown by one of the read methods, with error code EAGAIN or EWOULDBLOCK.</p>
439
- <dl><dt><b>Parameters:</b></dt><dd>
440
- <table border="0" cellspacing="2" cellpadding="0">
441
- <tr><td valign="top"></td><td valign="top"><em>msec</em>&nbsp;</td><td>The timeout, in milliseconds. If 0 is given, there will be no timeout. </td></tr>
442
- </table>
443
- </dd>
444
- </dl>
445
- <dl><dt><b>Exceptions:</b></dt><dd>
446
- <table border="0" cellspacing="2" cellpadding="0">
447
- <tr><td valign="top"></td><td valign="top"><em><a class="el" href="classPassenger_1_1SystemException.html" title="Represents an error returned by a system call or a standard library call.">SystemException</a></em>&nbsp;</td><td>Cannot set the timeout. </td></tr>
448
- </table>
449
- </dd>
450
- </dl>
451
-
452
- </div>
453
- </div>
454
- <a class="anchor" id="a77c5d7c47f387cf43992ebeb14e3c6c7"></a><!-- doxytag: member="Passenger::MessageChannel::setWriteTimeout" ref="a77c5d7c47f387cf43992ebeb14e3c6c7" args="(unsigned int msec)" -->
455
- <div class="memitem">
456
- <div class="memproto">
457
- <table class="memname">
458
- <tr>
459
- <td class="memname">void Passenger::MessageChannel::setWriteTimeout </td>
460
- <td>(</td>
461
- <td class="paramtype">unsigned int&nbsp;</td>
462
- <td class="paramname"> <em>msec</em></td>
463
- <td>&nbsp;)&nbsp;</td>
464
- <td><code> [inline]</code></td>
465
- </tr>
466
- </table>
467
- </div>
468
- <div class="memdoc">
469
-
470
- <p>Set the timeout value for writing data to this channel. </p>
471
- <p>If no data can be written within the timeout period, then a <a class="el" href="classPassenger_1_1SystemException.html" title="Represents an error returned by a system call or a standard library call.">SystemException</a> will be thrown, with error code EAGAIN or EWOULDBLOCK.</p>
472
- <dl><dt><b>Parameters:</b></dt><dd>
473
- <table border="0" cellspacing="2" cellpadding="0">
474
- <tr><td valign="top"></td><td valign="top"><em>msec</em>&nbsp;</td><td>The timeout, in milliseconds. If 0 is given, there will be no timeout. </td></tr>
475
- </table>
476
- </dd>
477
- </dl>
478
- <dl><dt><b>Exceptions:</b></dt><dd>
479
- <table border="0" cellspacing="2" cellpadding="0">
480
- <tr><td valign="top"></td><td valign="top"><em><a class="el" href="classPassenger_1_1SystemException.html" title="Represents an error returned by a system call or a standard library call.">SystemException</a></em>&nbsp;</td><td>Cannot set the timeout. </td></tr>
481
- </table>
482
- </dd>
483
- </dl>
484
-
485
- </div>
486
- </div>
487
- <a class="anchor" id="a12cce3364023eacbe4fe09006cf3d38d"></a><!-- doxytag: member="Passenger::MessageChannel::write" ref="a12cce3364023eacbe4fe09006cf3d38d" args="(const char *name,...)" -->
488
- <div class="memitem">
489
- <div class="memproto">
490
- <table class="memname">
491
- <tr>
492
- <td class="memname">void Passenger::MessageChannel::write </td>
493
- <td>(</td>
494
- <td class="paramtype">const char *&nbsp;</td>
495
- <td class="paramname"> <em>name</em>, </td>
496
- </tr>
497
- <tr>
498
- <td class="paramkey"></td>
499
- <td></td>
500
- <td class="paramtype">&nbsp;</td>
501
- <td class="paramname"> <em>...</em></td><td>&nbsp;</td>
502
- </tr>
503
- <tr>
504
- <td></td>
505
- <td>)</td>
506
- <td></td><td></td><td><code> [inline]</code></td>
507
- </tr>
508
- </table>
509
- </div>
510
- <div class="memdoc">
511
-
512
- <p>Send an array message, which consists of the given strings, over the underlying file descriptor. </p>
513
- <dl><dt><b>Parameters:</b></dt><dd>
514
- <table border="0" cellspacing="2" cellpadding="0">
515
- <tr><td valign="top"></td><td valign="top"><em>name</em>&nbsp;</td><td>The first element of the message to send. </td></tr>
516
- <tr><td valign="top"></td><td valign="top"><em>...</em>&nbsp;</td><td>Other elements of the message. These *must* be strings, i.e. of type char*. It is also required to terminate this list with a NULL. </td></tr>
517
- </table>
518
- </dd>
519
- </dl>
520
- <dl><dt><b>Exceptions:</b></dt><dd>
521
- <table border="0" cellspacing="2" cellpadding="0">
522
- <tr><td valign="top"></td><td valign="top"><em><a class="el" href="classPassenger_1_1SystemException.html" title="Represents an error returned by a system call or a standard library call.">SystemException</a></em>&nbsp;</td><td>An error occured while writing the data to the file descriptor. </td></tr>
523
- <tr><td valign="top"></td><td valign="top"><em>boost::thread_interrupted</em>&nbsp;</td><td></td></tr>
524
- </table>
525
- </dd>
526
- </dl>
527
- <dl class="pre"><dt><b>Precondition:</b></dt><dd>None of the message elements may contain a NUL character (<code>'\0'</code>). </dd></dl>
528
- <dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classPassenger_1_1MessageChannel.html#a129659b60d1a663337873d2af944431e" title="Read an array message from the underlying file descriptor.">read()</a>, <a class="el" href="classPassenger_1_1MessageChannel.html#a9ad7a978cf8409e01ab2f0a2b6be5a0a" title="Send an array message, which consists of the given elements, over the underlying...">write(const list&lt;string&gt; &amp;)</a> </dd></dl>
529
-
530
- </div>
531
- </div>
532
- <a class="anchor" id="a70cc924c1ce7e2cedcbab61155d3aec9"></a><!-- doxytag: member="Passenger::MessageChannel::write" ref="a70cc924c1ce7e2cedcbab61155d3aec9" args="(const char *name, va_list &amp;ap)" -->
533
- <div class="memitem">
534
- <div class="memproto">
535
- <table class="memname">
536
- <tr>
537
- <td class="memname">void Passenger::MessageChannel::write </td>
538
- <td>(</td>
539
- <td class="paramtype">const char *&nbsp;</td>
540
- <td class="paramname"> <em>name</em>, </td>
541
- </tr>
542
- <tr>
543
- <td class="paramkey"></td>
544
- <td></td>
545
- <td class="paramtype">va_list &amp;&nbsp;</td>
546
- <td class="paramname"> <em>ap</em></td><td>&nbsp;</td>
547
- </tr>
548
- <tr>
549
- <td></td>
550
- <td>)</td>
551
- <td></td><td></td><td><code> [inline]</code></td>
552
- </tr>
553
- </table>
554
- </div>
555
- <div class="memdoc">
556
-
557
- <p>Send an array message, which consists of the given strings, over the underlying file descriptor. </p>
558
- <p>Like <code>write(const char *name, ...)</code> but takes a va_list instead.</p>
559
- <dl><dt><b>Exceptions:</b></dt><dd>
560
- <table border="0" cellspacing="2" cellpadding="0">
561
- <tr><td valign="top"></td><td valign="top"><em><a class="el" href="classPassenger_1_1SystemException.html" title="Represents an error returned by a system call or a standard library call.">SystemException</a></em>&nbsp;</td><td>An error occured while writing the data to the file descriptor. </td></tr>
562
- <tr><td valign="top"></td><td valign="top"><em>boost::thread_interrupted</em>&nbsp;</td><td></td></tr>
563
- </table>
564
- </dd>
565
- </dl>
566
- <dl class="pre"><dt><b>Precondition:</b></dt><dd>None of the message elements may contain a NUL character (<code>'\0'</code>). </dd></dl>
567
-
568
- </div>
569
- </div>
570
- <a class="anchor" id="a6a9bc5d72715cb7ba0e437c8851ef487"></a><!-- doxytag: member="Passenger::MessageChannel::write" ref="a6a9bc5d72715cb7ba0e437c8851ef487" args="(const vector&lt; string &gt; &amp;args)" -->
571
- <div class="memitem">
572
- <div class="memproto">
573
- <table class="memname">
574
- <tr>
575
- <td class="memname">void Passenger::MessageChannel::write </td>
576
- <td>(</td>
577
- <td class="paramtype">const vector&lt; string &gt; &amp;&nbsp;</td>
578
- <td class="paramname"> <em>args</em></td>
579
- <td>&nbsp;)&nbsp;</td>
580
- <td><code> [inline]</code></td>
581
- </tr>
582
- </table>
583
- </div>
584
- <div class="memdoc">
585
-
586
- <p>Send an array message, which consists of the given elements, over the underlying file descriptor. </p>
587
- <dl><dt><b>Parameters:</b></dt><dd>
588
- <table border="0" cellspacing="2" cellpadding="0">
589
- <tr><td valign="top"></td><td valign="top"><em>args</em>&nbsp;</td><td>The message elements. </td></tr>
590
- </table>
591
- </dd>
592
- </dl>
593
- <dl><dt><b>Exceptions:</b></dt><dd>
594
- <table border="0" cellspacing="2" cellpadding="0">
595
- <tr><td valign="top"></td><td valign="top"><em><a class="el" href="classPassenger_1_1SystemException.html" title="Represents an error returned by a system call or a standard library call.">SystemException</a></em>&nbsp;</td><td>An error occured while writing the data to the file descriptor. </td></tr>
596
- <tr><td valign="top"></td><td valign="top"><em>boost::thread_interrupted</em>&nbsp;</td><td></td></tr>
597
- </table>
598
- </dd>
599
- </dl>
600
- <dl class="pre"><dt><b>Precondition:</b></dt><dd>None of the message elements may contain a NUL character (<code>'\0'</code>). </dd></dl>
601
- <dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classPassenger_1_1MessageChannel.html#a129659b60d1a663337873d2af944431e" title="Read an array message from the underlying file descriptor.">read()</a>, <a class="el" href="classPassenger_1_1MessageChannel.html#a150f68bc47e060dcc6ca35bee047914d" title="Send an array message, which consists of the given elements, over the underlying...">write</a>(const char *, ...) </dd></dl>
602
-
603
- </div>
604
- </div>
605
- <a class="anchor" id="a9ad7a978cf8409e01ab2f0a2b6be5a0a"></a><!-- doxytag: member="Passenger::MessageChannel::write" ref="a9ad7a978cf8409e01ab2f0a2b6be5a0a" args="(const list&lt; string &gt; &amp;args)" -->
606
- <div class="memitem">
607
- <div class="memproto">
608
- <table class="memname">
609
- <tr>
610
- <td class="memname">void Passenger::MessageChannel::write </td>
611
- <td>(</td>
612
- <td class="paramtype">const list&lt; string &gt; &amp;&nbsp;</td>
613
- <td class="paramname"> <em>args</em></td>
614
- <td>&nbsp;)&nbsp;</td>
615
- <td><code> [inline]</code></td>
616
- </tr>
617
- </table>
618
- </div>
619
- <div class="memdoc">
620
-
621
- <p>Send an array message, which consists of the given elements, over the underlying file descriptor. </p>
622
- <dl><dt><b>Parameters:</b></dt><dd>
623
- <table border="0" cellspacing="2" cellpadding="0">
624
- <tr><td valign="top"></td><td valign="top"><em>args</em>&nbsp;</td><td>The message elements. </td></tr>
625
- </table>
626
- </dd>
627
- </dl>
628
- <dl><dt><b>Exceptions:</b></dt><dd>
629
- <table border="0" cellspacing="2" cellpadding="0">
630
- <tr><td valign="top"></td><td valign="top"><em><a class="el" href="classPassenger_1_1SystemException.html" title="Represents an error returned by a system call or a standard library call.">SystemException</a></em>&nbsp;</td><td>An error occured while writing the data to the file descriptor. </td></tr>
631
- <tr><td valign="top"></td><td valign="top"><em>boost::thread_interrupted</em>&nbsp;</td><td></td></tr>
632
- </table>
633
- </dd>
634
- </dl>
635
- <dl class="pre"><dt><b>Precondition:</b></dt><dd>None of the message elements may contain a NUL character (<code>'\0'</code>). </dd></dl>
636
- <dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classPassenger_1_1MessageChannel.html#a129659b60d1a663337873d2af944431e" title="Read an array message from the underlying file descriptor.">read()</a>, <a class="el" href="classPassenger_1_1MessageChannel.html#a150f68bc47e060dcc6ca35bee047914d" title="Send an array message, which consists of the given elements, over the underlying...">write</a>(const char *, ...) </dd></dl>
637
-
638
- </div>
639
- </div>
640
- <a class="anchor" id="a150f68bc47e060dcc6ca35bee047914d"></a><!-- doxytag: member="Passenger::MessageChannel::write" ref="a150f68bc47e060dcc6ca35bee047914d" args="(const StringArrayType &amp;args)" -->
641
- <div class="memitem">
642
- <div class="memproto">
643
- <div class="memtemplate">
644
- template&lt;typename StringArrayType , typename StringArrayConstIteratorType &gt; </div>
645
- <table class="memname">
646
- <tr>
647
- <td class="memname">void Passenger::MessageChannel::write </td>
648
- <td>(</td>
649
- <td class="paramtype">const StringArrayType &amp;&nbsp;</td>
650
- <td class="paramname"> <em>args</em></td>
651
- <td>&nbsp;)&nbsp;</td>
652
- <td><code> [inline]</code></td>
653
- </tr>
654
- </table>
655
- </div>
656
- <div class="memdoc">
657
-
658
- <p>Send an array message, which consists of the given elements, over the underlying file descriptor. </p>
659
- <dl><dt><b>Parameters:</b></dt><dd>
660
- <table border="0" cellspacing="2" cellpadding="0">
661
- <tr><td valign="top"></td><td valign="top"><em>args</em>&nbsp;</td><td>An object which contains the message elements. This object must support STL-style iteration, and each iterator must have an std::string as value. Use the StringArrayType and StringArrayConstIteratorType template parameters to specify the exact type names. </td></tr>
662
- </table>
663
- </dd>
664
- </dl>
665
- <dl><dt><b>Exceptions:</b></dt><dd>
666
- <table border="0" cellspacing="2" cellpadding="0">
667
- <tr><td valign="top"></td><td valign="top"><em><a class="el" href="classPassenger_1_1SystemException.html" title="Represents an error returned by a system call or a standard library call.">SystemException</a></em>&nbsp;</td><td>An error occured while writing the data to the file descriptor. </td></tr>
668
- <tr><td valign="top"></td><td valign="top"><em>boost::thread_interrupted</em>&nbsp;</td><td></td></tr>
669
- </table>
670
- </dd>
671
- </dl>
672
- <dl class="pre"><dt><b>Precondition:</b></dt><dd>None of the message elements may contain a NUL character (<code>'\0'</code>). </dd></dl>
673
- <dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classPassenger_1_1MessageChannel.html#a129659b60d1a663337873d2af944431e" title="Read an array message from the underlying file descriptor.">read()</a>, <a class="el" href="classPassenger_1_1MessageChannel.html#a150f68bc47e060dcc6ca35bee047914d" title="Send an array message, which consists of the given elements, over the underlying...">write</a>(const char *, ...) </dd></dl>
674
-
675
- </div>
676
- </div>
677
- <a class="anchor" id="ae0c558e07dcc91900016773b2bec38d8"></a><!-- doxytag: member="Passenger::MessageChannel::writeFileDescriptor" ref="ae0c558e07dcc91900016773b2bec38d8" args="(int fileDescriptor, bool negotiate=true)" -->
678
- <div class="memitem">
679
- <div class="memproto">
680
- <table class="memname">
681
- <tr>
682
- <td class="memname">void Passenger::MessageChannel::writeFileDescriptor </td>
683
- <td>(</td>
684
- <td class="paramtype">int&nbsp;</td>
685
- <td class="paramname"> <em>fileDescriptor</em>, </td>
686
- </tr>
687
- <tr>
688
- <td class="paramkey"></td>
689
- <td></td>
690
- <td class="paramtype">bool&nbsp;</td>
691
- <td class="paramname"> <em>negotiate</em> = <code>true</code></td><td>&nbsp;</td>
692
- </tr>
693
- <tr>
694
- <td></td>
695
- <td>)</td>
696
- <td></td><td></td><td><code> [inline]</code></td>
697
- </tr>
698
- </table>
699
- </div>
700
- <div class="memdoc">
701
-
702
- <p>Pass a file descriptor. </p>
703
- <p>This only works if the underlying file descriptor is a Unix socket.</p>
704
- <dl><dt><b>Parameters:</b></dt><dd>
705
- <table border="0" cellspacing="2" cellpadding="0">
706
- <tr><td valign="top"></td><td valign="top"><em>fileDescriptor</em>&nbsp;</td><td>The file descriptor to pass. </td></tr>
707
- <tr><td valign="top"></td><td valign="top"><em>negotiate</em>&nbsp;</td><td>See Ruby's MessageChannel::send_io method's comments. </td></tr>
708
- </table>
709
- </dd>
710
- </dl>
711
- <dl><dt><b>Exceptions:</b></dt><dd>
712
- <table border="0" cellspacing="2" cellpadding="0">
713
- <tr><td valign="top"></td><td valign="top"><em><a class="el" href="classPassenger_1_1SystemException.html" title="Represents an error returned by a system call or a standard library call.">SystemException</a></em>&nbsp;</td><td>Something went wrong during file descriptor passing. </td></tr>
714
- <tr><td valign="top"></td><td valign="top"><em>boost::thread_interrupted</em>&nbsp;</td><td></td></tr>
715
- </table>
716
- </dd>
717
- </dl>
718
- <dl class="pre"><dt><b>Precondition:</b></dt><dd><code>fileDescriptor &gt;= 0</code> </dd></dl>
719
- <dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classPassenger_1_1MessageChannel.html#a1a28ba9d078f38f2831673092ac9dcbc" title="Receive a file descriptor, which had been passed over the underlying file descriptor...">readFileDescriptor()</a> </dd></dl>
720
-
721
- </div>
722
- </div>
723
- <a class="anchor" id="a80977020ef895f3ea790c5d28a333dda"></a><!-- doxytag: member="Passenger::MessageChannel::writeScalar" ref="a80977020ef895f3ea790c5d28a333dda" args="(const char *data, unsigned int size)" -->
724
- <div class="memitem">
725
- <div class="memproto">
726
- <table class="memname">
727
- <tr>
728
- <td class="memname">void Passenger::MessageChannel::writeScalar </td>
729
- <td>(</td>
730
- <td class="paramtype">const char *&nbsp;</td>
731
- <td class="paramname"> <em>data</em>, </td>
732
- </tr>
733
- <tr>
734
- <td class="paramkey"></td>
735
- <td></td>
736
- <td class="paramtype">unsigned int&nbsp;</td>
737
- <td class="paramname"> <em>size</em></td><td>&nbsp;</td>
738
- </tr>
739
- <tr>
740
- <td></td>
741
- <td>)</td>
742
- <td></td><td></td><td><code> [inline]</code></td>
743
- </tr>
744
- </table>
745
- </div>
746
- <div class="memdoc">
747
-
748
- <p>Write a scalar message to the underlying file descriptor. </p>
749
- <dl class="note"><dt><b>Note:</b></dt><dd>Security guarantee: this method will not copy the data in memory, so it's safe to use this method to write passwords to the underlying file descriptor.</dd></dl>
750
- <dl><dt><b>Parameters:</b></dt><dd>
751
- <table border="0" cellspacing="2" cellpadding="0">
752
- <tr><td valign="top"></td><td valign="top"><em>data</em>&nbsp;</td><td>The scalar message's content. </td></tr>
753
- <tr><td valign="top"></td><td valign="top"><em>size</em>&nbsp;</td><td>The number of bytes in <code>data</code>. </td></tr>
754
- </table>
755
- </dd>
756
- </dl>
757
- <dl class="pre"><dt><b>Precondition:</b></dt><dd><code>data != NULL</code> </dd></dl>
758
- <dl><dt><b>Exceptions:</b></dt><dd>
759
- <table border="0" cellspacing="2" cellpadding="0">
760
- <tr><td valign="top"></td><td valign="top"><em><a class="el" href="classPassenger_1_1SystemException.html" title="Represents an error returned by a system call or a standard library call.">SystemException</a></em>&nbsp;</td><td>An error occured while writing the data to the file descriptor. </td></tr>
761
- <tr><td valign="top"></td><td valign="top"><em>boost::thread_interrupted</em>&nbsp;</td><td></td></tr>
762
- </table>
763
- </dd>
764
- </dl>
765
- <dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classPassenger_1_1MessageChannel.html#a1f3cf672b566166ed920c2bba4d19604" title="Read a scalar message from the underlying file descriptor.">readScalar()</a>, <a class="el" href="classPassenger_1_1MessageChannel.html#a44e01a783c48abadeea0d915b9893bfb" title="Write a scalar message to the underlying file descriptor.">writeScalar(const string &amp;)</a> </dd></dl>
766
-
767
- </div>
768
- </div>
769
- <a class="anchor" id="a44e01a783c48abadeea0d915b9893bfb"></a><!-- doxytag: member="Passenger::MessageChannel::writeScalar" ref="a44e01a783c48abadeea0d915b9893bfb" args="(const string &amp;str)" -->
770
- <div class="memitem">
771
- <div class="memproto">
772
- <table class="memname">
773
- <tr>
774
- <td class="memname">void Passenger::MessageChannel::writeScalar </td>
775
- <td>(</td>
776
- <td class="paramtype">const string &amp;&nbsp;</td>
777
- <td class="paramname"> <em>str</em></td>
778
- <td>&nbsp;)&nbsp;</td>
779
- <td><code> [inline]</code></td>
780
- </tr>
781
- </table>
782
- </div>
783
- <div class="memdoc">
784
-
785
- <p>Write a scalar message to the underlying file descriptor. </p>
786
- <dl class="note"><dt><b>Note:</b></dt><dd>Security guarantee: this method will not copy the data in memory, so it's safe to use this method to write passwords to the underlying file descriptor.</dd></dl>
787
- <dl><dt><b>Parameters:</b></dt><dd>
788
- <table border="0" cellspacing="2" cellpadding="0">
789
- <tr><td valign="top"></td><td valign="top"><em>str</em>&nbsp;</td><td>The scalar message's content. </td></tr>
790
- </table>
791
- </dd>
792
- </dl>
793
- <dl><dt><b>Exceptions:</b></dt><dd>
794
- <table border="0" cellspacing="2" cellpadding="0">
795
- <tr><td valign="top"></td><td valign="top"><em><a class="el" href="classPassenger_1_1SystemException.html" title="Represents an error returned by a system call or a standard library call.">SystemException</a></em>&nbsp;</td><td>An error occured while writing the data to the file descriptor. </td></tr>
796
- <tr><td valign="top"></td><td valign="top"><em>boost::thread_interrupted</em>&nbsp;</td><td></td></tr>
797
- </table>
798
- </dd>
799
- </dl>
800
- <dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classPassenger_1_1MessageChannel.html#a1f3cf672b566166ed920c2bba4d19604" title="Read a scalar message from the underlying file descriptor.">readScalar()</a>, <a class="el" href="classPassenger_1_1MessageChannel.html#a80977020ef895f3ea790c5d28a333dda" title="Write a scalar message to the underlying file descriptor.">writeScalar(const char *, unsigned int)</a> </dd></dl>
801
-
802
- </div>
803
- </div>
804
- <a class="anchor" id="abf02c51a74477650de8d5d5db661063b"></a><!-- doxytag: member="Passenger::MessageChannel::writeUint32" ref="abf02c51a74477650de8d5d5db661063b" args="(unsigned int value)" -->
805
- <div class="memitem">
806
- <div class="memproto">
807
- <table class="memname">
808
- <tr>
809
- <td class="memname">void Passenger::MessageChannel::writeUint32 </td>
810
- <td>(</td>
811
- <td class="paramtype">unsigned int&nbsp;</td>
812
- <td class="paramname"> <em>value</em></td>
813
- <td>&nbsp;)&nbsp;</td>
814
- <td><code> [inline]</code></td>
815
- </tr>
816
- </table>
817
- </div>
818
- <div class="memdoc">
819
-
820
- <p>Write a 32-bit big-endian unsigned integer to the underlying file descriptor. </p>
821
- <dl><dt><b>Exceptions:</b></dt><dd>
822
- <table border="0" cellspacing="2" cellpadding="0">
823
- <tr><td valign="top"></td><td valign="top"><em><a class="el" href="classPassenger_1_1SystemException.html" title="Represents an error returned by a system call or a standard library call.">SystemException</a></em>&nbsp;</td><td>An error occurred while writing the data to the file descriptor. </td></tr>
824
- <tr><td valign="top"></td><td valign="top"><em>boost::thread_interrupted</em>&nbsp;</td><td></td></tr>
825
- </table>
826
- </dd>
827
- </dl>
828
-
829
- </div>
830
- </div>
831
- <hr/>The documentation for this class was generated from the following file:<ul>
832
- <li><a class="el" href="MessageChannel_8h_source.html">MessageChannel.h</a></li>
833
- </ul>
834
- </div>
835
- <hr size="1"/><address style="text-align: right;"><small>Generated by&nbsp;
836
- <a href="http://www.doxygen.org/index.html">
837
- <img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.6.2 </small></address>
838
- </body>
839
- </html>