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,378 +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: ServerInstanceDir.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>ServerInstanceDir.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_SERVER_INSTANCE_DIR_H_</span>
|
|
51
|
-
<a name="l00026"></a>00026 <span class="preprocessor"></span><span class="preprocessor">#define _PASSENGER_SERVER_INSTANCE_DIR_H_</span>
|
|
52
|
-
<a name="l00027"></a>00027 <span class="preprocessor"></span>
|
|
53
|
-
<a name="l00028"></a>00028 <span class="preprocessor">#include <boost/noncopyable.hpp></span>
|
|
54
|
-
<a name="l00029"></a>00029 <span class="preprocessor">#include <boost/shared_ptr.hpp></span>
|
|
55
|
-
<a name="l00030"></a>00030 <span class="preprocessor">#include <oxt/backtrace.hpp></span>
|
|
56
|
-
<a name="l00031"></a>00031
|
|
57
|
-
<a name="l00032"></a>00032 <span class="preprocessor">#include <sys/types.h></span>
|
|
58
|
-
<a name="l00033"></a>00033 <span class="preprocessor">#include <dirent.h></span>
|
|
59
|
-
<a name="l00034"></a>00034 <span class="preprocessor">#include <unistd.h></span>
|
|
60
|
-
<a name="l00035"></a>00035 <span class="preprocessor">#include <pwd.h></span>
|
|
61
|
-
<a name="l00036"></a>00036 <span class="preprocessor">#include <grp.h></span>
|
|
62
|
-
<a name="l00037"></a>00037 <span class="preprocessor">#include <cstdlib></span>
|
|
63
|
-
<a name="l00038"></a>00038 <span class="preprocessor">#include <cstring></span>
|
|
64
|
-
<a name="l00039"></a>00039 <span class="preprocessor">#include <string></span>
|
|
65
|
-
<a name="l00040"></a>00040
|
|
66
|
-
<a name="l00041"></a>00041 <span class="preprocessor">#include "Exceptions.h"</span>
|
|
67
|
-
<a name="l00042"></a>00042 <span class="preprocessor">#include "Utils.h"</span>
|
|
68
|
-
<a name="l00043"></a>00043 <span class="preprocessor">#include "Utils/StrIntUtils.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
|
|
75
|
-
<a name="l00050"></a>00050 <span class="keyword">class </span>ServerInstanceDir: <span class="keyword">public</span> noncopyable {
|
|
76
|
-
<a name="l00051"></a>00051 <span class="keyword">public</span>:
|
|
77
|
-
<a name="l00052"></a>00052 <span class="comment">// Don't forget to update lib/phusion_passenger/admin_tools/server_instance.rb too.</span>
|
|
78
|
-
<a name="l00053"></a>00053 <span class="keyword">static</span> <span class="keyword">const</span> <span class="keywordtype">int</span> DIR_STRUCTURE_MAJOR_VERSION = 1;
|
|
79
|
-
<a name="l00054"></a>00054 <span class="keyword">static</span> <span class="keyword">const</span> <span class="keywordtype">int</span> DIR_STRUCTURE_MINOR_VERSION = 0;
|
|
80
|
-
<a name="l00055"></a>00055 <span class="keyword">static</span> <span class="keyword">const</span> <span class="keywordtype">int</span> GENERATION_STRUCTURE_MAJOR_VERSION = 1;
|
|
81
|
-
<a name="l00056"></a>00056 <span class="keyword">static</span> <span class="keyword">const</span> <span class="keywordtype">int</span> GENERATION_STRUCTURE_MINOR_VERSION = 0;
|
|
82
|
-
<a name="l00057"></a>00057
|
|
83
|
-
<a name="l00058"></a>00058 <span class="keyword">class </span>Generation: <span class="keyword">public</span> noncopyable {
|
|
84
|
-
<a name="l00059"></a>00059 <span class="keyword">private</span>:
|
|
85
|
-
<a name="l00060"></a>00060 <span class="keyword">friend</span> <span class="keyword">class </span>ServerInstanceDir;
|
|
86
|
-
<a name="l00061"></a>00061
|
|
87
|
-
<a name="l00062"></a>00062 <span class="keywordtype">string</span> path;
|
|
88
|
-
<a name="l00063"></a>00063 <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> number;
|
|
89
|
-
<a name="l00064"></a>00064 <span class="keywordtype">bool</span> owner;
|
|
90
|
-
<a name="l00065"></a>00065
|
|
91
|
-
<a name="l00066"></a>00066 Generation(<span class="keyword">const</span> <span class="keywordtype">string</span> &serverInstanceDir, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> number) {
|
|
92
|
-
<a name="l00067"></a>00067 path = serverInstanceDir + <span class="stringliteral">"/generation-"</span> + toString(number);
|
|
93
|
-
<a name="l00068"></a>00068 this->number = number;
|
|
94
|
-
<a name="l00069"></a>00069 owner = <span class="keyword">false</span>;
|
|
95
|
-
<a name="l00070"></a>00070 }
|
|
96
|
-
<a name="l00071"></a>00071
|
|
97
|
-
<a name="l00072"></a>00072 <span class="keywordtype">void</span> create(<span class="keywordtype">bool</span> userSwitching, <span class="keyword">const</span> <span class="keywordtype">string</span> &defaultUser,
|
|
98
|
-
<a name="l00073"></a>00073 <span class="keyword">const</span> <span class="keywordtype">string</span> &defaultGroup, uid_t webServerWorkerUid,
|
|
99
|
-
<a name="l00074"></a>00074 gid_t webServerWorkerGid)
|
|
100
|
-
<a name="l00075"></a>00075 {
|
|
101
|
-
<a name="l00076"></a>00076 TRACE_POINT();
|
|
102
|
-
<a name="l00077"></a>00077 <span class="keywordtype">bool</span> runningAsRoot = geteuid() == 0;
|
|
103
|
-
<a name="l00078"></a>00078 <span class="keyword">struct </span>passwd *defaultUserEntry;
|
|
104
|
-
<a name="l00079"></a>00079 <span class="keyword">struct </span>group *defaultGroupEntry;
|
|
105
|
-
<a name="l00080"></a>00080 uid_t defaultUid;
|
|
106
|
-
<a name="l00081"></a>00081 gid_t defaultGid;
|
|
107
|
-
<a name="l00082"></a>00082
|
|
108
|
-
<a name="l00083"></a>00083 defaultUserEntry = getpwnam(defaultUser.c_str());
|
|
109
|
-
<a name="l00084"></a>00084 <span class="keywordflow">if</span> (defaultUserEntry == NULL) {
|
|
110
|
-
<a name="l00085"></a>00085 <span class="keywordflow">throw</span> NonExistentUserException(<span class="stringliteral">"Default user '"</span> + defaultUser +
|
|
111
|
-
<a name="l00086"></a>00086 <span class="stringliteral">"' does not exist."</span>);
|
|
112
|
-
<a name="l00087"></a>00087 }
|
|
113
|
-
<a name="l00088"></a>00088 defaultUid = defaultUserEntry->pw_uid;
|
|
114
|
-
<a name="l00089"></a>00089 defaultGroupEntry = getgrnam(defaultGroup.c_str());
|
|
115
|
-
<a name="l00090"></a>00090 <span class="keywordflow">if</span> (defaultGroupEntry == NULL) {
|
|
116
|
-
<a name="l00091"></a>00091 <span class="keywordflow">throw</span> NonExistentGroupException(<span class="stringliteral">"Default group '"</span> + defaultGroup +
|
|
117
|
-
<a name="l00092"></a>00092 <span class="stringliteral">"' does not exist."</span>);
|
|
118
|
-
<a name="l00093"></a>00093 }
|
|
119
|
-
<a name="l00094"></a>00094 defaultGid = defaultGroupEntry->gr_gid;
|
|
120
|
-
<a name="l00095"></a>00095
|
|
121
|
-
<a name="l00096"></a>00096 <span class="comment">/* We set a very tight permission here: no read or write access for</span>
|
|
122
|
-
<a name="l00097"></a>00097 <span class="comment"> * anybody except the owner. The individual files and subdirectories</span>
|
|
123
|
-
<a name="l00098"></a>00098 <span class="comment"> * decide for themselves whether they're readable by anybody.</span>
|
|
124
|
-
<a name="l00099"></a>00099 <span class="comment"> */</span>
|
|
125
|
-
<a name="l00100"></a>00100 <a class="code" href="namespacePassenger.html#a448f25263af0b37b91caee3d294ec4aa" title="Create the directory at the given path, creating intermediate directories if necessary...">makeDirTree</a>(path, <span class="stringliteral">"u=rwxs,g=x,o=x"</span>);
|
|
126
|
-
<a name="l00101"></a>00101
|
|
127
|
-
<a name="l00102"></a>00102 <span class="comment">/* Write structure version file. */</span>
|
|
128
|
-
<a name="l00103"></a>00103 <span class="keywordtype">string</span> structureVersionFile = path + <span class="stringliteral">"/structure_version.txt"</span>;
|
|
129
|
-
<a name="l00104"></a>00104 <a class="code" href="group__Support.html#ga6f414070373465da2e12947463f69953" title="Create the given file with the given contents, permissions and ownership.">createFile</a>(structureVersionFile,
|
|
130
|
-
<a name="l00105"></a>00105 toString(GENERATION_STRUCTURE_MAJOR_VERSION) + <span class="stringliteral">"."</span> +
|
|
131
|
-
<a name="l00106"></a>00106 toString(GENERATION_STRUCTURE_MINOR_VERSION),
|
|
132
|
-
<a name="l00107"></a>00107 S_IRUSR | S_IWUSR | S_IRGRP | S_IROTH);
|
|
133
|
-
<a name="l00108"></a>00108
|
|
134
|
-
<a name="l00109"></a>00109
|
|
135
|
-
<a name="l00110"></a>00110 <span class="comment">/* We want the upload buffer directory to be only writable by the web</span>
|
|
136
|
-
<a name="l00111"></a>00111 <span class="comment"> * server's worker processs. Other users may not have any access to this</span>
|
|
137
|
-
<a name="l00112"></a>00112 <span class="comment"> * directory.</span>
|
|
138
|
-
<a name="l00113"></a>00113 <span class="comment"> */</span>
|
|
139
|
-
<a name="l00114"></a>00114 <span class="keywordflow">if</span> (runningAsRoot) {
|
|
140
|
-
<a name="l00115"></a>00115 <a class="code" href="namespacePassenger.html#a448f25263af0b37b91caee3d294ec4aa" title="Create the directory at the given path, creating intermediate directories if necessary...">makeDirTree</a>(path + <span class="stringliteral">"/buffered_uploads"</span>, <span class="stringliteral">"u=rwxs,g=,o="</span>,
|
|
141
|
-
<a name="l00116"></a>00116 webServerWorkerUid, webServerWorkerGid);
|
|
142
|
-
<a name="l00117"></a>00117 } <span class="keywordflow">else</span> {
|
|
143
|
-
<a name="l00118"></a>00118 <a class="code" href="namespacePassenger.html#a448f25263af0b37b91caee3d294ec4aa" title="Create the directory at the given path, creating intermediate directories if necessary...">makeDirTree</a>(path + <span class="stringliteral">"/buffered_uploads"</span>, <span class="stringliteral">"u=rwxs,g=,o="</span>);
|
|
144
|
-
<a name="l00119"></a>00119 }
|
|
145
|
-
<a name="l00120"></a>00120
|
|
146
|
-
<a name="l00121"></a>00121 <span class="comment">/* The web server must be able to directly connect to a backend. */</span>
|
|
147
|
-
<a name="l00122"></a>00122 <span class="keywordflow">if</span> (runningAsRoot) {
|
|
148
|
-
<a name="l00123"></a>00123 <span class="keywordflow">if</span> (userSwitching) {
|
|
149
|
-
<a name="l00124"></a>00124 <span class="comment">/* Each backend process may be running as a different user,</span>
|
|
150
|
-
<a name="l00125"></a>00125 <span class="comment"> * so the backends subdirectory must be world-writable.</span>
|
|
151
|
-
<a name="l00126"></a>00126 <span class="comment"> * However we don't want everybody to be able to know the</span>
|
|
152
|
-
<a name="l00127"></a>00127 <span class="comment"> * sockets' filenames, so the directory is not readable.</span>
|
|
153
|
-
<a name="l00128"></a>00128 <span class="comment"> */</span>
|
|
154
|
-
<a name="l00129"></a>00129 <a class="code" href="namespacePassenger.html#a448f25263af0b37b91caee3d294ec4aa" title="Create the directory at the given path, creating intermediate directories if necessary...">makeDirTree</a>(path + <span class="stringliteral">"/backends"</span>, <span class="stringliteral">"u=rwxs,g=wx,o=wx"</span>);
|
|
155
|
-
<a name="l00130"></a>00130 } <span class="keywordflow">else</span> {
|
|
156
|
-
<a name="l00131"></a>00131 <span class="comment">/* All backend processes are running as defaultUser/defaultGroup,</span>
|
|
157
|
-
<a name="l00132"></a>00132 <span class="comment"> * so make defaultUser/defaultGroup the owner and group of the</span>
|
|
158
|
-
<a name="l00133"></a>00133 <span class="comment"> * subdirecory.</span>
|
|
159
|
-
<a name="l00134"></a>00134 <span class="comment"> *</span>
|
|
160
|
-
<a name="l00135"></a>00135 <span class="comment"> * The directory is not readable as a security precaution:</span>
|
|
161
|
-
<a name="l00136"></a>00136 <span class="comment"> * nobody should be able to know the sockets' filenames without</span>
|
|
162
|
-
<a name="l00137"></a>00137 <span class="comment"> * having access to the application pool.</span>
|
|
163
|
-
<a name="l00138"></a>00138 <span class="comment"> */</span>
|
|
164
|
-
<a name="l00139"></a>00139 <a class="code" href="namespacePassenger.html#a448f25263af0b37b91caee3d294ec4aa" title="Create the directory at the given path, creating intermediate directories if necessary...">makeDirTree</a>(path + <span class="stringliteral">"/backends"</span>, <span class="stringliteral">"u=rwxs,g=x,o=x"</span>, defaultUid, defaultGid);
|
|
165
|
-
<a name="l00140"></a>00140 }
|
|
166
|
-
<a name="l00141"></a>00141 } <span class="keywordflow">else</span> {
|
|
167
|
-
<a name="l00142"></a>00142 <span class="comment">/* All backend processes are running as the same user as the web server,</span>
|
|
168
|
-
<a name="l00143"></a>00143 <span class="comment"> * so only allow access for this user.</span>
|
|
169
|
-
<a name="l00144"></a>00144 <span class="comment"> */</span>
|
|
170
|
-
<a name="l00145"></a>00145 <a class="code" href="namespacePassenger.html#a448f25263af0b37b91caee3d294ec4aa" title="Create the directory at the given path, creating intermediate directories if necessary...">makeDirTree</a>(path + <span class="stringliteral">"/backends"</span>, <span class="stringliteral">"u=rwxs,g=,o="</span>);
|
|
171
|
-
<a name="l00146"></a>00146 }
|
|
172
|
-
<a name="l00147"></a>00147
|
|
173
|
-
<a name="l00148"></a>00148 <span class="comment">/* The helper server (containing the application pool) must be able to access</span>
|
|
174
|
-
<a name="l00149"></a>00149 <span class="comment"> * the spawn server's socket.</span>
|
|
175
|
-
<a name="l00150"></a>00150 <span class="comment"> */</span>
|
|
176
|
-
<a name="l00151"></a>00151 <span class="keywordflow">if</span> (runningAsRoot) {
|
|
177
|
-
<a name="l00152"></a>00152 <span class="keywordflow">if</span> (userSwitching) {
|
|
178
|
-
<a name="l00153"></a>00153 <span class="comment">/* Both the helper server and the spawn server are</span>
|
|
179
|
-
<a name="l00154"></a>00154 <span class="comment"> * running as root.</span>
|
|
180
|
-
<a name="l00155"></a>00155 <span class="comment"> */</span>
|
|
181
|
-
<a name="l00156"></a>00156 <a class="code" href="namespacePassenger.html#a448f25263af0b37b91caee3d294ec4aa" title="Create the directory at the given path, creating intermediate directories if necessary...">makeDirTree</a>(path + <span class="stringliteral">"/spawn-server"</span>, <span class="stringliteral">"u=rwxs,g=,o="</span>);
|
|
182
|
-
<a name="l00157"></a>00157 } <span class="keywordflow">else</span> {
|
|
183
|
-
<a name="l00158"></a>00158 <span class="comment">/* Both the helper server and the spawn server are</span>
|
|
184
|
-
<a name="l00159"></a>00159 <span class="comment"> * running as defaultUser/defaultGroup.</span>
|
|
185
|
-
<a name="l00160"></a>00160 <span class="comment"> */</span>
|
|
186
|
-
<a name="l00161"></a>00161 <a class="code" href="namespacePassenger.html#a448f25263af0b37b91caee3d294ec4aa" title="Create the directory at the given path, creating intermediate directories if necessary...">makeDirTree</a>(path + <span class="stringliteral">"/spawn-server"</span>, <span class="stringliteral">"u=rwxs,g=,o="</span>,
|
|
187
|
-
<a name="l00162"></a>00162 defaultUid, defaultGid);
|
|
188
|
-
<a name="l00163"></a>00163 }
|
|
189
|
-
<a name="l00164"></a>00164 } <span class="keywordflow">else</span> {
|
|
190
|
-
<a name="l00165"></a>00165 <a class="code" href="namespacePassenger.html#a448f25263af0b37b91caee3d294ec4aa" title="Create the directory at the given path, creating intermediate directories if necessary...">makeDirTree</a>(path + <span class="stringliteral">"/spawn-server"</span>, <span class="stringliteral">"u=rwxs,g=,o="</span>);
|
|
191
|
-
<a name="l00166"></a>00166 }
|
|
192
|
-
<a name="l00167"></a>00167
|
|
193
|
-
<a name="l00168"></a>00168 owner = <span class="keyword">true</span>;
|
|
194
|
-
<a name="l00169"></a>00169 }
|
|
195
|
-
<a name="l00170"></a>00170
|
|
196
|
-
<a name="l00171"></a>00171 <span class="keyword">public</span>:
|
|
197
|
-
<a name="l00172"></a>00172 ~Generation() {
|
|
198
|
-
<a name="l00173"></a>00173 <span class="keywordflow">if</span> (owner) {
|
|
199
|
-
<a name="l00174"></a>00174 <a class="code" href="namespacePassenger.html#a8422d210cbd2f62d21254415b5a7f747" title="Remove an entire directory tree recursively.">removeDirTree</a>(path);
|
|
200
|
-
<a name="l00175"></a>00175 }
|
|
201
|
-
<a name="l00176"></a>00176 }
|
|
202
|
-
<a name="l00177"></a>00177
|
|
203
|
-
<a name="l00178"></a>00178 <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> getNumber()<span class="keyword"> const </span>{
|
|
204
|
-
<a name="l00179"></a>00179 <span class="keywordflow">return</span> number;
|
|
205
|
-
<a name="l00180"></a>00180 }
|
|
206
|
-
<a name="l00181"></a>00181
|
|
207
|
-
<a name="l00182"></a>00182 <span class="keywordtype">string</span> getPath()<span class="keyword"> const </span>{
|
|
208
|
-
<a name="l00183"></a>00183 <span class="keywordflow">return</span> path;
|
|
209
|
-
<a name="l00184"></a>00184 }
|
|
210
|
-
<a name="l00185"></a>00185
|
|
211
|
-
<a name="l00186"></a>00186 <span class="keywordtype">void</span> detach() {
|
|
212
|
-
<a name="l00187"></a>00187 owner = <span class="keyword">false</span>;
|
|
213
|
-
<a name="l00188"></a>00188 }
|
|
214
|
-
<a name="l00189"></a>00189 };
|
|
215
|
-
<a name="l00190"></a>00190
|
|
216
|
-
<a name="l00191"></a>00191 <span class="keyword">typedef</span> shared_ptr<Generation> GenerationPtr;
|
|
217
|
-
<a name="l00192"></a>00192
|
|
218
|
-
<a name="l00193"></a>00193 <span class="keyword">private</span>:
|
|
219
|
-
<a name="l00194"></a>00194 <span class="keywordtype">string</span> path;
|
|
220
|
-
<a name="l00195"></a>00195 <span class="keywordtype">bool</span> owner;
|
|
221
|
-
<a name="l00196"></a>00196
|
|
222
|
-
<a name="l00197"></a>00197 <span class="keyword">friend</span> <span class="keyword">class </span>Generation;
|
|
223
|
-
<a name="l00198"></a>00198
|
|
224
|
-
<a name="l00199"></a>00199 <span class="keywordtype">void</span> initialize(<span class="keyword">const</span> <span class="keywordtype">string</span> &path, <span class="keywordtype">bool</span> owner) {
|
|
225
|
-
<a name="l00200"></a>00200 TRACE_POINT();
|
|
226
|
-
<a name="l00201"></a>00201 this->path = path;
|
|
227
|
-
<a name="l00202"></a>00202 this->owner = owner;
|
|
228
|
-
<a name="l00203"></a>00203
|
|
229
|
-
<a name="l00204"></a>00204 <span class="comment">/* Create the server instance directory. We only need to write to this</span>
|
|
230
|
-
<a name="l00205"></a>00205 <span class="comment"> * directory for these reasons:</span>
|
|
231
|
-
<a name="l00206"></a>00206 <span class="comment"> * 1. Initial population of structure files (structure_version.txt, instance.pid).</span>
|
|
232
|
-
<a name="l00207"></a>00207 <span class="comment"> * 2. Creating/removing a generation directory.</span>
|
|
233
|
-
<a name="l00208"></a>00208 <span class="comment"> * 3. Removing the entire server instance directory (after all</span>
|
|
234
|
-
<a name="l00209"></a>00209 <span class="comment"> * generations are removed).</span>
|
|
235
|
-
<a name="l00210"></a>00210 <span class="comment"> *</span>
|
|
236
|
-
<a name="l00211"></a>00211 <span class="comment"> * 1 and 2 are done by the helper server during initialization and before lowering</span>
|
|
237
|
-
<a name="l00212"></a>00212 <span class="comment"> * privilege. 3 is done during helper server shutdown by a cleanup process that's</span>
|
|
238
|
-
<a name="l00213"></a>00213 <span class="comment"> * running as the same user the helper server was running as before privilege</span>
|
|
239
|
-
<a name="l00214"></a>00214 <span class="comment"> * lowering.</span>
|
|
240
|
-
<a name="l00215"></a>00215 <span class="comment"> * Therefore, we make the directory only writable by the user the helper server</span>
|
|
241
|
-
<a name="l00216"></a>00216 <span class="comment"> * was running as before privilege is lowered. Everybody else has read and execute</span>
|
|
242
|
-
<a name="l00217"></a>00217 <span class="comment"> * rights though, because we want admin tools to be able to list the available</span>
|
|
243
|
-
<a name="l00218"></a>00218 <span class="comment"> * generations no matter what user they're running as.</span>
|
|
244
|
-
<a name="l00219"></a>00219 <span class="comment"> */</span>
|
|
245
|
-
<a name="l00220"></a>00220 <a class="code" href="namespacePassenger.html#a448f25263af0b37b91caee3d294ec4aa" title="Create the directory at the given path, creating intermediate directories if necessary...">makeDirTree</a>(path, <span class="stringliteral">"u=rwxs,g=rx,o=rx"</span>);
|
|
246
|
-
<a name="l00221"></a>00221 }
|
|
247
|
-
<a name="l00222"></a>00222
|
|
248
|
-
<a name="l00223"></a>00223 <span class="keywordtype">bool</span> isDirectory(<span class="keyword">const</span> <span class="keywordtype">string</span> &dir, <span class="keyword">struct</span> dirent *entry)<span class="keyword"> const </span>{
|
|
249
|
-
<a name="l00224"></a>00224 <span class="preprocessor"> #ifdef DT_DIR</span>
|
|
250
|
-
<a name="l00225"></a>00225 <span class="preprocessor"></span> <span class="keywordflow">if</span> (entry->d_type == DT_DIR) {
|
|
251
|
-
<a name="l00226"></a>00226 <span class="keywordflow">return</span> <span class="keyword">true</span>;
|
|
252
|
-
<a name="l00227"></a>00227 } <span class="keywordflow">else</span> <span class="keywordflow">if</span> (entry->d_type != DT_UNKNOWN) {
|
|
253
|
-
<a name="l00228"></a>00228 <span class="keywordflow">return</span> <span class="keyword">false</span>;
|
|
254
|
-
<a name="l00229"></a>00229 }
|
|
255
|
-
<a name="l00230"></a>00230 <span class="comment">// If DT_UNKNOWN, use normal check.</span>
|
|
256
|
-
<a name="l00231"></a>00231 <span class="preprocessor"> #endif</span>
|
|
257
|
-
<a name="l00232"></a>00232 <span class="preprocessor"></span> <span class="keywordtype">string</span> path = dir;
|
|
258
|
-
<a name="l00233"></a>00233 path.append(<span class="stringliteral">"/"</span>);
|
|
259
|
-
<a name="l00234"></a>00234 path.append(entry->d_name);
|
|
260
|
-
<a name="l00235"></a>00235 <span class="keywordflow">return</span> <a class="code" href="group__Support.html#ga15298b031377d3ecb80295bd5b1a8180" title="Check whether &#39;filename&#39; exists and what kind of file it is.">getFileType</a>(path) == <a class="code" href="namespacePassenger.html#a14174b712df6046cb823cde43d7ef07dabb09dbba1071b4770913363db2462eee" title="A directory.">FT_DIRECTORY</a>;
|
|
261
|
-
<a name="l00236"></a>00236 }
|
|
262
|
-
<a name="l00237"></a>00237
|
|
263
|
-
<a name="l00238"></a>00238 <span class="keyword">public</span>:
|
|
264
|
-
<a name="l00239"></a>00239 ServerInstanceDir(pid_t webServerPid, <span class="keyword">const</span> <span class="keywordtype">string</span> &parentDir = <span class="stringliteral">""</span>, <span class="keywordtype">bool</span> owner = <span class="keyword">true</span>) {
|
|
265
|
-
<a name="l00240"></a>00240 <span class="keywordtype">string</span> theParentDir;
|
|
266
|
-
<a name="l00241"></a>00241
|
|
267
|
-
<a name="l00242"></a>00242 <span class="keywordflow">if</span> (parentDir.empty()) {
|
|
268
|
-
<a name="l00243"></a>00243 theParentDir = <a class="code" href="group__Support.html#ga68f4105c5a8e510520b5ea3eecb66213" title="Return the path name for the directory in which the system stores general temporary...">getSystemTempDir</a>();
|
|
269
|
-
<a name="l00244"></a>00244 } <span class="keywordflow">else</span> {
|
|
270
|
-
<a name="l00245"></a>00245 theParentDir = parentDir;
|
|
271
|
-
<a name="l00246"></a>00246 }
|
|
272
|
-
<a name="l00247"></a>00247
|
|
273
|
-
<a name="l00248"></a>00248 <span class="comment">/* We embed the super structure version in the server instance directory name</span>
|
|
274
|
-
<a name="l00249"></a>00249 <span class="comment"> * because it's possible to upgrade Phusion Passenger without changing the</span>
|
|
275
|
-
<a name="l00250"></a>00250 <span class="comment"> * web server's PID. This way each incompatible upgrade will use its own</span>
|
|
276
|
-
<a name="l00251"></a>00251 <span class="comment"> * server instance directory.</span>
|
|
277
|
-
<a name="l00252"></a>00252 <span class="comment"> */</span>
|
|
278
|
-
<a name="l00253"></a>00253 initialize(theParentDir + <span class="stringliteral">"/passenger."</span> +
|
|
279
|
-
<a name="l00254"></a>00254 toString(DIR_STRUCTURE_MAJOR_VERSION) + <span class="stringliteral">"."</span> +
|
|
280
|
-
<a name="l00255"></a>00255 toString(DIR_STRUCTURE_MINOR_VERSION) + <span class="stringliteral">"."</span> +
|
|
281
|
-
<a name="l00256"></a>00256 toString<unsigned long long>(webServerPid),
|
|
282
|
-
<a name="l00257"></a>00257 owner);
|
|
283
|
-
<a name="l00258"></a>00258
|
|
284
|
-
<a name="l00259"></a>00259 }
|
|
285
|
-
<a name="l00260"></a>00260
|
|
286
|
-
<a name="l00261"></a>00261 ServerInstanceDir(<span class="keyword">const</span> <span class="keywordtype">string</span> &path, <span class="keywordtype">bool</span> owner = <span class="keyword">true</span>) {
|
|
287
|
-
<a name="l00262"></a>00262 initialize(path, owner);
|
|
288
|
-
<a name="l00263"></a>00263 }
|
|
289
|
-
<a name="l00264"></a>00264
|
|
290
|
-
<a name="l00265"></a>00265 ~ServerInstanceDir() {
|
|
291
|
-
<a name="l00266"></a>00266 <span class="keywordflow">if</span> (owner) {
|
|
292
|
-
<a name="l00267"></a>00267 GenerationPtr newestGeneration;
|
|
293
|
-
<a name="l00268"></a>00268 <span class="keywordflow">try</span> {
|
|
294
|
-
<a name="l00269"></a>00269 newestGeneration = getNewestGeneration();
|
|
295
|
-
<a name="l00270"></a>00270 } <span class="keywordflow">catch</span> (<span class="keyword">const</span> FileSystemException &e) {
|
|
296
|
-
<a name="l00271"></a>00271 <span class="keywordflow">if</span> (e.code() == ENOENT) {
|
|
297
|
-
<a name="l00272"></a>00272 <span class="keywordflow">return</span>;
|
|
298
|
-
<a name="l00273"></a>00273 } <span class="keywordflow">else</span> {
|
|
299
|
-
<a name="l00274"></a>00274 <span class="keywordflow">throw</span>;
|
|
300
|
-
<a name="l00275"></a>00275 }
|
|
301
|
-
<a name="l00276"></a>00276 }
|
|
302
|
-
<a name="l00277"></a>00277 <span class="keywordflow">if</span> (newestGeneration == NULL) {
|
|
303
|
-
<a name="l00278"></a>00278 <a class="code" href="namespacePassenger.html#a8422d210cbd2f62d21254415b5a7f747" title="Remove an entire directory tree recursively.">removeDirTree</a>(path);
|
|
304
|
-
<a name="l00279"></a>00279 }
|
|
305
|
-
<a name="l00280"></a>00280 }
|
|
306
|
-
<a name="l00281"></a>00281 }
|
|
307
|
-
<a name="l00282"></a>00282
|
|
308
|
-
<a name="l00283"></a>00283 <span class="keywordtype">string</span> getPath()<span class="keyword"> const </span>{
|
|
309
|
-
<a name="l00284"></a>00284 <span class="keywordflow">return</span> path;
|
|
310
|
-
<a name="l00285"></a>00285 }
|
|
311
|
-
<a name="l00286"></a>00286
|
|
312
|
-
<a name="l00287"></a>00287 <span class="keywordtype">void</span> detach() {
|
|
313
|
-
<a name="l00288"></a>00288 owner = <span class="keyword">false</span>;
|
|
314
|
-
<a name="l00289"></a>00289 }
|
|
315
|
-
<a name="l00290"></a>00290
|
|
316
|
-
<a name="l00291"></a>00291 GenerationPtr newGeneration(<span class="keywordtype">bool</span> userSwitching, <span class="keyword">const</span> <span class="keywordtype">string</span> &defaultUser,
|
|
317
|
-
<a name="l00292"></a>00292 <span class="keyword">const</span> <span class="keywordtype">string</span> &defaultGroup, uid_t webServerWorkerUid,
|
|
318
|
-
<a name="l00293"></a>00293 gid_t webServerWorkerGid)
|
|
319
|
-
<a name="l00294"></a>00294 {
|
|
320
|
-
<a name="l00295"></a>00295 GenerationPtr newestGeneration = getNewestGeneration();
|
|
321
|
-
<a name="l00296"></a>00296 <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> newNumber;
|
|
322
|
-
<a name="l00297"></a>00297 <span class="keywordflow">if</span> (newestGeneration != NULL) {
|
|
323
|
-
<a name="l00298"></a>00298 newNumber = newestGeneration->getNumber() + 1;
|
|
324
|
-
<a name="l00299"></a>00299 } <span class="keywordflow">else</span> {
|
|
325
|
-
<a name="l00300"></a>00300 newNumber = 0;
|
|
326
|
-
<a name="l00301"></a>00301 }
|
|
327
|
-
<a name="l00302"></a>00302
|
|
328
|
-
<a name="l00303"></a>00303 GenerationPtr generation(<span class="keyword">new</span> Generation(path, newNumber));
|
|
329
|
-
<a name="l00304"></a>00304 generation->create(userSwitching, defaultUser, defaultGroup,
|
|
330
|
-
<a name="l00305"></a>00305 webServerWorkerUid, webServerWorkerGid);
|
|
331
|
-
<a name="l00306"></a>00306 <span class="keywordflow">return</span> generation;
|
|
332
|
-
<a name="l00307"></a>00307 }
|
|
333
|
-
<a name="l00308"></a>00308
|
|
334
|
-
<a name="l00309"></a>00309 GenerationPtr getGeneration(<span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> number)<span class="keyword"> const </span>{
|
|
335
|
-
<a name="l00310"></a>00310 <span class="keywordflow">return</span> <a class="code" href="group__Support.html#ga41b6c4a82fed72531a147de0505a8396" title="Convenience shortcut for creating a shared_ptr.">ptr</a>(<span class="keyword">new</span> Generation(path, number));
|
|
336
|
-
<a name="l00311"></a>00311 }
|
|
337
|
-
<a name="l00312"></a>00312
|
|
338
|
-
<a name="l00313"></a>00313 GenerationPtr getNewestGeneration()<span class="keyword"> const </span>{
|
|
339
|
-
<a name="l00314"></a>00314 DIR *dir = opendir(path.c_str());
|
|
340
|
-
<a name="l00315"></a>00315 <span class="keyword">struct </span>dirent *entry;
|
|
341
|
-
<a name="l00316"></a>00316 <span class="keywordtype">int</span> result = -1;
|
|
342
|
-
<a name="l00317"></a>00317
|
|
343
|
-
<a name="l00318"></a>00318 <span class="keywordflow">if</span> (dir == NULL) {
|
|
344
|
-
<a name="l00319"></a>00319 <span class="keywordtype">int</span> e = errno;
|
|
345
|
-
<a name="l00320"></a>00320 <span class="keywordflow">throw</span> FileSystemException(<span class="stringliteral">"Cannot open directory "</span> + path,
|
|
346
|
-
<a name="l00321"></a>00321 e, path);
|
|
347
|
-
<a name="l00322"></a>00322 }
|
|
348
|
-
<a name="l00323"></a>00323 <span class="keywordflow">while</span> ((entry = readdir(dir)) != NULL) {
|
|
349
|
-
<a name="l00324"></a>00324 <span class="keywordflow">if</span> (isDirectory(path, entry)
|
|
350
|
-
<a name="l00325"></a>00325 && strncmp(entry->d_name, <span class="stringliteral">"generation-"</span>, <span class="keyword">sizeof</span>(<span class="stringliteral">"generation-"</span>) - 1) == 0) {
|
|
351
|
-
<a name="l00326"></a>00326 <span class="keyword">const</span> <span class="keywordtype">char</span> *numberString = entry->d_name + <span class="keyword">sizeof</span>(<span class="stringliteral">"generation-"</span>) - 1;
|
|
352
|
-
<a name="l00327"></a>00327 <span class="keywordtype">int</span> number = atoi(numberString);
|
|
353
|
-
<a name="l00328"></a>00328 <span class="keywordflow">if</span> (number >= 0 && number > result) {
|
|
354
|
-
<a name="l00329"></a>00329 result = number;
|
|
355
|
-
<a name="l00330"></a>00330 }
|
|
356
|
-
<a name="l00331"></a>00331 }
|
|
357
|
-
<a name="l00332"></a>00332 }
|
|
358
|
-
<a name="l00333"></a>00333 closedir(dir);
|
|
359
|
-
<a name="l00334"></a>00334
|
|
360
|
-
<a name="l00335"></a>00335 <span class="keywordflow">if</span> (result == -1) {
|
|
361
|
-
<a name="l00336"></a>00336 <span class="keywordflow">return</span> GenerationPtr();
|
|
362
|
-
<a name="l00337"></a>00337 } <span class="keywordflow">else</span> {
|
|
363
|
-
<a name="l00338"></a>00338 <span class="keywordflow">return</span> getGeneration(result);
|
|
364
|
-
<a name="l00339"></a>00339 }
|
|
365
|
-
<a name="l00340"></a>00340 }
|
|
366
|
-
<a name="l00341"></a>00341 };
|
|
367
|
-
<a name="l00342"></a>00342
|
|
368
|
-
<a name="l00343"></a>00343 <span class="keyword">typedef</span> shared_ptr<ServerInstanceDir> ServerInstanceDirPtr;
|
|
369
|
-
<a name="l00344"></a>00344
|
|
370
|
-
<a name="l00345"></a>00345 } <span class="comment">// namespace Passenger</span>
|
|
371
|
-
<a name="l00346"></a>00346
|
|
372
|
-
<a name="l00347"></a>00347 <span class="preprocessor">#endif </span><span class="comment">/* _PASSENGER_SERVER_INSTANCE_DIR_H_ */</span>
|
|
373
|
-
</pre></div></div>
|
|
374
|
-
<hr size="1"/><address style="text-align: right;"><small>Generated by
|
|
375
|
-
<a href="http://www.doxygen.org/index.html">
|
|
376
|
-
<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.6.2 </small></address>
|
|
377
|
-
</body>
|
|
378
|
-
</html>
|
|
@@ -1,501 +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: Session.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>Session.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_SESSION_H_</span>
|
|
51
|
-
<a name="l00026"></a>00026 <span class="preprocessor"></span><span class="preprocessor">#define _PASSENGER_SESSION_H_</span>
|
|
52
|
-
<a name="l00027"></a>00027 <span class="preprocessor"></span>
|
|
53
|
-
<a name="l00028"></a>00028 <span class="preprocessor">#include <sys/types.h></span>
|
|
54
|
-
<a name="l00029"></a>00029 <span class="preprocessor">#include <sys/socket.h></span>
|
|
55
|
-
<a name="l00030"></a>00030 <span class="preprocessor">#include <sys/un.h></span>
|
|
56
|
-
<a name="l00031"></a>00031 <span class="preprocessor">#include <unistd.h></span>
|
|
57
|
-
<a name="l00032"></a>00032 <span class="preprocessor">#include <netdb.h></span>
|
|
58
|
-
<a name="l00033"></a>00033 <span class="preprocessor">#include <cerrno></span>
|
|
59
|
-
<a name="l00034"></a>00034 <span class="preprocessor">#include <cstring></span>
|
|
60
|
-
<a name="l00035"></a>00035
|
|
61
|
-
<a name="l00036"></a>00036 <span class="preprocessor">#include <string></span>
|
|
62
|
-
<a name="l00037"></a>00037 <span class="preprocessor">#include <vector></span>
|
|
63
|
-
<a name="l00038"></a>00038
|
|
64
|
-
<a name="l00039"></a>00039 <span class="preprocessor">#include <boost/shared_ptr.hpp></span>
|
|
65
|
-
<a name="l00040"></a>00040 <span class="preprocessor">#include <boost/function.hpp></span>
|
|
66
|
-
<a name="l00041"></a>00041 <span class="preprocessor">#include <oxt/backtrace.hpp></span>
|
|
67
|
-
<a name="l00042"></a>00042 <span class="preprocessor">#include <oxt/system_calls.hpp></span>
|
|
68
|
-
<a name="l00043"></a>00043
|
|
69
|
-
<a name="l00044"></a>00044 <span class="preprocessor">#include "MessageChannel.h"</span>
|
|
70
|
-
<a name="l00045"></a>00045 <span class="preprocessor">#include "StaticString.h"</span>
|
|
71
|
-
<a name="l00046"></a>00046 <span class="preprocessor">#include "Exceptions.h"</span>
|
|
72
|
-
<a name="l00047"></a>00047 <span class="preprocessor">#include "Utils/StrIntUtils.h"</span>
|
|
73
|
-
<a name="l00048"></a>00048 <span class="preprocessor">#include "Utils/IOUtils.h"</span>
|
|
74
|
-
<a name="l00049"></a>00049
|
|
75
|
-
<a name="l00050"></a>00050 <span class="keyword">namespace </span>Passenger {
|
|
76
|
-
<a name="l00051"></a>00051
|
|
77
|
-
<a name="l00052"></a>00052 <span class="keyword">using namespace </span>boost;
|
|
78
|
-
<a name="l00053"></a>00053 <span class="keyword">using namespace </span>oxt;
|
|
79
|
-
<a name="l00054"></a>00054 <span class="keyword">using namespace </span>std;
|
|
80
|
-
<a name="l00055"></a>00055
|
|
81
|
-
<a name="l00056"></a>00056 <span class="comment"></span>
|
|
82
|
-
<a name="l00057"></a>00057 <span class="comment">/**</span>
|
|
83
|
-
<a name="l00058"></a>00058 <span class="comment"> * Represents a single request/response pair of an application process.</span>
|
|
84
|
-
<a name="l00059"></a>00059 <span class="comment"> *</span>
|
|
85
|
-
<a name="l00060"></a>00060 <span class="comment"> * Session is used to forward a single HTTP request to an application</span>
|
|
86
|
-
<a name="l00061"></a>00061 <span class="comment"> * process, and to read back the HTTP response. A Session object is to</span>
|
|
87
|
-
<a name="l00062"></a>00062 <span class="comment"> * be used in the following manner:</span>
|
|
88
|
-
<a name="l00063"></a>00063 <span class="comment"> *</span>
|
|
89
|
-
<a name="l00064"></a>00064 <span class="comment"> * -# Serialize the HTTP request headers into a format as expected by</span>
|
|
90
|
-
<a name="l00065"></a>00065 <span class="comment"> * sendHeaders(), then send that string by calling sendHeaders().</span>
|
|
91
|
-
<a name="l00066"></a>00066 <span class="comment"> * -# In case of a POST of PUT request, send the HTTP request body by</span>
|
|
92
|
-
<a name="l00067"></a>00067 <span class="comment"> * calling sendBodyBlock(), possibly multiple times.</span>
|
|
93
|
-
<a name="l00068"></a>00068 <span class="comment"> * -# Shutdown the writer end of the session channel (shutdownWriter())</span>
|
|
94
|
-
<a name="l00069"></a>00069 <span class="comment"> * since you're now done sending data.</span>
|
|
95
|
-
<a name="l00070"></a>00070 <span class="comment"> * -# The HTTP response can now be read through the session channel (getStream()).</span>
|
|
96
|
-
<a name="l00071"></a>00071 <span class="comment"> * -# When the HTTP response has been read, the session must be closed.</span>
|
|
97
|
-
<a name="l00072"></a>00072 <span class="comment"> * This is done by destroying the Session object.</span>
|
|
98
|
-
<a name="l00073"></a>00073 <span class="comment"> *</span>
|
|
99
|
-
<a name="l00074"></a>00074 <span class="comment"> * A usage example is shown in Process::newSession().</span>
|
|
100
|
-
<a name="l00075"></a>00075 <span class="comment"> *</span>
|
|
101
|
-
<a name="l00076"></a>00076 <span class="comment"> * Session is an abstract base class. Concrete implementations can be found in</span>
|
|
102
|
-
<a name="l00077"></a>00077 <span class="comment"> * StandardSession and ApplicationPool::Client::RemoteSession.</span>
|
|
103
|
-
<a name="l00078"></a>00078 <span class="comment"> *</span>
|
|
104
|
-
<a name="l00079"></a>00079 <span class="comment"> * Session is not guaranteed to be thread-safe.</span>
|
|
105
|
-
<a name="l00080"></a>00080 <span class="comment"> */</span>
|
|
106
|
-
<a name="l00081"></a><a class="code" href="classPassenger_1_1Session.html">00081</a> <span class="keyword">class </span><a class="code" href="classPassenger_1_1Session.html" title="Represents a single request/response pair of an application process.">Session</a> {
|
|
107
|
-
<a name="l00082"></a>00082 <span class="keyword">protected</span>:
|
|
108
|
-
<a name="l00083"></a>00083 <span class="keywordtype">string</span> detachKey;
|
|
109
|
-
<a name="l00084"></a>00084 <span class="keywordtype">string</span> connectPassword;
|
|
110
|
-
<a name="l00085"></a>00085 <span class="keywordtype">string</span> gupid;
|
|
111
|
-
<a name="l00086"></a>00086
|
|
112
|
-
<a name="l00087"></a>00087 <span class="keyword">public</span>:<span class="comment"></span>
|
|
113
|
-
<a name="l00088"></a>00088 <span class="comment"> /**</span>
|
|
114
|
-
<a name="l00089"></a>00089 <span class="comment"> * Concrete classes might throw arbitrary exceptions.</span>
|
|
115
|
-
<a name="l00090"></a>00090 <span class="comment"> */</span>
|
|
116
|
-
<a name="l00091"></a><a class="code" href="classPassenger_1_1Session.html#ac982015e84f64dbec70daef8fdbd31d9">00091</a> <span class="keyword">virtual</span> <a class="code" href="classPassenger_1_1Session.html#ac982015e84f64dbec70daef8fdbd31d9" title="Concrete classes might throw arbitrary exceptions.">~Session</a>() {}
|
|
117
|
-
<a name="l00092"></a>00092 <span class="comment"></span>
|
|
118
|
-
<a name="l00093"></a>00093 <span class="comment"> /**</span>
|
|
119
|
-
<a name="l00094"></a>00094 <span class="comment"> * Initiate the session by connecting to the associated process.</span>
|
|
120
|
-
<a name="l00095"></a>00095 <span class="comment"> * A Session is not usable until it's initiated.</span>
|
|
121
|
-
<a name="l00096"></a>00096 <span class="comment"> *</span>
|
|
122
|
-
<a name="l00097"></a>00097 <span class="comment"> * @throws SystemException Something went wrong.</span>
|
|
123
|
-
<a name="l00098"></a>00098 <span class="comment"> * @throws IOException Something went wrong.</span>
|
|
124
|
-
<a name="l00099"></a>00099 <span class="comment"> * @throws boost::thread_interrupted</span>
|
|
125
|
-
<a name="l00100"></a>00100 <span class="comment"> */</span>
|
|
126
|
-
<a name="l00101"></a>00101 <span class="keyword">virtual</span> <span class="keywordtype">void</span> <a class="code" href="classPassenger_1_1Session.html#abbcfa3eb48d38dead20c0d32cab4850b" title="Initiate the session by connecting to the associated process.">initiate</a>() = 0;
|
|
127
|
-
<a name="l00102"></a>00102 <span class="comment"></span>
|
|
128
|
-
<a name="l00103"></a>00103 <span class="comment"> /**</span>
|
|
129
|
-
<a name="l00104"></a>00104 <span class="comment"> * Returns whether this session has been initiated (that is, whether</span>
|
|
130
|
-
<a name="l00105"></a>00105 <span class="comment"> * initiate() had been called in the past).</span>
|
|
131
|
-
<a name="l00106"></a>00106 <span class="comment"> */</span>
|
|
132
|
-
<a name="l00107"></a>00107 <span class="keyword">virtual</span> <span class="keywordtype">bool</span> <a class="code" href="classPassenger_1_1Session.html#abf1b6ba182a0fc66c8e617f74afafb92" title="Returns whether this session has been initiated (that is, whether initiate() had...">initiated</a>() <span class="keyword">const</span> = 0;
|
|
133
|
-
<a name="l00108"></a>00108 <span class="comment"></span>
|
|
134
|
-
<a name="l00109"></a>00109 <span class="comment"> /**</span>
|
|
135
|
-
<a name="l00110"></a>00110 <span class="comment"> * Returns the type of the socket that this session is served from,</span>
|
|
136
|
-
<a name="l00111"></a>00111 <span class="comment"> * e.g. "unix" indicating a Unix socket.</span>
|
|
137
|
-
<a name="l00112"></a>00112 <span class="comment"> *</span>
|
|
138
|
-
<a name="l00113"></a>00113 <span class="comment"> * @post !result.empty()</span>
|
|
139
|
-
<a name="l00114"></a>00114 <span class="comment"> */</span>
|
|
140
|
-
<a name="l00115"></a>00115 <span class="keyword">virtual</span> <span class="keywordtype">string</span> <a class="code" href="classPassenger_1_1Session.html#ab8f084ab143d44f1a9ef8e8ccc841485" title="Returns the type of the socket that this session is served from, e.g.">getSocketType</a>() <span class="keyword">const</span> = 0;
|
|
141
|
-
<a name="l00116"></a>00116 <span class="comment"></span>
|
|
142
|
-
<a name="l00117"></a>00117 <span class="comment"> /**</span>
|
|
143
|
-
<a name="l00118"></a>00118 <span class="comment"> * Returns the address of the socket that this session is served</span>
|
|
144
|
-
<a name="l00119"></a>00119 <span class="comment"> * from. This can be a Unix socket filename or a TCP host:port string</span>
|
|
145
|
-
<a name="l00120"></a>00120 <span class="comment"> * like "127.0.0.1:1234".</span>
|
|
146
|
-
<a name="l00121"></a>00121 <span class="comment"> *</span>
|
|
147
|
-
<a name="l00122"></a>00122 <span class="comment"> * @post !result.empty()</span>
|
|
148
|
-
<a name="l00123"></a>00123 <span class="comment"> */</span>
|
|
149
|
-
<a name="l00124"></a>00124 <span class="keyword">virtual</span> <span class="keywordtype">string</span> <a class="code" href="classPassenger_1_1Session.html#a7b8a632ebde11544a8ab98fde89954bb" title="Returns the address of the socket that this session is served from.">getSocketName</a>() <span class="keyword">const</span> = 0;
|
|
150
|
-
<a name="l00125"></a>00125 <span class="comment"></span>
|
|
151
|
-
<a name="l00126"></a>00126 <span class="comment"> /**</span>
|
|
152
|
-
<a name="l00127"></a>00127 <span class="comment"> * Send HTTP request headers to the application. The HTTP headers must be</span>
|
|
153
|
-
<a name="l00128"></a>00128 <span class="comment"> * converted into CGI headers, and then encoded into a string that matches this grammar:</span>
|
|
154
|
-
<a name="l00129"></a>00129 <span class="comment"> *</span>
|
|
155
|
-
<a name="l00130"></a>00130 <span class="comment"> @verbatim</span>
|
|
156
|
-
<a name="l00131"></a>00131 <span class="comment"> headers ::= header*</span>
|
|
157
|
-
<a name="l00132"></a>00132 <span class="comment"> header ::= name NUL value NUL</span>
|
|
158
|
-
<a name="l00133"></a>00133 <span class="comment"> name ::= notnull+</span>
|
|
159
|
-
<a name="l00134"></a>00134 <span class="comment"> value ::= notnull+</span>
|
|
160
|
-
<a name="l00135"></a>00135 <span class="comment"> notnull ::= "\x01" | "\x02" | "\x02" | ... | "\xFF"</span>
|
|
161
|
-
<a name="l00136"></a>00136 <span class="comment"> NUL = "\x00"</span>
|
|
162
|
-
<a name="l00137"></a>00137 <span class="comment"> @endverbatim</span>
|
|
163
|
-
<a name="l00138"></a>00138 <span class="comment"> *</span>
|
|
164
|
-
<a name="l00139"></a>00139 <span class="comment"> * There must be a header with the name "PASSWORD_CONNECT_PASSWORD", and it must</span>
|
|
165
|
-
<a name="l00140"></a>00140 <span class="comment"> * have the same value as the string returned by getConnectPassword().</span>
|
|
166
|
-
<a name="l00141"></a>00141 <span class="comment"> *</span>
|
|
167
|
-
<a name="l00142"></a>00142 <span class="comment"> * This method should be the first one to be called during the lifetime of a Session</span>
|
|
168
|
-
<a name="l00143"></a>00143 <span class="comment"> * object, otherwise strange things may happen.</span>
|
|
169
|
-
<a name="l00144"></a>00144 <span class="comment"> *</span>
|
|
170
|
-
<a name="l00145"></a>00145 <span class="comment"> * @param headers The HTTP request headers, converted into CGI headers and encoded as</span>
|
|
171
|
-
<a name="l00146"></a>00146 <span class="comment"> * a string, according to the description.</span>
|
|
172
|
-
<a name="l00147"></a>00147 <span class="comment"> * @param size The size, in bytes, of <tt>headers</tt>.</span>
|
|
173
|
-
<a name="l00148"></a>00148 <span class="comment"> * @pre headers != NULL</span>
|
|
174
|
-
<a name="l00149"></a>00149 <span class="comment"> * @pre initiated()</span>
|
|
175
|
-
<a name="l00150"></a>00150 <span class="comment"> * @throws IOException The I/O channel has already been closed or discarded.</span>
|
|
176
|
-
<a name="l00151"></a>00151 <span class="comment"> * @throws SystemException Something went wrong during writing.</span>
|
|
177
|
-
<a name="l00152"></a>00152 <span class="comment"> * @throws boost::thread_interrupted</span>
|
|
178
|
-
<a name="l00153"></a>00153 <span class="comment"> */</span>
|
|
179
|
-
<a name="l00154"></a><a class="code" href="classPassenger_1_1Session.html#a8f8a39f78dd2672b00f1ff01e4d6d671">00154</a> <span class="keyword">virtual</span> <span class="keywordtype">void</span> <a class="code" href="classPassenger_1_1Session.html#a8f8a39f78dd2672b00f1ff01e4d6d671" title="Send HTTP request headers to the application.">sendHeaders</a>(<span class="keyword">const</span> <span class="keywordtype">char</span> *headers, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> size) {
|
|
180
|
-
<a name="l00155"></a>00155 TRACE_POINT();
|
|
181
|
-
<a name="l00156"></a>00156 <span class="keywordtype">int</span> stream = <a class="code" href="classPassenger_1_1Session.html#a949c7a46f4bb0c628730ded2041d2489" title="Returns this session&#39;s channel&#39;s file descriptor.">getStream</a>();
|
|
182
|
-
<a name="l00157"></a>00157 <span class="keywordflow">if</span> (stream == -1) {
|
|
183
|
-
<a name="l00158"></a>00158 <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 write headers to the request handler "</span>
|
|
184
|
-
<a name="l00159"></a>00159 <span class="stringliteral">"because the I/O stream has already been closed or discarded."</span>);
|
|
185
|
-
<a name="l00160"></a>00160 }
|
|
186
|
-
<a name="l00161"></a>00161 <span class="keywordflow">try</span> {
|
|
187
|
-
<a name="l00162"></a>00162 <a class="code" href="classPassenger_1_1MessageChannel.html" title="Convenience class for I/O operations on file descriptors.">MessageChannel</a>(stream).writeScalar(headers, size);
|
|
188
|
-
<a name="l00163"></a>00163 } <span class="keywordflow">catch</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> &e) {
|
|
189
|
-
<a name="l00164"></a>00164 e.setBriefMessage(<span class="stringliteral">"An error occured while writing headers "</span>
|
|
190
|
-
<a name="l00165"></a>00165 <span class="stringliteral">"to the request handler"</span>);
|
|
191
|
-
<a name="l00166"></a>00166 <span class="keywordflow">throw</span>;
|
|
192
|
-
<a name="l00167"></a>00167 }
|
|
193
|
-
<a name="l00168"></a>00168 }
|
|
194
|
-
<a name="l00169"></a>00169 <span class="comment"></span>
|
|
195
|
-
<a name="l00170"></a>00170 <span class="comment"> /**</span>
|
|
196
|
-
<a name="l00171"></a>00171 <span class="comment"> * Convenience shortcut for sendHeaders(const char *, unsigned int)</span>
|
|
197
|
-
<a name="l00172"></a>00172 <span class="comment"> * @param headers The headers</span>
|
|
198
|
-
<a name="l00173"></a>00173 <span class="comment"> * @pre initiated()</span>
|
|
199
|
-
<a name="l00174"></a>00174 <span class="comment"> * @throws IOException The I/O channel has already been closed or discarded.</span>
|
|
200
|
-
<a name="l00175"></a>00175 <span class="comment"> * @throws SystemException Something went wrong during writing.</span>
|
|
201
|
-
<a name="l00176"></a>00176 <span class="comment"> * @throws boost::thread_interrupted</span>
|
|
202
|
-
<a name="l00177"></a>00177 <span class="comment"> */</span>
|
|
203
|
-
<a name="l00178"></a><a class="code" href="classPassenger_1_1Session.html#a8253d81e64adc0dc72b1dc65a5117aba">00178</a> <span class="keyword">virtual</span> <span class="keywordtype">void</span> <a class="code" href="classPassenger_1_1Session.html#a8253d81e64adc0dc72b1dc65a5117aba" title="Convenience shortcut for sendHeaders(const char *, unsigned int).">sendHeaders</a>(<span class="keyword">const</span> <a class="code" href="classPassenger_1_1StaticString.html" title="An immutable, static byte buffer.">StaticString</a> &headers) {
|
|
204
|
-
<a name="l00179"></a>00179 <a class="code" href="classPassenger_1_1Session.html#a8f8a39f78dd2672b00f1ff01e4d6d671" title="Send HTTP request headers to the application.">sendHeaders</a>(headers.c_str(), headers.size());
|
|
205
|
-
<a name="l00180"></a>00180 }
|
|
206
|
-
<a name="l00181"></a>00181 <span class="comment"></span>
|
|
207
|
-
<a name="l00182"></a>00182 <span class="comment"> /**</span>
|
|
208
|
-
<a name="l00183"></a>00183 <span class="comment"> * Send a chunk of HTTP request body data to the application.</span>
|
|
209
|
-
<a name="l00184"></a>00184 <span class="comment"> * You can call this method as many times as is required to transfer</span>
|
|
210
|
-
<a name="l00185"></a>00185 <span class="comment"> * the entire HTTP request body.</span>
|
|
211
|
-
<a name="l00186"></a>00186 <span class="comment"> *</span>
|
|
212
|
-
<a name="l00187"></a>00187 <span class="comment"> * This method must only be called after a sendHeaders(), otherwise</span>
|
|
213
|
-
<a name="l00188"></a>00188 <span class="comment"> * strange things may happen.</span>
|
|
214
|
-
<a name="l00189"></a>00189 <span class="comment"> *</span>
|
|
215
|
-
<a name="l00190"></a>00190 <span class="comment"> * @param block A block of HTTP request body data to send.</span>
|
|
216
|
-
<a name="l00191"></a>00191 <span class="comment"> * @param size The size, in bytes, of <tt>block</tt>.</span>
|
|
217
|
-
<a name="l00192"></a>00192 <span class="comment"> * @pre initiated()</span>
|
|
218
|
-
<a name="l00193"></a>00193 <span class="comment"> * @throws IOException The I/O channel has already been closed or discarded.</span>
|
|
219
|
-
<a name="l00194"></a>00194 <span class="comment"> * @throws SystemException Something went wrong during writing.</span>
|
|
220
|
-
<a name="l00195"></a>00195 <span class="comment"> * @throws boost::thread_interrupted</span>
|
|
221
|
-
<a name="l00196"></a>00196 <span class="comment"> */</span>
|
|
222
|
-
<a name="l00197"></a><a class="code" href="classPassenger_1_1Session.html#a2203d81e25fe5066aed351608deecf7b">00197</a> <span class="keyword">virtual</span> <span class="keywordtype">void</span> <a class="code" href="classPassenger_1_1Session.html#a2203d81e25fe5066aed351608deecf7b" title="Send a chunk of HTTP request body data to the application.">sendBodyBlock</a>(<span class="keyword">const</span> <span class="keywordtype">char</span> *block, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> size) {
|
|
223
|
-
<a name="l00198"></a>00198 TRACE_POINT();
|
|
224
|
-
<a name="l00199"></a>00199 <span class="keywordtype">int</span> stream = <a class="code" href="classPassenger_1_1Session.html#a949c7a46f4bb0c628730ded2041d2489" title="Returns this session&#39;s channel&#39;s file descriptor.">getStream</a>();
|
|
225
|
-
<a name="l00200"></a>00200 <span class="keywordflow">if</span> (stream == -1) {
|
|
226
|
-
<a name="l00201"></a>00201 <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 write request body block to the "</span>
|
|
227
|
-
<a name="l00202"></a>00202 <span class="stringliteral">"request handler because the I/O channel has "</span>
|
|
228
|
-
<a name="l00203"></a>00203 <span class="stringliteral">"already been closed or discarded."</span>);
|
|
229
|
-
<a name="l00204"></a>00204 }
|
|
230
|
-
<a name="l00205"></a>00205 <span class="keywordflow">try</span> {
|
|
231
|
-
<a name="l00206"></a>00206 writeExact(stream, block, size);
|
|
232
|
-
<a name="l00207"></a>00207 } <span class="keywordflow">catch</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> &e) {
|
|
233
|
-
<a name="l00208"></a>00208 e.setBriefMessage(<span class="stringliteral">"An error occured while sending the "</span>
|
|
234
|
-
<a name="l00209"></a>00209 <span class="stringliteral">"request body to the request handler"</span>);
|
|
235
|
-
<a name="l00210"></a>00210 <span class="keywordflow">throw</span>;
|
|
236
|
-
<a name="l00211"></a>00211 }
|
|
237
|
-
<a name="l00212"></a>00212 }
|
|
238
|
-
<a name="l00213"></a>00213 <span class="comment"></span>
|
|
239
|
-
<a name="l00214"></a>00214 <span class="comment"> /**</span>
|
|
240
|
-
<a name="l00215"></a>00215 <span class="comment"> * Returns this session's channel's file descriptor. This stream is</span>
|
|
241
|
-
<a name="l00216"></a>00216 <span class="comment"> * full-duplex, and will be automatically closed upon Session's</span>
|
|
242
|
-
<a name="l00217"></a>00217 <span class="comment"> * destruction, unless discardStream() is called.</span>
|
|
243
|
-
<a name="l00218"></a>00218 <span class="comment"> *</span>
|
|
244
|
-
<a name="l00219"></a>00219 <span class="comment"> * @pre initiated()</span>
|
|
245
|
-
<a name="l00220"></a>00220 <span class="comment"> * @returns The file descriptor, or -1 if the I/O channel has already</span>
|
|
246
|
-
<a name="l00221"></a>00221 <span class="comment"> * been closed or discarded.</span>
|
|
247
|
-
<a name="l00222"></a>00222 <span class="comment"> */</span>
|
|
248
|
-
<a name="l00223"></a>00223 <span class="keyword">virtual</span> <span class="keywordtype">int</span> <a class="code" href="classPassenger_1_1Session.html#a949c7a46f4bb0c628730ded2041d2489" title="Returns this session&#39;s channel&#39;s file descriptor.">getStream</a>() <span class="keyword">const</span> = 0;
|
|
249
|
-
<a name="l00224"></a>00224 <span class="comment"></span>
|
|
250
|
-
<a name="l00225"></a>00225 <span class="comment"> /**</span>
|
|
251
|
-
<a name="l00226"></a>00226 <span class="comment"> * Set the timeout value for reading data from the I/O channel.</span>
|
|
252
|
-
<a name="l00227"></a>00227 <span class="comment"> * If no data can be read within the timeout period, then the</span>
|
|
253
|
-
<a name="l00228"></a>00228 <span class="comment"> * read call will fail with error EAGAIN or EWOULDBLOCK.</span>
|
|
254
|
-
<a name="l00229"></a>00229 <span class="comment"> *</span>
|
|
255
|
-
<a name="l00230"></a>00230 <span class="comment"> * @pre The I/O channel hasn't been closed or discarded.</span>
|
|
256
|
-
<a name="l00231"></a>00231 <span class="comment"> * @pre initiated()</span>
|
|
257
|
-
<a name="l00232"></a>00232 <span class="comment"> * @param msec The timeout, in milliseconds. If 0 is given,</span>
|
|
258
|
-
<a name="l00233"></a>00233 <span class="comment"> * there will be no timeout.</span>
|
|
259
|
-
<a name="l00234"></a>00234 <span class="comment"> * @throws SystemException Cannot set the timeout.</span>
|
|
260
|
-
<a name="l00235"></a>00235 <span class="comment"> */</span>
|
|
261
|
-
<a name="l00236"></a>00236 <span class="keyword">virtual</span> <span class="keywordtype">void</span> <a class="code" href="classPassenger_1_1Session.html#a5accbd8f7cce66d0ef6695481fdaa39c" title="Set the timeout value for reading data from the I/O channel.">setReaderTimeout</a>(<span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> msec) = 0;
|
|
262
|
-
<a name="l00237"></a>00237 <span class="comment"></span>
|
|
263
|
-
<a name="l00238"></a>00238 <span class="comment"> /**</span>
|
|
264
|
-
<a name="l00239"></a>00239 <span class="comment"> * Set the timeout value for writing data from the I/O channel.</span>
|
|
265
|
-
<a name="l00240"></a>00240 <span class="comment"> * If no data can be written within the timeout period, then the</span>
|
|
266
|
-
<a name="l00241"></a>00241 <span class="comment"> * write call will fail with error EAGAIN or EWOULDBLOCK.</span>
|
|
267
|
-
<a name="l00242"></a>00242 <span class="comment"> *</span>
|
|
268
|
-
<a name="l00243"></a>00243 <span class="comment"> * @pre The I/O channel hasn't been closed or discarded.</span>
|
|
269
|
-
<a name="l00244"></a>00244 <span class="comment"> * @pre initiated()</span>
|
|
270
|
-
<a name="l00245"></a>00245 <span class="comment"> * @param msec The timeout, in milliseconds. If 0 is given,</span>
|
|
271
|
-
<a name="l00246"></a>00246 <span class="comment"> * there will be no timeout.</span>
|
|
272
|
-
<a name="l00247"></a>00247 <span class="comment"> * @throws SystemException Cannot set the timeout.</span>
|
|
273
|
-
<a name="l00248"></a>00248 <span class="comment"> */</span>
|
|
274
|
-
<a name="l00249"></a>00249 <span class="keyword">virtual</span> <span class="keywordtype">void</span> <a class="code" href="classPassenger_1_1Session.html#a21dd749c0c8d22f65c6a914ec2f97c94" title="Set the timeout value for writing data from the I/O channel.">setWriterTimeout</a>(<span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> msec) = 0;
|
|
275
|
-
<a name="l00250"></a>00250 <span class="comment"></span>
|
|
276
|
-
<a name="l00251"></a>00251 <span class="comment"> /**</span>
|
|
277
|
-
<a name="l00252"></a>00252 <span class="comment"> * Indicate that we don't want to read data anymore from the I/O channel.</span>
|
|
278
|
-
<a name="l00253"></a>00253 <span class="comment"> * Calling this method after closeStream()/discardStream() is called will</span>
|
|
279
|
-
<a name="l00254"></a>00254 <span class="comment"> * have no effect.</span>
|
|
280
|
-
<a name="l00255"></a>00255 <span class="comment"> *</span>
|
|
281
|
-
<a name="l00256"></a>00256 <span class="comment"> * @pre initiated()</span>
|
|
282
|
-
<a name="l00257"></a>00257 <span class="comment"> * @throws SystemException Something went wrong.</span>
|
|
283
|
-
<a name="l00258"></a>00258 <span class="comment"> * @throws boost::thread_interrupted</span>
|
|
284
|
-
<a name="l00259"></a>00259 <span class="comment"> */</span>
|
|
285
|
-
<a name="l00260"></a>00260 <span class="keyword">virtual</span> <span class="keywordtype">void</span> <a class="code" href="classPassenger_1_1Session.html#ac579d233ddc82542c336b2af1f40c4dd" title="Indicate that we don&#39;t want to read data anymore from the I/O channel.">shutdownReader</a>() = 0;
|
|
286
|
-
<a name="l00261"></a>00261 <span class="comment"></span>
|
|
287
|
-
<a name="l00262"></a>00262 <span class="comment"> /**</span>
|
|
288
|
-
<a name="l00263"></a>00263 <span class="comment"> * Indicate that we don't want to write data anymore to the I/O channel.</span>
|
|
289
|
-
<a name="l00264"></a>00264 <span class="comment"> * Calling this method after closeStream()/discardStream() is called will</span>
|
|
290
|
-
<a name="l00265"></a>00265 <span class="comment"> * have no effect.</span>
|
|
291
|
-
<a name="l00266"></a>00266 <span class="comment"> *</span>
|
|
292
|
-
<a name="l00267"></a>00267 <span class="comment"> * @pre initiated()</span>
|
|
293
|
-
<a name="l00268"></a>00268 <span class="comment"> * @throws SystemException Something went wrong.</span>
|
|
294
|
-
<a name="l00269"></a>00269 <span class="comment"> * @throws boost::thread_interrupted</span>
|
|
295
|
-
<a name="l00270"></a>00270 <span class="comment"> */</span>
|
|
296
|
-
<a name="l00271"></a>00271 <span class="keyword">virtual</span> <span class="keywordtype">void</span> <a class="code" href="classPassenger_1_1Session.html#a8263c568a8ac4567b33728d820cbd920" title="Indicate that we don&#39;t want to write data anymore to the I/O channel.">shutdownWriter</a>() = 0;
|
|
297
|
-
<a name="l00272"></a>00272 <span class="comment"></span>
|
|
298
|
-
<a name="l00273"></a>00273 <span class="comment"> /**</span>
|
|
299
|
-
<a name="l00274"></a>00274 <span class="comment"> * Close the I/O stream.</span>
|
|
300
|
-
<a name="l00275"></a>00275 <span class="comment"> *</span>
|
|
301
|
-
<a name="l00276"></a>00276 <span class="comment"> * @throws SystemException Something went wrong.</span>
|
|
302
|
-
<a name="l00277"></a>00277 <span class="comment"> * @throws boost::thread_interrupted</span>
|
|
303
|
-
<a name="l00278"></a>00278 <span class="comment"> * @pre initiated()</span>
|
|
304
|
-
<a name="l00279"></a>00279 <span class="comment"> * @post getStream() == -1</span>
|
|
305
|
-
<a name="l00280"></a>00280 <span class="comment"> */</span>
|
|
306
|
-
<a name="l00281"></a>00281 <span class="keyword">virtual</span> <span class="keywordtype">void</span> <a class="code" href="classPassenger_1_1Session.html#a7ab85388f15388cb8e65873d1ad310a5" title="Close the I/O stream.">closeStream</a>() = 0;
|
|
307
|
-
<a name="l00282"></a>00282 <span class="comment"></span>
|
|
308
|
-
<a name="l00283"></a>00283 <span class="comment"> /**</span>
|
|
309
|
-
<a name="l00284"></a>00284 <span class="comment"> * Discard the I/O channel's file descriptor, so that the destructor</span>
|
|
310
|
-
<a name="l00285"></a>00285 <span class="comment"> * won't automatically close it.</span>
|
|
311
|
-
<a name="l00286"></a>00286 <span class="comment"> *</span>
|
|
312
|
-
<a name="l00287"></a>00287 <span class="comment"> * @pre initiated()</span>
|
|
313
|
-
<a name="l00288"></a>00288 <span class="comment"> * @post getStream() == -1</span>
|
|
314
|
-
<a name="l00289"></a>00289 <span class="comment"> */</span>
|
|
315
|
-
<a name="l00290"></a>00290 <span class="keyword">virtual</span> <span class="keywordtype">void</span> <a class="code" href="classPassenger_1_1Session.html#a75344fdfb3c693323877e32884efaa31" title="Discard the I/O channel&#39;s file descriptor, so that the destructor won&#39;t automatically...">discardStream</a>() = 0;
|
|
316
|
-
<a name="l00291"></a>00291 <span class="comment"></span>
|
|
317
|
-
<a name="l00292"></a>00292 <span class="comment"> /**</span>
|
|
318
|
-
<a name="l00293"></a>00293 <span class="comment"> * Get the process ID of the application process that this session</span>
|
|
319
|
-
<a name="l00294"></a>00294 <span class="comment"> * belongs to.</span>
|
|
320
|
-
<a name="l00295"></a>00295 <span class="comment"> */</span>
|
|
321
|
-
<a name="l00296"></a>00296 <span class="keyword">virtual</span> pid_t <a class="code" href="classPassenger_1_1Session.html#a1b58af5493a61bfe4efbd725dcef61a3" title="Get the process ID of the application process that this session belongs to.">getPid</a>() <span class="keyword">const</span> = 0;
|
|
322
|
-
<a name="l00297"></a>00297
|
|
323
|
-
<a name="l00298"></a>00298 <span class="keyword">const</span> <span class="keywordtype">string</span> getDetachKey()<span class="keyword"> const </span>{
|
|
324
|
-
<a name="l00299"></a>00299 <span class="keywordflow">return</span> detachKey;
|
|
325
|
-
<a name="l00300"></a>00300 }
|
|
326
|
-
<a name="l00301"></a>00301 <span class="comment"></span>
|
|
327
|
-
<a name="l00302"></a>00302 <span class="comment"> /**</span>
|
|
328
|
-
<a name="l00303"></a>00303 <span class="comment"> * Returns this session's process's connect password. This password is</span>
|
|
329
|
-
<a name="l00304"></a>00304 <span class="comment"> * guaranteed to be valid ASCII.</span>
|
|
330
|
-
<a name="l00305"></a>00305 <span class="comment"> */</span>
|
|
331
|
-
<a name="l00306"></a><a class="code" href="classPassenger_1_1Session.html#aeaf4f7097f7b3430dc88e8070cad5899">00306</a> <span class="keyword">const</span> <span class="keywordtype">string</span> <a class="code" href="classPassenger_1_1Session.html#aeaf4f7097f7b3430dc88e8070cad5899" title="Returns this session&#39;s process&#39;s connect password.">getConnectPassword</a>()<span class="keyword"> const </span>{
|
|
332
|
-
<a name="l00307"></a>00307 <span class="keywordflow">return</span> connectPassword;
|
|
333
|
-
<a name="l00308"></a>00308 }
|
|
334
|
-
<a name="l00309"></a>00309
|
|
335
|
-
<a name="l00310"></a>00310 <span class="keyword">const</span> <span class="keywordtype">string</span> getGupid()<span class="keyword"> const </span>{
|
|
336
|
-
<a name="l00311"></a>00311 <span class="keywordflow">return</span> gupid;
|
|
337
|
-
<a name="l00312"></a>00312 }
|
|
338
|
-
<a name="l00313"></a>00313 };
|
|
339
|
-
<a name="l00314"></a>00314
|
|
340
|
-
<a name="l00315"></a>00315 <span class="keyword">typedef</span> shared_ptr<Session> SessionPtr;
|
|
341
|
-
<a name="l00316"></a>00316
|
|
342
|
-
<a name="l00317"></a>00317 <span class="comment"></span>
|
|
343
|
-
<a name="l00318"></a>00318 <span class="comment">/**</span>
|
|
344
|
-
<a name="l00319"></a>00319 <span class="comment"> * A "standard" implementation of Session.</span>
|
|
345
|
-
<a name="l00320"></a>00320 <span class="comment"> */</span>
|
|
346
|
-
<a name="l00321"></a><a class="code" href="classPassenger_1_1StandardSession.html">00321</a> <span class="keyword">class </span><a class="code" href="classPassenger_1_1StandardSession.html" title="A &quot;standard&quot; implementation of Session.">StandardSession</a>: <span class="keyword">public</span> <a class="code" href="classPassenger_1_1Session.html" title="Represents a single request/response pair of an application process.">Session</a> {
|
|
347
|
-
<a name="l00322"></a>00322 <span class="keyword">public</span>:
|
|
348
|
-
<a name="l00323"></a>00323 <span class="keyword">typedef</span> function<void (const StandardSession *)> CloseCallback;
|
|
349
|
-
<a name="l00324"></a>00324
|
|
350
|
-
<a name="l00325"></a>00325 <span class="keyword">protected</span>:
|
|
351
|
-
<a name="l00326"></a>00326 pid_t pid;
|
|
352
|
-
<a name="l00327"></a>00327 CloseCallback closeCallback;
|
|
353
|
-
<a name="l00328"></a>00328 <span class="keywordtype">string</span> socketType;
|
|
354
|
-
<a name="l00329"></a>00329 <span class="keywordtype">string</span> socketName;
|
|
355
|
-
<a name="l00330"></a>00330 <span class="comment"></span>
|
|
356
|
-
<a name="l00331"></a>00331 <span class="comment"> /** The session connection file descriptor. */</span>
|
|
357
|
-
<a name="l00332"></a><a class="code" href="classPassenger_1_1StandardSession.html#a51d4e04acc68526a450b1fce2142dea9">00332</a> <span class="keywordtype">int</span> <a class="code" href="classPassenger_1_1StandardSession.html#a51d4e04acc68526a450b1fce2142dea9" title="The session connection file descriptor.">fd</a>;
|
|
358
|
-
<a name="l00333"></a>00333 <span class="keywordtype">bool</span> isInitiated;
|
|
359
|
-
<a name="l00334"></a>00334
|
|
360
|
-
<a name="l00335"></a>00335 <span class="keyword">public</span>:
|
|
361
|
-
<a name="l00336"></a>00336 <a class="code" href="classPassenger_1_1StandardSession.html" title="A &quot;standard&quot; implementation of Session.">StandardSession</a>(pid_t pid,
|
|
362
|
-
<a name="l00337"></a>00337 <span class="keyword">const</span> CloseCallback &closeCallback,
|
|
363
|
-
<a name="l00338"></a>00338 <span class="keyword">const</span> <span class="keywordtype">string</span> &socketType,
|
|
364
|
-
<a name="l00339"></a>00339 <span class="keyword">const</span> <span class="keywordtype">string</span> &socketName,
|
|
365
|
-
<a name="l00340"></a>00340 <span class="keyword">const</span> <span class="keywordtype">string</span> &detachKey,
|
|
366
|
-
<a name="l00341"></a>00341 <span class="keyword">const</span> <span class="keywordtype">string</span> &connectPassword,
|
|
367
|
-
<a name="l00342"></a>00342 <span class="keyword">const</span> <span class="keywordtype">string</span> &gupid)
|
|
368
|
-
<a name="l00343"></a>00343 {
|
|
369
|
-
<a name="l00344"></a>00344 TRACE_POINT();
|
|
370
|
-
<a name="l00345"></a>00345 <span class="keywordflow">if</span> (socketType != <span class="stringliteral">"unix"</span> && socketType != <span class="stringliteral">"tcp"</span>) {
|
|
371
|
-
<a name="l00346"></a>00346 <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">"Unsupported socket type '"</span> + socketType + <span class="stringliteral">"'"</span>);
|
|
372
|
-
<a name="l00347"></a>00347 }
|
|
373
|
-
<a name="l00348"></a>00348 this->pid = pid;
|
|
374
|
-
<a name="l00349"></a>00349 this->closeCallback = closeCallback;
|
|
375
|
-
<a name="l00350"></a>00350 this->socketType = socketType;
|
|
376
|
-
<a name="l00351"></a>00351 this->socketName = socketName;
|
|
377
|
-
<a name="l00352"></a>00352 this->detachKey = detachKey;
|
|
378
|
-
<a name="l00353"></a>00353 this->connectPassword = connectPassword;
|
|
379
|
-
<a name="l00354"></a>00354 this->gupid = gupid;
|
|
380
|
-
<a name="l00355"></a>00355 <a class="code" href="classPassenger_1_1StandardSession.html#a51d4e04acc68526a450b1fce2142dea9" title="The session connection file descriptor.">fd</a> = -1;
|
|
381
|
-
<a name="l00356"></a>00356 isInitiated = <span class="keyword">false</span>;
|
|
382
|
-
<a name="l00357"></a>00357 }
|
|
383
|
-
<a name="l00358"></a>00358
|
|
384
|
-
<a name="l00359"></a>00359 <span class="keyword">virtual</span> ~<a class="code" href="classPassenger_1_1StandardSession.html" title="A &quot;standard&quot; implementation of Session.">StandardSession</a>() {
|
|
385
|
-
<a name="l00360"></a>00360 TRACE_POINT();
|
|
386
|
-
<a name="l00361"></a>00361 <a class="code" href="classPassenger_1_1StandardSession.html#af5cdfa78db1fca6303ccd43ac5126b6b" title="Close the I/O stream.">closeStream</a>();
|
|
387
|
-
<a name="l00362"></a>00362 <span class="keywordflow">if</span> (closeCallback != NULL) {
|
|
388
|
-
<a name="l00363"></a>00363 closeCallback(<span class="keyword">this</span>);
|
|
389
|
-
<a name="l00364"></a>00364 }
|
|
390
|
-
<a name="l00365"></a>00365 }
|
|
391
|
-
<a name="l00366"></a>00366
|
|
392
|
-
<a name="l00367"></a><a class="code" href="classPassenger_1_1StandardSession.html#ac283db6faf2fcd1827baf3ebac276677">00367</a> <span class="keyword">virtual</span> <span class="keywordtype">void</span> <a class="code" href="classPassenger_1_1StandardSession.html#ac283db6faf2fcd1827baf3ebac276677" title="Initiate the session by connecting to the associated process.">initiate</a>() {
|
|
393
|
-
<a name="l00368"></a>00368 TRACE_POINT();
|
|
394
|
-
<a name="l00369"></a>00369 <span class="keywordflow">if</span> (socketType == <span class="stringliteral">"unix"</span>) {
|
|
395
|
-
<a name="l00370"></a>00370 <a class="code" href="classPassenger_1_1StandardSession.html#a51d4e04acc68526a450b1fce2142dea9" title="The session connection file descriptor.">fd</a> = connectToUnixServer(socketName.c_str());
|
|
396
|
-
<a name="l00371"></a>00371 } <span class="keywordflow">else</span> {
|
|
397
|
-
<a name="l00372"></a>00372 vector<string> args;
|
|
398
|
-
<a name="l00373"></a>00373
|
|
399
|
-
<a name="l00374"></a>00374 split(socketName, <span class="charliteral">':'</span>, args);
|
|
400
|
-
<a name="l00375"></a>00375 <span class="keywordflow">if</span> (args.size() != 2 || atoi(args[1]) == 0) {
|
|
401
|
-
<a name="l00376"></a>00376 UPDATE_TRACE_POINT();
|
|
402
|
-
<a name="l00377"></a>00377 <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">"Invalid TCP/IP address '"</span> + socketName + <span class="stringliteral">"'"</span>);
|
|
403
|
-
<a name="l00378"></a>00378 }
|
|
404
|
-
<a name="l00379"></a>00379 <a class="code" href="classPassenger_1_1StandardSession.html#a51d4e04acc68526a450b1fce2142dea9" title="The session connection file descriptor.">fd</a> = connectToTcpServer(args[0].c_str(), atoi(args[1]));
|
|
405
|
-
<a name="l00380"></a>00380 }
|
|
406
|
-
<a name="l00381"></a>00381 isInitiated = <span class="keyword">true</span>;
|
|
407
|
-
<a name="l00382"></a>00382 }
|
|
408
|
-
<a name="l00383"></a>00383
|
|
409
|
-
<a name="l00384"></a><a class="code" href="classPassenger_1_1StandardSession.html#a40cdaad38dfbb7995955f11bb27bba61">00384</a> <span class="keyword">virtual</span> <span class="keywordtype">bool</span> <a class="code" href="classPassenger_1_1StandardSession.html#a40cdaad38dfbb7995955f11bb27bba61" title="Returns whether this session has been initiated (that is, whether initiate() had...">initiated</a>()<span class="keyword"> const </span>{
|
|
410
|
-
<a name="l00385"></a>00385 <span class="keywordflow">return</span> isInitiated;
|
|
411
|
-
<a name="l00386"></a>00386 }
|
|
412
|
-
<a name="l00387"></a>00387
|
|
413
|
-
<a name="l00388"></a><a class="code" href="classPassenger_1_1StandardSession.html#a3a59997280d5f7fcaa901716cd8451a2">00388</a> <span class="keyword">virtual</span> <span class="keywordtype">string</span> <a class="code" href="classPassenger_1_1StandardSession.html#a3a59997280d5f7fcaa901716cd8451a2" title="Returns the type of the socket that this session is served from, e.g.">getSocketType</a>()<span class="keyword"> const </span>{
|
|
414
|
-
<a name="l00389"></a>00389 <span class="keywordflow">return</span> socketType;
|
|
415
|
-
<a name="l00390"></a>00390 }
|
|
416
|
-
<a name="l00391"></a>00391
|
|
417
|
-
<a name="l00392"></a><a class="code" href="classPassenger_1_1StandardSession.html#a720e98b8dd246eeca004c8e625c0d4d3">00392</a> <span class="keyword">virtual</span> <span class="keywordtype">string</span> <a class="code" href="classPassenger_1_1StandardSession.html#a720e98b8dd246eeca004c8e625c0d4d3" title="Returns the address of the socket that this session is served from.">getSocketName</a>()<span class="keyword"> const </span>{
|
|
418
|
-
<a name="l00393"></a>00393 <span class="keywordflow">return</span> socketName;
|
|
419
|
-
<a name="l00394"></a>00394 }
|
|
420
|
-
<a name="l00395"></a>00395
|
|
421
|
-
<a name="l00396"></a><a class="code" href="classPassenger_1_1StandardSession.html#aa3491d2151ba3b94c1b19a4f18bade6a">00396</a> <span class="keyword">virtual</span> <span class="keywordtype">int</span> <a class="code" href="classPassenger_1_1StandardSession.html#aa3491d2151ba3b94c1b19a4f18bade6a" title="Returns this session&#39;s channel&#39;s file descriptor.">getStream</a>()<span class="keyword"> const </span>{
|
|
422
|
-
<a name="l00397"></a>00397 <span class="keywordflow">return</span> <a class="code" href="classPassenger_1_1StandardSession.html#a51d4e04acc68526a450b1fce2142dea9" title="The session connection file descriptor.">fd</a>;
|
|
423
|
-
<a name="l00398"></a>00398 }
|
|
424
|
-
<a name="l00399"></a>00399
|
|
425
|
-
<a name="l00400"></a><a class="code" href="classPassenger_1_1StandardSession.html#a960346d8c27ff1ae9017d753e41a159a">00400</a> <span class="keyword">virtual</span> <span class="keywordtype">void</span> <a class="code" href="classPassenger_1_1StandardSession.html#a960346d8c27ff1ae9017d753e41a159a" title="Set the timeout value for reading data from the I/O channel.">setReaderTimeout</a>(<span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> msec) {
|
|
426
|
-
<a name="l00401"></a>00401 <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_1StandardSession.html#a51d4e04acc68526a450b1fce2142dea9" title="The session connection file descriptor.">fd</a>).setReadTimeout(msec);
|
|
427
|
-
<a name="l00402"></a>00402 }
|
|
428
|
-
<a name="l00403"></a>00403
|
|
429
|
-
<a name="l00404"></a><a class="code" href="classPassenger_1_1StandardSession.html#abb51c323ac0e24011191862f6dec7a75">00404</a> <span class="keyword">virtual</span> <span class="keywordtype">void</span> <a class="code" href="classPassenger_1_1StandardSession.html#abb51c323ac0e24011191862f6dec7a75" title="Set the timeout value for writing data from the I/O channel.">setWriterTimeout</a>(<span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> msec) {
|
|
430
|
-
<a name="l00405"></a>00405 <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_1StandardSession.html#a51d4e04acc68526a450b1fce2142dea9" title="The session connection file descriptor.">fd</a>).setWriteTimeout(msec);
|
|
431
|
-
<a name="l00406"></a>00406 }
|
|
432
|
-
<a name="l00407"></a>00407
|
|
433
|
-
<a name="l00408"></a><a class="code" href="classPassenger_1_1StandardSession.html#ac92d4d081d6145ba8d441c8cf88fae74">00408</a> <span class="keyword">virtual</span> <span class="keywordtype">void</span> <a class="code" href="classPassenger_1_1StandardSession.html#ac92d4d081d6145ba8d441c8cf88fae74" title="Indicate that we don&#39;t want to read data anymore from the I/O channel.">shutdownReader</a>() {
|
|
434
|
-
<a name="l00409"></a>00409 TRACE_POINT();
|
|
435
|
-
<a name="l00410"></a>00410 <span class="keywordflow">if</span> (<a class="code" href="classPassenger_1_1StandardSession.html#a51d4e04acc68526a450b1fce2142dea9" title="The session connection file descriptor.">fd</a> != -1) {
|
|
436
|
-
<a name="l00411"></a>00411 <span class="keywordtype">int</span> ret = syscalls::shutdown(<a class="code" href="classPassenger_1_1StandardSession.html#a51d4e04acc68526a450b1fce2142dea9" title="The session connection file descriptor.">fd</a>, SHUT_RD);
|
|
437
|
-
<a name="l00412"></a>00412 <span class="keywordflow">if</span> (ret == -1) {
|
|
438
|
-
<a name="l00413"></a>00413 <span class="keywordtype">int</span> e = errno;
|
|
439
|
-
<a name="l00414"></a>00414 <span class="comment">// ENOTCONN is harmless here.</span>
|
|
440
|
-
<a name="l00415"></a>00415 <span class="keywordflow">if</span> (e != ENOTCONN) {
|
|
441
|
-
<a name="l00416"></a>00416 <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">"Cannot shutdown the reader stream"</span>,
|
|
442
|
-
<a name="l00417"></a>00417 e);
|
|
443
|
-
<a name="l00418"></a>00418 }
|
|
444
|
-
<a name="l00419"></a>00419 }
|
|
445
|
-
<a name="l00420"></a>00420 }
|
|
446
|
-
<a name="l00421"></a>00421 }
|
|
447
|
-
<a name="l00422"></a>00422
|
|
448
|
-
<a name="l00423"></a><a class="code" href="classPassenger_1_1StandardSession.html#a045a8f7f849c34086b0832fdba7a2915">00423</a> <span class="keyword">virtual</span> <span class="keywordtype">void</span> <a class="code" href="classPassenger_1_1StandardSession.html#a045a8f7f849c34086b0832fdba7a2915" title="Indicate that we don&#39;t want to write data anymore to the I/O channel.">shutdownWriter</a>() {
|
|
449
|
-
<a name="l00424"></a>00424 TRACE_POINT();
|
|
450
|
-
<a name="l00425"></a>00425 <span class="keywordflow">if</span> (<a class="code" href="classPassenger_1_1StandardSession.html#a51d4e04acc68526a450b1fce2142dea9" title="The session connection file descriptor.">fd</a> != -1) {
|
|
451
|
-
<a name="l00426"></a>00426 <span class="keywordtype">int</span> ret = syscalls::shutdown(<a class="code" href="classPassenger_1_1StandardSession.html#a51d4e04acc68526a450b1fce2142dea9" title="The session connection file descriptor.">fd</a>, SHUT_WR);
|
|
452
|
-
<a name="l00427"></a>00427 <span class="keywordflow">if</span> (ret == -1) {
|
|
453
|
-
<a name="l00428"></a>00428 <span class="keywordtype">int</span> e = errno;
|
|
454
|
-
<a name="l00429"></a>00429 <span class="comment">// ENOTCONN is harmless here.</span>
|
|
455
|
-
<a name="l00430"></a>00430 <span class="keywordflow">if</span> (e != ENOTCONN) {
|
|
456
|
-
<a name="l00431"></a>00431 <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">"Cannot shutdown the writer stream"</span>,
|
|
457
|
-
<a name="l00432"></a>00432 e);
|
|
458
|
-
<a name="l00433"></a>00433 }
|
|
459
|
-
<a name="l00434"></a>00434 }
|
|
460
|
-
<a name="l00435"></a>00435 }
|
|
461
|
-
<a name="l00436"></a>00436 }
|
|
462
|
-
<a name="l00437"></a>00437
|
|
463
|
-
<a name="l00438"></a><a class="code" href="classPassenger_1_1StandardSession.html#af5cdfa78db1fca6303ccd43ac5126b6b">00438</a> <span class="keyword">virtual</span> <span class="keywordtype">void</span> <a class="code" href="classPassenger_1_1StandardSession.html#af5cdfa78db1fca6303ccd43ac5126b6b" title="Close the I/O stream.">closeStream</a>() {
|
|
464
|
-
<a name="l00439"></a>00439 TRACE_POINT();
|
|
465
|
-
<a name="l00440"></a>00440 <span class="keywordflow">if</span> (<a class="code" href="classPassenger_1_1StandardSession.html#a51d4e04acc68526a450b1fce2142dea9" title="The session connection file descriptor.">fd</a> != -1) {
|
|
466
|
-
<a name="l00441"></a>00441 <span class="keywordtype">int</span> ret = syscalls::close(<a class="code" href="classPassenger_1_1StandardSession.html#a51d4e04acc68526a450b1fce2142dea9" title="The session connection file descriptor.">fd</a>);
|
|
467
|
-
<a name="l00442"></a>00442 <a class="code" href="classPassenger_1_1StandardSession.html#a51d4e04acc68526a450b1fce2142dea9" title="The session connection file descriptor.">fd</a> = -1;
|
|
468
|
-
<a name="l00443"></a>00443 <span class="keywordflow">if</span> (ret == -1) {
|
|
469
|
-
<a name="l00444"></a>00444 <span class="keywordtype">int</span> e = errno;
|
|
470
|
-
<a name="l00445"></a>00445 <span class="keywordflow">if</span> (errno == EIO) {
|
|
471
|
-
<a name="l00446"></a>00446 <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>(
|
|
472
|
-
<a name="l00447"></a>00447 <span class="stringliteral">"A write operation on the session stream failed"</span>,
|
|
473
|
-
<a name="l00448"></a>00448 e);
|
|
474
|
-
<a name="l00449"></a>00449 } <span class="keywordflow">else</span> {
|
|
475
|
-
<a name="l00450"></a>00450 <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>(
|
|
476
|
-
<a name="l00451"></a>00451 <span class="stringliteral">"Cannot close the session stream"</span>,
|
|
477
|
-
<a name="l00452"></a>00452 e);
|
|
478
|
-
<a name="l00453"></a>00453 }
|
|
479
|
-
<a name="l00454"></a>00454 }
|
|
480
|
-
<a name="l00455"></a>00455 }
|
|
481
|
-
<a name="l00456"></a>00456 }
|
|
482
|
-
<a name="l00457"></a>00457
|
|
483
|
-
<a name="l00458"></a><a class="code" href="classPassenger_1_1StandardSession.html#a3666d401df82696fe945fcbb66804785">00458</a> <span class="keyword">virtual</span> <span class="keywordtype">void</span> <a class="code" href="classPassenger_1_1StandardSession.html#a3666d401df82696fe945fcbb66804785" title="Discard the I/O channel&#39;s file descriptor, so that the destructor won&#39;t automatically...">discardStream</a>() {
|
|
484
|
-
<a name="l00459"></a>00459 <a class="code" href="classPassenger_1_1StandardSession.html#a51d4e04acc68526a450b1fce2142dea9" title="The session connection file descriptor.">fd</a> = -1;
|
|
485
|
-
<a name="l00460"></a>00460 }
|
|
486
|
-
<a name="l00461"></a>00461
|
|
487
|
-
<a name="l00462"></a><a class="code" href="classPassenger_1_1StandardSession.html#a496bbb49ac5f8d86ac6c37e979e7e3e8">00462</a> <span class="keyword">virtual</span> pid_t <a class="code" href="classPassenger_1_1StandardSession.html#a496bbb49ac5f8d86ac6c37e979e7e3e8" title="Get the process ID of the application process that this session belongs to.">getPid</a>()<span class="keyword"> const </span>{
|
|
488
|
-
<a name="l00463"></a>00463 <span class="keywordflow">return</span> pid;
|
|
489
|
-
<a name="l00464"></a>00464 }
|
|
490
|
-
<a name="l00465"></a>00465 };
|
|
491
|
-
<a name="l00466"></a>00466
|
|
492
|
-
<a name="l00467"></a>00467
|
|
493
|
-
<a name="l00468"></a>00468 } <span class="comment">// namespace Passenger</span>
|
|
494
|
-
<a name="l00469"></a>00469
|
|
495
|
-
<a name="l00470"></a>00470 <span class="preprocessor">#endif </span><span class="comment">/* _PASSENGER_SESSION_H_ */</span>
|
|
496
|
-
</pre></div></div>
|
|
497
|
-
<hr size="1"/><address style="text-align: right;"><small>Generated by
|
|
498
|
-
<a href="http://www.doxygen.org/index.html">
|
|
499
|
-
<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.6.2 </small></address>
|
|
500
|
-
</body>
|
|
501
|
-
</html>
|