passenger 4.0.59 → 4.0.60

data/packaging/debian/debian_specs/nginx/modules/nginx-development-kit/docs/modules/set_var

@@ -0,0 +1,124 @@
+
+set var tools
+=============
+
+OVERVIEW
+--------
+This collection of tools is designed to make it easier to set Nginx variables
+using a common interface.  It works by plugging into and extending the features
+of the internal rewrite module, and operations performed by this module are
+therefore done at the rewrite phase of handling.
+
+
+ADVANTAGES OF USING THIS MODULE
+-------------------------------
+
+- simple interface - you don't have to worry about lots of http script compiling
+- it plugs into the rewrite module, so setting (and getting) vars will happen
+  in the order you expect based on how they appear in the configuration file
+- you do not have to worry about overriding the v->get_handler (useful if
+  a variable of a specific name could be set in multiple different ways)
+
+
+WHEN TO USE THIS AND WHEN TO USE v->get_handler = my_func
+---------------------------------------------------------
+
+- if you want a variable to always be generated using a specific function,
+    and should not be over-ridden by 'set' functions (e.g. $request_uri, 
+    $document_root), then you should use v->get_handler
+
+- if you want to allow a variable to be set using many possible methods,
+    including using the 'set' directive, then this module provides an easy way
+    for you to do so (if you use the v->get_handler method in this case, you may
+    run into problems because the get_handler may over-ride previous uses of the
+    set directive)
+
+
+USAGE
+-----
+
+- decide on the type of function you'll need to write
+
+    type                                use when there are these requirements
+    ----                                -------------------------------------
+    NDK_SET_VAR_BASIC                   0 variable values, no extra data
+    NDK_SET_VAR_DATA                    0 variable values, extra data
+    NDK_SET_VAR_VALUE                   1 variable value, no extra data
+    NDK_SET_VAR_VALUE_DATA              1 variable value, extra data
+    NDK_SET_VAR_MULTI_VALUE             2+ variable values, no extra data
+    NDK_SET_VAR_MULTI_VALUE_DATA        2+ variable values, extra data
+    NDK_SET_VAR_HASH                    the space needed for the result string 
+                                        value is known in advance (usually 
+                                        used in a hash function)
+
+    NOTE : if none of these generic calling types suit your needs, it is
+    easy to extend the list of types in the .c file (and you if you let me know
+    I'll add them to the list
+
+
+- define the filter function with the respective prototype
+
+    type                                prototype
+    ----                                ---------
+    NDK_SET_VAR_BASIC                   ndk_set_var_pt
+    NDK_SET_VAR_DATA                    ndk_set_var_data_pt
+    NDK_SET_VAR_VALUE                   ndk_set_var_value_pt
+    NDK_SET_VAR_DATA_VALUE              ndk_set_var_value_data_pt
+    NDK_SET_VAR_MULTI_VALUE             ndk_set_var_value_pt
+    NDK_SET_VAR_MULTI_VALUE_DATA        ndk_set_var_value_data_pt
+    NDK_SET_VAR_HASH                    ndk_set_var_hash_pt
+
+    (See ngx_tools_module.h for the prototype definitions.)
+
+    Note : For the multi_value functions, the variable value pointer is to the
+    first value (with the others being in an array following it)
+
+
+to use one of the default setup functions
+-----------------------------------------
+
+- define one or multiple ngx_http_var_filter_t's at the global scope, setting :
+
+    type = (one of types above)
+    func = function to call
+    size = (for multi value)        the number of variable values
+           (for hash)               length of buffer to allocate
+    data = (for data functions)     additional data (see note below)
+
+- define a configuration directive (see in the .c file for examples), where the
+    function is 'ngx_http_set_var' and the 'post' is a pointer your filter definition
+
+
+to setup in a customized way
+----------------------------
+
+- define a configuration directive which has your own specific configuration function
+
+- inside your config function, define one or several ngx_http_var_filter_t's like
+    above, and call one of the ngx_http_set_var_..._core functions, passing the 
+    variable name and value pointers as appropriate - see examples section
+
+Note : if you're passing extra data to the function, then you will probably want
+to use this second method and store the data either in the loc conf, or just
+allocate the space for it using one of the ngx_palloc functions.
+
+If the values that will be used for processing are in the same order as in the
+config file and there aren't any additional values that are input, then you can
+just use the (ngx_str_t *) (cf->args->elts) + 1 as your base for the values or 
+possibly not use the _core versions of the functions.
+
+
+That's it!
+
+
+FEEDBACK
+--------
+
+If you have any comments (good/bad), or have found any bugs, please let me know at:
+ngx.eugaia AT gmail DOT com
+
+
+TODO
+----
+- add more documentation/examples
+

data/packaging/debian/debian_specs/nginx/modules/nginx-development-kit/docs/patches/more_logging_info

@@ -0,0 +1,48 @@
+When tracking down some potential issues in the nginx constellation,
+we've found it useful to understand where particular error messages
+are coming from, since many of the same messages are repeated in
+various places. This patch will write the source file from which the
+message originated, the function name, and the line number if you're
+using GCC to compile nginx. Here's an example:
+
+Old Output:
+2010/01/12 14:43:10 [notice] 67772#0: nginx/0.7.64
+2010/01/12 14:43:10 [notice] 67772#0: built by gcc 4.0.1 (Apple Inc. build 5490)
+2010/01/12 14:43:10 [notice] 67772#0: OS: Darwin 9.8.0
+2010/01/12 14:43:10 [notice] 67772#0: hw.ncpu: 2
+2010/01/12 14:43:10 [notice] 67772#0: net.inet.tcp.sendspace: 65536
+2010/01/12 14:43:10 [notice] 67772#0: kern.ipc.somaxconn: 128
+2010/01/12 14:43:10 [notice] 67772#0: getrlimit(RLIMIT_NOFILE):
+256:9223372036854775807
+2010/01/12 14:43:10 [notice] 67772#0: start worker processes
+2010/01/12 14:43:10 [notice] 67772#0: start worker process 67785
+2010/01/12 14:43:16 [notice] 67772#0: signal 20 (SIGCHLD) received
+
+New Output:
+2010/01/14 16:35:09 [notice] 27241#0: src/os/unix/ngx_posix_init.c
+ngx_os_status(   80) nginx/0.7.64
+2010/01/14 16:35:09 [notice] 27241#0: src/os/unix/ngx_posix_init.c
+ngx_os_status(   83) built by gcc 4.0.1 (Apple Inc. build 5490)
+2010/01/14 16:35:09 [notice] 27241#0: src/os/unix/ngx_darwin_init.c
+ngx_os_specific_status(  153) OS: Darwin 9.8.0
+2010/01/14 16:35:09 [notice] 27241#0: src/os/unix/ngx_darwin_init.c
+ngx_os_specific_status(  166) hw.ncpu: 2
+2010/01/14 16:35:09 [notice] 27241#0: src/os/unix/ngx_darwin_init.c
+ngx_os_specific_status(  166) net.inet.tcp.sendspace: 65536
+2010/01/14 16:35:09 [notice] 27241#0: src/os/unix/ngx_darwin_init.c
+ngx_os_specific_status(  166) kern.ipc.somaxconn: 128
+2010/01/14 16:35:09 [notice] 27241#0: src/os/unix/ngx_posix_init.c
+ngx_os_status(   92) getrlimit(RLIMIT_NOFILE):
+2560:9223372036854775807
+2010/01/14 16:35:09 [notice] 27241#0: src/os/unix/ngx_process_cycle.c
+ngx_start_worker_processes(  337) start worker processes
+2010/01/14 16:35:09 [notice] 27241#0: src/os/unix/ngx_process.c
+ngx_spawn_process(  201) start worker process 27254
+2010/01/14 16:35:14 [notice] 27241#0: src/os/unix/ngx_process.c
+ngx_signal_handler(  420) signal 20 (SIGCHLD) received
+
+Formatting the filename and function name fields into fixed-width
+fields would be nicer, however that would require further changes in
+src/core/ngx_string.c
+
+(C) Brian Moran - bmoran@onehub.com  (posted to nginx-devel mailing list on 15/01/10)

data/packaging/debian/debian_specs/nginx/modules/nginx-development-kit/docs/upstream/list

@@ -0,0 +1,45 @@
+
+NDK_UPSTREAM_LIST
+-----------------
+
+This submodule provides a directive that creates a list of upstreams, with
+optional weighting. This list can then be used by other modules to hash over
+the upstreams however they choose.
+
+
+USAGE IN CONF FILE
+------------------
+
+e.g. upstream_list   name    backend1  4:backend2    3:backend3;
+
+
+
+USAGE WITH OTHER MODULES
+------------------------
+
+Add a line like
+
+CFLAGS="$CFLAGS -DNDK_UPSTREAM_LIST"
+
+to the config file of your module.
+
+
+
+INTEGRATING WITH YOUR MODULE
+----------------------------
+
+The upstream lists are stored in the array given in the lists.h file, which is
+an array of ndk_upstream_list_t elts.  The elts are currently all pointers to 
+strings which have been distributed according to the weight - so if there are
+two backends, with weight 3 and 4 respectively, there will be 7 pointers in
+total with the first 3 pointing to the first backend and the last 4 to the 
+second.
+
+
+
+TODO
+----
+-   replace strings with pointers to upstreams if they are available (and if 
+    this is possible)
+-   add additional 'http://' to strings if necessary
+-   improve this documentation

data/packaging/debian/debian_specs/nginx/modules/nginx-development-kit/examples/README

@@ -0,0 +1,12 @@
+
+2010 (C) Marcus Clyne
+
+
+Examples
+--------
+
+In this section there are a number of examples of the various features of the tools
+module.  These have been given in the form of dummy modules, to make it easier to
+use as templates for your own module should you choose to do so.
+
+

data/packaging/debian/debian_specs/nginx/modules/nginx-development-kit/examples/http/set_var/config

@@ -0,0 +1,4 @@
+ngx_addon_name=ngx_http_set_var_examples_module
+HTTP_MODULES="$HTTP_MODULES ngx_http_set_var_examples_module"
+NGX_ADDON_SRCS="$NGX_ADDON_SRCS $ngx_addon_dir/ngx_http_set_var_examples_module.c"
+have=NDK_SET_VAR . auto/have

data/packaging/debian/debian_specs/nginx/modules/nginx-development-kit/examples/http/set_var/ngx_http_set_var_examples_module.c

@@ -0,0 +1,136 @@
+
+/*
+ * 2010 (C) Marcus Clyne
+ */
+ 
+
+#include    <ndk.h>
+
+
+static ngx_int_t    ngx_http_set_var_concat2    (ngx_http_request_t *r, ngx_str_t *val, ngx_http_variable_value_t *v);
+static char *       ngx_http_set_prepend_hello   (ngx_conf_t *cf, ngx_command_t *cmd, void *conf);
+
+
+static  ndk_set_var_t      ngx_http_var_set_concat2 = {
+    NDK_SET_VAR_MULTI_VALUE,
+    ngx_http_set_var_concat2,
+    2,
+    NULL
+};
+
+
+static ngx_command_t  ngx_http_set_var_examples_commands[] = {
+    {
+        ngx_string ("set_concat2"),
+        NGX_HTTP_MAIN_CONF|NGX_HTTP_SRV_CONF|NGX_HTTP_SIF_CONF|NGX_HTTP_LOC_CONF|NGX_HTTP_LIF_CONF|NGX_CONF_TAKE3,
+        ndk_set_var_multi_value,
+        0,
+        0,
+        &ngx_http_var_set_concat2
+    },
+    {
+        ngx_string ("set_prepend_hello"),
+        NGX_HTTP_MAIN_CONF|NGX_HTTP_SRV_CONF|NGX_HTTP_SIF_CONF|NGX_HTTP_LOC_CONF|NGX_HTTP_LIF_CONF|NGX_CONF_TAKE1,
+        ngx_http_set_prepend_hello,
+        0,
+        0,
+        NULL
+    },
+    ngx_null_command
+};
+
+
+ngx_http_module_t     ngx_http_set_var_examples_module_ctx = {NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL};
+ngx_module_t          ngx_http_set_var_examples_module = {
+
+    NGX_MODULE_V1,
+    &ngx_http_set_var_examples_module_ctx,  // module context
+    ngx_http_set_var_examples_commands,     // module directives
+    NGX_HTTP_MODULE,                        // module type
+    NULL,                                   // init master
+    NULL,                                   // init module
+    NULL,                                   // init process
+    NULL,                                   // init thread
+    NULL,                                   // exit thread
+    NULL,                                   // exit process
+    NULL,                                   // exit master
+    NGX_MODULE_V1_PADDING
+};
+
+
+/*
+    This function is called by both examples, takes two variable values and concatenates them
+    to give a third string.
+*/
+
+static ngx_int_t
+ngx_http_set_var_concat2 (ngx_http_request_t *r, ngx_str_t *val, ngx_http_variable_value_t *v)
+{
+    size_t                      len;
+    ngx_http_variable_value_t   *v2;
+    u_char                      *p;
+
+    v2 = v + 1;
+
+    len = v->len + v2->len;
+
+	/*
+	 * NDK provided abbreviation for the following code:
+	 *
+	 * p = ngx_palloc (r->pool, len);
+	 * if (p == NULL)
+	 * 		return  NGX_ERROR;
+	 *
+	 * */
+	ndk_palloc_re(p, r->pool, len);
+
+    val->data = p;
+    val->len = len;
+
+    ngx_memzero (p, len);
+
+    p = ngx_cpymem (p, v->data, v->len);
+    ngx_memcpy (p, v2->data, v2->len);
+
+    return  NGX_OK;
+}
+
+
+
+/*  
+    This function demonstrates using the 'core' function in a function that appends the word
+    'hello_' to the beginning of a variable.
+
+    set                 $var      world;
+    set_prepend_hello    $var      $var;
+
+    If the arguments used in the variable value filter do not all come directly from the conf
+    file, or are not given in the order
+
+    direcive    $var_name   val1 "val2 string $var" ...
+
+    then the _core functions should be used inside the function that is called when the directive
+    is read.
+*/
+
+static char *
+ngx_http_set_prepend_hello (ngx_conf_t *cf, ngx_command_t *cmd, void *conf)
+{
+    ngx_str_t               s[2], *var_name;
+    ndk_set_var_t      filter;
+
+    var_name = cf->args->elts;
+    var_name++;
+
+    s[0].data = (u_char*) "hello_";
+    s[0].len = 6;
+
+    s[1] = *(var_name + 1);
+
+    filter.type = NDK_SET_VAR_MULTI_VALUE;
+    filter.func = ngx_http_set_var_concat2;
+    filter.size = 2;
+
+    return  ndk_set_var_multi_value_core (cf, var_name, (ngx_str_t *) s, &filter);
+}
+

data/packaging/debian/debian_specs/nginx/modules/nginx-development-kit/ngx_auto_lib_core

@@ -0,0 +1,797 @@
+
+## Directories to search for usable builds:
+##
+## - [$PFX]_INC and [$PFX]_LIB
+## - the dir specified by --with-[$pfx]=*
+## - each dir named [$pfx]-* under [$PFX]_BASE (descending order)
+## - each dir named [$pfx]-* under $ngx_src_dir/.. (descending order)
+## - system_paths (see below)
+##
+## Note : specifying [$PFX]_INC or [$PFX]_LIB prevents other dirs being tried
+##        specifying --with-[$pfx]= prevents autodiscovery of dirs
+##
+## Note : if this file is not in the same directory as the config file, the value
+##        for ngx_auto_lib_file should be changed to a relative path from that file
+## e.g. : $ngx_addon_dir/libs/ngx_auto_lib
+##
+## TODO : explain hooks
+
+#############
+## VERSION ##
+#############
+
+ngx_auto_lib_version=1001
+
+if [ ! $ngx_auto_lib_file_version ] || [ $ngx_auto_lib_file_version -lt $ngx_auto_lib_version ]; then
+
+    if [ ! $ngx_addon_dir ]; then
+        ngx_addon_dir=`cd $(dirname $0); pwd`
+    fi
+
+    ngx_auto_lib_file="$ngx_addon_dir/ngx_auto_lib_core"
+    ngx_auto_lib_file_version="$ngx_auto_lib_version"
+fi
+
+###############
+## VARIABLES ##
+###############
+
+v=
+v="$v       inc_path"
+v="$v       incs"
+v="$v       libs"
+v="$v       name"
+v="$v       path"
+v="$v       run"
+v="$v       test"
+ev=
+ev="$ev     add_libs"
+ev="$ev     add_path"
+ev="$ev     build_dirs"
+ev="$ev     build_inc_dirs"
+ev="$ev     build_lib_dirs"
+ev="$ev     check_macros_defined"
+ev="$ev     check_macros_non_zero"
+ev="$ev     defines"
+ev="$ev     deps"
+ev="$ev     exit_if_not_found"
+ev="$ev     haves"
+ev="$ev     inc_names"
+ev="$ev     lib_files"
+ev="$ev     lib_names"
+ev="$ev     libs_to_add"
+ev="$ev     modules"
+ev="$ev     srcs"
+ev="$ev     shared"
+ev="$ev     test_libs"
+ev="$ev     variables"
+
+ngx_feature_vars="$v"
+ngx_feature_extra_vars="$ev"
+ngx_feature_all_vars="$v $ev"
+
+NGX_AUTO_LIB_DEFAULT_SYSTEM_DIRS='/usr/local /usr /opt/local /opt /usr/pkg'
+
+####################
+## UTIL FUNCTIONS ##
+####################
+
+to_upper() {
+    echo "$@" | tr 'abcdefghijklmnopqrstuvwxyz' 'ABCDEFGHIJKLMNOPQRSTUVWXYZ'
+}
+
+to_lower() {
+    echo "$@" | tr 'ABCDEFGHIJKLMNOPQRSTUVWXYZ' 'abcdefghijklmnopqrstuvwxyz'
+}
+
+####################
+## INIT FUNCTIONS ##
+####################
+
+ngx_auto_lib_init() {
+
+    . $ngx_auto_lib_file
+
+    ngx_auto_lib_init_latest  $@
+}
+
+ngx_auto_lib_init_latest() {
+
+    # set name and prefixes
+
+    if [ ! $1 ]; then
+        echo "ngx_auto_lib_init() requires that a name be passed"
+        exit 1
+    fi
+
+    ngx_auto_lib_name=$1
+    ngx_auto_lib_module_name=$2
+
+    if [ $2 ]; then
+        NGX_AUTO_LIB_PFX=`to_upper $2`
+    else
+        NGX_AUTO_LIB_PFX=`to_upper $1`
+    fi
+
+    ngx_auto_lib_pfx=`to_lower $NGX_AUTO_LIB_PFX`
+
+    ngx_auto_lib_clean_feature_vars
+}
+
+ngx_auto_lib_clean_feature_vars() {
+    for var in $ngx_feature_all_vars; do
+        eval ngx_feature_$var=
+    done
+}
+
+ngx_auto_lib_get_variables() {
+
+    local pfx=$ngx_auto_lib_pfx
+    local PFX=$NGX_AUTO_LIB_PFX
+
+    eval NGX_AUTO_LIB_INC=\"\$${PFX}_INC\"
+    eval NGX_AUTO_LIB_LIB=\"\$${PFX}_LIB\"
+    eval NGX_AUTO_LIB_DIR=\"\$${PFX}\"
+    eval NGX_AUTO_LIB_BASE=\"\$${PFX}_BASE\"
+    eval NGX_AUTO_LIB_SEARCH_LIB_INC=\"\$${PFX}_SEARCH_LIB_INC\"
+    eval NGX_AUTO_LIB_SEARCH_DIR=\"\$${PFX}_SEARCH_DIR\"
+    eval NGX_AUTO_LIB_SEARCH_BASE=\"\$${PFX}_SEARCH_BASE\"
+    eval NGX_AUTO_LIB_SEARCH_BASE_PREFIX=\"\$${PFX}_SEARCH_BASE_PREFIX\"
+    eval NGX_AUTO_LIB_SEARCH_PARENT=\"\$${PFX}_SEARCH_PARENT\"
+    eval NGX_AUTO_LIB_SEARCH_SYSTEM=\"\$${PFX}_SEARCH_SYSTEM\"
+    eval NGX_AUTO_LIB_SHARED=\"\$${PFX}_SHARED\"
+    eval NGX_AUTO_LIB_SYSTEM_DIRS=\"\$${PFX}_SYSTEM_DIR\"
+    eval USE_NGX_AUTO_LIB=\"\$USE_${LIB}\"
+
+    if [ ! "$NGX_AUTO_LIB_DIR" ]; then
+        NGX_AUTO_LIB_DIR=NONE
+    fi
+
+    if [ ! "$USE_NGX_AUTO_LIB" ]; then
+        if [ $ngx_feature_check_macros_defined -o $ngx_feature_check_macros_non_zero ]; then
+            USE_NGX_AUTO_LIB=MAYBE
+        elif [ "$ngx_feature_required" = no ]; then
+            USE_NGX_AUTO_LIB=MAYBE
+        else
+            USE_NGX_AUTO_LIB=YES
+        fi
+    fi
+
+    if [ ! "$NGX_AUTO_LIB_SYSTEM_DIRS" ]; then
+        NGX_AUTO_LIB_SYSTEM_DIRS=$NGX_AUTO_LIB_DEFAULT_SYSTEM_DIRS
+    fi
+
+    # TODO : add _STATIC, and do searches for both static and shared libs
+
+    if [ ! "$NGX_AUTO_LIB_SHARED" ]; then
+        if [ "$ngx_feature_shared" = no ]; then
+            NGX_AUTO_LIB_SHARED=NO
+        else
+            NGX_AUTO_LIB_SHARED=YES
+        fi
+    fi
+
+    NGX_AUTO_LIB_SEARCH_DEP=NO
+
+    # set default search methods
+    # Note : these can be over-ridden by setting NGX_AUTO_LIB_SEARCH_[type]=YES|NO
+
+    local auto=y
+
+    if [ "$NGX_AUTO_LIB_INC" ] || [ "$NGX_AUTO_LIB_LIB" ]; then
+        ngx_auto_lib_search  LIB_INC    YES
+        auto=n
+    fi
+
+    if [ "$NGX_AUTO_LIB_DIR" != NONE ]; then
+        ngx_auto_lib_search  DIR        YES
+        auto=n
+    fi
+
+    if [ "$NGX_AUTO_LIB_BASE" ]; then
+        ngx_auto_lib_search  BASE       YES
+        auto=n
+    fi
+
+    if [ $auto = y ]; then
+        ngx_auto_lib_search  PARENT     YES
+        ngx_auto_lib_search  SYSTEM     YES
+    fi
+
+    ngx_auto_lib_search  LIB_INC    NO
+    ngx_auto_lib_search  DIR        NO
+    ngx_auto_lib_search  BASE       NO
+    ngx_auto_lib_search  PARENT     NO
+    ngx_auto_lib_search  SYSTEM     NO
+
+    if [ ! "$ngx_feature_lib_names" ]; then
+        ngx_feature_lib_names=$pfx
+    fi
+
+    if [ ! "$ngx_feature_inc_names" ]; then
+        ngx_feature_inc_names=$ngx_feature_lib_names
+    fi
+
+    if [ ! "$ngx_feature_exit_if_not_found" ]; then
+        ngx_feature_exit_if_not_found=yes
+    fi
+}
+
+#######################
+## DEFAULT FUNCTIONS ##
+#######################
+
+ngx_auto_lib_set_default() {
+
+    local suffix=
+    if [ $1 ]; then
+        suffix="_$1"
+    fi
+
+    local def=$2
+    local var="NGX_AUTO_LIB$suffix"
+
+    val=
+    if [ ! `eval echo '$'$var` ]; then
+        eval $var=\"$def\"
+    fi
+
+    #eval echo "$var = \$$var"
+}
+
+ngx_auto_lib_search() {
+    ngx_auto_lib_set_default "SEARCH_$1" $2
+}
+
+####################
+## SAVE FUNCTIONS ##
+####################
+
+ngx_auto_lib_save_vars() {
+    OLD_CORE_DEPS=$CORE_DEPS
+    OLD_CORE_INCS=$CORE_INCS
+    OLD_CORE_LIBS=$CORE_LIBS
+    OLD_CORE_SRCS=$CORE_SRCS
+    OLD_LINK_DEPS=$LINK_DEPS
+
+    CORE_DEPS=
+    CORE_INCS=
+    CORE_LIBS=
+    CORE_SRCS=
+    LINK_DEPS=
+}
+
+ngx_auto_lib_reset_vars() {
+    CORE_DEPS=$OLD_CORE_DEPS
+    CORE_INCS=$OLD_CORE_INCS
+    CORE_LIBS=$OLD_CORE_LIBS
+    CORE_SRCS=$OLD_CORE_SRCS
+    LINK_DEPS=$OLD_LINK_DEPS
+}
+
+ngx_auto_lib_save_feature_vars() {
+    for var in $ngx_feature_all_vars; do
+        eval main_ngx_feature_$var=\"\$ngx_feature_$var\"
+    done
+}
+
+ngx_auto_lib_reset_feature_vars() {
+    for var in $ngx_feature_all_vars; do
+        eval ngx_feature_$var=\"\$main_ngx_feature_$var\"
+    done
+}
+
+########################
+## CHECKING FUNCTIONS ##
+########################
+
+ngx_auto_lib_check_auto_config() {
+
+    ngx_auto_lib_save_feature_vars
+    ngx_auto_lib_clean_feature_vars
+
+    ngx_feature=$1
+    ngx_feature_inc_path="`echo $CFLAGS | tr ' ' '\n' | grep -- -D | tr '\n' ' '`"
+    ngx_feature_incs="#include <$NGX_AUTO_CONFIG_H>"
+    ngx_feature_libs=
+    ngx_feature_path=`pwd`
+    ngx_feature_run=no
+    ngx_feature_test=$2
+
+    #ngx_auto_lib_print_feature_vars
+
+    . auto/feature
+
+    if [ $ngx_found = yes ]; then
+        rv=0
+    else
+        rv=1
+    fi
+
+    ngx_auto_lib_reset_feature_vars
+
+    return $rv
+}
+
+ngx_auto_lib_check_macro_defined() {
+
+    for m in $@; do
+        ngx_auto_lib_check_auto_config  "$m"  "
+    #ifndef $m
+        rubbish
+    #endif"  && return 0
+    done
+
+    return 1
+}
+
+ngx_auto_lib_check_macro_non_zero() {
+
+    for m in $@; do
+        ngx_auto_lib_check_auto_config  "$m" "
+    #if !($m)
+        rubbish
+    #endif"  && return 0
+    done
+
+    return 1
+}
+
+ngx_auto_lib_check_require() {
+
+    if [ $USE_NGX_AUTO_LIB = YES ]; then
+        return 0
+    elif [ $USE_NGX_AUTO_LIB = NO ]; then
+        return 1
+    fi
+
+
+    # check if the libraries are required elsewhere
+
+    for l in $ngx_feature_lib_names; do
+        [ ! "`echo $CORE_LIBS $ADDON_LIBS | grep -w -- -l$l`" ] && return 0
+    done
+
+
+
+    # check that any required macros are set
+
+    local d=$ngx_feature_check_macros_defined
+    local nz=$ngx_feature_check_macros_non_zero
+
+    if [ "$d" ] || [ "$nz" ]; then
+
+        ngx_auto_lib_check_macro_defined   $d  && return 0
+        ngx_auto_lib_check_macro_non_zero  $nz  && return 0
+    fi
+
+
+    ngx_auto_lib_check
+}
+
+ngx_auto_lib_check() {
+    return 1
+}
+
+##################################
+## TEST PHASE HANDLER FUNCTIONS ##
+##################################
+
+ngx_auto_lib_test() {
+    ngx_auto_lib_test_pre_setup "$@"
+    ngx_auto_lib_test_setup "$@"
+    ngx_auto_lib_test_post_setup "$@"
+    ngx_auto_lib_test_feature
+}
+
+ngx_auto_lib_test_pre_setup() {
+    return 0
+}
+
+ngx_auto_lib_test_setup() {
+
+    local INC=$1
+    local LIB=$2
+
+    ngx_auto_lib_inc_dir=$INC
+    ngx_auto_lib_lib_dir=$LIB
+
+    ngx_auto_lib_reset_feature_vars
+
+    if [ ! "$ngx_feature_path" ]; then
+        ngx_feature_path="$INC"
+    fi
+
+    ngx_feature_path="$ngx_feature_path $ngx_feature_add_path"
+
+    for sfx in $ngx_feature_path_suffixes; do
+        ngx_feature_path="$ngx_feature_path $INC/$sfx"
+    done
+
+
+    local inc=
+    local lib=
+    local incs="$ngx_feature_inc_names"
+    local libs="$ngx_feature_lib_names"
+    local lib_files="$ngx_feature_lib_files"
+
+    for inc in $incs; do
+        ngx_feature_incs="$ngx_feature_incs
+#include <$inc.h>"
+    done
+
+
+    if [ ! "$ngx_feature_libs" ]; then
+
+        if [ $NGX_AUTO_LIB_SHARED = YES ]; then
+            if [ $NGX_RPATH = YES ]; then
+                ngx_feature_libs="-R$LIB"
+            fi
+            ngx_feature_libs="$ngx_feature_libs -L$LIB"
+
+            for lib in $libs; do
+                ngx_feature_libs="$ngx_feature_libs -l$lib"
+            done
+
+            # TODO : only add --rpath when the path is not a standard system path - warn if /usr
+
+            ngx_feature_libs="$ngx_feature_libs -Wl,--rpath -Wl,$LIB"
+
+        else
+
+            for lib in $lib_files; do
+                ngx_feature_libs="$ngx_feature_libs $LIB/$lib"      
+            done
+
+            for lib in $libs; do
+                ngx_feature_libs="$ngx_feature_libs $LIB/lib$lib.a"
+            done
+        fi
+    fi
+
+    if [ ! $ngx_feature_run ]; then
+        ngx_feature_run=no
+    fi
+
+    if [ $NGX_AUTO_LIB_SHARED = YES ]; then
+
+        # Add a test to be called in auto/feature after compilation that will check 
+        # whether any libraries that are linked are in fact using the path provided to
+        # link libraries rather than a standard path. Note : this test will work on 
+        # all linked shared objects, even if supplied directly by setting 
+        # $ngx_feature_libs instead of usign $ngx_feature_lib_names
+
+        # TODO : allow for some libraries to not be checked here if desired - if part of system paths
+
+        libs="`echo $ngx_feature_libs | tr ' ' '\n' | grep -- -l | sed 's|-l||g'`"
+
+        local test="
+            for l in $libs; do
+                o="'\`ldd '$NGX_AUTOTEST' | grep '$LIB'/lib\$l\\.so\`;
+                if [ ! \"\$o\" ]; then
+                    chmod -x $NGX_AUTOTEST;
+                    echo Linker does not link to correct version
+                else
+                    chmod +x $NGX_AUTOTEST;
+                fi
+            done'
+        test="`echo "$test" | tr '\n' ' '`"
+
+        ngx_feature_test_libs="$ngx_feature_test_libs; $test"
+    fi
+
+    ngx_feature_libs="$ngx_feature_libs $ngx_feature_add_libs"
+    ngx_feature_libs_to_add="$ngx_feature_libs"
+    ngx_feature_libs="$ngx_feature_libs $ngx_feature_test_libs"
+    ngx_feature="$ngx_auto_lib_name library $ngx_feature"
+}
+
+ngx_auto_lib_test_post_setup() {
+    return 0
+}
+
+ngx_auto_lib_test_feature() {
+    #ngx_auto_lib_print_feature_vars
+    . auto/feature
+    [ $ngx_found = yes ] && return 0
+    return 1
+}
+
+########################
+## TEST DIR FUNCTIONS ##
+########################
+
+ngx_auto_lib_test_dir_pair() {
+    ngx_auto_lib_test_inc_dir=$1
+    ngx_auto_lib_test_lib_dir=$2
+
+    if [ $1 = $2 ]; then
+        ngx_feature="in $1$3"
+    else
+        ngx_feature="in $1 and $2$3"
+    fi
+    ngx_auto_lib_test "$1" "$2" "$3"
+}
+
+ngx_auto_lib_test_dir_pairs() {
+    ngx_auto_lib_test_dir_pair  "$1/include"  "$2/lib"  "$3"   && return 0
+    ngx_auto_lib_test_dir_pair  "$1"          "$2"      "$3"   && return 0
+    return 1
+}
+
+ngx_auto_lib_test_dirs() {
+
+    local msg="$1"
+    local bdir idir ldir
+
+    local bdirs=$ngx_feature_build_dirs
+    local idirs=$ngx_feature_build_inc_dirs
+    local ldirs=$ngx_feature_build_lib_dirs
+
+    shift
+
+    for dir in "$@"; do
+        ngx_auto_lib_test_dir=$dir
+
+        for ldir in $ldirs; do
+            for idir in $idirs; do
+                ngx_auto_lib_test_dir_pair   "$dir/$idir"  "$dir/$ldir"  "$msg"  && return 0
+            done
+        done
+
+        for ldir in $ldirs; do
+            ngx_auto_lib_test_dir_pair       "$dir"        "$dir/$ldir"  "$msg"  && return 0
+        done
+
+        for idir in $idirs; do
+            ngx_auto_lib_test_dir_pair       "$dir/$idir"  "$dir"        "$msg"  && return 0
+        done
+
+        for bdir in $bdirs; do
+            ngx_auto_lib_test_dir_pairs      "$dir/$bdir"  "$dir/$bdir"  "$msg"  && return 0
+        done
+
+        ngx_auto_lib_test_dir_pairs          "$dir"        "$dir"        "$msg"  && return 0
+        ngx_auto_lib_test_dir=
+    done
+
+    return 1
+}
+
+ngx_auto_lib_test_install_dirs() {
+
+    local msg="$1"
+    local dir=
+
+    shift
+
+    for dir in "$@"; do
+        ngx_auto_lib_test_dir=$dir
+        ngx_auto_lib_test_dir_pair  "$dir/include"  "$dir/lib"  "$msg"   && return 0
+        ngx_auto_lib_test_dir=
+    done
+
+    return 1
+}
+
+ngx_auto_lib_run_tests() {
+
+    local name="$ngx_auto_lib_name"
+    local pfx="$ngx_auto_lib_pfx"
+    local PFX="$NGX_AUTO_LIB_PFX"
+    local INC="$NGX_AUTO_LIB_INC"
+    local LIB="$NGX_AUTO_LIB_LIB"
+    local DIR="$NGX_AUTO_LIB_DIR"
+    local BASE="$NGX_AUTO_LIB_BASE"
+    local MSG="$NGX_AUTO_LIB_MSG"
+
+
+    ngx_found=no
+
+
+    # dependency
+
+    if [ $NGX_AUTO_LIB_SEARCH_DEP = YES ]; then
+        ngx_auto_lib_test_dir_pair  "$INC"  "$LIB"  "$MSG"
+        return $?
+    fi
+
+
+    # lib and include dirs set explicitly (e.g. $OPENSSL_INC, $OPENSSL_LIB)
+
+    if [ $NGX_AUTO_LIB_SEARCH_LIB_INC = YES ]; then
+        ngx_auto_lib_test_dir_pair  "$INC"  "$LIB"  " (specified by \$${PFX}_INC and \$${PFX}_LIB)"  && return 0
+    fi
+
+
+    # path specified by ${PFX} (e.g. $OPENSSL, $PCRE)
+    # Note : these will be set automatically by configure for OpenSSL, PCRE, Zlib etc
+    # TODO : change to searching more than one path
+
+    if [ $NGX_AUTO_LIB_SEARCH_DIR = YES ] && [ $DIR != NONE ]; then
+        ngx_auto_lib_test_dirs  " (specified by \$${PFX})"  $DIR  && return 0
+    fi
+
+
+    # directories beginning with '$pfx-' that are in $NGX_AUTO_LIB_BASE (e.g. $OPENSSL_BASE)
+
+    if [ $NGX_AUTO_LIB_SEARCH_BASE = YES ] && [ $BASE ]; then
+
+        p=$NGX_AUTO_LIB_SEARCH_BASE_PREFIX
+
+        if [ "$p" = YES ]; then
+            p="!ame $pfx-*"
+        elif [ "$p" ]; then
+            p="!ame $p*"
+        fi
+
+        ngx_auto_lib_test_dirs " (found under \$${PFX}_BASE)" \
+                `find $BASE/* -maxdepth 0 -type d $p 2> /dev/null | sort -r`  && return 0
+    fi
+
+
+    # directories beginning with '$pfx-' that are in the same directory as the Nginx source
+
+    if [ $NGX_AUTO_LIB_SEARCH_PARENT = YES ]; then
+        local src_dir=`cd ..; pwd`
+        ngx_auto_lib_test_dirs " (found under Nginx source parent dir)" \
+                `find $src_dir/* -maxdepth 0 -type d !ame $pfx-* 2> /dev/null | sort -r` && return 0
+    fi
+
+
+    # system folders
+
+    if [ $NGX_AUTO_LIB_SEARCH_SYSTEM = YES ]; then
+        ngx_auto_lib_test_install_dirs  ""  $NGX_AUTO_LIB_SYSTEM_DIRS  && return 0
+    fi
+
+    return 1
+}
+
+#######################
+## HANDLER FUNCTIONS ##
+#######################
+
+ngx_auto_lib_run() {
+    ngx_auto_lib_get_variables
+    eval AUTO_$NGX_AUTO_LIB_PFX=NO
+
+    ngx_auto_lib_check_require  || return
+    ngx_auto_lib_setup          || return
+    ngx_auto_lib_save_feature_vars
+    ngx_auto_lib_run_tests
+    ngx_auto_lib_post_tests     || return
+    ngx_auto_lib_finalize
+}
+
+ngx_auto_lib_print_feature_vars() {
+    echo ----------------------------
+    for var in $ngx_feature_vars; do
+        eval "echo ngx_feature_$var = \$ngx_feature_$var"
+    done
+    echo ----------------------------
+}
+
+ngx_auto_lib_setup() {
+    return 0
+}
+
+ngx_auto_lib_post_tests() {
+    return 0
+}
+
+#############################
+## SET VARIABLES FUNCTIONS ##
+#############################
+
+# TODO : add HTTP/ADDON settings too
+
+ngx_auto_lib_set_core_variables() {
+    # TODO : don't add includes / libs more than once
+
+    eval CORE_DEPS=\"$CORE_DEPS $ngx_feature_deps\"
+    eval CORE_INCS=\"$CORE_INCS $ngx_feature_path\"
+    eval CORE_LIBS=\"$CORE_LIBS $ngx_feature_libs_to_add\"
+    eval CORE_SRCS=\"$CORE_SRCS $ngx_feature_srcs\"
+}
+
+ngx_auto_lib_set_generic_variables() {
+    local INC=$ngx_auto_lib_test_inc_dir
+    local LIB=$ngx_auto_lib_test_lib_dir
+
+    modules="$modules $ngx_feature_modules"
+
+    for have in $ngx_feature_haves; do
+        . auto/have
+    done
+
+    set - $ngx_feature_defines
+
+    while [ $1 ]; do
+        have=$1
+        value=$2
+        . auto/define
+    done
+
+    local PFX=$NGX_AUTO_LIB_PFX
+
+    eval USE_$PFX=NO
+
+    if [ $ngx_auto_lib_test_dir ]; then
+        eval $PFX=$ngx_auto_lib_test_dir
+    else
+        eval $PFX=$ngx_auto_lib_lib_dir
+    fi
+
+    if [ $NGX_AUTO_LIB_SHARED != YES ]; then
+        for l in $ngx_feature_lib_names; do
+            CORE_LIBS=`echo $CORE_LIBS | sed 's|-\<l$l\>||g'`
+            ADDON_LIBS=`echo $ADDON_LIBS | sed 's|-\<l$l\>||g'`
+        done
+    fi
+
+    eval ${PFX}_INC=$INC
+    eval ${PFX}_LIB=$LIB
+    eval ${PFX}_SHARED=$NGX_AUTO_LIB_SHARED
+    eval AUTO_$PFX=YES
+}
+
+ngx_auto_lib_set_custom_variables() {
+    return 0
+}
+
+########################
+## FINALIZE FUNCTIONS ##
+########################
+
+ngx_auto_lib_finalize() {
+    ngx_auto_lib_finalize_core
+}
+
+ngx_auto_lib_finalize_core() {
+
+    if [ $ngx_found = yes ]; then
+
+        ngx_auto_lib_set_core_variables
+        ngx_auto_lib_set_generic_variables
+
+        if [ "$ngx_feature_variables" ]; then
+            eval $ngx_feature_variables
+        fi
+
+        ngx_auto_lib_set_custom_variables
+
+    elif [ $ngx_feature_exit_if_not_found = yes ]; then
+
+        if [ $ngx_auto_lib_module_name ]; then
+            module_txt=" by the $ngx_auto_lib_module_name module" 
+        else
+            module_text=
+        fi        
+
+        lib=$ngx_auto_lib_name
+        pfx=$ngx_auto_lib_pfx
+        PFX=$NGX_AUTO_LIB_PFX
+
+cat << END
+
+$0: error: the $lib library is required$module_txt, but cannot
+be found using the current configuration. In order for the compilation to succeed,
+you will need to install the library using your system's package installer or point
+the configure script to the library using one of the following variables :
+
+to define a dir to find $pfx library (source or install dir)    $PFX
+to define $pfx lib and include dirs separately                  ${PFX}_LIB & ${PFX}_INC
+to define a base dir to search for dirs beginning with $pfx-    ${PFX}_BASE
+
+e.g.
+
+$ export ${PFX}_LIB=/path/to/library/lib
+$ export ${PFX}_LIB=/path/to/library/include
+$ $0 ...
+
+END
+        exit 1
+    fi
+}
+