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,162 +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::HTMLTemplate</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::HTMLTemplate</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/html_template_rb.html">lib/phusion_passenger/html_template.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
|
-
A convenience utility class for rendering our error pages.
|
|
80
|
-
</p>
|
|
81
|
-
</div>
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
<div class="sectiontitle">Methods</div>
|
|
86
|
-
<ul>
|
|
87
|
-
<li><a href="#M000322">[]=</a></li>
|
|
88
|
-
<li><a href="#M000321">new</a></li>
|
|
89
|
-
<li><a href="#M000323">result</a></li>
|
|
90
|
-
</ul>
|
|
91
|
-
|
|
92
|
-
<div class="sectiontitle">Included Modules</div>
|
|
93
|
-
<ul>
|
|
94
|
-
<li>ERB::Util</li>
|
|
95
|
-
</ul>
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
<div class="sectiontitle">Public Class methods</div>
|
|
102
|
-
<div class="method">
|
|
103
|
-
<div class="title">
|
|
104
|
-
<a name="M000321"></a><b>new</b>(template_name, options = {})
|
|
105
|
-
</div>
|
|
106
|
-
<div class="sourcecode">
|
|
107
|
-
<p class="source-link">[ <a href="javascript:toggleSource('M000321_source')" id="l_M000321_source">show source</a> ]</p>
|
|
108
|
-
<div id="M000321_source" class="dyn-source">
|
|
109
|
-
<pre>
|
|
110
|
-
<span class="ruby-comment cmt"># File lib/phusion_passenger/html_template.rb, line 31</span>
|
|
111
|
-
31: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-identifier">template_name</span>, <span class="ruby-identifier">options</span> = {})
|
|
112
|
-
32: <span class="ruby-ivar">@buffer</span> = <span class="ruby-value str">''</span>
|
|
113
|
-
33: <span class="ruby-ivar">@template</span> = <span class="ruby-constant">ERB</span>.<span class="ruby-identifier">new</span>(<span class="ruby-constant">File</span>.<span class="ruby-identifier">read</span>(<span class="ruby-node">"#{TEMPLATES_DIR}/#{template_name}.html.erb"</span>),
|
|
114
|
-
34: <span class="ruby-keyword kw">nil</span>, <span class="ruby-keyword kw">nil</span>, <span class="ruby-value str">'@buffer'</span>)
|
|
115
|
-
35: <span class="ruby-identifier">options</span>.<span class="ruby-identifier">each_pair</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">name</span>, <span class="ruby-identifier">value</span><span class="ruby-operator">|</span>
|
|
116
|
-
36: <span class="ruby-keyword kw">self</span>[<span class="ruby-identifier">name</span>] = <span class="ruby-identifier">value</span>
|
|
117
|
-
37: <span class="ruby-keyword kw">end</span>
|
|
118
|
-
38: <span class="ruby-keyword kw">end</span>
|
|
119
|
-
</pre>
|
|
120
|
-
</div>
|
|
121
|
-
</div>
|
|
122
|
-
</div>
|
|
123
|
-
<div class="sectiontitle">Public Instance methods</div>
|
|
124
|
-
<div class="method">
|
|
125
|
-
<div class="title">
|
|
126
|
-
<a name="M000322"></a><b>[]=</b>(name, value)
|
|
127
|
-
</div>
|
|
128
|
-
<div class="sourcecode">
|
|
129
|
-
<p class="source-link">[ <a href="javascript:toggleSource('M000322_source')" id="l_M000322_source">show source</a> ]</p>
|
|
130
|
-
<div id="M000322_source" class="dyn-source">
|
|
131
|
-
<pre>
|
|
132
|
-
<span class="ruby-comment cmt"># File lib/phusion_passenger/html_template.rb, line 40</span>
|
|
133
|
-
40: <span class="ruby-keyword kw">def</span> <span class="ruby-operator">[]=</span>(<span class="ruby-identifier">name</span>, <span class="ruby-identifier">value</span>)
|
|
134
|
-
41: <span class="ruby-identifier">instance_variable_set</span>(<span class="ruby-node">"@#{name}"</span>.<span class="ruby-identifier">to_sym</span>, <span class="ruby-identifier">value</span>)
|
|
135
|
-
42: <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">self</span>
|
|
136
|
-
43: <span class="ruby-keyword kw">end</span>
|
|
137
|
-
</pre>
|
|
138
|
-
</div>
|
|
139
|
-
</div>
|
|
140
|
-
</div>
|
|
141
|
-
<div class="method">
|
|
142
|
-
<div class="title">
|
|
143
|
-
<a name="M000323"></a><b>result</b>()
|
|
144
|
-
</div>
|
|
145
|
-
<div class="sourcecode">
|
|
146
|
-
<p class="source-link">[ <a href="javascript:toggleSource('M000323_source')" id="l_M000323_source">show source</a> ]</p>
|
|
147
|
-
<div id="M000323_source" class="dyn-source">
|
|
148
|
-
<pre>
|
|
149
|
-
<span class="ruby-comment cmt"># File lib/phusion_passenger/html_template.rb, line 45</span>
|
|
150
|
-
45: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">result</span>
|
|
151
|
-
46: <span class="ruby-keyword kw">return</span> <span class="ruby-ivar">@template</span>.<span class="ruby-identifier">result</span>(<span class="ruby-identifier">binding</span>)
|
|
152
|
-
47: <span class="ruby-keyword kw">end</span>
|
|
153
|
-
</pre>
|
|
154
|
-
</div>
|
|
155
|
-
</div>
|
|
156
|
-
</div>
|
|
157
|
-
</div>
|
|
158
|
-
|
|
159
|
-
</div>
|
|
160
|
-
|
|
161
|
-
</body>
|
|
162
|
-
</html>
|
|
@@ -1,141 +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::InitializationError</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::InitializationError</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/exceptions_rb.html">lib/phusion_passenger/exceptions.rb</a>
|
|
61
|
-
</td>
|
|
62
|
-
</tr>
|
|
63
|
-
<tr>
|
|
64
|
-
<td>Parent:</td>
|
|
65
|
-
<td>
|
|
66
|
-
StandardError
|
|
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
|
-
An abstract base class for <a href="AppInitError.html">AppInitError</a> and
|
|
80
|
-
<a href="FrameworkInitError.html">FrameworkInitError</a>. This represents
|
|
81
|
-
the failure when initializing something.
|
|
82
|
-
</p>
|
|
83
|
-
</div>
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
<div class="sectiontitle">Methods</div>
|
|
88
|
-
<ul>
|
|
89
|
-
<li><a href="#M000381">new</a></li>
|
|
90
|
-
</ul>
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
<div class="sectiontitle">Attributes</div>
|
|
97
|
-
<table border='0' cellpadding='5'>
|
|
98
|
-
<tr valign='top'>
|
|
99
|
-
<td class='attr-rw'>
|
|
100
|
-
[RW]
|
|
101
|
-
</td>
|
|
102
|
-
<td class='attr-name'>child_exception</td>
|
|
103
|
-
<td class='attr-desc'>
|
|
104
|
-
The exception that caused initialization to fail. This may be nil.
|
|
105
|
-
|
|
106
|
-
</td>
|
|
107
|
-
</tr>
|
|
108
|
-
</table>
|
|
109
|
-
|
|
110
|
-
<div class="sectiontitle">Public Class methods</div>
|
|
111
|
-
<div class="method">
|
|
112
|
-
<div class="title">
|
|
113
|
-
<a name="M000381"></a><b>new</b>(message, child_exception = nil)
|
|
114
|
-
</div>
|
|
115
|
-
<div class="description">
|
|
116
|
-
<p>
|
|
117
|
-
Create a <a href="InitializationError.html#M000381">new</a> <a
|
|
118
|
-
href="InitializationError.html">InitializationError</a>. <tt>message</tt>
|
|
119
|
-
is the error message, and <tt>child_exception</tt> is the exception that
|
|
120
|
-
caused initialization to fail.
|
|
121
|
-
</p>
|
|
122
|
-
</div>
|
|
123
|
-
<div class="sourcecode">
|
|
124
|
-
<p class="source-link">[ <a href="javascript:toggleSource('M000381_source')" id="l_M000381_source">show source</a> ]</p>
|
|
125
|
-
<div id="M000381_source" class="dyn-source">
|
|
126
|
-
<pre>
|
|
127
|
-
<span class="ruby-comment cmt"># File lib/phusion_passenger/exceptions.rb, line 48</span>
|
|
128
|
-
48: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-identifier">message</span>, <span class="ruby-identifier">child_exception</span> = <span class="ruby-keyword kw">nil</span>)
|
|
129
|
-
49: <span class="ruby-keyword kw">super</span>(<span class="ruby-identifier">message</span>)
|
|
130
|
-
50: <span class="ruby-ivar">@child_exception</span> = <span class="ruby-identifier">child_exception</span>
|
|
131
|
-
51: <span class="ruby-keyword kw">end</span>
|
|
132
|
-
</pre>
|
|
133
|
-
</div>
|
|
134
|
-
</div>
|
|
135
|
-
</div>
|
|
136
|
-
</div>
|
|
137
|
-
|
|
138
|
-
</div>
|
|
139
|
-
|
|
140
|
-
</body>
|
|
141
|
-
</html>
|
|
@@ -1,92 +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::InvalidPath</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::InvalidPath</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/exceptions_rb.html">lib/phusion_passenger/exceptions.rb</a>
|
|
61
|
-
</td>
|
|
62
|
-
</tr>
|
|
63
|
-
<tr>
|
|
64
|
-
<td>Parent:</td>
|
|
65
|
-
<td>
|
|
66
|
-
StandardError
|
|
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
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
</div>
|
|
88
|
-
|
|
89
|
-
</div>
|
|
90
|
-
|
|
91
|
-
</body>
|
|
92
|
-
</html>
|
|
@@ -1,673 +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::MessageChannel</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::MessageChannel</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/message_channel_rb.html">lib/phusion_passenger/message_channel.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
|
-
This class provides convenience methods for:
|
|
80
|
-
</p>
|
|
81
|
-
<ul>
|
|
82
|
-
<li>sending and receiving raw data over an <a href="../IO.html">IO</a> channel.
|
|
83
|
-
|
|
84
|
-
</li>
|
|
85
|
-
<li>sending and receiving messages over an <a href="../IO.html">IO</a> channel.
|
|
86
|
-
|
|
87
|
-
</li>
|
|
88
|
-
<li>file descriptor (<a href="../IO.html">IO</a> object) passing over a Unix
|
|
89
|
-
socket.
|
|
90
|
-
|
|
91
|
-
</li>
|
|
92
|
-
</ul>
|
|
93
|
-
<p>
|
|
94
|
-
All of these methods use exceptions for error reporting.
|
|
95
|
-
</p>
|
|
96
|
-
<p>
|
|
97
|
-
There are two kinds of messages:
|
|
98
|
-
</p>
|
|
99
|
-
<dl>
|
|
100
|
-
<dt> Array messages </dt><dd>These are just a list of strings, and the message itself has a specific
|
|
101
|
-
length. The contained strings may not contain NUL characters
|
|
102
|
-
(<tt>’\0‘</tt>). Note that an array message must have at least
|
|
103
|
-
one element.
|
|
104
|
-
|
|
105
|
-
</dd>
|
|
106
|
-
<dt> Scalar messages </dt><dd>These are byte strings which may contain arbitrary binary data. Scalar
|
|
107
|
-
messages also have a specific length.
|
|
108
|
-
|
|
109
|
-
</dd>
|
|
110
|
-
</dl>
|
|
111
|
-
<p>
|
|
112
|
-
The protocol is designed to be low overhead, easy to implement and easy to
|
|
113
|
-
parse.
|
|
114
|
-
</p>
|
|
115
|
-
<p>
|
|
116
|
-
<a href="MessageChannel.html">MessageChannel</a> is to be wrapped around an
|
|
117
|
-
<a href="../IO.html">IO</a> object. For example:
|
|
118
|
-
</p>
|
|
119
|
-
<pre>
|
|
120
|
-
a, b = IO.pipe
|
|
121
|
-
channel1 = MessageChannel.new(a)
|
|
122
|
-
channel2 = MessageChannel.new(b)
|
|
123
|
-
|
|
124
|
-
# Send an array message.
|
|
125
|
-
channel2.write("hello", "world !!")
|
|
126
|
-
channel1.read # => ["hello", "world !!"]
|
|
127
|
-
|
|
128
|
-
# Send a scalar message.
|
|
129
|
-
channel2.write_scalar("some long string which can contain arbitrary binary data")
|
|
130
|
-
channel1.read_scalar
|
|
131
|
-
</pre>
|
|
132
|
-
<p>
|
|
133
|
-
The life time of a <a href="MessageChannel.html">MessageChannel</a> is
|
|
134
|
-
independent from that of the wrapped <a href="../IO.html">IO</a> object. If
|
|
135
|
-
a <a href="MessageChannel.html">MessageChannel</a> object is destroyed, the
|
|
136
|
-
underlying <a href="../IO.html">IO</a> object is not automatically closed.
|
|
137
|
-
Call <a href="MessageChannel.html#M000358">close</a>() if you want to <a
|
|
138
|
-
href="MessageChannel.html#M000358">close</a> the underlying <a
|
|
139
|
-
href="../IO.html">IO</a> object.
|
|
140
|
-
</p>
|
|
141
|
-
<p>
|
|
142
|
-
Note: Be careful with mixing the sending/receiving of array messages,
|
|
143
|
-
scalar messages and <a href="../IO.html">IO</a> objects. If you send a
|
|
144
|
-
collection of any of these in a specific order, then the receiving side
|
|
145
|
-
must receive them in the exact some order. So suppose you first send a
|
|
146
|
-
message, then an <a href="../IO.html">IO</a> object, then a scalar, then
|
|
147
|
-
the receiving side must first receive a message, then an <a
|
|
148
|
-
href="../IO.html">IO</a> object, then a scalar. If the receiving side does
|
|
149
|
-
things in the wrong order then bad things will happen.
|
|
150
|
-
</p>
|
|
151
|
-
</div>
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
<div class="sectiontitle">Methods</div>
|
|
156
|
-
<ul>
|
|
157
|
-
<li><a href="#M000358">close</a></li>
|
|
158
|
-
<li><a href="#M000359">closed?</a></li>
|
|
159
|
-
<li><a href="#M000357">fileno</a></li>
|
|
160
|
-
<li><a href="#M000349">new</a></li>
|
|
161
|
-
<li><a href="#M000350">read</a></li>
|
|
162
|
-
<li><a href="#M000351">read_hash</a></li>
|
|
163
|
-
<li><a href="#M000352">read_scalar</a></li>
|
|
164
|
-
<li><a href="#M000355">recv_io</a></li>
|
|
165
|
-
<li><a href="#M000356">send_io</a></li>
|
|
166
|
-
<li><a href="#M000353">write</a></li>
|
|
167
|
-
<li><a href="#M000354">write_scalar</a></li>
|
|
168
|
-
</ul>
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
<div class="sectiontitle">Classes and Modules</div>
|
|
173
|
-
Class <a href="MessageChannel/InvalidHashError.html" class="link">PhusionPassenger::MessageChannel::InvalidHashError</a><br />
|
|
174
|
-
|
|
175
|
-
|
|
176
|
-
|
|
177
|
-
<div class="sectiontitle">Attributes</div>
|
|
178
|
-
<table border='0' cellpadding='5'>
|
|
179
|
-
<tr valign='top'>
|
|
180
|
-
<td class='attr-rw'>
|
|
181
|
-
[RW]
|
|
182
|
-
</td>
|
|
183
|
-
<td class='attr-name'>io</td>
|
|
184
|
-
<td class='attr-desc'>
|
|
185
|
-
The wrapped <a href="../IO.html">IO</a> object.
|
|
186
|
-
|
|
187
|
-
</td>
|
|
188
|
-
</tr>
|
|
189
|
-
</table>
|
|
190
|
-
|
|
191
|
-
<div class="sectiontitle">Public Class methods</div>
|
|
192
|
-
<div class="method">
|
|
193
|
-
<div class="title">
|
|
194
|
-
<a name="M000349"></a><b>new</b>(io = nil)
|
|
195
|
-
</div>
|
|
196
|
-
<div class="description">
|
|
197
|
-
<p>
|
|
198
|
-
Create a <a href="MessageChannel.html#M000349">new</a> <a
|
|
199
|
-
href="MessageChannel.html">MessageChannel</a> by wrapping the given <a
|
|
200
|
-
href="../IO.html">IO</a> object.
|
|
201
|
-
</p>
|
|
202
|
-
</div>
|
|
203
|
-
<div class="sourcecode">
|
|
204
|
-
<p class="source-link">[ <a href="javascript:toggleSource('M000349_source')" id="l_M000349_source">show source</a> ]</p>
|
|
205
|
-
<div id="M000349_source" class="dyn-source">
|
|
206
|
-
<pre>
|
|
207
|
-
<span class="ruby-comment cmt"># File lib/phusion_passenger/message_channel.rb, line 88</span>
|
|
208
|
-
88: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-identifier">io</span> = <span class="ruby-keyword kw">nil</span>)
|
|
209
|
-
89: <span class="ruby-ivar">@io</span> = <span class="ruby-identifier">io</span>
|
|
210
|
-
90: <span class="ruby-comment cmt"># Make it binary just in case.</span>
|
|
211
|
-
91: <span class="ruby-ivar">@io</span>.<span class="ruby-identifier">binmode</span> <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@io</span>
|
|
212
|
-
92: <span class="ruby-keyword kw">end</span>
|
|
213
|
-
</pre>
|
|
214
|
-
</div>
|
|
215
|
-
</div>
|
|
216
|
-
</div>
|
|
217
|
-
<div class="sectiontitle">Public Instance methods</div>
|
|
218
|
-
<div class="method">
|
|
219
|
-
<div class="title">
|
|
220
|
-
<a name="M000358"></a><b>close</b>()
|
|
221
|
-
</div>
|
|
222
|
-
<div class="description">
|
|
223
|
-
<p>
|
|
224
|
-
Close the underlying <a href="../IO.html">IO</a> stream. Might raise
|
|
225
|
-
SystemCallError or IOError when something goes wrong.
|
|
226
|
-
</p>
|
|
227
|
-
</div>
|
|
228
|
-
<div class="sourcecode">
|
|
229
|
-
<p class="source-link">[ <a href="javascript:toggleSource('M000358_source')" id="l_M000358_source">show source</a> ]</p>
|
|
230
|
-
<div id="M000358_source" class="dyn-source">
|
|
231
|
-
<pre>
|
|
232
|
-
<span class="ruby-comment cmt"># File lib/phusion_passenger/message_channel.rb, line 360</span>
|
|
233
|
-
360: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">close</span>
|
|
234
|
-
361: <span class="ruby-ivar">@io</span>.<span class="ruby-identifier">close</span>
|
|
235
|
-
362: <span class="ruby-keyword kw">end</span>
|
|
236
|
-
</pre>
|
|
237
|
-
</div>
|
|
238
|
-
</div>
|
|
239
|
-
</div>
|
|
240
|
-
<div class="method">
|
|
241
|
-
<div class="title">
|
|
242
|
-
<a name="M000359"></a><b>closed?</b>()
|
|
243
|
-
</div>
|
|
244
|
-
<div class="description">
|
|
245
|
-
<p>
|
|
246
|
-
Checks whether the underlying <a href="../IO.html">IO</a> stream is closed.
|
|
247
|
-
</p>
|
|
248
|
-
</div>
|
|
249
|
-
<div class="sourcecode">
|
|
250
|
-
<p class="source-link">[ <a href="javascript:toggleSource('M000359_source')" id="l_M000359_source">show source</a> ]</p>
|
|
251
|
-
<div id="M000359_source" class="dyn-source">
|
|
252
|
-
<pre>
|
|
253
|
-
<span class="ruby-comment cmt"># File lib/phusion_passenger/message_channel.rb, line 365</span>
|
|
254
|
-
365: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">closed?</span>
|
|
255
|
-
366: <span class="ruby-keyword kw">return</span> <span class="ruby-ivar">@io</span>.<span class="ruby-identifier">closed?</span>
|
|
256
|
-
367: <span class="ruby-keyword kw">end</span>
|
|
257
|
-
</pre>
|
|
258
|
-
</div>
|
|
259
|
-
</div>
|
|
260
|
-
</div>
|
|
261
|
-
<div class="method">
|
|
262
|
-
<div class="title">
|
|
263
|
-
<a name="M000357"></a><b>fileno</b>()
|
|
264
|
-
</div>
|
|
265
|
-
<div class="description">
|
|
266
|
-
<p>
|
|
267
|
-
Return the file descriptor of the underlying <a href="../IO.html">IO</a>
|
|
268
|
-
object.
|
|
269
|
-
</p>
|
|
270
|
-
</div>
|
|
271
|
-
<div class="sourcecode">
|
|
272
|
-
<p class="source-link">[ <a href="javascript:toggleSource('M000357_source')" id="l_M000357_source">show source</a> ]</p>
|
|
273
|
-
<div id="M000357_source" class="dyn-source">
|
|
274
|
-
<pre>
|
|
275
|
-
<span class="ruby-comment cmt"># File lib/phusion_passenger/message_channel.rb, line 354</span>
|
|
276
|
-
354: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">fileno</span>
|
|
277
|
-
355: <span class="ruby-keyword kw">return</span> <span class="ruby-ivar">@io</span>.<span class="ruby-identifier">fileno</span>
|
|
278
|
-
356: <span class="ruby-keyword kw">end</span>
|
|
279
|
-
</pre>
|
|
280
|
-
</div>
|
|
281
|
-
</div>
|
|
282
|
-
</div>
|
|
283
|
-
<div class="method">
|
|
284
|
-
<div class="title">
|
|
285
|
-
<a name="M000350"></a><b>read</b>()
|
|
286
|
-
</div>
|
|
287
|
-
<div class="description">
|
|
288
|
-
<p>
|
|
289
|
-
Read an array message from the underlying file descriptor. Returns the
|
|
290
|
-
array message as an array, or nil when end-of-stream has been reached.
|
|
291
|
-
</p>
|
|
292
|
-
<p>
|
|
293
|
-
Might raise SystemCallError, IOError or SocketError when something goes
|
|
294
|
-
wrong.
|
|
295
|
-
</p>
|
|
296
|
-
</div>
|
|
297
|
-
<div class="sourcecode">
|
|
298
|
-
<p class="source-link">[ <a href="javascript:toggleSource('M000350_source')" id="l_M000350_source">show source</a> ]</p>
|
|
299
|
-
<div id="M000350_source" class="dyn-source">
|
|
300
|
-
<pre>
|
|
301
|
-
<span class="ruby-comment cmt"># File lib/phusion_passenger/message_channel.rb, line 100</span>
|
|
302
|
-
100: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">read</span>
|
|
303
|
-
101: <span class="ruby-identifier">buffer</span> = <span class="ruby-identifier">new_buffer</span>
|
|
304
|
-
102: <span class="ruby-keyword kw">if</span> <span class="ruby-operator">!</span><span class="ruby-ivar">@io</span>.<span class="ruby-identifier">read</span>(<span class="ruby-constant">HEADER_SIZE</span>, <span class="ruby-identifier">buffer</span>)
|
|
305
|
-
103: <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">nil</span>
|
|
306
|
-
104: <span class="ruby-keyword kw">end</span>
|
|
307
|
-
105: <span class="ruby-keyword kw">while</span> <span class="ruby-identifier">buffer</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator"><</span> <span class="ruby-constant">HEADER_SIZE</span>
|
|
308
|
-
106: <span class="ruby-identifier">tmp</span> = <span class="ruby-ivar">@io</span>.<span class="ruby-identifier">read</span>(<span class="ruby-constant">HEADER_SIZE</span> <span class="ruby-operator">-</span> <span class="ruby-identifier">buffer</span>.<span class="ruby-identifier">size</span>)
|
|
309
|
-
107: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">tmp</span>.<span class="ruby-identifier">empty?</span>
|
|
310
|
-
108: <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">nil</span>
|
|
311
|
-
109: <span class="ruby-keyword kw">else</span>
|
|
312
|
-
110: <span class="ruby-identifier">buffer</span> <span class="ruby-operator"><<</span> <span class="ruby-identifier">tmp</span>
|
|
313
|
-
111: <span class="ruby-keyword kw">end</span>
|
|
314
|
-
112: <span class="ruby-keyword kw">end</span>
|
|
315
|
-
113:
|
|
316
|
-
114: <span class="ruby-identifier">chunk_size</span> = <span class="ruby-identifier">buffer</span>.<span class="ruby-identifier">unpack</span>(<span class="ruby-constant">UINT16_PACK_FORMAT</span>)[<span class="ruby-value">0</span>]
|
|
317
|
-
115: <span class="ruby-keyword kw">if</span> <span class="ruby-operator">!</span><span class="ruby-ivar">@io</span>.<span class="ruby-identifier">read</span>(<span class="ruby-identifier">chunk_size</span>, <span class="ruby-identifier">buffer</span>)
|
|
318
|
-
116: <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">nil</span>
|
|
319
|
-
117: <span class="ruby-keyword kw">end</span>
|
|
320
|
-
118: <span class="ruby-keyword kw">while</span> <span class="ruby-identifier">buffer</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator"><</span> <span class="ruby-identifier">chunk_size</span>
|
|
321
|
-
119: <span class="ruby-identifier">tmp</span> = <span class="ruby-ivar">@io</span>.<span class="ruby-identifier">read</span>(<span class="ruby-identifier">chunk_size</span> <span class="ruby-operator">-</span> <span class="ruby-identifier">buffer</span>.<span class="ruby-identifier">size</span>)
|
|
322
|
-
120: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">tmp</span>.<span class="ruby-identifier">empty?</span>
|
|
323
|
-
121: <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">nil</span>
|
|
324
|
-
122: <span class="ruby-keyword kw">else</span>
|
|
325
|
-
123: <span class="ruby-identifier">buffer</span> <span class="ruby-operator"><<</span> <span class="ruby-identifier">tmp</span>
|
|
326
|
-
124: <span class="ruby-keyword kw">end</span>
|
|
327
|
-
125: <span class="ruby-keyword kw">end</span>
|
|
328
|
-
126:
|
|
329
|
-
127: <span class="ruby-identifier">message</span> = []
|
|
330
|
-
128: <span class="ruby-identifier">offset</span> = <span class="ruby-value">0</span>
|
|
331
|
-
129: <span class="ruby-identifier">delimiter_pos</span> = <span class="ruby-identifier">buffer</span>.<span class="ruby-identifier">index</span>(<span class="ruby-constant">DELIMITER</span>, <span class="ruby-identifier">offset</span>)
|
|
332
|
-
130: <span class="ruby-keyword kw">while</span> <span class="ruby-operator">!</span><span class="ruby-identifier">delimiter_pos</span>.<span class="ruby-identifier">nil?</span>
|
|
333
|
-
131: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">delimiter_pos</span> <span class="ruby-operator">==</span> <span class="ruby-value">0</span>
|
|
334
|
-
132: <span class="ruby-identifier">message</span> <span class="ruby-operator"><<</span> <span class="ruby-value str">""</span>
|
|
335
|
-
133: <span class="ruby-keyword kw">else</span>
|
|
336
|
-
134: <span class="ruby-identifier">message</span> <span class="ruby-operator"><<</span> <span class="ruby-identifier">buffer</span>[<span class="ruby-identifier">offset</span> <span class="ruby-operator">..</span> <span class="ruby-identifier">delimiter_pos</span> <span class="ruby-operator">-</span> <span class="ruby-value">1</span>]
|
|
337
|
-
135: <span class="ruby-keyword kw">end</span>
|
|
338
|
-
136: <span class="ruby-identifier">offset</span> = <span class="ruby-identifier">delimiter_pos</span> <span class="ruby-operator">+</span> <span class="ruby-value">1</span>
|
|
339
|
-
137: <span class="ruby-identifier">delimiter_pos</span> = <span class="ruby-identifier">buffer</span>.<span class="ruby-identifier">index</span>(<span class="ruby-constant">DELIMITER</span>, <span class="ruby-identifier">offset</span>)
|
|
340
|
-
138: <span class="ruby-keyword kw">end</span>
|
|
341
|
-
139: <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">message</span>
|
|
342
|
-
140: <span class="ruby-keyword kw">rescue</span> <span class="ruby-constant">Errno</span><span class="ruby-operator">::</span><span class="ruby-constant">ECONNRESET</span>
|
|
343
|
-
141: <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">nil</span>
|
|
344
|
-
142: <span class="ruby-keyword kw">end</span>
|
|
345
|
-
</pre>
|
|
346
|
-
</div>
|
|
347
|
-
</div>
|
|
348
|
-
</div>
|
|
349
|
-
<div class="method">
|
|
350
|
-
<div class="title">
|
|
351
|
-
<a name="M000351"></a><b>read_hash</b>()
|
|
352
|
-
</div>
|
|
353
|
-
<div class="description">
|
|
354
|
-
<p>
|
|
355
|
-
Read an array message from the underlying file descriptor and return the
|
|
356
|
-
result as a hash instead of an array. This assumes that the array message
|
|
357
|
-
has an even number of elements. Returns nil when end-of-stream has been
|
|
358
|
-
reached.
|
|
359
|
-
</p>
|
|
360
|
-
<p>
|
|
361
|
-
Might raise SystemCallError, IOError or SocketError when something goes
|
|
362
|
-
wrong.
|
|
363
|
-
</p>
|
|
364
|
-
</div>
|
|
365
|
-
<div class="sourcecode">
|
|
366
|
-
<p class="source-link">[ <a href="javascript:toggleSource('M000351_source')" id="l_M000351_source">show source</a> ]</p>
|
|
367
|
-
<div id="M000351_source" class="dyn-source">
|
|
368
|
-
<pre>
|
|
369
|
-
<span class="ruby-comment cmt"># File lib/phusion_passenger/message_channel.rb, line 151</span>
|
|
370
|
-
151: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">read_hash</span>
|
|
371
|
-
152: <span class="ruby-identifier">buffer</span> = <span class="ruby-identifier">new_buffer</span>
|
|
372
|
-
153: <span class="ruby-keyword kw">if</span> <span class="ruby-operator">!</span><span class="ruby-ivar">@io</span>.<span class="ruby-identifier">read</span>(<span class="ruby-constant">HEADER_SIZE</span>, <span class="ruby-identifier">buffer</span>)
|
|
373
|
-
154: <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">nil</span>
|
|
374
|
-
155: <span class="ruby-keyword kw">end</span>
|
|
375
|
-
156: <span class="ruby-keyword kw">while</span> <span class="ruby-identifier">buffer</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator"><</span> <span class="ruby-constant">HEADER_SIZE</span>
|
|
376
|
-
157: <span class="ruby-identifier">tmp</span> = <span class="ruby-ivar">@io</span>.<span class="ruby-identifier">read</span>(<span class="ruby-constant">HEADER_SIZE</span> <span class="ruby-operator">-</span> <span class="ruby-identifier">buffer</span>.<span class="ruby-identifier">size</span>)
|
|
377
|
-
158: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">tmp</span>.<span class="ruby-identifier">empty?</span>
|
|
378
|
-
159: <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">nil</span>
|
|
379
|
-
160: <span class="ruby-keyword kw">else</span>
|
|
380
|
-
161: <span class="ruby-identifier">buffer</span> <span class="ruby-operator"><<</span> <span class="ruby-identifier">tmp</span>
|
|
381
|
-
162: <span class="ruby-keyword kw">end</span>
|
|
382
|
-
163: <span class="ruby-keyword kw">end</span>
|
|
383
|
-
164:
|
|
384
|
-
165: <span class="ruby-identifier">chunk_size</span> = <span class="ruby-identifier">buffer</span>.<span class="ruby-identifier">unpack</span>(<span class="ruby-constant">UINT16_PACK_FORMAT</span>)[<span class="ruby-value">0</span>]
|
|
385
|
-
166: <span class="ruby-keyword kw">if</span> <span class="ruby-operator">!</span><span class="ruby-ivar">@io</span>.<span class="ruby-identifier">read</span>(<span class="ruby-identifier">chunk_size</span>, <span class="ruby-identifier">buffer</span>)
|
|
386
|
-
167: <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">nil</span>
|
|
387
|
-
168: <span class="ruby-keyword kw">end</span>
|
|
388
|
-
169: <span class="ruby-keyword kw">while</span> <span class="ruby-identifier">buffer</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator"><</span> <span class="ruby-identifier">chunk_size</span>
|
|
389
|
-
170: <span class="ruby-identifier">tmp</span> = <span class="ruby-ivar">@io</span>.<span class="ruby-identifier">read</span>(<span class="ruby-identifier">chunk_size</span> <span class="ruby-operator">-</span> <span class="ruby-identifier">buffer</span>.<span class="ruby-identifier">size</span>)
|
|
390
|
-
171: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">tmp</span>.<span class="ruby-identifier">empty?</span>
|
|
391
|
-
172: <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">nil</span>
|
|
392
|
-
173: <span class="ruby-keyword kw">else</span>
|
|
393
|
-
174: <span class="ruby-identifier">buffer</span> <span class="ruby-operator"><<</span> <span class="ruby-identifier">tmp</span>
|
|
394
|
-
175: <span class="ruby-keyword kw">end</span>
|
|
395
|
-
176: <span class="ruby-keyword kw">end</span>
|
|
396
|
-
177:
|
|
397
|
-
178: <span class="ruby-identifier">result</span> = {}
|
|
398
|
-
179: <span class="ruby-identifier">offset</span> = <span class="ruby-value">0</span>
|
|
399
|
-
180: <span class="ruby-identifier">delimiter_pos</span> = <span class="ruby-identifier">buffer</span>.<span class="ruby-identifier">index</span>(<span class="ruby-constant">DELIMITER</span>, <span class="ruby-identifier">offset</span>)
|
|
400
|
-
181: <span class="ruby-keyword kw">while</span> <span class="ruby-operator">!</span><span class="ruby-identifier">delimiter_pos</span>.<span class="ruby-identifier">nil?</span>
|
|
401
|
-
182: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">delimiter_pos</span> <span class="ruby-operator">==</span> <span class="ruby-value">0</span>
|
|
402
|
-
183: <span class="ruby-identifier">name</span> = <span class="ruby-value str">""</span>
|
|
403
|
-
184: <span class="ruby-keyword kw">else</span>
|
|
404
|
-
185: <span class="ruby-identifier">name</span> = <span class="ruby-identifier">buffer</span>[<span class="ruby-identifier">offset</span> <span class="ruby-operator">..</span> <span class="ruby-identifier">delimiter_pos</span> <span class="ruby-operator">-</span> <span class="ruby-value">1</span>]
|
|
405
|
-
186: <span class="ruby-keyword kw">end</span>
|
|
406
|
-
187:
|
|
407
|
-
188: <span class="ruby-identifier">offset</span> = <span class="ruby-identifier">delimiter_pos</span> <span class="ruby-operator">+</span> <span class="ruby-value">1</span>
|
|
408
|
-
189: <span class="ruby-identifier">delimiter_pos</span> = <span class="ruby-identifier">buffer</span>.<span class="ruby-identifier">index</span>(<span class="ruby-constant">DELIMITER</span>, <span class="ruby-identifier">offset</span>)
|
|
409
|
-
190: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">delimiter_pos</span>.<span class="ruby-identifier">nil?</span>
|
|
410
|
-
191: <span class="ruby-identifier">raise</span> <span class="ruby-constant">InvalidHashError</span>
|
|
411
|
-
192: <span class="ruby-keyword kw">elsif</span> <span class="ruby-identifier">delimiter_pos</span> <span class="ruby-operator">==</span> <span class="ruby-value">0</span>
|
|
412
|
-
193: <span class="ruby-identifier">value</span> = <span class="ruby-value str">""</span>
|
|
413
|
-
194: <span class="ruby-keyword kw">else</span>
|
|
414
|
-
195: <span class="ruby-identifier">value</span> = <span class="ruby-identifier">buffer</span>[<span class="ruby-identifier">offset</span> <span class="ruby-operator">..</span> <span class="ruby-identifier">delimiter_pos</span> <span class="ruby-operator">-</span> <span class="ruby-value">1</span>]
|
|
415
|
-
196: <span class="ruby-keyword kw">end</span>
|
|
416
|
-
197:
|
|
417
|
-
198: <span class="ruby-identifier">result</span>[<span class="ruby-identifier">name</span>] = <span class="ruby-identifier">value</span>
|
|
418
|
-
199: <span class="ruby-identifier">offset</span> = <span class="ruby-identifier">delimiter_pos</span> <span class="ruby-operator">+</span> <span class="ruby-value">1</span>
|
|
419
|
-
200: <span class="ruby-identifier">delimiter_pos</span> = <span class="ruby-identifier">buffer</span>.<span class="ruby-identifier">index</span>(<span class="ruby-constant">DELIMITER</span>, <span class="ruby-identifier">offset</span>)
|
|
420
|
-
201: <span class="ruby-keyword kw">end</span>
|
|
421
|
-
202: <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">result</span>
|
|
422
|
-
203: <span class="ruby-keyword kw">rescue</span> <span class="ruby-constant">Errno</span><span class="ruby-operator">::</span><span class="ruby-constant">ECONNRESET</span>
|
|
423
|
-
204: <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">nil</span>
|
|
424
|
-
205: <span class="ruby-keyword kw">end</span>
|
|
425
|
-
</pre>
|
|
426
|
-
</div>
|
|
427
|
-
</div>
|
|
428
|
-
</div>
|
|
429
|
-
<div class="method">
|
|
430
|
-
<div class="title">
|
|
431
|
-
<a name="M000352"></a><b>read_scalar</b>(buffer = new_buffer, max_size = nil)
|
|
432
|
-
</div>
|
|
433
|
-
<div class="description">
|
|
434
|
-
<p>
|
|
435
|
-
Read a scalar message from the underlying <a href="../IO.html">IO</a>
|
|
436
|
-
object. Returns the <a href="MessageChannel.html#M000350">read</a> message,
|
|
437
|
-
or nil on end-of-stream.
|
|
438
|
-
</p>
|
|
439
|
-
<p>
|
|
440
|
-
Might raise SystemCallError, IOError or SocketError when something goes
|
|
441
|
-
wrong.
|
|
442
|
-
</p>
|
|
443
|
-
<p>
|
|
444
|
-
The <tt>buffer</tt> argument specifies a buffer in which <a
|
|
445
|
-
href="MessageChannel.html#M000352">#read_scalar</a> stores the <a
|
|
446
|
-
href="MessageChannel.html#M000350">read</a> data. It is good practice to
|
|
447
|
-
reuse existing buffers in order to minimize stress on the garbage
|
|
448
|
-
collector.
|
|
449
|
-
</p>
|
|
450
|
-
<p>
|
|
451
|
-
The <tt>max_size</tt> argument allows one to specify the maximum allowed
|
|
452
|
-
size for the scalar message. If the received scalar message‘s size is
|
|
453
|
-
larger than <tt>max_size</tt>, then a SecurityError will be raised.
|
|
454
|
-
</p>
|
|
455
|
-
</div>
|
|
456
|
-
<div class="sourcecode">
|
|
457
|
-
<p class="source-link">[ <a href="javascript:toggleSource('M000352_source')" id="l_M000352_source">show source</a> ]</p>
|
|
458
|
-
<div id="M000352_source" class="dyn-source">
|
|
459
|
-
<pre>
|
|
460
|
-
<span class="ruby-comment cmt"># File lib/phusion_passenger/message_channel.rb, line 220</span>
|
|
461
|
-
220: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">read_scalar</span>(<span class="ruby-identifier">buffer</span> = <span class="ruby-identifier">new_buffer</span>, <span class="ruby-identifier">max_size</span> = <span class="ruby-keyword kw">nil</span>)
|
|
462
|
-
221: <span class="ruby-keyword kw">if</span> <span class="ruby-operator">!</span><span class="ruby-ivar">@io</span>.<span class="ruby-identifier">read</span>(<span class="ruby-value">4</span>, <span class="ruby-identifier">buffer</span>)
|
|
463
|
-
222: <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">nil</span>
|
|
464
|
-
223: <span class="ruby-keyword kw">end</span>
|
|
465
|
-
224: <span class="ruby-keyword kw">while</span> <span class="ruby-identifier">buffer</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator"><</span> <span class="ruby-value">4</span>
|
|
466
|
-
225: <span class="ruby-identifier">tmp</span> = <span class="ruby-ivar">@io</span>.<span class="ruby-identifier">read</span>(<span class="ruby-value">4</span> <span class="ruby-operator">-</span> <span class="ruby-identifier">buffer</span>.<span class="ruby-identifier">size</span>)
|
|
467
|
-
226: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">tmp</span>.<span class="ruby-identifier">empty?</span>
|
|
468
|
-
227: <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">nil</span>
|
|
469
|
-
228: <span class="ruby-keyword kw">else</span>
|
|
470
|
-
229: <span class="ruby-identifier">buffer</span> <span class="ruby-operator"><<</span> <span class="ruby-identifier">tmp</span>
|
|
471
|
-
230: <span class="ruby-keyword kw">end</span>
|
|
472
|
-
231: <span class="ruby-keyword kw">end</span>
|
|
473
|
-
232:
|
|
474
|
-
233: <span class="ruby-identifier">size</span> = <span class="ruby-identifier">buffer</span>.<span class="ruby-identifier">unpack</span>(<span class="ruby-constant">UINT32_PACK_FORMAT</span>)[<span class="ruby-value">0</span>]
|
|
475
|
-
234: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">size</span> <span class="ruby-operator">==</span> <span class="ruby-value">0</span>
|
|
476
|
-
235: <span class="ruby-identifier">buffer</span>.<span class="ruby-identifier">replace</span>(<span class="ruby-value str">''</span>)
|
|
477
|
-
236: <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">buffer</span>
|
|
478
|
-
237: <span class="ruby-keyword kw">else</span>
|
|
479
|
-
238: <span class="ruby-keyword kw">if</span> <span class="ruby-operator">!</span><span class="ruby-identifier">max_size</span>.<span class="ruby-identifier">nil?</span> <span class="ruby-operator">&&</span> <span class="ruby-identifier">size</span> <span class="ruby-operator">></span> <span class="ruby-identifier">max_size</span>
|
|
480
|
-
239: <span class="ruby-identifier">raise</span> <span class="ruby-constant">SecurityError</span>, <span class="ruby-node">"Scalar message size (#{size}) "</span> <span class="ruby-operator"><<</span>
|
|
481
|
-
240: <span class="ruby-node">"exceeds maximum allowed size (#{max_size})."</span>
|
|
482
|
-
241: <span class="ruby-keyword kw">end</span>
|
|
483
|
-
242: <span class="ruby-keyword kw">if</span> <span class="ruby-operator">!</span><span class="ruby-ivar">@io</span>.<span class="ruby-identifier">read</span>(<span class="ruby-identifier">size</span>, <span class="ruby-identifier">buffer</span>)
|
|
484
|
-
243: <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">nil</span>
|
|
485
|
-
244: <span class="ruby-keyword kw">end</span>
|
|
486
|
-
245: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">buffer</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator"><</span> <span class="ruby-identifier">size</span>
|
|
487
|
-
246: <span class="ruby-identifier">tmp</span> = <span class="ruby-value str">''</span>
|
|
488
|
-
247: <span class="ruby-keyword kw">while</span> <span class="ruby-identifier">buffer</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator"><</span> <span class="ruby-identifier">size</span>
|
|
489
|
-
248: <span class="ruby-keyword kw">if</span> <span class="ruby-operator">!</span><span class="ruby-ivar">@io</span>.<span class="ruby-identifier">read</span>(<span class="ruby-identifier">size</span> <span class="ruby-operator">-</span> <span class="ruby-identifier">buffer</span>.<span class="ruby-identifier">size</span>, <span class="ruby-identifier">tmp</span>)
|
|
490
|
-
249: <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">nil</span>
|
|
491
|
-
250: <span class="ruby-keyword kw">else</span>
|
|
492
|
-
251: <span class="ruby-identifier">buffer</span> <span class="ruby-operator"><<</span> <span class="ruby-identifier">tmp</span>
|
|
493
|
-
252: <span class="ruby-keyword kw">end</span>
|
|
494
|
-
253: <span class="ruby-keyword kw">end</span>
|
|
495
|
-
254: <span class="ruby-keyword kw">end</span>
|
|
496
|
-
255: <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">buffer</span>
|
|
497
|
-
256: <span class="ruby-keyword kw">end</span>
|
|
498
|
-
257: <span class="ruby-keyword kw">rescue</span> <span class="ruby-constant">Errno</span><span class="ruby-operator">::</span><span class="ruby-constant">ECONNRESET</span>
|
|
499
|
-
258: <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">nil</span>
|
|
500
|
-
259: <span class="ruby-keyword kw">end</span>
|
|
501
|
-
</pre>
|
|
502
|
-
</div>
|
|
503
|
-
</div>
|
|
504
|
-
</div>
|
|
505
|
-
<div class="method">
|
|
506
|
-
<div class="title">
|
|
507
|
-
<a name="M000355"></a><b>recv_io</b>(klass = IO, negotiate = true)
|
|
508
|
-
</div>
|
|
509
|
-
<div class="description">
|
|
510
|
-
<p>
|
|
511
|
-
Receive an <a href="../IO.html">IO</a> object (a file descriptor) from the
|
|
512
|
-
channel. The other side must have sent an <a href="../IO.html">IO</a>
|
|
513
|
-
object by calling <a href="MessageChannel.html#M000356">send_io</a>(). Note
|
|
514
|
-
that this only works on Unix sockets.
|
|
515
|
-
</p>
|
|
516
|
-
<p>
|
|
517
|
-
Might raise SystemCallError, IOError or SocketError when something goes
|
|
518
|
-
wrong.
|
|
519
|
-
</p>
|
|
520
|
-
</div>
|
|
521
|
-
<div class="sourcecode">
|
|
522
|
-
<p class="source-link">[ <a href="javascript:toggleSource('M000355_source')" id="l_M000355_source">show source</a> ]</p>
|
|
523
|
-
<div id="M000355_source" class="dyn-source">
|
|
524
|
-
<pre>
|
|
525
|
-
<span class="ruby-comment cmt"># File lib/phusion_passenger/message_channel.rb, line 297</span>
|
|
526
|
-
297: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">recv_io</span>(<span class="ruby-identifier">klass</span> = <span class="ruby-constant">IO</span>, <span class="ruby-identifier">negotiate</span> = <span class="ruby-keyword kw">true</span>)
|
|
527
|
-
298: <span class="ruby-identifier">write</span>(<span class="ruby-value str">"pass IO"</span>) <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">negotiate</span>
|
|
528
|
-
299: <span class="ruby-identifier">io</span> = <span class="ruby-ivar">@io</span>.<span class="ruby-identifier">recv_io</span>(<span class="ruby-identifier">klass</span>)
|
|
529
|
-
300: <span class="ruby-identifier">write</span>(<span class="ruby-value str">"got IO"</span>) <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">negotiate</span>
|
|
530
|
-
301: <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">io</span>
|
|
531
|
-
302: <span class="ruby-keyword kw">end</span>
|
|
532
|
-
</pre>
|
|
533
|
-
</div>
|
|
534
|
-
</div>
|
|
535
|
-
</div>
|
|
536
|
-
<div class="method">
|
|
537
|
-
<div class="title">
|
|
538
|
-
<a name="M000356"></a><b>send_io</b>(io)
|
|
539
|
-
</div>
|
|
540
|
-
<div class="description">
|
|
541
|
-
<p>
|
|
542
|
-
Send an <a href="../IO.html">IO</a> object (a file descriptor) over the
|
|
543
|
-
channel. The other side must receive the <a href="../IO.html">IO</a> object
|
|
544
|
-
by calling <a href="MessageChannel.html#M000355">recv_io</a>(). Note that
|
|
545
|
-
this only works on Unix sockets.
|
|
546
|
-
</p>
|
|
547
|
-
<p>
|
|
548
|
-
Might raise SystemCallError, IOError or SocketError when something goes
|
|
549
|
-
wrong.
|
|
550
|
-
</p>
|
|
551
|
-
</div>
|
|
552
|
-
<div class="sourcecode">
|
|
553
|
-
<p class="source-link">[ <a href="javascript:toggleSource('M000356_source')" id="l_M000356_source">show source</a> ]</p>
|
|
554
|
-
<div id="M000356_source" class="dyn-source">
|
|
555
|
-
<pre>
|
|
556
|
-
<span class="ruby-comment cmt"># File lib/phusion_passenger/message_channel.rb, line 310</span>
|
|
557
|
-
310: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">send_io</span>(<span class="ruby-identifier">io</span>)
|
|
558
|
-
311: <span class="ruby-comment cmt"># We read a message before actually calling #send_io</span>
|
|
559
|
-
312: <span class="ruby-comment cmt"># in order to prevent the other side from accidentally</span>
|
|
560
|
-
313: <span class="ruby-comment cmt"># read()ing past the normal data and reading our file</span>
|
|
561
|
-
314: <span class="ruby-comment cmt"># descriptor too.</span>
|
|
562
|
-
315: <span class="ruby-comment cmt">#</span>
|
|
563
|
-
316: <span class="ruby-comment cmt"># For example suppose that side A looks like this:</span>
|
|
564
|
-
317: <span class="ruby-comment cmt">#</span>
|
|
565
|
-
318: <span class="ruby-comment cmt"># read(fd, buf, 1024)</span>
|
|
566
|
-
319: <span class="ruby-comment cmt"># read_io(fd)</span>
|
|
567
|
-
320: <span class="ruby-comment cmt">#</span>
|
|
568
|
-
321: <span class="ruby-comment cmt"># and side B:</span>
|
|
569
|
-
322: <span class="ruby-comment cmt">#</span>
|
|
570
|
-
323: <span class="ruby-comment cmt"># write(fd, buf, 100)</span>
|
|
571
|
-
324: <span class="ruby-comment cmt"># send_io(fd_to_pass)</span>
|
|
572
|
-
325: <span class="ruby-comment cmt">#</span>
|
|
573
|
-
326: <span class="ruby-comment cmt"># If B completes both write() and send_io(), then A's read() call</span>
|
|
574
|
-
327: <span class="ruby-comment cmt"># reads past the 100 bytes that B sent. On some platforms, like</span>
|
|
575
|
-
328: <span class="ruby-comment cmt"># Linux, this will cause read_io() to fail. And it just so happens</span>
|
|
576
|
-
329: <span class="ruby-comment cmt"># that Ruby's IO#read method slurps more than just the given amount</span>
|
|
577
|
-
330: <span class="ruby-comment cmt"># of bytes.</span>
|
|
578
|
-
331: <span class="ruby-identifier">result</span> = <span class="ruby-identifier">read</span>
|
|
579
|
-
332: <span class="ruby-keyword kw">if</span> <span class="ruby-operator">!</span><span class="ruby-identifier">result</span>
|
|
580
|
-
333: <span class="ruby-identifier">raise</span> <span class="ruby-constant">EOFError</span>, <span class="ruby-value str">"End of stream"</span>
|
|
581
|
-
334: <span class="ruby-keyword kw">elsif</span> <span class="ruby-identifier">result</span> <span class="ruby-operator">!=</span> [<span class="ruby-value str">"pass IO"</span>]
|
|
582
|
-
335: <span class="ruby-identifier">raise</span> <span class="ruby-constant">IOError</span>, <span class="ruby-value str">"IO passing pre-negotiation header expected"</span>
|
|
583
|
-
336: <span class="ruby-keyword kw">else</span>
|
|
584
|
-
337: <span class="ruby-ivar">@io</span>.<span class="ruby-identifier">send_io</span>(<span class="ruby-identifier">io</span>)
|
|
585
|
-
338: <span class="ruby-comment cmt"># Once you've sent the IO you expect to be able to close it on the</span>
|
|
586
|
-
339: <span class="ruby-comment cmt"># sender's side, even if the other side hasn't read the IO yet.</span>
|
|
587
|
-
340: <span class="ruby-comment cmt"># Not so: on some operating systems (I'm looking at you OS X) this</span>
|
|
588
|
-
341: <span class="ruby-comment cmt"># can cause the receiving side to receive a bad file descriptor.</span>
|
|
589
|
-
342: <span class="ruby-comment cmt"># The post negotiation protocol ensures that we block until the</span>
|
|
590
|
-
343: <span class="ruby-comment cmt"># other side has really received the IO.</span>
|
|
591
|
-
344: <span class="ruby-identifier">result</span> = <span class="ruby-identifier">read</span>
|
|
592
|
-
345: <span class="ruby-keyword kw">if</span> <span class="ruby-operator">!</span><span class="ruby-identifier">result</span>
|
|
593
|
-
346: <span class="ruby-identifier">raise</span> <span class="ruby-constant">EOFError</span>, <span class="ruby-value str">"End of stream"</span>
|
|
594
|
-
347: <span class="ruby-keyword kw">elsif</span> <span class="ruby-identifier">result</span> <span class="ruby-operator">!=</span> [<span class="ruby-value str">"got IO"</span>]
|
|
595
|
-
348: <span class="ruby-identifier">raise</span> <span class="ruby-constant">IOError</span>, <span class="ruby-value str">"IO passing post-negotiation header expected"</span>
|
|
596
|
-
349: <span class="ruby-keyword kw">end</span>
|
|
597
|
-
350: <span class="ruby-keyword kw">end</span>
|
|
598
|
-
351: <span class="ruby-keyword kw">end</span>
|
|
599
|
-
</pre>
|
|
600
|
-
</div>
|
|
601
|
-
</div>
|
|
602
|
-
</div>
|
|
603
|
-
<div class="method">
|
|
604
|
-
<div class="title">
|
|
605
|
-
<a name="M000353"></a><b>write</b>(name, *args)
|
|
606
|
-
</div>
|
|
607
|
-
<div class="description">
|
|
608
|
-
<p>
|
|
609
|
-
Send an array message, which consists of the given elements, over the
|
|
610
|
-
underlying file descriptor. <em>name</em> is the first element in the
|
|
611
|
-
message, and <em>args</em> are the other elements. These arguments will
|
|
612
|
-
internally be converted to strings by calling to_s().
|
|
613
|
-
</p>
|
|
614
|
-
<p>
|
|
615
|
-
Might raise SystemCallError, IOError or SocketError when something goes
|
|
616
|
-
wrong.
|
|
617
|
-
</p>
|
|
618
|
-
</div>
|
|
619
|
-
<div class="sourcecode">
|
|
620
|
-
<p class="source-link">[ <a href="javascript:toggleSource('M000353_source')" id="l_M000353_source">show source</a> ]</p>
|
|
621
|
-
<div id="M000353_source" class="dyn-source">
|
|
622
|
-
<pre>
|
|
623
|
-
<span class="ruby-comment cmt"># File lib/phusion_passenger/message_channel.rb, line 268</span>
|
|
624
|
-
268: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">write</span>(<span class="ruby-identifier">name</span>, <span class="ruby-operator">*</span><span class="ruby-identifier">args</span>)
|
|
625
|
-
269: <span class="ruby-identifier">check_argument</span>(<span class="ruby-identifier">name</span>)
|
|
626
|
-
270: <span class="ruby-identifier">args</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">arg</span><span class="ruby-operator">|</span>
|
|
627
|
-
271: <span class="ruby-identifier">check_argument</span>(<span class="ruby-identifier">arg</span>)
|
|
628
|
-
272: <span class="ruby-keyword kw">end</span>
|
|
629
|
-
273:
|
|
630
|
-
274: <span class="ruby-identifier">message</span> = <span class="ruby-node">"#{name}#{DELIMITER}"</span>
|
|
631
|
-
275: <span class="ruby-identifier">args</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">arg</span><span class="ruby-operator">|</span>
|
|
632
|
-
276: <span class="ruby-identifier">message</span> <span class="ruby-operator"><<</span> <span class="ruby-identifier">arg</span>.<span class="ruby-identifier">to_s</span> <span class="ruby-operator"><<</span> <span class="ruby-constant">DELIMITER</span>
|
|
633
|
-
277: <span class="ruby-keyword kw">end</span>
|
|
634
|
-
278: <span class="ruby-ivar">@io</span>.<span class="ruby-identifier">write</span>([<span class="ruby-identifier">message</span>.<span class="ruby-identifier">size</span>].<span class="ruby-identifier">pack</span>(<span class="ruby-value str">'n'</span>) <span class="ruby-operator"><<</span> <span class="ruby-identifier">message</span>)
|
|
635
|
-
279: <span class="ruby-ivar">@io</span>.<span class="ruby-identifier">flush</span>
|
|
636
|
-
280: <span class="ruby-keyword kw">end</span>
|
|
637
|
-
</pre>
|
|
638
|
-
</div>
|
|
639
|
-
</div>
|
|
640
|
-
</div>
|
|
641
|
-
<div class="method">
|
|
642
|
-
<div class="title">
|
|
643
|
-
<a name="M000354"></a><b>write_scalar</b>(data)
|
|
644
|
-
</div>
|
|
645
|
-
<div class="description">
|
|
646
|
-
<p>
|
|
647
|
-
Send a scalar message over the underlying <a href="../IO.html">IO</a>
|
|
648
|
-
object.
|
|
649
|
-
</p>
|
|
650
|
-
<p>
|
|
651
|
-
Might raise SystemCallError, IOError or SocketError when something goes
|
|
652
|
-
wrong.
|
|
653
|
-
</p>
|
|
654
|
-
</div>
|
|
655
|
-
<div class="sourcecode">
|
|
656
|
-
<p class="source-link">[ <a href="javascript:toggleSource('M000354_source')" id="l_M000354_source">show source</a> ]</p>
|
|
657
|
-
<div id="M000354_source" class="dyn-source">
|
|
658
|
-
<pre>
|
|
659
|
-
<span class="ruby-comment cmt"># File lib/phusion_passenger/message_channel.rb, line 286</span>
|
|
660
|
-
286: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">write_scalar</span>(<span class="ruby-identifier">data</span>)
|
|
661
|
-
287: <span class="ruby-ivar">@io</span>.<span class="ruby-identifier">write</span>([<span class="ruby-identifier">data</span>.<span class="ruby-identifier">size</span>].<span class="ruby-identifier">pack</span>(<span class="ruby-value str">'N'</span>) <span class="ruby-operator"><<</span> <span class="ruby-identifier">data</span>)
|
|
662
|
-
288: <span class="ruby-ivar">@io</span>.<span class="ruby-identifier">flush</span>
|
|
663
|
-
289: <span class="ruby-keyword kw">end</span>
|
|
664
|
-
</pre>
|
|
665
|
-
</div>
|
|
666
|
-
</div>
|
|
667
|
-
</div>
|
|
668
|
-
</div>
|
|
669
|
-
|
|
670
|
-
</div>
|
|
671
|
-
|
|
672
|
-
</body>
|
|
673
|
-
</html>
|