passenger-jmazzi 2.2.9

data/man/passenger-make-enterprisey.8

@@ -0,0 +1,23 @@
+.TH "passenger-make-enterprisey" "8" "2.0" "Phusion Passenger" "Adminstration Commands"
+.SH "NAME"
+.LP 
+passenger\-make-enterprisey \- activate your Phusion passenger enterprise licence
+.SH "SYNOPSIS"
+.LP 
+\fBpassenger\-make\-enterprisey
+.SH "DESCRIPTION"
+.LP 
+\fBpassenger\-make\-enterprisey\fR changes your ordinary everyday version of Phusion Passenger into a special enterprise version just as soon as you type in your licence key.
+.LP
+As everybody working at enterprise level knows, enterprise software is so much better in every possible way. So make sure you pick up your licence key today.
+.SH "SEE ALSO"
+Phusion Passenger Enterprise Programme (http://www.modrails.com/enterprise.html)
+.SH "AUTHOR"
+.LP 
+Phusion Passenger is written by Phusion (http://www.phusion.nl)
+.LP 
+"Phusion" and "Phusion Passenger" are trademarks of Hongli Lai & Ninh Bui.
+.LP 
+This manual page was written by Neil Wilson <neil@brightbox.co.uk> for the Ubuntu project (but may be used by others). 
+.SH "CAVEATS"
+Whatever you do don't look at the source code.

data/man/passenger-memory-stats.8

@@ -0,0 +1,33 @@
+.TH "passenger-memory-stats" "8" "2.0" "Phusion Passenger" "Administration Commands"
+.SH "NAME"
+.LP 
+passenger\-memory\-stats \- reports a snapshot of the Apache and Phusion Passenger memory statistcs
+.SH "SYNOPSIS"
+.LP 
+\fBpassenger\-memory\-stats\fR
+.SH "DESCRIPTION"
+.LP 
+\fBpassenger\-memory\-stats\fR allows you to easily analyze the real memory usage of Phusion Passenger and Apache.
+.LP 
+Process inspection tools such as \fIps\fR and \fItop\fR are useful, but they rarely show the correct memory usage. The real memory usage is usually lower than what \fIps\fR and \fItop\fR report.
+.LP 
+There are many technical reasons why this is so, but an explanation is beyond the scope of this page. We refer the interested reader to operating systems literature about virtual memory and copy\-on\-write.
+.LP 
+When you run this tool the \fIPrivate\fR or \fIprivate dirty RSS\fR field shows the real memory usage of processes.
+.SH "ENVIRONMENT VARIABLES"
+.LP 
+.TP 
+\fBHTTPD\fR
+The full filename to the Apache executable. By default, Passenger will attempt to autodetect the Apache executable. If autodetection fails for whatever reason, then Apache processes will not be shown in the memory statistics. In that case, you may manually specify the location to the Apache executable using this environment variable.
+.SH "SEE ALSO"
+.LP 
+passenger\-status(8), ps(1), top(1), 
+.LP 
+User guide at http://www.modrails.com/documentation.html
+.SH "AUTHOR"
+.LP 
+Phusion Passenger is written by Phusion (http://www.phusion.nl)
+.LP 
+"Phusion" and "Phusion Passenger" are trademarks of Hongli Lai & Ninh Bui.
+.LP 
+This manual page was written by Neil Wilson <neil@brightbox.co.uk> for the Ubuntu project (but may be used by others). 

data/man/passenger-status.8

@@ -0,0 +1,43 @@
+.TH "passenger-status" "8" "2.0" "Phusion Passenger" "Adminstration Commands"
+.SH "NAME"
+.LP 
+passenger\-status \- inspect Phusion Passenger's internal status
+.SH "SYNOPSIS"
+.LP 
+\fBpassenger\-status\fR [\fIpid\fR]
+.SH "DESCRIPTION"
+.LP 
+\fBpassenger\-status\fR looks at the current status of a Phusion Passenger installation. It will locate Phusion Passenger automatically if it is running and will give you a list of instances if there is more than one Phusion Passenger instance running. You can then select the instance by specifying the relevant PID on the command line.
+.LP 
+The \fIgeneral information\fR section shows the following details:
+.TP 
+max
+The maximum number of application instances that Phusion Passenger will spawn. This equals the value given for \fIPassengerMaxPoolSize\fR in the configuration.
+.TP 
+count
+The number of application instances that are currently alive. This value is always less than or equal to \fImax\fR.
+.TP 
+active
+The number of application instances that are currently processing requests. This value is always less than or equal to \fIcount\fR.
+.TP  
+inactive
+The number of application instances that are currently not processing requests, i.e. are idle. Idle application instances will be shutdown after a while, as can be specified with \fIPassengerPoolIdleTime\fR in the configuration. The value of \fIinactive\fR equals \fIcount\fR \- \fIactive\fR.
+.LP 
+The \fIapplications\fR section shows each application instance, which directory it belongs to. The \fIsessions\fR field shows how many HTTP client are currently being processed by that application instance.
+.SH "OPTIONS"
+.LP 
+.TP 
+\fBpid\fR
+The process ID of the Phusion Passenger instance you want to look at
+.SH "SEE ALSO"
+.LP 
+passenger\-memory\-stats(8), ps(1), top(1)
+.LP 
+User guide at http://www.modrails.com/documentation.html
+.SH "AUTHOR"
+.LP 
+Phusion Passenger is written by Phusion (http://www.phusion.nl)
+.LP 
+"Phusion" and "Phusion Passenger" are trademarks of Hongli Lai & Ninh Bui.
+.LP 
+This manual page was written by Neil Wilson <neil@brightbox.co.uk> for the Ubuntu project (but may be used by others). 

data/man/passenger-stress-test.1

@@ -0,0 +1,43 @@
+.TH "passenger-stress-test" "1" "2.0" "Phusion Passenger" "User Commands"
+.SH "NAME"
+.LP 
+passenger\-stress\-test \- stress tests a Phusion Passenger powered website.
+.SH "SYNOPSIS"
+.LP 
+\fBpassenger\-stress\-test\fR <\fIhostname\fR> <\fIapp_roo\fRt> [\fIoptions\fR]
+.SH "DESCRIPTION"
+.LP 
+Stress test the given (Phusion Passenger\-powered) website by
+.LP 
+\- crawling it with multiple concurrently running crawlers.
+.LP   
+\- gracefully restarting Apache at random times
+.LP 
+\- restarting the target (Phusion Passenger\-powered) application at random times
+.SH "OPTIONS"
+.LP 
+.TP 
+\fB\-c, \-\-concurrency\fR <\fInumber\fR>
+Number of crawlers to start (default = 20)
+.TP 
+\fB\-p, \-\-apache\-restart\-interval\fR <\fIinterval\fR>
+Gracefully restart Apache after <\fIinterval\fR> minutes (default = 1440)
+.TP 
+\fB\-a, \-\-app\-restart\-interval\fR <\fIinterval\fR>
+Restart the application after <\fIinterval\fR> minutes (default = 55)
+.TP 
+\fB\-h, \-\-help\fR
+Output help information and exit.
+
+.SH "SEE ALSO"
+.LP 
+passenger\-config(1), passenger\-memory\-stats(8), passenger\-status(8)
+.LP 
+User guide at http://www.modrails.com/documentation.html
+.SH "AUTHOR"
+.LP 
+Phusion Passenger is written by Phusion (http://www.phusion.nl)
+.LP 
+"Phusion" and "Phusion Passenger" are trademarks of Hongli Lai & Ninh Bui.
+.LP 
+This manual page was written by Neil Wilson <neil@brightbox.co.uk> for the Ubuntu project (but may be used by others). 

data/misc/copy_boost_headers.rb

@@ -0,0 +1,125 @@
+#!/usr/bin/env ruby
+#  Phusion Passenger - http://www.modrails.com/
+#  Copyright (c) 2008, 2009 Phusion
+#
+#  "Phusion Passenger" is a trademark of Hongli Lai & Ninh Bui.
+#
+#  Permission is hereby granted, free of charge, to any person obtaining a copy
+#  of this software and associated documentation files (the "Software"), to deal
+#  in the Software without restriction, including without limitation the rights
+#  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+#  copies of the Software, and to permit persons to whom the Software is
+#  furnished to do so, subject to the following conditions:
+#
+#  The above copyright notice and this permission notice shall be included in
+#  all copies or substantial portions of the Software.
+#
+#  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+#  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+#  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+#  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+#  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+#  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+#  THE SOFTWARE.
+
+ESSENTIALS = [
+	"boost/detail/{limits,endian}.hpp",
+	"boost/config/*",
+	"boost/detail/sp_counted_*",
+	"boost/detail/atomic_count*",
+	"libs/thread/src/*"
+]
+PROGRAM_SOURCE = %q{
+	#include <boost/shared_ptr.hpp>
+	#include <boost/thread.hpp>
+	#include <boost/function.hpp>
+	#include <boost/bind.hpp>
+	#include <boost/date_time/posix_time/posix_time.hpp>
+}
+BOOST_DIR = ARGV[0]
+Dir.chdir(File.dirname(__FILE__) + "/../ext")
+
+# Run the given command, and abort on error.
+def sh(*command)
+	puts command.join(" ")
+	if !system(*command)
+		puts "*** ERROR"
+		exit 1
+	end
+end
+
+def install(source_filename, target_filename)
+	command = ["install", "-D", "--mode=u+rw,g+r,o+r", source_filename, target_filename]
+	sh(*command)
+end
+
+def copy_boost_files(*patterns)
+	patterns.each do |pattern|
+		Dir["#{BOOST_DIR}/#{pattern}"].each do |source|
+			if File.directory?(source)
+				source.slice!(0 .. BOOST_DIR.size)
+				copy_boost_files("#{source}/*")
+			else
+				target = source.slice(BOOST_DIR.size + 1 .. source.size - 1)
+				target.sub!(%r{^libs/thread/}, 'boost/')
+				if !File.exist?(target)
+					install(source, target)
+				end
+			end
+		end
+	end
+end
+
+def copy_essential_files
+	copy_boost_files(*ESSENTIALS)
+end
+
+def prepare
+	File.open("test.cpp", "w") do |f|
+		f.write(PROGRAM_SOURCE)
+	end
+end
+
+def cleanup
+	File.unlink("test.cpp") rescue nil
+end
+
+# Compile PROGRAM_SOURCE and copy whatever missing header files the compiler needs.
+def copy_dependencies
+	done = false
+	while !done
+		missing_headers = `g++ test.cpp -c -I. 2>&1`.
+		  split("\n").
+		  grep(/error: .*: No such file/).
+		  map do |line|
+			file = line.sub(/.*error: (.*): .*/, '\1')
+			if file =~ /^boost\//
+				file
+			else
+				line =~ /(.*?):/
+				source = $1
+				File.dirname(source) + "/" + file
+			end
+		end
+		missing_headers.each do |header|
+			install("#{BOOST_DIR}/#{header}", header)
+		end
+		done = missing_headers.empty?
+	end
+end
+
+def start
+	if BOOST_DIR.nil? || BOOST_DIR.empty?
+		puts "Usage: copy_boost_headers.rb <boost source directory>"
+		exit 1
+	end
+	begin
+		prepare
+		copy_essential_files
+		copy_dependencies
+	ensure
+		cleanup
+	end
+end
+
+start

data/misc/find_owner_pipe_leaks.rb

@@ -0,0 +1,128 @@
+#!/usr/bin/env ruby
+#  Phusion Passenger - http://www.modrails.com/
+#  Copyright (c) 2008, 2009 Phusion
+#
+#  "Phusion Passenger" is a trademark of Hongli Lai & Ninh Bui.
+#
+#  Permission is hereby granted, free of charge, to any person obtaining a copy
+#  of this software and associated documentation files (the "Software"), to deal
+#  in the Software without restriction, including without limitation the rights
+#  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+#  copies of the Software, and to permit persons to whom the Software is
+#  furnished to do so, subject to the following conditions:
+#
+#  The above copyright notice and this permission notice shall be included in
+#  all copies or substantial portions of the Software.
+#
+#  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+#  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+#  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+#  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+#  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+#  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+#  THE SOFTWARE.
+##############################################################################
+# A script for finding owner pipe leaks in Apache. An owner pipe is considered
+# to be leaked if it is owned by two or more Apache processes.
+#
+# This script only works on Linux. Only run it when Apache is idle.
+
+$LOAD_PATH << "#{File.dirname(__FILE__)}/../lib"
+require 'set'
+require 'passenger/platform_info'
+
+include PlatformInfo
+
+def list_pids
+	Dir.chdir("/proc") do
+		return Dir["*"].select do |x|
+			x =~ /^\d+$/
+		end
+	end
+end
+
+def list_pipes(pid)
+	pipes = []
+	Dir["/proc/#{pid}/fd/*"].each do |file|
+		if File.symlink?(file) && File.readlink(file) =~ /^pipe:\[(.*)\]$/
+			pipes << $1
+		end
+	end
+	return pipes
+end
+
+def is_rails_app(pid)
+	return File.read("/proc/#{pid}/cmdline") =~ /^Rails: /
+end
+
+def is_apache(pid)
+	begin
+		return File.readlink("/proc/#{pid}/exe") == HTTPD
+	rescue
+		return false
+	end
+end
+
+# Returns a pair of these items:
+# - The owner pipe map. Maps a Rails application's PID to to its owner pipe's ID.
+# - The reverse map. Maps an owner pipe ID to the Rail application's PID.
+def create_owner_pipe_map
+	map = {}
+	reverse_map = {}
+	list_pids.select{ |x| is_rails_app(x) }.each do |pid|
+		owner_pipe = list_pipes(pid).first
+		map[pid] = owner_pipe
+		reverse_map[owner_pipe] = pid
+	end
+	return [map, reverse_map]
+end
+
+def show_owner_pipe_listing(map, reverse_map)
+	puts "------------ Owner pipe listing ------------"
+	count = 0
+	list_pids.select{ |x| is_apache(x) }.sort.each do |pid|
+		list_pipes(pid).select do |pipe|
+			reverse_map.has_key?(pipe)
+		end.each do |pipe|
+			puts "Apache PID #{pid} holds the owner pipe (#{pipe}) " <<
+				"for Rails PID #{reverse_map[pipe]}"
+			count += 1
+		end
+	end
+	if count == 0
+		puts "(none)"
+	end
+	puts ""
+end
+
+def show_owner_pipe_leaks(map, reverse_map)
+	apache_owner_pipe_map = {}
+	list_pids.select{ |x| is_apache(x) }.sort.each do |pid|
+		list_pipes(pid).select do |pipe|
+			reverse_map.has_key?(pipe)
+		end.each do |pipe|
+			apache_owner_pipe_map[pipe] ||= []
+			apache_owner_pipe_map[pipe] << pid
+		end
+	end
+	
+	puts "------------ Leaks ------------"
+	count = 0
+	apache_owner_pipe_map.each_pair do |pipe, pids|
+		if pids.size >= 2
+			puts "Rails PID #{reverse_map[pipe]} owned by Apache processes: #{pids.join(", ")}"
+			count += 1
+		end
+	end
+	if count == 0
+		puts "(none)"
+	end
+end
+
+def start
+	map, reverse_map = create_owner_pipe_map
+	show_owner_pipe_listing(map, reverse_map)
+	show_owner_pipe_leaks(map, reverse_map)
+end
+
+start

data/misc/rake/cplusplus.rb

@@ -0,0 +1,57 @@
+#  Phusion Passenger - http://www.modrails.com/
+#  Copyright (c) 2008, 2009 Phusion
+#
+#  "Phusion Passenger" is a trademark of Hongli Lai & Ninh Bui.
+#
+#  Permission is hereby granted, free of charge, to any person obtaining a copy
+#  of this software and associated documentation files (the "Software"), to deal
+#  in the Software without restriction, including without limitation the rights
+#  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+#  copies of the Software, and to permit persons to whom the Software is
+#  furnished to do so, subject to the following conditions:
+#
+#  The above copyright notice and this permission notice shall be included in
+#  all copies or substantial portions of the Software.
+#
+#  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+#  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+#  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+#  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+#  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+#  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+#  THE SOFTWARE.
+
+# Rake functions for compiling/linking C++ stuff.
+
+def compile_c(source, flags = "#{PlatformInfo.portability_cflags} #{EXTRA_CXXFLAGS}")
+	sh "#{CC} #{flags} -c #{source}"
+end
+
+def compile_cxx(source, flags = "#{PlatformInfo.portability_cflags} #{EXTRA_CXXFLAGS}")
+	sh "#{CXX} #{flags} -c #{source}"
+end
+
+def create_static_library(target, sources)
+	# On OS X, 'ar cru' will sometimes fail with an obscure error:
+	#
+	#   ar: foo.a is a fat file (use libtool(1) or lipo(1) and ar(1) on it)
+	#   ar: foo.a: Inappropriate file type or format
+	#
+	# So here we delete the ar file before creating it, which bypasses this problem.
+	sh "rm -rf #{target}"
+	sh "ar cru #{target} #{sources}"
+	sh "ranlib #{target}"
+end
+
+def create_executable(target, sources, linkflags = "#{PlatformInfo.portability_cflags} #{EXTRA_CXXFLAGS} #{PlatformInfo.portability_ldflags} #{EXTRA_LDFLAGS}")
+	sh "#{CXX} #{sources} -o #{target} #{linkflags}"
+end
+
+def create_shared_library(target, sources, flags = "#{PlatformInfo.portability_cflags} #{EXTRA_CXXFLAGS} #{PlatformInfo.portability_ldflags} #{EXTRA_LDFLAGS}")
+	if RUBY_PLATFORM =~ /darwin/
+		shlib_flag = "-flat_namespace -bundle -undefined dynamic_lookup"
+	else
+		shlib_flag = "-shared"
+	end
+	sh "#{CXX} #{shlib_flag} #{sources} -fPIC -o #{target} #{flags}"
+end