From: Joshua Slive Date: Wed, 22 Nov 2000 06:15:41 +0000 (+0000) Subject: Update the "bind" docs, remove the stuff from "server-wide.html" that X-Git-Tag: moving_to_httpd_module~103 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=180ef301d6d26602bb0a59871a8818c14e62968f;p=thirdparty%2Fapache%2Fhttpd.git Update the "bind" docs, remove the stuff from "server-wide.html" that will now go in the MPMs, and update prefork.html with that documentation. git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@87061 13f79535-47bb-0310-9956-ffa450edef68 --- diff --git a/docs/manual/bind.html b/docs/manual/bind.html index 75bacbb2536..5f04cf45c31 100644 --- a/docs/manual/bind.html +++ b/docs/manual/bind.html @@ -14,84 +14,27 @@

Setting which addresses and ports Apache uses

-
- -When Apache starts, it connects to some port and address on the +

When Apache starts, it connects to some port and address on the local machine and waits for incoming requests. By default, it listens to all addresses on the machine, and to the port -as specified by the Port directive in the server configuration. +as specified by the Port directive in the server configuration. However, it can be told to listen to more the one port, or to listen to only selected addresses, or a combination. This is often combined with the Virtual Host feature which determines how Apache -responds to different IP addresses, hostnames and ports.

- -There are two directives used to restrict or specify which addresses -and ports Apache listens to. - -

- -

BindAddress

-Syntax: BindAddress [ * | IP-address - | hostname ]
-Default: BindAddress *
-Context: server config
-Status: Core

- -Makes the server listen to just the specified address. If the argument -is *, the server listens to all addresses. The port listened to -is set with the Port directive. Only one BindAddress -should be used. - -

Listen

-Syntax: Listen [ port | IP-address:port ]
-Default: none
-Context: server config
-Status: Core

+responds to different IP addresses, hostnames and ports.

-Listen can be used instead of BindAddress and -Port. It tells the server to accept incoming requests on the -specified port or address-and-port combination. If the first format is -used, with a port number only, the server listens to the given port on -all interfaces, instead of the port given by the Port +

The Listen directive tells the server to accept +incoming requests only on the specified port or address-and-port +combinations. If only a port number is specified in the +Listen directive, the server listens to the given port on +all interfaces, instead of the port given by the Port directive. If an IP address is given as well as a port, the server -will listen on the given port and interface.

Multiple Listen +will listen on the given port and interface. Multiple Listen directives may be used to specify a number of addresses and ports to listen to. The server will respond to requests from any of the listed -addresses and ports.

+addresses and ports.

-For example, to make the server accept connections on both port +

For example, to make the server accept connections on both port 80 and port 8000, use: 

    Listen 80
@@ -107,7 +50,7 @@ interfaces and port numbers, use
 
 
How this works with Virtual Hosts

 
-BindAddress and Listen do not implement Virtual Hosts. They tell the
+
Listen does not implement Virtual Hosts.  It only tells the
 main server what addresses and ports to listen to.  If no
 <VirtualHost> directives are used, the server will behave the
 same for all accepted requests. However, <VirtualHost> can be
@@ -122,8 +65,8 @@ not listening to, it cannot be accessed.
 
See also

 
 See also the documentation on
+Listen directive,
 Virtual Hosts,
-BindAddress directive,
 Port directive,
 DNS Issues
 and
diff --git a/docs/manual/bind.html.en b/docs/manual/bind.html.en
index 75bacbb2536..5f04cf45c31 100644
--- a/docs/manual/bind.html.en
+++ b/docs/manual/bind.html.en
@@ -14,84 +14,27 @@
 
 
Setting which addresses and ports Apache uses

 
-

-
-When Apache starts, it connects to some port and address on the
+
When Apache starts, it connects to some port and address on the
 local machine and waits for incoming requests. By default, it
 listens to all addresses on the machine, and to the port
-as specified by the Port directive in the server configuration.
+as specified by the Port directive in the server configuration.
 However, it can be told to listen to more the one port, or to listen
 to only selected addresses, or a combination. This is often combined
 with the Virtual Host feature which determines how Apache
-responds to different IP addresses, hostnames and ports.

-
-There are two directives used to restrict or specify which addresses
-and ports Apache listens to.
-
-

-
-
BindAddress

-Syntax: BindAddress [ * | IP-address 
- | hostname ]

-Default: BindAddress *

-Context: server config

-Status: Core

-
-Makes the server listen to just the specified address. If the argument
-is *, the server listens to all addresses. The port listened to
-is set with the Port directive. Only one BindAddress
-should be used.
-
-
Listen

-Syntax: Listen [ port | IP-address:port ]

-Default: none

-Context: server config

-Status: Core

+responds to different IP addresses, hostnames and ports.

 
-Listen can be used instead of BindAddress and
-Port. It tells the server to accept incoming requests on the
-specified port or address-and-port combination. If the first format is
-used, with a port number only, the server listens to the given port on
-all interfaces, instead of the port given by the Port
+
The Listen directive tells the server to accept
+incoming requests only on the specified port or address-and-port
+combinations. If only a port number is specified in the
+Listen directive, the server listens to the given port on
+all interfaces, instead of the port given by the Port
 directive. If an IP address is given as well as a port, the server
-will listen on the given port and interface.  
 Multiple Listen
+will listen on the given port and interface.  Multiple Listen
 directives may be used to specify a number of addresses and ports to
 listen to. The server will respond to requests from any of the listed
-addresses and ports.

+addresses and ports.

 
-For example, to make the server accept connections on both port
+
For example, to make the server accept connections on both port
 80 and port 8000, use:
 
    Listen 80
@@ -107,7 +50,7 @@ interfaces and port numbers, use
 
 
How this works with Virtual Hosts

 
-BindAddress and Listen do not implement Virtual Hosts. They tell the
+
Listen does not implement Virtual Hosts.  It only tells the
 main server what addresses and ports to listen to.  If no
 <VirtualHost> directives are used, the server will behave the
 same for all accepted requests. However, <VirtualHost> can be
@@ -122,8 +65,8 @@ not listening to, it cannot be accessed.
 
See also

 
 See also the documentation on
+Listen directive,
 Virtual Hosts,
-BindAddress directive,
 Port directive,
 DNS Issues
 and
diff --git a/docs/manual/mod/mpm_common.html b/docs/manual/mod/mpm_common.html
index d29dbc9fd8a..b317e37526a 100644
--- a/docs/manual/mod/mpm_common.html
+++ b/docs/manual/mod/mpm_common.html
@@ -212,16 +212,15 @@ Listen [IP address:]port number

 >Module: dexter, mpmt_pthread, perchild, prefork, mpm_winnt

 
 
-
The Listen directive instructs Apache to listen to more than one IP
-address or port; by default it responds to requests on all IP
+
The Listen directive instructs Apache to listen to only specific IP
+addresses or ports; by default it responds to requests on all IP
 interfaces, but only on the port given by the Port directive.

+HREF="core.html#port">Port directive.

 
-Listen can be used instead of BindAddress and Port. It tells
+
The Listen directive tells
 the server to accept incoming requests on the specified port or
-address-and-port combination. If the first format is used, with a port
-number only, the server listens to the given port on all interfaces,
+address-and-port combination. If only a port number is specified,
+the server listens to the given port on all interfaces,
 instead of the port given by the Port directive. If an IP
 address is given as well as a port, the server will listen on the
 given port and interface.  

diff --git a/docs/manual/mod/prefork.html b/docs/manual/mod/prefork.html
index 9425cf9ee17..757b26f33f7 100644
--- a/docs/manual/mod/prefork.html
+++ b/docs/manual/mod/prefork.html
@@ -16,7 +16,8 @@
 
 
Multi-Processing Module prefork

 

-This Multi-Processing Module implements a pre-forking web server.
+This Multi-Processing Module implements a non-threaded, pre-forking
+web server.
 

 
 
Summary
 
-
This Multi-Processing Module (MPM) implements a pre-forking
-non-threaded web server which handles request in a manner
-very similar to the default behavior of Apache 1.3 on Unix.

-
+
This Multi-Processing Module (MPM) implements a non-threaded,
+pre-forking web server which handles request in a manner very similar
+to the default behavior of Apache 1.3 on Unix.

+
+
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 or
+idle server processes, which stand ready to serve incoming requests.
+In this way, clients do not need to wait for a new child processes to
+be forked before their requests can be served.

+
+
The StartServers, MinSpareServers,
+MaxSpareServers, and MaxServers regulate how
+the parent process creates children to serve requests.  In general,
+Apache is very self-regulating, so most sites do not need to adjust
+these directives from their default values.  Sites which need to serve
+more than 256 simultaneous requests may need to increase
+MaxClients, while sites with limited memory may need to
+decrease MaxClients to keep the server from thrashing
+(swapping memory to disk and back).  More information about tuning
+process creation is provided in the performance hints documentation.

+
+
While the parent process is usually started as root under Unix
+in order to bind to port 80, the child processes are launched
+by Apache as a less-privileged user.  The User and
+Group directives are used to set the privileges
+of the Apache child processes.  The child processes must
+be able to read all the content that will be served, but
+should have as few privileges beyond that as possible.
+In addition, unless suexec is used,
+these directives also set the privileges which will be inherited
+by CGI scripts.

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

+
+
See also: Setting which addresses and ports
+Apache uses.

 
 
Directives

 
    
@@ -52,8 +88,8 @@ very similar to the default behavior of Apache 1.3 on Unix.
    
 
  • LockFile
    • 
 
  • MaxClients
    • 
 
  • MaxRequestsPerChild
    • 
-
  • MaxSpareServers
    • 
-
  • MinSpareServers
    • 
+
  • MaxSpareServers
    • 
+
  • MinSpareServers
    • 
 
  • ScoreBoardFile
    • 
 
  • SendBufferSize
    • 
 
  • StartServers
    • 
@@ -127,7 +163,7 @@ This directive has no effect on Microsoft Windows.
 
    
 
 See also MaxSpareServers and
-StartServers.
    
+StartServers.
 
 
 
diff --git a/docs/manual/server-wide.html b/docs/manual/server-wide.html
index be987a8f5a4..bf8fa72a3ff 100644
--- a/docs/manual/server-wide.html
+++ b/docs/manual/server-wide.html
@@ -22,8 +22,6 @@ the basic operations of the server.
    
 
 
@@ -81,108 +79,6 @@ which are writable by non-root users.  See the security tips documentation for
 more details.
    
 
-
    
-
-
    Process Creation
    
-
-
-
    
-Related Directives

    
-
-BS2000Account
    
-Group
    
-MaxClients
    
-MaxRequestsPerChild
    
-MaxSpareServers
    
-MinSpareServers
    
-ServerType
    
-StartServers
    
-ThreadsPerChild
    
-User
    
-
    
-
-
    When ServerType is set to its recommended value of
-Standalone, Apache 1.3 for Unix is a pre-forking web
-server.  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 or
-idle server processes, which stand ready to serve incoming requests.
-In this way, clients do not need to wait for a new child processes to
-be forked before their requests can be served.
    
-
-
    The StartServers, MinSpareServers,
-MaxSpareServers, and MaxServers regulate how
-the parent process creates children to serve requests.  In general,
-Apache is very self-regulating, so most sites do not need to adjust
-these directives from their default values.  Sites which need to serve
-more than 256 simultaneous requests may need to increase
-MaxClients, while sites with limited memory may need to
-decrease MaxClients to keep the server from thrashing
-(swapping memory to disk and back).  More information about tuning
-process creation is provided in the performance hints documentation.
    
-
-
    While the parent process is usually started as root under Unix
-in order to bind to port 80, the child processes are launched
-by Apache as a less-privileged user.  The User and
-Group directives are used to set the privileges
-of the Apache child processes.  The child processes must
-be able to read all the content that will be served, but
-should have as few privileges beyond that as possible.
-In addition, unless suexec is used,
-these directives also set the privileges which will be inherited
-by CGI scripts.
    
-
-
    MaxRequestsPerChild controls how frequently the server
-recycles processes by killing old ones and launching new ones.
    
-
-
    Under Windows, Apache launches one control process and one
-child process.  The child process creates multiple threads to
-serve requests.  The number of threads is controlled by the
-ThreadsPerChild directive.
    
-
-
    
-
-
    Network Configuration
    
-
-
-
    
-Related Directives

    
-
-BindAddress
    
-KeepAlive
    
-KeepAliveTimeout
    
-Listen
    
-ListenBackLog
    
-MaxKeepAliveRequests
    
-Port
    
-SendBufferSize
    
-TimeOut
    
-
    
-
-
    When Apache starts, it connects to some port and address on the
-local machine and waits for incoming requests. By default, it listens
-to all addresses on the machine, and to the port as specified by the
-Port directive in the server configuration.  However, it
-can be told to listen to more than one port, to listen to only
-selected addresses, or a combination. This is often combined with the
-Virtual Host feature which determines how Apache
-responds to different IP addresses, hostnames and ports.
    
-
-
    There are two directives used to restrict or specify which addresses
-and ports Apache listens to.  The BindAddress directive
-is used to restrict the server to listening to a single IP address.
-The Listen directive can be used to specify multiple
-IP addresses and/or Ports to which Apache will listen.
    
-
-
    The ListenBackLog, SendBufferSize, and
-TimeOut directives are used to adjust how Apache
-interacts with the network.
    
-
-
    The KeepAlive, KeepAliveTimeout, 
-and MaxKeepAliveRequests directives are used to
-configure how Apache handles persistent connections.
    
-
 
    
 
    Limiting Resource Usage
    
 
diff --git a/docs/manual/server-wide.html.en b/docs/manual/server-wide.html.en
index be987a8f5a4..bf8fa72a3ff 100644
--- a/docs/manual/server-wide.html.en
+++ b/docs/manual/server-wide.html.en
@@ -22,8 +22,6 @@ the basic operations of the server.
    
 
@@ -81,108 +79,6 @@ which are writable by non-root users.  See the security tips documentation for
 more details.
    
 
-
    
-
-
    Process Creation
    
-
-
    
 
    
-
    
-Related Directives

    
-
-BS2000Account
    
-Group
    
-MaxClients
    
-MaxRequestsPerChild
    
-MaxSpareServers
    
-MinSpareServers
    
-ServerType
    
-StartServers
    
-ThreadsPerChild
    
-User
    
-
    
-
-
    When ServerType is set to its recommended value of
-Standalone, Apache 1.3 for Unix is a pre-forking web
-server.  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 or
-idle server processes, which stand ready to serve incoming requests.
-In this way, clients do not need to wait for a new child processes to
-be forked before their requests can be served.
    
-
-
    The StartServers, MinSpareServers,
-MaxSpareServers, and MaxServers regulate how
-the parent process creates children to serve requests.  In general,
-Apache is very self-regulating, so most sites do not need to adjust
-these directives from their default values.  Sites which need to serve
-more than 256 simultaneous requests may need to increase
-MaxClients, while sites with limited memory may need to
-decrease MaxClients to keep the server from thrashing
-(swapping memory to disk and back).  More information about tuning
-process creation is provided in the performance hints documentation.
    
-
-
    While the parent process is usually started as root under Unix
-in order to bind to port 80, the child processes are launched
-by Apache as a less-privileged user.  The User and
-Group directives are used to set the privileges
-of the Apache child processes.  The child processes must
-be able to read all the content that will be served, but
-should have as few privileges beyond that as possible.
-In addition, unless suexec is used,
-these directives also set the privileges which will be inherited
-by CGI scripts.
    
-
-
    MaxRequestsPerChild controls how frequently the server
-recycles processes by killing old ones and launching new ones.
    
-
-
    Under Windows, Apache launches one control process and one
-child process.  The child process creates multiple threads to
-serve requests.  The number of threads is controlled by the
-ThreadsPerChild directive.
    
-
-
    
-
-
    Network Configuration
    
-
-
-
    
-Related Directives

    
-
-BindAddress
    
-KeepAlive
    
-KeepAliveTimeout
    
-Listen
    
-ListenBackLog
    
-MaxKeepAliveRequests
    
-Port
    
-SendBufferSize
    
-TimeOut
    
-
    
-
-
    When Apache starts, it connects to some port and address on the
-local machine and waits for incoming requests. By default, it listens
-to all addresses on the machine, and to the port as specified by the
-Port directive in the server configuration.  However, it
-can be told to listen to more than one port, to listen to only
-selected addresses, or a combination. This is often combined with the
-Virtual Host feature which determines how Apache
-responds to different IP addresses, hostnames and ports.
    
-
-
    There are two directives used to restrict or specify which addresses
-and ports Apache listens to.  The BindAddress directive
-is used to restrict the server to listening to a single IP address.
-The Listen directive can be used to specify multiple
-IP addresses and/or Ports to which Apache will listen.
    
-
-
    The ListenBackLog, SendBufferSize, and
-TimeOut directives are used to adjust how Apache
-interacts with the network.
    
-
-
    The KeepAlive, KeepAliveTimeout, 
-and MaxKeepAliveRequests directives are used to
-configure how Apache handles persistent connections.
    
-
 
    
 
    Limiting Resource Usage