From 0d61ef875e9dbc00be74dd3e39c2db995b61f3df Mon Sep 17 00:00:00 2001 From: Joe Orton Date: Tue, 24 Jul 2012 13:48:04 +0000 Subject: [PATCH] Transforms. git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1365054 13f79535-47bb-0310-9956-ffa450edef68 --- docs/manual/mod/mod_proxy.html.en | 42 ++++++++++++++----- docs/manual/mod/quickreference.html.de | 4 +- docs/manual/mod/quickreference.html.en | 4 +- docs/manual/mod/quickreference.html.es | 4 +- docs/manual/mod/quickreference.html.ko.euc-kr | 4 +- docs/manual/mod/quickreference.html.tr.utf8 | 4 +- docs/manual/mod/quickreference.html.zh-cn | 4 +- 7 files changed, 37 insertions(+), 29 deletions(-) diff --git a/docs/manual/mod/mod_proxy.html.en b/docs/manual/mod/mod_proxy.html.en index ac90892813..8327b80521 100644 --- a/docs/manual/mod/mod_proxy.html.en +++ b/docs/manual/mod/mod_proxy.html.en @@ -730,21 +730,41 @@ response
top

ProxyBlock Directive

- - + +
Description:Words, hosts, or domains that are banned from being -proxied
Syntax:ProxyBlock *|word|host|domain -[word|host|domain] ...
Description:Disallow proxy requests to certain hosts
Syntax:ProxyBlock *|hostname|partial-hostname [hostname|partial-hostname]...
Context:server config, virtual host
Status:Extension
Module:mod_proxy
-

The ProxyBlock directive specifies a list of - words, hosts and/or domains, separated by spaces. HTTP, HTTPS, and - FTP document requests to sites whose names contain matched words, - hosts or domains are blocked by the proxy server. The proxy - module will also attempt to determine IP addresses of list items which - may be hostnames during startup, and cache them for match test as - well. That may slow down the startup time of the server.

+

The ProxyBlock directive can be used to + block FTP or HTTP access to certain hosts via the proxy, based on + a full or partial hostname match, or, if applicable, an IP address + comparison.

+ +

Each of the arguments to the ProxyBlock + directive can be either * or a alphanumeric string. + At startup, the module will attempt to resolve every alphanumeric + string from a DNS name to a set of IP addresses, but any DNS errors + are ignored.

+ +

If an asterisk "*" argument is specified, + mod_proxy will deny access to all FTP or HTTP + sites.

+ +

Otherwise, for any request for an HTTP or FTP resource via the + proxy, mod_proxy will check the hostname of the + request URI against each specified string. If a partial string + match is found, access is denied. If no matches against hostnames + are found, and a remote (forward) proxy is configured using + ProxyRemote or + ProxyRemoteMatch, access is allowed. If no + remote (forward) proxy is configured, the IP address of the + hostname from the URI is compared against all resolved IP + addresses determined at startup. Access is denied if any match is + found.

+ +

Note that the DNS lookups may slow down the startup time of the + server.

Example

       ProxyBlock news.example.com auctions.example.com friends.example.com
diff --git a/docs/manual/mod/quickreference.html.de b/docs/manual/mod/quickreference.html.de
index 1b473dff8c..25b2606494 100644
--- a/docs/manual/mod/quickreference.html.de
+++ b/docs/manual/mod/quickreference.html.de
@@ -689,9 +689,7 @@ malicious privileges-aware code.
 ProxyAddHeaders Off|On On svdEAdd proxy information in X-Forwarded-* headers
 ProxyBadHeader IsError|Ignore|StartBody IsError svEDetermines how to handle bad header lines in a
 response
-ProxyBlock *|word|host|domain
-[word|host|domain] ...svEWords, hosts, or domains that are banned from being
-proxied
+ProxyBlock *|hostname|partial-hostname [hostname|partial-hostname]...svEDisallow proxy requests to certain hosts
 ProxyDomain DomainsvEDefault domain name for proxied requests
 ProxyErrorOverride On|Off Off svdEOverride error pages for proxied content
 ProxyExpressDBMFile <pathname>svEPathname to DBM file.
diff --git a/docs/manual/mod/quickreference.html.en b/docs/manual/mod/quickreference.html.en
index 5b27fbaa14..31219154be 100644
--- a/docs/manual/mod/quickreference.html.en
+++ b/docs/manual/mod/quickreference.html.en
@@ -678,9 +678,7 @@ malicious privileges-aware code.
 ProxyAddHeaders Off|On On svdEAdd proxy information in X-Forwarded-* headers
 ProxyBadHeader IsError|Ignore|StartBody IsError svEDetermines how to handle bad header lines in a
 response
-ProxyBlock *|word|host|domain
-[word|host|domain] ...svEWords, hosts, or domains that are banned from being
-proxied
+ProxyBlock *|hostname|partial-hostname [hostname|partial-hostname]...svEDisallow proxy requests to certain hosts
 ProxyDomain DomainsvEDefault domain name for proxied requests
 ProxyErrorOverride On|Off Off svdEOverride error pages for proxied content
 ProxyExpressDBMFile <pathname>svEPathname to DBM file.
diff --git a/docs/manual/mod/quickreference.html.es b/docs/manual/mod/quickreference.html.es
index ba016c6a01..549629e19b 100644
--- a/docs/manual/mod/quickreference.html.es
+++ b/docs/manual/mod/quickreference.html.es
@@ -685,9 +685,7 @@ malicious privileges-aware code.
 ProxyAddHeaders Off|On On svdEAdd proxy information in X-Forwarded-* headers
 ProxyBadHeader IsError|Ignore|StartBody IsError svEDetermines how to handle bad header lines in a
 response
-ProxyBlock *|word|host|domain
-[word|host|domain] ...svEWords, hosts, or domains that are banned from being
-proxied
+ProxyBlock *|hostname|partial-hostname [hostname|partial-hostname]...svEDisallow proxy requests to certain hosts
 ProxyDomain DomainsvEDefault domain name for proxied requests
 ProxyErrorOverride On|Off Off svdEOverride error pages for proxied content
 ProxyExpressDBMFile <pathname>svEPathname to DBM file.
diff --git a/docs/manual/mod/quickreference.html.ko.euc-kr b/docs/manual/mod/quickreference.html.ko.euc-kr
index 7b84dc7b85..d443a371dd 100644
--- a/docs/manual/mod/quickreference.html.ko.euc-kr
+++ b/docs/manual/mod/quickreference.html.ko.euc-kr
@@ -646,9 +646,7 @@ malicious privileges-aware code.
 ProxyAddHeaders Off|On On svdEAdd proxy information in X-Forwarded-* headers
 ProxyBadHeader IsError|Ignore|StartBody IsError svEDetermines how to handle bad header lines in a
 response
-ProxyBlock *|word|host|domain
-[word|host|domain] ...svEWords, hosts, or domains that are banned from being
-proxied
+ProxyBlock *|hostname|partial-hostname [hostname|partial-hostname]...svEDisallow proxy requests to certain hosts
 ProxyDomain DomainsvEDefault domain name for proxied requests
 ProxyErrorOverride On|Off Off svdEOverride error pages for proxied content
 ProxyExpressDBMFile <pathname>svEPathname to DBM file.
diff --git a/docs/manual/mod/quickreference.html.tr.utf8 b/docs/manual/mod/quickreference.html.tr.utf8
index 4084ad3dcf..0417e4ca63 100644
--- a/docs/manual/mod/quickreference.html.tr.utf8
+++ b/docs/manual/mod/quickreference.html.tr.utf8
@@ -676,9 +676,7 @@ malicious privileges-aware code.
 ProxyAddHeaders Off|On On skdEAdd proxy information in X-Forwarded-* headers
 ProxyBadHeader IsError|Ignore|StartBody IsError skEDetermines how to handle bad header lines in a
 response
-ProxyBlock *|word|host|domain
-[word|host|domain] ...skEWords, hosts, or domains that are banned from being
-proxied
+ProxyBlock *|hostname|partial-hostname [hostname|partial-hostname]...skEDisallow proxy requests to certain hosts
 ProxyDomain DomainskEDefault domain name for proxied requests
 ProxyErrorOverride On|Off Off skdEOverride error pages for proxied content
 ProxyExpressDBMFile <pathname>skEPathname to DBM file.
diff --git a/docs/manual/mod/quickreference.html.zh-cn b/docs/manual/mod/quickreference.html.zh-cn
index c781d1368a..011c385ec6 100644
--- a/docs/manual/mod/quickreference.html.zh-cn
+++ b/docs/manual/mod/quickreference.html.zh-cn
@@ -673,9 +673,7 @@ malicious privileges-aware code.
 ProxyAddHeaders Off|On On svdEAdd proxy information in X-Forwarded-* headers
 ProxyBadHeader IsError|Ignore|StartBody IsError svEDetermines how to handle bad header lines in a
 response
-ProxyBlock *|word|host|domain
-[word|host|domain] ...svEWords, hosts, or domains that are banned from being
-proxied
+ProxyBlock *|hostname|partial-hostname [hostname|partial-hostname]...svEDisallow proxy requests to certain hosts
 ProxyDomain DomainsvEDefault domain name for proxied requests
 ProxyErrorOverride On|Off Off svdEOverride error pages for proxied content
 ProxyExpressDBMFile <pathname>svEPathname to DBM file.
-- 
2.40.0