passenger 3.0.7 → 3.0.8
Sign up to get free protection for your applications and to get access to all the features.
Potentially problematic release.
This version of passenger might be problematic. Click here for more details.
- data/NEWS +27 -0
- data/README +1 -1
- data/bin/passenger-install-nginx-module +3 -1
- data/build/config.rb +2 -1
- data/build/cxx_tests.rb +7 -3
- data/build/documentation.rb +5 -40
- data/build/nginx.rb +0 -1
- data/build/packaging.rb +0 -6
- data/build/rake_extensions.rb +5 -0
- data/doc/Architectural overview.html +344 -77
- data/doc/Security of user switching support.html +338 -71
- data/doc/Users guide Apache with comments.html +4830 -0
- data/doc/Users guide Apache.html +695 -428
- data/doc/Users guide Apache.idmap.txt +80 -0
- data/doc/Users guide Apache.txt +5 -5
- data/doc/Users guide Nginx.html +591 -313
- data/doc/Users guide Nginx.txt +9 -3
- data/doc/Users guide Standalone.html +344 -77
- data/ext/boost/src/pthread/thread.cpp +1 -1
- data/ext/common/AccountsDatabase.h +1 -1
- data/ext/common/Constants.h +2 -2
- data/ext/common/Logging.h +2 -1
- data/ext/common/LoggingAgent/FilterSupport.h +107 -3
- data/ext/common/Session.h +1 -1
- data/ext/common/Utils.cpp +2 -0
- data/ext/common/Utils/Dechunker.h +232 -0
- data/ext/common/Utils/HttpHeaderBufferer.h +165 -0
- data/ext/common/Utils/StrIntUtils.cpp +51 -15
- data/ext/common/Utils/StrIntUtils.h +3 -0
- data/ext/common/Utils/StreamBoyerMooreHorspool.h +506 -0
- data/ext/nginx/Configuration.c +36 -282
- data/ext/nginx/ContentHandler.c +17 -0
- data/ext/nginx/HelperAgent.cpp +397 -39
- data/ext/oxt/tracable_exception.cpp +3 -1
- data/ext/ruby/extconf.rb +1 -0
- data/ext/ruby/passenger_native_support.c +3 -0
- data/helper-scripts/prespawn +113 -31
- data/lib/phusion_passenger.rb +2 -2
- data/lib/phusion_passenger/standalone/runtime_installer.rb +3 -2
- data/lib/phusion_passenger/standalone/start_command.rb +12 -12
- data/test/cxx/DechunkerTest.cpp +216 -0
- data/test/cxx/FilterSupportTest.cpp +31 -4
- data/test/cxx/HttpHeaderBuffererTest.cpp +203 -0
- data/test/cxx/UtilsTest.cpp +46 -3
- data/test/integration_tests/hello_world_rack_spec.rb +7 -0
- data/test/stub/rack/config.ru +6 -1
- data/test/stub/rails_apps/1.2/empty/public/dispatch.cgi +1 -1
- data/test/stub/rails_apps/1.2/empty/public/dispatch.fcgi +1 -1
- data/test/stub/rails_apps/1.2/empty/public/dispatch.rb +1 -1
- data/test/stub/rails_apps/2.0/empty/public/dispatch.cgi +1 -1
- data/test/stub/rails_apps/2.0/empty/public/dispatch.fcgi +1 -1
- data/test/stub/rails_apps/2.0/empty/public/dispatch.rb +1 -1
- data/test/stub/rails_apps/2.2/empty/public/dispatch.cgi +1 -1
- data/test/stub/rails_apps/2.2/empty/public/dispatch.fcgi +1 -1
- data/test/stub/rails_apps/2.2/empty/public/dispatch.rb +1 -1
- metadata +20 -403
- data/doc/Doxyfile +0 -241
- data/doc/cxxapi/AbstractSpawnManager_8h_source.html +0 -141
- data/doc/cxxapi/Account_8h_source.html +0 -206
- data/doc/cxxapi/AccountsDatabase_8h_source.html +0 -161
- data/doc/cxxapi/AgentBase_8h_source.html +0 -70
- data/doc/cxxapi/AgentsStarter_8h_source.html +0 -112
- data/doc/cxxapi/BCrypt_8h_source.html +0 -104
- data/doc/cxxapi/Blowfish_8h_source.html +0 -134
- data/doc/cxxapi/Bucket_8h_source.html +0 -118
- data/doc/cxxapi/Constants_8h_source.html +0 -79
- data/doc/cxxapi/ContentHandler_8h_source.html +0 -95
- data/doc/cxxapi/DirectoryMapper_8h_source.html +0 -311
- data/doc/cxxapi/EventedClient_8h_source.html +0 -733
- data/doc/cxxapi/EventedMessageServer_8h_source.html +0 -358
- data/doc/cxxapi/EventedServer_8h_source.html +0 -326
- data/doc/cxxapi/Exceptions_8h_source.html +0 -393
- data/doc/cxxapi/FileDescriptor_8h_source.html +0 -324
- data/doc/cxxapi/Hooks_8h_source.html +0 -76
- data/doc/cxxapi/HttpStatusExtractor_8h_source.html +0 -382
- data/doc/cxxapi/IniFile_8h_source.html +0 -527
- data/doc/cxxapi/Logging_8h_source.html +0 -796
- data/doc/cxxapi/MessageChannel_8h_source.html +0 -776
- data/doc/cxxapi/MessageClient_8h_source.html +0 -328
- data/doc/cxxapi/MessageReadersWriters_8h_source.html +0 -539
- data/doc/cxxapi/MessageServer_8h_source.html +0 -612
- data/doc/cxxapi/PoolOptions_8h_source.html +0 -549
- data/doc/cxxapi/Process_8h_source.html +0 -286
- data/doc/cxxapi/RandomGenerator_8h_source.html +0 -191
- data/doc/cxxapi/ResourceLocator_8h_source.html +0 -166
- data/doc/cxxapi/SafeLibev_8h_source.html +0 -180
- data/doc/cxxapi/ScgiRequestParser_8h_source.html +0 -406
- data/doc/cxxapi/ServerInstanceDir_8h_source.html +0 -378
- data/doc/cxxapi/Session_8h_source.html +0 -501
- data/doc/cxxapi/SpawnManager_8h_source.html +0 -647
- data/doc/cxxapi/StaticContentHandler_8h_source.html +0 -69
- data/doc/cxxapi/StaticString_8h_source.html +0 -329
- data/doc/cxxapi/StringListCreator_8h_source.html +0 -114
- data/doc/cxxapi/Utils_8h_source.html +0 -469
- data/doc/cxxapi/annotated.html +0 -87
- data/doc/cxxapi/apache2_2Configuration_8h_source.html +0 -82
- data/doc/cxxapi/classAgentWatcher-members.html +0 -54
- data/doc/cxxapi/classAgentWatcher.html +0 -419
- data/doc/cxxapi/classClient-members.html +0 -38
- data/doc/cxxapi/classClient.html +0 -123
- data/doc/cxxapi/classHooks-members.html +0 -40
- data/doc/cxxapi/classHooks.html +0 -153
- data/doc/cxxapi/classPassenger_1_1AbstractSpawnManager-members.html +0 -40
- data/doc/cxxapi/classPassenger_1_1AbstractSpawnManager.html +0 -187
- data/doc/cxxapi/classPassenger_1_1AbstractSpawnManager__inherit__graph.map +0 -3
- data/doc/cxxapi/classPassenger_1_1AbstractSpawnManager__inherit__graph.md5 +0 -1
- data/doc/cxxapi/classPassenger_1_1AbstractSpawnManager__inherit__graph.png +0 -0
- data/doc/cxxapi/classPassenger_1_1ArgumentException-members.html +0 -36
- data/doc/cxxapi/classPassenger_1_1ArgumentException.html +0 -56
- data/doc/cxxapi/classPassenger_1_1ArrayMessage-members.html +0 -37
- data/doc/cxxapi/classPassenger_1_1ArrayMessage.html +0 -113
- data/doc/cxxapi/classPassenger_1_1BufferedUpload-members.html +0 -38
- data/doc/cxxapi/classPassenger_1_1BufferedUpload.html +0 -112
- data/doc/cxxapi/classPassenger_1_1BusyException-members.html +0 -36
- data/doc/cxxapi/classPassenger_1_1BusyException.html +0 -54
- data/doc/cxxapi/classPassenger_1_1ConfigurationException-members.html +0 -36
- data/doc/cxxapi/classPassenger_1_1ConfigurationException.html +0 -51
- data/doc/cxxapi/classPassenger_1_1DirectoryMapper-members.html +0 -41
- data/doc/cxxapi/classPassenger_1_1DirectoryMapper.html +0 -223
- data/doc/cxxapi/classPassenger_1_1EOFException-members.html +0 -36
- data/doc/cxxapi/classPassenger_1_1EOFException.html +0 -61
- data/doc/cxxapi/classPassenger_1_1EOFException__inherit__graph.map +0 -3
- data/doc/cxxapi/classPassenger_1_1EOFException__inherit__graph.md5 +0 -1
- data/doc/cxxapi/classPassenger_1_1EOFException__inherit__graph.png +0 -0
- data/doc/cxxapi/classPassenger_1_1EventFd-members.html +0 -36
- data/doc/cxxapi/classPassenger_1_1EventFd.html +0 -52
- data/doc/cxxapi/classPassenger_1_1EventedClient-members.html +0 -59
- data/doc/cxxapi/classPassenger_1_1EventedClient.html +0 -531
- data/doc/cxxapi/classPassenger_1_1EventedMessageServer-members.html +0 -37
- data/doc/cxxapi/classPassenger_1_1EventedMessageServer.html +0 -59
- data/doc/cxxapi/classPassenger_1_1EventedMessageServer__inherit__graph.map +0 -3
- data/doc/cxxapi/classPassenger_1_1EventedMessageServer__inherit__graph.md5 +0 -1
- data/doc/cxxapi/classPassenger_1_1EventedMessageServer__inherit__graph.png +0 -0
- data/doc/cxxapi/classPassenger_1_1EventedServer-members.html +0 -37
- data/doc/cxxapi/classPassenger_1_1EventedServer.html +0 -93
- data/doc/cxxapi/classPassenger_1_1EventedServer__inherit__graph.map +0 -3
- data/doc/cxxapi/classPassenger_1_1EventedServer__inherit__graph.md5 +0 -1
- data/doc/cxxapi/classPassenger_1_1EventedServer__inherit__graph.png +0 -0
- data/doc/cxxapi/classPassenger_1_1FileDescriptor-members.html +0 -41
- data/doc/cxxapi/classPassenger_1_1FileDescriptor.html +0 -178
- data/doc/cxxapi/classPassenger_1_1FileDescriptorPair-members.html +0 -36
- data/doc/cxxapi/classPassenger_1_1FileDescriptorPair.html +0 -52
- data/doc/cxxapi/classPassenger_1_1FileNotFoundException-members.html +0 -36
- data/doc/cxxapi/classPassenger_1_1FileNotFoundException.html +0 -58
- data/doc/cxxapi/classPassenger_1_1FileNotFoundException__inherit__graph.map +0 -3
- data/doc/cxxapi/classPassenger_1_1FileNotFoundException__inherit__graph.md5 +0 -1
- data/doc/cxxapi/classPassenger_1_1FileNotFoundException__inherit__graph.png +0 -0
- data/doc/cxxapi/classPassenger_1_1FileSystemException-members.html +0 -41
- data/doc/cxxapi/classPassenger_1_1FileSystemException.html +0 -66
- data/doc/cxxapi/classPassenger_1_1FileSystemException__inherit__graph.map +0 -3
- data/doc/cxxapi/classPassenger_1_1FileSystemException__inherit__graph.md5 +0 -1
- data/doc/cxxapi/classPassenger_1_1FileSystemException__inherit__graph.png +0 -0
- data/doc/cxxapi/classPassenger_1_1HttpStatusExtractor-members.html +0 -39
- data/doc/cxxapi/classPassenger_1_1HttpStatusExtractor.html +0 -128
- data/doc/cxxapi/classPassenger_1_1IOException-members.html +0 -36
- data/doc/cxxapi/classPassenger_1_1IOException.html +0 -61
- data/doc/cxxapi/classPassenger_1_1IOException__inherit__graph.map +0 -4
- data/doc/cxxapi/classPassenger_1_1IOException__inherit__graph.md5 +0 -1
- data/doc/cxxapi/classPassenger_1_1IOException__inherit__graph.png +0 -0
- data/doc/cxxapi/classPassenger_1_1MessageChannel-members.html +0 -57
- data/doc/cxxapi/classPassenger_1_1MessageChannel.html +0 -839
- data/doc/cxxapi/classPassenger_1_1MessageServer-members.html +0 -49
- data/doc/cxxapi/classPassenger_1_1MessageServer.html +0 -407
- data/doc/cxxapi/classPassenger_1_1MessageServer_1_1ClientContext-members.html +0 -36
- data/doc/cxxapi/classPassenger_1_1MessageServer_1_1ClientContext.html +0 -58
- data/doc/cxxapi/classPassenger_1_1MessageServer_1_1ClientContext__inherit__graph.map +0 -3
- data/doc/cxxapi/classPassenger_1_1MessageServer_1_1ClientContext__inherit__graph.md5 +0 -1
- data/doc/cxxapi/classPassenger_1_1MessageServer_1_1ClientContext__inherit__graph.png +0 -0
- data/doc/cxxapi/classPassenger_1_1MessageServer_1_1CommonClientContext-members.html +0 -41
- data/doc/cxxapi/classPassenger_1_1MessageServer_1_1CommonClientContext.html +0 -165
- data/doc/cxxapi/classPassenger_1_1MessageServer_1_1CommonClientContext__inherit__graph.map +0 -3
- data/doc/cxxapi/classPassenger_1_1MessageServer_1_1CommonClientContext__inherit__graph.md5 +0 -1
- data/doc/cxxapi/classPassenger_1_1MessageServer_1_1CommonClientContext__inherit__graph.png +0 -0
- data/doc/cxxapi/classPassenger_1_1MessageServer_1_1Handler-members.html +0 -39
- data/doc/cxxapi/classPassenger_1_1MessageServer_1_1Handler.html +0 -173
- data/doc/cxxapi/classPassenger_1_1Process-members.html +0 -44
- data/doc/cxxapi/classPassenger_1_1Process.html +0 -290
- data/doc/cxxapi/classPassenger_1_1RandomGenerator-members.html +0 -37
- data/doc/cxxapi/classPassenger_1_1RandomGenerator.html +0 -79
- data/doc/cxxapi/classPassenger_1_1ResourceLocator-members.html +0 -36
- data/doc/cxxapi/classPassenger_1_1ResourceLocator.html +0 -51
- data/doc/cxxapi/classPassenger_1_1RuntimeException-members.html +0 -36
- data/doc/cxxapi/classPassenger_1_1RuntimeException.html +0 -54
- data/doc/cxxapi/classPassenger_1_1SafeLibev-members.html +0 -36
- data/doc/cxxapi/classPassenger_1_1SafeLibev.html +0 -51
- data/doc/cxxapi/classPassenger_1_1ScalarMessage-members.html +0 -37
- data/doc/cxxapi/classPassenger_1_1ScalarMessage.html +0 -76
- data/doc/cxxapi/classPassenger_1_1ScgiRequestParser-members.html +0 -50
- data/doc/cxxapi/classPassenger_1_1ScgiRequestParser.html +0 -285
- data/doc/cxxapi/classPassenger_1_1SecurityException-members.html +0 -36
- data/doc/cxxapi/classPassenger_1_1SecurityException.html +0 -56
- data/doc/cxxapi/classPassenger_1_1Session-members.html +0 -53
- data/doc/cxxapi/classPassenger_1_1Session.html +0 -556
- data/doc/cxxapi/classPassenger_1_1Session__inherit__graph.map +0 -3
- data/doc/cxxapi/classPassenger_1_1Session__inherit__graph.md5 +0 -1
- data/doc/cxxapi/classPassenger_1_1Session__inherit__graph.png +0 -0
- data/doc/cxxapi/classPassenger_1_1SpawnException-members.html +0 -39
- data/doc/cxxapi/classPassenger_1_1SpawnException.html +0 -101
- data/doc/cxxapi/classPassenger_1_1SpawnManager-members.html +0 -42
- data/doc/cxxapi/classPassenger_1_1SpawnManager.html +0 -292
- data/doc/cxxapi/classPassenger_1_1SpawnManager__inherit__graph.map +0 -3
- data/doc/cxxapi/classPassenger_1_1SpawnManager__inherit__graph.md5 +0 -1
- data/doc/cxxapi/classPassenger_1_1SpawnManager__inherit__graph.png +0 -0
- data/doc/cxxapi/classPassenger_1_1StandardSession-members.html +0 -54
- data/doc/cxxapi/classPassenger_1_1StandardSession.html +0 -394
- data/doc/cxxapi/classPassenger_1_1StandardSession__inherit__graph.map +0 -3
- data/doc/cxxapi/classPassenger_1_1StandardSession__inherit__graph.md5 +0 -1
- data/doc/cxxapi/classPassenger_1_1StandardSession__inherit__graph.png +0 -0
- data/doc/cxxapi/classPassenger_1_1StaticString-members.html +0 -36
- data/doc/cxxapi/classPassenger_1_1StaticString.html +0 -56
- data/doc/cxxapi/classPassenger_1_1SyntaxError-members.html +0 -36
- data/doc/cxxapi/classPassenger_1_1SyntaxError.html +0 -54
- data/doc/cxxapi/classPassenger_1_1SystemException-members.html +0 -40
- data/doc/cxxapi/classPassenger_1_1SystemException.html +0 -155
- data/doc/cxxapi/classPassenger_1_1SystemException__inherit__graph.map +0 -4
- data/doc/cxxapi/classPassenger_1_1SystemException__inherit__graph.md5 +0 -1
- data/doc/cxxapi/classPassenger_1_1SystemException__inherit__graph.png +0 -0
- data/doc/cxxapi/classPassenger_1_1TimeRetrievalException-members.html +0 -40
- data/doc/cxxapi/classPassenger_1_1TimeRetrievalException.html +0 -61
- data/doc/cxxapi/classPassenger_1_1TimeRetrievalException__inherit__graph.map +0 -3
- data/doc/cxxapi/classPassenger_1_1TimeRetrievalException__inherit__graph.md5 +0 -1
- data/doc/cxxapi/classPassenger_1_1TimeRetrievalException__inherit__graph.png +0 -0
- data/doc/cxxapi/classPassenger_1_1TimeoutException-members.html +0 -36
- data/doc/cxxapi/classPassenger_1_1TimeoutException.html +0 -54
- data/doc/cxxapi/classPassenger_1_1Uint16Message-members.html +0 -36
- data/doc/cxxapi/classPassenger_1_1Uint16Message.html +0 -51
- data/doc/cxxapi/classPassenger_1_1Uint32Message-members.html +0 -36
- data/doc/cxxapi/classPassenger_1_1Uint32Message.html +0 -51
- data/doc/cxxapi/classServer-members.html +0 -36
- data/doc/cxxapi/classServer.html +0 -49
- data/doc/cxxapi/classServerInstanceDirToucher-members.html +0 -36
- data/doc/cxxapi/classServerInstanceDirToucher.html +0 -47
- data/doc/cxxapi/classes.html +0 -52
- data/doc/cxxapi/definitions_8h_source.html +0 -36
- data/doc/cxxapi/doxygen.css +0 -532
- data/doc/cxxapi/doxygen.png +0 -0
- data/doc/cxxapi/files.html +0 -76
- data/doc/cxxapi/ftv2blank.png +0 -0
- data/doc/cxxapi/ftv2doc.png +0 -0
- data/doc/cxxapi/ftv2folderclosed.png +0 -0
- data/doc/cxxapi/ftv2folderopen.png +0 -0
- data/doc/cxxapi/ftv2lastnode.png +0 -0
- data/doc/cxxapi/ftv2link.png +0 -0
- data/doc/cxxapi/ftv2mlastnode.png +0 -0
- data/doc/cxxapi/ftv2mnode.png +0 -0
- data/doc/cxxapi/ftv2node.png +0 -0
- data/doc/cxxapi/ftv2plastnode.png +0 -0
- data/doc/cxxapi/ftv2pnode.png +0 -0
- data/doc/cxxapi/ftv2vertline.png +0 -0
- data/doc/cxxapi/functions.html +0 -103
- data/doc/cxxapi/functions_0x62.html +0 -82
- data/doc/cxxapi/functions_0x63.html +0 -102
- data/doc/cxxapi/functions_0x64.html +0 -102
- data/doc/cxxapi/functions_0x65.html +0 -88
- data/doc/cxxapi/functions_0x66.html +0 -100
- data/doc/cxxapi/functions_0x67.html +0 -167
- data/doc/cxxapi/functions_0x68.html +0 -88
- data/doc/cxxapi/functions_0x69.html +0 -96
- data/doc/cxxapi/functions_0x6b.html +0 -80
- data/doc/cxxapi/functions_0x6c.html +0 -88
- data/doc/cxxapi/functions_0x6d.html +0 -88
- data/doc/cxxapi/functions_0x6e.html +0 -86
- data/doc/cxxapi/functions_0x6f.html +0 -94
- data/doc/cxxapi/functions_0x70.html +0 -94
- data/doc/cxxapi/functions_0x72.html +0 -110
- data/doc/cxxapi/functions_0x73.html +0 -171
- data/doc/cxxapi/functions_0x74.html +0 -85
- data/doc/cxxapi/functions_0x75.html +0 -85
- data/doc/cxxapi/functions_0x77.html +0 -92
- data/doc/cxxapi/functions_0x7e.html +0 -79
- data/doc/cxxapi/functions_enum.html +0 -49
- data/doc/cxxapi/functions_eval.html +0 -67
- data/doc/cxxapi/functions_func.html +0 -531
- data/doc/cxxapi/functions_vars.html +0 -278
- data/doc/cxxapi/graph_legend.dot +0 -22
- data/doc/cxxapi/graph_legend.html +0 -92
- data/doc/cxxapi/graph_legend.png +0 -0
- data/doc/cxxapi/group__Core.html +0 -46
- data/doc/cxxapi/group__Core.map +0 -3
- data/doc/cxxapi/group__Core.png +0 -0
- data/doc/cxxapi/group__Exceptions.html +0 -53
- data/doc/cxxapi/group__Hooks.html +0 -42
- data/doc/cxxapi/group__Hooks.map +0 -3
- data/doc/cxxapi/group__Hooks.png +0 -0
- data/doc/cxxapi/group__Support.html +0 -538
- data/doc/cxxapi/hierarchy.html +0 -101
- data/doc/cxxapi/index.html +0 -16
- data/doc/cxxapi/inherit__graph__0.map +0 -3
- data/doc/cxxapi/inherit__graph__0.md5 +0 -1
- data/doc/cxxapi/inherit__graph__0.png +0 -0
- data/doc/cxxapi/inherit__graph__1.map +0 -3
- data/doc/cxxapi/inherit__graph__1.md5 +0 -1
- data/doc/cxxapi/inherit__graph__1.png +0 -0
- data/doc/cxxapi/inherit__graph__10.map +0 -3
- data/doc/cxxapi/inherit__graph__10.md5 +0 -1
- data/doc/cxxapi/inherit__graph__10.png +0 -0
- data/doc/cxxapi/inherit__graph__11.map +0 -4
- data/doc/cxxapi/inherit__graph__11.md5 +0 -1
- data/doc/cxxapi/inherit__graph__11.png +0 -0
- data/doc/cxxapi/inherit__graph__12.map +0 -3
- data/doc/cxxapi/inherit__graph__12.md5 +0 -1
- data/doc/cxxapi/inherit__graph__12.png +0 -0
- data/doc/cxxapi/inherit__graph__13.map +0 -3
- data/doc/cxxapi/inherit__graph__13.md5 +0 -1
- data/doc/cxxapi/inherit__graph__13.png +0 -0
- data/doc/cxxapi/inherit__graph__14.map +0 -3
- data/doc/cxxapi/inherit__graph__14.md5 +0 -1
- data/doc/cxxapi/inherit__graph__14.png +0 -0
- data/doc/cxxapi/inherit__graph__15.map +0 -3
- data/doc/cxxapi/inherit__graph__15.md5 +0 -1
- data/doc/cxxapi/inherit__graph__15.png +0 -0
- data/doc/cxxapi/inherit__graph__16.map +0 -5
- data/doc/cxxapi/inherit__graph__16.md5 +0 -1
- data/doc/cxxapi/inherit__graph__16.png +0 -0
- data/doc/cxxapi/inherit__graph__17.map +0 -3
- data/doc/cxxapi/inherit__graph__17.md5 +0 -1
- data/doc/cxxapi/inherit__graph__17.png +0 -0
- data/doc/cxxapi/inherit__graph__18.map +0 -3
- data/doc/cxxapi/inherit__graph__18.md5 +0 -1
- data/doc/cxxapi/inherit__graph__18.png +0 -0
- data/doc/cxxapi/inherit__graph__19.map +0 -4
- data/doc/cxxapi/inherit__graph__19.md5 +0 -1
- data/doc/cxxapi/inherit__graph__19.png +0 -0
- data/doc/cxxapi/inherit__graph__2.map +0 -3
- data/doc/cxxapi/inherit__graph__2.md5 +0 -1
- data/doc/cxxapi/inherit__graph__2.png +0 -0
- data/doc/cxxapi/inherit__graph__20.map +0 -3
- data/doc/cxxapi/inherit__graph__20.md5 +0 -1
- data/doc/cxxapi/inherit__graph__20.png +0 -0
- data/doc/cxxapi/inherit__graph__21.map +0 -3
- data/doc/cxxapi/inherit__graph__21.md5 +0 -1
- data/doc/cxxapi/inherit__graph__21.png +0 -0
- data/doc/cxxapi/inherit__graph__22.map +0 -3
- data/doc/cxxapi/inherit__graph__22.md5 +0 -1
- data/doc/cxxapi/inherit__graph__22.png +0 -0
- data/doc/cxxapi/inherit__graph__23.map +0 -3
- data/doc/cxxapi/inherit__graph__23.md5 +0 -1
- data/doc/cxxapi/inherit__graph__23.png +0 -0
- data/doc/cxxapi/inherit__graph__24.map +0 -3
- data/doc/cxxapi/inherit__graph__24.md5 +0 -1
- data/doc/cxxapi/inherit__graph__24.png +0 -0
- data/doc/cxxapi/inherit__graph__25.map +0 -3
- data/doc/cxxapi/inherit__graph__25.md5 +0 -1
- data/doc/cxxapi/inherit__graph__25.png +0 -0
- data/doc/cxxapi/inherit__graph__26.map +0 -3
- data/doc/cxxapi/inherit__graph__26.md5 +0 -1
- data/doc/cxxapi/inherit__graph__26.png +0 -0
- data/doc/cxxapi/inherit__graph__27.map +0 -3
- data/doc/cxxapi/inherit__graph__27.md5 +0 -1
- data/doc/cxxapi/inherit__graph__27.png +0 -0
- data/doc/cxxapi/inherit__graph__28.map +0 -3
- data/doc/cxxapi/inherit__graph__28.md5 +0 -1
- data/doc/cxxapi/inherit__graph__28.png +0 -0
- data/doc/cxxapi/inherit__graph__29.map +0 -3
- data/doc/cxxapi/inherit__graph__29.md5 +0 -1
- data/doc/cxxapi/inherit__graph__29.png +0 -0
- data/doc/cxxapi/inherit__graph__3.map +0 -4
- data/doc/cxxapi/inherit__graph__3.md5 +0 -1
- data/doc/cxxapi/inherit__graph__3.png +0 -0
- data/doc/cxxapi/inherit__graph__30.map +0 -3
- data/doc/cxxapi/inherit__graph__30.md5 +0 -1
- data/doc/cxxapi/inherit__graph__30.png +0 -0
- data/doc/cxxapi/inherit__graph__31.map +0 -4
- data/doc/cxxapi/inherit__graph__31.md5 +0 -1
- data/doc/cxxapi/inherit__graph__31.png +0 -0
- data/doc/cxxapi/inherit__graph__32.map +0 -3
- data/doc/cxxapi/inherit__graph__32.md5 +0 -1
- data/doc/cxxapi/inherit__graph__32.png +0 -0
- data/doc/cxxapi/inherit__graph__33.map +0 -3
- data/doc/cxxapi/inherit__graph__33.md5 +0 -1
- data/doc/cxxapi/inherit__graph__33.png +0 -0
- data/doc/cxxapi/inherit__graph__34.map +0 -3
- data/doc/cxxapi/inherit__graph__34.md5 +0 -1
- data/doc/cxxapi/inherit__graph__34.png +0 -0
- data/doc/cxxapi/inherit__graph__35.map +0 -3
- data/doc/cxxapi/inherit__graph__35.md5 +0 -1
- data/doc/cxxapi/inherit__graph__35.png +0 -0
- data/doc/cxxapi/inherit__graph__36.map +0 -5
- data/doc/cxxapi/inherit__graph__36.md5 +0 -1
- data/doc/cxxapi/inherit__graph__36.png +0 -0
- data/doc/cxxapi/inherit__graph__37.map +0 -3
- data/doc/cxxapi/inherit__graph__37.md5 +0 -1
- data/doc/cxxapi/inherit__graph__37.png +0 -0
- data/doc/cxxapi/inherit__graph__38.map +0 -3
- data/doc/cxxapi/inherit__graph__38.md5 +0 -1
- data/doc/cxxapi/inherit__graph__38.png +0 -0
- data/doc/cxxapi/inherit__graph__39.map +0 -3
- data/doc/cxxapi/inherit__graph__39.md5 +0 -1
- data/doc/cxxapi/inherit__graph__39.png +0 -0
- data/doc/cxxapi/inherit__graph__4.map +0 -3
- data/doc/cxxapi/inherit__graph__4.md5 +0 -1
- data/doc/cxxapi/inherit__graph__4.png +0 -0
- data/doc/cxxapi/inherit__graph__40.map +0 -3
- data/doc/cxxapi/inherit__graph__40.md5 +0 -1
- data/doc/cxxapi/inherit__graph__40.png +0 -0
- data/doc/cxxapi/inherit__graph__41.map +0 -3
- data/doc/cxxapi/inherit__graph__41.md5 +0 -1
- data/doc/cxxapi/inherit__graph__41.png +0 -0
- data/doc/cxxapi/inherit__graph__5.map +0 -3
- data/doc/cxxapi/inherit__graph__5.md5 +0 -1
- data/doc/cxxapi/inherit__graph__5.png +0 -0
- data/doc/cxxapi/inherit__graph__6.map +0 -3
- data/doc/cxxapi/inherit__graph__6.md5 +0 -1
- data/doc/cxxapi/inherit__graph__6.png +0 -0
- data/doc/cxxapi/inherit__graph__7.map +0 -3
- data/doc/cxxapi/inherit__graph__7.md5 +0 -1
- data/doc/cxxapi/inherit__graph__7.png +0 -0
- data/doc/cxxapi/inherit__graph__8.map +0 -3
- data/doc/cxxapi/inherit__graph__8.md5 +0 -1
- data/doc/cxxapi/inherit__graph__8.png +0 -0
- data/doc/cxxapi/inherit__graph__9.map +0 -3
- data/doc/cxxapi/inherit__graph__9.md5 +0 -1
- data/doc/cxxapi/inherit__graph__9.png +0 -0
- data/doc/cxxapi/inherits.html +0 -165
- data/doc/cxxapi/main.html +0 -28
- data/doc/cxxapi/modules.html +0 -36
- data/doc/cxxapi/namespacePassenger.html +0 -585
- data/doc/cxxapi/namespacemembers.html +0 -190
- data/doc/cxxapi/namespacemembers_enum.html +0 -48
- data/doc/cxxapi/namespacemembers_eval.html +0 -57
- data/doc/cxxapi/namespacemembers_func.html +0 -114
- data/doc/cxxapi/namespacemembers_type.html +0 -54
- data/doc/cxxapi/namespaces.html +0 -37
- data/doc/cxxapi/nginx_2Configuration_8h_source.html +0 -126
- data/doc/cxxapi/ngx__http__passenger__module_8h_source.html +0 -95
- data/doc/cxxapi/structPassenger_1_1MessageServer_1_1DisconnectEventBroadcastGuard-members.html +0 -36
- data/doc/cxxapi/structPassenger_1_1MessageServer_1_1DisconnectEventBroadcastGuard.html +0 -51
- data/doc/cxxapi/structPassenger_1_1PoolOptions-members.html +0 -67
- data/doc/cxxapi/structPassenger_1_1PoolOptions.html +0 -647
- data/doc/cxxapi/structPassenger_1_1StaticString_1_1Hash-members.html +0 -36
- data/doc/cxxapi/structPassenger_1_1StaticString_1_1Hash.html +0 -51
- data/doc/cxxapi/tab_b.gif +0 -0
- data/doc/cxxapi/tab_l.gif +0 -0
- data/doc/cxxapi/tab_r.gif +0 -0
- data/doc/cxxapi/tabs.css +0 -105
- data/doc/cxxapi/tree.html +0 -249
- data/doc/template/horo.rb +0 -613
- data/ext/libev/config.h +0 -122
- data/ext/nginx/HttpStatusExtractor.h +0 -351
|
@@ -1,286 +0,0 @@
|
|
|
1
|
-
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
|
2
|
-
<html xmlns="http://www.w3.org/1999/xhtml">
|
|
3
|
-
<head>
|
|
4
|
-
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
|
|
5
|
-
<title>Passenger: Process.h Source File</title>
|
|
6
|
-
<link href="tabs.css" rel="stylesheet" type="text/css"/>
|
|
7
|
-
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
|
|
8
|
-
</head>
|
|
9
|
-
<body>
|
|
10
|
-
<!-- Generated by Doxygen 1.6.2 -->
|
|
11
|
-
<div class="navigation" id="top">
|
|
12
|
-
<div class="tabs">
|
|
13
|
-
<ul>
|
|
14
|
-
<li><a href="main.html"><span>Main Page</span></a></li>
|
|
15
|
-
<li><a href="modules.html"><span>Modules</span></a></li>
|
|
16
|
-
<li><a href="namespaces.html"><span>Namespaces</span></a></li>
|
|
17
|
-
<li><a href="annotated.html"><span>Classes</span></a></li>
|
|
18
|
-
<li class="current"><a href="files.html"><span>Files</span></a></li>
|
|
19
|
-
</ul>
|
|
20
|
-
</div>
|
|
21
|
-
<div class="tabs">
|
|
22
|
-
<ul>
|
|
23
|
-
<li><a href="files.html"><span>File List</span></a></li>
|
|
24
|
-
</ul>
|
|
25
|
-
</div>
|
|
26
|
-
<h1>Process.h</h1><div class="fragment"><pre class="fragment"><a name="l00001"></a>00001 <span class="comment">/*</span>
|
|
27
|
-
<a name="l00002"></a>00002 <span class="comment"> * Phusion Passenger - http://www.modrails.com/</span>
|
|
28
|
-
<a name="l00003"></a>00003 <span class="comment"> * Copyright (c) 2010 Phusion</span>
|
|
29
|
-
<a name="l00004"></a>00004 <span class="comment"> *</span>
|
|
30
|
-
<a name="l00005"></a>00005 <span class="comment"> * "Phusion Passenger" is a trademark of Hongli Lai & Ninh Bui.</span>
|
|
31
|
-
<a name="l00006"></a>00006 <span class="comment"> *</span>
|
|
32
|
-
<a name="l00007"></a>00007 <span class="comment"> * Permission is hereby granted, free of charge, to any person obtaining a copy</span>
|
|
33
|
-
<a name="l00008"></a>00008 <span class="comment"> * of this software and associated documentation files (the "Software"), to deal</span>
|
|
34
|
-
<a name="l00009"></a>00009 <span class="comment"> * in the Software without restriction, including without limitation the rights</span>
|
|
35
|
-
<a name="l00010"></a>00010 <span class="comment"> * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell</span>
|
|
36
|
-
<a name="l00011"></a>00011 <span class="comment"> * copies of the Software, and to permit persons to whom the Software is</span>
|
|
37
|
-
<a name="l00012"></a>00012 <span class="comment"> * furnished to do so, subject to the following conditions:</span>
|
|
38
|
-
<a name="l00013"></a>00013 <span class="comment"> *</span>
|
|
39
|
-
<a name="l00014"></a>00014 <span class="comment"> * The above copyright notice and this permission notice shall be included in</span>
|
|
40
|
-
<a name="l00015"></a>00015 <span class="comment"> * all copies or substantial portions of the Software.</span>
|
|
41
|
-
<a name="l00016"></a>00016 <span class="comment"> *</span>
|
|
42
|
-
<a name="l00017"></a>00017 <span class="comment"> * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR</span>
|
|
43
|
-
<a name="l00018"></a>00018 <span class="comment"> * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,</span>
|
|
44
|
-
<a name="l00019"></a>00019 <span class="comment"> * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE</span>
|
|
45
|
-
<a name="l00020"></a>00020 <span class="comment"> * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER</span>
|
|
46
|
-
<a name="l00021"></a>00021 <span class="comment"> * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,</span>
|
|
47
|
-
<a name="l00022"></a>00022 <span class="comment"> * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN</span>
|
|
48
|
-
<a name="l00023"></a>00023 <span class="comment"> * THE SOFTWARE.</span>
|
|
49
|
-
<a name="l00024"></a>00024 <span class="comment"> */</span>
|
|
50
|
-
<a name="l00025"></a>00025 <span class="preprocessor">#ifndef _PASSENGER_PROCESS_H_</span>
|
|
51
|
-
<a name="l00026"></a>00026 <span class="preprocessor"></span><span class="preprocessor">#define _PASSENGER_PROCESS_H_</span>
|
|
52
|
-
<a name="l00027"></a>00027 <span class="preprocessor"></span>
|
|
53
|
-
<a name="l00028"></a>00028 <span class="preprocessor">#include <boost/shared_ptr.hpp></span>
|
|
54
|
-
<a name="l00029"></a>00029 <span class="preprocessor">#include <boost/function.hpp></span>
|
|
55
|
-
<a name="l00030"></a>00030 <span class="preprocessor">#include <oxt/system_calls.hpp></span>
|
|
56
|
-
<a name="l00031"></a>00031 <span class="preprocessor">#include <oxt/backtrace.hpp></span>
|
|
57
|
-
<a name="l00032"></a>00032 <span class="preprocessor">#include <string></span>
|
|
58
|
-
<a name="l00033"></a>00033 <span class="preprocessor">#include <map></span>
|
|
59
|
-
<a name="l00034"></a>00034
|
|
60
|
-
<a name="l00035"></a>00035 <span class="preprocessor">#include <sys/types.h></span>
|
|
61
|
-
<a name="l00036"></a>00036 <span class="preprocessor">#include <unistd.h></span>
|
|
62
|
-
<a name="l00037"></a>00037 <span class="preprocessor">#include <errno.h></span>
|
|
63
|
-
<a name="l00038"></a>00038
|
|
64
|
-
<a name="l00039"></a>00039 <span class="preprocessor">#include "Session.h"</span>
|
|
65
|
-
<a name="l00040"></a>00040 <span class="preprocessor">#include "MessageChannel.h"</span>
|
|
66
|
-
<a name="l00041"></a>00041 <span class="preprocessor">#include "Exceptions.h"</span>
|
|
67
|
-
<a name="l00042"></a>00042 <span class="preprocessor">#include "Logging.h"</span>
|
|
68
|
-
<a name="l00043"></a>00043 <span class="preprocessor">#include "Utils.h"</span>
|
|
69
|
-
<a name="l00044"></a>00044
|
|
70
|
-
<a name="l00045"></a>00045 <span class="keyword">namespace </span>Passenger {
|
|
71
|
-
<a name="l00046"></a>00046
|
|
72
|
-
<a name="l00047"></a>00047 <span class="keyword">using namespace </span>std;
|
|
73
|
-
<a name="l00048"></a>00048 <span class="keyword">using namespace </span>boost;
|
|
74
|
-
<a name="l00049"></a>00049 <span class="comment"></span>
|
|
75
|
-
<a name="l00050"></a>00050 <span class="comment">/**</span>
|
|
76
|
-
<a name="l00051"></a>00051 <span class="comment"> * Represents a single application process, as spawned by SpawnManager</span>
|
|
77
|
-
<a name="l00052"></a>00052 <span class="comment"> * or by ApplicationPool::Interface::get().</span>
|
|
78
|
-
<a name="l00053"></a>00053 <span class="comment"> *</span>
|
|
79
|
-
<a name="l00054"></a>00054 <span class="comment"> * @ingroup Support</span>
|
|
80
|
-
<a name="l00055"></a>00055 <span class="comment"> */</span>
|
|
81
|
-
<a name="l00056"></a><a class="code" href="classPassenger_1_1Process.html">00056</a> <span class="keyword">class </span><a class="code" href="classPassenger_1_1Process.html" title="Represents a single application process, as spawned by SpawnManager or by ApplicationPool::Interface...">Process</a> {
|
|
82
|
-
<a name="l00057"></a>00057 <span class="keyword">public</span>:
|
|
83
|
-
<a name="l00058"></a>00058 <span class="keyword">struct </span>SocketInfo {
|
|
84
|
-
<a name="l00059"></a>00059 <span class="keywordtype">string</span> address;
|
|
85
|
-
<a name="l00060"></a>00060 <span class="keywordtype">string</span> type;
|
|
86
|
-
<a name="l00061"></a>00061
|
|
87
|
-
<a name="l00062"></a>00062 SocketInfo() {}
|
|
88
|
-
<a name="l00063"></a>00063
|
|
89
|
-
<a name="l00064"></a>00064 SocketInfo(<span class="keyword">const</span> <span class="keywordtype">string</span> &address, <span class="keyword">const</span> <span class="keywordtype">string</span> &type) {
|
|
90
|
-
<a name="l00065"></a>00065 this->address = address;
|
|
91
|
-
<a name="l00066"></a>00066 this->type = type;
|
|
92
|
-
<a name="l00067"></a>00067 }
|
|
93
|
-
<a name="l00068"></a>00068 };
|
|
94
|
-
<a name="l00069"></a>00069
|
|
95
|
-
<a name="l00070"></a>00070 <span class="keyword">typedef</span> map<string, SocketInfo> SocketInfoMap;
|
|
96
|
-
<a name="l00071"></a>00071
|
|
97
|
-
<a name="l00072"></a>00072 <span class="keyword">private</span>:
|
|
98
|
-
<a name="l00073"></a>00073 <span class="keywordtype">string</span> appRoot;
|
|
99
|
-
<a name="l00074"></a>00074 pid_t pid;
|
|
100
|
-
<a name="l00075"></a>00075 <span class="keywordtype">int</span> ownerPipe;
|
|
101
|
-
<a name="l00076"></a>00076 <span class="keywordtype">string</span> detachKey;
|
|
102
|
-
<a name="l00077"></a>00077 <span class="keywordtype">string</span> connectPassword;
|
|
103
|
-
<a name="l00078"></a>00078 <span class="keywordtype">string</span> gupid;
|
|
104
|
-
<a name="l00079"></a>00079 SocketInfoMap serverSockets;
|
|
105
|
-
<a name="l00080"></a>00080 SocketInfo *mainServerSocket;
|
|
106
|
-
<a name="l00081"></a>00081 function<void ()> destructionCallback;
|
|
107
|
-
<a name="l00082"></a>00082
|
|
108
|
-
<a name="l00083"></a>00083 <span class="keyword">public</span>:<span class="comment"></span>
|
|
109
|
-
<a name="l00084"></a>00084 <span class="comment"> /**</span>
|
|
110
|
-
<a name="l00085"></a>00085 <span class="comment"> * Construct a new Process object.</span>
|
|
111
|
-
<a name="l00086"></a>00086 <span class="comment"> *</span>
|
|
112
|
-
<a name="l00087"></a>00087 <span class="comment"> * @param appRoot The application root of an application.</span>
|
|
113
|
-
<a name="l00088"></a>00088 <span class="comment"> * This must be a valid directory, but the path does not have to be absolute.</span>
|
|
114
|
-
<a name="l00089"></a>00089 <span class="comment"> * @param pid The process ID of this application process.</span>
|
|
115
|
-
<a name="l00090"></a>00090 <span class="comment"> * @param ownerPipe The owner pipe of this application process.</span>
|
|
116
|
-
<a name="l00091"></a>00091 <span class="comment"> * @param serverSockets All the server sockets that this process listens on.</span>
|
|
117
|
-
<a name="l00092"></a>00092 <span class="comment"> * There must a server socket with the name 'main'.</span>
|
|
118
|
-
<a name="l00093"></a>00093 <span class="comment"> * @param detachKey A detach key. Used by the ApplicationPool algorithm.</span>
|
|
119
|
-
<a name="l00094"></a>00094 <span class="comment"> * @param connectPassword The password to use when connecting to this process.</span>
|
|
120
|
-
<a name="l00095"></a>00095 <span class="comment"> * Must be valid ASCII.</span>
|
|
121
|
-
<a name="l00096"></a>00096 <span class="comment"> * @param gupid A string which uniquely identifies this process.</span>
|
|
122
|
-
<a name="l00097"></a>00097 <span class="comment"> * @param destructionCallback A callback to be called when this Process is destroyed.</span>
|
|
123
|
-
<a name="l00098"></a>00098 <span class="comment"> * @throws ArgumentException If serverSockets has no socket named 'main'.</span>
|
|
124
|
-
<a name="l00099"></a>00099 <span class="comment"> */</span>
|
|
125
|
-
<a name="l00100"></a><a class="code" href="classPassenger_1_1Process.html#a52c89242f2ff9298f302b4e2f75aea8f">00100</a> <a class="code" href="classPassenger_1_1Process.html#a52c89242f2ff9298f302b4e2f75aea8f" title="Construct a new Process object.">Process</a>(<span class="keyword">const</span> <span class="keywordtype">string</span> &appRoot, pid_t pid, <span class="keywordtype">int</span> ownerPipe, <span class="keyword">const</span> SocketInfoMap &serverSockets,
|
|
126
|
-
<a name="l00101"></a>00101 <span class="keyword">const</span> <span class="keywordtype">string</span> &detachKey, <span class="keyword">const</span> <span class="keywordtype">string</span> &connectPassword, <span class="keyword">const</span> <span class="keywordtype">string</span> &gupid,
|
|
127
|
-
<a name="l00102"></a>00102 <span class="keyword">const</span> function<<span class="keywordtype">void</span> ()> &destructionCallback = function<<span class="keywordtype">void</span> ()>())
|
|
128
|
-
<a name="l00103"></a>00103 {
|
|
129
|
-
<a name="l00104"></a>00104 this->appRoot = appRoot;
|
|
130
|
-
<a name="l00105"></a>00105 this->pid = pid;
|
|
131
|
-
<a name="l00106"></a>00106 this->ownerPipe = ownerPipe;
|
|
132
|
-
<a name="l00107"></a>00107 this->serverSockets = serverSockets;
|
|
133
|
-
<a name="l00108"></a>00108 this->detachKey = detachKey;
|
|
134
|
-
<a name="l00109"></a>00109 this->connectPassword = connectPassword;
|
|
135
|
-
<a name="l00110"></a>00110 this->gupid = gupid;
|
|
136
|
-
<a name="l00111"></a>00111 this->destructionCallback = destructionCallback;
|
|
137
|
-
<a name="l00112"></a>00112 <span class="keywordflow">if</span> (serverSockets.find(<span class="stringliteral">"main"</span>) == serverSockets.end()) {
|
|
138
|
-
<a name="l00113"></a>00113 TRACE_POINT();
|
|
139
|
-
<a name="l00114"></a>00114 <span class="keywordflow">throw</span> <a class="code" href="classPassenger_1_1ArgumentException.html" title="Indicates that a specified argument is incorrect or violates a requirement.">ArgumentException</a>(<span class="stringliteral">"There must be a server socket named 'main'."</span>);
|
|
140
|
-
<a name="l00115"></a>00115 }
|
|
141
|
-
<a name="l00116"></a>00116 mainServerSocket = &this->serverSockets[<span class="stringliteral">"main"</span>];
|
|
142
|
-
<a name="l00117"></a>00117 P_TRACE(3, <span class="stringliteral">"Application process "</span> << pid << <span class="stringliteral">" ("</span> << <span class="keyword">this</span> << <span class="stringliteral">"): created."</span>);
|
|
143
|
-
<a name="l00118"></a>00118 }
|
|
144
|
-
<a name="l00119"></a>00119
|
|
145
|
-
<a name="l00120"></a>00120 <span class="keyword">virtual</span> ~<a class="code" href="classPassenger_1_1Process.html" title="Represents a single application process, as spawned by SpawnManager or by ApplicationPool::Interface...">Process</a>() {
|
|
146
|
-
<a name="l00121"></a>00121 TRACE_POINT();
|
|
147
|
-
<a name="l00122"></a>00122 SocketInfoMap::const_iterator it;
|
|
148
|
-
<a name="l00123"></a>00123 <span class="keywordtype">int</span> ret;
|
|
149
|
-
<a name="l00124"></a>00124
|
|
150
|
-
<a name="l00125"></a>00125 <span class="keywordflow">if</span> (ownerPipe != -1) {
|
|
151
|
-
<a name="l00126"></a>00126 <span class="keywordflow">do</span> {
|
|
152
|
-
<a name="l00127"></a>00127 ret = close(ownerPipe);
|
|
153
|
-
<a name="l00128"></a>00128 } <span class="keywordflow">while</span> (ret == -1 && errno == EINTR);
|
|
154
|
-
<a name="l00129"></a>00129 }
|
|
155
|
-
<a name="l00130"></a>00130 <span class="keywordflow">for</span> (it = serverSockets.begin(); it != serverSockets.end(); it++) {
|
|
156
|
-
<a name="l00131"></a>00131 <span class="keyword">const</span> SocketInfo &info = it->second;
|
|
157
|
-
<a name="l00132"></a>00132 <span class="keywordflow">if</span> (info.type == <span class="stringliteral">"unix"</span>) {
|
|
158
|
-
<a name="l00133"></a>00133 <span class="keywordflow">do</span> {
|
|
159
|
-
<a name="l00134"></a>00134 ret = unlink(info.address.c_str());
|
|
160
|
-
<a name="l00135"></a>00135 } <span class="keywordflow">while</span> (ret == -1 && errno == EINTR);
|
|
161
|
-
<a name="l00136"></a>00136 }
|
|
162
|
-
<a name="l00137"></a>00137 }
|
|
163
|
-
<a name="l00138"></a>00138 P_TRACE(3, <span class="stringliteral">"Application process "</span> << pid << <span class="stringliteral">" ("</span> << <span class="keyword">this</span> << <span class="stringliteral">"): destroyed."</span>);
|
|
164
|
-
<a name="l00139"></a>00139
|
|
165
|
-
<a name="l00140"></a>00140 <span class="keywordflow">if</span> (destructionCallback) {
|
|
166
|
-
<a name="l00141"></a>00141 destructionCallback();
|
|
167
|
-
<a name="l00142"></a>00142 }
|
|
168
|
-
<a name="l00143"></a>00143 }
|
|
169
|
-
<a name="l00144"></a>00144 <span class="comment"></span>
|
|
170
|
-
<a name="l00145"></a>00145 <span class="comment"> /**</span>
|
|
171
|
-
<a name="l00146"></a>00146 <span class="comment"> * Returns the application root for this application process. See</span>
|
|
172
|
-
<a name="l00147"></a>00147 <span class="comment"> * the constructor for information about the application root.</span>
|
|
173
|
-
<a name="l00148"></a>00148 <span class="comment"> */</span>
|
|
174
|
-
<a name="l00149"></a><a class="code" href="classPassenger_1_1Process.html#ace9e949fa460ce09228cc08d76fc38e7">00149</a> <span class="keywordtype">string</span> <a class="code" href="classPassenger_1_1Process.html#ace9e949fa460ce09228cc08d76fc38e7" title="Returns the application root for this application process.">getAppRoot</a>()<span class="keyword"> const </span>{
|
|
175
|
-
<a name="l00150"></a>00150 <span class="keywordflow">return</span> appRoot;
|
|
176
|
-
<a name="l00151"></a>00151 }
|
|
177
|
-
<a name="l00152"></a>00152 <span class="comment"></span>
|
|
178
|
-
<a name="l00153"></a>00153 <span class="comment"> /**</span>
|
|
179
|
-
<a name="l00154"></a>00154 <span class="comment"> * Returns the process ID of this application process.</span>
|
|
180
|
-
<a name="l00155"></a>00155 <span class="comment"> */</span>
|
|
181
|
-
<a name="l00156"></a><a class="code" href="classPassenger_1_1Process.html#afc1b82c05e963fee7e58445b152ca784">00156</a> pid_t <a class="code" href="classPassenger_1_1Process.html#afc1b82c05e963fee7e58445b152ca784" title="Returns the process ID of this application process.">getPid</a>()<span class="keyword"> const </span>{
|
|
182
|
-
<a name="l00157"></a>00157 <span class="keywordflow">return</span> pid;
|
|
183
|
-
<a name="l00158"></a>00158 }
|
|
184
|
-
<a name="l00159"></a>00159 <span class="comment"></span>
|
|
185
|
-
<a name="l00160"></a>00160 <span class="comment"> /**</span>
|
|
186
|
-
<a name="l00161"></a>00161 <span class="comment"> * Returns this process's detach key.</span>
|
|
187
|
-
<a name="l00162"></a>00162 <span class="comment"> */</span>
|
|
188
|
-
<a name="l00163"></a><a class="code" href="classPassenger_1_1Process.html#a308fa4c3bf80e4d3d48a3c833b9e3205">00163</a> <span class="keywordtype">string</span> <a class="code" href="classPassenger_1_1Process.html#a308fa4c3bf80e4d3d48a3c833b9e3205" title="Returns this process&#39;s detach key.">getDetachKey</a>()<span class="keyword"> const </span>{
|
|
189
|
-
<a name="l00164"></a>00164 <span class="keywordflow">return</span> detachKey;
|
|
190
|
-
<a name="l00165"></a>00165 }
|
|
191
|
-
<a name="l00166"></a>00166 <span class="comment"></span>
|
|
192
|
-
<a name="l00167"></a>00167 <span class="comment"> /**</span>
|
|
193
|
-
<a name="l00168"></a>00168 <span class="comment"> * Returns this process's connect password. This password is</span>
|
|
194
|
-
<a name="l00169"></a>00169 <span class="comment"> * guaranteed to be valid ASCII.</span>
|
|
195
|
-
<a name="l00170"></a>00170 <span class="comment"> */</span>
|
|
196
|
-
<a name="l00171"></a><a class="code" href="classPassenger_1_1Process.html#a002791d7909d4d7a6566eb26ec491552">00171</a> <span class="keywordtype">string</span> <a class="code" href="classPassenger_1_1Process.html#a002791d7909d4d7a6566eb26ec491552" title="Returns this process&#39;s connect password.">getConnectPassword</a>()<span class="keyword"> const </span>{
|
|
197
|
-
<a name="l00172"></a>00172 <span class="keywordflow">return</span> connectPassword;
|
|
198
|
-
<a name="l00173"></a>00173 }
|
|
199
|
-
<a name="l00174"></a>00174 <span class="comment"></span>
|
|
200
|
-
<a name="l00175"></a>00175 <span class="comment"> /**</span>
|
|
201
|
-
<a name="l00176"></a>00176 <span class="comment"> * Returns this process's gupid. This is like a PID, but does not rotate</span>
|
|
202
|
-
<a name="l00177"></a>00177 <span class="comment"> * and is even unique over multiple servers.</span>
|
|
203
|
-
<a name="l00178"></a>00178 <span class="comment"> */</span>
|
|
204
|
-
<a name="l00179"></a><a class="code" href="classPassenger_1_1Process.html#a6997775fdfa7c0d9e681102bd044c40b">00179</a> <span class="keywordtype">string</span> <a class="code" href="classPassenger_1_1Process.html#a6997775fdfa7c0d9e681102bd044c40b" title="Returns this process&#39;s gupid.">getGupid</a>()<span class="keyword"> const </span>{
|
|
205
|
-
<a name="l00180"></a>00180 <span class="keywordflow">return</span> gupid;
|
|
206
|
-
<a name="l00181"></a>00181 }
|
|
207
|
-
<a name="l00182"></a>00182 <span class="comment"></span>
|
|
208
|
-
<a name="l00183"></a>00183 <span class="comment"> /**</span>
|
|
209
|
-
<a name="l00184"></a>00184 <span class="comment"> * Returns a map containing all server sockets that this process</span>
|
|
210
|
-
<a name="l00185"></a>00185 <span class="comment"> * listens on.</span>
|
|
211
|
-
<a name="l00186"></a>00186 <span class="comment"> */</span>
|
|
212
|
-
<a name="l00187"></a><a class="code" href="classPassenger_1_1Process.html#afe06f5be540203452a5e787da15ee5e4">00187</a> <span class="keyword">const</span> SocketInfoMap *<a class="code" href="classPassenger_1_1Process.html#afe06f5be540203452a5e787da15ee5e4" title="Returns a map containing all server sockets that this process listens on.">getServerSockets</a>()<span class="keyword"> const </span>{
|
|
213
|
-
<a name="l00188"></a>00188 <span class="keywordflow">return</span> &serverSockets;
|
|
214
|
-
<a name="l00189"></a>00189 }
|
|
215
|
-
<a name="l00190"></a>00190 <span class="comment"></span>
|
|
216
|
-
<a name="l00191"></a>00191 <span class="comment"> /**</span>
|
|
217
|
-
<a name="l00192"></a>00192 <span class="comment"> * Request a new session from this application process by connecting to its</span>
|
|
218
|
-
<a name="l00193"></a>00193 <span class="comment"> * main server socket. This session represents the life time of a single</span>
|
|
219
|
-
<a name="l00194"></a>00194 <span class="comment"> * request/response pair, and can be used to send the request data to the</span>
|
|
220
|
-
<a name="l00195"></a>00195 <span class="comment"> * application process, as well as receiving the response data.</span>
|
|
221
|
-
<a name="l00196"></a>00196 <span class="comment"> *</span>
|
|
222
|
-
<a name="l00197"></a>00197 <span class="comment"> * The use of connect() is demonstrated in the following example.</span>
|
|
223
|
-
<a name="l00198"></a>00198 <span class="comment"> * @code</span>
|
|
224
|
-
<a name="l00199"></a>00199 <span class="comment"> * // Request a new session from the process.</span>
|
|
225
|
-
<a name="l00200"></a>00200 <span class="comment"> * SessionPtr session = process->newSession(...);</span>
|
|
226
|
-
<a name="l00201"></a>00201 <span class="comment"> * </span>
|
|
227
|
-
<a name="l00202"></a>00202 <span class="comment"> * // Send the request headers and request body data.</span>
|
|
228
|
-
<a name="l00203"></a>00203 <span class="comment"> * session->sendHeaders(...);</span>
|
|
229
|
-
<a name="l00204"></a>00204 <span class="comment"> * session->sendBodyBlock(...);</span>
|
|
230
|
-
<a name="l00205"></a>00205 <span class="comment"> * // Done sending data, so we close the writer channel.</span>
|
|
231
|
-
<a name="l00206"></a>00206 <span class="comment"> * session->shutdownWriter();</span>
|
|
232
|
-
<a name="l00207"></a>00207 <span class="comment"> *</span>
|
|
233
|
-
<a name="l00208"></a>00208 <span class="comment"> * // Now read the HTTP response.</span>
|
|
234
|
-
<a name="l00209"></a>00209 <span class="comment"> * string responseData = readAllDataFromSocket(session->getReader());</span>
|
|
235
|
-
<a name="l00210"></a>00210 <span class="comment"> * // Done reading data, so we close the reader channel.</span>
|
|
236
|
-
<a name="l00211"></a>00211 <span class="comment"> * session->shutdownReader();</span>
|
|
237
|
-
<a name="l00212"></a>00212 <span class="comment"> *</span>
|
|
238
|
-
<a name="l00213"></a>00213 <span class="comment"> * // This session has now finished, so we close the session by resetting</span>
|
|
239
|
-
<a name="l00214"></a>00214 <span class="comment"> * // the smart pointer to NULL (thereby destroying the Session object).</span>
|
|
240
|
-
<a name="l00215"></a>00215 <span class="comment"> * session.reset();</span>
|
|
241
|
-
<a name="l00216"></a>00216 <span class="comment"> *</span>
|
|
242
|
-
<a name="l00217"></a>00217 <span class="comment"> * // We can connect to a Process multiple times. Just make sure</span>
|
|
243
|
-
<a name="l00218"></a>00218 <span class="comment"> * // the previous session is closed.</span>
|
|
244
|
-
<a name="l00219"></a>00219 <span class="comment"> * session = process->newSession(...);</span>
|
|
245
|
-
<a name="l00220"></a>00220 <span class="comment"> * @endcode</span>
|
|
246
|
-
<a name="l00221"></a>00221 <span class="comment"> *</span>
|
|
247
|
-
<a name="l00222"></a>00222 <span class="comment"> * You <b>must</b> close a session when you no longer need it. If you</span>
|
|
248
|
-
<a name="l00223"></a>00223 <span class="comment"> * call connect() without having properly closed a previous session,</span>
|
|
249
|
-
<a name="l00224"></a>00224 <span class="comment"> * you might cause a deadlock because the application process may be</span>
|
|
250
|
-
<a name="l00225"></a>00225 <span class="comment"> * waiting for you to close the previous session.</span>
|
|
251
|
-
<a name="l00226"></a>00226 <span class="comment"> *</span>
|
|
252
|
-
<a name="l00227"></a>00227 <span class="comment"> * @param closeCallback A function which will be called when the session has been closed.</span>
|
|
253
|
-
<a name="l00228"></a>00228 <span class="comment"> * @param initiateNow Whether the session should be initiated immediately.</span>
|
|
254
|
-
<a name="l00229"></a>00229 <span class="comment"> * If set to false then you must call <tt>initiate()</tt> on</span>
|
|
255
|
-
<a name="l00230"></a>00230 <span class="comment"> * the session before it's usable.</span>
|
|
256
|
-
<a name="l00231"></a>00231 <span class="comment"> * @return A smart pointer to a Session object, which represents the created session.</span>
|
|
257
|
-
<a name="l00232"></a>00232 <span class="comment"> * @post result->initiated() == initiateNow</span>
|
|
258
|
-
<a name="l00233"></a>00233 <span class="comment"> * @throws SystemException Something went wrong during session initiation.</span>
|
|
259
|
-
<a name="l00234"></a>00234 <span class="comment"> * @throws IOException Something went wrong during session initiation.</span>
|
|
260
|
-
<a name="l00235"></a>00235 <span class="comment"> * @throws boost::thread_interrupted</span>
|
|
261
|
-
<a name="l00236"></a>00236 <span class="comment"> */</span>
|
|
262
|
-
<a name="l00237"></a><a class="code" href="classPassenger_1_1Process.html#a4df3ce126ba64c864c1759d916f25635">00237</a> SessionPtr <a class="code" href="classPassenger_1_1Process.html#a4df3ce126ba64c864c1759d916f25635" title="Request a new session from this application process by connecting to its main server...">newSession</a>(<span class="keyword">const</span> StandardSession::CloseCallback &closeCallback = StandardSession::CloseCallback(),
|
|
263
|
-
<a name="l00238"></a>00238 <span class="keywordtype">bool</span> initiateNow = <span class="keyword">true</span>)
|
|
264
|
-
<a name="l00239"></a>00239 {
|
|
265
|
-
<a name="l00240"></a>00240 SessionPtr session(<span class="keyword">new</span> <a class="code" href="classPassenger_1_1StandardSession.html" title="A &quot;standard&quot; implementation of Session.">StandardSession</a>(pid, closeCallback,
|
|
266
|
-
<a name="l00241"></a>00241 mainServerSocket->type, mainServerSocket->address,
|
|
267
|
-
<a name="l00242"></a>00242 detachKey, connectPassword, gupid));
|
|
268
|
-
<a name="l00243"></a>00243 <span class="keywordflow">if</span> (initiateNow) {
|
|
269
|
-
<a name="l00244"></a>00244 session->initiate();
|
|
270
|
-
<a name="l00245"></a>00245 }
|
|
271
|
-
<a name="l00246"></a>00246 <span class="keywordflow">return</span> session;
|
|
272
|
-
<a name="l00247"></a>00247 }
|
|
273
|
-
<a name="l00248"></a>00248 };
|
|
274
|
-
<a name="l00249"></a>00249 <span class="comment"></span>
|
|
275
|
-
<a name="l00250"></a>00250 <span class="comment">/** Convenient alias for Process smart pointer. */</span>
|
|
276
|
-
<a name="l00251"></a><a class="code" href="namespacePassenger.html#aced1f248465136b313c6dec5fe6ca492">00251</a> <span class="keyword">typedef</span> shared_ptr<Process> <a class="code" href="namespacePassenger.html#aced1f248465136b313c6dec5fe6ca492" title="Convenient alias for Process smart pointer.">ProcessPtr</a>;
|
|
277
|
-
<a name="l00252"></a>00252
|
|
278
|
-
<a name="l00253"></a>00253 } <span class="comment">// namespace Passenger</span>
|
|
279
|
-
<a name="l00254"></a>00254
|
|
280
|
-
<a name="l00255"></a>00255 <span class="preprocessor">#endif </span><span class="comment">/* _PASSENGER_PROCESS_H_ */</span>
|
|
281
|
-
</pre></div></div>
|
|
282
|
-
<hr size="1"/><address style="text-align: right;"><small>Generated by
|
|
283
|
-
<a href="http://www.doxygen.org/index.html">
|
|
284
|
-
<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.6.2 </small></address>
|
|
285
|
-
</body>
|
|
286
|
-
</html>
|
|
@@ -1,191 +0,0 @@
|
|
|
1
|
-
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
|
2
|
-
<html xmlns="http://www.w3.org/1999/xhtml">
|
|
3
|
-
<head>
|
|
4
|
-
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
|
|
5
|
-
<title>Passenger: RandomGenerator.h Source File</title>
|
|
6
|
-
<link href="tabs.css" rel="stylesheet" type="text/css"/>
|
|
7
|
-
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
|
|
8
|
-
</head>
|
|
9
|
-
<body>
|
|
10
|
-
<!-- Generated by Doxygen 1.6.2 -->
|
|
11
|
-
<div class="navigation" id="top">
|
|
12
|
-
<div class="tabs">
|
|
13
|
-
<ul>
|
|
14
|
-
<li><a href="main.html"><span>Main Page</span></a></li>
|
|
15
|
-
<li><a href="modules.html"><span>Modules</span></a></li>
|
|
16
|
-
<li><a href="namespaces.html"><span>Namespaces</span></a></li>
|
|
17
|
-
<li><a href="annotated.html"><span>Classes</span></a></li>
|
|
18
|
-
<li class="current"><a href="files.html"><span>Files</span></a></li>
|
|
19
|
-
</ul>
|
|
20
|
-
</div>
|
|
21
|
-
<div class="tabs">
|
|
22
|
-
<ul>
|
|
23
|
-
<li><a href="files.html"><span>File List</span></a></li>
|
|
24
|
-
</ul>
|
|
25
|
-
</div>
|
|
26
|
-
<h1>RandomGenerator.h</h1><div class="fragment"><pre class="fragment"><a name="l00001"></a>00001 <span class="comment">/*</span>
|
|
27
|
-
<a name="l00002"></a>00002 <span class="comment"> * Phusion Passenger - http://www.modrails.com/</span>
|
|
28
|
-
<a name="l00003"></a>00003 <span class="comment"> * Copyright (c) 2010 Phusion</span>
|
|
29
|
-
<a name="l00004"></a>00004 <span class="comment"> *</span>
|
|
30
|
-
<a name="l00005"></a>00005 <span class="comment"> * "Phusion Passenger" is a trademark of Hongli Lai & Ninh Bui.</span>
|
|
31
|
-
<a name="l00006"></a>00006 <span class="comment"> *</span>
|
|
32
|
-
<a name="l00007"></a>00007 <span class="comment"> * Permission is hereby granted, free of charge, to any person obtaining a copy</span>
|
|
33
|
-
<a name="l00008"></a>00008 <span class="comment"> * of this software and associated documentation files (the "Software"), to deal</span>
|
|
34
|
-
<a name="l00009"></a>00009 <span class="comment"> * in the Software without restriction, including without limitation the rights</span>
|
|
35
|
-
<a name="l00010"></a>00010 <span class="comment"> * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell</span>
|
|
36
|
-
<a name="l00011"></a>00011 <span class="comment"> * copies of the Software, and to permit persons to whom the Software is</span>
|
|
37
|
-
<a name="l00012"></a>00012 <span class="comment"> * furnished to do so, subject to the following conditions:</span>
|
|
38
|
-
<a name="l00013"></a>00013 <span class="comment"> *</span>
|
|
39
|
-
<a name="l00014"></a>00014 <span class="comment"> * The above copyright notice and this permission notice shall be included in</span>
|
|
40
|
-
<a name="l00015"></a>00015 <span class="comment"> * all copies or substantial portions of the Software.</span>
|
|
41
|
-
<a name="l00016"></a>00016 <span class="comment"> *</span>
|
|
42
|
-
<a name="l00017"></a>00017 <span class="comment"> * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR</span>
|
|
43
|
-
<a name="l00018"></a>00018 <span class="comment"> * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,</span>
|
|
44
|
-
<a name="l00019"></a>00019 <span class="comment"> * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE</span>
|
|
45
|
-
<a name="l00020"></a>00020 <span class="comment"> * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER</span>
|
|
46
|
-
<a name="l00021"></a>00021 <span class="comment"> * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,</span>
|
|
47
|
-
<a name="l00022"></a>00022 <span class="comment"> * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN</span>
|
|
48
|
-
<a name="l00023"></a>00023 <span class="comment"> * THE SOFTWARE.</span>
|
|
49
|
-
<a name="l00024"></a>00024 <span class="comment"> */</span>
|
|
50
|
-
<a name="l00025"></a>00025 <span class="preprocessor">#ifndef _PASSENGER_RANDOM_GENERATOR_H_</span>
|
|
51
|
-
<a name="l00026"></a>00026 <span class="preprocessor"></span><span class="preprocessor">#define _PASSENGER_RANDOM_GENERATOR_H_</span>
|
|
52
|
-
<a name="l00027"></a>00027 <span class="preprocessor"></span>
|
|
53
|
-
<a name="l00028"></a>00028 <span class="preprocessor">#include <string></span>
|
|
54
|
-
<a name="l00029"></a>00029
|
|
55
|
-
<a name="l00030"></a>00030 <span class="preprocessor">#include <boost/noncopyable.hpp></span>
|
|
56
|
-
<a name="l00031"></a>00031 <span class="preprocessor">#include <boost/shared_ptr.hpp></span>
|
|
57
|
-
<a name="l00032"></a>00032 <span class="preprocessor">#include <oxt/system_calls.hpp></span>
|
|
58
|
-
<a name="l00033"></a>00033
|
|
59
|
-
<a name="l00034"></a>00034 <span class="preprocessor">#include "StaticString.h"</span>
|
|
60
|
-
<a name="l00035"></a>00035 <span class="preprocessor">#include "Exceptions.h"</span>
|
|
61
|
-
<a name="l00036"></a>00036 <span class="preprocessor">#include "Utils/StrIntUtils.h"</span>
|
|
62
|
-
<a name="l00037"></a>00037
|
|
63
|
-
<a name="l00038"></a>00038 <span class="comment"></span>
|
|
64
|
-
<a name="l00039"></a>00039 <span class="comment">/**</span>
|
|
65
|
-
<a name="l00040"></a>00040 <span class="comment"> * A random </span>
|
|
66
|
-
<a name="l00041"></a>00041 <span class="comment"> */</span>
|
|
67
|
-
<a name="l00042"></a>00042 <span class="keyword">namespace </span>Passenger {
|
|
68
|
-
<a name="l00043"></a>00043
|
|
69
|
-
<a name="l00044"></a>00044 <span class="keyword">using namespace </span>std;
|
|
70
|
-
<a name="l00045"></a>00045 <span class="keyword">using namespace </span>boost;
|
|
71
|
-
<a name="l00046"></a>00046 <span class="keyword">using namespace </span>oxt;
|
|
72
|
-
<a name="l00047"></a>00047 <span class="comment"></span>
|
|
73
|
-
<a name="l00048"></a>00048 <span class="comment">/**</span>
|
|
74
|
-
<a name="l00049"></a>00049 <span class="comment"> * A random data generator. Data is generated using /dev/urandom, and</span>
|
|
75
|
-
<a name="l00050"></a>00050 <span class="comment"> * is cryptographically secure. Unlike rand() and friends,</span>
|
|
76
|
-
<a name="l00051"></a>00051 <span class="comment"> * RandomGenerator does not require seeding.</span>
|
|
77
|
-
<a name="l00052"></a>00052 <span class="comment"> *</span>
|
|
78
|
-
<a name="l00053"></a>00053 <span class="comment"> * The reason why RandomGenerator isn't a singleton is because opening</span>
|
|
79
|
-
<a name="l00054"></a>00054 <span class="comment"> * /dev/urandom is *very* slow on Mac OS X and OpenBSD. Each object of</span>
|
|
80
|
-
<a name="l00055"></a>00055 <span class="comment"> * this class caches the /dev/urandom file handle.</span>
|
|
81
|
-
<a name="l00056"></a>00056 <span class="comment"> *</span>
|
|
82
|
-
<a name="l00057"></a>00057 <span class="comment"> * This class is thread-safe as long as there are no concurrent</span>
|
|
83
|
-
<a name="l00058"></a>00058 <span class="comment"> * calls to reopen() or close().</span>
|
|
84
|
-
<a name="l00059"></a>00059 <span class="comment"> */</span>
|
|
85
|
-
<a name="l00060"></a><a class="code" href="classPassenger_1_1RandomGenerator.html">00060</a> <span class="keyword">class </span><a class="code" href="classPassenger_1_1RandomGenerator.html" title="A random data generator.">RandomGenerator</a>: <span class="keyword">public</span> boost::noncopyable {
|
|
86
|
-
<a name="l00061"></a>00061 <span class="keyword">private</span>:
|
|
87
|
-
<a name="l00062"></a>00062 FILE *handle;
|
|
88
|
-
<a name="l00063"></a>00063
|
|
89
|
-
<a name="l00064"></a>00064 <span class="keyword">public</span>:
|
|
90
|
-
<a name="l00065"></a>00065 <a class="code" href="classPassenger_1_1RandomGenerator.html" title="A random data generator.">RandomGenerator</a>(<span class="keywordtype">bool</span> open = <span class="keyword">true</span>) {
|
|
91
|
-
<a name="l00066"></a>00066 handle = NULL;
|
|
92
|
-
<a name="l00067"></a>00067 <span class="keywordflow">if</span> (open) {
|
|
93
|
-
<a name="l00068"></a>00068 reopen();
|
|
94
|
-
<a name="l00069"></a>00069 }
|
|
95
|
-
<a name="l00070"></a>00070 }
|
|
96
|
-
<a name="l00071"></a>00071
|
|
97
|
-
<a name="l00072"></a>00072 ~<a class="code" href="classPassenger_1_1RandomGenerator.html" title="A random data generator.">RandomGenerator</a>() {
|
|
98
|
-
<a name="l00073"></a>00073 this_thread::disable_syscall_interruption dsi;
|
|
99
|
-
<a name="l00074"></a>00074 close();
|
|
100
|
-
<a name="l00075"></a>00075 }
|
|
101
|
-
<a name="l00076"></a>00076
|
|
102
|
-
<a name="l00077"></a>00077 <span class="keywordtype">void</span> reopen() {
|
|
103
|
-
<a name="l00078"></a>00078 close();
|
|
104
|
-
<a name="l00079"></a>00079 handle = syscalls::fopen(<span class="stringliteral">"/dev/urandom"</span>, <span class="stringliteral">"r"</span>);
|
|
105
|
-
<a name="l00080"></a>00080 <span class="keywordflow">if</span> (handle == NULL) {
|
|
106
|
-
<a name="l00081"></a>00081 <span class="keywordflow">throw</span> <a class="code" href="classPassenger_1_1FileSystemException.html" title="A filesystem error, as returned by the operating system.">FileSystemException</a>(<span class="stringliteral">"Cannot open /dev/urandom"</span>,
|
|
107
|
-
<a name="l00082"></a>00082 errno, <span class="stringliteral">"/dev/urandom"</span>);
|
|
108
|
-
<a name="l00083"></a>00083 }
|
|
109
|
-
<a name="l00084"></a>00084 }
|
|
110
|
-
<a name="l00085"></a>00085
|
|
111
|
-
<a name="l00086"></a>00086 <span class="keywordtype">void</span> close() {
|
|
112
|
-
<a name="l00087"></a>00087 <span class="keywordflow">if</span> (handle != NULL) {
|
|
113
|
-
<a name="l00088"></a>00088 syscalls::fclose(handle);
|
|
114
|
-
<a name="l00089"></a>00089 handle = NULL;
|
|
115
|
-
<a name="l00090"></a>00090 }
|
|
116
|
-
<a name="l00091"></a>00091 }
|
|
117
|
-
<a name="l00092"></a>00092
|
|
118
|
-
<a name="l00093"></a>00093 <a class="code" href="classPassenger_1_1StaticString.html" title="An immutable, static byte buffer.">StaticString</a> generateBytes(<span class="keywordtype">void</span> *buf, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> size) {
|
|
119
|
-
<a name="l00094"></a>00094 <span class="keywordtype">size_t</span> ret = syscalls::fread(buf, 1, size, handle);
|
|
120
|
-
<a name="l00095"></a>00095 <span class="keywordflow">if</span> (ret != size) {
|
|
121
|
-
<a name="l00096"></a>00096 <span class="keywordflow">throw</span> <a class="code" href="classPassenger_1_1IOException.html" title="Represents an error that occured during an I/O operation.">IOException</a>(<span class="stringliteral">"Cannot read sufficient data from /dev/urandom"</span>);
|
|
122
|
-
<a name="l00097"></a>00097 }
|
|
123
|
-
<a name="l00098"></a>00098 <span class="keywordflow">return</span> <a class="code" href="classPassenger_1_1StaticString.html" title="An immutable, static byte buffer.">StaticString</a>((<span class="keyword">const</span> <span class="keywordtype">char</span> *) buf, size);
|
|
124
|
-
<a name="l00099"></a>00099 }
|
|
125
|
-
<a name="l00100"></a>00100
|
|
126
|
-
<a name="l00101"></a>00101 <span class="keywordtype">string</span> generateByteString(<span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> size) {
|
|
127
|
-
<a name="l00102"></a>00102 <span class="keywordtype">char</span> buf[size];
|
|
128
|
-
<a name="l00103"></a>00103 generateBytes(buf, size);
|
|
129
|
-
<a name="l00104"></a>00104 <span class="keywordflow">return</span> string(buf, size);
|
|
130
|
-
<a name="l00105"></a>00105 }
|
|
131
|
-
<a name="l00106"></a>00106
|
|
132
|
-
<a name="l00107"></a>00107 <span class="keywordtype">string</span> generateHexString(<span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> size) {
|
|
133
|
-
<a name="l00108"></a>00108 <span class="keywordtype">char</span> buf[size];
|
|
134
|
-
<a name="l00109"></a>00109 generateBytes(buf, size);
|
|
135
|
-
<a name="l00110"></a>00110 <span class="keywordflow">return</span> toHex(<a class="code" href="classPassenger_1_1StaticString.html" title="An immutable, static byte buffer.">StaticString</a>(buf, size));
|
|
136
|
-
<a name="l00111"></a>00111 }
|
|
137
|
-
<a name="l00112"></a>00112 <span class="comment"></span>
|
|
138
|
-
<a name="l00113"></a>00113 <span class="comment"> /**</span>
|
|
139
|
-
<a name="l00114"></a>00114 <span class="comment"> * Generates a random string of <em>size</em> bytes which is also</span>
|
|
140
|
-
<a name="l00115"></a>00115 <span class="comment"> * valid ASCII. The result consists only of the characters A-Z,</span>
|
|
141
|
-
<a name="l00116"></a>00116 <span class="comment"> * a-z and 0-9, and therefore the total number of possibilities</span>
|
|
142
|
-
<a name="l00117"></a>00117 <span class="comment"> * given a size of N is 62**N. However not every character has an</span>
|
|
143
|
-
<a name="l00118"></a>00118 <span class="comment"> * equal chance of being chosen: a-i have 5/256 chance of being</span>
|
|
144
|
-
<a name="l00119"></a>00119 <span class="comment"> * chosen, while other characters have 4/256 chance of being chosen.</span>
|
|
145
|
-
<a name="l00120"></a>00120 <span class="comment"> * Therefore, to match the entropy of a random binary string of</span>
|
|
146
|
-
<a name="l00121"></a>00121 <span class="comment"> * size N, one should choose a <em>size</em> which yields slightly</span>
|
|
147
|
-
<a name="l00122"></a>00122 <span class="comment"> * more possibilities than 2**N.</span>
|
|
148
|
-
<a name="l00123"></a>00123 <span class="comment"> */</span>
|
|
149
|
-
<a name="l00124"></a><a class="code" href="classPassenger_1_1RandomGenerator.html#ad9d9a489f6dbfabafb35da326f5ed967">00124</a> <span class="keywordtype">string</span> <a class="code" href="classPassenger_1_1RandomGenerator.html#ad9d9a489f6dbfabafb35da326f5ed967" title="Generates a random string of size bytes which is also valid ASCII.">generateAsciiString</a>(<span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> size) {
|
|
150
|
-
<a name="l00125"></a>00125 <span class="keywordtype">char</span> buf[size];
|
|
151
|
-
<a name="l00126"></a>00126 <a class="code" href="classPassenger_1_1RandomGenerator.html#ad9d9a489f6dbfabafb35da326f5ed967" title="Generates a random string of size bytes which is also valid ASCII.">generateAsciiString</a>(buf, size);
|
|
152
|
-
<a name="l00127"></a>00127 <span class="keywordflow">return</span> string(buf, size);
|
|
153
|
-
<a name="l00128"></a>00128 }
|
|
154
|
-
<a name="l00129"></a>00129
|
|
155
|
-
<a name="l00130"></a>00130 <span class="keywordtype">void</span> <a class="code" href="classPassenger_1_1RandomGenerator.html#ad9d9a489f6dbfabafb35da326f5ed967" title="Generates a random string of size bytes which is also valid ASCII.">generateAsciiString</a>(<span class="keywordtype">char</span> *_buf, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> size) {
|
|
156
|
-
<a name="l00131"></a>00131 <span class="keyword">static</span> <span class="keyword">const</span> <span class="keywordtype">char</span> chars[] = {
|
|
157
|
-
<a name="l00132"></a>00132 <span class="charliteral">'a'</span>, <span class="charliteral">'b'</span>, <span class="charliteral">'c'</span>, <span class="charliteral">'d'</span>, <span class="charliteral">'e'</span>, <span class="charliteral">'f'</span>, <span class="charliteral">'g'</span>, <span class="charliteral">'h'</span>, <span class="charliteral">'i'</span>, <span class="charliteral">'j'</span>, <span class="charliteral">'k'</span>, <span class="charliteral">'l'</span>, <span class="charliteral">'m'</span>,
|
|
158
|
-
<a name="l00133"></a>00133 <span class="charliteral">'n'</span>, <span class="charliteral">'o'</span>, <span class="charliteral">'p'</span>, <span class="charliteral">'q'</span>, <span class="charliteral">'r'</span>, <span class="charliteral">'s'</span>, <span class="charliteral">'t'</span>, <span class="charliteral">'u'</span>, <span class="charliteral">'v'</span>, <span class="charliteral">'w'</span>, <span class="charliteral">'x'</span>, <span class="charliteral">'y'</span>, <span class="charliteral">'z'</span>,
|
|
159
|
-
<a name="l00134"></a>00134 <span class="charliteral">'A'</span>, <span class="charliteral">'B'</span>, <span class="charliteral">'C'</span>, <span class="charliteral">'D'</span>, <span class="charliteral">'E'</span>, <span class="charliteral">'F'</span>, <span class="charliteral">'G'</span>, <span class="charliteral">'H'</span>, <span class="charliteral">'I'</span>, <span class="charliteral">'J'</span>, <span class="charliteral">'K'</span>, <span class="charliteral">'L'</span>, <span class="charliteral">'M'</span>,
|
|
160
|
-
<a name="l00135"></a>00135 <span class="charliteral">'N'</span>, <span class="charliteral">'O'</span>, <span class="charliteral">'P'</span>, <span class="charliteral">'Q'</span>, <span class="charliteral">'R'</span>, <span class="charliteral">'S'</span>, <span class="charliteral">'T'</span>, <span class="charliteral">'U'</span>, <span class="charliteral">'V'</span>, <span class="charliteral">'W'</span>, <span class="charliteral">'X'</span>, <span class="charliteral">'Y'</span>, <span class="charliteral">'Z'</span>,
|
|
161
|
-
<a name="l00136"></a>00136 <span class="charliteral">'0'</span>, <span class="charliteral">'1'</span>, <span class="charliteral">'2'</span>, <span class="charliteral">'3'</span>, <span class="charliteral">'4'</span>, <span class="charliteral">'5'</span>, <span class="charliteral">'6'</span>, <span class="charliteral">'7'</span>, <span class="charliteral">'8'</span>, <span class="charliteral">'9'</span>
|
|
162
|
-
<a name="l00137"></a>00137 };
|
|
163
|
-
<a name="l00138"></a>00138 <span class="keywordtype">unsigned</span> <span class="keywordtype">char</span> *buf = (<span class="keywordtype">unsigned</span> <span class="keywordtype">char</span> *) _buf;
|
|
164
|
-
<a name="l00139"></a>00139 generateBytes(buf, size);
|
|
165
|
-
<a name="l00140"></a>00140 <span class="keywordflow">for</span> (<span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> i = 0; i < size; i++) {
|
|
166
|
-
<a name="l00141"></a>00141 buf[i] = chars[buf[i] % <span class="keyword">sizeof</span>(chars)];
|
|
167
|
-
<a name="l00142"></a>00142 }
|
|
168
|
-
<a name="l00143"></a>00143 }
|
|
169
|
-
<a name="l00144"></a>00144
|
|
170
|
-
<a name="l00145"></a>00145 <span class="keywordtype">int</span> generateInt() {
|
|
171
|
-
<a name="l00146"></a>00146 <span class="keywordtype">int</span> ret;
|
|
172
|
-
<a name="l00147"></a>00147 generateBytes(&ret, <span class="keyword">sizeof</span>(ret));
|
|
173
|
-
<a name="l00148"></a>00148 <span class="keywordflow">return</span> ret;
|
|
174
|
-
<a name="l00149"></a>00149 }
|
|
175
|
-
<a name="l00150"></a>00150
|
|
176
|
-
<a name="l00151"></a>00151 <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> generateUint() {
|
|
177
|
-
<a name="l00152"></a>00152 <span class="keywordflow">return</span> (<span class="keywordtype">unsigned</span> <span class="keywordtype">int</span>) generateInt();
|
|
178
|
-
<a name="l00153"></a>00153 }
|
|
179
|
-
<a name="l00154"></a>00154 };
|
|
180
|
-
<a name="l00155"></a>00155
|
|
181
|
-
<a name="l00156"></a>00156 <span class="keyword">typedef</span> shared_ptr<RandomGenerator> RandomGeneratorPtr;
|
|
182
|
-
<a name="l00157"></a>00157
|
|
183
|
-
<a name="l00158"></a>00158 } <span class="comment">// namespace Passenger</span>
|
|
184
|
-
<a name="l00159"></a>00159
|
|
185
|
-
<a name="l00160"></a>00160 <span class="preprocessor">#endif </span><span class="comment">/* _PASSENGER_RANDOM_GENERATOR_H_ */</span>
|
|
186
|
-
</pre></div></div>
|
|
187
|
-
<hr size="1"/><address style="text-align: right;"><small>Generated by
|
|
188
|
-
<a href="http://www.doxygen.org/index.html">
|
|
189
|
-
<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.6.2 </small></address>
|
|
190
|
-
</body>
|
|
191
|
-
</html>
|