From: Graham Leggett Date: Wed, 23 Sep 2009 22:29:21 +0000 (+0000) Subject: Update transformations. X-Git-Tag: 2.2.14~4 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=ba617ed3e9c8b43c7839149d8774ff8be621fa0a;p=thirdparty%2Fapache%2Fhttpd.git Update transformations. git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/2.2.x@818291 13f79535-47bb-0310-9956-ffa450edef68 --- diff --git a/docs/manual/mod/allmodules.xml b/docs/manual/mod/allmodules.xml index 1aab531ef84..eb817961c78 100644 --- a/docs/manual/mod/allmodules.xml +++ b/docs/manual/mod/allmodules.xml @@ -63,6 +63,7 @@ mod_proxy_connect.xml mod_proxy_ftp.xml mod_proxy_http.xml + mod_proxy_scgi.xml mod_rewrite.xml mod_setenvif.xml mod_so.xml diff --git a/docs/manual/mod/allmodules.xml.de b/docs/manual/mod/allmodules.xml.de index 54e539db24f..a1cbc84d801 100644 --- a/docs/manual/mod/allmodules.xml.de +++ b/docs/manual/mod/allmodules.xml.de @@ -63,6 +63,7 @@ mod_proxy_connect.xml mod_proxy_ftp.xml mod_proxy_http.xml + mod_proxy_scgi.xml mod_rewrite.xml mod_setenvif.xml mod_so.xml diff --git a/docs/manual/mod/allmodules.xml.es b/docs/manual/mod/allmodules.xml.es index 39d91d680d8..80a54d95d00 100644 --- a/docs/manual/mod/allmodules.xml.es +++ b/docs/manual/mod/allmodules.xml.es @@ -63,6 +63,7 @@ mod_proxy_connect.xml mod_proxy_ftp.xml mod_proxy_http.xml + mod_proxy_scgi.xml mod_rewrite.xml mod_setenvif.xml mod_so.xml diff --git a/docs/manual/mod/allmodules.xml.ja b/docs/manual/mod/allmodules.xml.ja index b8d3f939aff..c997489e09e 100644 --- a/docs/manual/mod/allmodules.xml.ja +++ b/docs/manual/mod/allmodules.xml.ja @@ -63,6 +63,7 @@ mod_proxy_connect.xml.ja mod_proxy_ftp.xml mod_proxy_http.xml + mod_proxy_scgi.xml mod_rewrite.xml mod_setenvif.xml.ja mod_so.xml.ja diff --git a/docs/manual/mod/allmodules.xml.ko b/docs/manual/mod/allmodules.xml.ko index 4cbb3214951..74ba4c221ad 100644 --- a/docs/manual/mod/allmodules.xml.ko +++ b/docs/manual/mod/allmodules.xml.ko @@ -63,6 +63,7 @@ mod_proxy_connect.xml mod_proxy_ftp.xml mod_proxy_http.xml + mod_proxy_scgi.xml mod_rewrite.xml mod_setenvif.xml.ko mod_so.xml.ko diff --git a/docs/manual/mod/allmodules.xml.ru b/docs/manual/mod/allmodules.xml.ru index 1aab531ef84..eb817961c78 100644 --- a/docs/manual/mod/allmodules.xml.ru +++ b/docs/manual/mod/allmodules.xml.ru @@ -63,6 +63,7 @@ mod_proxy_connect.xml mod_proxy_ftp.xml mod_proxy_http.xml + mod_proxy_scgi.xml mod_rewrite.xml mod_setenvif.xml mod_so.xml diff --git a/docs/manual/mod/allmodules.xml.tr b/docs/manual/mod/allmodules.xml.tr index 9242e4fd49a..4705af0442c 100644 --- a/docs/manual/mod/allmodules.xml.tr +++ b/docs/manual/mod/allmodules.xml.tr @@ -63,6 +63,7 @@ mod_proxy_connect.xml mod_proxy_ftp.xml mod_proxy_http.xml + mod_proxy_scgi.xml mod_rewrite.xml mod_setenvif.xml.tr mod_so.xml.tr diff --git a/docs/manual/mod/directives.html.en b/docs/manual/mod/directives.html.en index 46a6a101d14..a94e2529680 100644 --- a/docs/manual/mod/directives.html.en +++ b/docs/manual/mod/directives.html.en @@ -314,6 +314,8 @@
  • ProxyRemote
  • ProxyRemoteMatch
  • ProxyRequests
    • +
  • ProxySCGIInternalRedirect
    • +
  • ProxySCGISendfile
  • ProxySet
  • ProxyStatus
  • ProxyTimeout
    • diff --git a/docs/manual/mod/index.html.en b/docs/manual/mod/index.html.en index e83a7064364..8464e060f9c 100644 --- a/docs/manual/mod/index.html.en +++ b/docs/manual/mod/index.html.en @@ -155,6 +155,7 @@ by other LDAP modules mod_proxy
    mod_proxy_http
    HTTP support module for mod_proxy
    +
    mod_proxy_scgi
    SCGI gateway module for mod_proxy
    mod_rewrite
    Provides a rule-based rewriting engine to rewrite requested URLs on the fly
    mod_setenvif
    Allows the setting of environment variables based diff --git a/docs/manual/mod/mod_proxy_scgi.html b/docs/manual/mod/mod_proxy_scgi.html new file mode 100644 index 00000000000..590ef84df50 --- /dev/null +++ b/docs/manual/mod/mod_proxy_scgi.html @@ -0,0 +1,5 @@ +# GENERATED FROM XML -- DO NOT EDIT + +URI: mod_proxy_scgi.html.en +Content-Language: en +Content-type: text/html; charset=ISO-8859-1 diff --git a/docs/manual/mod/mod_proxy_scgi.html.en b/docs/manual/mod/mod_proxy_scgi.html.en new file mode 100644 index 00000000000..c4decc251b8 --- /dev/null +++ b/docs/manual/mod/mod_proxy_scgi.html.en @@ -0,0 +1,159 @@ + + + +mod_proxy_scgi - Apache HTTP Server + + + + + +
    +

    Modules | Directives | FAQ | Glossary | Sitemap

    +

    Apache HTTP Server Version 2.2

    +
    +
    <-
    + +
    +

    Apache Module mod_proxy_scgi

    +
    +

    Available Languages:  en 

    +
    + + + + +
    Description:SCGI gateway module for mod_proxy
    Status:Extension
    Module Identifier:proxy_scgi_module
    Source File:mod_proxy_scgi.c
    Compatibility:Available in version 2.3 and later
    +

    Summary

    + +

    This module requires the service of mod_proxy. It provides support for the + SCGI protocol, version + 1.

    + +

    Thus, in order to get the ability of handling the SCGI protocol, + mod_proxy and mod_proxy_scgi have to + be present in the server.

    + +

    Warning

    +

    Do not enable proxying until you have secured your server. Open proxy + servers are dangerous both to your network and to the Internet at + large.

    +
    +
    + +
    top
    +
    +

    Examples

    +

    Remember, in order to make the following examples work, you have to + enable mod_proxy and mod_proxy_scgi.

    + +

    Simple gateway

    + ProxyPass /scgi-bin/ scgi://localhost:4000/ +

    + +

    The balanced gateway needs mod_proxy_balancer in + addition to the already mentioned proxy modules.

    + +

    Balanced gateway

    + ProxyPass /scgi-bin/ balancer://somecluster/
    + <Proxy balancer://somecluster/>
    + + BalancerMember scgi://localhost:4000/
    + BalancerMember scgi://localhost:4001/
    +     + </Proxy> +

    +
    +
    top
    +

    ProxySCGIInternalRedirect Directive

    + + + + + + + +
    Description:Enable or disable internal redirect responses from the +backend
    Syntax:ProxySCGIInternalRedirect On|Off
    Default:ProxySCGIInternalRedirect On
    Context:server config, virtual host, directory
    Status:Extension
    Module:mod_proxy_scgi
    +

    The ProxySCGIInternalRedirect enables the backend + to internally redirect the gateway to a different URL. This feature + origins in mod_cgi, which internally redirects the + response, if the response status is OK (200) and + the response contains a Location header and its value starts + with a slash (/). This value is interpreted as a new local + URL the apache internally redirects to.

    + +

    mod_proxy_scgi does the same as + mod_cgi in this regard, except that you can turn off the + feature.

    + +

    Example

    + ProxySCGIInternalRedirect Off +

    + +
    +
    top
    +

    ProxySCGISendfile Directive

    + + + + + + + +
    Description:Enable evaluation of X-Sendfile pseudo response +header
    Syntax:ProxySCGISendfile On|Off|Headername
    Default:ProxySCGISendfile Off
    Context:server config, virtual host, directory
    Status:Extension
    Module:mod_proxy_scgi
    +

    The ProxySCGISendfile directive enables the + SCGI backend to let files serve directly by the gateway. This is useful + performance purposes -- the httpd can use sendfile or other + optimizations, which are not possible if the file comes over the backend + socket.

    +

    The ProxySCGISendfile argument determines the + gateway behaviour:

    +
    +
    Off
    +
    No special handling takes place.
    + +
    On
    +
    The gateway looks for a backend response header called + X-Sendfile and interprets the value as filename to serve. The + header is removed from the final response headers. This is equivalent to + ProxySCGIRequest X-Sendfile.
    + +
    anything else
    +
    Similar to On, but instead of the hardcoded header name + the argument is applied as header name.
    +
    + +

    Example

    + # Use the default header (X-Sendfile)
    + ProxySCGISendfile On
    +
    + # Use a different header
    + ProxySCGISendfile X-Send-Static +

    + +
    +
    +
    +

    Available Languages:  en 

    +
    + \ No newline at end of file diff --git a/docs/manual/mod/mod_proxy_scgi.xml.meta b/docs/manual/mod/mod_proxy_scgi.xml.meta new file mode 100644 index 00000000000..653cb9c2e8a --- /dev/null +++ b/docs/manual/mod/mod_proxy_scgi.xml.meta @@ -0,0 +1,12 @@ + + + + + mod_proxy_scgi + /mod/ + .. + + + en + + diff --git a/docs/manual/mod/quickreference.html.en b/docs/manual/mod/quickreference.html.en index ef542faca7c..b1e939d8389 100644 --- a/docs/manual/mod/quickreference.html.en +++ b/docs/manual/mod/quickreference.html.en @@ -537,6 +537,10 @@ connections ProxyRemoteMatch regex remote-serversvERemote proxy used to handle requests matched by regular expressions ProxyRequests On|Off Off svEEnables forward (standard) proxy requests +ProxySCGIInternalRedirect On|Off On svdEEnable or disable internal redirect responses from the +backend +ProxySCGISendfile On|Off|Headername Off svdEEnable evaluation of X-Sendfile pseudo response +header ProxySet url key=value [key=value ...]dESet various Proxy balancer or member parameters ProxyStatus Off|On|Full Off svEShow Proxy LoadBalancer status in mod_status ProxyTimeout secondssvENetwork timeout for proxied requests diff --git a/docs/manual/sitemap.html.en b/docs/manual/sitemap.html.en index cc0a47bc822..e9a374df661 100644 --- a/docs/manual/sitemap.html.en +++ b/docs/manual/sitemap.html.en @@ -226,6 +226,7 @@ Server on HPUX
  • Apache Module mod_proxy_connect
  • Apache Module mod_proxy_ftp
  • Apache Module mod_proxy_http
    • +
  • Apache Module mod_proxy_scgi
  • Apache Module mod_rewrite
  • Apache Module mod_setenvif
  • Apache Module mod_so