passenger_dudemeister 3.0.1

data/ext/apache2/Bucket.h

@@ -0,0 +1,87 @@
+/*
+ *  Phusion Passenger - http://www.modrails.com/
+ *  Copyright (c) 2010 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.
+ */
+#ifndef _PASSENGER_BUCKET_H_
+#define _PASSENGER_BUCKET_H_
+
+#include <boost/shared_ptr.hpp>
+#include <apr_buckets.h>
+#include "Session.h"
+
+namespace Passenger {
+
+using namespace boost;
+
+struct PassengerBucketState {
+	/** The number of bytes that this PassengerBucket has read so far. */
+	unsigned long bytesRead;
+	
+	/** Whether this PassengerBucket is completed, i.e. no more data
+	 * can be read from the underlying file descriptor. When true,
+	 * this can either mean that EOF has been reached, or that an I/O
+	 * error occured. Use errorCode to check whether an error occurred.
+	 */
+	bool completed;
+	
+	/** When completed is true, errorCode contains the errno value of
+	 * the last read() call.
+	 *
+	 * A value of 0 means that no error occured.
+	 */
+	int errorCode;
+	
+	PassengerBucketState() {
+		bytesRead = 0;
+		completed = false;
+		errorCode = 0;
+	}
+};
+
+typedef shared_ptr<PassengerBucketState> PassengerBucketStatePtr;
+
+/**
+ * We used to use an apr_bucket_pipe for forwarding the backend process's
+ * response to the HTTP client. However, apr_bucket_pipe has a number of
+ * issues:
+ * - It closes the pipe's file descriptor when it has reached
+ *   end-of-stream, but not when an error has occurred. This behavior is
+ *   undesirable because it can easily cause file descriptor leaks.
+ * - It does weird non-blocking-I/O related things which can cause it
+ *   to read less data than can actually be read.
+ *
+ * PassengerBucket is like apr_bucket_pipe, but:
+ * - It also holds a reference to a Session. When a read error has occured
+ *   or when end-of-stream has been reached, the Session will be
+ *   dereferenced, so that the underlying file descriptor is closed.
+ * - It ignores the APR_NONBLOCK_READ flag because that's known to cause
+ *   strange I/O problems.
+ * - It can store its current state in a PassengerBucketState data structure.
+ */
+apr_bucket *passenger_bucket_create(SessionPtr session,
+                                    PassengerBucketStatePtr state,
+                                    apr_bucket_alloc_t *list);
+
+} // namespace Passenger
+
+#endif /* _PASSENGER_BUCKET_H_ */

data/ext/apache2/Configuration.cpp

@@ -0,0 +1,717 @@
+/*
+ *  Phusion Passenger - http://www.modrails.com/
+ *  Copyright (c) 2010 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.
+ */
+#include <algorithm>
+#include <cstdlib>
+
+/* ap_config.h checks whether the compiler has support for C99's designated
+ * initializers, and defines AP_HAVE_DESIGNATED_INITIALIZER if it does. However,
+ * g++ does not support designated initializers, even when ap_config.h thinks
+ * it does. Here we undefine the macro to force httpd_config.h to not use
+ * designated initializers. This should fix compilation problems on some systems.
+ */
+#include <ap_config.h>
+#undef AP_HAVE_DESIGNATED_INITIALIZER
+
+#include "Configuration.hpp"
+#include "Utils.h"
+
+/* The APR headers must come after the Passenger headers. See Hooks.cpp
+ * to learn why.
+ */
+#include <apr_strings.h>
+
+using namespace Passenger;
+
+extern "C" module AP_MODULE_DECLARE_DATA passenger_module;
+
+namespace Passenger { ServerConfig serverConfig; }
+
+#define MERGE_THREEWAY_CONFIG(field) \
+	config->field = (add->field == DirConfig::UNSET) ? base->field : add->field
+#define MERGE_STR_CONFIG(field) \
+	config->field = (add->field == NULL) ? base->field : add->field
+#define MERGE_STRING_CONFIG(field) \
+	config->field = (add->field.empty()) ? base->field : add->field
+#define MERGE_INT_CONFIG(field) \
+	config->field = (add->field ## Specified) ? add->field : base->field; \
+	config->field ## Specified = base->field ## Specified || add->field ## Specified
+
+#define DEFINE_DIR_STR_CONFIG_SETTER(functionName, fieldName)                    \
+	static const char *                                                      \
+	functionName(cmd_parms *cmd, void *pcfg, const char *arg) {              \
+		DirConfig *config = (DirConfig *) pcfg;                          \
+		config->fieldName = arg;                                         \
+		return NULL;                                                     \
+	}
+#define DEFINE_DIR_INT_CONFIG_SETTER(functionName, fieldName, integerType, minValue)            \
+	static const char *                                                                     \
+	functionName(cmd_parms *cmd, void *pcfg, const char *arg) {                             \
+		DirConfig *config = (DirConfig *) pcfg;                                         \
+		char *end;                                                                      \
+		long int result;                                                                \
+		                                                                                \
+		result = strtol(arg, &end, 10);                                                 \
+		if (*end != '\0') {                                                             \
+			string message = "Invalid number specified for ";                       \
+			message.append(cmd->directive->directive);                              \
+			message.append(".");                                                    \
+			                                                                        \
+			char *messageStr = (char *) apr_palloc(cmd->temp_pool,                  \
+				message.size() + 1);                                            \
+			memcpy(messageStr, message.c_str(), message.size() + 1);                \
+			return messageStr;                                                      \
+		} else if (result < minValue) {                                                 \
+			string message = "Value for ";                                          \
+			message.append(cmd->directive->directive);                              \
+			message.append(" must be greater than or equal to " #minValue ".");     \
+			                                                                        \
+			char *messageStr = (char *) apr_palloc(cmd->temp_pool,                  \
+				message.size() + 1);                                            \
+			memcpy(messageStr, message.c_str(), message.size() + 1);                \
+			return messageStr;                                                      \
+		} else {                                                                        \
+			config->fieldName = (integerType) result;                               \
+			config->fieldName ## Specified = true;                                  \
+			return NULL;                                                            \
+		}                                                                               \
+	}
+#define DEFINE_DIR_THREEWAY_CONFIG_SETTER(functionName, fieldName)           \
+	static const char *                                                  \
+	functionName(cmd_parms *cmd, void *pcfg, const char *arg) {          \
+		DirConfig *config = (DirConfig *) pcfg;                      \
+		if (arg) {                                                   \
+			config->fieldName = DirConfig::ENABLED;              \
+		} else {                                      	             \
+			config->fieldName = DirConfig::DISABLED;             \
+		}                                                            \
+		return NULL;                                                 \
+	}
+
+#define DEFINE_SERVER_STR_CONFIG_SETTER(functionName, fieldName)                 \
+	static const char *                                                      \
+	functionName(cmd_parms *cmd, void *dummy, const char *arg) {             \
+		serverConfig.fieldName = arg;                                    \
+		return NULL;                                                     \
+	}
+#define DEFINE_SERVER_BOOLEAN_CONFIG_SETTER(functionName, fieldName)             \
+	static const char *                                                      \
+	functionName(cmd_parms *cmd, void *dummy, int arg) {                     \
+		serverConfig.fieldName = arg;                                    \
+		return NULL;                                                     \
+	}
+#define DEFINE_SERVER_INT_CONFIG_SETTER(functionName, fieldName, integerType, minValue)         \
+	static const char *                                                                     \
+	functionName(cmd_parms *cmd, void *pcfg, const char *arg) {                             \
+		char *end;                                                                      \
+		long int result;                                                                \
+		                                                                                \
+		result = strtol(arg, &end, 10);                                                 \
+		if (*end != '\0') {                                                             \
+			string message = "Invalid number specified for ";                       \
+			message.append(cmd->directive->directive);                              \
+			message.append(".");                                                    \
+			                                                                        \
+			char *messageStr = (char *) apr_palloc(cmd->temp_pool,                  \
+				message.size() + 1);                                            \
+			memcpy(messageStr, message.c_str(), message.size() + 1);                \
+			return messageStr;                                                      \
+		} else if (result < minValue) {                                                 \
+			string message = "Value for ";                                          \
+			message.append(cmd->directive->directive);                              \
+			message.append(" must be greater than or equal to " #minValue ".");     \
+			                                                                        \
+			char *messageStr = (char *) apr_palloc(cmd->temp_pool,                  \
+				message.size() + 1);                                            \
+			memcpy(messageStr, message.c_str(), message.size() + 1);                \
+			return messageStr;                                                      \
+		} else {                                                                        \
+			serverConfig.fieldName = (integerType) result;                          \
+			return NULL;                                                            \
+		}                                                                               \
+	}
+
+
+template<typename T> static apr_status_t
+destroy_config_struct(void *x) {
+	delete (T *) x;
+	return APR_SUCCESS;
+}
+
+
+extern "C" {
+
+static DirConfig *
+create_dir_config_struct(apr_pool_t *pool) {
+	DirConfig *config = new DirConfig();
+	apr_pool_cleanup_register(pool, config, destroy_config_struct<DirConfig>, apr_pool_cleanup_null);
+	return config;
+}
+
+void *
+passenger_config_create_dir(apr_pool_t *p, char *dirspec) {
+	DirConfig *config = create_dir_config_struct(p);
+	config->enabled = DirConfig::UNSET;
+	config->autoDetectRails = DirConfig::UNSET;
+	config->autoDetectRack = DirConfig::UNSET;
+	config->autoDetectWSGI = DirConfig::UNSET;
+	config->environment = NULL;
+	config->appRoot = NULL;
+	config->user = NULL;
+	config->group = NULL;
+	config->spawnMethod = DirConfig::SM_UNSET;
+	config->frameworkSpawnerTimeout = -1;
+	config->appSpawnerTimeout = -1;
+	config->maxRequests = 0;
+	config->maxRequestsSpecified = false;
+	config->minInstances = 1;
+	config->minInstancesSpecified = false;
+	config->highPerformance = DirConfig::UNSET;
+	config->useGlobalQueue = DirConfig::UNSET;
+	config->resolveSymlinksInDocRoot = DirConfig::UNSET;
+	config->allowEncodedSlashes = DirConfig::UNSET;
+	config->statThrottleRate = 0;
+	config->statThrottleRateSpecified = false;
+	config->restartDir = NULL;
+	config->uploadBufferDir = NULL;
+	config->friendlyErrorPages = DirConfig::UNSET;
+	config->analytics = DirConfig::UNSET;
+	/*************************************/
+	return config;
+}
+
+void *
+passenger_config_merge_dir(apr_pool_t *p, void *basev, void *addv) {
+	DirConfig *config = create_dir_config_struct(p);
+	DirConfig *base = (DirConfig *) basev;
+	DirConfig *add = (DirConfig *) addv;
+	
+	config->enabled = (add->enabled == DirConfig::UNSET) ? base->enabled : add->enabled;
+	
+	config->railsBaseURIs = base->railsBaseURIs;
+	for (set<string>::const_iterator it(add->railsBaseURIs.begin()); it != add->railsBaseURIs.end(); it++) {
+		config->railsBaseURIs.insert(*it);
+	}
+	config->rackBaseURIs = base->rackBaseURIs;
+	for (set<string>::const_iterator it(add->rackBaseURIs.begin()); it != add->rackBaseURIs.end(); it++) {
+		config->rackBaseURIs.insert(*it);
+	}
+	
+	MERGE_THREEWAY_CONFIG(autoDetectRails);
+	MERGE_THREEWAY_CONFIG(autoDetectRack);
+	MERGE_THREEWAY_CONFIG(autoDetectWSGI);
+	MERGE_STR_CONFIG(environment);
+	MERGE_STR_CONFIG(appRoot);
+	MERGE_STRING_CONFIG(appGroupName);
+	MERGE_STR_CONFIG(user);
+	MERGE_STR_CONFIG(group);
+	config->spawnMethod = (add->spawnMethod == DirConfig::SM_UNSET) ? base->spawnMethod : add->spawnMethod;
+	config->frameworkSpawnerTimeout = (add->frameworkSpawnerTimeout == -1) ? base->frameworkSpawnerTimeout : add->frameworkSpawnerTimeout;
+	config->appSpawnerTimeout = (add->appSpawnerTimeout == -1) ? base->appSpawnerTimeout : add->appSpawnerTimeout;
+	MERGE_INT_CONFIG(maxRequests);
+	MERGE_INT_CONFIG(minInstances);
+	MERGE_THREEWAY_CONFIG(highPerformance);
+	MERGE_THREEWAY_CONFIG(useGlobalQueue);
+	MERGE_INT_CONFIG(statThrottleRate);
+	MERGE_STR_CONFIG(restartDir);
+	MERGE_STR_CONFIG(uploadBufferDir);
+	MERGE_STRING_CONFIG(unionStationKey);
+	MERGE_THREEWAY_CONFIG(resolveSymlinksInDocRoot);
+	MERGE_THREEWAY_CONFIG(allowEncodedSlashes);
+	MERGE_THREEWAY_CONFIG(friendlyErrorPages);
+	MERGE_THREEWAY_CONFIG(analytics);
+	/*************************************/
+	return config;
+}
+
+
+/*************************************************
+ * Passenger settings
+ *************************************************/
+
+DEFINE_SERVER_STR_CONFIG_SETTER(cmd_passenger_root, root)
+DEFINE_SERVER_STR_CONFIG_SETTER(cmd_passenger_ruby, ruby)
+DEFINE_SERVER_INT_CONFIG_SETTER(cmd_passenger_log_level, logLevel, unsigned int, 0)
+DEFINE_SERVER_STR_CONFIG_SETTER(cmd_passenger_debug_log_file, debugLogFile)
+DEFINE_SERVER_INT_CONFIG_SETTER(cmd_passenger_max_pool_size, maxPoolSize, unsigned int, 1)
+DEFINE_SERVER_INT_CONFIG_SETTER(cmd_passenger_max_instances_per_app, maxInstancesPerApp, unsigned int, 0)
+DEFINE_SERVER_INT_CONFIG_SETTER(cmd_passenger_pool_idle_time, poolIdleTime, unsigned int, 0)
+DEFINE_SERVER_BOOLEAN_CONFIG_SETTER(cmd_passenger_user_switching, userSwitching)
+DEFINE_SERVER_STR_CONFIG_SETTER(cmd_passenger_default_user, defaultUser)
+DEFINE_SERVER_STR_CONFIG_SETTER(cmd_passenger_default_group, defaultGroup)
+DEFINE_SERVER_STR_CONFIG_SETTER(cmd_passenger_temp_dir, tempDir)
+DEFINE_SERVER_STR_CONFIG_SETTER(cmd_union_station_gateway_address, unionStationGatewayAddress)
+DEFINE_SERVER_INT_CONFIG_SETTER(cmd_union_station_gateway_port, unionStationGatewayPort, int, 1)
+DEFINE_SERVER_STR_CONFIG_SETTER(cmd_union_station_gateway_cert, unionStationGatewayCert)
+DEFINE_SERVER_STR_CONFIG_SETTER(cmd_passenger_analytics_log_dir, analyticsLogDir)
+DEFINE_SERVER_STR_CONFIG_SETTER(cmd_passenger_analytics_log_user, analyticsLogUser)
+DEFINE_SERVER_STR_CONFIG_SETTER(cmd_passenger_analytics_log_group, analyticsLogGroup)
+DEFINE_SERVER_STR_CONFIG_SETTER(cmd_passenger_analytics_log_permissions, analyticsLogPermissions)
+
+static const char *
+cmd_passenger_pre_start(cmd_parms *cmd, void *pcfg, const char *arg) {
+	serverConfig.prestartURLs.insert(arg);
+	return NULL;
+}
+
+DEFINE_DIR_INT_CONFIG_SETTER(cmd_passenger_min_instances, minInstances, unsigned long, 0)
+DEFINE_DIR_THREEWAY_CONFIG_SETTER(cmd_passenger_use_global_queue, useGlobalQueue)
+DEFINE_DIR_INT_CONFIG_SETTER(cmd_passenger_max_requests, maxRequests, unsigned long, 0)
+DEFINE_DIR_THREEWAY_CONFIG_SETTER(cmd_passenger_high_performance, highPerformance)
+DEFINE_DIR_THREEWAY_CONFIG_SETTER(cmd_passenger_enabled, enabled)
+DEFINE_DIR_STR_CONFIG_SETTER(cmd_environment, environment)
+DEFINE_DIR_INT_CONFIG_SETTER(cmd_passenger_stat_throttle_rate, statThrottleRate, unsigned long, 0)
+DEFINE_DIR_STR_CONFIG_SETTER(cmd_passenger_app_root, appRoot)
+DEFINE_DIR_STR_CONFIG_SETTER(cmd_passenger_app_group_name, appGroupName)
+DEFINE_DIR_STR_CONFIG_SETTER(cmd_passenger_user, user)
+DEFINE_DIR_STR_CONFIG_SETTER(cmd_passenger_group, group)
+DEFINE_DIR_STR_CONFIG_SETTER(cmd_passenger_restart_dir, restartDir)
+DEFINE_DIR_STR_CONFIG_SETTER(cmd_passenger_upload_buffer_dir, uploadBufferDir)
+DEFINE_DIR_STR_CONFIG_SETTER(cmd_union_station_key, unionStationKey)
+DEFINE_DIR_THREEWAY_CONFIG_SETTER(cmd_passenger_resolve_symlinks_in_document_root, resolveSymlinksInDocRoot)
+DEFINE_DIR_THREEWAY_CONFIG_SETTER(cmd_passenger_allow_encoded_slashes, allowEncodedSlashes)
+DEFINE_DIR_THREEWAY_CONFIG_SETTER(cmd_passenger_friendly_error_pages, friendlyErrorPages)
+DEFINE_DIR_THREEWAY_CONFIG_SETTER(cmd_passenger_analytics, analytics)
+
+static const char *
+cmd_passenger_spawn_method(cmd_parms *cmd, void *pcfg, const char *arg) {
+	DirConfig *config = (DirConfig *) pcfg;
+	if (strcmp(arg, "smart") == 0) {
+		config->spawnMethod = DirConfig::SM_SMART;
+	} else if (strcmp(arg, "smart-lv2") == 0) {
+		config->spawnMethod = DirConfig::SM_SMART_LV2;
+	} else if (strcmp(arg, "conservative") == 0) {
+		config->spawnMethod = DirConfig::SM_CONSERVATIVE;
+	} else {
+		return "PassengerSpawnMethod may only be 'smart', 'smart-lv2' or 'conservative'.";
+	}
+	return NULL;
+}
+
+
+/*************************************************
+ * Rails-specific settings
+ *************************************************/
+
+static const char *
+cmd_rails_base_uri(cmd_parms *cmd, void *pcfg, const char *arg) {
+	DirConfig *config = (DirConfig *) pcfg;
+	if (strlen(arg) == 0) {
+		return "RailsBaseURI may not be set to the empty string";
+	} else if (arg[0] != '/') {
+		return "RailsBaseURI must start with a slash (/)";
+	} else if (strlen(arg) > 1 && arg[strlen(arg) - 1] == '/') {
+		return "RailsBaseURI must not end with a slash (/)";
+	} else {
+		config->railsBaseURIs.insert(arg);
+		return NULL;
+	}
+}
+
+DEFINE_DIR_THREEWAY_CONFIG_SETTER(cmd_rails_auto_detect, autoDetectRails)
+
+static const char *
+cmd_rails_framework_spawner_idle_time(cmd_parms *cmd, void *pcfg, const char *arg) {
+	DirConfig *config = (DirConfig *) pcfg;
+	char *end;
+	long int result;
+	
+	result = strtol(arg, &end, 10);
+	if (*end != '\0') {
+		return "Invalid number specified for RailsFrameworkSpawnerIdleTime.";
+	} else if (result < 0) {
+		return "Value for RailsFrameworkSpawnerIdleTime must be at least 0.";
+	} else {
+		config->frameworkSpawnerTimeout = result;
+		return NULL;
+	}
+}
+
+static const char *
+cmd_rails_app_spawner_idle_time(cmd_parms *cmd, void *pcfg, const char *arg) {
+	DirConfig *config = (DirConfig *) pcfg;
+	char *end;
+	long int result;
+	
+	result = strtol(arg, &end, 10);
+	if (*end != '\0') {
+		return "Invalid number specified for RailsAppSpawnerIdleTime.";
+	} else if (result < 0) {
+		return "Value for RailsAppSpawnerIdleTime must be at least 0.";
+	} else {
+		config->appSpawnerTimeout = result;
+		return NULL;
+	}
+}
+
+
+/*************************************************
+ * Rack-specific settings
+ *************************************************/
+
+static const char *
+cmd_rack_base_uri(cmd_parms *cmd, void *pcfg, const char *arg) {
+	DirConfig *config = (DirConfig *) pcfg;
+	if (strlen(arg) == 0) {
+		return "RackBaseURI may not be set to the empty string";
+	} else if (arg[0] != '/') {
+		return "RackBaseURI must start with a slash (/)";
+	} else if (strlen(arg) > 1 && arg[strlen(arg) - 1] == '/') {
+		return "RackBaseURI must not end with a slash (/)";
+	} else {
+		config->rackBaseURIs.insert(arg);
+		return NULL;
+	}
+}
+
+DEFINE_DIR_THREEWAY_CONFIG_SETTER(cmd_rack_auto_detect, autoDetectRack)
+
+
+/*************************************************
+ * WSGI-specific settings
+ *************************************************/
+
+DEFINE_DIR_THREEWAY_CONFIG_SETTER(cmd_wsgi_auto_detect, autoDetectWSGI)
+
+
+/*************************************************
+ * Obsolete settings
+ *************************************************/
+
+static const char *
+cmd_rails_spawn_server(cmd_parms *cmd, void *pcfg, const char *arg) {
+	fprintf(stderr, "WARNING: The 'RailsSpawnServer' option is obsolete. "
+		"Please specify 'PassengerRoot' instead. The correct value was "
+		"given to you by 'passenger-install-apache2-module'.");
+	fflush(stderr);
+	return NULL;
+}
+
+static const char *
+cmd_rails_allow_mod_rewrite(cmd_parms *cmd, void *pcfg, int arg) {
+	fprintf(stderr, "WARNING: The 'RailsAllowModRewrite' option is obsolete: "
+		"Phusion Passenger now fully supports mod_rewrite. "
+		"Please remove this option from your configuration file.");
+	fflush(stderr);
+	return NULL;
+}
+
+
+typedef const char * (*Take1Func)();
+typedef const char * (*FlagFunc)();
+
+const command_rec passenger_commands[] = {
+	// Passenger settings.
+	AP_INIT_TAKE1("PassengerRoot",
+		(Take1Func) cmd_passenger_root,
+		NULL,
+		RSRC_CONF,
+		"The Passenger root folder."),
+	AP_INIT_TAKE1("PassengerRuby",
+		(Take1Func) cmd_passenger_ruby,
+		NULL,
+		RSRC_CONF,
+		"The Ruby interpreter to use."),
+	AP_INIT_TAKE1("PassengerLogLevel",
+		(Take1Func) cmd_passenger_log_level,
+		NULL,
+		RSRC_CONF,
+		"Passenger log verbosity."),
+	AP_INIT_TAKE1("PassengerDebugLogFile",
+		(Take1Func) cmd_passenger_debug_log_file,
+		NULL,
+		RSRC_CONF,
+		"Passenger debug log file."),
+	AP_INIT_TAKE1("PassengerMaxPoolSize",
+		(Take1Func) cmd_passenger_max_pool_size,
+		NULL,
+		RSRC_CONF,
+		"The maximum number of simultaneously alive application instances."),
+	AP_INIT_TAKE1("PassengerMinInstances",
+		(Take1Func) cmd_passenger_min_instances,
+		NULL,
+		OR_LIMIT | ACCESS_CONF | RSRC_CONF,
+		"The minimum number of application instances to keep when cleaning idle instances."),
+	AP_INIT_TAKE1("PassengerMaxInstancesPerApp",
+		(Take1Func) cmd_passenger_max_instances_per_app,
+		NULL,
+		RSRC_CONF,
+		"The maximum number of simultaneously alive application instances a single application may occupy."),
+	AP_INIT_TAKE1("PassengerPoolIdleTime",
+		(Take1Func) cmd_passenger_pool_idle_time,
+		NULL,
+		RSRC_CONF,
+		"The maximum number of seconds that an application may be idle before it gets terminated."),
+	AP_INIT_FLAG("PassengerUseGlobalQueue",
+		(FlagFunc) cmd_passenger_use_global_queue,
+		NULL,
+		OR_OPTIONS | ACCESS_CONF | RSRC_CONF,
+		"Enable or disable Passenger's global queuing mode mode."),
+	AP_INIT_FLAG("PassengerUserSwitching",
+		(FlagFunc) cmd_passenger_user_switching,
+		NULL,
+		RSRC_CONF,
+		"Whether to enable user switching support."),
+	AP_INIT_TAKE1("PassengerUser",
+		(Take1Func) cmd_passenger_user,
+		NULL,
+		ACCESS_CONF | RSRC_CONF,
+		"The user that Ruby applications must run as."),
+	AP_INIT_TAKE1("PassengerGroup",
+		(Take1Func) cmd_passenger_group,
+		NULL,
+		ACCESS_CONF | RSRC_CONF,
+		"The group that Ruby applications must run as."),
+	AP_INIT_TAKE1("PassengerDefaultUser",
+		(Take1Func) cmd_passenger_default_user,
+		NULL,
+		RSRC_CONF,
+		"The user that Ruby applications must run as when user switching fails or is disabled."),
+	AP_INIT_TAKE1("PassengerDefaultGroup",
+		(Take1Func) cmd_passenger_default_group,
+		NULL,
+		RSRC_CONF,
+		"The group that Ruby applications must run as when user switching fails or is disabled."),
+	AP_INIT_TAKE1("PassengerTempDir",
+		(Take1Func) cmd_passenger_temp_dir,
+		NULL,
+		RSRC_CONF,
+		"The temp directory that Passenger should use."),
+	AP_INIT_TAKE1("PassengerMaxRequests",
+		(Take1Func) cmd_passenger_max_requests,
+		NULL,
+		OR_LIMIT | ACCESS_CONF | RSRC_CONF,
+		"The maximum number of requests that an application instance may process."),
+	AP_INIT_FLAG("PassengerHighPerformance",
+		(FlagFunc) cmd_passenger_high_performance,
+		NULL,
+		OR_ALL,
+		"Enable or disable Passenger's high performance mode."),
+	AP_INIT_FLAG("PassengerEnabled",
+		(FlagFunc) cmd_passenger_enabled,
+		NULL,
+		OR_ALL,
+		"Enable or disable Phusion Passenger."),
+	AP_INIT_TAKE1("PassengerAppGroupName",
+		(Take1Func) cmd_passenger_app_group_name,
+		NULL,
+		OR_OPTIONS | ACCESS_CONF | RSRC_CONF,
+		"The temp directory that Passenger should use."),
+	AP_INIT_TAKE1("PassengerStatThrottleRate",
+		(Take1Func) cmd_passenger_stat_throttle_rate,
+		NULL,
+		OR_LIMIT | ACCESS_CONF | RSRC_CONF,
+		"Limit the number of stat calls to once per given seconds."),
+	AP_INIT_TAKE1("PassengerRestartDir",
+		(Take1Func) cmd_passenger_restart_dir,
+		NULL,
+		OR_OPTIONS | ACCESS_CONF | RSRC_CONF,
+		"The directory in which Passenger should look for restart.txt."),
+	AP_INIT_TAKE1("PassengerAppRoot",
+		(Take1Func) cmd_passenger_app_root,
+		NULL,
+		OR_OPTIONS | ACCESS_CONF | RSRC_CONF,
+		"The application's root directory."),
+	AP_INIT_TAKE1("PassengerUploadBufferDir",
+		(Take1Func) cmd_passenger_upload_buffer_dir,
+		NULL,
+		OR_OPTIONS,
+		"The directory in which upload buffer files should be placed."),
+	AP_INIT_TAKE1("UnionStationKey",
+		(Take1Func) cmd_union_station_key,
+		NULL,
+		OR_ALL,
+		"The Union Station key."),
+	AP_INIT_FLAG("PassengerResolveSymlinksInDocumentRoot",
+		(FlagFunc) cmd_passenger_resolve_symlinks_in_document_root,
+		NULL,
+		OR_OPTIONS | ACCESS_CONF | RSRC_CONF,
+		"Whether to resolve symlinks in the DocumentRoot path"),
+	AP_INIT_FLAG("PassengerAllowEncodedSlashes",
+		(FlagFunc) cmd_passenger_allow_encoded_slashes,
+		NULL,
+		OR_OPTIONS | ACCESS_CONF | RSRC_CONF,
+		"Whether to support encoded slashes in the URL"),
+	AP_INIT_FLAG("PassengerFriendlyErrorPages",
+		(FlagFunc) cmd_passenger_friendly_error_pages,
+		NULL,
+		OR_OPTIONS | ACCESS_CONF | RSRC_CONF,
+		"Whether to display friendly error pages when something goes wrong"),
+	AP_INIT_TAKE1("PassengerSpawnMethod",
+		(Take1Func) cmd_passenger_spawn_method,
+		NULL,
+		RSRC_CONF,
+		"The spawn method to use."),
+	AP_INIT_TAKE1("UnionStationGatewayAddress",
+		(Take1Func) cmd_union_station_gateway_address,
+		NULL,
+		RSRC_CONF,
+		"The Union Station Gateway host name."),
+	AP_INIT_TAKE1("UnionStationGatewayPort",
+		(Take1Func) cmd_union_station_gateway_port,
+		NULL,
+		RSRC_CONF,
+		"The Union Station Gateway port number."),
+	AP_INIT_TAKE1("UnionStationGatewayCert",
+		(Take1Func) cmd_union_station_gateway_cert,
+		NULL,
+		RSRC_CONF,
+		"The Union Station Gateway certificate."),
+	AP_INIT_TAKE1("PassengerAnalyticsLogDir",
+		(Take1Func) cmd_passenger_analytics_log_dir,
+		NULL,
+		RSRC_CONF,
+		"Directory in which to store analytics logs."),
+	AP_INIT_TAKE1("PassengerAnalyticsLogUser",
+		(Take1Func) cmd_passenger_analytics_log_user,
+		NULL,
+		RSRC_CONF,
+		"The owner of analytics files."),
+	AP_INIT_TAKE1("PassengerAnalyticsLogGroup",
+		(Take1Func) cmd_passenger_analytics_log_group,
+		NULL,
+		RSRC_CONF,
+		"The group of analytics files."),
+	AP_INIT_TAKE1("PassengerAnalyticsLogPermissions",
+		(Take1Func) cmd_passenger_analytics_log_permissions,
+		NULL,
+		RSRC_CONF,
+		"The permissions of analytics files."),
+	AP_INIT_TAKE1("PassengerPreStart",
+		(Take1Func) cmd_passenger_pre_start,
+		NULL,
+		RSRC_CONF,
+		"Prestart the given web applications during startup."),
+	AP_INIT_TAKE1("PassengerAnalytics",
+		(Take1Func) cmd_passenger_analytics,
+		NULL,
+		OR_OPTIONS | ACCESS_CONF | RSRC_CONF,
+		"Whether to enable analytics logging."),
+	
+	/*****************************/
+
+	// Rails-specific settings.
+	AP_INIT_TAKE1("RailsBaseURI",
+		(Take1Func) cmd_rails_base_uri,
+		NULL,
+		OR_OPTIONS | ACCESS_CONF | RSRC_CONF,
+		"Reserve the given URI to a Rails application."),
+	AP_INIT_FLAG("RailsAutoDetect",
+		(FlagFunc) cmd_rails_auto_detect,
+		NULL,
+		RSRC_CONF,
+		"Whether auto-detection of Ruby on Rails applications should be enabled."),
+	AP_INIT_TAKE1("RailsEnv",
+		(Take1Func) cmd_environment,
+		NULL,
+		OR_OPTIONS | ACCESS_CONF | RSRC_CONF,
+		"The environment under which a Rails app must run."),
+	AP_INIT_TAKE1("RailsFrameworkSpawnerIdleTime",
+		(Take1Func) cmd_rails_framework_spawner_idle_time,
+		NULL,
+		RSRC_CONF,
+		"The maximum number of seconds that a framework spawner may be idle before it is shutdown."),
+	AP_INIT_TAKE1("RailsAppSpawnerIdleTime",
+		(Take1Func) cmd_rails_app_spawner_idle_time,
+		NULL,
+		RSRC_CONF,
+		"The maximum number of seconds that an application spawner may be idle before it is shutdown."),
+	
+	// Rack-specific settings.
+	AP_INIT_TAKE1("RackBaseURI",
+		(Take1Func) cmd_rack_base_uri,
+		NULL,
+		OR_OPTIONS | ACCESS_CONF | RSRC_CONF,
+		"Reserve the given URI to a Rack application."),
+	AP_INIT_FLAG("RackAutoDetect",
+		(FlagFunc) cmd_rack_auto_detect,
+		NULL,
+		RSRC_CONF,
+		"Whether auto-detection of Rack applications should be enabled."),
+	AP_INIT_TAKE1("RackEnv",
+		(Take1Func) cmd_environment,
+		NULL,
+		OR_OPTIONS | ACCESS_CONF | RSRC_CONF,
+		"The environment under which a Rack app must run."),
+	
+	// WSGI-specific settings.
+	AP_INIT_FLAG("PassengerWSGIAutoDetect",
+		(FlagFunc) cmd_wsgi_auto_detect,
+		NULL,
+		RSRC_CONF,
+		"Whether auto-detection of WSGI applications should be enabled."),
+	
+	// Backwards compatibility options.
+	AP_INIT_TAKE1("RailsRuby",
+		(Take1Func) cmd_passenger_ruby,
+		NULL,
+		RSRC_CONF,
+		"Deprecated option."),
+	AP_INIT_TAKE1("RailsMaxPoolSize",
+		(Take1Func) cmd_passenger_max_pool_size,
+		NULL,
+		RSRC_CONF,
+		"Deprecated option."),
+	AP_INIT_TAKE1("RailsMaxInstancesPerApp",
+		(Take1Func) cmd_passenger_max_instances_per_app,
+		NULL,
+		RSRC_CONF,
+		"Deprecated option"),
+	AP_INIT_TAKE1("RailsPoolIdleTime",
+		(Take1Func) cmd_passenger_pool_idle_time,
+		NULL,
+		RSRC_CONF,
+		"Deprecated option."),
+	AP_INIT_FLAG("RailsUserSwitching",
+		(FlagFunc) cmd_passenger_user_switching,
+		NULL,
+		RSRC_CONF,
+		"Deprecated option."),
+	AP_INIT_TAKE1("RailsDefaultUser",
+		(Take1Func) cmd_passenger_default_user,
+		NULL,
+		RSRC_CONF,
+		"Deprecated option."),
+	AP_INIT_TAKE1("RailsSpawnMethod",
+		(Take1Func) cmd_passenger_spawn_method,
+		NULL,
+		RSRC_CONF,
+		"Deprecated option."),
+	
+	// Obsolete options.
+	AP_INIT_TAKE1("RailsSpawnServer",
+		(Take1Func) cmd_rails_spawn_server,
+		NULL,
+		RSRC_CONF,
+		"Obsolete option."),
+	AP_INIT_FLAG("RailsAllowModRewrite",
+		(FlagFunc) cmd_rails_allow_mod_rewrite,
+		NULL,
+		RSRC_CONF,
+		"Whether custom mod_rewrite rules should be allowed."),
+	
+	{ NULL }
+};
+
+} // extern "C"