Changeset 229 for draft-ietf-httpbis/latest/p6-cache.xml
- Timestamp:
- 02/03/08 17:21:57 (13 years ago)
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
draft-ietf-httpbis/latest/p6-cache.xml
r228 r229 429 429 430 430 <section title="Notational Conventions and Generic Grammar" anchor="notation"> 431 <x:anchor-alias value="DIGIT"/> 432 <x:anchor-alias value="DQUOTE"/> 433 <x:anchor-alias value="quoted-string"/> 434 <x:anchor-alias value="SP"/> 435 <x:anchor-alias value="token"/> 431 436 <t> 432 437 This specification uses the ABNF syntax defined in ¬ation-abnf; and … … 436 441 </t> 437 442 <figure><artwork type="abnf2616"> 438 DIGIT= <DIGIT, defined in &basic-rules;>439 DQUOTE= <DQUOTE, defined in &basic-rules;>440 SP= <SP, defined in &basic-rules;>443 <x:ref>DIGIT</x:ref> = <DIGIT, defined in &basic-rules;> 444 <x:ref>DQUOTE</x:ref> = <DQUOTE, defined in &basic-rules;> 445 <x:ref>SP</x:ref> = <SP, defined in &basic-rules;> 441 446 </artwork></figure> 442 447 <figure><artwork type="abnf2616"> 443 quoted-string= <quoted-string, defined in &basic-rules;>444 token= <token, defined in &basic-rules;>448 <x:ref>quoted-string</x:ref> = <quoted-string, defined in &basic-rules;> 449 <x:ref>token</x:ref> = <token, defined in &basic-rules;> 445 450 </artwork></figure> 446 451 <t anchor="abnf.dependencies"> 452 <x:anchor-alias value="field-name"/> 453 <x:anchor-alias value="HTTP-date"/> 454 <x:anchor-alias value="port"/> 455 <x:anchor-alias value="pseudonym"/> 456 <x:anchor-alias value="uri-host"/> 447 457 The ABNF rules below are defined in other parts: 448 458 </t> 449 459 <figure><!--Part1--><artwork type="abnf2616"> 450 field-name= <field-name, defined in &message-headers;>451 HTTP-date= <HTTP-date, defined in &full-date;>452 port= <port, defined in &general-syntax;>453 pseudonym= <pseudonym, defined in &header-via;>454 uri-host= <uri-host, defined in &general-syntax;>460 <x:ref>field-name</x:ref> = <field-name, defined in &message-headers;> 461 <x:ref>HTTP-date</x:ref> = <HTTP-date, defined in &full-date;> 462 <x:ref>port</x:ref> = <port, defined in &general-syntax;> 463 <x:ref>pseudonym</x:ref> = <pseudonym, defined in &header-via;> 464 <x:ref>uri-host</x:ref> = <uri-host, defined in &general-syntax;> 455 465 </artwork></figure> 456 466 </section> … … 1493 1503 <iref primary="true" item="Age header" x:for-anchor=""/> 1494 1504 <iref primary="true" item="Headers" subitem="Age" x:for-anchor=""/> 1505 <x:anchor-alias value="Age"/> 1506 <x:anchor-alias value="age-value"/> 1495 1507 <t> 1496 1508 The Age response-header field conveys the sender's estimate of the … … 1501 1513 </t> 1502 1514 <figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="Age"/><iref primary="true" item="Grammar" subitem="age-value"/> 1503 Age = "Age" ":" age-value1504 age-value = delta-seconds1515 <x:ref>Age</x:ref> = "Age" ":" <x:ref>age-value</x:ref> 1516 <x:ref>age-value</x:ref> = <x:ref>delta-seconds</x:ref> 1505 1517 </artwork></figure> 1506 <t> 1518 <t anchor="rule.delta-seconds"> 1519 <x:anchor-alias value="delta-seconds"/> 1507 1520 Age values are non-negative decimal integers, representing time in 1508 1521 seconds. 1509 1522 </t> 1510 1523 <figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="delta-seconds"/> 1511 delta-seconds = 1*DIGIT1524 <x:ref>delta-seconds</x:ref> = 1*<x:ref>DIGIT</x:ref> 1512 1525 </artwork></figure> 1513 1526 <t> … … 1525 1538 <iref primary="true" item="Cache-Control header" x:for-anchor=""/> 1526 1539 <iref primary="true" item="Headers" subitem="Cache-Control" x:for-anchor=""/> 1540 <x:anchor-alias value="Cache-Control"/> 1541 <x:anchor-alias value="cache-directive"/> 1542 <x:anchor-alias value="cache-extension"/> 1543 <x:anchor-alias value="cache-request-directive"/> 1544 <x:anchor-alias value="cache-response-directive"/> 1527 1545 <t> 1528 1546 The Cache-Control general-header field is used to specify directives … … 1547 1565 </t> 1548 1566 <figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="Cache-Control"/><iref primary="true" item="Grammar" subitem="cache-directive"/><iref primary="true" item="Grammar" subitem="cache-request-directive"/><iref primary="true" item="Grammar" subitem="cache-response-directive"/><iref primary="true" item="Grammar" subitem="cache-extension"/> 1549 Cache-Control = "Cache-Control" ":" 1#cache-directive1550 1551 cache-directive = cache-request-directive1552 | cache-response-directive1553 1554 cache-request-directive=1567 <x:ref>Cache-Control</x:ref> = "Cache-Control" ":" 1#<x:ref>cache-directive</x:ref> 1568 1569 <x:ref>cache-directive</x:ref> = <x:ref>cache-request-directive</x:ref> 1570 | <x:ref>cache-response-directive</x:ref> 1571 1572 <x:ref>cache-request-directive</x:ref> = 1555 1573 "no-cache" ; <xref target="what.is.cacheable"/> 1556 1574 | "no-store" ; <xref target="what.may.be.stored.by.caches"/> 1557 | "max-age" "=" delta-seconds; <xref target="modifications.of.the.basic.expiration.mechanism"/>, <xref format="counter" target="cache.revalidation.and.reload.controls"/>1558 | "max-stale" [ "=" delta-seconds] ; <xref target="modifications.of.the.basic.expiration.mechanism"/>1559 | "min-fresh" "=" delta-seconds; <xref target="modifications.of.the.basic.expiration.mechanism"/>1575 | "max-age" "=" <x:ref>delta-seconds</x:ref> ; <xref target="modifications.of.the.basic.expiration.mechanism"/>, <xref format="counter" target="cache.revalidation.and.reload.controls"/> 1576 | "max-stale" [ "=" <x:ref>delta-seconds</x:ref> ] ; <xref target="modifications.of.the.basic.expiration.mechanism"/> 1577 | "min-fresh" "=" <x:ref>delta-seconds</x:ref> ; <xref target="modifications.of.the.basic.expiration.mechanism"/> 1560 1578 | "no-transform" ; <xref target="no-transform.directive"/> 1561 1579 | "only-if-cached" ; <xref target="cache.revalidation.and.reload.controls"/> 1562 | cache-extension; <xref target="cache.control.extensions"/>1563 1564 cache-response-directive=1580 | <x:ref>cache-extension</x:ref> ; <xref target="cache.control.extensions"/> 1581 1582 <x:ref>cache-response-directive</x:ref> = 1565 1583 "public" ; <xref target="what.is.cacheable"/> 1566 | "private" [ "=" DQUOTE 1#field-name DQUOTE] ; <xref target="what.is.cacheable"/>1567 | "no-cache" [ "=" DQUOTE 1#field-name DQUOTE] ; <xref target="what.is.cacheable"/>1584 | "private" [ "=" <x:ref>DQUOTE</x:ref> 1#<x:ref>field-name</x:ref> <x:ref>DQUOTE</x:ref> ] ; <xref target="what.is.cacheable"/> 1585 | "no-cache" [ "=" <x:ref>DQUOTE</x:ref> 1#<x:ref>field-name</x:ref> <x:ref>DQUOTE</x:ref> ] ; <xref target="what.is.cacheable"/> 1568 1586 | "no-store" ; <xref target="what.may.be.stored.by.caches"/> 1569 1587 | "no-transform" ; <xref target="no-transform.directive"/> 1570 1588 | "must-revalidate" ; <xref target="cache.revalidation.and.reload.controls"/> 1571 1589 | "proxy-revalidate" ; <xref target="cache.revalidation.and.reload.controls"/> 1572 | "max-age" "=" delta-seconds; <xref target="modifications.of.the.basic.expiration.mechanism"/>1573 | "s-maxage" "=" delta-seconds; <xref target="modifications.of.the.basic.expiration.mechanism"/>1574 | cache-extension; <xref target="cache.control.extensions"/>1575 1576 cache-extension = token [ "=" ( token | quoted-string) ]1590 | "max-age" "=" <x:ref>delta-seconds</x:ref> ; <xref target="modifications.of.the.basic.expiration.mechanism"/> 1591 | "s-maxage" "=" <x:ref>delta-seconds</x:ref> ; <xref target="modifications.of.the.basic.expiration.mechanism"/> 1592 | <x:ref>cache-extension</x:ref> ; <xref target="cache.control.extensions"/> 1593 1594 <x:ref>cache-extension</x:ref> = <x:ref>token</x:ref> [ "=" ( <x:ref>token</x:ref> | <x:ref>quoted-string</x:ref> ) ] 1577 1595 </artwork></figure> 1578 1596 <t> … … 2069 2087 <iref primary="true" item="Expires header" x:for-anchor=""/> 2070 2088 <iref primary="true" item="Headers" subitem="Expires" x:for-anchor=""/> 2089 <x:anchor-alias value="Expires"/> 2071 2090 <t> 2072 2091 The Expires entity-header field gives the date/time after which the … … 2087 2106 </t> 2088 2107 <figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="Expires"/> 2089 Expires = "Expires" ":" HTTP-date2108 <x:ref>Expires</x:ref> = "Expires" ":" <x:ref>HTTP-date</x:ref> 2090 2109 </artwork></figure> 2091 2110 <t> … … 2129 2148 <iref primary="true" item="Pragma header" x:for-anchor=""/> 2130 2149 <iref primary="true" item="Headers" subitem="Pragma" x:for-anchor=""/> 2150 <x:anchor-alias value="extension-pragma"/> 2151 <x:anchor-alias value="Pragma"/> 2152 <x:anchor-alias value="pragma-directive"/> 2131 2153 <t> 2132 2154 The Pragma general-header field is used to include implementation-specific … … 2137 2159 </t> 2138 2160 <figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="Pragma"/><iref primary="true" item="Grammar" subitem="pragma-directive"/><iref primary="true" item="Grammar" subitem="extension-pragma"/> 2139 Pragma = "Pragma" ":" 1#pragma-directive2140 pragma-directive = "no-cache" | extension-pragma2141 extension-pragma = token [ "=" ( token | quoted-string) ]2161 <x:ref>Pragma</x:ref> = "Pragma" ":" 1#<x:ref>pragma-directive</x:ref> 2162 <x:ref>pragma-directive</x:ref> = "no-cache" | <x:ref>extension-pragma</x:ref> 2163 <x:ref>extension-pragma</x:ref> = <x:ref>token</x:ref> [ "=" ( <x:ref>token</x:ref> | <x:ref>quoted-string</x:ref> ) ] 2142 2164 </artwork></figure> 2143 2165 <t> … … 2173 2195 <iref primary="true" item="Vary header" x:for-anchor=""/> 2174 2196 <iref primary="true" item="Headers" subitem="Vary" x:for-anchor=""/> 2197 <x:anchor-alias value="Vary"/> 2175 2198 <t> 2176 2199 The Vary field value indicates the set of request-header fields that … … 2185 2208 </t> 2186 2209 <figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="Vary"/> 2187 Vary = "Vary" ":" ( "*" | 1#field-name)2210 <x:ref>Vary</x:ref> = "Vary" ":" ( "*" | 1#<x:ref>field-name</x:ref> ) 2188 2211 </artwork></figure> 2189 2212 <t> … … 2224 2247 <iref primary="true" item="Warning header" x:for-anchor=""/> 2225 2248 <iref primary="true" item="Headers" subitem="Warning" x:for-anchor=""/> 2249 <x:anchor-alias value="Warning"/> 2250 <x:anchor-alias value="warning-value"/> 2251 <x:anchor-alias value="warn-agent"/> 2252 <x:anchor-alias value="warn-code"/> 2253 <x:anchor-alias value="warn-date"/> 2254 <x:anchor-alias value="warn-text"/> 2226 2255 <t> 2227 2256 The Warning general-header field is used to carry additional … … 2236 2265 </t> 2237 2266 <figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="Warning"/><iref primary="true" item="Grammar" subitem="warning-value"/><iref primary="true" item="Grammar" subitem="warn-code"/><iref primary="true" item="Grammar" subitem="warn-agent"/><iref primary="true" item="Grammar" subitem="warn-text"/><iref primary="true" item="Grammar" subitem="warn-date"/> 2238 Warning = "Warning" ":" 1#warning-value2267 <x:ref>Warning</x:ref> = "Warning" ":" 1#<x:ref>warning-value</x:ref> 2239 2268 2240 warning-value = warn-code SP warn-agent SP warn-text2241 [ SP warn-date]2269 <x:ref>warning-value</x:ref> = <x:ref>warn-code</x:ref> <x:ref>SP</x:ref> <x:ref>warn-agent</x:ref> <x:ref>SP</x:ref> <x:ref>warn-text</x:ref> 2270 [<x:ref>SP</x:ref> <x:ref>warn-date</x:ref>] 2242 2271 2243 warn-code = 3DIGIT2244 warn-agent = ( uri-host [ ":" port ] ) | pseudonym2272 <x:ref>warn-code</x:ref> = 3<x:ref>DIGIT</x:ref> 2273 <x:ref>warn-agent</x:ref> = ( <x:ref>uri-host</x:ref> [ ":" <x:ref>port</x:ref> ] ) | <x:ref>pseudonym</x:ref> 2245 2274 ; the name or pseudonym of the server adding 2246 2275 ; the Warning header, for use in debugging 2247 warn-text = quoted-string2248 warn-date = DQUOTE HTTP-date DQUOTE2276 <x:ref>warn-text</x:ref> = <x:ref>quoted-string</x:ref> 2277 <x:ref>warn-date</x:ref> = <x:ref>DQUOTE</x:ref> <x:ref>HTTP-date</x:ref> <x:ref>DQUOTE</x:ref> 2249 2278 </artwork></figure> 2250 2279 <t>
Note: See TracChangeset
for help on using the changeset viewer.