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/Exceptions_8h_source.html DELETED
@@ -1,393 +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: Exceptions.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>Exceptions.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_EXCEPTIONS_H_</span>
51
- <a name="l00026"></a>00026 <span class="preprocessor"></span><span class="preprocessor">#define _PASSENGER_EXCEPTIONS_H_</span>
52
- <a name="l00027"></a>00027 <span class="preprocessor"></span>
53
- <a name="l00028"></a>00028 <span class="preprocessor">#include &lt;oxt/tracable_exception.hpp&gt;</span>
54
- <a name="l00029"></a>00029 <span class="preprocessor">#include &lt;string&gt;</span>
55
- <a name="l00030"></a>00030 <span class="preprocessor">#include &lt;sstream&gt;</span>
56
- <a name="l00031"></a>00031 <span class="preprocessor">#include &lt;cstring&gt;</span>
57
- <a name="l00032"></a>00032 <span class="comment"></span>
58
- <a name="l00033"></a>00033 <span class="comment">/**</span>
59
- <a name="l00034"></a>00034 <span class="comment"> * @defgroup Exceptions Exceptions</span>
60
- <a name="l00035"></a>00035 <span class="comment"> */</span>
61
- <a name="l00036"></a>00036
62
- <a name="l00037"></a>00037 <span class="keyword">namespace </span>Passenger {
63
- <a name="l00038"></a>00038
64
- <a name="l00039"></a>00039 <span class="keyword">using namespace </span>std;
65
- <a name="l00040"></a>00040 <span class="comment"></span>
66
- <a name="l00041"></a>00041 <span class="comment">/**</span>
67
- <a name="l00042"></a>00042 <span class="comment"> * Represents an error returned by a system call or a standard library call.</span>
68
- <a name="l00043"></a>00043 <span class="comment"> *</span>
69
- <a name="l00044"></a>00044 <span class="comment"> * Use the code() method to find out the value of &lt;tt&gt;errno&lt;/tt&gt; at the time</span>
70
- <a name="l00045"></a>00045 <span class="comment"> * the error occured.</span>
71
- <a name="l00046"></a>00046 <span class="comment"> *</span>
72
- <a name="l00047"></a>00047 <span class="comment"> * @ingroup Exceptions</span>
73
- <a name="l00048"></a>00048 <span class="comment"> */</span>
74
- <a name="l00049"></a><a class="code" href="classPassenger_1_1SystemException.html">00049</a> <span class="keyword">class </span><a class="code" href="classPassenger_1_1SystemException.html" title="Represents an error returned by a system call or a standard library call.">SystemException</a>: <span class="keyword">public</span> oxt::tracable_exception {
75
- <a name="l00050"></a>00050 <span class="keyword">private</span>:
76
- <a name="l00051"></a>00051 <span class="keywordtype">string</span> briefMessage;
77
- <a name="l00052"></a>00052 <span class="keywordtype">string</span> systemMessage;
78
- <a name="l00053"></a>00053 <span class="keywordtype">string</span> fullMessage;
79
- <a name="l00054"></a>00054 <span class="keywordtype">int</span> m_code;
80
- <a name="l00055"></a>00055 <span class="keyword">public</span>:<span class="comment"></span>
81
- <a name="l00056"></a>00056 <span class="comment"> /**</span>
82
- <a name="l00057"></a>00057 <span class="comment"> * Create a new SystemException.</span>
83
- <a name="l00058"></a>00058 <span class="comment"> *</span>
84
- <a name="l00059"></a>00059 <span class="comment"> * @param briefMessage A brief message describing the error.</span>
85
- <a name="l00060"></a>00060 <span class="comment"> * @param errorCode The error code, i.e. the value of errno right after the error occured.</span>
86
- <a name="l00061"></a>00061 <span class="comment"> * @note A system description of the error will be appended to the given message.</span>
87
- <a name="l00062"></a>00062 <span class="comment"> * For example, if &lt;tt&gt;errorCode&lt;/tt&gt; is &lt;tt&gt;EBADF&lt;/tt&gt;, and &lt;tt&gt;briefMessage&lt;/tt&gt;</span>
88
- <a name="l00063"></a>00063 <span class="comment"> * is &lt;em&gt;&quot;Something happened&quot;&lt;/em&gt;, then what() will return &lt;em&gt;&quot;Something happened: Bad</span>
89
- <a name="l00064"></a>00064 <span class="comment"> * file descriptor (10)&quot;&lt;/em&gt; (if 10 is the number for EBADF).</span>
90
- <a name="l00065"></a>00065 <span class="comment"> * @post code() == errorCode</span>
91
- <a name="l00066"></a>00066 <span class="comment"> * @post brief() == briefMessage</span>
92
- <a name="l00067"></a>00067 <span class="comment"> */</span>
93
- <a name="l00068"></a><a class="code" href="classPassenger_1_1SystemException.html#a1f0f33c63934ee40c5cd9c338c8aa04b">00068</a> <a class="code" href="classPassenger_1_1SystemException.html#a1f0f33c63934ee40c5cd9c338c8aa04b" title="Create a new SystemException.">SystemException</a>(<span class="keyword">const</span> <span class="keywordtype">string</span> &amp;briefMessage, <span class="keywordtype">int</span> errorCode) {
94
- <a name="l00069"></a>00069 stringstream str;
95
- <a name="l00070"></a>00070
96
- <a name="l00071"></a>00071 str &lt;&lt; strerror(errorCode) &lt;&lt; <span class="stringliteral">&quot; (&quot;</span> &lt;&lt; errorCode &lt;&lt; <span class="stringliteral">&quot;)&quot;</span>;
97
- <a name="l00072"></a>00072 systemMessage = str.str();
98
- <a name="l00073"></a>00073
99
- <a name="l00074"></a>00074 setBriefMessage(briefMessage);
100
- <a name="l00075"></a>00075 m_code = errorCode;
101
- <a name="l00076"></a>00076 }
102
- <a name="l00077"></a>00077
103
- <a name="l00078"></a>00078 <span class="keyword">virtual</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>() throw() {}
104
- <a name="l00079"></a>00079
105
- <a name="l00080"></a>00080 <span class="keyword">virtual</span> <span class="keyword">const</span> <span class="keywordtype">char</span> *what() <span class="keyword">const</span> throw() {
106
- <a name="l00081"></a>00081 <span class="keywordflow">return</span> fullMessage.c_str();
107
- <a name="l00082"></a>00082 }
108
- <a name="l00083"></a>00083
109
- <a name="l00084"></a>00084 <span class="keywordtype">void</span> setBriefMessage(<span class="keyword">const</span> <span class="keywordtype">string</span> &amp;message) {
110
- <a name="l00085"></a>00085 briefMessage = message;
111
- <a name="l00086"></a>00086 fullMessage = briefMessage + <span class="stringliteral">&quot;: &quot;</span> + systemMessage;
112
- <a name="l00087"></a>00087 }
113
- <a name="l00088"></a>00088 <span class="comment"></span>
114
- <a name="l00089"></a>00089 <span class="comment"> /**</span>
115
- <a name="l00090"></a>00090 <span class="comment"> * The value of &lt;tt&gt;errno&lt;/tt&gt; at the time the error occured.</span>
116
- <a name="l00091"></a>00091 <span class="comment"> */</span>
117
- <a name="l00092"></a><a class="code" href="classPassenger_1_1SystemException.html#aee7a6672bf79b72a4c3ee70c57d6a47c">00092</a> <span class="keywordtype">int</span> <a class="code" href="classPassenger_1_1SystemException.html#aee7a6672bf79b72a4c3ee70c57d6a47c" title="The value of errno at the time the error occured.">code</a>() <span class="keyword">const</span> throw() {
118
- <a name="l00093"></a>00093 <span class="keywordflow">return</span> m_code;
119
- <a name="l00094"></a>00094 }
120
- <a name="l00095"></a>00095 <span class="comment"></span>
121
- <a name="l00096"></a>00096 <span class="comment"> /**</span>
122
- <a name="l00097"></a>00097 <span class="comment"> * Returns a brief version of the exception message. This message does</span>
123
- <a name="l00098"></a>00098 <span class="comment"> * not include the system error description, and is equivalent to the</span>
124
- <a name="l00099"></a>00099 <span class="comment"> * value of the &lt;tt&gt;message&lt;/tt&gt; parameter as passed to the constructor.</span>
125
- <a name="l00100"></a>00100 <span class="comment"> */</span>
126
- <a name="l00101"></a><a class="code" href="classPassenger_1_1SystemException.html#a84fa2ab4f5b7b96704734fcdfdaa0269">00101</a> <span class="keywordtype">string</span> <a class="code" href="classPassenger_1_1SystemException.html#a84fa2ab4f5b7b96704734fcdfdaa0269" title="Returns a brief version of the exception message.">brief</a>() <span class="keyword">const</span> throw() {
127
- <a name="l00102"></a>00102 <span class="keywordflow">return</span> briefMessage;
128
- <a name="l00103"></a>00103 }
129
- <a name="l00104"></a>00104 <span class="comment"></span>
130
- <a name="l00105"></a>00105 <span class="comment"> /**</span>
131
- <a name="l00106"></a>00106 <span class="comment"> * Returns the system&#39;s error message. This message contains both the</span>
132
- <a name="l00107"></a>00107 <span class="comment"> * content of &lt;tt&gt;strerror(errno)&lt;/tt&gt; and the errno number itself.</span>
133
- <a name="l00108"></a>00108 <span class="comment"> */</span>
134
- <a name="l00109"></a><a class="code" href="classPassenger_1_1SystemException.html#a0ef41d755fea2c9b1db2252e7c418dc8">00109</a> <span class="keywordtype">string</span> <a class="code" href="classPassenger_1_1SystemException.html#a0ef41d755fea2c9b1db2252e7c418dc8" title="Returns the system&amp;#39;s error message.">sys</a>() <span class="keyword">const</span> throw() {
135
- <a name="l00110"></a>00110 <span class="keywordflow">return</span> systemMessage;
136
- <a name="l00111"></a>00111 }
137
- <a name="l00112"></a>00112 };
138
- <a name="l00113"></a>00113 <span class="comment"></span>
139
- <a name="l00114"></a>00114 <span class="comment">/**</span>
140
- <a name="l00115"></a>00115 <span class="comment"> * A filesystem error, as returned by the operating system. This may include,</span>
141
- <a name="l00116"></a>00116 <span class="comment"> * for example, permission errors.</span>
142
- <a name="l00117"></a>00117 <span class="comment"> *</span>
143
- <a name="l00118"></a>00118 <span class="comment"> * @ingroup Exceptions</span>
144
- <a name="l00119"></a>00119 <span class="comment"> */</span>
145
- <a name="l00120"></a><a class="code" href="classPassenger_1_1FileSystemException.html">00120</a> <span class="keyword">class </span><a class="code" href="classPassenger_1_1FileSystemException.html" title="A filesystem error, as returned by the operating system.">FileSystemException</a>: <span class="keyword">public</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> {
146
- <a name="l00121"></a>00121 <span class="keyword">private</span>:
147
- <a name="l00122"></a>00122 <span class="keywordtype">string</span> m_filename;
148
- <a name="l00123"></a>00123 <span class="keyword">public</span>:
149
- <a name="l00124"></a>00124 <a class="code" href="classPassenger_1_1FileSystemException.html" title="A filesystem error, as returned by the operating system.">FileSystemException</a>(<span class="keyword">const</span> <span class="keywordtype">string</span> &amp;message, <span class="keywordtype">int</span> errorCode,
150
- <a name="l00125"></a>00125 <span class="keyword">const</span> <span class="keywordtype">string</span> &amp;<a class="code" href="classPassenger_1_1FileSystemException.html#a7eef8fefd84a07efa9fe3a76129a4386" title="The filename that&amp;#39;s associated to the error.">filename</a>)
151
- <a name="l00126"></a>00126 : <a class="code" href="classPassenger_1_1SystemException.html#a1f0f33c63934ee40c5cd9c338c8aa04b" title="Create a new SystemException.">SystemException</a>(message, errorCode),
152
- <a name="l00127"></a>00127 m_filename(filename) {}
153
- <a name="l00128"></a>00128
154
- <a name="l00129"></a>00129 <span class="keyword">virtual</span> ~<a class="code" href="classPassenger_1_1FileSystemException.html" title="A filesystem error, as returned by the operating system.">FileSystemException</a>() <span class="keywordflow">throw</span>() {}
155
- <a name="l00130"></a>00130 <span class="comment"></span>
156
- <a name="l00131"></a>00131 <span class="comment"> /**</span>
157
- <a name="l00132"></a>00132 <span class="comment"> * The filename that&#39;s associated to the error.</span>
158
- <a name="l00133"></a>00133 <span class="comment"> */</span>
159
- <a name="l00134"></a><a class="code" href="classPassenger_1_1FileSystemException.html#a7eef8fefd84a07efa9fe3a76129a4386">00134</a> <span class="keywordtype">string</span> <a class="code" href="classPassenger_1_1FileSystemException.html#a7eef8fefd84a07efa9fe3a76129a4386" title="The filename that&amp;#39;s associated to the error.">filename</a>() <span class="keyword">const</span> throw() {
160
- <a name="l00135"></a>00135 <span class="keywordflow">return</span> m_filename;
161
- <a name="l00136"></a>00136 }
162
- <a name="l00137"></a>00137 };
163
- <a name="l00138"></a>00138 <span class="comment"></span>
164
- <a name="l00139"></a>00139 <span class="comment">/**</span>
165
- <a name="l00140"></a>00140 <span class="comment"> * Unable to retrieve the system time using &lt;tt&gt;time()&lt;/tt&gt;.</span>
166
- <a name="l00141"></a>00141 <span class="comment"> *</span>
167
- <a name="l00142"></a>00142 <span class="comment"> * @ingroup Exceptions</span>
168
- <a name="l00143"></a>00143 <span class="comment"> */</span>
169
- <a name="l00144"></a><a class="code" href="classPassenger_1_1TimeRetrievalException.html">00144</a> <span class="keyword">class </span><a class="code" href="classPassenger_1_1TimeRetrievalException.html" title="Unable to retrieve the system time using time().">TimeRetrievalException</a>: <span class="keyword">public</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> {
170
- <a name="l00145"></a>00145 <span class="keyword">public</span>:
171
- <a name="l00146"></a>00146 <a class="code" href="classPassenger_1_1TimeRetrievalException.html" title="Unable to retrieve the system time using time().">TimeRetrievalException</a>(<span class="keyword">const</span> <span class="keywordtype">string</span> &amp;message, <span class="keywordtype">int</span> errorCode)
172
- <a name="l00147"></a>00147 : <a class="code" href="classPassenger_1_1SystemException.html#a1f0f33c63934ee40c5cd9c338c8aa04b" title="Create a new SystemException.">SystemException</a>(message, errorCode)
173
- <a name="l00148"></a>00148 {}
174
- <a name="l00149"></a>00149 <span class="keyword">virtual</span> ~<a class="code" href="classPassenger_1_1TimeRetrievalException.html" title="Unable to retrieve the system time using time().">TimeRetrievalException</a>() <span class="keywordflow">throw</span>() {}
175
- <a name="l00150"></a>00150 };
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"> * Represents an error that occured during an I/O operation.</span>
179
- <a name="l00154"></a>00154 <span class="comment"> *</span>
180
- <a name="l00155"></a>00155 <span class="comment"> * @ingroup Exceptions</span>
181
- <a name="l00156"></a>00156 <span class="comment"> */</span>
182
- <a name="l00157"></a><a class="code" href="classPassenger_1_1IOException.html">00157</a> <span class="keyword">class </span><a class="code" href="classPassenger_1_1IOException.html" title="Represents an error that occured during an I/O operation.">IOException</a>: <span class="keyword">public</span> oxt::tracable_exception {
183
- <a name="l00158"></a>00158 <span class="keyword">private</span>:
184
- <a name="l00159"></a>00159 <span class="keywordtype">string</span> msg;
185
- <a name="l00160"></a>00160 <span class="keyword">public</span>:
186
- <a name="l00161"></a>00161 <a class="code" href="classPassenger_1_1IOException.html" title="Represents an error that occured during an I/O operation.">IOException</a>(<span class="keyword">const</span> <span class="keywordtype">string</span> &amp;message): msg(message) {}
187
- <a name="l00162"></a>00162 <span class="keyword">virtual</span> ~<a class="code" href="classPassenger_1_1IOException.html" title="Represents an error that occured during an I/O operation.">IOException</a>() <span class="keywordflow">throw</span>() {}
188
- <a name="l00163"></a>00163 <span class="keyword">virtual</span> <span class="keyword">const</span> <span class="keywordtype">char</span> *what() <span class="keyword">const</span> <span class="keywordflow">throw</span>() { <span class="keywordflow">return</span> msg.c_str(); }
189
- <a name="l00164"></a>00164 };
190
- <a name="l00165"></a>00165 <span class="comment"></span>
191
- <a name="l00166"></a>00166 <span class="comment">/**</span>
192
- <a name="l00167"></a>00167 <span class="comment"> * Thrown when a certain file cannot be found.</span>
193
- <a name="l00168"></a>00168 <span class="comment"> */</span>
194
- <a name="l00169"></a><a class="code" href="classPassenger_1_1FileNotFoundException.html">00169</a> <span class="keyword">class </span><a class="code" href="classPassenger_1_1FileNotFoundException.html" title="Thrown when a certain file cannot be found.">FileNotFoundException</a>: <span class="keyword">public</span> <a class="code" href="classPassenger_1_1IOException.html" title="Represents an error that occured during an I/O operation.">IOException</a> {
195
- <a name="l00170"></a>00170 <span class="keyword">public</span>:
196
- <a name="l00171"></a>00171 <a class="code" href="classPassenger_1_1FileNotFoundException.html" title="Thrown when a certain file cannot be found.">FileNotFoundException</a>(<span class="keyword">const</span> <span class="keywordtype">string</span> &amp;message): <a class="code" href="classPassenger_1_1IOException.html" title="Represents an error that occured during an I/O operation.">IOException</a>(message) {}
197
- <a name="l00172"></a>00172 <span class="keyword">virtual</span> ~<a class="code" href="classPassenger_1_1FileNotFoundException.html" title="Thrown when a certain file cannot be found.">FileNotFoundException</a>() <span class="keywordflow">throw</span>() {}
198
- <a name="l00173"></a>00173 };
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"> * An unexpected end-of-file I/O error.</span>
202
- <a name="l00177"></a>00177 <span class="comment"> *</span>
203
- <a name="l00178"></a>00178 <span class="comment"> * @ingroup Exceptions</span>
204
- <a name="l00179"></a>00179 <span class="comment"> */</span>
205
- <a name="l00180"></a><a class="code" href="classPassenger_1_1EOFException.html">00180</a> <span class="keyword">class </span><a class="code" href="classPassenger_1_1EOFException.html" title="An unexpected end-of-file I/O error.">EOFException</a>: <span class="keyword">public</span> <a class="code" href="classPassenger_1_1IOException.html" title="Represents an error that occured during an I/O operation.">IOException</a> {
206
- <a name="l00181"></a>00181 <span class="keyword">public</span>:
207
- <a name="l00182"></a>00182 <a class="code" href="classPassenger_1_1EOFException.html" title="An unexpected end-of-file I/O error.">EOFException</a>(<span class="keyword">const</span> <span class="keywordtype">string</span> &amp;message): <a class="code" href="classPassenger_1_1IOException.html" title="Represents an error that occured during an I/O operation.">IOException</a>(message) {}
208
- <a name="l00183"></a>00183 <span class="keyword">virtual</span> ~<a class="code" href="classPassenger_1_1EOFException.html" title="An unexpected end-of-file I/O error.">EOFException</a>() <span class="keywordflow">throw</span>() {}
209
- <a name="l00184"></a>00184 };
210
- <a name="l00185"></a>00185 <span class="comment"></span>
211
- <a name="l00186"></a>00186 <span class="comment">/**</span>
212
- <a name="l00187"></a>00187 <span class="comment"> * Thrown when an invalid configuration is given.</span>
213
- <a name="l00188"></a>00188 <span class="comment"> */</span>
214
- <a name="l00189"></a><a class="code" href="classPassenger_1_1ConfigurationException.html">00189</a> <span class="keyword">class </span><a class="code" href="classPassenger_1_1ConfigurationException.html" title="Thrown when an invalid configuration is given.">ConfigurationException</a>: <span class="keyword">public</span> oxt::tracable_exception {
215
- <a name="l00190"></a>00190 <span class="keyword">private</span>:
216
- <a name="l00191"></a>00191 <span class="keywordtype">string</span> msg;
217
- <a name="l00192"></a>00192 <span class="keyword">public</span>:
218
- <a name="l00193"></a>00193 <a class="code" href="classPassenger_1_1ConfigurationException.html" title="Thrown when an invalid configuration is given.">ConfigurationException</a>(<span class="keyword">const</span> <span class="keywordtype">string</span> &amp;message): msg(message) {}
219
- <a name="l00194"></a>00194 <span class="keyword">virtual</span> ~<a class="code" href="classPassenger_1_1ConfigurationException.html" title="Thrown when an invalid configuration is given.">ConfigurationException</a>() <span class="keywordflow">throw</span>() {}
220
- <a name="l00195"></a>00195 <span class="keyword">virtual</span> <span class="keyword">const</span> <span class="keywordtype">char</span> *what() <span class="keyword">const</span> <span class="keywordflow">throw</span>() { <span class="keywordflow">return</span> msg.c_str(); }
221
- <a name="l00196"></a>00196 };
222
- <a name="l00197"></a>00197 <span class="comment"></span>
223
- <a name="l00198"></a>00198 <span class="comment">/**</span>
224
- <a name="l00199"></a>00199 <span class="comment"> * Thrown when SpawnManager or ApplicationPool fails to spawn an application</span>
225
- <a name="l00200"></a>00200 <span class="comment"> * instance. The exception may contain an error page, which is a user-friendly</span>
226
- <a name="l00201"></a>00201 <span class="comment"> * HTML page with details about the error.</span>
227
- <a name="l00202"></a>00202 <span class="comment"> */</span>
228
- <a name="l00203"></a><a class="code" href="classPassenger_1_1SpawnException.html">00203</a> <span class="keyword">class </span><a class="code" href="classPassenger_1_1SpawnException.html" title="Thrown when SpawnManager or ApplicationPool fails to spawn an application instance...">SpawnException</a>: <span class="keyword">public</span> oxt::tracable_exception {
229
- <a name="l00204"></a>00204 <span class="keyword">private</span>:
230
- <a name="l00205"></a>00205 <span class="keywordtype">string</span> msg;
231
- <a name="l00206"></a>00206 <span class="keywordtype">bool</span> m_hasErrorPage;
232
- <a name="l00207"></a>00207 <span class="keywordtype">bool</span> m_isHTML;
233
- <a name="l00208"></a>00208 <span class="keywordtype">string</span> m_errorPage;
234
- <a name="l00209"></a>00209 <span class="keyword">public</span>:
235
- <a name="l00210"></a>00210 <a class="code" href="classPassenger_1_1SpawnException.html" title="Thrown when SpawnManager or ApplicationPool fails to spawn an application instance...">SpawnException</a>(<span class="keyword">const</span> <span class="keywordtype">string</span> &amp;message)
236
- <a name="l00211"></a>00211 : msg(message) {
237
- <a name="l00212"></a>00212 m_hasErrorPage = <span class="keyword">false</span>;
238
- <a name="l00213"></a>00213 m_isHTML = <span class="keyword">false</span>;
239
- <a name="l00214"></a>00214 }
240
- <a name="l00215"></a>00215
241
- <a name="l00216"></a>00216 <a class="code" href="classPassenger_1_1SpawnException.html" title="Thrown when SpawnManager or ApplicationPool fails to spawn an application instance...">SpawnException</a>(<span class="keyword">const</span> <span class="keywordtype">string</span> &amp;message, <span class="keyword">const</span> <span class="keywordtype">string</span> &amp;errorPage, <span class="keywordtype">bool</span> <a class="code" href="classPassenger_1_1SpawnException.html#a99538fa117c984660607a7e163ab4158" title="Whether the error page content is HTML.">isHTML</a> = <span class="keyword">true</span>)
242
- <a name="l00217"></a>00217 : msg(message), m_errorPage(errorPage)
243
- <a name="l00218"></a>00218 {
244
- <a name="l00219"></a>00219 m_hasErrorPage = <span class="keyword">true</span>;
245
- <a name="l00220"></a>00220 m_isHTML = <a class="code" href="classPassenger_1_1SpawnException.html#a99538fa117c984660607a7e163ab4158" title="Whether the error page content is HTML.">isHTML</a>;
246
- <a name="l00221"></a>00221 }
247
- <a name="l00222"></a>00222
248
- <a name="l00223"></a>00223 <span class="keyword">virtual</span> ~<a class="code" href="classPassenger_1_1SpawnException.html" title="Thrown when SpawnManager or ApplicationPool fails to spawn an application instance...">SpawnException</a>() <span class="keywordflow">throw</span>() {}
249
- <a name="l00224"></a>00224 <span class="keyword">virtual</span> <span class="keyword">const</span> <span class="keywordtype">char</span> *what() <span class="keyword">const</span> <span class="keywordflow">throw</span>() { <span class="keywordflow">return</span> msg.c_str(); }
250
- <a name="l00225"></a>00225 <span class="comment"></span>
251
- <a name="l00226"></a>00226 <span class="comment"> /**</span>
252
- <a name="l00227"></a>00227 <span class="comment"> * Check whether an error page is available.</span>
253
- <a name="l00228"></a>00228 <span class="comment"> */</span>
254
- <a name="l00229"></a><a class="code" href="classPassenger_1_1SpawnException.html#ae65dc272e183fd9e5637a4091cc6bbf4">00229</a> <span class="keywordtype">bool</span> <a class="code" href="classPassenger_1_1SpawnException.html#ae65dc272e183fd9e5637a4091cc6bbf4" title="Check whether an error page is available.">hasErrorPage</a>()<span class="keyword"> const </span>{
255
- <a name="l00230"></a>00230 <span class="keywordflow">return</span> m_hasErrorPage;
256
- <a name="l00231"></a>00231 }
257
- <a name="l00232"></a>00232 <span class="comment"></span>
258
- <a name="l00233"></a>00233 <span class="comment"> /**</span>
259
- <a name="l00234"></a>00234 <span class="comment"> * Return the error page content.</span>
260
- <a name="l00235"></a>00235 <span class="comment"> *</span>
261
- <a name="l00236"></a>00236 <span class="comment"> * @pre hasErrorPage()</span>
262
- <a name="l00237"></a>00237 <span class="comment"> */</span>
263
- <a name="l00238"></a><a class="code" href="classPassenger_1_1SpawnException.html#a6f675a37edd7070875d0744e7dd010a1">00238</a> <span class="keyword">const</span> <span class="keywordtype">string</span> <a class="code" href="classPassenger_1_1SpawnException.html#a6f675a37edd7070875d0744e7dd010a1" title="Return the error page content.">getErrorPage</a>()<span class="keyword"> const </span>{
264
- <a name="l00239"></a>00239 <span class="keywordflow">return</span> m_errorPage;
265
- <a name="l00240"></a>00240 }
266
- <a name="l00241"></a>00241 <span class="comment"></span>
267
- <a name="l00242"></a>00242 <span class="comment"> /**</span>
268
- <a name="l00243"></a>00243 <span class="comment"> * Whether the error page content is HTML.</span>
269
- <a name="l00244"></a>00244 <span class="comment"> *</span>
270
- <a name="l00245"></a>00245 <span class="comment"> * @pre hasErrorPage()</span>
271
- <a name="l00246"></a>00246 <span class="comment"> */</span>
272
- <a name="l00247"></a><a class="code" href="classPassenger_1_1SpawnException.html#a99538fa117c984660607a7e163ab4158">00247</a> <span class="keywordtype">bool</span> <a class="code" href="classPassenger_1_1SpawnException.html#a99538fa117c984660607a7e163ab4158" title="Whether the error page content is HTML.">isHTML</a>()<span class="keyword"> const </span>{
273
- <a name="l00248"></a>00248 <span class="keywordflow">return</span> m_isHTML;
274
- <a name="l00249"></a>00249 }
275
- <a name="l00250"></a>00250 };
276
- <a name="l00251"></a>00251 <span class="comment"></span>
277
- <a name="l00252"></a>00252 <span class="comment">/**</span>
278
- <a name="l00253"></a>00253 <span class="comment"> * Indicates that a specified argument is incorrect or violates a requirement.</span>
279
- <a name="l00254"></a>00254 <span class="comment"> *</span>
280
- <a name="l00255"></a>00255 <span class="comment"> * @ingroup Exceptions</span>
281
- <a name="l00256"></a>00256 <span class="comment"> */</span>
282
- <a name="l00257"></a><a class="code" href="classPassenger_1_1ArgumentException.html">00257</a> <span class="keyword">class </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="keyword">public</span> oxt::tracable_exception {
283
- <a name="l00258"></a>00258 <span class="keyword">private</span>:
284
- <a name="l00259"></a>00259 <span class="keywordtype">string</span> msg;
285
- <a name="l00260"></a>00260 <span class="keyword">public</span>:
286
- <a name="l00261"></a>00261 <a class="code" href="classPassenger_1_1ArgumentException.html" title="Indicates that a specified argument is incorrect or violates a requirement.">ArgumentException</a>(<span class="keyword">const</span> <span class="keywordtype">string</span> &amp;message): msg(message) {}
287
- <a name="l00262"></a>00262 <span class="keyword">virtual</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="keywordflow">throw</span>() {}
288
- <a name="l00263"></a>00263 <span class="keyword">virtual</span> <span class="keyword">const</span> <span class="keywordtype">char</span> *what() <span class="keyword">const</span> <span class="keywordflow">throw</span>() { <span class="keywordflow">return</span> msg.c_str(); }
289
- <a name="l00264"></a>00264 };
290
- <a name="l00265"></a>00265
291
- <a name="l00266"></a>00266 <span class="comment">/*</span>
292
- <a name="l00267"></a>00267 <span class="comment"> * @ingroup Exceptions</span>
293
- <a name="l00268"></a>00268 <span class="comment"> */</span>
294
- <a name="l00269"></a>00269 <span class="keyword">class </span>InvalidModeStringException: <span class="keyword">public</span> <a class="code" href="classPassenger_1_1ArgumentException.html" title="Indicates that a specified argument is incorrect or violates a requirement.">ArgumentException</a> {
295
- <a name="l00270"></a>00270 <span class="keyword">public</span>:
296
- <a name="l00271"></a>00271 InvalidModeStringException(<span class="keyword">const</span> <span class="keywordtype">string</span> &amp;message): <a class="code" href="classPassenger_1_1ArgumentException.html" title="Indicates that a specified argument is incorrect or violates a requirement.">ArgumentException</a>(message) {}
297
- <a name="l00272"></a>00272 };
298
- <a name="l00273"></a>00273 <span class="comment"></span>
299
- <a name="l00274"></a>00274 <span class="comment">/**</span>
300
- <a name="l00275"></a>00275 <span class="comment"> * A generic runtime exception.</span>
301
- <a name="l00276"></a>00276 <span class="comment"> *</span>
302
- <a name="l00277"></a>00277 <span class="comment"> * @ingroup Exceptions</span>
303
- <a name="l00278"></a>00278 <span class="comment"> */</span>
304
- <a name="l00279"></a><a class="code" href="classPassenger_1_1RuntimeException.html">00279</a> <span class="keyword">class </span><a class="code" href="classPassenger_1_1RuntimeException.html" title="A generic runtime exception.">RuntimeException</a>: <span class="keyword">public</span> oxt::tracable_exception {
305
- <a name="l00280"></a>00280 <span class="keyword">private</span>:
306
- <a name="l00281"></a>00281 <span class="keywordtype">string</span> msg;
307
- <a name="l00282"></a>00282 <span class="keyword">public</span>:
308
- <a name="l00283"></a>00283 <a class="code" href="classPassenger_1_1RuntimeException.html" title="A generic runtime exception.">RuntimeException</a>(<span class="keyword">const</span> <span class="keywordtype">string</span> &amp;message): msg(message) {}
309
- <a name="l00284"></a>00284 <span class="keyword">virtual</span> ~<a class="code" href="classPassenger_1_1RuntimeException.html" title="A generic runtime exception.">RuntimeException</a>() <span class="keywordflow">throw</span>() {}
310
- <a name="l00285"></a>00285 <span class="keyword">virtual</span> <span class="keyword">const</span> <span class="keywordtype">char</span> *what() <span class="keyword">const</span> <span class="keywordflow">throw</span>() { <span class="keywordflow">return</span> msg.c_str(); }
311
- <a name="l00286"></a>00286 };
312
- <a name="l00287"></a>00287 <span class="comment"></span>
313
- <a name="l00288"></a>00288 <span class="comment">/**</span>
314
- <a name="l00289"></a>00289 <span class="comment"> * An exception indicating that some timeout expired.</span>
315
- <a name="l00290"></a>00290 <span class="comment"> *</span>
316
- <a name="l00291"></a>00291 <span class="comment"> * @ingroup Exceptions</span>
317
- <a name="l00292"></a>00292 <span class="comment"> */</span>
318
- <a name="l00293"></a><a class="code" href="classPassenger_1_1TimeoutException.html">00293</a> <span class="keyword">class </span><a class="code" href="classPassenger_1_1TimeoutException.html" title="An exception indicating that some timeout expired.">TimeoutException</a>: <span class="keyword">public</span> oxt::tracable_exception {
319
- <a name="l00294"></a>00294 <span class="keyword">private</span>:
320
- <a name="l00295"></a>00295 <span class="keywordtype">string</span> msg;
321
- <a name="l00296"></a>00296 <span class="keyword">public</span>:
322
- <a name="l00297"></a>00297 <a class="code" href="classPassenger_1_1TimeoutException.html" title="An exception indicating that some timeout expired.">TimeoutException</a>(<span class="keyword">const</span> <span class="keywordtype">string</span> &amp;message): msg(message) {}
323
- <a name="l00298"></a>00298 <span class="keyword">virtual</span> ~<a class="code" href="classPassenger_1_1TimeoutException.html" title="An exception indicating that some timeout expired.">TimeoutException</a>() <span class="keywordflow">throw</span>() {}
324
- <a name="l00299"></a>00299 <span class="keyword">virtual</span> <span class="keyword">const</span> <span class="keywordtype">char</span> *what() <span class="keyword">const</span> <span class="keywordflow">throw</span>() { <span class="keywordflow">return</span> msg.c_str(); }
325
- <a name="l00300"></a>00300 };
326
- <a name="l00301"></a>00301 <span class="comment"></span>
327
- <a name="l00302"></a>00302 <span class="comment">/**</span>
328
- <a name="l00303"></a>00303 <span class="comment"> * Represents some kind of security error.</span>
329
- <a name="l00304"></a>00304 <span class="comment"> *</span>
330
- <a name="l00305"></a>00305 <span class="comment"> * @ingroup Exceptions</span>
331
- <a name="l00306"></a>00306 <span class="comment"> */</span>
332
- <a name="l00307"></a><a class="code" href="classPassenger_1_1SecurityException.html">00307</a> <span class="keyword">class </span><a class="code" href="classPassenger_1_1SecurityException.html" title="Represents some kind of security error.">SecurityException</a>: <span class="keyword">public</span> oxt::tracable_exception {
333
- <a name="l00308"></a>00308 <span class="keyword">private</span>:
334
- <a name="l00309"></a>00309 <span class="keywordtype">string</span> msg;
335
- <a name="l00310"></a>00310 <span class="keyword">public</span>:
336
- <a name="l00311"></a>00311 <a class="code" href="classPassenger_1_1SecurityException.html" title="Represents some kind of security error.">SecurityException</a>(<span class="keyword">const</span> <span class="keywordtype">string</span> &amp;message): msg(message) {}
337
- <a name="l00312"></a>00312 <span class="keyword">virtual</span> ~<a class="code" href="classPassenger_1_1SecurityException.html" title="Represents some kind of security error.">SecurityException</a>() <span class="keywordflow">throw</span>() {}
338
- <a name="l00313"></a>00313 <span class="keyword">virtual</span> <span class="keyword">const</span> <span class="keywordtype">char</span> *what() <span class="keyword">const</span> <span class="keywordflow">throw</span>() { <span class="keywordflow">return</span> msg.c_str(); }
339
- <a name="l00314"></a>00314 };
340
- <a name="l00315"></a>00315 <span class="comment"></span>
341
- <a name="l00316"></a>00316 <span class="comment">/**</span>
342
- <a name="l00317"></a>00317 <span class="comment"> * @ingroup Exceptions</span>
343
- <a name="l00318"></a>00318 <span class="comment"> */</span>
344
- <a name="l00319"></a>00319 <span class="keyword">class </span>NonExistentUserException: <span class="keyword">public</span> <a class="code" href="classPassenger_1_1SecurityException.html" title="Represents some kind of security error.">SecurityException</a> {
345
- <a name="l00320"></a>00320 <span class="keyword">public</span>:
346
- <a name="l00321"></a>00321 NonExistentUserException(<span class="keyword">const</span> <span class="keywordtype">string</span> &amp;message): <a class="code" href="classPassenger_1_1SecurityException.html" title="Represents some kind of security error.">SecurityException</a>(message) {}
347
- <a name="l00322"></a>00322 };
348
- <a name="l00323"></a>00323 <span class="comment"></span>
349
- <a name="l00324"></a>00324 <span class="comment">/**</span>
350
- <a name="l00325"></a>00325 <span class="comment"> * @ingroup Exceptions</span>
351
- <a name="l00326"></a>00326 <span class="comment"> */</span>
352
- <a name="l00327"></a>00327 <span class="keyword">class </span>NonExistentGroupException: <span class="keyword">public</span> SecurityException {
353
- <a name="l00328"></a>00328 <span class="keyword">public</span>:
354
- <a name="l00329"></a>00329 NonExistentGroupException(<span class="keyword">const</span> <span class="keywordtype">string</span> &amp;message): SecurityException(message) {}
355
- <a name="l00330"></a>00330 };
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"> * The application pool is too busy and cannot fulfill a get() request.</span>
359
- <a name="l00334"></a>00334 <span class="comment"> *</span>
360
- <a name="l00335"></a>00335 <span class="comment"> * @ingroup Exceptions</span>
361
- <a name="l00336"></a>00336 <span class="comment"> */</span>
362
- <a name="l00337"></a><a class="code" href="classPassenger_1_1BusyException.html">00337</a> <span class="keyword">class </span><a class="code" href="classPassenger_1_1BusyException.html" title="The application pool is too busy and cannot fulfill a get() request.">BusyException</a>: <span class="keyword">public</span> oxt::tracable_exception {
363
- <a name="l00338"></a>00338 <span class="keyword">private</span>:
364
- <a name="l00339"></a>00339 <span class="keywordtype">string</span> msg;
365
- <a name="l00340"></a>00340 <span class="keyword">public</span>:
366
- <a name="l00341"></a>00341 <a class="code" href="classPassenger_1_1BusyException.html" title="The application pool is too busy and cannot fulfill a get() request.">BusyException</a>(<span class="keyword">const</span> <span class="keywordtype">string</span> &amp;message): msg(message) {}
367
- <a name="l00342"></a>00342 <span class="keyword">virtual</span> ~<a class="code" href="classPassenger_1_1BusyException.html" title="The application pool is too busy and cannot fulfill a get() request.">BusyException</a>() <span class="keywordflow">throw</span>() {}
368
- <a name="l00343"></a>00343 <span class="keyword">virtual</span> <span class="keyword">const</span> <span class="keywordtype">char</span> *what() <span class="keyword">const</span> <span class="keywordflow">throw</span>() { <span class="keywordflow">return</span> msg.c_str(); }
369
- <a name="l00344"></a>00344 };
370
- <a name="l00345"></a>00345 <span class="comment"></span>
371
- <a name="l00346"></a>00346 <span class="comment">/**</span>
372
- <a name="l00347"></a>00347 <span class="comment"> * A parser detected a syntax error.</span>
373
- <a name="l00348"></a>00348 <span class="comment"> *</span>
374
- <a name="l00349"></a>00349 <span class="comment"> * @ingroup Exceptions</span>
375
- <a name="l00350"></a>00350 <span class="comment"> */</span>
376
- <a name="l00351"></a><a class="code" href="classPassenger_1_1SyntaxError.html">00351</a> <span class="keyword">class </span><a class="code" href="classPassenger_1_1SyntaxError.html" title="A parser detected a syntax error.">SyntaxError</a>: <span class="keyword">public</span> oxt::tracable_exception {
377
- <a name="l00352"></a>00352 <span class="keyword">private</span>:
378
- <a name="l00353"></a>00353 <span class="keywordtype">string</span> msg;
379
- <a name="l00354"></a>00354 <span class="keyword">public</span>:
380
- <a name="l00355"></a>00355 <a class="code" href="classPassenger_1_1SyntaxError.html" title="A parser detected a syntax error.">SyntaxError</a>(<span class="keyword">const</span> <span class="keywordtype">string</span> &amp;message): msg(message) {}
381
- <a name="l00356"></a>00356 <span class="keyword">virtual</span> ~<a class="code" href="classPassenger_1_1SyntaxError.html" title="A parser detected a syntax error.">SyntaxError</a>() <span class="keywordflow">throw</span>() {}
382
- <a name="l00357"></a>00357 <span class="keyword">virtual</span> <span class="keyword">const</span> <span class="keywordtype">char</span> *what() <span class="keyword">const</span> <span class="keywordflow">throw</span>() { <span class="keywordflow">return</span> msg.c_str(); }
383
- <a name="l00358"></a>00358 };
384
- <a name="l00359"></a>00359
385
- <a name="l00360"></a>00360 } <span class="comment">// namespace Passenger</span>
386
- <a name="l00361"></a>00361
387
- <a name="l00362"></a>00362 <span class="preprocessor">#endif </span><span class="comment">/* _PASSENGER_EXCEPTIONS_H_ */</span>
388
- </pre></div></div>
389
- <hr size="1"/><address style="text-align: right;"><small>Generated by&nbsp;
390
- <a href="http://www.doxygen.org/index.html">
391
- <img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.6.2 </small></address>
392
- </body>
393
- </html>
data/doc/cxxapi/FileDescriptor_8h_source.html DELETED
@@ -1,324 +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: FileDescriptor.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>FileDescriptor.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_FILE_DESCRIPTOR_H_</span>
51
- <a name="l00026"></a>00026 <span class="preprocessor"></span><span class="preprocessor">#define _PASSENGER_FILE_DESCRIPTOR_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/make_shared.hpp&gt;</span>
55
- <a name="l00030"></a>00030 <span class="preprocessor">#include &lt;oxt/system_calls.hpp&gt;</span>
56
- <a name="l00031"></a>00031
57
- <a name="l00032"></a>00032 <span class="preprocessor">#include &lt;utility&gt;</span>
58
- <a name="l00033"></a>00033 <span class="preprocessor">#include &lt;unistd.h&gt;</span>
59
- <a name="l00034"></a>00034 <span class="preprocessor">#include &lt;cerrno&gt;</span>
60
- <a name="l00035"></a>00035
61
- <a name="l00036"></a>00036 <span class="preprocessor">#include &lt;Exceptions.h&gt;</span>
62
- <a name="l00037"></a>00037
63
- <a name="l00038"></a>00038 <span class="keyword">namespace </span>Passenger {
64
- <a name="l00039"></a>00039
65
- <a name="l00040"></a>00040 <span class="keyword">using namespace </span>std;
66
- <a name="l00041"></a>00041 <span class="keyword">using namespace </span>boost;
67
- <a name="l00042"></a>00042 <span class="keyword">using namespace </span>oxt;
68
- <a name="l00043"></a>00043
69
- <a name="l00044"></a>00044
70
- <a name="l00045"></a>00045 <span class="keywordtype">void</span> safelyClose(<span class="keywordtype">int</span> fd);
71
- <a name="l00046"></a>00046
72
- <a name="l00047"></a>00047 <span class="comment"></span>
73
- <a name="l00048"></a>00048 <span class="comment">/**</span>
74
- <a name="l00049"></a>00049 <span class="comment"> * Wrapper class around a file descriptor integer, for RAII behavior.</span>
75
- <a name="l00050"></a>00050 <span class="comment"> *</span>
76
- <a name="l00051"></a>00051 <span class="comment"> * A FileDescriptor object behaves just like an int, so that you can pass it to</span>
77
- <a name="l00052"></a>00052 <span class="comment"> * system calls such as read(). It performs reference counting. When the last</span>
78
- <a name="l00053"></a>00053 <span class="comment"> * copy of a FileDescriptor has been destroyed, the underlying file descriptor</span>
79
- <a name="l00054"></a>00054 <span class="comment"> * will be automatically closed. In this case, any close() system call errors</span>
80
- <a name="l00055"></a>00055 <span class="comment"> * are silently ignored. If you are interested in whether the close() system</span>
81
- <a name="l00056"></a>00056 <span class="comment"> * call succeeded, then you should call FileDescriptor::close().</span>
82
- <a name="l00057"></a>00057 <span class="comment"> *</span>
83
- <a name="l00058"></a>00058 <span class="comment"> * This class is *not* thread-safe. It is safe to call system calls on the</span>
84
- <a name="l00059"></a>00059 <span class="comment"> * underlying file descriptor from multiple threads, but it&#39;s not safe to</span>
85
- <a name="l00060"></a>00060 <span class="comment"> * call FileDescriptor::close() from multiple threads if all those</span>
86
- <a name="l00061"></a>00061 <span class="comment"> * FileDescriptor objects point to the same underlying file descriptor.</span>
87
- <a name="l00062"></a>00062 <span class="comment"> */</span>
88
- <a name="l00063"></a><a class="code" href="classPassenger_1_1FileDescriptor.html">00063</a> <span class="keyword">class </span><a class="code" href="classPassenger_1_1FileDescriptor.html" title="Wrapper class around a file descriptor integer, for RAII behavior.">FileDescriptor</a> {
89
- <a name="l00064"></a>00064 <span class="keyword">private</span>:
90
- <a name="l00065"></a>00065 <span class="keyword">struct </span>SharedData {
91
- <a name="l00066"></a>00066 <span class="keywordtype">int</span> fd;
92
- <a name="l00067"></a>00067
93
- <a name="l00068"></a>00068 SharedData(<span class="keywordtype">int</span> fd) {
94
- <a name="l00069"></a>00069 this-&gt;fd = fd;
95
- <a name="l00070"></a>00070 }
96
- <a name="l00071"></a>00071
97
- <a name="l00072"></a>00072 ~SharedData() {
98
- <a name="l00073"></a>00073 <span class="keywordflow">if</span> (fd &gt;= 0) {
99
- <a name="l00074"></a>00074 this_thread::disable_syscall_interruption dsi;
100
- <a name="l00075"></a>00075 <a class="code" href="classPassenger_1_1FileDescriptor.html#a02062f3cfb689b32781e11114c0abe5b" title="Close the underlying file descriptor.">syscalls::close</a>(fd);
101
- <a name="l00076"></a>00076 }
102
- <a name="l00077"></a>00077 }
103
- <a name="l00078"></a>00078
104
- <a name="l00079"></a>00079 <span class="keywordtype">void</span> <a class="code" href="classPassenger_1_1FileDescriptor.html#a02062f3cfb689b32781e11114c0abe5b" title="Close the underlying file descriptor.">close</a>(<span class="keywordtype">bool</span> checkErrors = <span class="keyword">true</span>) {
105
- <a name="l00080"></a>00080 <span class="keywordflow">if</span> (fd &gt;= 0) {
106
- <a name="l00081"></a>00081 this_thread::disable_syscall_interruption dsi;
107
- <a name="l00082"></a>00082 <span class="keywordtype">int</span> theFd = fd;
108
- <a name="l00083"></a>00083 fd = -1;
109
- <a name="l00084"></a>00084 <span class="keywordflow">if</span> (checkErrors) {
110
- <a name="l00085"></a>00085 safelyClose(theFd);
111
- <a name="l00086"></a>00086 } <span class="keywordflow">else</span> {
112
- <a name="l00087"></a>00087 <a class="code" href="classPassenger_1_1FileDescriptor.html#a02062f3cfb689b32781e11114c0abe5b" title="Close the underlying file descriptor.">syscalls::close</a>(fd);
113
- <a name="l00088"></a>00088 }
114
- <a name="l00089"></a>00089 }
115
- <a name="l00090"></a>00090 }
116
- <a name="l00091"></a>00091
117
- <a name="l00092"></a>00092 <span class="keywordtype">void</span> <a class="code" href="classPassenger_1_1FileDescriptor.html#ad9f7acde3003ab0730bc248948a63777" title="Detach from the underlying file descriptor without closing it.">detach</a>() {
118
- <a name="l00093"></a>00093 fd = -1;
119
- <a name="l00094"></a>00094 }
120
- <a name="l00095"></a>00095 };
121
- <a name="l00096"></a>00096 <span class="comment"></span>
122
- <a name="l00097"></a>00097 <span class="comment"> /** Shared pointer for reference counting on this file descriptor */</span>
123
- <a name="l00098"></a>00098 shared_ptr&lt;SharedData&gt; data;
124
- <a name="l00099"></a>00099
125
- <a name="l00100"></a>00100 <span class="keyword">public</span>:<span class="comment"></span>
126
- <a name="l00101"></a>00101 <span class="comment"> /** </span>
127
- <a name="l00102"></a>00102 <span class="comment"> * Creates a new empty FileDescriptor instance that has no underlying</span>
128
- <a name="l00103"></a>00103 <span class="comment"> * file descriptor.</span>
129
- <a name="l00104"></a>00104 <span class="comment"> *</span>
130
- <a name="l00105"></a>00105 <span class="comment"> * @post *this == -1</span>
131
- <a name="l00106"></a>00106 <span class="comment"> */</span>
132
- <a name="l00107"></a><a class="code" href="classPassenger_1_1FileDescriptor.html#a05d83ad9cc77c493a3ce4f2b51d44559">00107</a> <a class="code" href="classPassenger_1_1FileDescriptor.html#a05d83ad9cc77c493a3ce4f2b51d44559" title="Creates a new empty FileDescriptor instance that has no underlying file descriptor...">FileDescriptor</a>() { }
133
- <a name="l00108"></a>00108 <span class="comment"></span>
134
- <a name="l00109"></a>00109 <span class="comment"> /**</span>
135
- <a name="l00110"></a>00110 <span class="comment"> * Creates a new FileDescriptor instance with the given fd as a handle.</span>
136
- <a name="l00111"></a>00111 <span class="comment"> *</span>
137
- <a name="l00112"></a>00112 <span class="comment"> * @post *this == fd</span>
138
- <a name="l00113"></a>00113 <span class="comment"> */</span>
139
- <a name="l00114"></a><a class="code" href="classPassenger_1_1FileDescriptor.html#a62c05b925cb1cf964169cef7635650ee">00114</a> <a class="code" href="classPassenger_1_1FileDescriptor.html#a62c05b925cb1cf964169cef7635650ee" title="Creates a new FileDescriptor instance with the given fd as a handle.">FileDescriptor</a>(<span class="keywordtype">int</span> fd) {
140
- <a name="l00115"></a>00115 <span class="keywordflow">if</span> (fd &gt;= 0) {
141
- <a name="l00116"></a>00116 <span class="comment">/* Make sure that the &#39;new&#39; operator doesn&#39;t overwrite</span>
142
- <a name="l00117"></a>00117 <span class="comment"> * errno so that we can write code like this:</span>
143
- <a name="l00118"></a>00118 <span class="comment"> *</span>
144
- <a name="l00119"></a>00119 <span class="comment"> * FileDescriptor fd = open(...);</span>
145
- <a name="l00120"></a>00120 <span class="comment"> * if (fd == -1) {</span>
146
- <a name="l00121"></a>00121 <span class="comment"> * print_error(errno);</span>
147
- <a name="l00122"></a>00122 <span class="comment"> * }</span>
148
- <a name="l00123"></a>00123 <span class="comment"> */</span>
149
- <a name="l00124"></a>00124 <span class="keywordtype">int</span> e = errno;
150
- <a name="l00125"></a>00125 data = make_shared&lt;SharedData&gt;(fd);
151
- <a name="l00126"></a>00126 errno = e;
152
- <a name="l00127"></a>00127 }
153
- <a name="l00128"></a>00128 }
154
- <a name="l00129"></a>00129 <span class="comment"></span>
155
- <a name="l00130"></a>00130 <span class="comment"> /**</span>
156
- <a name="l00131"></a>00131 <span class="comment"> * Close the underlying file descriptor. If it was already closed, then</span>
157
- <a name="l00132"></a>00132 <span class="comment"> * nothing will happen. If there are multiple copies of this FileDescriptor</span>
158
- <a name="l00133"></a>00133 <span class="comment"> * then the underlying file descriptor will be closed for every one of them.</span>
159
- <a name="l00134"></a>00134 <span class="comment"> *</span>
160
- <a name="l00135"></a>00135 <span class="comment"> * @params checkErrors Whether a SystemException should be thrown in case</span>
161
- <a name="l00136"></a>00136 <span class="comment"> * closing the file descriptor fails. If false, errors</span>
162
- <a name="l00137"></a>00137 <span class="comment"> * are silently ignored.</span>
163
- <a name="l00138"></a>00138 <span class="comment"> * @throws SystemException Something went wrong while closing</span>
164
- <a name="l00139"></a>00139 <span class="comment"> * the file descriptor. Only thrown if</span>
165
- <a name="l00140"></a>00140 <span class="comment"> * checkErrors is true.</span>
166
- <a name="l00141"></a>00141 <span class="comment"> * @post *this == -1</span>
167
- <a name="l00142"></a>00142 <span class="comment"> */</span>
168
- <a name="l00143"></a><a class="code" href="classPassenger_1_1FileDescriptor.html#a02062f3cfb689b32781e11114c0abe5b">00143</a> <span class="keywordtype">void</span> <a class="code" href="classPassenger_1_1FileDescriptor.html#a02062f3cfb689b32781e11114c0abe5b" title="Close the underlying file descriptor.">close</a>(<span class="keywordtype">bool</span> checkErrors = <span class="keyword">true</span>) {
169
- <a name="l00144"></a>00144 <span class="keywordflow">if</span> (data != NULL) {
170
- <a name="l00145"></a>00145 data-&gt;close(checkErrors);
171
- <a name="l00146"></a>00146 data.reset();
172
- <a name="l00147"></a>00147 }
173
- <a name="l00148"></a>00148 }
174
- <a name="l00149"></a>00149 <span class="comment"></span>
175
- <a name="l00150"></a>00150 <span class="comment"> /**</span>
176
- <a name="l00151"></a>00151 <span class="comment"> * Detach from the underlying file descriptor without closing it.</span>
177
- <a name="l00152"></a>00152 <span class="comment"> * This FileDescriptor and all copies will no longer affect the</span>
178
- <a name="l00153"></a>00153 <span class="comment"> * underlying file descriptors.</span>
179
- <a name="l00154"></a>00154 <span class="comment"> *</span>
180
- <a name="l00155"></a>00155 <span class="comment"> * @return The underlying file descriptor, or -1 if already closed.</span>
181
- <a name="l00156"></a>00156 <span class="comment"> * @post *this == -1</span>
182
- <a name="l00157"></a>00157 <span class="comment"> */</span>
183
- <a name="l00158"></a><a class="code" href="classPassenger_1_1FileDescriptor.html#ad9f7acde3003ab0730bc248948a63777">00158</a> <span class="keywordtype">int</span> <a class="code" href="classPassenger_1_1FileDescriptor.html#ad9f7acde3003ab0730bc248948a63777" title="Detach from the underlying file descriptor without closing it.">detach</a>() {
184
- <a name="l00159"></a>00159 <span class="keywordflow">if</span> (data != NULL) {
185
- <a name="l00160"></a>00160 <span class="keywordtype">int</span> fd = data-&gt;fd;
186
- <a name="l00161"></a>00161 data-&gt;detach();
187
- <a name="l00162"></a>00162 data.reset();
188
- <a name="l00163"></a>00163 <span class="keywordflow">return</span> fd;
189
- <a name="l00164"></a>00164 } <span class="keywordflow">else</span> {
190
- <a name="l00165"></a>00165 <span class="keywordflow">return</span> -1;
191
- <a name="l00166"></a>00166 }
192
- <a name="l00167"></a>00167 }
193
- <a name="l00168"></a>00168 <span class="comment"></span>
194
- <a name="l00169"></a>00169 <span class="comment"> /**</span>
195
- <a name="l00170"></a>00170 <span class="comment"> * Overloads the integer cast operator so that it will return the underlying</span>
196
- <a name="l00171"></a>00171 <span class="comment"> * file descriptor handle as an integer.</span>
197
- <a name="l00172"></a>00172 <span class="comment"> *</span>
198
- <a name="l00173"></a>00173 <span class="comment"> * Returns -1 if FileDescriptor::close() was called.</span>
199
- <a name="l00174"></a>00174 <span class="comment"> */</span>
200
- <a name="l00175"></a><a class="code" href="classPassenger_1_1FileDescriptor.html#ac335c2a97f3a6c8e3920f573b0d04081">00175</a> <a class="code" href="classPassenger_1_1FileDescriptor.html#ac335c2a97f3a6c8e3920f573b0d04081" title="Overloads the integer cast operator so that it will return the underlying file descriptor...">operator int </a>()<span class="keyword"> const </span>{
201
- <a name="l00176"></a>00176 <span class="keywordflow">if</span> (data == NULL) {
202
- <a name="l00177"></a>00177 <span class="keywordflow">return</span> -1;
203
- <a name="l00178"></a>00178 } <span class="keywordflow">else</span> {
204
- <a name="l00179"></a>00179 <span class="keywordflow">return</span> data-&gt;fd;
205
- <a name="l00180"></a>00180 }
206
- <a name="l00181"></a>00181 }
207
- <a name="l00182"></a>00182
208
- <a name="l00183"></a>00183 <a class="code" href="classPassenger_1_1FileDescriptor.html" title="Wrapper class around a file descriptor integer, for RAII behavior.">FileDescriptor</a> &amp;operator=(<span class="keywordtype">int</span> fd) {
209
- <a name="l00184"></a>00184 <span class="comment">/* Make sure that the &#39;new&#39; and &#39;delete&#39; operators don&#39;t</span>
210
- <a name="l00185"></a>00185 <span class="comment"> * overwrite errno so that we can write code like this:</span>
211
- <a name="l00186"></a>00186 <span class="comment"> *</span>
212
- <a name="l00187"></a>00187 <span class="comment"> * FileDescriptor fd;</span>
213
- <a name="l00188"></a>00188 <span class="comment"> * fd = open(...);</span>
214
- <a name="l00189"></a>00189 <span class="comment"> * if (fd == -1) {</span>
215
- <a name="l00190"></a>00190 <span class="comment"> * print_error(errno);</span>
216
- <a name="l00191"></a>00191 <span class="comment"> * }</span>
217
- <a name="l00192"></a>00192 <span class="comment"> */</span>
218
- <a name="l00193"></a>00193 <span class="keywordtype">int</span> e = errno;
219
- <a name="l00194"></a>00194 <span class="keywordflow">if</span> (fd &gt;= 0) {
220
- <a name="l00195"></a>00195 data = make_shared&lt;SharedData&gt;(fd);
221
- <a name="l00196"></a>00196 } <span class="keywordflow">else</span> {
222
- <a name="l00197"></a>00197 data.reset();
223
- <a name="l00198"></a>00198 }
224
- <a name="l00199"></a>00199 errno = e;
225
- <a name="l00200"></a>00200 <span class="keywordflow">return</span> *<span class="keyword">this</span>;
226
- <a name="l00201"></a>00201 }
227
- <a name="l00202"></a>00202
228
- <a name="l00203"></a>00203 <a class="code" href="classPassenger_1_1FileDescriptor.html#a05d83ad9cc77c493a3ce4f2b51d44559" title="Creates a new empty FileDescriptor instance that has no underlying file descriptor...">FileDescriptor</a> &amp;operator=(<span class="keyword">const</span> <a class="code" href="classPassenger_1_1FileDescriptor.html#a05d83ad9cc77c493a3ce4f2b51d44559" title="Creates a new empty FileDescriptor instance that has no underlying file descriptor...">FileDescriptor</a> &amp;other) {
229
- <a name="l00204"></a>00204 <span class="comment">/* Make sure that the &#39;delete&#39; operator implicitly invoked by</span>
230
- <a name="l00205"></a>00205 <span class="comment"> * shared_ptr doesn&#39;t overwrite errno so that we can write code</span>
231
- <a name="l00206"></a>00206 <span class="comment"> * like this:</span>
232
- <a name="l00207"></a>00207 <span class="comment"> *</span>
233
- <a name="l00208"></a>00208 <span class="comment"> * FileDescriptor fd;</span>
234
- <a name="l00209"></a>00209 <span class="comment"> * fd = other_file_descriptor_object;</span>
235
- <a name="l00210"></a>00210 <span class="comment"> * if (fd == -1) {</span>
236
- <a name="l00211"></a>00211 <span class="comment"> * print_error(errno);</span>
237
- <a name="l00212"></a>00212 <span class="comment"> * }</span>
238
- <a name="l00213"></a>00213 <span class="comment"> */</span>
239
- <a name="l00214"></a>00214 <span class="keywordtype">int</span> e = errno;
240
- <a name="l00215"></a>00215 data = other.data;
241
- <a name="l00216"></a>00216 errno = e;
242
- <a name="l00217"></a>00217 <span class="keywordflow">return</span> *<span class="keyword">this</span>;
243
- <a name="l00218"></a>00218 }
244
- <a name="l00219"></a>00219 };
245
- <a name="l00220"></a>00220 <span class="comment"></span>
246
- <a name="l00221"></a>00221 <span class="comment">/**</span>
247
- <a name="l00222"></a>00222 <span class="comment"> * A structure containing two FileDescriptor objects. Behaves like a pair</span>
248
- <a name="l00223"></a>00223 <span class="comment"> * and like a two-element array.</span>
249
- <a name="l00224"></a>00224 <span class="comment"> */</span>
250
- <a name="l00225"></a><a class="code" href="classPassenger_1_1FileDescriptorPair.html">00225</a> <span class="keyword">class </span><a class="code" href="classPassenger_1_1FileDescriptorPair.html" title="A structure containing two FileDescriptor objects.">FileDescriptorPair</a>: <span class="keyword">public</span> pair&lt;FileDescriptor, FileDescriptor&gt; {
251
- <a name="l00226"></a>00226 <span class="keyword">public</span>:
252
- <a name="l00227"></a>00227 <a class="code" href="classPassenger_1_1FileDescriptorPair.html" title="A structure containing two FileDescriptor objects.">FileDescriptorPair</a>() { }
253
- <a name="l00228"></a>00228
254
- <a name="l00229"></a>00229 <a class="code" href="classPassenger_1_1FileDescriptorPair.html" title="A structure containing two FileDescriptor objects.">FileDescriptorPair</a>(<span class="keyword">const</span> <a class="code" href="classPassenger_1_1FileDescriptor.html" title="Wrapper class around a file descriptor integer, for RAII behavior.">FileDescriptor</a> &amp;a, <span class="keyword">const</span> <a class="code" href="classPassenger_1_1FileDescriptor.html" title="Wrapper class around a file descriptor integer, for RAII behavior.">FileDescriptor</a> &amp;b)
255
- <a name="l00230"></a>00230 : pair&lt;FileDescriptor, FileDescriptor&gt;(a, b)
256
- <a name="l00231"></a>00231 { }
257
- <a name="l00232"></a>00232
258
- <a name="l00233"></a>00233 <a class="code" href="classPassenger_1_1FileDescriptor.html" title="Wrapper class around a file descriptor integer, for RAII behavior.">FileDescriptor</a> &amp;operator[](<span class="keywordtype">int</span> index) {
259
- <a name="l00234"></a>00234 <span class="keywordflow">if</span> (index == 0) {
260
- <a name="l00235"></a>00235 <span class="keywordflow">return</span> first;
261
- <a name="l00236"></a>00236 } <span class="keywordflow">else</span> <span class="keywordflow">if</span> (index == 1) {
262
- <a name="l00237"></a>00237 <span class="keywordflow">return</span> second;
263
- <a name="l00238"></a>00238 } <span class="keywordflow">else</span> {
264
- <a name="l00239"></a>00239 <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">&quot;Index must be either 0 of 1&quot;</span>);
265
- <a name="l00240"></a>00240 }
266
- <a name="l00241"></a>00241 }
267
- <a name="l00242"></a>00242 };
268
- <a name="l00243"></a>00243
269
- <a name="l00244"></a>00244 <span class="comment">// Convenience aliases.</span>
270
- <a name="l00245"></a>00245 <span class="keyword">typedef</span> <a class="code" href="classPassenger_1_1FileDescriptorPair.html" title="A structure containing two FileDescriptor objects.">FileDescriptorPair</a> <a class="code" href="classPassenger_1_1FileDescriptorPair.html" title="A structure containing two FileDescriptor objects.">Pipe</a>;
271
- <a name="l00246"></a>00246 <span class="keyword">typedef</span> <a class="code" href="classPassenger_1_1FileDescriptorPair.html" title="A structure containing two FileDescriptor objects.">FileDescriptorPair</a> <a class="code" href="classPassenger_1_1FileDescriptorPair.html" title="A structure containing two FileDescriptor objects.">SocketPair</a>;
272
- <a name="l00247"></a>00247 <span class="comment"></span>
273
- <a name="l00248"></a>00248 <span class="comment">/**</span>
274
- <a name="l00249"></a>00249 <span class="comment"> * A synchronization mechanism that&#39;s implemented with file descriptors,</span>
275
- <a name="l00250"></a>00250 <span class="comment"> * and as such can be used in combination with select() and friends.</span>
276
- <a name="l00251"></a>00251 <span class="comment"> *</span>
277
- <a name="l00252"></a>00252 <span class="comment"> * One can wait for an event on an EventFd by select()ing it on read events.</span>
278
- <a name="l00253"></a>00253 <span class="comment"> * Another thread can signal the EventFd by calling notify().</span>
279
- <a name="l00254"></a>00254 <span class="comment"> */</span>
280
- <a name="l00255"></a><a class="code" href="classPassenger_1_1EventFd.html">00255</a> <span class="keyword">class </span><a class="code" href="classPassenger_1_1EventFd.html" title="A synchronization mechanism that&amp;#39;s implemented with file descriptors, and as...">EventFd</a> {
281
- <a name="l00256"></a>00256 <span class="keyword">private</span>:
282
- <a name="l00257"></a>00257 <span class="keywordtype">int</span> reader;
283
- <a name="l00258"></a>00258 <span class="keywordtype">int</span> writer;
284
- <a name="l00259"></a>00259
285
- <a name="l00260"></a>00260 <span class="keyword">public</span>:
286
- <a name="l00261"></a>00261 <a class="code" href="classPassenger_1_1EventFd.html" title="A synchronization mechanism that&amp;#39;s implemented with file descriptors, and as...">EventFd</a>() {
287
- <a name="l00262"></a>00262 <span class="keywordtype">int</span> fds[2];
288
- <a name="l00263"></a>00263
289
- <a name="l00264"></a>00264 <span class="keywordflow">if</span> (syscalls::pipe(fds) == -1) {
290
- <a name="l00265"></a>00265 <span class="keywordtype">int</span> e = errno;
291
- <a name="l00266"></a>00266 <span class="keywordflow">throw</span> <a class="code" href="classPassenger_1_1SystemException.html" title="Represents an error returned by a system call or a standard library call.">SystemException</a>(<span class="stringliteral">&quot;Cannot create a pipe&quot;</span>, e);
292
- <a name="l00267"></a>00267 }
293
- <a name="l00268"></a>00268 reader = fds[0];
294
- <a name="l00269"></a>00269 writer = fds[1];
295
- <a name="l00270"></a>00270 }
296
- <a name="l00271"></a>00271
297
- <a name="l00272"></a>00272 ~<a class="code" href="classPassenger_1_1EventFd.html" title="A synchronization mechanism that&amp;#39;s implemented with file descriptors, and as...">EventFd</a>() {
298
- <a name="l00273"></a>00273 this_thread::disable_syscall_interruption dsi;
299
- <a name="l00274"></a>00274 syscalls::close(reader);
300
- <a name="l00275"></a>00275 syscalls::close(writer);
301
- <a name="l00276"></a>00276 }
302
- <a name="l00277"></a>00277
303
- <a name="l00278"></a>00278 <span class="keywordtype">void</span> notify() {
304
- <a name="l00279"></a>00279 ssize_t ret = syscalls::write(writer, <span class="stringliteral">&quot;x&quot;</span>, 1);
305
- <a name="l00280"></a>00280 <span class="keywordflow">if</span> (ret == -1 &amp;&amp; errno != EAGAIN) {
306
- <a name="l00281"></a>00281 <span class="keywordtype">int</span> e = errno;
307
- <a name="l00282"></a>00282 <span class="keywordflow">throw</span> <a class="code" href="classPassenger_1_1SystemException.html" title="Represents an error returned by a system call or a standard library call.">SystemException</a>(<span class="stringliteral">&quot;Cannot write notification data&quot;</span>, e);
308
- <a name="l00283"></a>00283 }
309
- <a name="l00284"></a>00284 }
310
- <a name="l00285"></a>00285
311
- <a name="l00286"></a>00286 <span class="keywordtype">int</span> fd()<span class="keyword"> const </span>{
312
- <a name="l00287"></a>00287 <span class="keywordflow">return</span> reader;
313
- <a name="l00288"></a>00288 }
314
- <a name="l00289"></a>00289 };
315
- <a name="l00290"></a>00290
316
- <a name="l00291"></a>00291 } <span class="comment">// namespace Passenger</span>
317
- <a name="l00292"></a>00292
318
- <a name="l00293"></a>00293 <span class="preprocessor">#endif </span><span class="comment">/* _PASSENGER_FILE_DESCRIPTOR_H_ */</span>
319
- </pre></div></div>
320
- <hr size="1"/><address style="text-align: right;"><small>Generated by&nbsp;
321
- <a href="http://www.doxygen.org/index.html">
322
- <img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.6.2 </small></address>
323
- </body>
324
- </html>