diff --git a/docs/manual/mod/core.html.en b/docs/manual/mod/core.html.en index dc5afc634a..0b0e882637 100644 --- a/docs/manual/mod/core.html.en +++ b/docs/manual/mod/core.html.en @@ -105,15 +105,22 @@ available Context:server config Status:Core Module:core -Compatibility:Available in Apache 2.1.5 and later +Compatibility:Available in Apache 2.1.5 and later. +On Windows from Apache 2.3.3 and later.

This directive enables operating system specific optimizations for a listening socket by the Protocol type. The basic premise is for the kernel to not send a socket to the server process until either data is received or an entire HTTP Request is buffered. Only - FreeBSD's Accept Filters and Linux's more primitive - TCP_DEFER_ACCEPT are currently supported.

+ FreeBSD's Accept Filters, Linux's more primitive + TCP_DEFER_ACCEPT, and Windows' optimized AcceptEx() + are currently supported.

+ +

Using none for an argument will disable any accept filters + for that protocol. This is useful for protocols that require a server + send data first, such as ftp: or nntp:

+

AcceptFilter nntp none

The default values on FreeBSD are:

@@ -142,10 +149,28 @@ available tcp(7) man page.

-

Using none for an argument will disable any accept filters - for that protocol. This is useful for protocols that require a server - send data first, such as nntp:

-

AcceptFilter nntp none

+

The default values on Windows are:

+

+ AcceptFilter http data
+ AcceptFilter https data +

+ +

Window's mpm_winnt interprets the AcceptFilter to toggle the AcceptEx() + API, and does not support http protocol buffering. There are two values + which utilize the Windows AcceptEx() API and will recycle network + sockets between connections. data waits until data has + been transmitted as documented above, and the initial data buffer and + network endpoint addresses are all retrieved from the single AcceptEx() + invocation. connect will use the AcceptEx() API, also + retrieve the network endpoint addresses, but like none + the connect option does not wait for the initial data + transmission.

+ +

On Windows, none uses accept() rather than than AcceptEx() + and will not recycle sockets between connections. This is useful for + network adapters with broken driver support, as well as some virtual + network providers such as vpn drivers, or spam, virus or spyware + filters.

diff --git a/docs/manual/mod/core.xml b/docs/manual/mod/core.xml index 40f454db7a..2bdf5d4eb3 100644 --- a/docs/manual/mod/core.xml +++ b/docs/manual/mod/core.xml @@ -32,7 +32,8 @@ available Configures optimizations for a Protocol's Listener Sockets AcceptFilter protocol accept_filter server config -Available in Apache 2.1.5 and later +Available in Apache 2.1.5 and later. +On Windows from Apache 2.3.3 and later.

This directive enables operating system specific optimizations for a @@ -40,8 +41,14 @@ available kernel to not send a socket to the server process until either data is received or an entire HTTP Request is buffered. Only - FreeBSD's Accept Filters and Linux's more primitive - TCP_DEFER_ACCEPT are currently supported.

+ FreeBSD's Accept Filters, Linux's more primitive + TCP_DEFER_ACCEPT, and Windows' optimized AcceptEx() + are currently supported.

+ +

Using none for an argument will disable any accept filters + for that protocol. This is useful for protocols that require a server + send data first, such as ftp: or nntp:

+ AcceptFilter nntp none

The default values on FreeBSD are:

@@ -70,10 +77,28 @@ available tcp(7) man page.

-

Using none for an argument will disable any accept filters - for that protocol. This is useful for protocols that require a server - send data first, such as nntp:

- AcceptFilter nntp none +

The default values on Windows are:

+ + AcceptFilter http data
+ AcceptFilter https data +
+ +

Window's mpm_winnt interprets the AcceptFilter to toggle the AcceptEx() + API, and does not support http protocol buffering. There are two values + which utilize the Windows AcceptEx() API and will recycle network + sockets between connections. data waits until data has + been transmitted as documented above, and the initial data buffer and + network endpoint addresses are all retrieved from the single AcceptEx() + invocation. connect will use the AcceptEx() API, also + retrieve the network endpoint addresses, but like none + the connect option does not wait for the initial data + transmission.

+ +

On Windows, none uses accept() rather than than AcceptEx() + and will not recycle sockets between connections. This is useful for + network adapters with broken driver support, as well as some virtual + network providers such as vpn drivers, or spam, virus or spyware + filters.

diff --git a/docs/manual/mod/directives.html.de b/docs/manual/mod/directives.html.de index 415cef3091..4ee064708c 100644 --- a/docs/manual/mod/directives.html.de +++ b/docs/manual/mod/directives.html.de @@ -38,7 +38,7 @@ zu jeder Direktive eine Zusammenfassung der Details enthlt.

-

 A  |  B  |  C  |  D  |  E  |  F  |  G  |  H  |  I  |  K  |  L  |  M  |  N  |  O  |  P  |  R  |  S  |  T  |  U  |  V  |  W  |  X 

+

 A  |  B  |  C  |  D  |  E  |  F  |  G  |  H  |  I  |  K  |  L  |  M  |  N  |  O  |  P  |  R  |  S  |  T  |  U  |  V  |  X 

diff --git a/docs/manual/mod/directives.html.en b/docs/manual/mod/directives.html.en index d598dec659..a51ba3cf6a 100644 --- a/docs/manual/mod/directives.html.en +++ b/docs/manual/mod/directives.html.en @@ -39,7 +39,7 @@ summary form.

-

 A  |  B  |  C  |  D  |  E  |  F  |  G  |  H  |  I  |  K  |  L  |  M  |  N  |  O  |  P  |  R  |  S  |  T  |  U  |  V  |  W  |  X 

+

 A  |  B  |  C  |  D  |  E  |  F  |  G  |  H  |  I  |  K  |  L  |  M  |  N  |  O  |  P  |  R  |  S  |  T  |  U  |  V  |  X 

diff --git a/docs/manual/mod/directives.html.es b/docs/manual/mod/directives.html.es index c40f1783f5..bb8cc9e82e 100644 --- a/docs/manual/mod/directives.html.es +++ b/docs/manual/mod/directives.html.es @@ -41,7 +41,7 @@ directiva de forma resumida.

-

 A  |  B  |  C  |  D  |  E  |  F  |  G  |  H  |  I  |  K  |  L  |  M  |  N  |  O  |  P  |  R  |  S  |  T  |  U  |  V  |  W  |  X 

+

 A  |  B  |  C  |  D  |  E  |  F  |  G  |  H  |  I  |  K  |  L  |  M  |  N  |  O  |  P  |  R  |  S  |  T  |  U  |  V  |  X 

diff --git a/docs/manual/mod/directives.html.ja.utf8 b/docs/manual/mod/directives.html.ja.utf8 index 4565808fcc..bd142e1898 100644 --- a/docs/manual/mod/directives.html.ja.utf8 +++ b/docs/manual/mod/directives.html.ja.utf8 @@ -37,7 +37,7 @@ あります。

-

 A  |  B  |  C  |  D  |  E  |  F  |  G  |  H  |  I  |  K  |  L  |  M  |  N  |  O  |  P  |  R  |  S  |  T  |  U  |  V  |  W  |  X 

+

 A  |  B  |  C  |  D  |  E  |  F  |  G  |  H  |  I  |  K  |  L  |  M  |  N  |  O  |  P  |  R  |  S  |  T  |  U  |  V  |  X 

diff --git a/docs/manual/mod/directives.html.ko.euc-kr b/docs/manual/mod/directives.html.ko.euc-kr index a9e24045a2..2bb5afe75c 100644 --- a/docs/manual/mod/directives.html.ko.euc-kr +++ b/docs/manual/mod/directives.html.ko.euc-kr @@ -36,7 +36,7 @@ þ Ͽ þ ִ.

-

 A  |  B  |  C  |  D  |  E  |  F  |  G  |  H  |  I  |  K  |  L  |  M  |  N  |  O  |  P  |  R  |  S  |  T  |  U  |  V  |  W  |  X 

+

 A  |  B  |  C  |  D  |  E  |  F  |  G  |  H  |  I  |  K  |  L  |  M  |  N  |  O  |  P  |  R  |  S  |  T  |  U  |  V  |  X 

diff --git a/docs/manual/mod/directives.html.tr.utf8 b/docs/manual/mod/directives.html.tr.utf8 index f0c85544b7..18b3984b5c 100644 --- a/docs/manual/mod/directives.html.tr.utf8 +++ b/docs/manual/mod/directives.html.tr.utf8 @@ -35,7 +35,7 @@ Hızlı Yönerge Kılavuzu da mevcuttur.

-

 A  |  B  |  C  |  D  |  E  |  F  |  G  |  H  |  I  |  K  |  L  |  M  |  N  |  O  |  P  |  R  |  S  |  T  |  U  |  V  |  W  |  X 

+

 A  |  B  |  C  |  D  |  E  |  F  |  G  |  H  |  I  |  K  |  L  |  M  |  N  |  O  |  P  |  R  |  S  |  T  |  U  |  V  |  X 

diff --git a/docs/manual/mod/mod_request.html.en b/docs/manual/mod/mod_request.html.en index ea5e979af1..f9bd517925 100644 --- a/docs/manual/mod/mod_request.html.en +++ b/docs/manual/mod/mod_request.html.en @@ -59,7 +59,7 @@ mod_include.

When this directive has a value greater than zero, request handlers that would otherwise discard request bodies will - instead let the request body aside for use by filters up to + instead set the request body aside for use by filters up to the maximum size specified. In the case of the mod_include filter, an attempt to POST a request to the static shtml file will cause any subrequests to be POST diff --git a/docs/manual/mod/mod_request.xml.tr b/docs/manual/mod/mod_request.xml.tr index 3f4532ebf6..986bea51dc 100644 --- a/docs/manual/mod/mod_request.xml.tr +++ b/docs/manual/mod/mod_request.xml.tr @@ -1,7 +1,7 @@ - +