passenger 4.0.59 → 4.0.60

data/packaging/debian/debian_specs/nginx/modules/nginx-echo/src/ngx_http_echo_var.c

@@ -0,0 +1,110 @@
+#ifndef DDEBUG
+#define DDEBUG 0
+#endif
+#include "ddebug.h"
+
+#include "ngx_http_echo_var.h"
+#include "ngx_http_echo_timer.h"
+#include "ngx_http_echo_request_info.h"
+#include "ngx_http_echo_foreach.h"
+
+
+static ngx_int_t ngx_http_echo_incr_variable(ngx_http_request_t *r,
+        ngx_http_variable_value_t *v, uintptr_t data);
+
+
+static ngx_http_variable_t ngx_http_echo_variables[] = {
+
+    { ngx_string("echo_timer_elapsed"), NULL,
+      ngx_http_echo_timer_elapsed_variable, 0,
+      NGX_HTTP_VAR_NOCACHEABLE, 0 },
+
+    { ngx_string("echo_request_method"), NULL,
+      ngx_http_echo_request_method_variable, 0,
+      NGX_HTTP_VAR_NOCACHEABLE, 0 },
+
+    { ngx_string("echo_cacheable_request_uri"), NULL,
+      ngx_http_echo_cacheable_request_uri_variable, 0,
+      0, 0 },
+
+    { ngx_string("echo_request_uri"), NULL,
+      ngx_http_echo_request_uri_variable, 0,
+      0, 0 },
+
+    { ngx_string("echo_client_request_method"), NULL,
+      ngx_http_echo_client_request_method_variable, 0,
+      NGX_HTTP_VAR_NOCACHEABLE, 0 },
+
+    { ngx_string("echo_request_body"), NULL,
+      ngx_http_echo_request_body_variable, 0,
+      NGX_HTTP_VAR_NOCACHEABLE, 0 },
+
+    { ngx_string("echo_client_request_headers"), NULL,
+      ngx_http_echo_client_request_headers_variable, 0,
+      NGX_HTTP_VAR_NOCACHEABLE, 0 },
+
+    { ngx_string("echo_it"), NULL,
+      ngx_http_echo_it_variable, 0,
+      NGX_HTTP_VAR_NOCACHEABLE, 0 },
+
+    { ngx_string("echo_incr"), NULL,
+      ngx_http_echo_incr_variable, 0,
+      NGX_HTTP_VAR_NOCACHEABLE, 0 },
+
+    { ngx_string("echo_response_status"), NULL,
+      ngx_http_echo_response_status_variable, 0,
+      NGX_HTTP_VAR_NOCACHEABLE, 0 },
+
+    { ngx_null_string, NULL, NULL, 0, 0, 0 }
+};
+
+
+ngx_int_t
+ngx_http_echo_add_variables(ngx_conf_t *cf)
+{
+    ngx_http_variable_t *var, *v;
+
+    for (v = ngx_http_echo_variables; v->name.len; v++) {
+        var = ngx_http_add_variable(cf, &v->name, v->flags);
+        if (var == NULL) {
+            return NGX_ERROR;
+        }
+
+        var->get_handler = v->get_handler;
+        var->data = v->data;
+    }
+
+    return NGX_OK;
+}
+
+
+static ngx_int_t
+ngx_http_echo_incr_variable(ngx_http_request_t *r,
+    ngx_http_variable_value_t *v, uintptr_t data)
+{
+    ngx_http_echo_ctx_t         *ctx;
+    u_char                      *p;
+
+    ctx = ngx_http_get_module_ctx(r->main, ngx_http_echo_module);
+
+    if (ctx == NULL) {
+        return NGX_ERROR;
+    }
+
+    ctx->counter++;
+
+    p = ngx_palloc(r->pool, NGX_INT_T_LEN);
+    if (p == NULL) {
+        return NGX_ERROR;
+    }
+
+    v->len = ngx_sprintf(p, "%ui", ctx->counter) - p;
+    v->data = p;
+
+    v->valid = 1;
+    v->not_found = 0;
+    v->no_cacheable = 1;
+
+    return NGX_OK;
+}
+

data/packaging/debian/debian_specs/nginx/modules/nginx-echo/src/ngx_http_echo_var.h

@@ -0,0 +1,9 @@
+#ifndef ECHO_VAR_H
+#define ECHO_VAR_H
+
+#include "ngx_http_echo_module.h"
+
+ngx_int_t ngx_http_echo_add_variables(ngx_conf_t *cf);
+
+#endif /* ECHO_VAR_H */
+

data/packaging/debian/debian_specs/nginx/modules/nginx-echo/util/build.sh

@@ -0,0 +1,45 @@
+#!/usr/bin/env bash
+
+# this file is mostly meant to be used by the author himself.
+
+root=`pwd`
+version=$1
+force=$2
+home=~
+
+  #--without-http_ssi_module \
+            #--with-cc=gcc46 \
+
+ngx-build $force $version \
+            --with-ld-opt="-L$PCRE_LIB -Wl,-rpath,$PCRE_LIB:$LIBDRIZZLE_LIB:/usr/local/lib" \
+            --with-cc-opt="-DDEBUG_MALLOC" \
+            --with-http_stub_status_module \
+            --without-mail_pop3_module \
+            --without-mail_imap_module \
+            --without-mail_smtp_module \
+            --without-http_upstream_ip_hash_module \
+            --without-http_empty_gif_module \
+            --without-http_memcached_module \
+            --without-http_referer_module \
+            --without-http_autoindex_module \
+            --without-http_auth_basic_module \
+            --without-http_userid_module \
+          --with-http_addition_module \
+          --add-module=$root/../ndk-nginx-module \
+          --add-module=$root/../set-misc-nginx-module \
+          --add-module=$root/../eval-nginx-module \
+          --add-module=$root/../xss-nginx-module \
+          --add-module=$root/../rds-json-nginx-module \
+          --add-module=$root/../headers-more-nginx-module \
+          --add-module=$root/../lua-nginx-module \
+          --add-module=$root $opts \
+          --with-select_module \
+          --with-poll_module \
+          --with-rtsig_module \
+          --with-debug || exit 1
+          #--add-module=$root/../lz-session-nginx-module \
+          #--add-module=$home/work/ndk \
+          #--add-module=$home/work/ndk/examples/http/set_var \
+          #--add-module=$root/../eval-nginx-module \
+          #--add-module=/home/agentz/work/nginx_eval_module-1.0.1 \
+

data/packaging/debian/debian_specs/nginx/modules/nginx-echo/util/releng

@@ -0,0 +1,8 @@
+#!/bin/bash
+
+./update-readme
+ack '.{81}' src/ngx_http_*.[ch]
+ack '(?<=\#define)\s*DDEBUG\s*[12]' src
+echo =======================================
+ack '(?<=This document describes echo-nginx-module v)\d+\.\d+' README
+

data/packaging/debian/debian_specs/nginx/modules/nginx-echo/util/wiki2pod.pl

@@ -0,0 +1,131 @@
+#!/usr/bin/env perl
+
+use strict;
+use warnings;
+use bytes;
+
+my @nl_counts;
+my $last_nl_count_level;
+
+my @bl_counts;
+my $last_bl_count_level;
+
+sub fmt_pos ($) {
+    (my $s = $_[0]) =~ s{\#(.*)}{/"$1"};
+    $s;
+}
+
+sub fmt_mark ($$) {
+    my ($tag, $s) = @_;
+    my $max_level = 0;
+    while ($s =~ /([<>])\1*/g) {
+        my $level = length $&;
+        if ($level > $max_level) {
+            $max_level = $level;
+        }
+    }
+
+    my $times = $max_level + 1;
+    if ($times > 1) {
+        $s = " $s ";
+    }
+    return $tag . ('<' x $times) . $s . ('>' x $times);
+}
+
+print "=encoding utf-8\n\n";
+
+while (<>) {
+    if ($. == 1) {
+        # strip the leading U+FEFF byte in MS-DOS text files
+        my $first = ord(substr($_, 0, 1));
+        #printf STDERR "0x%x", $first;
+        #my $second = ord(substr($_, 2, 1));
+        #printf STDERR "0x%x", $second;
+        if ($first == 0xEF) {
+            substr($_, 0, 1, '');
+            #warn "Hit!";
+        }
+    }
+    s{\[(http[^ \]]+) ([^\]]*)\]}{$2 (L<$1>)}gi;
+    s{ \[\[ ( [^\]\|]+ ) \| ([^\]]*) \]\] }{"L<$2|" . fmt_pos($1) . ">"}gixe;
+    s{<code>(.*?)</code>}{fmt_mark('C', $1)}gie;
+    s{'''(.*?)'''}{fmt_mark('B', $1)}ge;
+    s{''(.*?)''}{fmt_mark('I', $1)}ge;
+    if (s{^\s*<[^>]+>\s*$}{}) {
+        next;
+    }
+
+    if (/^\s*$/) {
+        print "\n";
+        next;
+    }
+
+=begin cmt
+
+    if ($. == 1) {
+        warn $_;
+        for my $i (0..length($_) - 1) {
+            my $chr = substr($_, $i, 1);
+            warn "chr ord($i): ".ord($chr)." \"$chr\"\n";
+        }
+    }
+
+=end cmt
+=cut
+
+    if (/(=+) (.*) \1$/) {
+        #warn "HERE! $_" if $. == 1;
+        my ($level, $title) = (length $1, $2);
+        collapse_lists();
+
+        print "\n=head$level $title\n\n";
+    } elsif (/^(\#+) (.*)/) {
+        my ($level, $txt) = (length($1) - 1, $2);
+        if (defined $last_nl_count_level && $level != $last_nl_count_level) {
+            print "\n=back\n\n";
+        }
+        $last_nl_count_level = $level;
+        $nl_counts[$level] ||= 0;
+        if ($nl_counts[$level] == 0) {
+            print "\n=over\n\n";
+        }
+        $nl_counts[$level]++;
+        print "\n=item $nl_counts[$level].\n\n";
+        print "$txt\n";
+    } elsif (/^(\*+) (.*)/) {
+        my ($level, $txt) = (length($1) - 1, $2);
+        if (defined $last_bl_count_level && $level != $last_bl_count_level) {
+            print "\n=back\n\n";
+        }
+        $last_bl_count_level = $level;
+        $bl_counts[$level] ||= 0;
+        if ($bl_counts[$level] == 0) {
+            print "\n=over\n\n";
+        }
+        $bl_counts[$level]++;
+        print "\n=item *\n\n";
+        print "$txt\n";
+    } else {
+        collapse_lists();
+        print;
+    }
+}
+
+collapse_lists();
+
+sub collapse_lists {
+    while (defined $last_nl_count_level && $last_nl_count_level >= 0) {
+        print "\n=back\n\n";
+        $last_nl_count_level--;
+    }
+    undef $last_nl_count_level;
+    undef @nl_counts;
+
+    while (defined $last_bl_count_level && $last_bl_count_level >= 0) {
+        print "\n=back\n\n";
+        $last_bl_count_level--;
+    }
+    undef $last_bl_count_level;
+    undef @bl_counts;
+}
+

data/packaging/debian/debian_specs/nginx/modules/nginx-echo/valgrind.suppress

@@ -0,0 +1,38 @@
+{
+   <insert_a_suppression_name_here>
+   Memcheck:Addr4
+   fun:lj_str_new
+   fun:lua_setfield
+   fun:ngx_http_lua_cache_store_code
+}
+{
+   <insert_a_suppression_name_here>
+   Memcheck:Addr4
+   fun:lj_str_new
+   fun:lua_getfield
+   fun:ngx_http_lua_cache_load_code
+}
+{
+   <insert_a_suppression_name_here>
+   Memcheck:Param
+   epoll_ctl(event)
+   fun:epoll_ctl
+}
+{
+   <insert_a_suppression_name_here>
+   Memcheck:Leak
+   fun:malloc
+   fun:ngx_alloc
+   fun:ngx_event_process_init
+}
+{
+   <insert_a_suppression_name_here>
+   Memcheck:Cond
+   fun:index
+   fun:expand_dynamic_string_token
+   fun:_dl_map_object
+   fun:map_doit
+   fun:_dl_catch_error
+   fun:do_preload
+   fun:dl_main
+}

data/packaging/debian/debian_specs/nginx/modules/nginx-http-push/LICENCE

@@ -0,0 +1,24 @@
+This work is distributed under the MIT Licence.
+
+Copyright (c) 2009 Leo Ponomarev
+
+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.

data/packaging/debian/debian_specs/nginx/modules/nginx-http-push/README

@@ -0,0 +1,206 @@
+NGiNX HTTP push module - Turn NGiNX into an adept HTTP Push (Comet) server.
+
+This module takes care of all the connection juggling, and exposes a simple
+interface to broadcast messages to clients via plain old HTTP requests.
+This makes it possible to write live-updating applications without having to
+wait on idle connections via upstream proxies or making your code all
+asynchronous and concurrent.
+
+---------------- Configuration Directives & Variables ------------------------
+Variables:
+$push_channel_id
+  A token uniquely identifying a communication channel. Must be present in the
+  context of the push_subscriber and push_publisher directives.
+  Example:
+    set $push_channel_id $arg_id; 
+	#channel id is now the url query string parameter "id"
+	#(/foo/bar?id=channel_id_string)
+
+Directives:
+
+==Publisher/Subscriber==
+
+push_subscriber [ long-poll | interval-poll ]
+  default: long-poll
+  context: server, location
+  Defines a server or location as a subscriber. This location represents a 
+  subscriber's interface to a channel's message queue. The queue is traversed
+  automatically via caching information request headers (If-Modified-Since and
+  If-None-Match), beginning with the oldest available message. Requests for 
+  upcoming messages are handled in accordance with the setting provided. 
+  See the protocol documentation for a detailed description. 
+
+push_subscriber_concurrency [ last | first | broadcast ]
+  default: broadcast
+  context: http, server, location
+  Controls how multiple subscriber requests to a channel (identified by
+  some common ID) are handled.
+  The values work as follows:
+   - broadcast: any number of concurrent subscriber requests may be held.
+   - last: only the most recent subscriber request is kept, all others get 
+     a 409 Conflict response.
+   - first: only the oldest subscriber request is kept, all others get a 
+     409 Conflict response.
+
+push_publisher
+  default: none
+  context: server, location
+  Defines a server or location as a message publisher. Requests to a publisher
+  location are treated as messages to be sent to subscribers. See the protocol 
+  documentation for a detailed description. 
+
+== Message storage ==
+
+push_store_messages [ on | off ]
+  default: on
+  context: http, server, location
+  Whether or not message queuing is enabled. "Off" is equivalent to the setting
+  push_channel_buffer_length 0;
+
+push_max_reserved_memory [ size ]
+  default: 32M
+  context: http
+  The size of the memory chunk this module will use for all message queuing
+  and buffering. 
+
+push_min_message_buffer_length [ number ]
+  default: 1
+  context: http, server, location
+  The minimum number of messages to store per channel. A channel's message
+  buffer will retain at least this many most recent messages.
+
+push_max_message_buffer_length [ number ]
+  default: 10
+  context: http, server, location
+  The maximum number of messages to store per channel. A channel's message
+  buffer will retain at most this many most recent messages.
+
+push_message_buffer_length [ number ]
+  default: none
+  context: http, server, location
+  The exact number of messages to store per channel. Sets both
+  push_max_message_buffer_length and push_min_message_buffer_length to this 
+  value.
+  
+push_delete_oldest_received_message [ on | off ]
+  default: off
+  context: http, server, location
+  When enabled, as soon as the oldest message in a channel's message queue has
+  been received by a subscriber, it is deleted -- provided there are more than
+  push_min_message_buffer_length messages in the channel's message buffer.
+  Recommend avoiding this directive as it violates subscribers' assumptions of 
+  GET request idempotence.
+
+push_message_timeout [ time ]
+  default: 1h
+  context: http, server, location
+  The length of time a message may be queued before it is considered expired. 
+  If you do not want messages to expire, set this to 0. Applicable only if a 
+  push_publisher is present in this or a child context. 
+
+push_subscriber_timeout [ time ]
+  default: 0
+  context: http, server, location
+  The length of time a subscriber's long-polling connection can last before
+  it's timed out. If you don't want subscriber's connection to timeout, set
+  this to 0. Applicable only if a push_subscriber is present in this or a 
+  child context.
+
+push_channel_timeout [ time ]
+  default: 0
+  context: http, server, location
+  The length of time a channel will be removed after it has no subscriber and
+  no queued messages. If you want to remove a channel as soon as possible, 
+  set this to 0. Applicable only if a push_publisher or push_subscriber is 
+  present in this or a child context and push_subscriber_timeout is greater
+  than 0. This value should be greater than push_subscriber_timeout to make
+  sense.
+
+== Security ==
+
+push_authorized_channels_only [ on | off ]
+  default: off
+  context: http, server, location
+  Whether or not a subscriber may create a channel by making a request to a 
+  push_subscriber location. If set to on, a publisher must send a POST or PUT
+  request before a subscriber can request messages on the channel. Otherwise, 
+  all subscriber requests to nonexistent channels will get a 403 Forbidden 
+  response.
+
+push_channel_group [ string ]
+  default: (none)
+  context: server, location
+  Because settings are bound to locations and not individual channels,
+  it is useful to be able to have channels that can be reached only from some
+  locations and never others. That's where this setting comes in. Think of it
+  as a prefix string for the channel id.
+
+push_max_channel_id_length [ number ]
+  default: 512
+  context: main, server, location
+  Maximum permissible channel id length (number of characters). 
+  Longer ids will be truncated.
+
+push_max_channel_subscribers [ number ]
+  default: 0 (unlimited)
+  context: main, server, location
+  Maximum concurrent subscribers. Pretty self-explanatory.
+
+--------------------------- Example Config -----------------------------------
+http {
+  #maximum amount of memory the push module is allowed to use 
+  #for buffering and stuff
+  push_max_reserved_memory	12M; #default is 3M
+
+  # internal publish endpoint (keep it private / protected)
+  location /publish {
+    set $push_channel_id $arg_channel; #/?channel=239aff3 or some-such
+    push_publisher;
+
+    push_message_timeout 2h;           # expire buffered messages after 2 hours
+    push_max_message_buffer_length 10; # store absolutely at most 10 messages
+    push_min_message_recipients 0;     # minimum recipients before purge
+  }
+ 
+  # public long-polling endpoint
+  location /activity {
+    push_subscriber;
+ 
+    # how multiple subscriber requests to the same channel id are handled
+    # - last: only the most recent subscriber request is kept, 409 for others.
+    # - first: only the oldest subscriber request is kept, 409 for others.
+    # - broadcast: any number of subscriber requests may be long-polling.
+    push_subscriber_concurrency broadcast;
+    set $push_channel_id $arg_channel; #/?channel=239aff3 or some-such
+    default_type  text/plain;
+  }
+}
+
+---------------------------- Operation ---------------------------------------
+The following describes what is likely to be the most commonly desired setup:
+
+Assuming the example config given above,
+Clients will connect to http://example.com/activity?id=... and have the 
+response delayed until a message is POSTed to http://example.com/publish?id=...
+Messages can be sent to clients that have not yet connected, i.e. they are 
+queued.
+
+Upon sending a request to a push_publisher location, the message, contained in
+the publisher request body, will be sent to the channel identified by 
+$push_channel_id and to all presently connected channel subscribers. If there 
+are no subscribers waiting for a message at the time, the publisher will be 
+sent to with a with a 202 Accepted response. Otherwise, a 201 Created response
+is sent. Additionally, the body of the publisher response will contain 
+information about the channel (number of current subscribers, message queue
+length, etc).
+ 
+If you intend to have the publisher be a server-side application, it's a damn 
+good idea to make sure the push_publisher location is not publicly accessible.
+
+Traversal through a channel's message buffer by a subscriber requires proper 
+HTTP caching support from the subscriber client. Make sure it correctly sends 
+Last-Modified and Etag headers. (All modern web browsers do this.)
+
+----------------------- Protocol Spec --------------------------------------
+This module is unconditionally (fully) compliant with the Basic HTTP Push 
+Relay Protocol, Rev. 2.21, found in the file protocol.txt.