passenger 5.0.21 → 5.0.22

data/src/ruby_supportlib/phusion_passenger/config/restart_app_command.rb

@@ -258,6 +258,9 @@ module PhusionPassenger
         elsif response.code.to_i == 401
           if response["pool-empty"] == "true"
             REXML::Document.new('<?xml version="1.0" encoding="iso8859-1"?><info version="3"></info>')
+          elsif @options[:ignore_app_not_running]
+            print_instance_querying_permission_error
+            exit
           else
             print_instance_querying_permission_error
             abort

data/src/ruby_supportlib/phusion_passenger/config/utils.rb

@@ -105,16 +105,18 @@ module PhusionPassenger
         abort
       end
 
-      def list_all_passenger_instances(instances)
-        puts "The following #{PROGRAM_NAME} instances are running:"
-        puts
-        printf "%-25s  %s\n", "Name", "Description"
-        puts "------------------------------------------------------------------"
+      def list_all_passenger_instances(instances, print_preamble = true)
+        if print_preamble
+          puts "The following #{PROGRAM_NAME} instances are running:"
+          puts
+        end
+        printf "%-25s  %-7s  %s\n", "Name", "PID", "Description"
+        puts "--------------------------------------------------------------------------"
         if instances.empty?
-          printf "%-25s  %s\n", "(list empty)", "-"
+          printf "%-25s  %-7s  %s\n", "(list empty)", "-", "-"
         else
           instances.each do |instance|
-            printf "%-25s  %s\n", instance.name, instance.server_software
+            printf "%-25s  %-7s  %s\n", instance.name, instance.watchdog_pid, instance.server_software
           end
         end
       end

data/src/ruby_supportlib/phusion_passenger/config/validate_install_command.rb

@@ -252,6 +252,7 @@ module PhusionPassenger
 
         paths.delete(try_realpath(gem_bindir))
         paths.delete(try_realpath(homebrew_bindir))
+        paths.delete(try_realpath(rbenv_shims_dir))
         paths.delete(try_realpath(PhusionPassenger.bin_dir))
         paths.uniq!
 
@@ -621,6 +622,12 @@ module PhusionPassenger
         end
       end
 
+      # Returns the ~/.rbenv/shims directory if it exists.
+      def rbenv_shims_dir
+        home = PhusionPassenger.home_dir
+        "#{home}/.rbenv/shims"
+      end
+
       def logn(message)
         STDOUT.write(@colors.ansi_colorize(message))
         STDOUT.flush
@@ -726,7 +733,7 @@ module PhusionPassenger
         if path
           begin
             Pathname.new(path).realpath.to_s
-          rescue Errno::ENOENT, Errno::EACCES
+          rescue Errno::ENOENT, Errno::EACCES, Errno::ENOTDIR
             path
           end
         else

data/src/ruby_supportlib/phusion_passenger/constants.rb

@@ -25,6 +25,7 @@
 module PhusionPassenger
   PASSENGER_TXN_ID            = "PASSENGER_TXN_ID".freeze
   PASSENGER_APP_GROUP_NAME    = "PASSENGER_APP_GROUP_NAME".freeze
+  PASSENGER_DELTA_MONOTONIC   = "PASSENGER_DELTA_MONOTONIC".freeze
   RACK_HIJACK_IO              = "rack.hijack_io".freeze
 
   LVL_CRIT   = 0
@@ -59,6 +60,7 @@ module PhusionPassenger
     DEFAULT_STICKY_SESSIONS_COOKIE_NAME = "_passenger_route"
     DEFAULT_APP_THREAD_COUNT = 1
     DEFAULT_RESPONSE_BUFFER_HIGH_WATERMARK = 1024 * 1024 * 128
+    DEFAULT_MAX_REQUEST_QUEUE_SIZE = 100
     DEFAULT_STAT_THROTTLE_RATE = 10
     DEFAULT_ANALYTICS_LOG_USER = DEFAULT_WEB_APP_USER
     DEFAULT_ANALYTICS_LOG_GROUP = ""
@@ -83,7 +85,7 @@ module PhusionPassenger
     # Versions
     PASSENGER_VERSION = PhusionPassenger::VERSION_STRING
     PASSENGER_API_VERSION_MAJOR = 0
-    PASSENGER_API_VERSION_MINOR = 2
+    PASSENGER_API_VERSION_MINOR = 3
     PASSENGER_API_VERSION = "#{PASSENGER_API_VERSION_MAJOR}.#{PASSENGER_API_VERSION_MINOR}"
     SERVER_INSTANCE_DIR_STRUCTURE_MAJOR_VERSION = 3
     SERVER_INSTANCE_DIR_STRUCTURE_MINOR_VERSION = 0

data/src/ruby_supportlib/phusion_passenger/native_support.rb

@@ -309,10 +309,26 @@ module PhusionPassenger
       options = { :logger => logger }
       begin
         try_directories(target_dirs, options) do |target_dir|
-          result =
-            sh_nonfatal("#{PlatformInfo.ruby_command} #{Shellwords.escape extconf_rb}",
-              options) &&
-            sh_nonfatal("make clean && make", options)
+          result = nil
+          # Perform the actual compilation in a temporary directory to avoid
+          # problems with multiple processes trying to concurrently compile.
+          # https://github.com/phusion/passenger/issues/1570
+          PhusionPassenger::Utils.mktmpdir("passenger-native-support-") do |tmpdir|
+            Dir.chdir(tmpdir) do
+              result =
+                sh_nonfatal("#{PlatformInfo.ruby_command} #{Shellwords.escape extconf_rb}",
+                  options) &&
+                sh_nonfatal("make", options)
+              if result
+                begin
+                  FileUtils.cp_r(".", target_dir)
+                rescue SystemCallError => e
+                  log("Error: #{e}")
+                  result = false
+                end
+              end
+            end
+          end
           if result
             log "Compilation succesful. The logs are here:"
             log logger.path

data/src/ruby_supportlib/phusion_passenger/nginx/config_options.rb

@@ -306,6 +306,14 @@ LOCATION_CONFIGURATION_OPTIONS = [
     :name   => 'passenger_vary_turbocache_by_cookie',
     :type   => :string
   },
+  {
+    :name   => 'passenger_abort_websockets_on_process_shutdown',
+    :type   => :flag
+  },
+  {
+    :name   => 'passenger_force_max_concurrent_requests_per_process',
+    :type   => :integer
+  },
 
   ###### Enterprise features ######
   {

data/src/ruby_supportlib/phusion_passenger/packaging.rb

@@ -95,6 +95,7 @@ module PhusionPassenger
     EXCLUDE_GLOB = [
       '**/.DS_Store',
       '.gitignore',
+      '.gitattributes',
       '.gitmodules',
       '.travis.yml',
       '.settings/*',

data/src/ruby_supportlib/phusion_passenger/platform_info/apache_detector.rb

@@ -288,7 +288,7 @@ module PhusionPassenger
         if path
           begin
             Pathname.new(path).realpath.to_s
-          rescue Errno::ENOENT, Errno::EACCES
+          rescue Errno::ENOENT, Errno::EACCES, Errno::ENOTDIR
             path
           end
         else

data/src/ruby_supportlib/phusion_passenger/platform_info/operating_system.rb

@@ -1,5 +1,5 @@
 #  Phusion Passenger - https://www.phusionpassenger.com/
-#  Copyright (c) 2010-2013 Phusion Holding B.V.
+#  Copyright (c) 2010-2015 Phusion Holding B.V.
 #
 #  "Passenger", "Phusion Passenger" and "Union Station" are registered
 #  trademarks of Phusion Holding B.V.
@@ -34,11 +34,13 @@ module PhusionPassenger
     # Identifiers for other operating systems may contain a version number, e.g. "freebsd10".
     def self.os_name
       if rb_config['target_os'] =~ /darwin/ && (sw_vers = find_command('sw_vers'))
-        return "macosx"
+        'macosx'
       elsif rb_config['target_os'] =~ /^linux-/
-        return "linux"
+        'linux'
+      elsif rb_config['target_os'] =~ /solaris/
+        'solaris'
       else
-        return rb_config['target_os']
+        rb_config['target_os']
       end
     end
     memoize :os_name
@@ -148,6 +150,11 @@ module PhusionPassenger
     end
     memoize :cpu_architectures, true
 
+    # Returns whether the flock() function is supported on this OS.
+    def self.supports_flock?
+      defined?(File::LOCK_EX) && os_name != 'solaris'
+    end
+
     # Returns whether the OS's main CPU architecture supports the
     # x86/x86_64 sfence instruction.
     def self.supports_sfence_instruction?

data/src/ruby_supportlib/phusion_passenger/rack/thread_handler_extension.rb

@@ -241,7 +241,7 @@ module PhusionPassenger
             # Disallowed by the HTTP spec
             raise "Response object may not contain both Content-Length and Transfer-Encoding"
           end
-        else
+        elsif output_body
           # The app has set neither the Content-Length nor the Transfer-Encoding
           # header. This means we'll have to add one of those headers. We know exactly how
           # big our body will be, so we can keep-alive the connection.

data/src/ruby_supportlib/phusion_passenger/standalone/config_options_list.rb

@@ -0,0 +1,647 @@
+#  Phusion Passenger - https://www.phusionpassenger.com/
+#  Copyright (c) 2015 Phusion Holding B.V.
+#
+#  "Passenger", "Phusion Passenger" and "Union Station" are registered
+#  trademarks of Phusion Holding B.V.
+#
+#  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.
+
+PhusionPassenger.require_passenger_lib 'constants'
+PhusionPassenger.require_passenger_lib 'platform_info/ruby'
+
+# This file contains a specification of all supported Passenger Standalone
+# configuration options. The specifications are spread over multiple constants,
+# one for each category. The command line parser for `passenger start` is
+# automatically generated from these specifications. The configuration file
+# parser and the environment variable parser also use these specifications.
+#
+# A specification is an array of hashes. The following keys are supported:
+#
+# - :name
+#   The name of the configuration option. If you omit this option, while
+#   simultaneously setting the `:cli` option, then it means this configuration
+#   option is available as a command line option only.
+#
+# - :type
+#   (default: :string)
+#   The value type. Supported types are: :string, :integer, :boolean, :path,
+#   :array, :map.
+#   This is used for determining a default parser and for checking the value.
+#
+# - :type_desc
+#   (default: automatically inferred)
+#   A description of the value type, to be used in command line option help
+#   messages. For example, the `:address` option should have the type desc
+#   `HOST` so that the help message `--address HOST` is generated. Boolean
+#   options have a `type_desc` of nil.
+#
+# - :cli
+#   (default: automatically inferred)
+#   The name of the corresponding command line option. If not specified, then
+#   a default one will be automatically generated form the configuration option
+#   name. For example, `:ssl_certificate_path` becomes `--ssl-certificate-path`.
+#   If set to nil, then it means there is no corresponding command line option.
+#
+# - :cli_parser
+#   (default: automatically inferred)
+#   Command line options are parsed based on the configuration option type.
+#   If you want to parse it differently, then you can set this option to a
+#   lambda to specify a custom parser.
+#
+# - :short_cli
+#   The name of the corresponding short command line option, if any. For
+#   example, the `:address` option should have `short_cli` set to `-a`.
+#
+# - :desc
+#   A description to be displayed in command line options help message.
+#
+# - :default
+#   The default value.
+#
+# - :min
+#   If :type is :integer, then this specifies the minimum accepted value.
+#   Has no meaing if :type is not :integer.
+#   This value is used by the default CLI parser to check whether the
+#   passed argument is acceptable.
+
+module PhusionPassenger
+  module Standalone
+    # Server configuration options
+    SERVER_CONFIG_SPEC = [
+      {
+        :name      => :address,
+        :type_desc => 'HOST',
+        :short_cli => '-a',
+        :default   => '0.0.0.0',
+        :desc      => "Bind to the given address.\n" \
+                      "Default: %DEFAULT%"
+      },
+      {
+        :name      => :port,
+        :type      => :integer,
+        :short_cli => '-p',
+        :default   => 3000,
+        :desc      => 'Use the given port number. Default: %DEFAULT%'
+      },
+      {
+        :name      => :socket_file,
+        :type      => :path,
+        :type_desc => 'FILE',
+        :cli       => '--socket',
+        :short_cli => '-S',
+        :desc      => "Bind to Unix domain socket instead of TCP\n" \
+                      'socket'
+      },
+      {
+        :name      => :ssl,
+        :type      => :boolean,
+        :desc      => "Enable SSL support (Nginx\n" \
+                      'engine only)'
+      },
+      {
+        :name      => :ssl_certificate,
+        :type      => :path,
+        :desc      => "Specify the SSL certificate path\n" \
+                      '(Nginx engine only)'
+      },
+      {
+        :name      => :ssl_certificate_key,
+        :type      => :path,
+        :desc      => "Specify the SSL key path (Nginx\n" \
+                      'engine only)'
+      },
+      {
+        :name      => :ssl_port,
+        :type      => :integer,
+        :type_desc => 'PORT',
+        :desc      => "Listen for SSL on this port, while\n" \
+                      "listening for HTTP on the normal port\n" \
+                      '(Nginx engine only)'
+      },
+      {
+        :name      => :daemonize,
+        :type      => :boolean,
+        :short_cli => '-d',
+        :desc      => 'Daemonize into the background'
+      },
+      {
+        :name      => :user,
+        :type_desc => 'USERNAME',
+        :desc      => "User to run as. Ignored unless\n" \
+                      'running as root'
+      },
+      {
+        :name      => :log_file,
+        :type      => :path,
+        :desc      => "Where to write log messages. Default:\n" \
+                      'console, or /dev/null when daemonized'
+      },
+      {
+        :name      => :pid_file,
+        :type      => :path,
+        :desc      => 'Where to store the PID file'
+      },
+      {
+        :name      => :instance_registry_dir,
+        :type      => :path,
+        :desc      => 'Use the given instance registry directory'
+      },
+      {
+        :name      => :data_buffer_dir,
+        :type      => :path,
+        :desc      => 'Use the given data buffer directory'
+      }
+    ]
+
+    # Application loading configuration options
+    APPLICATION_LOADING_CONFIG_SPECS = [
+      {
+        :name      => :environment,
+        :type_desc => 'NAME',
+        :short_cli => '-e',
+        :default   => ENV['RAILS_ENV'] || ENV['RACK_ENV'] || ENV['NODE_ENV'] ||
+          ENV['PASSENGER_APP_ENV'] || 'development',
+        :desc      => "Web framework environment. Default:\n" \
+                      "%DEFAULT%"
+      },
+      {
+        :name      => :ruby,
+        :type_desc => 'FILENAME',
+        :desc      => "Executable to use for Ruby apps.\n" \
+                      "Default: #{PlatformInfo.ruby_command}\n" \
+                      "(current context)"
+      },
+      {
+        :name      => :python,
+        :type_desc => 'FILENAME',
+        :desc      => 'Executable to use for Python apps'
+      },
+      {
+        :name      => :nodejs,
+        :type_desc => 'FILENAME',
+        :desc      => 'Executable to use for Node.js apps'
+      },
+      {
+        :name      => :meteor_app_settings,
+        :type      => :path,
+        :type_desc => 'FILENAME',
+        :desc      => "Settings file to use for (development mode)\n" \
+                      'Meteor apps'
+      },
+      {
+        :type      => :path,
+        :type_desc => 'FILENAME',
+        :cli       => '--rackup',
+        :short_cli => '-R',
+        :cli_parser => lambda do |options, value|
+          options[:app_type] = 'rack'
+          options[:startup_file] = File.absolute_logical_path(value,
+            Dir.logical_pwd)
+        end,
+        :desc      => "Consider application a Ruby app, and use\n" \
+                      'the given rackup file'
+      },
+      {
+        :name      => :app_type,
+        :type_desc => 'NAME',
+        :desc      => 'Force app to be detected as the given type'
+      },
+      {
+        :name      => :startup_file,
+        :type      => :path,
+        :type_desc => 'FILENAME',
+        :desc      => 'Force given startup file to be used'
+      },
+      {
+        :name      => :spawn_method,
+        :type_desc => 'NAME',
+        :default   => PlatformInfo.ruby_supports_fork? ? DEFAULT_SPAWN_METHOD : 'direct',
+        :desc      => 'The spawn method to use. Default: %DEFAULT%'
+      },
+      {
+        :name      => :static_files_dir,
+        :type      => :path,
+        :desc      => "Specify the static files dir (Nginx engine\n" \
+                      'only)'
+      },
+      {
+        :name      => :restart_dir,
+        :type      => :path,
+        :desc      => 'Specify the restart dir'
+      },
+      {
+        :name      => :friendly_error_pages,
+        :type      => :boolean,
+        :desc      => 'Turn on friendly error pages'
+      },
+      {
+        :type      => :boolean,
+        :cli       => '--no-friendly-error-pages',
+        :cli_parser => lambda do |options, value|
+          options[:friendly_error_pages] = false
+        end,
+        :desc      => 'Turn off friendly error pages'
+      },
+      {
+        :name      => :load_shell_envvars,
+        :type      => :boolean,
+        :desc      => "Load shell startup files before loading\n" \
+                      'application'
+      },
+      {
+        :name      => :debugger,
+        :type      => :boolean,
+        :desc      => 'Enable debugger support'
+      },
+      {
+        :name      => :envvars,
+        :type      => :map,
+        :type_desc => 'NAME=VALUE',
+        :default   => {},
+        :cli       => '--envvar',
+        :cli_parser => lambda do |options, value|
+          if value !~ /=.+/
+            abort "*** ERROR: invalid --envvar format: #{value}"
+          end
+          key, real_value = value.split('=', 2)
+          options[:envvars] ||= {}
+          options[:envvars][key] = real_value
+        end,
+        :desc      => 'Pass environment variable to application'
+      }
+    ]
+
+    # Process management configuration options
+    PROCESS_MANAGEMENT_CONFIG_SPECS = [
+      {
+        :name      => :max_pool_size,
+        :type      => :integer,
+        :min       => 1,
+        :desc      => "Maximum number of application processes.\n" \
+                      "Default: #{DEFAULT_MAX_POOL_SIZE}"
+      },
+      {
+        :name      => :min_instances,
+        :type      => :integer,
+        :min       => 0,
+        :desc      => "Minimum number of processes per\n" \
+                      'application. Default: 1'
+      },
+      {
+        :name      => :pool_idle_time,
+        :type      => :integer,
+        :type_desc => 'SECONDS',
+        :desc      => "Maximum time that processes may be idle.\n" \
+                      "Default: #{DEFAULT_POOL_IDLE_TIME}"
+      },
+      {
+        :name      => :max_preloader_idle_time,
+        :type      => :integer,
+        :type_desc => 'SECONDS',
+        :desc      => "Maximum time that preloader processes may\n" \
+                      "be idle. A value of 0 means that preloader\n" \
+                      "processes never timeout. Default: #{DEFAULT_MAX_PRELOADER_IDLE_TIME}"
+      },
+      {
+        :name      => :force_max_concurrent_requests_per_process,
+        :type      => :integer,
+        :desc      => "Force #{SHORT_PROGRAM_NAME} to believe that an\n" \
+                      "application process can handle the given\n" \
+                      "number of concurrent requests per process"
+      },
+      {
+        :name      => :concurrency_model,
+        :type_desc => 'NAME',
+        :desc      => "The concurrency model to use, either\n" \
+                      "'process' or 'thread' (Enterprise only).\n" \
+                      "Default: #{DEFAULT_CONCURRENCY_MODEL}"
+      },
+      {
+        :name      => :thread_count,
+        :type      => :integer,
+        :desc      => "The number of threads to use when using\n" \
+                      "the 'thread' concurrency model (Enterprise\n" \
+                      "only). Default: #{DEFAULT_APP_THREAD_COUNT}"
+      },
+      {
+        :name      => :memory_limit,
+        :type      => :integer,
+        :type_desc => 'MB',
+        :desc      => "Restart application processes that go over\n" \
+                      "the given memory limit (Enterprise only)"
+      },
+      {
+        :name      => :rolling_restarts,
+        :type      => :boolean,
+        :desc      => "Enable rolling restarts (Enterprise only)"
+      },
+      {
+        :name      => :resist_deployment_errors,
+        :type      => :boolean,
+        :desc      => "Enable deployment error resistance\n" \
+                      '(Enterprise only)'
+      }
+    ]
+
+    # Request handling configuration options
+    REQUEST_HANDLING_CONFIG_SPECS = [
+      {
+        :name      => :max_request_time,
+        :type      => :integer,
+        :type_desc => 'SECONDS',
+        :min       => 0,
+        :desc      => "Abort requests that take too much time\n" \
+                      '(Enterprise only)'
+      },
+      {
+        :name      => :max_request_queue_size,
+        :type      => :integer,
+        :min       => 1,
+        :desc      => "Specify request queue size. Default: #{DEFAULT_MAX_REQUEST_QUEUE_SIZE}"
+      },
+      {
+        :name      => :sticky_sessions,
+        :type      => :boolean,
+        :desc      => 'Enable sticky sessions'
+      },
+      {
+        :name      => :sticky_sessions_cookie_name,
+        :type_desc => 'NAME',
+        :desc      => "Cookie name to use for sticky sessions.\n" \
+                      "Default: #{DEFAULT_STICKY_SESSIONS_COOKIE_NAME}"
+      },
+      {
+        :name      => :vary_turbocache_by_cookie,
+        :type_desc => 'NAME',
+        :desc      => "Vary the turbocache by the cookie of the\n" \
+                      'given name'
+      },
+      {
+        :name      => :turbocaching,
+        :type      => :boolean,
+        :cli       => nil
+      },
+      {
+        :type      => :boolean,
+        :cli       => '--disable-turbocaching',
+        :desc      => 'Disable turbocaching',
+        :cli_parser => lambda do |options, value|
+          options[:turbocaching] = false
+        end
+      },
+      {
+        :name      => :abort_websockets_on_process_shutdown,
+        :type      => :boolean,
+        :cli       => nil
+      },
+      {
+        :type      => :boolean,
+        :cli       => '--no-abort-websockets-on-process-shutdown',
+        :desc      => "Do not abort WebSocket connections on\n" \
+                      'process restart',
+        :cli_parser => lambda do |options, value|
+          options[:abort_websockets_on_process_shutdown] = false
+        end
+      }
+    ]
+
+    # Union Station configuration options
+    UNION_STATION_CONFIG_SPECS = [
+      {
+        :name      => :union_station_gateway_address,
+        :cli       => nil
+      },
+      {
+        :name      => :union_station_gateway_port,
+        :type      => :integer,
+        :cli       => nil
+      },
+      {
+        :type_desc => 'HOST:PORT',
+        :cli       => '--union-station-gateway',
+        :cli_parser => lambda do |options, value|
+          host, port = value.split(":", 2)
+          port = port.to_i
+          port = 443 if port == 0
+          options[:union_station_gateway_address] = host
+          options[:union_station_gateway_port] = port.to_i
+        end,
+        :desc      => 'Specify Union Station Gateway host and port'
+      },
+      {
+        :name      => :union_station_key,
+        :type_desc => 'KEY',
+        :desc      => 'Specify Union Station key'
+      },
+      {
+        :name      => :union_station_gateway_cert,
+        :type      => :path,
+        :desc      => "The certificate to use for contacting the\n" \
+                      "Union Station gateway, or '-' to disable\n" \
+                      "certificate checking",
+        :config_value_parser => lambda do |value, base_dir|
+          if value == '-'
+            '-'
+          else
+            File.absolute_logical_path(value.to_s, base_dir)
+          end
+        end,
+        :cli_parser => lambda do |options, value|
+          if value == '-'
+            options[:union_station_gateway_cert] = '-'
+          else
+            options[:union_station_gateway_cert] =
+              File.absolute_logical_path(value,
+                Dir.logical_pwd)
+          end
+        end
+      }
+    ]
+
+    # Nginx engine configuration options
+    NGINX_ENGINE_CONFIG_SPECS = [
+      {
+        :name      => :nginx_bin,
+        :type      => :path,
+        :type_desc => 'FILENAME',
+        :desc      => 'Nginx binary to use as core'
+      },
+      {
+        :name      => :nginx_version,
+        :type_desc => 'VERSION',
+        :default   => PREFERRED_NGINX_VERSION,
+        :desc      => "Nginx version to use as core.\n" \
+                      "Default: #{PREFERRED_NGINX_VERSION}"
+      },
+      {
+        :name      => :nginx_tarball,
+        :type      => :path,
+        :type_desc => 'FILENAME',
+        :desc      => "If Nginx needs to be installed, then the\n" \
+                      "given tarball will be used instead of\n" \
+                      "downloading from the Internet"
+      },
+      {
+        :name      => :nginx_config_template,
+        :type      => :path,
+        :type_desc => 'FILENAME',
+        :desc      => "The template to use for generating the\n" \
+                      'Nginx config file'
+      },
+      {
+        :name      => :debug_nginx_config,
+        :type      => :boolean,
+        :desc      => 'Print Nginx config template and exit'
+      }
+    ]
+
+    # Advanced configuration options
+    ADVANCED_CONFIG_SPECS = [
+      {
+        :name      => :engine,
+        :type_desc => 'NAME',
+        :default   => 'nginx',
+        :desc      => "Underlying HTTP engine to use. Available\n" \
+                      "options: nginx (default), builtin"
+      },
+      {
+        :name      => :log_level,
+        :type      => :integer,
+        :default   => DEFAULT_LOG_LEVEL,
+        :desc      => "Log level to use. Default: #{DEFAULT_LOG_LEVEL}"
+      },
+      {
+        :name      => :auto,
+        :type      => :boolean,
+        :default   => !STDIN.tty? || !STDOUT.tty?,
+        :desc      => "Run in non-interactive mode. Default when\n" \
+                      'stdin or stdout is not a TTY'
+      },
+      {
+        :name      => :ctls,
+        :type      => :array,
+        :type_desc => 'NAME=VALUE',
+        :default   => [],
+        :cli_parser => lambda do |options, value|
+          if value !~ /=.+/
+            abort "*** ERROR: invalid --ctl format: #{value}"
+          end
+          options[:ctls] ||= []
+          options[:ctls] << value
+        end
+      },
+      {
+        :name      => :binaries_url_root,
+        :type_desc => 'URL',
+        :desc      => "If Nginx needs to be installed, then the\n" \
+                      "specified URL will be checked for binaries\n" \
+                      'prior to a local build'
+      },
+      {
+        :name      => :runtime_check_only,
+        :type      => :boolean,
+        :desc      => "Quit after checking whether the\n" \
+                      "#{PROGRAM_NAME} Standalone runtime files\n" \
+                      'are installed'
+      },
+      {
+        :name      => :dont_install_runtime,
+        :type      => :boolean,
+        :cli       => '--no-install-runtime',
+        :desc      => 'Abort if runtime must be installed'
+      },
+      {
+        :name      => :dont_compile_runtime,
+        :type      => :boolean,
+        :cli       => '--no-compile-runtime',
+        :desc      => 'Abort if runtime must be compiled'
+      }
+    ]
+
+    CONFIG_SPECS = [
+      SERVER_CONFIG_SPEC,
+      APPLICATION_LOADING_CONFIG_SPECS,
+      PROCESS_MANAGEMENT_CONFIG_SPECS,
+      REQUEST_HANDLING_CONFIG_SPECS,
+      UNION_STATION_CONFIG_SPECS,
+      NGINX_ENGINE_CONFIG_SPECS,
+      ADVANCED_CONFIG_SPECS
+    ]
+
+    # Maps configuration options to their default value. Automatically
+    # set by code later in this file.
+    #
+    # To inspect the value of this array, run:
+    #
+    #   ./dev/runner -r standalone/config_options_list -r pp \
+    #     'pp Standalone::CONFIG_DEFAULTS; nil'
+    CONFIG_DEFAULTS = {}
+
+    # Indexes all configuration specification items by name.
+    #
+    # To inspect the value of this array, run:
+    #
+    #   ./dev/runner -r standalone/config_options_list -r pp \
+    #     'pp Standalone::CONFIG_NAME_INDEX; nil'
+    CONFIG_NAME_INDEX = {}
+
+
+    ############
+
+
+    # Apply transformations on the specification constants, e.g. set default values.
+
+    make_default_type_desc_value = lambda do |spec_item|
+      case spec_item[:type]
+      when :string
+        'STRING'
+      when :integer
+        'NUMBER'
+      when :path
+        'PATH'
+      when :array
+        'ARRAY'
+      when :map
+        'MAP'
+      else
+        nil
+      end
+    end
+
+    make_default_cli_value = lambda do |spec_item|
+      '--' + spec_item[:name].to_s.gsub('_', '-')
+    end
+
+    CONFIG_SPECS.each do |spec|
+      spec.each do |spec_item|
+        spec_item[:type] ||= :string
+        spec_item[:type_desc] ||= make_default_type_desc_value.call(spec_item)
+        if spec_item[:name]
+          if !spec_item.key?(:cli)
+            spec_item[:cli] = make_default_cli_value.call(spec_item)
+          end
+          if spec_item[:default]
+            CONFIG_DEFAULTS[spec_item[:name]] = spec_item[:default]
+          end
+          CONFIG_NAME_INDEX[spec_item[:name]] = spec_item
+        end
+      end
+    end
+  end
+end