passenger 3.0.7 → 3.0.8

Sign up to get free protection for your applications and to get access to all the features.

Potentially problematic release.

This version of passenger might be problematic. Click here for more details.

Files changed (439) hide show
  1. data/NEWS +27 -0
  2. data/README +1 -1
  3. data/bin/passenger-install-nginx-module +3 -1
  4. data/build/config.rb +2 -1
  5. data/build/cxx_tests.rb +7 -3
  6. data/build/documentation.rb +5 -40
  7. data/build/nginx.rb +0 -1
  8. data/build/packaging.rb +0 -6
  9. data/build/rake_extensions.rb +5 -0
  10. data/doc/Architectural overview.html +344 -77
  11. data/doc/Security of user switching support.html +338 -71
  12. data/doc/Users guide Apache with comments.html +4830 -0
  13. data/doc/Users guide Apache.html +695 -428
  14. data/doc/Users guide Apache.idmap.txt +80 -0
  15. data/doc/Users guide Apache.txt +5 -5
  16. data/doc/Users guide Nginx.html +591 -313
  17. data/doc/Users guide Nginx.txt +9 -3
  18. data/doc/Users guide Standalone.html +344 -77
  19. data/ext/boost/src/pthread/thread.cpp +1 -1
  20. data/ext/common/AccountsDatabase.h +1 -1
  21. data/ext/common/Constants.h +2 -2
  22. data/ext/common/Logging.h +2 -1
  23. data/ext/common/LoggingAgent/FilterSupport.h +107 -3
  24. data/ext/common/Session.h +1 -1
  25. data/ext/common/Utils.cpp +2 -0
  26. data/ext/common/Utils/Dechunker.h +232 -0
  27. data/ext/common/Utils/HttpHeaderBufferer.h +165 -0
  28. data/ext/common/Utils/StrIntUtils.cpp +51 -15
  29. data/ext/common/Utils/StrIntUtils.h +3 -0
  30. data/ext/common/Utils/StreamBoyerMooreHorspool.h +506 -0
  31. data/ext/nginx/Configuration.c +36 -282
  32. data/ext/nginx/ContentHandler.c +17 -0
  33. data/ext/nginx/HelperAgent.cpp +397 -39
  34. data/ext/oxt/tracable_exception.cpp +3 -1
  35. data/ext/ruby/extconf.rb +1 -0
  36. data/ext/ruby/passenger_native_support.c +3 -0
  37. data/helper-scripts/prespawn +113 -31
  38. data/lib/phusion_passenger.rb +2 -2
  39. data/lib/phusion_passenger/standalone/runtime_installer.rb +3 -2
  40. data/lib/phusion_passenger/standalone/start_command.rb +12 -12
  41. data/test/cxx/DechunkerTest.cpp +216 -0
  42. data/test/cxx/FilterSupportTest.cpp +31 -4
  43. data/test/cxx/HttpHeaderBuffererTest.cpp +203 -0
  44. data/test/cxx/UtilsTest.cpp +46 -3
  45. data/test/integration_tests/hello_world_rack_spec.rb +7 -0
  46. data/test/stub/rack/config.ru +6 -1
  47. data/test/stub/rails_apps/1.2/empty/public/dispatch.cgi +1 -1
  48. data/test/stub/rails_apps/1.2/empty/public/dispatch.fcgi +1 -1
  49. data/test/stub/rails_apps/1.2/empty/public/dispatch.rb +1 -1
  50. data/test/stub/rails_apps/2.0/empty/public/dispatch.cgi +1 -1
  51. data/test/stub/rails_apps/2.0/empty/public/dispatch.fcgi +1 -1
  52. data/test/stub/rails_apps/2.0/empty/public/dispatch.rb +1 -1
  53. data/test/stub/rails_apps/2.2/empty/public/dispatch.cgi +1 -1
  54. data/test/stub/rails_apps/2.2/empty/public/dispatch.fcgi +1 -1
  55. data/test/stub/rails_apps/2.2/empty/public/dispatch.rb +1 -1
  56. metadata +20 -403
  57. data/doc/Doxyfile +0 -241
  58. data/doc/cxxapi/AbstractSpawnManager_8h_source.html +0 -141
  59. data/doc/cxxapi/Account_8h_source.html +0 -206
  60. data/doc/cxxapi/AccountsDatabase_8h_source.html +0 -161
  61. data/doc/cxxapi/AgentBase_8h_source.html +0 -70
  62. data/doc/cxxapi/AgentsStarter_8h_source.html +0 -112
  63. data/doc/cxxapi/BCrypt_8h_source.html +0 -104
  64. data/doc/cxxapi/Blowfish_8h_source.html +0 -134
  65. data/doc/cxxapi/Bucket_8h_source.html +0 -118
  66. data/doc/cxxapi/Constants_8h_source.html +0 -79
  67. data/doc/cxxapi/ContentHandler_8h_source.html +0 -95
  68. data/doc/cxxapi/DirectoryMapper_8h_source.html +0 -311
  69. data/doc/cxxapi/EventedClient_8h_source.html +0 -733
  70. data/doc/cxxapi/EventedMessageServer_8h_source.html +0 -358
  71. data/doc/cxxapi/EventedServer_8h_source.html +0 -326
  72. data/doc/cxxapi/Exceptions_8h_source.html +0 -393
  73. data/doc/cxxapi/FileDescriptor_8h_source.html +0 -324
  74. data/doc/cxxapi/Hooks_8h_source.html +0 -76
  75. data/doc/cxxapi/HttpStatusExtractor_8h_source.html +0 -382
  76. data/doc/cxxapi/IniFile_8h_source.html +0 -527
  77. data/doc/cxxapi/Logging_8h_source.html +0 -796
  78. data/doc/cxxapi/MessageChannel_8h_source.html +0 -776
  79. data/doc/cxxapi/MessageClient_8h_source.html +0 -328
  80. data/doc/cxxapi/MessageReadersWriters_8h_source.html +0 -539
  81. data/doc/cxxapi/MessageServer_8h_source.html +0 -612
  82. data/doc/cxxapi/PoolOptions_8h_source.html +0 -549
  83. data/doc/cxxapi/Process_8h_source.html +0 -286
  84. data/doc/cxxapi/RandomGenerator_8h_source.html +0 -191
  85. data/doc/cxxapi/ResourceLocator_8h_source.html +0 -166
  86. data/doc/cxxapi/SafeLibev_8h_source.html +0 -180
  87. data/doc/cxxapi/ScgiRequestParser_8h_source.html +0 -406
  88. data/doc/cxxapi/ServerInstanceDir_8h_source.html +0 -378
  89. data/doc/cxxapi/Session_8h_source.html +0 -501
  90. data/doc/cxxapi/SpawnManager_8h_source.html +0 -647
  91. data/doc/cxxapi/StaticContentHandler_8h_source.html +0 -69
  92. data/doc/cxxapi/StaticString_8h_source.html +0 -329
  93. data/doc/cxxapi/StringListCreator_8h_source.html +0 -114
  94. data/doc/cxxapi/Utils_8h_source.html +0 -469
  95. data/doc/cxxapi/annotated.html +0 -87
  96. data/doc/cxxapi/apache2_2Configuration_8h_source.html +0 -82
  97. data/doc/cxxapi/classAgentWatcher-members.html +0 -54
  98. data/doc/cxxapi/classAgentWatcher.html +0 -419
  99. data/doc/cxxapi/classClient-members.html +0 -38
  100. data/doc/cxxapi/classClient.html +0 -123
  101. data/doc/cxxapi/classHooks-members.html +0 -40
  102. data/doc/cxxapi/classHooks.html +0 -153
  103. data/doc/cxxapi/classPassenger_1_1AbstractSpawnManager-members.html +0 -40
  104. data/doc/cxxapi/classPassenger_1_1AbstractSpawnManager.html +0 -187
  105. data/doc/cxxapi/classPassenger_1_1AbstractSpawnManager__inherit__graph.map +0 -3
  106. data/doc/cxxapi/classPassenger_1_1AbstractSpawnManager__inherit__graph.md5 +0 -1
  107. data/doc/cxxapi/classPassenger_1_1AbstractSpawnManager__inherit__graph.png +0 -0
  108. data/doc/cxxapi/classPassenger_1_1ArgumentException-members.html +0 -36
  109. data/doc/cxxapi/classPassenger_1_1ArgumentException.html +0 -56
  110. data/doc/cxxapi/classPassenger_1_1ArrayMessage-members.html +0 -37
  111. data/doc/cxxapi/classPassenger_1_1ArrayMessage.html +0 -113
  112. data/doc/cxxapi/classPassenger_1_1BufferedUpload-members.html +0 -38
  113. data/doc/cxxapi/classPassenger_1_1BufferedUpload.html +0 -112
  114. data/doc/cxxapi/classPassenger_1_1BusyException-members.html +0 -36
  115. data/doc/cxxapi/classPassenger_1_1BusyException.html +0 -54
  116. data/doc/cxxapi/classPassenger_1_1ConfigurationException-members.html +0 -36
  117. data/doc/cxxapi/classPassenger_1_1ConfigurationException.html +0 -51
  118. data/doc/cxxapi/classPassenger_1_1DirectoryMapper-members.html +0 -41
  119. data/doc/cxxapi/classPassenger_1_1DirectoryMapper.html +0 -223
  120. data/doc/cxxapi/classPassenger_1_1EOFException-members.html +0 -36
  121. data/doc/cxxapi/classPassenger_1_1EOFException.html +0 -61
  122. data/doc/cxxapi/classPassenger_1_1EOFException__inherit__graph.map +0 -3
  123. data/doc/cxxapi/classPassenger_1_1EOFException__inherit__graph.md5 +0 -1
  124. data/doc/cxxapi/classPassenger_1_1EOFException__inherit__graph.png +0 -0
  125. data/doc/cxxapi/classPassenger_1_1EventFd-members.html +0 -36
  126. data/doc/cxxapi/classPassenger_1_1EventFd.html +0 -52
  127. data/doc/cxxapi/classPassenger_1_1EventedClient-members.html +0 -59
  128. data/doc/cxxapi/classPassenger_1_1EventedClient.html +0 -531
  129. data/doc/cxxapi/classPassenger_1_1EventedMessageServer-members.html +0 -37
  130. data/doc/cxxapi/classPassenger_1_1EventedMessageServer.html +0 -59
  131. data/doc/cxxapi/classPassenger_1_1EventedMessageServer__inherit__graph.map +0 -3
  132. data/doc/cxxapi/classPassenger_1_1EventedMessageServer__inherit__graph.md5 +0 -1
  133. data/doc/cxxapi/classPassenger_1_1EventedMessageServer__inherit__graph.png +0 -0
  134. data/doc/cxxapi/classPassenger_1_1EventedServer-members.html +0 -37
  135. data/doc/cxxapi/classPassenger_1_1EventedServer.html +0 -93
  136. data/doc/cxxapi/classPassenger_1_1EventedServer__inherit__graph.map +0 -3
  137. data/doc/cxxapi/classPassenger_1_1EventedServer__inherit__graph.md5 +0 -1
  138. data/doc/cxxapi/classPassenger_1_1EventedServer__inherit__graph.png +0 -0
  139. data/doc/cxxapi/classPassenger_1_1FileDescriptor-members.html +0 -41
  140. data/doc/cxxapi/classPassenger_1_1FileDescriptor.html +0 -178
  141. data/doc/cxxapi/classPassenger_1_1FileDescriptorPair-members.html +0 -36
  142. data/doc/cxxapi/classPassenger_1_1FileDescriptorPair.html +0 -52
  143. data/doc/cxxapi/classPassenger_1_1FileNotFoundException-members.html +0 -36
  144. data/doc/cxxapi/classPassenger_1_1FileNotFoundException.html +0 -58
  145. data/doc/cxxapi/classPassenger_1_1FileNotFoundException__inherit__graph.map +0 -3
  146. data/doc/cxxapi/classPassenger_1_1FileNotFoundException__inherit__graph.md5 +0 -1
  147. data/doc/cxxapi/classPassenger_1_1FileNotFoundException__inherit__graph.png +0 -0
  148. data/doc/cxxapi/classPassenger_1_1FileSystemException-members.html +0 -41
  149. data/doc/cxxapi/classPassenger_1_1FileSystemException.html +0 -66
  150. data/doc/cxxapi/classPassenger_1_1FileSystemException__inherit__graph.map +0 -3
  151. data/doc/cxxapi/classPassenger_1_1FileSystemException__inherit__graph.md5 +0 -1
  152. data/doc/cxxapi/classPassenger_1_1FileSystemException__inherit__graph.png +0 -0
  153. data/doc/cxxapi/classPassenger_1_1HttpStatusExtractor-members.html +0 -39
  154. data/doc/cxxapi/classPassenger_1_1HttpStatusExtractor.html +0 -128
  155. data/doc/cxxapi/classPassenger_1_1IOException-members.html +0 -36
  156. data/doc/cxxapi/classPassenger_1_1IOException.html +0 -61
  157. data/doc/cxxapi/classPassenger_1_1IOException__inherit__graph.map +0 -4
  158. data/doc/cxxapi/classPassenger_1_1IOException__inherit__graph.md5 +0 -1
  159. data/doc/cxxapi/classPassenger_1_1IOException__inherit__graph.png +0 -0
  160. data/doc/cxxapi/classPassenger_1_1MessageChannel-members.html +0 -57
  161. data/doc/cxxapi/classPassenger_1_1MessageChannel.html +0 -839
  162. data/doc/cxxapi/classPassenger_1_1MessageServer-members.html +0 -49
  163. data/doc/cxxapi/classPassenger_1_1MessageServer.html +0 -407
  164. data/doc/cxxapi/classPassenger_1_1MessageServer_1_1ClientContext-members.html +0 -36
  165. data/doc/cxxapi/classPassenger_1_1MessageServer_1_1ClientContext.html +0 -58
  166. data/doc/cxxapi/classPassenger_1_1MessageServer_1_1ClientContext__inherit__graph.map +0 -3
  167. data/doc/cxxapi/classPassenger_1_1MessageServer_1_1ClientContext__inherit__graph.md5 +0 -1
  168. data/doc/cxxapi/classPassenger_1_1MessageServer_1_1ClientContext__inherit__graph.png +0 -0
  169. data/doc/cxxapi/classPassenger_1_1MessageServer_1_1CommonClientContext-members.html +0 -41
  170. data/doc/cxxapi/classPassenger_1_1MessageServer_1_1CommonClientContext.html +0 -165
  171. data/doc/cxxapi/classPassenger_1_1MessageServer_1_1CommonClientContext__inherit__graph.map +0 -3
  172. data/doc/cxxapi/classPassenger_1_1MessageServer_1_1CommonClientContext__inherit__graph.md5 +0 -1
  173. data/doc/cxxapi/classPassenger_1_1MessageServer_1_1CommonClientContext__inherit__graph.png +0 -0
  174. data/doc/cxxapi/classPassenger_1_1MessageServer_1_1Handler-members.html +0 -39
  175. data/doc/cxxapi/classPassenger_1_1MessageServer_1_1Handler.html +0 -173
  176. data/doc/cxxapi/classPassenger_1_1Process-members.html +0 -44
  177. data/doc/cxxapi/classPassenger_1_1Process.html +0 -290
  178. data/doc/cxxapi/classPassenger_1_1RandomGenerator-members.html +0 -37
  179. data/doc/cxxapi/classPassenger_1_1RandomGenerator.html +0 -79
  180. data/doc/cxxapi/classPassenger_1_1ResourceLocator-members.html +0 -36
  181. data/doc/cxxapi/classPassenger_1_1ResourceLocator.html +0 -51
  182. data/doc/cxxapi/classPassenger_1_1RuntimeException-members.html +0 -36
  183. data/doc/cxxapi/classPassenger_1_1RuntimeException.html +0 -54
  184. data/doc/cxxapi/classPassenger_1_1SafeLibev-members.html +0 -36
  185. data/doc/cxxapi/classPassenger_1_1SafeLibev.html +0 -51
  186. data/doc/cxxapi/classPassenger_1_1ScalarMessage-members.html +0 -37
  187. data/doc/cxxapi/classPassenger_1_1ScalarMessage.html +0 -76
  188. data/doc/cxxapi/classPassenger_1_1ScgiRequestParser-members.html +0 -50
  189. data/doc/cxxapi/classPassenger_1_1ScgiRequestParser.html +0 -285
  190. data/doc/cxxapi/classPassenger_1_1SecurityException-members.html +0 -36
  191. data/doc/cxxapi/classPassenger_1_1SecurityException.html +0 -56
  192. data/doc/cxxapi/classPassenger_1_1Session-members.html +0 -53
  193. data/doc/cxxapi/classPassenger_1_1Session.html +0 -556
  194. data/doc/cxxapi/classPassenger_1_1Session__inherit__graph.map +0 -3
  195. data/doc/cxxapi/classPassenger_1_1Session__inherit__graph.md5 +0 -1
  196. data/doc/cxxapi/classPassenger_1_1Session__inherit__graph.png +0 -0
  197. data/doc/cxxapi/classPassenger_1_1SpawnException-members.html +0 -39
  198. data/doc/cxxapi/classPassenger_1_1SpawnException.html +0 -101
  199. data/doc/cxxapi/classPassenger_1_1SpawnManager-members.html +0 -42
  200. data/doc/cxxapi/classPassenger_1_1SpawnManager.html +0 -292
  201. data/doc/cxxapi/classPassenger_1_1SpawnManager__inherit__graph.map +0 -3
  202. data/doc/cxxapi/classPassenger_1_1SpawnManager__inherit__graph.md5 +0 -1
  203. data/doc/cxxapi/classPassenger_1_1SpawnManager__inherit__graph.png +0 -0
  204. data/doc/cxxapi/classPassenger_1_1StandardSession-members.html +0 -54
  205. data/doc/cxxapi/classPassenger_1_1StandardSession.html +0 -394
  206. data/doc/cxxapi/classPassenger_1_1StandardSession__inherit__graph.map +0 -3
  207. data/doc/cxxapi/classPassenger_1_1StandardSession__inherit__graph.md5 +0 -1
  208. data/doc/cxxapi/classPassenger_1_1StandardSession__inherit__graph.png +0 -0
  209. data/doc/cxxapi/classPassenger_1_1StaticString-members.html +0 -36
  210. data/doc/cxxapi/classPassenger_1_1StaticString.html +0 -56
  211. data/doc/cxxapi/classPassenger_1_1SyntaxError-members.html +0 -36
  212. data/doc/cxxapi/classPassenger_1_1SyntaxError.html +0 -54
  213. data/doc/cxxapi/classPassenger_1_1SystemException-members.html +0 -40
  214. data/doc/cxxapi/classPassenger_1_1SystemException.html +0 -155
  215. data/doc/cxxapi/classPassenger_1_1SystemException__inherit__graph.map +0 -4
  216. data/doc/cxxapi/classPassenger_1_1SystemException__inherit__graph.md5 +0 -1
  217. data/doc/cxxapi/classPassenger_1_1SystemException__inherit__graph.png +0 -0
  218. data/doc/cxxapi/classPassenger_1_1TimeRetrievalException-members.html +0 -40
  219. data/doc/cxxapi/classPassenger_1_1TimeRetrievalException.html +0 -61
  220. data/doc/cxxapi/classPassenger_1_1TimeRetrievalException__inherit__graph.map +0 -3
  221. data/doc/cxxapi/classPassenger_1_1TimeRetrievalException__inherit__graph.md5 +0 -1
  222. data/doc/cxxapi/classPassenger_1_1TimeRetrievalException__inherit__graph.png +0 -0
  223. data/doc/cxxapi/classPassenger_1_1TimeoutException-members.html +0 -36
  224. data/doc/cxxapi/classPassenger_1_1TimeoutException.html +0 -54
  225. data/doc/cxxapi/classPassenger_1_1Uint16Message-members.html +0 -36
  226. data/doc/cxxapi/classPassenger_1_1Uint16Message.html +0 -51
  227. data/doc/cxxapi/classPassenger_1_1Uint32Message-members.html +0 -36
  228. data/doc/cxxapi/classPassenger_1_1Uint32Message.html +0 -51
  229. data/doc/cxxapi/classServer-members.html +0 -36
  230. data/doc/cxxapi/classServer.html +0 -49
  231. data/doc/cxxapi/classServerInstanceDirToucher-members.html +0 -36
  232. data/doc/cxxapi/classServerInstanceDirToucher.html +0 -47
  233. data/doc/cxxapi/classes.html +0 -52
  234. data/doc/cxxapi/definitions_8h_source.html +0 -36
  235. data/doc/cxxapi/doxygen.css +0 -532
  236. data/doc/cxxapi/doxygen.png +0 -0
  237. data/doc/cxxapi/files.html +0 -76
  238. data/doc/cxxapi/ftv2blank.png +0 -0
  239. data/doc/cxxapi/ftv2doc.png +0 -0
  240. data/doc/cxxapi/ftv2folderclosed.png +0 -0
  241. data/doc/cxxapi/ftv2folderopen.png +0 -0
  242. data/doc/cxxapi/ftv2lastnode.png +0 -0
  243. data/doc/cxxapi/ftv2link.png +0 -0
  244. data/doc/cxxapi/ftv2mlastnode.png +0 -0
  245. data/doc/cxxapi/ftv2mnode.png +0 -0
  246. data/doc/cxxapi/ftv2node.png +0 -0
  247. data/doc/cxxapi/ftv2plastnode.png +0 -0
  248. data/doc/cxxapi/ftv2pnode.png +0 -0
  249. data/doc/cxxapi/ftv2vertline.png +0 -0
  250. data/doc/cxxapi/functions.html +0 -103
  251. data/doc/cxxapi/functions_0x62.html +0 -82
  252. data/doc/cxxapi/functions_0x63.html +0 -102
  253. data/doc/cxxapi/functions_0x64.html +0 -102
  254. data/doc/cxxapi/functions_0x65.html +0 -88
  255. data/doc/cxxapi/functions_0x66.html +0 -100
  256. data/doc/cxxapi/functions_0x67.html +0 -167
  257. data/doc/cxxapi/functions_0x68.html +0 -88
  258. data/doc/cxxapi/functions_0x69.html +0 -96
  259. data/doc/cxxapi/functions_0x6b.html +0 -80
  260. data/doc/cxxapi/functions_0x6c.html +0 -88
  261. data/doc/cxxapi/functions_0x6d.html +0 -88
  262. data/doc/cxxapi/functions_0x6e.html +0 -86
  263. data/doc/cxxapi/functions_0x6f.html +0 -94
  264. data/doc/cxxapi/functions_0x70.html +0 -94
  265. data/doc/cxxapi/functions_0x72.html +0 -110
  266. data/doc/cxxapi/functions_0x73.html +0 -171
  267. data/doc/cxxapi/functions_0x74.html +0 -85
  268. data/doc/cxxapi/functions_0x75.html +0 -85
  269. data/doc/cxxapi/functions_0x77.html +0 -92
  270. data/doc/cxxapi/functions_0x7e.html +0 -79
  271. data/doc/cxxapi/functions_enum.html +0 -49
  272. data/doc/cxxapi/functions_eval.html +0 -67
  273. data/doc/cxxapi/functions_func.html +0 -531
  274. data/doc/cxxapi/functions_vars.html +0 -278
  275. data/doc/cxxapi/graph_legend.dot +0 -22
  276. data/doc/cxxapi/graph_legend.html +0 -92
  277. data/doc/cxxapi/graph_legend.png +0 -0
  278. data/doc/cxxapi/group__Core.html +0 -46
  279. data/doc/cxxapi/group__Core.map +0 -3
  280. data/doc/cxxapi/group__Core.png +0 -0
  281. data/doc/cxxapi/group__Exceptions.html +0 -53
  282. data/doc/cxxapi/group__Hooks.html +0 -42
  283. data/doc/cxxapi/group__Hooks.map +0 -3
  284. data/doc/cxxapi/group__Hooks.png +0 -0
  285. data/doc/cxxapi/group__Support.html +0 -538
  286. data/doc/cxxapi/hierarchy.html +0 -101
  287. data/doc/cxxapi/index.html +0 -16
  288. data/doc/cxxapi/inherit__graph__0.map +0 -3
  289. data/doc/cxxapi/inherit__graph__0.md5 +0 -1
  290. data/doc/cxxapi/inherit__graph__0.png +0 -0
  291. data/doc/cxxapi/inherit__graph__1.map +0 -3
  292. data/doc/cxxapi/inherit__graph__1.md5 +0 -1
  293. data/doc/cxxapi/inherit__graph__1.png +0 -0
  294. data/doc/cxxapi/inherit__graph__10.map +0 -3
  295. data/doc/cxxapi/inherit__graph__10.md5 +0 -1
  296. data/doc/cxxapi/inherit__graph__10.png +0 -0
  297. data/doc/cxxapi/inherit__graph__11.map +0 -4
  298. data/doc/cxxapi/inherit__graph__11.md5 +0 -1
  299. data/doc/cxxapi/inherit__graph__11.png +0 -0
  300. data/doc/cxxapi/inherit__graph__12.map +0 -3
  301. data/doc/cxxapi/inherit__graph__12.md5 +0 -1
  302. data/doc/cxxapi/inherit__graph__12.png +0 -0
  303. data/doc/cxxapi/inherit__graph__13.map +0 -3
  304. data/doc/cxxapi/inherit__graph__13.md5 +0 -1
  305. data/doc/cxxapi/inherit__graph__13.png +0 -0
  306. data/doc/cxxapi/inherit__graph__14.map +0 -3
  307. data/doc/cxxapi/inherit__graph__14.md5 +0 -1
  308. data/doc/cxxapi/inherit__graph__14.png +0 -0
  309. data/doc/cxxapi/inherit__graph__15.map +0 -3
  310. data/doc/cxxapi/inherit__graph__15.md5 +0 -1
  311. data/doc/cxxapi/inherit__graph__15.png +0 -0
  312. data/doc/cxxapi/inherit__graph__16.map +0 -5
  313. data/doc/cxxapi/inherit__graph__16.md5 +0 -1
  314. data/doc/cxxapi/inherit__graph__16.png +0 -0
  315. data/doc/cxxapi/inherit__graph__17.map +0 -3
  316. data/doc/cxxapi/inherit__graph__17.md5 +0 -1
  317. data/doc/cxxapi/inherit__graph__17.png +0 -0
  318. data/doc/cxxapi/inherit__graph__18.map +0 -3
  319. data/doc/cxxapi/inherit__graph__18.md5 +0 -1
  320. data/doc/cxxapi/inherit__graph__18.png +0 -0
  321. data/doc/cxxapi/inherit__graph__19.map +0 -4
  322. data/doc/cxxapi/inherit__graph__19.md5 +0 -1
  323. data/doc/cxxapi/inherit__graph__19.png +0 -0
  324. data/doc/cxxapi/inherit__graph__2.map +0 -3
  325. data/doc/cxxapi/inherit__graph__2.md5 +0 -1
  326. data/doc/cxxapi/inherit__graph__2.png +0 -0
  327. data/doc/cxxapi/inherit__graph__20.map +0 -3
  328. data/doc/cxxapi/inherit__graph__20.md5 +0 -1
  329. data/doc/cxxapi/inherit__graph__20.png +0 -0
  330. data/doc/cxxapi/inherit__graph__21.map +0 -3
  331. data/doc/cxxapi/inherit__graph__21.md5 +0 -1
  332. data/doc/cxxapi/inherit__graph__21.png +0 -0
  333. data/doc/cxxapi/inherit__graph__22.map +0 -3
  334. data/doc/cxxapi/inherit__graph__22.md5 +0 -1
  335. data/doc/cxxapi/inherit__graph__22.png +0 -0
  336. data/doc/cxxapi/inherit__graph__23.map +0 -3
  337. data/doc/cxxapi/inherit__graph__23.md5 +0 -1
  338. data/doc/cxxapi/inherit__graph__23.png +0 -0
  339. data/doc/cxxapi/inherit__graph__24.map +0 -3
  340. data/doc/cxxapi/inherit__graph__24.md5 +0 -1
  341. data/doc/cxxapi/inherit__graph__24.png +0 -0
  342. data/doc/cxxapi/inherit__graph__25.map +0 -3
  343. data/doc/cxxapi/inherit__graph__25.md5 +0 -1
  344. data/doc/cxxapi/inherit__graph__25.png +0 -0
  345. data/doc/cxxapi/inherit__graph__26.map +0 -3
  346. data/doc/cxxapi/inherit__graph__26.md5 +0 -1
  347. data/doc/cxxapi/inherit__graph__26.png +0 -0
  348. data/doc/cxxapi/inherit__graph__27.map +0 -3
  349. data/doc/cxxapi/inherit__graph__27.md5 +0 -1
  350. data/doc/cxxapi/inherit__graph__27.png +0 -0
  351. data/doc/cxxapi/inherit__graph__28.map +0 -3
  352. data/doc/cxxapi/inherit__graph__28.md5 +0 -1
  353. data/doc/cxxapi/inherit__graph__28.png +0 -0
  354. data/doc/cxxapi/inherit__graph__29.map +0 -3
  355. data/doc/cxxapi/inherit__graph__29.md5 +0 -1
  356. data/doc/cxxapi/inherit__graph__29.png +0 -0
  357. data/doc/cxxapi/inherit__graph__3.map +0 -4
  358. data/doc/cxxapi/inherit__graph__3.md5 +0 -1
  359. data/doc/cxxapi/inherit__graph__3.png +0 -0
  360. data/doc/cxxapi/inherit__graph__30.map +0 -3
  361. data/doc/cxxapi/inherit__graph__30.md5 +0 -1
  362. data/doc/cxxapi/inherit__graph__30.png +0 -0
  363. data/doc/cxxapi/inherit__graph__31.map +0 -4
  364. data/doc/cxxapi/inherit__graph__31.md5 +0 -1
  365. data/doc/cxxapi/inherit__graph__31.png +0 -0
  366. data/doc/cxxapi/inherit__graph__32.map +0 -3
  367. data/doc/cxxapi/inherit__graph__32.md5 +0 -1
  368. data/doc/cxxapi/inherit__graph__32.png +0 -0
  369. data/doc/cxxapi/inherit__graph__33.map +0 -3
  370. data/doc/cxxapi/inherit__graph__33.md5 +0 -1
  371. data/doc/cxxapi/inherit__graph__33.png +0 -0
  372. data/doc/cxxapi/inherit__graph__34.map +0 -3
  373. data/doc/cxxapi/inherit__graph__34.md5 +0 -1
  374. data/doc/cxxapi/inherit__graph__34.png +0 -0
  375. data/doc/cxxapi/inherit__graph__35.map +0 -3
  376. data/doc/cxxapi/inherit__graph__35.md5 +0 -1
  377. data/doc/cxxapi/inherit__graph__35.png +0 -0
  378. data/doc/cxxapi/inherit__graph__36.map +0 -5
  379. data/doc/cxxapi/inherit__graph__36.md5 +0 -1
  380. data/doc/cxxapi/inherit__graph__36.png +0 -0
  381. data/doc/cxxapi/inherit__graph__37.map +0 -3
  382. data/doc/cxxapi/inherit__graph__37.md5 +0 -1
  383. data/doc/cxxapi/inherit__graph__37.png +0 -0
  384. data/doc/cxxapi/inherit__graph__38.map +0 -3
  385. data/doc/cxxapi/inherit__graph__38.md5 +0 -1
  386. data/doc/cxxapi/inherit__graph__38.png +0 -0
  387. data/doc/cxxapi/inherit__graph__39.map +0 -3
  388. data/doc/cxxapi/inherit__graph__39.md5 +0 -1
  389. data/doc/cxxapi/inherit__graph__39.png +0 -0
  390. data/doc/cxxapi/inherit__graph__4.map +0 -3
  391. data/doc/cxxapi/inherit__graph__4.md5 +0 -1
  392. data/doc/cxxapi/inherit__graph__4.png +0 -0
  393. data/doc/cxxapi/inherit__graph__40.map +0 -3
  394. data/doc/cxxapi/inherit__graph__40.md5 +0 -1
  395. data/doc/cxxapi/inherit__graph__40.png +0 -0
  396. data/doc/cxxapi/inherit__graph__41.map +0 -3
  397. data/doc/cxxapi/inherit__graph__41.md5 +0 -1
  398. data/doc/cxxapi/inherit__graph__41.png +0 -0
  399. data/doc/cxxapi/inherit__graph__5.map +0 -3
  400. data/doc/cxxapi/inherit__graph__5.md5 +0 -1
  401. data/doc/cxxapi/inherit__graph__5.png +0 -0
  402. data/doc/cxxapi/inherit__graph__6.map +0 -3
  403. data/doc/cxxapi/inherit__graph__6.md5 +0 -1
  404. data/doc/cxxapi/inherit__graph__6.png +0 -0
  405. data/doc/cxxapi/inherit__graph__7.map +0 -3
  406. data/doc/cxxapi/inherit__graph__7.md5 +0 -1
  407. data/doc/cxxapi/inherit__graph__7.png +0 -0
  408. data/doc/cxxapi/inherit__graph__8.map +0 -3
  409. data/doc/cxxapi/inherit__graph__8.md5 +0 -1
  410. data/doc/cxxapi/inherit__graph__8.png +0 -0
  411. data/doc/cxxapi/inherit__graph__9.map +0 -3
  412. data/doc/cxxapi/inherit__graph__9.md5 +0 -1
  413. data/doc/cxxapi/inherit__graph__9.png +0 -0
  414. data/doc/cxxapi/inherits.html +0 -165
  415. data/doc/cxxapi/main.html +0 -28
  416. data/doc/cxxapi/modules.html +0 -36
  417. data/doc/cxxapi/namespacePassenger.html +0 -585
  418. data/doc/cxxapi/namespacemembers.html +0 -190
  419. data/doc/cxxapi/namespacemembers_enum.html +0 -48
  420. data/doc/cxxapi/namespacemembers_eval.html +0 -57
  421. data/doc/cxxapi/namespacemembers_func.html +0 -114
  422. data/doc/cxxapi/namespacemembers_type.html +0 -54
  423. data/doc/cxxapi/namespaces.html +0 -37
  424. data/doc/cxxapi/nginx_2Configuration_8h_source.html +0 -126
  425. data/doc/cxxapi/ngx__http__passenger__module_8h_source.html +0 -95
  426. data/doc/cxxapi/structPassenger_1_1MessageServer_1_1DisconnectEventBroadcastGuard-members.html +0 -36
  427. data/doc/cxxapi/structPassenger_1_1MessageServer_1_1DisconnectEventBroadcastGuard.html +0 -51
  428. data/doc/cxxapi/structPassenger_1_1PoolOptions-members.html +0 -67
  429. data/doc/cxxapi/structPassenger_1_1PoolOptions.html +0 -647
  430. data/doc/cxxapi/structPassenger_1_1StaticString_1_1Hash-members.html +0 -36
  431. data/doc/cxxapi/structPassenger_1_1StaticString_1_1Hash.html +0 -51
  432. data/doc/cxxapi/tab_b.gif +0 -0
  433. data/doc/cxxapi/tab_l.gif +0 -0
  434. data/doc/cxxapi/tab_r.gif +0 -0
  435. data/doc/cxxapi/tabs.css +0 -105
  436. data/doc/cxxapi/tree.html +0 -249
  437. data/doc/template/horo.rb +0 -613
  438. data/ext/libev/config.h +0 -122
  439. data/ext/nginx/HttpStatusExtractor.h +0 -351
data/doc/cxxapi/Utils_8h_source.html DELETED
@@ -1,469 +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: Utils.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>Utils.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_UTILS_H_</span>
51
- <a name="l00026"></a>00026 <span class="preprocessor"></span><span class="preprocessor">#define _PASSENGER_UTILS_H_</span>
52
- <a name="l00027"></a>00027 <span class="preprocessor"></span>
53
- <a name="l00028"></a>00028 <span class="preprocessor">#include &lt;boost/shared_ptr.hpp&gt;</span>
54
- <a name="l00029"></a>00029 <span class="preprocessor">#include &lt;boost/function.hpp&gt;</span>
55
- <a name="l00030"></a>00030 <span class="preprocessor">#include &lt;sys/types.h&gt;</span>
56
- <a name="l00031"></a>00031 <span class="preprocessor">#include &lt;sys/stat.h&gt;</span>
57
- <a name="l00032"></a>00032 <span class="preprocessor">#include &lt;string&gt;</span>
58
- <a name="l00033"></a>00033 <span class="preprocessor">#include &lt;vector&gt;</span>
59
- <a name="l00034"></a>00034 <span class="preprocessor">#include &lt;utility&gt;</span>
60
- <a name="l00035"></a>00035 <span class="preprocessor">#include &lt;sstream&gt;</span>
61
- <a name="l00036"></a>00036 <span class="preprocessor">#include &lt;cstdio&gt;</span>
62
- <a name="l00037"></a>00037 <span class="preprocessor">#include &lt;climits&gt;</span>
63
- <a name="l00038"></a>00038 <span class="preprocessor">#include &lt;cstdlib&gt;</span>
64
- <a name="l00039"></a>00039 <span class="preprocessor">#include &lt;cstring&gt;</span>
65
- <a name="l00040"></a>00040 <span class="preprocessor">#include &lt;errno.h&gt;</span>
66
- <a name="l00041"></a>00041 <span class="preprocessor">#include &lt;unistd.h&gt;</span>
67
- <a name="l00042"></a>00042 <span class="preprocessor">#include &quot;StaticString.h&quot;</span>
68
- <a name="l00043"></a>00043 <span class="preprocessor">#include &quot;Exceptions.h&quot;</span>
69
- <a name="l00044"></a>00044
70
- <a name="l00045"></a>00045 <span class="keyword">namespace </span>Passenger {
71
- <a name="l00046"></a>00046
72
- <a name="l00047"></a>00047 <span class="keyword">using namespace </span>std;
73
- <a name="l00048"></a>00048 <span class="keyword">using namespace </span>boost;
74
- <a name="l00049"></a>00049
75
- <a name="l00050"></a>00050 <span class="keyword">static</span> <span class="keyword">const</span> uid_t USER_NOT_GIVEN = (uid_t) -1;
76
- <a name="l00051"></a>00051 <span class="keyword">static</span> <span class="keyword">const</span> gid_t GROUP_NOT_GIVEN = (gid_t) -1;
77
- <a name="l00052"></a>00052
78
- <a name="l00053"></a>00053 <span class="keyword">typedef</span> <span class="keyword">struct </span>CachedFileStat CachedFileStat;
79
- <a name="l00054"></a>00054 <span class="keyword">class </span>ResourceLocator;
80
- <a name="l00055"></a>00055 <span class="comment"></span>
81
- <a name="l00056"></a>00056 <span class="comment">/** Enumeration which indicates what kind of file a file is. */</span>
82
- <a name="l00057"></a><a class="code" href="namespacePassenger.html#a14174b712df6046cb823cde43d7ef07d">00057</a> <span class="keyword">typedef</span> <span class="keyword">enum</span> {<span class="comment"></span>
83
- <a name="l00058"></a>00058 <span class="comment"> /** The file doesn&#39;t exist. */</span>
84
- <a name="l00059"></a><a class="code" href="namespacePassenger.html#a14174b712df6046cb823cde43d7ef07da9fc66834fe96c52799397496b8df8486">00059</a> <a class="code" href="namespacePassenger.html#a14174b712df6046cb823cde43d7ef07da9fc66834fe96c52799397496b8df8486" title="The file doesn&amp;#39;t exist.">FT_NONEXISTANT</a>,<span class="comment"></span>
85
- <a name="l00060"></a>00060 <span class="comment"> /** A regular file or a symlink to a regular file. */</span>
86
- <a name="l00061"></a><a class="code" href="namespacePassenger.html#a14174b712df6046cb823cde43d7ef07da1538596a928321d1a282c6bb06e80563">00061</a> <a class="code" href="namespacePassenger.html#a14174b712df6046cb823cde43d7ef07da1538596a928321d1a282c6bb06e80563" title="A regular file or a symlink to a regular file.">FT_REGULAR</a>,<span class="comment"></span>
87
- <a name="l00062"></a>00062 <span class="comment"> /** A directory. */</span>
88
- <a name="l00063"></a><a class="code" href="namespacePassenger.html#a14174b712df6046cb823cde43d7ef07dabb09dbba1071b4770913363db2462eee">00063</a> <a class="code" href="namespacePassenger.html#a14174b712df6046cb823cde43d7ef07dabb09dbba1071b4770913363db2462eee" title="A directory.">FT_DIRECTORY</a>,<span class="comment"></span>
89
- <a name="l00064"></a>00064 <span class="comment"> /** Something else, e.g. a pipe or a socket. */</span>
90
- <a name="l00065"></a><a class="code" href="namespacePassenger.html#a14174b712df6046cb823cde43d7ef07da3e89b9a7be074975e007d9f7cd77f4ff">00065</a> <a class="code" href="namespacePassenger.html#a14174b712df6046cb823cde43d7ef07da3e89b9a7be074975e007d9f7cd77f4ff" title="Something else, e.g.">FT_OTHER</a>
91
- <a name="l00066"></a>00066 } FileType;
92
- <a name="l00067"></a>00067 <span class="comment"></span>
93
- <a name="l00068"></a>00068 <span class="comment">/**</span>
94
- <a name="l00069"></a>00069 <span class="comment"> * Convenience shortcut for creating a &lt;tt&gt;shared_ptr&lt;/tt&gt;.</span>
95
- <a name="l00070"></a>00070 <span class="comment"> * Instead of:</span>
96
- <a name="l00071"></a>00071 <span class="comment"> * @code</span>
97
- <a name="l00072"></a>00072 <span class="comment"> * shared_ptr&lt;Foo&gt; foo;</span>
98
- <a name="l00073"></a>00073 <span class="comment"> * ...</span>
99
- <a name="l00074"></a>00074 <span class="comment"> * foo = shared_ptr&lt;Foo&gt;(new Foo());</span>
100
- <a name="l00075"></a>00075 <span class="comment"> * @endcode</span>
101
- <a name="l00076"></a>00076 <span class="comment"> * one can write:</span>
102
- <a name="l00077"></a>00077 <span class="comment"> * @code</span>
103
- <a name="l00078"></a>00078 <span class="comment"> * shared_ptr&lt;Foo&gt; foo;</span>
104
- <a name="l00079"></a>00079 <span class="comment"> * ...</span>
105
- <a name="l00080"></a>00080 <span class="comment"> * foo = ptr(new Foo());</span>
106
- <a name="l00081"></a>00081 <span class="comment"> * @endcode</span>
107
- <a name="l00082"></a>00082 <span class="comment"> *</span>
108
- <a name="l00083"></a>00083 <span class="comment"> * @param pointer The item to put in the shared_ptr object.</span>
109
- <a name="l00084"></a>00084 <span class="comment"> * @ingroup Support</span>
110
- <a name="l00085"></a>00085 <span class="comment"> */</span>
111
- <a name="l00086"></a>00086 <span class="keyword">template</span>&lt;<span class="keyword">typename</span> T&gt; shared_ptr&lt;T&gt;
112
- <a name="l00087"></a><a class="code" href="group__Support.html#ga41b6c4a82fed72531a147de0505a8396">00087</a> <a class="code" href="group__Support.html#ga41b6c4a82fed72531a147de0505a8396" title="Convenience shortcut for creating a shared_ptr.">ptr</a>(T *pointer) {
113
- <a name="l00088"></a>00088 <span class="keywordflow">return</span> shared_ptr&lt;T&gt;(pointer);
114
- <a name="l00089"></a>00089 }
115
- <a name="l00090"></a>00090 <span class="comment"></span>
116
- <a name="l00091"></a>00091 <span class="comment">/**</span>
117
- <a name="l00092"></a>00092 <span class="comment"> * Check whether the specified file exists.</span>
118
- <a name="l00093"></a>00093 <span class="comment"> *</span>
119
- <a name="l00094"></a>00094 <span class="comment"> * @param filename The filename to check.</span>
120
- <a name="l00095"></a>00095 <span class="comment"> * @param cstat A CachedFileStat object, if you want to use cached statting.</span>
121
- <a name="l00096"></a>00096 <span class="comment"> * @param throttleRate A throttle rate for cstat. Only applicable if cstat is not NULL.</span>
122
- <a name="l00097"></a>00097 <span class="comment"> * @return Whether the file exists.</span>
123
- <a name="l00098"></a>00098 <span class="comment"> * @throws FileSystemException Unable to check because of a filesystem error.</span>
124
- <a name="l00099"></a>00099 <span class="comment"> * @throws TimeRetrievalException</span>
125
- <a name="l00100"></a>00100 <span class="comment"> * @throws boost::thread_interrupted</span>
126
- <a name="l00101"></a>00101 <span class="comment"> * @ingroup Support</span>
127
- <a name="l00102"></a>00102 <span class="comment"> */</span>
128
- <a name="l00103"></a>00103 <span class="keywordtype">bool</span> <a class="code" href="group__Support.html#ga2a62e38a72c6c65992e3361f6d80c7ef" title="Check whether the specified file exists.">fileExists</a>(<span class="keyword">const</span> StaticString &amp;filename, CachedFileStat *cstat = 0,
129
- <a name="l00104"></a>00104 <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> throttleRate = 0);
130
- <a name="l00105"></a>00105 <span class="comment"></span>
131
- <a name="l00106"></a>00106 <span class="comment">/**</span>
132
- <a name="l00107"></a>00107 <span class="comment"> * Check whether &#39;filename&#39; exists and what kind of file it is.</span>
133
- <a name="l00108"></a>00108 <span class="comment"> *</span>
134
- <a name="l00109"></a>00109 <span class="comment"> * @param filename The filename to check.</span>
135
- <a name="l00110"></a>00110 <span class="comment"> * @param mstat A CachedFileStat object, if you want to use cached statting.</span>
136
- <a name="l00111"></a>00111 <span class="comment"> * @param throttleRate A throttle rate for cstat. Only applicable if cstat is not NULL.</span>
137
- <a name="l00112"></a>00112 <span class="comment"> * @return The file type.</span>
138
- <a name="l00113"></a>00113 <span class="comment"> * @throws FileSystemException Unable to check because of a filesystem error.</span>
139
- <a name="l00114"></a>00114 <span class="comment"> * @throws TimeRetrievalException</span>
140
- <a name="l00115"></a>00115 <span class="comment"> * @throws boost::thread_interrupted</span>
141
- <a name="l00116"></a>00116 <span class="comment"> * @ingroup Support</span>
142
- <a name="l00117"></a>00117 <span class="comment"> */</span>
143
- <a name="l00118"></a>00118 FileType <a class="code" href="group__Support.html#ga15298b031377d3ecb80295bd5b1a8180" title="Check whether &amp;#39;filename&amp;#39; exists and what kind of file it is.">getFileType</a>(<span class="keyword">const</span> StaticString &amp;filename, CachedFileStat *cstat = 0,
144
- <a name="l00119"></a>00119 <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> throttleRate = 0);
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"> * Create the given file with the given contents, permissions and ownership.</span>
148
- <a name="l00123"></a>00123 <span class="comment"> * This function does not leave behind junk files: if the ownership cannot be set</span>
149
- <a name="l00124"></a>00124 <span class="comment"> * or if not all data can be written then then the file will be deleted.</span>
150
- <a name="l00125"></a>00125 <span class="comment"> *</span>
151
- <a name="l00126"></a>00126 <span class="comment"> * @param filename The file to create.</span>
152
- <a name="l00127"></a>00127 <span class="comment"> * @param contents The contents to write to the file.</span>
153
- <a name="l00128"></a>00128 <span class="comment"> * @param permissions The desired file permissions.</span>
154
- <a name="l00129"></a>00129 <span class="comment"> * @param owner The desired file owner. Specify USER_NOT_GIVEN if you want to use the current</span>
155
- <a name="l00130"></a>00130 <span class="comment"> * process&#39;s owner as the file owner.</span>
156
- <a name="l00131"></a>00131 <span class="comment"> * @param group The desired file group. Specify GROUP_NOT_GIVEN if you want to use the current</span>
157
- <a name="l00132"></a>00132 <span class="comment"> * process&#39;s group as the file group.</span>
158
- <a name="l00133"></a>00133 <span class="comment"> * @param overwrite Whether to overwrite the file if it exists. If set to false</span>
159
- <a name="l00134"></a>00134 <span class="comment"> * and the file exists then nothing will happen.</span>
160
- <a name="l00135"></a>00135 <span class="comment"> * @throws FileSystemException Something went wrong.</span>
161
- <a name="l00136"></a>00136 <span class="comment"> * @ingroup Support</span>
162
- <a name="l00137"></a>00137 <span class="comment"> */</span>
163
- <a name="l00138"></a>00138 <span class="keywordtype">void</span> <a class="code" href="group__Support.html#ga6f414070373465da2e12947463f69953" title="Create the given file with the given contents, permissions and ownership.">createFile</a>(<span class="keyword">const</span> <span class="keywordtype">string</span> &amp;filename, <span class="keyword">const</span> StaticString &amp;contents,
164
- <a name="l00139"></a>00139 mode_t permissions = S_IRUSR | S_IWUSR | S_IRGRP | S_IROTH,
165
- <a name="l00140"></a>00140 uid_t owner = USER_NOT_GIVEN, gid_t group = GROUP_NOT_GIVEN,
166
- <a name="l00141"></a>00141 <span class="keywordtype">bool</span> overwrite = <span class="keyword">true</span>);
167
- <a name="l00142"></a>00142 <span class="comment"></span>
168
- <a name="l00143"></a>00143 <span class="comment">/**</span>
169
- <a name="l00144"></a>00144 <span class="comment"> * Returns a canonical version of the specified path. All symbolic links</span>
170
- <a name="l00145"></a>00145 <span class="comment"> * and relative path elements are resolved.</span>
171
- <a name="l00146"></a>00146 <span class="comment"> *</span>
172
- <a name="l00147"></a>00147 <span class="comment"> * @throws FileSystemException Something went wrong.</span>
173
- <a name="l00148"></a>00148 <span class="comment"> * @ingroup Support</span>
174
- <a name="l00149"></a>00149 <span class="comment"> */</span>
175
- <a name="l00150"></a>00150 <span class="keywordtype">string</span> <a class="code" href="group__Support.html#gaf3b0a483f0a252ae08d9de9f8b267d36" title="Returns a canonical version of the specified path.">canonicalizePath</a>(<span class="keyword">const</span> <span class="keywordtype">string</span> &amp;path);
176
- <a name="l00151"></a>00151 <span class="comment"></span>
177
- <a name="l00152"></a>00152 <span class="comment">/**</span>
178
- <a name="l00153"></a>00153 <span class="comment"> * If &lt;em&gt;path&lt;/em&gt; refers to a symlink, then this function resolves the</span>
179
- <a name="l00154"></a>00154 <span class="comment"> * symlink for 1 level. That is, if the symlink points to another symlink,</span>
180
- <a name="l00155"></a>00155 <span class="comment"> * then the other symlink will not be resolved. The resolved path is returned.</span>
181
- <a name="l00156"></a>00156 <span class="comment"> *</span>
182
- <a name="l00157"></a>00157 <span class="comment"> * If the symlink doesn&#39;t point to an absolute path, then this function will</span>
183
- <a name="l00158"></a>00158 <span class="comment"> * prepend &lt;em&gt;path&lt;/em&gt;&#39;s directory to the result.</span>
184
- <a name="l00159"></a>00159 <span class="comment"> *</span>
185
- <a name="l00160"></a>00160 <span class="comment"> * If &lt;em&gt;path&lt;/em&gt; doesn&#39;t refer to a symlink then this method will return</span>
186
- <a name="l00161"></a>00161 <span class="comment"> * &lt;em&gt;path&lt;/em&gt;.</span>
187
- <a name="l00162"></a>00162 <span class="comment"> *</span>
188
- <a name="l00163"></a>00163 <span class="comment"> * @throws FileSystemException Something went wrong.</span>
189
- <a name="l00164"></a>00164 <span class="comment"> * @ingroup Support</span>
190
- <a name="l00165"></a>00165 <span class="comment"> */</span>
191
- <a name="l00166"></a>00166 <span class="keywordtype">string</span> <a class="code" href="group__Support.html#gac3d2b3d608188527d888e63d22c5163c" title="If path refers to a symlink, then this function resolves the symlink for 1 level...">resolveSymlink</a>(<span class="keyword">const</span> <span class="keywordtype">string</span> &amp;path);
192
- <a name="l00167"></a>00167 <span class="comment"></span>
193
- <a name="l00168"></a>00168 <span class="comment">/**</span>
194
- <a name="l00169"></a>00169 <span class="comment"> * Given a path, extracts its directory name.</span>
195
- <a name="l00170"></a>00170 <span class="comment"> *</span>
196
- <a name="l00171"></a>00171 <span class="comment"> * @ingroup Support</span>
197
- <a name="l00172"></a>00172 <span class="comment"> */</span>
198
- <a name="l00173"></a>00173 <span class="keywordtype">string</span> <a class="code" href="group__Support.html#gae651ece5281f22dc5fc974079f7c9187" title="Given a path, extracts its directory name.">extractDirName</a>(<span class="keyword">const</span> StaticString &amp;path);
199
- <a name="l00174"></a>00174 <span class="comment"></span>
200
- <a name="l00175"></a>00175 <span class="comment">/**</span>
201
- <a name="l00176"></a>00176 <span class="comment"> * Given a path, extracts its base name.</span>
202
- <a name="l00177"></a>00177 <span class="comment"> *</span>
203
- <a name="l00178"></a>00178 <span class="comment"> * @ingroup Support</span>
204
- <a name="l00179"></a>00179 <span class="comment"> */</span>
205
- <a name="l00180"></a>00180 <span class="keywordtype">string</span> <a class="code" href="group__Support.html#gaeb750234207485fa57609174ca8d4359" title="Given a path, extracts its base name.">extractBaseName</a>(<span class="keyword">const</span> StaticString &amp;path);
206
- <a name="l00181"></a>00181 <span class="comment"></span>
207
- <a name="l00182"></a>00182 <span class="comment">/**</span>
208
- <a name="l00183"></a>00183 <span class="comment"> * Escape the given raw string into an XML value.</span>
209
- <a name="l00184"></a>00184 <span class="comment"> *</span>
210
- <a name="l00185"></a>00185 <span class="comment"> * @throws std::bad_alloc Something went wrong.</span>
211
- <a name="l00186"></a>00186 <span class="comment"> * @ingroup Support</span>
212
- <a name="l00187"></a>00187 <span class="comment"> */</span>
213
- <a name="l00188"></a>00188 <span class="keywordtype">string</span> <a class="code" href="group__Support.html#gae74addedf73782a1eb1f6dd48d6fce06" title="Escape the given raw string into an XML value.">escapeForXml</a>(<span class="keyword">const</span> <span class="keywordtype">string</span> &amp;input);
214
- <a name="l00189"></a>00189 <span class="comment"></span>
215
- <a name="l00190"></a>00190 <span class="comment">/**</span>
216
- <a name="l00191"></a>00191 <span class="comment"> * Returns the username of the user that the current process is running as.</span>
217
- <a name="l00192"></a>00192 <span class="comment"> * If the user has no associated username, then &quot;UID xxxx&quot; is returned,</span>
218
- <a name="l00193"></a>00193 <span class="comment"> * where xxxx is the current UID.</span>
219
- <a name="l00194"></a>00194 <span class="comment"> */</span>
220
- <a name="l00195"></a>00195 <span class="keywordtype">string</span> <a class="code" href="namespacePassenger.html#ade80218e8b836b796f8b960b6225b439" title="Returns the username of the user that the current process is running as.">getProcessUsername</a>();
221
- <a name="l00196"></a>00196 <span class="comment"></span>
222
- <a name="l00197"></a>00197 <span class="comment">/**</span>
223
- <a name="l00198"></a>00198 <span class="comment"> * Converts a mode string into a mode_t value.</span>
224
- <a name="l00199"></a>00199 <span class="comment"> *</span>
225
- <a name="l00200"></a>00200 <span class="comment"> * At this time only the symbolic mode strings are supported, e.g. something like looks</span>
226
- <a name="l00201"></a>00201 <span class="comment"> * this: &quot;u=rwx,g=w,o=rx&quot;. The grammar is as follows:</span>
227
- <a name="l00202"></a>00202 <span class="comment"> * @code</span>
228
- <a name="l00203"></a>00203 <span class="comment"> * mode ::= (clause (&quot;,&quot; clause)*)?</span>
229
- <a name="l00204"></a>00204 <span class="comment"> * clause ::= who &quot;=&quot; permission*</span>
230
- <a name="l00205"></a>00205 <span class="comment"> * who ::= &quot;u&quot; | &quot;g&quot; | &quot;o&quot;</span>
231
- <a name="l00206"></a>00206 <span class="comment"> * permission ::= &quot;r&quot; | &quot;w&quot; | &quot;x&quot; | &quot;s&quot;</span>
232
- <a name="l00207"></a>00207 <span class="comment"> * @endcode</span>
233
- <a name="l00208"></a>00208 <span class="comment"> *</span>
234
- <a name="l00209"></a>00209 <span class="comment"> * Notes:</span>
235
- <a name="l00210"></a>00210 <span class="comment"> * - The mode value starts with 0. So if you specify &quot;u=rwx&quot;, then the group and world</span>
236
- <a name="l00211"></a>00211 <span class="comment"> * permissions will be empty (set to 0).</span>
237
- <a name="l00212"></a>00212 <span class="comment"> * - The &quot;s&quot; permission is only allowed for who == &quot;u&quot; or who == &quot;g&quot;.</span>
238
- <a name="l00213"></a>00213 <span class="comment"> * - The return value does not depend on the umask.</span>
239
- <a name="l00214"></a>00214 <span class="comment"> *</span>
240
- <a name="l00215"></a>00215 <span class="comment"> * @throws InvalidModeStringException The mode string cannot be parsed.</span>
241
- <a name="l00216"></a>00216 <span class="comment"> */</span>
242
- <a name="l00217"></a>00217 mode_t <a class="code" href="namespacePassenger.html#ada53f5a9bdcf3d22d4a710e7ea3678e9" title="Converts a mode string into a mode_t value.">parseModeString</a>(<span class="keyword">const</span> StaticString &amp;mode);
243
- <a name="l00218"></a>00218 <span class="comment"></span>
244
- <a name="l00219"></a>00219 <span class="comment">/**</span>
245
- <a name="l00220"></a>00220 <span class="comment"> * Return the path name for the directory in which the system stores general</span>
246
- <a name="l00221"></a>00221 <span class="comment"> * temporary files. This is usually &quot;/tmp&quot;, but might be something else depending</span>
247
- <a name="l00222"></a>00222 <span class="comment"> * on some environment variables.</span>
248
- <a name="l00223"></a>00223 <span class="comment"> *</span>
249
- <a name="l00224"></a>00224 <span class="comment"> * @ensure result != NULL</span>
250
- <a name="l00225"></a>00225 <span class="comment"> * @ingroup Support</span>
251
- <a name="l00226"></a>00226 <span class="comment"> */</span>
252
- <a name="l00227"></a>00227 <span class="keyword">const</span> <span class="keywordtype">char</span> *<a class="code" href="group__Support.html#ga68f4105c5a8e510520b5ea3eecb66213" title="Return the path name for the directory in which the system stores general temporary...">getSystemTempDir</a>();
253
- <a name="l00228"></a>00228
254
- <a name="l00229"></a>00229 <span class="comment">/* Create a temporary directory for storing Phusion Passenger instance-specific</span>
255
- <a name="l00230"></a>00230 <span class="comment"> * temp files, such as temporarily buffered uploads, sockets for backend</span>
256
- <a name="l00231"></a>00231 <span class="comment"> * processes, etc.</span>
257
- <a name="l00232"></a>00232 <span class="comment"> * The directory that will be created is the one returned by</span>
258
- <a name="l00233"></a>00233 <span class="comment"> * &lt;tt&gt;getPassengerTempDir(false, parentDir)&lt;/tt&gt;. This call stores the path to</span>
259
- <a name="l00234"></a>00234 <span class="comment"> * this temp directory in an internal variable, so that subsequent calls to</span>
260
- <a name="l00235"></a>00235 <span class="comment"> * getPassengerTempDir() will return the same path.</span>
261
- <a name="l00236"></a>00236 <span class="comment"> *</span>
262
- <a name="l00237"></a>00237 <span class="comment"> * The created temp directory will have several subdirectories:</span>
263
- <a name="l00238"></a>00238 <span class="comment"> * - webserver_private - for storing the web server&#39;s buffered uploads.</span>
264
- <a name="l00239"></a>00239 <span class="comment"> * - info - for storing files that allow external tools to query information</span>
265
- <a name="l00240"></a>00240 <span class="comment"> * about a running Phusion Passenger instance.</span>
266
- <a name="l00241"></a>00241 <span class="comment"> * - backends - for storing Unix sockets created by backend processes.</span>
267
- <a name="l00242"></a>00242 <span class="comment"> * - master - for storing files such as the Passenger HelperServer socket.</span>
268
- <a name="l00243"></a>00243 <span class="comment"> *</span>
269
- <a name="l00244"></a>00244 <span class="comment"> * If a (sub)directory already exists, then it will not result in an error.</span>
270
- <a name="l00245"></a>00245 <span class="comment"> *</span>
271
- <a name="l00246"></a>00246 <span class="comment"> * The &lt;em&gt;userSwitching&lt;/em&gt; and &lt;em&gt;lowestUser&lt;/em&gt; arguments passed to</span>
272
- <a name="l00247"></a>00247 <span class="comment"> * this method are used for determining the optimal permissions for the</span>
273
- <a name="l00248"></a>00248 <span class="comment"> * (sub)directories. The permissions will be set as tightly as possible based</span>
274
- <a name="l00249"></a>00249 <span class="comment"> * on the values. The &lt;em&gt;workerUid&lt;/em&gt; and &lt;em&gt;workerGid&lt;/em&gt; arguments</span>
275
- <a name="l00250"></a>00250 <span class="comment"> * will be used for determining the owner of certain subdirectories.</span>
276
- <a name="l00251"></a>00251 <span class="comment"> *</span>
277
- <a name="l00252"></a>00252 <span class="comment"> * @note You should only call this method inside the web server&#39;s master</span>
278
- <a name="l00253"></a>00253 <span class="comment"> * process. In case of Apache, this is the Apache control process,</span>
279
- <a name="l00254"></a>00254 <span class="comment"> * the one that tends to run as root. This is because this function</span>
280
- <a name="l00255"></a>00255 <span class="comment"> * will set directory permissions and owners/groups, which may require</span>
281
- <a name="l00256"></a>00256 <span class="comment"> * root privileges.</span>
282
- <a name="l00257"></a>00257 <span class="comment"> *</span>
283
- <a name="l00258"></a>00258 <span class="comment"> * @param parentDir The directory under which the Phusion Passenger-specific</span>
284
- <a name="l00259"></a>00259 <span class="comment"> * temp directory should be created. This argument may be the</span>
285
- <a name="l00260"></a>00260 <span class="comment"> * empty string, in which case getSystemTempDir() will be used</span>
286
- <a name="l00261"></a>00261 <span class="comment"> * as the parent directory.</span>
287
- <a name="l00262"></a>00262 <span class="comment"> * @param userSwitching Whether user switching is turned on.</span>
288
- <a name="l00263"></a>00263 <span class="comment"> * @param lowestUser The user that the spawn manager and the pool server will</span>
289
- <a name="l00264"></a>00264 <span class="comment"> * run as, if user switching is turned off.</span>
290
- <a name="l00265"></a>00265 <span class="comment"> * @param workerUid The UID that the web server&#39;s worker processes are running</span>
291
- <a name="l00266"></a>00266 <span class="comment"> * as. On Apache, this is the UID that&#39;s associated with the</span>
292
- <a name="l00267"></a>00267 <span class="comment"> * &#39;User&#39; directive.</span>
293
- <a name="l00268"></a>00268 <span class="comment"> * @param workerGid The GID that the web server&#39;s worker processes are running</span>
294
- <a name="l00269"></a>00269 <span class="comment"> * as. On Apache, this is the GID that&#39;s associated with the</span>
295
- <a name="l00270"></a>00270 <span class="comment"> * &#39;Group&#39; directive.</span>
296
- <a name="l00271"></a>00271 <span class="comment"> * @throws IOException Something went wrong.</span>
297
- <a name="l00272"></a>00272 <span class="comment"> * @throws SystemException Something went wrong.</span>
298
- <a name="l00273"></a>00273 <span class="comment"> * @throws FileSystemException Something went wrong.</span>
299
- <a name="l00274"></a>00274 <span class="comment"> */</span>
300
- <a name="l00275"></a>00275 <span class="comment">/* void createPassengerTempDir(const string &amp;parentDir, bool userSwitching,</span>
301
- <a name="l00276"></a>00276 <span class="comment"> const string &amp;lowestUser,</span>
302
- <a name="l00277"></a>00277 <span class="comment"> uid_t workerUid, gid_t workerGid); */</span>
303
- <a name="l00278"></a>00278 <span class="comment"></span>
304
- <a name="l00279"></a>00279 <span class="comment">/**</span>
305
- <a name="l00280"></a>00280 <span class="comment"> * Create the directory at the given path, creating intermediate directories</span>
306
- <a name="l00281"></a>00281 <span class="comment"> * if necessary. The created directories&#39; permissions are exactly as specified</span>
307
- <a name="l00282"></a>00282 <span class="comment"> * by the &#39;mode&#39; parameter (i.e. the umask will be ignored). You can specify</span>
308
- <a name="l00283"></a>00283 <span class="comment"> * this directory&#39;s owner and group through the &#39;owner&#39; and &#39;group&#39; parameters.</span>
309
- <a name="l00284"></a>00284 <span class="comment"> * A value of USER_NOT_GIVEN for &#39;owner&#39; and/or GROUP_NOT_GIVEN &#39;group&#39; means</span>
310
- <a name="l00285"></a>00285 <span class="comment"> * that the owner/group should not be changed.</span>
311
- <a name="l00286"></a>00286 <span class="comment"> *</span>
312
- <a name="l00287"></a>00287 <span class="comment"> * If &#39;path&#39; already exists, then nothing will happen.</span>
313
- <a name="l00288"></a>00288 <span class="comment"> *</span>
314
- <a name="l00289"></a>00289 <span class="comment"> * @param mode A mode string, as supported by parseModeString().</span>
315
- <a name="l00290"></a>00290 <span class="comment"> * @throws FileSystemException Something went wrong.</span>
316
- <a name="l00291"></a>00291 <span class="comment"> * @throws InvalidModeStringException The mode string cannot be parsed.</span>
317
- <a name="l00292"></a>00292 <span class="comment"> */</span>
318
- <a name="l00293"></a>00293 <span class="keywordtype">void</span> <a class="code" href="namespacePassenger.html#a448f25263af0b37b91caee3d294ec4aa" title="Create the directory at the given path, creating intermediate directories if necessary...">makeDirTree</a>(<span class="keyword">const</span> <span class="keywordtype">string</span> &amp;path, <span class="keyword">const</span> StaticString &amp;mode = <span class="stringliteral">&quot;u=rwx,g=,o=&quot;</span>,
319
- <a name="l00294"></a>00294 uid_t owner = USER_NOT_GIVEN, gid_t group = GROUP_NOT_GIVEN);
320
- <a name="l00295"></a>00295 <span class="comment"></span>
321
- <a name="l00296"></a>00296 <span class="comment">/**</span>
322
- <a name="l00297"></a>00297 <span class="comment"> * Remove an entire directory tree recursively. If the directory doesn&#39;t exist then this</span>
323
- <a name="l00298"></a>00298 <span class="comment"> * function does nothing.</span>
324
- <a name="l00299"></a>00299 <span class="comment"> *</span>
325
- <a name="l00300"></a>00300 <span class="comment"> * @throws FileSystemException Something went wrong.</span>
326
- <a name="l00301"></a>00301 <span class="comment"> */</span>
327
- <a name="l00302"></a>00302 <span class="keywordtype">void</span> <a class="code" href="namespacePassenger.html#a8422d210cbd2f62d21254415b5a7f747" title="Remove an entire directory tree recursively.">removeDirTree</a>(<span class="keyword">const</span> <span class="keywordtype">string</span> &amp;path);
328
- <a name="l00303"></a>00303 <span class="comment"></span>
329
- <a name="l00304"></a>00304 <span class="comment">/**</span>
330
- <a name="l00305"></a>00305 <span class="comment"> * Check whether the specified directory is a valid Ruby on Rails</span>
331
- <a name="l00306"></a>00306 <span class="comment"> * application root directory.</span>
332
- <a name="l00307"></a>00307 <span class="comment"> *</span>
333
- <a name="l00308"></a>00308 <span class="comment"> * @param cstat A CachedFileStat object, if you want to use cached statting.</span>
334
- <a name="l00309"></a>00309 <span class="comment"> * @param throttleRate A throttle rate for cstat. Only applicable if cstat is not NULL.</span>
335
- <a name="l00310"></a>00310 <span class="comment"> * @throws FileSystemException Unable to check because of a system error.</span>
336
- <a name="l00311"></a>00311 <span class="comment"> * @throws TimeRetrievalException</span>
337
- <a name="l00312"></a>00312 <span class="comment"> * @throws boost::thread_interrupted</span>
338
- <a name="l00313"></a>00313 <span class="comment"> * @ingroup Support</span>
339
- <a name="l00314"></a>00314 <span class="comment"> */</span>
340
- <a name="l00315"></a>00315 <span class="keywordtype">bool</span> <a class="code" href="group__Support.html#ga5e6bc7ff22b7c61238d7913521936f71" title="Check whether the specified directory is a valid Ruby on Rails application root directory...">verifyRailsDir</a>(<span class="keyword">const</span> <span class="keywordtype">string</span> &amp;dir, CachedFileStat *cstat = 0,
341
- <a name="l00316"></a>00316 <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> throttleRate = 0);
342
- <a name="l00317"></a>00317 <span class="comment"></span>
343
- <a name="l00318"></a>00318 <span class="comment">/**</span>
344
- <a name="l00319"></a>00319 <span class="comment"> * Check whether the specified directory is a valid Rack application</span>
345
- <a name="l00320"></a>00320 <span class="comment"> * root directory.</span>
346
- <a name="l00321"></a>00321 <span class="comment"> *</span>
347
- <a name="l00322"></a>00322 <span class="comment"> * @param cstat A CachedFileStat object, if you want to use cached statting.</span>
348
- <a name="l00323"></a>00323 <span class="comment"> * @param throttleRate A throttle rate for cstat. Only applicable if cstat is not NULL.</span>
349
- <a name="l00324"></a>00324 <span class="comment"> * @throws FileSystemException Unable to check because of a filesystem error.</span>
350
- <a name="l00325"></a>00325 <span class="comment"> * @throws TimeRetrievalException</span>
351
- <a name="l00326"></a>00326 <span class="comment"> * @throws boost::thread_interrupted</span>
352
- <a name="l00327"></a>00327 <span class="comment"> * @ingroup Support</span>
353
- <a name="l00328"></a>00328 <span class="comment"> */</span>
354
- <a name="l00329"></a>00329 <span class="keywordtype">bool</span> <a class="code" href="group__Support.html#ga53969f8e3ee68d1d99ffe75af8db9be8" title="Check whether the specified directory is a valid Rack application root directory...">verifyRackDir</a>(<span class="keyword">const</span> <span class="keywordtype">string</span> &amp;dir, CachedFileStat *cstat = 0,
355
- <a name="l00330"></a>00330 <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> throttleRate = 0);
356
- <a name="l00331"></a>00331 <span class="comment"></span>
357
- <a name="l00332"></a>00332 <span class="comment">/**</span>
358
- <a name="l00333"></a>00333 <span class="comment"> * Check whether the specified directory is a valid WSGI application</span>
359
- <a name="l00334"></a>00334 <span class="comment"> * root directory.</span>
360
- <a name="l00335"></a>00335 <span class="comment"> *</span>
361
- <a name="l00336"></a>00336 <span class="comment"> * @param cstat A CachedFileStat object, if you want to use cached statting.</span>
362
- <a name="l00337"></a>00337 <span class="comment"> * @param throttleRate A throttle rate for cstat. Only applicable if cstat is not NULL.</span>
363
- <a name="l00338"></a>00338 <span class="comment"> * @throws FileSystemException Unable to check because of a filesystem error.</span>
364
- <a name="l00339"></a>00339 <span class="comment"> * @throws TimeRetrievalException</span>
365
- <a name="l00340"></a>00340 <span class="comment"> * @throws boost::thread_interrupted</span>
366
- <a name="l00341"></a>00341 <span class="comment"> * @ingroup Support</span>
367
- <a name="l00342"></a>00342 <span class="comment"> */</span>
368
- <a name="l00343"></a>00343 <span class="keywordtype">bool</span> <a class="code" href="group__Support.html#gaaec51d2912999d611994c49341f36247" title="Check whether the specified directory is a valid WSGI application root directory...">verifyWSGIDir</a>(<span class="keyword">const</span> <span class="keywordtype">string</span> &amp;dir, CachedFileStat *cstat = 0,
369
- <a name="l00344"></a>00344 <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> throttleRate = 0);
370
- <a name="l00345"></a>00345
371
- <a name="l00346"></a>00346 <span class="keywordtype">void</span> prestartWebApps(<span class="keyword">const</span> ResourceLocator &amp;locator, <span class="keyword">const</span> <span class="keywordtype">string</span> &amp;serializedprestartURLs);
372
- <a name="l00347"></a>00347 <span class="comment"></span>
373
- <a name="l00348"></a>00348 <span class="comment">/**</span>
374
- <a name="l00349"></a>00349 <span class="comment"> * Runs the given function and catches any tracable_exceptions. Upon catching such an exception,</span>
375
- <a name="l00350"></a>00350 <span class="comment"> * its message and backtrace will be printed. If toAbort is true then it will call abort(),</span>
376
- <a name="l00351"></a>00351 <span class="comment"> * otherwise the exception is swallowed.</span>
377
- <a name="l00352"></a>00352 <span class="comment"> * thread_interrupted and all other exceptions are silently propagated.</span>
378
- <a name="l00353"></a>00353 <span class="comment"> */</span>
379
- <a name="l00354"></a>00354 <span class="keywordtype">void</span> <a class="code" href="namespacePassenger.html#ad233ce971fa0e937182c637bf2d1f105" title="Runs the given function and catches any tracable_exceptions.">runAndPrintExceptions</a>(<span class="keyword">const</span> function&lt;<span class="keywordtype">void</span> ()&gt; &amp;func, <span class="keywordtype">bool</span> toAbort);
380
- <a name="l00355"></a>00355 <span class="keywordtype">void</span> <a class="code" href="namespacePassenger.html#ad233ce971fa0e937182c637bf2d1f105" title="Runs the given function and catches any tracable_exceptions.">runAndPrintExceptions</a>(<span class="keyword">const</span> function&lt;<span class="keywordtype">void</span> ()&gt; &amp;func);
381
- <a name="l00356"></a>00356 <span class="comment"></span>
382
- <a name="l00357"></a>00357 <span class="comment">/**</span>
383
- <a name="l00358"></a>00358 <span class="comment"> * Returns the system&#39;s host name.</span>
384
- <a name="l00359"></a>00359 <span class="comment"> *</span>
385
- <a name="l00360"></a>00360 <span class="comment"> * @throws SystemException The host name cannot be retrieved.</span>
386
- <a name="l00361"></a>00361 <span class="comment"> */</span>
387
- <a name="l00362"></a>00362 <span class="keywordtype">string</span> <a class="code" href="namespacePassenger.html#a1d0a66b0e207c46dc6124ff3b2f331e6" title="Returns the system&amp;#39;s host name.">getHostName</a>();
388
- <a name="l00363"></a>00363 <span class="comment"></span>
389
- <a name="l00364"></a>00364 <span class="comment">/**</span>
390
- <a name="l00365"></a>00365 <span class="comment"> * Convert a signal number to its associated name.</span>
391
- <a name="l00366"></a>00366 <span class="comment"> */</span>
392
- <a name="l00367"></a>00367 <span class="keywordtype">string</span> <a class="code" href="namespacePassenger.html#a979cb43cef743bf261c329b13e712366" title="Convert a signal number to its associated name.">getSignalName</a>(<span class="keywordtype">int</span> sig);
393
- <a name="l00368"></a>00368 <span class="comment"></span>
394
- <a name="l00369"></a>00369 <span class="comment">/**</span>
395
- <a name="l00370"></a>00370 <span class="comment"> * Resets the current process&#39;s signal handler disposition and signal mask</span>
396
- <a name="l00371"></a>00371 <span class="comment"> * to default values. One should call this every time one forks a child process;</span>
397
- <a name="l00372"></a>00372 <span class="comment"> * non-default signal masks/handler dispositions can cause all kinds of weird quirks,</span>
398
- <a name="l00373"></a>00373 <span class="comment"> * like waitpid() malfunctioning on OS X.</span>
399
- <a name="l00374"></a>00374 <span class="comment"> *</span>
400
- <a name="l00375"></a>00375 <span class="comment"> * This function is async-signal safe.</span>
401
- <a name="l00376"></a>00376 <span class="comment"> */</span>
402
- <a name="l00377"></a>00377 <span class="keywordtype">void</span> <a class="code" href="namespacePassenger.html#a2029ad8cb57611ab161b20ef9df39c86" title="Resets the current process&amp;#39;s signal handler disposition and signal mask to default...">resetSignalHandlersAndMask</a>();
403
- <a name="l00378"></a>00378 <span class="comment"></span>
404
- <a name="l00379"></a>00379 <span class="comment">/**</span>
405
- <a name="l00380"></a>00380 <span class="comment"> * Close all file descriptors that are higher than &lt;em&gt;lastToKeepOpen&lt;/em&gt;.</span>
406
- <a name="l00381"></a>00381 <span class="comment"> * This function is async-signal safe. But make sure there are no other</span>
407
- <a name="l00382"></a>00382 <span class="comment"> * threads running that might open file descriptors!</span>
408
- <a name="l00383"></a>00383 <span class="comment"> */</span>
409
- <a name="l00384"></a>00384 <span class="keywordtype">void</span> <a class="code" href="namespacePassenger.html#af116b11276c90901729b6ce541dd2a07" title="Close all file descriptors that are higher than lastToKeepOpen.">closeAllFileDescriptors</a>(<span class="keywordtype">int</span> lastToKeepOpen);
410
- <a name="l00385"></a>00385
411
- <a name="l00386"></a>00386 <span class="comment"></span>
412
- <a name="l00387"></a>00387 <span class="comment">/**</span>
413
- <a name="l00388"></a>00388 <span class="comment"> * Represents a buffered upload file.</span>
414
- <a name="l00389"></a>00389 <span class="comment"> *</span>
415
- <a name="l00390"></a>00390 <span class="comment"> * @ingroup Support</span>
416
- <a name="l00391"></a>00391 <span class="comment"> */</span>
417
- <a name="l00392"></a><a class="code" href="classPassenger_1_1BufferedUpload.html">00392</a> <span class="keyword">class </span><a class="code" href="classPassenger_1_1BufferedUpload.html" title="Represents a buffered upload file.">BufferedUpload</a> {
418
- <a name="l00393"></a>00393 <span class="keyword">public</span>:<span class="comment"></span>
419
- <a name="l00394"></a>00394 <span class="comment"> /** The file handle. */</span>
420
- <a name="l00395"></a><a class="code" href="classPassenger_1_1BufferedUpload.html#a0a340f2d972ae791f56f893901109dac">00395</a> FILE *<a class="code" href="classPassenger_1_1BufferedUpload.html#a0a340f2d972ae791f56f893901109dac" title="The file handle.">handle</a>;
421
- <a name="l00396"></a>00396 <span class="comment"></span>
422
- <a name="l00397"></a>00397 <span class="comment"> /**</span>
423
- <a name="l00398"></a>00398 <span class="comment"> * Create an empty upload bufer file, and open it for reading and writing.</span>
424
- <a name="l00399"></a>00399 <span class="comment"> *</span>
425
- <a name="l00400"></a>00400 <span class="comment"> * @throws SystemException Something went wrong.</span>
426
- <a name="l00401"></a>00401 <span class="comment"> */</span>
427
- <a name="l00402"></a><a class="code" href="classPassenger_1_1BufferedUpload.html#a51489619731ea95c2ece27faab9e24fc">00402</a> <a class="code" href="classPassenger_1_1BufferedUpload.html#a51489619731ea95c2ece27faab9e24fc" title="Create an empty upload bufer file, and open it for reading and writing.">BufferedUpload</a>(<span class="keyword">const</span> <span class="keywordtype">string</span> &amp;dir, <span class="keyword">const</span> <span class="keywordtype">char</span> *identifier = <span class="stringliteral">&quot;temp&quot;</span>) {
428
- <a name="l00403"></a>00403 <span class="keywordtype">char</span> templ[PATH_MAX];
429
- <a name="l00404"></a>00404 <span class="keywordtype">int</span> fd;
430
- <a name="l00405"></a>00405
431
- <a name="l00406"></a>00406 snprintf(templ, <span class="keyword">sizeof</span>(templ), <span class="stringliteral">&quot;%s/%s.XXXXXX&quot;</span>, dir.c_str(), identifier);
432
- <a name="l00407"></a>00407 templ[<span class="keyword">sizeof</span>(templ) - 1] = <span class="charliteral">&#39;\0&#39;</span>;
433
- <a name="l00408"></a>00408 fd = mkstemp(templ);
434
- <a name="l00409"></a>00409 <span class="keywordflow">if</span> (fd == -1) {
435
- <a name="l00410"></a>00410 <span class="keywordtype">char</span> message[1024];
436
- <a name="l00411"></a>00411 <span class="keywordtype">int</span> e = errno;
437
- <a name="l00412"></a>00412
438
- <a name="l00413"></a>00413 snprintf(message, <span class="keyword">sizeof</span>(message), <span class="stringliteral">&quot;Cannot create a temporary file &#39;%s&#39;&quot;</span>, templ);
439
- <a name="l00414"></a>00414 message[<span class="keyword">sizeof</span>(message) - 1] = <span class="charliteral">&#39;\0&#39;</span>;
440
- <a name="l00415"></a>00415 <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>(message, e);
441
- <a name="l00416"></a>00416 }
442
- <a name="l00417"></a>00417
443
- <a name="l00418"></a>00418 <span class="comment">/* We use a POSIX trick here: the file&#39;s permissions are set to &quot;u=,g=,o=&quot;</span>
444
- <a name="l00419"></a>00419 <span class="comment"> * and the file is deleted immediately from the filesystem, while we</span>
445
- <a name="l00420"></a>00420 <span class="comment"> * keep its file handle open. The result is that no other processes</span>
446
- <a name="l00421"></a>00421 <span class="comment"> * will be able to access this file&#39;s contents anymore, except us.</span>
447
- <a name="l00422"></a>00422 <span class="comment"> * We now have an anonymous disk-backed buffer.</span>
448
- <a name="l00423"></a>00423 <span class="comment"> */</span>
449
- <a name="l00424"></a>00424 fchmod(fd, 0000);
450
- <a name="l00425"></a>00425 unlink(templ);
451
- <a name="l00426"></a>00426
452
- <a name="l00427"></a>00427 <a class="code" href="classPassenger_1_1BufferedUpload.html#a0a340f2d972ae791f56f893901109dac" title="The file handle.">handle</a> = fdopen(fd, <span class="stringliteral">&quot;w+&quot;</span>);
453
- <a name="l00428"></a>00428 }
454
- <a name="l00429"></a>00429
455
- <a name="l00430"></a>00430 ~<a class="code" href="classPassenger_1_1BufferedUpload.html" title="Represents a buffered upload file.">BufferedUpload</a>() {
456
- <a name="l00431"></a>00431 fclose(<a class="code" href="classPassenger_1_1BufferedUpload.html#a0a340f2d972ae791f56f893901109dac" title="The file handle.">handle</a>);
457
- <a name="l00432"></a>00432 }
458
- <a name="l00433"></a>00433 };
459
- <a name="l00434"></a>00434
460
- <a name="l00435"></a>00435 } <span class="comment">// namespace Passenger</span>
461
- <a name="l00436"></a>00436
462
- <a name="l00437"></a>00437 <span class="preprocessor">#endif </span><span class="comment">/* _PASSENGER_UTILS_H_ */</span>
463
- <a name="l00438"></a>00438
464
- </pre></div></div>
465
- <hr size="1"/><address style="text-align: right;"><small>Generated by&nbsp;
466
- <a href="http://www.doxygen.org/index.html">
467
- <img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.6.2 </small></address>
468
- </body>
469
- </html>