rockdog-passenger 0.0.1

data/lib/rake/rdoctask.rb

@@ -0,0 +1,209 @@
+#!/usr/bin/env ruby
+
+require 'rake'
+require 'rake/tasklib'
+
+module Rake
+
+  # Create a documentation task that will generate the RDoc files for
+  # a project.
+  #
+  # The RDocTask will create the following targets:
+  #
+  # [<b>:<em>rdoc</em></b>]
+  #   Main task for this RDOC task.  
+  #
+  # [<b>:clobber_<em>rdoc</em></b>]
+  #   Delete all the rdoc files.  This target is automatically
+  #   added to the main clobber target.
+  #
+  # [<b>:re<em>rdoc</em></b>]
+  #   Rebuild the rdoc files from scratch, even if they are not out
+  #   of date.
+  #
+  # Simple example:
+  #
+  #   Rake::RDocTask.new do |rd|
+  #     rd.main = "README.rdoc"
+  #     rd.rdoc_files.include("README.rdoc", "lib/**/*.rb")
+  #   end
+  #
+  # The +rd+ object passed to the block is an RDocTask object. See the
+  # attributes list for the RDocTask class for available customization options.
+  #
+  # == Specifying different task names
+  #
+  # You may wish to give the task a different name, such as if you are
+  # generating two sets of documentation.  For instance, if you want to have a
+  # development set of documentation including private methods:
+  #
+  #   Rake::RDocTask.new(:rdoc_dev) do |rd|
+  #     rd.main = "README.doc"
+  #     rd.rdoc_files.include("README.rdoc", "lib/**/*.rb")
+  #     rd.options << "--all"
+  #   end
+  #
+  # The tasks would then be named :<em>rdoc_dev</em>, :clobber_<em>rdoc_dev</em>, and
+  # :re<em>rdoc_dev</em>. 
+  #
+  # If you wish to have completely different task names, then pass a Hash as
+  # first argument. With the <tt>:rdoc</tt>, <tt>:clobber_rdoc</tt> and
+  # <tt>:rerdoc</tt> options, you can customize the task names to your liking.
+  # For example:
+  #
+  #   Rake::RDocTask.new(:rdoc => "rdoc", :clobber_rdoc => "rdoc:clean", :rerdoc => "rdoc:force")
+  #
+  # This will create the tasks <tt>:rdoc</tt>, <tt>:rdoc_clean</tt> and
+  # <tt>:rdoc:force</tt>.
+  #
+  class RDocTask < TaskLib
+    # Name of the main, top level task.  (default is :rdoc)
+    attr_accessor :name
+
+    # Name of directory to receive the html output files. (default is "html")
+    attr_accessor :rdoc_dir
+
+    # Title of RDoc documentation. (defaults to rdoc's default)
+    attr_accessor :title
+
+    # Name of file to be used as the main, top level file of the
+    # RDoc. (default is none)
+    attr_accessor :main
+
+    # Name of template to be used by rdoc. (defaults to rdoc's default)
+    attr_accessor :template
+
+    # List of files to be included in the rdoc generation. (default is [])
+    attr_accessor :rdoc_files
+
+    # Additional list of options to be passed rdoc.  (default is [])
+    attr_accessor :options
+
+    # Whether to run the rdoc process as an external shell (default is false)
+    attr_accessor :external
+    
+    attr_accessor :inline_source
+
+    # Create an RDoc task with the given name. See the RDocTask class overview
+    # for documentation.
+    def initialize(name = :rdoc)  # :yield: self
+      if name.is_a?(Hash)
+        invalid_options = name.keys.map { |k| k.to_sym } - [:rdoc, :clobber_rdoc, :rerdoc]
+        if !invalid_options.empty?
+          raise ArgumentError, "Invalid option(s) passed to RDocTask.new: #{invalid_options.join(", ")}"
+        end
+      end
+      
+      @name = name
+      @rdoc_files = Rake::FileList.new
+      @rdoc_dir = 'html'
+      @main = nil
+      @title = nil
+      @template = nil
+      @external = false
+      @inline_source = true
+      @options = []
+      yield self if block_given?
+      define
+    end
+    
+    # Create the tasks defined by this task lib.
+    def define
+      if rdoc_task_name != "rdoc"
+        desc "Build the RDOC HTML Files"
+      else
+        desc "Build the #{rdoc_task_name} HTML Files"
+      end
+      task rdoc_task_name
+      
+      desc "Force a rebuild of the RDOC files"
+      task rerdoc_task_name => [clobber_task_name, rdoc_task_name]
+      
+      desc "Remove rdoc products" 
+      task clobber_task_name do
+        rm_r rdoc_dir rescue nil
+      end
+      
+      task :clobber => [clobber_task_name]
+      
+      directory @rdoc_dir
+      task rdoc_task_name => [rdoc_target]
+      file rdoc_target => @rdoc_files + [Rake.application.rakefile] do
+        rm_r @rdoc_dir rescue nil
+        @before_running_rdoc.call if @before_running_rdoc
+        args = option_list + @rdoc_files
+        if @external
+          argstring = args.join(' ')
+          sh %{ruby -Ivendor vender/rd #{argstring}}
+        else
+          require 'rdoc/rdoc'
+          RDoc::RDoc.new.document(args)
+        end
+      end
+      self
+    end
+
+    def option_list
+      result = @options.dup
+      result << "-o" << @rdoc_dir
+      result << "--main" << quote(main) if main
+      result << "--title" << quote(title) if title
+      result << "-T" << quote(template) if template
+      result << "--inline-source" if inline_source && !@options.include?("--inline-source") && !@options.include?("-S")
+      result
+    end
+
+    def quote(str)
+      if @external
+        "'#{str}'"
+      else
+        str
+      end
+    end
+
+    def option_string
+      option_list.join(' ')
+    end
+    
+    # The block passed to this method will be called just before running the
+    # RDoc generator. It is allowed to modify RDocTask attributes inside the
+    # block.
+    def before_running_rdoc(&block)
+      @before_running_rdoc = block
+    end
+
+    private
+    
+    def rdoc_target
+      "#{rdoc_dir}/index.html"
+    end
+    
+    def rdoc_task_name
+      case name
+      when Hash
+        (name[:rdoc] || "rdoc").to_s
+      else
+        name.to_s
+      end
+    end
+    
+    def clobber_task_name
+      case name
+      when Hash
+        (name[:clobber_rdoc] || "clobber_rdoc").to_s
+      else
+        "clobber_#{name}"
+      end
+    end
+    
+    def rerdoc_task_name
+      case name
+      when Hash
+        (name[:rerdoc] || "rerdoc").to_s
+      else
+        "re#{name}"
+      end
+    end
+
+  end
+end

data/man/passenger-config.1

@@ -0,0 +1,29 @@
+.TH "passenger-config" "1" "2.0" "Phusion Passenger" "User Commands"
+.SH "NAME"
+.LP 
+passenger\-config \- Show configuration settings for Phusion Passenger
+.SH "SYNOPSIS"
+.LP 
+\fBpassenger\-config\fR \fI\-\-root\fR | \fI\-\-version\fR
+.SH "DESCRIPTION"
+.LP 
+\fBpassenger\-config\fR shows the current configuration settings for Phusion Passenger. You need to select one of the following options.
+.SH "OPTIONS"
+.TP 
+\fB\-\-root\fR
+Shows the Phusion Passenger root directory
+.TP 
+\fB\-\-version\fR
+Shows the current Phusion Passenger version number
+.SH "SEE ALSO"
+.LP 
+passenger\-memory\-stats(1), passenger\-stress\-test(1), 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/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,102 @@
+#!/usr/bin/env ruby
+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