From a385a5afb1a8e48ca5b937accc3e7b8f4fbb7468 Mon Sep 17 00:00:00 2001 From: Andre Malo Date: Wed, 11 Dec 2002 21:33:39 +0000 Subject: [PATCH] update transformation: part V/V git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@97868 13f79535-47bb-0310-9956-ffa450edef68 --- docs/manual/bind.html.en | 37 ++++++- docs/manual/cgi_path.html.en | 37 ++++++- docs/manual/configuring.html.en | 47 ++++++-- docs/manual/content-negotiation.html.en | 66 +++++++++-- docs/manual/custom-error.html.en | 37 ++++++- docs/manual/dns-caveats.html.en | 47 ++++++-- docs/manual/dso.html.en | 42 ++++++- docs/manual/env.html.en | 42 ++++++- docs/manual/filter.html.en | 25 ++++- docs/manual/glossary.html.en | 25 ++++- docs/manual/handler.html.en | 37 ++++++- docs/manual/howto/cgi.html.en | 55 ++++++++-- docs/manual/howto/htaccess.html.en | 62 +++++++++-- docs/manual/howto/index.html.en | 23 +++- docs/manual/howto/public_html.html.en | 49 +++++++-- docs/manual/howto/ssi.html.en | 67 +++++++++-- docs/manual/install.html.en | 69 ++++++++++-- docs/manual/invoking.html.en | 42 ++++++- docs/manual/logs.html.en | 57 ++++++++-- docs/manual/misc/index.html.en | 21 +++- docs/manual/misc/perf-tuning.html.en | 42 ++++++- docs/manual/misc/rewriteguide.html.en | 52 +++++++-- docs/manual/misc/security_tips.html.en | 72 ++++++++++-- docs/manual/mod/perchild.html.en | 84 ++++++++++---- docs/manual/mod/prefork.html.en | 122 +++++++++++++++------ docs/manual/mod/quickreference.html.en | 35 +++++- docs/manual/mod/worker.html.en | 55 ++++++++-- docs/manual/mpm.html.en | 37 ++++++- docs/manual/new_features_2_0.html.en | 32 +++++- docs/manual/platform/ebcdic.html.en | 57 ++++++++-- docs/manual/platform/index.html.en | 30 ++++- docs/manual/platform/netware.html.en | 52 +++++++-- docs/manual/platform/perf-hp.html.en | 21 +++- docs/manual/platform/win_compiling.html.en | 42 ++++++- docs/manual/platform/win_service.html.en | 57 ++++++++-- docs/manual/platform/windows.html.en | 67 +++++++++-- docs/manual/programs/apachectl.html.en | 32 +++++- docs/manual/programs/httpd.html.en | 32 +++++- docs/manual/programs/index.html.en | 25 ++++- docs/manual/sections.html.en | 52 +++++++-- docs/manual/server-wide.html.en | 37 ++++++- docs/manual/sitemap.html.en | 41 ++++++- docs/manual/ssl/index.html.en | 32 +++++- docs/manual/ssl/ssl_compat.html.en | 37 ++++++- docs/manual/ssl/ssl_faq.html.en | 52 +++++++-- docs/manual/ssl/ssl_howto.html.en | 32 +++++- docs/manual/ssl/ssl_intro.html.en | 42 ++++++- docs/manual/stopping.html.en | 47 ++++++-- docs/manual/suexec.html.en | 63 +++++++++-- docs/manual/upgrading.html.en | 42 ++++++- docs/manual/urlmapping.html.en | 62 +++++++++-- docs/manual/vhosts/details.html.en | 37 ++++++- docs/manual/vhosts/examples.html.en | 90 +++++++++++---- docs/manual/vhosts/fd-limits.html.en | 25 ++++- docs/manual/vhosts/index.html.en | 34 +++++- docs/manual/vhosts/ip-based.html.en | 44 ++++++-- docs/manual/vhosts/mass.html.en | 80 +++++++++++--- docs/manual/vhosts/name-based.html.en | 37 ++++++- 58 files changed, 2284 insertions(+), 435 deletions(-) diff --git a/docs/manual/bind.html.en b/docs/manual/bind.html.en index 558a2c1e25..d63e402a51 100644 --- a/docs/manual/bind.html.en +++ b/docs/manual/bind.html.en @@ -4,9 +4,28 @@ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX - -->Binding - Apache HTTP Server
<-
Apache > HTTP Server > Documentation > Version 2.1

Binding

+ --> +Binding - Apache HTTP Server + + + + + +
<-
+

Binding

Configuring Apache to listen on specific addresses and ports.

-
top
+ +
top
+
+

Overview

@@ -55,7 +74,9 @@

Listen [fe80::a00:20ff:fea7:ccea]:80

-
top
top
+
+

Special IPv6 Considerations

When APR supports IPv6, Apache will create IPv6-capable listening @@ -96,7 +117,9 @@

Apache does not currently detect this, so the Listen statements must be edited manually by the administrator.

-
top
top
+
+

How This Works With Virtual Hosts

Listen does not implement Virtual Hosts. It only tells the @@ -115,4 +138,8 @@ <VirtualHost> is set for an address and port that the server is not listening to, it cannot be accessed.

-
\ No newline at end of file +
+ + \ No newline at end of file diff --git a/docs/manual/cgi_path.html.en b/docs/manual/cgi_path.html.en index a58cdc3a29..b23a6f23fd 100644 --- a/docs/manual/cgi_path.html.en +++ b/docs/manual/cgi_path.html.en @@ -4,7 +4,19 @@ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX - -->PATH_INFO Changes in the CGI Environment - Apache HTTP Server
<-
Apache > HTTP Server > Documentation > Version 2.1

PATH_INFO Changes in the CGI Environment

+ --> +PATH_INFO Changes in the CGI Environment - Apache HTTP Server + + + + + +
<-
+

PATH_INFO Changes in the CGI Environment

As implemented in Apache 1.1.1 and earlier versions, the method Apache used to create PATH_INFO in the CGI environment was counterintuitive, and could result in crashes in certain @@ -14,7 +26,14 @@ still compatible with the CGI/1.1 specification, and CGI scripts can be easily modified (see below).

-
top
+ +
top
+
+

The Problem

Apache 1.1.1 and earlier implemented the PATH_INFO and SCRIPT_NAME environment variables by looking at the filename, not the URL. While this resulted in the correct values in many @@ -33,7 +52,9 @@ to "/ralph/script", and SCRIPT_NAME to "/cgi-". Obviously, the latter is incorrect. In certain cases, this could even cause the server to crash.

-
top
top
+
+

The Solution

Apache 1.2 and later now determine SCRIPT_NAME and PATH_INFO by looking directly at the URL, and determining how much of the URL is client-modifiable, and setting PATH_INFO to it. To use @@ -53,7 +74,9 @@ information is not a recommended method, and a script making use of it "deserves" not to work. Apache 1.2b3 and later, however, do provide a workaround.

-
top
top
+
+

Compatibility with Previous Servers

It may be necessary for a script that was designed for @@ -75,4 +98,8 @@

By doing this, a script can work with all servers supporting the CGI/1.1 specification, including all versions of Apache.

-
\ No newline at end of file +
+ + \ No newline at end of file diff --git a/docs/manual/configuring.html.en b/docs/manual/configuring.html.en index a7749ef218..ffad6f9901 100644 --- a/docs/manual/configuring.html.en +++ b/docs/manual/configuring.html.en @@ -4,10 +4,31 @@ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX - -->Configuration Files - Apache HTTP Server
<-
Apache > HTTP Server > Documentation > Version 2.1

Configuration Files

+ --> +Configuration Files - Apache HTTP Server + + + + + +
<-
+

Configuration Files

This document describes the files used to configure the Apache HTTP server.

-
top
+ +
top
+
+

Main Configuration Files

@@ -25,7 +46,9 @@ HTTP server.

The server also reads a file containing mime document types; the filename is set by the TypesConfig directive, and is mime.types by default.

-
top
top
+
+

Syntax of the Configuration Files

Apache configuration files contain one directive per line. @@ -46,7 +69,9 @@ HTTP server.

without starting the server by using apachectl configtest or the -t command line option.

-
top
top
+
+

Modules

@@ -66,7 +91,9 @@ HTTP server.

To see which modules are currently compiled into the server, you can use the -l command line option.

-
top
top
+
+

Scope of Directives

@@ -94,7 +121,9 @@ HTTP server.

can be placed in which sections, check the Context of the directive. For further information, we provide details on How Directory, Location and Files sections work.

-
top
top
+
+

.htaccess Files

@@ -119,4 +148,8 @@ HTTP server.

For more information on .htaccess files, see the .htaccess tutorial.

-
\ No newline at end of file +
+ + \ No newline at end of file diff --git a/docs/manual/content-negotiation.html.en b/docs/manual/content-negotiation.html.en index 6f62d8ed39..5c1c1f7a9e 100644 --- a/docs/manual/content-negotiation.html.en +++ b/docs/manual/content-negotiation.html.en @@ -4,7 +4,19 @@ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX - -->Content Negotiation - Apache HTTP Server
<-
Apache > HTTP Server > Documentation > Version 2.1

Content Negotiation

+ --> +Content Negotiation - Apache HTTP Server + + + + + +
<-
+

Content Negotiation

Apache's supports content negotiation as described in the HTTP/1.1 specification. It can choose the best @@ -17,9 +29,21 @@

Content negotiation is provided by the mod_negotiation module. which is compiled in by default.

-
top
+ +
top
+
+

About Content Negotiation

A resource may be available in several different representations. For example, it might be available in @@ -71,7 +95,9 @@ Negotiation

  • variant. The ways in which the variants for a negotiable resource vary are called the dimensions of negotiation.

    -
  • top
    top
    +
    +

    Negotiation in Apache

    In order to negotiate a resource, the server needs to be given information about each of the variants. This is done in @@ -195,7 +221,9 @@ Negotiation

  • -
  • top
    top
    +
    +

    The Negotiation Methods

    After Apache has obtained a list of the variants for a given resource, either from a type-map file or from the filenames in @@ -357,7 +385,9 @@ Negotiation

  • -
  • top
    top
    +
    +

    Fiddling with Quality Values

    Apache sometimes changes the quality values from what would @@ -453,7 +483,9 @@ Negotiation

  • -
  • top
    top
    +
    +

    Extensions to Transparent Content Negotiation

    Apache extends the transparent content negotiation protocol (RFC @@ -465,7 +497,9 @@ to use them as candidate variants whenever their encodings are acceptable according to the Accept-Encoding request header. The RVSA/1.0 implementation does not round computed quality factors to 5 decimal places before choosing the best variant.

    -
    top
    top
    +
    +

    Note on hyperlinks and naming conventions

    If you are using language negotiation you can choose between different naming conventions, because files can have more than @@ -572,7 +606,9 @@ decimal places before choosing the best variant.

    extension (including an encoding extension if there is one) must be on the right hand side of the MIME-type extension (e.g., foo.html.en).

    -
    top
    top
    +
    +

    Note on Caching

    When a cache stores a representation, it associates it with the request URL. The next time that URL is requested, the cache @@ -591,10 +627,16 @@ decimal places before choosing the best variant.

    negotiation. This directive can be given in the server config or virtual host, and takes no arguments. It has no effect on requests from HTTP/1.1 clients.

    -
    top
    top
    +
    +

    More Information

    For more information about content negotiation, see Alan J. Flavell's Language Negotiation Notes. But note that this document may not be updated to include changes in Apache 2.0.

    -
    \ No newline at end of file +
    + + \ No newline at end of file diff --git a/docs/manual/custom-error.html.en b/docs/manual/custom-error.html.en index acc95d59c8..96bfa676a2 100644 --- a/docs/manual/custom-error.html.en +++ b/docs/manual/custom-error.html.en @@ -4,7 +4,19 @@ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX - -->Custom Error Responses - Apache HTTP Server
    <-
    Apache > HTTP Server > Documentation > Version 2.1

    Custom Error Responses

    + --> +Custom Error Responses - Apache HTTP Server + + + + + +
    <-
    +

    Custom Error Responses

    Additional functionality allows webmasters to configure the response of Apache to some error or problem.

    @@ -14,7 +26,14 @@

    If a script crashes and produces a "500 Server Error" response, then this response can be replaced with either some friendlier text or by a redirection to another URL (local or external).

    -
    top
    + +
    top
    +
    +

    Behavior

    Old Behavior

    @@ -73,7 +92,9 @@ scheme name like http:, even if it refers to the same host as the server).

    -
    top
    top
    +
    +

    Configuration

    Use of ErrorDocument is enabled @@ -107,7 +128,9 @@

  • A local URL to redirect to.
  • -
    top
    top
    +
    +

    Custom Error Responses and Redirects

    Apache's behavior to redirected URLs has been modified so @@ -156,4 +179,8 @@ condition, such as 404 Not Found, it can use the specific code and error text instead.

    -
    \ No newline at end of file +
    + + \ No newline at end of file diff --git a/docs/manual/dns-caveats.html.en b/docs/manual/dns-caveats.html.en index e45b66875d..8b99077375 100644 --- a/docs/manual/dns-caveats.html.en +++ b/docs/manual/dns-caveats.html.en @@ -4,13 +4,34 @@ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX - -->Issues Regarding DNS and Apache - Apache HTTP Server
    <-
    Apache > HTTP Server > Documentation > Version 2.1

    Issues Regarding DNS and Apache

    + --> +Issues Regarding DNS and Apache - Apache HTTP Server + + + + + +
    <-
    +

    Issues Regarding DNS and Apache

    This page could be summarized with the statement: don't require Apache to use DNS for any parsing of the configuration files. If Apache has to use DNS to parse the configuration files then your server may be subject to reliability problems (it might not boot), or denial and theft of service attacks (including users able to steal hits from other users).

    -
    top
    + +
    top
    +
    +

    A Simple Example

    @@ -61,7 +82,9 @@ DocumentRoot /www/abc
    </VirtualHost>

    -
    top
    top
    +
    +

    Denial of Service

    There are (at least) two forms that denial of service can @@ -107,7 +130,9 @@ this happens requires a more in-depth discussion of how Apache matches up incoming requests with the virtual host that will serve it. A rough document describing this is available.

    -
    top
    top
    +
    +

    The "main server" Address

    The addition of name-based @@ -136,7 +161,9 @@ are using. It also affects CGIs unless you use mod_env to control the environment. It's best to consult the man pages or FAQs for your OS.

    -
    top
    top
    +
    +

    Tips to Avoid These Problems

      @@ -158,7 +185,9 @@
    • create a <VirtualHost _default_:*> server that has no pages to serve
    -
    top
    top
    +
    +

    Appendix: Future Directions

    The situation regarding DNS is highly undesirable. For @@ -191,4 +220,8 @@ configuration. But as of March 1997 these features have not been deployed widely enough to be put into use on critical webservers.

    -
    \ No newline at end of file +
    + + \ No newline at end of file diff --git a/docs/manual/dso.html.en b/docs/manual/dso.html.en index 817c646cbf..1ba9330e03 100644 --- a/docs/manual/dso.html.en +++ b/docs/manual/dso.html.en @@ -4,7 +4,19 @@ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX - -->Dynamic Shared Object (DSO) Support - Apache HTTP Server
    <-
    Apache > HTTP Server > Documentation > Version 2.1

    Dynamic Shared Object (DSO) Support

    + --> +Dynamic Shared Object (DSO) Support - Apache HTTP Server + + + + + +
    <-
    +

    Dynamic Shared Object (DSO) Support

    The Apache HTTP Server is a modular program where the administrator can choose the functionality to include in the server by selecting a set of modules. The modules can be @@ -18,7 +30,15 @@

    This document describes how to use DSO modules as well as the theory behind their use.

    -
    top
    + +
    top
    +
    +

    Implementation

    @@ -50,7 +70,9 @@ source tree and without having to fiddle with the platform-dependent compiler and linker flags for DSO support.

    -
    top
    top
    +
    +

    Usage Summary

    To give you an overview of the DSO features of Apache 2.0, here is a short and concise summary:

    @@ -106,7 +128,9 @@ $ apxs -i -a -n foo mod_foo.la use a LoadModule directive in httpd.conf to tell Apache to activate the module.

    -
    top
    top
    +
    +

    Background

    On modern Unix derivatives there exists a nifty mechanism usually called dynamic linking/loading of Dynamic Shared @@ -206,7 +230,9 @@ $ apxs -i -a -n foo mod_foo.la modules into the Apache core functionality. So, Apache is really predestined for using DSO to load its modules at run-time.

    -
    top
    top
    +
    +

    Advantages and Disadvantages

    The above DSO based features have the following advantages:

    @@ -269,4 +295,8 @@ $ apxs -i -a -n foo mod_foo.la loading the code yourself via dlopen(). -
    \ No newline at end of file +
    + + \ No newline at end of file diff --git a/docs/manual/env.html.en b/docs/manual/env.html.en index d980f5d59a..0d23152836 100644 --- a/docs/manual/env.html.en +++ b/docs/manual/env.html.en @@ -4,7 +4,19 @@ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX - -->Environment Variables in Apache - Apache HTTP Server
    <-

    Environment Variables in Apache

    + --> +Environment Variables in Apache - Apache HTTP Server + + + + + +
    <-
    +

    Environment Variables in Apache

    The Apache HTTP Server provides a mechanism for storing information in named variables that are called environment variables. This information can be used to control various @@ -24,7 +36,15 @@ server itself runs, you must use the standard environment manipulation mechanisms provided by your operating system shell.

    -
    top
    + +
    top
    +
    top
    top
    +
    +

    Using Environment Variables

    @@ -182,7 +204,9 @@ variables. Rather, they are variables special to mod_rewrite which cannot be accessed from other modules.

    -
    top
    top
    +
    +

    Special Purpose Environment Variables

    Interoperability problems have led to the introduction of @@ -276,7 +300,9 @@ -

    top
    top
    +
    +

    Examples

    Changing protocol behavior with misbehaving clients

    @@ -342,4 +368,8 @@ SetEnvIf Referer "^$" local_referal ApacheToday tutorial " Keeping Your Images from Adorning Other Sites".

    -
    \ No newline at end of file +
    + + \ No newline at end of file diff --git a/docs/manual/filter.html.en b/docs/manual/filter.html.en index 8f116e324d..0d2b58b78e 100644 --- a/docs/manual/filter.html.en +++ b/docs/manual/filter.html.en @@ -4,9 +4,24 @@ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX - -->Filters - Apache HTTP Server
    <-

    Filters

    + --> +Filters - Apache HTTP Server + + + + + +
    <-
    +

    Filters

    This document describes the use of filters in Apache.

    -
    top
    +
    top
    +
    +

    Filters

    @@ -44,4 +59,8 @@

    In addition, the module mod_ext_filter allows for external programs to be defined as filters.

    -
    \ No newline at end of file +
    + + \ No newline at end of file diff --git a/docs/manual/glossary.html.en b/docs/manual/glossary.html.en index 9ccfbc8c55..906ebf492a 100644 --- a/docs/manual/glossary.html.en +++ b/docs/manual/glossary.html.en @@ -4,11 +4,26 @@ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX - -->Glossary - Apache HTTP Server
    <-

    Glossary

    + --> +Glossary - Apache HTTP Server + + + + + +
    <-
    +

    Glossary

    This glossary defines some of the common terminology related to Apache in particular, and web serving in general. More information on each concept is provided in the links.

    -
    top
    +
    top
    +
    +

    Definitions

    Authentication
    The positive @@ -321,4 +336,8 @@ scheme recommended by the International Telecommunication Union (ITU-T) which is used for SSL/TLS authentication.
    See: SSL/TLS Encryption
    -
    \ No newline at end of file +
    + + \ No newline at end of file diff --git a/docs/manual/handler.html.en b/docs/manual/handler.html.en index d8a1ed2d37..6e1ca0f58e 100644 --- a/docs/manual/handler.html.en +++ b/docs/manual/handler.html.en @@ -4,9 +4,28 @@ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX - -->Apache's Handler Use - Apache HTTP Server
    <-

    Apache's Handler Use

    + --> +Apache's Handler Use - Apache HTTP Server + + + + + +
    <-
    +

    Apache's Handler Use

    This document describes the use of Apache's Handlers.

    -
    top
    + +
    top
    +
    +

    What is a Handler

    @@ -53,7 +72,9 @@
  • type-map: Parse as a type map file for content negotiation. (mod_negotiation)
  • -
    top
    top
    + -
    top
    top
    +
    +

    Programmer's Note

    In order to implement the handler features, an addition has @@ -111,4 +134,8 @@ type. While it is not necessary, the naming convention for handlers is to use a dash-separated word, with no slashes, so as to not invade the media type name-space.

    -
    \ No newline at end of file +
    + + \ No newline at end of file diff --git a/docs/manual/howto/cgi.html.en b/docs/manual/howto/cgi.html.en index cb47436ec1..713e387638 100644 --- a/docs/manual/howto/cgi.html.en +++ b/docs/manual/howto/cgi.html.en @@ -4,7 +4,30 @@ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX - -->Apache Tutorial: Dynamic Content with CGI - Apache HTTP Server
    <-

    Apache Tutorial: Dynamic Content with CGI

    top

    Introduction

    + --> +Apache Tutorial: Dynamic Content with CGI - Apache HTTP Server + + + + + +
    <-
    +

    Apache Tutorial: Dynamic Content with CGI

    + +
    top
    +
    +

    Introduction

    @@ -16,7 +39,9 @@ your web site. This document will be an introduction to setting up CGI on your Apache web server, and getting started writing CGI programs.

    -
    top
    top
    +
    +

    Configuring Apache to permit CGI

    In order to get your CGI programs to work properly, you'll @@ -136,7 +161,9 @@

    which tells Apache that execution of CGI programs is permitted in this directory.

    -
    top
    top
    +
    +

    Writing a CGI program

    There are two main differences between ``regular'' @@ -195,7 +222,9 @@ once you get that working, you'll have a good chance of getting just about anything working.

    -
    top
    top
    +
    +

    But it's still not working!

    There are four basic things that you may see in your browser @@ -318,7 +347,9 @@ error logs, and you'll find that almost all of your problems are quickly identified, and quickly solved.

    -
    top
    top
    +
    +

    What's going on behind the scenes?

    As you become more advanced in CGI programming, it will @@ -414,7 +445,9 @@ and modules available to help you process this data, as well as handle other of the aspects of your CGI program.

    -
    top
    top
    +
    +

    CGI modules/libraries

    When you write CGI programs, you should consider using a @@ -431,7 +464,9 @@ options. One of these is the CGIC library, from http://www.boutell.com/cgic/

    -
    top
    top
    +
    +

    For more information

    There are a large number of CGI resources on the web. You @@ -464,4 +499,8 @@

    Note that questions about CGI problems should never be posted to the Apache bug database unless you are sure you have found a problem in the Apache source code.

    -
    \ No newline at end of file +
    + + \ No newline at end of file diff --git a/docs/manual/howto/htaccess.html.en b/docs/manual/howto/htaccess.html.en index 86a34c9de7..884d105b69 100644 --- a/docs/manual/howto/htaccess.html.en +++ b/docs/manual/howto/htaccess.html.en @@ -4,12 +4,38 @@ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX - -->Apache Tutorial: .htaccess files - Apache HTTP Server
    <-

    Apache Tutorial: .htaccess files

    + --> +Apache Tutorial: .htaccess files - Apache HTTP Server + + + + + +
    <-
    +

    Apache Tutorial: .htaccess files

    .htaccess files provide a way to make configuration changes on a per-directory basis.

    -
    top
    + +
    top
    +
    top
    top
    +
    +

    What they are/How to use them

    .htaccess files (or "distributed configuration files") @@ -63,7 +89,9 @@ changes on a per-directory basis.

    If you are unsure whether a particular directive is permitted in a .htaccess file, look at the documentation for that directive, and check the Context line for ".htaccess."

    -
    top
    top
    +
    +

    When (not) to use .htaccess files

    In general, you should never use .htaccess files unless @@ -160,7 +188,9 @@ changes on a per-directory basis.

    AllowOverride None

    -
    top
    top
    +
    +

    How directives are applied

    The configuration directives found in a .htaccess file are applied to the directory in which the .htaccess file @@ -198,7 +228,9 @@ changes on a per-directory basis.

    permitted, as only Options Includes is in effect, which completely overrides any earlier setting that may have been in place.

    -
    top
    top
    +
    +

    Authentication example

    If you jumped directly to this part of the document to find out how to do authentication, it is important to note one thing. There is a @@ -233,7 +265,9 @@ changes on a per-directory basis.

    Please see the authentication tutorial for a more complete discussion of authentication and authorization.

    -
    top
    top
    +
    +

    Server side includes example

    Another common use of .htaccess files is to enable Server Side Includes for a particular directory. This may be done with @@ -252,7 +286,9 @@ changes on a per-directory basis.

    Please see the SSI tutorial for a more complete discussion of server-side includes.

    -
    top
    top
    +
    +

    CGI example

    Finally, you may wish to use a .htaccess file to permit the execution of CGI programs in a particular directory. This may be @@ -278,7 +314,9 @@ changes on a per-directory basis.

    Please see the CGI tutorial for a more complete discussion of CGI programming and configuration.

    -
    top
    top
    +
    +

    Troubleshooting

    When you put configuration directives in a .htaccess file, and you don't get the desired effect, there are a number of @@ -298,4 +336,8 @@ changes on a per-directory basis.

    Alternately, it may tell you that you had a syntax error, which you will then need to fix.

    -
    \ No newline at end of file +
    + + \ No newline at end of file diff --git a/docs/manual/howto/index.html.en b/docs/manual/howto/index.html.en index ab7d61bf7a..a8cfb78a3a 100644 --- a/docs/manual/howto/index.html.en +++ b/docs/manual/howto/index.html.en @@ -4,7 +4,22 @@ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX - -->How-To / Tutorials - Apache HTTP Server
    <-

    How-To / Tutorials

    top

    How-To / Tutorials

    + --> +How-To / Tutorials - Apache HTTP Server + + + + + +
    <-
    +

    How-To / Tutorials

    +
    top
    +
    +

    How-To / Tutorials

    @@ -73,4 +88,8 @@ -
    \ No newline at end of file +
    + + \ No newline at end of file diff --git a/docs/manual/howto/public_html.html.en b/docs/manual/howto/public_html.html.en index dd19a31fad..ab6b4e7d8b 100644 --- a/docs/manual/howto/public_html.html.en +++ b/docs/manual/howto/public_html.html.en @@ -4,18 +4,41 @@ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX - -->Per-user web directories - Apache HTTP Server
    <-

    Per-user web directories

    + --> +Per-user web directories - Apache HTTP Server + + + + + +
    <-
    +

    Per-user web directories

    On systems with multiple users, each user can be permitted to have a web site in their home directory using the UserDir directive. Visitors to a URL http://example.com/~username/ will get content out of the home directory of the user "username", out of the subdirectory specified by the UserDir directive.

    -
    top
    + +
    top
    +
    top
    top
    +
    +

    Setting the file path with UserDir

    The UserDir @@ -57,7 +80,9 @@ translated to the file path /var/www/rbowen/docs/file.html

    -
    top
    top
    +
    +

    Restricting what users are permitted to use this feature

    @@ -82,7 +107,9 @@

    See UserDir documentation for additional examples.

    -
    top
    top
    +
    +

    Enabling a cgi directory for each user

    In order to give each user their own cgi-bin directory, you can use @@ -97,7 +124,9 @@ </Directory>

    -
    top
    top
    +
    +

    Allowing users to alter configuration

    If you want to allows users to modify the server configuration in @@ -107,4 +136,8 @@ to modify. See the .htaccess tutorial for additional details on how this works.

    -
    \ No newline at end of file +
    + + \ No newline at end of file diff --git a/docs/manual/howto/ssi.html.en b/docs/manual/howto/ssi.html.en index 6ba0fd283d..ec958ad98c 100644 --- a/docs/manual/howto/ssi.html.en +++ b/docs/manual/howto/ssi.html.en @@ -4,10 +4,35 @@ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX - -->Apache Tutorial: Introduction to Server Side Includes - Apache HTTP Server
    <-

    Apache Tutorial: Introduction to Server Side Includes

    + --> +Apache Tutorial: Introduction to Server Side Includes - Apache HTTP Server + + + + + +
    <-
    +

    Apache Tutorial: Introduction to Server Side Includes

    Server-side includes provide a means to add dynamic content to existing HTML documents.

    -
    top
    + +
    top
    +
    +

    Introduction

    This article deals with Server Side Includes, usually called @@ -19,7 +44,9 @@ existing HTML documents.

    the somewhat more advanced things that can be done with SSI, such as conditional statements in your SSI directives.

    -
    top
    top
    +
    +

    What are SSI?

    SSI (Server Side Includes) are directives that are placed in HTML pages, and evaluated on the server while the pages are @@ -35,7 +62,9 @@ existing HTML documents.

    But if a majority of your page is being generated at the time that it is served, you need to look for some other solution.

    -
    top
    top
    +
    +

    Configuring your server to permit SSI

    To permit SSI on your server, you must have the following @@ -114,7 +143,9 @@ existing HTML documents.

    time on your files, thereby letting browsers and proxies know that it is acceptable to cache them. -
    top
    top
    +
    +

    Basic SSI directives

    SSI directives have the following syntax:

    @@ -175,7 +206,9 @@ existing HTML documents.

    -
    top
    top
    +
    +

    Additional examples

    Following are some specific examples of things you can do in @@ -243,7 +276,9 @@ modified? include another file, and so on.

    -
    top
    top
    +
    +

    What else can I config?

    In addition to being able to config the time @@ -271,7 +306,9 @@ modified? can specify bytes for a full count in bytes, or abbrev for an abbreviated number in Kb or Mb, as appropriate.

    -
    top
    top
    +
    +

    Executing commands

    I expect that I'll have an article some time in the coming @@ -307,7 +344,9 @@ modified? feature disabled. You can allow SSI, but not the exec feature, with the IncludesNOEXEC argument to the Options directive.

    -
    top
    top
    +
    +

    Advanced SSI techniques

    In addition to spitting out content, Apache SSI gives you @@ -423,10 +462,16 @@ modified? this functionality can let you do some pretty involved dynamic stuff without ever resorting to CGI.

    -
    top
    top
    +
    +

    Conclusion

    SSI is certainly not a replacement for CGI, or other technologies used for generating dynamic web pages. But it is a great way to add small amounts of dynamic content to pages, without doing a lot of extra work.

    -
    \ No newline at end of file +
    + + \ No newline at end of file diff --git a/docs/manual/install.html.en b/docs/manual/install.html.en index 506e869563..5c6dcf0c92 100644 --- a/docs/manual/install.html.en +++ b/docs/manual/install.html.en @@ -4,7 +4,19 @@ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX - -->Compiling and Installing - Apache HTTP Server
    <-

    Compiling and Installing

    + --> +Compiling and Installing - Apache HTTP Server + + + + + +
    <-
    +

    Compiling and Installing

    This document covers compilation and installation of Apache on Unix and Unix-like systems only. For compiling and @@ -18,8 +30,21 @@ to create an environment that looks like many other Open Source projects.

    -
    top
    + +
    top
    +
    +

    Overview for the impatient

    @@ -80,7 +105,9 @@

    Each section of the compilation and installation process is described in more detail below, beginning with the requirements for compiling and installing Apache HTTPD.

    -
    top
    top
    +
    +

    Requirements

    The following requirements exist for building Apache:

    @@ -124,7 +151,9 @@ option (see below) to make sure the correct one is selected by ./configure. -
    top
    top
    +
    top
    top
    +
    +

    Extract

    Extracting the source from the Apache HTTPD tarball is a simple matter of uncompressing, and then untarring:

    @@ -196,7 +227,9 @@ containing the source code for the distribution. You should cd into that directory before proceeding with compiling the server.

    -
    top
    top
    +
    +

    Configuring the source tree

    The next step is to configure the Apache source tree for your particular platform and personal requirements. This is @@ -502,7 +535,9 @@ seperated by a colon. carefully read and consider the suexec documentation before implementing this feature.

    -
    top
    top
    +
    +

    Build

    Now you can build the various parts which form the Apache package by simply running the command:

    @@ -513,7 +548,9 @@ seperated by a colon. approximately 3 minutes to compile under a Pentium III/Linux 2.2 system, but this will vary widely depending on your hardware and the number of modules which you have enabled.

    -
    top
    top
    +
    +

    Install

    Now its time to install the package under the configured installation PREFIX (see --prefix option @@ -523,7 +560,9 @@ seperated by a colon.

    If you are upgrading, the installation will not overwrite your configuration files or documents.

    -
    top
    top
    +
    +

    Customize

    Next, you can customize your Apache HTTP server by editing the configuration files under @@ -533,7 +572,9 @@ seperated by a colon.

    Have a look at the Apache manual under docs/manual/ or consult http://httpd.apache.org/docs-2.1/ for the most recent version of this manual and a complete reference of available configuration directives.

    -
    top
    top
    +
    +

    Test

    Now you can start your Apache HTTP server by immediately running:

    @@ -548,4 +589,8 @@ seperated by a colon. running:

    $ PREFIX/bin/apachectl stop

    -
    \ No newline at end of file + + + \ No newline at end of file diff --git a/docs/manual/invoking.html.en b/docs/manual/invoking.html.en index 28fc431d03..047177d367 100644 --- a/docs/manual/invoking.html.en +++ b/docs/manual/invoking.html.en @@ -4,7 +4,19 @@ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX - -->Starting Apache - Apache HTTP Server
    <-

    Starting Apache

    + --> +Starting Apache - Apache HTTP Server + + + + + +
    <-
    +

    Starting Apache

    On Windows, Apache is normally run as a service on Windows NT, or as a console application on Windows 95. For details, see running Apache for @@ -14,7 +26,15 @@ is run as a daemon that executes continuously in the background to handle requests. This document describes how to invoke httpd.

    -
    top
    + +
    top
    +
    +

    How Apache Starts

    If the Listen specified in the configuration file is default of 80 (or any other @@ -57,7 +77,9 @@ the test page in the DocumentRoot directory and the local copy of the documentation linked from that page.

    -
    top
    top
    +
    +

    Errors During Start-up

    If Apache suffers a fatal problem during startup, it will write a message describing the problem either to the console or @@ -77,7 +99,9 @@

    For further trouble-shooting instructions, consult the Apache FAQ.

    -
    top
    top
    +
    +

    Starting at Boot-Time

    If you want your server to continue running after a system reboot, you should add a call to apachectl to your @@ -93,7 +117,9 @@ httpd. So you can often simply link apachectl into the appropriate init directory. But be sure to check the exact requirements of your system.

    -
    top
    top
    +
    +

    Additional Information

    Additional information about the command-line options of httpd and apachectl as well as other support programs included with the server is available on the @@ -101,4 +127,8 @@ There is also documentation on all the modules included with the Apache distribution and the directives that they provide.

    -
    \ No newline at end of file +
    + + \ No newline at end of file diff --git a/docs/manual/logs.html.en b/docs/manual/logs.html.en index d3b87bede4..d0a2cf7b22 100644 --- a/docs/manual/logs.html.en +++ b/docs/manual/logs.html.en @@ -4,7 +4,19 @@ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX - -->Log Files - Apache HTTP Server
    <-

    Log Files

    + --> +Log Files - Apache HTTP Server + + + + + +
    <-
    +

    Log Files

    In order to effectively manage a web server, it is necessary to get feedback about the activity and performance of the server as well as any problems that may be occuring. The Apache @@ -12,7 +24,18 @@ capabilities. This document describes how to configure its logging capabilities, and how to understand what the logs contain.

    -
    top
    + +
    top
    +
    +

    Security Warning

    Anyone who can write to the directory where Apache is @@ -28,7 +51,9 @@ possible for malicious clients to insert control-characters in the log files, so care must be taken in dealing with raw logs.

    -
    top
    top
    +
    @@ -92,7 +117,9 @@

    tail -f error_log

    -
    top
    top
    +
    +

    Access Log

    @@ -376,7 +403,9 @@ easier to simply post-process the log files to remove requests that you do not want to consider.

    -
    top
    top
    +
    +

    Log Rotation

    On even a moderately busy server, the quantity of @@ -409,7 +438,9 @@

    Another way to perform log rotation is using piped logs as discussed in the next section.

    -
    top
    top
    +
    +

    Piped Logs

    Apache httpd is capable of writing error and access log @@ -452,7 +483,9 @@

    As with conditional logging, piped logs are a very powerful tool, but they should not be used where a simpler solution like off-line post-processing is available.

    -
    top
    top
    +
    +

    Virtual Hosts

    When running a server with many virtual @@ -494,7 +527,9 @@ host that is serving the request. Then a program like split-logfile can be used to post-process the access log in order to split it into one file per virtual host.

    -
    top
    top
    +
    +

    Other Log Files

    @@ -531,4 +566,8 @@ the rewriting engine transforms requests. The level of detail is controlled by the RewriteLogLevel directive.

    -
    \ No newline at end of file +
    + + \ No newline at end of file diff --git a/docs/manual/misc/index.html.en b/docs/manual/misc/index.html.en index 3e10e8a783..f289e3b903 100644 --- a/docs/manual/misc/index.html.en +++ b/docs/manual/misc/index.html.en @@ -4,7 +4,19 @@ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX - -->Apache Miscellaneous Documentation - Apache HTTP Server
    <-

    Apache Miscellaneous Documentation

    + --> +Apache Miscellaneous Documentation - Apache HTTP Server + + + + + +
    <-
    +

    Apache Miscellaneous Documentation

    Below is a list of additional documentation pages that apply to the Apache web server development project.

    @@ -81,4 +93,9 @@ -
    \ No newline at end of file +
    +
    + + \ No newline at end of file diff --git a/docs/manual/misc/perf-tuning.html.en b/docs/manual/misc/perf-tuning.html.en index 22477a86ca..ff6f9416c2 100644 --- a/docs/manual/misc/perf-tuning.html.en +++ b/docs/manual/misc/perf-tuning.html.en @@ -4,7 +4,19 @@ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX - -->Apache Performance Notes - Apache HTTP Server
    <-

    Apache Performance Notes

    + --> +Apache Performance Notes - Apache HTTP Server + + + + + +
    <-
    +

    Apache Performance Notes

    Warning: This document has not been fully updated @@ -31,7 +43,15 @@ of the capabilities of the hardware and OS, while others allow the administrator to trade functionality for speed.

    -
    top
    + +
    top
    +
    top
    top
    +
    +

    Run-Time Configuration Issues

    @@ -346,7 +368,9 @@ DirectoryIndex index.cgi index.pl index.shtml index.html -
    top
    top
    +
    +

    Compile-Time Configuration Issues

    @@ -717,7 +741,9 @@ DirectoryIndex index.cgi index.pl index.shtml index.html -
    top
    top
    +
    +

    Appendix: Detailed Analysis of a Trace

    @@ -871,4 +897,8 @@ DirectoryIndex index.cgi index.pl index.shtml index.html high load conditions) occur in parallel with the worker thread's handling of the just-accepted connection.

    -
    \ No newline at end of file +
    + + \ No newline at end of file diff --git a/docs/manual/misc/rewriteguide.html.en b/docs/manual/misc/rewriteguide.html.en index 41ceb3aa18..c6673eb5c5 100644 --- a/docs/manual/misc/rewriteguide.html.en +++ b/docs/manual/misc/rewriteguide.html.en @@ -4,7 +4,19 @@ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX - -->URL Rewriting Guide - Apache HTTP Server
    <-

    URL Rewriting Guide

    + --> +URL Rewriting Guide - Apache HTTP Server + + + + + +
    <-
    +

    URL Rewriting Guide

    Originally written by
    Ralf S. Engelschall <rse@apache.org>
    @@ -18,7 +30,17 @@ with in practice. I give detailed descriptions on how to solve each problem by configuring URL rewriting rulesets.

    -
    top
    + +
    top
    +
    +

    Introduction to mod_rewrite

    @@ -39,7 +61,9 @@ avoid the first case by presenting already invented solutions to you.

    -
    top
    top
    +
    +

    Practical Solutions

    @@ -58,7 +82,9 @@ particular ruleset really does before you use it. It avoid problems.
    -
    top
    top
    +
    +

    URL Layout

    @@ -960,7 +986,9 @@ RewriteRule ^(.*)$ $1.html -
    top
    top
    +
    +

    Content Handling

    @@ -1857,7 +1885,9 @@ RewriteRule ^/(.*)$ %1/$1 [E=VHOST:${lowercase:%{HTTP_HOST}}] -
    top
    top
    +
    +

    Access Restriction

    @@ -2113,7 +2143,9 @@ http://www.badguys.com/bad/index3.html http://somewhere.com/ -
    top
    top
    +
    +

    Other

    @@ -2171,4 +2203,8 @@ while (<>) { -
    \ No newline at end of file +
    + + \ No newline at end of file diff --git a/docs/manual/misc/security_tips.html.en b/docs/manual/misc/security_tips.html.en index 5ffad5552a..e98d05eafa 100644 --- a/docs/manual/misc/security_tips.html.en +++ b/docs/manual/misc/security_tips.html.en @@ -4,10 +4,36 @@ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX - -->Security Tips - Apache HTTP Server
    <-

    Security Tips

    + --> +Security Tips - Apache HTTP Server + + + + + +
    <-
    +

    Security Tips

    Some hints and tips on security issues in setting up a web server. Some of the suggestions will be general, others specific to Apache.

    -
    top
    + +
    top
    +
    +

    Keep up to Date

    The Apache HTTP Server has a good record for security and a developer community highly concerned about security issues. But @@ -26,7 +52,9 @@ Operating System. You must therefore stay aware of problems and updates with all the software on your system.

    -
    top
    top
    +
    +

    Permissions on ServerRoot Directories

    @@ -73,7 +101,9 @@ themselves are writeable (by a non-root user), then someone may be able to overwrite the log itself with bogus data.

    -
    top
    top
    +
    +

    Server Side Includes

    @@ -110,7 +140,9 @@ still use >--#include virtual="..." --< to execute CGI scripts if these scripts are in directories desginated by a ScriptAlias directive.

    -
    top
    top
    +
    +

    CGI in General

    @@ -130,7 +162,9 @@ popular way of doing this is with CGIWrap.

    -
    top
    top
    +
    +

    Non Script Aliased CGI

    @@ -145,7 +179,9 @@
  • You have no users, and nobody ever visits your server.
  • -
    top
    top
    +
    +

    Script Aliased CGI

    @@ -158,7 +194,9 @@

    Most sites choose this option over the non script aliased CGI approach.

    -
    top
    top
    +
    +

    Other sources of dynamic content

    @@ -170,7 +208,9 @@ server user can. Some scripting engines may provide restrictions, but it is better to be safe and assume not.

    -
    top
    top
    +
    +

    Protecting System Settings

    @@ -189,7 +229,9 @@

    This prevents the use of .htaccess files in all directories apart from those specifically enabled.

    -
    top
    top
    +
    +

    Protect Server Files by Default

    @@ -245,7 +287,9 @@ UserDir disabled root

    -
    top
    top
    +
    +

    Watching Your Logs

    @@ -291,4 +335,8 @@ <Files>

    -
    \ No newline at end of file +
    + + \ No newline at end of file diff --git a/docs/manual/mod/perchild.html.en b/docs/manual/mod/perchild.html.en index 5b63c3fb33..1a8db1fe1d 100644 --- a/docs/manual/mod/perchild.html.en +++ b/docs/manual/mod/perchild.html.en @@ -4,13 +4,30 @@ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX - -->perchild - Apache HTTP Server
    <-

    Apache Module perchild

    + + +
    Description: - Multi-Processing Module allowing for daemon processes + --> +perchild - Apache HTTP Server + + + + + + +
    <-
    + +
    +

    Apache Module perchild

    +
    Description:Multi-Processing Module allowing for daemon processes serving requests to be assigned a variety of different - userids
    Status: - MPM
    Module Identifier: - mpm_perchild_module
    Source File: - perchild.c

    Summary

    + userids
    Status:MPM
    Module Identifier:mpm_perchild_module
    Source File:perchild.c
    +

    Summary

    +
    This MPM does not currently work on most platforms. Work is ongoing to make it functional. @@ -65,7 +82,10 @@ make it functional. userids. These processes can then be associated with specific virtual hosts.

    -

    Directives

    +
    top

    AssignUserId Directive

    Description: -
    Syntax: - AssignUserID user_id group_id
    Context: - virtual host
    Status: - MPM
    Module: - perchild
    + +
    + +
    top
    +

    AssignUserId Directive

    + + + + + + +
    Description:
    Syntax:AssignUserID user_id group_id
    Context:virtual host
    Status:MPM
    Module:perchild

    Tie a virtual host to a specific child process. Requests addressed to the virtual host where this directive appears will be served by the process running with the specified user and group id.

    -
    top

    ChildPerUserId Directive

    Description: -
    Syntax: - ChildPerUserID user_id -group_id num_children
    Context: - server config
    Status: - MPM
    Module: - perchild
    + +
    +
    top
    +

    ChildPerUserId Directive

    + + + + + + +
    Description:
    Syntax:ChildPerUserID user_id +group_id num_children
    Context:server config
    Status:MPM
    Module:perchild

    Specify a user id and group id for a number of child processes. The third argument, num_children, is the number of child processes to start with the specified user and group. It does not represent a specific @@ -107,4 +141,10 @@ child number. If the total number of child processes, found by totaling all of the third arguments to all ChildPerUserId directives in the config file, is less than NumServers, then all remaining children will inherit the User and Group settings from the main server

    -
    \ No newline at end of file + +
    + + + \ No newline at end of file diff --git a/docs/manual/mod/prefork.html.en b/docs/manual/mod/prefork.html.en index 81a13081bb..d14c50dcd9 100644 --- a/docs/manual/mod/prefork.html.en +++ b/docs/manual/mod/prefork.html.en @@ -4,11 +4,28 @@ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX - -->prefork - Apache HTTP Server
    <-

    Apache Module prefork

    Description: - Implements a non-threaded, pre-forking web server
    Status: - MPM
    Module Identifier: - mpm_prefork_module
    Source File: - prefork.c

    Summary

    + --> +prefork - Apache HTTP Server + + + + + + +
    <-
    + +
    +

    Apache Module prefork

    + + + +
    Description:Implements a non-threaded, pre-forking web server
    Status:MPM
    Module Identifier:mpm_prefork_module
    Source File:prefork.c
    +

    Summary

    +

    This Multi-Processing Module (MPM) implements a non-threaded, pre-forking web server that handles requests in a manner similar to Apache 1.3. It is appropriate for sites that need to avoid @@ -23,7 +40,10 @@ small enough to assure that there is enough physical RAM for all processes.

    -

    Directives

    +
    top
    +
    top
    +
    +

    How it Works

    A single control process is responsible for launching child processes which listen for connections and serve them when they arrive. Apache always tries to maintain several spare @@ -74,14 +104,18 @@

    MaxRequestsPerChild controls how frequently the server recycles processes by killing old ones and launching new ones.

    -
    top

    AcceptMutex Directive

    Description: - Method that Apache uses to serialize multiple children -accepting requests on network sockets
    Syntax: - AcceptMutex default|method
    Default: - AcceptMutex default
    Context: - server config
    Status: - MPM
    Module: - prefork
    +
    +
    top
    +

    AcceptMutex Directive

    + + + + + + + +
    Description:Method that Apache uses to serialize multiple children +accepting requests on network sockets
    Syntax:AcceptMutex default|method
    Default:AcceptMutex default
    Context:server config
    Status:MPM
    Module:prefork

    The AcceptMutex directives sets the method that Apache uses to serialize multiple children accepting requests on network sockets. Prior to Apache 2.0, the method was @@ -117,13 +151,18 @@ accepting requests on network socketstop

    MaxSpareServers Directive

    Description: - Maximum number of idle child server processes
    Syntax: - MaxSpareServers number
    Default: - MaxSpareServers 10
    Context: - server config
    Status: - MPM
    Module: - prefork
    + +
    +
    top
    +

    MaxSpareServers Directive

    + + + + + + + +
    Description:Maximum number of idle child server processes
    Syntax:MaxSpareServers number
    Default:MaxSpareServers 10
    Context:server config
    Status:MPM
    Module:prefork

    The MaxSpareServers directive sets the desired maximum number of idle child server processes. An idle process is one which is not handling a request. If there are @@ -133,13 +172,23 @@ accepting requests on network socketsMinSpareServers

  • StartServers
  • top

    MinSpareServers Directive

    Description: - Minimum number of idle child server processes
    Syntax: - MinSpareServers number
    Default: - MinSpareServers 5
    Context: - server config
    Status: - MPM
    Module: - prefork
    + +

    See also

    + +
    +
    top
    +

    MinSpareServers Directive

    + + + + + + + +
    Description:Minimum number of idle child server processes
    Syntax:MinSpareServers number
    Default:MinSpareServers 5
    Context:server config
    Status:MPM
    Module:prefork

    The MinSpareServers directive sets the desired minimum number of idle child server processes. An idle process is one which is not handling a request. If there are @@ -149,4 +198,15 @@ accepting requests on network socketsMaxSpareServers

  • StartServers
  • \ No newline at end of file + +

    See also

    + +
    +
    + + \ No newline at end of file diff --git a/docs/manual/mod/quickreference.html.en b/docs/manual/mod/quickreference.html.en index 00097a1ae7..83d07942d0 100644 --- a/docs/manual/mod/quickreference.html.en +++ b/docs/manual/mod/quickreference.html.en @@ -4,7 +4,22 @@ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX - -->Directive Quick Reference - Apache HTTP Server
    <-

    Directive Quick Reference

    + --> +Directive Quick Reference - Apache HTTP Server + + + + + + +
    <-
    + +

    Directive Quick Reference

    +

    The directive quick reference shows the usage, default, status, and context of each Apache configuration directive. For more information about each of these, see the Directive Dictionary.

    @@ -18,20 +33,24 @@ is allowed and the status of the directive according to the legend tables below.

    -
    +
     A  |  B  |  C  |  D  |  E  |  F  |  G  |  H  |  I  |  K  |  L  |  M  |  N  |  O  |  P  |  R  |  S  |  T  |  U  |  V  |  X 
    + +
     A  |  B  |  C  |  D  |  E  |  F  |  G  |  H  |  I  |  K  |  L  |  M  |  N  |  O  |  P  |  R  |  S  |  T  |  U  |  V  |  X  -
    sserver config
    vvirtual host
    ddirectory
    h.htaccess
    +
    -
    CCore
    MMPM
    BBase
    EExtension
    XExperimental
    -
    AcceptMutex default|method default sM
    Method that Apache uses to serialize multiple children +
    + + + @@ -651,4 +670,8 @@ a given virtual host a given virtual host -
    AcceptMutex default|method default sM
    Method that Apache uses to serialize multiple children accepting requests on network sockets
    AcceptPathInfo On|Off|Default Default svdhC
    Resources accept trailing pathname information
    AccessFileName filename [filename] ... .htaccess svC
    Name of the distributed configuration file
    XBitHack on|off|full off svdhB
    Parse SSI directives in files with the execute bit set
    \ No newline at end of file +
    + + \ No newline at end of file diff --git a/docs/manual/mod/worker.html.en b/docs/manual/mod/worker.html.en index 6bb7a12fa9..6c718e98cd 100644 --- a/docs/manual/mod/worker.html.en +++ b/docs/manual/mod/worker.html.en @@ -4,12 +4,29 @@ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX - -->worker - Apache HTTP Server
    <-

    Apache Module worker

    Description: - Multi-Processing Module implementing a hybrid - multi-threaded multi-process web server
    Status: - MPM
    Module Identifier: - mpm_worker_module
    Source File: - worker.c

    Summary

    + --> +worker - Apache HTTP Server + + + + + + +
    <-
    + +
    +

    Apache Module worker

    + + + +
    Description:Multi-Processing Module implementing a hybrid + multi-threaded multi-process web server
    Status:MPM
    Module Identifier:mpm_worker_module
    Source File:worker.c
    +

    Summary

    +

    This Multi-Processing Module (MPM) implements a hybrid multi-process multi-threaded server. By using threads to serve requests, it is able to serve a large number of requests with @@ -24,7 +41,10 @@ controls the maximum total number of threads that may be launched.

    -

    Directives

    +
    top
    +
    top
    +
    +

    How it Works

    Each process has a fixed number of threads. The server adjusts to handle load by increasing or decreasing the number of processes.

    @@ -99,4 +129,9 @@

    MaxRequestsPerChild controls how frequently the server recycles processes by killing old ones and launching new ones.

    -
    \ No newline at end of file +
    +
    + + \ No newline at end of file diff --git a/docs/manual/mpm.html.en b/docs/manual/mpm.html.en index e4259fb2df..407e59eafb 100644 --- a/docs/manual/mpm.html.en +++ b/docs/manual/mpm.html.en @@ -4,10 +4,29 @@ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX - -->Multi-Processing Modules (MPMs) - Apache HTTP Server
    <-

    Multi-Processing Modules (MPMs)

    + --> +Multi-Processing Modules (MPMs) - Apache HTTP Server + + + + + +
    <-
    +

    Multi-Processing Modules (MPMs)

    This document describes what a Multi-Processing Module is and how they are using by the Apache HTTP Server.

    -
    top
    + +
    top
    +
    +

    Introduction

    The Apache HTTP Server is designed to be a powerful and flexible web server that can work on a very wide variety of @@ -54,7 +73,9 @@ how they are using by the Apache HTTP Server.

    be loaded into the server at any time. The list of available MPMs appears on the module index page.

    -
    top
    top
    +
    +

    Choosing an MPM

    MPMs must be chosen during configuration, and compiled into the server. Compilers are capable of optimizing a lot of @@ -71,7 +92,9 @@ how they are using by the Apache HTTP Server.

    determine which MPM was chosen by using ./httpd -l. This command will list every module that is compiled into the server, including the MPM.

    -
    top
    top
    +
    +

    MPM Defaults

    The following table lists the default MPMs for various operating systems. This will be the MPM selected if you do not make another @@ -84,4 +107,8 @@ choice at compile-time.

    Unixprefork Windowsmpm_winnt -
    \ No newline at end of file +
    + + \ No newline at end of file diff --git a/docs/manual/new_features_2_0.html.en b/docs/manual/new_features_2_0.html.en index 6c1173202a..8d036012ad 100644 --- a/docs/manual/new_features_2_0.html.en +++ b/docs/manual/new_features_2_0.html.en @@ -4,10 +4,28 @@ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX - -->Overview of new features in Apache 2.0 - Apache HTTP Server
    <-

    Overview of new features in Apache 2.0

    + --> +Overview of new features in Apache 2.0 - Apache HTTP Server + + + + + +
    <-
    +

    Overview of new features in Apache 2.0

    This document describes some of the major changes between the 1.3 and 2.0 versions of the Apache HTTP Server.

    -
    top
    + +
    top
    +
    +

    Core Enhancements

    @@ -101,7 +119,9 @@ syntax.
    -
    top
    top
    +
    +

    Module Enhancements

    @@ -198,4 +218,8 @@ directive.
    -
    \ No newline at end of file +
    + + \ No newline at end of file diff --git a/docs/manual/platform/ebcdic.html.en b/docs/manual/platform/ebcdic.html.en index 4e60cc35f4..2fbade8162 100644 --- a/docs/manual/platform/ebcdic.html.en +++ b/docs/manual/platform/ebcdic.html.en @@ -4,7 +4,19 @@ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX - -->The Apache EBCDIC Port - Apache HTTP Server
    <-

    The Apache EBCDIC Port

    + --> +The Apache EBCDIC Port - Apache HTTP Server + + + + + +
    <-
    +

    The Apache EBCDIC Port

    Warning: This document has not been updated to take into account changes made in @@ -12,7 +24,18 @@ information may still be relevant, but please use it with care.
    -
    top
    + +
    top
    +
    +

    Overview of the Apache EBCDIC Port

    @@ -42,7 +65,9 @@

    This document serves as a rationale to describe some of the design decisions of the port to this machine.

    -
    top
    top
    +
    +

    Design Goals

    @@ -60,7 +85,9 @@ might solve the problem by defining an "ebcdic-handler" for all documents which must be converted.

    -
    top
    top
    +
    +

    Technical Solution

    @@ -91,7 +118,9 @@ the response body may contain text or a binary file) -
    top
    top
    +
    +

    Porting Notes

    @@ -230,7 +259,9 @@ -
    top
    top
    +
    +

    Document Storage Notes

    @@ -274,7 +305,9 @@ -
    top
    top
    +
    +

    Apache Modules' Status

    @@ -496,7 +529,9 @@ -
    top
    top
    +
    +

    Third Party Modules' Status

    @@ -534,4 +569,8 @@ -
    \ No newline at end of file +
    + + \ No newline at end of file diff --git a/docs/manual/platform/index.html.en b/docs/manual/platform/index.html.en index be7be4ad56..dbb4bedf9a 100644 --- a/docs/manual/platform/index.html.en +++ b/docs/manual/platform/index.html.en @@ -4,7 +4,25 @@ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX - -->Platform Specific Notes - Apache HTTP Server
    <-

    Platform Specific Notes

    top

    Microsoft Windows

    + --> +Platform Specific Notes - Apache HTTP Server + + + + + +
    <-
    +

    Platform Specific Notes

    + +
    top
    +
    +

    Microsoft Windows

    @@ -37,7 +55,9 @@ -
    top
    top
    +
    +

    Other Platforms

    @@ -68,4 +88,8 @@ -
    \ No newline at end of file +
    + + \ No newline at end of file diff --git a/docs/manual/platform/netware.html.en b/docs/manual/platform/netware.html.en index 019862dd8b..8acf04bf4f 100644 --- a/docs/manual/platform/netware.html.en +++ b/docs/manual/platform/netware.html.en @@ -4,7 +4,19 @@ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX - -->Using Apache With Novell NetWare - Apache HTTP Server
    <-

    Using Apache With Novell NetWare

    + --> +Using Apache With Novell NetWare - Apache HTTP Server + + + + + +
    <-
    +

    Using Apache With Novell NetWare

    This document explains how to install, configure and run Apache 2.0 under Novell NetWare 5.1 and above. If you find any bugs, @@ -27,7 +39,17 @@ bugs), see the section on Compiling Apache for NetWare below.

    -
    top
    + +
    top
    +
    +

    Requirements

    @@ -41,7 +63,9 @@

    NetWare service packs are available here.

    -
    top
    top
    +
    +

    Downloading Apache for NetWare

    @@ -51,7 +75,9 @@ beta-test releases, together with details of mirror web and anonymous ftp sites.

    -
    top
    top
    +
    +

    Installing Apache for NetWare

    @@ -131,7 +157,9 @@

    Apache may be installed to other volumes besides the default SYS volume.

    -
    top
    top
    +
    +

    Running Apache for NetWare

    @@ -257,7 +285,9 @@ web server. -
    top
    top
    +
    +

    Configuring Apache for NetWare

    @@ -348,7 +378,9 @@ -
    top
    top
    +
    +

    Compiling Apache for NetWare

    @@ -580,4 +612,8 @@ -
    \ No newline at end of file +
    + + \ No newline at end of file diff --git a/docs/manual/platform/perf-hp.html.en b/docs/manual/platform/perf-hp.html.en index b0d3b8130f..6710a120ea 100644 --- a/docs/manual/platform/perf-hp.html.en +++ b/docs/manual/platform/perf-hp.html.en @@ -4,7 +4,19 @@ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX - -->Running a High-Performance Web Server on HPUX - Apache HTTP Server
    <-

    Running a High-Performance Web Server on HPUX

    + --> +Running a High-Performance Web Server on HPUX - Apache HTTP Server + + + + + +
    <-
    +

    Running a High-Performance Web Server on HPUX

     Date: Wed, 05 Nov 1997 16:59:34 -0800
    @@ -77,4 +89,9 @@ Subject: HP-UX tuning tips
     
         

    http://www.cup.hp.com/netperf/NetperfPage.html

    -
    \ No newline at end of file +
    +
    + + \ No newline at end of file diff --git a/docs/manual/platform/win_compiling.html.en b/docs/manual/platform/win_compiling.html.en index f6c7c0ad9e..49dcce6fde 100644 --- a/docs/manual/platform/win_compiling.html.en +++ b/docs/manual/platform/win_compiling.html.en @@ -4,13 +4,33 @@ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX - -->Compiling Apache for Microsoft Windows - Apache HTTP Server
    <-

    Compiling Apache for Microsoft Windows

    + --> +Compiling Apache for Microsoft Windows - Apache HTTP Server + + + + + +
    <-
    +

    Compiling Apache for Microsoft Windows

    There are many important points before you begin compiling Apache. See Using Apache with Microsoft Windows before you begin.

    -
    top
    + +
    top
    +
    +

    Requirements

    @@ -133,7 +153,9 @@ -
    top
    top
    +
    +

    Command-Line Build

    @@ -156,7 +178,9 @@ nmake /f Makefile.win _apached debugging information in the resulting files, making it easier to find bugs and track down problems.

    -
    top
    top
    +
    +

    Developer Studio Workspace IDE Build

    @@ -222,7 +246,9 @@ nmake /f Makefile.win _apached should be simple, with minimal compilation and linkage flags that will be recognized by all VC++ 5.0 through 7.0 environments.

    -
    top
    top
    +
    +

    Project Components

    @@ -383,4 +409,8 @@ nmake /f Makefile.win installd INSTDIR=dir -
    \ No newline at end of file +
    + + \ No newline at end of file diff --git a/docs/manual/platform/win_service.html.en b/docs/manual/platform/win_service.html.en index 18ec3e155f..92752ef1e5 100644 --- a/docs/manual/platform/win_service.html.en +++ b/docs/manual/platform/win_service.html.en @@ -4,7 +4,19 @@ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX - -->Running Apache for Windows as a Service - Apache HTTP Server
    <-

    Running Apache for Windows as a Service

    + --> +Running Apache for Windows as a Service - Apache HTTP Server + + + + + +
    <-
    +
    top
    top
    +
    +

    Important Note on service dependencies:

    @@ -156,7 +181,9 @@ DependOnService value, double click that value if it already exists, and add the Rpcss entry to the list.

    -
    top
    top
    +
    +

    User Account for Apache Service to Run As (NT/2000)

    @@ -243,7 +270,9 @@ that you need to review the "Log On As" configuration, since the server can't access a required network resource.
    -
    top
    top
    +
    +

    Troubleshooting Apache for Windows as a Service

    @@ -271,7 +300,9 @@ Viewer in case of any problems, even if no error message pops up to warn you that an error occured.
    -
    top
    top
    +
    +

    Running Apache for Windows from the Command Line

    @@ -279,7 +310,9 @@ line, please refer to console command line section.

    -
    top
    top
    +
    +

    Controlling Apache as a Service

    @@ -316,7 +349,9 @@

    Again, quotes are only required if the service name contains spaces.

    -
    top
    top
    +
    +

    HIGHLY EXPERIMENTAL Windows 95/98 Service

    @@ -368,4 +403,8 @@ developing web content and learning the Apache server, and perhaps as a intranet server on a secured, private network.

    -
    \ No newline at end of file + + + \ No newline at end of file diff --git a/docs/manual/platform/windows.html.en b/docs/manual/platform/windows.html.en index 0e4d466a28..593e61a48d 100644 --- a/docs/manual/platform/windows.html.en +++ b/docs/manual/platform/windows.html.en @@ -4,7 +4,19 @@ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX - -->Using Apache with Microsoft Windows - Apache HTTP Server
    <-

    Using Apache with Microsoft Windows

    + --> +Using Apache with Microsoft Windows - Apache HTTP Server + + + + + +
    <-
    +

    Using Apache with Microsoft Windows

    This document explains how to install, configure and run Apache 2.0 under Microsoft Windows. If you find any bugs, or @@ -37,7 +49,20 @@ the future, and patches to allow Apache to work on 9x are welcome!

    -
    top
    + +
    top
    +
    +

    Requirements

    @@ -55,7 +80,9 @@ and WinSock integrity that were resolved in later Service Packs.

    -
    top
    top
    +
    +

    Downloading Apache for Windows

    @@ -72,7 +99,9 @@ the source code, to compile Apache yourself with the Microsoft Visual C++ (Visual Studio) tools.

    -
    top
    top
    +
    +

    Installing Apache for Windows

    @@ -122,7 +151,9 @@ start really using Apache. However to get started quickly the files should work as installed.

    -
    top
    top
    +
    +

    Running Apache for Windows

    @@ -234,7 +265,9 @@ reconfigure either Apache or the other product so that they do not listen on the same TCP/IP ports.

    -
    top
    top
    +
    +

    Configuring Apache for Windows

    @@ -332,7 +365,9 @@ -
    top
    top
    +
    +

    Running Apache for Windows as a Service

    @@ -420,7 +455,9 @@ DependOnService value, double click that value if it already exists, and add the Rpcss entry to the list.

    -
    top
    top
    +
    +

    Running Apache for Windows from the Command Line

    @@ -523,7 +560,9 @@

    Apache will execute, and will remain running until it is stopped by pressing control-C.

    -
    top
    top
    +
    +

    Signalling Apache when running as a Service

    @@ -546,7 +585,9 @@ NET STOP "service name"

    -
    top
    top
    +
    +

    Signalling Apache when running as a console application

    @@ -577,4 +618,8 @@ The command line option used, -k, was chosen as a reminder of the "kill" command used on Unix.
    -
    \ No newline at end of file + + + \ No newline at end of file diff --git a/docs/manual/programs/apachectl.html.en b/docs/manual/programs/apachectl.html.en index ec5a7dcd59..7f273708ad 100644 --- a/docs/manual/programs/apachectl.html.en +++ b/docs/manual/programs/apachectl.html.en @@ -4,7 +4,19 @@ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX - -->apachectl - Apache HTTP Server Control Interface - Apache HTTP Server
    <-

    apachectl - Apache HTTP Server Control Interface

    + --> +apachectl - Apache HTTP Server Control Interface - Apache HTTP Server + + + + + +
    <-
    +

    apachectl - Apache HTTP Server Control Interface

    apachectl is a front end to the Apache HyperText Transfer Protocol (HTTP) server. It is designed to help the administrator control the functioning of the Apache @@ -28,7 +40,13 @@

    The apachectl script returns a 0 exit value on success, and >0 if an error occurs. For more details, view the comments in the script.

    -
    top
    + +
    top
    +
    +

    Synopsis

    When acting in pass-through mode, apachectl can take all the arguments available for the httpd @@ -41,7 +59,9 @@ one-word commands, defined below.

    apachectl command

    -
    top
    top
    +
    +

    Options

    Only the SysV init-style options are defined here. Other arguments are defined on the httpd manual page.

    @@ -117,4 +137,8 @@ available. -
    \ No newline at end of file +
    + + \ No newline at end of file diff --git a/docs/manual/programs/httpd.html.en b/docs/manual/programs/httpd.html.en index 7a70d557ae..c6151a3362 100644 --- a/docs/manual/programs/httpd.html.en +++ b/docs/manual/programs/httpd.html.en @@ -4,7 +4,19 @@ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX - -->httpd - Apache Hypertext Transfer Protocol Server - Apache HTTP Server
    <-

    httpd - Apache Hypertext Transfer Protocol Server

    + --> +httpd - Apache Hypertext Transfer Protocol Server - Apache HTTP Server + + + + + +
    <-
    +

    httpd - Apache Hypertext Transfer Protocol Server

    httpd is the Apache HyperText Transfer Protocol (HTTP) server program. It is designed to be run as a standalone daemon process. When used like this it will create a pool of @@ -13,7 +25,13 @@

    In general, httpd should not be invoked directly, but rather should be invoked via apachectl on unix systems or as an NT service under win32.

    -
    top
    + +
    top
    +
    +

    Synopsis

    httpd [ -d serverroot ] [ -f config ] [ -C @@ -34,7 +52,9 @@ install|config|uninstall ] [ -n name ] [ -w ]

    -
    top
    top
    +
    +

    Options

    -d serverroot
    @@ -154,4 +174,8 @@ be read.
    -
    \ No newline at end of file +
    + + \ No newline at end of file diff --git a/docs/manual/programs/index.html.en b/docs/manual/programs/index.html.en index 12b65b751c..952d7510f9 100644 --- a/docs/manual/programs/index.html.en +++ b/docs/manual/programs/index.html.en @@ -4,10 +4,25 @@ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX - -->Server and Supporting Programs - Apache HTTP Server
    <-

    Server and Supporting Programs

    + --> +Server and Supporting Programs - Apache HTTP Server + + + + + +
    <-
    +

    Server and Supporting Programs

    This page documents all the executable programs included with the Apache HTTP Server.

    -
    top
    +
    top
    +
    +

    Index

    httpd
    @@ -56,4 +71,8 @@
    Other Programs
    -
    \ No newline at end of file +
    + + \ No newline at end of file diff --git a/docs/manual/sections.html.en b/docs/manual/sections.html.en index 090aa57d9a..1e82644281 100644 --- a/docs/manual/sections.html.en +++ b/docs/manual/sections.html.en @@ -4,12 +4,34 @@ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX - -->Configuration Sections - Apache HTTP Server
    <-

    Configuration Sections

    Directives in the configuration files may apply to the + --> +Configuration Sections - Apache HTTP Server + + + + +

    +
    <-
    +

    Configuration Sections

    Directives in the configuration files may apply to the entire server, or they may be restricted to apply only to particular directories, files, hosts, or URLs. This document describes how to use configuration section containers or .htaccess files to change the scope of other configuration directives.

    -
    top
    + +
    top
    +
    top
    top
    +
    +

    Filesystem and Webspace

    The most commonly used configuration section containers are the ones that change the configuration of particular places in the @@ -246,14 +270,18 @@ rule. Putting configuration restrictions in a <Location to all requests regardless of the specific URL.

    -
    top
    top
    +
    +

    Virtual Hosts

    The <VirtualHost> container encloses directives that apply to specific hosts. This is useful when serving multiple hosts from the same machine with a different configuration for each. For more information, see the Virtual Host Documentation.

    -
    top
    top
    +
    +

    Proxy

    The <Proxy> and <ProxyMatch> @@ -269,7 +297,9 @@ Order allow,deny
    Deny from all
    </Proxy>

    -
    top
    top
    +
    +

    What Directives are Allowed?

    To find out what directives are allowed in what types of configuration sections, check the Context of the directive. @@ -299,7 +329,9 @@ be used in <Files> and <FilesMatch> sections. -

    top
    top
    +
    +

    How the sections are merged

    The configuration sections are applied in a very particular order. Since this can have important effects on how configuration directives @@ -403,4 +435,8 @@ Deny from badguy.example.com
    -

    \ No newline at end of file +
    + + \ No newline at end of file diff --git a/docs/manual/server-wide.html.en b/docs/manual/server-wide.html.en index f25bf59ae8..7aac9b3fb7 100644 --- a/docs/manual/server-wide.html.en +++ b/docs/manual/server-wide.html.en @@ -4,11 +4,30 @@ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX - -->Server-Wide Configuration - Apache HTTP Server
    <-

    Server-Wide Configuration

    + --> +Server-Wide Configuration - Apache HTTP Server + + + + + +
    <-
    +

    Server-Wide Configuration

    This document explains some of the directives provided by the core server which are used to configure the basic operations of the server.

    -
    top
    + +
    top
    +
    +

    Server Identification

    @@ -28,7 +47,9 @@ the basic operations of the server.

    directory name, Apache must redirect the client to the full name including the trailing slash so that the client will correctly resolve relative references in the document.

    -
    top
    top
    +
    +

    File Locations

    @@ -40,7 +61,9 @@ the basic operations of the server.

    about locating files in paths which are writable by non-root users. See the security tips documentation for more details.

    -
    top
    top
    +
    +

    Limiting Resource Usage

    @@ -59,4 +82,8 @@ the basic operations of the server.

    The ThreadStackSize directive is used only on Netware to control the stack size.

    -
    \ No newline at end of file +
    + + \ No newline at end of file diff --git a/docs/manual/sitemap.html.en b/docs/manual/sitemap.html.en index a8bdc401d3..91b33bc3f3 100644 --- a/docs/manual/sitemap.html.en +++ b/docs/manual/sitemap.html.en @@ -4,10 +4,41 @@ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX - -->Site Map - Apache HTTP Server
    <-
    + + \ No newline at end of file diff --git a/docs/manual/ssl/index.html.en b/docs/manual/ssl/index.html.en index 89d5aeea11..ab1b27b2f7 100644 --- a/docs/manual/ssl/index.html.en +++ b/docs/manual/ssl/index.html.en @@ -4,13 +4,31 @@ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX - -->Apache SSL/TLS Encryption - Apache HTTP Server
    <-

    Apache SSL/TLS Encryption

    + --> +Apache SSL/TLS Encryption - Apache HTTP Server + + + + + +
    <-
    +

    Apache SSL/TLS Encryption

    The Apache HTTP Server module mod_ssl provides an interface to the OpenSSL library, which provides Strong Encryption using the Secure Sockets Layer and Transport Layer Security protocols. The module and this documentation are based on Ralf S. Engelschall's mod_ssl project.

    -
    top
    + +
    top
    +
    +

    Documentation

    -
    top
    top
    +
    +

    mod_ssl

    Extensive documentation on the directives and environment variables provided by this module is provided in the mod_ssl reference documentation.

    -
    \ No newline at end of file +
    + + \ No newline at end of file diff --git a/docs/manual/ssl/ssl_compat.html.en b/docs/manual/ssl/ssl_compat.html.en index 8925ae630d..c9d46ae95f 100644 --- a/docs/manual/ssl/ssl_compat.html.en +++ b/docs/manual/ssl/ssl_compat.html.en @@ -4,7 +4,19 @@ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX - -->SSL/TLS Strong Encryption: Compatibility - Apache HTTP Server
    <-

    SSL/TLS Strong Encryption: Compatibility

    + --> +SSL/TLS Strong Encryption: Compatibility - Apache HTTP Server + + + + + +
    <-
    +

    SSL/TLS Strong Encryption: Compatibility

    All PCs are compatible. But some of them are more compatible than others.

    @@ -28,7 +40,14 @@ superset of the functionality of all other solutions we can easily provide backward compatibility for most of the cases. Actually there are three compatibility areas we currently address: configuration directives, environment variables and custom log functions.

    -
    top
    + +
    top
    +
    +

    Configuration Directives

    For backward compatibility to the configuration directives of other SSL solutions we do an on-the-fly mapping: directives which have a direct counterpart in mod_ssl are mapped silently while other directives lead to a @@ -95,7 +114,9 @@ provide.

    SSLProxyCipherList spec-functionality not supported -
    top
    top
    +
    +

    Environment Variables

    When you use ``SSLOptions +CompatEnvVars'' additional environment variables are generated. They all correspond to existing official mod_ssl variables. The currently implemented variable derivation is listed in Table 2.

    @@ -170,7 +191,9 @@ variables. The currently implemented variable derivation is listed in top
    top
    +
    +

    Custom Log Functions

    When mod_ssl is built into Apache or at least loaded (under DSO situation) additional functions exist for the Custom Log Format of @@ -196,4 +219,8 @@ are listed in Table 3.

    %...{errstr}c Certificate Verification Error (string) -
    \ No newline at end of file +
    + + \ No newline at end of file diff --git a/docs/manual/ssl/ssl_faq.html.en b/docs/manual/ssl/ssl_faq.html.en index 5412b3037d..01c02921e9 100644 --- a/docs/manual/ssl/ssl_faq.html.en +++ b/docs/manual/ssl/ssl_faq.html.en @@ -4,7 +4,19 @@ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX - -->SSL/TLS Strong Encryption: FAQ - Apache HTTP Server
    <-

    SSL/TLS Strong Encryption: FAQ

    + --> +SSL/TLS Strong Encryption: FAQ - Apache HTTP Server + + + + + +
    <-
    +

    SSL/TLS Strong Encryption: FAQ

    The wise man doesn't give the right answers, he poses the right questions.

    @@ -20,7 +32,17 @@ to avoid answering the same questions over and over.

    Please read this chapter at least once when installing mod_ssl or at least search for your problem here before submitting a problem report to the author.

    -
    top
    + +
    top
    +
    +

    About The Module

    top
    top
    +
    +

    About Installation

    top
    top
    +
    +

    About Configuration

    top
    top
    +
    +

    About Certificates

    • What are Keys, CSRs and Certs?
    • Difference on startup?
    • @@ -648,7 +676,9 @@ browsers complain that they cannot verify the server certificate? makes sure the intermediate CA certificate is send to the browser and this way fills the gap in the certificate chain.

      -
    top
    top
    +
    +

    About SSL Protocol

    top
    top
    +
    +

    About Support

    \ No newline at end of file +
    + + \ No newline at end of file diff --git a/docs/manual/ssl/ssl_howto.html.en b/docs/manual/ssl/ssl_howto.html.en index 356cd985c1..2277165be6 100644 --- a/docs/manual/ssl/ssl_howto.html.en +++ b/docs/manual/ssl/ssl_howto.html.en @@ -4,7 +4,19 @@ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX - -->SSL/TLS Strong Encryption: How-To - Apache HTTP Server
    <-

    SSL/TLS Strong Encryption: How-To

    + --> +SSL/TLS Strong Encryption: How-To - Apache HTTP Server + + + + + +
    <-
    +

    SSL/TLS Strong Encryption: How-To

    The solution of this problem is trivial and is left as an exercise for the reader.

    @@ -19,7 +31,13 @@ instructions on how to solve such typical situations. Treat is as a first step to find out the final solution, but always try to understand the stuff before you use it. Nothing is worse than using a security solution without knowing its restrictions and coherences.

    -
    top
    + +
    top
    +
    +

    Cipher Suites and Enforced Strong Security

    -
    top
    top
    +
    +

    Client Authentication and Access Control

    -
    \ No newline at end of file + + + \ No newline at end of file diff --git a/docs/manual/ssl/ssl_intro.html.en b/docs/manual/ssl/ssl_intro.html.en index b510016e24..bd62894d65 100644 --- a/docs/manual/ssl/ssl_intro.html.en +++ b/docs/manual/ssl/ssl_intro.html.en @@ -4,7 +4,19 @@ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX - -->SSL/TLS Strong Encryption: An Introduction - Apache HTTP Server
    <-

    SSL/TLS Strong Encryption: An Introduction

    + --> +SSL/TLS Strong Encryption: An Introduction - Apache HTTP Server + + + + + +
    <-
    +

    SSL/TLS Strong Encryption: An Introduction

    The nice thing about standards is that there are so many to choose from. And if you really don't like all the standards you just have to @@ -31,7 +43,15 @@ Trust, World Wide Web Journal, Volume 2, Issue 3, Summer 1997. Please send any postive feedback to Frederick Hirsch (the original article author) and all negative feedback to Ralf S. Engelschall (the mod_ssl author).

    -
    top
    + +
    top
    +
    +

    Cryptographic Techniques

    Understanding SSL requires an understanding of cryptographic algorithms, message digest functions (aka. one-way or hash functions), and @@ -124,7 +144,9 @@ later date, the signature contains a unique sequence number. This protects the bank from a fraudulent claim from Alice that she did not send the message -- only she could have signed it (non-repudiation).

    -
    top
    top
    +
    +

    Certificates

    Although Alice could have sent a private message to the bank, signed it, and ensured the integrity of the message, she still needs to be sure @@ -329,7 +351,9 @@ dUHzICxBVC1lnHyYGjDuAMhe396lYAn8bCld1/L4NMGBCQ== -

    top
    top
    +
    +

    Secure Sockets Layer (SSL)

    The Secure Sockets Layer protocol is a protocol layer which may be placed between a reliable connection-oriented network layer protocol @@ -559,7 +583,9 @@ the Internet Engineering Task Force (IETF).

    https rather than http and a different server port (by default 443). This mainly is what mod_ssl provides to you for the Apache webserver...

    -
    top
    top
    +
    +

    References

    [AC96]
    @@ -597,4 +623,8 @@ Version 3.0, 1996. See http://ietf.org/rfc/rfc2246.txt.
    -
    \ No newline at end of file +
    + + \ No newline at end of file diff --git a/docs/manual/stopping.html.en b/docs/manual/stopping.html.en index 117143a573..81bb7eae04 100644 --- a/docs/manual/stopping.html.en +++ b/docs/manual/stopping.html.en @@ -4,11 +4,32 @@ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX - -->Stopping and Restarting - Apache HTTP Server
    <-

    Stopping and Restarting

    + --> +Stopping and Restarting - Apache HTTP Server + + + + + +
    <-
    +

    Stopping and Restarting

    This document covers stopping and restarting Apache on Unix-like systems. Windows users should see Signaling Apache when running.

    -
    top
    + +
    top
    +
    +

    Introduction

    In order to stop or restart Apache, you must send a signal to the running httpd processes. There are two ways to @@ -40,7 +61,9 @@

    tail -f /usr/local/apache2/logs/error_log

    Modify those examples to match your ServerRoot and PidFile settings.

    -
    top
    top
    +
    +

    Stop Now

    Signal: TERM
    apachectl -k stop
    @@ -51,7 +74,9 @@ children. It may take it several seconds to complete killing off its children. Then the parent itself exits. Any requests in progress are terminated, and no further requests are served.

    -
    top
    top
    +
    +

    Graceful Restart

    Signal: USR1
    apachectl -k graceful
    @@ -122,7 +147,9 @@ already has those ports bound). If it fails for any other reason then it's probably a config file error and the error should be fixed before issuing the graceful restart.
    -
    top
    top
    +
    +

    Restart Now

    Signal: HUP
    apachectl -k restart
    @@ -141,7 +168,9 @@
    If your configuration file has errors in it when you issue a restart then your parent will not restart, it will exit with an error. See above for a method of avoiding this.
    -
    top
    top
    +
    +

    Appendix: signals and race conditions

    Prior to Apache 1.2b9 there were several race conditions involving the restart and die signals (a simple @@ -174,4 +203,8 @@ error. See above for a method of avoiding this.

    -- in a test case the server was restarted twenty times per second and clients successfully browsed the site without getting broken images or empty documents.

    -
    \ No newline at end of file + + + \ No newline at end of file diff --git a/docs/manual/suexec.html.en b/docs/manual/suexec.html.en index a610d1bed5..e019211423 100644 --- a/docs/manual/suexec.html.en +++ b/docs/manual/suexec.html.en @@ -4,7 +4,19 @@ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX - -->suEXEC Support - Apache HTTP Server
    <-

    suEXEC Support

    + --> +suEXEC Support - Apache HTTP Server + + + + + +
    <-
    +

    suEXEC Support

    The suEXEC feature provides Apache users the ability to run CGI and SSI programs @@ -20,10 +32,21 @@ you aren't familiar with managing setuid root programs and the security issues they present, we highly recommend that you not consider using suEXEC.

    -
    top
    + +
    top
    +
    +

    Before we begin

    Before jumping head-first into this document, you should be aware of the assumptions made on the part of the @@ -69,7 +92,9 @@ enough to use it.

    Still with us? Yes? Good. Let's move on!

    -
    top
    top
    +
    +

    suEXEC Security Model

    Before we begin configuring and installing suEXEC, we will first discuss the security model you are about @@ -313,7 +338,9 @@ configuration, as well as what security risks can be avoided with a proper suEXEC setup, see the "Beware the Jabberwock" section of this document.

    -
    top
    top
    +
    +

    Configuring & Installing suEXEC

    Here's where we begin the fun.

    @@ -434,7 +461,9 @@ owner root and must have the setuserid execution bit set for file modes.

    -
    top
    top
    +
    +

    Enabling & Disabling suEXEC

    Upon startup of Apache, it looks for the file @@ -455,7 +484,9 @@ will not be enough.

    If you want to disable suEXEC you should kill and restart Apache after you have removed the "suexec" file.

    -
    top
    top
    +
    +

    Using suEXEC

    Virtual Hosts:
    One way to use the suEXEC wrapper is through the SuexecUserGroup directive in @@ -475,7 +506,9 @@ execution to be enabled for the user and that the script must meet the scrutiny of the security checks above.

    -
    top
    top
    +
    +

    Debugging suEXEC

    The suEXEC wrapper will write log information to the file defined with the --with-suexec-logfile option as @@ -483,7 +516,9 @@ the wrapper properly, have a look at this log and the error_log for the server to see where you may have gone astray.

    -
    top
    top
    +
    +

    Beware the Jabberwock: Warnings & Examples

    NOTE! This section may not be @@ -536,4 +571,8 @@ -

    \ No newline at end of file +
    + + \ No newline at end of file diff --git a/docs/manual/upgrading.html.en b/docs/manual/upgrading.html.en index 45b86b9334..ab08f8bbbf 100644 --- a/docs/manual/upgrading.html.en +++ b/docs/manual/upgrading.html.en @@ -4,13 +4,33 @@ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX - -->Upgrading to 2.0 from 1.3 - Apache HTTP Server
    <-

    Upgrading to 2.0 from 1.3

    + --> +Upgrading to 2.0 from 1.3 - Apache HTTP Server + + + + + +
    <-
    +

    Upgrading to 2.0 from 1.3

    In order to assist folks upgrading, we maintain a document describing information critical to existing Apache users. These are intended to be brief notes, and you should be able to find more information in either the New Features document, or in the src/CHANGES file.

    -
    top
    + +
    top
    +
    +

    Compile-Time Configuration Changes

    -
    top
    top
    +
    +

    Run-Time Configuration Changes

      @@ -134,7 +156,9 @@ files. The old behavior can be restored using the MultiviewsMatch directive.
    -
    top
    top
    +
    +

    Misc Changes

      @@ -156,7 +180,9 @@ compiled server should be directed to a separate directory.
    -
    top
    top
    +
    +

    Third Party Modules

    Extensive changes were made to the server API in Apache 2.0. @@ -164,4 +190,8 @@ not work in Apache 2.0 without modification. Details are provided in the developer documentation.

    -
    \ No newline at end of file +
    + + \ No newline at end of file diff --git a/docs/manual/urlmapping.html.en b/docs/manual/urlmapping.html.en index 39c2da7a71..4ff79993d8 100755 --- a/docs/manual/urlmapping.html.en +++ b/docs/manual/urlmapping.html.en @@ -4,14 +4,40 @@ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX - -->Mapping URLs to Filesystem Locations - Apache HTTP Server
    <-

    Mapping URLs to Filesystem Locations

    + --> +Mapping URLs to Filesystem Locations - Apache HTTP Server + + + + + +
    <-
    +

    Mapping URLs to Filesystem Locations

    This document explains how Apache uses the URL of a request to determine the filesystem location from which to serve a file.

    -
    top
    + +
    top
    +
    top
    top
    +
    +

    DocumentRoot

    In deciding what file to serve for a given request, Apache's default behavior is to take the URL-Path for the request (the part @@ -30,7 +56,9 @@ be used to dynamically determine the appropriate place from which to serve content based on the requested IP address or hostname.

    -
    top
    top
    +
    +

    Files Outside the DocumentRoot

    There are frequently circumstances where it is necessary to allow web access to parts of the filesystem that are not strictly @@ -65,7 +93,9 @@ http://example.com/~user/cgi-bin/script.cgi to the path /home/user/cgi-bin/script.cgi and will treat the resulting file as a CGI script.

    -
    top
    top
    +
    +

    User Directories

    Traditionally on Unix systems, the home directory of a particular user can be referred to as @@ -105,7 +135,9 @@

    AliasMatch ^/upages/([a-zA-Z0-9]*)/?(.*) /home/$1/public_html/$2

    -
    top
    top
    +
    +

    URL Redirection

    The configuration directives discussed in the above sections tell Apache to get content from a specific place in the filesystem @@ -141,7 +173,9 @@

    RedirectMatch temp .* http://www.example.com/startpage.html

    -
    top
    top
    +
    +

    Reverse Proxy

    Apache also allows you to bring remote documents into the URL space of the local server. This technique is called reverse @@ -171,7 +205,9 @@ links inside the documents will not be rewritten. So any absolute links on internal.example.com will result in the client breaking out of the proxy server and requesting directly from internal.example.com.

    -
    top
    top
    +
    +

    Rewriting Engine

    When even more powerful substitution is required, the rewriting engine provided by mod_rewrite @@ -184,7 +220,9 @@ breaking out of the proxy server and requesting directly from internal redirects (aliases), external redirects, and proxying. Many practical examples employing mod_rewrite are discussed in the URL Rewriting Guide.

    -
    top
    top
    +
    +

    File Not Found

    Inevitably, URLs will be requested for which no matching file can be found in the filesystem. This can happen for @@ -222,4 +260,8 @@ breaking out of the proxy server and requesting directly from and can be customized in a flexible manner as discussed in the Custom error responses and International Server Error Responses documents.

    -
    \ No newline at end of file +
    + + \ No newline at end of file diff --git a/docs/manual/vhosts/details.html.en b/docs/manual/vhosts/details.html.en index 729e0f228f..9e9e09f43c 100644 --- a/docs/manual/vhosts/details.html.en +++ b/docs/manual/vhosts/details.html.en @@ -4,7 +4,19 @@ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX - -->An In-Depth Discussion of Virtual Host Matching - Apache HTTP Server
    <-

    An In-Depth Discussion of Virtual Host Matching

    + --> +An In-Depth Discussion of Virtual Host Matching - Apache HTTP Server + + + + + +
    <-
    +

    An In-Depth Discussion of Virtual Host Matching

    The virtual host code was completely rewritten in Apache 1.3. This document attempts to explain @@ -18,7 +30,14 @@ understanding how, here are some examples.

    -
    top
    + +
    top
    +
    +

    Config File Parsing

    There is a main_server which consists of all the definitions appearing outside of @@ -205,7 +224,9 @@ wildcard is given the same ServerName as the main_server.

    -
    top
    top
    +
    +

    Virtual Host Matching

    The server determines which vhost to use for a request as follows:

    @@ -377,7 +398,9 @@ -
    top
    top
    +
    +

    Tips

    In addition to the tips on the DNS Issues page, here are some further tips:

    @@ -401,4 +424,8 @@ /abc" should appear after "ServerPath /abc/def"). -
    \ No newline at end of file +
    + + \ No newline at end of file diff --git a/docs/manual/vhosts/examples.html.en b/docs/manual/vhosts/examples.html.en index 61bc017db4..6543dcdede 100644 --- a/docs/manual/vhosts/examples.html.en +++ b/docs/manual/vhosts/examples.html.en @@ -4,7 +4,19 @@ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX - -->VirtualHost Examples - Apache HTTP Server
    <-

    VirtualHost Examples

    + --> +VirtualHost Examples - Apache HTTP Server + + + + + +
    <-
    +

    VirtualHost Examples

    This document attempts to answer the commonly-asked questions about setting up virtual hosts. These scenarios are those involving multiple @@ -12,17 +24,31 @@ coming soon about running sites on several servers behind a single proxy server.

    -
    +
    top
    +
    top
    +
    +

    Running several name-based web sites on a single IP address.

    Your server has a single IP address, and multiple aliases (CNAMES) @@ -107,7 +133,9 @@ configuration will not work for, in fact, is when you are serving different content based on differing IP addresses or ports.

    -
    top
    top
    +
    +

    Name-based hosts on more than one IP address.

    @@ -158,7 +186,9 @@ unknown hostname, or no Host: header, will be served from www.example1.com.

    -
    top
    top
    + -
    top
    top
    +
    +

    Running different sites on different ports.

    You have multiple domains going to the same IP and also want to @@ -250,7 +282,9 @@ </VirtualHost>

    -
    top
    top
    +
    +

    IP-based virtual hosting

    The server has two IP addresses (172.20.30.40 and 172.20.30.50) which resolve to the names @@ -282,7 +316,9 @@ localhost, for example) will go to the main server, if there is one.

    -
    top
    top
    +
    +

    Mixed port-based and ip-based virtual hosts

    The server machine has two IP addresses (172.20.30.40 and @@ -328,7 +364,9 @@ </VirtualHost>

    -
    top
    top
    +
    +

    Mixed name-based and IP-based vhosts

    On some of my addresses, I want to do name-based virtual hosts, and @@ -378,7 +416,9 @@ </VirtualHost>

    -
    top
    top
    +
    top
    top
    +
    +

    Migrating a name-based vhost to an IP-based vhost

    The name-based vhost with the hostname @@ -505,7 +547,9 @@ IP-based vhost) and through the old address (as a name-based vhost).

    -
    top
    top
    +
    +

    Using the ServerPath directive

    We have a server with two name-based vhosts. In order to match the @@ -571,4 +615,8 @@ Host: header can use both URL variants, i.e., with or without URL prefix.

    -
    \ No newline at end of file + + + \ No newline at end of file diff --git a/docs/manual/vhosts/fd-limits.html.en b/docs/manual/vhosts/fd-limits.html.en index f32a814be3..65d2aa1b6d 100644 --- a/docs/manual/vhosts/fd-limits.html.en +++ b/docs/manual/vhosts/fd-limits.html.en @@ -4,7 +4,19 @@ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX - -->File Descriptor Limits - Apache HTTP Server
    <-

    File Descriptor Limits

    + --> +File Descriptor Limits - Apache HTTP Server + + + + + +
    <-
    +

    File Descriptor Limits

    When using a large number of Virtual Hosts, Apache may run out of available file descriptors (sometimes called file @@ -60,7 +72,10 @@ problems and how they can be solved on your operating system.

    -
    top
    +
    top
    +
    +

    Splitting up your log files

    If you want to log multiple virtual hosts to the same log file, you may want to split up the log files afterwards in order to run @@ -99,4 +114,8 @@ split-logfile < /logs/multiple_vhost_log generate one file for each virtual host that appears in your log file. Each file will be called hostname.log.

    -
    \ No newline at end of file +
    + + \ No newline at end of file diff --git a/docs/manual/vhosts/index.html.en b/docs/manual/vhosts/index.html.en index c30a024965..452769dd76 100644 --- a/docs/manual/vhosts/index.html.en +++ b/docs/manual/vhosts/index.html.en @@ -4,7 +4,19 @@ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX - -->Apache Virtual Host documentation - Apache HTTP Server
    <-

    Apache Virtual Host documentation

    + --> +Apache Virtual Host documentation - Apache HTTP Server + + + + + +
    <-
    +

    Apache Virtual Host documentation

    The term Virtual Host refers to the practice of running more than one web site (such as @@ -25,9 +37,15 @@ details of virtual host support in Apache version 1.3 and later.

    -
    +
    top
    +
    top
    +
    +

    Virtual Host Support

    -
    top
    top
    +
    +

    Configuration directives

    \ No newline at end of file +
    + + \ No newline at end of file diff --git a/docs/manual/vhosts/ip-based.html.en b/docs/manual/vhosts/ip-based.html.en index 07a50a2cd3..354a22426e 100644 --- a/docs/manual/vhosts/ip-based.html.en +++ b/docs/manual/vhosts/ip-based.html.en @@ -4,10 +4,30 @@ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX - -->Apache IP-based Virtual Host Support - Apache HTTP Server
    <-

    Apache IP-based Virtual Host Support

    +
    top
    +
    +

    System requirements

    As the term IP-based indicates, the server must have a different IP address for each IP-based @@ -18,7 +38,9 @@ frequently called "ip aliases", and the "ifconfig" command is most commonly used to set them up).

    -
    top
    top
    +
    +

    How to set up Apache

    There are two ways of configuring apache to support multiple hosts. Either by running a separate httpd daemon for each @@ -54,7 +76,9 @@ significant. -

    top
    top
    +
    +

    Setting up multiple daemons

    Create a separate httpd installation for each virtual host. For each installation, use the Listen directive in the @@ -68,7 +92,9 @@

    It is recommended that you use an IP address instead of a hostname (see DNS caveats).

    -
    top
    top
    +
    +

    Setting up a single daemon with virtual hosts

    For this case, a single httpd will service requests for the @@ -116,4 +142,8 @@ directory where they are written. See the security tips document for details.

    -
    \ No newline at end of file + + + \ No newline at end of file diff --git a/docs/manual/vhosts/mass.html.en b/docs/manual/vhosts/mass.html.en index 6d01911167..94d2c892d4 100644 --- a/docs/manual/vhosts/mass.html.en +++ b/docs/manual/vhosts/mass.html.en @@ -4,17 +4,43 @@ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX - -->Dynamically configured mass virtual hosting - Apache HTTP Server
    <-

    Dynamically configured mass virtual hosting

    + --> +Dynamically configured mass virtual hosting - Apache HTTP Server + + + + + +
    <-
    +

    Dynamically configured mass virtual hosting

    This document describes how to efficiently serve an arbitrary number of virtual hosts with Apache 1.3.

    -
    top
    + +
    top
    +
    +

    Motivation

    The techniques described here are of interest if your httpd.conf contains many @@ -68,7 +94,9 @@ NameVirtualHost 111.22.33.44
    arrange for the process at the other end to distribute the logs to the customers (it can also accumulate statistics, etc.).

    -
    top
    top
    +
    +

    Overview

    A virtual host is defined by two pieces of information: its IP address, and the contents of the Host: header @@ -112,7 +140,9 @@ NameVirtualHost 111.22.33.44
    if any CGIs or SSI documents make use of it they will get a misleading value.

    -
    top
    top
    +
    +

    Simple dynamic virtual hosts

    This extract from httpd.conf implements the virtual host arrangement outlined in the Motivation section above, but in a @@ -137,7 +167,9 @@ VirtualScriptAlias /www/hosts/%0/cgi-bin name that is inserted into the filename is then derived from the IP address of the virtual host.

    -
    top
    top
    +
    +

    A virtually hosted homepages system

    This is an adjustment of the above system tailored for an ISP's homepages server. Using a slightly more complicated @@ -161,7 +193,9 @@ ScriptAlias /cgi-bin/ /www/std-cgi/
    VirtualDocumentRoot settings in the mod_vhost_alias documentation.

    -
    top
    top
    +
    +

    Using more than one virtual hosting system on the same server

    With more complicated setups you can use Apache's normal @@ -214,7 +248,9 @@ LogFormat "%V %h %l %u %t \"%r\" %s %b" vcommon
    </VirtualHost>

    -
    top
    top
    +
    +

    More efficient IP-based virtual hosting

    After the first example I noted that it is easy to turn it into an IP-based virtual hosting setup. @@ -238,7 +274,9 @@ VirtualDocumentRootIP /www/hosts/%0/docs
    VirtualScriptAliasIP /www/hosts/%0/cgi-bin

    -
    top
    top
    +
    +

    Using older versions of Apache

    The examples above rely on mod_vhost_alias which appeared after version 1.3.6. If you are using a version @@ -260,7 +298,9 @@ VirtualScriptAliasIP /www/hosts/%0/cgi-bin
    :port on the end which is not the case for %V.

    -
    top
    top
    +
    +

    Simple dynamic virtual hosts using mod_rewrite

    This extract from httpd.conf does the same @@ -316,7 +356,9 @@ RewriteRule ^/(.*)$ /www/hosts/${lowercase:%{SERVER_NAME}}/cgi-bin/$1 [T=appl # that's it!

    -
    top
    top
    + -
    top
    top
    +
    +

    Using a separate virtual host configuration file

    This arrangement uses more advanced mod_rewrite @@ -386,4 +430,8 @@ RewriteCond ${vhost:%1} ^(/.*)$
    RewriteRule ^/(.*)$ %1/cgi-bin/$1

    - \ No newline at end of file + + + \ No newline at end of file diff --git a/docs/manual/vhosts/name-based.html.en b/docs/manual/vhosts/name-based.html.en index bc9a2415ca..ad84cc982d 100644 --- a/docs/manual/vhosts/name-based.html.en +++ b/docs/manual/vhosts/name-based.html.en @@ -4,11 +4,30 @@ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX - -->Name-based Virtual Host Support - Apache HTTP Server
    <-

    Name-based Virtual Host Support

    + --> +Name-based Virtual Host Support - Apache HTTP Server + + + + + +
    <-
    +

    Name-based Virtual Host Support

    This document describes when and how to use name-based virtual hosts.

    -
    top
    + +
    top
    +
    +

    Name-based vs. IP-based Virtual Hosts

    IP-based virtual hosts use the IP address of the connection to determine the correct virtual host to serve. Therefore you need to @@ -43,7 +62,9 @@ they are on separate IP addresses. -

    top
    top
    +
    +

    Using Name-based Virtual Hosts

    @@ -158,7 +179,9 @@ <VirtualHost> container and list it first in the configuration file.

    -
    top
    top
    +
    +

    Compatibility with Older Browsers

    As mentioned earlier, there are some clients who do not send the required data for the name-based virtual @@ -212,4 +235,8 @@ guidelines will, for the most part, ensure that your pages will work with all browsers, new and old.

    -
    \ No newline at end of file +
    + + \ No newline at end of file -- 2.40.0