Changeset 1487 for draft-ietf-httpbis/latest
- Timestamp:
- 05/12/11 13:24:57 (11 years ago)
- Location:
- draft-ietf-httpbis/latest
- Files:
-
- 1 added
- 4 edited
Legend:
- Unmodified
- Added
- Removed
-
draft-ietf-httpbis/latest
- Property svn:ignore
-
old new 1 *.abnf 2 *.abnf-appendix 3 *.cache-directives 4 *.diff 5 *.iana-status-codes 6 *.iana-warn-codes 1 7 *.redxml 8 *.xhtml 9 p1-messaging.iana-headers 10 p1-messaging.iana-headers.xml 11 p1-messaging.parsed-abnf 2 12 p1-messaging.txt 13 p2-semantics.iana-headers 14 p2-semantics.iana-headers.xml 15 p2-semantics.iana-methods 16 p2-semantics.iana-methods.xml 17 p2-semantics.iana-status-codes 18 p2-semantics.iana-status-codes.xml 19 p2-semantics.parsed-abnf 3 20 p2-semantics.txt 21 p3-payload.iana-headers 22 p3-payload.iana-headers.xml 23 p3-payload.parsed-abnf 4 24 p3-payload.txt 25 p4-conditional.iana-headers 26 p4-conditional.iana-headers.xml 27 p4-conditional.parsed-abnf 5 28 p4-conditional.txt 29 p5-range.iana-headers 30 p5-range.iana-headers.xml 31 p5-range.parsed-abnf 6 32 p5-range.txt 33 p6-cache.iana-headers 34 p6-cache.iana-headers.xml 35 p6-cache.parsed-abnf 7 36 p6-cache.txt 37 p7-auth.iana-headers 38 p7-auth.iana-headers.xml 39 p7-auth.parsed-abnf 8 40 p7-auth.txt 9 41 p8-cookies.txt 10 p2-semantics.iana-methods.xml11 p2-semantics.iana-status-codes.xml12 p1-messaging.iana-headers.xml13 p2-semantics.iana-headers.xml14 p3-payload.iana-headers.xml15 p4-conditional.iana-headers.xml16 p5-range.iana-headers.xml17 p6-cache.iana-headers.xml18 p7-auth.iana-headers.xml19 *.abnf20 p1-messaging.iana-headers21 p1-messaging.parsed-abnf22 p2-semantics.iana-headers23 p2-semantics.iana-methods24 p2-semantics.iana-status-codes25 p2-semantics.parsed-abnf26 p3-payload.iana-headers27 p3-payload.parsed-abnf28 p4-conditional.iana-headers29 p4-conditional.parsed-abnf30 p5-range.iana-headers31 p5-range.parsed-abnf32 p6-cache.iana-headers33 p6-cache.parsed-abnf34 p7-auth.iana-headers35 p7-auth.parsed-abnf36 *.abnf-appendix37 *.iana-status-codes38 *.cache-directives39 *.xhtml40 *.diff
-
- Property svn:ignore
-
draft-ietf-httpbis/latest/Makefile
r1147 r1487 39 39 p5-range.iana-status-codes \ 40 40 p6-cache.iana-headers \ 41 p6-cache.iana-warn-codes \ 41 42 p6-cache.cache-directives \ 42 43 p7-auth.iana-headers \ … … 79 80 $(saxon) $< extract-status-code-defs.xslt > $@ 80 81 82 %.iana-warn-codes: %.xml extract-warn-code-defs.xslt 83 $(saxon) $< extract-warn-code-defs.xslt > $@ 84 81 85 %.cache-directives: %.xml extract-cache-directives.xslt 82 86 $(saxon) $< extract-cache-directives.xslt > $@ -
draft-ietf-httpbis/latest/p6-cache.html
r1485 r1487 593 593 <li>3.5 <a href="#header.vary">Vary</a></li> 594 594 <li>3.6 <a href="#header.warning">Warning</a><ul> 595 <li>3.6.1 <a href="#warn.code.extensions">Warn Code Extensions</a></li> 595 <li>3.6.1 <a href="#warn.110">110 Response is Stale</a></li> 596 <li>3.6.2 <a href="#warn.111">111 Revalidation Failed</a></li> 597 <li>3.6.3 <a href="#warn.112">112 Disconnected Operation</a></li> 598 <li>3.6.4 <a href="#warn.113">113 Heuristic Expiration</a></li> 599 <li>3.6.5 <a href="#warn.199">199 Miscellaneous Warning</a></li> 600 <li>3.6.6 <a href="#warn.214">214 Transformation Applied</a></li> 601 <li>3.6.7 <a href="#warn.299">299 Miscellaneous Persistent Warning</a></li> 602 <li>3.6.8 <a href="#warn.code.extensions">Warn Code Extensions</a></li> 596 603 </ul> 597 604 </li> … … 1519 1526 of its meaning. 1520 1527 </p> 1521 < p id="rfc.section.3.6.p.12"> 110 Response is stale </p>1522 < ul class="empty">1523 <li>A cache <em class="bcp14">SHOULD</em> include this whenever the returned response is stale.1524 </li>1525 </ ul>1526 < p id="rfc.section.3.6.p.13"> 111 Revalidation failed </p>1527 < ul class="empty">1528 <li>A cache <em class="bcp14">SHOULD</em> include this when returning a stale response because an attempt to validate the response failed, due to an inability to reach1529 the server.1530 </li>1531 </ ul>1532 < p id="rfc.section.3.6.p.14"> 112 Disconnected operation </p>1533 < ul class="empty">1534 <li>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.1535 </li>1536 </ ul>1537 < p id="rfc.section.3.6.p.15"> 113 Heuristic expiration </p>1538 < ul class="empty">1539 <li>A cache <em class="bcp14">SHOULD</em> include this if it heuristically chose a freshness lifetime greater than 24 hours and the response's age is greater than 241540 hours.1541 </li>1542 </ ul>1543 < p id="rfc.section.3.6.p.16"> 199 Miscellaneous warning </p>1544 < ul class="empty">1545 <li>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.1546 </li>1547 </ ul>1548 < p id="rfc.section.3.6.p.17"> 214 Transformation applied </p>1549 < ul class="empty">1550 <li><em class="bcp14">MUST</em> be added by a proxy if it applies any transformation to the representation, such as changing the content-coding, media-type,1551 or modifying the representation data, unless this Warning code already appears in the response.1552 </li>1553 </ ul>1554 < p id="rfc.section.3.6.p.18"> 299 Miscellaneous persistent warning </p>1555 < ul class="empty">1556 <li>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.1557 </li>1558 </ ul>1559 <h3 id="rfc.section.3.6. 1"><a href="#rfc.section.3.6.1">3.6.1</a> <a id="warn.code.extensions" href="#warn.code.extensions">Warn Code Extensions</a></h3>1560 <p id="rfc.section.3.6. 1.p.1">The HTTP Warn Code Registry defines the name space for warn codes.</p>1561 <p id="rfc.section.3.6. 1.p.2">A registration <em class="bcp14">MUST</em> include the following fields:1528 <div id="rfc.iref.78"></div> 1529 <div id="rfc.iref.w.2"></div> 1530 <h3 id="rfc.section.3.6.1"><a href="#rfc.section.3.6.1">3.6.1</a> <a id="warn.110" href="#warn.110">110 Response is Stale</a></h3> 1531 <p id="rfc.section.3.6.1.p.1">A cache <em class="bcp14">SHOULD</em> include this whenever the returned response is stale. 1532 </p> 1533 <div id="rfc.iref.79"></div> 1534 <div id="rfc.iref.w.3"></div> 1535 <h3 id="rfc.section.3.6.2"><a href="#rfc.section.3.6.2">3.6.2</a> <a id="warn.111" href="#warn.111">111 Revalidation Failed</a></h3> 1536 <p id="rfc.section.3.6.2.p.1">A cache <em class="bcp14">SHOULD</em> include this when returning a stale response because an attempt to validate the response failed, due to an inability to reach 1537 the server. 1538 </p> 1539 <div id="rfc.iref.80"></div> 1540 <div id="rfc.iref.w.4"></div> 1541 <h3 id="rfc.section.3.6.3"><a href="#rfc.section.3.6.3">3.6.3</a> <a id="warn.112" href="#warn.112">112 Disconnected Operation</a></h3> 1542 <p id="rfc.section.3.6.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. 1543 </p> 1544 <div id="rfc.iref.81"></div> 1545 <div id="rfc.iref.w.5"></div> 1546 <h3 id="rfc.section.3.6.4"><a href="#rfc.section.3.6.4">3.6.4</a> <a id="warn.113" href="#warn.113">113 Heuristic Expiration</a></h3> 1547 <p id="rfc.section.3.6.4.p.1">A cache <em class="bcp14">SHOULD</em> include this if it heuristically chose a freshness lifetime greater than 24 hours and the response's age is greater than 24 1548 hours. 1549 </p> 1550 <div id="rfc.iref.82"></div> 1551 <div id="rfc.iref.w.6"></div> 1552 <h3 id="rfc.section.3.6.5"><a href="#rfc.section.3.6.5">3.6.5</a> <a id="warn.199" href="#warn.199">199 Miscellaneous Warning</a></h3> 1553 <p id="rfc.section.3.6.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. 1554 </p> 1555 <div id="rfc.iref.83"></div> 1556 <div id="rfc.iref.w.7"></div> 1557 <h3 id="rfc.section.3.6.6"><a href="#rfc.section.3.6.6">3.6.6</a> <a id="warn.214" href="#warn.214">214 Transformation Applied</a></h3> 1558 <p id="rfc.section.3.6.6.p.1"> <em class="bcp14">MUST</em> be added by a proxy if it applies any transformation to the representation, such as changing the content-coding, media-type, 1559 or modifying the representation data, unless this Warning code already appears in the response. 1560 </p> 1561 <div id="rfc.iref.84"></div> 1562 <div id="rfc.iref.w.8"></div> 1563 <h3 id="rfc.section.3.6.7"><a href="#rfc.section.3.6.7">3.6.7</a> <a id="warn.299" href="#warn.299">299 Miscellaneous Persistent Warning</a></h3> 1564 <p id="rfc.section.3.6.7.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. 1565 </p> 1566 <h3 id="rfc.section.3.6.8"><a href="#rfc.section.3.6.8">3.6.8</a> <a id="warn.code.extensions" href="#warn.code.extensions">Warn Code Extensions</a></h3> 1567 <p id="rfc.section.3.6.8.p.1">The HTTP Warn Code Registry defines the name space for warn codes.</p> 1568 <p id="rfc.section.3.6.8.p.2">A registration <em class="bcp14">MUST</em> include the following fields: 1562 1569 </p> 1563 1570 <ul> … … 1566 1573 <li>Pointer to specification text</li> 1567 1574 </ul> 1568 <p id="rfc.section.3.6. 1.p.3">Values to be added to this name space are subject to IETF review (<a href="#RFC5226" id="rfc.xref.RFC5226.2"><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>).1569 </p> 1570 <p id="rfc.section.3.6. 1.p.4">The registry itself is maintained at <<a href="http://www.iana.org/assignments/http-warn-codes">http://www.iana.org/assignments/http-warn-codes</a>>.1575 <p id="rfc.section.3.6.8.p.3">Values to be added to this name space are subject to IETF review (<a href="#RFC5226" id="rfc.xref.RFC5226.2"><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>). 1576 </p> 1577 <p id="rfc.section.3.6.8.p.4">The registry itself is maintained at <<a href="http://www.iana.org/assignments/http-warn-codes">http://www.iana.org/assignments/http-warn-codes</a>>. 1571 1578 </p> 1572 1579 <h2 id="rfc.section.3.7"><a href="#rfc.section.3.7">3.7</a> <a id="history.lists" href="#history.lists">History Lists</a></h2> … … 1670 1677 </div> 1671 1678 <h3 id="rfc.section.3.8.2"><a href="#rfc.section.3.8.2">3.8.2</a> <a id="warn.code.registration" href="#warn.code.registration">Warn Code Registry</a></h3> 1672 <p id="rfc.section.3.8.2.p.1">The registration procedure for HTTP Warn Codes is defined by <a href="#warn.code.extensions" title="Warn Code Extensions">Section 3.6. 1</a> of this document.1679 <p id="rfc.section.3.8.2.p.1">The registration procedure for HTTP Warn Codes is defined by <a href="#warn.code.extensions" title="Warn Code Extensions">Section 3.6.8</a> of this document. 1673 1680 </p> 1674 1681 <p id="rfc.section.3.8.2.p.2">The HTTP Warn Code Registry shall 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: 1675 1682 </p> 1676 <div id="rfc.table.u.1"> 1683 <div id="rfc.table.2"> 1684 <div id="iana.warn.code.registration.table"></div> 1677 1685 <table class="tt full left" cellpadding="3" cellspacing="0"> 1678 1686 <thead> … … 1686 1694 <tr> 1687 1695 <td class="left">110</td> 1688 <td class="left">Response is stale</td> 1689 <td class="left"><a href="#header.warning" id="rfc.xref.header.warning.4" title="Warning">Section 3.6</a></td> 1696 <td class="left">Response is Stale</td> 1697 <td class="left"> <a href="#warn.110" id="rfc.xref.warn.110.1" title="110 Response is Stale">Section 3.6.1</a> 1698 </td> 1690 1699 </tr> 1691 1700 <tr> 1692 1701 <td class="left">111</td> 1693 <td class="left">Revalidation failed</td> 1694 <td class="left"><a href="#header.warning" id="rfc.xref.header.warning.5" title="Warning">Section 3.6</a></td> 1702 <td class="left">Revalidation Failed</td> 1703 <td class="left"> <a href="#warn.111" id="rfc.xref.warn.111.1" title="111 Revalidation Failed">Section 3.6.2</a> 1704 </td> 1695 1705 </tr> 1696 1706 <tr> 1697 1707 <td class="left">112</td> 1698 <td class="left">Disconnected operation</td> 1699 <td class="left"><a href="#header.warning" id="rfc.xref.header.warning.6" title="Warning">Section 3.6</a></td> 1708 <td class="left">Disconnected Operation</td> 1709 <td class="left"> <a href="#warn.112" id="rfc.xref.warn.112.1" title="112 Disconnected Operation">Section 3.6.3</a> 1710 </td> 1700 1711 </tr> 1701 1712 <tr> 1702 1713 <td class="left">113</td> 1703 <td class="left">Heuristic expiration</td> 1704 <td class="left"><a href="#header.warning" id="rfc.xref.header.warning.7" title="Warning">Section 3.6</a></td> 1714 <td class="left">Heuristic Expiration</td> 1715 <td class="left"> <a href="#warn.113" id="rfc.xref.warn.113.1" title="113 Heuristic Expiration">Section 3.6.4</a> 1716 </td> 1705 1717 </tr> 1706 1718 <tr> 1707 1719 <td class="left">199</td> 1708 <td class="left">Miscellaneous warning</td> 1709 <td class="left"><a href="#header.warning" id="rfc.xref.header.warning.8" title="Warning">Section 3.6</a></td> 1720 <td class="left">Miscellaneous Warning</td> 1721 <td class="left"> <a href="#warn.199" id="rfc.xref.warn.199.1" title="199 Miscellaneous Warning">Section 3.6.5</a> 1722 </td> 1710 1723 </tr> 1711 1724 <tr> 1712 1725 <td class="left">214</td> 1713 <td class="left">Transformation applied</td> 1714 <td class="left"><a href="#header.warning" id="rfc.xref.header.warning.9" title="Warning">Section 3.6</a></td> 1726 <td class="left">Transformation Applied</td> 1727 <td class="left"> <a href="#warn.214" id="rfc.xref.warn.214.1" title="214 Transformation Applied">Section 3.6.6</a> 1728 </td> 1715 1729 </tr> 1716 1730 <tr> 1717 1731 <td class="left">299</td> 1718 <td class="left">Miscellaneous persistent warning</td> 1719 <td class="left"><a href="#header.warning" id="rfc.xref.header.warning.10" title="Warning">Section 3.6</a></td> 1732 <td class="left">Miscellaneous Persistent Warning</td> 1733 <td class="left"> <a href="#warn.299" id="rfc.xref.warn.299.1" title="299 Miscellaneous Persistent Warning">Section 3.6.7</a> 1734 </td> 1720 1735 </tr> 1721 1736 </tbody> … … 1725 1740 <p id="rfc.section.3.9.p.1">The Message Header Field 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>> shall 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>): 1726 1741 </p> 1727 <div id="rfc.table. 2">1742 <div id="rfc.table.3"> 1728 1743 <div id="iana.header.registration.table"></div> 1729 1744 <table class="tt full left" cellpadding="3" cellspacing="0"> … … 1776 1791 <td class="left">http</td> 1777 1792 <td class="left">standard</td> 1778 <td class="left"> <a href="#header.warning" id="rfc.xref.header.warning. 11" title="Warning">Section 3.6</a>1793 <td class="left"> <a href="#header.warning" id="rfc.xref.header.warning.4" title="Warning">Section 3.6</a> 1779 1794 </td> 1780 1795 </tr> … … 1894 1909 </p> 1895 1910 <p id="rfc.section.A.p.5">Do not mention RFC 2047 encoding and multiple languages in Warning header fields anymore, as these aspects never were implemented. 1896 (<a href="#header.warning" id="rfc.xref.header.warning. 12" title="Warning">Section 3.6</a>)1911 (<a href="#header.warning" id="rfc.xref.header.warning.5" title="Warning">Section 3.6</a>) 1897 1912 </p> 1898 1913 <h1 id="rfc.section.B"><a href="#rfc.section.B">B.</a> <a id="collected.abnf" href="#collected.abnf">Collected ABNF</a></h1> … … 2177 2192 </ul> 2178 2193 <h1 id="rfc.index"><a href="#rfc.index">Index</a></h1> 2179 <p class="noprint"><a href="#rfc.index. A">A</a> <a href="#rfc.index.C">C</a> <a href="#rfc.index.E">E</a> <a href="#rfc.index.F">F</a> <a href="#rfc.index.G">G</a> <a href="#rfc.index.H">H</a> <a href="#rfc.index.M">M</a> <a href="#rfc.index.N">N</a> <a href="#rfc.index.O">O</a> <a href="#rfc.index.P">P</a> <a href="#rfc.index.R">R</a> <a href="#rfc.index.S">S</a> <a href="#rfc.index.V">V</a> <a href="#rfc.index.W">W</a>2194 <p class="noprint"><a href="#rfc.index.1">1</a> <a href="#rfc.index.2">2</a> <a href="#rfc.index.A">A</a> <a href="#rfc.index.C">C</a> <a href="#rfc.index.E">E</a> <a href="#rfc.index.F">F</a> <a href="#rfc.index.G">G</a> <a href="#rfc.index.H">H</a> <a href="#rfc.index.M">M</a> <a href="#rfc.index.N">N</a> <a href="#rfc.index.O">O</a> <a href="#rfc.index.P">P</a> <a href="#rfc.index.R">R</a> <a href="#rfc.index.S">S</a> <a href="#rfc.index.V">V</a> <a href="#rfc.index.W">W</a> 2180 2195 </p> 2181 2196 <div class="print2col"> 2182 2197 <ul class="ind"> 2198 <li><a id="rfc.index.1" href="#rfc.index.1"><b>1</b></a><ul> 2199 <li>110 Response is Stale (warn code) <a href="#rfc.iref.78"><b>3.6.1</b></a>, <a href="#rfc.xref.warn.110.1">3.8.2</a></li> 2200 <li>111 Revalidation Failed (warn code) <a href="#rfc.iref.79"><b>3.6.2</b></a>, <a href="#rfc.xref.warn.111.1">3.8.2</a></li> 2201 <li>112 Disconnected Operation (warn code) <a href="#rfc.iref.80"><b>3.6.3</b></a>, <a href="#rfc.xref.warn.112.1">3.8.2</a></li> 2202 <li>113 Heuristic Expiration (warn code) <a href="#rfc.iref.81"><b>3.6.4</b></a>, <a href="#rfc.xref.warn.113.1">3.8.2</a></li> 2203 <li>199 Miscellaneous Warning (warn code) <a href="#rfc.iref.82"><b>3.6.5</b></a>, <a href="#rfc.xref.warn.199.1">3.8.2</a></li> 2204 </ul> 2205 </li> 2206 <li><a id="rfc.index.2" href="#rfc.index.2"><b>2</b></a><ul> 2207 <li>214 Transformation Applied (warn code) <a href="#rfc.iref.83"><b>3.6.6</b></a>, <a href="#rfc.xref.warn.214.1">3.8.2</a></li> 2208 <li>299 Miscellaneous Persistent Warning (warn code) <a href="#rfc.iref.84"><b>3.6.7</b></a>, <a href="#rfc.xref.warn.299.1">3.8.2</a></li> 2209 </ul> 2210 </li> 2183 2211 <li><a id="rfc.index.A" href="#rfc.index.A"><b>A</b></a><ul> 2184 2212 <li>age <a href="#rfc.iref.a.1">1.2</a></li> … … 2253 2281 <li>Pragma <a href="#rfc.xref.header.pragma.1">2.2</a>, <a href="#rfc.xref.header.pragma.2">3.2</a>, <a href="#rfc.iref.h.5"><b>3.4</b></a>, <a href="#rfc.xref.header.pragma.3">3.9</a></li> 2254 2282 <li>Vary <a href="#rfc.xref.header.vary.1">2.7</a>, <a href="#rfc.iref.h.6"><b>3.5</b></a>, <a href="#rfc.xref.header.vary.2">3.9</a></li> 2255 <li>Warning <a href="#rfc.xref.header.warning.1">2.3.3</a>, <a href="#rfc.xref.header.warning.2">2.4.1</a>, <a href="#rfc.xref.header.warning.3">2.8</a>, <a href="#rfc.iref.h.7"><b>3.6</b></a>, <a href="#rfc.xref.header.warning.4">3. 8.2</a>, <a href="#rfc.xref.header.warning.5">3.8.2</a>, <a href="#rfc.xref.header.warning.6">3.8.2</a>, <a href="#rfc.xref.header.warning.7">3.8.2</a>, <a href="#rfc.xref.header.warning.8">3.8.2</a>, <a href="#rfc.xref.header.warning.9">3.8.2</a>, <a href="#rfc.xref.header.warning.10">3.8.2</a>, <a href="#rfc.xref.header.warning.11">3.9</a>, <a href="#rfc.xref.header.warning.12">A</a></li>2283 <li>Warning <a href="#rfc.xref.header.warning.1">2.3.3</a>, <a href="#rfc.xref.header.warning.2">2.4.1</a>, <a href="#rfc.xref.header.warning.3">2.8</a>, <a href="#rfc.iref.h.7"><b>3.6</b></a>, <a href="#rfc.xref.header.warning.4">3.9</a>, <a href="#rfc.xref.header.warning.5">A</a></li> 2256 2284 </ul> 2257 2285 </li> … … 2370 2398 </li> 2371 2399 <li><em>RFC3864</em> <a href="#rfc.xref.RFC3864.1">3.9</a>, <a href="#RFC3864"><b>6.2</b></a></li> 2372 <li><em>RFC5226</em> <a href="#rfc.xref.RFC5226.1">3.2.3</a>, <a href="#rfc.xref.RFC5226.2">3.6. 1</a>, <a href="#RFC5226"><b>6.2</b></a><ul>2373 <li><em>Section 4.1</em> <a href="#rfc.xref.RFC5226.1">3.2.3</a>, <a href="#rfc.xref.RFC5226.2">3.6. 1</a></li>2400 <li><em>RFC5226</em> <a href="#rfc.xref.RFC5226.1">3.2.3</a>, <a href="#rfc.xref.RFC5226.2">3.6.8</a>, <a href="#RFC5226"><b>6.2</b></a><ul> 2401 <li><em>Section 4.1</em> <a href="#rfc.xref.RFC5226.1">3.2.3</a>, <a href="#rfc.xref.RFC5226.2">3.6.8</a></li> 2374 2402 </ul> 2375 2403 </li> … … 2405 2433 </li> 2406 2434 <li><a id="rfc.index.W" href="#rfc.index.W"><b>W</b></a><ul> 2407 <li>Warning header field <a href="#rfc.xref.header.warning.1">2.3.3</a>, <a href="#rfc.xref.header.warning.2">2.4.1</a>, <a href="#rfc.xref.header.warning.3">2.8</a>, <a href="#rfc.iref.w.1"><b>3.6</b></a>, <a href="#rfc.xref.header.warning.4">3.8.2</a>, <a href="#rfc.xref.header.warning.5">3.8.2</a>, <a href="#rfc.xref.header.warning.6">3.8.2</a>, <a href="#rfc.xref.header.warning.7">3.8.2</a>, <a href="#rfc.xref.header.warning.8">3.8.2</a>, <a href="#rfc.xref.header.warning.9">3.8.2</a>, <a href="#rfc.xref.header.warning.10">3.8.2</a>, <a href="#rfc.xref.header.warning.11">3.9</a>, <a href="#rfc.xref.header.warning.12">A</a></li> 2435 <li>Warn Codes 2436 <ul> 2437 <li>110 Response is Stale <a href="#rfc.iref.w.2"><b>3.6.1</b></a>, <a href="#rfc.xref.warn.110.1">3.8.2</a></li> 2438 <li>111 Revalidation Failed <a href="#rfc.iref.w.3"><b>3.6.2</b></a>, <a href="#rfc.xref.warn.111.1">3.8.2</a></li> 2439 <li>112 Disconnected Operation <a href="#rfc.iref.w.4"><b>3.6.3</b></a>, <a href="#rfc.xref.warn.112.1">3.8.2</a></li> 2440 <li>113 Heuristic Expiration <a href="#rfc.iref.w.5"><b>3.6.4</b></a>, <a href="#rfc.xref.warn.113.1">3.8.2</a></li> 2441 <li>199 Miscellaneous Warning <a href="#rfc.iref.w.6"><b>3.6.5</b></a>, <a href="#rfc.xref.warn.199.1">3.8.2</a></li> 2442 <li>214 Transformation Applied <a href="#rfc.iref.w.7"><b>3.6.6</b></a>, <a href="#rfc.xref.warn.214.1">3.8.2</a></li> 2443 <li>299 Miscellaneous Persistent Warning <a href="#rfc.iref.w.8"><b>3.6.7</b></a>, <a href="#rfc.xref.warn.299.1">3.8.2</a></li> 2444 </ul> 2445 </li> 2446 <li>Warning header field <a href="#rfc.xref.header.warning.1">2.3.3</a>, <a href="#rfc.xref.header.warning.2">2.4.1</a>, <a href="#rfc.xref.header.warning.3">2.8</a>, <a href="#rfc.iref.w.1"><b>3.6</b></a>, <a href="#rfc.xref.header.warning.4">3.9</a>, <a href="#rfc.xref.header.warning.5">A</a></li> 2408 2447 </ul> 2409 2448 </li> -
draft-ietf-httpbis/latest/p6-cache.xml
r1485 r1487 1867 1867 recommended warn-text in English, and a description of its meaning. 1868 1868 </t> 1869 <t><?rfc needLines="4"?> 1870 110 Response is stale 1871 <list> 1872 <t>A cache &SHOULD; include this whenever the returned response is stale.</t> 1873 </list> 1874 </t> 1875 <t><?rfc needLines="4"?> 1876 111 Revalidation failed 1877 <list> 1878 <t>A cache &SHOULD; include this when returning a stale response because an 1879 attempt to validate the response failed, due to an inability to reach 1880 the server.</t> 1881 </list> 1882 </t> 1883 <t><?rfc needLines="4"?> 1884 112 Disconnected operation 1885 <list> 1886 <t>A cache &SHOULD; include this if it is intentionally disconnected from 1887 the rest of the network for a period of time.</t> 1888 </list> 1889 </t> 1890 <t><?rfc needLines="4"?> 1891 113 Heuristic expiration 1892 <list> 1893 <t>A cache &SHOULD; include this if it heuristically chose a freshness 1894 lifetime greater than 24 hours and the response's age is greater than 24 1895 hours.</t> 1896 </list> 1897 </t> 1898 <t><?rfc needLines="4"?> 1899 199 Miscellaneous warning 1900 <list> 1901 <t>The warning text can include arbitrary information to be presented to 1902 a human user, or logged. A system receiving this warning &MUST-NOT; take 1903 any automated action, besides presenting the warning to the user.</t> 1904 </list> 1905 </t> 1906 <t><?rfc needLines="4"?> 1907 214 Transformation applied 1908 <list> 1909 <t>&MUST; be added by a proxy if it applies any 1910 transformation to the representation, such as changing the 1911 content-coding, media-type, or modifying the representation data, unless 1912 this Warning code already appears in the response.</t> 1913 </list> 1914 </t> 1915 <t><?rfc needLines="4"?> 1916 299 Miscellaneous persistent warning 1917 <list> 1918 <t>The warning text can include arbitrary information to be presented to 1919 a human user, or logged. A system receiving this warning &MUST-NOT; take 1920 any automated action.</t> 1921 </list> 1922 </t> 1869 1870 <section title="110 Response is Stale" anchor="warn.110"> 1871 <iref primary="true" item="110 Response is Stale (warn code)" x:for-anchor=""/> 1872 <iref primary="true" item="Warn Codes" subitem="110 Response is Stale" x:for-anchor=""/> 1873 <t> 1874 A cache &SHOULD; include this whenever the returned response is stale. 1875 </t> 1876 </section> 1877 1878 <section title="111 Revalidation Failed" anchor="warn.111"> 1879 <iref primary="true" item="111 Revalidation Failed (warn code)" x:for-anchor=""/> 1880 <iref primary="true" item="Warn Codes" subitem="111 Revalidation Failed" x:for-anchor=""/> 1881 <t> 1882 A cache &SHOULD; include this when returning a stale response because an 1883 attempt to validate the response failed, due to an inability to reach 1884 the server. 1885 </t> 1886 </section> 1887 1888 <section title="112 Disconnected Operation" anchor="warn.112"> 1889 <iref primary="true" item="112 Disconnected Operation (warn code)" x:for-anchor=""/> 1890 <iref primary="true" item="Warn Codes" subitem="112 Disconnected Operation" x:for-anchor=""/> 1891 <t> 1892 A cache &SHOULD; include this if it is intentionally disconnected from 1893 the rest of the network for a period of time. 1894 </t> 1895 </section> 1896 1897 <section title="113 Heuristic Expiration" anchor="warn.113"> 1898 <iref primary="true" item="113 Heuristic Expiration (warn code)" x:for-anchor=""/> 1899 <iref primary="true" item="Warn Codes" subitem="113 Heuristic Expiration" x:for-anchor=""/> 1900 <t> 1901 A cache &SHOULD; include this if it heuristically chose a freshness 1902 lifetime greater than 24 hours and the response's age is greater than 24 1903 hours. 1904 </t> 1905 </section> 1906 1907 <section title="199 Miscellaneous Warning" anchor="warn.199"> 1908 <iref primary="true" item="199 Miscellaneous Warning (warn code)" x:for-anchor=""/> 1909 <iref primary="true" item="Warn Codes" subitem="199 Miscellaneous Warning" x:for-anchor=""/> 1910 <t> 1911 The warning text can include arbitrary information to be presented to 1912 a human user, or logged. A system receiving this warning &MUST-NOT; take 1913 any automated action, besides presenting the warning to the user. 1914 </t> 1915 </section> 1916 1917 <section title="214 Transformation Applied" anchor="warn.214"> 1918 <iref primary="true" item="214 Transformation Applied (warn code)" x:for-anchor=""/> 1919 <iref primary="true" item="Warn Codes" subitem="214 Transformation Applied" x:for-anchor=""/> 1920 <t> 1921 &MUST; be added by a proxy if it applies any transformation to the 1922 representation, such as changing the content-coding, media-type, or 1923 modifying the representation data, unless this Warning code already appears 1924 in the response. 1925 </t> 1926 </section> 1927 1928 <section title="299 Miscellaneous Persistent Warning" anchor="warn.299"> 1929 <iref primary="true" item="299 Miscellaneous Persistent Warning (warn code)" x:for-anchor=""/> 1930 <iref primary="true" item="Warn Codes" subitem="299 Miscellaneous Persistent Warning" x:for-anchor=""/> 1931 <t> 1932 The warning text can include arbitrary information to be presented to 1933 a human user, or logged. A system receiving this warning &MUST-NOT; take 1934 any automated action. 1935 </t> 1936 </section> 1937 1923 1938 <section title="Warn Code Extensions" anchor="warn.code.extensions"> 1924 1939 <t> … … 2056 2071 populated with the registrations below: 2057 2072 </t> 2058 2059 <texttable align="left" suppress-title="true"> 2073 <?BEGININC p6-cache.iana-warn-codes ?> 2074 <!--AUTOGENERATED FROM extract-warn-code-defs.xslt, do not edit manually--> 2075 <texttable align="left" suppress-title="true" anchor="iana.warn.code.registration.table"> 2060 2076 <ttcol>Warn Code</ttcol> 2061 2077 <ttcol>Short Description</ttcol> 2062 2078 <ttcol>Reference</ttcol> 2063 2064 2079 <c>110</c> 2065 <c>Response is stale</c> 2066 <c><xref target="header.warning"/></c> 2067 2080 <c>Response is Stale</c> 2081 <c> 2082 <xref target="warn.110"/> 2083 </c> 2068 2084 <c>111</c> 2069 <c>Revalidation failed</c> 2070 <c><xref target="header.warning"/></c> 2071 2085 <c>Revalidation Failed</c> 2086 <c> 2087 <xref target="warn.111"/> 2088 </c> 2072 2089 <c>112</c> 2073 <c>Disconnected operation</c> 2074 <c><xref target="header.warning"/></c> 2075 2090 <c>Disconnected Operation</c> 2091 <c> 2092 <xref target="warn.112"/> 2093 </c> 2076 2094 <c>113</c> 2077 <c>Heuristic expiration</c> 2078 <c><xref target="header.warning"/></c> 2079 2095 <c>Heuristic Expiration</c> 2096 <c> 2097 <xref target="warn.113"/> 2098 </c> 2080 2099 <c>199</c> 2081 <c>Miscellaneous warning</c> 2082 <c><xref target="header.warning"/></c> 2083 2100 <c>Miscellaneous Warning</c> 2101 <c> 2102 <xref target="warn.199"/> 2103 </c> 2084 2104 <c>214</c> 2085 <c>Transformation applied</c> 2086 <c><xref target="header.warning"/></c> 2087 2105 <c>Transformation Applied</c> 2106 <c> 2107 <xref target="warn.214"/> 2108 </c> 2088 2109 <c>299</c> 2089 <c>Miscellaneous persistent warning</c> 2090 <c><xref target="header.warning"/></c> 2110 <c>Miscellaneous Persistent Warning</c> 2111 <c> 2112 <xref target="warn.299"/> 2113 </c> 2091 2114 </texttable> 2115 <!--(END)--> 2116 <?ENDINC p6-cache.iana-warn-codes ?> 2092 2117 </section> 2093 2118 </section>
Note: See TracChangeset
for help on using the changeset viewer.