Changeset 1896 for draft-ietf-httpbis/latest/p6-cache.html
- Timestamp:
- 15/09/12 10:06:59 (10 years ago)
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
draft-ietf-httpbis/latest/p6-cache.html
r1894 r1896 1213 1213 </pre><p id="rfc.section.7.2.p.7">For the cache directives defined below, no argument is defined (nor allowed) otherwise stated otherwise.</p> 1214 1214 <h3 id="rfc.section.7.2.1"><a href="#rfc.section.7.2.1">7.2.1</a> <a id="cache-request-directive" href="#cache-request-directive">Request Cache-Control Directives</a></h3> 1215 <div id="rfc.iref.c.7"></div>1216 1215 <div id="rfc.iref.n.1"></div> 1217 1216 <h4 id="rfc.section.7.2.1.1"><a href="#rfc.section.7.2.1.1">7.2.1.1</a> <a id="cache-request-directive.no-cache" href="#cache-request-directive.no-cache">no-cache</a></h4> 1218 1217 <p id="rfc.section.7.2.1.1.p.1">The "no-cache" request directive indicates that a cache <em class="bcp14">MUST NOT</em> use a stored response to satisfy the request without successful validation on the origin server. 1219 1218 </p> 1220 <div id="rfc.iref.c.8"></div>1221 1219 <div id="rfc.iref.n.2"></div> 1222 1220 <h4 id="rfc.section.7.2.1.2"><a href="#rfc.section.7.2.1.2">7.2.1.2</a> <a id="cache-request-directive.no-store" href="#cache-request-directive.no-store">no-store</a></h4> … … 1229 1227 to the already stored response. 1230 1228 </p> 1231 <div id="rfc.iref.c.9"></div>1232 1229 <div id="rfc.iref.m.1"></div> 1233 1230 <h4 id="rfc.section.7.2.1.3"><a href="#rfc.section.7.2.1.3">7.2.1.3</a> <a id="cache-request-directive.max-age" href="#cache-request-directive.max-age">max-age</a></h4> … … 1243 1240 <p id="rfc.section.7.2.1.3.p.3"> <b>Note:</b> This directive uses the token form of the argument syntax; e.g., 'max-age=5', not 'max-age="5"'. Senders <em class="bcp14">SHOULD NOT</em> use the quoted-string form. 1244 1241 </p> 1245 <div id="rfc.iref.c.10"></div>1246 1242 <div id="rfc.iref.m.2"></div> 1247 1243 <h4 id="rfc.section.7.2.1.4"><a href="#rfc.section.7.2.1.4">7.2.1.4</a> <a id="cache-request-directive.max-stale" href="#cache-request-directive.max-stale">max-stale</a></h4> … … 1258 1254 <p id="rfc.section.7.2.1.4.p.3"> <b>Note:</b> This directive uses the token form of the argument syntax; e.g., 'max-stale=10', not 'max-stale="10"'. Senders <em class="bcp14">SHOULD NOT</em> use the quoted-string form. 1259 1255 </p> 1260 <div id="rfc.iref.c.11"></div>1261 1256 <div id="rfc.iref.m.3"></div> 1262 1257 <h4 id="rfc.section.7.2.1.5"><a href="#rfc.section.7.2.1.5">7.2.1.5</a> <a id="cache-request-directive.min-fresh" href="#cache-request-directive.min-fresh">min-fresh</a></h4> … … 1272 1267 <p id="rfc.section.7.2.1.5.p.3"> <b>Note:</b> This directive uses the token form of the argument syntax; e.g., 'min-fresh=20', not 'min-fresh="20"'. Senders <em class="bcp14">SHOULD NOT</em> use the quoted-string form. 1273 1268 </p> 1274 <div id="rfc.iref.c.12"></div>1275 1269 <div id="rfc.iref.n.3"></div> 1276 1270 <h4 id="rfc.section.7.2.1.6"><a href="#rfc.section.7.2.1.6">7.2.1.6</a> <a id="cache-request-directive.no-transform" href="#cache-request-directive.no-transform">no-transform</a></h4> 1277 1271 <p id="rfc.section.7.2.1.6.p.1">The "no-transform" request directive indicates that an intermediary (whether or not it implements a cache) <em class="bcp14">MUST NOT</em> change the <a href="p2-semantics.html#header.content-encoding" class="smpl">Content-Encoding</a>, <a href="p5-range.html#header.content-range" class="smpl">Content-Range</a> or <a href="p2-semantics.html#header.content-type" class="smpl">Content-Type</a> request header fields, nor the request representation. 1278 1272 </p> 1279 <div id="rfc.iref.c.13"></div>1280 1273 <div id="rfc.iref.o.1"></div> 1281 1274 <h4 id="rfc.section.7.2.1.7"><a href="#rfc.section.7.2.1.7">7.2.1.7</a> <a id="cache-request-directive.only-if-cached" href="#cache-request-directive.only-if-cached">only-if-cached</a></h4> … … 1285 1278 </p> 1286 1279 <h3 id="rfc.section.7.2.2"><a href="#rfc.section.7.2.2">7.2.2</a> <a id="cache-response-directive" href="#cache-response-directive">Response Cache-Control Directives</a></h3> 1287 <div id="rfc.iref.c.14"></div>1288 1280 <div id="rfc.iref.p.2"></div> 1289 1281 <h4 id="rfc.section.7.2.2.1"><a href="#rfc.section.7.2.2.1">7.2.2.1</a> <a id="cache-response-directive.only-if-cached" href="#cache-response-directive.only-if-cached">public</a></h4> 1290 1282 <p id="rfc.section.7.2.2.1.p.1">The "public" response directive indicates that a response whose associated request contains an 'Authentication' header <em class="bcp14">MAY</em> be stored (see <a href="#caching.authenticated.responses" title="Storing Responses to Authenticated Requests">Section 3.2</a>). 1291 1283 </p> 1292 <div id="rfc.iref.c.15"></div>1293 1284 <div id="rfc.iref.p.3"></div> 1294 1285 <h4 id="rfc.section.7.2.2.2"><a href="#rfc.section.7.2.2.2">7.2.2.2</a> <a id="cache-response-directive.private" href="#cache-response-directive.private">private</a></h4> … … 1312 1303 <p id="rfc.section.7.2.2.2.p.6"> <b>Note:</b> This directive uses the quoted-string form of the argument syntax. Senders <em class="bcp14">SHOULD NOT</em> use the token form (even if quoting appears not to be needed for single-entry lists). 1313 1304 </p> 1314 <div id="rfc.iref.c.16"></div>1315 1305 <div id="rfc.iref.n.4"></div> 1316 1306 <h4 id="rfc.section.7.2.2.3"><a href="#rfc.section.7.2.2.3">7.2.2.3</a> <a id="cache-response-directive.no-cache" href="#cache-response-directive.no-cache">no-cache</a></h4> … … 1337 1327 <p id="rfc.section.7.2.2.3.p.6"> <b>Note:</b> This directive uses the quoted-string form of the argument syntax. Senders <em class="bcp14">SHOULD NOT</em> use the token form (even if quoting appears not to be needed for single-entry lists). 1338 1328 </p> 1339 <div id="rfc.iref.c.17"></div>1340 1329 <div id="rfc.iref.n.5"></div> 1341 1330 <h4 id="rfc.section.7.2.2.4"><a href="#rfc.section.7.2.2.4">7.2.2.4</a> <a id="cache-response-directive.no-store" href="#cache-response-directive.no-store">no-store</a></h4> … … 1345 1334 might not recognize or obey this directive, and communications networks might be vulnerable to eavesdropping. 1346 1335 </p> 1347 <div id="rfc.iref.c.18"></div>1348 1336 <div id="rfc.iref.m.4"></div> 1349 1337 <h4 id="rfc.section.7.2.2.5"><a href="#rfc.section.7.2.2.5">7.2.2.5</a> <a id="cache-response-directive.must-revalidate" href="#cache-response-directive.must-revalidate">must-revalidate</a></h4> … … 1356 1344 could result in incorrect operation, such as a silently unexecuted financial transaction. 1357 1345 </p> 1358 <div id="rfc.iref.c.19"></div>1359 1346 <div id="rfc.iref.p.4"></div> 1360 1347 <h4 id="rfc.section.7.2.2.6"><a href="#rfc.section.7.2.2.6">7.2.2.6</a> <a id="cache-response-directive.proxy-revalidate" href="#cache-response-directive.proxy-revalidate">proxy-revalidate</a></h4> … … 1362 1349 not apply to private caches. 1363 1350 </p> 1364 <div id="rfc.iref.c.20"></div>1365 1351 <div id="rfc.iref.m.5"></div> 1366 1352 <h4 id="rfc.section.7.2.2.7"><a href="#rfc.section.7.2.2.7">7.2.2.7</a> <a id="cache-response-directive.max-age" href="#cache-response-directive.max-age">max-age</a></h4> … … 1375 1361 <p id="rfc.section.7.2.2.7.p.3"> <b>Note:</b> This directive uses the token form of the argument syntax; e.g., 'max-age=5', not 'max-age="5"'. Senders <em class="bcp14">SHOULD NOT</em> use the quoted-string form. 1376 1362 </p> 1377 <div id="rfc.iref.c.21"></div>1378 1363 <div id="rfc.iref.s.4"></div> 1379 1364 <h4 id="rfc.section.7.2.2.8"><a href="#rfc.section.7.2.2.8">7.2.2.8</a> <a id="cache-response-directive.s-maxage" href="#cache-response-directive.s-maxage">s-maxage</a></h4> … … 1388 1373 <p id="rfc.section.7.2.2.8.p.3"> <b>Note:</b> This directive uses the token form of the argument syntax; e.g., 's-maxage=10', not 's-maxage="10"'. Senders <em class="bcp14">SHOULD NOT</em> use the quoted-string form. 1389 1374 </p> 1390 <div id="rfc.iref.c.22"></div>1391 1375 <div id="rfc.iref.n.6"></div> 1392 1376 <h4 id="rfc.section.7.2.2.9"><a href="#rfc.section.7.2.2.9">7.2.2.9</a> <a id="cache-response-directive.no-transform" href="#cache-response-directive.no-transform">no-transform</a></h4> … … 1543 1527 of its meaning. 1544 1528 </p> 1545 <div id="rfc.iref. 68"></div>1529 <div id="rfc.iref.52"></div> 1546 1530 <div id="rfc.iref.w.2"></div> 1547 1531 <h3 id="rfc.section.7.5.1"><a href="#rfc.section.7.5.1">7.5.1</a> <a id="warn.110" href="#warn.110">110 Response is Stale</a></h3> 1548 1532 <p id="rfc.section.7.5.1.p.1">A cache <em class="bcp14">SHOULD</em> include this whenever the returned response is stale. 1549 1533 </p> 1550 <div id="rfc.iref. 69"></div>1534 <div id="rfc.iref.53"></div> 1551 1535 <div id="rfc.iref.w.3"></div> 1552 1536 <h3 id="rfc.section.7.5.2"><a href="#rfc.section.7.5.2">7.5.2</a> <a id="warn.111" href="#warn.111">111 Revalidation Failed</a></h3> … … 1554 1538 the server. 1555 1539 </p> 1556 <div id="rfc.iref. 70"></div>1540 <div id="rfc.iref.54"></div> 1557 1541 <div id="rfc.iref.w.4"></div> 1558 1542 <h3 id="rfc.section.7.5.3"><a href="#rfc.section.7.5.3">7.5.3</a> <a id="warn.112" href="#warn.112">112 Disconnected Operation</a></h3> 1559 1543 <p id="rfc.section.7.5.3.p.1">A cache <em class="bcp14">SHOULD</em> include this if it is intentionally disconnected from the rest of the network for a period of time. 1560 1544 </p> 1561 <div id="rfc.iref. 71"></div>1545 <div id="rfc.iref.55"></div> 1562 1546 <div id="rfc.iref.w.5"></div> 1563 1547 <h3 id="rfc.section.7.5.4"><a href="#rfc.section.7.5.4">7.5.4</a> <a id="warn.113" href="#warn.113">113 Heuristic Expiration</a></h3> … … 1565 1549 hours. 1566 1550 </p> 1567 <div id="rfc.iref. 72"></div>1551 <div id="rfc.iref.56"></div> 1568 1552 <div id="rfc.iref.w.6"></div> 1569 1553 <h3 id="rfc.section.7.5.5"><a href="#rfc.section.7.5.5">7.5.5</a> <a id="warn.199" href="#warn.199">199 Miscellaneous Warning</a></h3> 1570 1554 <p id="rfc.section.7.5.5.p.1">The warning text can include arbitrary information to be presented to a human user, or logged. A system receiving this warning <em class="bcp14">MUST NOT</em> take any automated action, besides presenting the warning to the user. 1571 1555 </p> 1572 <div id="rfc.iref. 73"></div>1556 <div id="rfc.iref.57"></div> 1573 1557 <div id="rfc.iref.w.7"></div> 1574 1558 <h3 id="rfc.section.7.5.6"><a href="#rfc.section.7.5.6">7.5.6</a> <a id="warn.214" href="#warn.214">214 Transformation Applied</a></h3> … … 1576 1560 or modifying the representation data, unless this Warning code already appears in the response. 1577 1561 </p> 1578 <div id="rfc.iref. 74"></div>1562 <div id="rfc.iref.58"></div> 1579 1563 <div id="rfc.iref.w.8"></div> 1580 1564 <h3 id="rfc.section.7.5.7"><a href="#rfc.section.7.5.7">7.5.7</a> <a id="warn.299" href="#warn.299">299 Miscellaneous Persistent Warning</a></h3> … … 2028 2012 <ul class="ind"> 2029 2013 <li><a id="rfc.index.1" href="#rfc.index.1"><b>1</b></a><ul> 2030 <li>110 Response is Stale (warn code) <a href="#rfc.iref. 68"><b>7.5.1</b></a>, <a href="#rfc.xref.warn.110.1">9.2</a></li>2031 <li>111 Revalidation Failed (warn code) <a href="#rfc.iref. 69"><b>7.5.2</b></a>, <a href="#rfc.xref.warn.111.1">9.2</a></li>2032 <li>112 Disconnected Operation (warn code) <a href="#rfc.iref. 70"><b>7.5.3</b></a>, <a href="#rfc.xref.warn.112.1">9.2</a></li>2033 <li>113 Heuristic Expiration (warn code) <a href="#rfc.iref. 71"><b>7.5.4</b></a>, <a href="#rfc.xref.warn.113.1">9.2</a></li>2034 <li>199 Miscellaneous Warning (warn code) <a href="#rfc.iref. 72"><b>7.5.5</b></a>, <a href="#rfc.xref.warn.199.1">9.2</a></li>2014 <li>110 Response is Stale (warn code) <a href="#rfc.iref.52"><b>7.5.1</b></a>, <a href="#rfc.xref.warn.110.1">9.2</a></li> 2015 <li>111 Revalidation Failed (warn code) <a href="#rfc.iref.53"><b>7.5.2</b></a>, <a href="#rfc.xref.warn.111.1">9.2</a></li> 2016 <li>112 Disconnected Operation (warn code) <a href="#rfc.iref.54"><b>7.5.3</b></a>, <a href="#rfc.xref.warn.112.1">9.2</a></li> 2017 <li>113 Heuristic Expiration (warn code) <a href="#rfc.iref.55"><b>7.5.4</b></a>, <a href="#rfc.xref.warn.113.1">9.2</a></li> 2018 <li>199 Miscellaneous Warning (warn code) <a href="#rfc.iref.56"><b>7.5.5</b></a>, <a href="#rfc.xref.warn.199.1">9.2</a></li> 2035 2019 </ul> 2036 2020 </li> 2037 2021 <li><a id="rfc.index.2" href="#rfc.index.2"><b>2</b></a><ul> 2038 <li>214 Transformation Applied (warn code) <a href="#rfc.iref. 73"><b>7.5.6</b></a>, <a href="#rfc.xref.warn.214.1">9.2</a></li>2039 <li>299 Miscellaneous Persistent Warning (warn code) <a href="#rfc.iref. 74"><b>7.5.7</b></a>, <a href="#rfc.xref.warn.299.1">9.2</a></li>2022 <li>214 Transformation Applied (warn code) <a href="#rfc.iref.57"><b>7.5.6</b></a>, <a href="#rfc.xref.warn.214.1">9.2</a></li> 2023 <li>299 Miscellaneous Persistent Warning (warn code) <a href="#rfc.iref.58"><b>7.5.7</b></a>, <a href="#rfc.xref.warn.299.1">9.2</a></li> 2040 2024 </ul> 2041 2025 </li> … … 2047 2031 <li><a id="rfc.index.C" href="#rfc.index.C"><b>C</b></a><ul> 2048 2032 <li>cache <a href="#rfc.iref.c.1">1.1</a>, <a href="#rfc.iref.c.2">1.2</a></li> 2049 <li>Cache Directives 2050 <ul>2051 <li>max-age <a href="#rfc.iref.c.9"><b>7.2.1.3</b></a>, <a href="#rfc.iref.c.20"><b>7.2.2.7</b></a></li>2052 <li>max-stale <a href="#rfc.iref.c.10"><b>7.2.1.4</b></a></li>2053 <li>min-fresh <a href="#rfc.iref.c.11"><b>7.2.1.5</b></a></li>2054 <li>must-revalidate <a href="#rfc.iref.c.18"><b>7.2.2.5</b></a></li>2055 <li>no-cache <a href="#rfc.iref.c.7"><b>7.2.1.1</b></a>, <a href="#rfc.iref.c.16"><b>7.2.2.3</b></a></li>2056 <li>no-store <a href="#rfc.iref.c.8"><b>7.2.1.2</b></a>, <a href="#rfc.iref.c.17"><b>7.2.2.4</b></a></li>2057 <li>no-transform <a href="#rfc.iref.c.12"><b>7.2.1.6</b></a>, <a href="#rfc.iref.c.22"><b>7.2.2.9</b></a></li>2058 <li>only-if-cached <a href="#rfc.iref.c.13"><b>7.2.1.7</b></a></li>2059 <li>private <a href="#rfc.iref.c.15"><b>7.2.2.2</b></a></li>2060 <li>proxy-revalidate <a href="#rfc.iref.c.19"><b>7.2.2.6</b></a></li>2061 <li>public <a href="#rfc.iref.c.14"><b>7.2.2.1</b></a></li>2062 <li>s-maxage <a href="#rfc.iref.c.21"><b>7.2.2.8</b></a></li>2063 </ul>2064 </li>2065 2033 <li>cache entry <a href="#rfc.iref.c.4">2</a></li> 2066 2034 <li>cache key <a href="#rfc.iref.c.5">2</a></li> … … 2106 2074 </li> 2107 2075 <li><a id="rfc.index.M" href="#rfc.index.M"><b>M</b></a><ul> 2108 <li>max-age 2109 <ul> 2110 <li>Cache Directive <a href="#rfc.iref.m.1"><b>7.2.1.3</b></a>, <a href="#rfc.iref.m.5"><b>7.2.2.7</b></a></li> 2111 </ul> 2112 </li> 2113 <li>max-stale 2114 <ul> 2115 <li>Cache Directive <a href="#rfc.iref.m.2"><b>7.2.1.4</b></a></li> 2116 </ul> 2117 </li> 2118 <li>min-fresh 2119 <ul> 2120 <li>Cache Directive <a href="#rfc.iref.m.3"><b>7.2.1.5</b></a></li> 2121 </ul> 2122 </li> 2123 <li>must-revalidate 2124 <ul> 2125 <li>Cache Directive <a href="#rfc.iref.m.4"><b>7.2.2.5</b></a></li> 2126 </ul> 2127 </li> 2076 <li>max-age (cache directive) <a href="#rfc.iref.m.1"><b>7.2.1.3</b></a>, <a href="#rfc.iref.m.5"><b>7.2.2.7</b></a></li> 2077 <li>max-stale (cache directive) <a href="#rfc.iref.m.2"><b>7.2.1.4</b></a></li> 2078 <li>min-fresh (cache directive) <a href="#rfc.iref.m.3"><b>7.2.1.5</b></a></li> 2079 <li>must-revalidate (cache directive) <a href="#rfc.iref.m.4"><b>7.2.2.5</b></a></li> 2128 2080 </ul> 2129 2081 </li> 2130 2082 <li><a id="rfc.index.N" href="#rfc.index.N"><b>N</b></a><ul> 2131 <li>no-cache 2132 <ul> 2133 <li>Cache Directive <a href="#rfc.iref.n.1"><b>7.2.1.1</b></a>, <a href="#rfc.iref.n.4"><b>7.2.2.3</b></a></li> 2134 </ul> 2135 </li> 2136 <li>no-store 2137 <ul> 2138 <li>Cache Directive <a href="#rfc.iref.n.2"><b>7.2.1.2</b></a>, <a href="#rfc.iref.n.5"><b>7.2.2.4</b></a></li> 2139 </ul> 2140 </li> 2141 <li>no-transform 2142 <ul> 2143 <li>Cache Directive <a href="#rfc.iref.n.3"><b>7.2.1.6</b></a>, <a href="#rfc.iref.n.6"><b>7.2.2.9</b></a></li> 2144 </ul> 2145 </li> 2083 <li>no-cache (cache directive) <a href="#rfc.iref.n.1"><b>7.2.1.1</b></a>, <a href="#rfc.iref.n.4"><b>7.2.2.3</b></a></li> 2084 <li>no-store (cache directive) <a href="#rfc.iref.n.2"><b>7.2.1.2</b></a>, <a href="#rfc.iref.n.5"><b>7.2.2.4</b></a></li> 2085 <li>no-transform (cache directive) <a href="#rfc.iref.n.3"><b>7.2.1.6</b></a>, <a href="#rfc.iref.n.6"><b>7.2.2.9</b></a></li> 2146 2086 </ul> 2147 2087 </li> 2148 2088 <li><a id="rfc.index.O" href="#rfc.index.O"><b>O</b></a><ul> 2149 <li>only-if-cached 2150 <ul> 2151 <li>Cache Directive <a href="#rfc.iref.o.1"><b>7.2.1.7</b></a></li> 2152 </ul> 2153 </li> 2089 <li>only-if-cached (cache directive) <a href="#rfc.iref.o.1"><b>7.2.1.7</b></a></li> 2154 2090 </ul> 2155 2091 </li> … … 2191 2127 </li> 2192 2128 <li>Pragma header field <a href="#rfc.xref.header.pragma.1">4</a>, <a href="#rfc.xref.header.pragma.2">7.2</a>, <a href="#rfc.iref.p.5"><b>7.4</b></a>, <a href="#rfc.xref.header.pragma.3">9.3</a></li> 2193 <li>private 2194 <ul> 2195 <li>Cache Directive <a href="#rfc.iref.p.3"><b>7.2.2.2</b></a></li> 2196 </ul> 2197 </li> 2129 <li>private (cache directive) <a href="#rfc.iref.p.3"><b>7.2.2.2</b></a></li> 2198 2130 <li>private cache <a href="#rfc.iref.p.1">1.2</a></li> 2199 <li>proxy-revalidate 2200 <ul> 2201 <li>Cache Directive <a href="#rfc.iref.p.4"><b>7.2.2.6</b></a></li> 2202 </ul> 2203 </li> 2204 <li>public 2205 <ul> 2206 <li>Cache Directive <a href="#rfc.iref.p.2"><b>7.2.2.1</b></a></li> 2207 </ul> 2208 </li> 2131 <li>proxy-revalidate (cache directive) <a href="#rfc.iref.p.4"><b>7.2.2.6</b></a></li> 2132 <li>public (cache directive) <a href="#rfc.iref.p.2"><b>7.2.2.1</b></a></li> 2209 2133 </ul> 2210 2134 </li> … … 2234 2158 </li> 2235 2159 <li><a id="rfc.index.S" href="#rfc.index.S"><b>S</b></a><ul> 2236 <li>s-maxage 2237 <ul> 2238 <li>Cache Directive <a href="#rfc.iref.s.4"><b>7.2.2.8</b></a></li> 2239 </ul> 2240 </li> 2160 <li>s-maxage (cache directive) <a href="#rfc.iref.s.4"><b>7.2.2.8</b></a></li> 2241 2161 <li>shared cache <a href="#rfc.iref.s.1">1.2</a></li> 2242 2162 <li>stale <a href="#rfc.iref.s.2">1.2</a></li>
Note: See TracChangeset
for help on using the changeset viewer.