passenger 2.2.9 → 2.2.10

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 (435) hide show
  1. data/NEWS +10 -0
  2. data/doc/Architectural overview.html +202 -65
  3. data/doc/Security of user switching support.html +200 -63
  4. data/doc/Users guide Apache.html +266 -129
  5. data/doc/Users guide Nginx.html +234 -97
  6. data/doc/cxxapi/AbstractSpawnManager_8h-source.html +138 -0
  7. data/doc/cxxapi/Account_8h-source.html +202 -0
  8. data/doc/cxxapi/AccountsDatabase_8h-source.html +158 -0
  9. data/doc/cxxapi/AgentsStarter_8h-source.html +79 -0
  10. data/doc/cxxapi/BCrypt_8h-source.html +101 -0
  11. data/doc/cxxapi/BacktracesServer_8h-source.html +87 -0
  12. data/doc/cxxapi/Base64_8h-source.html +85 -0
  13. data/doc/cxxapi/Blowfish_8h-source.html +131 -0
  14. data/doc/cxxapi/Bucket_8h-source.html +1 -1
  15. data/doc/cxxapi/CachedFileStat_8h-source.html +49 -157
  16. data/doc/cxxapi/Configuration_8h-source.html +1 -1
  17. data/doc/cxxapi/Constants_8h-source.html +71 -0
  18. data/doc/cxxapi/ContentHandler_8h-source.html +92 -0
  19. data/doc/cxxapi/DirectoryMapper_8h-source.html +1 -1
  20. data/doc/cxxapi/Exceptions_8h-source.html +332 -236
  21. data/doc/cxxapi/FileChangeChecker_8h-source.html +237 -0
  22. data/doc/cxxapi/FileDescriptor_8h-source.html +206 -0
  23. data/doc/cxxapi/Hooks_8h-source.html +1 -1
  24. data/doc/cxxapi/HttpStatusExtractor_8h-source.html +378 -0
  25. data/doc/cxxapi/LoggingServer_8h-source.html +165 -0
  26. data/doc/cxxapi/Logging_8h-source.html +580 -112
  27. data/doc/cxxapi/MessageChannel_8h-source.html +789 -599
  28. data/doc/cxxapi/MessageClient_8h-source.html +297 -0
  29. data/doc/cxxapi/MessageServer_8h-source.html +607 -0
  30. data/doc/cxxapi/PoolOptions_8h-source.html +471 -278
  31. data/doc/cxxapi/Process_8h-source.html +272 -0
  32. data/doc/cxxapi/RandomGenerator_8h-source.html +156 -0
  33. data/doc/cxxapi/ResourceLocator_8h-source.html +104 -0
  34. data/doc/cxxapi/ScgiRequestParser_8h-source.html +399 -0
  35. data/doc/cxxapi/ServerInstanceDir_8h-source.html +356 -0
  36. data/doc/cxxapi/Session_8h-source.html +483 -0
  37. data/doc/cxxapi/SpawnManager_8h-source.html +590 -546
  38. data/doc/cxxapi/StaticContentHandler_8h-source.html +65 -0
  39. data/doc/cxxapi/StaticString_8h-source.html +214 -0
  40. data/doc/cxxapi/StringListCreator_8h-source.html +111 -0
  41. data/doc/cxxapi/SystemTime_8h-source.html +191 -78
  42. data/doc/cxxapi/Timer_8h-source.html +157 -0
  43. data/doc/cxxapi/Utils_8h-source.html +621 -434
  44. data/doc/cxxapi/Version_8h-source.html +59 -0
  45. data/doc/cxxapi/annotated.html +1 -1
  46. data/doc/cxxapi/apache2_2Configuration_8h-source.html +79 -0
  47. data/doc/cxxapi/classAgentWatcher-members.html +50 -0
  48. data/doc/cxxapi/classAgentWatcher.html +445 -0
  49. data/doc/cxxapi/classClient-members.html +4 -3
  50. data/doc/cxxapi/classClient.html +50 -46
  51. data/doc/cxxapi/classHooks-members.html +1 -1
  52. data/doc/cxxapi/classHooks.html +1 -1
  53. data/doc/cxxapi/classPassenger_1_1AbstractSpawnManager-members.html +37 -0
  54. data/doc/cxxapi/classPassenger_1_1AbstractSpawnManager.html +191 -0
  55. data/doc/cxxapi/classPassenger_1_1AbstractSpawnManager__inherit__graph.map +1 -0
  56. data/doc/cxxapi/classPassenger_1_1AbstractSpawnManager__inherit__graph.md5 +1 -0
  57. data/doc/cxxapi/classPassenger_1_1AbstractSpawnManager__inherit__graph.png +0 -0
  58. data/doc/cxxapi/{classPassenger_1_1DummySpawnManager-members.html → classPassenger_1_1ArgumentException-members.html} +3 -2
  59. data/doc/cxxapi/classPassenger_1_1ArgumentException.html +52 -0
  60. data/doc/cxxapi/classPassenger_1_1BacktracesServer-members.html +36 -0
  61. data/doc/cxxapi/classPassenger_1_1BacktracesServer.html +107 -0
  62. data/doc/cxxapi/classPassenger_1_1BacktracesServer__inherit__graph.map +1 -0
  63. data/doc/cxxapi/classPassenger_1_1BacktracesServer__inherit__graph.md5 +1 -0
  64. data/doc/cxxapi/classPassenger_1_1BacktracesServer__inherit__graph.png +0 -0
  65. data/doc/cxxapi/classPassenger_1_1BufferedUpload-members.html +3 -3
  66. data/doc/cxxapi/classPassenger_1_1BufferedUpload.html +18 -34
  67. data/doc/cxxapi/classPassenger_1_1BusyException-members.html +2 -1
  68. data/doc/cxxapi/classPassenger_1_1BusyException.html +3 -2
  69. data/doc/cxxapi/classPassenger_1_1ConfigurationException-members.html +2 -1
  70. data/doc/cxxapi/classPassenger_1_1ConfigurationException.html +3 -2
  71. data/doc/cxxapi/classPassenger_1_1DirectoryMapper-members.html +1 -1
  72. data/doc/cxxapi/classPassenger_1_1DirectoryMapper.html +1 -1
  73. data/doc/cxxapi/{classPassenger_1_1FileChecker-members.html → classPassenger_1_1EOFException-members.html} +3 -4
  74. data/doc/cxxapi/classPassenger_1_1EOFException.html +57 -0
  75. data/doc/cxxapi/classPassenger_1_1EOFException__inherit__graph.map +1 -0
  76. data/doc/cxxapi/classPassenger_1_1EOFException__inherit__graph.md5 +1 -0
  77. data/doc/cxxapi/classPassenger_1_1EOFException__inherit__graph.png +0 -0
  78. data/doc/cxxapi/classPassenger_1_1EventFd-members.html +33 -0
  79. data/doc/cxxapi/classPassenger_1_1EventFd.html +49 -0
  80. data/doc/cxxapi/classPassenger_1_1FileChangeChecker-members.html +37 -0
  81. data/doc/cxxapi/classPassenger_1_1FileChangeChecker.html +166 -0
  82. data/doc/cxxapi/classPassenger_1_1FileDescriptor-members.html +37 -0
  83. data/doc/cxxapi/classPassenger_1_1FileDescriptor.html +159 -0
  84. data/doc/cxxapi/classPassenger_1_1FileNotFoundException-members.html +2 -1
  85. data/doc/cxxapi/classPassenger_1_1FileNotFoundException.html +3 -2
  86. data/doc/cxxapi/classPassenger_1_1FileSystemException-members.html +2 -1
  87. data/doc/cxxapi/classPassenger_1_1FileSystemException.html +3 -2
  88. data/doc/cxxapi/{classPassenger_1_1ApplicationPoolServer-members.html → classPassenger_1_1HttpStatusExtractor-members.html} +6 -5
  89. data/doc/cxxapi/classPassenger_1_1HttpStatusExtractor.html +128 -0
  90. data/doc/cxxapi/classPassenger_1_1IOException-members.html +2 -1
  91. data/doc/cxxapi/classPassenger_1_1IOException.html +4 -3
  92. data/doc/cxxapi/classPassenger_1_1IOException__inherit__graph.map +2 -1
  93. data/doc/cxxapi/classPassenger_1_1IOException__inherit__graph.md5 +1 -1
  94. data/doc/cxxapi/classPassenger_1_1IOException__inherit__graph.png +0 -0
  95. data/doc/cxxapi/classPassenger_1_1MemZeroGuard-members.html +36 -0
  96. data/doc/cxxapi/classPassenger_1_1MemZeroGuard.html +147 -0
  97. data/doc/cxxapi/classPassenger_1_1MessageChannel-members.html +12 -5
  98. data/doc/cxxapi/classPassenger_1_1MessageChannel.html +267 -34
  99. data/doc/cxxapi/classPassenger_1_1MessageServer-members.html +46 -0
  100. data/doc/cxxapi/classPassenger_1_1MessageServer.html +438 -0
  101. data/doc/cxxapi/classPassenger_1_1MessageServer_1_1ClientContext-members.html +33 -0
  102. data/doc/cxxapi/classPassenger_1_1MessageServer_1_1ClientContext.html +56 -0
  103. data/doc/cxxapi/classPassenger_1_1MessageServer_1_1ClientContext__inherit__graph.map +1 -0
  104. data/doc/cxxapi/classPassenger_1_1MessageServer_1_1ClientContext__inherit__graph.md5 +1 -0
  105. data/doc/cxxapi/classPassenger_1_1MessageServer_1_1ClientContext__inherit__graph.png +0 -0
  106. data/doc/cxxapi/classPassenger_1_1MessageServer_1_1CommonClientContext-members.html +38 -0
  107. data/doc/cxxapi/classPassenger_1_1MessageServer_1_1CommonClientContext.html +175 -0
  108. data/doc/cxxapi/classPassenger_1_1MessageServer_1_1CommonClientContext__inherit__graph.map +1 -0
  109. data/doc/cxxapi/classPassenger_1_1MessageServer_1_1CommonClientContext__inherit__graph.md5 +1 -0
  110. data/doc/cxxapi/classPassenger_1_1MessageServer_1_1CommonClientContext__inherit__graph.png +0 -0
  111. data/doc/cxxapi/classPassenger_1_1MessageServer_1_1Handler-members.html +36 -0
  112. data/doc/cxxapi/classPassenger_1_1MessageServer_1_1Handler.html +176 -0
  113. data/doc/cxxapi/classPassenger_1_1MessageServer_1_1Handler__inherit__graph.map +1 -0
  114. data/doc/cxxapi/classPassenger_1_1MessageServer_1_1Handler__inherit__graph.md5 +1 -0
  115. data/doc/cxxapi/classPassenger_1_1MessageServer_1_1Handler__inherit__graph.png +0 -0
  116. data/doc/cxxapi/classPassenger_1_1Process-members.html +40 -0
  117. data/doc/cxxapi/classPassenger_1_1Process.html +266 -0
  118. data/doc/cxxapi/classPassenger_1_1RandomGenerator-members.html +33 -0
  119. data/doc/cxxapi/classPassenger_1_1RandomGenerator.html +51 -0
  120. data/doc/cxxapi/classPassenger_1_1RuntimeException-members.html +2 -1
  121. data/doc/cxxapi/classPassenger_1_1RuntimeException.html +3 -2
  122. data/doc/cxxapi/classPassenger_1_1ScgiRequestParser-members.html +47 -0
  123. data/doc/cxxapi/classPassenger_1_1ScgiRequestParser.html +302 -0
  124. data/doc/cxxapi/classPassenger_1_1SecurityException-members.html +33 -0
  125. data/doc/cxxapi/classPassenger_1_1SecurityException.html +52 -0
  126. data/doc/cxxapi/classPassenger_1_1Session-members.html +50 -0
  127. data/doc/cxxapi/classPassenger_1_1Session.html +577 -0
  128. data/doc/cxxapi/classPassenger_1_1Session__inherit__graph.map +1 -0
  129. data/doc/cxxapi/classPassenger_1_1Session__inherit__graph.md5 +1 -0
  130. data/doc/cxxapi/classPassenger_1_1Session__inherit__graph.png +0 -0
  131. data/doc/cxxapi/classPassenger_1_1SpawnException-members.html +2 -1
  132. data/doc/cxxapi/classPassenger_1_1SpawnException.html +5 -4
  133. data/doc/cxxapi/classPassenger_1_1SpawnManager-members.html +8 -5
  134. data/doc/cxxapi/classPassenger_1_1SpawnManager.html +127 -45
  135. data/doc/cxxapi/classPassenger_1_1SpawnManager__inherit__graph.map +1 -0
  136. data/doc/cxxapi/classPassenger_1_1SpawnManager__inherit__graph.md5 +1 -0
  137. data/doc/cxxapi/classPassenger_1_1SpawnManager__inherit__graph.png +0 -0
  138. data/doc/cxxapi/classPassenger_1_1StandardSession-members.html +51 -0
  139. data/doc/cxxapi/classPassenger_1_1StandardSession.html +415 -0
  140. data/doc/cxxapi/classPassenger_1_1StandardSession__inherit__graph.map +1 -0
  141. data/doc/cxxapi/classPassenger_1_1StandardSession__inherit__graph.md5 +1 -0
  142. data/doc/cxxapi/classPassenger_1_1StandardSession__inherit__graph.png +0 -0
  143. data/doc/cxxapi/classPassenger_1_1StaticString-members.html +33 -0
  144. data/doc/cxxapi/classPassenger_1_1StaticString.html +54 -0
  145. data/doc/cxxapi/classPassenger_1_1SystemException-members.html +2 -1
  146. data/doc/cxxapi/classPassenger_1_1SystemException.html +4 -3
  147. data/doc/cxxapi/classPassenger_1_1SystemException__inherit__graph.map +1 -0
  148. data/doc/cxxapi/classPassenger_1_1SystemException__inherit__graph.md5 +1 -1
  149. data/doc/cxxapi/classPassenger_1_1SystemException__inherit__graph.png +0 -0
  150. data/doc/cxxapi/classPassenger_1_1SystemTime-members.html +9 -1
  151. data/doc/cxxapi/classPassenger_1_1SystemTime.html +92 -8
  152. data/doc/cxxapi/classPassenger_1_1TimeRetrievalException-members.html +37 -0
  153. data/doc/cxxapi/classPassenger_1_1TimeRetrievalException.html +57 -0
  154. data/doc/cxxapi/classPassenger_1_1TimeRetrievalException__inherit__graph.map +1 -0
  155. data/doc/cxxapi/classPassenger_1_1TimeRetrievalException__inherit__graph.md5 +1 -0
  156. data/doc/cxxapi/classPassenger_1_1TimeRetrievalException__inherit__graph.png +0 -0
  157. data/doc/cxxapi/classPassenger_1_1TimeoutException-members.html +33 -0
  158. data/doc/cxxapi/classPassenger_1_1TimeoutException.html +50 -0
  159. data/doc/cxxapi/{classPassenger_1_1Application-members.html → classPassenger_1_1Timer-members.html} +8 -7
  160. data/doc/cxxapi/classPassenger_1_1Timer.html +163 -0
  161. data/doc/cxxapi/classServer-members.html +33 -0
  162. data/doc/cxxapi/classServer.html +46 -0
  163. data/doc/cxxapi/classServerInstanceDirToucher-members.html +33 -0
  164. data/doc/cxxapi/classServerInstanceDirToucher.html +43 -0
  165. data/doc/cxxapi/classes.html +1 -1
  166. data/doc/cxxapi/definitions_8h-source.html +1 -1
  167. data/doc/cxxapi/files.html +1 -1
  168. data/doc/cxxapi/functions.html +1 -1
  169. data/doc/cxxapi/{functions_type.html → functions_enum.html} +7 -5
  170. data/doc/cxxapi/functions_eval.html +55 -0
  171. data/doc/cxxapi/functions_func.html +1 -1
  172. data/doc/cxxapi/functions_vars.html +106 -9
  173. data/doc/cxxapi/graph_legend.html +1 -1
  174. data/doc/cxxapi/group__Configuration.html +1 -1
  175. data/doc/cxxapi/group__Core.html +1 -1
  176. data/doc/cxxapi/group__Exceptions.html +17 -1
  177. data/doc/cxxapi/group__Hooks.html +1 -1
  178. data/doc/cxxapi/group__Support.html +1 -1
  179. data/doc/cxxapi/hierarchy.html +34 -12
  180. data/doc/cxxapi/inherit__graph__0.map +1 -1
  181. data/doc/cxxapi/inherit__graph__0.md5 +1 -1
  182. data/doc/cxxapi/inherit__graph__0.png +0 -0
  183. data/doc/cxxapi/inherit__graph__1.map +1 -1
  184. data/doc/cxxapi/inherit__graph__1.md5 +1 -1
  185. data/doc/cxxapi/inherit__graph__1.png +0 -0
  186. data/doc/cxxapi/inherit__graph__10.map +1 -1
  187. data/doc/cxxapi/inherit__graph__10.md5 +1 -1
  188. data/doc/cxxapi/inherit__graph__10.png +0 -0
  189. data/doc/cxxapi/inherit__graph__11.map +1 -1
  190. data/doc/cxxapi/inherit__graph__11.md5 +1 -1
  191. data/doc/cxxapi/inherit__graph__11.png +0 -0
  192. data/doc/cxxapi/inherit__graph__12.map +1 -1
  193. data/doc/cxxapi/inherit__graph__12.md5 +1 -1
  194. data/doc/cxxapi/inherit__graph__12.png +0 -0
  195. data/doc/cxxapi/inherit__graph__13.map +1 -1
  196. data/doc/cxxapi/inherit__graph__13.md5 +1 -1
  197. data/doc/cxxapi/inherit__graph__13.png +0 -0
  198. data/doc/cxxapi/inherit__graph__14.map +3 -2
  199. data/doc/cxxapi/inherit__graph__14.md5 +1 -1
  200. data/doc/cxxapi/inherit__graph__14.png +0 -0
  201. data/doc/cxxapi/inherit__graph__15.map +1 -1
  202. data/doc/cxxapi/inherit__graph__15.md5 +1 -1
  203. data/doc/cxxapi/inherit__graph__15.png +0 -0
  204. data/doc/cxxapi/inherit__graph__16.map +1 -1
  205. data/doc/cxxapi/inherit__graph__16.md5 +1 -1
  206. data/doc/cxxapi/inherit__graph__16.png +0 -0
  207. data/doc/cxxapi/inherit__graph__17.map +1 -1
  208. data/doc/cxxapi/inherit__graph__17.md5 +1 -1
  209. data/doc/cxxapi/inherit__graph__17.png +0 -0
  210. data/doc/cxxapi/inherit__graph__18.map +2 -1
  211. data/doc/cxxapi/inherit__graph__18.md5 +1 -1
  212. data/doc/cxxapi/inherit__graph__18.png +0 -0
  213. data/doc/cxxapi/inherit__graph__19.map +1 -1
  214. data/doc/cxxapi/inherit__graph__19.md5 +1 -1
  215. data/doc/cxxapi/inherit__graph__19.png +0 -0
  216. data/doc/cxxapi/inherit__graph__2.map +1 -1
  217. data/doc/cxxapi/inherit__graph__2.md5 +1 -1
  218. data/doc/cxxapi/inherit__graph__2.png +0 -0
  219. data/doc/cxxapi/inherit__graph__20.map +1 -2
  220. data/doc/cxxapi/inherit__graph__20.md5 +1 -1
  221. data/doc/cxxapi/inherit__graph__20.png +0 -0
  222. data/doc/cxxapi/inherit__graph__21.map +1 -1
  223. data/doc/cxxapi/inherit__graph__21.md5 +1 -1
  224. data/doc/cxxapi/inherit__graph__21.png +0 -0
  225. data/doc/cxxapi/inherit__graph__22.map +1 -0
  226. data/doc/cxxapi/inherit__graph__22.md5 +1 -0
  227. data/doc/cxxapi/inherit__graph__22.png +0 -0
  228. data/doc/cxxapi/inherit__graph__23.map +1 -0
  229. data/doc/cxxapi/inherit__graph__23.md5 +1 -0
  230. data/doc/cxxapi/inherit__graph__23.png +0 -0
  231. data/doc/cxxapi/inherit__graph__24.map +1 -0
  232. data/doc/cxxapi/inherit__graph__24.md5 +1 -0
  233. data/doc/cxxapi/inherit__graph__24.png +0 -0
  234. data/doc/cxxapi/inherit__graph__25.map +1 -0
  235. data/doc/cxxapi/inherit__graph__25.md5 +1 -0
  236. data/doc/cxxapi/inherit__graph__25.png +0 -0
  237. data/doc/cxxapi/inherit__graph__26.map +1 -0
  238. data/doc/cxxapi/inherit__graph__26.md5 +1 -0
  239. data/doc/cxxapi/inherit__graph__26.png +0 -0
  240. data/doc/cxxapi/inherit__graph__27.map +2 -0
  241. data/doc/cxxapi/inherit__graph__27.md5 +1 -0
  242. data/doc/cxxapi/inherit__graph__27.png +0 -0
  243. data/doc/cxxapi/inherit__graph__28.map +1 -0
  244. data/doc/cxxapi/inherit__graph__28.md5 +1 -0
  245. data/doc/cxxapi/inherit__graph__28.png +0 -0
  246. data/doc/cxxapi/inherit__graph__29.map +1 -0
  247. data/doc/cxxapi/inherit__graph__29.md5 +1 -0
  248. data/doc/cxxapi/inherit__graph__29.png +0 -0
  249. data/doc/cxxapi/inherit__graph__3.map +2 -1
  250. data/doc/cxxapi/inherit__graph__3.md5 +1 -1
  251. data/doc/cxxapi/inherit__graph__3.png +0 -0
  252. data/doc/cxxapi/inherit__graph__30.map +1 -0
  253. data/doc/cxxapi/inherit__graph__30.md5 +1 -0
  254. data/doc/cxxapi/inherit__graph__30.png +0 -0
  255. data/doc/cxxapi/inherit__graph__31.map +3 -0
  256. data/doc/cxxapi/inherit__graph__31.md5 +1 -0
  257. data/doc/cxxapi/inherit__graph__31.png +0 -0
  258. data/doc/cxxapi/inherit__graph__32.map +1 -0
  259. data/doc/cxxapi/inherit__graph__32.md5 +1 -0
  260. data/doc/cxxapi/inherit__graph__32.png +0 -0
  261. data/doc/cxxapi/inherit__graph__33.map +1 -0
  262. data/doc/cxxapi/inherit__graph__33.md5 +1 -0
  263. data/doc/cxxapi/inherit__graph__33.png +0 -0
  264. data/doc/cxxapi/inherit__graph__34.map +1 -0
  265. data/doc/cxxapi/inherit__graph__34.md5 +1 -0
  266. data/doc/cxxapi/inherit__graph__34.png +0 -0
  267. data/doc/cxxapi/inherit__graph__35.map +1 -0
  268. data/doc/cxxapi/inherit__graph__35.md5 +1 -0
  269. data/doc/cxxapi/inherit__graph__35.png +0 -0
  270. data/doc/cxxapi/inherit__graph__36.map +1 -0
  271. data/doc/cxxapi/inherit__graph__36.md5 +1 -0
  272. data/doc/cxxapi/inherit__graph__36.png +0 -0
  273. data/doc/cxxapi/inherit__graph__4.map +1 -1
  274. data/doc/cxxapi/inherit__graph__4.md5 +1 -1
  275. data/doc/cxxapi/inherit__graph__4.png +0 -0
  276. data/doc/cxxapi/inherit__graph__5.map +1 -1
  277. data/doc/cxxapi/inherit__graph__5.md5 +1 -1
  278. data/doc/cxxapi/inherit__graph__5.png +0 -0
  279. data/doc/cxxapi/inherit__graph__6.map +1 -2
  280. data/doc/cxxapi/inherit__graph__6.md5 +1 -1
  281. data/doc/cxxapi/inherit__graph__6.png +0 -0
  282. data/doc/cxxapi/inherit__graph__7.map +1 -1
  283. data/doc/cxxapi/inherit__graph__7.md5 +1 -1
  284. data/doc/cxxapi/inherit__graph__7.png +0 -0
  285. data/doc/cxxapi/inherit__graph__8.map +1 -1
  286. data/doc/cxxapi/inherit__graph__8.md5 +1 -1
  287. data/doc/cxxapi/inherit__graph__8.png +0 -0
  288. data/doc/cxxapi/inherit__graph__9.map +1 -1
  289. data/doc/cxxapi/inherit__graph__9.md5 +1 -1
  290. data/doc/cxxapi/inherit__graph__9.png +0 -0
  291. data/doc/cxxapi/inherits.html +81 -41
  292. data/doc/cxxapi/main.html +1 -1
  293. data/doc/cxxapi/md5_8h-source.html +121 -0
  294. data/doc/cxxapi/modules.html +1 -1
  295. data/doc/cxxapi/namespacePassenger.html +651 -0
  296. data/doc/cxxapi/namespacemembers.html +155 -0
  297. data/doc/cxxapi/namespacemembers_enum.html +46 -0
  298. data/doc/cxxapi/namespacemembers_eval.html +52 -0
  299. data/doc/cxxapi/namespacemembers_func.html +139 -0
  300. data/doc/cxxapi/namespacemembers_type.html +50 -0
  301. data/doc/cxxapi/namespaces.html +34 -0
  302. data/doc/cxxapi/nginx_2Configuration_8h-source.html +114 -0
  303. data/doc/cxxapi/ngx__http__passenger__module_8h-source.html +91 -0
  304. data/doc/cxxapi/structPassenger_1_1AnythingToString-members.html +2 -1
  305. data/doc/cxxapi/structPassenger_1_1AnythingToString.html +3 -2
  306. data/doc/cxxapi/structPassenger_1_1AnythingToString_3_01vector_3_01string_01_4_01_4-members.html +2 -1
  307. data/doc/cxxapi/structPassenger_1_1AnythingToString_3_01vector_3_01string_01_4_01_4.html +3 -2
  308. data/doc/cxxapi/structPassenger_1_1MessageServer_1_1DisconnectEventBroadcastGuard-members.html +33 -0
  309. data/doc/cxxapi/structPassenger_1_1MessageServer_1_1DisconnectEventBroadcastGuard.html +49 -0
  310. data/doc/cxxapi/structPassenger_1_1PoolOptions-members.html +19 -7
  311. data/doc/cxxapi/structPassenger_1_1PoolOptions.html +323 -53
  312. data/doc/cxxapi/structPassenger_1_1StaticString_1_1Hash-members.html +33 -0
  313. data/doc/cxxapi/structPassenger_1_1StaticString_1_1Hash.html +49 -0
  314. data/ext/common/MessageChannel.h +48 -4
  315. data/ext/common/Version.h +1 -1
  316. data/ext/nginx/HttpStatusExtractor.h +1 -0
  317. data/ext/nginx/ScgiRequestParser.h +1 -0
  318. data/ext/phusion_passenger/native_support.c +5 -1
  319. data/lib/phusion_passenger/constants.rb +1 -1
  320. data/lib/phusion_passenger/message_channel.rb +45 -3
  321. data/lib/phusion_passenger/rack/application_spawner.rb +4 -0
  322. data/lib/phusion_passenger/railz/application_spawner.rb +19 -1
  323. data/lib/phusion_passenger/utils.rb +3 -3
  324. data/lib/phusion_passenger/utils/rewindable_input.rb +5 -0
  325. data/test/MessageChannelTest.cpp +9 -1
  326. data/test/stub/message_channel.rb +1 -1
  327. data/test/stub/message_channel_2.rb +1 -1
  328. data/test/stub/message_channel_3.rb +2 -2
  329. metadata +173 -113
  330. data/doc/cxxapi/ApplicationPoolServer_8h-source.html +0 -833
  331. data/doc/cxxapi/ApplicationPool_8h-source.html +0 -226
  332. data/doc/cxxapi/Application_8h-source.html +0 -553
  333. data/doc/cxxapi/DummySpawnManager_8h-source.html +0 -130
  334. data/doc/cxxapi/FileChecker_8h-source.html +0 -134
  335. data/doc/cxxapi/StandardApplicationPool_8h-source.html +0 -842
  336. data/doc/cxxapi/classPassenger_1_1Application.html +0 -231
  337. data/doc/cxxapi/classPassenger_1_1ApplicationPool-members.html +0 -41
  338. data/doc/cxxapi/classPassenger_1_1ApplicationPool.html +0 -323
  339. data/doc/cxxapi/classPassenger_1_1ApplicationPoolServer.html +0 -227
  340. data/doc/cxxapi/classPassenger_1_1ApplicationPool__inherit__graph.map +0 -1
  341. data/doc/cxxapi/classPassenger_1_1ApplicationPool__inherit__graph.md5 +0 -1
  342. data/doc/cxxapi/classPassenger_1_1ApplicationPool__inherit__graph.png +0 -0
  343. data/doc/cxxapi/classPassenger_1_1Application_1_1Session-members.html +0 -44
  344. data/doc/cxxapi/classPassenger_1_1Application_1_1Session.html +0 -403
  345. data/doc/cxxapi/classPassenger_1_1DummySpawnManager.html +0 -53
  346. data/doc/cxxapi/classPassenger_1_1FileChecker.html +0 -124
  347. data/doc/cxxapi/classPassenger_1_1StandardApplicationPool-members.html +0 -44
  348. data/doc/cxxapi/classPassenger_1_1StandardApplicationPool.html +0 -342
  349. data/doc/cxxapi/classPassenger_1_1StandardApplicationPool__inherit__graph.map +0 -1
  350. data/doc/cxxapi/classPassenger_1_1StandardApplicationPool__inherit__graph.md5 +0 -1
  351. data/doc/cxxapi/classPassenger_1_1StandardApplicationPool__inherit__graph.png +0 -0
  352. data/doc/rdoc/classes/ConditionVariable.html +0 -194
  353. data/doc/rdoc/classes/Exception.html +0 -120
  354. data/doc/rdoc/classes/GC.html +0 -113
  355. data/doc/rdoc/classes/IO.html +0 -169
  356. data/doc/rdoc/classes/PhusionPassenger.html +0 -239
  357. data/doc/rdoc/classes/PhusionPassenger/AbstractInstaller.html +0 -153
  358. data/doc/rdoc/classes/PhusionPassenger/AbstractRequestHandler.html +0 -517
  359. data/doc/rdoc/classes/PhusionPassenger/AbstractServer.html +0 -719
  360. data/doc/rdoc/classes/PhusionPassenger/AbstractServer/ServerAlreadyStarted.html +0 -97
  361. data/doc/rdoc/classes/PhusionPassenger/AbstractServer/ServerError.html +0 -96
  362. data/doc/rdoc/classes/PhusionPassenger/AbstractServer/ServerNotStarted.html +0 -97
  363. data/doc/rdoc/classes/PhusionPassenger/AbstractServer/UnknownMessage.html +0 -96
  364. data/doc/rdoc/classes/PhusionPassenger/AbstractServerCollection.html +0 -598
  365. data/doc/rdoc/classes/PhusionPassenger/AdminTools.html +0 -140
  366. data/doc/rdoc/classes/PhusionPassenger/AdminTools/ControlProcess.html +0 -317
  367. data/doc/rdoc/classes/PhusionPassenger/AdminTools/ControlProcess/Instance.html +0 -138
  368. data/doc/rdoc/classes/PhusionPassenger/AppInitError.html +0 -154
  369. data/doc/rdoc/classes/PhusionPassenger/Application.html +0 -283
  370. data/doc/rdoc/classes/PhusionPassenger/ConsoleTextTemplate.html +0 -172
  371. data/doc/rdoc/classes/PhusionPassenger/FrameworkInitError.html +0 -145
  372. data/doc/rdoc/classes/PhusionPassenger/HTMLTemplate.html +0 -175
  373. data/doc/rdoc/classes/PhusionPassenger/InitializationError.html +0 -141
  374. data/doc/rdoc/classes/PhusionPassenger/InvalidPath.html +0 -92
  375. data/doc/rdoc/classes/PhusionPassenger/MessageChannel.html +0 -489
  376. data/doc/rdoc/classes/PhusionPassenger/NativeSupport.html +0 -350
  377. data/doc/rdoc/classes/PhusionPassenger/Rack.html +0 -91
  378. data/doc/rdoc/classes/PhusionPassenger/Rack/ApplicationSpawner.html +0 -188
  379. data/doc/rdoc/classes/PhusionPassenger/Rack/RequestHandler.html +0 -199
  380. data/doc/rdoc/classes/PhusionPassenger/Railz.html +0 -95
  381. data/doc/rdoc/classes/PhusionPassenger/Railz/ApplicationSpawner.html +0 -438
  382. data/doc/rdoc/classes/PhusionPassenger/Railz/ApplicationSpawner/Error.html +0 -98
  383. data/doc/rdoc/classes/PhusionPassenger/Railz/CGIFixed.html +0 -200
  384. data/doc/rdoc/classes/PhusionPassenger/Railz/FrameworkSpawner.html +0 -436
  385. data/doc/rdoc/classes/PhusionPassenger/Railz/FrameworkSpawner/Error.html +0 -98
  386. data/doc/rdoc/classes/PhusionPassenger/Railz/RequestHandler.html +0 -155
  387. data/doc/rdoc/classes/PhusionPassenger/SpawnManager.html +0 -402
  388. data/doc/rdoc/classes/PhusionPassenger/UnknownError.html +0 -125
  389. data/doc/rdoc/classes/PhusionPassenger/Utils.html +0 -805
  390. data/doc/rdoc/classes/PhusionPassenger/Utils/PseudoIO.html +0 -169
  391. data/doc/rdoc/classes/PhusionPassenger/Utils/RewindableInput.html +0 -247
  392. data/doc/rdoc/classes/PhusionPassenger/Utils/RewindableInput/Tempfile.html +0 -120
  393. data/doc/rdoc/classes/PhusionPassenger/VersionNotFound.html +0 -140
  394. data/doc/rdoc/classes/PhusionPassenger/WSGI.html +0 -89
  395. data/doc/rdoc/classes/PhusionPassenger/WSGI/ApplicationSpawner.html +0 -188
  396. data/doc/rdoc/classes/PlatformInfo.html +0 -866
  397. data/doc/rdoc/classes/RakeExtensions.html +0 -197
  398. data/doc/rdoc/classes/Signal.html +0 -139
  399. data/doc/rdoc/created.rid +0 -1
  400. data/doc/rdoc/files/DEVELOPERS_TXT.html +0 -255
  401. data/doc/rdoc/files/README.html +0 -157
  402. data/doc/rdoc/files/ext/phusion_passenger/native_support_c.html +0 -92
  403. data/doc/rdoc/files/lib/phusion_passenger/abstract_installer_rb.html +0 -129
  404. data/doc/rdoc/files/lib/phusion_passenger/abstract_request_handler_rb.html +0 -129
  405. data/doc/rdoc/files/lib/phusion_passenger/abstract_server_collection_rb.html +0 -126
  406. data/doc/rdoc/files/lib/phusion_passenger/abstract_server_rb.html +0 -128
  407. data/doc/rdoc/files/lib/phusion_passenger/admin_tools/control_process_rb.html +0 -130
  408. data/doc/rdoc/files/lib/phusion_passenger/admin_tools_rb.html +0 -122
  409. data/doc/rdoc/files/lib/phusion_passenger/application_rb.html +0 -127
  410. data/doc/rdoc/files/lib/phusion_passenger/console_text_template_rb.html +0 -126
  411. data/doc/rdoc/files/lib/phusion_passenger/constants_rb.html +0 -122
  412. data/doc/rdoc/files/lib/phusion_passenger/dependencies_rb.html +0 -134
  413. data/doc/rdoc/files/lib/phusion_passenger/events_rb.html +0 -122
  414. data/doc/rdoc/files/lib/phusion_passenger/exceptions_rb.html +0 -122
  415. data/doc/rdoc/files/lib/phusion_passenger/html_template_rb.html +0 -126
  416. data/doc/rdoc/files/lib/phusion_passenger/message_channel_rb.html +0 -120
  417. data/doc/rdoc/files/lib/phusion_passenger/packaging_rb.html +0 -122
  418. data/doc/rdoc/files/lib/phusion_passenger/platform_info_rb.html +0 -127
  419. data/doc/rdoc/files/lib/phusion_passenger/rack/application_spawner_rb.html +0 -133
  420. data/doc/rdoc/files/lib/phusion_passenger/rack/request_handler_rb.html +0 -125
  421. data/doc/rdoc/files/lib/phusion_passenger/railz/application_spawner_rb.html +0 -140
  422. data/doc/rdoc/files/lib/phusion_passenger/railz/cgi_fixed_rb.html +0 -126
  423. data/doc/rdoc/files/lib/phusion_passenger/railz/framework_spawner_rb.html +0 -145
  424. data/doc/rdoc/files/lib/phusion_passenger/railz/request_handler_rb.html +0 -125
  425. data/doc/rdoc/files/lib/phusion_passenger/simple_benchmarking_rb.html +0 -122
  426. data/doc/rdoc/files/lib/phusion_passenger/spawn_manager_rb.html +0 -159
  427. data/doc/rdoc/files/lib/phusion_passenger/utils/rewindable_input_rb.html +0 -100
  428. data/doc/rdoc/files/lib/phusion_passenger/utils_rb.html +0 -174
  429. data/doc/rdoc/files/lib/phusion_passenger/wsgi/application_spawner_rb.html +0 -129
  430. data/doc/rdoc/files/misc/rake/extensions_rb.html +0 -130
  431. data/doc/rdoc/fr_class_index.html +0 -93
  432. data/doc/rdoc/fr_file_index.html +0 -77
  433. data/doc/rdoc/fr_method_index.html +0 -212
  434. data/doc/rdoc/index.html +0 -26
  435. data/doc/rdoc/rdoc-style.css +0 -187
@@ -0,0 +1,272 @@
1
+ <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2
+ <html><head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
3
+ <title>Passenger: Process.h Source File</title>
4
+ <link href="tabs.css" rel="stylesheet" type="text/css">
5
+ <link href="doxygen.css" rel="stylesheet" type="text/css">
6
+ </head><body>
7
+ <!-- Generated by Doxygen 1.5.8 -->
8
+ <div class="navigation" id="top">
9
+ <div class="tabs">
10
+ <ul>
11
+ <li><a href="main.html"><span>Main&nbsp;Page</span></a></li>
12
+ <li><a href="modules.html"><span>Modules</span></a></li>
13
+ <li><a href="namespaces.html"><span>Namespaces</span></a></li>
14
+ <li><a href="annotated.html"><span>Classes</span></a></li>
15
+ <li class="current"><a href="files.html"><span>Files</span></a></li>
16
+ </ul>
17
+ </div>
18
+ <div class="tabs">
19
+ <ul>
20
+ <li><a href="files.html"><span>File&nbsp;List</span></a></li>
21
+ </ul>
22
+ </div>
23
+ <h1>Process.h</h1><div class="fragment"><pre class="fragment"><a name="l00001"></a>00001 <span class="comment">/*</span>
24
+ <a name="l00002"></a>00002 <span class="comment"> * Phusion Passenger - http://www.modrails.com/</span>
25
+ <a name="l00003"></a>00003 <span class="comment"> * Copyright (c) 2010 Phusion</span>
26
+ <a name="l00004"></a>00004 <span class="comment"> *</span>
27
+ <a name="l00005"></a>00005 <span class="comment"> * "Phusion Passenger" is a trademark of Hongli Lai &amp; Ninh Bui.</span>
28
+ <a name="l00006"></a>00006 <span class="comment"> *</span>
29
+ <a name="l00007"></a>00007 <span class="comment"> * Permission is hereby granted, free of charge, to any person obtaining a copy</span>
30
+ <a name="l00008"></a>00008 <span class="comment"> * of this software and associated documentation files (the "Software"), to deal</span>
31
+ <a name="l00009"></a>00009 <span class="comment"> * in the Software without restriction, including without limitation the rights</span>
32
+ <a name="l00010"></a>00010 <span class="comment"> * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell</span>
33
+ <a name="l00011"></a>00011 <span class="comment"> * copies of the Software, and to permit persons to whom the Software is</span>
34
+ <a name="l00012"></a>00012 <span class="comment"> * furnished to do so, subject to the following conditions:</span>
35
+ <a name="l00013"></a>00013 <span class="comment"> *</span>
36
+ <a name="l00014"></a>00014 <span class="comment"> * The above copyright notice and this permission notice shall be included in</span>
37
+ <a name="l00015"></a>00015 <span class="comment"> * all copies or substantial portions of the Software.</span>
38
+ <a name="l00016"></a>00016 <span class="comment"> *</span>
39
+ <a name="l00017"></a>00017 <span class="comment"> * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR</span>
40
+ <a name="l00018"></a>00018 <span class="comment"> * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,</span>
41
+ <a name="l00019"></a>00019 <span class="comment"> * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE</span>
42
+ <a name="l00020"></a>00020 <span class="comment"> * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER</span>
43
+ <a name="l00021"></a>00021 <span class="comment"> * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,</span>
44
+ <a name="l00022"></a>00022 <span class="comment"> * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN</span>
45
+ <a name="l00023"></a>00023 <span class="comment"> * THE SOFTWARE.</span>
46
+ <a name="l00024"></a>00024 <span class="comment"> */</span>
47
+ <a name="l00025"></a>00025 <span class="preprocessor">#ifndef _PASSENGER_PROCESS_H_</span>
48
+ <a name="l00026"></a>00026 <span class="preprocessor"></span><span class="preprocessor">#define _PASSENGER_PROCESS_H_</span>
49
+ <a name="l00027"></a>00027 <span class="preprocessor"></span>
50
+ <a name="l00028"></a>00028 <span class="preprocessor">#include &lt;boost/shared_ptr.hpp&gt;</span>
51
+ <a name="l00029"></a>00029 <span class="preprocessor">#include &lt;boost/function.hpp&gt;</span>
52
+ <a name="l00030"></a>00030 <span class="preprocessor">#include &lt;oxt/system_calls.hpp&gt;</span>
53
+ <a name="l00031"></a>00031 <span class="preprocessor">#include &lt;oxt/backtrace.hpp&gt;</span>
54
+ <a name="l00032"></a>00032 <span class="preprocessor">#include &lt;string&gt;</span>
55
+ <a name="l00033"></a>00033 <span class="preprocessor">#include &lt;map&gt;</span>
56
+ <a name="l00034"></a>00034
57
+ <a name="l00035"></a>00035 <span class="preprocessor">#include &lt;sys/types.h&gt;</span>
58
+ <a name="l00036"></a>00036 <span class="preprocessor">#include &lt;unistd.h&gt;</span>
59
+ <a name="l00037"></a>00037 <span class="preprocessor">#include &lt;errno.h&gt;</span>
60
+ <a name="l00038"></a>00038
61
+ <a name="l00039"></a>00039 <span class="preprocessor">#include "Session.h"</span>
62
+ <a name="l00040"></a>00040 <span class="preprocessor">#include "MessageChannel.h"</span>
63
+ <a name="l00041"></a>00041 <span class="preprocessor">#include "Exceptions.h"</span>
64
+ <a name="l00042"></a>00042 <span class="preprocessor">#include "Logging.h"</span>
65
+ <a name="l00043"></a>00043 <span class="preprocessor">#include "Utils.h"</span>
66
+ <a name="l00044"></a>00044
67
+ <a name="l00045"></a>00045 <span class="keyword">namespace </span>Passenger {
68
+ <a name="l00046"></a>00046
69
+ <a name="l00047"></a>00047 <span class="keyword">using namespace </span>std;
70
+ <a name="l00048"></a>00048 <span class="keyword">using namespace </span>boost;
71
+ <a name="l00049"></a>00049 <span class="comment"></span>
72
+ <a name="l00050"></a>00050 <span class="comment">/**</span>
73
+ <a name="l00051"></a>00051 <span class="comment"> * Represents a single application process, as spawned by SpawnManager</span>
74
+ <a name="l00052"></a>00052 <span class="comment"> * or by ApplicationPool::Interface::get().</span>
75
+ <a name="l00053"></a>00053 <span class="comment"> *</span>
76
+ <a name="l00054"></a>00054 <span class="comment"> * @ingroup Support</span>
77
+ <a name="l00055"></a>00055 <span class="comment"> */</span>
78
+ <a name="l00056"></a><a class="code" href="classPassenger_1_1Process.html">00056</a> <span class="keyword">class </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> {
79
+ <a name="l00057"></a>00057 <span class="keyword">public</span>:
80
+ <a name="l00058"></a>00058 <span class="keyword">struct </span>SocketInfo {
81
+ <a name="l00059"></a>00059 <span class="keywordtype">string</span> address;
82
+ <a name="l00060"></a>00060 <span class="keywordtype">string</span> type;
83
+ <a name="l00061"></a>00061
84
+ <a name="l00062"></a>00062 SocketInfo() {}
85
+ <a name="l00063"></a>00063
86
+ <a name="l00064"></a>00064 SocketInfo(<span class="keyword">const</span> <span class="keywordtype">string</span> &amp;address, <span class="keyword">const</span> <span class="keywordtype">string</span> &amp;type) {
87
+ <a name="l00065"></a>00065 this-&gt;address = address;
88
+ <a name="l00066"></a>00066 this-&gt;type = type;
89
+ <a name="l00067"></a>00067 }
90
+ <a name="l00068"></a>00068 };
91
+ <a name="l00069"></a>00069
92
+ <a name="l00070"></a>00070 <span class="keyword">typedef</span> map&lt;string, SocketInfo&gt; SocketInfoMap;
93
+ <a name="l00071"></a>00071
94
+ <a name="l00072"></a>00072 <span class="keyword">private</span>:
95
+ <a name="l00073"></a>00073 <span class="keywordtype">string</span> appRoot;
96
+ <a name="l00074"></a>00074 pid_t pid;
97
+ <a name="l00075"></a>00075 <span class="keywordtype">int</span> ownerPipe;
98
+ <a name="l00076"></a>00076 <span class="keywordtype">string</span> detachKey;
99
+ <a name="l00077"></a>00077 <span class="keywordtype">string</span> connectPassword;
100
+ <a name="l00078"></a>00078 SocketInfoMap serverSockets;
101
+ <a name="l00079"></a>00079 SocketInfo *mainServerSocket;
102
+ <a name="l00080"></a>00080 function&lt;void ()&gt; destructionCallback;
103
+ <a name="l00081"></a>00081
104
+ <a name="l00082"></a>00082 <span class="keyword">public</span>:<span class="comment"></span>
105
+ <a name="l00083"></a>00083 <span class="comment"> /**</span>
106
+ <a name="l00084"></a>00084 <span class="comment"> * Construct a new Process object.</span>
107
+ <a name="l00085"></a>00085 <span class="comment"> *</span>
108
+ <a name="l00086"></a>00086 <span class="comment"> * @param appRoot The application root of an application.</span>
109
+ <a name="l00087"></a>00087 <span class="comment"> * This must be a valid directory, but the path does not have to be absolute.</span>
110
+ <a name="l00088"></a>00088 <span class="comment"> * @param pid The process ID of this application process.</span>
111
+ <a name="l00089"></a>00089 <span class="comment"> * @param ownerPipe The owner pipe of this application process.</span>
112
+ <a name="l00090"></a>00090 <span class="comment"> * @param serverSockets All the server sockets that this process listens on.</span>
113
+ <a name="l00091"></a>00091 <span class="comment"> * There must a server socket with the name 'main'.</span>
114
+ <a name="l00092"></a>00092 <span class="comment"> * @param detachKey A detach key. Used by the ApplicationPool algorithm.</span>
115
+ <a name="l00093"></a>00093 <span class="comment"> * @param connectPassword The password to use when connecting to this process.</span>
116
+ <a name="l00094"></a>00094 <span class="comment"> * Must be valid ASCII.</span>
117
+ <a name="l00095"></a>00095 <span class="comment"> * @param destructionCallback A callback to be called when this Process is destroyed.</span>
118
+ <a name="l00096"></a>00096 <span class="comment"> * @throws ArgumentException If serverSockets has no socket named 'main'.</span>
119
+ <a name="l00097"></a>00097 <span class="comment"> */</span>
120
+ <a name="l00098"></a><a class="code" href="classPassenger_1_1Process.html#cbc73466ae557c68cf040fcce925096c">00098</a> <a class="code" href="classPassenger_1_1Process.html#cbc73466ae557c68cf040fcce925096c" title="Construct a new Process object.">Process</a>(<span class="keyword">const</span> <span class="keywordtype">string</span> &amp;appRoot, pid_t pid, <span class="keywordtype">int</span> ownerPipe, <span class="keyword">const</span> SocketInfoMap &amp;serverSockets,
121
+ <a name="l00099"></a>00099 <span class="keyword">const</span> <span class="keywordtype">string</span> &amp;detachKey, <span class="keyword">const</span> <span class="keywordtype">string</span> &amp;connectPassword,
122
+ <a name="l00100"></a>00100 <span class="keyword">const</span> function&lt;<span class="keywordtype">void</span> ()&gt; &amp;destructionCallback = function&lt;<span class="keywordtype">void</span> ()&gt;())
123
+ <a name="l00101"></a>00101 {
124
+ <a name="l00102"></a>00102 this-&gt;appRoot = appRoot;
125
+ <a name="l00103"></a>00103 this-&gt;pid = pid;
126
+ <a name="l00104"></a>00104 this-&gt;ownerPipe = ownerPipe;
127
+ <a name="l00105"></a>00105 this-&gt;serverSockets = serverSockets;
128
+ <a name="l00106"></a>00106 this-&gt;detachKey = detachKey;
129
+ <a name="l00107"></a>00107 this-&gt;connectPassword = connectPassword;
130
+ <a name="l00108"></a>00108 this-&gt;destructionCallback = destructionCallback;
131
+ <a name="l00109"></a>00109 <span class="keywordflow">if</span> (serverSockets.find(<span class="stringliteral">"main"</span>) == serverSockets.end()) {
132
+ <a name="l00110"></a>00110 TRACE_POINT();
133
+ <a name="l00111"></a>00111 <span class="keywordflow">throw</span> <a class="code" href="classPassenger_1_1ArgumentException.html" title="Indicates that a specified argument is incorrect or violates a requirement.">ArgumentException</a>(<span class="stringliteral">"There must be a server socket named 'main'."</span>);
134
+ <a name="l00112"></a>00112 }
135
+ <a name="l00113"></a>00113 mainServerSocket = &amp;this-&gt;serverSockets[<span class="stringliteral">"main"</span>];
136
+ <a name="l00114"></a>00114 P_TRACE(3, <span class="stringliteral">"Application process "</span> &lt;&lt; <span class="keyword">this</span> &lt;&lt; <span class="stringliteral">": created."</span>);
137
+ <a name="l00115"></a>00115 }
138
+ <a name="l00116"></a>00116
139
+ <a name="l00117"></a>00117 <span class="keyword">virtual</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>() {
140
+ <a name="l00118"></a>00118 TRACE_POINT();
141
+ <a name="l00119"></a>00119 SocketInfoMap::const_iterator it;
142
+ <a name="l00120"></a>00120 <span class="keywordtype">int</span> ret;
143
+ <a name="l00121"></a>00121
144
+ <a name="l00122"></a>00122 <span class="keywordflow">if</span> (ownerPipe != -1) {
145
+ <a name="l00123"></a>00123 <span class="keywordflow">do</span> {
146
+ <a name="l00124"></a>00124 ret = close(ownerPipe);
147
+ <a name="l00125"></a>00125 } <span class="keywordflow">while</span> (ret == -1 &amp;&amp; errno == EINTR);
148
+ <a name="l00126"></a>00126 }
149
+ <a name="l00127"></a>00127 <span class="keywordflow">for</span> (it = serverSockets.begin(); it != serverSockets.end(); it++) {
150
+ <a name="l00128"></a>00128 <span class="keyword">const</span> SocketInfo &amp;info = it-&gt;second;
151
+ <a name="l00129"></a>00129 <span class="keywordflow">if</span> (info.type == <span class="stringliteral">"unix"</span>) {
152
+ <a name="l00130"></a>00130 <span class="keywordflow">do</span> {
153
+ <a name="l00131"></a>00131 ret = unlink(info.address.c_str());
154
+ <a name="l00132"></a>00132 } <span class="keywordflow">while</span> (ret == -1 &amp;&amp; errno == EINTR);
155
+ <a name="l00133"></a>00133 }
156
+ <a name="l00134"></a>00134 }
157
+ <a name="l00135"></a>00135 P_TRACE(3, <span class="stringliteral">"Application process "</span> &lt;&lt; <span class="keyword">this</span> &lt;&lt; <span class="stringliteral">": destroyed."</span>);
158
+ <a name="l00136"></a>00136
159
+ <a name="l00137"></a>00137 <span class="keywordflow">if</span> (destructionCallback) {
160
+ <a name="l00138"></a>00138 destructionCallback();
161
+ <a name="l00139"></a>00139 }
162
+ <a name="l00140"></a>00140 }
163
+ <a name="l00141"></a>00141 <span class="comment"></span>
164
+ <a name="l00142"></a>00142 <span class="comment"> /**</span>
165
+ <a name="l00143"></a>00143 <span class="comment"> * Returns the application root for this application process. See</span>
166
+ <a name="l00144"></a>00144 <span class="comment"> * the constructor for information about the application root.</span>
167
+ <a name="l00145"></a>00145 <span class="comment"> */</span>
168
+ <a name="l00146"></a><a class="code" href="classPassenger_1_1Process.html#ce9e949fa460ce09228cc08d76fc38e7">00146</a> <span class="keywordtype">string</span> <a class="code" href="classPassenger_1_1Process.html#ce9e949fa460ce09228cc08d76fc38e7" title="Returns the application root for this application process.">getAppRoot</a>()<span class="keyword"> const </span>{
169
+ <a name="l00147"></a>00147 <span class="keywordflow">return</span> appRoot;
170
+ <a name="l00148"></a>00148 }
171
+ <a name="l00149"></a>00149 <span class="comment"></span>
172
+ <a name="l00150"></a>00150 <span class="comment"> /**</span>
173
+ <a name="l00151"></a>00151 <span class="comment"> * Returns the process ID of this application process.</span>
174
+ <a name="l00152"></a>00152 <span class="comment"> */</span>
175
+ <a name="l00153"></a><a class="code" href="classPassenger_1_1Process.html#fc1b82c05e963fee7e58445b152ca784">00153</a> pid_t <a class="code" href="classPassenger_1_1Process.html#fc1b82c05e963fee7e58445b152ca784" title="Returns the process ID of this application process.">getPid</a>()<span class="keyword"> const </span>{
176
+ <a name="l00154"></a>00154 <span class="keywordflow">return</span> pid;
177
+ <a name="l00155"></a>00155 }
178
+ <a name="l00156"></a>00156 <span class="comment"></span>
179
+ <a name="l00157"></a>00157 <span class="comment"> /**</span>
180
+ <a name="l00158"></a>00158 <span class="comment"> * Returns this process's detach key.</span>
181
+ <a name="l00159"></a>00159 <span class="comment"> */</span>
182
+ <a name="l00160"></a><a class="code" href="classPassenger_1_1Process.html#308fa4c3bf80e4d3d48a3c833b9e3205">00160</a> <span class="keywordtype">string</span> <a class="code" href="classPassenger_1_1Process.html#308fa4c3bf80e4d3d48a3c833b9e3205" title="Returns this process&amp;#39;s detach key.">getDetachKey</a>()<span class="keyword"> const </span>{
183
+ <a name="l00161"></a>00161 <span class="keywordflow">return</span> detachKey;
184
+ <a name="l00162"></a>00162 }
185
+ <a name="l00163"></a>00163 <span class="comment"></span>
186
+ <a name="l00164"></a>00164 <span class="comment"> /**</span>
187
+ <a name="l00165"></a>00165 <span class="comment"> * Returns this process's connect password. This password is</span>
188
+ <a name="l00166"></a>00166 <span class="comment"> * guaranteed to be valid ASCII.</span>
189
+ <a name="l00167"></a>00167 <span class="comment"> */</span>
190
+ <a name="l00168"></a><a class="code" href="classPassenger_1_1Process.html#002791d7909d4d7a6566eb26ec491552">00168</a> <span class="keywordtype">string</span> <a class="code" href="classPassenger_1_1Process.html#002791d7909d4d7a6566eb26ec491552" title="Returns this process&amp;#39;s connect password.">getConnectPassword</a>()<span class="keyword"> const </span>{
191
+ <a name="l00169"></a>00169 <span class="keywordflow">return</span> connectPassword;
192
+ <a name="l00170"></a>00170 }
193
+ <a name="l00171"></a>00171 <span class="comment"></span>
194
+ <a name="l00172"></a>00172 <span class="comment"> /**</span>
195
+ <a name="l00173"></a>00173 <span class="comment"> * Returns a map containing all server sockets that this process</span>
196
+ <a name="l00174"></a>00174 <span class="comment"> * listens on.</span>
197
+ <a name="l00175"></a>00175 <span class="comment"> */</span>
198
+ <a name="l00176"></a><a class="code" href="classPassenger_1_1Process.html#fe06f5be540203452a5e787da15ee5e4">00176</a> <span class="keyword">const</span> SocketInfoMap *<a class="code" href="classPassenger_1_1Process.html#fe06f5be540203452a5e787da15ee5e4" title="Returns a map containing all server sockets that this process listens on.">getServerSockets</a>()<span class="keyword"> const </span>{
199
+ <a name="l00177"></a>00177 <span class="keywordflow">return</span> &amp;serverSockets;
200
+ <a name="l00178"></a>00178 }
201
+ <a name="l00179"></a>00179 <span class="comment"></span>
202
+ <a name="l00180"></a>00180 <span class="comment"> /**</span>
203
+ <a name="l00181"></a>00181 <span class="comment"> * Request a new session from this application process by connecting to its</span>
204
+ <a name="l00182"></a>00182 <span class="comment"> * main server socket. This session represents the life time of a single</span>
205
+ <a name="l00183"></a>00183 <span class="comment"> * request/response pair, and can be used to send the request data to the</span>
206
+ <a name="l00184"></a>00184 <span class="comment"> * application process, as well as receiving the response data.</span>
207
+ <a name="l00185"></a>00185 <span class="comment"> *</span>
208
+ <a name="l00186"></a>00186 <span class="comment"> * The use of connect() is demonstrated in the following example.</span>
209
+ <a name="l00187"></a>00187 <span class="comment"> * @code</span>
210
+ <a name="l00188"></a>00188 <span class="comment"> * // Request a new session from the process.</span>
211
+ <a name="l00189"></a>00189 <span class="comment"> * SessionPtr session = process-&gt;newSession(...);</span>
212
+ <a name="l00190"></a>00190 <span class="comment"> * </span>
213
+ <a name="l00191"></a>00191 <span class="comment"> * // Send the request headers and request body data.</span>
214
+ <a name="l00192"></a>00192 <span class="comment"> * session-&gt;sendHeaders(...);</span>
215
+ <a name="l00193"></a>00193 <span class="comment"> * session-&gt;sendBodyBlock(...);</span>
216
+ <a name="l00194"></a>00194 <span class="comment"> * // Done sending data, so we close the writer channel.</span>
217
+ <a name="l00195"></a>00195 <span class="comment"> * session-&gt;shutdownWriter();</span>
218
+ <a name="l00196"></a>00196 <span class="comment"> *</span>
219
+ <a name="l00197"></a>00197 <span class="comment"> * // Now read the HTTP response.</span>
220
+ <a name="l00198"></a>00198 <span class="comment"> * string responseData = readAllDataFromSocket(session-&gt;getReader());</span>
221
+ <a name="l00199"></a>00199 <span class="comment"> * // Done reading data, so we close the reader channel.</span>
222
+ <a name="l00200"></a>00200 <span class="comment"> * session-&gt;shutdownReader();</span>
223
+ <a name="l00201"></a>00201 <span class="comment"> *</span>
224
+ <a name="l00202"></a>00202 <span class="comment"> * // This session has now finished, so we close the session by resetting</span>
225
+ <a name="l00203"></a>00203 <span class="comment"> * // the smart pointer to NULL (thereby destroying the Session object).</span>
226
+ <a name="l00204"></a>00204 <span class="comment"> * session.reset();</span>
227
+ <a name="l00205"></a>00205 <span class="comment"> *</span>
228
+ <a name="l00206"></a>00206 <span class="comment"> * // We can connect to a Process multiple times. Just make sure</span>
229
+ <a name="l00207"></a>00207 <span class="comment"> * // the previous session is closed.</span>
230
+ <a name="l00208"></a>00208 <span class="comment"> * session = process-&gt;newSession(...);</span>
231
+ <a name="l00209"></a>00209 <span class="comment"> * @endcode</span>
232
+ <a name="l00210"></a>00210 <span class="comment"> *</span>
233
+ <a name="l00211"></a>00211 <span class="comment"> * You &lt;b&gt;must&lt;/b&gt; close a session when you no longer need it. If you</span>
234
+ <a name="l00212"></a>00212 <span class="comment"> * call connect() without having properly closed a previous session,</span>
235
+ <a name="l00213"></a>00213 <span class="comment"> * you might cause a deadlock because the application process may be</span>
236
+ <a name="l00214"></a>00214 <span class="comment"> * waiting for you to close the previous session.</span>
237
+ <a name="l00215"></a>00215 <span class="comment"> *</span>
238
+ <a name="l00216"></a>00216 <span class="comment"> * @param closeCallback A function which will be called when the session has been closed.</span>
239
+ <a name="l00217"></a>00217 <span class="comment"> * @param initiateNow Whether the session should be initiated immediately.</span>
240
+ <a name="l00218"></a>00218 <span class="comment"> * If set to false then you must call &lt;tt&gt;initiate()&lt;/tt&gt; on</span>
241
+ <a name="l00219"></a>00219 <span class="comment"> * the session before it's usable.</span>
242
+ <a name="l00220"></a>00220 <span class="comment"> * @return A smart pointer to a Session object, which represents the created session.</span>
243
+ <a name="l00221"></a>00221 <span class="comment"> * @post result-&gt;initiated() == initiateNow</span>
244
+ <a name="l00222"></a>00222 <span class="comment"> * @throws SystemException Something went wrong during session initiation.</span>
245
+ <a name="l00223"></a>00223 <span class="comment"> * @throws IOException Something went wrong during session initiation.</span>
246
+ <a name="l00224"></a>00224 <span class="comment"> * @throws boost::thread_interrupted</span>
247
+ <a name="l00225"></a>00225 <span class="comment"> */</span>
248
+ <a name="l00226"></a><a class="code" href="classPassenger_1_1Process.html#a5bd9ad8220bf64e5edf3d025004547a">00226</a> SessionPtr <a class="code" href="classPassenger_1_1Process.html#a5bd9ad8220bf64e5edf3d025004547a" title="Request a new session from this application process by connecting to its main server...">newSession</a>(<span class="keyword">const</span> function&lt;<span class="keywordtype">void</span>()&gt; &amp;closeCallback = function&lt;<span class="keywordtype">void</span>()&gt;(),
249
+ <a name="l00227"></a>00227 <span class="keywordtype">bool</span> initiateNow = <span class="keyword">true</span>)
250
+ <a name="l00228"></a>00228 {
251
+ <a name="l00229"></a>00229 SessionPtr session(<span class="keyword">new</span> <a class="code" href="classPassenger_1_1StandardSession.html" title="A &amp;quot;standard&amp;quot; implementation of Session.">StandardSession</a>(pid, closeCallback,
252
+ <a name="l00230"></a>00230 mainServerSocket-&gt;type, mainServerSocket-&gt;address,
253
+ <a name="l00231"></a>00231 detachKey, connectPassword));
254
+ <a name="l00232"></a>00232 <span class="keywordflow">if</span> (initiateNow) {
255
+ <a name="l00233"></a>00233 session-&gt;initiate();
256
+ <a name="l00234"></a>00234 }
257
+ <a name="l00235"></a>00235 <span class="keywordflow">return</span> session;
258
+ <a name="l00236"></a>00236 }
259
+ <a name="l00237"></a>00237 };
260
+ <a name="l00238"></a>00238 <span class="comment"></span>
261
+ <a name="l00239"></a>00239 <span class="comment">/** Convenient alias for Process smart pointer. */</span>
262
+ <a name="l00240"></a><a class="code" href="namespacePassenger.html#ced1f248465136b313c6dec5fe6ca492">00240</a> <span class="keyword">typedef</span> shared_ptr&lt;Process&gt; <a class="code" href="namespacePassenger.html#ced1f248465136b313c6dec5fe6ca492" title="Convenient alias for Process smart pointer.">ProcessPtr</a>;
263
+ <a name="l00241"></a>00241
264
+ <a name="l00242"></a>00242 } <span class="comment">// namespace Passenger</span>
265
+ <a name="l00243"></a>00243
266
+ <a name="l00244"></a>00244 <span class="preprocessor">#endif </span><span class="comment">/* _PASSENGER_PROCESS_H_ */</span>
267
+ </pre></div></div>
268
+ <hr size="1"><address style="text-align: right;"><small>Generated on Sun Feb 21 12:22:46 2010 for Passenger by&nbsp;
269
+ <a href="http://www.doxygen.org/index.html">
270
+ <img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.8 </small></address>
271
+ </body>
272
+ </html>
@@ -0,0 +1,156 @@
1
+ <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2
+ <html><head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
3
+ <title>Passenger: RandomGenerator.h Source File</title>
4
+ <link href="tabs.css" rel="stylesheet" type="text/css">
5
+ <link href="doxygen.css" rel="stylesheet" type="text/css">
6
+ </head><body>
7
+ <!-- Generated by Doxygen 1.5.8 -->
8
+ <div class="navigation" id="top">
9
+ <div class="tabs">
10
+ <ul>
11
+ <li><a href="main.html"><span>Main&nbsp;Page</span></a></li>
12
+ <li><a href="modules.html"><span>Modules</span></a></li>
13
+ <li><a href="namespaces.html"><span>Namespaces</span></a></li>
14
+ <li><a href="annotated.html"><span>Classes</span></a></li>
15
+ <li class="current"><a href="files.html"><span>Files</span></a></li>
16
+ </ul>
17
+ </div>
18
+ <div class="tabs">
19
+ <ul>
20
+ <li><a href="files.html"><span>File&nbsp;List</span></a></li>
21
+ </ul>
22
+ </div>
23
+ <h1>RandomGenerator.h</h1><div class="fragment"><pre class="fragment"><a name="l00001"></a>00001 <span class="comment">/*</span>
24
+ <a name="l00002"></a>00002 <span class="comment"> * Phusion Passenger - http://www.modrails.com/</span>
25
+ <a name="l00003"></a>00003 <span class="comment"> * Copyright (c) 2010 Phusion</span>
26
+ <a name="l00004"></a>00004 <span class="comment"> *</span>
27
+ <a name="l00005"></a>00005 <span class="comment"> * "Phusion Passenger" is a trademark of Hongli Lai &amp; Ninh Bui.</span>
28
+ <a name="l00006"></a>00006 <span class="comment"> *</span>
29
+ <a name="l00007"></a>00007 <span class="comment"> * Permission is hereby granted, free of charge, to any person obtaining a copy</span>
30
+ <a name="l00008"></a>00008 <span class="comment"> * of this software and associated documentation files (the "Software"), to deal</span>
31
+ <a name="l00009"></a>00009 <span class="comment"> * in the Software without restriction, including without limitation the rights</span>
32
+ <a name="l00010"></a>00010 <span class="comment"> * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell</span>
33
+ <a name="l00011"></a>00011 <span class="comment"> * copies of the Software, and to permit persons to whom the Software is</span>
34
+ <a name="l00012"></a>00012 <span class="comment"> * furnished to do so, subject to the following conditions:</span>
35
+ <a name="l00013"></a>00013 <span class="comment"> *</span>
36
+ <a name="l00014"></a>00014 <span class="comment"> * The above copyright notice and this permission notice shall be included in</span>
37
+ <a name="l00015"></a>00015 <span class="comment"> * all copies or substantial portions of the Software.</span>
38
+ <a name="l00016"></a>00016 <span class="comment"> *</span>
39
+ <a name="l00017"></a>00017 <span class="comment"> * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR</span>
40
+ <a name="l00018"></a>00018 <span class="comment"> * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,</span>
41
+ <a name="l00019"></a>00019 <span class="comment"> * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE</span>
42
+ <a name="l00020"></a>00020 <span class="comment"> * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER</span>
43
+ <a name="l00021"></a>00021 <span class="comment"> * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,</span>
44
+ <a name="l00022"></a>00022 <span class="comment"> * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN</span>
45
+ <a name="l00023"></a>00023 <span class="comment"> * THE SOFTWARE.</span>
46
+ <a name="l00024"></a>00024 <span class="comment"> */</span>
47
+ <a name="l00025"></a>00025 <span class="preprocessor">#ifndef _PASSENGER_RANDOM_GENERATOR_H_</span>
48
+ <a name="l00026"></a>00026 <span class="preprocessor"></span><span class="preprocessor">#define _PASSENGER_RANDOM_GENERATOR_H_</span>
49
+ <a name="l00027"></a>00027 <span class="preprocessor"></span>
50
+ <a name="l00028"></a>00028 <span class="preprocessor">#include &lt;string&gt;</span>
51
+ <a name="l00029"></a>00029
52
+ <a name="l00030"></a>00030 <span class="preprocessor">#include &lt;boost/noncopyable.hpp&gt;</span>
53
+ <a name="l00031"></a>00031 <span class="preprocessor">#include &lt;boost/shared_ptr.hpp&gt;</span>
54
+ <a name="l00032"></a>00032 <span class="preprocessor">#include &lt;oxt/system_calls.hpp&gt;</span>
55
+ <a name="l00033"></a>00033
56
+ <a name="l00034"></a>00034 <span class="preprocessor">#include "StaticString.h"</span>
57
+ <a name="l00035"></a>00035 <span class="preprocessor">#include "Utils.h"</span>
58
+ <a name="l00036"></a>00036 <span class="preprocessor">#include "Exceptions.h"</span>
59
+ <a name="l00037"></a>00037
60
+ <a name="l00038"></a>00038 <span class="comment"></span>
61
+ <a name="l00039"></a>00039 <span class="comment">/**</span>
62
+ <a name="l00040"></a>00040 <span class="comment"> * A random </span>
63
+ <a name="l00041"></a>00041 <span class="comment"> */</span>
64
+ <a name="l00042"></a>00042 <span class="keyword">namespace </span>Passenger {
65
+ <a name="l00043"></a>00043
66
+ <a name="l00044"></a>00044 <span class="keyword">using namespace </span>std;
67
+ <a name="l00045"></a>00045 <span class="keyword">using namespace </span>boost;
68
+ <a name="l00046"></a>00046 <span class="keyword">using namespace </span>oxt;
69
+ <a name="l00047"></a>00047 <span class="comment"></span>
70
+ <a name="l00048"></a>00048 <span class="comment">/**</span>
71
+ <a name="l00049"></a>00049 <span class="comment"> * A random data generator. Data is generated using /dev/urandom, and</span>
72
+ <a name="l00050"></a>00050 <span class="comment"> * is cryptographically secure. Unlike rand() and friends,</span>
73
+ <a name="l00051"></a>00051 <span class="comment"> * RandomGenerator does not require seeding.</span>
74
+ <a name="l00052"></a>00052 <span class="comment"> *</span>
75
+ <a name="l00053"></a>00053 <span class="comment"> * The reason why RandomGenerator isn't a singleton is because opening</span>
76
+ <a name="l00054"></a>00054 <span class="comment"> * /dev/urandom is *very* slow on Mac OS X and OpenBSD. Each object of</span>
77
+ <a name="l00055"></a>00055 <span class="comment"> * this class caches the /dev/urandom file handle.</span>
78
+ <a name="l00056"></a>00056 <span class="comment"> *</span>
79
+ <a name="l00057"></a>00057 <span class="comment"> * This class is thread-safe as long as there are no concurrent</span>
80
+ <a name="l00058"></a>00058 <span class="comment"> * calls to reopen() or close().</span>
81
+ <a name="l00059"></a>00059 <span class="comment"> */</span>
82
+ <a name="l00060"></a><a class="code" href="classPassenger_1_1RandomGenerator.html">00060</a> <span class="keyword">class </span><a class="code" href="classPassenger_1_1RandomGenerator.html" title="A random data generator.">RandomGenerator</a>: <span class="keyword">public</span> boost::noncopyable {
83
+ <a name="l00061"></a>00061 <span class="keyword">private</span>:
84
+ <a name="l00062"></a>00062 FILE *handle;
85
+ <a name="l00063"></a>00063
86
+ <a name="l00064"></a>00064 <span class="keyword">public</span>:
87
+ <a name="l00065"></a>00065 <a class="code" href="classPassenger_1_1RandomGenerator.html" title="A random data generator.">RandomGenerator</a>(<span class="keywordtype">bool</span> open = <span class="keyword">true</span>) {
88
+ <a name="l00066"></a>00066 handle = NULL;
89
+ <a name="l00067"></a>00067 <span class="keywordflow">if</span> (open) {
90
+ <a name="l00068"></a>00068 reopen();
91
+ <a name="l00069"></a>00069 }
92
+ <a name="l00070"></a>00070 }
93
+ <a name="l00071"></a>00071
94
+ <a name="l00072"></a>00072 ~<a class="code" href="classPassenger_1_1RandomGenerator.html" title="A random data generator.">RandomGenerator</a>() {
95
+ <a name="l00073"></a>00073 this_thread::disable_syscall_interruption dsi;
96
+ <a name="l00074"></a>00074 close();
97
+ <a name="l00075"></a>00075 }
98
+ <a name="l00076"></a>00076
99
+ <a name="l00077"></a>00077 <span class="keywordtype">void</span> reopen() {
100
+ <a name="l00078"></a>00078 close();
101
+ <a name="l00079"></a>00079 handle = syscalls::fopen(<span class="stringliteral">"/dev/urandom"</span>, <span class="stringliteral">"r"</span>);
102
+ <a name="l00080"></a>00080 <span class="keywordflow">if</span> (handle == NULL) {
103
+ <a name="l00081"></a>00081 <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">"Cannot open /dev/urandom"</span>,
104
+ <a name="l00082"></a>00082 errno, <span class="stringliteral">"/dev/urandom"</span>);
105
+ <a name="l00083"></a>00083 }
106
+ <a name="l00084"></a>00084 }
107
+ <a name="l00085"></a>00085
108
+ <a name="l00086"></a>00086 <span class="keywordtype">void</span> close() {
109
+ <a name="l00087"></a>00087 <span class="keywordflow">if</span> (handle != NULL) {
110
+ <a name="l00088"></a>00088 syscalls::fclose(handle);
111
+ <a name="l00089"></a>00089 handle = NULL;
112
+ <a name="l00090"></a>00090 }
113
+ <a name="l00091"></a>00091 }
114
+ <a name="l00092"></a>00092
115
+ <a name="l00093"></a>00093 <a class="code" href="classPassenger_1_1StaticString.html" title="An immutable, static byte buffer.">StaticString</a> generateBytes(<span class="keywordtype">void</span> *buf, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> size) {
116
+ <a name="l00094"></a>00094 <span class="keywordtype">size_t</span> ret = syscalls::fread(buf, 1, size, handle);
117
+ <a name="l00095"></a>00095 <span class="keywordflow">if</span> (ret != size) {
118
+ <a name="l00096"></a>00096 <span class="keywordflow">throw</span> <a class="code" href="classPassenger_1_1IOException.html" title="Represents an error that occured during an I/O operation.">IOException</a>(<span class="stringliteral">"Cannot read sufficient data from /dev/urandom"</span>);
119
+ <a name="l00097"></a>00097 }
120
+ <a name="l00098"></a>00098 <span class="keywordflow">return</span> <a class="code" href="classPassenger_1_1StaticString.html" title="An immutable, static byte buffer.">StaticString</a>((<span class="keyword">const</span> <span class="keywordtype">char</span> *) buf, size);
121
+ <a name="l00099"></a>00099 }
122
+ <a name="l00100"></a>00100
123
+ <a name="l00101"></a>00101 <span class="keywordtype">string</span> generateByteString(<span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> size) {
124
+ <a name="l00102"></a>00102 <span class="keywordtype">char</span> buf[size];
125
+ <a name="l00103"></a>00103 generateBytes(buf, size);
126
+ <a name="l00104"></a>00104 <span class="keywordflow">return</span> string(buf, size);
127
+ <a name="l00105"></a>00105 }
128
+ <a name="l00106"></a>00106
129
+ <a name="l00107"></a>00107 <span class="keywordtype">string</span> generateHexString(<span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> size) {
130
+ <a name="l00108"></a>00108 <span class="keywordtype">char</span> buf[size];
131
+ <a name="l00109"></a>00109 generateBytes(buf, size);
132
+ <a name="l00110"></a>00110 <span class="keywordflow">return</span> <a class="code" href="namespacePassenger.html#1d4b16a419fe7231bc8b7036266f8131" title="Convert the given binary data to hexadecimal.">toHex</a>(<a class="code" href="classPassenger_1_1StaticString.html" title="An immutable, static byte buffer.">StaticString</a>(buf, size));
133
+ <a name="l00111"></a>00111 }
134
+ <a name="l00112"></a>00112
135
+ <a name="l00113"></a>00113 <span class="keywordtype">int</span> generateInt() {
136
+ <a name="l00114"></a>00114 <span class="keywordtype">int</span> ret;
137
+ <a name="l00115"></a>00115 generateBytes(&amp;ret, <span class="keyword">sizeof</span>(ret));
138
+ <a name="l00116"></a>00116 <span class="keywordflow">return</span> ret;
139
+ <a name="l00117"></a>00117 }
140
+ <a name="l00118"></a>00118
141
+ <a name="l00119"></a>00119 <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> generateUint() {
142
+ <a name="l00120"></a>00120 <span class="keywordflow">return</span> (<span class="keywordtype">unsigned</span> <span class="keywordtype">int</span>) generateInt();
143
+ <a name="l00121"></a>00121 }
144
+ <a name="l00122"></a>00122 };
145
+ <a name="l00123"></a>00123
146
+ <a name="l00124"></a>00124 <span class="keyword">typedef</span> shared_ptr&lt;RandomGenerator&gt; RandomGeneratorPtr;
147
+ <a name="l00125"></a>00125
148
+ <a name="l00126"></a>00126 } <span class="comment">// namespace Passenger</span>
149
+ <a name="l00127"></a>00127
150
+ <a name="l00128"></a>00128 <span class="preprocessor">#endif </span><span class="comment">/* _PASSENGER_RANDOM_GENERATOR_H_ */</span>
151
+ </pre></div></div>
152
+ <hr size="1"><address style="text-align: right;"><small>Generated on Sun Feb 21 12:22:46 2010 for Passenger by&nbsp;
153
+ <a href="http://www.doxygen.org/index.html">
154
+ <img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.8 </small></address>
155
+ </body>
156
+ </html>
@@ -0,0 +1,104 @@
1
+ <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2
+ <html><head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
3
+ <title>Passenger: ResourceLocator.h Source File</title>
4
+ <link href="tabs.css" rel="stylesheet" type="text/css">
5
+ <link href="doxygen.css" rel="stylesheet" type="text/css">
6
+ </head><body>
7
+ <!-- Generated by Doxygen 1.5.8 -->
8
+ <div class="navigation" id="top">
9
+ <div class="tabs">
10
+ <ul>
11
+ <li><a href="main.html"><span>Main&nbsp;Page</span></a></li>
12
+ <li><a href="modules.html"><span>Modules</span></a></li>
13
+ <li><a href="namespaces.html"><span>Namespaces</span></a></li>
14
+ <li><a href="annotated.html"><span>Classes</span></a></li>
15
+ <li class="current"><a href="files.html"><span>Files</span></a></li>
16
+ </ul>
17
+ </div>
18
+ <div class="tabs">
19
+ <ul>
20
+ <li><a href="files.html"><span>File&nbsp;List</span></a></li>
21
+ </ul>
22
+ </div>
23
+ <h1>ResourceLocator.h</h1><div class="fragment"><pre class="fragment"><a name="l00001"></a>00001 <span class="comment">/*</span>
24
+ <a name="l00002"></a>00002 <span class="comment"> * Phusion Passenger - http://www.modrails.com/</span>
25
+ <a name="l00003"></a>00003 <span class="comment"> * Copyright (c) 2010 Phusion</span>
26
+ <a name="l00004"></a>00004 <span class="comment"> *</span>
27
+ <a name="l00005"></a>00005 <span class="comment"> * "Phusion Passenger" is a trademark of Hongli Lai &amp; Ninh Bui.</span>
28
+ <a name="l00006"></a>00006 <span class="comment"> *</span>
29
+ <a name="l00007"></a>00007 <span class="comment"> * Permission is hereby granted, free of charge, to any person obtaining a copy</span>
30
+ <a name="l00008"></a>00008 <span class="comment"> * of this software and associated documentation files (the "Software"), to deal</span>
31
+ <a name="l00009"></a>00009 <span class="comment"> * in the Software without restriction, including without limitation the rights</span>
32
+ <a name="l00010"></a>00010 <span class="comment"> * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell</span>
33
+ <a name="l00011"></a>00011 <span class="comment"> * copies of the Software, and to permit persons to whom the Software is</span>
34
+ <a name="l00012"></a>00012 <span class="comment"> * furnished to do so, subject to the following conditions:</span>
35
+ <a name="l00013"></a>00013 <span class="comment"> *</span>
36
+ <a name="l00014"></a>00014 <span class="comment"> * The above copyright notice and this permission notice shall be included in</span>
37
+ <a name="l00015"></a>00015 <span class="comment"> * all copies or substantial portions of the Software.</span>
38
+ <a name="l00016"></a>00016 <span class="comment"> *</span>
39
+ <a name="l00017"></a>00017 <span class="comment"> * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR</span>
40
+ <a name="l00018"></a>00018 <span class="comment"> * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,</span>
41
+ <a name="l00019"></a>00019 <span class="comment"> * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE</span>
42
+ <a name="l00020"></a>00020 <span class="comment"> * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER</span>
43
+ <a name="l00021"></a>00021 <span class="comment"> * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,</span>
44
+ <a name="l00022"></a>00022 <span class="comment"> * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN</span>
45
+ <a name="l00023"></a>00023 <span class="comment"> * THE SOFTWARE.</span>
46
+ <a name="l00024"></a>00024 <span class="comment"> */</span>
47
+ <a name="l00025"></a>00025 <span class="preprocessor">#ifndef _PASSENGER_RESOURCE_LOCATOR_H_</span>
48
+ <a name="l00026"></a>00026 <span class="preprocessor"></span><span class="preprocessor">#define _PASSENGER_RESOURCE_LOCATOR_H_</span>
49
+ <a name="l00027"></a>00027 <span class="preprocessor"></span>
50
+ <a name="l00028"></a>00028 <span class="preprocessor">#include &lt;string&gt;</span>
51
+ <a name="l00029"></a>00029 <span class="preprocessor">#include "Utils.h"</span>
52
+ <a name="l00030"></a>00030
53
+ <a name="l00031"></a>00031 <span class="keyword">namespace </span>Passenger {
54
+ <a name="l00032"></a>00032
55
+ <a name="l00033"></a>00033 <span class="keyword">class </span>ResourceLocator {
56
+ <a name="l00034"></a>00034 <span class="keyword">private</span>:
57
+ <a name="l00035"></a>00035 <span class="keywordtype">string</span> root;
58
+ <a name="l00036"></a>00036 <span class="keywordtype">bool</span> nativelyPackaged;
59
+ <a name="l00037"></a>00037
60
+ <a name="l00038"></a>00038 <span class="keyword">public</span>:
61
+ <a name="l00039"></a>00039 ResourceLocator(<span class="keyword">const</span> <span class="keywordtype">string</span> &amp;passengerRoot) {
62
+ <a name="l00040"></a>00040 root = passengerRoot;
63
+ <a name="l00041"></a>00041 nativelyPackaged = !<a class="code" href="group__Support.html#g2a62e38a72c6c65992e3361f6d80c7ef" title="Check whether the specified file exists.">fileExists</a>(root + <span class="stringliteral">"/Rakefile"</span>) ||
64
+ <a name="l00042"></a>00042 !<a class="code" href="group__Support.html#g2a62e38a72c6c65992e3361f6d80c7ef" title="Check whether the specified file exists.">fileExists</a>(root + <span class="stringliteral">"/DEVELOPERS.TXT"</span>);
65
+ <a name="l00043"></a>00043 }
66
+ <a name="l00044"></a>00044
67
+ <a name="l00045"></a>00045 <span class="keywordtype">string</span> getSourceRoot()<span class="keyword"> const </span>{
68
+ <a name="l00046"></a>00046 <span class="keywordflow">if</span> (nativelyPackaged) {
69
+ <a name="l00047"></a>00047 <span class="keywordflow">return</span> <span class="stringliteral">"/usr/lib/phusion-passenger/source"</span>;
70
+ <a name="l00048"></a>00048 } <span class="keywordflow">else</span> {
71
+ <a name="l00049"></a>00049 <span class="keywordflow">return</span> root;
72
+ <a name="l00050"></a>00050 }
73
+ <a name="l00051"></a>00051 }
74
+ <a name="l00052"></a>00052
75
+ <a name="l00053"></a>00053 <span class="keywordtype">string</span> getAgentsDir()<span class="keyword"> const </span>{
76
+ <a name="l00054"></a>00054 <span class="keywordflow">if</span> (nativelyPackaged) {
77
+ <a name="l00055"></a>00055 <span class="keywordflow">return</span> <span class="stringliteral">"/usr/lib/phusion-passenger/agents"</span>;
78
+ <a name="l00056"></a>00056 } <span class="keywordflow">else</span> {
79
+ <a name="l00057"></a>00057 <span class="keywordflow">return</span> root + <span class="stringliteral">"/agents"</span>;
80
+ <a name="l00058"></a>00058 }
81
+ <a name="l00059"></a>00059 }
82
+ <a name="l00060"></a>00060
83
+ <a name="l00061"></a>00061 <span class="keywordtype">string</span> getHelperScriptDir()<span class="keyword"> const </span>{
84
+ <a name="l00062"></a>00062 <span class="keywordflow">if</span> (nativelyPackaged) {
85
+ <a name="l00063"></a>00063 <span class="keywordflow">return</span> <span class="stringliteral">"/usr/share/phusion-passenger/helper-scripts"</span>;
86
+ <a name="l00064"></a>00064 } <span class="keywordflow">else</span> {
87
+ <a name="l00065"></a>00065 <span class="keywordflow">return</span> root + <span class="stringliteral">"/helper-scripts"</span>;
88
+ <a name="l00066"></a>00066 }
89
+ <a name="l00067"></a>00067 }
90
+ <a name="l00068"></a>00068
91
+ <a name="l00069"></a>00069 <span class="keywordtype">string</span> getSpawnServerFilename()<span class="keyword"> const </span>{
92
+ <a name="l00070"></a>00070 <span class="keywordflow">return</span> root + <span class="stringliteral">"/bin/passenger-spawn-server"</span>;
93
+ <a name="l00071"></a>00071 }
94
+ <a name="l00072"></a>00072 };
95
+ <a name="l00073"></a>00073
96
+ <a name="l00074"></a>00074 }
97
+ <a name="l00075"></a>00075
98
+ <a name="l00076"></a>00076 <span class="preprocessor">#endif </span><span class="comment">/* _PASSENGER_RESOURCE_LOCATOR_H_ */</span>
99
+ </pre></div></div>
100
+ <hr size="1"><address style="text-align: right;"><small>Generated on Sun Feb 21 12:22:46 2010 for Passenger by&nbsp;
101
+ <a href="http://www.doxygen.org/index.html">
102
+ <img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.8 </small></address>
103
+ </body>
104
+ </html>