passenger 3.0.0 → 3.0.1
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/DEVELOPERS.TXT +9 -6
- data/NEWS +50 -0
- data/Rakefile +2 -1
- data/bin/passenger-install-apache2-module +4 -4
- data/bin/passenger-install-nginx-module +1 -1
- data/bin/passenger-make-enterprisey +1 -1
- data/build/agents.rb +26 -19
- data/build/apache2.rb +49 -46
- data/build/basics.rb +37 -13
- data/build/common_library.rb +134 -64
- data/build/config.rb +18 -11
- data/build/cplusplus_support.rb +4 -0
- data/build/cxx_tests.rb +26 -12
- data/build/documentation.rb +18 -11
- data/build/integration_tests.rb +18 -11
- data/build/misc.rb +18 -11
- data/build/nginx.rb +27 -19
- data/build/oxt_tests.rb +18 -11
- data/build/packaging.rb +45 -37
- data/build/rpm.rb +98 -0
- data/build/ruby_extension.rb +19 -13
- data/build/ruby_tests.rb +19 -12
- data/build/test_basics.rb +23 -11
- data/debian/README.Debian +15 -0
- data/debian/changelog +185 -0
- data/debian/control +47 -19
- data/debian/copyright +20 -0
- data/debian/libapache2-mod-passenger.install +1 -0
- data/debian/libapache2-mod-passenger.postinst +36 -0
- data/debian/libapache2-mod-passenger.prerm +15 -0
- data/debian/passenger-common.install +4 -0
- data/debian/passenger.conf +4 -0
- data/debian/passenger.load +1 -0
- data/debian/rules +37 -0
- data/debian/watch +3 -0
- data/{misc → dev}/copy_boost_headers.rb +3 -0
- data/{misc → dev}/find_owner_pipe_leaks.rb +0 -0
- data/{misc → dev}/render_error_pages.rb +0 -0
- data/doc/Users guide Apache.html +39 -1
- data/doc/Users guide Apache.txt +40 -0
- data/doc/Users guide Nginx.html +1 -1
- data/doc/Users guide Standalone.html +1 -1
- data/doc/cxxapi/Constants_8h_source.html +1 -1
- data/doc/cxxapi/DirectoryMapper_8h_source.html +6 -22
- data/doc/cxxapi/EventedClient_8h_source.html +572 -468
- data/doc/cxxapi/Exceptions_8h_source.html +142 -129
- data/doc/cxxapi/FileDescriptor_8h_source.html +263 -199
- data/doc/cxxapi/MessageChannel_8h_source.html +686 -770
- data/doc/cxxapi/MessageServer_8h_source.html +1 -1
- data/doc/cxxapi/PoolOptions_8h_source.html +79 -78
- data/doc/cxxapi/ResourceLocator_8h_source.html +105 -55
- data/doc/cxxapi/SafeLibev_8h_source.html +180 -0
- data/doc/cxxapi/ServerInstanceDir_8h_source.html +114 -110
- data/doc/cxxapi/Session_8h_source.html +1 -1
- data/doc/cxxapi/SpawnManager_8h_source.html +208 -208
- data/doc/cxxapi/StaticString_8h_source.html +258 -183
- data/doc/cxxapi/Utils_8h_source.html +71 -54
- data/doc/cxxapi/annotated.html +3 -0
- data/doc/cxxapi/classAgentWatcher.html +2 -2
- data/doc/cxxapi/classPassenger_1_1DirectoryMapper-members.html +0 -1
- data/doc/cxxapi/classPassenger_1_1DirectoryMapper.html +0 -27
- data/doc/cxxapi/classPassenger_1_1EventedClient-members.html +5 -0
- data/doc/cxxapi/classPassenger_1_1EventedClient.html +102 -7
- data/doc/cxxapi/classPassenger_1_1FileDescriptor-members.html +2 -1
- data/doc/cxxapi/classPassenger_1_1FileDescriptor.html +34 -8
- data/doc/cxxapi/classPassenger_1_1FileDescriptorPair-members.html +36 -0
- data/doc/cxxapi/classPassenger_1_1FileDescriptorPair.html +52 -0
- data/doc/cxxapi/classPassenger_1_1MessageChannel-members.html +0 -3
- data/doc/cxxapi/classPassenger_1_1MessageChannel.html +0 -120
- data/doc/cxxapi/classPassenger_1_1SafeLibev-members.html +36 -0
- data/doc/cxxapi/classPassenger_1_1SafeLibev.html +51 -0
- data/doc/cxxapi/classPassenger_1_1SpawnException-members.html +1 -0
- data/doc/cxxapi/classPassenger_1_1SpawnException.html +22 -0
- data/doc/cxxapi/classes.html +14 -14
- data/doc/cxxapi/files.html +2 -0
- data/doc/cxxapi/functions_0x63.html +6 -3
- data/doc/cxxapi/functions_0x64.html +9 -2
- data/doc/cxxapi/functions_0x67.html +6 -9
- data/doc/cxxapi/functions_0x69.html +3 -0
- data/doc/cxxapi/functions_0x77.html +8 -8
- data/doc/cxxapi/functions_eval.html +6 -0
- data/doc/cxxapi/functions_func.html +18 -17
- data/doc/cxxapi/functions_vars.html +8 -0
- data/doc/cxxapi/graph_legend.png +0 -0
- data/doc/cxxapi/group__Core.png +0 -0
- data/doc/cxxapi/group__Hooks.png +0 -0
- data/doc/cxxapi/hierarchy.html +3 -0
- data/doc/cxxapi/inherit__graph__14.map +1 -1
- data/doc/cxxapi/inherit__graph__14.md5 +1 -1
- data/doc/cxxapi/inherit__graph__14.png +0 -0
- data/doc/cxxapi/inherit__graph__15.map +1 -3
- data/doc/cxxapi/inherit__graph__15.md5 +1 -1
- data/doc/cxxapi/inherit__graph__15.png +0 -0
- data/doc/cxxapi/inherit__graph__16.map +3 -1
- data/doc/cxxapi/inherit__graph__16.md5 +1 -1
- data/doc/cxxapi/inherit__graph__16.png +0 -0
- data/doc/cxxapi/inherit__graph__17.map +1 -1
- data/doc/cxxapi/inherit__graph__17.md5 +1 -1
- data/doc/cxxapi/inherit__graph__17.png +0 -0
- data/doc/cxxapi/inherit__graph__18.map +1 -2
- data/doc/cxxapi/inherit__graph__18.md5 +1 -1
- data/doc/cxxapi/inherit__graph__18.png +0 -0
- data/doc/cxxapi/inherit__graph__19.map +2 -1
- data/doc/cxxapi/inherit__graph__19.md5 +1 -1
- data/doc/cxxapi/inherit__graph__19.png +0 -0
- data/doc/cxxapi/inherit__graph__20.map +1 -1
- data/doc/cxxapi/inherit__graph__20.md5 +1 -1
- data/doc/cxxapi/inherit__graph__20.png +0 -0
- data/doc/cxxapi/inherit__graph__21.map +1 -1
- data/doc/cxxapi/inherit__graph__21.md5 +1 -1
- data/doc/cxxapi/inherit__graph__21.png +0 -0
- data/doc/cxxapi/inherit__graph__22.map +1 -1
- data/doc/cxxapi/inherit__graph__22.md5 +1 -1
- data/doc/cxxapi/inherit__graph__22.png +0 -0
- data/doc/cxxapi/inherit__graph__23.map +1 -1
- data/doc/cxxapi/inherit__graph__23.md5 +1 -1
- data/doc/cxxapi/inherit__graph__23.png +0 -0
- data/doc/cxxapi/inherit__graph__24.map +1 -1
- data/doc/cxxapi/inherit__graph__24.md5 +1 -1
- data/doc/cxxapi/inherit__graph__24.png +0 -0
- data/doc/cxxapi/inherit__graph__25.map +1 -1
- data/doc/cxxapi/inherit__graph__25.md5 +1 -1
- data/doc/cxxapi/inherit__graph__25.png +0 -0
- data/doc/cxxapi/inherit__graph__26.map +1 -1
- data/doc/cxxapi/inherit__graph__26.md5 +1 -1
- data/doc/cxxapi/inherit__graph__26.png +0 -0
- data/doc/cxxapi/inherit__graph__27.map +1 -1
- data/doc/cxxapi/inherit__graph__27.md5 +1 -1
- data/doc/cxxapi/inherit__graph__27.png +0 -0
- data/doc/cxxapi/inherit__graph__28.map +1 -2
- data/doc/cxxapi/inherit__graph__28.md5 +1 -1
- data/doc/cxxapi/inherit__graph__28.png +0 -0
- data/doc/cxxapi/inherit__graph__29.map +1 -1
- data/doc/cxxapi/inherit__graph__29.md5 +1 -1
- data/doc/cxxapi/inherit__graph__29.png +0 -0
- data/doc/cxxapi/inherit__graph__30.map +1 -1
- data/doc/cxxapi/inherit__graph__30.md5 +1 -1
- data/doc/cxxapi/inherit__graph__30.png +0 -0
- data/doc/cxxapi/inherit__graph__31.map +2 -1
- data/doc/cxxapi/inherit__graph__31.md5 +1 -1
- data/doc/cxxapi/inherit__graph__31.png +0 -0
- data/doc/cxxapi/inherit__graph__32.map +1 -3
- data/doc/cxxapi/inherit__graph__32.md5 +1 -1
- data/doc/cxxapi/inherit__graph__32.png +0 -0
- data/doc/cxxapi/inherit__graph__33.map +1 -1
- data/doc/cxxapi/inherit__graph__33.md5 +1 -1
- data/doc/cxxapi/inherit__graph__33.png +0 -0
- data/doc/cxxapi/inherit__graph__34.map +1 -1
- data/doc/cxxapi/inherit__graph__34.md5 +1 -1
- data/doc/cxxapi/inherit__graph__34.png +0 -0
- data/doc/cxxapi/inherit__graph__35.map +3 -1
- data/doc/cxxapi/inherit__graph__35.md5 +1 -1
- data/doc/cxxapi/inherit__graph__35.png +0 -0
- data/doc/cxxapi/inherit__graph__36.map +1 -1
- data/doc/cxxapi/inherit__graph__36.md5 +1 -1
- data/doc/cxxapi/inherit__graph__36.png +0 -0
- data/doc/cxxapi/inherit__graph__37.map +1 -1
- data/doc/cxxapi/inherit__graph__37.md5 +1 -1
- data/doc/cxxapi/inherit__graph__37.png +0 -0
- data/doc/cxxapi/inherit__graph__38.map +3 -1
- data/doc/cxxapi/inherit__graph__38.md5 +1 -1
- data/doc/cxxapi/inherit__graph__38.png +0 -0
- data/doc/cxxapi/inherit__graph__39.map +3 -1
- data/doc/cxxapi/inherit__graph__39.md5 +1 -1
- data/doc/cxxapi/inherit__graph__39.png +0 -0
- data/doc/cxxapi/inherits.html +33 -24
- data/doc/cxxapi/namespacePassenger.html +52 -0
- data/doc/cxxapi/namespacemembers.html +6 -0
- data/doc/cxxapi/namespacemembers_func.html +6 -0
- data/doc/cxxapi/tree.html +8 -0
- data/ext/apache2/Configuration.cpp +30 -8
- data/ext/apache2/Configuration.hpp +15 -14
- data/ext/apache2/DirectoryMapper.h +0 -16
- data/ext/apache2/Hooks.cpp +30 -29
- data/ext/boost/algorithm/string/detail/case_conv.hpp +6 -6
- data/ext/boost/algorithm/string/detail/find_format.hpp +14 -4
- data/ext/boost/algorithm/string/detail/find_format_all.hpp +13 -3
- data/ext/boost/algorithm/string/detail/find_format_store.hpp +11 -0
- data/ext/boost/algorithm/string/erase.hpp +2 -2
- data/ext/boost/bind/placeholders.hpp +2 -2
- data/ext/boost/concept/detail/backward_compatibility.hpp +16 -0
- data/ext/boost/concept/detail/general.hpp +15 -6
- data/ext/boost/concept/detail/has_constraints.hpp +5 -3
- data/ext/boost/concept/usage.hpp +5 -4
- data/ext/boost/concept_check.hpp +10 -1
- data/ext/boost/config/abi/borland_prefix.hpp +1 -1
- data/ext/boost/config/auto_link.hpp +68 -21
- data/ext/boost/config/compiler/borland.hpp +11 -3
- data/ext/boost/config/compiler/clang.hpp +62 -0
- data/ext/boost/config/compiler/codegear.hpp +21 -7
- data/ext/boost/config/compiler/common_edg.hpp +4 -2
- data/ext/boost/config/compiler/digitalmars.hpp +1 -1
- data/ext/boost/config/compiler/gcc.hpp +46 -7
- data/ext/boost/config/compiler/gcc_xml.hpp +25 -0
- data/ext/boost/config/compiler/intel.hpp +23 -0
- data/ext/boost/config/compiler/kai.hpp +1 -1
- data/ext/boost/config/compiler/metrowerks.hpp +1 -1
- data/ext/boost/config/compiler/nvcc.hpp +86 -0
- data/ext/boost/config/compiler/pgi.hpp +18 -3
- data/ext/boost/config/compiler/sunpro_cc.hpp +19 -5
- data/ext/boost/config/compiler/vacpp.hpp +8 -0
- data/ext/boost/config/compiler/visualc.hpp +27 -11
- data/ext/boost/config/platform/cygwin.hpp +0 -3
- data/ext/boost/config/platform/symbian.hpp +94 -0
- data/ext/boost/config/platform/win32.hpp +8 -1
- data/ext/boost/config/select_compiler_config.hpp +10 -0
- data/ext/boost/config/select_platform_config.hpp +4 -0
- data/ext/boost/config/stdlib/dinkumware.hpp +11 -1
- data/ext/boost/config/stdlib/libcomo.hpp +1 -0
- data/ext/boost/config/stdlib/libstdcpp3.hpp +1 -0
- data/ext/boost/config/stdlib/modena.hpp +1 -0
- data/ext/boost/config/stdlib/msl.hpp +1 -0
- data/ext/boost/config/stdlib/roguewave.hpp +1 -0
- data/ext/boost/config/stdlib/sgi.hpp +1 -0
- data/ext/boost/config/stdlib/stlport.hpp +1 -0
- data/ext/boost/config/stdlib/vacpp.hpp +1 -0
- data/ext/boost/config/suffix.hpp +40 -2
- data/ext/boost/cstdint.hpp +36 -7
- data/ext/boost/date_time/gregorian/conversion.hpp +4 -2
- data/ext/boost/date_time/microsec_time_clock.hpp +7 -7
- data/ext/boost/date_time/posix_time/conversion.hpp +4 -2
- data/ext/boost/date_time/time_facet.hpp +43 -4
- data/ext/boost/detail/endian.hpp +5 -2
- data/ext/boost/detail/lcast_precision.hpp +2 -2
- data/ext/boost/detail/sp_typeinfo.hpp +1 -1
- data/ext/boost/detail/workaround.hpp +5 -0
- data/ext/boost/exception/detail/error_info_impl.hpp +3 -3
- data/ext/boost/exception/detail/exception_ptr.hpp +76 -135
- data/ext/boost/exception/detail/is_output_streamable.hpp +15 -2
- data/ext/boost/exception/detail/type_info.hpp +9 -5
- data/ext/boost/exception/diagnostic_information.hpp +5 -3
- data/ext/boost/exception/exception.hpp +60 -46
- data/ext/boost/exception/info.hpp +47 -14
- data/ext/boost/function/function_base.hpp +4 -4
- data/ext/boost/integer.hpp +4 -0
- data/ext/boost/integer_fwd.hpp +9 -3
- data/ext/boost/iterator/iterator_concepts.hpp +284 -0
- data/ext/boost/iterator/transform_iterator.hpp +0 -1
- data/ext/boost/make_shared.hpp +17 -0
- data/ext/boost/mpl/aux_/config/has_xxx.hpp +4 -3
- data/ext/boost/mpl/aux_/preprocessed/gcc/template_arity.hpp +2 -6
- data/ext/boost/mpl/aux_/template_arity.hpp +4 -4
- data/ext/boost/mpl/eval_if.hpp +3 -3
- data/ext/boost/mpl/has_xxx.hpp +369 -3
- data/ext/boost/optional/optional.hpp +3 -1
- data/ext/boost/optional/optional_fwd.hpp +1 -1
- data/ext/boost/preprocessor/repetition/enum_trailing_params.hpp +38 -0
- data/ext/boost/range/algorithm/equal.hpp +188 -0
- data/ext/boost/range/as_literal.hpp +15 -15
- data/ext/boost/range/concepts.hpp +331 -0
- data/ext/boost/range/const_iterator.hpp +7 -4
- data/ext/boost/range/detail/extract_optional_type.hpp +52 -0
- data/ext/boost/range/detail/implementation_help.hpp +7 -7
- data/ext/boost/range/detail/misc_concept.hpp +33 -0
- data/ext/boost/range/iterator.hpp +32 -32
- data/ext/boost/range/iterator_range.hpp +8 -651
- data/ext/boost/range/iterator_range_core.hpp +542 -0
- data/ext/boost/range/iterator_range_io.hpp +93 -0
- data/ext/boost/range/mutable_iterator.hpp +7 -4
- data/ext/boost/range/size.hpp +1 -1
- data/ext/boost/range/size_type.hpp +2 -1
- data/ext/boost/shared_array.hpp +19 -0
- data/ext/boost/smart_ptr/detail/sp_convertible.hpp +2 -2
- data/ext/boost/smart_ptr/detail/yield_k.hpp +1 -1
- data/ext/boost/smart_ptr/make_shared.hpp +508 -0
- data/ext/boost/smart_ptr/shared_array.hpp +147 -0
- data/ext/boost/src/pthread/thread.cpp +16 -21
- data/ext/boost/src/pthread/timeconv.inl +7 -4
- data/ext/boost/thread/barrier.hpp +2 -1
- data/ext/boost/thread/detail/config.hpp +7 -1
- data/ext/boost/thread/detail/platform.hpp +1 -1
- data/ext/boost/thread/detail/thread.hpp +62 -18
- data/ext/boost/thread/detail/thread_group.hpp +5 -2
- data/ext/boost/thread/detail/tss_hooks.hpp +8 -25
- data/ext/boost/thread/future.hpp +45 -34
- data/ext/boost/thread/locks.hpp +184 -55
- data/ext/boost/thread/pthread/condition_variable.hpp +7 -7
- data/ext/boost/thread/pthread/condition_variable_fwd.hpp +4 -2
- data/ext/boost/thread/pthread/mutex.hpp +29 -17
- data/ext/boost/thread/pthread/once.hpp +5 -0
- data/ext/boost/thread/pthread/recursive_mutex.hpp +97 -18
- data/ext/boost/thread/pthread/shared_mutex.hpp +1 -1
- data/ext/boost/thread/pthread/thread_heap_alloc.hpp +1 -1
- data/ext/boost/thread/tss.hpp +2 -0
- data/ext/boost/throw_exception.hpp +21 -5
- data/ext/boost/token_functions.hpp +111 -91
- data/ext/boost/type_traits/add_reference.hpp +19 -1
- data/ext/boost/type_traits/function_traits.hpp +2 -2
- data/ext/boost/type_traits/is_const.hpp +24 -5
- data/ext/boost/type_traits/is_convertible.hpp +1 -1
- data/ext/boost/type_traits/is_function.hpp +3 -0
- data/ext/boost/type_traits/is_lvalue_reference.hpp +118 -0
- data/ext/boost/type_traits/is_reference.hpp +8 -81
- data/ext/boost/type_traits/is_rvalue_reference.hpp +29 -0
- data/ext/boost/type_traits/is_same.hpp +2 -2
- data/ext/boost/type_traits/is_volatile.hpp +26 -7
- data/ext/boost/type_traits/remove_const.hpp +12 -0
- data/ext/boost/type_traits/remove_cv.hpp +23 -1
- data/ext/boost/type_traits/remove_reference.hpp +21 -1
- data/ext/boost/type_traits/type_with_alignment.hpp +10 -10
- data/ext/boost/units/detail/utility.hpp +104 -0
- data/ext/boost/utility/compare_pointees.hpp +1 -1
- data/ext/common/AgentsStarter.hpp +151 -161
- data/ext/common/ApplicationPool/Pool.h +16 -4
- data/ext/common/Constants.h +1 -1
- data/ext/common/EventedClient.h +130 -26
- data/ext/common/Exceptions.h +15 -2
- data/ext/common/FileDescriptor.h +76 -12
- data/ext/common/IniFile.h +488 -0
- data/ext/common/LoggingAgent/LoggingServer.h +2 -2
- data/ext/common/LoggingAgent/RemoteSender.h +15 -6
- data/ext/common/MessageChannel.h +17 -101
- data/ext/common/PoolOptions.h +1 -0
- data/ext/common/ResourceLocator.h +78 -28
- data/ext/common/SafeLibev.h +149 -0
- data/ext/common/ServerInstanceDir.h +11 -7
- data/ext/common/Session.h +1 -1
- data/ext/common/SpawnManager.h +14 -14
- data/ext/common/StaticString.h +75 -0
- data/ext/common/Utils.cpp +304 -12
- data/ext/common/Utils.h +17 -0
- data/ext/common/Utils/BufferedIO.h +196 -0
- data/ext/common/Utils/IOUtils.cpp +159 -0
- data/ext/common/Utils/IOUtils.h +118 -1
- data/ext/common/Utils/ProcessMetricsCollector.h +184 -56
- data/ext/common/Utils/StrIntUtils.cpp +45 -11
- data/ext/common/Utils/StrIntUtils.h +8 -5
- data/ext/common/Utils/Timer.h +22 -0
- data/ext/common/Utils/utf8.h +35 -0
- data/ext/common/Utils/utf8/checked.h +324 -0
- data/ext/common/Utils/utf8/core.h +359 -0
- data/ext/common/Utils/utf8/unchecked.h +229 -0
- data/ext/common/Watchdog.cpp +52 -85
- data/ext/libev/config.h +122 -0
- data/ext/nginx/Configuration.c +7 -1
- data/ext/nginx/HelperAgent.cpp +16 -18
- data/ext/nginx/config +6 -4
- data/ext/oxt/system_calls.cpp +10 -0
- data/ext/oxt/system_calls.hpp +2 -0
- data/lib/phusion_passenger.rb +6 -11
- data/lib/phusion_passenger/dependencies.rb +2 -0
- data/lib/phusion_passenger/packaging.rb +5 -5
- data/lib/phusion_passenger/platform_info.rb +88 -0
- data/lib/phusion_passenger/platform_info/binary_compatibility.rb +3 -17
- data/lib/phusion_passenger/platform_info/compiler.rb +14 -32
- data/lib/phusion_passenger/platform_info/curl.rb +6 -1
- data/lib/phusion_passenger/platform_info/operating_system.rb +107 -0
- data/lib/phusion_passenger/public_api.rb +2 -2
- data/lib/phusion_passenger/rails3_extensions/init.rb +5 -2
- data/lib/phusion_passenger/standalone/command.rb +6 -2
- data/lib/phusion_passenger/standalone/package_runtime_command.rb +2 -2
- data/lib/phusion_passenger/standalone/runtime_installer.rb +17 -5
- data/lib/phusion_passenger/standalone/start_command.rb +12 -12
- data/lib/phusion_passenger/standalone/stop_command.rb +3 -3
- data/lib/phusion_passenger/standalone/utils.rb +6 -2
- data/lib/phusion_passenger/templates/standalone/config.erb +37 -5
- data/lib/phusion_passenger/utils.rb +4 -7
- data/resources/mime.types +73 -0
- data/{misc → resources}/union_station_gateway.crt +0 -0
- data/test/cxx/BufferedIOTest.cpp +364 -0
- data/test/cxx/EventedClientTest.cpp +150 -13
- data/test/cxx/IOUtilsTest.cpp +399 -1
- data/test/cxx/MessageChannelTest.cpp +5 -120
- data/test/cxx/ProcessMetricsCollectorTest.cpp +121 -0
- data/test/cxx/StaticStringTest.cpp +134 -0
- data/test/cxx/UtilsTest.cpp +16 -46
- data/test/stub/rails_apps/2.3/mycook/public/dispatch.cgi +2 -2
- data/test/stub/rails_apps/2.3/mycook/public/dispatch.fcgi +1 -1
- data/test/stub/rails_apps/2.3/mycook/public/dispatch.rb +1 -1
- data/test/stub/rails_apps/3.0/empty/Gemfile.lock +73 -0
- data/test/support/allocate_memory.c +14 -0
- data/test/support/test_helper.rb +3 -0
- metadata +57 -174
- data/bin/passenger-stress-test +0 -345
- data/debian/postinst +0 -24
- data/doc/rdoc/classes/ConditionVariable.html +0 -215
- data/doc/rdoc/classes/Exception.html +0 -120
- data/doc/rdoc/classes/GC.html +0 -113
- data/doc/rdoc/classes/IO.html +0 -221
- data/doc/rdoc/classes/PhusionPassenger.html +0 -397
- data/doc/rdoc/classes/PhusionPassenger/AbstractInstaller.html +0 -180
- data/doc/rdoc/classes/PhusionPassenger/AbstractRequestHandler.html +0 -647
- data/doc/rdoc/classes/PhusionPassenger/AbstractServer.html +0 -654
- data/doc/rdoc/classes/PhusionPassenger/AbstractServer/InvalidPassword.html +0 -92
- data/doc/rdoc/classes/PhusionPassenger/AbstractServer/ServerAlreadyStarted.html +0 -97
- data/doc/rdoc/classes/PhusionPassenger/AbstractServer/ServerError.html +0 -96
- data/doc/rdoc/classes/PhusionPassenger/AbstractServer/ServerNotStarted.html +0 -97
- data/doc/rdoc/classes/PhusionPassenger/AbstractServer/UnknownMessage.html +0 -96
- data/doc/rdoc/classes/PhusionPassenger/AbstractServerCollection.html +0 -619
- data/doc/rdoc/classes/PhusionPassenger/AdminTools.html +0 -142
- data/doc/rdoc/classes/PhusionPassenger/AdminTools/MemoryStats.html +0 -368
- data/doc/rdoc/classes/PhusionPassenger/AdminTools/MemoryStats/Process.html +0 -231
- data/doc/rdoc/classes/PhusionPassenger/AdminTools/ServerInstance.html +0 -588
- data/doc/rdoc/classes/PhusionPassenger/AdminTools/ServerInstance/CorruptedDirectoryError.html +0 -92
- data/doc/rdoc/classes/PhusionPassenger/AdminTools/ServerInstance/GenerationsAbsentError.html +0 -92
- data/doc/rdoc/classes/PhusionPassenger/AdminTools/ServerInstance/Group.html +0 -147
- data/doc/rdoc/classes/PhusionPassenger/AdminTools/ServerInstance/Process.html +0 -279
- data/doc/rdoc/classes/PhusionPassenger/AdminTools/ServerInstance/RoleDeniedError.html +0 -92
- data/doc/rdoc/classes/PhusionPassenger/AdminTools/ServerInstance/StaleDirectoryError.html +0 -92
- data/doc/rdoc/classes/PhusionPassenger/AdminTools/ServerInstance/Stats.html +0 -123
- data/doc/rdoc/classes/PhusionPassenger/AdminTools/ServerInstance/UnsupportedGenerationStructureVersionError.html +0 -92
- data/doc/rdoc/classes/PhusionPassenger/AnalyticsLogger.html +0 -341
- data/doc/rdoc/classes/PhusionPassenger/AnalyticsLogger/Log.html +0 -294
- data/doc/rdoc/classes/PhusionPassenger/AnalyticsLogger/SharedData.html +0 -199
- data/doc/rdoc/classes/PhusionPassenger/AppInitError.html +0 -155
- data/doc/rdoc/classes/PhusionPassenger/AppProcess.html +0 -367
- data/doc/rdoc/classes/PhusionPassenger/ClassicRails.html +0 -95
- data/doc/rdoc/classes/PhusionPassenger/ClassicRails/ApplicationSpawner.html +0 -351
- data/doc/rdoc/classes/PhusionPassenger/ClassicRails/ApplicationSpawner/Error.html +0 -98
- data/doc/rdoc/classes/PhusionPassenger/ClassicRails/CGIFixed.html +0 -200
- data/doc/rdoc/classes/PhusionPassenger/ClassicRails/FrameworkSpawner.html +0 -410
- data/doc/rdoc/classes/PhusionPassenger/ClassicRails/FrameworkSpawner/Error.html +0 -98
- data/doc/rdoc/classes/PhusionPassenger/ClassicRails/RequestHandler.html +0 -156
- data/doc/rdoc/classes/PhusionPassenger/ClassicRailsExtensions.html +0 -115
- data/doc/rdoc/classes/PhusionPassenger/ClassicRailsExtensions/AnalyticsLogging.html +0 -202
- data/doc/rdoc/classes/PhusionPassenger/ConsoleTextTemplate.html +0 -172
- data/doc/rdoc/classes/PhusionPassenger/DebugLogging.html +0 -273
- data/doc/rdoc/classes/PhusionPassenger/FrameworkInitError.html +0 -145
- data/doc/rdoc/classes/PhusionPassenger/HTMLTemplate.html +0 -162
- data/doc/rdoc/classes/PhusionPassenger/InitializationError.html +0 -141
- data/doc/rdoc/classes/PhusionPassenger/InvalidPath.html +0 -92
- data/doc/rdoc/classes/PhusionPassenger/MessageChannel.html +0 -673
- data/doc/rdoc/classes/PhusionPassenger/MessageChannel/InvalidHashError.html +0 -92
- data/doc/rdoc/classes/PhusionPassenger/MessageClient.html +0 -415
- data/doc/rdoc/classes/PhusionPassenger/NativeSupportLoader.html +0 -134
- data/doc/rdoc/classes/PhusionPassenger/Packaging.html +0 -129
- data/doc/rdoc/classes/PhusionPassenger/PlatformInfo.html +0 -1809
- data/doc/rdoc/classes/PhusionPassenger/Plugin.html +0 -237
- data/doc/rdoc/classes/PhusionPassenger/Rack.html +0 -91
- data/doc/rdoc/classes/PhusionPassenger/Rack/ApplicationSpawner.html +0 -312
- data/doc/rdoc/classes/PhusionPassenger/Rack/ApplicationSpawner/Error.html +0 -98
- data/doc/rdoc/classes/PhusionPassenger/Rack/RequestHandler.html +0 -218
- data/doc/rdoc/classes/PhusionPassenger/Rails3Extensions.html +0 -114
- data/doc/rdoc/classes/PhusionPassenger/Rails3Extensions/AnalyticsLogging.html +0 -256
- data/doc/rdoc/classes/PhusionPassenger/Rails3Extensions/AnalyticsLogging/ACExtension.html +0 -139
- data/doc/rdoc/classes/PhusionPassenger/Rails3Extensions/AnalyticsLogging/ASBenchmarkableExtension.html +0 -118
- data/doc/rdoc/classes/PhusionPassenger/Rails3Extensions/AnalyticsLogging/ExceptionLogger.html +0 -135
- data/doc/rdoc/classes/PhusionPassenger/SpawnManager.html +0 -378
- data/doc/rdoc/classes/PhusionPassenger/Standalone.html +0 -111
- data/doc/rdoc/classes/PhusionPassenger/Standalone/AppFinder.html +0 -252
- data/doc/rdoc/classes/PhusionPassenger/Standalone/Command.html +0 -161
- data/doc/rdoc/classes/PhusionPassenger/Standalone/ConfigFile.html +0 -368
- data/doc/rdoc/classes/PhusionPassenger/Standalone/ConfigFile/DisallowedContextError.html +0 -132
- data/doc/rdoc/classes/PhusionPassenger/Standalone/HelpCommand.html +0 -151
- data/doc/rdoc/classes/PhusionPassenger/Standalone/Main.html +0 -189
- data/doc/rdoc/classes/PhusionPassenger/Standalone/PackageRuntimeCommand.html +0 -177
- data/doc/rdoc/classes/PhusionPassenger/Standalone/RuntimeInstaller.html +0 -341
- data/doc/rdoc/classes/PhusionPassenger/Standalone/StartCommand.html +0 -203
- data/doc/rdoc/classes/PhusionPassenger/Standalone/StatusCommand.html +0 -156
- data/doc/rdoc/classes/PhusionPassenger/Standalone/StopCommand.html +0 -168
- data/doc/rdoc/classes/PhusionPassenger/Standalone/Utils.html +0 -86
- data/doc/rdoc/classes/PhusionPassenger/Standalone/VersionCommand.html +0 -135
- data/doc/rdoc/classes/PhusionPassenger/UnknownError.html +0 -125
- data/doc/rdoc/classes/PhusionPassenger/Utils.html +0 -1550
- data/doc/rdoc/classes/PhusionPassenger/Utils/FileSystemWatcher.html +0 -204
- data/doc/rdoc/classes/PhusionPassenger/Utils/FileSystemWatcher/DirInfo.html +0 -171
- data/doc/rdoc/classes/PhusionPassenger/Utils/FileSystemWatcher/FileInfo.html +0 -140
- data/doc/rdoc/classes/PhusionPassenger/Utils/HostsFileParser.html +0 -260
- data/doc/rdoc/classes/PhusionPassenger/Utils/PseudoIO.html +0 -169
- data/doc/rdoc/classes/PhusionPassenger/Utils/RewindableInput.html +0 -265
- data/doc/rdoc/classes/PhusionPassenger/Utils/RewindableInput/Tempfile.html +0 -120
- data/doc/rdoc/classes/PhusionPassenger/Utils/UnseekableSocket.html +0 -561
- data/doc/rdoc/classes/PhusionPassenger/VersionNotFound.html +0 -140
- data/doc/rdoc/classes/PhusionPassenger/WSGI.html +0 -89
- data/doc/rdoc/classes/PhusionPassenger/WSGI/ApplicationSpawner.html +0 -182
- data/doc/rdoc/classes/Process.html +0 -115
- data/doc/rdoc/classes/Signal.html +0 -139
- data/doc/rdoc/created.rid +0 -1
- data/doc/rdoc/files/DEVELOPERS_TXT.html +0 -276
- data/doc/rdoc/files/README.html +0 -157
- data/doc/rdoc/files/lib/phusion_passenger/abstract_installer_rb.html +0 -130
- data/doc/rdoc/files/lib/phusion_passenger/abstract_request_handler_rb.html +0 -135
- data/doc/rdoc/files/lib/phusion_passenger/abstract_server_collection_rb.html +0 -126
- data/doc/rdoc/files/lib/phusion_passenger/abstract_server_rb.html +0 -128
- data/doc/rdoc/files/lib/phusion_passenger/admin_tools/memory_stats_rb.html +0 -126
- data/doc/rdoc/files/lib/phusion_passenger/admin_tools/server_instance_rb.html +0 -132
- data/doc/rdoc/files/lib/phusion_passenger/admin_tools_rb.html +0 -122
- data/doc/rdoc/files/lib/phusion_passenger/analytics_logger_rb.html +0 -129
- data/doc/rdoc/files/lib/phusion_passenger/app_process_rb.html +0 -127
- data/doc/rdoc/files/lib/phusion_passenger/classic_rails/application_spawner_rb.html +0 -141
- data/doc/rdoc/files/lib/phusion_passenger/classic_rails/cgi_fixed_rb.html +0 -126
- data/doc/rdoc/files/lib/phusion_passenger/classic_rails/framework_spawner_rb.html +0 -146
- data/doc/rdoc/files/lib/phusion_passenger/classic_rails/request_handler_rb.html +0 -125
- data/doc/rdoc/files/lib/phusion_passenger/classic_rails_extensions/init_rb.html +0 -132
- data/doc/rdoc/files/lib/phusion_passenger/console_text_template_rb.html +0 -126
- data/doc/rdoc/files/lib/phusion_passenger/constants_rb.html +0 -122
- data/doc/rdoc/files/lib/phusion_passenger/debug_logging_rb.html +0 -122
- data/doc/rdoc/files/lib/phusion_passenger/dependencies_rb.html +0 -147
- data/doc/rdoc/files/lib/phusion_passenger/exceptions_rb.html +0 -122
- data/doc/rdoc/files/lib/phusion_passenger/html_template_rb.html +0 -127
- data/doc/rdoc/files/lib/phusion_passenger/message_channel_rb.html +0 -120
- data/doc/rdoc/files/lib/phusion_passenger/message_client_rb.html +0 -127
- data/doc/rdoc/files/lib/phusion_passenger/native_support_rb.html +0 -132
- data/doc/rdoc/files/lib/phusion_passenger/packaging_rb.html +0 -122
- data/doc/rdoc/files/lib/phusion_passenger/platform_info/apache_rb.html +0 -127
- data/doc/rdoc/files/lib/phusion_passenger/platform_info/binary_compatibility_rb.html +0 -129
- data/doc/rdoc/files/lib/phusion_passenger/platform_info/compiler_rb.html +0 -126
- data/doc/rdoc/files/lib/phusion_passenger/platform_info/curl_rb.html +0 -126
- data/doc/rdoc/files/lib/phusion_passenger/platform_info/documentation_tools_rb.html +0 -126
- data/doc/rdoc/files/lib/phusion_passenger/platform_info/linux_rb.html +0 -126
- data/doc/rdoc/files/lib/phusion_passenger/platform_info/operating_system_rb.html +0 -127
- data/doc/rdoc/files/lib/phusion_passenger/platform_info/ruby_rb.html +0 -128
- data/doc/rdoc/files/lib/phusion_passenger/platform_info/zlib_rb.html +0 -126
- data/doc/rdoc/files/lib/phusion_passenger/platform_info_rb.html +0 -122
- data/doc/rdoc/files/lib/phusion_passenger/plugin_rb.html +0 -127
- data/doc/rdoc/files/lib/phusion_passenger/public_api_rb.html +0 -127
- data/doc/rdoc/files/lib/phusion_passenger/rack/application_spawner_rb.html +0 -137
- data/doc/rdoc/files/lib/phusion_passenger/rack/request_handler_rb.html +0 -125
- data/doc/rdoc/files/lib/phusion_passenger/rails3_extensions/init_rb.html +0 -127
- data/doc/rdoc/files/lib/phusion_passenger/simple_benchmarking_rb.html +0 -122
- data/doc/rdoc/files/lib/phusion_passenger/spawn_manager_rb.html +0 -160
- data/doc/rdoc/files/lib/phusion_passenger/standalone/app_finder_rb.html +0 -127
- data/doc/rdoc/files/lib/phusion_passenger/standalone/command_rb.html +0 -135
- data/doc/rdoc/files/lib/phusion_passenger/standalone/config_file_rb.html +0 -126
- data/doc/rdoc/files/lib/phusion_passenger/standalone/help_command_rb.html +0 -126
- data/doc/rdoc/files/lib/phusion_passenger/standalone/main_rb.html +0 -126
- data/doc/rdoc/files/lib/phusion_passenger/standalone/package_runtime_command_rb.html +0 -127
- data/doc/rdoc/files/lib/phusion_passenger/standalone/runtime_installer_rb.html +0 -133
- data/doc/rdoc/files/lib/phusion_passenger/standalone/start_command_rb.html +0 -136
- data/doc/rdoc/files/lib/phusion_passenger/standalone/status_command_rb.html +0 -126
- data/doc/rdoc/files/lib/phusion_passenger/standalone/stop_command_rb.html +0 -126
- data/doc/rdoc/files/lib/phusion_passenger/standalone/utils_rb.html +0 -126
- data/doc/rdoc/files/lib/phusion_passenger/standalone/version_command_rb.html +0 -127
- data/doc/rdoc/files/lib/phusion_passenger/utils/file_system_watcher_rb.html +0 -126
- data/doc/rdoc/files/lib/phusion_passenger/utils/hosts_file_parser_rb.html +0 -120
- data/doc/rdoc/files/lib/phusion_passenger/utils/rewindable_input_rb.html +0 -100
- data/doc/rdoc/files/lib/phusion_passenger/utils/tmpdir_rb.html +0 -122
- data/doc/rdoc/files/lib/phusion_passenger/utils/unseekable_socket_rb.html +0 -126
- data/doc/rdoc/files/lib/phusion_passenger/utils_rb.html +0 -179
- data/doc/rdoc/files/lib/phusion_passenger/wsgi/application_spawner_rb.html +0 -132
- data/doc/rdoc/fr_class_index.html +0 -138
- data/doc/rdoc/fr_file_index.html +0 -108
- data/doc/rdoc/fr_method_index.html +0 -430
- data/doc/rdoc/index.html +0 -26
- data/doc/rdoc/rdoc-style.css +0 -187
- data/ext/apache2/LICENSE-CNRI.TXT +0 -79
- data/ext/common/Utils/BlockingScalar.h +0 -50
- data/ext/common/Utils/FileHandleGuard.h +0 -81
|
@@ -1,647 +0,0 @@
|
|
|
1
|
-
<?xml version="1.0" encoding="iso-8859-1"?>
|
|
2
|
-
<!DOCTYPE html
|
|
3
|
-
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
|
|
4
|
-
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
|
5
|
-
<html>
|
|
6
|
-
<head>
|
|
7
|
-
<title>Class: PhusionPassenger::AbstractRequestHandler</title>
|
|
8
|
-
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
|
|
9
|
-
<link rel="stylesheet" href="../.././rdoc-style.css" type="text/css" media="screen" />
|
|
10
|
-
|
|
11
|
-
<script language="JavaScript" type="text/javascript">
|
|
12
|
-
// <![CDATA[
|
|
13
|
-
|
|
14
|
-
function toggleSource( id )
|
|
15
|
-
{
|
|
16
|
-
var elem
|
|
17
|
-
var link
|
|
18
|
-
|
|
19
|
-
if( document.getElementById )
|
|
20
|
-
{
|
|
21
|
-
elem = document.getElementById( id )
|
|
22
|
-
link = document.getElementById( "l_" + id )
|
|
23
|
-
}
|
|
24
|
-
else if ( document.all )
|
|
25
|
-
{
|
|
26
|
-
elem = eval( "document.all." + id )
|
|
27
|
-
link = eval( "document.all.l_" + id )
|
|
28
|
-
}
|
|
29
|
-
else
|
|
30
|
-
return false;
|
|
31
|
-
|
|
32
|
-
if( elem.style.display == "block" )
|
|
33
|
-
{
|
|
34
|
-
elem.style.display = "none"
|
|
35
|
-
link.innerHTML = "show source"
|
|
36
|
-
}
|
|
37
|
-
else
|
|
38
|
-
{
|
|
39
|
-
elem.style.display = "block"
|
|
40
|
-
link.innerHTML = "hide source"
|
|
41
|
-
}
|
|
42
|
-
}
|
|
43
|
-
|
|
44
|
-
function openCode( url )
|
|
45
|
-
{
|
|
46
|
-
window.open( url, "SOURCE_CODE", "resizable=yes,scrollbars=yes,toolbar=no,status=no,height=480,width=750" ).focus();
|
|
47
|
-
}
|
|
48
|
-
// ]]>
|
|
49
|
-
</script>
|
|
50
|
-
</head>
|
|
51
|
-
|
|
52
|
-
<body>
|
|
53
|
-
<table width="100%" border='0' cellpadding='0' cellspacing='0' class='banner'><tr>
|
|
54
|
-
<td class="file-title"><span class="file-title-prefix">Class</span><br />PhusionPassenger::AbstractRequestHandler</td>
|
|
55
|
-
<td align="right">
|
|
56
|
-
<table cellspacing="0" cellpadding="2">
|
|
57
|
-
<tr valign="top">
|
|
58
|
-
<td>In:</td>
|
|
59
|
-
<td>
|
|
60
|
-
<a href="../../files/lib/phusion_passenger/abstract_request_handler_rb.html">lib/phusion_passenger/abstract_request_handler.rb</a>
|
|
61
|
-
</td>
|
|
62
|
-
</tr>
|
|
63
|
-
<tr>
|
|
64
|
-
<td>Parent:</td>
|
|
65
|
-
<td>
|
|
66
|
-
Object
|
|
67
|
-
</td>
|
|
68
|
-
</tr>
|
|
69
|
-
</table>
|
|
70
|
-
</td>
|
|
71
|
-
</tr>
|
|
72
|
-
</table>
|
|
73
|
-
<!-- banner header -->
|
|
74
|
-
|
|
75
|
-
<div id="bodyContent">
|
|
76
|
-
<div id="content">
|
|
77
|
-
|
|
78
|
-
<div class="description"><p>
|
|
79
|
-
The request handler is the layer which connects Apache with the underlying
|
|
80
|
-
application‘s request dispatcher (i.e. either Rails‘s
|
|
81
|
-
Dispatcher class or <a href="Rack.html">Rack</a>). The request
|
|
82
|
-
handler‘s job is to process incoming HTTP requests using the
|
|
83
|
-
currently loaded Ruby on Rails application. HTTP requests are forwarded to
|
|
84
|
-
the request handler by the web server. HTTP responses generated by the RoR
|
|
85
|
-
application are forwarded to the web server, which, in turn, sends the
|
|
86
|
-
response back to the HTTP client.
|
|
87
|
-
</p>
|
|
88
|
-
<p>
|
|
89
|
-
<a href="AbstractRequestHandler.html">AbstractRequestHandler</a> is an
|
|
90
|
-
abstract base class for easing the implementation of request handlers for
|
|
91
|
-
Rails and <a href="Rack.html">Rack</a>.
|
|
92
|
-
</p>
|
|
93
|
-
<h2>Design decisions</h2>
|
|
94
|
-
<p>
|
|
95
|
-
Some design decisions are made because we want to decrease system
|
|
96
|
-
administrator maintenance overhead. These decisions are documented in this
|
|
97
|
-
section.
|
|
98
|
-
</p>
|
|
99
|
-
<h3>Owner pipes</h3>
|
|
100
|
-
<p>
|
|
101
|
-
Because only the web server communicates directly with a request handler,
|
|
102
|
-
we want the request handler to exit if the web server has also exited. This
|
|
103
|
-
is implemented by using a so-called _owner pipe_. The writable part of the
|
|
104
|
-
pipe will be passed to the web server* via a Unix socket, and the web
|
|
105
|
-
server will own that part of the pipe, while <a
|
|
106
|
-
href="AbstractRequestHandler.html">AbstractRequestHandler</a> owns the
|
|
107
|
-
readable part of the pipe. <a
|
|
108
|
-
href="AbstractRequestHandler.html">AbstractRequestHandler</a> will
|
|
109
|
-
continuously check whether the other side of the pipe has been closed. If
|
|
110
|
-
so, then it knows that the web server has exited, and so the request
|
|
111
|
-
handler will exit as well. This works even if the web server gets killed by
|
|
112
|
-
SIGKILL.
|
|
113
|
-
</p>
|
|
114
|
-
<ul>
|
|
115
|
-
<li>It might also be passed to the ApplicationPoolServerExecutable, if the web
|
|
116
|
-
server‘s using ApplicationPoolServer instead of
|
|
117
|
-
StandardApplicationPool.
|
|
118
|
-
|
|
119
|
-
</li>
|
|
120
|
-
</ul>
|
|
121
|
-
<h2>Request format</h2>
|
|
122
|
-
<p>
|
|
123
|
-
Incoming "HTTP requests" are not true HTTP requests, i.e. their
|
|
124
|
-
binary representation do not conform to RFC 2616. Instead, the request
|
|
125
|
-
format is based on CGI, and is similar to that of SCGI.
|
|
126
|
-
</p>
|
|
127
|
-
<p>
|
|
128
|
-
The format consists of 3 parts:
|
|
129
|
-
</p>
|
|
130
|
-
<ul>
|
|
131
|
-
<li>A 32-bit big-endian integer, containing the size of the transformed
|
|
132
|
-
headers.
|
|
133
|
-
|
|
134
|
-
</li>
|
|
135
|
-
<li>The transformed HTTP headers.
|
|
136
|
-
|
|
137
|
-
</li>
|
|
138
|
-
<li>The verbatim (untransformed) HTTP request body.
|
|
139
|
-
|
|
140
|
-
</li>
|
|
141
|
-
</ul>
|
|
142
|
-
<p>
|
|
143
|
-
HTTP headers are transformed to a format that satisfies the following
|
|
144
|
-
grammar:
|
|
145
|
-
</p>
|
|
146
|
-
<pre>
|
|
147
|
-
headers ::= header*
|
|
148
|
-
header ::= name NUL value NUL
|
|
149
|
-
name ::= notnull+
|
|
150
|
-
value ::= notnull+
|
|
151
|
-
notnull ::= "\x01" | "\x02" | "\x02" | ... | "\xFF"
|
|
152
|
-
NUL = "\x00"
|
|
153
|
-
</pre>
|
|
154
|
-
<p>
|
|
155
|
-
The web server transforms the HTTP request to the aforementioned format,
|
|
156
|
-
and sends it to the request handler.
|
|
157
|
-
</p>
|
|
158
|
-
</div>
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
<div class="sectiontitle">Methods</div>
|
|
163
|
-
<ul>
|
|
164
|
-
<li><a href="#M000338">cleanup</a></li>
|
|
165
|
-
<li><a href="#M000340">main_loop</a></li>
|
|
166
|
-
<li><a href="#M000339">main_loop_running?</a></li>
|
|
167
|
-
<li><a href="#M000337">new</a></li>
|
|
168
|
-
<li><a href="#M000342">soft_shutdown</a></li>
|
|
169
|
-
<li><a href="#M000341">start_main_loop_thread</a></li>
|
|
170
|
-
</ul>
|
|
171
|
-
|
|
172
|
-
<div class="sectiontitle">Included Modules</div>
|
|
173
|
-
<ul>
|
|
174
|
-
<li><a href="DebugLogging.html">DebugLogging</a></li>
|
|
175
|
-
<li><a href="Utils.html">Utils</a></li>
|
|
176
|
-
</ul>
|
|
177
|
-
|
|
178
|
-
|
|
179
|
-
|
|
180
|
-
<div class="sectiontitle">Constants</div>
|
|
181
|
-
<table border='0' cellpadding='5'>
|
|
182
|
-
<tr valign='top'>
|
|
183
|
-
<td class="attr-name">HARD_TERMINATION_SIGNAL</td>
|
|
184
|
-
<td>=</td>
|
|
185
|
-
<td class="attr-value">"SIGTERM"</td>
|
|
186
|
-
</tr>
|
|
187
|
-
<tr valign='top'>
|
|
188
|
-
<td> </td>
|
|
189
|
-
<td colspan="2" class="attr-desc">
|
|
190
|
-
<a href="../Signal.html">Signal</a> which will cause the Rails application
|
|
191
|
-
to exit immediately.
|
|
192
|
-
|
|
193
|
-
</td>
|
|
194
|
-
</tr>
|
|
195
|
-
<tr valign='top'>
|
|
196
|
-
<td class="attr-name">SOFT_TERMINATION_SIGNAL</td>
|
|
197
|
-
<td>=</td>
|
|
198
|
-
<td class="attr-value">"SIGUSR1"</td>
|
|
199
|
-
</tr>
|
|
200
|
-
<tr valign='top'>
|
|
201
|
-
<td> </td>
|
|
202
|
-
<td colspan="2" class="attr-desc">
|
|
203
|
-
<a href="../Signal.html">Signal</a> which will cause the Rails application
|
|
204
|
-
to exit as soon as it‘s done processing a request.
|
|
205
|
-
|
|
206
|
-
</td>
|
|
207
|
-
</tr>
|
|
208
|
-
<tr valign='top'>
|
|
209
|
-
<td class="attr-name">BACKLOG_SIZE</td>
|
|
210
|
-
<td>=</td>
|
|
211
|
-
<td class="attr-value">500</td>
|
|
212
|
-
</tr>
|
|
213
|
-
<tr valign='top'>
|
|
214
|
-
<td class="attr-name">MAX_HEADER_SIZE</td>
|
|
215
|
-
<td>=</td>
|
|
216
|
-
<td class="attr-value">128 * 1024</td>
|
|
217
|
-
</tr>
|
|
218
|
-
<tr valign='top'>
|
|
219
|
-
<td class="attr-name">OBJECT_SPACE_SUPPORTS_LIVE_OBJECTS</td>
|
|
220
|
-
<td>=</td>
|
|
221
|
-
<td class="attr-value">ObjectSpace.respond_to?(:live_objects)</td>
|
|
222
|
-
</tr>
|
|
223
|
-
<tr valign='top'>
|
|
224
|
-
<td class="attr-name">OBJECT_SPACE_SUPPORTS_ALLOCATED_OBJECTS</td>
|
|
225
|
-
<td>=</td>
|
|
226
|
-
<td class="attr-value">ObjectSpace.respond_to?(:allocated_objects)</td>
|
|
227
|
-
</tr>
|
|
228
|
-
<tr valign='top'>
|
|
229
|
-
<td class="attr-name">OBJECT_SPACE_SUPPORTS_COUNT_OBJECTS</td>
|
|
230
|
-
<td>=</td>
|
|
231
|
-
<td class="attr-value">ObjectSpace.respond_to?(:count_objects)</td>
|
|
232
|
-
</tr>
|
|
233
|
-
<tr valign='top'>
|
|
234
|
-
<td class="attr-name">GC_SUPPORTS_TIME</td>
|
|
235
|
-
<td>=</td>
|
|
236
|
-
<td class="attr-value">GC.respond_to?(:time)</td>
|
|
237
|
-
</tr>
|
|
238
|
-
<tr valign='top'>
|
|
239
|
-
<td class="attr-name">GC_SUPPORTS_CLEAR_STATS</td>
|
|
240
|
-
<td>=</td>
|
|
241
|
-
<td class="attr-value">GC.respond_to?(:clear_stats)</td>
|
|
242
|
-
</tr>
|
|
243
|
-
</table>
|
|
244
|
-
|
|
245
|
-
<div class="sectiontitle">Attributes</div>
|
|
246
|
-
<table border='0' cellpadding='5'>
|
|
247
|
-
<tr valign='top'>
|
|
248
|
-
<td class='attr-rw'>
|
|
249
|
-
[RW]
|
|
250
|
-
</td>
|
|
251
|
-
<td class='attr-name'>connect_password</td>
|
|
252
|
-
<td class='attr-desc'>
|
|
253
|
-
A password with which clients must authenticate. Default is
|
|
254
|
-
unauthenticated.
|
|
255
|
-
|
|
256
|
-
</td>
|
|
257
|
-
</tr>
|
|
258
|
-
<tr valign='top'>
|
|
259
|
-
<td class='attr-rw'>
|
|
260
|
-
[R]
|
|
261
|
-
</td>
|
|
262
|
-
<td class='attr-name'>iterations</td>
|
|
263
|
-
<td class='attr-desc'>
|
|
264
|
-
The number of times the main loop has iterated so far. Mostly useful for
|
|
265
|
-
unit test assertions.
|
|
266
|
-
|
|
267
|
-
</td>
|
|
268
|
-
</tr>
|
|
269
|
-
<tr valign='top'>
|
|
270
|
-
<td class='attr-rw'>
|
|
271
|
-
[RW]
|
|
272
|
-
</td>
|
|
273
|
-
<td class='attr-name'>memory_limit</td>
|
|
274
|
-
<td class='attr-desc'>
|
|
275
|
-
Specifies the maximum allowed memory usage, in MB. If after having
|
|
276
|
-
processed a request <a
|
|
277
|
-
href="AbstractRequestHandler.html">AbstractRequestHandler</a> detects that
|
|
278
|
-
memory usage has risen above this limit, then it will gracefully exit (that
|
|
279
|
-
is, exit after having processed all pending requests).
|
|
280
|
-
|
|
281
|
-
<p>
|
|
282
|
-
A value of 0 (the default) indicates that there‘s no limit.
|
|
283
|
-
</p>
|
|
284
|
-
</td>
|
|
285
|
-
</tr>
|
|
286
|
-
<tr valign='top'>
|
|
287
|
-
<td class='attr-rw'>
|
|
288
|
-
[R]
|
|
289
|
-
</td>
|
|
290
|
-
<td class='attr-name'>processed_requests</td>
|
|
291
|
-
<td class='attr-desc'>
|
|
292
|
-
Number of requests processed so far. This includes requests that raised
|
|
293
|
-
exceptions.
|
|
294
|
-
|
|
295
|
-
</td>
|
|
296
|
-
</tr>
|
|
297
|
-
<tr valign='top'>
|
|
298
|
-
<td class='attr-rw'>
|
|
299
|
-
[R]
|
|
300
|
-
</td>
|
|
301
|
-
<td class='attr-name'>server_sockets</td>
|
|
302
|
-
<td class='attr-desc'>
|
|
303
|
-
A hash containing all server sockets that this request handler listens on.
|
|
304
|
-
The hash is in the form of:
|
|
305
|
-
|
|
306
|
-
<pre>
|
|
307
|
-
{
|
|
308
|
-
name1 => [socket_address1, socket_type1, socket1],
|
|
309
|
-
name2 => [socket_address2, socket_type2, socket2],
|
|
310
|
-
...
|
|
311
|
-
}
|
|
312
|
-
</pre>
|
|
313
|
-
<p>
|
|
314
|
-
<tt>name</tt> is a Symbol. <tt>socket_addressx</tt> is the address of the
|
|
315
|
-
socket, <tt>socket_typex</tt> is the socket‘s type (either
|
|
316
|
-
‘unix’ or ‘tcp’) and <tt>socketx</tt> is the actual
|
|
317
|
-
socket <a href="../IO.html">IO</a> objec. There‘s guaranteed to be at
|
|
318
|
-
least one server socket, namely one with the name +:main+.
|
|
319
|
-
</p>
|
|
320
|
-
</td>
|
|
321
|
-
</tr>
|
|
322
|
-
<tr valign='top'>
|
|
323
|
-
<td class='attr-rw'>
|
|
324
|
-
[RW]
|
|
325
|
-
</td>
|
|
326
|
-
<td class='attr-name'>soft_termination_linger_time</td>
|
|
327
|
-
<td class='attr-desc'>
|
|
328
|
-
If a soft termination signal was received, then the main loop will quit the
|
|
329
|
-
given amount of seconds after the last time a connection was accepted.
|
|
330
|
-
Defaults to 3 seconds.
|
|
331
|
-
|
|
332
|
-
</td>
|
|
333
|
-
</tr>
|
|
334
|
-
</table>
|
|
335
|
-
|
|
336
|
-
<div class="sectiontitle">Public Class methods</div>
|
|
337
|
-
<div class="method">
|
|
338
|
-
<div class="title">
|
|
339
|
-
<a name="M000337"></a><b>new</b>(owner_pipe, options = {})
|
|
340
|
-
</div>
|
|
341
|
-
<div class="description">
|
|
342
|
-
<p>
|
|
343
|
-
Create a <a href="AbstractRequestHandler.html#M000337">new</a>
|
|
344
|
-
RequestHandler with the given owner pipe. <tt>owner_pipe</tt> must be the
|
|
345
|
-
readable part of a pipe <a href="../IO.html">IO</a> object.
|
|
346
|
-
</p>
|
|
347
|
-
<p>
|
|
348
|
-
Additionally, the following options may be given:
|
|
349
|
-
</p>
|
|
350
|
-
<ul>
|
|
351
|
-
<li>memory_limit: Used to set the <tt>memory_limit</tt> attribute.
|
|
352
|
-
|
|
353
|
-
</li>
|
|
354
|
-
<li>detach_key
|
|
355
|
-
|
|
356
|
-
</li>
|
|
357
|
-
<li>connect_password
|
|
358
|
-
|
|
359
|
-
</li>
|
|
360
|
-
<li>pool_account_username
|
|
361
|
-
|
|
362
|
-
</li>
|
|
363
|
-
<li>pool_account_password_base64
|
|
364
|
-
|
|
365
|
-
</li>
|
|
366
|
-
</ul>
|
|
367
|
-
</div>
|
|
368
|
-
<div class="sourcecode">
|
|
369
|
-
<p class="source-link">[ <a href="javascript:toggleSource('M000337_source')" id="l_M000337_source">show source</a> ]</p>
|
|
370
|
-
<div id="M000337_source" class="dyn-source">
|
|
371
|
-
<pre>
|
|
372
|
-
<span class="ruby-comment cmt"># File lib/phusion_passenger/abstract_request_handler.rb, line 170</span>
|
|
373
|
-
170: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-identifier">owner_pipe</span>, <span class="ruby-identifier">options</span> = {})
|
|
374
|
-
171: <span class="ruby-ivar">@server_sockets</span> = {}
|
|
375
|
-
172:
|
|
376
|
-
173: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">should_use_unix_sockets?</span>
|
|
377
|
-
174: <span class="ruby-ivar">@main_socket_address</span>, <span class="ruby-ivar">@main_socket</span> = <span class="ruby-identifier">create_unix_socket_on_filesystem</span>
|
|
378
|
-
175: <span class="ruby-ivar">@server_sockets</span>[<span class="ruby-identifier">:main</span>] = [<span class="ruby-ivar">@main_socket_address</span>, <span class="ruby-value str">'unix'</span>, <span class="ruby-ivar">@main_socket</span>]
|
|
379
|
-
176: <span class="ruby-keyword kw">else</span>
|
|
380
|
-
177: <span class="ruby-ivar">@main_socket_address</span>, <span class="ruby-ivar">@main_socket</span> = <span class="ruby-identifier">create_tcp_socket</span>
|
|
381
|
-
178: <span class="ruby-ivar">@server_sockets</span>[<span class="ruby-identifier">:main</span>] = [<span class="ruby-ivar">@main_socket_address</span>, <span class="ruby-value str">'tcp'</span>, <span class="ruby-ivar">@main_socket</span>]
|
|
382
|
-
179: <span class="ruby-keyword kw">end</span>
|
|
383
|
-
180:
|
|
384
|
-
181: <span class="ruby-ivar">@http_socket_address</span>, <span class="ruby-ivar">@http_socket</span> = <span class="ruby-identifier">create_tcp_socket</span>
|
|
385
|
-
182: <span class="ruby-ivar">@server_sockets</span>[<span class="ruby-identifier">:http</span>] = [<span class="ruby-ivar">@http_socket_address</span>, <span class="ruby-value str">'tcp'</span>, <span class="ruby-ivar">@http_socket</span>]
|
|
386
|
-
183:
|
|
387
|
-
184: <span class="ruby-ivar">@owner_pipe</span> = <span class="ruby-identifier">owner_pipe</span>
|
|
388
|
-
185: <span class="ruby-ivar">@options</span> = <span class="ruby-identifier">options</span>
|
|
389
|
-
186: <span class="ruby-ivar">@previous_signal_handlers</span> = {}
|
|
390
|
-
187: <span class="ruby-ivar">@main_loop_generation</span> = <span class="ruby-value">0</span>
|
|
391
|
-
188: <span class="ruby-ivar">@main_loop_thread_lock</span> = <span class="ruby-constant">Mutex</span>.<span class="ruby-identifier">new</span>
|
|
392
|
-
189: <span class="ruby-ivar">@main_loop_thread_cond</span> = <span class="ruby-constant">ConditionVariable</span>.<span class="ruby-identifier">new</span>
|
|
393
|
-
190: <span class="ruby-ivar">@memory_limit</span> = <span class="ruby-identifier">options</span>[<span class="ruby-value str">"memory_limit"</span>] <span class="ruby-operator">||</span> <span class="ruby-value">0</span>
|
|
394
|
-
191: <span class="ruby-ivar">@connect_password</span> = <span class="ruby-identifier">options</span>[<span class="ruby-value str">"connect_password"</span>]
|
|
395
|
-
192: <span class="ruby-ivar">@detach_key</span> = <span class="ruby-identifier">options</span>[<span class="ruby-value str">"detach_key"</span>]
|
|
396
|
-
193: <span class="ruby-ivar">@pool_account_username</span> = <span class="ruby-identifier">options</span>[<span class="ruby-value str">"pool_account_username"</span>]
|
|
397
|
-
194: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">options</span>[<span class="ruby-value str">"pool_account_password_base64"</span>]
|
|
398
|
-
195: <span class="ruby-ivar">@pool_account_password</span> = <span class="ruby-identifier">options</span>[<span class="ruby-value str">"pool_account_password_base64"</span>].<span class="ruby-identifier">unpack</span>(<span class="ruby-value str">'m'</span>).<span class="ruby-identifier">first</span>
|
|
399
|
-
196: <span class="ruby-keyword kw">end</span>
|
|
400
|
-
197: <span class="ruby-ivar">@analytics_logger</span> = <span class="ruby-identifier">options</span>[<span class="ruby-value str">"analytics_logger"</span>]
|
|
401
|
-
198: <span class="ruby-ivar">@iterations</span> = <span class="ruby-value">0</span>
|
|
402
|
-
199: <span class="ruby-ivar">@processed_requests</span> = <span class="ruby-value">0</span>
|
|
403
|
-
200: <span class="ruby-ivar">@soft_termination_linger_time</span> = <span class="ruby-value">3</span>
|
|
404
|
-
201: <span class="ruby-ivar">@main_loop_running</span> = <span class="ruby-keyword kw">false</span>
|
|
405
|
-
202: <span class="ruby-ivar">@passenger_header</span> = <span class="ruby-identifier">determine_passenger_header</span>
|
|
406
|
-
203:
|
|
407
|
-
204: <span class="ruby-ivar">@debugger</span> = <span class="ruby-ivar">@options</span>[<span class="ruby-value str">"debugger"</span>]
|
|
408
|
-
205: <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@debugger</span>
|
|
409
|
-
206: <span class="ruby-ivar">@server_sockets</span>[<span class="ruby-identifier">:ruby_debug_cmd</span>] = [<span class="ruby-node">"127.0.0.1:#{Debugger.cmd_port}"</span>, <span class="ruby-value str">'tcp'</span>]
|
|
410
|
-
207: <span class="ruby-ivar">@server_sockets</span>[<span class="ruby-identifier">:ruby_debug_ctrl</span>] = [<span class="ruby-node">"127.0.0.1:#{Debugger.ctrl_port}"</span>, <span class="ruby-value str">'tcp'</span>]
|
|
411
|
-
208: <span class="ruby-keyword kw">end</span>
|
|
412
|
-
209:
|
|
413
|
-
210: <span class="ruby-comment cmt">#############</span>
|
|
414
|
-
211: <span class="ruby-keyword kw">end</span>
|
|
415
|
-
</pre>
|
|
416
|
-
</div>
|
|
417
|
-
</div>
|
|
418
|
-
</div>
|
|
419
|
-
<div class="sectiontitle">Public Instance methods</div>
|
|
420
|
-
<div class="method">
|
|
421
|
-
<div class="title">
|
|
422
|
-
<a name="M000338"></a><b>cleanup</b>()
|
|
423
|
-
</div>
|
|
424
|
-
<div class="description">
|
|
425
|
-
<p>
|
|
426
|
-
Clean up temporary stuff created by the request handler.
|
|
427
|
-
</p>
|
|
428
|
-
<p>
|
|
429
|
-
If the main loop was started by <a
|
|
430
|
-
href="AbstractRequestHandler.html#M000340">#main_loop</a>, then this method
|
|
431
|
-
may only be called after the main loop has exited.
|
|
432
|
-
</p>
|
|
433
|
-
<p>
|
|
434
|
-
If the main loop was started by <a
|
|
435
|
-
href="AbstractRequestHandler.html#M000341">#start_main_loop_thread</a>,
|
|
436
|
-
then this method may be called at any time, and it will stop the main loop
|
|
437
|
-
thread.
|
|
438
|
-
</p>
|
|
439
|
-
</div>
|
|
440
|
-
<div class="sourcecode">
|
|
441
|
-
<p class="source-link">[ <a href="javascript:toggleSource('M000338_source')" id="l_M000338_source">show source</a> ]</p>
|
|
442
|
-
<div id="M000338_source" class="dyn-source">
|
|
443
|
-
<pre>
|
|
444
|
-
<span class="ruby-comment cmt"># File lib/phusion_passenger/abstract_request_handler.rb, line 220</span>
|
|
445
|
-
220: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">cleanup</span>
|
|
446
|
-
221: <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@main_loop_thread</span>
|
|
447
|
-
222: <span class="ruby-ivar">@main_loop_thread_lock</span>.<span class="ruby-identifier">synchronize</span> <span class="ruby-keyword kw">do</span>
|
|
448
|
-
223: <span class="ruby-ivar">@graceful_termination_pipe</span>[<span class="ruby-value">1</span>].<span class="ruby-identifier">close</span> <span class="ruby-keyword kw">rescue</span> <span class="ruby-keyword kw">nil</span>
|
|
449
|
-
224: <span class="ruby-keyword kw">end</span>
|
|
450
|
-
225: <span class="ruby-ivar">@main_loop_thread</span>.<span class="ruby-identifier">join</span>
|
|
451
|
-
226: <span class="ruby-keyword kw">end</span>
|
|
452
|
-
227: <span class="ruby-ivar">@server_sockets</span>.<span class="ruby-identifier">each_value</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">value</span><span class="ruby-operator">|</span>
|
|
453
|
-
228: <span class="ruby-identifier">address</span>, <span class="ruby-identifier">type</span>, <span class="ruby-identifier">socket</span> = <span class="ruby-identifier">value</span>
|
|
454
|
-
229: <span class="ruby-identifier">socket</span>.<span class="ruby-identifier">close</span> <span class="ruby-keyword kw">rescue</span> <span class="ruby-keyword kw">nil</span>
|
|
455
|
-
230: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">type</span> <span class="ruby-operator">==</span> <span class="ruby-value str">'unix'</span>
|
|
456
|
-
231: <span class="ruby-constant">File</span>.<span class="ruby-identifier">unlink</span>(<span class="ruby-identifier">address</span>) <span class="ruby-keyword kw">rescue</span> <span class="ruby-keyword kw">nil</span>
|
|
457
|
-
232: <span class="ruby-keyword kw">end</span>
|
|
458
|
-
233: <span class="ruby-keyword kw">end</span>
|
|
459
|
-
234: <span class="ruby-ivar">@owner_pipe</span>.<span class="ruby-identifier">close</span> <span class="ruby-keyword kw">rescue</span> <span class="ruby-keyword kw">nil</span>
|
|
460
|
-
235: <span class="ruby-keyword kw">end</span>
|
|
461
|
-
</pre>
|
|
462
|
-
</div>
|
|
463
|
-
</div>
|
|
464
|
-
</div>
|
|
465
|
-
<div class="method">
|
|
466
|
-
<div class="title">
|
|
467
|
-
<a name="M000340"></a><b>main_loop</b>()
|
|
468
|
-
</div>
|
|
469
|
-
<div class="description">
|
|
470
|
-
<p>
|
|
471
|
-
Enter the request handler‘s main loop.
|
|
472
|
-
</p>
|
|
473
|
-
</div>
|
|
474
|
-
<div class="sourcecode">
|
|
475
|
-
<p class="source-link">[ <a href="javascript:toggleSource('M000340_source')" id="l_M000340_source">show source</a> ]</p>
|
|
476
|
-
<div id="M000340_source" class="dyn-source">
|
|
477
|
-
<pre>
|
|
478
|
-
<span class="ruby-comment cmt"># File lib/phusion_passenger/abstract_request_handler.rb, line 243</span>
|
|
479
|
-
243: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">main_loop</span>
|
|
480
|
-
244: <span class="ruby-identifier">debug</span>(<span class="ruby-value str">"Entering request handler main loop"</span>)
|
|
481
|
-
245: <span class="ruby-identifier">reset_signal_handlers</span>
|
|
482
|
-
246: <span class="ruby-keyword kw">begin</span>
|
|
483
|
-
247: <span class="ruby-ivar">@graceful_termination_pipe</span> = <span class="ruby-constant">IO</span>.<span class="ruby-identifier">pipe</span>
|
|
484
|
-
248: <span class="ruby-ivar">@graceful_termination_pipe</span>[<span class="ruby-value">0</span>].<span class="ruby-identifier">close_on_exec!</span>
|
|
485
|
-
249: <span class="ruby-ivar">@graceful_termination_pipe</span>[<span class="ruby-value">1</span>].<span class="ruby-identifier">close_on_exec!</span>
|
|
486
|
-
250:
|
|
487
|
-
251: <span class="ruby-ivar">@main_loop_thread_lock</span>.<span class="ruby-identifier">synchronize</span> <span class="ruby-keyword kw">do</span>
|
|
488
|
-
252: <span class="ruby-ivar">@main_loop_generation</span> <span class="ruby-operator">+=</span> <span class="ruby-value">1</span>
|
|
489
|
-
253: <span class="ruby-ivar">@main_loop_running</span> = <span class="ruby-keyword kw">true</span>
|
|
490
|
-
254: <span class="ruby-ivar">@main_loop_thread_cond</span>.<span class="ruby-identifier">broadcast</span>
|
|
491
|
-
255:
|
|
492
|
-
256: <span class="ruby-ivar">@select_timeout</span> = <span class="ruby-keyword kw">nil</span>
|
|
493
|
-
257:
|
|
494
|
-
258: <span class="ruby-ivar">@selectable_sockets</span> = []
|
|
495
|
-
259: <span class="ruby-ivar">@server_sockets</span>.<span class="ruby-identifier">each_value</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">value</span><span class="ruby-operator">|</span>
|
|
496
|
-
260: <span class="ruby-identifier">socket</span> = <span class="ruby-identifier">value</span>[<span class="ruby-value">2</span>]
|
|
497
|
-
261: <span class="ruby-ivar">@selectable_sockets</span> <span class="ruby-operator"><<</span> <span class="ruby-identifier">socket</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">socket</span>
|
|
498
|
-
262: <span class="ruby-keyword kw">end</span>
|
|
499
|
-
263: <span class="ruby-ivar">@selectable_sockets</span> <span class="ruby-operator"><<</span> <span class="ruby-ivar">@owner_pipe</span>
|
|
500
|
-
264: <span class="ruby-ivar">@selectable_sockets</span> <span class="ruby-operator"><<</span> <span class="ruby-ivar">@graceful_termination_pipe</span>[<span class="ruby-value">0</span>]
|
|
501
|
-
265: <span class="ruby-keyword kw">end</span>
|
|
502
|
-
266:
|
|
503
|
-
267: <span class="ruby-identifier">install_useful_signal_handlers</span>
|
|
504
|
-
268: <span class="ruby-identifier">socket_wrapper</span> = <span class="ruby-constant">Utils</span><span class="ruby-operator">::</span><span class="ruby-constant">UnseekableSocket</span>.<span class="ruby-identifier">new</span>
|
|
505
|
-
269: <span class="ruby-identifier">channel</span> = <span class="ruby-constant">MessageChannel</span>.<span class="ruby-identifier">new</span>
|
|
506
|
-
270: <span class="ruby-identifier">buffer</span> = <span class="ruby-value str">''</span>
|
|
507
|
-
271:
|
|
508
|
-
272: <span class="ruby-keyword kw">while</span> <span class="ruby-keyword kw">true</span>
|
|
509
|
-
273: <span class="ruby-ivar">@iterations</span> <span class="ruby-operator">+=</span> <span class="ruby-value">1</span>
|
|
510
|
-
274: <span class="ruby-keyword kw">if</span> <span class="ruby-operator">!</span><span class="ruby-identifier">accept_and_process_next_request</span>(<span class="ruby-identifier">socket_wrapper</span>, <span class="ruby-identifier">channel</span>, <span class="ruby-identifier">buffer</span>)
|
|
511
|
-
275: <span class="ruby-identifier">trace</span>(<span class="ruby-value">2</span>, <span class="ruby-value str">"Request handler main loop exited normally"</span>)
|
|
512
|
-
276: <span class="ruby-keyword kw">break</span>
|
|
513
|
-
277: <span class="ruby-keyword kw">end</span>
|
|
514
|
-
278: <span class="ruby-ivar">@processed_requests</span> <span class="ruby-operator">+=</span> <span class="ruby-value">1</span>
|
|
515
|
-
279: <span class="ruby-keyword kw">end</span>
|
|
516
|
-
280: <span class="ruby-keyword kw">rescue</span> <span class="ruby-constant">EOFError</span>
|
|
517
|
-
281: <span class="ruby-comment cmt"># Exit main loop.</span>
|
|
518
|
-
282: <span class="ruby-identifier">trace</span>(<span class="ruby-value">2</span>, <span class="ruby-value str">"Request handler main loop interrupted by EOFError exception"</span>)
|
|
519
|
-
283: <span class="ruby-keyword kw">rescue</span> <span class="ruby-constant">Interrupt</span>
|
|
520
|
-
284: <span class="ruby-comment cmt"># Exit main loop.</span>
|
|
521
|
-
285: <span class="ruby-identifier">trace</span>(<span class="ruby-value">2</span>, <span class="ruby-value str">"Request handler main loop interrupted by Interrupt exception"</span>)
|
|
522
|
-
286: <span class="ruby-keyword kw">rescue</span> <span class="ruby-constant">SignalException</span> =<span class="ruby-operator">></span> <span class="ruby-identifier">signal</span>
|
|
523
|
-
287: <span class="ruby-identifier">trace</span>(<span class="ruby-value">2</span>, <span class="ruby-value str">"Request handler main loop interrupted by SignalException"</span>)
|
|
524
|
-
288: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">signal</span>.<span class="ruby-identifier">message</span> <span class="ruby-operator">!=</span> <span class="ruby-constant">HARD_TERMINATION_SIGNAL</span> <span class="ruby-operator">&&</span>
|
|
525
|
-
289: <span class="ruby-identifier">signal</span>.<span class="ruby-identifier">message</span> <span class="ruby-operator">!=</span> <span class="ruby-constant">SOFT_TERMINATION_SIGNAL</span>
|
|
526
|
-
290: <span class="ruby-identifier">raise</span>
|
|
527
|
-
291: <span class="ruby-keyword kw">end</span>
|
|
528
|
-
292: <span class="ruby-keyword kw">rescue</span> <span class="ruby-constant">Exception</span> =<span class="ruby-operator">></span> <span class="ruby-identifier">e</span>
|
|
529
|
-
293: <span class="ruby-identifier">trace</span>(<span class="ruby-value">2</span>, <span class="ruby-node">"Request handler main loop interrupted by #{e.class} exception"</span>)
|
|
530
|
-
294: <span class="ruby-identifier">raise</span>
|
|
531
|
-
295: <span class="ruby-keyword kw">ensure</span>
|
|
532
|
-
296: <span class="ruby-identifier">debug</span>(<span class="ruby-value str">"Exiting request handler main loop"</span>)
|
|
533
|
-
297: <span class="ruby-identifier">revert_signal_handlers</span>
|
|
534
|
-
298: <span class="ruby-ivar">@main_loop_thread_lock</span>.<span class="ruby-identifier">synchronize</span> <span class="ruby-keyword kw">do</span>
|
|
535
|
-
299: <span class="ruby-ivar">@graceful_termination_pipe</span>[<span class="ruby-value">1</span>].<span class="ruby-identifier">close</span> <span class="ruby-keyword kw">rescue</span> <span class="ruby-keyword kw">nil</span>
|
|
536
|
-
300: <span class="ruby-ivar">@graceful_termination_pipe</span>[<span class="ruby-value">0</span>].<span class="ruby-identifier">close</span> <span class="ruby-keyword kw">rescue</span> <span class="ruby-keyword kw">nil</span>
|
|
537
|
-
301: <span class="ruby-ivar">@selectable_sockets</span> = []
|
|
538
|
-
302: <span class="ruby-ivar">@main_loop_generation</span> <span class="ruby-operator">+=</span> <span class="ruby-value">1</span>
|
|
539
|
-
303: <span class="ruby-ivar">@main_loop_running</span> = <span class="ruby-keyword kw">false</span>
|
|
540
|
-
304: <span class="ruby-ivar">@main_loop_thread_cond</span>.<span class="ruby-identifier">broadcast</span>
|
|
541
|
-
305: <span class="ruby-keyword kw">end</span>
|
|
542
|
-
306: <span class="ruby-keyword kw">end</span>
|
|
543
|
-
307: <span class="ruby-keyword kw">end</span>
|
|
544
|
-
</pre>
|
|
545
|
-
</div>
|
|
546
|
-
</div>
|
|
547
|
-
</div>
|
|
548
|
-
<div class="method">
|
|
549
|
-
<div class="title">
|
|
550
|
-
<a name="M000339"></a><b>main_loop_running?</b>()
|
|
551
|
-
</div>
|
|
552
|
-
<div class="description">
|
|
553
|
-
<p>
|
|
554
|
-
Check whether the main loop‘s currently running.
|
|
555
|
-
</p>
|
|
556
|
-
</div>
|
|
557
|
-
<div class="sourcecode">
|
|
558
|
-
<p class="source-link">[ <a href="javascript:toggleSource('M000339_source')" id="l_M000339_source">show source</a> ]</p>
|
|
559
|
-
<div id="M000339_source" class="dyn-source">
|
|
560
|
-
<pre>
|
|
561
|
-
<span class="ruby-comment cmt"># File lib/phusion_passenger/abstract_request_handler.rb, line 238</span>
|
|
562
|
-
238: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">main_loop_running?</span>
|
|
563
|
-
239: <span class="ruby-keyword kw">return</span> <span class="ruby-ivar">@main_loop_running</span>
|
|
564
|
-
240: <span class="ruby-keyword kw">end</span>
|
|
565
|
-
</pre>
|
|
566
|
-
</div>
|
|
567
|
-
</div>
|
|
568
|
-
</div>
|
|
569
|
-
<div class="method">
|
|
570
|
-
<div class="title">
|
|
571
|
-
<a name="M000342"></a><b>soft_shutdown</b>()
|
|
572
|
-
</div>
|
|
573
|
-
<div class="description">
|
|
574
|
-
<p>
|
|
575
|
-
Remove this request handler from the application pool so that no <a
|
|
576
|
-
href="AbstractRequestHandler.html#M000337">new</a> connections will come
|
|
577
|
-
in. Then make the main loop quit a few seconds after the last time a
|
|
578
|
-
connection came in. This all is to ensure that no connections come in while
|
|
579
|
-
we‘re shutting down.
|
|
580
|
-
</p>
|
|
581
|
-
<p>
|
|
582
|
-
May only be called while the main loop is running. May be called from any
|
|
583
|
-
thread.
|
|
584
|
-
</p>
|
|
585
|
-
</div>
|
|
586
|
-
<div class="sourcecode">
|
|
587
|
-
<p class="source-link">[ <a href="javascript:toggleSource('M000342_source')" id="l_M000342_source">show source</a> ]</p>
|
|
588
|
-
<div id="M000342_source" class="dyn-source">
|
|
589
|
-
<pre>
|
|
590
|
-
<span class="ruby-comment cmt"># File lib/phusion_passenger/abstract_request_handler.rb, line 333</span>
|
|
591
|
-
333: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">soft_shutdown</span>
|
|
592
|
-
334: <span class="ruby-ivar">@select_timeout</span> = <span class="ruby-ivar">@soft_termination_linger_time</span>
|
|
593
|
-
335: <span class="ruby-ivar">@graceful_termination_pipe</span>[<span class="ruby-value">1</span>].<span class="ruby-identifier">close</span> <span class="ruby-keyword kw">rescue</span> <span class="ruby-keyword kw">nil</span>
|
|
594
|
-
336: <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@detach_key</span> <span class="ruby-operator">&&</span> <span class="ruby-ivar">@pool_account_username</span> <span class="ruby-operator">&&</span> <span class="ruby-ivar">@pool_account_password</span>
|
|
595
|
-
337: <span class="ruby-identifier">client</span> = <span class="ruby-constant">MessageClient</span>.<span class="ruby-identifier">new</span>(<span class="ruby-ivar">@pool_account_username</span>, <span class="ruby-ivar">@pool_account_password</span>)
|
|
596
|
-
338: <span class="ruby-keyword kw">begin</span>
|
|
597
|
-
339: <span class="ruby-identifier">client</span>.<span class="ruby-identifier">detach</span>(<span class="ruby-ivar">@detach_key</span>)
|
|
598
|
-
340: <span class="ruby-keyword kw">ensure</span>
|
|
599
|
-
341: <span class="ruby-identifier">client</span>.<span class="ruby-identifier">close</span>
|
|
600
|
-
342: <span class="ruby-keyword kw">end</span>
|
|
601
|
-
343: <span class="ruby-keyword kw">end</span>
|
|
602
|
-
344: <span class="ruby-keyword kw">end</span>
|
|
603
|
-
</pre>
|
|
604
|
-
</div>
|
|
605
|
-
</div>
|
|
606
|
-
</div>
|
|
607
|
-
<div class="method">
|
|
608
|
-
<div class="title">
|
|
609
|
-
<a name="M000341"></a><b>start_main_loop_thread</b>()
|
|
610
|
-
</div>
|
|
611
|
-
<div class="description">
|
|
612
|
-
<p>
|
|
613
|
-
Start the main loop in a <a
|
|
614
|
-
href="AbstractRequestHandler.html#M000337">new</a> thread. This thread will
|
|
615
|
-
be stopped by <a href="AbstractRequestHandler.html#M000338">#cleanup</a>.
|
|
616
|
-
</p>
|
|
617
|
-
</div>
|
|
618
|
-
<div class="sourcecode">
|
|
619
|
-
<p class="source-link">[ <a href="javascript:toggleSource('M000341_source')" id="l_M000341_source">show source</a> ]</p>
|
|
620
|
-
<div id="M000341_source" class="dyn-source">
|
|
621
|
-
<pre>
|
|
622
|
-
<span class="ruby-comment cmt"># File lib/phusion_passenger/abstract_request_handler.rb, line 310</span>
|
|
623
|
-
310: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">start_main_loop_thread</span>
|
|
624
|
-
311: <span class="ruby-identifier">current_generation</span> = <span class="ruby-ivar">@main_loop_generation</span>
|
|
625
|
-
312: <span class="ruby-ivar">@main_loop_thread</span> = <span class="ruby-constant">Thread</span>.<span class="ruby-identifier">new</span> <span class="ruby-keyword kw">do</span>
|
|
626
|
-
313: <span class="ruby-keyword kw">begin</span>
|
|
627
|
-
314: <span class="ruby-identifier">main_loop</span>
|
|
628
|
-
315: <span class="ruby-keyword kw">rescue</span> <span class="ruby-constant">Exception</span> =<span class="ruby-operator">></span> <span class="ruby-identifier">e</span>
|
|
629
|
-
316: <span class="ruby-identifier">print_exception</span>(<span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">class</span>, <span class="ruby-identifier">e</span>)
|
|
630
|
-
317: <span class="ruby-keyword kw">end</span>
|
|
631
|
-
318: <span class="ruby-keyword kw">end</span>
|
|
632
|
-
319: <span class="ruby-ivar">@main_loop_thread_lock</span>.<span class="ruby-identifier">synchronize</span> <span class="ruby-keyword kw">do</span>
|
|
633
|
-
320: <span class="ruby-keyword kw">while</span> <span class="ruby-ivar">@main_loop_generation</span> <span class="ruby-operator">==</span> <span class="ruby-identifier">current_generation</span>
|
|
634
|
-
321: <span class="ruby-ivar">@main_loop_thread_cond</span>.<span class="ruby-identifier">wait</span>(<span class="ruby-ivar">@main_loop_thread_lock</span>)
|
|
635
|
-
322: <span class="ruby-keyword kw">end</span>
|
|
636
|
-
323: <span class="ruby-keyword kw">end</span>
|
|
637
|
-
324: <span class="ruby-keyword kw">end</span>
|
|
638
|
-
</pre>
|
|
639
|
-
</div>
|
|
640
|
-
</div>
|
|
641
|
-
</div>
|
|
642
|
-
</div>
|
|
643
|
-
|
|
644
|
-
</div>
|
|
645
|
-
|
|
646
|
-
</body>
|
|
647
|
-
</html>
|