Changeset 1696

Timestamp:

27/06/12 15:56:55 (11 years ago)

Author:

julian.reschke@…

Message:

Clarify etags, If-Match, and proxies vs origin servers (see #354)

Location:

draft-ietf-httpbis/latest

Files:

• p4-conditional.html (modified) (7 diffs)
• p4-conditional.xml (modified) (2 diffs)

draft-ietf-httpbis/latest/p4-conditional.html

@@ -449 +449 @@
   } 
   @bottom-center {
-       content: "Expires December 25, 2012"; 
+       content: "Expires December 29, 2012"; 
   } 
   @bottom-right {
@@ -490 +490 @@
       <meta name="dct.creator" content="Reschke, J. F.">
       <meta name="dct.identifier" content="urn:ietf:id:draft-ietf-httpbis-p4-conditional-latest">
-      <meta name="dct.issued" scheme="ISO8601" content="2012-06-23">
+      <meta name="dct.issued" scheme="ISO8601" content="2012-06-27">
       <meta name="dct.replaces" content="urn:ietf:rfc:2616">
       <meta name="dct.abstract" content="The Hypertext Transfer Protocol (HTTP) is an application-level protocol for distributed, collaborative, hypertext information systems. HTTP has been in use by the World Wide Web global information initiative since 1990. This document is Part 4 of the seven-part specification that defines the protocol referred to as &#34;HTTP/1.1&#34; and, taken together, obsoletes RFC 2616. Part 4 defines request header fields for indicating conditional requests and the rules for constructing responses to those requests.">
@@ -516 +516 @@
             </tr>
             <tr>
-               <td class="left">Expires: December 25, 2012</td>
+               <td class="left">Expires: December 29, 2012</td>
                <td class="right">J. Reschke, Editor</td>
             </tr>
@@ -525 +525 @@
             <tr>
                <td class="left"></td>
-               <td class="right">June 23, 2012</td>
+               <td class="right">June 27, 2012</td>
             </tr>
          </tbody>
@@ -555 +555 @@
          in progress”.
       </p>
-      <p>This Internet-Draft will expire on December 25, 2012.</p>
+      <p>This Internet-Draft will expire on December 29, 2012.</p>
       <h1><a id="rfc.copyrightnotice" href="#rfc.copyrightnotice">Copyright Notice</a></h1>
       <p>Copyright © 2012 IETF Trust and the persons identified as the document authors. All rights reserved.</p>
@@ -989 +989 @@
          exists for the target resource, then the server <em class="bcp14">MAY</em> perform the request method as if the If-Match header field was not present.
       </p>
-      <p id="rfc.section.3.1.p.4">If none of the entity-tags match, or if "*" is given and no current representation exists, the server <em class="bcp14">MUST NOT</em> perform the requested method. Instead, the server <em class="bcp14">MUST</em> respond with the 412 (Precondition Failed) status code.
-      </p>
-      <p id="rfc.section.3.1.p.5">If the request would, without the If-Match header field, result in anything other than a 2xx or 412 status code, then the
+      <p id="rfc.section.3.1.p.4">Origin servers <em class="bcp14">MUST NOT</em> perform the requested method if none of the entity-tags match, or if "*" is given and no current representation exists; instead
+         they <em class="bcp14">MUST</em> respond with the 412 (Precondition Failed) status code.
+      </p>
+      <p id="rfc.section.3.1.p.5">Proxy servers using a cached response as the selected representation <em class="bcp14">MUST NOT</em> perform the requested method if none of the entity-tags match, or if "*" is given and no current representation exists; instead,
+         they <em class="bcp14">MUST</em> forward the request towards the origin server.
+      </p>
+      <p id="rfc.section.3.1.p.6">If the request would, without the If-Match header field, result in anything other than a 2xx or 412 status code, then the
          If-Match header field <em class="bcp14">MUST</em> be ignored.
       </p>
-      <p id="rfc.section.3.1.p.6">Examples:</p>
+      <p id="rfc.section.3.1.p.7">Examples:</p>
       <div id="rfc.figure.u.10"></div><pre class="text">  If-Match: "xyzzy"
   If-Match: "xyzzy", "r2d2xxxx", "c3piozzzz"
   If-Match: *
-</pre><p id="rfc.section.3.1.p.8">The result of a request having both an If-Match header field and either an If-None-Match or an If-Modified-Since header field
+</pre><p id="rfc.section.3.1.p.9">The result of a request having both an If-Match header field and either an If-None-Match or an If-Modified-Since header field
          is undefined by this specification.
       </p>
@@ -1343 +1347 @@
       <p id="rfc.section.C.1.p.1">Closed issues: </p>
       <ul>
+         <li> &lt;<a href="http://tools.ietf.org/wg/httpbis/trac/ticket/354">http://tools.ietf.org/wg/httpbis/trac/ticket/354</a>&gt;: "ETags and Conditional Requests"
+         </li>
          <li> &lt;<a href="http://tools.ietf.org/wg/httpbis/trac/ticket/361">http://tools.ietf.org/wg/httpbis/trac/ticket/361</a>&gt;: "ABNF requirements for recipients"
          </li>

draft-ietf-httpbis/latest/p4-conditional.xml

@@ -758 +758 @@
 </t>
 <t>
-   If none of the entity-tags match, or if "*" is given and no current
-   representation exists, the server &MUST-NOT; perform the requested method.
-   Instead, the server &MUST; respond with the 412 (Precondition Failed)
+   Origin servers &MUST-NOT; perform the requested method if none of the
+   entity-tags match, or if "*" is given and no current representation
+   exists; instead they &MUST; respond with the 412 (Precondition Failed)
    status code.
+</t>
+<t>
+   Proxy servers using a cached response as the selected representation
+   &MUST-NOT; perform the requested method if none of the entity-tags match,
+   or if "*" is given and no current representation exists; instead, they
+   &MUST; forward the request towards the origin server.
 </t>
 <t>
@@ -1412 +1418 @@
   <list style="symbols"> 
     <t>
+      <eref target="http://tools.ietf.org/wg/httpbis/trac/ticket/354"/>:
+      "ETags and Conditional Requests"
+    </t>
+    <t>
       <eref target="http://tools.ietf.org/wg/httpbis/trac/ticket/361"/>:
       "ABNF requirements for recipients"