From: Joshua Slive Date: Wed, 27 Sep 2000 18:36:46 +0000 (+0000) Subject: Style changes. X-Git-Tag: APACHE_2_0_ALPHA_7~93 X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=02faee3869b1dbc632cfc7faf3cabfa43604915e;p=thirdparty%2Fapache%2Fhttpd.git Style changes. git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@86343 13f79535-47bb-0310-9956-ffa450edef68 --- diff --git a/docs/manual/mod/mod_mmap_static.html b/docs/manual/mod/mod_mmap_static.html index 07ed6b73505..26743569f95 100644 --- a/docs/manual/mod/mod_mmap_static.html +++ b/docs/manual/mod/mod_mmap_static.html @@ -15,15 +15,24 @@

Module mod_mmap_static

- This module is contained in the mod_mmap_static.c file, with - Apache 1.3 and later. It provides mmap()ing of a statically configured list - of frequently requested but not changed files. It is not compiled into the - server by default. To use mod_mmap_static you have to enable - the following line in the server build Configuration file: - 

-    AddModule  modules/experimental/mod_mmap_static.o
-
-

+ This module provides mmap()ing of a statically configured list + of frequently requested but not changed files. + +

Status: Experimental +
+Source File: mod_mmap_static.c +
+Module Identifier: mmap_static_module +

Summary

@@ -59,7 +68,7 @@

-

MMapFile

+

MMapFile directive

Module mod_negotiation

-This module is contained in the mod_negotiation.c file, -and is compiled in by default. It provides for content negotiation. +

This module provides for content negotiation.

+ +

Status: Base +
+Source File: mod_negotiation.c +
+Module Identifier: negotiation_module +

Summary

Content negotiation, or more accurately content selection, is the @@ -32,7 +47,20 @@ which explicitly lists the files containing the variants. filename pattern match, and choose from amongst the results. -

Type maps

+

Directives

+ + +See also: +DefaultLanguage, +AddEncoding, +AddLanguage, +AddType, and +Option. + +

Type maps

A type map has the same format as RFC822 mail headers. It contains document descriptions separated by blank lines, with lines beginning with a hash character ('#') treated as comments. A document description consists of @@ -82,7 +110,7 @@ Example:
The path to the file containing this variant, relative to the map file. -

MultiViews

+

MultiViews

A MultiViews search is enabled by the MultiViews Option. If the server receives a request for /some/dir/foo and @@ -95,23 +123,10 @@ requirements, and returns that document.

-

Directives

- - -See also: -DefaultLanguage, -AddEncoding, -AddLanguage, -AddType, and -Option. -
-

CacheNegotiatedDocs

+

CacheNegotiatedDocs directive

LanguagePriority +

LanguagePriority directive

Apache module mod_proxy

-This module is contained in the mod_proxy.c file for Apache 1.1.x, -or the modules/proxy subdirectory for Apache 1.2, and -is not compiled in by default. It provides for an HTTP -1.0 caching proxy -server. It is only available in Apache 1.1 and later. Common configuration -questions are addressed after the directive -descriptions. - -

Note:

-

This module was experimental in Apache 1.1.x. As of Apache 1.2, mod_proxy -stability is greatly improved.

+

This module provides for an HTTP 1.0 caching proxy +server.

+ +

Status: Extension +
+Source File: mod_proxy.c +
+Module Identifier: proxy_module +
+Compatibility: Available in Apache 1.1 and later. +

Summary

@@ -38,6 +50,10 @@ proxying capability for The module can be configured to connect to other proxy modules for these and other protocols. +

This module was experimental in Apache 1.1.x. As of Apache 1.2, mod_proxy +stability is greatly improved.

+ +

Directives

+

Common configuration topics

+ + + +

Controlling access to your proxy

+ +You can control who can access your proxy via the normal <Directory> +control block using the following example:

+ +

+<Directory proxy:*>
+Order Deny,Allow
+Deny from [machines you'd like *not* to allow by IP address or name]
+Allow from [machines you'd like to allow by IP address or name]
+</Directory>
+

+ +A <Files> block will also work, and is the only method known to work +for all possible URLs in Apache versions earlier than 1.2b10.

+ +

Using Netscape hostname shortcuts

+ +There is an optional patch to the proxy module to allow Netscape-like +hostname shortcuts to be used. It's available from the +contrib/patches/1.2 directory on the Apache Web site.

+ +

Why doesn't file type xxx download via FTP?

+ +You probably don't have that particular file type defined as +application/octet-stream in your proxy's mime.types configuration +file. A useful line can be

+ +

+application/octet-stream        bin dms lha lzh exe class tgz taz
+
+ +

How can I force an FTP ASCII download of File xxx?

+ +In the rare situation where you must download a specific file using the FTP +ASCII transfer method (while the default transfer is in +binary mode), you can override mod_proxy's default by +suffixing the request with ;type=a to force an ASCII transfer.

+ +

Why does Apache start more slowly when using the + proxy module?

+ +If you're using the ProxyBlock or NoCache +directives, hostnames' IP addresses are looked up and cached during +startup for later match test. This may take a few seconds (or more) +depending on the speed with which the hostname lookups occur.

+ +

Can I use the Apache proxy module with my SOCKS proxy?

+ +Yes. Just build Apache with the rule SOCKS4=yes in your +Configuration file, and follow the instructions there. SOCKS5 +capability can be added in a similar way (there's no SOCKS5 +rule yet), so use the EXTRA_LDFLAGS definition, or build Apache +normally and run it with the runsocks wrapper provided with SOCKS5, +if your OS supports dynamically linked libraries.

+ +Some users have reported problems when using SOCKS version 4.2 on Solaris. +The problem was solved by upgrading to SOCKS 4.3.

+ +Remember that you'll also have to grant access to your Apache proxy machine by +permitting connections on the appropriate ports in your SOCKS daemon's +configuration.

+ +

What other functions are useful for an intranet proxy server?

+ +

An Apache proxy server situated in an intranet needs to forward external +requests through the company's firewall. However, when it has to access +resources within the intranet, it can bypass the firewall when accessing +hosts. The NoProxy directive is useful for specifying +which hosts belong to the intranet and should be accessed directly.

+ +

Users within an intranet tend to omit the local domain name from their +WWW requests, thus requesting "http://somehost/" instead of +"http://somehost.my.dom.ain/". Some commercial proxy servers let them get +away with this and simply serve the request, implying a configured +local domain. When the ProxyDomain directive +is used and the server is configured for +proxy service, Apache can return a redirect response and send the client +to the correct, fully qualified, server address. This is the preferred method +since the user's bookmark files will then contain fully qualified hosts.

+
-

ProxyRequests

+

ProxyRequests directive

ProxyPass directive.
-

ProxyRemote

+

ProxyRemote directive

-

ProxyPass

+

ProxyPass directive

-

ProxyPassReverse

+

ProxyPassReverse directive

RewriteRule ...
-

AllowCONNECT

+

AllowCONNECT directive

-

ProxyBlock

+

ProxyBlock directive

-

ProxyReceiveBufferSize

+

ProxyReceiveBufferSize directive

-

NoProxy

+

NoProxy directive

-

ProxyDomain

+

ProxyDomain directive

-

ProxyVia

+

ProxyVia directive

Via: comment
-

CacheForceCompletion

+

CacheForceCompletion directive

-

CacheRoot

+

CacheRoot directive

-

CacheSize

+

CacheSize directive

-

CacheGcInterval

+

CacheGcInterval directive

-

CacheMaxExpire

+

CacheMaxExpire directive

-

CacheLastModifiedFactor

+

CacheLastModifiedFactor directive

-

CacheDirLevels

+

CacheDirLevels directive

-

CacheDirLength

+

CacheDirLength directive

-

CacheDefaultExpire

+

CacheDefaultExpire directive

-

NoCache

+

NoCache directive

-
- -

Common configuration topics

- - - -

Controlling access to your proxy

- -You can control who can access your proxy via the normal <Directory> -control block using the following example:

- -

-<Directory proxy:*>
-Order Deny,Allow
-Deny from [machines you'd like *not* to allow by IP address or name]
-Allow from [machines you'd like to allow by IP address or name]
-</Directory>
-

- -A <Files> block will also work, and is the only method known to work -for all possible URLs in Apache versions earlier than 1.2b10.

- -

Using Netscape hostname shortcuts

- -There is an optional patch to the proxy module to allow Netscape-like -hostname shortcuts to be used. It's available from the -contrib/patches/1.2 directory on the Apache Web site.

- -

Why doesn't file type xxx download via FTP?

- -You probably don't have that particular file type defined as -application/octet-stream in your proxy's mime.types configuration -file. A useful line can be

- -

-application/octet-stream        bin dms lha lzh exe class tgz taz
-
- -

How can I force an FTP ASCII download of File xxx?

- -In the rare situation where you must download a specific file using the FTP -ASCII transfer method (while the default transfer is in -binary mode), you can override mod_proxy's default by -suffixing the request with ;type=a to force an ASCII transfer.

- -

Why does Apache start more slowly when using the - proxy module?

- -If you're using the ProxyBlock or NoCache -directives, hostnames' IP addresses are looked up and cached during -startup for later match test. This may take a few seconds (or more) -depending on the speed with which the hostname lookups occur.

- -

Can I use the Apache proxy module with my SOCKS proxy?

- -Yes. Just build Apache with the rule SOCKS4=yes in your -Configuration file, and follow the instructions there. SOCKS5 -capability can be added in a similar way (there's no SOCKS5 -rule yet), so use the EXTRA_LDFLAGS definition, or build Apache -normally and run it with the runsocks wrapper provided with SOCKS5, -if your OS supports dynamically linked libraries.

- -Some users have reported problems when using SOCKS version 4.2 on Solaris. -The problem was solved by upgrading to SOCKS 4.3.

- -Remember that you'll also have to grant access to your Apache proxy machine by -permitting connections on the appropriate ports in your SOCKS daemon's -configuration.

- -

What other functions are useful for an intranet proxy server?

- -

An Apache proxy server situated in an intranet needs to forward external -requests through the company's firewall. However, when it has to access -resources within the intranet, it can bypass the firewall when accessing -hosts. The NoProxy directive is useful for specifying -which hosts belong to the intranet and should be accessed directly.

- -

Users within an intranet tend to omit the local domain name from their -WWW requests, thus requesting "http://somehost/" instead of -"http://somehost.my.dom.ain/". Some commercial proxy servers let them get -away with this and simply serve the request, implying a configured -local domain. When the ProxyDomain directive -is used and the server is configured for -proxy service, Apache can return a redirect response and send the client -to the correct, fully qualified, server address. This is the preferred method -since the user's bookmark files will then contain fully qualified hosts.

- diff --git a/docs/manual/mod/mod_setenvif.html b/docs/manual/mod/mod_setenvif.html index 8cccd423570..a86bbfdef89 100644 --- a/docs/manual/mod/mod_setenvif.html +++ b/docs/manual/mod/mod_setenvif.html @@ -14,11 +14,31 @@

Module mod_setenvif

- This module is contained in the mod_setenvif.c file, and - is compiled in by default. It provides for - the ability to set environment variables based upon attributes of the - request. + This module provides the ability to set environment variables based + upon attributes of the request.

+ +

Status: Base +
+Source File: mod_setenvif.c +
+Module Identifier: setenvif_module +
+Compatibility: Available in Apache 1.3 and later. +

+

Summary

The mod_setenvif module allows you to set environment @@ -49,7 +69,7 @@

-

The BrowserMatch Directive

+

BrowserMatch directive

- - The BrowserMatchNoCase Directive + BrowserMatchNoCase directive

@@ -223,8 +242,7 @@

- - The SetEnvIf Directive + SetEnvIf directive

@@ -335,8 +353,7 @@

- - The SetEnvIfNoCase Directive + SetEnvIfNoCase directive