Changeset 817 for draft-ietf-httpbis/latest/p6-cache.html
- Timestamp:
- 07/05/10 14:20:31 (12 years ago)
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
draft-ietf-httpbis/latest/p6-cache.html
r816 r817 581 581 <li class="tocline0">4. <a href="#history.lists">History Lists</a></li> 582 582 <li class="tocline0">5. <a href="#IANA.considerations">IANA Considerations</a><ul class="toc"> 583 <li class="tocline1">5.1 <a href="#message.header.registration">Message Header Registration</a></li> 583 <li class="tocline1">5.1 <a href="#cache.directive.registration">Cache Directive Registry</a></li> 584 <li class="tocline1">5.2 <a href="#message.header.registration">Message Header Registration</a></li> 584 585 </ul> 585 586 </li> … … 1233 1234 cache does not understand the extension(s). 1234 1235 </p> 1236 <p id="rfc.section.3.2.3.p.7">The HTTP Cache Directive Registry defines the name space for the cache directives.</p> 1237 <p id="rfc.section.3.2.3.p.8">Registrations <em class="bcp14">MUST</em> include the following fields: 1238 </p> 1239 <ul> 1240 <li>Cache Directive Name</li> 1241 <li>Pointer to specification text</li> 1242 </ul> 1243 <p id="rfc.section.3.2.3.p.9">Values to be added to this name space are subject to IETF review (<a href="#RFC5226" id="rfc.xref.RFC5226.1"><cite title="Guidelines for Writing an IANA Considerations Section in RFCs">[RFC5226]</cite></a>, <a href="http://tools.ietf.org/html/rfc5226#section-4.1">Section 4.1</a>). 1244 </p> 1245 <p id="rfc.section.3.2.3.p.10">The registry itself is maintained at <<a href="http://www.iana.org/assignments/http-cache-directives">http://www.iana.org/assignments/http-cache-directives</a>>. 1246 </p> 1235 1247 <div id="rfc.iref.e.2"></div> 1236 1248 <div id="rfc.iref.h.4"></div> … … 1402 1414 </p> 1403 1415 <h1 id="rfc.section.5"><a href="#rfc.section.5">5.</a> <a id="IANA.considerations" href="#IANA.considerations">IANA Considerations</a></h1> 1404 <h2 id="rfc.section.5.1"><a href="#rfc.section.5.1">5.1</a> <a id="message.header.registration" href="#message.header.registration">Message Header Registration</a></h2> 1405 <p id="rfc.section.5.1.p.1">The Message Header Registry located at <<a href="http://www.iana.org/assignments/message-headers/message-header-index.html">http://www.iana.org/assignments/message-headers/message-header-index.html</a>> should be updated with the permanent registrations below (see <a href="#RFC3864" id="rfc.xref.RFC3864.1"><cite title="Registration Procedures for Message Header Fields">[RFC3864]</cite></a>): 1416 <h2 id="rfc.section.5.1"><a href="#rfc.section.5.1">5.1</a> <a id="cache.directive.registration" href="#cache.directive.registration">Cache Directive Registry</a></h2> 1417 <p id="rfc.section.5.1.p.1">The registration procedure for HTTP Cache Directives is defined by <a href="#cache.control.extensions" title="Cache Control Extensions">Section 3.2.3</a> of this document. 1418 </p> 1419 <p id="rfc.section.5.1.p.2">The HTTP Cache Directive Registry should be created at <<a href="http://www.iana.org/assignments/http-cache-directives">http://www.iana.org/assignments/http-cache-directives</a>> and be populated with the registrations below: 1406 1420 </p> 1407 1421 <div id="rfc.table.1"> 1422 <div id="iana.cache.directive.registration.table"></div> 1423 <table class="tt full left" cellpadding="3" cellspacing="0"> 1424 <thead> 1425 <tr> 1426 <th>Cache Directive</th> 1427 <th>Reference</th> 1428 </tr> 1429 </thead> 1430 <tbody> 1431 <tr> 1432 <td class="left">max-age</td> 1433 <td class="left"> <a href="#cache-request-directive" title="Request Cache-Control Directives">Section 3.2.1</a>, <a href="#cache-response-directive" title="Response Cache-Control Directives">Section 3.2.2</a> 1434 </td> 1435 </tr> 1436 <tr> 1437 <td class="left">max-stale</td> 1438 <td class="left"> <a href="#cache-request-directive" title="Request Cache-Control Directives">Section 3.2.1</a> 1439 </td> 1440 </tr> 1441 <tr> 1442 <td class="left">min-fresh</td> 1443 <td class="left"> <a href="#cache-request-directive" title="Request Cache-Control Directives">Section 3.2.1</a> 1444 </td> 1445 </tr> 1446 <tr> 1447 <td class="left">must-revalidate</td> 1448 <td class="left"> <a href="#cache-response-directive" title="Response Cache-Control Directives">Section 3.2.2</a> 1449 </td> 1450 </tr> 1451 <tr> 1452 <td class="left">no-cache</td> 1453 <td class="left"> <a href="#cache-request-directive" title="Request Cache-Control Directives">Section 3.2.1</a>, <a href="#cache-response-directive" title="Response Cache-Control Directives">Section 3.2.2</a> 1454 </td> 1455 </tr> 1456 <tr> 1457 <td class="left">no-store</td> 1458 <td class="left"> <a href="#cache-request-directive" title="Request Cache-Control Directives">Section 3.2.1</a>, <a href="#cache-response-directive" title="Response Cache-Control Directives">Section 3.2.2</a> 1459 </td> 1460 </tr> 1461 <tr> 1462 <td class="left">no-transform</td> 1463 <td class="left"> <a href="#cache-request-directive" title="Request Cache-Control Directives">Section 3.2.1</a>, <a href="#cache-response-directive" title="Response Cache-Control Directives">Section 3.2.2</a> 1464 </td> 1465 </tr> 1466 <tr> 1467 <td class="left">only-if-cached</td> 1468 <td class="left"> <a href="#cache-request-directive" title="Request Cache-Control Directives">Section 3.2.1</a> 1469 </td> 1470 </tr> 1471 <tr> 1472 <td class="left">private</td> 1473 <td class="left"> <a href="#cache-response-directive" title="Response Cache-Control Directives">Section 3.2.2</a> 1474 </td> 1475 </tr> 1476 <tr> 1477 <td class="left">proxy-revalidate</td> 1478 <td class="left"> <a href="#cache-response-directive" title="Response Cache-Control Directives">Section 3.2.2</a> 1479 </td> 1480 </tr> 1481 <tr> 1482 <td class="left">public</td> 1483 <td class="left"> <a href="#cache-response-directive" title="Response Cache-Control Directives">Section 3.2.2</a> 1484 </td> 1485 </tr> 1486 <tr> 1487 <td class="left">s-maxage</td> 1488 <td class="left"> <a href="#cache-response-directive" title="Response Cache-Control Directives">Section 3.2.2</a> 1489 </td> 1490 </tr> 1491 </tbody> 1492 </table> 1493 </div> 1494 <h2 id="rfc.section.5.2"><a href="#rfc.section.5.2">5.2</a> <a id="message.header.registration" href="#message.header.registration">Message Header Registration</a></h2> 1495 <p id="rfc.section.5.2.p.1">The Message Header Registry located at <<a href="http://www.iana.org/assignments/message-headers/message-header-index.html">http://www.iana.org/assignments/message-headers/message-header-index.html</a>> should be updated with the permanent registrations below (see <a href="#RFC3864" id="rfc.xref.RFC3864.1"><cite title="Registration Procedures for Message Header Fields">[RFC3864]</cite></a>): 1496 </p> 1497 <div id="rfc.table.2"> 1408 1498 <div id="iana.header.registration.table"></div> 1409 1499 <table class="tt full left" cellpadding="3" cellspacing="0"> … … 1462 1552 </table> 1463 1553 </div> 1464 <p id="rfc.section.5. 1.p.2">The change controller is: "IETF (iesg@ietf.org) - Internet Engineering Task Force".</p>1554 <p id="rfc.section.5.2.p.2">The change controller is: "IETF (iesg@ietf.org) - Internet Engineering Task Force".</p> 1465 1555 <h1 id="rfc.section.6"><a href="#rfc.section.6">6.</a> <a id="security.considerations" href="#security.considerations">Security Considerations</a></h1> 1466 1556 <p id="rfc.section.6.p.1">Caches expose additional potential vulnerabilities, since the contents of the cache represent an attractive target for malicious … … 1516 1606 <h2 id="rfc.references.2"><a href="#rfc.section.8.2" id="rfc.section.8.2">8.2</a> Informative References 1517 1607 </h2> 1518 <table> 1608 <table> 1519 1609 <tr> 1520 1610 <td class="reference"><b id="RFC1305">[RFC1305]</b></td> … … 1530 1620 <td class="reference"><b id="RFC3864">[RFC3864]</b></td> 1531 1621 <td class="top"><a href="mailto:GK-IETF@ninebynine.org" title="Nine by Nine">Klyne, G.</a>, <a href="mailto:mnot@pobox.com" title="BEA Systems">Nottingham, M.</a>, and <a href="mailto:JeffMogul@acm.org" title="HP Labs">J. Mogul</a>, “<a href="http://tools.ietf.org/html/rfc3864">Registration Procedures for Message Header Fields</a>”, BCP 90, RFC 3864, September 2004. 1622 </td> 1623 </tr> 1624 <tr> 1625 <td class="reference"><b id="RFC5226">[RFC5226]</b></td> 1626 <td class="top"><a href="mailto:narten@us.ibm.com" title="IBM">Narten, T.</a> and <a href="mailto:Harald@Alvestrand.no" title="Google">H. Alvestrand</a>, “<a href="http://tools.ietf.org/html/rfc5226">Guidelines for Writing an IANA Considerations Section in RFCs</a>”, BCP 26, RFC 5226, May 2008. 1532 1627 </td> 1533 1628 </tr> … … 1775 1870 <li> <<a href="http://tools.ietf.org/wg/httpbis/trac/ticket/29">http://tools.ietf.org/wg/httpbis/trac/ticket/29</a>>: "Age calculation" 1776 1871 </li> 1872 <li> <<a href="http://tools.ietf.org/wg/httpbis/trac/ticket/208">http://tools.ietf.org/wg/httpbis/trac/ticket/208</a>>: "IANA registry for cache-control directives" 1873 </li> 1777 1874 </ul> 1778 1875 <h1 id="rfc.index"><a href="#rfc.index">Index</a></h1> … … 1783 1880 <li class="indline0"><a id="rfc.index.A" href="#rfc.index.A"><b>A</b></a><ul class="ind"> 1784 1881 <li class="indline1">age <a class="iref" href="#rfc.iref.a.1">1.2</a></li> 1785 <li class="indline1">Age header <a class="iref" href="#rfc.xref.header.age.1">2.2</a>, <a class="iref" href="#rfc.xref.header.age.2">2.3.2</a>, <a class="iref" href="#rfc.iref.a.2"><b>3.1</b></a>, <a class="iref" href="#rfc.xref.header.age.3">5. 1</a></li>1882 <li class="indline1">Age header <a class="iref" href="#rfc.xref.header.age.1">2.2</a>, <a class="iref" href="#rfc.xref.header.age.2">2.3.2</a>, <a class="iref" href="#rfc.iref.a.2"><b>3.1</b></a>, <a class="iref" href="#rfc.xref.header.age.3">5.2</a></li> 1786 1883 </ul> 1787 1884 </li> … … 1804 1901 </ul> 1805 1902 </li> 1806 <li class="indline1">Cache-Control header <a class="iref" href="#rfc.xref.header.cache-control.1">2.1</a>, <a class="iref" href="#rfc.xref.header.cache-control.2">2.1</a>, <a class="iref" href="#rfc.xref.header.cache-control.3">2.2</a>, <a class="iref" href="#rfc.iref.c.3"><b>3.2</b></a>, <a class="iref" href="#rfc.xref.header.cache-control.4">5. 1</a>, <a class="iref" href="#rfc.xref.header.cache-control.5">A.1</a>, <a class="iref" href="#rfc.xref.header.cache-control.6">A.1</a></li>1903 <li class="indline1">Cache-Control header <a class="iref" href="#rfc.xref.header.cache-control.1">2.1</a>, <a class="iref" href="#rfc.xref.header.cache-control.2">2.1</a>, <a class="iref" href="#rfc.xref.header.cache-control.3">2.2</a>, <a class="iref" href="#rfc.iref.c.3"><b>3.2</b></a>, <a class="iref" href="#rfc.xref.header.cache-control.4">5.2</a>, <a class="iref" href="#rfc.xref.header.cache-control.5">A.1</a>, <a class="iref" href="#rfc.xref.header.cache-control.6">A.1</a></li> 1807 1904 <li class="indline1">cacheable <a class="iref" href="#rfc.iref.c.2">1.2</a></li> 1808 1905 </ul> 1809 1906 </li> 1810 1907 <li class="indline0"><a id="rfc.index.E" href="#rfc.index.E"><b>E</b></a><ul class="ind"> 1811 <li class="indline1">Expires header <a class="iref" href="#rfc.xref.header.expires.1">2.1</a>, <a class="iref" href="#rfc.xref.header.expires.2">2.3</a>, <a class="iref" href="#rfc.xref.header.expires.3">2.3.1</a>, <a class="iref" href="#rfc.iref.e.2"><b>3.3</b></a>, <a class="iref" href="#rfc.xref.header.expires.4">5. 1</a></li>1908 <li class="indline1">Expires header <a class="iref" href="#rfc.xref.header.expires.1">2.1</a>, <a class="iref" href="#rfc.xref.header.expires.2">2.3</a>, <a class="iref" href="#rfc.xref.header.expires.3">2.3.1</a>, <a class="iref" href="#rfc.iref.e.2"><b>3.3</b></a>, <a class="iref" href="#rfc.xref.header.expires.4">5.2</a></li> 1812 1909 <li class="indline1">explicit expiration time <a class="iref" href="#rfc.iref.e.1">1.2</a></li> 1813 1910 </ul> … … 1852 1949 <li class="indline1">Headers 1853 1950 <ul class="ind"> 1854 <li class="indline1">Age <a class="iref" href="#rfc.xref.header.age.1">2.2</a>, <a class="iref" href="#rfc.xref.header.age.2">2.3.2</a>, <a class="iref" href="#rfc.iref.h.2"><b>3.1</b></a>, <a class="iref" href="#rfc.xref.header.age.3">5. 1</a></li>1855 <li class="indline1">Cache-Control <a class="iref" href="#rfc.xref.header.cache-control.1">2.1</a>, <a class="iref" href="#rfc.xref.header.cache-control.2">2.1</a>, <a class="iref" href="#rfc.xref.header.cache-control.3">2.2</a>, <a class="iref" href="#rfc.iref.h.3"><b>3.2</b></a>, <a class="iref" href="#rfc.xref.header.cache-control.4">5. 1</a>, <a class="iref" href="#rfc.xref.header.cache-control.5">A.1</a>, <a class="iref" href="#rfc.xref.header.cache-control.6">A.1</a></li>1856 <li class="indline1">Expires <a class="iref" href="#rfc.xref.header.expires.1">2.1</a>, <a class="iref" href="#rfc.xref.header.expires.2">2.3</a>, <a class="iref" href="#rfc.xref.header.expires.3">2.3.1</a>, <a class="iref" href="#rfc.iref.h.4"><b>3.3</b></a>, <a class="iref" href="#rfc.xref.header.expires.4">5. 1</a></li>1857 <li class="indline1">Pragma <a class="iref" href="#rfc.xref.header.pragma.1">2.2</a>, <a class="iref" href="#rfc.xref.header.pragma.2">3.2</a>, <a class="iref" href="#rfc.iref.h.5"><b>3.4</b></a>, <a class="iref" href="#rfc.xref.header.pragma.3">5. 1</a></li>1858 <li class="indline1">Vary <a class="iref" href="#rfc.xref.header.vary.1">2.6</a>, <a class="iref" href="#rfc.iref.h.6"><b>3.5</b></a>, <a class="iref" href="#rfc.xref.header.vary.2">5. 1</a></li>1859 <li class="indline1">Warning <a class="iref" href="#rfc.xref.header.warning.1">2.3.3</a>, <a class="iref" href="#rfc.xref.header.warning.2">2.7</a>, <a class="iref" href="#rfc.iref.h.7"><b>3.6</b></a>, <a class="iref" href="#rfc.xref.header.warning.3">5. 1</a>, <a class="iref" href="#rfc.xref.header.warning.4">A.1</a>, <a class="iref" href="#rfc.xref.header.warning.5">A.2</a></li>1951 <li class="indline1">Age <a class="iref" href="#rfc.xref.header.age.1">2.2</a>, <a class="iref" href="#rfc.xref.header.age.2">2.3.2</a>, <a class="iref" href="#rfc.iref.h.2"><b>3.1</b></a>, <a class="iref" href="#rfc.xref.header.age.3">5.2</a></li> 1952 <li class="indline1">Cache-Control <a class="iref" href="#rfc.xref.header.cache-control.1">2.1</a>, <a class="iref" href="#rfc.xref.header.cache-control.2">2.1</a>, <a class="iref" href="#rfc.xref.header.cache-control.3">2.2</a>, <a class="iref" href="#rfc.iref.h.3"><b>3.2</b></a>, <a class="iref" href="#rfc.xref.header.cache-control.4">5.2</a>, <a class="iref" href="#rfc.xref.header.cache-control.5">A.1</a>, <a class="iref" href="#rfc.xref.header.cache-control.6">A.1</a></li> 1953 <li class="indline1">Expires <a class="iref" href="#rfc.xref.header.expires.1">2.1</a>, <a class="iref" href="#rfc.xref.header.expires.2">2.3</a>, <a class="iref" href="#rfc.xref.header.expires.3">2.3.1</a>, <a class="iref" href="#rfc.iref.h.4"><b>3.3</b></a>, <a class="iref" href="#rfc.xref.header.expires.4">5.2</a></li> 1954 <li class="indline1">Pragma <a class="iref" href="#rfc.xref.header.pragma.1">2.2</a>, <a class="iref" href="#rfc.xref.header.pragma.2">3.2</a>, <a class="iref" href="#rfc.iref.h.5"><b>3.4</b></a>, <a class="iref" href="#rfc.xref.header.pragma.3">5.2</a></li> 1955 <li class="indline1">Vary <a class="iref" href="#rfc.xref.header.vary.1">2.6</a>, <a class="iref" href="#rfc.iref.h.6"><b>3.5</b></a>, <a class="iref" href="#rfc.xref.header.vary.2">5.2</a></li> 1956 <li class="indline1">Warning <a class="iref" href="#rfc.xref.header.warning.1">2.3.3</a>, <a class="iref" href="#rfc.xref.header.warning.2">2.7</a>, <a class="iref" href="#rfc.iref.h.7"><b>3.6</b></a>, <a class="iref" href="#rfc.xref.header.warning.3">5.2</a>, <a class="iref" href="#rfc.xref.header.warning.4">A.1</a>, <a class="iref" href="#rfc.xref.header.warning.5">A.2</a></li> 1860 1957 </ul> 1861 1958 </li> … … 1940 2037 </ul> 1941 2038 </li> 1942 <li class="indline1">Pragma header <a class="iref" href="#rfc.xref.header.pragma.1">2.2</a>, <a class="iref" href="#rfc.xref.header.pragma.2">3.2</a>, <a class="iref" href="#rfc.iref.p.4"><b>3.4</b></a>, <a class="iref" href="#rfc.xref.header.pragma.3">5. 1</a></li>2039 <li class="indline1">Pragma header <a class="iref" href="#rfc.xref.header.pragma.1">2.2</a>, <a class="iref" href="#rfc.xref.header.pragma.2">3.2</a>, <a class="iref" href="#rfc.iref.p.4"><b>3.4</b></a>, <a class="iref" href="#rfc.xref.header.pragma.3">5.2</a></li> 1943 2040 <li class="indline1">private 1944 2041 <ul class="ind"> … … 1962 2059 <li class="indline1"><em>RFC2119</em> <a class="iref" href="#rfc.xref.RFC2119.1">1.3</a>, <a class="iref" href="#RFC2119"><b>8.1</b></a></li> 1963 2060 <li class="indline1"><em>RFC2616</em> <a class="iref" href="#RFC2616"><b>8.2</b></a>, <a class="iref" href="#rfc.xref.RFC2616.1">C.1</a></li> 1964 <li class="indline1"><em>RFC3864</em> <a class="iref" href="#rfc.xref.RFC3864.1">5.1</a>, <a class="iref" href="#RFC3864"><b>8.2</b></a></li> 2061 <li class="indline1"><em>RFC3864</em> <a class="iref" href="#rfc.xref.RFC3864.1">5.2</a>, <a class="iref" href="#RFC3864"><b>8.2</b></a></li> 2062 <li class="indline1"><em>RFC5226</em> <a class="iref" href="#rfc.xref.RFC5226.1">3.2.3</a>, <a class="iref" href="#RFC5226"><b>8.2</b></a><ul class="ind"> 2063 <li class="indline1"><em>Section 4.1</em> <a class="iref" href="#rfc.xref.RFC5226.1">3.2.3</a></li> 2064 </ul> 2065 </li> 1965 2066 <li class="indline1"><em>RFC5234</em> <a class="iref" href="#rfc.xref.RFC5234.1">1.4</a>, <a class="iref" href="#rfc.xref.RFC5234.2">1.4</a>, <a class="iref" href="#RFC5234"><b>8.1</b></a><ul class="ind"> 1966 2067 <li class="indline1"><em>Appendix B.1</em> <a class="iref" href="#rfc.xref.RFC5234.2">1.4</a></li> … … 1980 2081 <li class="indline0"><a id="rfc.index.V" href="#rfc.index.V"><b>V</b></a><ul class="ind"> 1981 2082 <li class="indline1">validator <a class="iref" href="#rfc.iref.v.1">1.2</a>, <a class="iref" href="#rfc.iref.v.2">1.2</a></li> 1982 <li class="indline1">Vary header <a class="iref" href="#rfc.xref.header.vary.1">2.6</a>, <a class="iref" href="#rfc.iref.v.3"><b>3.5</b></a>, <a class="iref" href="#rfc.xref.header.vary.2">5. 1</a></li>2083 <li class="indline1">Vary header <a class="iref" href="#rfc.xref.header.vary.1">2.6</a>, <a class="iref" href="#rfc.iref.v.3"><b>3.5</b></a>, <a class="iref" href="#rfc.xref.header.vary.2">5.2</a></li> 1983 2084 </ul> 1984 2085 </li> 1985 2086 <li class="indline0"><a id="rfc.index.W" href="#rfc.index.W"><b>W</b></a><ul class="ind"> 1986 <li class="indline1">Warning header <a class="iref" href="#rfc.xref.header.warning.1">2.3.3</a>, <a class="iref" href="#rfc.xref.header.warning.2">2.7</a>, <a class="iref" href="#rfc.iref.w.1"><b>3.6</b></a>, <a class="iref" href="#rfc.xref.header.warning.3">5. 1</a>, <a class="iref" href="#rfc.xref.header.warning.4">A.1</a>, <a class="iref" href="#rfc.xref.header.warning.5">A.2</a></li>2087 <li class="indline1">Warning header <a class="iref" href="#rfc.xref.header.warning.1">2.3.3</a>, <a class="iref" href="#rfc.xref.header.warning.2">2.7</a>, <a class="iref" href="#rfc.iref.w.1"><b>3.6</b></a>, <a class="iref" href="#rfc.xref.header.warning.3">5.2</a>, <a class="iref" href="#rfc.xref.header.warning.4">A.1</a>, <a class="iref" href="#rfc.xref.header.warning.5">A.2</a></li> 1987 2088 </ul> 1988 2089 </li>
Note: See TracChangeset
for help on using the changeset viewer.