passenger 4.0.44 → 4.0.45

data/ext/common/ApplicationPool2/README.md

@@ -1,56 +0,0 @@
-# Overview
-
-ApplicationPool2 is a subsystem in Phusion Passenger that takes care of
-dynamically calculating how many processes are needed, spawning application
-processes, shutting down processes, restarting processes, forwarding requests to
-the right process, etc. Pretty much all important application process management
-is encapculated in this subsystem.
-
-It does not handle the actual request/response I/O with the application
-processes: that's left to the caller of the ApplicationPool2 subsystem.
-
-Here's a quick rundown of the available classes:
-
- * Pool
-   This is the core of the subsystem. It contains high-level process management
-   logic but not the low-level details of spawning processes. The code is
-   further divided into the following classes, each of which contain the core
-   code managing its respective domain:
-   * SuperGroup
-     A logical collection of different applications. Can contain one or more
-     Groups. In the current version of Phusion Passenger, a SuperGroup only
-     contains exactly 1 Group.
-   * Group
-     Represents an application and can contains multiple processes, all
-     belonging to the same application.
-   * Process
-     Represents an OS process; an instance of a certain application. A process
-     may have multiple server sockets on which it listens. This is represented
-     by the `Socket` class:
-     * Socket
-
- * Spawner
-   Encapsulates all low-level process spawning logic. Pool calls Spawner
-   whenever it needs to spawn another application process.
-
-   Spawner is an interface. There are multiple implementations that all
-   spawn processes in a different way. These are:
-   * DirectSpawner
-   * SmartSpawner
-   * DummySpawner
-
-   The spawn method is user-configurable. To avoid convoluting the Pool code
-   with spawner implementation selection logic, we have:
-   * SpawnerFactory
-
- * Session
-   A session represents a single interaction with an application process, e.g.
-   a single request/response session.
-
- * Options
-   A configuration object for the Pool::get() method.
-
-The `Pool` class's `get` method is the main interface into the ApplicationPool2
-subsystem. When an HTTP request comes in, call `Pool::get()` with the
-appropriate arguments, and it will automatically spawn a process for you when
-needed, open a session with that process and give you the session object.

data/man/passenger-stress-test.1

@@ -1,43 +0,0 @@
-.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/node_lib/phusion_passenger/httplib_emulation.js

@@ -1,215 +0,0 @@
-/*
- *  Phusion Passenger - https://www.phusionpassenger.com/
- *  Copyright (c) 2013-2014 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.
- */
-
-/**
- * Provides helper functions for emulating the http.Server API.
- */
-
-var http = require('http');
-
-const HTTP_HEADERS_WITHOUT_PREFIX = {
-	'CONTENT_LENGTH': true,
-	'CONTENT_TYPE': true
-};
-
-function cgiKeyToHttpHeader(key) {
-	if (HTTP_HEADERS_WITHOUT_PREFIX[key]) {
-		return key.toLowerCase().replace(/_/g, '-');
-	} else if (key.match(/^HTTP_/)) {
-		return key.replace(/^HTTP_/, '').toLowerCase().replace(/_/g, '-');
-	} else {
-		return undefined;
-	}
-}
-
-function setHttpHeaders(httpHeaders, cgiHeaders) {
-	for (var i = 0; i < cgiHeaders.keys.length; i++) {
-		var key = cgiHeaders.keys[i];
-		var httpHeader = cgiKeyToHttpHeader(key);
-		if (httpHeader !== undefined) {
-			httpHeaders[httpHeader] = cgiHeaders[key];
-		}
-	}
-
-	if (cgiHeaders['HTTPS']) {
-		httpHeaders['x-forwarded-proto'] = 'https';
-	}
-	if (!httpHeaders['x-forwarded-for']) {
-		httpHeaders['x-forwarded-for'] = cgiHeaders['REMOTE_ADDR'];
-	}
-}
-
-function inferHttpVersion(protocolDescription) {
-	var match = protocolDescription.match(/^HTTP\/(.+)/);
-	if (match) {
-		return match[1];
-	}
-}
-
-function createIncomingMessage(headers, socket, bodyBegin) {
-	/* Node's HTTP parser simulates an 'end' event if it determines that
-	 * the request should not have a request body. Currently (Node 0.10.18),
-	 * it thinks GET requests without an Upgrade header should not have a
-	 * request body, even though technically such GET requests are allowed
-	 * to have a request body. For compatibility reasons we implement the
-	 * same behavior as Node's HTTP parser.
-	 */
-
-	var message = new http.IncomingMessage(socket);
-	setHttpHeaders(message.headers, headers);
-	message.cgiHeaders = headers;
-	message.httpVersion = inferHttpVersion(headers['SERVER_PROTOCOL']);
-	message.method = headers['REQUEST_METHOD'];
-	message.url    = headers['REQUEST_URI'];
-	message.connection.remoteAddress = headers['REMOTE_ADDR'];
-	message.connection.remotePort = parseInt(headers['REMOTE_PORT']);
-	message.upgrade = !!headers['HTTP_UPGRADE'];
-
-	if (message.upgrade) {
-		// Emit end event as described above.
-		message.push(null);
-		return message;
-	}
-
-	message._emitEndEvent = IncomingMessage_emitEndEvent;
-	resetIncomingMessageOverridedMethods(message);
-
-	socket.on('end', function() {
-		message._emitEndEvent();
-	});
-	socket.on('drain', function() {
-		message.emit('drain');
-	});
-	socket.on('timeout', function() {
-		message.emit('timeout');
-	});
-
-	if (headers['REQUEST_METHOD'] != 'GET') {
-		if (bodyBegin.length > 0) {
-			message.push(bodyBegin);
-		}
-		socket.ondata = function(buffer, offset, end) {
-			if (!message.push(buffer.slice(offset, end))) {
-				socket._handle.readStop();
-			}
-		}
-	} else {
-		// Emit end event as described above.
-		message.push(null);
-	}
-
-	return message;
-}
-
-function IncomingMessage_pause() {
-	this._flowing = false;
-	this._orig_pause();
-	resetIncomingMessageOverridedMethods(this);
-}
-
-function IncomingMessage_resume() {
-	this._flowing = true;
-	this._orig_resume();
-	resetIncomingMessageOverridedMethods(this);
-}
-
-function IncomingMessage_on(event, listener) {
-	if (event == 'data') {
-		this._flowing = true;
-		installDataEventHandler(this);
-	} else if (event == 'readable') {
-		installReadableEventHandler(this);
-	}
-	this._orig_on.call(this, event, listener);
-	resetIncomingMessageOverridedMethods(this);
-	return this;
-}
-
-function IncomingMessage_emitEndEvent() {
-	if (!this._readableState.endEmitted) {
-		this._readableState.endEmitted = true;
-		this.emit('end');
-	}
-}
-
-/*
- * Calling on(), pause() etc on the message object may cause our overrided
- * methods to be set to something else. This is probably becaused by the code
- * in Node.js responsible for switching a stream to flowing mode, e.g.
- * emitDataEvents() in _stream_readable.js. Thus, this function
- * should be called from on(), pause() etc.
- */
-function resetIncomingMessageOverridedMethods(message) {
-	if (message.pause !== IncomingMessage_pause) {
-		message._orig_pause = message.pause;
-		message.pause = IncomingMessage_pause;
-	}
-	if (message.resume !== IncomingMessage_resume) {
-		message._orig_resume = message.resume;
-		message.resume = IncomingMessage_resume;
-	}
-	if (message.on !== IncomingMessage_on) {
-		message._orig_on = message.on;
-		message.on = IncomingMessage_on;
-		message.addListener = IncomingMessage_on;
-	}
-}
-
-function installDataEventHandler(message) {
-	if (!message._dataEventHandlerInstalled) {
-		message._dataEventHandlerInstalled = true;
-		message.socket.on('data', function(chunk) {
-			message.emit('data', chunk);
-		});
-	}
-}
-
-function installReadableEventHandler(message) {
-	if (!message._readableEventHandlerInstalled) {
-		message._readableEventHandlerInstalled = true;
-		message.socket.on('readable', function() {
-			message.emit('readable');
-		});
-	}
-}
-
-function createServerResponse(req) {
-	var res = new http.ServerResponse(req);
-	res.assignSocket(req.socket);
-	res.shouldKeepAlive = false;
-	req.socket.on('drain', function() {
-		res.emit('drain');
-	});
-	req.socket.on('timeout', function() {
-		res.emit('timeout');
-	});
-	res.once('finish', function() {
-		req.socket.destroySoon();
-	});
-	return res;
-}
-
-exports.createIncomingMessage = createIncomingMessage;
-exports.createServerResponse  = createServerResponse;

data/node_lib/phusion_passenger/request_handler.js

@@ -1,73 +0,0 @@
-/*
- *  Phusion Passenger - https://www.phusionpassenger.com/
- *  Copyright (c) 2012-2013 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.
- */
-
-var net = require('net');
-var SessionProtocolParser = require('./session_protocol_parser').SessionProtocolParser;
-
-/**
- * Handles incoming Phusion Passenger requests and emits events.
- */
-function RequestHandler(readyCallback, clientCallback) {
-	var self = this;
-
-	function handleNewClient(socket) {
-		var state = 'PARSING_HEADER';
-		var parser = new SessionProtocolParser();
-
-		function handleReadable() {
-			// read(n) returns null unless the buffer is at least n bytes.
-			// We just want to read whatever we can we poke into its buffer.
-			// Hope they don't change the this.
-			var len = socket._readableState.length;
-			handleData(socket.read(len));
-		}
-
-		function handleData(data) {
-			if (state == 'PARSING_HEADER') {
-				var consumed = parser.feed(data);
-				if (parser.state == SessionProtocolParser.SPP_DONE) {
-					state = 'HEADER_SEEN';
-					socket.removeListener('readable', handleReadable);
-					PhusionPassenger.emit('request', parser, socket, data.slice(consumed));
-				} else if (parser.state == SessionProtocolParser.SPP_ERROR) {
-					console.error('Header parse error');
-					socket.destroySoon();
-				}
-			} else {
-				// Do nothing.
-			}
-		}
-
-		socket.on('readable', handleReadable);
-	}
-
-	var server = net.createServer({ allowHalfOpen: true }, handleNewClient);
-	this.server = server;
-	server.listen(0, function() {
-		readyCallback(self);
-	});
-}
-
-exports.RequestHandler = RequestHandler;

data/node_lib/phusion_passenger/session_protocol_parser.js

@@ -1,113 +0,0 @@
-/*
- *  Phusion Passenger - https://www.phusionpassenger.com/
- *  Copyright (c) 2012-2013 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.
- */
-
-const SPP_PARSING_SIZE    = SessionProtocolParser.SPP_PARSING_SIZE = 0;
-const SPP_PARSING_HEADERS = SessionProtocolParser.SPP_PARSING_HEADERS = 1;
-const SPP_DONE            = SessionProtocolParser.SPP_DONE = 10;
-const SPP_ERROR           = SessionProtocolParser.SPP_ERROR = 11;
-
-const ENCODING = 'binary';
-
-function SessionProtocolParser() {
-	this.state = SPP_PARSING_SIZE;
-	this.processed = 0;
-	this.size = 0;
-	this.keys = [];
-}
-
-SessionProtocolParser.prototype.feed = function(buffer) {
-	var consumed = 0;
-	var locallyConsumed;
-
-	while (consumed < buffer.length && this.state != SPP_ERROR && this.state != SPP_DONE) {
-		switch (this.state) {
-		case SPP_PARSING_SIZE:
-			this.size += buffer[consumed] * Math.pow(256, 3 - this.processed);
-			locallyConsumed = 1;
-			this.processed++;
-			if (this.processed == 4) {
-				this.state = SPP_PARSING_HEADERS;
-				this.buffer = new Buffer(this.size);
-				this.processed = 0;
-			}
-			break;
-
-		case SPP_PARSING_HEADERS:
-			locallyConsumed = Math.min(buffer.length - consumed, this.buffer.length - this.processed);
-			buffer.copy(this.buffer, this.processed, consumed, consumed + locallyConsumed);
-			this.processed += locallyConsumed;
-			if (this.processed == this.buffer.length) {
-				this.state = SPP_DONE;
-				this.parse();
-			}
-			break;
-
-		default:
-			console.assert(false);
-			break;
-		}
-
-		consumed += locallyConsumed;
-	}
-
-	return consumed;
-}
-
-SessionProtocolParser.prototype.parse = function() {
-	function findZero(buffer, start) {
-		while (start < buffer.length) {
-			if (buffer[start] == 0) {
-				return start;
-			} else {
-				start++;
-			}
-		}
-		return -1;
-	}
-
-	var start = 0;
-	var key, value;
-
-	while (start < this.buffer.length) {
-		var keyEnd = findZero(this.buffer, start);
-		if (keyEnd != -1 && keyEnd + 1 < this.buffer.length) {
-			var valueStart = keyEnd + 1;
-			var valueEnd   = findZero(this.buffer, valueStart);
-			if (valueEnd != -1) {
-				key = this.buffer.toString(ENCODING, start, keyEnd);
-				value = this.buffer.toString(ENCODING, valueStart, valueEnd);
-				start = valueEnd + 1;
-				this.keys.push(key);
-				this[key] = value;
-			} else {
-				start = this.buffer.length;
-			}
-		} else {
-			start = this.buffer.length;
-		}
-	}
-}
-
-exports.SessionProtocolParser = SessionProtocolParser;