passenger 3.0.3 → 3.0.4

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 (621) hide show
  1. data/NEWS +14 -0
  2. data/ext/apache2/Hooks.cpp +2 -2
  3. data/ext/boost/thread/exceptions.hpp +8 -1
  4. data/ext/common/Constants.h +1 -1
  5. data/ext/nginx/Configuration.c +2 -1
  6. data/lib/phusion_passenger.rb +1 -1
  7. metadata +4 -618
  8. data/doc/cxxapi/AbstractSpawnManager_8h-source.html +0 -138
  9. data/doc/cxxapi/AbstractSpawnManager_8h_source.html +0 -141
  10. data/doc/cxxapi/Account_8h-source.html +0 -202
  11. data/doc/cxxapi/Account_8h_source.html +0 -206
  12. data/doc/cxxapi/AccountsDatabase_8h-source.html +0 -158
  13. data/doc/cxxapi/AccountsDatabase_8h_source.html +0 -161
  14. data/doc/cxxapi/AgentBase_8h_source.html +0 -70
  15. data/doc/cxxapi/AgentsStarter_8h-source.html +0 -79
  16. data/doc/cxxapi/AgentsStarter_8h_source.html +0 -112
  17. data/doc/cxxapi/BCrypt_8h-source.html +0 -101
  18. data/doc/cxxapi/BCrypt_8h_source.html +0 -104
  19. data/doc/cxxapi/BacktracesServer_8h-source.html +0 -87
  20. data/doc/cxxapi/Base64_8h-source.html +0 -85
  21. data/doc/cxxapi/Blowfish_8h-source.html +0 -131
  22. data/doc/cxxapi/Blowfish_8h_source.html +0 -134
  23. data/doc/cxxapi/Bucket_8h-source.html +0 -115
  24. data/doc/cxxapi/Bucket_8h_source.html +0 -118
  25. data/doc/cxxapi/CachedFileStat_8h-source.html +0 -79
  26. data/doc/cxxapi/Configuration_8h-source.html +0 -432
  27. data/doc/cxxapi/Configuration_8h_source.html +0 -435
  28. data/doc/cxxapi/Constants_8h-source.html +0 -71
  29. data/doc/cxxapi/Constants_8h_source.html +0 -79
  30. data/doc/cxxapi/ContentHandler_8h-source.html +0 -92
  31. data/doc/cxxapi/ContentHandler_8h_source.html +0 -95
  32. data/doc/cxxapi/DirectoryMapper_8h-source.html +0 -324
  33. data/doc/cxxapi/DirectoryMapper_8h_source.html +0 -311
  34. data/doc/cxxapi/EventedClient_8h_source.html +0 -733
  35. data/doc/cxxapi/EventedMessageServer_8h_source.html +0 -358
  36. data/doc/cxxapi/EventedServer_8h-source.html +0 -415
  37. data/doc/cxxapi/EventedServer_8h_source.html +0 -326
  38. data/doc/cxxapi/Exceptions_8h-source.html +0 -363
  39. data/doc/cxxapi/Exceptions_8h_source.html +0 -393
  40. data/doc/cxxapi/FileChangeChecker_8h-source.html +0 -237
  41. data/doc/cxxapi/FileDescriptor_8h-source.html +0 -206
  42. data/doc/cxxapi/FileDescriptor_8h_source.html +0 -324
  43. data/doc/cxxapi/Hooks_8h-source.html +0 -73
  44. data/doc/cxxapi/Hooks_8h_source.html +0 -76
  45. data/doc/cxxapi/HttpStatusExtractor_8h-source.html +0 -379
  46. data/doc/cxxapi/HttpStatusExtractor_8h_source.html +0 -382
  47. data/doc/cxxapi/IniFile_8h_source.html +0 -527
  48. data/doc/cxxapi/LoggingServer_8h-source.html +0 -165
  49. data/doc/cxxapi/Logging_8h-source.html +0 -709
  50. data/doc/cxxapi/Logging_8h_source.html +0 -796
  51. data/doc/cxxapi/MessageChannel_8h-source.html +0 -852
  52. data/doc/cxxapi/MessageChannel_8h_source.html +0 -776
  53. data/doc/cxxapi/MessageClient_8h-source.html +0 -297
  54. data/doc/cxxapi/MessageClient_8h_source.html +0 -328
  55. data/doc/cxxapi/MessageReadersWriters_8h-source.html +0 -451
  56. data/doc/cxxapi/MessageReadersWriters_8h_source.html +0 -539
  57. data/doc/cxxapi/MessageServer_8h-source.html +0 -607
  58. data/doc/cxxapi/MessageServer_8h_source.html +0 -612
  59. data/doc/cxxapi/PoolOptions_8h-source.html +0 -511
  60. data/doc/cxxapi/PoolOptions_8h_source.html +0 -549
  61. data/doc/cxxapi/Process_8h-source.html +0 -283
  62. data/doc/cxxapi/Process_8h_source.html +0 -286
  63. data/doc/cxxapi/RandomGenerator_8h-source.html +0 -183
  64. data/doc/cxxapi/RandomGenerator_8h_source.html +0 -191
  65. data/doc/cxxapi/ResourceLocator_8h-source.html +0 -104
  66. data/doc/cxxapi/ResourceLocator_8h_source.html +0 -166
  67. data/doc/cxxapi/SafeLibev_8h_source.html +0 -180
  68. data/doc/cxxapi/ScgiRequestParser_8h-source.html +0 -400
  69. data/doc/cxxapi/ScgiRequestParser_8h_source.html +0 -406
  70. data/doc/cxxapi/ServerInstanceDir_8h-source.html +0 -356
  71. data/doc/cxxapi/ServerInstanceDir_8h_source.html +0 -378
  72. data/doc/cxxapi/Session_8h-source.html +0 -496
  73. data/doc/cxxapi/Session_8h_source.html +0 -501
  74. data/doc/cxxapi/SpawnManager_8h-source.html +0 -632
  75. data/doc/cxxapi/SpawnManager_8h_source.html +0 -647
  76. data/doc/cxxapi/StaticContentHandler_8h-source.html +0 -65
  77. data/doc/cxxapi/StaticContentHandler_8h_source.html +0 -68
  78. data/doc/cxxapi/StaticString_8h-source.html +0 -214
  79. data/doc/cxxapi/StaticString_8h_source.html +0 -329
  80. data/doc/cxxapi/StringListCreator_8h-source.html +0 -111
  81. data/doc/cxxapi/StringListCreator_8h_source.html +0 -114
  82. data/doc/cxxapi/SystemTime_8h-source.html +0 -222
  83. data/doc/cxxapi/Timer_8h-source.html +0 -157
  84. data/doc/cxxapi/Utils_8h-source.html +0 -688
  85. data/doc/cxxapi/Utils_8h_source.html +0 -459
  86. data/doc/cxxapi/Version_8h-source.html +0 -59
  87. data/doc/cxxapi/annotated.html +0 -87
  88. data/doc/cxxapi/apache2_2Configuration_8h-source.html +0 -79
  89. data/doc/cxxapi/apache2_2Configuration_8h_source.html +0 -82
  90. data/doc/cxxapi/classAgentWatcher-members.html +0 -54
  91. data/doc/cxxapi/classAgentWatcher.html +0 -419
  92. data/doc/cxxapi/classClient-members.html +0 -38
  93. data/doc/cxxapi/classClient.html +0 -123
  94. data/doc/cxxapi/classHooks-members.html +0 -40
  95. data/doc/cxxapi/classHooks.html +0 -153
  96. data/doc/cxxapi/classPassenger_1_1AbstractSpawnManager-members.html +0 -40
  97. data/doc/cxxapi/classPassenger_1_1AbstractSpawnManager.html +0 -187
  98. data/doc/cxxapi/classPassenger_1_1AbstractSpawnManager__inherit__graph.map +0 -1
  99. data/doc/cxxapi/classPassenger_1_1AbstractSpawnManager__inherit__graph.md5 +0 -1
  100. data/doc/cxxapi/classPassenger_1_1AbstractSpawnManager__inherit__graph.png +0 -0
  101. data/doc/cxxapi/classPassenger_1_1ArgumentException-members.html +0 -36
  102. data/doc/cxxapi/classPassenger_1_1ArgumentException.html +0 -56
  103. data/doc/cxxapi/classPassenger_1_1ArrayMessage-members.html +0 -37
  104. data/doc/cxxapi/classPassenger_1_1ArrayMessage.html +0 -113
  105. data/doc/cxxapi/classPassenger_1_1ArrayReader-members.html +0 -33
  106. data/doc/cxxapi/classPassenger_1_1ArrayReader.html +0 -47
  107. data/doc/cxxapi/classPassenger_1_1BacktracesServer-members.html +0 -36
  108. data/doc/cxxapi/classPassenger_1_1BacktracesServer.html +0 -107
  109. data/doc/cxxapi/classPassenger_1_1BacktracesServer__inherit__graph.map +0 -1
  110. data/doc/cxxapi/classPassenger_1_1BacktracesServer__inherit__graph.md5 +0 -1
  111. data/doc/cxxapi/classPassenger_1_1BacktracesServer__inherit__graph.png +0 -0
  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 -1
  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_1FileChangeChecker-members.html +0 -37
  140. data/doc/cxxapi/classPassenger_1_1FileChangeChecker.html +0 -166
  141. data/doc/cxxapi/classPassenger_1_1FileDescriptor-members.html +0 -41
  142. data/doc/cxxapi/classPassenger_1_1FileDescriptor.html +0 -178
  143. data/doc/cxxapi/classPassenger_1_1FileDescriptorPair-members.html +0 -36
  144. data/doc/cxxapi/classPassenger_1_1FileDescriptorPair.html +0 -52
  145. data/doc/cxxapi/classPassenger_1_1FileNotFoundException-members.html +0 -36
  146. data/doc/cxxapi/classPassenger_1_1FileNotFoundException.html +0 -58
  147. data/doc/cxxapi/classPassenger_1_1FileNotFoundException__inherit__graph.map +0 -1
  148. data/doc/cxxapi/classPassenger_1_1FileNotFoundException__inherit__graph.md5 +0 -1
  149. data/doc/cxxapi/classPassenger_1_1FileNotFoundException__inherit__graph.png +0 -0
  150. data/doc/cxxapi/classPassenger_1_1FileSystemException-members.html +0 -41
  151. data/doc/cxxapi/classPassenger_1_1FileSystemException.html +0 -66
  152. data/doc/cxxapi/classPassenger_1_1FileSystemException__inherit__graph.map +0 -1
  153. data/doc/cxxapi/classPassenger_1_1FileSystemException__inherit__graph.md5 +0 -1
  154. data/doc/cxxapi/classPassenger_1_1FileSystemException__inherit__graph.png +0 -0
  155. data/doc/cxxapi/classPassenger_1_1HttpStatusExtractor-members.html +0 -39
  156. data/doc/cxxapi/classPassenger_1_1HttpStatusExtractor.html +0 -128
  157. data/doc/cxxapi/classPassenger_1_1IOException-members.html +0 -36
  158. data/doc/cxxapi/classPassenger_1_1IOException.html +0 -61
  159. data/doc/cxxapi/classPassenger_1_1IOException__inherit__graph.map +0 -2
  160. data/doc/cxxapi/classPassenger_1_1IOException__inherit__graph.md5 +0 -1
  161. data/doc/cxxapi/classPassenger_1_1IOException__inherit__graph.png +0 -0
  162. data/doc/cxxapi/classPassenger_1_1MemZeroGuard-members.html +0 -36
  163. data/doc/cxxapi/classPassenger_1_1MemZeroGuard.html +0 -147
  164. data/doc/cxxapi/classPassenger_1_1MessageChannel-members.html +0 -57
  165. data/doc/cxxapi/classPassenger_1_1MessageChannel.html +0 -839
  166. data/doc/cxxapi/classPassenger_1_1MessageServer-members.html +0 -49
  167. data/doc/cxxapi/classPassenger_1_1MessageServer.html +0 -407
  168. data/doc/cxxapi/classPassenger_1_1MessageServer_1_1ClientContext-members.html +0 -36
  169. data/doc/cxxapi/classPassenger_1_1MessageServer_1_1ClientContext.html +0 -58
  170. data/doc/cxxapi/classPassenger_1_1MessageServer_1_1ClientContext__inherit__graph.map +0 -3
  171. data/doc/cxxapi/classPassenger_1_1MessageServer_1_1ClientContext__inherit__graph.md5 +0 -1
  172. data/doc/cxxapi/classPassenger_1_1MessageServer_1_1ClientContext__inherit__graph.png +0 -0
  173. data/doc/cxxapi/classPassenger_1_1MessageServer_1_1CommonClientContext-members.html +0 -41
  174. data/doc/cxxapi/classPassenger_1_1MessageServer_1_1CommonClientContext.html +0 -165
  175. data/doc/cxxapi/classPassenger_1_1MessageServer_1_1CommonClientContext__inherit__graph.map +0 -3
  176. data/doc/cxxapi/classPassenger_1_1MessageServer_1_1CommonClientContext__inherit__graph.md5 +0 -1
  177. data/doc/cxxapi/classPassenger_1_1MessageServer_1_1CommonClientContext__inherit__graph.png +0 -0
  178. data/doc/cxxapi/classPassenger_1_1MessageServer_1_1Handler-members.html +0 -39
  179. data/doc/cxxapi/classPassenger_1_1MessageServer_1_1Handler.html +0 -173
  180. data/doc/cxxapi/classPassenger_1_1MessageServer_1_1Handler__inherit__graph.map +0 -1
  181. data/doc/cxxapi/classPassenger_1_1MessageServer_1_1Handler__inherit__graph.md5 +0 -1
  182. data/doc/cxxapi/classPassenger_1_1MessageServer_1_1Handler__inherit__graph.png +0 -0
  183. data/doc/cxxapi/classPassenger_1_1Process-members.html +0 -44
  184. data/doc/cxxapi/classPassenger_1_1Process.html +0 -290
  185. data/doc/cxxapi/classPassenger_1_1RandomGenerator-members.html +0 -37
  186. data/doc/cxxapi/classPassenger_1_1RandomGenerator.html +0 -79
  187. data/doc/cxxapi/classPassenger_1_1ResourceLocator-members.html +0 -36
  188. data/doc/cxxapi/classPassenger_1_1ResourceLocator.html +0 -51
  189. data/doc/cxxapi/classPassenger_1_1RuntimeException-members.html +0 -36
  190. data/doc/cxxapi/classPassenger_1_1RuntimeException.html +0 -54
  191. data/doc/cxxapi/classPassenger_1_1SafeLibev-members.html +0 -36
  192. data/doc/cxxapi/classPassenger_1_1SafeLibev.html +0 -51
  193. data/doc/cxxapi/classPassenger_1_1ScalarMessage-members.html +0 -37
  194. data/doc/cxxapi/classPassenger_1_1ScalarMessage.html +0 -76
  195. data/doc/cxxapi/classPassenger_1_1ScalarReader-members.html +0 -33
  196. data/doc/cxxapi/classPassenger_1_1ScalarReader.html +0 -47
  197. data/doc/cxxapi/classPassenger_1_1ScgiRequestParser-members.html +0 -50
  198. data/doc/cxxapi/classPassenger_1_1ScgiRequestParser.html +0 -285
  199. data/doc/cxxapi/classPassenger_1_1SecurityException-members.html +0 -36
  200. data/doc/cxxapi/classPassenger_1_1SecurityException.html +0 -56
  201. data/doc/cxxapi/classPassenger_1_1Session-members.html +0 -53
  202. data/doc/cxxapi/classPassenger_1_1Session.html +0 -556
  203. data/doc/cxxapi/classPassenger_1_1Session__inherit__graph.map +0 -1
  204. data/doc/cxxapi/classPassenger_1_1Session__inherit__graph.md5 +0 -1
  205. data/doc/cxxapi/classPassenger_1_1Session__inherit__graph.png +0 -0
  206. data/doc/cxxapi/classPassenger_1_1SpawnException-members.html +0 -39
  207. data/doc/cxxapi/classPassenger_1_1SpawnException.html +0 -101
  208. data/doc/cxxapi/classPassenger_1_1SpawnManager-members.html +0 -42
  209. data/doc/cxxapi/classPassenger_1_1SpawnManager.html +0 -292
  210. data/doc/cxxapi/classPassenger_1_1SpawnManager__inherit__graph.map +0 -1
  211. data/doc/cxxapi/classPassenger_1_1SpawnManager__inherit__graph.md5 +0 -1
  212. data/doc/cxxapi/classPassenger_1_1SpawnManager__inherit__graph.png +0 -0
  213. data/doc/cxxapi/classPassenger_1_1StandardSession-members.html +0 -54
  214. data/doc/cxxapi/classPassenger_1_1StandardSession.html +0 -394
  215. data/doc/cxxapi/classPassenger_1_1StandardSession__inherit__graph.map +0 -1
  216. data/doc/cxxapi/classPassenger_1_1StandardSession__inherit__graph.md5 +0 -1
  217. data/doc/cxxapi/classPassenger_1_1StandardSession__inherit__graph.png +0 -0
  218. data/doc/cxxapi/classPassenger_1_1StaticString-members.html +0 -36
  219. data/doc/cxxapi/classPassenger_1_1StaticString.html +0 -56
  220. data/doc/cxxapi/classPassenger_1_1SystemException-members.html +0 -40
  221. data/doc/cxxapi/classPassenger_1_1SystemException.html +0 -155
  222. data/doc/cxxapi/classPassenger_1_1SystemException__inherit__graph.map +0 -2
  223. data/doc/cxxapi/classPassenger_1_1SystemException__inherit__graph.md5 +0 -1
  224. data/doc/cxxapi/classPassenger_1_1SystemException__inherit__graph.png +0 -0
  225. data/doc/cxxapi/classPassenger_1_1SystemTime-members.html +0 -43
  226. data/doc/cxxapi/classPassenger_1_1SystemTime.html +0 -173
  227. data/doc/cxxapi/classPassenger_1_1TimeRetrievalException-members.html +0 -40
  228. data/doc/cxxapi/classPassenger_1_1TimeRetrievalException.html +0 -61
  229. data/doc/cxxapi/classPassenger_1_1TimeRetrievalException__inherit__graph.map +0 -1
  230. data/doc/cxxapi/classPassenger_1_1TimeRetrievalException__inherit__graph.md5 +0 -1
  231. data/doc/cxxapi/classPassenger_1_1TimeRetrievalException__inherit__graph.png +0 -0
  232. data/doc/cxxapi/classPassenger_1_1TimeoutException-members.html +0 -36
  233. data/doc/cxxapi/classPassenger_1_1TimeoutException.html +0 -54
  234. data/doc/cxxapi/classPassenger_1_1Timer-members.html +0 -38
  235. data/doc/cxxapi/classPassenger_1_1Timer.html +0 -163
  236. data/doc/cxxapi/classPassenger_1_1Uint16Message-members.html +0 -36
  237. data/doc/cxxapi/classPassenger_1_1Uint16Message.html +0 -51
  238. data/doc/cxxapi/classPassenger_1_1Uint16Reader-members.html +0 -33
  239. data/doc/cxxapi/classPassenger_1_1Uint16Reader.html +0 -47
  240. data/doc/cxxapi/classPassenger_1_1Uint32Message-members.html +0 -36
  241. data/doc/cxxapi/classPassenger_1_1Uint32Message.html +0 -51
  242. data/doc/cxxapi/classPassenger_1_1Uint32Reader-members.html +0 -33
  243. data/doc/cxxapi/classPassenger_1_1Uint32Reader.html +0 -47
  244. data/doc/cxxapi/classServer-members.html +0 -36
  245. data/doc/cxxapi/classServer.html +0 -49
  246. data/doc/cxxapi/classServerInstanceDirToucher-members.html +0 -36
  247. data/doc/cxxapi/classServerInstanceDirToucher.html +0 -47
  248. data/doc/cxxapi/classes.html +0 -52
  249. data/doc/cxxapi/definitions_8h-source.html +0 -33
  250. data/doc/cxxapi/definitions_8h_source.html +0 -36
  251. data/doc/cxxapi/doxygen.css +0 -532
  252. data/doc/cxxapi/doxygen.png +0 -0
  253. data/doc/cxxapi/files.html +0 -76
  254. data/doc/cxxapi/ftv2blank.png +0 -0
  255. data/doc/cxxapi/ftv2doc.png +0 -0
  256. data/doc/cxxapi/ftv2folderclosed.png +0 -0
  257. data/doc/cxxapi/ftv2folderopen.png +0 -0
  258. data/doc/cxxapi/ftv2lastnode.png +0 -0
  259. data/doc/cxxapi/ftv2link.png +0 -0
  260. data/doc/cxxapi/ftv2mlastnode.png +0 -0
  261. data/doc/cxxapi/ftv2mnode.png +0 -0
  262. data/doc/cxxapi/ftv2node.png +0 -0
  263. data/doc/cxxapi/ftv2plastnode.png +0 -0
  264. data/doc/cxxapi/ftv2pnode.png +0 -0
  265. data/doc/cxxapi/ftv2vertline.png +0 -0
  266. data/doc/cxxapi/functions.html +0 -103
  267. data/doc/cxxapi/functions_0x62.html +0 -82
  268. data/doc/cxxapi/functions_0x63.html +0 -102
  269. data/doc/cxxapi/functions_0x64.html +0 -102
  270. data/doc/cxxapi/functions_0x65.html +0 -88
  271. data/doc/cxxapi/functions_0x66.html +0 -100
  272. data/doc/cxxapi/functions_0x67.html +0 -167
  273. data/doc/cxxapi/functions_0x68.html +0 -88
  274. data/doc/cxxapi/functions_0x69.html +0 -96
  275. data/doc/cxxapi/functions_0x6b.html +0 -80
  276. data/doc/cxxapi/functions_0x6c.html +0 -88
  277. data/doc/cxxapi/functions_0x6d.html +0 -88
  278. data/doc/cxxapi/functions_0x6e.html +0 -86
  279. data/doc/cxxapi/functions_0x6f.html +0 -94
  280. data/doc/cxxapi/functions_0x70.html +0 -94
  281. data/doc/cxxapi/functions_0x72.html +0 -110
  282. data/doc/cxxapi/functions_0x73.html +0 -171
  283. data/doc/cxxapi/functions_0x74.html +0 -85
  284. data/doc/cxxapi/functions_0x75.html +0 -85
  285. data/doc/cxxapi/functions_0x77.html +0 -92
  286. data/doc/cxxapi/functions_0x7e.html +0 -79
  287. data/doc/cxxapi/functions_enum.html +0 -49
  288. data/doc/cxxapi/functions_eval.html +0 -67
  289. data/doc/cxxapi/functions_func.html +0 -531
  290. data/doc/cxxapi/functions_vars.html +0 -278
  291. data/doc/cxxapi/graph_legend.dot +0 -22
  292. data/doc/cxxapi/graph_legend.html +0 -92
  293. data/doc/cxxapi/graph_legend.png +0 -0
  294. data/doc/cxxapi/group__Configuration.html +0 -198
  295. data/doc/cxxapi/group__Configuration.map +0 -3
  296. data/doc/cxxapi/group__Configuration.png +0 -0
  297. data/doc/cxxapi/group__Core.html +0 -46
  298. data/doc/cxxapi/group__Core.map +0 -3
  299. data/doc/cxxapi/group__Core.png +0 -0
  300. data/doc/cxxapi/group__Exceptions.html +0 -53
  301. data/doc/cxxapi/group__Hooks.html +0 -42
  302. data/doc/cxxapi/group__Hooks.map +0 -3
  303. data/doc/cxxapi/group__Hooks.png +0 -0
  304. data/doc/cxxapi/group__Support.html +0 -538
  305. data/doc/cxxapi/hierarchy.html +0 -101
  306. data/doc/cxxapi/index.html +0 -16
  307. data/doc/cxxapi/inherit__graph__0.map +0 -1
  308. data/doc/cxxapi/inherit__graph__0.md5 +0 -1
  309. data/doc/cxxapi/inherit__graph__0.png +0 -0
  310. data/doc/cxxapi/inherit__graph__1.map +0 -1
  311. data/doc/cxxapi/inherit__graph__1.md5 +0 -1
  312. data/doc/cxxapi/inherit__graph__1.png +0 -0
  313. data/doc/cxxapi/inherit__graph__10.map +0 -3
  314. data/doc/cxxapi/inherit__graph__10.md5 +0 -1
  315. data/doc/cxxapi/inherit__graph__10.png +0 -0
  316. data/doc/cxxapi/inherit__graph__11.map +0 -4
  317. data/doc/cxxapi/inherit__graph__11.md5 +0 -1
  318. data/doc/cxxapi/inherit__graph__11.png +0 -0
  319. data/doc/cxxapi/inherit__graph__12.map +0 -3
  320. data/doc/cxxapi/inherit__graph__12.md5 +0 -1
  321. data/doc/cxxapi/inherit__graph__12.png +0 -0
  322. data/doc/cxxapi/inherit__graph__13.map +0 -3
  323. data/doc/cxxapi/inherit__graph__13.md5 +0 -1
  324. data/doc/cxxapi/inherit__graph__13.png +0 -0
  325. data/doc/cxxapi/inherit__graph__14.map +0 -3
  326. data/doc/cxxapi/inherit__graph__14.md5 +0 -1
  327. data/doc/cxxapi/inherit__graph__14.png +0 -0
  328. data/doc/cxxapi/inherit__graph__15.map +0 -3
  329. data/doc/cxxapi/inherit__graph__15.md5 +0 -1
  330. data/doc/cxxapi/inherit__graph__15.png +0 -0
  331. data/doc/cxxapi/inherit__graph__16.map +0 -5
  332. data/doc/cxxapi/inherit__graph__16.md5 +0 -1
  333. data/doc/cxxapi/inherit__graph__16.png +0 -0
  334. data/doc/cxxapi/inherit__graph__17.map +0 -3
  335. data/doc/cxxapi/inherit__graph__17.md5 +0 -1
  336. data/doc/cxxapi/inherit__graph__17.png +0 -0
  337. data/doc/cxxapi/inherit__graph__18.map +0 -3
  338. data/doc/cxxapi/inherit__graph__18.md5 +0 -1
  339. data/doc/cxxapi/inherit__graph__18.png +0 -0
  340. data/doc/cxxapi/inherit__graph__19.map +0 -4
  341. data/doc/cxxapi/inherit__graph__19.md5 +0 -1
  342. data/doc/cxxapi/inherit__graph__19.png +0 -0
  343. data/doc/cxxapi/inherit__graph__2.map +0 -1
  344. data/doc/cxxapi/inherit__graph__2.md5 +0 -1
  345. data/doc/cxxapi/inherit__graph__2.png +0 -0
  346. data/doc/cxxapi/inherit__graph__20.map +0 -3
  347. data/doc/cxxapi/inherit__graph__20.md5 +0 -1
  348. data/doc/cxxapi/inherit__graph__20.png +0 -0
  349. data/doc/cxxapi/inherit__graph__21.map +0 -3
  350. data/doc/cxxapi/inherit__graph__21.md5 +0 -1
  351. data/doc/cxxapi/inherit__graph__21.png +0 -0
  352. data/doc/cxxapi/inherit__graph__22.map +0 -3
  353. data/doc/cxxapi/inherit__graph__22.md5 +0 -1
  354. data/doc/cxxapi/inherit__graph__22.png +0 -0
  355. data/doc/cxxapi/inherit__graph__23.map +0 -3
  356. data/doc/cxxapi/inherit__graph__23.md5 +0 -1
  357. data/doc/cxxapi/inherit__graph__23.png +0 -0
  358. data/doc/cxxapi/inherit__graph__24.map +0 -3
  359. data/doc/cxxapi/inherit__graph__24.md5 +0 -1
  360. data/doc/cxxapi/inherit__graph__24.png +0 -0
  361. data/doc/cxxapi/inherit__graph__25.map +0 -3
  362. data/doc/cxxapi/inherit__graph__25.md5 +0 -1
  363. data/doc/cxxapi/inherit__graph__25.png +0 -0
  364. data/doc/cxxapi/inherit__graph__26.map +0 -3
  365. data/doc/cxxapi/inherit__graph__26.md5 +0 -1
  366. data/doc/cxxapi/inherit__graph__26.png +0 -0
  367. data/doc/cxxapi/inherit__graph__27.map +0 -3
  368. data/doc/cxxapi/inherit__graph__27.md5 +0 -1
  369. data/doc/cxxapi/inherit__graph__27.png +0 -0
  370. data/doc/cxxapi/inherit__graph__28.map +0 -3
  371. data/doc/cxxapi/inherit__graph__28.md5 +0 -1
  372. data/doc/cxxapi/inherit__graph__28.png +0 -0
  373. data/doc/cxxapi/inherit__graph__29.map +0 -3
  374. data/doc/cxxapi/inherit__graph__29.md5 +0 -1
  375. data/doc/cxxapi/inherit__graph__29.png +0 -0
  376. data/doc/cxxapi/inherit__graph__3.map +0 -2
  377. data/doc/cxxapi/inherit__graph__3.md5 +0 -1
  378. data/doc/cxxapi/inherit__graph__3.png +0 -0
  379. data/doc/cxxapi/inherit__graph__30.map +0 -3
  380. data/doc/cxxapi/inherit__graph__30.md5 +0 -1
  381. data/doc/cxxapi/inherit__graph__30.png +0 -0
  382. data/doc/cxxapi/inherit__graph__31.map +0 -4
  383. data/doc/cxxapi/inherit__graph__31.md5 +0 -1
  384. data/doc/cxxapi/inherit__graph__31.png +0 -0
  385. data/doc/cxxapi/inherit__graph__32.map +0 -3
  386. data/doc/cxxapi/inherit__graph__32.md5 +0 -1
  387. data/doc/cxxapi/inherit__graph__32.png +0 -0
  388. data/doc/cxxapi/inherit__graph__33.map +0 -3
  389. data/doc/cxxapi/inherit__graph__33.md5 +0 -1
  390. data/doc/cxxapi/inherit__graph__33.png +0 -0
  391. data/doc/cxxapi/inherit__graph__34.map +0 -3
  392. data/doc/cxxapi/inherit__graph__34.md5 +0 -1
  393. data/doc/cxxapi/inherit__graph__34.png +0 -0
  394. data/doc/cxxapi/inherit__graph__35.map +0 -3
  395. data/doc/cxxapi/inherit__graph__35.md5 +0 -1
  396. data/doc/cxxapi/inherit__graph__35.png +0 -0
  397. data/doc/cxxapi/inherit__graph__36.map +0 -5
  398. data/doc/cxxapi/inherit__graph__36.md5 +0 -1
  399. data/doc/cxxapi/inherit__graph__36.png +0 -0
  400. data/doc/cxxapi/inherit__graph__37.map +0 -3
  401. data/doc/cxxapi/inherit__graph__37.md5 +0 -1
  402. data/doc/cxxapi/inherit__graph__37.png +0 -0
  403. data/doc/cxxapi/inherit__graph__38.map +0 -3
  404. data/doc/cxxapi/inherit__graph__38.md5 +0 -1
  405. data/doc/cxxapi/inherit__graph__38.png +0 -0
  406. data/doc/cxxapi/inherit__graph__39.map +0 -3
  407. data/doc/cxxapi/inherit__graph__39.md5 +0 -1
  408. data/doc/cxxapi/inherit__graph__39.png +0 -0
  409. data/doc/cxxapi/inherit__graph__4.map +0 -3
  410. data/doc/cxxapi/inherit__graph__4.md5 +0 -1
  411. data/doc/cxxapi/inherit__graph__4.png +0 -0
  412. data/doc/cxxapi/inherit__graph__40.map +0 -3
  413. data/doc/cxxapi/inherit__graph__40.md5 +0 -1
  414. data/doc/cxxapi/inherit__graph__40.png +0 -0
  415. data/doc/cxxapi/inherit__graph__5.map +0 -3
  416. data/doc/cxxapi/inherit__graph__5.md5 +0 -1
  417. data/doc/cxxapi/inherit__graph__5.png +0 -0
  418. data/doc/cxxapi/inherit__graph__6.map +0 -3
  419. data/doc/cxxapi/inherit__graph__6.md5 +0 -1
  420. data/doc/cxxapi/inherit__graph__6.png +0 -0
  421. data/doc/cxxapi/inherit__graph__7.map +0 -3
  422. data/doc/cxxapi/inherit__graph__7.md5 +0 -1
  423. data/doc/cxxapi/inherit__graph__7.png +0 -0
  424. data/doc/cxxapi/inherit__graph__8.map +0 -3
  425. data/doc/cxxapi/inherit__graph__8.md5 +0 -1
  426. data/doc/cxxapi/inherit__graph__8.png +0 -0
  427. data/doc/cxxapi/inherit__graph__9.map +0 -3
  428. data/doc/cxxapi/inherit__graph__9.md5 +0 -1
  429. data/doc/cxxapi/inherit__graph__9.png +0 -0
  430. data/doc/cxxapi/inherits.html +0 -165
  431. data/doc/cxxapi/main.html +0 -28
  432. data/doc/cxxapi/md5_8h-source.html +0 -121
  433. data/doc/cxxapi/modules.html +0 -36
  434. data/doc/cxxapi/namespacePassenger.html +0 -553
  435. data/doc/cxxapi/namespacemembers.html +0 -135
  436. data/doc/cxxapi/namespacemembers_enum.html +0 -48
  437. data/doc/cxxapi/namespacemembers_eval.html +0 -57
  438. data/doc/cxxapi/namespacemembers_func.html +0 -111
  439. data/doc/cxxapi/namespacemembers_type.html +0 -54
  440. data/doc/cxxapi/namespaces.html +0 -37
  441. data/doc/cxxapi/nginx_2Configuration_8h-source.html +0 -115
  442. data/doc/cxxapi/nginx_2Configuration_8h_source.html +0 -125
  443. data/doc/cxxapi/ngx__http__passenger__module_8h-source.html +0 -91
  444. data/doc/cxxapi/ngx__http__passenger__module_8h_source.html +0 -94
  445. data/doc/cxxapi/structPassenger_1_1AnythingToString-members.html +0 -33
  446. data/doc/cxxapi/structPassenger_1_1AnythingToString.html +0 -52
  447. data/doc/cxxapi/structPassenger_1_1AnythingToString_3_01vector_3_01StaticString_01_4_01_4-members.html +0 -33
  448. data/doc/cxxapi/structPassenger_1_1AnythingToString_3_01vector_3_01StaticString_01_4_01_4.html +0 -52
  449. data/doc/cxxapi/structPassenger_1_1AnythingToString_3_01vector_3_01string_01_4_01_4-members.html +0 -33
  450. data/doc/cxxapi/structPassenger_1_1AnythingToString_3_01vector_3_01string_01_4_01_4.html +0 -52
  451. data/doc/cxxapi/structPassenger_1_1MessageServer_1_1DisconnectEventBroadcastGuard-members.html +0 -36
  452. data/doc/cxxapi/structPassenger_1_1MessageServer_1_1DisconnectEventBroadcastGuard.html +0 -51
  453. data/doc/cxxapi/structPassenger_1_1PoolOptions-members.html +0 -67
  454. data/doc/cxxapi/structPassenger_1_1PoolOptions.html +0 -647
  455. data/doc/cxxapi/structPassenger_1_1StaticString_1_1Hash-members.html +0 -36
  456. data/doc/cxxapi/structPassenger_1_1StaticString_1_1Hash.html +0 -51
  457. data/doc/cxxapi/tab_b.gif +0 -0
  458. data/doc/cxxapi/tab_l.gif +0 -0
  459. data/doc/cxxapi/tab_r.gif +0 -0
  460. data/doc/cxxapi/tabs.css +0 -105
  461. data/doc/cxxapi/tree.html +0 -249
  462. data/doc/rdoc/classes/ConditionVariable.html +0 -215
  463. data/doc/rdoc/classes/Exception.html +0 -120
  464. data/doc/rdoc/classes/GC.html +0 -113
  465. data/doc/rdoc/classes/IO.html +0 -221
  466. data/doc/rdoc/classes/PhusionPassenger.html +0 -397
  467. data/doc/rdoc/classes/PhusionPassenger/AbstractInstaller.html +0 -180
  468. data/doc/rdoc/classes/PhusionPassenger/AbstractRequestHandler.html +0 -647
  469. data/doc/rdoc/classes/PhusionPassenger/AbstractServer.html +0 -654
  470. data/doc/rdoc/classes/PhusionPassenger/AbstractServer/InvalidPassword.html +0 -92
  471. data/doc/rdoc/classes/PhusionPassenger/AbstractServer/ServerAlreadyStarted.html +0 -97
  472. data/doc/rdoc/classes/PhusionPassenger/AbstractServer/ServerError.html +0 -96
  473. data/doc/rdoc/classes/PhusionPassenger/AbstractServer/ServerNotStarted.html +0 -97
  474. data/doc/rdoc/classes/PhusionPassenger/AbstractServer/UnknownMessage.html +0 -96
  475. data/doc/rdoc/classes/PhusionPassenger/AbstractServerCollection.html +0 -619
  476. data/doc/rdoc/classes/PhusionPassenger/AdminTools.html +0 -142
  477. data/doc/rdoc/classes/PhusionPassenger/AdminTools/MemoryStats.html +0 -368
  478. data/doc/rdoc/classes/PhusionPassenger/AdminTools/MemoryStats/Process.html +0 -231
  479. data/doc/rdoc/classes/PhusionPassenger/AdminTools/ServerInstance.html +0 -588
  480. data/doc/rdoc/classes/PhusionPassenger/AdminTools/ServerInstance/CorruptedDirectoryError.html +0 -92
  481. data/doc/rdoc/classes/PhusionPassenger/AdminTools/ServerInstance/GenerationsAbsentError.html +0 -92
  482. data/doc/rdoc/classes/PhusionPassenger/AdminTools/ServerInstance/Group.html +0 -147
  483. data/doc/rdoc/classes/PhusionPassenger/AdminTools/ServerInstance/Process.html +0 -279
  484. data/doc/rdoc/classes/PhusionPassenger/AdminTools/ServerInstance/RoleDeniedError.html +0 -92
  485. data/doc/rdoc/classes/PhusionPassenger/AdminTools/ServerInstance/StaleDirectoryError.html +0 -92
  486. data/doc/rdoc/classes/PhusionPassenger/AdminTools/ServerInstance/Stats.html +0 -123
  487. data/doc/rdoc/classes/PhusionPassenger/AdminTools/ServerInstance/UnsupportedGenerationStructureVersionError.html +0 -92
  488. data/doc/rdoc/classes/PhusionPassenger/AnalyticsLogger.html +0 -368
  489. data/doc/rdoc/classes/PhusionPassenger/AnalyticsLogger/Log.html +0 -299
  490. data/doc/rdoc/classes/PhusionPassenger/AnalyticsLogger/SharedData.html +0 -206
  491. data/doc/rdoc/classes/PhusionPassenger/AppInitError.html +0 -155
  492. data/doc/rdoc/classes/PhusionPassenger/AppProcess.html +0 -367
  493. data/doc/rdoc/classes/PhusionPassenger/ClassicRails.html +0 -95
  494. data/doc/rdoc/classes/PhusionPassenger/ClassicRails/ApplicationSpawner.html +0 -351
  495. data/doc/rdoc/classes/PhusionPassenger/ClassicRails/ApplicationSpawner/Error.html +0 -98
  496. data/doc/rdoc/classes/PhusionPassenger/ClassicRails/CGIFixed.html +0 -200
  497. data/doc/rdoc/classes/PhusionPassenger/ClassicRails/FrameworkSpawner.html +0 -410
  498. data/doc/rdoc/classes/PhusionPassenger/ClassicRails/FrameworkSpawner/Error.html +0 -98
  499. data/doc/rdoc/classes/PhusionPassenger/ClassicRails/RequestHandler.html +0 -156
  500. data/doc/rdoc/classes/PhusionPassenger/ClassicRailsExtensions.html +0 -115
  501. data/doc/rdoc/classes/PhusionPassenger/ClassicRailsExtensions/AnalyticsLogging.html +0 -202
  502. data/doc/rdoc/classes/PhusionPassenger/ConsoleTextTemplate.html +0 -172
  503. data/doc/rdoc/classes/PhusionPassenger/DebugLogging.html +0 -273
  504. data/doc/rdoc/classes/PhusionPassenger/FrameworkInitError.html +0 -145
  505. data/doc/rdoc/classes/PhusionPassenger/HTMLTemplate.html +0 -162
  506. data/doc/rdoc/classes/PhusionPassenger/InitializationError.html +0 -141
  507. data/doc/rdoc/classes/PhusionPassenger/InvalidPath.html +0 -92
  508. data/doc/rdoc/classes/PhusionPassenger/MessageChannel.html +0 -673
  509. data/doc/rdoc/classes/PhusionPassenger/MessageChannel/InvalidHashError.html +0 -92
  510. data/doc/rdoc/classes/PhusionPassenger/MessageClient.html +0 -415
  511. data/doc/rdoc/classes/PhusionPassenger/NativeSupportLoader.html +0 -134
  512. data/doc/rdoc/classes/PhusionPassenger/Packaging.html +0 -129
  513. data/doc/rdoc/classes/PhusionPassenger/PlatformInfo.html +0 -1972
  514. data/doc/rdoc/classes/PhusionPassenger/Plugin.html +0 -237
  515. data/doc/rdoc/classes/PhusionPassenger/Rack.html +0 -91
  516. data/doc/rdoc/classes/PhusionPassenger/Rack/ApplicationSpawner.html +0 -312
  517. data/doc/rdoc/classes/PhusionPassenger/Rack/ApplicationSpawner/Error.html +0 -98
  518. data/doc/rdoc/classes/PhusionPassenger/Rack/RequestHandler.html +0 -218
  519. data/doc/rdoc/classes/PhusionPassenger/Rails3Extensions.html +0 -114
  520. data/doc/rdoc/classes/PhusionPassenger/Rails3Extensions/AnalyticsLogging.html +0 -259
  521. data/doc/rdoc/classes/PhusionPassenger/Rails3Extensions/AnalyticsLogging/ACExtension.html +0 -139
  522. data/doc/rdoc/classes/PhusionPassenger/Rails3Extensions/AnalyticsLogging/ASBenchmarkableExtension.html +0 -118
  523. data/doc/rdoc/classes/PhusionPassenger/Rails3Extensions/AnalyticsLogging/ExceptionLogger.html +0 -135
  524. data/doc/rdoc/classes/PhusionPassenger/SpawnManager.html +0 -378
  525. data/doc/rdoc/classes/PhusionPassenger/Standalone.html +0 -111
  526. data/doc/rdoc/classes/PhusionPassenger/Standalone/AppFinder.html +0 -252
  527. data/doc/rdoc/classes/PhusionPassenger/Standalone/Command.html +0 -161
  528. data/doc/rdoc/classes/PhusionPassenger/Standalone/ConfigFile.html +0 -368
  529. data/doc/rdoc/classes/PhusionPassenger/Standalone/ConfigFile/DisallowedContextError.html +0 -132
  530. data/doc/rdoc/classes/PhusionPassenger/Standalone/HelpCommand.html +0 -151
  531. data/doc/rdoc/classes/PhusionPassenger/Standalone/Main.html +0 -189
  532. data/doc/rdoc/classes/PhusionPassenger/Standalone/PackageRuntimeCommand.html +0 -177
  533. data/doc/rdoc/classes/PhusionPassenger/Standalone/RuntimeInstaller.html +0 -341
  534. data/doc/rdoc/classes/PhusionPassenger/Standalone/StartCommand.html +0 -203
  535. data/doc/rdoc/classes/PhusionPassenger/Standalone/StatusCommand.html +0 -156
  536. data/doc/rdoc/classes/PhusionPassenger/Standalone/StopCommand.html +0 -168
  537. data/doc/rdoc/classes/PhusionPassenger/Standalone/Utils.html +0 -86
  538. data/doc/rdoc/classes/PhusionPassenger/Standalone/VersionCommand.html +0 -135
  539. data/doc/rdoc/classes/PhusionPassenger/UnknownError.html +0 -125
  540. data/doc/rdoc/classes/PhusionPassenger/Utils.html +0 -1543
  541. data/doc/rdoc/classes/PhusionPassenger/Utils/FileSystemWatcher.html +0 -204
  542. data/doc/rdoc/classes/PhusionPassenger/Utils/FileSystemWatcher/DirInfo.html +0 -171
  543. data/doc/rdoc/classes/PhusionPassenger/Utils/FileSystemWatcher/FileInfo.html +0 -140
  544. data/doc/rdoc/classes/PhusionPassenger/Utils/HostsFileParser.html +0 -260
  545. data/doc/rdoc/classes/PhusionPassenger/Utils/PseudoIO.html +0 -194
  546. data/doc/rdoc/classes/PhusionPassenger/Utils/RewindableInput.html +0 -265
  547. data/doc/rdoc/classes/PhusionPassenger/Utils/RewindableInput/Tempfile.html +0 -120
  548. data/doc/rdoc/classes/PhusionPassenger/Utils/UnseekableSocket.html +0 -561
  549. data/doc/rdoc/classes/PhusionPassenger/VersionNotFound.html +0 -140
  550. data/doc/rdoc/classes/PhusionPassenger/WSGI.html +0 -89
  551. data/doc/rdoc/classes/PhusionPassenger/WSGI/ApplicationSpawner.html +0 -182
  552. data/doc/rdoc/classes/Process.html +0 -115
  553. data/doc/rdoc/classes/Signal.html +0 -139
  554. data/doc/rdoc/created.rid +0 -1
  555. data/doc/rdoc/files/DEVELOPERS_TXT.html +0 -280
  556. data/doc/rdoc/files/README.html +0 -157
  557. data/doc/rdoc/files/lib/phusion_passenger/abstract_installer_rb.html +0 -130
  558. data/doc/rdoc/files/lib/phusion_passenger/abstract_request_handler_rb.html +0 -135
  559. data/doc/rdoc/files/lib/phusion_passenger/abstract_server_collection_rb.html +0 -126
  560. data/doc/rdoc/files/lib/phusion_passenger/abstract_server_rb.html +0 -128
  561. data/doc/rdoc/files/lib/phusion_passenger/admin_tools/memory_stats_rb.html +0 -126
  562. data/doc/rdoc/files/lib/phusion_passenger/admin_tools/server_instance_rb.html +0 -132
  563. data/doc/rdoc/files/lib/phusion_passenger/admin_tools_rb.html +0 -122
  564. data/doc/rdoc/files/lib/phusion_passenger/analytics_logger_rb.html +0 -129
  565. data/doc/rdoc/files/lib/phusion_passenger/app_process_rb.html +0 -127
  566. data/doc/rdoc/files/lib/phusion_passenger/classic_rails/application_spawner_rb.html +0 -141
  567. data/doc/rdoc/files/lib/phusion_passenger/classic_rails/cgi_fixed_rb.html +0 -126
  568. data/doc/rdoc/files/lib/phusion_passenger/classic_rails/framework_spawner_rb.html +0 -146
  569. data/doc/rdoc/files/lib/phusion_passenger/classic_rails/request_handler_rb.html +0 -125
  570. data/doc/rdoc/files/lib/phusion_passenger/classic_rails_extensions/init_rb.html +0 -132
  571. data/doc/rdoc/files/lib/phusion_passenger/console_text_template_rb.html +0 -126
  572. data/doc/rdoc/files/lib/phusion_passenger/constants_rb.html +0 -122
  573. data/doc/rdoc/files/lib/phusion_passenger/debug_logging_rb.html +0 -122
  574. data/doc/rdoc/files/lib/phusion_passenger/dependencies_rb.html +0 -147
  575. data/doc/rdoc/files/lib/phusion_passenger/exceptions_rb.html +0 -122
  576. data/doc/rdoc/files/lib/phusion_passenger/html_template_rb.html +0 -127
  577. data/doc/rdoc/files/lib/phusion_passenger/message_channel_rb.html +0 -120
  578. data/doc/rdoc/files/lib/phusion_passenger/message_client_rb.html +0 -127
  579. data/doc/rdoc/files/lib/phusion_passenger/native_support_rb.html +0 -132
  580. data/doc/rdoc/files/lib/phusion_passenger/packaging_rb.html +0 -122
  581. data/doc/rdoc/files/lib/phusion_passenger/platform_info/apache_rb.html +0 -127
  582. data/doc/rdoc/files/lib/phusion_passenger/platform_info/binary_compatibility_rb.html +0 -129
  583. data/doc/rdoc/files/lib/phusion_passenger/platform_info/compiler_rb.html +0 -127
  584. data/doc/rdoc/files/lib/phusion_passenger/platform_info/curl_rb.html +0 -126
  585. data/doc/rdoc/files/lib/phusion_passenger/platform_info/documentation_tools_rb.html +0 -126
  586. data/doc/rdoc/files/lib/phusion_passenger/platform_info/linux_rb.html +0 -126
  587. data/doc/rdoc/files/lib/phusion_passenger/platform_info/operating_system_rb.html +0 -127
  588. data/doc/rdoc/files/lib/phusion_passenger/platform_info/ruby_rb.html +0 -128
  589. data/doc/rdoc/files/lib/phusion_passenger/platform_info/zlib_rb.html +0 -126
  590. data/doc/rdoc/files/lib/phusion_passenger/platform_info_rb.html +0 -122
  591. data/doc/rdoc/files/lib/phusion_passenger/plugin_rb.html +0 -127
  592. data/doc/rdoc/files/lib/phusion_passenger/public_api_rb.html +0 -127
  593. data/doc/rdoc/files/lib/phusion_passenger/rack/application_spawner_rb.html +0 -137
  594. data/doc/rdoc/files/lib/phusion_passenger/rack/request_handler_rb.html +0 -125
  595. data/doc/rdoc/files/lib/phusion_passenger/rails3_extensions/init_rb.html +0 -127
  596. data/doc/rdoc/files/lib/phusion_passenger/simple_benchmarking_rb.html +0 -122
  597. data/doc/rdoc/files/lib/phusion_passenger/spawn_manager_rb.html +0 -160
  598. data/doc/rdoc/files/lib/phusion_passenger/standalone/app_finder_rb.html +0 -127
  599. data/doc/rdoc/files/lib/phusion_passenger/standalone/command_rb.html +0 -136
  600. data/doc/rdoc/files/lib/phusion_passenger/standalone/config_file_rb.html +0 -126
  601. data/doc/rdoc/files/lib/phusion_passenger/standalone/help_command_rb.html +0 -126
  602. data/doc/rdoc/files/lib/phusion_passenger/standalone/main_rb.html +0 -126
  603. data/doc/rdoc/files/lib/phusion_passenger/standalone/package_runtime_command_rb.html +0 -127
  604. data/doc/rdoc/files/lib/phusion_passenger/standalone/runtime_installer_rb.html +0 -133
  605. data/doc/rdoc/files/lib/phusion_passenger/standalone/start_command_rb.html +0 -136
  606. data/doc/rdoc/files/lib/phusion_passenger/standalone/status_command_rb.html +0 -126
  607. data/doc/rdoc/files/lib/phusion_passenger/standalone/stop_command_rb.html +0 -126
  608. data/doc/rdoc/files/lib/phusion_passenger/standalone/utils_rb.html +0 -126
  609. data/doc/rdoc/files/lib/phusion_passenger/standalone/version_command_rb.html +0 -127
  610. data/doc/rdoc/files/lib/phusion_passenger/utils/file_system_watcher_rb.html +0 -126
  611. data/doc/rdoc/files/lib/phusion_passenger/utils/hosts_file_parser_rb.html +0 -120
  612. data/doc/rdoc/files/lib/phusion_passenger/utils/rewindable_input_rb.html +0 -100
  613. data/doc/rdoc/files/lib/phusion_passenger/utils/tmpdir_rb.html +0 -122
  614. data/doc/rdoc/files/lib/phusion_passenger/utils/unseekable_socket_rb.html +0 -126
  615. data/doc/rdoc/files/lib/phusion_passenger/utils_rb.html +0 -179
  616. data/doc/rdoc/files/lib/phusion_passenger/wsgi/application_spawner_rb.html +0 -132
  617. data/doc/rdoc/fr_class_index.html +0 -139
  618. data/doc/rdoc/fr_file_index.html +0 -108
  619. data/doc/rdoc/fr_method_index.html +0 -439
  620. data/doc/rdoc/index.html +0 -26
  621. data/doc/rdoc/rdoc-style.css +0 -187
@@ -1,607 +0,0 @@
1
- <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2
- <html><head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
3
- <title>Passenger: MessageServer.h Source File</title>
4
- <link href="tabs.css" rel="stylesheet" type="text/css">
5
- <link href="doxygen.css" rel="stylesheet" type="text/css">
6
- </head><body>
7
- <!-- Generated by Doxygen 1.5.8 -->
8
- <div class="navigation" id="top">
9
- <div class="tabs">
10
- <ul>
11
- <li><a href="main.html"><span>Main&nbsp;Page</span></a></li>
12
- <li><a href="modules.html"><span>Modules</span></a></li>
13
- <li><a href="namespaces.html"><span>Namespaces</span></a></li>
14
- <li><a href="annotated.html"><span>Classes</span></a></li>
15
- <li class="current"><a href="files.html"><span>Files</span></a></li>
16
- </ul>
17
- </div>
18
- <div class="tabs">
19
- <ul>
20
- <li><a href="files.html"><span>File&nbsp;List</span></a></li>
21
- </ul>
22
- </div>
23
- <h1>MessageServer.h</h1><div class="fragment"><pre class="fragment"><a name="l00001"></a>00001 <span class="comment">/*</span>
24
- <a name="l00002"></a>00002 <span class="comment"> * Phusion Passenger - http://www.modrails.com/</span>
25
- <a name="l00003"></a>00003 <span class="comment"> * Copyright (c) 2010 Phusion</span>
26
- <a name="l00004"></a>00004 <span class="comment"> *</span>
27
- <a name="l00005"></a>00005 <span class="comment"> * "Phusion Passenger" is a trademark of Hongli Lai &amp; Ninh Bui.</span>
28
- <a name="l00006"></a>00006 <span class="comment"> *</span>
29
- <a name="l00007"></a>00007 <span class="comment"> * Permission is hereby granted, free of charge, to any person obtaining a copy</span>
30
- <a name="l00008"></a>00008 <span class="comment"> * of this software and associated documentation files (the "Software"), to deal</span>
31
- <a name="l00009"></a>00009 <span class="comment"> * in the Software without restriction, including without limitation the rights</span>
32
- <a name="l00010"></a>00010 <span class="comment"> * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell</span>
33
- <a name="l00011"></a>00011 <span class="comment"> * copies of the Software, and to permit persons to whom the Software is</span>
34
- <a name="l00012"></a>00012 <span class="comment"> * furnished to do so, subject to the following conditions:</span>
35
- <a name="l00013"></a>00013 <span class="comment"> *</span>
36
- <a name="l00014"></a>00014 <span class="comment"> * The above copyright notice and this permission notice shall be included in</span>
37
- <a name="l00015"></a>00015 <span class="comment"> * all copies or substantial portions of the Software.</span>
38
- <a name="l00016"></a>00016 <span class="comment"> *</span>
39
- <a name="l00017"></a>00017 <span class="comment"> * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR</span>
40
- <a name="l00018"></a>00018 <span class="comment"> * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,</span>
41
- <a name="l00019"></a>00019 <span class="comment"> * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE</span>
42
- <a name="l00020"></a>00020 <span class="comment"> * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER</span>
43
- <a name="l00021"></a>00021 <span class="comment"> * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,</span>
44
- <a name="l00022"></a>00022 <span class="comment"> * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN</span>
45
- <a name="l00023"></a>00023 <span class="comment"> * THE SOFTWARE.</span>
46
- <a name="l00024"></a>00024 <span class="comment"> */</span>
47
- <a name="l00025"></a>00025 <span class="preprocessor">#ifndef _PASSENGER_MESSAGE_SERVER_H_</span>
48
- <a name="l00026"></a>00026 <span class="preprocessor"></span><span class="preprocessor">#define _PASSENGER_MESSAGE_SERVER_H_</span>
49
- <a name="l00027"></a>00027 <span class="preprocessor"></span>
50
- <a name="l00028"></a>00028 <span class="preprocessor">#include &lt;string&gt;</span>
51
- <a name="l00029"></a>00029 <span class="preprocessor">#include &lt;vector&gt;</span>
52
- <a name="l00030"></a>00030
53
- <a name="l00031"></a>00031 <span class="preprocessor">#include &lt;boost/shared_ptr.hpp&gt;</span>
54
- <a name="l00032"></a>00032 <span class="preprocessor">#include &lt;boost/thread.hpp&gt;</span>
55
- <a name="l00033"></a>00033 <span class="preprocessor">#include &lt;oxt/system_calls.hpp&gt;</span>
56
- <a name="l00034"></a>00034 <span class="preprocessor">#include &lt;oxt/dynamic_thread_group.hpp&gt;</span>
57
- <a name="l00035"></a>00035
58
- <a name="l00036"></a>00036 <span class="preprocessor">#include &lt;sys/types.h&gt;</span>
59
- <a name="l00037"></a>00037 <span class="preprocessor">#include &lt;sys/stat.h&gt;</span>
60
- <a name="l00038"></a>00038 <span class="preprocessor">#include &lt;sys/un.h&gt;</span>
61
- <a name="l00039"></a>00039 <span class="preprocessor">#include &lt;unistd.h&gt;</span>
62
- <a name="l00040"></a>00040 <span class="preprocessor">#include &lt;cerrno&gt;</span>
63
- <a name="l00041"></a>00041 <span class="preprocessor">#include &lt;cassert&gt;</span>
64
- <a name="l00042"></a>00042
65
- <a name="l00043"></a>00043 <span class="preprocessor">#include "Account.h"</span>
66
- <a name="l00044"></a>00044 <span class="preprocessor">#include "AccountsDatabase.h"</span>
67
- <a name="l00045"></a>00045 <span class="preprocessor">#include "Constants.h"</span>
68
- <a name="l00046"></a>00046 <span class="preprocessor">#include "FileDescriptor.h"</span>
69
- <a name="l00047"></a>00047 <span class="preprocessor">#include "MessageChannel.h"</span>
70
- <a name="l00048"></a>00048 <span class="preprocessor">#include "Logging.h"</span>
71
- <a name="l00049"></a>00049 <span class="preprocessor">#include "Exceptions.h"</span>
72
- <a name="l00050"></a>00050 <span class="preprocessor">#include "Utils.h"</span>
73
- <a name="l00051"></a>00051
74
- <a name="l00052"></a>00052 <span class="keyword">namespace </span>Passenger {
75
- <a name="l00053"></a>00053
76
- <a name="l00054"></a>00054 <span class="keyword">using namespace </span>std;
77
- <a name="l00055"></a>00055 <span class="keyword">using namespace </span>boost;
78
- <a name="l00056"></a>00056 <span class="keyword">using namespace </span>oxt;
79
- <a name="l00057"></a>00057
80
- <a name="l00058"></a>00058
81
- <a name="l00059"></a>00059 <span class="comment">/* This source file follows the security guidelines written in Account.h. */</span>
82
- <a name="l00060"></a>00060 <span class="comment"></span>
83
- <a name="l00061"></a>00061 <span class="comment">/**</span>
84
- <a name="l00062"></a>00062 <span class="comment"> * Simple pluggable request/response messaging server framework.</span>
85
- <a name="l00063"></a>00063 <span class="comment"> *</span>
86
- <a name="l00064"></a>00064 <span class="comment"> * MessageServer implements a server with the following properties:</span>
87
- <a name="l00065"></a>00065 <span class="comment"> * - It listens on a Unix socket. Socket creation and destruction is automatically handled.</span>
88
- <a name="l00066"></a>00066 <span class="comment"> * The socket is world-writable because a username/password authentication scheme is</span>
89
- <a name="l00067"></a>00067 <span class="comment"> * used to enforce security.</span>
90
- <a name="l00068"></a>00068 <span class="comment"> * - Multithreaded: 1 thread per client.</span>
91
- <a name="l00069"></a>00069 <span class="comment"> * - Designed for simple request/response cycles. That is, a client sends a request, and</span>
92
- <a name="l00070"></a>00070 <span class="comment"> * the server may respond with arbitrary data. The server does not respond sporadically,</span>
93
- <a name="l00071"></a>00071 <span class="comment"> * i.e. it only responds after a request.</span>
94
- <a name="l00072"></a>00072 <span class="comment"> * - Requests are discrete MessageChannel array messages, not byte streams.</span>
95
- <a name="l00073"></a>00073 <span class="comment"> * - Connections are authenticated. Connecting clients must send a username and password,</span>
96
- <a name="l00074"></a>00074 <span class="comment"> * which are then checked against an accounts database. The associated account is known</span>
97
- <a name="l00075"></a>00075 <span class="comment"> * throughout the entire connection life time so that it's possible to implement</span>
98
- <a name="l00076"></a>00076 <span class="comment"> * authorization features.</span>
99
- <a name="l00077"></a>00077 <span class="comment"> *</span>
100
- <a name="l00078"></a>00078 <span class="comment"> * MessageServer does not process messages by itself. Instead, one registers handlers</span>
101
- <a name="l00079"></a>00079 <span class="comment"> * which handle message processing. This framework allows one to seperate message</span>
102
- <a name="l00080"></a>00080 <span class="comment"> * handling code by function, while allowing everything to listen on the same socket and</span>
103
- <a name="l00081"></a>00081 <span class="comment"> * to use a common request parsing and dispatching codebase.</span>
104
- <a name="l00082"></a>00082 <span class="comment"> *</span>
105
- <a name="l00083"></a>00083 <span class="comment"> * A username/password authentication scheme was chosen over a file permission scheme because</span>
106
- <a name="l00084"></a>00084 <span class="comment"> * experience has shown that the latter is inadequate. For example, the web server may</span>
107
- <a name="l00085"></a>00085 <span class="comment"> * consist of multiple worker processes, each running as a different user. Although ACLs</span>
108
- <a name="l00086"></a>00086 <span class="comment"> * can solve this problem as well, not every platform supports ACLs by default.</span>
109
- <a name="l00087"></a>00087 <span class="comment"> *</span>
110
- <a name="l00088"></a>00088 <span class="comment"> * &lt;h2&gt;Writing handlers&lt;/h2&gt;</span>
111
- <a name="l00089"></a>00089 <span class="comment"> * Handlers must inherit from MessageServer::Handler. They may implement newClient()</span>
112
- <a name="l00090"></a>00090 <span class="comment"> * and must implement processMessage().</span>
113
- <a name="l00091"></a>00091 <span class="comment"> *</span>
114
- <a name="l00092"></a>00092 <span class="comment"> * When a new client is accepted, MessageServer will call newClient() on all handlers.</span>
115
- <a name="l00093"></a>00093 <span class="comment"> * This method accepts one argument: a common client context object. This context object</span>
116
- <a name="l00094"></a>00094 <span class="comment"> * contains client-specific information, such as its file descriptor. It cannot be</span>
117
- <a name="l00095"></a>00095 <span class="comment"> * extended to store more information, but it is passed to every handler anyway,</span>
118
- <a name="l00096"></a>00096 <span class="comment"> * hence the word "common" in its name.</span>
119
- <a name="l00097"></a>00097 <span class="comment"> * newClient() is supposed to return a handler-specific client context object for storing</span>
120
- <a name="l00098"></a>00098 <span class="comment"> * its own information, or a null pointer if it doesn't need to store anything.</span>
121
- <a name="l00099"></a>00099 <span class="comment"> *</span>
122
- <a name="l00100"></a>00100 <span class="comment"> * When a client sends a request, MessageServer iterates through all handlers and calls</span>
123
- <a name="l00101"></a>00101 <span class="comment"> * processMessage() on each one, passing it the common client context and the</span>
124
- <a name="l00102"></a>00102 <span class="comment"> * handler-specific client context. processMessage() may return either true or false;</span>
125
- <a name="l00103"></a>00103 <span class="comment"> * true indicates that the handler processed the message, false indicates that</span>
126
- <a name="l00104"></a>00104 <span class="comment"> * it did not. Iteration stops at the first handler that returns true.</span>
127
- <a name="l00105"></a>00105 <span class="comment"> * If all handlers return false, i.e. the client sent a message that no handler recognizes,</span>
128
- <a name="l00106"></a>00106 <span class="comment"> * then MessageServer will close the connection with the client.</span>
129
- <a name="l00107"></a>00107 <span class="comment"> *</span>
130
- <a name="l00108"></a>00108 <span class="comment"> * Handlers do not need to be thread-safe as long as they only operate on data in the</span>
131
- <a name="l00109"></a>00109 <span class="comment"> * context objects. MessageServer ensures that context objects are not shared with other</span>
132
- <a name="l00110"></a>00110 <span class="comment"> * threads.</span>
133
- <a name="l00111"></a>00111 <span class="comment"> *</span>
134
- <a name="l00112"></a>00112 <span class="comment"> * &lt;h2&gt;Usage example&lt;/h2&gt;</span>
135
- <a name="l00113"></a>00113 <span class="comment"> * This implements a simple ping server. Every time a "ping" request is sent, the</span>
136
- <a name="l00114"></a>00114 <span class="comment"> * server responds with "pong" along with the number of times it had already sent</span>
137
- <a name="l00115"></a>00115 <span class="comment"> * pong to the same client in the past.</span>
138
- <a name="l00116"></a>00116 <span class="comment"> *</span>
139
- <a name="l00117"></a>00117 <span class="comment"> * @code</span>
140
- <a name="l00118"></a>00118 <span class="comment"> * class PingHandler: public MessageServer::Handler {</span>
141
- <a name="l00119"></a>00119 <span class="comment"> * public:</span>
142
- <a name="l00120"></a>00120 <span class="comment"> * struct MyContext: public MessageServer::ClientContext {</span>
143
- <a name="l00121"></a>00121 <span class="comment"> * int count;</span>
144
- <a name="l00122"></a>00122 <span class="comment"> * </span>
145
- <a name="l00123"></a>00123 <span class="comment"> * MyContext() {</span>
146
- <a name="l00124"></a>00124 <span class="comment"> * count = 0;</span>
147
- <a name="l00125"></a>00125 <span class="comment"> * }</span>
148
- <a name="l00126"></a>00126 <span class="comment"> * };</span>
149
- <a name="l00127"></a>00127 <span class="comment"> * </span>
150
- <a name="l00128"></a>00128 <span class="comment"> * MessageServer::ClientContextPtr newClient(MessageServer::CommonClientContext &amp;commonContext) {</span>
151
- <a name="l00129"></a>00129 <span class="comment"> * return MessageServer::ClientContextPtr(new MyContext());</span>
152
- <a name="l00130"></a>00130 <span class="comment"> * }</span>
153
- <a name="l00131"></a>00131 <span class="comment"> * </span>
154
- <a name="l00132"></a>00132 <span class="comment"> * bool processMessage(MessageServer::CommonClientContext &amp;commonContext,</span>
155
- <a name="l00133"></a>00133 <span class="comment"> * MessageServer::ClientContextPtr &amp;specificContext,</span>
156
- <a name="l00134"></a>00134 <span class="comment"> * const vector&lt;string&gt; &amp;args)</span>
157
- <a name="l00135"></a>00135 <span class="comment"> * {</span>
158
- <a name="l00136"></a>00136 <span class="comment"> * if (args[0] == "ping") {</span>
159
- <a name="l00137"></a>00137 <span class="comment"> * MyContext *myContext = (MyContext *) specificContext.get();</span>
160
- <a name="l00138"></a>00138 <span class="comment"> * commonContext.channel.write("pong", toString(specificContext-&gt;count).c_str(), NULL);</span>
161
- <a name="l00139"></a>00139 <span class="comment"> * specificContext-&gt;count++;</span>
162
- <a name="l00140"></a>00140 <span class="comment"> * return true;</span>
163
- <a name="l00141"></a>00141 <span class="comment"> * } else {</span>
164
- <a name="l00142"></a>00142 <span class="comment"> * return false;</span>
165
- <a name="l00143"></a>00143 <span class="comment"> * }</span>
166
- <a name="l00144"></a>00144 <span class="comment"> * }</span>
167
- <a name="l00145"></a>00145 <span class="comment"> * };</span>
168
- <a name="l00146"></a>00146 <span class="comment"> * </span>
169
- <a name="l00147"></a>00147 <span class="comment"> * ...</span>
170
- <a name="l00148"></a>00148 <span class="comment"> * </span>
171
- <a name="l00149"></a>00149 <span class="comment"> * MessageServer server("server.sock");</span>
172
- <a name="l00150"></a>00150 <span class="comment"> * server.addHandler(MessageServer::HandlerPtr(new PingHandler()));</span>
173
- <a name="l00151"></a>00151 <span class="comment"> * server.addHandler(MessageServer::HandlerPtr(new PingHandler()));</span>
174
- <a name="l00152"></a>00152 <span class="comment"> * server.mainLoop();</span>
175
- <a name="l00153"></a>00153 <span class="comment"> * @endcode</span>
176
- <a name="l00154"></a>00154 <span class="comment"> *</span>
177
- <a name="l00155"></a>00155 <span class="comment"> * @ingroup Support</span>
178
- <a name="l00156"></a>00156 <span class="comment"> */</span>
179
- <a name="l00157"></a><a class="code" href="classPassenger_1_1MessageServer.html">00157</a> <span class="keyword">class </span><a class="code" href="classPassenger_1_1MessageServer.html" title="Simple pluggable request/response messaging server framework.">MessageServer</a> {
180
- <a name="l00158"></a>00158 <span class="keyword">public</span>:
181
- <a name="l00159"></a>00159 <span class="keyword">static</span> <span class="keyword">const</span> <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> CLIENT_THREAD_STACK_SIZE = 64 * 1024;
182
- <a name="l00160"></a>00160 <span class="comment"></span>
183
- <a name="l00161"></a>00161 <span class="comment"> /** Interface for client context objects. */</span>
184
- <a name="l00162"></a><a class="code" href="classPassenger_1_1MessageServer_1_1ClientContext.html">00162</a> <span class="keyword">class </span><a class="code" href="classPassenger_1_1MessageServer_1_1ClientContext.html" title="Interface for client context objects.">ClientContext</a> {
185
- <a name="l00163"></a>00163 <span class="keyword">public</span>:
186
- <a name="l00164"></a>00164 <span class="keyword">virtual</span> ~<a class="code" href="classPassenger_1_1MessageServer_1_1ClientContext.html" title="Interface for client context objects.">ClientContext</a>() { }
187
- <a name="l00165"></a>00165 };
188
- <a name="l00166"></a>00166
189
- <a name="l00167"></a>00167 <span class="keyword">typedef</span> shared_ptr&lt;ClientContext&gt; ClientContextPtr;
190
- <a name="l00168"></a>00168 <span class="comment"></span>
191
- <a name="l00169"></a>00169 <span class="comment"> /**</span>
192
- <a name="l00170"></a>00170 <span class="comment"> * A common client context, containing client-specific information</span>
193
- <a name="l00171"></a>00171 <span class="comment"> * used by MessageServer itself.</span>
194
- <a name="l00172"></a>00172 <span class="comment"> */</span>
195
- <a name="l00173"></a><a class="code" href="classPassenger_1_1MessageServer_1_1CommonClientContext.html">00173</a> <span class="keyword">class </span><a class="code" href="classPassenger_1_1MessageServer_1_1CommonClientContext.html" title="A common client context, containing client-specific information used by MessageServer...">CommonClientContext</a>: <span class="keyword">public</span> <a class="code" href="classPassenger_1_1MessageServer_1_1ClientContext.html" title="Interface for client context objects.">ClientContext</a> {
196
- <a name="l00174"></a>00174 <span class="keyword">public</span>:<span class="comment"></span>
197
- <a name="l00175"></a>00175 <span class="comment"> /** The client's socket file descriptor. */</span>
198
- <a name="l00176"></a><a class="code" href="classPassenger_1_1MessageServer_1_1CommonClientContext.html#66485f4cbc9a23473b071924743c1c6f">00176</a> <a class="code" href="classPassenger_1_1FileDescriptor.html" title="Wrapper class around a file descriptor integer, for RAII behavior.">FileDescriptor</a> <a class="code" href="classPassenger_1_1MessageServer_1_1CommonClientContext.html#66485f4cbc9a23473b071924743c1c6f" title="The client&amp;#39;s socket file descriptor.">fd</a>;
199
- <a name="l00177"></a>00177 <span class="comment"></span>
200
- <a name="l00178"></a>00178 <span class="comment"> /** The channel that's associated with the client's socket. */</span>
201
- <a name="l00179"></a><a class="code" href="classPassenger_1_1MessageServer_1_1CommonClientContext.html#1401aab009ce4f77c4e3aba1990c8f4a">00179</a> <a class="code" href="classPassenger_1_1MessageChannel.html" title="Convenience class for I/O operations on file descriptors.">MessageChannel</a> <a class="code" href="classPassenger_1_1MessageServer_1_1CommonClientContext.html#1401aab009ce4f77c4e3aba1990c8f4a" title="The channel that&amp;#39;s associated with the client&amp;#39;s socket.">channel</a>;
202
- <a name="l00180"></a>00180 <span class="comment"></span>
203
- <a name="l00181"></a>00181 <span class="comment"> /** The account with which the client authenticated. */</span>
204
- <a name="l00182"></a><a class="code" href="classPassenger_1_1MessageServer_1_1CommonClientContext.html#f12e379a0f334d695071aceadc9d1343">00182</a> AccountPtr <a class="code" href="classPassenger_1_1MessageServer_1_1CommonClientContext.html#f12e379a0f334d695071aceadc9d1343" title="The account with which the client authenticated.">account</a>;
205
- <a name="l00183"></a>00183
206
- <a name="l00184"></a>00184
207
- <a name="l00185"></a>00185 <a class="code" href="classPassenger_1_1MessageServer_1_1CommonClientContext.html" title="A common client context, containing client-specific information used by MessageServer...">CommonClientContext</a>(<a class="code" href="classPassenger_1_1FileDescriptor.html" title="Wrapper class around a file descriptor integer, for RAII behavior.">FileDescriptor</a> &amp;theFd, AccountPtr &amp;theAccount)
208
- <a name="l00186"></a>00186 : <a class="code" href="classPassenger_1_1MessageServer_1_1CommonClientContext.html#66485f4cbc9a23473b071924743c1c6f" title="The client&amp;#39;s socket file descriptor.">fd</a>(theFd), <a class="code" href="classPassenger_1_1MessageServer_1_1CommonClientContext.html#1401aab009ce4f77c4e3aba1990c8f4a" title="The channel that&amp;#39;s associated with the client&amp;#39;s socket.">channel</a>(theFd), <a class="code" href="classPassenger_1_1MessageServer_1_1CommonClientContext.html#f12e379a0f334d695071aceadc9d1343" title="The account with which the client authenticated.">account</a>(theAccount)
209
- <a name="l00187"></a>00187 { }
210
- <a name="l00188"></a>00188 <span class="comment"></span>
211
- <a name="l00189"></a>00189 <span class="comment"> /** Returns a string representation for this client context. */</span>
212
- <a name="l00190"></a><a class="code" href="classPassenger_1_1MessageServer_1_1CommonClientContext.html#74c5f4696c7c7bbd16cd8677d856003b">00190</a> <span class="keywordtype">string</span> <a class="code" href="classPassenger_1_1MessageServer_1_1CommonClientContext.html#74c5f4696c7c7bbd16cd8677d856003b" title="Returns a string representation for this client context.">name</a>() {
213
- <a name="l00191"></a>00191 <span class="keywordflow">return</span> <a class="code" href="group__Support.html#gf6fab368d70c18fdf16bf5a24f630407" title="Convert anything to a string.">toString</a>(<a class="code" href="classPassenger_1_1MessageServer_1_1CommonClientContext.html#1401aab009ce4f77c4e3aba1990c8f4a" title="The channel that&amp;#39;s associated with the client&amp;#39;s socket.">channel</a>.<a class="code" href="classPassenger_1_1MessageChannel.html#0b1e25dd75783d9753f8a0d1dd42606a" title="Returns the underlying file descriptor.">filenum</a>());
214
- <a name="l00192"></a>00192 }
215
- <a name="l00193"></a>00193 <span class="comment"></span>
216
- <a name="l00194"></a>00194 <span class="comment"> /**</span>
217
- <a name="l00195"></a>00195 <span class="comment"> * Checks whether this client has all of the rights in &lt;tt&gt;rights&lt;/tt&gt;. The</span>
218
- <a name="l00196"></a>00196 <span class="comment"> * client will be notified about the result of this check, by sending it a</span>
219
- <a name="l00197"></a>00197 <span class="comment"> * message.</span>
220
- <a name="l00198"></a>00198 <span class="comment"> *</span>
221
- <a name="l00199"></a>00199 <span class="comment"> * @throws SecurityException The client doesn't have one of the required rights.</span>
222
- <a name="l00200"></a>00200 <span class="comment"> * @throws SystemException Something went wrong while communicating with the client.</span>
223
- <a name="l00201"></a>00201 <span class="comment"> * @throws boost::thread_interrupted</span>
224
- <a name="l00202"></a>00202 <span class="comment"> */</span>
225
- <a name="l00203"></a><a class="code" href="classPassenger_1_1MessageServer_1_1CommonClientContext.html#57a0ea308db6512e00a3526cb41be867">00203</a> <span class="keywordtype">void</span> <a class="code" href="classPassenger_1_1MessageServer_1_1CommonClientContext.html#57a0ea308db6512e00a3526cb41be867" title="Checks whether this client has all of the rights in rights.">requireRights</a>(Account::Rights rights) {
226
- <a name="l00204"></a>00204 <span class="keywordflow">if</span> (!<a class="code" href="classPassenger_1_1MessageServer_1_1CommonClientContext.html#f12e379a0f334d695071aceadc9d1343" title="The account with which the client authenticated.">account</a>-&gt;hasRights(rights)) {
227
- <a name="l00205"></a>00205 P_TRACE(2, <span class="stringliteral">"Security error: insufficient rights to execute this command."</span>);
228
- <a name="l00206"></a>00206 <a class="code" href="classPassenger_1_1MessageServer_1_1CommonClientContext.html#1401aab009ce4f77c4e3aba1990c8f4a" title="The channel that&amp;#39;s associated with the client&amp;#39;s socket.">channel</a>.<a class="code" href="classPassenger_1_1MessageChannel.html#150f68bc47e060dcc6ca35bee047914d" title="Send an array message, which consists of the given elements, over the underlying...">write</a>(<span class="stringliteral">"SecurityException"</span>, <span class="stringliteral">"Insufficient rights to execute this command."</span>, NULL);
229
- <a name="l00207"></a>00207 <span class="keywordflow">throw</span> <a class="code" href="classPassenger_1_1SecurityException.html" title="Represents some kind of security error.">SecurityException</a>(<span class="stringliteral">"Insufficient rights to execute this command."</span>);
230
- <a name="l00208"></a>00208 } <span class="keywordflow">else</span> {
231
- <a name="l00209"></a>00209 <a class="code" href="classPassenger_1_1MessageServer_1_1CommonClientContext.html#1401aab009ce4f77c4e3aba1990c8f4a" title="The channel that&amp;#39;s associated with the client&amp;#39;s socket.">channel</a>.<a class="code" href="classPassenger_1_1MessageChannel.html#150f68bc47e060dcc6ca35bee047914d" title="Send an array message, which consists of the given elements, over the underlying...">write</a>(<span class="stringliteral">"Passed security"</span>, NULL);
232
- <a name="l00210"></a>00210 }
233
- <a name="l00211"></a>00211 }
234
- <a name="l00212"></a>00212 };
235
- <a name="l00213"></a>00213 <span class="comment"></span>
236
- <a name="l00214"></a>00214 <span class="comment"> /**</span>
237
- <a name="l00215"></a>00215 <span class="comment"> * An abstract message handler class.</span>
238
- <a name="l00216"></a>00216 <span class="comment"> *</span>
239
- <a name="l00217"></a>00217 <span class="comment"> * The methods defined in this class are allowed to throw arbitrary exceptions.</span>
240
- <a name="l00218"></a>00218 <span class="comment"> * Such exceptions are caught and logged, after which the connection to the</span>
241
- <a name="l00219"></a>00219 <span class="comment"> * client is closed.</span>
242
- <a name="l00220"></a>00220 <span class="comment"> */</span>
243
- <a name="l00221"></a><a class="code" href="classPassenger_1_1MessageServer_1_1Handler.html">00221</a> <span class="keyword">class </span><a class="code" href="classPassenger_1_1MessageServer_1_1Handler.html" title="An abstract message handler class.">Handler</a> {
244
- <a name="l00222"></a>00222 <span class="keyword">public</span>:
245
- <a name="l00223"></a>00223 <span class="keyword">virtual</span> ~<a class="code" href="classPassenger_1_1MessageServer_1_1Handler.html" title="An abstract message handler class.">Handler</a>() { }
246
- <a name="l00224"></a>00224 <span class="comment"></span>
247
- <a name="l00225"></a>00225 <span class="comment"> /**</span>
248
- <a name="l00226"></a>00226 <span class="comment"> * Called when a new client has connected to the MessageServer.</span>
249
- <a name="l00227"></a>00227 <span class="comment"> *</span>
250
- <a name="l00228"></a>00228 <span class="comment"> * This method is called after the client has authenticated itself.</span>
251
- <a name="l00229"></a>00229 <span class="comment"> *</span>
252
- <a name="l00230"></a>00230 <span class="comment"> * @param context Contains common client-specific information.</span>
253
- <a name="l00231"></a>00231 <span class="comment"> * @return A client context object for storing handler-specific client</span>
254
- <a name="l00232"></a>00232 <span class="comment"> * information, or null. The default implementation returns null.</span>
255
- <a name="l00233"></a>00233 <span class="comment"> */</span>
256
- <a name="l00234"></a><a class="code" href="classPassenger_1_1MessageServer_1_1Handler.html#3dcae8f3416eba769b4971083eeaee8d">00234</a> <span class="keyword">virtual</span> ClientContextPtr <a class="code" href="classPassenger_1_1MessageServer_1_1Handler.html#3dcae8f3416eba769b4971083eeaee8d" title="Called when a new client has connected to the MessageServer.">newClient</a>(<a class="code" href="classPassenger_1_1MessageServer_1_1CommonClientContext.html" title="A common client context, containing client-specific information used by MessageServer...">CommonClientContext</a> &amp;context) {
257
- <a name="l00235"></a>00235 <span class="keywordflow">return</span> ClientContextPtr();
258
- <a name="l00236"></a>00236 }
259
- <a name="l00237"></a>00237 <span class="comment"></span>
260
- <a name="l00238"></a>00238 <span class="comment"> /**</span>
261
- <a name="l00239"></a>00239 <span class="comment"> * Called when a client has disconnected from the MessageServer. The</span>
262
- <a name="l00240"></a>00240 <span class="comment"> * default implementation does nothing.</span>
263
- <a name="l00241"></a>00241 <span class="comment"> *</span>
264
- <a name="l00242"></a>00242 <span class="comment"> * This method is called even if processMessage() throws an exception.</span>
265
- <a name="l00243"></a>00243 <span class="comment"> * It is however not called if newClient() throws an exception.</span>
266
- <a name="l00244"></a>00244 <span class="comment"> *</span>
267
- <a name="l00245"></a>00245 <span class="comment"> * @param commonContext Contains common client-specific information.</span>
268
- <a name="l00246"></a>00246 <span class="comment"> * @param handlerSpecificContext The client context object as was returned</span>
269
- <a name="l00247"></a>00247 <span class="comment"> * earlier by newClient().</span>
270
- <a name="l00248"></a>00248 <span class="comment"> */</span>
271
- <a name="l00249"></a><a class="code" href="classPassenger_1_1MessageServer_1_1Handler.html#63bf8b0539e86e862cfc2defe6dc9300">00249</a> <span class="keyword">virtual</span> <span class="keywordtype">void</span> <a class="code" href="classPassenger_1_1MessageServer_1_1Handler.html#63bf8b0539e86e862cfc2defe6dc9300" title="Called when a client has disconnected from the MessageServer.">clientDisconnected</a>(<a class="code" href="classPassenger_1_1MessageServer_1_1CommonClientContext.html" title="A common client context, containing client-specific information used by MessageServer...">MessageServer::CommonClientContext</a> &amp;context,
272
- <a name="l00250"></a>00250 MessageServer::ClientContextPtr &amp;handlerSpecificContext)
273
- <a name="l00251"></a>00251 { }
274
- <a name="l00252"></a>00252 <span class="comment"></span>
275
- <a name="l00253"></a>00253 <span class="comment"> /**</span>
276
- <a name="l00254"></a>00254 <span class="comment"> * Called then a client has sent a request message.</span>
277
- <a name="l00255"></a>00255 <span class="comment"> *</span>
278
- <a name="l00256"></a>00256 <span class="comment"> * This method is called after newClient() is called.</span>
279
- <a name="l00257"></a>00257 <span class="comment"> *</span>
280
- <a name="l00258"></a>00258 <span class="comment"> * @param commonContext Contains common client-specific information.</span>
281
- <a name="l00259"></a>00259 <span class="comment"> * @param handlerSpecificContext The client context object as was returned</span>
282
- <a name="l00260"></a>00260 <span class="comment"> * earlier by newClient().</span>
283
- <a name="l00261"></a>00261 <span class="comment"> * @param args The request message's contents.</span>
284
- <a name="l00262"></a>00262 <span class="comment"> * @return Whether this handler has processed the message. Return false</span>
285
- <a name="l00263"></a>00263 <span class="comment"> * if the message is unrecognized.</span>
286
- <a name="l00264"></a>00264 <span class="comment"> */</span>
287
- <a name="l00265"></a>00265 <span class="keyword">virtual</span> <span class="keywordtype">bool</span> <a class="code" href="classPassenger_1_1MessageServer_1_1Handler.html#4bc6162024c6e2bc450f8772897a628d" title="Called then a client has sent a request message.">processMessage</a>(<a class="code" href="classPassenger_1_1MessageServer_1_1CommonClientContext.html" title="A common client context, containing client-specific information used by MessageServer...">CommonClientContext</a> &amp;commonContext,
288
- <a name="l00266"></a>00266 ClientContextPtr &amp;handlerSpecificContext,
289
- <a name="l00267"></a>00267 <span class="keyword">const</span> vector&lt;string&gt; &amp;args) = 0;
290
- <a name="l00268"></a>00268 };
291
- <a name="l00269"></a>00269
292
- <a name="l00270"></a>00270 <span class="keyword">typedef</span> shared_ptr&lt;Handler&gt; HandlerPtr;
293
- <a name="l00271"></a>00271
294
- <a name="l00272"></a>00272 <span class="keyword">protected</span>:<span class="comment"></span>
295
- <a name="l00273"></a>00273 <span class="comment"> /** The filename of the server socket on which this MessageServer is listening. */</span>
296
- <a name="l00274"></a><a class="code" href="classPassenger_1_1MessageServer.html#18f4966401ab1f1ef245af922b382ce3">00274</a> <span class="keywordtype">string</span> <a class="code" href="classPassenger_1_1MessageServer.html#18f4966401ab1f1ef245af922b382ce3" title="The filename of the server socket on which this MessageServer is listening.">socketFilename</a>;
297
- <a name="l00275"></a>00275 <span class="comment"></span>
298
- <a name="l00276"></a>00276 <span class="comment"> /** An accounts database, used for authenticating clients. */</span>
299
- <a name="l00277"></a><a class="code" href="classPassenger_1_1MessageServer.html#4705130bf6626dd2201e7d73ead57b93">00277</a> AccountsDatabasePtr <a class="code" href="classPassenger_1_1MessageServer.html#4705130bf6626dd2201e7d73ead57b93" title="An accounts database, used for authenticating clients.">accountsDatabase</a>;
300
- <a name="l00278"></a>00278 <span class="comment"></span>
301
- <a name="l00279"></a>00279 <span class="comment"> /** The registered message handlers. */</span>
302
- <a name="l00280"></a><a class="code" href="classPassenger_1_1MessageServer.html#bced7a8e542f6ab4a81ac1b11f8d163a">00280</a> vector&lt;HandlerPtr&gt; <a class="code" href="classPassenger_1_1MessageServer.html#bced7a8e542f6ab4a81ac1b11f8d163a" title="The registered message handlers.">handlers</a>;
303
- <a name="l00281"></a>00281 <span class="comment"></span>
304
- <a name="l00282"></a>00282 <span class="comment"> /** The maximum number of milliseconds that client may spend on logging in.</span>
305
- <a name="l00283"></a>00283 <span class="comment"> * Clients that take longer are disconnected.</span>
306
- <a name="l00284"></a>00284 <span class="comment"> *</span>
307
- <a name="l00285"></a>00285 <span class="comment"> * @invariant loginTimeout != 0</span>
308
- <a name="l00286"></a>00286 <span class="comment"> */</span>
309
- <a name="l00287"></a><a class="code" href="classPassenger_1_1MessageServer.html#bf5075add15c5f32a60039bdcbe98926">00287</a> <span class="keywordtype">unsigned</span> <span class="keywordtype">long</span> <span class="keywordtype">long</span> <a class="code" href="classPassenger_1_1MessageServer.html#bf5075add15c5f32a60039bdcbe98926" title="The maximum number of milliseconds that client may spend on logging in.">loginTimeout</a>;
310
- <a name="l00288"></a>00288 <span class="comment"></span>
311
- <a name="l00289"></a>00289 <span class="comment"> /** The client threads. */</span>
312
- <a name="l00290"></a><a class="code" href="classPassenger_1_1MessageServer.html#48ccf2c09c2c8b5dcfe3a0585dba67cf">00290</a> dynamic_thread_group <a class="code" href="classPassenger_1_1MessageServer.html#48ccf2c09c2c8b5dcfe3a0585dba67cf" title="The client threads.">threadGroup</a>;
313
- <a name="l00291"></a>00291 <span class="comment"></span>
314
- <a name="l00292"></a>00292 <span class="comment"> /** The server socket's file descriptor.</span>
315
- <a name="l00293"></a>00293 <span class="comment"> * @invariant serverFd &gt;= 0</span>
316
- <a name="l00294"></a>00294 <span class="comment"> */</span>
317
- <a name="l00295"></a><a class="code" href="classPassenger_1_1MessageServer.html#ef3c642484fbbbfc46b7768c53a5c0d4">00295</a> <span class="keywordtype">int</span> <a class="code" href="classPassenger_1_1MessageServer.html#ef3c642484fbbbfc46b7768c53a5c0d4" title="The server socket&amp;#39;s file descriptor.">serverFd</a>;
318
- <a name="l00296"></a>00296
319
- <a name="l00297"></a>00297 <span class="comment"></span>
320
- <a name="l00298"></a>00298 <span class="comment"> /** Calls clientDisconnected() on all handlers when destroyed. */</span>
321
- <a name="l00299"></a><a class="code" href="structPassenger_1_1MessageServer_1_1DisconnectEventBroadcastGuard.html">00299</a> <span class="keyword">struct </span><a class="code" href="structPassenger_1_1MessageServer_1_1DisconnectEventBroadcastGuard.html" title="Calls clientDisconnected() on all handlers when destroyed.">DisconnectEventBroadcastGuard</a> {
322
- <a name="l00300"></a>00300 vector&lt;HandlerPtr&gt; &amp;handlers;
323
- <a name="l00301"></a>00301 <a class="code" href="classPassenger_1_1MessageServer_1_1CommonClientContext.html" title="A common client context, containing client-specific information used by MessageServer...">CommonClientContext</a> &amp;commonContext;
324
- <a name="l00302"></a>00302 vector&lt;ClientContextPtr&gt; &amp;handlerSpecificContexts;
325
- <a name="l00303"></a>00303
326
- <a name="l00304"></a>00304 <a class="code" href="structPassenger_1_1MessageServer_1_1DisconnectEventBroadcastGuard.html" title="Calls clientDisconnected() on all handlers when destroyed.">DisconnectEventBroadcastGuard</a>(vector&lt;HandlerPtr&gt; &amp;_handlers,
327
- <a name="l00305"></a>00305 <a class="code" href="classPassenger_1_1MessageServer_1_1CommonClientContext.html" title="A common client context, containing client-specific information used by MessageServer...">CommonClientContext</a> &amp;_commonContext,
328
- <a name="l00306"></a>00306 vector&lt;ClientContextPtr&gt; &amp;_handlerSpecificContexts)
329
- <a name="l00307"></a>00307 : handlers(_handlers),
330
- <a name="l00308"></a>00308 commonContext(_commonContext),
331
- <a name="l00309"></a>00309 handlerSpecificContexts(_handlerSpecificContexts)
332
- <a name="l00310"></a>00310 { }
333
- <a name="l00311"></a>00311
334
- <a name="l00312"></a>00312 ~<a class="code" href="structPassenger_1_1MessageServer_1_1DisconnectEventBroadcastGuard.html" title="Calls clientDisconnected() on all handlers when destroyed.">DisconnectEventBroadcastGuard</a>() {
335
- <a name="l00313"></a>00313 vector&lt;HandlerPtr&gt;::iterator handler_iter;
336
- <a name="l00314"></a>00314 vector&lt;ClientContextPtr&gt;::iterator context_iter;
337
- <a name="l00315"></a>00315
338
- <a name="l00316"></a>00316 <span class="keywordflow">for</span> (handler_iter = handlers.begin(), context_iter = handlerSpecificContexts.begin();
339
- <a name="l00317"></a>00317 handler_iter != handlers.end();
340
- <a name="l00318"></a>00318 handler_iter++, context_iter++) {
341
- <a name="l00319"></a>00319 (*handler_iter)-&gt;clientDisconnected(commonContext, *context_iter);
342
- <a name="l00320"></a>00320 }
343
- <a name="l00321"></a>00321 }
344
- <a name="l00322"></a>00322 };
345
- <a name="l00323"></a>00323
346
- <a name="l00324"></a>00324 <span class="comment"></span>
347
- <a name="l00325"></a>00325 <span class="comment"> /**</span>
348
- <a name="l00326"></a>00326 <span class="comment"> * Create a server socket and set it up for listening. This socket will</span>
349
- <a name="l00327"></a>00327 <span class="comment"> * be world-writable.</span>
350
- <a name="l00328"></a>00328 <span class="comment"> *</span>
351
- <a name="l00329"></a>00329 <span class="comment"> * @throws RuntimeException</span>
352
- <a name="l00330"></a>00330 <span class="comment"> * @throws SystemException</span>
353
- <a name="l00331"></a>00331 <span class="comment"> * @throws boost::thread_interrupted</span>
354
- <a name="l00332"></a>00332 <span class="comment"> */</span>
355
- <a name="l00333"></a><a class="code" href="classPassenger_1_1MessageServer.html#86f9ec99fe5dbed5c04d4b9e8f170995">00333</a> <span class="keywordtype">void</span> <a class="code" href="classPassenger_1_1MessageServer.html#86f9ec99fe5dbed5c04d4b9e8f170995" title="Create a server socket and set it up for listening.">startListening</a>() {
356
- <a name="l00334"></a>00334 TRACE_POINT();
357
- <a name="l00335"></a>00335 <span class="keywordtype">int</span> ret;
358
- <a name="l00336"></a>00336
359
- <a name="l00337"></a>00337 <a class="code" href="classPassenger_1_1MessageServer.html#ef3c642484fbbbfc46b7768c53a5c0d4" title="The server socket&amp;#39;s file descriptor.">serverFd</a> = <a class="code" href="group__Support.html#g5d3b342a34d81e7506744e90ee2f9b8b" title="Create a new Unix server socket which is bounded to filename.">createUnixServer</a>(<a class="code" href="classPassenger_1_1MessageServer.html#18f4966401ab1f1ef245af922b382ce3" title="The filename of the server socket on which this MessageServer is listening.">socketFilename</a>.c_str());
360
- <a name="l00338"></a>00338 <span class="keywordflow">do</span> {
361
- <a name="l00339"></a>00339 ret = chmod(<a class="code" href="classPassenger_1_1MessageServer.html#18f4966401ab1f1ef245af922b382ce3" title="The filename of the server socket on which this MessageServer is listening.">socketFilename</a>.c_str(),
362
- <a name="l00340"></a>00340 S_ISVTX |
363
- <a name="l00341"></a>00341 S_IRUSR | S_IWUSR | S_IXUSR |
364
- <a name="l00342"></a>00342 S_IRGRP | S_IWGRP | S_IXGRP |
365
- <a name="l00343"></a>00343 S_IROTH | S_IWOTH | S_IXOTH);
366
- <a name="l00344"></a>00344 } <span class="keywordflow">while</span> (ret == -1 &amp;&amp; errno == EINTR);
367
- <a name="l00345"></a>00345 }
368
- <a name="l00346"></a>00346 <span class="comment"></span>
369
- <a name="l00347"></a>00347 <span class="comment"> /**</span>
370
- <a name="l00348"></a>00348 <span class="comment"> * Authenticate the given client and returns its account information.</span>
371
- <a name="l00349"></a>00349 <span class="comment"> *</span>
372
- <a name="l00350"></a>00350 <span class="comment"> * @return A smart pointer to an Account object, or NULL if authentication failed.</span>
373
- <a name="l00351"></a>00351 <span class="comment"> */</span>
374
- <a name="l00352"></a><a class="code" href="classPassenger_1_1MessageServer.html#6687fdc90ef1c361a69c0fdcde38bb42">00352</a> AccountPtr <a class="code" href="classPassenger_1_1MessageServer.html#6687fdc90ef1c361a69c0fdcde38bb42" title="Authenticate the given client and returns its account information.">authenticate</a>(<a class="code" href="classPassenger_1_1FileDescriptor.html" title="Wrapper class around a file descriptor integer, for RAII behavior.">FileDescriptor</a> &amp;client) {
375
- <a name="l00353"></a>00353 <a class="code" href="classPassenger_1_1MessageChannel.html" title="Convenience class for I/O operations on file descriptors.">MessageChannel</a> channel(client);
376
- <a name="l00354"></a>00354 <span class="keywordtype">string</span> username, password;
377
- <a name="l00355"></a>00355 <a class="code" href="classPassenger_1_1MemZeroGuard.html" title="Fills the given memory space or string with zeroes when a MemoryZeroGuard object...">MemZeroGuard</a> passwordGuard(password);
378
- <a name="l00356"></a>00356 <span class="keywordtype">unsigned</span> <span class="keywordtype">long</span> <span class="keywordtype">long</span> timeout = <a class="code" href="classPassenger_1_1MessageServer.html#bf5075add15c5f32a60039bdcbe98926" title="The maximum number of milliseconds that client may spend on logging in.">loginTimeout</a>;
379
- <a name="l00357"></a>00357
380
- <a name="l00358"></a>00358 <span class="keywordflow">try</span> {
381
- <a name="l00359"></a>00359 <span class="keywordflow">try</span> {
382
- <a name="l00360"></a>00360 <span class="keywordflow">if</span> (!channel.<a class="code" href="classPassenger_1_1MessageChannel.html#1f3cf672b566166ed920c2bba4d19604" title="Read a scalar message from the underlying file descriptor.">readScalar</a>(username, 50, &amp;timeout)) {
383
- <a name="l00361"></a>00361 <span class="keywordflow">return</span> AccountPtr();
384
- <a name="l00362"></a>00362 }
385
- <a name="l00363"></a>00363 } <span class="keywordflow">catch</span> (<span class="keyword">const</span> <a class="code" href="classPassenger_1_1SecurityException.html" title="Represents some kind of security error.">SecurityException</a> &amp;) {
386
- <a name="l00364"></a>00364 channel.<a class="code" href="classPassenger_1_1MessageChannel.html#150f68bc47e060dcc6ca35bee047914d" title="Send an array message, which consists of the given elements, over the underlying...">write</a>(<span class="stringliteral">"The supplied username is too long."</span>, NULL);
387
- <a name="l00365"></a>00365 <span class="keywordflow">return</span> AccountPtr();
388
- <a name="l00366"></a>00366 }
389
- <a name="l00367"></a>00367
390
- <a name="l00368"></a>00368 <span class="keywordflow">try</span> {
391
- <a name="l00369"></a>00369 <span class="keywordflow">if</span> (!channel.<a class="code" href="classPassenger_1_1MessageChannel.html#1f3cf672b566166ed920c2bba4d19604" title="Read a scalar message from the underlying file descriptor.">readScalar</a>(password, MESSAGE_SERVER_MAX_PASSWORD_SIZE, &amp;timeout)) {
392
- <a name="l00370"></a>00370 <span class="keywordflow">return</span> AccountPtr();
393
- <a name="l00371"></a>00371 }
394
- <a name="l00372"></a>00372 } <span class="keywordflow">catch</span> (<span class="keyword">const</span> <a class="code" href="classPassenger_1_1SecurityException.html" title="Represents some kind of security error.">SecurityException</a> &amp;) {
395
- <a name="l00373"></a>00373 channel.<a class="code" href="classPassenger_1_1MessageChannel.html#150f68bc47e060dcc6ca35bee047914d" title="Send an array message, which consists of the given elements, over the underlying...">write</a>(<span class="stringliteral">"The supplied password is too long."</span>, NULL);
396
- <a name="l00374"></a>00374 <span class="keywordflow">return</span> AccountPtr();
397
- <a name="l00375"></a>00375 }
398
- <a name="l00376"></a>00376
399
- <a name="l00377"></a>00377 AccountPtr account = <a class="code" href="classPassenger_1_1MessageServer.html#4705130bf6626dd2201e7d73ead57b93" title="An accounts database, used for authenticating clients.">accountsDatabase</a>-&gt;authenticate(username, password);
400
- <a name="l00378"></a>00378 passwordGuard.<a class="code" href="classPassenger_1_1MemZeroGuard.html#fbefb3b41c341bcaeaa9c23f698df15c" title="Zero the data immediately.">zeroNow</a>();
401
- <a name="l00379"></a>00379 <span class="keywordflow">if</span> (account == NULL) {
402
- <a name="l00380"></a>00380 channel.<a class="code" href="classPassenger_1_1MessageChannel.html#150f68bc47e060dcc6ca35bee047914d" title="Send an array message, which consists of the given elements, over the underlying...">write</a>(<span class="stringliteral">"Invalid username or password."</span>, NULL);
403
- <a name="l00381"></a>00381 <span class="keywordflow">return</span> AccountPtr();
404
- <a name="l00382"></a>00382 } <span class="keywordflow">else</span> {
405
- <a name="l00383"></a>00383 channel.<a class="code" href="classPassenger_1_1MessageChannel.html#150f68bc47e060dcc6ca35bee047914d" title="Send an array message, which consists of the given elements, over the underlying...">write</a>(<span class="stringliteral">"ok"</span>, NULL);
406
- <a name="l00384"></a>00384 <span class="keywordflow">return</span> account;
407
- <a name="l00385"></a>00385 }
408
- <a name="l00386"></a>00386 } <span class="keywordflow">catch</span> (<span class="keyword">const</span> <a class="code" href="classPassenger_1_1SystemException.html" title="Represents an error returned by a system call or a standard library call.">SystemException</a> &amp;) {
409
- <a name="l00387"></a>00387 <span class="keywordflow">return</span> AccountPtr();
410
- <a name="l00388"></a>00388 } <span class="keywordflow">catch</span> (<span class="keyword">const</span> <a class="code" href="classPassenger_1_1TimeoutException.html" title="An exception indicating that some timeout expired.">TimeoutException</a> &amp;) {
411
- <a name="l00389"></a>00389 <span class="keywordflow">return</span> AccountPtr();
412
- <a name="l00390"></a>00390 }
413
- <a name="l00391"></a>00391 }
414
- <a name="l00392"></a>00392
415
- <a name="l00393"></a>00393 <span class="keywordtype">void</span> broadcastNewClientEvent(CommonClientContext &amp;context,
416
- <a name="l00394"></a>00394 vector&lt;ClientContextPtr&gt; &amp;handlerSpecificContexts) {
417
- <a name="l00395"></a>00395 vector&lt;HandlerPtr&gt;::iterator it;
418
- <a name="l00396"></a>00396
419
- <a name="l00397"></a>00397 <span class="keywordflow">for</span> (it = <a class="code" href="classPassenger_1_1MessageServer.html#bced7a8e542f6ab4a81ac1b11f8d163a" title="The registered message handlers.">handlers</a>.begin(); it != <a class="code" href="classPassenger_1_1MessageServer.html#bced7a8e542f6ab4a81ac1b11f8d163a" title="The registered message handlers.">handlers</a>.end(); it++) {
420
- <a name="l00398"></a>00398 handlerSpecificContexts.push_back((*it)-&gt;newClient(context));
421
- <a name="l00399"></a>00399 }
422
- <a name="l00400"></a>00400 }
423
- <a name="l00401"></a>00401
424
- <a name="l00402"></a>00402 <span class="keywordtype">bool</span> processMessage(CommonClientContext &amp;commonContext,
425
- <a name="l00403"></a>00403 vector&lt;ClientContextPtr&gt; &amp;handlerSpecificContexts,
426
- <a name="l00404"></a>00404 <span class="keyword">const</span> vector&lt;string&gt; &amp;args) {
427
- <a name="l00405"></a>00405 vector&lt;HandlerPtr&gt;::iterator handler_iter;
428
- <a name="l00406"></a>00406 vector&lt;ClientContextPtr&gt;::iterator context_iter;
429
- <a name="l00407"></a>00407
430
- <a name="l00408"></a>00408 <span class="keywordflow">for</span> (handler_iter = <a class="code" href="classPassenger_1_1MessageServer.html#bced7a8e542f6ab4a81ac1b11f8d163a" title="The registered message handlers.">handlers</a>.begin(), context_iter = handlerSpecificContexts.begin();
431
- <a name="l00409"></a>00409 handler_iter != <a class="code" href="classPassenger_1_1MessageServer.html#bced7a8e542f6ab4a81ac1b11f8d163a" title="The registered message handlers.">handlers</a>.end();
432
- <a name="l00410"></a>00410 handler_iter++, context_iter++) {
433
- <a name="l00411"></a>00411 <span class="keywordflow">if</span> ((*handler_iter)-&gt;processMessage(commonContext, *context_iter, args)) {
434
- <a name="l00412"></a>00412 <span class="keywordflow">return</span> <span class="keyword">true</span>;
435
- <a name="l00413"></a>00413 }
436
- <a name="l00414"></a>00414 }
437
- <a name="l00415"></a>00415 <span class="keywordflow">return</span> <span class="keyword">false</span>;
438
- <a name="l00416"></a>00416 }
439
- <a name="l00417"></a>00417
440
- <a name="l00418"></a>00418 <span class="keywordtype">void</span> processUnknownMessage(CommonClientContext &amp;commonContext, <span class="keyword">const</span> vector&lt;string&gt; &amp;args) {
441
- <a name="l00419"></a>00419 TRACE_POINT();
442
- <a name="l00420"></a>00420 <span class="keywordtype">string</span> name;
443
- <a name="l00421"></a>00421 <span class="keywordflow">if</span> (args.empty()) {
444
- <a name="l00422"></a>00422 name = <span class="stringliteral">"(null)"</span>;
445
- <a name="l00423"></a>00423 } <span class="keywordflow">else</span> {
446
- <a name="l00424"></a>00424 name = args[0];
447
- <a name="l00425"></a>00425 }
448
- <a name="l00426"></a>00426 P_TRACE(2, <span class="stringliteral">"A MessageServer client sent an invalid command: "</span>
449
- <a name="l00427"></a>00427 &lt;&lt; name &lt;&lt; <span class="stringliteral">" ("</span> &lt;&lt; args.size() &lt;&lt; <span class="stringliteral">" elements)"</span>);
450
- <a name="l00428"></a>00428 }
451
- <a name="l00429"></a>00429 <span class="comment"></span>
452
- <a name="l00430"></a>00430 <span class="comment"> /**</span>
453
- <a name="l00431"></a>00431 <span class="comment"> * The main function for a thread which handles a client.</span>
454
- <a name="l00432"></a>00432 <span class="comment"> */</span>
455
- <a name="l00433"></a><a class="code" href="classPassenger_1_1MessageServer.html#c7d708f90b3a1b1ae5e7b215c688c95e">00433</a> <span class="keywordtype">void</span> <a class="code" href="classPassenger_1_1MessageServer.html#c7d708f90b3a1b1ae5e7b215c688c95e" title="The main function for a thread which handles a client.">clientHandlingMainLoop</a>(<a class="code" href="classPassenger_1_1FileDescriptor.html" title="Wrapper class around a file descriptor integer, for RAII behavior.">FileDescriptor</a> &amp;client) {
456
- <a name="l00434"></a>00434 TRACE_POINT();
457
- <a name="l00435"></a>00435 vector&lt;string&gt; args;
458
- <a name="l00436"></a>00436
459
- <a name="l00437"></a>00437 P_TRACE(4, <span class="stringliteral">"MessageServer client thread "</span> &lt;&lt; (<span class="keywordtype">int</span>) client &lt;&lt; <span class="stringliteral">" started."</span>);
460
- <a name="l00438"></a>00438
461
- <a name="l00439"></a>00439 <span class="keywordflow">try</span> {
462
- <a name="l00440"></a>00440 AccountPtr account(<a class="code" href="classPassenger_1_1MessageServer.html#6687fdc90ef1c361a69c0fdcde38bb42" title="Authenticate the given client and returns its account information.">authenticate</a>(client));
463
- <a name="l00441"></a>00441 <span class="keywordflow">if</span> (account == NULL) {
464
- <a name="l00442"></a>00442 P_TRACE(4, <span class="stringliteral">"MessageServer client thread "</span> &lt;&lt; (<span class="keywordtype">int</span>) client &lt;&lt; <span class="stringliteral">" exited."</span>);
465
- <a name="l00443"></a>00443 <span class="keywordflow">return</span>;
466
- <a name="l00444"></a>00444 }
467
- <a name="l00445"></a>00445
468
- <a name="l00446"></a>00446 <a class="code" href="classPassenger_1_1MessageServer_1_1CommonClientContext.html" title="A common client context, containing client-specific information used by MessageServer...">CommonClientContext</a> commonContext(client, account);
469
- <a name="l00447"></a>00447 vector&lt;ClientContextPtr&gt; handlerSpecificContexts;
470
- <a name="l00448"></a>00448 broadcastNewClientEvent(commonContext, handlerSpecificContexts);
471
- <a name="l00449"></a>00449 <a class="code" href="structPassenger_1_1MessageServer_1_1DisconnectEventBroadcastGuard.html" title="Calls clientDisconnected() on all handlers when destroyed.">DisconnectEventBroadcastGuard</a> dguard(<a class="code" href="classPassenger_1_1MessageServer.html#bced7a8e542f6ab4a81ac1b11f8d163a" title="The registered message handlers.">handlers</a>, commonContext, handlerSpecificContexts);
472
- <a name="l00450"></a>00450
473
- <a name="l00451"></a>00451 <span class="keywordflow">while</span> (!this_thread::interruption_requested()) {
474
- <a name="l00452"></a>00452 UPDATE_TRACE_POINT();
475
- <a name="l00453"></a>00453 <span class="keywordflow">if</span> (!commonContext.<a class="code" href="classPassenger_1_1MessageServer_1_1CommonClientContext.html#1401aab009ce4f77c4e3aba1990c8f4a" title="The channel that&amp;#39;s associated with the client&amp;#39;s socket.">channel</a>.<a class="code" href="classPassenger_1_1MessageChannel.html#129659b60d1a663337873d2af944431e" title="Read an array message from the underlying file descriptor.">read</a>(args)) {
476
- <a name="l00454"></a>00454 <span class="comment">// Client closed connection.</span>
477
- <a name="l00455"></a>00455 <span class="keywordflow">break</span>;
478
- <a name="l00456"></a>00456 }
479
- <a name="l00457"></a>00457
480
- <a name="l00458"></a>00458 P_TRACE(4, <span class="stringliteral">"MessageServer client "</span> &lt;&lt; commonContext.<a class="code" href="classPassenger_1_1MessageServer_1_1CommonClientContext.html#74c5f4696c7c7bbd16cd8677d856003b" title="Returns a string representation for this client context.">name</a>() &lt;&lt;
481
- <a name="l00459"></a>00459 <span class="stringliteral">": received message: "</span> &lt;&lt; <a class="code" href="group__Support.html#gf6fab368d70c18fdf16bf5a24f630407" title="Convert anything to a string.">toString</a>(args));
482
- <a name="l00460"></a>00460
483
- <a name="l00461"></a>00461 UPDATE_TRACE_POINT();
484
- <a name="l00462"></a>00462 <span class="keywordflow">if</span> (!processMessage(commonContext, handlerSpecificContexts, args)) {
485
- <a name="l00463"></a>00463 processUnknownMessage(commonContext, args);
486
- <a name="l00464"></a>00464 <span class="keywordflow">break</span>;
487
- <a name="l00465"></a>00465 }
488
- <a name="l00466"></a>00466 args.clear();
489
- <a name="l00467"></a>00467 }
490
- <a name="l00468"></a>00468
491
- <a name="l00469"></a>00469 client.<a class="code" href="classPassenger_1_1FileDescriptor.html#d7c1a99531181878cbab74a7400c5432" title="Close the underlying file descriptor.">close</a>();
492
- <a name="l00470"></a>00470 P_TRACE(4, <span class="stringliteral">"MessageServer client thread "</span> &lt;&lt; (<span class="keywordtype">int</span>) client &lt;&lt; <span class="stringliteral">" exited."</span>);
493
- <a name="l00471"></a>00471 } <span class="keywordflow">catch</span> (<span class="keyword">const</span> boost::thread_interrupted &amp;) {
494
- <a name="l00472"></a>00472 P_TRACE(2, <span class="stringliteral">"MessageServer client thread "</span> &lt;&lt; (<span class="keywordtype">int</span>) client &lt;&lt; <span class="stringliteral">" interrupted."</span>);
495
- <a name="l00473"></a>00473 } <span class="keywordflow">catch</span> (<span class="keyword">const</span> tracable_exception &amp;e) {
496
- <a name="l00474"></a>00474 P_TRACE(2, <span class="stringliteral">"An error occurred in a MessageServer client thread "</span> &lt;&lt; (<span class="keywordtype">int</span>) client &lt;&lt; <span class="stringliteral">":\n"</span>
497
- <a name="l00475"></a>00475 &lt;&lt; <span class="stringliteral">" message: "</span> &lt;&lt; <a class="code" href="group__Support.html#gf6fab368d70c18fdf16bf5a24f630407" title="Convert anything to a string.">toString</a>(args) &lt;&lt; <span class="stringliteral">"\n"</span>
498
- <a name="l00476"></a>00476 &lt;&lt; <span class="stringliteral">" exception: "</span> &lt;&lt; e.what() &lt;&lt; <span class="stringliteral">"\n"</span>
499
- <a name="l00477"></a>00477 &lt;&lt; <span class="stringliteral">" backtrace:\n"</span> &lt;&lt; e.backtrace());
500
- <a name="l00478"></a>00478 } <span class="keywordflow">catch</span> (<span class="keyword">const</span> std::exception &amp;e) {
501
- <a name="l00479"></a>00479 P_TRACE(2, <span class="stringliteral">"An error occurred in a MessageServer client thread "</span> &lt;&lt; (<span class="keywordtype">int</span>) client &lt;&lt;<span class="stringliteral">":\n"</span>
502
- <a name="l00480"></a>00480 &lt;&lt; <span class="stringliteral">" message: "</span> &lt;&lt; <a class="code" href="group__Support.html#gf6fab368d70c18fdf16bf5a24f630407" title="Convert anything to a string.">toString</a>(args) &lt;&lt; <span class="stringliteral">"\n"</span>
503
- <a name="l00481"></a>00481 &lt;&lt; <span class="stringliteral">" exception: "</span> &lt;&lt; e.what() &lt;&lt; <span class="stringliteral">"\n"</span>
504
- <a name="l00482"></a>00482 &lt;&lt; <span class="stringliteral">" backtrace: not available"</span>);
505
- <a name="l00483"></a>00483 } <span class="keywordflow">catch</span> (...) {
506
- <a name="l00484"></a>00484 P_TRACE(2, <span class="stringliteral">"An unknown exception occurred in a MessageServer client thread."</span>);
507
- <a name="l00485"></a>00485 }
508
- <a name="l00486"></a>00486 }
509
- <a name="l00487"></a>00487
510
- <a name="l00488"></a>00488 <span class="keyword">public</span>:<span class="comment"></span>
511
- <a name="l00489"></a>00489 <span class="comment"> /**</span>
512
- <a name="l00490"></a>00490 <span class="comment"> * Creates a new MessageServer object.</span>
513
- <a name="l00491"></a>00491 <span class="comment"> * The actual server main loop is not started until you call mainLoop().</span>
514
- <a name="l00492"></a>00492 <span class="comment"> *</span>
515
- <a name="l00493"></a>00493 <span class="comment"> * @param socketFilename The socket filename on which this MessageServer</span>
516
- <a name="l00494"></a>00494 <span class="comment"> * should be listening.</span>
517
- <a name="l00495"></a>00495 <span class="comment"> * @param accountsDatabase An accounts database for this server, used for</span>
518
- <a name="l00496"></a>00496 <span class="comment"> * authenticating clients.</span>
519
- <a name="l00497"></a>00497 <span class="comment"> * @throws RuntimeException Something went wrong while setting up the server socket.</span>
520
- <a name="l00498"></a>00498 <span class="comment"> * @throws SystemException Something went wrong while setting up the server socket.</span>
521
- <a name="l00499"></a>00499 <span class="comment"> * @throws boost::thread_interrupted</span>
522
- <a name="l00500"></a>00500 <span class="comment"> */</span>
523
- <a name="l00501"></a><a class="code" href="classPassenger_1_1MessageServer.html#4b6f33e66261116c2ec04b26e651dc18">00501</a> <a class="code" href="classPassenger_1_1MessageServer.html#4b6f33e66261116c2ec04b26e651dc18" title="Creates a new MessageServer object.">MessageServer</a>(<span class="keyword">const</span> <span class="keywordtype">string</span> &amp;<a class="code" href="classPassenger_1_1MessageServer.html#18f4966401ab1f1ef245af922b382ce3" title="The filename of the server socket on which this MessageServer is listening.">socketFilename</a>, AccountsDatabasePtr <a class="code" href="classPassenger_1_1MessageServer.html#4705130bf6626dd2201e7d73ead57b93" title="An accounts database, used for authenticating clients.">accountsDatabase</a>) {
524
- <a name="l00502"></a>00502 this-&gt;socketFilename = socketFilename;
525
- <a name="l00503"></a>00503 this-&gt;accountsDatabase = accountsDatabase;
526
- <a name="l00504"></a>00504 <a class="code" href="classPassenger_1_1MessageServer.html#bf5075add15c5f32a60039bdcbe98926" title="The maximum number of milliseconds that client may spend on logging in.">loginTimeout</a> = 2000;
527
- <a name="l00505"></a>00505 <a class="code" href="classPassenger_1_1MessageServer.html#86f9ec99fe5dbed5c04d4b9e8f170995" title="Create a server socket and set it up for listening.">startListening</a>();
528
- <a name="l00506"></a>00506 }
529
- <a name="l00507"></a>00507
530
- <a name="l00508"></a>00508 ~<a class="code" href="classPassenger_1_1MessageServer.html" title="Simple pluggable request/response messaging server framework.">MessageServer</a>() {
531
- <a name="l00509"></a>00509 this_thread::disable_syscall_interruption dsi;
532
- <a name="l00510"></a>00510 syscalls::close(<a class="code" href="classPassenger_1_1MessageServer.html#ef3c642484fbbbfc46b7768c53a5c0d4" title="The server socket&amp;#39;s file descriptor.">serverFd</a>);
533
- <a name="l00511"></a>00511 syscalls::unlink(<a class="code" href="classPassenger_1_1MessageServer.html#18f4966401ab1f1ef245af922b382ce3" title="The filename of the server socket on which this MessageServer is listening.">socketFilename</a>.c_str());
534
- <a name="l00512"></a>00512 }
535
- <a name="l00513"></a>00513
536
- <a name="l00514"></a>00514 <span class="keywordtype">string</span> getSocketFilename()<span class="keyword"> const </span>{
537
- <a name="l00515"></a>00515 <span class="keywordflow">return</span> <a class="code" href="classPassenger_1_1MessageServer.html#18f4966401ab1f1ef245af922b382ce3" title="The filename of the server socket on which this MessageServer is listening.">socketFilename</a>;
538
- <a name="l00516"></a>00516 }
539
- <a name="l00517"></a>00517 <span class="comment"></span>
540
- <a name="l00518"></a>00518 <span class="comment"> /**</span>
541
- <a name="l00519"></a>00519 <span class="comment"> * Starts the server main loop. This method will loop forever until some</span>
542
- <a name="l00520"></a>00520 <span class="comment"> * other thread interrupts the calling thread, or until an exception is raised.</span>
543
- <a name="l00521"></a>00521 <span class="comment"> *</span>
544
- <a name="l00522"></a>00522 <span class="comment"> * @throws SystemException Unable to accept a new connection. If this is a</span>
545
- <a name="l00523"></a>00523 <span class="comment"> * non-fatal error then you may call mainLoop() again</span>
546
- <a name="l00524"></a>00524 <span class="comment"> * to restart the server main loop.</span>
547
- <a name="l00525"></a>00525 <span class="comment"> * @throws boost::thread_interrupted The calling thread has been interrupted.</span>
548
- <a name="l00526"></a>00526 <span class="comment"> */</span>
549
- <a name="l00527"></a><a class="code" href="classPassenger_1_1MessageServer.html#af639d8228da241b957c707ef0f04c91">00527</a> <span class="keywordtype">void</span> <a class="code" href="classPassenger_1_1MessageServer.html#af639d8228da241b957c707ef0f04c91" title="Starts the server main loop.">mainLoop</a>() {
550
- <a name="l00528"></a>00528 TRACE_POINT();
551
- <a name="l00529"></a>00529 <span class="keywordflow">while</span> (<span class="keyword">true</span>) {
552
- <a name="l00530"></a>00530 this_thread::interruption_point();
553
- <a name="l00531"></a>00531 sockaddr_un addr;
554
- <a name="l00532"></a>00532 socklen_t len = <span class="keyword">sizeof</span>(addr);
555
- <a name="l00533"></a>00533 <a class="code" href="classPassenger_1_1FileDescriptor.html" title="Wrapper class around a file descriptor integer, for RAII behavior.">FileDescriptor</a> fd;
556
- <a name="l00534"></a>00534
557
- <a name="l00535"></a>00535 UPDATE_TRACE_POINT();
558
- <a name="l00536"></a>00536 fd = syscalls::accept(<a class="code" href="classPassenger_1_1MessageServer.html#ef3c642484fbbbfc46b7768c53a5c0d4" title="The server socket&amp;#39;s file descriptor.">serverFd</a>, (<span class="keyword">struct</span> sockaddr *) &amp;addr, &amp;len);
559
- <a name="l00537"></a>00537 <span class="keywordflow">if</span> (fd == -1) {
560
- <a name="l00538"></a>00538 <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">"Unable to accept a new client"</span>, errno);
561
- <a name="l00539"></a>00539 }
562
- <a name="l00540"></a>00540
563
- <a name="l00541"></a>00541 UPDATE_TRACE_POINT();
564
- <a name="l00542"></a>00542 this_thread::disable_interruption di;
565
- <a name="l00543"></a>00543 this_thread::disable_syscall_interruption dsi;
566
- <a name="l00544"></a>00544
567
- <a name="l00545"></a>00545 function&lt;void ()&gt; func(boost::bind(&amp;<a class="code" href="classPassenger_1_1MessageServer.html#c7d708f90b3a1b1ae5e7b215c688c95e" title="The main function for a thread which handles a client.">MessageServer::clientHandlingMainLoop</a>,
568
- <a name="l00546"></a>00546 <span class="keyword">this</span>, fd));
569
- <a name="l00547"></a>00547 <span class="keywordtype">string</span> name = <span class="stringliteral">"MessageServer client thread "</span>;
570
- <a name="l00548"></a>00548 name.append(<a class="code" href="group__Support.html#gf6fab368d70c18fdf16bf5a24f630407" title="Convert anything to a string.">toString</a>(fd));
571
- <a name="l00549"></a>00549 <a class="code" href="classPassenger_1_1MessageServer.html#48ccf2c09c2c8b5dcfe3a0585dba67cf" title="The client threads.">threadGroup</a>.create_thread(func, name, CLIENT_THREAD_STACK_SIZE);
572
- <a name="l00550"></a>00550 }
573
- <a name="l00551"></a>00551 }
574
- <a name="l00552"></a>00552 <span class="comment"></span>
575
- <a name="l00553"></a>00553 <span class="comment"> /**</span>
576
- <a name="l00554"></a>00554 <span class="comment"> * Registers a new handler.</span>
577
- <a name="l00555"></a>00555 <span class="comment"> * </span>
578
- <a name="l00556"></a>00556 <span class="comment"> * @pre The main loop isn't running.</span>
579
- <a name="l00557"></a>00557 <span class="comment"> */</span>
580
- <a name="l00558"></a><a class="code" href="classPassenger_1_1MessageServer.html#8f5df648df67f85ab0b7317be21f643f">00558</a> <span class="keywordtype">void</span> <a class="code" href="classPassenger_1_1MessageServer.html#8f5df648df67f85ab0b7317be21f643f" title="Registers a new handler.">addHandler</a>(HandlerPtr handler) {
581
- <a name="l00559"></a>00559 <a class="code" href="classPassenger_1_1MessageServer.html#bced7a8e542f6ab4a81ac1b11f8d163a" title="The registered message handlers.">handlers</a>.push_back(handler);
582
- <a name="l00560"></a>00560 }
583
- <a name="l00561"></a>00561 <span class="comment"></span>
584
- <a name="l00562"></a>00562 <span class="comment"> /**</span>
585
- <a name="l00563"></a>00563 <span class="comment"> * Sets the maximum number of milliseconds that clients may spend on logging in.</span>
586
- <a name="l00564"></a>00564 <span class="comment"> * Clients that take longer are disconnected.</span>
587
- <a name="l00565"></a>00565 <span class="comment"> *</span>
588
- <a name="l00566"></a>00566 <span class="comment"> * @pre timeout != 0</span>
589
- <a name="l00567"></a>00567 <span class="comment"> * @pre The main loop isn't running.</span>
590
- <a name="l00568"></a>00568 <span class="comment"> */</span>
591
- <a name="l00569"></a><a class="code" href="classPassenger_1_1MessageServer.html#91571b29a8a88f80bab68f8083f59291">00569</a> <span class="keywordtype">void</span> <a class="code" href="classPassenger_1_1MessageServer.html#91571b29a8a88f80bab68f8083f59291" title="Sets the maximum number of milliseconds that clients may spend on logging in.">setLoginTimeout</a>(<span class="keywordtype">unsigned</span> <span class="keywordtype">long</span> <span class="keywordtype">long</span> timeout) {
592
- <a name="l00570"></a>00570 assert(timeout != 0);
593
- <a name="l00571"></a>00571 <a class="code" href="classPassenger_1_1MessageServer.html#bf5075add15c5f32a60039bdcbe98926" title="The maximum number of milliseconds that client may spend on logging in.">loginTimeout</a> = timeout;
594
- <a name="l00572"></a>00572 }
595
- <a name="l00573"></a>00573 };
596
- <a name="l00574"></a>00574
597
- <a name="l00575"></a>00575 <span class="keyword">typedef</span> shared_ptr&lt;MessageServer&gt; MessageServerPtr;
598
- <a name="l00576"></a>00576
599
- <a name="l00577"></a>00577 } <span class="comment">// namespace Passenger</span>
600
- <a name="l00578"></a>00578
601
- <a name="l00579"></a>00579 <span class="preprocessor">#endif </span><span class="comment">/* _PASSENGER_MESSAGE_SERVER_H_ */</span>
602
- </pre></div></div>
603
- <hr size="1"><address style="text-align: right;"><small>Generated on Sun Mar 28 14:11:56 2010 for Passenger by&nbsp;
604
- <a href="http://www.doxygen.org/index.html">
605
- <img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.8 </small></address>
606
- </body>
607
- </html>