Ignore:
Timestamp:
Sep 3, 2012, 3:12:40 PM (7 years ago)
Author:
fielding@…
Message:

(editorial) move Expect 100-continue discussion to p2

File:
1 edited

Legend:

Unmodified
Added
Removed
  • draft-ietf-httpbis/latest/p1-messaging.xml

    r1845 r1859  
    3434  <!ENTITY header-date            "<xref target='Part2' x:rel='#header.date' xmlns:x='http://purl.org/net/xml2rfc/ext'/>">
    3535  <!ENTITY header-etag            "<xref target='Part4' x:rel='#header.etag' xmlns:x='http://purl.org/net/xml2rfc/ext'/>">
    36   <!ENTITY header-expect          "<xref target='Part2' x:rel='#header.expect' xmlns:x='http://purl.org/net/xml2rfc/ext'/>">
    3736  <!ENTITY header-expires         "<xref target='Part6' x:rel='#header.expires' xmlns:x='http://purl.org/net/xml2rfc/ext'/>">
    3837  <!ENTITY header-last-modified   "<xref target='Part4' x:rel='#header.last-modified' xmlns:x='http://purl.org/net/xml2rfc/ext'/>">
     
    4847  <!ENTITY qvalue                 "<xref target='Part2' x:rel='#quality.values' xmlns:x='http://purl.org/net/xml2rfc/ext'/>">
    4948  <!ENTITY status-codes           "<xref target='Part2' x:rel='#status.codes' xmlns:x='http://purl.org/net/xml2rfc/ext'/>">
    50   <!ENTITY status-100             "<xref target='Part2' x:rel='#status.100' xmlns:x='http://purl.org/net/xml2rfc/ext'/>">
    5149  <!ENTITY status-1xx             "<xref target='Part2' x:rel='#status.1xx' xmlns:x='http://purl.org/net/xml2rfc/ext'/>">
    5250  <!ENTITY status-203             "<xref target='Part2' x:rel='#status.203' xmlns:x='http://purl.org/net/xml2rfc/ext'/>">
     
    5553  <!ENTITY status-4xx             "<xref target='Part2' x:rel='#status.4xx' xmlns:x='http://purl.org/net/xml2rfc/ext'/>">
    5654  <!ENTITY status-414             "<xref target='Part2' x:rel='#status.414' xmlns:x='http://purl.org/net/xml2rfc/ext'/>">
    57   <!ENTITY cons-new-header-fields "<xref target='Part2' x:rel='#considerations.for.creating.header.fields' xmlns:x='http://purl.org/net/xml2rfc/ext'/>">
     55  <!ENTITY cons-new-header-fields "<xref target='Part2' x:rel='#considerations.for.new.header.fields' xmlns:x='http://purl.org/net/xml2rfc/ext'/>">
    5856]>
    5957<?rfc toc="yes" ?>
     
    30103008</t>
    30113009</section>
    3012 </section>
    3013 
    3014 <section title="Use of the 100 (Continue) Status" anchor="use.of.the.100.status">
    3015 <t>
    3016    The purpose of the <x:ref>100 (Continue)</x:ref> status code (see &status-100;)
    3017    is to allow a client that is sending a request message with a request body
    3018    to determine if the origin server is willing to accept the request
    3019    (based on the request header fields) before the client sends the request
    3020    body. In some cases, it might either be inappropriate or highly
    3021    inefficient for the client to send the body if the server will reject
    3022    the message without looking at the body.
    3023 </t>
    3024 <t>
    3025    Requirements for HTTP/1.1 clients:
    3026   <list style="symbols">
    3027     <t>
    3028         If a client will wait for a <x:ref>100 (Continue)</x:ref> response before
    3029         sending the request body, it &MUST; send an <x:ref>Expect</x:ref> header
    3030         field (&header-expect;) with the "100-continue" expectation.
    3031     </t>
    3032     <t>
    3033         A client &MUST-NOT; send an <x:ref>Expect</x:ref> header field with
    3034         the "100-continue" expectation if it does not intend to send a request
    3035         body.
    3036     </t>
    3037   </list>
    3038 </t>
    3039 <t>
    3040    Because of the presence of older implementations, the protocol allows
    3041    ambiguous situations in which a client might send "Expect: 100-continue"
    3042    without receiving either a <x:ref>417 (Expectation Failed)</x:ref>
    3043    or a <x:ref>100 (Continue)</x:ref> status code. Therefore, when a client sends this
    3044    header field to an origin server (possibly via a proxy) from which it
    3045    has never seen a <x:ref>100 (Continue)</x:ref> status code, the client &SHOULD-NOT; 
    3046    wait for an indefinite period before sending the request body.
    3047 </t>
    3048 <t>
    3049    Requirements for HTTP/1.1 origin servers:
    3050   <list style="symbols">
    3051     <t> Upon receiving a request which includes an <x:ref>Expect</x:ref> header
    3052         field with the "100-continue" expectation, an origin server &MUST;
    3053         either respond with <x:ref>100 (Continue)</x:ref> status code and continue to read
    3054         from the input stream, or respond with a final status code. The
    3055         origin server &MUST-NOT; wait for the request body before sending
    3056         the <x:ref>100 (Continue)</x:ref> response. If it responds with a final status
    3057         code, it &MAY; close the transport connection or it &MAY; continue
    3058         to read and discard the rest of the request.  It &MUST-NOT;
    3059         perform the request method if it returns a final status code.
    3060     </t>
    3061     <t> An origin server &SHOULD-NOT;  send a <x:ref>100 (Continue)</x:ref> response if
    3062         the request message does not include an <x:ref>Expect</x:ref> header
    3063         field with the "100-continue" expectation, and &MUST-NOT; send a
    3064         <x:ref>100 (Continue)</x:ref> response if such a request comes from an HTTP/1.0
    3065         (or earlier) client. There is an exception to this rule: for
    3066         compatibility with <xref target="RFC2068"/>, a server &MAY; send a <x:ref>100 (Continue)</x:ref>
    3067         status code in response to an HTTP/1.1 PUT or POST request that does
    3068         not include an Expect header field with the "100-continue"
    3069         expectation. This exception, the purpose of which is
    3070         to minimize any client processing delays associated with an
    3071         undeclared wait for <x:ref>100 (Continue)</x:ref> status code, applies only to
    3072         HTTP/1.1 requests, and not to requests with any other HTTP-version
    3073         value.
    3074     </t>
    3075     <t> An origin server &MAY; omit a <x:ref>100 (Continue)</x:ref> response if it has
    3076         already received some or all of the request body for the
    3077         corresponding request.
    3078     </t>
    3079     <t> An origin server that sends a <x:ref>100 (Continue)</x:ref> response &MUST;
    3080         ultimately send a final status code, once the request body is
    3081         received and processed, unless it terminates the transport
    3082         connection prematurely.
    3083     </t>
    3084     <t> If an origin server receives a request that does not include an
    3085         <x:ref>Expect</x:ref> header field with the "100-continue" expectation,
    3086         the request includes a request body, and the server responds
    3087         with a final status code before reading the entire request body
    3088         from the transport connection, then the server &SHOULD-NOT;  close
    3089         the transport connection until it has read the entire request,
    3090         or until the client closes the connection. Otherwise, the client
    3091         might not reliably receive the response message. However, this
    3092         requirement ought not be construed as preventing a server from
    3093         defending itself against denial-of-service attacks, or from
    3094         badly broken client implementations.
    3095       </t>
    3096     </list>
    3097 </t>
    3098 <t>
    3099    Requirements for HTTP/1.1 proxies:
    3100   <list style="symbols">
    3101     <t> If a proxy receives a request that includes an <x:ref>Expect</x:ref>
    3102         header field with the "100-continue" expectation, and the proxy
    3103         either knows that the next-hop server complies with HTTP/1.1 or
    3104         higher, or does not know the HTTP version of the next-hop
    3105         server, it &MUST; forward the request, including the Expect header
    3106         field.
    3107     </t>
    3108     <t> If the proxy knows that the version of the next-hop server is
    3109         HTTP/1.0 or lower, it &MUST-NOT; forward the request, and it &MUST;
    3110         respond with a <x:ref>417 (Expectation Failed)</x:ref> status code.
    3111     </t>
    3112     <t> Proxies &SHOULD; maintain a record of the HTTP version
    3113         numbers received from recently-referenced next-hop servers.
    3114     </t>
    3115     <t> A proxy &MUST-NOT; forward a <x:ref>100 (Continue)</x:ref> response if the
    3116         request message was received from an HTTP/1.0 (or earlier)
    3117         client and did not include an <x:ref>Expect</x:ref> header field with
    3118         the "100-continue" expectation. This requirement overrides the
    3119         general rule for forwarding of <x:ref>1xx</x:ref> responses (see &status-1xx;).
    3120     </t>
    3121   </list>
    3122 </t>
    31233010</section>
    31243011
Note: See TracChangeset for help on using the changeset viewer.