draft-ietf-httpbis-p6-cache-06.txt | draft-ietf-httpbis-p6-cache-07.txt | |||
---|---|---|---|---|
HTTPbis Working Group R. Fielding, Ed. | HTTPbis Working Group R. Fielding, Ed. | |||
Internet-Draft Day Software | Internet-Draft Day Software | |||
Obsoletes: 2616 (if approved) J. Gettys | Obsoletes: 2616 (if approved) J. Gettys | |||
Intended status: Standards Track One Laptop per Child | Intended status: Standards Track One Laptop per Child | |||
Expires: September 10, 2009 J. Mogul | Expires: January 14, 2010 J. Mogul | |||
HP | HP | |||
H. Frystyk | H. Frystyk | |||
Microsoft | Microsoft | |||
L. Masinter | L. Masinter | |||
Adobe Systems | Adobe Systems | |||
P. Leach | P. Leach | |||
Microsoft | Microsoft | |||
T. Berners-Lee | T. Berners-Lee | |||
W3C/MIT | W3C/MIT | |||
Y. Lafon, Ed. | Y. Lafon, Ed. | |||
W3C | W3C | |||
M. Nottingham, Ed. | ||||
J. Reschke, Ed. | J. Reschke, Ed. | |||
greenbytes | greenbytes | |||
March 9, 2009 | July 13, 2009 | |||
HTTP/1.1, part 6: Caching | HTTP/1.1, part 6: Caching | |||
draft-ietf-httpbis-p6-cache-06 | draft-ietf-httpbis-p6-cache-07 | |||
Status of this Memo | Status of this Memo | |||
This Internet-Draft is submitted to IETF in full conformance with the | This Internet-Draft is submitted to IETF in full conformance with the | |||
provisions of BCP 78 and BCP 79. This document may contain material | provisions of BCP 78 and BCP 79. This document may contain material | |||
from IETF Documents or IETF Contributions published or made publicly | from IETF Documents or IETF Contributions published or made publicly | |||
available before November 10, 2008. The person(s) controlling the | available before November 10, 2008. The person(s) controlling the | |||
copyright in some of this material may not have granted the IETF | copyright in some of this material may not have granted the IETF | |||
Trust the right to allow modifications of such material outside the | Trust the right to allow modifications of such material outside the | |||
IETF Standards Process. Without obtaining an adequate license from | IETF Standards Process. Without obtaining an adequate license from | |||
skipping to change at page 2, line 4 | skipping to change at page 2, line 6 | |||
Internet-Drafts are working documents of the Internet Engineering | Internet-Drafts are working documents of the Internet Engineering | |||
Task Force (IETF), its areas, and its working groups. Note that | Task Force (IETF), its areas, and its working groups. Note that | |||
other groups may also distribute working documents as Internet- | other groups may also distribute working documents as Internet- | |||
Drafts. | Drafts. | |||
Internet-Drafts are draft documents valid for a maximum of six months | Internet-Drafts are draft documents valid for a maximum of six months | |||
and may be updated, replaced, or obsoleted by other documents at any | and may be updated, replaced, or obsoleted by other documents at any | |||
time. It is inappropriate to use Internet-Drafts as reference | time. It is inappropriate to use Internet-Drafts as reference | |||
material or to cite them other than as "work in progress." | material or to cite them other than as "work in progress." | |||
The list of current Internet-Drafts can be accessed at | The list of current Internet-Drafts can be accessed at | |||
http://www.ietf.org/ietf/1id-abstracts.txt. | http://www.ietf.org/ietf/1id-abstracts.txt. | |||
The list of Internet-Draft Shadow Directories can be accessed at | The list of Internet-Draft Shadow Directories can be accessed at | |||
http://www.ietf.org/shadow.html. | http://www.ietf.org/shadow.html. | |||
This Internet-Draft will expire on September 10, 2009. | This Internet-Draft will expire on January 14, 2010. | |||
Copyright Notice | Copyright Notice | |||
Copyright (c) 2009 IETF Trust and the persons identified as the | Copyright (c) 2009 IETF Trust and the persons identified as the | |||
document authors. All rights reserved. | document authors. All rights reserved. | |||
This document is subject to BCP 78 and the IETF Trust's Legal | This document is subject to BCP 78 and the IETF Trust's Legal | |||
Provisions Relating to IETF Documents in effect on the date of | Provisions Relating to IETF Documents in effect on the date of | |||
publication of this document (http://trustee.ietf.org/license-info). | publication of this document (http://trustee.ietf.org/license-info). | |||
Please review these documents carefully, as they describe your rights | Please review these documents carefully, as they describe your rights | |||
skipping to change at page 2, line 41 | skipping to change at page 2, line 44 | |||
or indicate cacheable response messages. | or indicate cacheable response messages. | |||
Editorial Note (To be removed by RFC Editor) | Editorial Note (To be removed by RFC Editor) | |||
Discussion of this draft should take place on the HTTPBIS working | Discussion of this draft should take place on the HTTPBIS working | |||
group mailing list (ietf-http-wg@w3.org). The current issues list is | group mailing list (ietf-http-wg@w3.org). The current issues list is | |||
at <http://tools.ietf.org/wg/httpbis/trac/report/11> and related | at <http://tools.ietf.org/wg/httpbis/trac/report/11> and related | |||
documents (including fancy diffs) can be found at | documents (including fancy diffs) can be found at | |||
<http://tools.ietf.org/wg/httpbis/>. | <http://tools.ietf.org/wg/httpbis/>. | |||
The changes in this draft are summarized in Appendix C.7. | The changes in this draft are summarized in Appendix C.8. | |||
Table of Contents | Table of Contents | |||
1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 5 | 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 5 | |||
1.1. Purpose . . . . . . . . . . . . . . . . . . . . . . . . . 5 | 1.1. Purpose . . . . . . . . . . . . . . . . . . . . . . . . . 5 | |||
1.2. Terminology . . . . . . . . . . . . . . . . . . . . . . . 5 | 1.2. Terminology . . . . . . . . . . . . . . . . . . . . . . . 5 | |||
1.3. Requirements . . . . . . . . . . . . . . . . . . . . . . . 6 | 1.3. Requirements . . . . . . . . . . . . . . . . . . . . . . . 6 | |||
1.4. Syntax Notation . . . . . . . . . . . . . . . . . . . . . 7 | 1.4. Syntax Notation . . . . . . . . . . . . . . . . . . . . . 7 | |||
1.4.1. Core Rules . . . . . . . . . . . . . . . . . . . . . . 7 | 1.4.1. Core Rules . . . . . . . . . . . . . . . . . . . . . . 7 | |||
1.4.2. ABNF Rules defined in other Parts of the | 1.4.2. ABNF Rules defined in other Parts of the | |||
skipping to change at page 3, line 27 | skipping to change at page 3, line 27 | |||
2.1.1. Storing Partial and Incomplete Responses . . . . . . . 8 | 2.1.1. Storing Partial and Incomplete Responses . . . . . . . 8 | |||
2.2. Constructing Responses from Caches . . . . . . . . . . . . 8 | 2.2. Constructing Responses from Caches . . . . . . . . . . . . 8 | |||
2.3. Freshness Model . . . . . . . . . . . . . . . . . . . . . 9 | 2.3. Freshness Model . . . . . . . . . . . . . . . . . . . . . 9 | |||
2.3.1. Calculating Freshness Lifetime . . . . . . . . . . . . 10 | 2.3.1. Calculating Freshness Lifetime . . . . . . . . . . . . 10 | |||
2.3.2. Calculating Age . . . . . . . . . . . . . . . . . . . 11 | 2.3.2. Calculating Age . . . . . . . . . . . . . . . . . . . 11 | |||
2.3.3. Serving Stale Responses . . . . . . . . . . . . . . . 13 | 2.3.3. Serving Stale Responses . . . . . . . . . . . . . . . 13 | |||
2.4. Validation Model . . . . . . . . . . . . . . . . . . . . . 13 | 2.4. Validation Model . . . . . . . . . . . . . . . . . . . . . 13 | |||
2.5. Request Methods that Invalidate . . . . . . . . . . . . . 14 | 2.5. Request Methods that Invalidate . . . . . . . . . . . . . 14 | |||
2.6. Caching Negotiated Responses . . . . . . . . . . . . . . . 15 | 2.6. Caching Negotiated Responses . . . . . . . . . . . . . . . 15 | |||
2.7. Combining Responses . . . . . . . . . . . . . . . . . . . 16 | 2.7. Combining Responses . . . . . . . . . . . . . . . . . . . 16 | |||
3. Header Field Definitions . . . . . . . . . . . . . . . . . . . 16 | 3. Header Field Definitions . . . . . . . . . . . . . . . . . . . 17 | |||
3.1. Age . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 | 3.1. Age . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 | |||
3.2. Cache-Control . . . . . . . . . . . . . . . . . . . . . . 17 | 3.2. Cache-Control . . . . . . . . . . . . . . . . . . . . . . 17 | |||
3.2.1. Request Cache-Control Directives . . . . . . . . . . . 18 | 3.2.1. Request Cache-Control Directives . . . . . . . . . . . 18 | |||
3.2.2. Response Cache-Control Directives . . . . . . . . . . 20 | 3.2.2. Response Cache-Control Directives . . . . . . . . . . 20 | |||
3.2.3. Cache Control Extensions . . . . . . . . . . . . . . . 22 | 3.2.3. Cache Control Extensions . . . . . . . . . . . . . . . 22 | |||
3.3. Expires . . . . . . . . . . . . . . . . . . . . . . . . . 23 | 3.3. Expires . . . . . . . . . . . . . . . . . . . . . . . . . 23 | |||
3.4. Pragma . . . . . . . . . . . . . . . . . . . . . . . . . . 23 | 3.4. Pragma . . . . . . . . . . . . . . . . . . . . . . . . . . 23 | |||
3.5. Vary . . . . . . . . . . . . . . . . . . . . . . . . . . . 24 | 3.5. Vary . . . . . . . . . . . . . . . . . . . . . . . . . . . 24 | |||
3.6. Warning . . . . . . . . . . . . . . . . . . . . . . . . . 25 | 3.6. Warning . . . . . . . . . . . . . . . . . . . . . . . . . 25 | |||
4. History Lists . . . . . . . . . . . . . . . . . . . . . . . . 28 | 4. History Lists . . . . . . . . . . . . . . . . . . . . . . . . 28 | |||
skipping to change at page 4, line 9 | skipping to change at page 4, line 9 | |||
Appendix B. Collected ABNF . . . . . . . . . . . . . . . . . . . 31 | Appendix B. Collected ABNF . . . . . . . . . . . . . . . . . . . 31 | |||
Appendix C. Change Log (to be removed by RFC Editor before | Appendix C. Change Log (to be removed by RFC Editor before | |||
publication) . . . . . . . . . . . . . . . . . . . . 33 | publication) . . . . . . . . . . . . . . . . . . . . 33 | |||
C.1. Since RFC2616 . . . . . . . . . . . . . . . . . . . . . . 33 | C.1. Since RFC2616 . . . . . . . . . . . . . . . . . . . . . . 33 | |||
C.2. Since draft-ietf-httpbis-p6-cache-00 . . . . . . . . . . . 33 | C.2. Since draft-ietf-httpbis-p6-cache-00 . . . . . . . . . . . 33 | |||
C.3. Since draft-ietf-httpbis-p6-cache-01 . . . . . . . . . . . 34 | C.3. Since draft-ietf-httpbis-p6-cache-01 . . . . . . . . . . . 34 | |||
C.4. Since draft-ietf-httpbis-p6-cache-02 . . . . . . . . . . . 34 | C.4. Since draft-ietf-httpbis-p6-cache-02 . . . . . . . . . . . 34 | |||
C.5. Since draft-ietf-httpbis-p6-cache-03 . . . . . . . . . . . 34 | C.5. Since draft-ietf-httpbis-p6-cache-03 . . . . . . . . . . . 34 | |||
C.6. Since draft-ietf-httpbis-p6-cache-04 . . . . . . . . . . . 35 | C.6. Since draft-ietf-httpbis-p6-cache-04 . . . . . . . . . . . 35 | |||
C.7. Since draft-ietf-httpbis-p6-cache-05 . . . . . . . . . . . 35 | C.7. Since draft-ietf-httpbis-p6-cache-05 . . . . . . . . . . . 35 | |||
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35 | C.8. Since draft-ietf-httpbis-p6-cache-06 . . . . . . . . . . . 35 | |||
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36 | ||||
Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . . 38 | Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . . 38 | |||
1. Introduction | 1. Introduction | |||
HTTP is typically used for distributed information systems, where | HTTP is typically used for distributed information systems, where | |||
performance can be improved by the use of response caches. This | performance can be improved by the use of response caches. This | |||
document defines aspects of HTTP/1.1 related to caching and reusing | document defines aspects of HTTP/1.1 related to caching and reusing | |||
response messages. | response messages. | |||
1.1. Purpose | 1.1. Purpose | |||
skipping to change at page 7, line 39 | skipping to change at page 7, line 39 | |||
quoted-string = <quoted-string, defined in [Part1], Section 1.2.2> | quoted-string = <quoted-string, defined in [Part1], Section 1.2.2> | |||
token = <token, defined in [Part1], Section 1.2.2> | token = <token, defined in [Part1], Section 1.2.2> | |||
OWS = <OWS, defined in [Part1], Section 1.2.2> | OWS = <OWS, defined in [Part1], Section 1.2.2> | |||
1.4.2. ABNF Rules defined in other Parts of the Specification | 1.4.2. ABNF Rules defined in other Parts of the Specification | |||
The ABNF rules below are defined in other parts: | The ABNF rules below are defined in other parts: | |||
field-name = <field-name, defined in [Part1], Section 4.2> | field-name = <field-name, defined in [Part1], Section 4.2> | |||
HTTP-date = <HTTP-date, defined in [Part1], Section 3.2.1> | HTTP-date = <HTTP-date, defined in [Part1], Section 3.2> | |||
port = <port, defined in [Part1], Section 2.1> | port = <port, defined in [Part1], Section 2.1> | |||
pseudonym = <pseudonym, defined in [Part1], Section 8.9> | pseudonym = <pseudonym, defined in [Part1], Section 8.9> | |||
uri-host = <uri-host, defined in [Part1], Section 2.1> | uri-host = <uri-host, defined in [Part1], Section 2.1> | |||
2. Cache Operation | 2. Cache Operation | |||
2.1. Response Cacheability | 2.1. Response Cacheability | |||
A cache MUST NOT store a response to any request, unless: | A cache MUST NOT store a response to any request, unless: | |||
skipping to change at page 8, line 45 | skipping to change at page 8, line 45 | |||
A cache that does not support the Range and Content-Range headers | A cache that does not support the Range and Content-Range headers | |||
MUST NOT store incomplete or partial responses. | MUST NOT store incomplete or partial responses. | |||
2.2. Constructing Responses from Caches | 2.2. Constructing Responses from Caches | |||
For a presented request, a cache MUST NOT return a stored response, | For a presented request, a cache MUST NOT return a stored response, | |||
unless: | unless: | |||
o The presented Request-URI and that of the stored response match | o The presented Request-URI and that of the stored response match | |||
(see [[anchor1: TBD]]), and | ([[TODO-Request-URI: Need to find a new term for this, as Part 1 | |||
doesn't define Request-URI anymore; the new term request-target | ||||
does not work for this.]]), and | ||||
o the request method associated with the stored response allows it | o the request method associated with the stored response allows it | |||
to be used for the presented request, and | to be used for the presented request, and | |||
o selecting request-headers nominated by the stored response (if | o selecting request-headers nominated by the stored response (if | |||
any) match those presented (see Section 2.6), and | any) match those presented (see Section 2.6), and | |||
o the presented request and stored response are free from directives | o the presented request and stored response are free from directives | |||
that would prevent its use (see Section 3.2 and Section 3.4), and | that would prevent its use (see Section 3.2 and Section 3.4), and | |||
o the stored response is either: | o the stored response is either: | |||
* fresh (see Section 2.3), or | * fresh (see Section 2.3), or | |||
* allowed to be served stale (see Section 2.3.3), or | * allowed to be served stale (see Section 2.3.3), or | |||
* successfully validated (see Section 2.4). | * successfully validated (see Section 2.4). | |||
skipping to change at page 9, line 15 | skipping to change at page 9, line 18 | |||
that would prevent its use (see Section 3.2 and Section 3.4), and | that would prevent its use (see Section 3.2 and Section 3.4), and | |||
o the stored response is either: | o the stored response is either: | |||
* fresh (see Section 2.3), or | * fresh (see Section 2.3), or | |||
* allowed to be served stale (see Section 2.3.3), or | * allowed to be served stale (see Section 2.3.3), or | |||
* successfully validated (see Section 2.4). | * successfully validated (see Section 2.4). | |||
[[anchor2: TODO: define method cacheability for GET, HEAD and POST in | [[TODO-method-cacheability: define method cacheability for GET, HEAD | |||
p2-semantics.]] | and POST in p2-semantics.]] | |||
When a stored response is used to satisfy a request, caches MUST | When a stored response is used to satisfy a request, caches MUST | |||
include a single Age header field Section 3.1 in the response with a | include a single Age header field (Section 3.1) in the response with | |||
value equal to the stored response's current_age; see Section 2.3.2. | a value equal to the stored response's current_age; see | |||
[[anchor3: DISCUSS: this currently includes successfully validated | Section 2.3.2. [[anchor1: DISCUSS: this currently includes | |||
responses.]] | successfully validated responses.]] | |||
Requests with methods that are unsafe (Section 7.1.1 of [Part2]) MUST | Requests with methods that are unsafe (Section 7.1.1 of [Part2]) MUST | |||
be written through the cache to the origin server; i.e., A cache must | be written through the cache to the origin server; i.e., A cache must | |||
not reply to such a request before having forwarded the request and | not reply to such a request before having forwarded the request and | |||
having received a corresponding response. | having received a corresponding response. | |||
Also, note that unsafe requests might invalidate already stored | Also, note that unsafe requests might invalidate already stored | |||
responses; see Section 2.5. | responses; see Section 2.5. | |||
Caches MUST use the most recent response (as determined by the Date | Caches MUST use the most recent response (as determined by the Date | |||
header) when more than one suitable response is stored. They can | header) when more than one suitable response is stored. They can | |||
also forward a request with "Cache-Control: max-age=0" or "Cache- | also forward a request with "Cache-Control: max-age=0" or "Cache- | |||
Control: no-cache" to disambiguate which response to use. | Control: no-cache" to disambiguate which response to use. | |||
[[anchor4: TODO: end-to-end and hop-by-hop headers, non-modifiable | [[TODO-header-properties: end-to-end and hop-by-hop headers, non- | |||
headers removed; re-spec in p1]] | modifiable headers removed; re-spec in p1]] | |||
2.3. Freshness Model | 2.3. Freshness Model | |||
When a response is "fresh" in the cache, it can be used to satisfy | When a response is "fresh" in the cache, it can be used to satisfy | |||
subsequent requests without contacting the origin server, thereby | subsequent requests without contacting the origin server, thereby | |||
improving efficiency. | improving efficiency. | |||
The primary mechanism for determining freshness is for an origin | The primary mechanism for determining freshness is for an origin | |||
server to provide an explicit expiration time in the future, using | server to provide an explicit expiration time in the future, using | |||
either the Expires header (Section 3.3) or the max-age response cache | either the Expires header (Section 3.3) or the max-age response cache | |||
directive (Section 3.2.2). Generally, origin servers will assign | directive (Section 3.2.2). Generally, origin servers will assign | |||
future explicit expiration times to responses in the belief that the | future explicit expiration times to responses in the belief that the | |||
entity is not likely to change in a semantically significant way | entity is not likely to change in a semantically significant way | |||
before the expiration time is reached. | before the expiration time is reached. | |||
If an origin server wishes to force a cache to validate every | If an origin server wishes to force a cache to validate every | |||
request, it can assign an explicit expiration time in the past. This | request, it can assign an explicit expiration time in the past. This | |||
means that the response is always stale, so that caches should | means that the response is always stale, so that caches should | |||
validate it before using it for subsequent requests. [[anchor5: This | validate it before using it for subsequent requests. [[anchor2: This | |||
wording may cause confusion, because the response may still be served | wording may cause confusion, because the response may still be served | |||
stale.]] | stale.]] | |||
Since origin servers do not always provide explicit expiration times, | Since origin servers do not always provide explicit expiration times, | |||
HTTP caches may also assign heuristic expiration times when they are | HTTP caches may also assign heuristic expiration times when they are | |||
not specified, employing algorithms that use other header values | not specified, employing algorithms that use other header values | |||
(such as the Last-Modified time) to estimate a plausible expiration | (such as the Last-Modified time) to estimate a plausible expiration | |||
time. The HTTP/1.1 specification does not provide specific | time. The HTTP/1.1 specification does not provide specific | |||
algorithms, but does impose worst-case constraints on their results. | algorithms, but does impose worst-case constraints on their results. | |||
skipping to change at page 10, line 32 | skipping to change at page 10, line 35 | |||
response_is_fresh = (freshness_lifetime > current_age) | response_is_fresh = (freshness_lifetime > current_age) | |||
The freshness_lifetime is defined in Section 2.3.1; the current_age | The freshness_lifetime is defined in Section 2.3.1; the current_age | |||
is defined in Section 2.3.2. | is defined in Section 2.3.2. | |||
Additionally, clients may need to influence freshness calculation. | Additionally, clients may need to influence freshness calculation. | |||
They can do this using several request cache directives, with the | They can do this using several request cache directives, with the | |||
effect of either increasing or loosening constraints on freshness. | effect of either increasing or loosening constraints on freshness. | |||
See Section 3.2.1. | See Section 3.2.1. | |||
[[anchor6: ISSUE: there are not requirements directly applying to | [[anchor3: ISSUE: there are not requirements directly applying to | |||
cache-request-directives and freshness.]] | cache-request-directives and freshness.]] | |||
Note that freshness applies only to cache operation; it cannot be | Note that freshness applies only to cache operation; it cannot be | |||
used to force a user agent to refresh its display or reload a | used to force a user agent to refresh its display or reload a | |||
resource. See Section 4 for an explanation of the difference between | resource. See Section 4 for an explanation of the difference between | |||
caches and history mechanisms. | caches and history mechanisms. | |||
2.3.1. Calculating Freshness Lifetime | 2.3.1. Calculating Freshness Lifetime | |||
A cache can calculate the freshness lifetime (denoted as | A cache can calculate the freshness lifetime (denoted as | |||
skipping to change at page 11, line 30 | skipping to change at page 11, line 33 | |||
When a heuristic is used to calculate freshness lifetime, the cache | When a heuristic is used to calculate freshness lifetime, the cache | |||
SHOULD attach a Warning header with a 113 warn-code to the response | SHOULD attach a Warning header with a 113 warn-code to the response | |||
if its current_age is more than 24 hours and such a warning is not | if its current_age is more than 24 hours and such a warning is not | |||
already present. | already present. | |||
Also, if the response has a Last-Modified header (Section 6.6 of | Also, if the response has a Last-Modified header (Section 6.6 of | |||
[Part4]), the heuristic expiration value SHOULD be no more than some | [Part4]), the heuristic expiration value SHOULD be no more than some | |||
fraction of the interval since that time. A typical setting of this | fraction of the interval since that time. A typical setting of this | |||
fraction might be 10%. | fraction might be 10%. | |||
[[anchor7: REVIEW: took away HTTP/1.0 query string heuristic | [[anchor4: REVIEW: took away HTTP/1.0 query string heuristic | |||
uncacheability.]] | uncacheability.]] | |||
2.3.2. Calculating Age | 2.3.2. Calculating Age | |||
HTTP/1.1 uses the Age response-header to convey the estimated age of | HTTP/1.1 uses the Age response-header to convey the estimated age of | |||
the response message when obtained from a cache. The Age field value | the response message when obtained from a cache. The Age field value | |||
is the cache's estimate of the amount of time since the response was | is the cache's estimate of the amount of time since the response was | |||
generated or validated by the origin server. In essence, the Age | generated or validated by the origin server. In essence, the Age | |||
value is the sum of the time that the response has been resident in | value is the sum of the time that the response has been resident in | |||
each of the caches along the path from the origin server, plus the | each of the caches along the path from the origin server, plus the | |||
skipping to change at page 13, line 36 | skipping to change at page 13, line 50 | |||
If a cache receives a first-hand response (either an entire response, | If a cache receives a first-hand response (either an entire response, | |||
or a 304 (Not Modified) response) that it would normally forward to | or a 304 (Not Modified) response) that it would normally forward to | |||
the requesting client, and the received response is no longer fresh, | the requesting client, and the received response is no longer fresh, | |||
the cache SHOULD forward it to the requesting client without adding a | the cache SHOULD forward it to the requesting client without adding a | |||
new Warning (but without removing any existing Warning headers). A | new Warning (but without removing any existing Warning headers). A | |||
cache SHOULD NOT attempt to validate a response simply because that | cache SHOULD NOT attempt to validate a response simply because that | |||
response became stale in transit. | response became stale in transit. | |||
2.4. Validation Model | 2.4. Validation Model | |||
Checking with the origin server to see if a stale or otherwise | When a cache has one or more stored responses for a requested URI, | |||
unusable cached response can be reused is called "validating" or | but cannot serve any of them (e.g., because they are not fresh, or | |||
"revalidating." Doing so potentially avoids the overhead of | one cannot be selected; see Section 2.6), it can use the conditional | |||
retransmitting the response body when the stored response is valid. | request mechanism [Part4] in the forwarded request to give the origin | |||
server an opportunity to both select a valid stored response to be | ||||
used, and to update it. This process is known as "validating" or | ||||
"revalidating" the stored response. | ||||
HTTP's conditional request mechanism [Part4] is used for this | When sending such a conditional request, the cache SHOULD add an If- | |||
purpose. When a stored response includes one or more validators, | Modified-Since header whose value is that of the Last-Modified header | |||
such as the field values of an ETag or Last-Modified header field, | from the selected (see Section 2.6) stored response, if available. | |||
then a validating request SHOULD be made conditional to those field | ||||
values. | Additionally, the cache SHOULD add an If-None-Match header whose | |||
value is that of the ETag header(s) from all responses stored for the | ||||
requested URI, if present. However, if any of the stored responses | ||||
contains only partial content, its entity-tag SHOULD NOT be included | ||||
in the If-None-Match header field unless the request is for a range | ||||
that would be fully satisfied by that stored response. | ||||
A 304 (Not Modified) response status code indicates that the stored | A 304 (Not Modified) response status code indicates that the stored | |||
response can be updated and reused; see Section 2.7. | response can be updated and reused; see Section 2.7. | |||
If instead the cache receives a full response (i.e., one with a | A full response (i.e., one with a response body) indicates that none | |||
response body), it is used to satisfy the request and replace the | of the stored responses nominated in the conditional request is | |||
stored response. [[anchor8: Should there be a requirement here?]] | suitable. Instead, the full response is used both to satisfy the | |||
request and replace the stored response. [[anchor5: Should there be a | ||||
requirement here?]] | ||||
If a cache receives a 5xx response while attempting to validate a | If a cache receives a 5xx response while attempting to validate a | |||
response, it MAY either forward this response to the requesting | response, it MAY either forward this response to the requesting | |||
client, or act as if the server failed to respond. In the latter | client, or act as if the server failed to respond. In the latter | |||
case, it MAY return a previously stored response (which SHOULD | case, it MAY return a previously stored response (see Section 2.3.3). | |||
include the 111 warn-code; see Section 3.6) unless the stored | ||||
response includes the "must-revalidate" cache directive (see | If a cache receives a successful response whose Content-Location | |||
Section 2.3.3). | field matches that of an existing stored response for the same | |||
Request-URI, whose entity-tag differs from that of the existing | ||||
stored response, and whose Date is more recent than that of the | ||||
existing response, the existing response SHOULD NOT be returned in | ||||
response to future requests and SHOULD be deleted from the cache. | ||||
[[anchor6: DISCUSS: Not sure if this is necessary.]] | ||||
2.5. Request Methods that Invalidate | 2.5. Request Methods that Invalidate | |||
Because unsafe methods (Section 7.1.1 of [Part2]) have the potential | Because unsafe methods (Section 7.1.1 of [Part2]) have the potential | |||
for changing state on the origin server, intervening caches can use | for changing state on the origin server, intervening caches can use | |||
them to keep their contents up-to-date. | them to keep their contents up-to-date. | |||
The following HTTP methods MUST cause a cache to invalidate the | The following HTTP methods MUST cause a cache to invalidate the | |||
Request-URI as well as the Location and Content-Location headers (if | Request-URI as well as the URI(s) in the Location and Content- | |||
present): | Location headers (if present): | |||
o PUT | o PUT | |||
o DELETE | o DELETE | |||
o POST | o POST | |||
An invalidation based on the URI in a Location or Content-Location | An invalidation based on a URI from a Location or Content-Location | |||
header MUST NOT be performed if the host part of that URI differs | header MUST NOT be performed if the host part of that URI differs | |||
from the host part in the Request-URI. This helps prevent denial of | from the host part in the Request-URI. This helps prevent denial of | |||
service attacks. | service attacks. | |||
[[anchor9: TODO: "host part" needs to be specified better.]] | [[anchor7: TODO: "host part" needs to be specified better.]] | |||
A cache that passes through requests for methods it does not | A cache that passes through requests for methods it does not | |||
understand SHOULD invalidate the Request-URI. | understand SHOULD invalidate the Request-URI. | |||
Here, "invalidate" means that the cache will either remove all stored | Here, "invalidate" means that the cache will either remove all stored | |||
responses related to the Request-URI, or will mark these as "invalid" | responses related to the Request-URI, or will mark these as "invalid" | |||
and in need of a mandatory validation before they can be returned in | and in need of a mandatory validation before they can be returned in | |||
response to a subsequent request. | response to a subsequent request. | |||
Note that this does not guarantee that all appropriate responses are | Note that this does not guarantee that all appropriate responses are | |||
invalidated. For example, the request that caused the change at the | invalidated. For example, the request that caused the change at the | |||
origin server might not have gone through the cache where a response | origin server might not have gone through the cache where a response | |||
is stored. | is stored. | |||
[[anchor10: TODO: specify that only successful (2xx, 3xx?) responses | [[anchor8: TODO: specify that only successful (2xx, 3xx?) responses | |||
invalidate.]] | invalidate.]] | |||
2.6. Caching Negotiated Responses | 2.6. Caching Negotiated Responses | |||
Use of server-driven content negotiation (Section 4.1 of [Part3]) | ||||
alters the conditions under which a cache can use the response for | ||||
subsequent requests. | ||||
When a cache receives a request that can be satisfied by a stored | When a cache receives a request that can be satisfied by a stored | |||
response that includes a Vary header field (Section 3.5), it MUST NOT | response that has a Vary header field (Section 3.5), it MUST NOT use | |||
use that response unless all of the selecting request-headers in the | that response unless all of the selecting request-headers nominated | |||
presented request match the corresponding stored request-headers from | by the Vary header match in both the original request (i.e., that | |||
the original request. | associated with the stored response), and the presented request. | |||
The selecting request-headers from two requests are defined to match | The selecting request-headers from two requests are defined to match | |||
if and only if the selecting request-headers in the first request can | if and only if the selecting request-headers in the first request can | |||
be transformed to the selecting request-headers in the second request | be transformed to the selecting request-headers in the second request | |||
by adding or removing linear white space [[anchor11: [ref]]] at | by adding or removing linear white space [[anchor9: [ref]]] at places | |||
places where this is allowed by the corresponding ABNF, and/or | where this is allowed by the corresponding ABNF, and/or combining | |||
combining multiple message-header fields with the same field name | multiple message-header fields with the same field name following the | |||
following the rules about message headers in Section 4.2 of [Part1]. | rules about message headers in Section 4.2 of [Part1]. | |||
[[anchor12: DISCUSS: header-specific canonicalisation]] | ||||
If a header field is absent from a request, it can only match another | ||||
request if it is also absent there. | ||||
A Vary header field-value of "*" always fails to match, and | A Vary header field-value of "*" always fails to match, and | |||
subsequent requests to that resource can only be properly interpreted | subsequent requests to that resource can only be properly interpreted | |||
by the origin server. | by the origin server. | |||
If no stored response matches, the cache MAY forward the presented | The stored response with matching selecting request-headers is known | |||
request to the origin server in a conditional request, and SHOULD | as the selected response. | |||
include all ETags stored with potentially suitable responses in an | ||||
If-None-Match request header. If the server responds with 304 (Not | ||||
Modified) and includes an entity tag or Content-Location that | ||||
indicates the entity to be used, that cached response MUST be used to | ||||
satisfy the presented request, and SHOULD be used to update the | ||||
corresponding stored response; see Section 2.7. | ||||
If any of the stored responses contains only partial content, its | ||||
entity-tag SHOULD NOT be included in the If-None-Match header field | ||||
unless the request is for a range that would be fully satisfied by | ||||
that stored response. | ||||
If a cache receives a successful response whose Content-Location | If no selected response is available, the cache MAY forward the | |||
field matches that of an existing stored response for the same | presented request to the origin server in a conditional request; see | |||
Request-URI, whose entity-tag differs from that of the existing | Section 2.4. | |||
stored response, and whose Date is more recent than that of the | ||||
existing response, the existing response SHOULD NOT be returned in | ||||
response to future requests and SHOULD be deleted from the | ||||
cache.[[anchor13: DISCUSS: Not sure if this is necessary.]] | ||||
2.7. Combining Responses | 2.7. Combining Responses | |||
When a cache receives a 304 (Not Modified) response or a 206 (Partial | When a cache receives a 304 (Not Modified) response or a 206 (Partial | |||
Content) response, it needs to update the stored response with the | Content) response (in this section, the "new" response"), it needs to | |||
new one, so that the updated response can be sent to the client. | created an updated response by combining the stored response with the | |||
new one, so that the updated response can be used to satisfy the | ||||
request. | ||||
If the status code is 304 (Not Modified), the cache SHOULD use the | If the new response contains an ETag, it identifies the stored | |||
stored entity-body as the updated entity-body. If the status code is | response to use. [[anchor10: may need language about Content-Location | |||
206 (Partial Content) and the ETag or Last-Modified headers match | here]][[anchor11: cover case where INM with multiple etags was sent]] | |||
exactly, the cache MAY combine the stored entity-body in the stored | ||||
response with the updated entity-body received in the response and | ||||
use the result as the updated entity-body (see Section 4 of [Part5]). | ||||
The stored response headers are used for the updated response, except | If the status code is 206 (partial content), both the stored and new | |||
that | responses MUST have ETags, and those ETags MUST match using the | |||
strong comparison function (see Section 4 of [Part4]). Otherwise, | ||||
the responses MUST NOT be combined. | ||||
The stored response headers are used as those of the updated | ||||
response, except that | ||||
o any stored Warning headers with warn-code 1xx (see Section 3.6) | o any stored Warning headers with warn-code 1xx (see Section 3.6) | |||
MUST be deleted from the stored response and the forwarded | MUST be deleted from the stored response and the updated response. | |||
response. | ||||
o any stored Warning headers with warn-code 2xx MUST be retained in | o any stored Warning headers with warn-code 2xx MUST be retained in | |||
the stored response and the forwarded response. | the stored response and the updated response. | |||
o any headers provided in the 304 or 206 response MUST replace the | o any headers provided in the new response MUST replace the | |||
corresponding headers from the stored response. | corresponding headers from the stored response. | |||
A cache MUST also replace any stored headers with corresponding | If a header field-name in the new response matches more than one | |||
headers received in the incoming response, except for Warning headers | header in the stored response, all such stored headers MUST be | |||
as described immediately above. If a header field-name in the | replaced. | |||
incoming response matches more than one header in the stored | ||||
response, all such old headers MUST be replaced. It MAY store the | ||||
combined entity-body. | ||||
[[anchor14: ISSUE: discuss how to handle HEAD updates]] | The updated response can [[[[anchor12: requirement?]]]] be used to | |||
replace the stored response in cache. In the case of a 206 response, | ||||
the combined entity-body MAY be stored. | ||||
[[anchor13: ISSUE: discuss how to handle HEAD updates]] | ||||
3. Header Field Definitions | 3. Header Field Definitions | |||
This section defines the syntax and semantics of HTTP/1.1 header | This section defines the syntax and semantics of HTTP/1.1 header | |||
fields related to caching. | fields related to caching. | |||
For entity-header fields, both sender and recipient refer to either | For entity-header fields, both sender and recipient refer to either | |||
the client or the server, depending on who sends and who receives the | the client or the server, depending on who sends and who receives the | |||
entity. | entity. | |||
3.1. Age | 3.1. Age | |||
The response-header field "Age" conveys the sender's estimate of the | The response-header field "Age" conveys the sender's estimate of the | |||
amount of time since the response (or its validation) was generated | amount of time since the response (or its validation) was generated | |||
at the origin server. Age values are calculated as specified in | at the origin server. Age values are calculated as specified in | |||
Section 2.3.2. | Section 2.3.2. | |||
Age = "Age" ":" OWS Age-v | Age = "Age" ":" OWS Age-v | |||
Age-v = delta-seconds | Age-v = delta-seconds | |||
Age field-values are non-negative decimal integers, representing time | Age field-values are non-negative integers, representing time in | |||
in seconds. | seconds. | |||
delta-seconds = 1*DIGIT | delta-seconds = 1*DIGIT | |||
If a cache receives a value larger than the largest positive integer | If a cache receives a value larger than the largest positive integer | |||
it can represent, or if any of its age calculations overflows, it | it can represent, or if any of its age calculations overflows, it | |||
MUST transmit an Age header with a field-value of 2147483648 (2^31). | MUST transmit an Age header with a field-value of 2147483648 (2^31). | |||
Caches SHOULD use an arithmetic type of at least 31 bits of range. | Caches SHOULD use an arithmetic type of at least 31 bits of range. | |||
The presence of an Age header field in a response implies that a | The presence of an Age header field in a response implies that a | |||
response is not first-hand. However, the converse is not true, since | response is not first-hand. However, the converse is not true, since | |||
skipping to change at page 19, line 13 | skipping to change at page 19, line 21 | |||
client is not willing to accept a stale response. | client is not willing to accept a stale response. | |||
max-stale | max-stale | |||
The max-stale request directive indicates that the client is | The max-stale request directive indicates that the client is | |||
willing to accept a response that has exceeded its expiration | willing to accept a response that has exceeded its expiration | |||
time. If max-stale is assigned a value, then the client is | time. If max-stale is assigned a value, then the client is | |||
willing to accept a response that has exceeded its expiration time | willing to accept a response that has exceeded its expiration time | |||
by no more than the specified number of seconds. If no value is | by no more than the specified number of seconds. If no value is | |||
assigned to max-stale, then the client is willing to accept a | assigned to max-stale, then the client is willing to accept a | |||
stale response of any age. [[anchor15: of any staleness? --mnot]] | stale response of any age. [[anchor14: of any staleness? --mnot]] | |||
min-fresh | min-fresh | |||
The min-fresh request directive indicates that the client is | The min-fresh request directive indicates that the client is | |||
willing to accept a response whose freshness lifetime is no less | willing to accept a response whose freshness lifetime is no less | |||
than its current age plus the specified time in seconds. That is, | than its current age plus the specified time in seconds. That is, | |||
the client wants a response that will still be fresh for at least | the client wants a response that will still be fresh for at least | |||
the specified number of seconds. | the specified number of seconds. | |||
no-transform | no-transform | |||
skipping to change at page 20, line 51 | skipping to change at page 20, line 51 | |||
no-cache | no-cache | |||
The no-cache response directive indicates that the response MUST | The no-cache response directive indicates that the response MUST | |||
NOT be used to satisfy a subsequent request without successful | NOT be used to satisfy a subsequent request without successful | |||
validation on the origin server. This allows an origin server to | validation on the origin server. This allows an origin server to | |||
prevent caching even by caches that have been configured to return | prevent caching even by caches that have been configured to return | |||
stale responses. | stale responses. | |||
If the no-cache response directive specifies one or more field- | If the no-cache response directive specifies one or more field- | |||
names, this requirement is limited to the field-values assosicated | names, this requirement is limited to the field-values associated | |||
with the listed response headers. That is, the specified field- | with the listed response headers. That is, the specified field- | |||
name(s) MUST NOT be sent in the response to a subsequent request | name(s) MUST NOT be sent in the response to a subsequent request | |||
without successful validation on the origin server. This allows | without successful validation on the origin server. This allows | |||
an origin server to prevent the re-use of certain header fields in | an origin server to prevent the re-use of certain header fields in | |||
a response, while still allowing caching of the rest of the | a response, while still allowing caching of the rest of the | |||
response. | response. | |||
Note: Most HTTP/1.0 caches will not recognize or obey this | Note: Most HTTP/1.0 caches will not recognize or obey this | |||
directive. | directive. | |||
skipping to change at page 23, line 26 | skipping to change at page 23, line 26 | |||
The entity-header field "Expires" gives the date/time after which the | The entity-header field "Expires" gives the date/time after which the | |||
response is considered stale. See Section 2.3 for further discussion | response is considered stale. See Section 2.3 for further discussion | |||
of the freshness model. | of the freshness model. | |||
The presence of an Expires field does not imply that the original | The presence of an Expires field does not imply that the original | |||
resource will change or cease to exist at, before, or after that | resource will change or cease to exist at, before, or after that | |||
time. | time. | |||
The field-value is an absolute date and time as defined by HTTP-date | The field-value is an absolute date and time as defined by HTTP-date | |||
in Section 3.2.1 of [Part1]; it MUST be sent in rfc1123-date format. | in Section 3.2 of [Part1]; it MUST be sent in rfc1123-date format. | |||
Expires = "Expires" ":" OWS Expires-v | Expires = "Expires" ":" OWS Expires-v | |||
Expires-v = HTTP-date | Expires-v = HTTP-date | |||
For example | For example | |||
Expires: Thu, 01 Dec 1994 16:00:00 GMT | Expires: Thu, 01 Dec 1994 16:00:00 GMT | |||
Note: if a response includes a Cache-Control field with the max- | Note: if a response includes a Cache-Control field with the max- | |||
age directive (see Section 3.2.2), that directive overrides the | age directive (see Section 3.2.2), that directive overrides the | |||
skipping to change at page 29, line 48 | skipping to change at page 29, line 48 | |||
[ISO-8859-1] | [ISO-8859-1] | |||
International Organization for Standardization, | International Organization for Standardization, | |||
"Information technology -- 8-bit single-byte coded graphic | "Information technology -- 8-bit single-byte coded graphic | |||
character sets -- Part 1: Latin alphabet No. 1", ISO/ | character sets -- Part 1: Latin alphabet No. 1", ISO/ | |||
IEC 8859-1:1998, 1998. | IEC 8859-1:1998, 1998. | |||
[Part1] Fielding, R., Ed., Gettys, J., Mogul, J., Frystyk, H., | [Part1] Fielding, R., Ed., Gettys, J., Mogul, J., Frystyk, H., | |||
Masinter, L., Leach, P., Berners-Lee, T., Lafon, Y., Ed., | Masinter, L., Leach, P., Berners-Lee, T., Lafon, Y., Ed., | |||
and J. Reschke, Ed., "HTTP/1.1, part 1: URIs, Connections, | and J. Reschke, Ed., "HTTP/1.1, part 1: URIs, Connections, | |||
and Message Parsing", draft-ietf-httpbis-p1-messaging-06 | and Message Parsing", draft-ietf-httpbis-p1-messaging-07 | |||
(work in progress), March 2009. | (work in progress), July 2009. | |||
[Part2] Fielding, R., Ed., Gettys, J., Mogul, J., Frystyk, H., | [Part2] Fielding, R., Ed., Gettys, J., Mogul, J., Frystyk, H., | |||
Masinter, L., Leach, P., Berners-Lee, T., Lafon, Y., Ed., | Masinter, L., Leach, P., Berners-Lee, T., Lafon, Y., Ed., | |||
and J. Reschke, Ed., "HTTP/1.1, part 2: Message | and J. Reschke, Ed., "HTTP/1.1, part 2: Message | |||
Semantics", draft-ietf-httpbis-p2-semantics-06 (work in | Semantics", draft-ietf-httpbis-p2-semantics-07 (work in | |||
progress), March 2009. | progress), July 2009. | |||
[Part3] Fielding, R., Ed., Gettys, J., Mogul, J., Frystyk, H., | [Part3] Fielding, R., Ed., Gettys, J., Mogul, J., Frystyk, H., | |||
Masinter, L., Leach, P., Berners-Lee, T., Lafon, Y., Ed., | Masinter, L., Leach, P., Berners-Lee, T., Lafon, Y., Ed., | |||
and J. Reschke, Ed., "HTTP/1.1, part 3: Message Payload | and J. Reschke, Ed., "HTTP/1.1, part 3: Message Payload | |||
and Content Negotiation", draft-ietf-httpbis-p3-payload-06 | and Content Negotiation", draft-ietf-httpbis-p3-payload-07 | |||
(work in progress), March 2009. | (work in progress), July 2009. | |||
[Part4] Fielding, R., Ed., Gettys, J., Mogul, J., Frystyk, H., | [Part4] Fielding, R., Ed., Gettys, J., Mogul, J., Frystyk, H., | |||
Masinter, L., Leach, P., Berners-Lee, T., Lafon, Y., Ed., | Masinter, L., Leach, P., Berners-Lee, T., Lafon, Y., Ed., | |||
and J. Reschke, Ed., "HTTP/1.1, part 4: Conditional | and J. Reschke, Ed., "HTTP/1.1, part 4: Conditional | |||
Requests", draft-ietf-httpbis-p4-conditional-06 (work in | Requests", draft-ietf-httpbis-p4-conditional-07 (work in | |||
progress), March 2009. | progress), July 2009. | |||
[Part5] Fielding, R., Ed., Gettys, J., Mogul, J., Frystyk, H., | [Part5] Fielding, R., Ed., Gettys, J., Mogul, J., Frystyk, H., | |||
Masinter, L., Leach, P., Berners-Lee, T., Lafon, Y., Ed., | Masinter, L., Leach, P., Berners-Lee, T., Lafon, Y., Ed., | |||
and J. Reschke, Ed., "HTTP/1.1, part 5: Range Requests and | and J. Reschke, Ed., "HTTP/1.1, part 5: Range Requests and | |||
Partial Responses", draft-ietf-httpbis-p5-range-06 (work | Partial Responses", draft-ietf-httpbis-p5-range-07 (work | |||
in progress), March 2009. | in progress), July 2009. | |||
[Part7] Fielding, R., Ed., Gettys, J., Mogul, J., Frystyk, H., | [Part7] Fielding, R., Ed., Gettys, J., Mogul, J., Frystyk, H., | |||
Masinter, L., Leach, P., Berners-Lee, T., Lafon, Y., Ed., | Masinter, L., Leach, P., Berners-Lee, T., Lafon, Y., Ed., | |||
and J. Reschke, Ed., "HTTP/1.1, part 7: Authentication", | and J. Reschke, Ed., "HTTP/1.1, part 7: Authentication", | |||
draft-ietf-httpbis-p7-auth-06 (work in progress), | draft-ietf-httpbis-p7-auth-07 (work in progress), | |||
March 2009. | July 2009. | |||
[RFC2047] Moore, K., "MIME (Multipurpose Internet Mail Extensions) | [RFC2047] Moore, K., "MIME (Multipurpose Internet Mail Extensions) | |||
Part Three: Message Header Extensions for Non-ASCII Text", | Part Three: Message Header Extensions for Non-ASCII Text", | |||
RFC 2047, November 1996. | RFC 2047, November 1996. | |||
[RFC2119] Bradner, S., "Key words for use in RFCs to Indicate | [RFC2119] Bradner, S., "Key words for use in RFCs to Indicate | |||
Requirement Levels", BCP 14, RFC 2119, March 1997. | Requirement Levels", BCP 14, RFC 2119, March 1997. | |||
[RFC5234] Crocker, D., Ed. and P. Overell, "Augmented BNF for Syntax | [RFC5234] Crocker, D., Ed. and P. Overell, "Augmented BNF for Syntax | |||
Specifications: ABNF", STD 68, RFC 5234, January 2008. | Specifications: ABNF", STD 68, RFC 5234, January 2008. | |||
skipping to change at page 31, line 20 | skipping to change at page 31, line 20 | |||
A.1. Changes from RFC 2068 | A.1. Changes from RFC 2068 | |||
A case was missed in the Cache-Control model of HTTP/1.1; s-maxage | A case was missed in the Cache-Control model of HTTP/1.1; s-maxage | |||
was introduced to add this missing case. (Sections 2.1, 3.2). | was introduced to add this missing case. (Sections 2.1, 3.2). | |||
Transfer-coding and message lengths all interact in ways that | Transfer-coding and message lengths all interact in ways that | |||
required fixing exactly when chunked encoding is used (to allow for | required fixing exactly when chunked encoding is used (to allow for | |||
transfer encoding that may not be self delimiting); it was important | transfer encoding that may not be self delimiting); it was important | |||
to straighten out exactly how message lengths are computed. (see also | to straighten out exactly how message lengths are computed. (see also | |||
[Part1], [Part3] and [Part5]) [[anchor18: This used to refer to the | [Part1], [Part3] and [Part5]) [[anchor17: This used to refer to the | |||
text about non-modifiable headers, and will have to be updated later | text about non-modifiable headers, and will have to be updated later | |||
on. --jre]] | on. --jre]] | |||
Proxies should be able to add Content-Length when appropriate. | Proxies should be able to add Content-Length when appropriate. | |||
[[anchor19: This used to refer to the text about non-modifiable | [[anchor18: This used to refer to the text about non-modifiable | |||
headers, and will have to be updated later on. --jre]] | headers, and will have to be updated later on. --jre]] | |||
Range request responses would become very verbose if all meta-data | Range request responses would become very verbose if all meta-data | |||
were always returned; by allowing the server to only send needed | were always returned; by allowing the server to only send needed | |||
headers in a 206 response, this problem can be avoided. | headers in a 206 response, this problem can be avoided. | |||
(Section 2.7) | (Section 2.7) | |||
The Cache-Control: max-age directive was not properly defined for | The Cache-Control: max-age directive was not properly defined for | |||
responses. (Section 3.2.2) | responses. (Section 3.2.2) | |||
skipping to change at page 32, line 10 | skipping to change at page 32, line 10 | |||
Age = "Age:" OWS Age-v | Age = "Age:" OWS Age-v | |||
Age-v = delta-seconds | Age-v = delta-seconds | |||
Cache-Control = "Cache-Control:" OWS Cache-Control-v | Cache-Control = "Cache-Control:" OWS Cache-Control-v | |||
Cache-Control-v = *( "," OWS ) cache-directive *( OWS "," [ OWS | Cache-Control-v = *( "," OWS ) cache-directive *( OWS "," [ OWS | |||
cache-directive ] ) | cache-directive ] ) | |||
Expires = "Expires:" OWS Expires-v | Expires = "Expires:" OWS Expires-v | |||
Expires-v = HTTP-date | Expires-v = HTTP-date | |||
HTTP-date = <HTTP-date, defined in [Part1], Section 3.2.1> | HTTP-date = <HTTP-date, defined in [Part1], Section 3.2> | |||
OWS = <OWS, defined in [Part1], Section 1.2.2> | OWS = <OWS, defined in [Part1], Section 1.2.2> | |||
Pragma = "Pragma:" OWS Pragma-v | Pragma = "Pragma:" OWS Pragma-v | |||
Pragma-v = *( "," OWS ) pragma-directive *( OWS "," [ OWS | Pragma-v = *( "," OWS ) pragma-directive *( OWS "," [ OWS | |||
pragma-directive ] ) | pragma-directive ] ) | |||
Vary = "Vary:" OWS Vary-v | Vary = "Vary:" OWS Vary-v | |||
Vary-v = "*" / ( *( "," OWS ) field-name *( OWS "," [ OWS field-name | Vary-v = "*" / ( *( "," OWS ) field-name *( OWS "," [ OWS field-name | |||
] ) ) | ] ) ) | |||
skipping to change at page 35, line 42 | skipping to change at page 35, line 42 | |||
o <http://trac.tools.ietf.org/wg/httpbis/trac/ticket/139>: "Methods | o <http://trac.tools.ietf.org/wg/httpbis/trac/ticket/139>: "Methods | |||
and Caching" | and Caching" | |||
In addition: Final work on ABNF conversion | In addition: Final work on ABNF conversion | |||
(<http://tools.ietf.org/wg/httpbis/trac/ticket/36>): | (<http://tools.ietf.org/wg/httpbis/trac/ticket/36>): | |||
o Add appendix containing collected and expanded ABNF, reorganize | o Add appendix containing collected and expanded ABNF, reorganize | |||
ABNF introduction. | ABNF introduction. | |||
C.8. Since draft-ietf-httpbis-p6-cache-06 | ||||
Closed issues: | ||||
o <http://tools.ietf.org/wg/httpbis/trac/ticket/161>: "base for | ||||
numeric protocol elements" | ||||
Affected issues: | ||||
o <http://tools.ietf.org/wg/httpbis/trac/ticket/37>: Vary and non- | ||||
existant headers | ||||
Index | Index | |||
A | A | |||
age 6 | age 6 | |||
Age header 17 | Age header 17 | |||
C | C | |||
cache 5 | cache 5 | |||
Cache Directives | Cache Directives | |||
max-age 18, 21 | max-age 19, 21 | |||
max-stale 19 | max-stale 19 | |||
min-fresh 19 | min-fresh 19 | |||
must-revalidate 21 | must-revalidate 21 | |||
no-cache 18, 20 | no-cache 18, 20 | |||
no-store 18, 21 | no-store 18, 21 | |||
no-transform 19, 22 | no-transform 19, 22 | |||
only-if-cached 19 | only-if-cached 19 | |||
private 20 | private 20 | |||
proxy-revalidate 21 | proxy-revalidate 21 | |||
public 20 | public 20 | |||
skipping to change at page 37, line 16 | skipping to change at page 37, line 27 | |||
Age 17 | Age 17 | |||
Cache-Control 17 | Cache-Control 17 | |||
Expires 23 | Expires 23 | |||
Pragma 23 | Pragma 23 | |||
Vary 24 | Vary 24 | |||
Warning 25 | Warning 25 | |||
heuristic expiration time 5 | heuristic expiration time 5 | |||
M | M | |||
max-age | max-age | |||
Cache Directive 18, 21 | Cache Directive 19, 21 | |||
max-stale | max-stale | |||
Cache Directive 19 | Cache Directive 19 | |||
min-fresh | min-fresh | |||
Cache Directive 19 | Cache Directive 19 | |||
must-revalidate | must-revalidate | |||
Cache Directive 21 | Cache Directive 21 | |||
N | N | |||
no-cache | no-cache | |||
Cache Directive 18, 20 | Cache Directive 18, 20 | |||
skipping to change at page 39, line 30 | skipping to change at page 40, line 4 | |||
Tim Berners-Lee | Tim Berners-Lee | |||
World Wide Web Consortium | World Wide Web Consortium | |||
MIT Computer Science and Artificial Intelligence Laboratory | MIT Computer Science and Artificial Intelligence Laboratory | |||
The Stata Center, Building 32 | The Stata Center, Building 32 | |||
32 Vassar Street | 32 Vassar Street | |||
Cambridge, MA 02139 | Cambridge, MA 02139 | |||
USA | USA | |||
Email: timbl@w3.org | Email: timbl@w3.org | |||
URI: http://www.w3.org/People/Berners-Lee/ | URI: http://www.w3.org/People/Berners-Lee/ | |||
Yves Lafon (editor) | Yves Lafon (editor) | |||
World Wide Web Consortium | World Wide Web Consortium | |||
W3C / ERCIM | W3C / ERCIM | |||
2004, rte des Lucioles | 2004, rte des Lucioles | |||
Sophia-Antipolis, AM 06902 | Sophia-Antipolis, AM 06902 | |||
France | France | |||
Email: ylafon@w3.org | Email: ylafon@w3.org | |||
URI: http://www.raubacapeu.net/people/yves/ | URI: http://www.raubacapeu.net/people/yves/ | |||
Mark Nottingham (editor) | ||||
Email: mnot@mnot.net | ||||
URI: http://www.mnot.net/ | ||||
Julian F. Reschke (editor) | Julian F. Reschke (editor) | |||
greenbytes GmbH | greenbytes GmbH | |||
Hafenweg 16 | Hafenweg 16 | |||
Muenster, NW 48155 | Muenster, NW 48155 | |||
Germany | Germany | |||
Phone: +49 251 2807760 | Phone: +49 251 2807760 | |||
Fax: +49 251 2807761 | Fax: +49 251 2807761 | |||
Email: julian.reschke@greenbytes.de | Email: julian.reschke@greenbytes.de | |||
URI: http://greenbytes.de/tech/webdav/ | URI: http://greenbytes.de/tech/webdav/ | |||
End of changes. 58 change blocks. | ||||
119 lines changed or deleted | 145 lines changed or added | |||
This html diff was produced by rfcdiff 1.35. The latest version is available from http://tools.ietf.org/tools/rfcdiff/ |