Skip to content

Commit ef5ea14

Browse files
committed
Mike's AD review
Add some text about the advisory nature of the signal and how this won't change intermediaries that don't understand this.
1 parent e14c8a7 commit ef5ea14

File tree

1 file changed

+15
-6
lines changed

1 file changed

+15
-6
lines changed

draft-ietf-httpbis-incremental.md

Lines changed: 15 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -82,9 +82,14 @@ an intermediary that tries to buffer entire messages --
8282
either request or response -- prevents any data from being delivered.
8383

8484
To help avoid such behavior, this document specifies the "Incremental" HTTP header
85-
field, which instructs HTTP intermediaries to begin forwarding the HTTP message
85+
field, which requests that HTTP intermediaries begin forwarding the HTTP message
8686
downstream before receiving the complete message.
8787

88+
This indication is advisory.
89+
Intermediaries that are unaware of this field will not change their behavior.
90+
intermediaries that support the field might choose instead to reject a request;
91+
see {{security}}.
92+
8893

8994
# Conventions and Definitions
9095

@@ -136,7 +141,7 @@ sections of the message before forwarding them downstream.
136141
If an intermediary decides outright to refuse forwarding the message body
137142
incrementally, the intermediary MUST generate an error response rather than
138143
buffering an entire message before forwarding. Typical scenarios under which an
139-
intermediary might refuse are discussed in {{security-considerations}}.
144+
intermediary might refuse are discussed in {{security}}.
140145

141146
The request to use incremental forwarding also applies to HTTP implementations.
142147
Though most HTTP APIs provide the ability to incrementally transfer message content,
@@ -151,8 +156,8 @@ incrementally. Clients can rely on prior knowledge or probe for support on
151156
individual resources.
152157

153158
The Incremental header field facilitates the establishment of a bidirectional
154-
byte channel over HTTP, as its presence in both requests and responses instructs
155-
intermediaries to forward early responses ({{Section 7.5 of HTTP}}) and to
159+
byte channel over HTTP, as its presence in both requests and responses requests that
160+
intermediaries forward early responses ({{Section 7.5 of HTTP}}) and to
156161
transmit message contents incrementally in both directions. However, when developing
157162
bidirectional protocols over HTTP, Extended CONNECT {{?RFC8441}}{{?RFC9220}} is
158163
generally more consistent with HTTP's architecture.
@@ -162,13 +167,16 @@ value, but future documents might define parameters. Receivers MUST ignore
162167
unknown parameters.
163168

164169

165-
# Security Considerations
170+
# Security Considerations {#security}
166171

167172
When receiving a request or response that asks for incremental forwarding,
168173
intermediaries might reject the request due to security concerns. The following
169174
subsections explore typical scenarios under which the intermediaries might
170175
reject requests.
171176

177+
Note that rejecting requests based on the value of the Incremental field
178+
only occurs when an intermediary understands the field.
179+
172180

173181
## Permanent Rejection
174182

@@ -238,7 +246,7 @@ Reference:
238246

239247
Comments:
240248
: None
241-
{: spacing="compact"}
249+
{:compact}
242250

243251
An HTTP Proxy Error Type is registered in the HTTP Proxy Error Types registry as
244252
shown below:
@@ -261,6 +269,7 @@ Response Only Generated By Intermediaries:
261269

262270
Reference:
263271
: This document
272+
{:compact}
264273

265274
--- back
266275

0 commit comments

Comments
 (0)