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
@@ -1,647 +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: SpawnManager.h Source File</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><a href="annotated.html"><span>Classes</span></a></li>
18
- <li class="current"><a href="files.html"><span>Files</span></a></li>
19
- </ul>
20
- </div>
21
- <div class="tabs">
22
- <ul>
23
- <li><a href="files.html"><span>File&nbsp;List</span></a></li>
24
- </ul>
25
- </div>
26
- <h1>SpawnManager.h</h1><div class="fragment"><pre class="fragment"><a name="l00001"></a>00001 <span class="comment">/*</span>
27
- <a name="l00002"></a>00002 <span class="comment"> * Phusion Passenger - http://www.modrails.com/</span>
28
- <a name="l00003"></a>00003 <span class="comment"> * Copyright (c) 2010 Phusion</span>
29
- <a name="l00004"></a>00004 <span class="comment"> *</span>
30
- <a name="l00005"></a>00005 <span class="comment"> * &quot;Phusion Passenger&quot; is a trademark of Hongli Lai &amp; Ninh Bui.</span>
31
- <a name="l00006"></a>00006 <span class="comment"> *</span>
32
- <a name="l00007"></a>00007 <span class="comment"> * Permission is hereby granted, free of charge, to any person obtaining a copy</span>
33
- <a name="l00008"></a>00008 <span class="comment"> * of this software and associated documentation files (the &quot;Software&quot;), to deal</span>
34
- <a name="l00009"></a>00009 <span class="comment"> * in the Software without restriction, including without limitation the rights</span>
35
- <a name="l00010"></a>00010 <span class="comment"> * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell</span>
36
- <a name="l00011"></a>00011 <span class="comment"> * copies of the Software, and to permit persons to whom the Software is</span>
37
- <a name="l00012"></a>00012 <span class="comment"> * furnished to do so, subject to the following conditions:</span>
38
- <a name="l00013"></a>00013 <span class="comment"> *</span>
39
- <a name="l00014"></a>00014 <span class="comment"> * The above copyright notice and this permission notice shall be included in</span>
40
- <a name="l00015"></a>00015 <span class="comment"> * all copies or substantial portions of the Software.</span>
41
- <a name="l00016"></a>00016 <span class="comment"> *</span>
42
- <a name="l00017"></a>00017 <span class="comment"> * THE SOFTWARE IS PROVIDED &quot;AS IS&quot;, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR</span>
43
- <a name="l00018"></a>00018 <span class="comment"> * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,</span>
44
- <a name="l00019"></a>00019 <span class="comment"> * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE</span>
45
- <a name="l00020"></a>00020 <span class="comment"> * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER</span>
46
- <a name="l00021"></a>00021 <span class="comment"> * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,</span>
47
- <a name="l00022"></a>00022 <span class="comment"> * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN</span>
48
- <a name="l00023"></a>00023 <span class="comment"> * THE SOFTWARE.</span>
49
- <a name="l00024"></a>00024 <span class="comment"> */</span>
50
- <a name="l00025"></a>00025 <span class="preprocessor">#ifndef _PASSENGER_SPAWN_MANAGER_H_</span>
51
- <a name="l00026"></a>00026 <span class="preprocessor"></span><span class="preprocessor">#define _PASSENGER_SPAWN_MANAGER_H_</span>
52
- <a name="l00027"></a>00027 <span class="preprocessor"></span>
53
- <a name="l00028"></a>00028 <span class="preprocessor">#include &lt;string&gt;</span>
54
- <a name="l00029"></a>00029 <span class="preprocessor">#include &lt;vector&gt;</span>
55
- <a name="l00030"></a>00030 <span class="preprocessor">#include &lt;boost/shared_ptr.hpp&gt;</span>
56
- <a name="l00031"></a>00031 <span class="preprocessor">#include &lt;boost/thread.hpp&gt;</span>
57
- <a name="l00032"></a>00032 <span class="preprocessor">#include &lt;boost/function.hpp&gt;</span>
58
- <a name="l00033"></a>00033 <span class="preprocessor">#include &lt;oxt/system_calls.hpp&gt;</span>
59
- <a name="l00034"></a>00034 <span class="preprocessor">#include &lt;oxt/backtrace.hpp&gt;</span>
60
- <a name="l00035"></a>00035
61
- <a name="l00036"></a>00036 <span class="preprocessor">#include &lt;sys/types.h&gt;</span>
62
- <a name="l00037"></a>00037 <span class="preprocessor">#include &lt;sys/wait.h&gt;</span>
63
- <a name="l00038"></a>00038 <span class="preprocessor">#include &lt;sys/stat.h&gt;</span>
64
- <a name="l00039"></a>00039 <span class="preprocessor">#include &lt;arpa/inet.h&gt;</span>
65
- <a name="l00040"></a>00040 <span class="preprocessor">#include &lt;cstdio&gt;</span>
66
- <a name="l00041"></a>00041 <span class="preprocessor">#include &lt;cstdarg&gt;</span>
67
- <a name="l00042"></a>00042 <span class="preprocessor">#include &lt;unistd.h&gt;</span>
68
- <a name="l00043"></a>00043 <span class="preprocessor">#include &lt;errno.h&gt;</span>
69
- <a name="l00044"></a>00044 <span class="preprocessor">#include &lt;grp.h&gt;</span>
70
- <a name="l00045"></a>00045 <span class="preprocessor">#include &lt;pwd.h&gt;</span>
71
- <a name="l00046"></a>00046 <span class="preprocessor">#include &lt;signal.h&gt;</span>
72
- <a name="l00047"></a>00047
73
- <a name="l00048"></a>00048 <span class="preprocessor">#include &quot;AbstractSpawnManager.h&quot;</span>
74
- <a name="l00049"></a>00049 <span class="preprocessor">#include &quot;ServerInstanceDir.h&quot;</span>
75
- <a name="l00050"></a>00050 <span class="preprocessor">#include &quot;FileDescriptor.h&quot;</span>
76
- <a name="l00051"></a>00051 <span class="preprocessor">#include &quot;Constants.h&quot;</span>
77
- <a name="l00052"></a>00052 <span class="preprocessor">#include &quot;MessageChannel.h&quot;</span>
78
- <a name="l00053"></a>00053 <span class="preprocessor">#include &quot;AccountsDatabase.h&quot;</span>
79
- <a name="l00054"></a>00054 <span class="preprocessor">#include &quot;RandomGenerator.h&quot;</span>
80
- <a name="l00055"></a>00055 <span class="preprocessor">#include &quot;Exceptions.h&quot;</span>
81
- <a name="l00056"></a>00056 <span class="preprocessor">#include &quot;Logging.h&quot;</span>
82
- <a name="l00057"></a>00057 <span class="preprocessor">#include &quot;Utils/Base64.h&quot;</span>
83
- <a name="l00058"></a>00058 <span class="preprocessor">#include &quot;Utils/SystemTime.h&quot;</span>
84
- <a name="l00059"></a>00059 <span class="preprocessor">#include &quot;Utils/IOUtils.h&quot;</span>
85
- <a name="l00060"></a>00060
86
- <a name="l00061"></a>00061 <span class="keyword">namespace </span>Passenger {
87
- <a name="l00062"></a>00062
88
- <a name="l00063"></a>00063 <span class="keyword">using namespace </span>std;
89
- <a name="l00064"></a>00064 <span class="keyword">using namespace </span>boost;
90
- <a name="l00065"></a>00065 <span class="keyword">using namespace </span>oxt;
91
- <a name="l00066"></a>00066 <span class="comment"></span>
92
- <a name="l00067"></a>00067 <span class="comment">/**</span>
93
- <a name="l00068"></a>00068 <span class="comment"> * An AbstractSpawnManager implementation.</span>
94
- <a name="l00069"></a>00069 <span class="comment"> *</span>
95
- <a name="l00070"></a>00070 <span class="comment"> * Internally, this class makes use of a spawn server, which is written in Ruby. This server</span>
96
- <a name="l00071"></a>00071 <span class="comment"> * is automatically started when a SpawnManager instance is created, and automatically</span>
97
- <a name="l00072"></a>00072 <span class="comment"> * shutdown when that instance is destroyed. The existance of the spawn server is almost</span>
98
- <a name="l00073"></a>00073 <span class="comment"> * totally transparent to users of this class. Spawn requests are sent to the server,</span>
99
- <a name="l00074"></a>00074 <span class="comment"> * and details about the spawned process is returned.</span>
100
- <a name="l00075"></a>00075 <span class="comment"> *</span>
101
- <a name="l00076"></a>00076 <span class="comment"> * If the spawn server dies during the middle of an operation, it will be restarted.</span>
102
- <a name="l00077"></a>00077 <span class="comment"> * See spawn() for full details.</span>
103
- <a name="l00078"></a>00078 <span class="comment"> *</span>
104
- <a name="l00079"></a>00079 <span class="comment"> * The communication channel with the server is anonymous, i.e. no other processes</span>
105
- <a name="l00080"></a>00080 <span class="comment"> * can access the communication channel, so communication is guaranteed to be safe</span>
106
- <a name="l00081"></a>00081 <span class="comment"> * (unless, of course, if the spawn server itself is a trojan).</span>
107
- <a name="l00082"></a><a class="code" href="classPassenger_1_1SpawnManager.html">00082</a> <span class="comment"> *</span>
108
- <a name="l00083"></a>00083 <span class="comment"> * The server will try to keep the spawning time as small as possible, by keeping</span>
109
- <a name="l00084"></a>00084 <span class="comment"> * corresponding Ruby on Rails frameworks and application code in memory. So the second</span>
110
- <a name="l00085"></a>00085 <span class="comment"> * time a process of the same application is spawned, the spawn time is significantly</span>
111
- <a name="l00086"></a>00086 <span class="comment"> * lower than the first time. Nevertheless, spawning is a relatively expensive operation</span>
112
- <a name="l00087"></a>00087 <span class="comment"> * (compared to the processing of a typical HTTP request/response), and so should be</span>
113
- <a name="l00088"></a>00088 <span class="comment"> * avoided whenever possible.</span>
114
- <a name="l00089"></a>00089 <span class="comment"> *</span>
115
- <a name="l00090"></a>00090 <span class="comment"> * See the documentation of the spawn server for full implementation details.</span>
116
- <a name="l00091"></a>00091 <span class="comment"> *</span>
117
- <a name="l00092"></a>00092 <span class="comment"> * @ingroup Support</span>
118
- <a name="l00093"></a>00093 <span class="comment"> */</span>
119
- <a name="l00094"></a>00094 <span class="keyword">class </span><a class="code" href="classPassenger_1_1SpawnManager.html" title="An AbstractSpawnManager implementation.">SpawnManager</a>: <span class="keyword">public</span> <a class="code" href="classPassenger_1_1AbstractSpawnManager.html" title="Spawning of application processes.">AbstractSpawnManager</a> {
120
- <a name="l00095"></a>00095 <span class="keyword">private</span>:
121
- <a name="l00096"></a>00096 <span class="keyword">static</span> <span class="keyword">const</span> <span class="keywordtype">int</span> SERVER_SOCKET_FD = 3;
122
- <a name="l00097"></a>00097 <span class="keyword">static</span> <span class="keyword">const</span> <span class="keywordtype">int</span> OWNER_SOCKET_FD = 4;
123
- <a name="l00098"></a>00098 <span class="keyword">static</span> <span class="keyword">const</span> <span class="keywordtype">int</span> HIGHEST_FD = OWNER_SOCKET_FD;
124
- <a name="l00099"></a>00099
125
- <a name="l00100"></a>00100 <span class="keywordtype">string</span> spawnServerCommand;
126
- <a name="l00101"></a>00101 ServerInstanceDir::GenerationPtr generation;
127
- <a name="l00102"></a>00102 AccountsDatabasePtr accountsDatabase;
128
- <a name="l00103"></a>00103 <span class="keywordtype">string</span> rubyCommand;
129
- <a name="l00104"></a>00104 AnalyticsLoggerPtr analyticsLogger;
130
- <a name="l00105"></a>00105 <span class="keywordtype">int</span> logLevel;
131
- <a name="l00106"></a>00106 <span class="keywordtype">string</span> debugLogFile;
132
- <a name="l00107"></a>00107
133
- <a name="l00108"></a>00108 boost::mutex lock;
134
- <a name="l00109"></a>00109 <a class="code" href="classPassenger_1_1RandomGenerator.html" title="A random data generator.">RandomGenerator</a> random;
135
- <a name="l00110"></a>00110
136
- <a name="l00111"></a>00111 pid_t pid;
137
- <a name="l00112"></a>00112 <a class="code" href="classPassenger_1_1FileDescriptor.html" title="Wrapper class around a file descriptor integer, for RAII behavior.">FileDescriptor</a> ownerSocket;
138
- <a name="l00113"></a>00113 <span class="keywordtype">string</span> socketFilename;
139
- <a name="l00114"></a>00114 <span class="keywordtype">string</span> socketPassword;
140
- <a name="l00115"></a>00115 <span class="keywordtype">bool</span> serverNeedsRestart;
141
- <a name="l00116"></a>00116
142
- <a name="l00117"></a>00117 <span class="keyword">static</span> <span class="keywordtype">void</span> deleteAccount(AccountsDatabasePtr accountsDatabase, <span class="keyword">const</span> <span class="keywordtype">string</span> &amp;username) {
143
- <a name="l00118"></a>00118 accountsDatabase-&gt;remove(username);
144
- <a name="l00119"></a>00119 }
145
- <a name="l00120"></a>00120 <span class="comment"></span>
146
- <a name="l00121"></a>00121 <span class="comment"> /**</span>
147
- <a name="l00122"></a>00122 <span class="comment"> * Restarts the spawn server.</span>
148
- <a name="l00123"></a>00123 <span class="comment"> *</span>
149
- <a name="l00124"></a>00124 <span class="comment"> * @pre System call interruption is disabled.</span>
150
- <a name="l00125"></a>00125 <span class="comment"> * @throws RuntimeException An error occurred while creating a Unix server socket.</span>
151
- <a name="l00126"></a>00126 <span class="comment"> * @throws SystemException An error occured while trying to setup the spawn server.</span>
152
- <a name="l00127"></a>00127 <span class="comment"> * @throws IOException An error occurred while generating random data.</span>
153
- <a name="l00128"></a>00128 <span class="comment"> */</span>
154
- <a name="l00129"></a>00129 <span class="keywordtype">void</span> restartServer() {
155
- <a name="l00130"></a>00130 TRACE_POINT();
156
- <a name="l00131"></a>00131 <span class="keywordflow">if</span> (pid != 0) {
157
- <a name="l00132"></a>00132 UPDATE_TRACE_POINT();
158
- <a name="l00133"></a>00133 ownerSocket.<a class="code" href="classPassenger_1_1FileDescriptor.html#a02062f3cfb689b32781e11114c0abe5b" title="Close the underlying file descriptor.">close</a>();
159
- <a name="l00134"></a>00134
160
- <a name="l00135"></a>00135 <span class="comment">/* Wait at most 5 seconds for the spawn server to exit.</span>
161
- <a name="l00136"></a>00136 <span class="comment"> * If that doesn&#39;t work, kill it, then wait at most 5 seconds</span>
162
- <a name="l00137"></a>00137 <span class="comment"> * for it to exit.</span>
163
- <a name="l00138"></a>00138 <span class="comment"> */</span>
164
- <a name="l00139"></a>00139 time_t begin = syscalls::time(NULL);
165
- <a name="l00140"></a>00140 <span class="keywordtype">bool</span> done = <span class="keyword">false</span>;
166
- <a name="l00141"></a>00141 <span class="keywordflow">while</span> (!done &amp;&amp; syscalls::time(NULL) - begin &lt; 5) {
167
- <a name="l00142"></a>00142 <span class="keywordflow">if</span> (syscalls::waitpid(pid, NULL, WNOHANG) &gt; 0) {
168
- <a name="l00143"></a>00143 done = <span class="keyword">true</span>;
169
- <a name="l00144"></a>00144 } <span class="keywordflow">else</span> {
170
- <a name="l00145"></a>00145 syscalls::usleep(100000);
171
- <a name="l00146"></a>00146 }
172
- <a name="l00147"></a>00147 }
173
- <a name="l00148"></a>00148 UPDATE_TRACE_POINT();
174
- <a name="l00149"></a>00149 <span class="keywordflow">if</span> (!done) {
175
- <a name="l00150"></a>00150 UPDATE_TRACE_POINT();
176
- <a name="l00151"></a>00151 P_TRACE(2, <span class="stringliteral">&quot;Spawn server did not exit in time, killing it...&quot;</span>);
177
- <a name="l00152"></a>00152 syscalls::kill(pid, SIGTERM);
178
- <a name="l00153"></a>00153 begin = syscalls::time(NULL);
179
- <a name="l00154"></a>00154 <span class="keywordflow">while</span> (syscalls::time(NULL) - begin &lt; 5) {
180
- <a name="l00155"></a>00155 <span class="keywordflow">if</span> (syscalls::waitpid(pid, NULL, WNOHANG) &gt; 0) {
181
- <a name="l00156"></a>00156 <span class="keywordflow">break</span>;
182
- <a name="l00157"></a>00157 } <span class="keywordflow">else</span> {
183
- <a name="l00158"></a>00158 syscalls::usleep(100000);
184
- <a name="l00159"></a>00159 }
185
- <a name="l00160"></a>00160 }
186
- <a name="l00161"></a>00161 }
187
- <a name="l00162"></a>00162 pid = 0;
188
- <a name="l00163"></a>00163 }
189
- <a name="l00164"></a>00164
190
- <a name="l00165"></a>00165 <a class="code" href="classPassenger_1_1FileDescriptor.html" title="Wrapper class around a file descriptor integer, for RAII behavior.">FileDescriptor</a> serverSocket;
191
- <a name="l00166"></a>00166 <span class="keywordtype">string</span> socketFilename;
192
- <a name="l00167"></a>00167 <span class="keywordtype">string</span> socketPassword;
193
- <a name="l00168"></a>00168 <span class="keywordtype">int</span> ret, fds[2];
194
- <a name="l00169"></a>00169
195
- <a name="l00170"></a>00170 UPDATE_TRACE_POINT();
196
- <a name="l00171"></a>00171 socketFilename = generation-&gt;getPath() + <span class="stringliteral">&quot;/spawn-server/socket.&quot;</span> +
197
- <a name="l00172"></a>00172 toString(getpid()) + <span class="stringliteral">&quot;.&quot;</span> +
198
- <a name="l00173"></a>00173 pointerToIntString(<span class="keyword">this</span>);
199
- <a name="l00174"></a>00174 socketPassword = Base64::encode(random.generateByteString(32));
200
- <a name="l00175"></a>00175 serverSocket = createUnixServer(socketFilename.c_str());
201
- <a name="l00176"></a>00176 <span class="keywordflow">do</span> {
202
- <a name="l00177"></a>00177 ret = chmod(socketFilename.c_str(), S_IRUSR | S_IWUSR | S_IXUSR);
203
- <a name="l00178"></a>00178 } <span class="keywordflow">while</span> (ret == -1 &amp;&amp; errno == EINTR);
204
- <a name="l00179"></a>00179 <span class="keywordflow">if</span> (ret == -1) {
205
- <a name="l00180"></a>00180 <span class="keywordtype">int</span> e = errno;
206
- <a name="l00181"></a>00181 syscalls::unlink(socketFilename.c_str());
207
- <a name="l00182"></a>00182 <span class="keywordflow">throw</span> <a class="code" href="classPassenger_1_1FileSystemException.html" title="A filesystem error, as returned by the operating system.">FileSystemException</a>(<span class="stringliteral">&quot;Cannot set permissions on &#39;&quot;</span> + socketFilename + <span class="stringliteral">&quot;&#39;&quot;</span>,
208
- <a name="l00183"></a>00183 e, socketFilename);
209
- <a name="l00184"></a>00184 }
210
- <a name="l00185"></a>00185
211
- <a name="l00186"></a>00186 <span class="keywordflow">if</span> (syscalls::socketpair(AF_UNIX, SOCK_STREAM, 0, fds) == -1) {
212
- <a name="l00187"></a>00187 <span class="keywordtype">int</span> e = errno;
213
- <a name="l00188"></a>00188 syscalls::unlink(socketFilename.c_str());
214
- <a name="l00189"></a>00189 <span class="keywordflow">throw</span> <a class="code" href="classPassenger_1_1SystemException.html" title="Represents an error returned by a system call or a standard library call.">SystemException</a>(<span class="stringliteral">&quot;Cannot create a Unix socket&quot;</span>, e);
215
- <a name="l00190"></a>00190 }
216
- <a name="l00191"></a>00191
217
- <a name="l00192"></a>00192 UPDATE_TRACE_POINT();
218
- <a name="l00193"></a>00193 pid = syscalls::fork();
219
- <a name="l00194"></a>00194 <span class="keywordflow">if</span> (pid == 0) {
220
- <a name="l00195"></a>00195 dup2(serverSocket, HIGHEST_FD + 1);
221
- <a name="l00196"></a>00196 dup2(fds[1], HIGHEST_FD + 2);
222
- <a name="l00197"></a>00197 dup2(HIGHEST_FD + 1, SERVER_SOCKET_FD);
223
- <a name="l00198"></a>00198 dup2(HIGHEST_FD + 2, OWNER_SOCKET_FD);
224
- <a name="l00199"></a>00199
225
- <a name="l00200"></a>00200 <span class="comment">// Close all unnecessary file descriptors</span>
226
- <a name="l00201"></a>00201 <span class="keywordflow">for</span> (<span class="keywordtype">long</span> i = sysconf(_SC_OPEN_MAX) - 1; i &gt; HIGHEST_FD; i--) {
227
- <a name="l00202"></a>00202 close(i);
228
- <a name="l00203"></a>00203 }
229
- <a name="l00204"></a>00204
230
- <a name="l00205"></a>00205 execlp(rubyCommand.c_str(),
231
- <a name="l00206"></a>00206 rubyCommand.c_str(),
232
- <a name="l00207"></a>00207 spawnServerCommand.c_str(),
233
- <a name="l00208"></a>00208 <span class="comment">/* The spawn server changes the process names of the subservers</span>
234
- <a name="l00209"></a>00209 <span class="comment"> * that it starts, for better usability. However, the process name length</span>
235
- <a name="l00210"></a>00210 <span class="comment"> * (as shown by ps) is limited. Here, we try to expand that limit by</span>
236
- <a name="l00211"></a>00211 <span class="comment"> * deliberately passing a useless whitespace string to the spawn server.</span>
237
- <a name="l00212"></a>00212 <span class="comment"> * This argument is ignored by the spawn server. This works on some</span>
238
- <a name="l00213"></a>00213 <span class="comment"> * systems, such as Ubuntu Linux.</span>
239
- <a name="l00214"></a>00214 <span class="comment"> */</span>
240
- <a name="l00215"></a>00215 <span class="stringliteral">&quot; &quot;</span>,
241
- <a name="l00216"></a>00216 (<span class="keywordtype">char</span> *) NULL);
242
- <a name="l00217"></a>00217 <span class="keywordtype">int</span> e = errno;
243
- <a name="l00218"></a>00218 fprintf(stderr, <span class="stringliteral">&quot;*** Passenger ERROR (%s:%d):\n&quot;</span>
244
- <a name="l00219"></a>00219 <span class="stringliteral">&quot;Could not start the spawn server: %s: %s (%d)\n&quot;</span>,
245
- <a name="l00220"></a>00220 __FILE__, __LINE__,
246
- <a name="l00221"></a>00221 rubyCommand.c_str(), strerror(e), e);
247
- <a name="l00222"></a>00222 fflush(stderr);
248
- <a name="l00223"></a>00223 _exit(1);
249
- <a name="l00224"></a>00224 } <span class="keywordflow">else</span> <span class="keywordflow">if</span> (pid == -1) {
250
- <a name="l00225"></a>00225 <span class="keywordtype">int</span> e = errno;
251
- <a name="l00226"></a>00226 syscalls::unlink(socketFilename.c_str());
252
- <a name="l00227"></a>00227 syscalls::close(fds[0]);
253
- <a name="l00228"></a>00228 syscalls::close(fds[1]);
254
- <a name="l00229"></a>00229 pid = 0;
255
- <a name="l00230"></a>00230 <span class="keywordflow">throw</span> <a class="code" href="classPassenger_1_1SystemException.html" title="Represents an error returned by a system call or a standard library call.">SystemException</a>(<span class="stringliteral">&quot;Unable to fork a process&quot;</span>, e);
256
- <a name="l00231"></a>00231 } <span class="keywordflow">else</span> {
257
- <a name="l00232"></a>00232 <a class="code" href="classPassenger_1_1FileDescriptor.html" title="Wrapper class around a file descriptor integer, for RAII behavior.">FileDescriptor</a> ownerSocket = fds[0];
258
- <a name="l00233"></a>00233 syscalls::close(fds[1]);
259
- <a name="l00234"></a>00234 serverSocket.close();
260
- <a name="l00235"></a>00235
261
- <a name="l00236"></a>00236 <span class="comment">// Pass arguments to spawn server.</span>
262
- <a name="l00237"></a>00237 writeExact(ownerSocket, socketFilename + <span class="stringliteral">&quot;\n&quot;</span>);
263
- <a name="l00238"></a>00238 writeExact(ownerSocket, socketPassword + <span class="stringliteral">&quot;\n&quot;</span>);
264
- <a name="l00239"></a>00239 writeExact(ownerSocket, generation-&gt;getPath() + <span class="stringliteral">&quot;\n&quot;</span>);
265
- <a name="l00240"></a>00240 <span class="keywordflow">if</span> (analyticsLogger != NULL) {
266
- <a name="l00241"></a>00241 writeExact(ownerSocket, analyticsLogger-&gt;getAddress() + <span class="stringliteral">&quot;\n&quot;</span>);
267
- <a name="l00242"></a>00242 writeExact(ownerSocket, analyticsLogger-&gt;getUsername() + <span class="stringliteral">&quot;\n&quot;</span>);
268
- <a name="l00243"></a>00243 writeExact(ownerSocket, Base64::encode(analyticsLogger-&gt;getPassword()) + <span class="stringliteral">&quot;\n&quot;</span>);
269
- <a name="l00244"></a>00244 writeExact(ownerSocket, analyticsLogger-&gt;getNodeName() + <span class="stringliteral">&quot;\n&quot;</span>);
270
- <a name="l00245"></a>00245 } <span class="keywordflow">else</span> {
271
- <a name="l00246"></a>00246 writeExact(ownerSocket, <span class="stringliteral">&quot;\n&quot;</span>);
272
- <a name="l00247"></a>00247 writeExact(ownerSocket, <span class="stringliteral">&quot;\n&quot;</span>);
273
- <a name="l00248"></a>00248 writeExact(ownerSocket, <span class="stringliteral">&quot;\n&quot;</span>);
274
- <a name="l00249"></a>00249 writeExact(ownerSocket, <span class="stringliteral">&quot;\n&quot;</span>);
275
- <a name="l00250"></a>00250 }
276
- <a name="l00251"></a>00251 writeExact(ownerSocket, toString(logLevel) + <span class="stringliteral">&quot;\n&quot;</span>);
277
- <a name="l00252"></a>00252 writeExact(ownerSocket, debugLogFile + <span class="stringliteral">&quot;\n&quot;</span>);
278
- <a name="l00253"></a>00253
279
- <a name="l00254"></a>00254 this-&gt;ownerSocket = ownerSocket;
280
- <a name="l00255"></a>00255 this-&gt;socketFilename = socketFilename;
281
- <a name="l00256"></a>00256 this-&gt;socketPassword = socketPassword;
282
- <a name="l00257"></a>00257 <a class="code" href="classPassenger_1_1SpawnManager.html#ab4dfcb11c58b07d8144b18dd99abed45" title="A method which is called after the spawn server has started.">spawnServerStarted</a>();
283
- <a name="l00258"></a>00258 }
284
- <a name="l00259"></a>00259 }
285
- <a name="l00260"></a>00260 <span class="comment"></span>
286
- <a name="l00261"></a>00261 <span class="comment"> /**</span>
287
- <a name="l00262"></a>00262 <span class="comment"> * Connects to the spawn server and returns the connection.</span>
288
- <a name="l00263"></a>00263 <span class="comment"> *</span>
289
- <a name="l00264"></a>00264 <span class="comment"> * @throws RuntimeException</span>
290
- <a name="l00265"></a>00265 <span class="comment"> * @throws SystemException</span>
291
- <a name="l00266"></a>00266 <span class="comment"> * @throws boost::thread_interrupted</span>
292
- <a name="l00267"></a>00267 <span class="comment"> */</span>
293
- <a name="l00268"></a>00268 <a class="code" href="classPassenger_1_1FileDescriptor.html" title="Wrapper class around a file descriptor integer, for RAII behavior.">FileDescriptor</a> connect()<span class="keyword"> const </span>{
294
- <a name="l00269"></a>00269 TRACE_POINT();
295
- <a name="l00270"></a>00270 <a class="code" href="classPassenger_1_1FileDescriptor.html" title="Wrapper class around a file descriptor integer, for RAII behavior.">FileDescriptor</a> fd = connectToUnixServer(socketFilename.c_str());
296
- <a name="l00271"></a>00271 <a class="code" href="classPassenger_1_1MessageChannel.html" title="Convenience class for I/O operations on file descriptors.">MessageChannel</a> channel(fd);
297
- <a name="l00272"></a>00272 UPDATE_TRACE_POINT();
298
- <a name="l00273"></a>00273 channel.writeScalar(socketPassword);
299
- <a name="l00274"></a>00274 <span class="keywordflow">return</span> fd;
300
- <a name="l00275"></a>00275 }
301
- <a name="l00276"></a>00276 <span class="comment"></span>
302
- <a name="l00277"></a>00277 <span class="comment"> /**</span>
303
- <a name="l00278"></a>00278 <span class="comment"> * Send the spawn command to the spawn server.</span>
304
- <a name="l00279"></a>00279 <span class="comment"> *</span>
305
- <a name="l00280"></a>00280 <span class="comment"> * @param PoolOptions The spawn options to use.</span>
306
- <a name="l00281"></a>00281 <span class="comment"> * @return A Process smart pointer, representing the spawned process.</span>
307
- <a name="l00282"></a>00282 <span class="comment"> * @throws SpawnException Something went wrong.</span>
308
- <a name="l00283"></a>00283 <span class="comment"> * @throws Anything thrown by options.environmentVariables-&gt;getItems().</span>
309
- <a name="l00284"></a>00284 <span class="comment"> * @throws boost::thread_interrupted</span>
310
- <a name="l00285"></a>00285 <span class="comment"> */</span>
311
- <a name="l00286"></a>00286 <a class="code" href="namespacePassenger.html#aced1f248465136b313c6dec5fe6ca492" title="Convenient alias for Process smart pointer.">ProcessPtr</a> sendSpawnCommand(<span class="keyword">const</span> <a class="code" href="structPassenger_1_1PoolOptions.html" title="This struct encapsulates information for ApplicationPool::get() and for SpawnManager::spawn()...">PoolOptions</a> &amp;options) {
312
- <a name="l00287"></a>00287 TRACE_POINT();
313
- <a name="l00288"></a>00288 <a class="code" href="classPassenger_1_1FileDescriptor.html" title="Wrapper class around a file descriptor integer, for RAII behavior.">FileDescriptor</a> connection;
314
- <a name="l00289"></a>00289 <a class="code" href="classPassenger_1_1MessageChannel.html" title="Convenience class for I/O operations on file descriptors.">MessageChannel</a> channel;
315
- <a name="l00290"></a>00290
316
- <a name="l00291"></a>00291 P_DEBUG(<span class="stringliteral">&quot;Spawning a new application process for &quot;</span> &lt;&lt; options.<a class="code" href="structPassenger_1_1PoolOptions.html#a822039d204b48d9ed49184646734acf3" title="The root directory of the application to spawn.">appRoot</a> &lt;&lt; <span class="stringliteral">&quot;...&quot;</span>);
317
- <a name="l00292"></a>00292
318
- <a name="l00293"></a>00293 <span class="keywordflow">try</span> {
319
- <a name="l00294"></a>00294 connection = connect();
320
- <a name="l00295"></a>00295 channel = <a class="code" href="classPassenger_1_1MessageChannel.html" title="Convenience class for I/O operations on file descriptors.">MessageChannel</a>(connection);
321
- <a name="l00296"></a>00296 } <span class="keywordflow">catch</span> (<span class="keyword">const</span> <a class="code" href="classPassenger_1_1SystemException.html" title="Represents an error returned by a system call or a standard library call.">SystemException</a> &amp;e) {
322
- <a name="l00297"></a>00297 <span class="keywordflow">throw</span> <a class="code" href="classPassenger_1_1SpawnException.html" title="Thrown when SpawnManager or ApplicationPool fails to spawn an application instance...">SpawnException</a>(<span class="keywordtype">string</span>(<span class="stringliteral">&quot;Could not connect to the spawn server: &quot;</span>) +
323
- <a name="l00298"></a>00298 e.<a class="code" href="classPassenger_1_1SystemException.html#a0ef41d755fea2c9b1db2252e7c418dc8" title="Returns the system&amp;#39;s error message.">sys</a>());
324
- <a name="l00299"></a>00299 } <span class="keywordflow">catch</span> (<span class="keyword">const</span> std::exception &amp;e) {
325
- <a name="l00300"></a>00300 <span class="keywordflow">throw</span> <a class="code" href="classPassenger_1_1SpawnException.html" title="Thrown when SpawnManager or ApplicationPool fails to spawn an application instance...">SpawnException</a>(<span class="keywordtype">string</span>(<span class="stringliteral">&quot;Could not connect to the spawn server: &quot;</span>) +
326
- <a name="l00301"></a>00301 e.what());
327
- <a name="l00302"></a>00302 }
328
- <a name="l00303"></a>00303
329
- <a name="l00304"></a>00304 UPDATE_TRACE_POINT();
330
- <a name="l00305"></a>00305 vector&lt;string&gt; args;
331
- <a name="l00306"></a>00306 <span class="keywordtype">string</span> appRoot;
332
- <a name="l00307"></a>00307 pid_t appPid;
333
- <a name="l00308"></a>00308 <span class="keywordtype">int</span> i, nServerSockets, ownerPipe;
334
- <a name="l00309"></a>00309 Process::SocketInfoMap serverSockets;
335
- <a name="l00310"></a>00310 <span class="keywordtype">string</span> detachKey = random.<a class="code" href="classPassenger_1_1RandomGenerator.html#ad9d9a489f6dbfabafb35da326f5ed967" title="Generates a random string of size bytes which is also valid ASCII.">generateAsciiString</a>(43);
336
- <a name="l00311"></a>00311 <span class="comment">// The connect password must be a URL-friendly string because users will</span>
337
- <a name="l00312"></a>00312 <span class="comment">// insert it in HTTP headers.</span>
338
- <a name="l00313"></a>00313 <span class="keywordtype">string</span> connectPassword = random.<a class="code" href="classPassenger_1_1RandomGenerator.html#ad9d9a489f6dbfabafb35da326f5ed967" title="Generates a random string of size bytes which is also valid ASCII.">generateAsciiString</a>(43);
339
- <a name="l00314"></a>00314 <span class="keywordtype">string</span> gupid = integerToHex(SystemTime::get() / 60) + <span class="stringliteral">&quot;-&quot;</span> +
340
- <a name="l00315"></a>00315 random.<a class="code" href="classPassenger_1_1RandomGenerator.html#ad9d9a489f6dbfabafb35da326f5ed967" title="Generates a random string of size bytes which is also valid ASCII.">generateAsciiString</a>(11);
341
- <a name="l00316"></a>00316 AccountPtr account;
342
- <a name="l00317"></a>00317 function&lt;void ()&gt; destructionCallback;
343
- <a name="l00318"></a>00318
344
- <a name="l00319"></a>00319 <span class="keywordflow">try</span> {
345
- <a name="l00320"></a>00320 args.push_back(<span class="stringliteral">&quot;spawn_application&quot;</span>);
346
- <a name="l00321"></a>00321 options.<a class="code" href="structPassenger_1_1PoolOptions.html#a437e077b0ab037f4e86680e9164a694e" title="Append the information in this PoolOptions object to the given string vector.">toVector</a>(args);
347
- <a name="l00322"></a>00322
348
- <a name="l00323"></a>00323 args.push_back(<span class="stringliteral">&quot;detach_key&quot;</span>);
349
- <a name="l00324"></a>00324 args.push_back(detachKey);
350
- <a name="l00325"></a>00325 args.push_back(<span class="stringliteral">&quot;connect_password&quot;</span>);
351
- <a name="l00326"></a>00326 args.push_back(connectPassword);
352
- <a name="l00327"></a>00327 <span class="keywordflow">if</span> (accountsDatabase != NULL) {
353
- <a name="l00328"></a>00328 <span class="keywordtype">string</span> username = <span class="stringliteral">&quot;_backend-&quot;</span> + toString(accountsDatabase-&gt;getUniqueNumber());
354
- <a name="l00329"></a>00329 <span class="keywordtype">string</span> password = random.generateByteString(MESSAGE_SERVER_MAX_PASSWORD_SIZE);
355
- <a name="l00330"></a>00330 account = accountsDatabase-&gt;add(username, password, <span class="keyword">false</span>, options.<a class="code" href="structPassenger_1_1PoolOptions.html#a45665fffc8a20ea60a3fcafaff8627ab" title="Any rights that the spawned application process may have.">rights</a>);
356
- <a name="l00331"></a>00331 destructionCallback = boost::bind(&amp;SpawnManager::deleteAccount,
357
- <a name="l00332"></a>00332 accountsDatabase, username);
358
- <a name="l00333"></a>00333
359
- <a name="l00334"></a>00334 args.push_back(<span class="stringliteral">&quot;pool_account_username&quot;</span>);
360
- <a name="l00335"></a>00335 args.push_back(username);
361
- <a name="l00336"></a>00336 args.push_back(<span class="stringliteral">&quot;pool_account_password_base64&quot;</span>);
362
- <a name="l00337"></a>00337 args.push_back(Base64::encode(password));
363
- <a name="l00338"></a>00338 }
364
- <a name="l00339"></a>00339
365
- <a name="l00340"></a>00340 channel.<a class="code" href="classPassenger_1_1MessageChannel.html#a150f68bc47e060dcc6ca35bee047914d" title="Send an array message, which consists of the given elements, over the underlying...">write</a>(args);
366
- <a name="l00341"></a>00341 } <span class="keywordflow">catch</span> (<span class="keyword">const</span> <a class="code" href="classPassenger_1_1SystemException.html" title="Represents an error returned by a system call or a standard library call.">SystemException</a> &amp;e) {
367
- <a name="l00342"></a>00342 <span class="keywordflow">throw</span> <a class="code" href="classPassenger_1_1SpawnException.html" title="Thrown when SpawnManager or ApplicationPool fails to spawn an application instance...">SpawnException</a>(<span class="keywordtype">string</span>(<span class="stringliteral">&quot;Could not write &#39;spawn_application&#39; &quot;</span>
368
- <a name="l00343"></a>00343 <span class="stringliteral">&quot;command to the spawn server: &quot;</span>) + e.<a class="code" href="classPassenger_1_1SystemException.html#a0ef41d755fea2c9b1db2252e7c418dc8" title="Returns the system&amp;#39;s error message.">sys</a>());
369
- <a name="l00344"></a>00344 }
370
- <a name="l00345"></a>00345
371
- <a name="l00346"></a>00346 <span class="keywordflow">try</span> {
372
- <a name="l00347"></a>00347 UPDATE_TRACE_POINT();
373
- <a name="l00348"></a>00348 <span class="comment">// Read status.</span>
374
- <a name="l00349"></a>00349 <span class="keywordflow">if</span> (!channel.<a class="code" href="classPassenger_1_1MessageChannel.html#a129659b60d1a663337873d2af944431e" title="Read an array message from the underlying file descriptor.">read</a>(args)) {
375
- <a name="l00350"></a>00350 <span class="keywordflow">throw</span> <a class="code" href="classPassenger_1_1SpawnException.html" title="Thrown when SpawnManager or ApplicationPool fails to spawn an application instance...">SpawnException</a>(<span class="stringliteral">&quot;The spawn server has exited unexpectedly.&quot;</span>);
376
- <a name="l00351"></a>00351 }
377
- <a name="l00352"></a>00352 <span class="keywordflow">if</span> (args.size() != 1) {
378
- <a name="l00353"></a>00353 <span class="keywordflow">throw</span> <a class="code" href="classPassenger_1_1SpawnException.html" title="Thrown when SpawnManager or ApplicationPool fails to spawn an application instance...">SpawnException</a>(<span class="stringliteral">&quot;The spawn server sent an invalid message.&quot;</span>);
379
- <a name="l00354"></a>00354 }
380
- <a name="l00355"></a>00355 <span class="keywordflow">if</span> (args[0] == <span class="stringliteral">&quot;error_page&quot;</span>) {
381
- <a name="l00356"></a>00356 UPDATE_TRACE_POINT();
382
- <a name="l00357"></a>00357 <span class="keywordtype">string</span> errorPage;
383
- <a name="l00358"></a>00358
384
- <a name="l00359"></a>00359 <span class="keywordflow">if</span> (!channel.<a class="code" href="classPassenger_1_1MessageChannel.html#a1f3cf672b566166ed920c2bba4d19604" title="Read a scalar message from the underlying file descriptor.">readScalar</a>(errorPage)) {
385
- <a name="l00360"></a>00360 <span class="keywordflow">throw</span> <a class="code" href="classPassenger_1_1SpawnException.html" title="Thrown when SpawnManager or ApplicationPool fails to spawn an application instance...">SpawnException</a>(<span class="stringliteral">&quot;The spawn server has exited unexpectedly.&quot;</span>);
386
- <a name="l00361"></a>00361 }
387
- <a name="l00362"></a>00362 <span class="keywordflow">throw</span> <a class="code" href="classPassenger_1_1SpawnException.html" title="Thrown when SpawnManager or ApplicationPool fails to spawn an application instance...">SpawnException</a>(<span class="stringliteral">&quot;An error occured while spawning the application.&quot;</span>,
388
- <a name="l00363"></a>00363 errorPage);
389
- <a name="l00364"></a>00364 } <span class="keywordflow">else</span> <span class="keywordflow">if</span> (args[0] != <span class="stringliteral">&quot;ok&quot;</span>) {
390
- <a name="l00365"></a>00365 <span class="keywordflow">throw</span> <a class="code" href="classPassenger_1_1SpawnException.html" title="Thrown when SpawnManager or ApplicationPool fails to spawn an application instance...">SpawnException</a>(<span class="stringliteral">&quot;The spawn server sent an invalid message.&quot;</span>);
391
- <a name="l00366"></a>00366 }
392
- <a name="l00367"></a>00367
393
- <a name="l00368"></a>00368 <span class="comment">// Read application info.</span>
394
- <a name="l00369"></a>00369 UPDATE_TRACE_POINT();
395
- <a name="l00370"></a>00370 <span class="keywordflow">if</span> (!channel.<a class="code" href="classPassenger_1_1MessageChannel.html#a129659b60d1a663337873d2af944431e" title="Read an array message from the underlying file descriptor.">read</a>(args)) {
396
- <a name="l00371"></a>00371 <span class="keywordflow">throw</span> <a class="code" href="classPassenger_1_1SpawnException.html" title="Thrown when SpawnManager or ApplicationPool fails to spawn an application instance...">SpawnException</a>(<span class="stringliteral">&quot;The spawn server has exited unexpectedly.&quot;</span>);
397
- <a name="l00372"></a>00372 }
398
- <a name="l00373"></a>00373 <span class="keywordflow">if</span> (args.size() != 3) {
399
- <a name="l00374"></a>00374 <span class="keywordflow">throw</span> <a class="code" href="classPassenger_1_1SpawnException.html" title="Thrown when SpawnManager or ApplicationPool fails to spawn an application instance...">SpawnException</a>(<span class="stringliteral">&quot;The spawn server sent an invalid message.&quot;</span>);
400
- <a name="l00375"></a>00375 }
401
- <a name="l00376"></a>00376
402
- <a name="l00377"></a>00377 appRoot = args[0];
403
- <a name="l00378"></a>00378 appPid = (pid_t) stringToULL(args[1]);
404
- <a name="l00379"></a>00379 nServerSockets = atoi(args[2]);
405
- <a name="l00380"></a>00380
406
- <a name="l00381"></a>00381 UPDATE_TRACE_POINT();
407
- <a name="l00382"></a>00382 <span class="keywordflow">for</span> (i = 0; i &lt; nServerSockets; i++) {
408
- <a name="l00383"></a>00383 <span class="keywordflow">if</span> (!channel.<a class="code" href="classPassenger_1_1MessageChannel.html#a129659b60d1a663337873d2af944431e" title="Read an array message from the underlying file descriptor.">read</a>(args)) {
409
- <a name="l00384"></a>00384 <span class="keywordflow">throw</span> <a class="code" href="classPassenger_1_1SpawnException.html" title="Thrown when SpawnManager or ApplicationPool fails to spawn an application instance...">SpawnException</a>(<span class="stringliteral">&quot;The spawn server has exited unexpectedly.&quot;</span>);
410
- <a name="l00385"></a>00385 }
411
- <a name="l00386"></a>00386 <span class="keywordflow">if</span> (args.size() != 3) {
412
- <a name="l00387"></a>00387 <span class="keywordflow">throw</span> <a class="code" href="classPassenger_1_1SpawnException.html" title="Thrown when SpawnManager or ApplicationPool fails to spawn an application instance...">SpawnException</a>(<span class="stringliteral">&quot;The spawn server sent an invalid message.&quot;</span>);
413
- <a name="l00388"></a>00388 }
414
- <a name="l00389"></a>00389 serverSockets[args[0]] = Process::SocketInfo(args[1], args[2]);
415
- <a name="l00390"></a>00390 }
416
- <a name="l00391"></a>00391 <span class="keywordflow">if</span> (serverSockets.find(<span class="stringliteral">&quot;main&quot;</span>) == serverSockets.end()) {
417
- <a name="l00392"></a>00392 UPDATE_TRACE_POINT();
418
- <a name="l00393"></a>00393 <span class="keywordflow">throw</span> <a class="code" href="classPassenger_1_1SpawnException.html" title="Thrown when SpawnManager or ApplicationPool fails to spawn an application instance...">SpawnException</a>(<span class="stringliteral">&quot;The spawn server sent an invalid message.&quot;</span>);
419
- <a name="l00394"></a>00394 }
420
- <a name="l00395"></a>00395 } <span class="keywordflow">catch</span> (<span class="keyword">const</span> <a class="code" href="classPassenger_1_1SystemException.html" title="Represents an error returned by a system call or a standard library call.">SystemException</a> &amp;e) {
421
- <a name="l00396"></a>00396 <span class="keywordflow">throw</span> <a class="code" href="classPassenger_1_1SpawnException.html" title="Thrown when SpawnManager or ApplicationPool fails to spawn an application instance...">SpawnException</a>(<span class="keywordtype">string</span>(<span class="stringliteral">&quot;Could not read from the spawn server: &quot;</span>) + e.<a class="code" href="classPassenger_1_1SystemException.html#a0ef41d755fea2c9b1db2252e7c418dc8" title="Returns the system&amp;#39;s error message.">sys</a>());
422
- <a name="l00397"></a>00397 }
423
- <a name="l00398"></a>00398
424
- <a name="l00399"></a>00399 UPDATE_TRACE_POINT();
425
- <a name="l00400"></a>00400 <span class="keywordflow">try</span> {
426
- <a name="l00401"></a>00401 ownerPipe = channel.<a class="code" href="classPassenger_1_1MessageChannel.html#a1a28ba9d078f38f2831673092ac9dcbc" title="Receive a file descriptor, which had been passed over the underlying file descriptor...">readFileDescriptor</a>();
427
- <a name="l00402"></a>00402 } <span class="keywordflow">catch</span> (<span class="keyword">const</span> <a class="code" href="classPassenger_1_1SystemException.html" title="Represents an error returned by a system call or a standard library call.">SystemException</a> &amp;e) {
428
- <a name="l00403"></a>00403 <span class="keywordflow">throw</span> <a class="code" href="classPassenger_1_1SpawnException.html" title="Thrown when SpawnManager or ApplicationPool fails to spawn an application instance...">SpawnException</a>(<span class="keywordtype">string</span>(<span class="stringliteral">&quot;Could not receive the spawned &quot;</span>
429
- <a name="l00404"></a>00404 <span class="stringliteral">&quot;application&#39;s owner pipe from the spawn server: &quot;</span>) +
430
- <a name="l00405"></a>00405 e.<a class="code" href="classPassenger_1_1SystemException.html#a0ef41d755fea2c9b1db2252e7c418dc8" title="Returns the system&amp;#39;s error message.">sys</a>());
431
- <a name="l00406"></a>00406 } <span class="keywordflow">catch</span> (<span class="keyword">const</span> <a class="code" href="classPassenger_1_1IOException.html" title="Represents an error that occured during an I/O operation.">IOException</a> &amp;e) {
432
- <a name="l00407"></a>00407 <span class="keywordflow">throw</span> <a class="code" href="classPassenger_1_1SpawnException.html" title="Thrown when SpawnManager or ApplicationPool fails to spawn an application instance...">SpawnException</a>(<span class="keywordtype">string</span>(<span class="stringliteral">&quot;Could not receive the spawned &quot;</span>
433
- <a name="l00408"></a>00408 <span class="stringliteral">&quot;application&#39;s owner pipe from the spawn server: &quot;</span>) +
434
- <a name="l00409"></a>00409 e.what());
435
- <a name="l00410"></a>00410 }
436
- <a name="l00411"></a>00411
437
- <a name="l00412"></a>00412 UPDATE_TRACE_POINT();
438
- <a name="l00413"></a>00413 P_DEBUG(<span class="stringliteral">&quot;Application process &quot;</span> &lt;&lt; appPid &lt;&lt; <span class="stringliteral">&quot; spawned&quot;</span>);
439
- <a name="l00414"></a>00414 <span class="keywordflow">return</span> <a class="code" href="namespacePassenger.html#aced1f248465136b313c6dec5fe6ca492" title="Convenient alias for Process smart pointer.">ProcessPtr</a>(<span class="keyword">new</span> <a class="code" href="classPassenger_1_1Process.html" title="Represents a single application process, as spawned by SpawnManager or by ApplicationPool::Interface...">Process</a>(appRoot, appPid, ownerPipe, serverSockets,
440
- <a name="l00415"></a>00415 detachKey, connectPassword, gupid, destructionCallback));
441
- <a name="l00416"></a>00416 }
442
- <a name="l00417"></a>00417 <span class="comment"></span>
443
- <a name="l00418"></a>00418 <span class="comment"> /**</span>
444
- <a name="l00419"></a>00419 <span class="comment"> * @throws boost::thread_interrupted</span>
445
- <a name="l00420"></a>00420 <span class="comment"> * @throws Anything thrown by options.environmentVariables-&gt;getItems().</span>
446
- <a name="l00421"></a>00421 <span class="comment"> */</span>
447
- <a name="l00422"></a>00422 <a class="code" href="namespacePassenger.html#aced1f248465136b313c6dec5fe6ca492" title="Convenient alias for Process smart pointer.">ProcessPtr</a>
448
- <a name="l00423"></a>00423 handleSpawnException(<span class="keyword">const</span> <a class="code" href="classPassenger_1_1SpawnException.html" title="Thrown when SpawnManager or ApplicationPool fails to spawn an application instance...">SpawnException</a> &amp;e, <span class="keyword">const</span> <a class="code" href="structPassenger_1_1PoolOptions.html" title="This struct encapsulates information for ApplicationPool::get() and for SpawnManager::spawn()...">PoolOptions</a> &amp;options) {
449
- <a name="l00424"></a>00424 TRACE_POINT();
450
- <a name="l00425"></a>00425 <span class="keywordtype">bool</span> restarted;
451
- <a name="l00426"></a>00426 <span class="keywordflow">try</span> {
452
- <a name="l00427"></a>00427 P_DEBUG(<span class="stringliteral">&quot;Spawn server died. Attempting to restart it...&quot;</span>);
453
- <a name="l00428"></a>00428 this_thread::disable_syscall_interruption dsi;
454
- <a name="l00429"></a>00429 restartServer();
455
- <a name="l00430"></a>00430 P_DEBUG(<span class="stringliteral">&quot;Restart seems to be successful.&quot;</span>);
456
- <a name="l00431"></a>00431 restarted = <span class="keyword">true</span>;
457
- <a name="l00432"></a>00432 } <span class="keywordflow">catch</span> (<span class="keyword">const</span> <a class="code" href="classPassenger_1_1IOException.html" title="Represents an error that occured during an I/O operation.">IOException</a> &amp;e) {
458
- <a name="l00433"></a>00433 P_DEBUG(<span class="stringliteral">&quot;Restart failed: &quot;</span> &lt;&lt; e.what());
459
- <a name="l00434"></a>00434 restarted = <span class="keyword">false</span>;
460
- <a name="l00435"></a>00435 } <span class="keywordflow">catch</span> (<span class="keyword">const</span> <a class="code" href="classPassenger_1_1SystemException.html" title="Represents an error returned by a system call or a standard library call.">SystemException</a> &amp;e) {
461
- <a name="l00436"></a>00436 P_DEBUG(<span class="stringliteral">&quot;Restart failed: &quot;</span> &lt;&lt; e.what());
462
- <a name="l00437"></a>00437 restarted = <span class="keyword">false</span>;
463
- <a name="l00438"></a>00438 }
464
- <a name="l00439"></a>00439 <span class="keywordflow">if</span> (restarted) {
465
- <a name="l00440"></a>00440 <span class="keywordflow">return</span> sendSpawnCommand(options);
466
- <a name="l00441"></a>00441 } <span class="keywordflow">else</span> {
467
- <a name="l00442"></a>00442 <span class="keywordflow">throw</span> <a class="code" href="classPassenger_1_1SpawnException.html" title="Thrown when SpawnManager or ApplicationPool fails to spawn an application instance...">SpawnException</a>(<span class="stringliteral">&quot;The spawn server died unexpectedly, and restarting it failed.&quot;</span>);
468
- <a name="l00443"></a>00443 }
469
- <a name="l00444"></a>00444 }
470
- <a name="l00445"></a>00445 <span class="comment"></span>
471
- <a name="l00446"></a>00446 <span class="comment"> /**</span>
472
- <a name="l00447"></a>00447 <span class="comment"> * Send the reload command to the spawn server.</span>
473
- <a name="l00448"></a>00448 <span class="comment"> *</span>
474
- <a name="l00449"></a>00449 <span class="comment"> * @param appRoot The application root to reload.</span>
475
- <a name="l00450"></a>00450 <span class="comment"> * @throws RuntimeException </span>
476
- <a name="l00451"></a>00451 <span class="comment"> * @throws SystemException</span>
477
- <a name="l00452"></a>00452 <span class="comment"> * @throws boost::thread_interrupted</span>
478
- <a name="l00453"></a>00453 <span class="comment"> */</span>
479
- <a name="l00454"></a>00454 <span class="keywordtype">void</span> sendReloadCommand(<span class="keyword">const</span> <span class="keywordtype">string</span> &amp;appRoot) {
480
- <a name="l00455"></a>00455 TRACE_POINT();
481
- <a name="l00456"></a>00456 <a class="code" href="classPassenger_1_1FileDescriptor.html" title="Wrapper class around a file descriptor integer, for RAII behavior.">FileDescriptor</a> connection;
482
- <a name="l00457"></a>00457 <a class="code" href="classPassenger_1_1MessageChannel.html" title="Convenience class for I/O operations on file descriptors.">MessageChannel</a> channel;
483
- <a name="l00458"></a>00458
484
- <a name="l00459"></a>00459 <span class="keywordflow">try</span> {
485
- <a name="l00460"></a>00460 connection = connect();
486
- <a name="l00461"></a>00461 channel = <a class="code" href="classPassenger_1_1MessageChannel.html" title="Convenience class for I/O operations on file descriptors.">MessageChannel</a>(connection);
487
- <a name="l00462"></a>00462 } <span class="keywordflow">catch</span> (<a class="code" href="classPassenger_1_1SystemException.html" title="Represents an error returned by a system call or a standard library call.">SystemException</a> &amp;e) {
488
- <a name="l00463"></a>00463 e.setBriefMessage(<span class="stringliteral">&quot;Could not connect to the spawn server&quot;</span>);
489
- <a name="l00464"></a>00464 <span class="keywordflow">throw</span>;
490
- <a name="l00465"></a>00465 } <span class="keywordflow">catch</span> (<span class="keyword">const</span> <a class="code" href="classPassenger_1_1RuntimeException.html" title="A generic runtime exception.">RuntimeException</a> &amp;e) {
491
- <a name="l00466"></a>00466 <span class="keywordflow">throw</span> <a class="code" href="classPassenger_1_1RuntimeException.html" title="A generic runtime exception.">RuntimeException</a>(<span class="keywordtype">string</span>(<span class="stringliteral">&quot;Could not connect to the spawn server: &quot;</span>) +
492
- <a name="l00467"></a>00467 e.what());
493
- <a name="l00468"></a>00468 }
494
- <a name="l00469"></a>00469
495
- <a name="l00470"></a>00470 <span class="keywordflow">try</span> {
496
- <a name="l00471"></a>00471 channel.<a class="code" href="classPassenger_1_1MessageChannel.html#a150f68bc47e060dcc6ca35bee047914d" title="Send an array message, which consists of the given elements, over the underlying...">write</a>(<span class="stringliteral">&quot;reload&quot;</span>, appRoot.c_str(), NULL);
497
- <a name="l00472"></a>00472 } <span class="keywordflow">catch</span> (<a class="code" href="classPassenger_1_1SystemException.html" title="Represents an error returned by a system call or a standard library call.">SystemException</a> &amp;e) {
498
- <a name="l00473"></a>00473 e.setBriefMessage(<span class="stringliteral">&quot;Could not write &#39;reload&#39; command to the spawn server&quot;</span>);
499
- <a name="l00474"></a>00474 <span class="keywordflow">throw</span>;
500
- <a name="l00475"></a>00475 }
501
- <a name="l00476"></a>00476 }
502
- <a name="l00477"></a>00477
503
- <a name="l00478"></a>00478 <span class="keywordtype">void</span> handleReloadException(<span class="keyword">const</span> <a class="code" href="classPassenger_1_1SystemException.html" title="Represents an error returned by a system call or a standard library call.">SystemException</a> &amp;e, <span class="keyword">const</span> <span class="keywordtype">string</span> &amp;appRoot) {
504
- <a name="l00479"></a>00479 TRACE_POINT();
505
- <a name="l00480"></a>00480 <span class="keywordtype">bool</span> restarted;
506
- <a name="l00481"></a>00481 <span class="keywordflow">try</span> {
507
- <a name="l00482"></a>00482 P_DEBUG(<span class="stringliteral">&quot;Spawn server died. Attempting to restart it...&quot;</span>);
508
- <a name="l00483"></a>00483 restartServer();
509
- <a name="l00484"></a>00484 P_DEBUG(<span class="stringliteral">&quot;Restart seems to be successful.&quot;</span>);
510
- <a name="l00485"></a>00485 restarted = <span class="keyword">true</span>;
511
- <a name="l00486"></a>00486 } <span class="keywordflow">catch</span> (<span class="keyword">const</span> <a class="code" href="classPassenger_1_1IOException.html" title="Represents an error that occured during an I/O operation.">IOException</a> &amp;e) {
512
- <a name="l00487"></a>00487 P_DEBUG(<span class="stringliteral">&quot;Restart failed: &quot;</span> &lt;&lt; e.what());
513
- <a name="l00488"></a>00488 restarted = <span class="keyword">false</span>;
514
- <a name="l00489"></a>00489 } <span class="keywordflow">catch</span> (<span class="keyword">const</span> <a class="code" href="classPassenger_1_1SystemException.html" title="Represents an error returned by a system call or a standard library call.">SystemException</a> &amp;e) {
515
- <a name="l00490"></a>00490 P_DEBUG(<span class="stringliteral">&quot;Restart failed: &quot;</span> &lt;&lt; e.what());
516
- <a name="l00491"></a>00491 restarted = <span class="keyword">false</span>;
517
- <a name="l00492"></a>00492 }
518
- <a name="l00493"></a>00493 <span class="keywordflow">if</span> (restarted) {
519
- <a name="l00494"></a>00494 <span class="keywordflow">return</span> sendReloadCommand(appRoot);
520
- <a name="l00495"></a>00495 } <span class="keywordflow">else</span> {
521
- <a name="l00496"></a>00496 <span class="keywordflow">throw</span> <a class="code" href="classPassenger_1_1SpawnException.html" title="Thrown when SpawnManager or ApplicationPool fails to spawn an application instance...">SpawnException</a>(<span class="stringliteral">&quot;The spawn server died unexpectedly, and restarting it failed.&quot;</span>);
522
- <a name="l00497"></a>00497 }
523
- <a name="l00498"></a>00498 }
524
- <a name="l00499"></a>00499
525
- <a name="l00500"></a>00500 <a class="code" href="classPassenger_1_1IOException.html" title="Represents an error that occured during an I/O operation.">IOException</a> prependMessageToException(<span class="keyword">const</span> <a class="code" href="classPassenger_1_1IOException.html" title="Represents an error that occured during an I/O operation.">IOException</a> &amp;e, <span class="keyword">const</span> <span class="keywordtype">string</span> &amp;message) {
526
- <a name="l00501"></a><a class="code" href="classPassenger_1_1SpawnManager.html#ab4dfcb11c58b07d8144b18dd99abed45">00501</a> <span class="keywordflow">return</span> <a class="code" href="classPassenger_1_1IOException.html" title="Represents an error that occured during an I/O operation.">IOException</a>(message + <span class="stringliteral">&quot;: &quot;</span> + e.what());
527
- <a name="l00502"></a>00502 }
528
- <a name="l00503"></a>00503
529
- <a name="l00504"></a>00504 <a class="code" href="classPassenger_1_1SystemException.html" title="Represents an error returned by a system call or a standard library call.">SystemException</a> prependMessageToException(<span class="keyword">const</span> <a class="code" href="classPassenger_1_1SystemException.html" title="Represents an error returned by a system call or a standard library call.">SystemException</a> &amp;e, <span class="keyword">const</span> <span class="keywordtype">string</span> &amp;message) {
530
- <a name="l00505"></a>00505 <span class="keywordflow">return</span> <a class="code" href="classPassenger_1_1SystemException.html" title="Represents an error returned by a system call or a standard library call.">SystemException</a>(message + <span class="stringliteral">&quot;: &quot;</span> + e.<a class="code" href="classPassenger_1_1SystemException.html#a84fa2ab4f5b7b96704734fcdfdaa0269" title="Returns a brief version of the exception message.">brief</a>(), e.<a class="code" href="classPassenger_1_1SystemException.html#aee7a6672bf79b72a4c3ee70c57d6a47c" title="The value of errno at the time the error occured.">code</a>());
531
- <a name="l00506"></a>00506 }
532
- <a name="l00507"></a>00507
533
- <a name="l00508"></a>00508 <span class="keyword">protected</span>:<span class="comment"></span>
534
- <a name="l00509"></a>00509 <span class="comment"> /**</span>
535
- <a name="l00510"></a>00510 <span class="comment"> * A method which is called after the spawn server has started.</span>
536
- <a name="l00511"></a>00511 <span class="comment"> * It doesn&#39;t do anything by default and serves as a hook for unit tests.</span>
537
- <a name="l00512"></a>00512 <span class="comment"> */</span>
538
- <a name="l00513"></a>00513 <span class="keyword">virtual</span> <span class="keywordtype">void</span> <a class="code" href="classPassenger_1_1SpawnManager.html#ab4dfcb11c58b07d8144b18dd99abed45" title="A method which is called after the spawn server has started.">spawnServerStarted</a>() { }
539
- <a name="l00514"></a>00514
540
- <a name="l00515"></a>00515 <span class="keyword">public</span>:<span class="comment"></span>
541
- <a name="l00516"></a>00516 <span class="comment"> /**</span>
542
- <a name="l00517"></a>00517 <span class="comment"> * Construct a new SpawnManager.</span>
543
- <a name="l00518"></a>00518 <span class="comment"> *</span>
544
- <a name="l00519"></a>00519 <span class="comment"> * @param spawnServerCommand The filename of the spawn server to use.</span>
545
- <a name="l00520"></a><a class="code" href="classPassenger_1_1SpawnManager.html#a50cf2d13d1a5ab8809108d3de7d9326b">00520</a> <span class="comment"> * @param generation The server instance dir generation in which</span>
546
- <a name="l00521"></a>00521 <span class="comment"> * generation-specific are stored.</span>
547
- <a name="l00522"></a>00522 <span class="comment"> * @param accountsDatabase An accounts database. SpawnManager will automatically</span>
548
- <a name="l00523"></a>00523 <span class="comment"> * create a new account for each spawned process, assigning</span>
549
- <a name="l00524"></a>00524 <span class="comment"> * it the rights as set in the PoolOptions object. This</span>
550
- <a name="l00525"></a>00525 <span class="comment"> * account is also automatically deleted when no longer needed.</span>
551
- <a name="l00526"></a>00526 <span class="comment"> * May be a null pointer.</span>
552
- <a name="l00527"></a>00527 <span class="comment"> * @param rubyCommand The Ruby interpreter&#39;s command.</span>
553
- <a name="l00528"></a>00528 <span class="comment"> * @throws RuntimeException An error occurred while creating a Unix server socket.</span>
554
- <a name="l00529"></a>00529 <span class="comment"> * @throws SystemException An error occured while trying to setup the spawn server.</span>
555
- <a name="l00530"></a>00530 <span class="comment"> * @throws IOException An error occurred while generating random data.</span>
556
- <a name="l00531"></a>00531 <span class="comment"> */</span>
557
- <a name="l00532"></a>00532 <a class="code" href="classPassenger_1_1SpawnManager.html#a50cf2d13d1a5ab8809108d3de7d9326b" title="Construct a new SpawnManager.">SpawnManager</a>(<span class="keyword">const</span> <span class="keywordtype">string</span> &amp;spawnServerCommand,
558
- <a name="l00533"></a>00533 <span class="keyword">const</span> ServerInstanceDir::GenerationPtr &amp;generation,
559
- <a name="l00534"></a>00534 <span class="keyword">const</span> AccountsDatabasePtr &amp;accountsDatabase = AccountsDatabasePtr(),
560
- <a name="l00535"></a>00535 <span class="keyword">const</span> <span class="keywordtype">string</span> &amp;rubyCommand = <span class="stringliteral">&quot;ruby&quot;</span>,
561
- <a name="l00536"></a>00536 <span class="keyword">const</span> AnalyticsLoggerPtr &amp;analyticsLogger = AnalyticsLoggerPtr(),
562
- <a name="l00537"></a>00537 <span class="keywordtype">int</span> logLevel = 0,
563
- <a name="l00538"></a>00538 <span class="keyword">const</span> <span class="keywordtype">string</span> &amp;debugLogFile = <span class="stringliteral">&quot;&quot;</span>
564
- <a name="l00539"></a>00539 ) {
565
- <a name="l00540"></a>00540 TRACE_POINT();
566
- <a name="l00541"></a>00541 this-&gt;spawnServerCommand = spawnServerCommand;
567
- <a name="l00542"></a>00542 this-&gt;generation = generation;
568
- <a name="l00543"></a>00543 this-&gt;accountsDatabase = accountsDatabase;
569
- <a name="l00544"></a>00544 this-&gt;rubyCommand = rubyCommand;
570
- <a name="l00545"></a>00545 this-&gt;analyticsLogger = analyticsLogger;
571
- <a name="l00546"></a>00546 this-&gt;logLevel = logLevel;
572
- <a name="l00547"></a>00547 this-&gt;debugLogFile = debugLogFile;
573
- <a name="l00548"></a>00548 pid = 0;
574
- <a name="l00549"></a>00549 this_thread::disable_interruption di;
575
- <a name="l00550"></a>00550 this_thread::disable_syscall_interruption dsi;
576
- <a name="l00551"></a>00551 <span class="keywordflow">try</span> {
577
- <a name="l00552"></a>00552 restartServer();
578
- <a name="l00553"></a>00553 } <span class="keywordflow">catch</span> (<span class="keyword">const</span> <a class="code" href="classPassenger_1_1IOException.html" title="Represents an error that occured during an I/O operation.">IOException</a> &amp;e) {
579
- <a name="l00554"></a>00554 <span class="keywordflow">throw</span> prependMessageToException(e, <span class="stringliteral">&quot;Could not start the spawn server&quot;</span>);
580
- <a name="l00555"></a>00555 } <span class="keywordflow">catch</span> (<span class="keyword">const</span> <a class="code" href="classPassenger_1_1SystemException.html" title="Represents an error returned by a system call or a standard library call.">SystemException</a> &amp;e) {
581
- <a name="l00556"></a>00556 <span class="keywordflow">throw</span> prependMessageToException(e, <span class="stringliteral">&quot;Could not start the spawn server&quot;</span>);
582
- <a name="l00557"></a>00557 }
583
- <a name="l00558"></a>00558 }
584
- <a name="l00559"></a>00559
585
- <a name="l00560"></a><a class="code" href="classPassenger_1_1SpawnManager.html#a88a94ba4d41dab492cb1dc8a0f998973">00560</a> <span class="keyword">virtual</span> ~<a class="code" href="classPassenger_1_1SpawnManager.html" title="An AbstractSpawnManager implementation.">SpawnManager</a>() {
586
- <a name="l00561"></a>00561 TRACE_POINT();
587
- <a name="l00562"></a>00562 <span class="keywordflow">if</span> (pid != 0) {
588
- <a name="l00563"></a>00563 UPDATE_TRACE_POINT();
589
- <a name="l00564"></a>00564 this_thread::disable_interruption di;
590
- <a name="l00565"></a>00565 this_thread::disable_syscall_interruption dsi;
591
- <a name="l00566"></a>00566 syscalls::unlink(socketFilename.c_str());
592
- <a name="l00567"></a>00567 ownerSocket.<a class="code" href="classPassenger_1_1FileDescriptor.html#a02062f3cfb689b32781e11114c0abe5b" title="Close the underlying file descriptor.">close</a>();
593
- <a name="l00568"></a>00568 syscalls::waitpid(pid, NULL, 0);
594
- <a name="l00569"></a>00569 }
595
- <a name="l00570"></a>00570 }
596
- <a name="l00571"></a>00571
597
- <a name="l00572"></a>00572 <span class="keyword">virtual</span> <a class="code" href="namespacePassenger.html#aced1f248465136b313c6dec5fe6ca492" title="Convenient alias for Process smart pointer.">ProcessPtr</a> <a class="code" href="classPassenger_1_1SpawnManager.html#a88a94ba4d41dab492cb1dc8a0f998973" title="Spawn a new application process.">spawn</a>(<span class="keyword">const</span> <a class="code" href="structPassenger_1_1PoolOptions.html" title="This struct encapsulates information for ApplicationPool::get() and for SpawnManager::spawn()...">PoolOptions</a> &amp;options) {
598
- <a name="l00573"></a>00573 TRACE_POINT();
599
- <a name="l00574"></a>00574 AnalyticsScopeLog scope(options.<a class="code" href="structPassenger_1_1PoolOptions.html#ace54185a9981f103a036a7ac3e768612" title="An analytics log object to log things to.">log</a>, <span class="stringliteral">&quot;spawn app process&quot;</span>);
600
- <a name="l00575"></a>00575 <a class="code" href="namespacePassenger.html#aced1f248465136b313c6dec5fe6ca492" title="Convenient alias for Process smart pointer.">ProcessPtr</a> result;
601
- <a name="l00576"></a>00576 boost::mutex::scoped_lock l(lock);
602
- <a name="l00577"></a>00577
603
- <a name="l00578"></a>00578 <span class="keywordflow">try</span> {
604
- <a name="l00579"></a><a class="code" href="classPassenger_1_1SpawnManager.html#aad71b2ea9431f3286f23a6e6f80e0981">00579</a> result = sendSpawnCommand(options);
605
- <a name="l00580"></a>00580 } <span class="keywordflow">catch</span> (<span class="keyword">const</span> <a class="code" href="classPassenger_1_1SpawnException.html" title="Thrown when SpawnManager or ApplicationPool fails to spawn an application instance...">SpawnException</a> &amp;e) {
606
- <a name="l00581"></a>00581 <span class="keywordflow">if</span> (e.<a class="code" href="classPassenger_1_1SpawnException.html#ae65dc272e183fd9e5637a4091cc6bbf4" title="Check whether an error page is available.">hasErrorPage</a>()) {
607
- <a name="l00582"></a>00582 <span class="keywordflow">throw</span>;
608
- <a name="l00583"></a>00583 } <span class="keywordflow">else</span> {
609
- <a name="l00584"></a>00584 result = handleSpawnException(e, options);
610
- <a name="l00585"></a>00585 }
611
- <a name="l00586"></a>00586 }
612
- <a name="l00587"></a>00587 scope.success();
613
- <a name="l00588"></a>00588 <span class="keywordflow">return</span> result;
614
- <a name="l00589"></a>00589 }
615
- <a name="l00590"></a><a class="code" href="classPassenger_1_1SpawnManager.html#a9210212c23c5a8ee5ee4dd5c9dcdf57d">00590</a>
616
- <a name="l00591"></a>00591 <span class="keyword">virtual</span> <span class="keywordtype">void</span> <a class="code" href="classPassenger_1_1SpawnManager.html#aad71b2ea9431f3286f23a6e6f80e0981" title="Shutdown the ApplicationSpawner server that&amp;#39;s running at the given application...">reload</a>(<span class="keyword">const</span> <span class="keywordtype">string</span> &amp;appRoot) {
617
- <a name="l00592"></a>00592 TRACE_POINT();
618
- <a name="l00593"></a>00593 this_thread::disable_interruption di;
619
- <a name="l00594"></a><a class="code" href="classPassenger_1_1SpawnManager.html#af34df8cfccfc64507999f1b48bc5a126">00594</a> this_thread::disable_syscall_interruption dsi;
620
- <a name="l00595"></a>00595 <span class="keywordflow">try</span> {
621
- <a name="l00596"></a>00596 <span class="keywordflow">return</span> sendReloadCommand(appRoot);
622
- <a name="l00597"></a>00597 } <span class="keywordflow">catch</span> (<span class="keyword">const</span> <a class="code" href="classPassenger_1_1SystemException.html" title="Represents an error returned by a system call or a standard library call.">SystemException</a> &amp;e) {
623
- <a name="l00598"></a>00598 <span class="keywordflow">return</span> handleReloadException(e, appRoot);
624
- <a name="l00599"></a>00599 }
625
- <a name="l00600"></a><a class="code" href="namespacePassenger.html#a6ab2d566ff87a2676c23d8aa40204587">00600</a> }
626
- <a name="l00601"></a>00601
627
- <a name="l00602"></a>00602 <span class="keyword">virtual</span> <span class="keywordtype">void</span> <a class="code" href="classPassenger_1_1SpawnManager.html#a9210212c23c5a8ee5ee4dd5c9dcdf57d" title="Forcefully kill the spawn server.">killSpawnServer</a>()<span class="keyword"> const </span>{
628
- <a name="l00603"></a>00603 kill(pid, SIGKILL);
629
- <a name="l00604"></a>00604 }
630
- <a name="l00605"></a>00605
631
- <a name="l00606"></a>00606 <span class="keyword">virtual</span> pid_t <a class="code" href="classPassenger_1_1SpawnManager.html#af34df8cfccfc64507999f1b48bc5a126" title="Returns the spawn server&amp;#39;s PID.">getServerPid</a>()<span class="keyword"> const </span>{
632
- <a name="l00607"></a>00607 <span class="keywordflow">return</span> pid;
633
- <a name="l00608"></a>00608 }
634
- <a name="l00609"></a>00609 };
635
- <a name="l00610"></a>00610 <span class="comment"></span>
636
- <a name="l00611"></a>00611 <span class="comment">/** Convenient alias for SpawnManager smart pointer. */</span>
637
- <a name="l00612"></a>00612 <span class="keyword">typedef</span> shared_ptr&lt;SpawnManager&gt; <a class="code" href="namespacePassenger.html#a6ab2d566ff87a2676c23d8aa40204587" title="Convenient alias for SpawnManager smart pointer.">SpawnManagerPtr</a>;
638
- <a name="l00613"></a>00613
639
- <a name="l00614"></a>00614 } <span class="comment">// namespace Passenger</span>
640
- <a name="l00615"></a>00615
641
- <a name="l00616"></a>00616 <span class="preprocessor">#endif </span><span class="comment">/* _PASSENGER_SPAWN_MANAGER_H_ */</span>
642
- </pre></div></div>
643
- <hr size="1"/><address style="text-align: right;"><small>Generated by&nbsp;
644
- <a href="http://www.doxygen.org/index.html">
645
- <img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.6.2 </small></address>
646
- </body>
647
- </html>