From: William A. Rowe Jr Date: Sat, 20 Aug 2016 01:17:51 +0000 (+0000) Subject: Regen docs, no complaints yet X-Git-Tag: 2.5.0-alpha~1242 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=7f477e487bfd7b23a20b22687f60450caf42a5da;p=thirdparty%2Fapache%2Fhttpd.git Regen docs, no complaints yet git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1756979 13f79535-47bb-0310-9956-ffa450edef68 --- diff --git a/docs/manual/mod/core.html.de b/docs/manual/mod/core.html.de index 0a1d9d8b600..360dc1dbd1e 100644 --- a/docs/manual/mod/core.html.de +++ b/docs/manual/mod/core.html.de @@ -1556,10 +1556,11 @@ angegebenen MIME-Content-Type

HttpProtocolOptions-Direktive

- - + + diff --git a/docs/manual/mod/core.html.en b/docs/manual/mod/core.html.en index fd61f8de23d..2afd3a25fdf 100644 --- a/docs/manual/mod/core.html.en +++ b/docs/manual/mod/core.html.en @@ -2030,10 +2030,11 @@ media type in the HTTP Content-Type header field

HttpProtocolOptions Directive

Beschreibung:Modify restrictions on HTTP Request Messages
Syntax:HttpProtocolOptions [Strict|Unsafe] [Allow0.9|Require1.0] -[StrictWhitespace|LenientWhitespace] [RegisteredMethods|LenientMethods]
Voreinstellung:HttpProtocolOptions Strict Allow0.9 LenientWhitespace -LenientMethods
Syntax:HttpProtocolOptions [Strict|Unsafe] [StrictURL|UnsafeURL] + [StrictWhitespace|LenientWhitespace] [RegisteredMethods|LenientMethods] + [Allow0.9|Require1.0]
Voreinstellung:HttpProtocolOptions Strict StrictURL LenientWhitespace +LenientMethods Allow0.9
Kontext:Serverkonfiguration, Virtual Host
Status:Core
Modul:core
- - + + @@ -2043,11 +2044,11 @@ LenientMethods (RFC 7230 §3.1.1) and the HTTP Request Header Fields (RFC 7230 §3.2), which are now applied by default or using the Strict option. Due to legacy modules, applications or - custom user-agents which must be deperecated, an Unsafe - option has been added to revert to the legacy behavior. These rules are - applied prior to request processing, so must be configured at the global - or default (first) matching virtual host section, by interface and not - by name, to be honored.

+ custom user-agents which must be deperecated, Unsafe + and UnsafeURL options have been added to revert to the legacy + behaviors. These rules are applied prior to request processing, so must be + configured at the global or default (first) matching virtual host section, + by IP/port interface and not by name, to be honored.

Prior to the introduction of this directive, the Apache HTTP Server request message parsers were tolerant of a number of forms of input @@ -2058,23 +2059,26 @@ LenientMethods of this directive, all grammer rules of the specification are enforced in the default Strict operating mode.

+

RFC 7230 §2.2 and 2.3 define "Reserved Characters" and + "Unreserved Characters". All other character octets are required to + be %XX encoded under this spec, and RFC7230 defers to these requirements. + By default the StrictURI option will reject all requests + containing invalid characters. This rule can be relaxed with the + UnsafeURI option to support badly written user-agents.

+

Users are strongly cautioned against toggling the Unsafe - mode of operation for these reasons, most especially on outward-facing, - publicly accessible server deployments. Reviewing the messages within the - ErrorLog, configured with - LogLevel info level or below, + and UnsafeURI modes of operation, most especially on + outward-facing, publicly accessible server deployments. If an interface + is required of faulty monitoring or other custom software running only + on an intranet, users should consider toggling these only for a specific + virtual host configured on their private subnet.

+ +

Reviewing the messages logged to the ErrorLog, + configured with LogLevel info level, can help identify such faulty requests along with their origin. Users should pay particular attention to any 400 responses in the access log for indiciations that valid requests are unexpectedly rejected.

-

RFC 2616 §19.6 "Compatibility With Previous Versions" had - encouraged HTTP servers to support legacy HTTP/0.9 requests. RFC 7230 - superceeds this with "The expectation to support HTTP/0.9 requests has - been removed" and offers additional comments in - RFC 2616 Appendix A. The Require1.0 option allows - the user to remove support of the default Allow0.9 option's - behavior.

-

RFC 7230 §3.5 "Message Parsing Robustness" permits, and identifies potential risks of parsing messages containing non-space character whitespace. While the spec defines that exactly one space @@ -2091,13 +2095,21 @@ LenientMethods origin servers shall respond with an error when an unsupported method is encountered in the request line. This already happens when the LenientMethods option is used, but administrators may wish - to toggle the RegisteredMethods option and register all - permitted method tokens using the RegisterHttpMethod + to toggle the RegisteredMethods option and register any + non-standard methods using the RegisterHttpMethod directive, particularly if the Unsafe option has been toggled. The RegisteredMethods option should not be toggled for forward proxy hosts, as the methods supported by the origin servers are unknown to the proxy server.

+

RFC 2616 §19.6 "Compatibility With Previous Versions" had + encouraged HTTP servers to support legacy HTTP/0.9 requests. RFC 7230 + superceeds this with "The expectation to support HTTP/0.9 requests has + been removed" and offers additional comments in + RFC 2616 Appendix A. The Require1.0 option allows + the user to remove support of the default Allow0.9 option's + behavior.

+
top

<If> Directive

diff --git a/docs/manual/mod/core.html.es b/docs/manual/mod/core.html.es index d3a454f70c0..2be9eb1d458 100644 --- a/docs/manual/mod/core.html.es +++ b/docs/manual/mod/core.html.es @@ -1739,10 +1739,11 @@ media type in the HTTP Content-Type header field

HttpProtocolOptions Directiva

Description:Modify restrictions on HTTP Request Messages
Syntax:HttpProtocolOptions [Strict|Unsafe] [Allow0.9|Require1.0] -[StrictWhitespace|LenientWhitespace] [RegisteredMethods|LenientMethods]
Default:HttpProtocolOptions Strict Allow0.9 LenientWhitespace -LenientMethods
Syntax:HttpProtocolOptions [Strict|Unsafe] [StrictURL|UnsafeURL] + [StrictWhitespace|LenientWhitespace] [RegisteredMethods|LenientMethods] + [Allow0.9|Require1.0]
Default:HttpProtocolOptions Strict StrictURL LenientWhitespace +LenientMethods Allow0.9
Context:server config, virtual host
Status:Core
Module:core
- - + + diff --git a/docs/manual/mod/core.html.fr b/docs/manual/mod/core.html.fr index 87a61a48cfd..03c1a5fbd4e 100644 --- a/docs/manual/mod/core.html.fr +++ b/docs/manual/mod/core.html.fr @@ -2175,10 +2175,11 @@ clients

Directive HttpProtocolOptions

Descripción:Modify restrictions on HTTP Request Messages
Sintaxis:HttpProtocolOptions [Strict|Unsafe] [Allow0.9|Require1.0] -[StrictWhitespace|LenientWhitespace] [RegisteredMethods|LenientMethods]
Valor por defecto:HttpProtocolOptions Strict Allow0.9 LenientWhitespace -LenientMethods
Sintaxis:HttpProtocolOptions [Strict|Unsafe] [StrictURL|UnsafeURL] + [StrictWhitespace|LenientWhitespace] [RegisteredMethods|LenientMethods] + [Allow0.9|Require1.0]
Valor por defecto:HttpProtocolOptions Strict StrictURL LenientWhitespace +LenientMethods Allow0.9
Contexto:server config, virtual host
Estado:Core
Módulo:core
- - + + diff --git a/docs/manual/mod/core.html.ja.utf8 b/docs/manual/mod/core.html.ja.utf8 index 10c20d9e758..f99d5181075 100644 --- a/docs/manual/mod/core.html.ja.utf8 +++ b/docs/manual/mod/core.html.ja.utf8 @@ -1504,10 +1504,11 @@ request

HttpProtocolOptions ディレクティブ

Description:Modify restrictions on HTTP Request Messages
Syntaxe:HttpProtocolOptions [Strict|Unsafe] [Allow0.9|Require1.0] -[StrictWhitespace|LenientWhitespace] [RegisteredMethods|LenientMethods]
Défaut:HttpProtocolOptions Strict Allow0.9 LenientWhitespace -LenientMethods
Syntaxe:HttpProtocolOptions [Strict|Unsafe] [StrictURL|UnsafeURL] + [StrictWhitespace|LenientWhitespace] [RegisteredMethods|LenientMethods] + [Allow0.9|Require1.0]
Défaut:HttpProtocolOptions Strict StrictURL LenientWhitespace +LenientMethods Allow0.9
Contexte:configuration du serveur, serveur virtuel
Statut:Core
Module:core
- - + + diff --git a/docs/manual/mod/core.html.tr.utf8 b/docs/manual/mod/core.html.tr.utf8 index 45533e8dae4..f3624a7066d 100644 --- a/docs/manual/mod/core.html.tr.utf8 +++ b/docs/manual/mod/core.html.tr.utf8 @@ -1971,10 +1971,11 @@ için iptal edilmiştir.

HttpProtocolOptions Yönergesi

説明:Modify restrictions on HTTP Request Messages
構文:HttpProtocolOptions [Strict|Unsafe] [Allow0.9|Require1.0] -[StrictWhitespace|LenientWhitespace] [RegisteredMethods|LenientMethods]
デフォルト:HttpProtocolOptions Strict Allow0.9 LenientWhitespace -LenientMethods
構文:HttpProtocolOptions [Strict|Unsafe] [StrictURL|UnsafeURL] + [StrictWhitespace|LenientWhitespace] [RegisteredMethods|LenientMethods] + [Allow0.9|Require1.0]
デフォルト:HttpProtocolOptions Strict StrictURL LenientWhitespace +LenientMethods Allow0.9
コンテキスト:サーバ設定ファイル, バーチャルホスト
ステータス:Core
モジュール:core
- - + + diff --git a/docs/manual/mod/core.xml.de b/docs/manual/mod/core.xml.de index 2fd01c8e72f..9a7dde92433 100644 --- a/docs/manual/mod/core.xml.de +++ b/docs/manual/mod/core.xml.de @@ -1,7 +1,7 @@ - + + + diff --git a/docs/manual/mod/core.xml.ja b/docs/manual/mod/core.xml.ja index d03dca97974..e4ed2af9598 100644 --- a/docs/manual/mod/core.xml.ja +++ b/docs/manual/mod/core.xml.ja @@ -1,7 +1,7 @@ - + +
Açıklama:Modify restrictions on HTTP Request Messages
Sözdizimi:HttpProtocolOptions [Strict|Unsafe] [Allow0.9|Require1.0] -[StrictWhitespace|LenientWhitespace] [RegisteredMethods|LenientMethods]
Öntanımlı:HttpProtocolOptions Strict Allow0.9 LenientWhitespace -LenientMethods
Sözdizimi:HttpProtocolOptions [Strict|Unsafe] [StrictURL|UnsafeURL] + [StrictWhitespace|LenientWhitespace] [RegisteredMethods|LenientMethods] + [Allow0.9|Require1.0]
Öntanımlı:HttpProtocolOptions Strict StrictURL LenientWhitespace +LenientMethods Allow0.9
Bağlam:sunucu geneli, sanal konak
Durum:Çekirdek
Modül:core