| draft-ietf-httpbis-p1-messaging-04.txt | draft-ietf-httpbis-p1-messaging-05.txt | |||
|---|---|---|---|---|
| Network Working Group R. Fielding, Ed. | Network 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: March 2, 2009 J. Mogul | Expires: May 20, 2009 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 | |||
| J. Reschke, Ed. | J. Reschke, Ed. | |||
| greenbytes | greenbytes | |||
| August 29, 2008 | November 16, 2008 | |||
| HTTP/1.1, part 1: URIs, Connections, and Message Parsing | HTTP/1.1, part 1: URIs, Connections, and Message Parsing | |||
| draft-ietf-httpbis-p1-messaging-04 | draft-ietf-httpbis-p1-messaging-05 | |||
| Status of this Memo | Status of this Memo | |||
| By submitting this Internet-Draft, each author represents that any | By submitting this Internet-Draft, each author represents that any | |||
| applicable patent or other IPR claims of which he or she is aware | applicable patent or other IPR claims of which he or she is aware | |||
| have been or will be disclosed, and any of which he or she becomes | have been or will be disclosed, and any of which he or she becomes | |||
| aware will be disclosed, in accordance with Section 6 of BCP 79. | aware will be disclosed, in accordance with Section 6 of BCP 79. | |||
| 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 | |||
| skipping to change at page 1, line 49 | skipping to change at page 1, line 49 | |||
| 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 March 2, 2009. | This Internet-Draft will expire on May 20, 2009. | |||
| Abstract | Abstract | |||
| The Hypertext Transfer Protocol (HTTP) is an application-level | The Hypertext Transfer Protocol (HTTP) is an application-level | |||
| protocol for distributed, collaborative, hypermedia information | protocol for distributed, collaborative, hypermedia information | |||
| systems. HTTP has been in use by the World Wide Web global | systems. HTTP has been in use by the World Wide Web global | |||
| information initiative since 1990. This document is Part 1 of the | information initiative since 1990. This document is Part 1 of the | |||
| seven-part specification that defines the protocol referred to as | seven-part specification that defines the protocol referred to as | |||
| "HTTP/1.1" and, taken together, obsoletes RFC 2616. Part 1 provides | "HTTP/1.1" and, taken together, obsoletes RFC 2616. Part 1 provides | |||
| an overview of HTTP and its associated terminology, defines the | an overview of HTTP and its associated terminology, defines the | |||
| "http" and "https" Uniform Resource Identifier (URI) schemes, defines | "http" and "https" Uniform Resource Identifier (URI) schemes, defines | |||
| the generic message syntax and parsing requirements for HTTP message | the generic message syntax and parsing requirements for HTTP message | |||
| frames, and describes general security concerns for implementations. | frames, and describes general security concerns for implementations. | |||
| 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://www.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://www.tools.ietf.org/wg/httpbis/>. | <http://tools.ietf.org/wg/httpbis/>. | |||
| The changes in this draft are summarized in Appendix D.4. | The changes in this draft are summarized in Appendix E.6. | |||
| Table of Contents | Table of Contents | |||
| 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 5 | 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 5 | |||
| 1.1. Purpose . . . . . . . . . . . . . . . . . . . . . . . . . 5 | 1.1. Requirements . . . . . . . . . . . . . . . . . . . . . . . 5 | |||
| 1.2. Requirements . . . . . . . . . . . . . . . . . . . . . . . 6 | 1.2. Overall Operation . . . . . . . . . . . . . . . . . . . . 6 | |||
| 1.3. Terminology . . . . . . . . . . . . . . . . . . . . . . . 6 | 2. Notational Conventions and Generic Grammar . . . . . . . . . . 8 | |||
| 1.4. Overall Operation . . . . . . . . . . . . . . . . . . . . 9 | 2.1. ABNF Extension: #rule . . . . . . . . . . . . . . . . . . 8 | |||
| 2. Notational Conventions and Generic Grammar . . . . . . . . . . 11 | 2.2. Basic Rules . . . . . . . . . . . . . . . . . . . . . . . 8 | |||
| 2.1. Augmented BNF . . . . . . . . . . . . . . . . . . . . . . 11 | 2.3. ABNF Rules defined in other Parts of the Specification . . 10 | |||
| 2.2. Basic Rules . . . . . . . . . . . . . . . . . . . . . . . 13 | 3. Protocol Parameters . . . . . . . . . . . . . . . . . . . . . 11 | |||
| 2.3. ABNF Rules defined in other Parts of the Specification . . 16 | 3.1. HTTP Version . . . . . . . . . . . . . . . . . . . . . . . 11 | |||
| 3. Protocol Parameters . . . . . . . . . . . . . . . . . . . . . 16 | 3.2. Uniform Resource Identifiers . . . . . . . . . . . . . . . 12 | |||
| 3.1. HTTP Version . . . . . . . . . . . . . . . . . . . . . . . 16 | 3.2.1. http URI scheme . . . . . . . . . . . . . . . . . . . 13 | |||
| 3.2. Uniform Resource Identifiers . . . . . . . . . . . . . . . 17 | 3.2.2. URI Comparison . . . . . . . . . . . . . . . . . . . . 13 | |||
| 3.2.1. General Syntax . . . . . . . . . . . . . . . . . . . . 17 | 3.3. Date/Time Formats . . . . . . . . . . . . . . . . . . . . 14 | |||
| 3.2.2. http URL . . . . . . . . . . . . . . . . . . . . . . . 18 | 3.3.1. Full Date . . . . . . . . . . . . . . . . . . . . . . 14 | |||
| 3.2.3. URI Comparison . . . . . . . . . . . . . . . . . . . . 19 | 3.4. Transfer Codings . . . . . . . . . . . . . . . . . . . . . 16 | |||
| 3.3. Date/Time Formats . . . . . . . . . . . . . . . . . . . . 19 | 3.4.1. Chunked Transfer Coding . . . . . . . . . . . . . . . 17 | |||
| 3.3.1. Full Date . . . . . . . . . . . . . . . . . . . . . . 19 | 3.5. Product Tokens . . . . . . . . . . . . . . . . . . . . . . 18 | |||
| 3.4. Transfer Codings . . . . . . . . . . . . . . . . . . . . . 21 | 4. HTTP Message . . . . . . . . . . . . . . . . . . . . . . . . . 19 | |||
| 3.4.1. Chunked Transfer Coding . . . . . . . . . . . . . . . 22 | 4.1. Message Types . . . . . . . . . . . . . . . . . . . . . . 19 | |||
| 3.5. Product Tokens . . . . . . . . . . . . . . . . . . . . . . 24 | 4.2. Message Headers . . . . . . . . . . . . . . . . . . . . . 20 | |||
| 4. HTTP Message . . . . . . . . . . . . . . . . . . . . . . . . . 24 | 4.3. Message Body . . . . . . . . . . . . . . . . . . . . . . . 21 | |||
| 4.1. Message Types . . . . . . . . . . . . . . . . . . . . . . 24 | 4.4. Message Length . . . . . . . . . . . . . . . . . . . . . . 22 | |||
| 4.2. Message Headers . . . . . . . . . . . . . . . . . . . . . 25 | 4.5. General Header Fields . . . . . . . . . . . . . . . . . . 23 | |||
| 4.3. Message Body . . . . . . . . . . . . . . . . . . . . . . . 26 | 5. Request . . . . . . . . . . . . . . . . . . . . . . . . . . . 24 | |||
| 4.4. Message Length . . . . . . . . . . . . . . . . . . . . . . 27 | 5.1. Request-Line . . . . . . . . . . . . . . . . . . . . . . . 24 | |||
| 4.5. General Header Fields . . . . . . . . . . . . . . . . . . 28 | 5.1.1. Method . . . . . . . . . . . . . . . . . . . . . . . . 24 | |||
| 5. Request . . . . . . . . . . . . . . . . . . . . . . . . . . . 29 | 5.1.2. Request-URI . . . . . . . . . . . . . . . . . . . . . 24 | |||
| 5.1. Request-Line . . . . . . . . . . . . . . . . . . . . . . . 29 | 5.2. The Resource Identified by a Request . . . . . . . . . . . 26 | |||
| 5.1.1. Method . . . . . . . . . . . . . . . . . . . . . . . . 29 | 6. Response . . . . . . . . . . . . . . . . . . . . . . . . . . . 26 | |||
| 5.1.2. Request-URI . . . . . . . . . . . . . . . . . . . . . 30 | 6.1. Status-Line . . . . . . . . . . . . . . . . . . . . . . . 27 | |||
| 5.2. The Resource Identified by a Request . . . . . . . . . . . 31 | 6.1.1. Status Code and Reason Phrase . . . . . . . . . . . . 27 | |||
| 6. Response . . . . . . . . . . . . . . . . . . . . . . . . . . . 32 | 7. Connections . . . . . . . . . . . . . . . . . . . . . . . . . 27 | |||
| 6.1. Status-Line . . . . . . . . . . . . . . . . . . . . . . . 32 | 7.1. Persistent Connections . . . . . . . . . . . . . . . . . . 28 | |||
| 6.1.1. Status Code and Reason Phrase . . . . . . . . . . . . 32 | 7.1.1. Purpose . . . . . . . . . . . . . . . . . . . . . . . 28 | |||
| 7. Connections . . . . . . . . . . . . . . . . . . . . . . . . . 33 | 7.1.2. Overall Operation . . . . . . . . . . . . . . . . . . 28 | |||
| 7.1. Persistent Connections . . . . . . . . . . . . . . . . . . 33 | 7.1.3. Proxy Servers . . . . . . . . . . . . . . . . . . . . 30 | |||
| 7.1.1. Purpose . . . . . . . . . . . . . . . . . . . . . . . 33 | 7.1.4. Practical Considerations . . . . . . . . . . . . . . . 30 | |||
| 7.1.2. Overall Operation . . . . . . . . . . . . . . . . . . 34 | 7.2. Message Transmission Requirements . . . . . . . . . . . . 31 | |||
| 7.1.3. Proxy Servers . . . . . . . . . . . . . . . . . . . . 35 | 7.2.1. Persistent Connections and Flow Control . . . . . . . 31 | |||
| 7.1.4. Practical Considerations . . . . . . . . . . . . . . . 35 | 7.2.2. Monitoring Connections for Error Status Messages . . . 31 | |||
| 7.2. Message Transmission Requirements . . . . . . . . . . . . 36 | 7.2.3. Use of the 100 (Continue) Status . . . . . . . . . . . 32 | |||
| 7.2.1. Persistent Connections and Flow Control . . . . . . . 37 | ||||
| 7.2.2. Monitoring Connections for Error Status Messages . . . 37 | ||||
| 7.2.3. Use of the 100 (Continue) Status . . . . . . . . . . . 37 | ||||
| 7.2.4. Client Behavior if Server Prematurely Closes | 7.2.4. Client Behavior if Server Prematurely Closes | |||
| Connection . . . . . . . . . . . . . . . . . . . . . . 39 | Connection . . . . . . . . . . . . . . . . . . . . . . 34 | |||
| 8. Header Field Definitions . . . . . . . . . . . . . . . . . . . 40 | 8. Header Field Definitions . . . . . . . . . . . . . . . . . . . 34 | |||
| 8.1. Connection . . . . . . . . . . . . . . . . . . . . . . . . 40 | 8.1. Connection . . . . . . . . . . . . . . . . . . . . . . . . 35 | |||
| 8.2. Content-Length . . . . . . . . . . . . . . . . . . . . . . 41 | 8.2. Content-Length . . . . . . . . . . . . . . . . . . . . . . 36 | |||
| 8.3. Date . . . . . . . . . . . . . . . . . . . . . . . . . . . 42 | 8.3. Date . . . . . . . . . . . . . . . . . . . . . . . . . . . 36 | |||
| 8.3.1. Clockless Origin Server Operation . . . . . . . . . . 43 | 8.3.1. Clockless Origin Server Operation . . . . . . . . . . 37 | |||
| 8.4. Host . . . . . . . . . . . . . . . . . . . . . . . . . . . 43 | 8.4. Host . . . . . . . . . . . . . . . . . . . . . . . . . . . 38 | |||
| 8.5. TE . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44 | 8.5. TE . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38 | |||
| 8.6. Trailer . . . . . . . . . . . . . . . . . . . . . . . . . 45 | 8.6. Trailer . . . . . . . . . . . . . . . . . . . . . . . . . 39 | |||
| 8.7. Transfer-Encoding . . . . . . . . . . . . . . . . . . . . 45 | 8.7. Transfer-Encoding . . . . . . . . . . . . . . . . . . . . 40 | |||
| 8.8. Upgrade . . . . . . . . . . . . . . . . . . . . . . . . . 46 | 8.8. Upgrade . . . . . . . . . . . . . . . . . . . . . . . . . 41 | |||
| 8.9. Via . . . . . . . . . . . . . . . . . . . . . . . . . . . 47 | 8.9. Via . . . . . . . . . . . . . . . . . . . . . . . . . . . 42 | |||
| 9. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 48 | 9. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 43 | |||
| 9.1. Message Header Registration . . . . . . . . . . . . . . . 48 | 9.1. Message Header Registration . . . . . . . . . . . . . . . 43 | |||
| 9.2. URI Scheme Registration . . . . . . . . . . . . . . . . . 49 | 9.2. URI Scheme Registration . . . . . . . . . . . . . . . . . 44 | |||
| 9.3. Internet Media Type Registrations . . . . . . . . . . . . 49 | 9.3. Internet Media Type Registrations . . . . . . . . . . . . 44 | |||
| 9.3.1. Internet Media Type message/http . . . . . . . . . . . 49 | 9.3.1. Internet Media Type message/http . . . . . . . . . . . 44 | |||
| 9.3.2. Internet Media Type application/http . . . . . . . . . 50 | 9.3.2. Internet Media Type application/http . . . . . . . . . 45 | |||
| 10. Security Considerations . . . . . . . . . . . . . . . . . . . 51 | 10. Security Considerations . . . . . . . . . . . . . . . . . . . 46 | |||
| 10.1. Personal Information . . . . . . . . . . . . . . . . . . . 52 | 10.1. Personal Information . . . . . . . . . . . . . . . . . . . 47 | |||
| 10.2. Abuse of Server Log Information . . . . . . . . . . . . . 52 | 10.2. Abuse of Server Log Information . . . . . . . . . . . . . 47 | |||
| 10.3. Attacks Based On File and Path Names . . . . . . . . . . . 52 | 10.3. Attacks Based On File and Path Names . . . . . . . . . . . 47 | |||
| 10.4. DNS Spoofing . . . . . . . . . . . . . . . . . . . . . . . 52 | 10.4. DNS Spoofing . . . . . . . . . . . . . . . . . . . . . . . 47 | |||
| 10.5. Proxies and Caching . . . . . . . . . . . . . . . . . . . 53 | 10.5. Proxies and Caching . . . . . . . . . . . . . . . . . . . 48 | |||
| 10.6. Denial of Service Attacks on Proxies . . . . . . . . . . . 54 | 10.6. Denial of Service Attacks on Proxies . . . . . . . . . . . 49 | |||
| 11. Acknowledgments . . . . . . . . . . . . . . . . . . . . . . . 54 | 11. Acknowledgments . . . . . . . . . . . . . . . . . . . . . . . 49 | |||
| 12. References . . . . . . . . . . . . . . . . . . . . . . . . . . 55 | 12. References . . . . . . . . . . . . . . . . . . . . . . . . . . 50 | |||
| 12.1. Normative References . . . . . . . . . . . . . . . . . . . 55 | 12.1. Normative References . . . . . . . . . . . . . . . . . . . 50 | |||
| 12.2. Informative References . . . . . . . . . . . . . . . . . . 56 | 12.2. Informative References . . . . . . . . . . . . . . . . . . 51 | |||
| Appendix A. Tolerant Applications . . . . . . . . . . . . . . . . 59 | Appendix A. Tolerant Applications . . . . . . . . . . . . . . . . 53 | |||
| Appendix B. Conversion of Date Formats . . . . . . . . . . . . . 59 | Appendix B. Conversion of Date Formats . . . . . . . . . . . . . 54 | |||
| Appendix C. Compatibility with Previous Versions . . . . . . . . 60 | Appendix C. Compatibility with Previous Versions . . . . . . . . 54 | |||
| C.1. Changes from HTTP/1.0 . . . . . . . . . . . . . . . . . . 60 | C.1. Changes from HTTP/1.0 . . . . . . . . . . . . . . . . . . 55 | |||
| C.1.1. Changes to Simplify Multi-homed Web Servers and | C.1.1. Changes to Simplify Multi-homed Web Servers and | |||
| Conserve IP Addresses . . . . . . . . . . . . . . . . 60 | Conserve IP Addresses . . . . . . . . . . . . . . . . 55 | |||
| C.2. Compatibility with HTTP/1.0 Persistent Connections . . . . 61 | C.2. Compatibility with HTTP/1.0 Persistent Connections . . . . 56 | |||
| C.3. Changes from RFC 2068 . . . . . . . . . . . . . . . . . . 62 | C.3. Changes from RFC 2068 . . . . . . . . . . . . . . . . . . 57 | |||
| C.4. Changes from RFC 2616 . . . . . . . . . . . . . . . . . . 62 | C.4. Changes from RFC 2616 . . . . . . . . . . . . . . . . . . 57 | |||
| Appendix D. Change Log (to be removed by RFC Editor before | Appendix D. Terminology . . . . . . . . . . . . . . . . . . . . . 58 | |||
| publication) . . . . . . . . . . . . . . . . . . . . 63 | Appendix E. Change Log (to be removed by RFC Editor before | |||
| D.1. Since RFC2616 . . . . . . . . . . . . . . . . . . . . . . 63 | publication) . . . . . . . . . . . . . . . . . . . . 61 | |||
| D.2. Since draft-ietf-httpbis-p1-messaging-00 . . . . . . . . . 63 | E.1. Since RFC2616 . . . . . . . . . . . . . . . . . . . . . . 61 | |||
| D.3. Since draft-ietf-httpbis-p1-messaging-01 . . . . . . . . . 64 | E.2. Since draft-ietf-httpbis-p1-messaging-00 . . . . . . . . . 61 | |||
| D.4. Since draft-ietf-httpbis-p1-messaging-02 . . . . . . . . . 65 | E.3. Since draft-ietf-httpbis-p1-messaging-01 . . . . . . . . . 62 | |||
| D.5. Since draft-ietf-httpbis-p1-messaging-03 . . . . . . . . . 66 | E.4. Since draft-ietf-httpbis-p1-messaging-02 . . . . . . . . . 63 | |||
| Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66 | E.5. Since draft-ietf-httpbis-p1-messaging-03 . . . . . . . . . 64 | |||
| Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . . 70 | E.6. Since draft-ietf-httpbis-p1-messaging-04 . . . . . . . . . 64 | |||
| Intellectual Property and Copyright Statements . . . . . . . . . . 73 | Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65 | |||
| Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . . 69 | ||||
| Intellectual Property and Copyright Statements . . . . . . . . . . 72 | ||||
| 1. Introduction | 1. Introduction | |||
| The Hypertext Transfer Protocol (HTTP) is an application-level | The Hypertext Transfer Protocol (HTTP) is an application-level | |||
| protocol for distributed, collaborative, hypermedia information | request/response protocol that uses extensible semantics and MIME- | |||
| systems. HTTP has been in use by the World-Wide Web global | like message payloads for flexible interaction with network-based | |||
| information initiative since 1990. The first version of HTTP, | hypermedia information systems. HTTP relies upon the Uniform | |||
| commonly referred to as HTTP/0.9, was a simple protocol for raw data | Resource Identifier (URI) standard [RFC3986] to indicate resource | |||
| transfer across the Internet with only a single method and no | targets for interaction and to identify other resources. Messages | |||
| metadata. HTTP/1.0, as defined by [RFC1945], improved the protocol | ||||
| by allowing messages to be in the format of MIME-like messages, | ||||
| containing metadata about the data transferred and modifiers on the | ||||
| request/response semantics. However, HTTP/1.0 did not sufficiently | ||||
| take into consideration the effects of hierarchical proxies, caching, | ||||
| the need for persistent connections, or name-based virtual hosts. In | ||||
| addition, the proliferation of incompletely-implemented applications | ||||
| calling themselves "HTTP/1.0" necessitated a protocol version change | ||||
| in order for two communicating applications to determine each other's | ||||
| true capabilities. | ||||
| This document is Part 1 of the seven-part specification that defines | ||||
| the protocol referred to as "HTTP/1.1", obsoleting [RFC2616]. | ||||
| HTTP/1.1 remains compatible with HTTP/1.0 by including more stringent | ||||
| requirements that enable reliable implementations and adding only | ||||
| those new features that will either be safely ignored by an HTTP/1.0 | ||||
| recipient or only sent when communicating with a party advertising | ||||
| compliance with HTTP/1.1. Part 1 defines those aspects of HTTP/1.1 | ||||
| related to overall network operation, message framing, interaction | ||||
| with transport protocols, and URI schemes. | ||||
| This document is currently disorganized in order to minimize the | ||||
| changes between drafts and enable reviewers to see the smaller errata | ||||
| changes. The next draft will reorganize the sections to better | ||||
| reflect the content. In particular, the sections will be organized | ||||
| according to the typical process of deciding when to use HTTP (URI | ||||
| schemes), overall network operation, connection management, message | ||||
| framing, and generic message parsing. The current mess reflects how | ||||
| widely dispersed these topics and associated requirements had become | ||||
| in [RFC2616]. | ||||
| 1.1. Purpose | ||||
| Practical information systems require more functionality than simple | ||||
| retrieval, including search, front-end update, and annotation. HTTP | ||||
| allows an open-ended set of methods and headers that indicate the | ||||
| purpose of a request [RFC2324]. It builds on the discipline of | ||||
| reference provided by the Uniform Resource Identifier (URI) | ||||
| [RFC1630], as a location (URL) [RFC1738] or name (URN) [RFC1737], for | ||||
| indicating the resource to which a method is to be applied. Messages | ||||
| are passed in a format similar to that used by Internet mail | are passed in a format similar to that used by Internet mail | |||
| [RFC2822] as defined by the Multipurpose Internet Mail Extensions | [RFC5322] and the Multipurpose Internet Mail Extensions (MIME) | |||
| (MIME) [RFC2045]. | [RFC2045] (see Appendix A of [Part3] for the differences between HTTP | |||
| and MIME messages). | ||||
| HTTP is also used as a generic protocol for communication between | HTTP is also designed for use as a generic protocol for translating | |||
| user agents and proxies/gateways to other Internet systems, including | communication to and from other Internet information systems, such as | |||
| those supported by the SMTP [RFC2821], NNTP [RFC3977], FTP [RFC959], | USENET news services via NNTP [RFC3977], file services via FTP | |||
| Gopher [RFC1436], and WAIS [WAIS] protocols. In this way, HTTP | [RFC959], Gopher [RFC1436], and WAIS [WAIS]. HTTP proxies and | |||
| allows basic hypermedia access to resources available from diverse | gateways provide access to alternative information services by | |||
| applications. | translating their diverse protocols into a hypermedia format that can | |||
| be viewed and manipulated by clients in the same way as HTTP | ||||
| services. | ||||
| 1.2. Requirements | This document is Part 1 of the seven-part specification of HTTP, | |||
| defining the protocol referred to as "HTTP/1.1" and obsoleting | ||||
| [RFC2616]. Part 1 defines how clients determine when to use HTTP, | ||||
| the URI schemes specific to HTTP-based resources, overall network | ||||
| operation with transport protocol connection management, and HTTP | ||||
| message framing. Our goal is to define all of the mechanisms | ||||
| necessary for HTTP message handling that are independent of message | ||||
| semantics, thereby defining the complete set of requirements for an | ||||
| HTTP message relay or generic message parser. | ||||
| 1.1. Requirements | ||||
| The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", | The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", | |||
| "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this | "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this | |||
| document are to be interpreted as described in [RFC2119]. | document are to be interpreted as described in [RFC2119]. | |||
| An implementation is not compliant if it fails to satisfy one or more | An implementation is not compliant if it fails to satisfy one or more | |||
| of the MUST or REQUIRED level requirements for the protocols it | of the MUST or REQUIRED level requirements for the protocols it | |||
| implements. An implementation that satisfies all the MUST or | implements. An implementation that satisfies all the MUST or | |||
| REQUIRED level and all the SHOULD level requirements for its | REQUIRED level and all the SHOULD level requirements for its | |||
| protocols is said to be "unconditionally compliant"; one that | protocols is said to be "unconditionally compliant"; one that | |||
| satisfies all the MUST level requirements but not all the SHOULD | satisfies all the MUST level requirements but not all the SHOULD | |||
| level requirements for its protocols is said to be "conditionally | level requirements for its protocols is said to be "conditionally | |||
| compliant." | compliant." | |||
| 1.3. Terminology | 1.2. Overall Operation | |||
| This specification uses a number of terms to refer to the roles | ||||
| played by participants in, and objects of, the HTTP communication. | ||||
| connection | ||||
| A transport layer virtual circuit established between two programs | ||||
| for the purpose of communication. | ||||
| message | ||||
| The basic unit of HTTP communication, consisting of a structured | ||||
| sequence of octets matching the syntax defined in Section 4 and | ||||
| transmitted via the connection. | ||||
| request | ||||
| An HTTP request message, as defined in Section 5. | ||||
| response | ||||
| An HTTP response message, as defined in Section 6. | ||||
| resource | ||||
| A network data object or service that can be identified by a URI, | ||||
| as defined in Section 3.2. Resources may be available in multiple | ||||
| representations (e.g. multiple languages, data formats, size, and | ||||
| resolutions) or vary in other ways. | ||||
| entity | ||||
| The information transferred as the payload of a request or | ||||
| response. An entity consists of metainformation in the form of | ||||
| entity-header fields and content in the form of an entity-body, as | ||||
| described in Section 4 of [Part3]. | ||||
| representation | ||||
| An entity included with a response that is subject to content | ||||
| negotiation, as described in Section 5 of [Part3]. There may | ||||
| exist multiple representations associated with a particular | ||||
| response status. | ||||
| content negotiation | ||||
| The mechanism for selecting the appropriate representation when | ||||
| servicing a request, as described in Section 5 of [Part3]. The | ||||
| representation of entities in any response can be negotiated | ||||
| (including error responses). | ||||
| variant | ||||
| A resource may have one, or more than one, representation(s) | ||||
| associated with it at any given instant. Each of these | ||||
| representations is termed a `variant'. Use of the term `variant' | ||||
| does not necessarily imply that the resource is subject to content | ||||
| negotiation. | ||||
| client | ||||
| A program that establishes connections for the purpose of sending | ||||
| requests. | ||||
| user agent | ||||
| The client which initiates a request. These are often browsers, | ||||
| editors, spiders (web-traversing robots), or other end user tools. | ||||
| server | ||||
| An application program that accepts connections in order to | ||||
| service requests by sending back responses. Any given program may | ||||
| be capable of being both a client and a server; our use of these | ||||
| terms refers only to the role being performed by the program for a | ||||
| particular connection, rather than to the program's capabilities | ||||
| in general. Likewise, any server may act as an origin server, | ||||
| proxy, gateway, or tunnel, switching behavior based on the nature | ||||
| of each request. | ||||
| origin server | ||||
| The server on which a given resource resides or is to be created. | ||||
| proxy | ||||
| An intermediary program which acts as both a server and a client | ||||
| for the purpose of making requests on behalf of other clients. | ||||
| Requests are serviced internally or by passing them on, with | ||||
| possible translation, to other servers. A proxy MUST implement | ||||
| both the client and server requirements of this specification. A | ||||
| "transparent proxy" is a proxy that does not modify the request or | ||||
| response beyond what is required for proxy authentication and | ||||
| identification. A "non-transparent proxy" is a proxy that | ||||
| modifies the request or response in order to provide some added | ||||
| service to the user agent, such as group annotation services, | ||||
| media type transformation, protocol reduction, or anonymity | ||||
| filtering. Except where either transparent or non-transparent | ||||
| behavior is explicitly stated, the HTTP proxy requirements apply | ||||
| to both types of proxies. | ||||
| gateway | ||||
| A server which acts as an intermediary for some other server. | ||||
| Unlike a proxy, a gateway receives requests as if it were the | ||||
| origin server for the requested resource; the requesting client | ||||
| may not be aware that it is communicating with a gateway. | ||||
| tunnel | ||||
| An intermediary program which is acting as a blind relay between | ||||
| two connections. Once active, a tunnel is not considered a party | ||||
| to the HTTP communication, though the tunnel may have been | ||||
| initiated by an HTTP request. The tunnel ceases to exist when | ||||
| both ends of the relayed connections are closed. | ||||
| cache | ||||
| A program's local store of response messages and the subsystem | ||||
| that controls its message storage, retrieval, and deletion. A | ||||
| cache stores cacheable responses in order to reduce the response | ||||
| time and network bandwidth consumption on future, equivalent | ||||
| requests. Any client or server may include a cache, though a | ||||
| cache cannot be used by a server that is acting as a tunnel. | ||||
| cacheable | ||||
| A response is cacheable if a cache is allowed to store a copy of | ||||
| the response message for use in answering subsequent requests. | ||||
| The rules for determining the cacheability of HTTP responses are | ||||
| defined in Section 1 of [Part6]. Even if a resource is cacheable, | ||||
| there may be additional constraints on whether a cache can use the | ||||
| cached copy for a particular request. | ||||
| upstream/downstream | ||||
| Upstream and downstream describe the flow of a message: all | ||||
| messages flow from upstream to downstream. | ||||
| inbound/outbound | ||||
| Inbound and outbound refer to the request and response paths for | ||||
| messages: "inbound" means "traveling toward the origin server", | ||||
| and "outbound" means "traveling toward the user agent" | ||||
| 1.4. Overall Operation | ||||
| HTTP is a request/response protocol. A client sends a request to the | HTTP is a request/response protocol. A client sends a request to the | |||
| server in the form of a request method, URI, and protocol version, | server in the form of a request method, URI, and protocol version, | |||
| followed by a MIME-like message containing request modifiers, client | followed by a MIME-like message containing request modifiers, client | |||
| information, and possible body content over a connection with a | information, and possible body content over a connection with a | |||
| server. The server responds with a status line, including the | server. The server responds with a status line, including the | |||
| message's protocol version and a success or error code, followed by a | message's protocol version and a success or error code, followed by a | |||
| MIME-like message containing server information, entity | MIME-like message containing server information, entity | |||
| metainformation, and possible entity-body content. The relationship | metainformation, and possible entity-body content. The relationship | |||
| between HTTP and MIME is described in Appendix A of [Part3]. | between HTTP and MIME is described in Appendix A of [Part3]. | |||
| skipping to change at page 11, line 34 | skipping to change at page 8, line 7 | |||
| response structures onto the transport data units of the protocol in | response structures onto the transport data units of the protocol in | |||
| question is outside the scope of this specification. | question is outside the scope of this specification. | |||
| In HTTP/1.0, most implementations used a new connection for each | In HTTP/1.0, most implementations used a new connection for each | |||
| request/response exchange. In HTTP/1.1, a connection may be used for | request/response exchange. In HTTP/1.1, a connection may be used for | |||
| one or more request/response exchanges, although connections may be | one or more request/response exchanges, although connections may be | |||
| closed for a variety of reasons (see Section 7.1). | closed for a variety of reasons (see Section 7.1). | |||
| 2. Notational Conventions and Generic Grammar | 2. Notational Conventions and Generic Grammar | |||
| 2.1. Augmented BNF | 2.1. ABNF Extension: #rule | |||
| All of the mechanisms specified in this document are described in | ||||
| both prose and an augmented Backus-Naur Form (BNF) similar to that | ||||
| used by [RFC822ABNF]. Implementors will need to be familiar with the | ||||
| notation in order to understand this specification. The augmented | ||||
| BNF includes the following constructs: | ||||
| name = definition | ||||
| The name of a rule is simply the name itself (without any | ||||
| enclosing "<" and ">") and is separated from its definition by the | ||||
| equal "=" character. White space is only significant in that | ||||
| indentation of continuation lines is used to indicate a rule | ||||
| definition that spans more than one line. Certain basic rules are | ||||
| in uppercase, such as SP, LWS, HTAB, CRLF, DIGIT, ALPHA, etc. | ||||
| Angle brackets are used within definitions whenever their presence | ||||
| will facilitate discerning the use of rule names. | ||||
| "literal" | ||||
| Quotation marks surround literal text. Unless stated otherwise, | ||||
| the text is case-insensitive. | ||||
| rule1 | rule2 | ||||
| Elements separated by a bar ("|") are alternatives, e.g., "yes | | ||||
| no" will accept yes or no. | ||||
| (rule1 rule2) | ||||
| Elements enclosed in parentheses are treated as a single element. | ||||
| Thus, "(elem (foo | bar) elem)" allows the token sequences "elem | ||||
| foo elem" and "elem bar elem". | ||||
| *rule | ||||
| The character "*" preceding an element indicates repetition. The | ||||
| full form is "<n>*<m>element" indicating at least <n> and at most | ||||
| <m> occurrences of element. Default values are 0 and infinity so | ||||
| that "*(element)" allows any number, including zero; "1*element" | ||||
| requires at least one; and "1*2element" allows one or two. | ||||
| [rule] | ||||
| Square brackets enclose optional elements; "[foo bar]" is | ||||
| equivalent to "*1(foo bar)". | ||||
| N rule | ||||
| Specific repetition: "<n>(element)" is equivalent to | ||||
| "<n>*<n>(element)"; that is, exactly <n> occurrences of (element). | ||||
| Thus 2DIGIT is a 2-digit number, and 3ALPHA is a string of three | ||||
| alphabetic characters. | ||||
| #rule | One extension to the ABNF rules of [RFC5234] is used to improve | |||
| readability. | ||||
| A construct "#" is defined, similar to "*", for defining lists of | A construct "#" is defined, similar to "*", for defining lists of | |||
| elements. The full form is "<n>#<m>element" indicating at least | elements. The full form is "<n>#<m>element" indicating at least <n> | |||
| <n> and at most <m> elements, each separated by one or more commas | and at most <m> elements, each separated by one or more commas (",") | |||
| (",") and OPTIONAL linear white space (LWS). This makes the usual | and OPTIONAL linear white space (OWS). This makes the usual form of | |||
| form of lists very easy; a rule such as | lists very easy; a rule such as | |||
| ( *OWS element *( *OWS "," *OWS element )) | ||||
| ( *LWS element *( *LWS "," *LWS element )) | ||||
| can be shown as | can be shown as | |||
| 1#element | 1#element | |||
| Wherever this construct is used, null elements are allowed, but do | Wherever this construct is used, null elements are allowed, but do | |||
| not contribute to the count of elements present. That is, | not contribute to the count of elements present. That is, | |||
| "(element), , (element) " is permitted, but counts as only two | "(element), , (element) " is permitted, but counts as only two | |||
| elements. Therefore, where at least one element is required, at | elements. Therefore, where at least one element is required, at | |||
| least one non-null element MUST be present. Default values are 0 | least one non-null element MUST be present. Default values are 0 and | |||
| and infinity so that "#element" allows any number, including zero; | infinity so that "#element" allows any number, including zero; | |||
| "1#element" requires at least one; and "1#2element" allows one or | "1#element" requires at least one; and "1#2element" allows one or | |||
| two. | two. | |||
| ; comment | [[abnf.list: At a later point of time, we may want to add an appendix | |||
| containing the whole ABNF, with the list rules expanded to strict RFC | ||||
| A semi-colon, set off some distance to the right of rule text, | 5234 notation.]] | |||
| starts a comment that continues to the end of line. This is a | ||||
| simple way of including useful notes in parallel with the | ||||
| specifications. | ||||
| implied *LWS | ||||
| The grammar described by this specification is word-based. Except | ||||
| where noted otherwise, linear white space (LWS) can be included | ||||
| between any two adjacent words (token or quoted-string), and | ||||
| between adjacent words and separators, without changing the | ||||
| interpretation of a field. At least one delimiter (LWS and/or | ||||
| separators) MUST exist between any two tokens (for the definition | ||||
| of "token" below), since they would otherwise be interpreted as a | ||||
| single token. | ||||
| 2.2. Basic Rules | 2.2. Basic Rules | |||
| The following rules are used throughout this specification to | This specification uses the Augmented Backus-Naur Form (ABNF) | |||
| describe basic parsing constructs. The US-ASCII coded character set | notation of [RFC5234]. The following core rules are included by | |||
| is defined by ANSI X3.4-1986 [USASCII]. | reference, as defined in [RFC5234], Appendix B.1: ALPHA (letters), | |||
| CHAR (any [USASCII] character, excluding NUL), CR (carriage return), | ||||
| OCTET = %x00-FF | CRLF (CR LF), CTL (controls), DIGIT (decimal 0-9), DQUOTE (double | |||
| ; any 8-bit sequence of data | quote), HEXDIG (hexadecimal 0-9/A-F/a-f), HTAB (horizontal tab), LF | |||
| CHAR = %x01-7F | (line feed), OCTET (any 8-bit sequence of data), SP (space) and WSP | |||
| ; any US-ASCII character, excluding NUL | (white space). | |||
| ALPHA = %x41-5A | %x61-7A | ||||
| ; A-Z | a-z | ||||
| DIGIT = %x30-39 | ||||
| ; any US-ASCII digit "0".."9" | ||||
| CTL = %x00-1F | %x7F | ||||
| ; (octets 0 - 31) and DEL (127) | ||||
| CR = %x0D | ||||
| ; US-ASCII CR, carriage return (13) | ||||
| LF = %x0A | ||||
| ; US-ASCII LF, linefeed (10) | ||||
| SP = %x20 | ||||
| ; US-ASCII SP, space (32) | ||||
| HTAB = %x09 | ||||
| ; US-ASCII HT, horizontal-tab (9) | ||||
| DQUOTE = %x22 | ||||
| ; US-ASCII double-quote mark (34) | ||||
| HTTP/1.1 defines the sequence CR LF as the end-of-line marker for all | HTTP/1.1 defines the sequence CR LF as the end-of-line marker for all | |||
| protocol elements except the entity-body (see Appendix A for tolerant | protocol elements except the entity-body (see Appendix A for tolerant | |||
| applications). The end-of-line marker within an entity-body is | applications). The end-of-line marker within an entity-body is | |||
| defined by its associated media type, as described in Section 3.3 of | defined by its associated media type, as described in Section 3.3 of | |||
| [Part3]. | [Part3]. | |||
| CRLF = CR LF | All linear white space (LWS) in header field-values has the same | |||
| semantics as SP. A recipient MAY replace any such linear white space | ||||
| with a single SP before interpreting the field value or forwarding | ||||
| the message downstream. | ||||
| HTTP/1.1 header field values can be folded onto multiple lines if the | Historically, HTTP/1.1 header field values allow linear white space | |||
| continuation line begins with a space or horizontal tab. All linear | folding across multiple lines. However, this specification | |||
| white space, including folding, has the same semantics as SP. A | deprecates its use; senders MUST NOT produce messages that include | |||
| recipient MAY replace any linear white space with a single SP before | LWS folding (i.e., use the obs-fold rule), except within the message/ | |||
| interpreting the field value or forwarding the message downstream. | http media type (Section 9.3.1). Receivers SHOULD still parse folded | |||
| linear white space. | ||||
| LWS = [CRLF] 1*( SP | HTAB ) | This specification uses three rules to denote the use of linear white | |||
| space; BWS ("Bad" White Space), OWS (Optional White Space), and RWS | ||||
| (Required White Space). | ||||
| "Bad" white space is allowed by the BNF, but senders SHOULD NOT | ||||
| produce it in messages. Receivers MUST accept it in incoming | ||||
| messages. | ||||
| Required white space is used when at least one linear white space | ||||
| character is required to separate field tokens. In all such cases, a | ||||
| single SP character SHOULD be used. | ||||
| OWS = *( [ obs-fold ] WSP ) | ||||
| ; "optional" white space | ||||
| RWS = 1*( [ obs-fold ] WSP ) | ||||
| ; "required" white space | ||||
| BWS = OWS | ||||
| ; "bad" white space | ||||
| obs-fold = CRLF | ||||
| The TEXT rule is only used for descriptive field contents and values | The TEXT rule is only used for descriptive field contents and values | |||
| that are not intended to be interpreted by the message parser. Words | that are not intended to be interpreted by the message parser. Words | |||
| of *TEXT MAY contain characters from character sets other than ISO- | of *TEXT MAY contain characters from character sets other than ISO- | |||
| 8859-1 [ISO-8859-1] only when encoded according to the rules of | 8859-1 [ISO-8859-1] only when encoded according to the rules of | |||
| [RFC2047]. | [RFC2047]. | |||
| TEXT = %x20-7E | %x80-FF | LWS | TEXT = %x20-7E / %x80-FF / OWS | |||
| ; any OCTET except CTLs, but including LWS | ; any OCTET except CTLs, but including OWS | |||
| A CRLF is allowed in the definition of TEXT only as part of a header | A CRLF is allowed in the definition of TEXT only as part of a header | |||
| field continuation. It is expected that the folding LWS will be | field continuation. It is expected that the folding LWS will be | |||
| replaced with a single SP before interpretation of the TEXT value. | replaced with a single SP before interpretation of the TEXT value. | |||
| Hexadecimal numeric characters are used in several protocol elements. | ||||
| HEXDIG = "A" | "B" | "C" | "D" | "E" | "F" | ||||
| | "a" | "b" | "c" | "d" | "e" | "f" | DIGIT | ||||
| Many HTTP/1.1 header field values consist of words separated by LWS | Many HTTP/1.1 header field values consist of words separated by LWS | |||
| or special characters. These special characters MUST be in a quoted | or special characters. These special characters MUST be in a quoted | |||
| string to be used within a parameter value (as defined in | string to be used within a parameter value (as defined in | |||
| Section 3.4). | Section 3.4). | |||
| separators = "(" | ")" | "<" | ">" | "@" | tchar = "!" / "#" / "$" / "%" / "&" / "'" / "*" | |||
| | "," | ";" | ":" | "\" | DQUOTE | / "+" / "-" / "." / "^" / "_" / "`" / "|" / "~" | |||
| | "/" | "[" | "]" | "?" | "=" | / DIGIT / ALPHA | |||
| | "{" | "}" | SP | HTAB | ||||
| tchar = "!" | "#" | "$" | "%" | "&" | "'" | "*" | ||||
| | "+" | "-" | "." | "^" | "_" | "`" | "|" | "~" | ||||
| | DIGIT | ALPHA | ||||
| ; any CHAR except CTLs or separators | ||||
| token = 1*tchar | token = 1*tchar | |||
| Comments can be included in some HTTP header fields by surrounding | Comments can be included in some HTTP header fields by surrounding | |||
| the comment text with parentheses. Comments are only allowed in | the comment text with parentheses. Comments are only allowed in | |||
| fields containing "comment" as part of their field value definition. | fields containing "comment" as part of their field value definition. | |||
| In all other fields, parentheses are considered part of the field | In all other fields, parentheses are considered part of the field | |||
| value. | value. | |||
| comment = "(" *( ctext | quoted-pair | comment ) ")" | comment = "(" *( ctext / quoted-pair / comment ) ")" | |||
| ctext = <any TEXT excluding "(" and ")"> | ctext = <any TEXT excluding "(" and ")"> | |||
| A string of text is parsed as a single word if it is quoted using | A string of text is parsed as a single word if it is quoted using | |||
| double-quote marks. | double-quote marks. | |||
| quoted-string = ( DQUOTE *(qdtext | quoted-pair ) DQUOTE ) | quoted-string = DQUOTE *(qdtext / quoted-pair ) DQUOTE | |||
| qdtext = <any TEXT excluding DQUOTE and "\"> | qdtext = <any TEXT excluding DQUOTE and "\"> | |||
| The backslash character ("\") MAY be used as a single-character | The backslash character ("\") MAY be used as a single-character | |||
| quoting mechanism only within quoted-string and comment constructs. | quoting mechanism only within quoted-string and comment constructs. | |||
| quoted-text = %x01-09 | | quoted-text = %x01-09 / | |||
| %x0B-0C | | %x0B-0C / | |||
| %x0E-FF ; Characters excluding NUL, CR and LF | %x0E-FF ; Characters excluding NUL, CR and LF | |||
| quoted-pair = "\" quoted-text | quoted-pair = "\" quoted-text | |||
| 2.3. ABNF Rules defined in other Parts of the Specification | 2.3. 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: | |||
| request-header = <request-header, defined in [Part2], Section 4> | request-header = <request-header, defined in [Part2], Section 4> | |||
| response-header = <response-header, defined in [Part2], Section 6> | response-header = <response-header, defined in [Part2], Section 6> | |||
| skipping to change at page 17, line 36 | skipping to change at page 12, line 17 | |||
| since the publication of [RFC2068], caching proxies MUST, gateways | since the publication of [RFC2068], caching proxies MUST, gateways | |||
| MAY, and tunnels MUST NOT upgrade the request to the highest version | MAY, and tunnels MUST NOT upgrade the request to the highest version | |||
| they support. The proxy/gateway's response to that request MUST be | they support. The proxy/gateway's response to that request MUST be | |||
| in the same major version as the request. | in the same major version as the request. | |||
| Note: Converting between versions of HTTP may involve modification | Note: Converting between versions of HTTP may involve modification | |||
| of header fields required or forbidden by the versions involved. | of header fields required or forbidden by the versions involved. | |||
| 3.2. Uniform Resource Identifiers | 3.2. Uniform Resource Identifiers | |||
| URIs have been known by many names: WWW addresses, Universal Document | Uniform Resource Identifiers (URIs) [RFC3986] are used in HTTP to | |||
| Identifiers, Universal Resource Identifiers [RFC1630], and finally | indicate the target of a request and to identify additional resources | |||
| the combination of Uniform Resource Locators (URL) [RFC1738] and | related to that resource, the request, or the response. Each | |||
| Names (URN) [RFC1737]. As far as HTTP is concerned, Uniform Resource | protocol element in HTTP that allows a URI reference will indicate in | |||
| Identifiers are simply formatted strings which identify--via name, | its ABNF whether the element allows only a URI in absolute form, any | |||
| location, or any other characteristic--a resource. | relative reference, or some limited subset of the URI-reference | |||
| grammar. Unless otherwise indicated, relative URI references are to | ||||
| be parsed relative to the URI corresponding to the request target | ||||
| (the base URI). | ||||
| 3.2.1. General Syntax | This specification adopts the definitions of "URI-reference", | |||
| "absolute-URI", "fragment", "port", "host", "path-abempty", "path- | ||||
| absolute", "query", and "authority" from [RFC3986]: | ||||
| URIs in HTTP can be represented in absolute form or relative to some | absolute-URI = <absolute-URI, defined in [RFC3986], Section 4.3> | |||
| known base URI [RFC1808], depending upon the context of their use. | authority = <authority, defined in [RFC3986], Section 3.2> | |||
| The two forms are differentiated by the fact that absolute URIs | fragment = <fragment, defined in [RFC3986], Section 3.5> | |||
| always begin with a scheme name followed by a colon. For definitive | path-abempty = <path-abempty, defined in [RFC3986], Section 3.3> | |||
| information on URL syntax and semantics, see "Uniform Resource | path-absolute = <path-absolute, defined in [RFC3986], Section 3.3> | |||
| Identifiers (URI): Generic Syntax and Semantics," [RFC2396] (which | port = <port, defined in [RFC3986], Section 3.2.3> | |||
| replaces [RFC1738] and [RFC1808]). This specification adopts the | query = <query, defined in [RFC3986], Section 3.4> | |||
| definitions of "URI-reference", "absoluteURI", "fragment", | uri-host = <host, defined in [RFC3986], Section 3.2.2> | |||
| "relativeURI", "port", "host", "abs_path", "query", and "authority" | ||||
| from that specification: | ||||
| absoluteURI = <absoluteURI, defined in [RFC2396], Section 3> | relative-part = <relative-part, defined in [RFC3986], Section 4.2> | |||
| authority = <authority, defined in [RFC2396], Section 3.2> | relativeURI = relative-part [ "?" query ] | |||
| fragment = <fragment, defined in [RFC2396], Section 4.1> | ||||
| path-absolute = <abs_path, defined in [RFC2396], Section 3> | ||||
| port = <port, defined in [RFC2396], Section 3.2.2> | ||||
| query = <query, defined in [RFC2396], Section 3.4> | ||||
| relativeURI = <relativeURI, defined in [RFC2396], Section 5> | ||||
| uri-host = <host, defined in [RFC2396], Section 3.2.2> | ||||
| HTTP does not place any a priori limit on the length of a URI. | HTTP does not place an a priori limit on the length of a URI. | |||
| Servers MUST be able to handle the URI of any resource they serve, | Servers MUST be able to handle the URI of any resource they serve, | |||
| and SHOULD be able to handle URIs of unbounded length if they provide | and SHOULD be able to handle URIs of unbounded length if they provide | |||
| GET-based forms that could generate such URIs. A server SHOULD | GET-based forms that could generate such URIs. A server SHOULD | |||
| return 414 (Request-URI Too Long) status if a URI is longer than the | return 414 (Request-URI Too Long) status if a URI is longer than the | |||
| server can handle (see Section 9.4.15 of [Part2]). | server can handle (see Section 9.4.15 of [Part2]). | |||
| Note: Servers ought to be cautious about depending on URI lengths | Note: Servers ought to be cautious about depending on URI lengths | |||
| above 255 bytes, because some older client or proxy | above 255 bytes, because some older client or proxy | |||
| implementations might not properly support these lengths. | implementations might not properly support these lengths. | |||
| 3.2.2. http URL | 3.2.1. http URI scheme | |||
| The "http" scheme is used to locate network resources via the HTTP | The "http" scheme is used to locate network resources via the HTTP | |||
| protocol. This section defines the scheme-specific syntax and | protocol. This section defines the syntax and semantics for | |||
| semantics for http URLs. | identifiers using the http or https URI schemes. | |||
| http-URL = "http:" "//" uri-host [ ":" port ] | http-URI = "http:" "//" authority path-abempty [ "?" query ] | |||
| [ path-absolute [ "?" query ]] | ||||
| If the port is empty or not given, port 80 is assumed. The semantics | If the port is empty or not given, port 80 is assumed. The semantics | |||
| are that the identified resource is located at the server listening | are that the identified resource is located at the server listening | |||
| for TCP connections on that port of that host, and the Request-URI | for TCP connections on that port of that host, and the Request-URI | |||
| for the resource is path-absolute (Section 5.1.2). The use of IP | for the resource is path-absolute (Section 5.1.2). The use of IP | |||
| addresses in URLs SHOULD be avoided whenever possible (see | addresses in URLs SHOULD be avoided whenever possible (see | |||
| [RFC1900]). If the path-absolute is not present in the URL, it MUST | [RFC1900]). If the path-absolute is not present in the URL, it MUST | |||
| be given as "/" when used as a Request-URI for a resource | be given as "/" when used as a Request-URI for a resource | |||
| (Section 5.1.2). If a proxy receives a host name which is not a | (Section 5.1.2). If a proxy receives a host name which is not a | |||
| fully qualified domain name, it MAY add its domain to the host name | fully qualified domain name, it MAY add its domain to the host name | |||
| it received. If a proxy receives a fully qualified domain name, the | it received. If a proxy receives a fully qualified domain name, the | |||
| proxy MUST NOT change the host name. | proxy MUST NOT change the host name. | |||
| Note: the "https" scheme is defined in [RFC2818]. | Note: the "https" scheme is defined in [RFC2818]. | |||
| 3.2.3. URI Comparison | 3.2.2. URI Comparison | |||
| When comparing two URIs to decide if they match or not, a client | When comparing two URIs to decide if they match or not, a client | |||
| SHOULD use a case-sensitive octet-by-octet comparison of the entire | SHOULD use a case-sensitive octet-by-octet comparison of the entire | |||
| URIs, with these exceptions: | URIs, with these exceptions: | |||
| o A port that is empty or not given is equivalent to the default | o A port that is empty or not given is equivalent to the default | |||
| port for that URI-reference; | port for that URI-reference; | |||
| o Comparisons of host names MUST be case-insensitive; | o Comparisons of host names MUST be case-insensitive; | |||
| o Comparisons of scheme names MUST be case-insensitive; | o Comparisons of scheme names MUST be case-insensitive; | |||
| o An empty path-absolute is equivalent to an path-absolute of "/". | o An empty path-absolute is equivalent to an path-absolute of "/". | |||
| Characters other than those in the "reserved" set (see [RFC2396], | Characters other than those in the "reserved" set (see [RFC3986], | |||
| Section 2.2) are equivalent to their ""%" HEXDIG HEXDIG" encoding. | Section 2.2) are equivalent to their ""%" HEXDIG HEXDIG" encoding. | |||
| For example, the following three URIs are equivalent: | For example, the following three URIs are equivalent: | |||
| http://example.com:80/~smith/home.html | http://example.com:80/~smith/home.html | |||
| http://EXAMPLE.com/%7Esmith/home.html | http://EXAMPLE.com/%7Esmith/home.html | |||
| http://EXAMPLE.com:/%7esmith/home.html | http://EXAMPLE.com:/%7esmith/home.html | |||
| 3.3. Date/Time Formats | 3.3. Date/Time Formats | |||
| skipping to change at page 20, line 14 | skipping to change at page 14, line 40 | |||
| All HTTP date/time stamps MUST be represented in Greenwich Mean Time | All HTTP date/time stamps MUST be represented in Greenwich Mean Time | |||
| (GMT), without exception. For the purposes of HTTP, GMT is exactly | (GMT), without exception. For the purposes of HTTP, GMT is exactly | |||
| equal to UTC (Coordinated Universal Time). This is indicated in the | equal to UTC (Coordinated Universal Time). This is indicated in the | |||
| first two formats by the inclusion of "GMT" as the three-letter | first two formats by the inclusion of "GMT" as the three-letter | |||
| abbreviation for time zone, and MUST be assumed when reading the | abbreviation for time zone, and MUST be assumed when reading the | |||
| asctime format. HTTP-date is case sensitive and MUST NOT include | asctime format. HTTP-date is case sensitive and MUST NOT include | |||
| additional LWS beyond that specifically included as SP in the | additional LWS beyond that specifically included as SP in the | |||
| grammar. | grammar. | |||
| HTTP-date = rfc1123-date | obsolete-date | HTTP-date = rfc1123-date / obsolete-date | |||
| obsolete-date = rfc850-date | asctime-date | obsolete-date = rfc850-date / asctime-date | |||
| rfc1123-date = wkday "," SP date1 SP time SP GMT | rfc1123-date = wkday "," SP date1 SP time SP GMT | |||
| rfc850-date = weekday "," SP date2 SP time SP GMT | rfc850-date = weekday "," SP date2 SP time SP GMT | |||
| asctime-date = wkday SP date3 SP time SP 4DIGIT | asctime-date = wkday SP date3 SP time SP 4DIGIT | |||
| date1 = 2DIGIT SP month SP 4DIGIT | date1 = 2DIGIT SP month SP 4DIGIT | |||
| ; day month year (e.g., 02 Jun 1982) | ; day month year (e.g., 02 Jun 1982) | |||
| date2 = 2DIGIT "-" month "-" 2DIGIT | date2 = 2DIGIT "-" month "-" 2DIGIT | |||
| ; day-month-year (e.g., 02-Jun-82) | ; day-month-year (e.g., 02-Jun-82) | |||
| date3 = month SP ( 2DIGIT | ( SP 1DIGIT )) | date3 = month SP ( 2DIGIT / ( SP 1DIGIT )) | |||
| ; month day (e.g., Jun 2) | ; month day (e.g., Jun 2) | |||
| time = 2DIGIT ":" 2DIGIT ":" 2DIGIT | time = 2DIGIT ":" 2DIGIT ":" 2DIGIT | |||
| ; 00:00:00 - 23:59:59 | ; 00:00:00 - 23:59:59 | |||
| wkday = s-Mon | s-Tue | s-Wed | wkday = s-Mon / s-Tue / s-Wed | |||
| | s-Thu | s-Fri | s-Sat | s-Sun | / s-Thu / s-Fri / s-Sat / s-Sun | |||
| weekday = l-Mon | l-Tue | l-Wed | weekday = l-Mon / l-Tue / l-Wed | |||
| | l-Thu | l-Fri | l-Sat | l-Sun | / l-Thu / l-Fri / l-Sat / l-Sun | |||
| month = s-Jan | s-Feb | s-Mar | s-Apr | month = s-Jan / s-Feb / s-Mar / s-Apr | |||
| | s-May | s-Jun | s-Jul | s-Aug | / s-May / s-Jun / s-Jul / s-Aug | |||
| | s-Sep | s-Oct | s-Nov | s-Dec | / s-Sep / s-Oct / s-Nov / s-Dec | |||
| GMT = %x47.4D.54 ; "GMT", case-sensitive | GMT = %x47.4D.54 ; "GMT", case-sensitive | |||
| s-Mon = %x4D.6F.6E ; "Mon", case-sensitive | s-Mon = %x4D.6F.6E ; "Mon", case-sensitive | |||
| s-Tue = %x54.75.65 ; "Tue", case-sensitive | s-Tue = %x54.75.65 ; "Tue", case-sensitive | |||
| s-Wed = %x57.65.64 ; "Wed", case-sensitive | s-Wed = %x57.65.64 ; "Wed", case-sensitive | |||
| s-Thu = %x54.68.75 ; "Thu", case-sensitive | s-Thu = %x54.68.75 ; "Thu", case-sensitive | |||
| s-Fri = %x46.72.69 ; "Fri", case-sensitive | s-Fri = %x46.72.69 ; "Fri", case-sensitive | |||
| s-Sat = %x53.61.74 ; "Sat", case-sensitive | s-Sat = %x53.61.74 ; "Sat", case-sensitive | |||
| s-Sun = %x53.75.6E ; "Sun", case-sensitive | s-Sun = %x53.75.6E ; "Sun", case-sensitive | |||
| skipping to change at page 21, line 30 | skipping to change at page 16, line 13 | |||
| etc. | etc. | |||
| 3.4. Transfer Codings | 3.4. Transfer Codings | |||
| Transfer-coding values are used to indicate an encoding | Transfer-coding values are used to indicate an encoding | |||
| transformation that has been, can be, or may need to be applied to an | transformation that has been, can be, or may need to be applied to an | |||
| entity-body in order to ensure "safe transport" through the network. | entity-body in order to ensure "safe transport" through the network. | |||
| This differs from a content coding in that the transfer-coding is a | This differs from a content coding in that the transfer-coding is a | |||
| property of the message, not of the original entity. | property of the message, not of the original entity. | |||
| transfer-coding = "chunked" | transfer-extension | transfer-coding = "chunked" / transfer-extension | |||
| transfer-extension = token *( ";" parameter ) | transfer-extension = token *( OWS ";" OWS parameter ) | |||
| Parameters are in the form of attribute/value pairs. | Parameters are in the form of attribute/value pairs. | |||
| parameter = attribute "=" value | parameter = attribute BWS "=" BWS value | |||
| attribute = token | attribute = token | |||
| value = token | quoted-string | value = token / quoted-string | |||
| All transfer-coding values are case-insensitive. HTTP/1.1 uses | All transfer-coding values are case-insensitive. HTTP/1.1 uses | |||
| transfer-coding values in the TE header field (Section 8.5) and in | transfer-coding values in the TE header field (Section 8.5) and in | |||
| the Transfer-Encoding header field (Section 8.7). | the Transfer-Encoding header field (Section 8.7). | |||
| Whenever a transfer-coding is applied to a message-body, the set of | Whenever a transfer-coding is applied to a message-body, the set of | |||
| transfer-codings MUST include "chunked", unless the message indicates | transfer-codings MUST include "chunked", unless the message indicates | |||
| it is terminated by closing the connection. When the "chunked" | it is terminated by closing the connection. When the "chunked" | |||
| transfer-coding is used, it MUST be the last transfer-coding applied | transfer-coding is used, it MUST be the last transfer-coding applied | |||
| to the message-body. The "chunked" transfer-coding MUST NOT be | to the message-body. The "chunked" transfer-coding MUST NOT be | |||
| skipping to change at page 22, line 40 | skipping to change at page 17, line 21 | |||
| followed by an OPTIONAL trailer containing entity-header fields. | followed by an OPTIONAL trailer containing entity-header fields. | |||
| This allows dynamically produced content to be transferred along with | This allows dynamically produced content to be transferred along with | |||
| the information necessary for the recipient to verify that it has | the information necessary for the recipient to verify that it has | |||
| received the full message. | received the full message. | |||
| Chunked-Body = *chunk | Chunked-Body = *chunk | |||
| last-chunk | last-chunk | |||
| trailer-part | trailer-part | |||
| CRLF | CRLF | |||
| chunk = chunk-size [ chunk-extension ] CRLF | chunk = chunk-size *WSP [ chunk-ext ] CRLF | |||
| chunk-data CRLF | chunk-data CRLF | |||
| chunk-size = 1*HEXDIG | chunk-size = 1*HEXDIG | |||
| last-chunk = 1*("0") [ chunk-extension ] CRLF | last-chunk = 1*("0") *WSP [ chunk-ext ] CRLF | |||
| chunk-extension= *( ";" chunk-ext-name [ "=" chunk-ext-val ] ) | chunk-ext = *( ";" *WSP chunk-ext-name | |||
| [ "=" chunk-ext-val ] *WSP ) | ||||
| chunk-ext-name = token | chunk-ext-name = token | |||
| chunk-ext-val = token | quoted-string | chunk-ext-val = token / quoted-string | |||
| chunk-data = 1*OCTET ; a sequence of chunk-size octets | chunk-data = 1*OCTET ; a sequence of chunk-size octets | |||
| trailer-part = *(entity-header CRLF) | trailer-part = *(entity-header CRLF) | |||
| The chunk-size field is a string of hex digits indicating the size of | The chunk-size field is a string of hex digits indicating the size of | |||
| the chunk-data in octets. The chunked encoding is ended by any chunk | the chunk-data in octets. The chunked encoding is ended by any chunk | |||
| whose size is zero, followed by the trailer, which is terminated by | whose size is zero, followed by the trailer, which is terminated by | |||
| an empty line. | an empty line. | |||
| The trailer allows the sender to include additional HTTP header | The trailer allows the sender to include additional HTTP header | |||
| fields at the end of the message. The Trailer header field can be | fields at the end of the message. The Trailer header field can be | |||
| skipping to change at page 23, line 38 | skipping to change at page 18, line 22 | |||
| This requirement prevents an interoperability failure when the | This requirement prevents an interoperability failure when the | |||
| message is being received by an HTTP/1.1 (or later) proxy and | message is being received by an HTTP/1.1 (or later) proxy and | |||
| forwarded to an HTTP/1.0 recipient. It avoids a situation where | forwarded to an HTTP/1.0 recipient. It avoids a situation where | |||
| compliance with the protocol would have necessitated a possibly | compliance with the protocol would have necessitated a possibly | |||
| infinite buffer on the proxy. | infinite buffer on the proxy. | |||
| A process for decoding the "chunked" transfer-coding can be | A process for decoding the "chunked" transfer-coding can be | |||
| represented in pseudo-code as: | represented in pseudo-code as: | |||
| length := 0 | length := 0 | |||
| read chunk-size, chunk-extension (if any) and CRLF | read chunk-size, chunk-ext (if any) and CRLF | |||
| while (chunk-size > 0) { | while (chunk-size > 0) { | |||
| read chunk-data and CRLF | read chunk-data and CRLF | |||
| append chunk-data to entity-body | append chunk-data to entity-body | |||
| length := length + chunk-size | length := length + chunk-size | |||
| read chunk-size and CRLF | read chunk-size and CRLF | |||
| } | } | |||
| read entity-header | read entity-header | |||
| while (entity-header not empty) { | while (entity-header not empty) { | |||
| append entity-header to existing header fields | append entity-header to existing header fields | |||
| read entity-header | read entity-header | |||
| skipping to change at page 24, line 4 | skipping to change at page 18, line 36 | |||
| length := length + chunk-size | length := length + chunk-size | |||
| read chunk-size and CRLF | read chunk-size and CRLF | |||
| } | } | |||
| read entity-header | read entity-header | |||
| while (entity-header not empty) { | while (entity-header not empty) { | |||
| append entity-header to existing header fields | append entity-header to existing header fields | |||
| read entity-header | read entity-header | |||
| } | } | |||
| Content-Length := length | Content-Length := length | |||
| Remove "chunked" from Transfer-Encoding | Remove "chunked" from Transfer-Encoding | |||
| All HTTP/1.1 applications MUST be able to receive and decode the | All HTTP/1.1 applications MUST be able to receive and decode the | |||
| "chunked" transfer-coding, and MUST ignore chunk-extension extensions | "chunked" transfer-coding, and MUST ignore chunk-ext extensions they | |||
| they do not understand. | do not understand. | |||
| 3.5. Product Tokens | 3.5. Product Tokens | |||
| Product tokens are used to allow communicating applications to | Product tokens are used to allow communicating applications to | |||
| identify themselves by software name and version. Most fields using | identify themselves by software name and version. Most fields using | |||
| product tokens also allow sub-products which form a significant part | product tokens also allow sub-products which form a significant part | |||
| of the application to be listed, separated by white space. By | of the application to be listed, separated by white space. By | |||
| convention, the products are listed in order of their significance | convention, the products are listed in order of their significance | |||
| for identifying the application. | for identifying the application. | |||
| skipping to change at page 24, line 39 | skipping to change at page 19, line 23 | |||
| versions of the same product SHOULD only differ in the product- | versions of the same product SHOULD only differ in the product- | |||
| version portion of the product value). | version portion of the product value). | |||
| 4. HTTP Message | 4. HTTP Message | |||
| 4.1. Message Types | 4.1. Message Types | |||
| HTTP messages consist of requests from client to server and responses | HTTP messages consist of requests from client to server and responses | |||
| from server to client. | from server to client. | |||
| HTTP-message = Request | Response ; HTTP/1.1 messages | HTTP-message = Request / Response ; HTTP/1.1 messages | |||
| Request (Section 5) and Response (Section 6) messages use the generic | Request (Section 5) and Response (Section 6) messages use the generic | |||
| message format of [RFC2822] for transferring entities (the payload of | message format of [RFC5322] for transferring entities (the payload of | |||
| the message). Both types of message consist of a start-line, zero or | the message). Both types of message consist of a start-line, zero or | |||
| more header fields (also known as "headers"), an empty line (i.e., a | more header fields (also known as "headers"), an empty line (i.e., a | |||
| line with nothing preceding the CRLF) indicating the end of the | line with nothing preceding the CRLF) indicating the end of the | |||
| header fields, and possibly a message-body. | header fields, and possibly a message-body. | |||
| generic-message = start-line | generic-message = start-line | |||
| *(message-header CRLF) | *(message-header CRLF) | |||
| CRLF | CRLF | |||
| [ message-body ] | [ message-body ] | |||
| start-line = Request-Line | Status-Line | start-line = Request-Line / Status-Line | |||
| In the interest of robustness, servers SHOULD ignore any empty | In the interest of robustness, servers SHOULD ignore any empty | |||
| line(s) received where a Request-Line is expected. In other words, | line(s) received where a Request-Line is expected. In other words, | |||
| if the server is reading the protocol stream at the beginning of a | if the server is reading the protocol stream at the beginning of a | |||
| message and receives a CRLF first, it should ignore the CRLF. | message and receives a CRLF first, it should ignore the CRLF. | |||
| Certain buggy HTTP/1.0 client implementations generate extra CRLF's | Certain buggy HTTP/1.0 client implementations generate extra CRLF's | |||
| after a POST request. To restate what is explicitly forbidden by the | after a POST request. To restate what is explicitly forbidden by the | |||
| BNF, an HTTP/1.1 client MUST NOT preface or follow a request with an | BNF, an HTTP/1.1 client MUST NOT preface or follow a request with an | |||
| extra CRLF. | extra CRLF. | |||
| 4.2. Message Headers | 4.2. Message Headers | |||
| HTTP header fields, which include general-header (Section 4.5), | HTTP header fields, which include general-header (Section 4.5), | |||
| request-header (Section 4 of [Part2]), response-header (Section 6 of | request-header (Section 4 of [Part2]), response-header (Section 6 of | |||
| [Part2]), and entity-header (Section 4.1 of [Part3]) fields, follow | [Part2]), and entity-header (Section 4.1 of [Part3]) fields, follow | |||
| the same generic format as that given in Section 2.1 of [RFC2822]. | the same generic format as that given in Section 2.1 of [RFC5322]. | |||
| Each header field consists of a name followed by a colon (":") and | Each header field consists of a name followed by a colon (":") and | |||
| the field value. Field names are case-insensitive. The field value | the field value. Field names are case-insensitive. The field value | |||
| MAY be preceded by any amount of LWS, though a single SP is | MAY be preceded by any amount of LWS, though a single SP is | |||
| preferred. Header fields can be extended over multiple lines by | preferred. Header fields can be extended over multiple lines by | |||
| preceding each extra line with at least one SP or HTAB. Applications | preceding each extra line with at least one SP or HTAB. Applications | |||
| ought to follow "common form", where one is known or indicated, when | ought to follow "common form", where one is known or indicated, when | |||
| generating HTTP constructs, since there might exist some | generating HTTP constructs, since there might exist some | |||
| implementations that fail to accept anything beyond the common forms. | implementations that fail to accept anything beyond the common forms. | |||
| message-header = field-name ":" [ field-value ] | message-header = field-name ":" [ field-value ] | |||
| field-name = token | field-name = token | |||
| field-value = *( field-content | LWS ) | field-value = *( field-content / OWS ) | |||
| field-content = <field content> | field-content = <field content> | |||
| ; the OCTETs making up the field-value | ||||
| ; and consisting of either *TEXT or combinations | [[anchor1: whitespace between field-name and colon is an error and | |||
| ; of token, separators, and quoted-string | MUST NOT be accepted]] | |||
| The field-content does not include any leading or trailing LWS: | The field-content does not include any leading or trailing LWS: | |||
| linear white space occurring before the first non-whitespace | linear white space occurring before the first non-whitespace | |||
| character of the field-value or after the last non-whitespace | character of the field-value or after the last non-whitespace | |||
| character of the field-value. Such leading or trailing LWS MAY be | character of the field-value. Such leading or trailing LWS MAY be | |||
| removed without changing the semantics of the field value. Any LWS | removed without changing the semantics of the field value. Any LWS | |||
| that occurs between field-content MAY be replaced with a single SP | that occurs between field-content MAY be replaced with a single SP | |||
| before interpreting the field value or forwarding the message | before interpreting the field value or forwarding the message | |||
| downstream. | downstream. | |||
| skipping to change at page 26, line 37 | skipping to change at page 21, line 21 | |||
| 4.3. Message Body | 4.3. Message Body | |||
| The message-body (if any) of an HTTP message is used to carry the | The message-body (if any) of an HTTP message is used to carry the | |||
| entity-body associated with the request or response. The message- | entity-body associated with the request or response. The message- | |||
| body differs from the entity-body only when a transfer-coding has | body differs from the entity-body only when a transfer-coding has | |||
| been applied, as indicated by the Transfer-Encoding header field | been applied, as indicated by the Transfer-Encoding header field | |||
| (Section 8.7). | (Section 8.7). | |||
| message-body = entity-body | message-body = entity-body | |||
| | <entity-body encoded as per Transfer-Encoding> | / <entity-body encoded as per Transfer-Encoding> | |||
| Transfer-Encoding MUST be used to indicate any transfer-codings | Transfer-Encoding MUST be used to indicate any transfer-codings | |||
| applied by an application to ensure safe and proper transfer of the | applied by an application to ensure safe and proper transfer of the | |||
| message. Transfer-Encoding is a property of the message, not of the | message. Transfer-Encoding is a property of the message, not of the | |||
| entity, and thus MAY be added or removed by any application along the | entity, and thus MAY be added or removed by any application along the | |||
| request/response chain. (However, Section 3.4 places restrictions on | request/response chain. (However, Section 3.4 places restrictions on | |||
| when certain transfer-codings may be used.) | when certain transfer-codings may be used.) | |||
| The rules for when a message-body is allowed in a message differ for | The rules for when a message-body is allowed in a message differ for | |||
| requests and responses. | requests and responses. | |||
| skipping to change at page 29, line 6 | skipping to change at page 23, line 34 | |||
| invalid length is received and detected. | invalid length is received and detected. | |||
| 4.5. General Header Fields | 4.5. General Header Fields | |||
| There are a few header fields which have general applicability for | There are a few header fields which have general applicability for | |||
| both request and response messages, but which do not apply to the | both request and response messages, but which do not apply to the | |||
| entity being transferred. These header fields apply only to the | entity being transferred. These header fields apply only to the | |||
| message being transmitted. | message being transmitted. | |||
| general-header = Cache-Control ; [Part6], Section 16.2 | general-header = Cache-Control ; [Part6], Section 16.2 | |||
| | Connection ; Section 8.1 | / Connection ; Section 8.1 | |||
| | Date ; Section 8.3 | / Date ; Section 8.3 | |||
| | Pragma ; [Part6], Section 16.4 | / Pragma ; [Part6], Section 16.4 | |||
| | Trailer ; Section 8.6 | / Trailer ; Section 8.6 | |||
| | Transfer-Encoding ; Section 8.7 | / Transfer-Encoding ; Section 8.7 | |||
| | Upgrade ; Section 8.8 | / Upgrade ; Section 8.8 | |||
| | Via ; Section 8.9 | / Via ; Section 8.9 | |||
| | Warning ; [Part6], Section 16.6 | / Warning ; [Part6], Section 16.6 | |||
| General-header field names can be extended reliably only in | General-header field names can be extended reliably only in | |||
| combination with a change in the protocol version. However, new or | combination with a change in the protocol version. However, new or | |||
| experimental header fields may be given the semantics of general | experimental header fields may be given the semantics of general | |||
| header fields if all parties in the communication recognize them to | header fields if all parties in the communication recognize them to | |||
| be general-header fields. Unrecognized header fields are treated as | be general-header fields. Unrecognized header fields are treated as | |||
| entity-header fields. | entity-header fields. | |||
| 5. Request | 5. Request | |||
| A request message from a client to a server includes, within the | A request message from a client to a server includes, within the | |||
| first line of that message, the method to be applied to the resource, | first line of that message, the method to be applied to the resource, | |||
| the identifier of the resource, and the protocol version in use. | the identifier of the resource, and the protocol version in use. | |||
| Request = Request-Line ; Section 5.1 | Request = Request-Line ; Section 5.1 | |||
| *(( general-header ; Section 4.5 | *(( general-header ; Section 4.5 | |||
| | request-header ; [Part2], Section 4 | / request-header ; [Part2], Section 4 | |||
| | entity-header ) CRLF) ; [Part3], Section 4.1 | / entity-header ) CRLF) ; [Part3], Section 4.1 | |||
| CRLF | CRLF | |||
| [ message-body ] ; Section 4.3 | [ message-body ] ; Section 4.3 | |||
| 5.1. Request-Line | 5.1. Request-Line | |||
| The Request-Line begins with a method token, followed by the Request- | The Request-Line begins with a method token, followed by the Request- | |||
| URI and the protocol version, and ending with CRLF. The elements are | URI and the protocol version, and ending with CRLF. The elements are | |||
| separated by SP characters. No CR or LF is allowed except in the | separated by SP characters. No CR or LF is allowed except in the | |||
| final CRLF sequence. | final CRLF sequence. | |||
| skipping to change at page 30, line 11 | skipping to change at page 24, line 40 | |||
| identified by the Request-URI. The method is case-sensitive. | identified by the Request-URI. The method is case-sensitive. | |||
| Method = token | Method = token | |||
| 5.1.2. Request-URI | 5.1.2. Request-URI | |||
| The Request-URI is a Uniform Resource Identifier (Section 3.2) and | The Request-URI is a Uniform Resource Identifier (Section 3.2) and | |||
| identifies the resource upon which to apply the request. | identifies the resource upon which to apply the request. | |||
| Request-URI = "*" | Request-URI = "*" | |||
| | absoluteURI | / absolute-URI | |||
| | ( path-absolute [ "?" query ] ) | / ( path-absolute [ "?" query ] ) | |||
| | authority | / authority | |||
| The four options for Request-URI are dependent on the nature of the | The four options for Request-URI are dependent on the nature of the | |||
| request. The asterisk "*" means that the request does not apply to a | request. The asterisk "*" means that the request does not apply to a | |||
| particular resource, but to the server itself, and is only allowed | particular resource, but to the server itself, and is only allowed | |||
| when the method used does not necessarily apply to a resource. One | when the method used does not necessarily apply to a resource. One | |||
| example would be | example would be | |||
| OPTIONS * HTTP/1.1 | OPTIONS * HTTP/1.1 | |||
| The absoluteURI form is REQUIRED when the request is being made to a | The absolute-URI form is REQUIRED when the request is being made to a | |||
| proxy. The proxy is requested to forward the request or service it | proxy. The proxy is requested to forward the request or service it | |||
| from a valid cache, and return the response. Note that the proxy MAY | from a valid cache, and return the response. Note that the proxy MAY | |||
| forward the request on to another proxy or directly to the server | forward the request on to another proxy or directly to the server | |||
| specified by the absoluteURI. In order to avoid request loops, a | specified by the absolute-URI. In order to avoid request loops, a | |||
| proxy MUST be able to recognize all of its server names, including | proxy MUST be able to recognize all of its server names, including | |||
| any aliases, local variations, and the numeric IP address. An | any aliases, local variations, and the numeric IP address. An | |||
| example Request-Line would be: | example Request-Line would be: | |||
| GET http://www.example.org/pub/WWW/TheProject.html HTTP/1.1 | GET http://www.example.org/pub/WWW/TheProject.html HTTP/1.1 | |||
| To allow for transition to absoluteURIs in all requests in future | To allow for transition to absolute-URIs in all requests in future | |||
| versions of HTTP, all HTTP/1.1 servers MUST accept the absoluteURI | versions of HTTP, all HTTP/1.1 servers MUST accept the absolute-URI | |||
| form in requests, even though HTTP/1.1 clients will only generate | form in requests, even though HTTP/1.1 clients will only generate | |||
| them in requests to proxies. | them in requests to proxies. | |||
| The authority form is only used by the CONNECT method (Section 8.9 of | The authority form is only used by the CONNECT method (Section 8.9 of | |||
| [Part2]). | [Part2]). | |||
| The most common form of Request-URI is that used to identify a | The most common form of Request-URI is that used to identify a | |||
| resource on an origin server or gateway. In this case the absolute | resource on an origin server or gateway. In this case the absolute | |||
| path of the URI MUST be transmitted (see Section 3.2.1, path- | path of the URI MUST be transmitted (see Section 3.2.1, path- | |||
| absolute) as the Request-URI, and the network location of the URI | absolute) as the Request-URI, and the network location of the URI | |||
| skipping to change at page 31, line 4 | skipping to change at page 25, line 33 | |||
| resource on an origin server or gateway. In this case the absolute | resource on an origin server or gateway. In this case the absolute | |||
| path of the URI MUST be transmitted (see Section 3.2.1, path- | path of the URI MUST be transmitted (see Section 3.2.1, path- | |||
| absolute) as the Request-URI, and the network location of the URI | absolute) as the Request-URI, and the network location of the URI | |||
| (authority) MUST be transmitted in a Host header field. For example, | (authority) MUST be transmitted in a Host header field. For example, | |||
| a client wishing to retrieve the resource above directly from the | a client wishing to retrieve the resource above directly from the | |||
| origin server would create a TCP connection to port 80 of the host | origin server would create a TCP connection to port 80 of the host | |||
| "www.example.org" and send the lines: | "www.example.org" and send the lines: | |||
| GET /pub/WWW/TheProject.html HTTP/1.1 | GET /pub/WWW/TheProject.html HTTP/1.1 | |||
| Host: www.example.org | Host: www.example.org | |||
| followed by the remainder of the Request. Note that the absolute | followed by the remainder of the Request. Note that the absolute | |||
| path cannot be empty; if none is present in the original URI, it MUST | path cannot be empty; if none is present in the original URI, it MUST | |||
| be given as "/" (the server root). | be given as "/" (the server root). | |||
| The Request-URI is transmitted in the format specified in | The Request-URI is transmitted in the format specified in | |||
| Section 3.2.1. If the Request-URI is encoded using the "% HEXDIG | Section 3.2.1. If the Request-URI is encoded using the "% HEXDIG | |||
| HEXDIG" encoding ([RFC2396], Section 2.4.1), the origin server MUST | HEXDIG" encoding ([RFC3986], Section 2.4), the origin server MUST | |||
| decode the Request-URI in order to properly interpret the request. | decode the Request-URI in order to properly interpret the request. | |||
| Servers SHOULD respond to invalid Request-URIs with an appropriate | Servers SHOULD respond to invalid Request-URIs with an appropriate | |||
| status code. | status code. | |||
| A transparent proxy MUST NOT rewrite the "path-absolute" part of the | A transparent proxy MUST NOT rewrite the "path-absolute" part of the | |||
| received Request-URI when forwarding it to the next inbound server, | received Request-URI when forwarding it to the next inbound server, | |||
| except as noted above to replace a null path-absolute with "/". | except as noted above to replace a null path-absolute with "/". | |||
| Note: The "no rewrite" rule prevents the proxy from changing the | Note: The "no rewrite" rule prevents the proxy from changing the | |||
| meaning of the request when the origin server is improperly using | meaning of the request when the origin server is improperly using | |||
| skipping to change at page 31, line 40 | skipping to change at page 26, line 22 | |||
| An origin server that does not allow resources to differ by the | An origin server that does not allow resources to differ by the | |||
| requested host MAY ignore the Host header field value when | requested host MAY ignore the Host header field value when | |||
| determining the resource identified by an HTTP/1.1 request. (But see | determining the resource identified by an HTTP/1.1 request. (But see | |||
| Appendix C.1.1 for other requirements on Host support in HTTP/1.1.) | Appendix C.1.1 for other requirements on Host support in HTTP/1.1.) | |||
| An origin server that does differentiate resources based on the host | An origin server that does differentiate resources based on the host | |||
| requested (sometimes referred to as virtual hosts or vanity host | requested (sometimes referred to as virtual hosts or vanity host | |||
| names) MUST use the following rules for determining the requested | names) MUST use the following rules for determining the requested | |||
| resource on an HTTP/1.1 request: | resource on an HTTP/1.1 request: | |||
| 1. If Request-URI is an absoluteURI, the host is part of the | 1. If Request-URI is an absolute-URI, the host is part of the | |||
| Request-URI. Any Host header field value in the request MUST be | Request-URI. Any Host header field value in the request MUST be | |||
| ignored. | ignored. | |||
| 2. If the Request-URI is not an absoluteURI, and the request | 2. If the Request-URI is not an absolute-URI, and the request | |||
| includes a Host header field, the host is determined by the Host | includes a Host header field, the host is determined by the Host | |||
| header field value. | header field value. | |||
| 3. If the host as determined by rule 1 or 2 is not a valid host on | 3. If the host as determined by rule 1 or 2 is not a valid host on | |||
| the server, the response MUST be a 400 (Bad Request) error | the server, the response MUST be a 400 (Bad Request) error | |||
| message. | message. | |||
| Recipients of an HTTP/1.0 request that lacks a Host header field MAY | Recipients of an HTTP/1.0 request that lacks a Host header field MAY | |||
| attempt to use heuristics (e.g., examination of the URI path for | attempt to use heuristics (e.g., examination of the URI path for | |||
| something unique to a particular host) in order to determine what | something unique to a particular host) in order to determine what | |||
| exact resource is being requested. | exact resource is being requested. | |||
| 6. Response | 6. Response | |||
| After receiving and interpreting a request message, a server responds | After receiving and interpreting a request message, a server responds | |||
| with an HTTP response message. | with an HTTP response message. | |||
| Response = Status-Line ; Section 6.1 | Response = Status-Line ; Section 6.1 | |||
| *(( general-header ; Section 4.5 | *(( general-header ; Section 4.5 | |||
| | response-header ; [Part2], Section 6 | / response-header ; [Part2], Section 6 | |||
| | entity-header ) CRLF) ; [Part3], Section 4.1 | / entity-header ) CRLF) ; [Part3], Section 4.1 | |||
| CRLF | CRLF | |||
| [ message-body ] ; Section 4.3 | [ message-body ] ; Section 4.3 | |||
| 6.1. Status-Line | 6.1. Status-Line | |||
| The first line of a Response message is the Status-Line, consisting | The first line of a Response message is the Status-Line, consisting | |||
| of the protocol version followed by a numeric status code and its | of the protocol version followed by a numeric status code and its | |||
| associated textual phrase, with each element separated by SP | associated textual phrase, with each element separated by SP | |||
| characters. No CR or LF is allowed except in the final CRLF | characters. No CR or LF is allowed except in the final CRLF | |||
| sequence. | sequence. | |||
| skipping to change at page 40, line 25 | skipping to change at page 35, line 9 | |||
| 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 message framing and transport protocols. | fields related to message framing and transport protocols. | |||
| 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. | |||
| 8.1. Connection | 8.1. Connection | |||
| The Connection general-header field allows the sender to specify | The general-header field "Connection" allows the sender to specify | |||
| options that are desired for that particular connection and MUST NOT | options that are desired for that particular connection and MUST NOT | |||
| be communicated by proxies over further connections. | be communicated by proxies over further connections. | |||
| The Connection header has the following grammar: | The Connection header's value has the following grammar: | |||
| Connection = "Connection" ":" 1#(connection-token) | Connection = "Connection" ":" OWS Connection-v | |||
| Connection-v = 1#connection-token | ||||
| connection-token = token | connection-token = token | |||
| HTTP/1.1 proxies MUST parse the Connection header field before a | HTTP/1.1 proxies MUST parse the Connection header field before a | |||
| message is forwarded and, for each connection-token in this field, | message is forwarded and, for each connection-token in this field, | |||
| remove any header field(s) from the message with the same name as the | remove any header field(s) from the message with the same name as the | |||
| connection-token. Connection options are signaled by the presence of | connection-token. Connection options are signaled by the presence of | |||
| a connection-token in the Connection header field, not by any | a connection-token in the Connection header field, not by any | |||
| corresponding additional header field(s), since the additional header | corresponding additional header field(s), since the additional header | |||
| field may not be sent if there are no parameters associated with that | field may not be sent if there are no parameters associated with that | |||
| connection option. | connection option. | |||
| skipping to change at page 41, line 24 | skipping to change at page 36, line 9 | |||
| A system receiving an HTTP/1.0 (or lower-version) message that | A system receiving an HTTP/1.0 (or lower-version) message that | |||
| includes a Connection header MUST, for each connection-token in this | includes a Connection header MUST, for each connection-token in this | |||
| field, remove and ignore any header field(s) from the message with | field, remove and ignore any header field(s) from the message with | |||
| the same name as the connection-token. This protects against | the same name as the connection-token. This protects against | |||
| mistaken forwarding of such header fields by pre-HTTP/1.1 proxies. | mistaken forwarding of such header fields by pre-HTTP/1.1 proxies. | |||
| See Appendix C.2. | See Appendix C.2. | |||
| 8.2. Content-Length | 8.2. Content-Length | |||
| The Content-Length entity-header field indicates the size of the | The entity-header field "Content-Length" indicates the size of the | |||
| entity-body, in decimal number of OCTETs, sent to the recipient or, | entity-body, in decimal number of OCTETs, sent to the recipient or, | |||
| in the case of the HEAD method, the size of the entity-body that | in the case of the HEAD method, the size of the entity-body that | |||
| would have been sent had the request been a GET. | would have been sent had the request been a GET. | |||
| Content-Length = "Content-Length" ":" 1*DIGIT | Content-Length = "Content-Length" ":" OWS 1*Content-Length-v | |||
| Content-Length-v = 1*DIGIT | ||||
| An example is | An example is | |||
| Content-Length: 3495 | Content-Length: 3495 | |||
| Applications SHOULD use this field to indicate the transfer-length of | Applications SHOULD use this field to indicate the transfer-length of | |||
| the message-body, unless this is prohibited by the rules in | the message-body, unless this is prohibited by the rules in | |||
| Section 4.4. | Section 4.4. | |||
| Any Content-Length greater than or equal to zero is a valid value. | Any Content-Length greater than or equal to zero is a valid value. | |||
| skipping to change at page 42, line 7 | skipping to change at page 36, line 38 | |||
| Note that the meaning of this field is significantly different from | Note that the meaning of this field is significantly different from | |||
| the corresponding definition in MIME, where it is an optional field | the corresponding definition in MIME, where it is an optional field | |||
| used within the "message/external-body" content-type. In HTTP, it | used within the "message/external-body" content-type. In HTTP, it | |||
| SHOULD be sent whenever the message's length can be determined prior | SHOULD be sent whenever the message's length can be determined prior | |||
| to being transferred, unless this is prohibited by the rules in | to being transferred, unless this is prohibited by the rules in | |||
| Section 4.4. | Section 4.4. | |||
| 8.3. Date | 8.3. Date | |||
| The Date general-header field represents the date and time at which | The general-header field "Date" represents the date and time at which | |||
| the message was originated, having the same semantics as orig-date in | the message was originated, having the same semantics as orig-date in | |||
| Section 3.6.1 of [RFC2822]. The field value is an HTTP-date, as | Section 3.6.1 of [RFC5322]. The field value is an HTTP-date, as | |||
| described in Section 3.3.1; it MUST be sent in rfc1123-date format. | described in Section 3.3.1; it MUST be sent in rfc1123-date format. | |||
| Date = "Date" ":" HTTP-date | Date = "Date" ":" OWS Date-v | |||
| Date-v = HTTP-date | ||||
| An example is | An example is | |||
| Date: Tue, 15 Nov 1994 08:12:31 GMT | Date: Tue, 15 Nov 1994 08:12:31 GMT | |||
| Origin servers MUST include a Date header field in all responses, | Origin servers MUST include a Date header field in all responses, | |||
| except in these cases: | except in these cases: | |||
| 1. If the response status code is 100 (Continue) or 101 (Switching | 1. If the response status code is 100 (Continue) or 101 (Switching | |||
| Protocols), the response MAY include a Date header field, at the | Protocols), the response MAY include a Date header field, at the | |||
| skipping to change at page 43, line 21 | skipping to change at page 38, line 7 | |||
| An origin server without a clock MUST NOT assign Expires or Last- | An origin server without a clock MUST NOT assign Expires or Last- | |||
| Modified values to a response, unless these values were associated | Modified values to a response, unless these values were associated | |||
| with the resource by a system or user with a reliable clock. It MAY | with the resource by a system or user with a reliable clock. It MAY | |||
| assign an Expires value that is known, at or before server | assign an Expires value that is known, at or before server | |||
| configuration time, to be in the past (this allows "pre-expiration" | configuration time, to be in the past (this allows "pre-expiration" | |||
| of responses without storing separate Expires values for each | of responses without storing separate Expires values for each | |||
| resource). | resource). | |||
| 8.4. Host | 8.4. Host | |||
| The Host request-header field specifies the Internet host and port | The request-header field "Host" specifies the Internet host and port | |||
| number of the resource being requested, as obtained from the original | number of the resource being requested, as obtained from the original | |||
| URI given by the user or referring resource (generally an HTTP URL, | URI given by the user or referring resource (generally an HTTP URL, | |||
| as described in Section 3.2.2). The Host field value MUST represent | as described in Section 3.2.1). The Host field value MUST represent | |||
| the naming authority of the origin server or gateway given by the | the naming authority of the origin server or gateway given by the | |||
| original URL. This allows the origin server or gateway to | original URL. This allows the origin server or gateway to | |||
| differentiate between internally-ambiguous URLs, such as the root "/" | differentiate between internally-ambiguous URLs, such as the root "/" | |||
| URL of a server for multiple host names on a single IP address. | URL of a server for multiple host names on a single IP address. | |||
| Host = "Host" ":" uri-host [ ":" port ] ; Section 3.2.2 | Host = "Host" ":" OWS Host-v | |||
| Host-v = uri-host [ ":" port ] ; Section 3.2.1 | ||||
| A "host" without any trailing port information implies the default | A "host" without any trailing port information implies the default | |||
| port for the service requested (e.g., "80" for an HTTP URL). For | port for the service requested (e.g., "80" for an HTTP URL). For | |||
| example, a request on the origin server for | example, a request on the origin server for | |||
| <http://www.example.org/pub/WWW/> would properly include: | <http://www.example.org/pub/WWW/> would properly include: | |||
| GET /pub/WWW/ HTTP/1.1 | GET /pub/WWW/ HTTP/1.1 | |||
| Host: www.example.org | Host: www.example.org | |||
| A client MUST include a Host header field in all HTTP/1.1 request | A client MUST include a Host header field in all HTTP/1.1 request | |||
| skipping to change at page 44, line 7 | skipping to change at page 38, line 41 | |||
| request message it forwards does contain an appropriate Host header | request message it forwards does contain an appropriate Host header | |||
| field that identifies the service being requested by the proxy. All | field that identifies the service being requested by the proxy. All | |||
| Internet-based HTTP/1.1 servers MUST respond with a 400 (Bad Request) | Internet-based HTTP/1.1 servers MUST respond with a 400 (Bad Request) | |||
| status code to any HTTP/1.1 request message which lacks a Host header | status code to any HTTP/1.1 request message which lacks a Host header | |||
| field. | field. | |||
| See Sections 5.2 and C.1.1 for other requirements relating to Host. | See Sections 5.2 and C.1.1 for other requirements relating to Host. | |||
| 8.5. TE | 8.5. TE | |||
| The TE request-header field indicates what extension transfer-codings | The request-header field "TE" indicates what extension transfer- | |||
| it is willing to accept in the response and whether or not it is | codings it is willing to accept in the response and whether or not it | |||
| willing to accept trailer fields in a chunked transfer-coding. Its | is willing to accept trailer fields in a chunked transfer-coding. | |||
| value may consist of the keyword "trailers" and/or a comma-separated | Its value may consist of the keyword "trailers" and/or a comma- | |||
| list of extension transfer-coding names with optional accept | separated list of extension transfer-coding names with optional | |||
| parameters (as described in Section 3.4). | accept parameters (as described in Section 3.4). | |||
| TE = "TE" ":" #( t-codings ) | TE = "TE" ":" OWS TE-v | |||
| t-codings = "trailers" | ( transfer-extension [ accept-params ] ) | TE-v = #t-codings | |||
| t-codings = "trailers" / ( transfer-extension [ accept-params ] ) | ||||
| The presence of the keyword "trailers" indicates that the client is | The presence of the keyword "trailers" indicates that the client is | |||
| willing to accept trailer fields in a chunked transfer-coding, as | willing to accept trailer fields in a chunked transfer-coding, as | |||
| defined in Section 3.4.1. This keyword is reserved for use with | defined in Section 3.4.1. This keyword is reserved for use with | |||
| transfer-coding values even though it does not itself represent a | transfer-coding values even though it does not itself represent a | |||
| transfer-coding. | transfer-coding. | |||
| Examples of its use are: | Examples of its use are: | |||
| TE: deflate | TE: deflate | |||
| skipping to change at page 45, line 14 | skipping to change at page 39, line 50 | |||
| 3. If multiple transfer-codings are acceptable, then the acceptable | 3. If multiple transfer-codings are acceptable, then the acceptable | |||
| transfer-coding with the highest non-zero qvalue is preferred. | transfer-coding with the highest non-zero qvalue is preferred. | |||
| The "chunked" transfer-coding always has a qvalue of 1. | The "chunked" transfer-coding always has a qvalue of 1. | |||
| If the TE field-value is empty or if no TE field is present, the only | If the TE field-value is empty or if no TE field is present, the only | |||
| transfer-coding is "chunked". A message with no transfer-coding is | transfer-coding is "chunked". A message with no transfer-coding is | |||
| always acceptable. | always acceptable. | |||
| 8.6. Trailer | 8.6. Trailer | |||
| The Trailer general field value indicates that the given set of | The general field "Trailer" indicates that the given set of header | |||
| header fields is present in the trailer of a message encoded with | fields is present in the trailer of a message encoded with chunked | |||
| chunked transfer-coding. | transfer-coding. | |||
| Trailer = "Trailer" ":" 1#field-name | Trailer = "Trailer" ":" OWS Trailer-v | |||
| Trailer-v = 1#field-name | ||||
| An HTTP/1.1 message SHOULD include a Trailer header field in a | An HTTP/1.1 message SHOULD include a Trailer header field in a | |||
| message using chunked transfer-coding with a non-empty trailer. | message using chunked transfer-coding with a non-empty trailer. | |||
| Doing so allows the recipient to know which header fields to expect | Doing so allows the recipient to know which header fields to expect | |||
| in the trailer. | in the trailer. | |||
| If no Trailer header field is present, the trailer SHOULD NOT include | If no Trailer header field is present, the trailer SHOULD NOT include | |||
| any header fields. See Section 3.4.1 for restrictions on the use of | any header fields. See Section 3.4.1 for restrictions on the use of | |||
| trailer fields in a "chunked" transfer-coding. | trailer fields in a "chunked" transfer-coding. | |||
| skipping to change at page 45, line 40 | skipping to change at page 40, line 29 | |||
| include the following header fields: | include the following header fields: | |||
| o Transfer-Encoding | o Transfer-Encoding | |||
| o Content-Length | o Content-Length | |||
| o Trailer | o Trailer | |||
| 8.7. Transfer-Encoding | 8.7. Transfer-Encoding | |||
| The Transfer-Encoding general-header field indicates what (if any) | The general-header "Transfer-Encoding" field indicates what (if any) | |||
| type of transformation has been applied to the message body in order | type of transformation has been applied to the message body in order | |||
| to safely transfer it between the sender and the recipient. This | to safely transfer it between the sender and the recipient. This | |||
| differs from the content-coding in that the transfer-coding is a | differs from the content-coding in that the transfer-coding is a | |||
| property of the message, not of the entity. | property of the message, not of the entity. | |||
| Transfer-Encoding = "Transfer-Encoding" ":" 1#transfer-coding | Transfer-Encoding = "Transfer-Encoding" ":" OWS | |||
| Transfer-Encoding-v | ||||
| Transfer-Encoding-v = 1#transfer-coding | ||||
| Transfer-codings are defined in Section 3.4. An example is: | Transfer-codings are defined in Section 3.4. An example is: | |||
| Transfer-Encoding: chunked | Transfer-Encoding: chunked | |||
| If multiple encodings have been applied to an entity, the transfer- | If multiple encodings have been applied to an entity, the transfer- | |||
| codings MUST be listed in the order in which they were applied. | codings MUST be listed in the order in which they were applied. | |||
| Additional information about the encoding parameters MAY be provided | Additional information about the encoding parameters MAY be provided | |||
| by other entity-header fields not defined by this specification. | by other entity-header fields not defined by this specification. | |||
| Many older HTTP/1.0 applications do not understand the Transfer- | Many older HTTP/1.0 applications do not understand the Transfer- | |||
| Encoding header. | Encoding header. | |||
| 8.8. Upgrade | 8.8. Upgrade | |||
| skipping to change at page 46, line 14 | skipping to change at page 41, line 7 | |||
| If multiple encodings have been applied to an entity, the transfer- | If multiple encodings have been applied to an entity, the transfer- | |||
| codings MUST be listed in the order in which they were applied. | codings MUST be listed in the order in which they were applied. | |||
| Additional information about the encoding parameters MAY be provided | Additional information about the encoding parameters MAY be provided | |||
| by other entity-header fields not defined by this specification. | by other entity-header fields not defined by this specification. | |||
| Many older HTTP/1.0 applications do not understand the Transfer- | Many older HTTP/1.0 applications do not understand the Transfer- | |||
| Encoding header. | Encoding header. | |||
| 8.8. Upgrade | 8.8. Upgrade | |||
| The Upgrade general-header allows the client to specify what | The general-header "Upgrade" allows the client to specify what | |||
| additional communication protocols it supports and would like to use | additional communication protocols it supports and would like to use | |||
| if the server finds it appropriate to switch protocols. The server | if the server finds it appropriate to switch protocols. The server | |||
| MUST use the Upgrade header field within a 101 (Switching Protocols) | MUST use the Upgrade header field within a 101 (Switching Protocols) | |||
| response to indicate which protocol(s) are being switched. | response to indicate which protocol(s) are being switched. | |||
| Upgrade = "Upgrade" ":" 1#product | Upgrade = "Upgrade" ":" OWS Upgrade-v | |||
| Upgrade-v = 1#product | ||||
| For example, | For example, | |||
| Upgrade: HTTP/2.0, SHTTP/1.3, IRC/6.9, RTA/x11 | Upgrade: HTTP/2.0, SHTTP/1.3, IRC/6.9, RTA/x11 | |||
| The Upgrade header field is intended to provide a simple mechanism | The Upgrade header field is intended to provide a simple mechanism | |||
| for transition from HTTP/1.1 to some other, incompatible protocol. | for transition from HTTP/1.1 to some other, incompatible protocol. | |||
| It does so by allowing the client to advertise its desire to use | It does so by allowing the client to advertise its desire to use | |||
| another protocol, such as a later version of HTTP with a higher major | another protocol, such as a later version of HTTP with a higher major | |||
| version number, even though the current request has been made using | version number, even though the current request has been made using | |||
| skipping to change at page 47, line 18 | skipping to change at page 42, line 10 | |||
| This specification only defines the protocol name "HTTP" for use by | This specification only defines the protocol name "HTTP" for use by | |||
| the family of Hypertext Transfer Protocols, as defined by the HTTP | the family of Hypertext Transfer Protocols, as defined by the HTTP | |||
| version rules of Section 3.1 and future updates to this | version rules of Section 3.1 and future updates to this | |||
| specification. Any token can be used as a protocol name; however, it | specification. Any token can be used as a protocol name; however, it | |||
| will only be useful if both the client and server associate the name | will only be useful if both the client and server associate the name | |||
| with the same protocol. | with the same protocol. | |||
| 8.9. Via | 8.9. Via | |||
| The Via general-header field MUST be used by gateways and proxies to | The general-header field "Via" MUST be used by gateways and proxies | |||
| indicate the intermediate protocols and recipients between the user | to indicate the intermediate protocols and recipients between the | |||
| agent and the server on requests, and between the origin server and | user agent and the server on requests, and between the origin server | |||
| the client on responses. It is analogous to the "Received" field | and the client on responses. It is analogous to the "Received" field | |||
| defined in Section 3.6.7 of [RFC2822] and is intended to be used for | defined in Section 3.6.7 of [RFC5322] and is intended to be used for | |||
| tracking message forwards, avoiding request loops, and identifying | tracking message forwards, avoiding request loops, and identifying | |||
| the protocol capabilities of all senders along the request/response | the protocol capabilities of all senders along the request/response | |||
| chain. | chain. | |||
| Via = "Via" ":" 1#( received-protocol received-by [ comment ] ) | Via = "Via" ":" OWS Via-v | |||
| Via-v = 1#( received-protocol RWS received-by | ||||
| [ RWS comment ] ) | ||||
| received-protocol = [ protocol-name "/" ] protocol-version | received-protocol = [ protocol-name "/" ] protocol-version | |||
| protocol-name = token | protocol-name = token | |||
| protocol-version = token | protocol-version = token | |||
| received-by = ( uri-host [ ":" port ] ) | pseudonym | received-by = ( uri-host [ ":" port ] ) / pseudonym | |||
| pseudonym = token | pseudonym = token | |||
| The received-protocol indicates the protocol version of the message | The received-protocol indicates the protocol version of the message | |||
| received by the server or client along each segment of the request/ | received by the server or client along each segment of the request/ | |||
| response chain. The received-protocol version is appended to the Via | response chain. The received-protocol version is appended to the Via | |||
| field value when the message is forwarded so that information about | field value when the message is forwarded so that information about | |||
| the protocol capabilities of upstream applications remains visible to | the protocol capabilities of upstream applications remains visible to | |||
| all recipients. | all recipients. | |||
| The protocol-name is optional if and only if it would be "HTTP". The | The protocol-name is optional if and only if it would be "HTTP". The | |||
| skipping to change at page 49, line 26 | skipping to change at page 44, line 26 | |||
| | Via | http | standard | Section 8.9 | | | Via | http | standard | Section 8.9 | | |||
| +-------------------+----------+----------+-------------+ | +-------------------+----------+----------+-------------+ | |||
| The change controller is: "IETF (iesg@ietf.org) - Internet | The change controller is: "IETF (iesg@ietf.org) - Internet | |||
| Engineering Task Force". | Engineering Task Force". | |||
| 9.2. URI Scheme Registration | 9.2. URI Scheme Registration | |||
| The entry for the "http" URI Scheme in the registry located at | The entry for the "http" URI Scheme in the registry located at | |||
| <http://www.iana.org/assignments/uri-schemes.html> should be updated | <http://www.iana.org/assignments/uri-schemes.html> should be updated | |||
| to point to Section 3.2.2 of this document (see [RFC4395]). | to point to Section 3.2.1 of this document (see [RFC4395]). | |||
| 9.3. Internet Media Type Registrations | 9.3. Internet Media Type Registrations | |||
| This document serves as the specification for the Internet media | This document serves as the specification for the Internet media | |||
| types "message/http" and "application/http". The following is to be | types "message/http" and "application/http". The following is to be | |||
| registered with IANA (see [RFC4288]). | registered with IANA (see [RFC4288]). | |||
| 9.3.1. Internet Media Type message/http | 9.3.1. Internet Media Type message/http | |||
| The message/http type can be used to enclose a single HTTP request or | The message/http type can be used to enclose a single HTTP request or | |||
| skipping to change at page 54, line 21 | skipping to change at page 49, line 21 | |||
| protect against a broad range of security and privacy attacks. Such | protect against a broad range of security and privacy attacks. Such | |||
| cryptography is beyond the scope of the HTTP/1.1 specification. | cryptography is beyond the scope of the HTTP/1.1 specification. | |||
| 10.6. Denial of Service Attacks on Proxies | 10.6. Denial of Service Attacks on Proxies | |||
| They exist. They are hard to defend against. Research continues. | They exist. They are hard to defend against. Research continues. | |||
| Beware. | Beware. | |||
| 11. Acknowledgments | 11. Acknowledgments | |||
| This specification makes heavy use of the augmented BNF and generic | ||||
| constructs defined by David H. Crocker for [RFC822ABNF]. Similarly, | ||||
| it reuses many of the definitions provided by Nathaniel Borenstein | ||||
| and Ned Freed for MIME [RFC2045]. We hope that their inclusion in | ||||
| this specification will help reduce past confusion over the | ||||
| relationship between HTTP and Internet mail message formats. | ||||
| HTTP has evolved considerably over the years. It has benefited from | HTTP has evolved considerably over the years. It has benefited from | |||
| a large and active developer community--the many people who have | a large and active developer community--the many people who have | |||
| participated on the www-talk mailing list--and it is that community | participated on the www-talk mailing list--and it is that community | |||
| which has been most responsible for the success of HTTP and of the | which has been most responsible for the success of HTTP and of the | |||
| World-Wide Web in general. Marc Andreessen, Robert Cailliau, Daniel | World-Wide Web in general. Marc Andreessen, Robert Cailliau, Daniel | |||
| W. Connolly, Bob Denny, John Franks, Jean-Francois Groff, Phillip M. | W. Connolly, Bob Denny, John Franks, Jean-Francois Groff, Phillip M. | |||
| Hallam-Baker, Hakon W. Lie, Ari Luotonen, Rob McCool, Lou Montulli, | Hallam-Baker, Hakon W. Lie, Ari Luotonen, Rob McCool, Lou Montulli, | |||
| Dave Raggett, Tony Sanders, and Marc VanHeyningen deserve special | Dave Raggett, Tony Sanders, and Marc VanHeyningen deserve special | |||
| recognition for their efforts in defining early aspects of the | recognition for their efforts in defining early aspects of the | |||
| protocol. | protocol. | |||
| skipping to change at page 55, line 24 | skipping to change at page 50, line 17 | |||
| Mogul, Paul Leach, Dave Kristol, Koen Holtman, John Franks, Josh | Mogul, Paul Leach, Dave Kristol, Koen Holtman, John Franks, Josh | |||
| Cohen, Alex Hopmann, Scott Lawrence, and Larry Masinter for their | Cohen, Alex Hopmann, Scott Lawrence, and Larry Masinter for their | |||
| help. And thanks go particularly to Jeff Mogul and Scott Lawrence | help. And thanks go particularly to Jeff Mogul and Scott Lawrence | |||
| for performing the "MUST/MAY/SHOULD" audit. | for performing the "MUST/MAY/SHOULD" audit. | |||
| The Apache Group, Anselm Baird-Smith, author of Jigsaw, and Henrik | The Apache Group, Anselm Baird-Smith, author of Jigsaw, and Henrik | |||
| Frystyk implemented RFC 2068 early, and we wish to thank them for the | Frystyk implemented RFC 2068 early, and we wish to thank them for the | |||
| discovery of many of the problems that this document attempts to | discovery of many of the problems that this document attempts to | |||
| rectify. | rectify. | |||
| This specification makes heavy use of the augmented BNF and generic | ||||
| constructs defined by David H. Crocker for [RFC5234]. Similarly, it | ||||
| reuses many of the definitions provided by Nathaniel Borenstein and | ||||
| Ned Freed for MIME [RFC2045]. We hope that their inclusion in this | ||||
| specification will help reduce past confusion over the relationship | ||||
| between HTTP and Internet mail message formats. | ||||
| 12. References | 12. References | |||
| 12.1. Normative References | 12.1. Normative References | |||
| [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. | |||
| [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-04 (work in | Semantics", draft-ietf-httpbis-p2-semantics-05 (work in | |||
| progress), August 2008. | progress), November 2008. | |||
| [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-04 | and Content Negotiation", draft-ietf-httpbis-p3-payload-05 | |||
| (work in progress), August 2008. | (work in progress), November 2008. | |||
| [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-04 (work | Partial Responses", draft-ietf-httpbis-p5-range-05 (work | |||
| in progress), August 2008. | in progress), November 2008. | |||
| [Part6] Fielding, R., Ed., Gettys, J., Mogul, J., Frystyk, H., | [Part6] 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 6: Caching", | and J. Reschke, Ed., "HTTP/1.1, part 6: Caching", | |||
| draft-ietf-httpbis-p6-cache-04 (work in progress), | draft-ietf-httpbis-p6-cache-05 (work in progress), | |||
| August 2008. | November 2008. | |||
| [RFC2045] Freed, N. and N. Borenstein, "Multipurpose Internet Mail | [RFC2045] Freed, N. and N. Borenstein, "Multipurpose Internet Mail | |||
| Extensions (MIME) Part One: Format of Internet Message | Extensions (MIME) Part One: Format of Internet Message | |||
| Bodies", RFC 2045, November 1996. | Bodies", RFC 2045, November 1996. | |||
| [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. | |||
| [RFC2396] Berners-Lee, T., Fielding, R., and L. Masinter, "Uniform | [RFC3986] Berners-Lee, T., Fielding, R., and L. Masinter, "Uniform | |||
| Resource Identifiers (URI): Generic Syntax", RFC 2396, | Resource Identifier (URI): Generic Syntax", RFC 3986, | |||
| August 1998. | STD 66, January 2005. | |||
| [RFC822ABNF] | [RFC5234] Crocker, D., Ed. and P. Overell, "Augmented BNF for Syntax | |||
| Crocker, D., "Standard for the format of ARPA Internet | Specifications: ABNF", STD 68, RFC 5234, January 2008. | |||
| text messages", STD 11, RFC 822, August 1982. | ||||
| [USASCII] American National Standards Institute, "Coded Character | [USASCII] American National Standards Institute, "Coded Character | |||
| Set -- 7-bit American Standard Code for Information | Set -- 7-bit American Standard Code for Information | |||
| Interchange", ANSI X3.4, 1986. | Interchange", ANSI X3.4, 1986. | |||
| 12.2. Informative References | 12.2. Informative References | |||
| [Kri2001] Kristol, D., "HTTP Cookies: Standards, Privacy, and | [Kri2001] Kristol, D., "HTTP Cookies: Standards, Privacy, and | |||
| Politics", ACM Transactions on Internet Technology Vol. 1, | Politics", ACM Transactions on Internet Technology Vol. 1, | |||
| #2, November 2001, <http://arxiv.org/abs/cs.SE/0105018>. | #2, November 2001, <http://arxiv.org/abs/cs.SE/0105018>. | |||
| skipping to change at page 57, line 16 | skipping to change at page 52, line 14 | |||
| and Support", STD 3, RFC 1123, October 1989. | and Support", STD 3, RFC 1123, October 1989. | |||
| [RFC1305] Mills, D., "Network Time Protocol (Version 3) | [RFC1305] Mills, D., "Network Time Protocol (Version 3) | |||
| Specification, Implementation", RFC 1305, March 1992. | Specification, Implementation", RFC 1305, March 1992. | |||
| [RFC1436] Anklesaria, F., McCahill, M., Lindner, P., Johnson, D., | [RFC1436] Anklesaria, F., McCahill, M., Lindner, P., Johnson, D., | |||
| Torrey, D., and B. Alberti, "The Internet Gopher Protocol | Torrey, D., and B. Alberti, "The Internet Gopher Protocol | |||
| (a distributed document search and retrieval protocol)", | (a distributed document search and retrieval protocol)", | |||
| RFC 1436, March 1993. | RFC 1436, March 1993. | |||
| [RFC1630] Berners-Lee, T., "Universal Resource Identifiers in WWW: A | ||||
| Unifying Syntax for the Expression of Names and Addresses | ||||
| of Objects on the Network as used in the World-Wide Web", | ||||
| RFC 1630, June 1994. | ||||
| [RFC1737] Masinter, L. and K. Sollins, "Functional Requirements for | ||||
| Uniform Resource Names", RFC 1737, December 1994. | ||||
| [RFC1738] Berners-Lee, T., Masinter, L., and M. McCahill, "Uniform | ||||
| Resource Locators (URL)", RFC 1738, December 1994. | ||||
| [RFC1808] Fielding, R., "Relative Uniform Resource Locators", | ||||
| RFC 1808, June 1995. | ||||
| [RFC1900] Carpenter, B. and Y. Rekhter, "Renumbering Needs Work", | [RFC1900] Carpenter, B. and Y. Rekhter, "Renumbering Needs Work", | |||
| RFC 1900, February 1996. | RFC 1900, February 1996. | |||
| [RFC1945] Berners-Lee, T., Fielding, R., and H. Nielsen, "Hypertext | [RFC1945] Berners-Lee, T., Fielding, R., and H. Nielsen, "Hypertext | |||
| Transfer Protocol -- HTTP/1.0", RFC 1945, May 1996. | Transfer Protocol -- HTTP/1.0", RFC 1945, May 1996. | |||
| [RFC2068] Fielding, R., Gettys, J., Mogul, J., Nielsen, H., and T. | [RFC2068] Fielding, R., Gettys, J., Mogul, J., Nielsen, H., and T. | |||
| Berners-Lee, "Hypertext Transfer Protocol -- HTTP/1.1", | Berners-Lee, "Hypertext Transfer Protocol -- HTTP/1.1", | |||
| RFC 2068, January 1997. | RFC 2068, January 1997. | |||
| [RFC2109] Kristol, D. and L. Montulli, "HTTP State Management | [RFC2109] Kristol, D. and L. Montulli, "HTTP State Management | |||
| Mechanism", RFC 2109, February 1997. | Mechanism", RFC 2109, February 1997. | |||
| [RFC2145] Mogul, J., Fielding, R., Gettys, J., and H. Nielsen, "Use | [RFC2145] Mogul, J., Fielding, R., Gettys, J., and H. Nielsen, "Use | |||
| and Interpretation of HTTP Version Numbers", RFC 2145, | and Interpretation of HTTP Version Numbers", RFC 2145, | |||
| May 1997. | May 1997. | |||
| [RFC2324] Masinter, L., "Hyper Text Coffee Pot Control Protocol | ||||
| (HTCPCP/1.0)", RFC 2324, April 1998. | ||||
| [RFC2616] Fielding, R., Gettys, J., Mogul, J., Frystyk, H., | [RFC2616] Fielding, R., Gettys, J., Mogul, J., Frystyk, H., | |||
| Masinter, L., Leach, P., and T. Berners-Lee, "Hypertext | Masinter, L., Leach, P., and T. Berners-Lee, "Hypertext | |||
| Transfer Protocol -- HTTP/1.1", RFC 2616, June 1999. | Transfer Protocol -- HTTP/1.1", RFC 2616, June 1999. | |||
| [RFC2818] Rescorla, E., "HTTP Over TLS", RFC 2818, May 2000. | [RFC2818] Rescorla, E., "HTTP Over TLS", RFC 2818, May 2000. | |||
| [RFC2821] Klensin, J., "Simple Mail Transfer Protocol", RFC 2821, | ||||
| April 2001. | ||||
| [RFC2822] Resnick, P., "Internet Message Format", RFC 2822, | ||||
| April 2001. | ||||
| [RFC2965] Kristol, D. and L. Montulli, "HTTP State Management | [RFC2965] Kristol, D. and L. Montulli, "HTTP State Management | |||
| Mechanism", RFC 2965, October 2000. | Mechanism", RFC 2965, October 2000. | |||
| [RFC3864] Klyne, G., Nottingham, M., and J. Mogul, "Registration | [RFC3864] Klyne, G., Nottingham, M., and J. Mogul, "Registration | |||
| Procedures for Message Header Fields", BCP 90, RFC 3864, | Procedures for Message Header Fields", BCP 90, RFC 3864, | |||
| September 2004. | September 2004. | |||
| [RFC3977] Feather, C., "Network News Transfer Protocol (NNTP)", | [RFC3977] Feather, C., "Network News Transfer Protocol (NNTP)", | |||
| RFC 3977, October 2006. | RFC 3977, October 2006. | |||
| [RFC4288] Freed, N. and J. Klensin, "Media Type Specifications and | [RFC4288] Freed, N. and J. Klensin, "Media Type Specifications and | |||
| Registration Procedures", BCP 13, RFC 4288, December 2005. | Registration Procedures", BCP 13, RFC 4288, December 2005. | |||
| [RFC4395] Hansen, T., Hardie, T., and L. Masinter, "Guidelines and | [RFC4395] Hansen, T., Hardie, T., and L. Masinter, "Guidelines and | |||
| Registration Procedures for New URI Schemes", BCP 115, | Registration Procedures for New URI Schemes", BCP 115, | |||
| RFC 4395, February 2006. | RFC 4395, February 2006. | |||
| [RFC5322] Resnick, P., "Internet Message Format", RFC 5322, | ||||
| October 2008. | ||||
| [RFC822] Crocker, D., "Standard for the format of ARPA Internet | [RFC822] Crocker, D., "Standard for the format of ARPA Internet | |||
| text messages", STD 11, RFC 822, August 1982. | text messages", STD 11, RFC 822, August 1982. | |||
| [RFC959] Postel, J. and J. Reynolds, "File Transfer Protocol", | [RFC959] Postel, J. and J. Reynolds, "File Transfer Protocol", | |||
| STD 9, RFC 959, October 1985. | STD 9, RFC 959, October 1985. | |||
| [Spe] Spero, S., "Analysis of HTTP Performance Problems", | [Spe] Spero, S., "Analysis of HTTP Performance Problems", | |||
| <http://sunsite.unc.edu/mdma-release/http-prob.html>. | <http://sunsite.unc.edu/mdma-release/http-prob.html>. | |||
| [Tou1998] Touch, J., Heidemann, J., and K. Obraczka, "Analysis of | [Tou1998] Touch, J., Heidemann, J., and K. Obraczka, "Analysis of | |||
| skipping to change at page 60, line 9 | skipping to change at page 54, line 35 | |||
| Appendix B. Conversion of Date Formats | Appendix B. Conversion of Date Formats | |||
| HTTP/1.1 uses a restricted set of date formats (Section 3.3.1) to | HTTP/1.1 uses a restricted set of date formats (Section 3.3.1) to | |||
| simplify the process of date comparison. Proxies and gateways from | simplify the process of date comparison. Proxies and gateways from | |||
| other protocols SHOULD ensure that any Date header field present in a | other protocols SHOULD ensure that any Date header field present in a | |||
| message conforms to one of the HTTP/1.1 formats and rewrite the date | message conforms to one of the HTTP/1.1 formats and rewrite the date | |||
| if necessary. | if necessary. | |||
| Appendix C. Compatibility with Previous Versions | Appendix C. Compatibility with Previous Versions | |||
| HTTP has been in use by the World-Wide Web global information | ||||
| initiative since 1990. The first version of HTTP, later referred to | ||||
| as HTTP/0.9, was a simple protocol for hypertext data transfer across | ||||
| the Internet with only a single method and no metadata. HTTP/1.0, as | ||||
| defined by [RFC1945], added a range of request methods and MIME-like | ||||
| messaging that could include metadata about the data transferred and | ||||
| modifiers on the request/response semantics. However, HTTP/1.0 did | ||||
| not sufficiently take into consideration the effects of hierarchical | ||||
| proxies, caching, the need for persistent connections, or name-based | ||||
| virtual hosts. The proliferation of incompletely-implemented | ||||
| applications calling themselves "HTTP/1.0" further necessitated a | ||||
| protocol version change in order for two communicating applications | ||||
| to determine each other's true capabilities. | ||||
| HTTP/1.1 remains compatible with HTTP/1.0 by including more stringent | ||||
| requirements that enable reliable implementations, adding only those | ||||
| new features that will either be safely ignored by an HTTP/1.0 | ||||
| recipient or only sent when communicating with a party advertising | ||||
| compliance with HTTP/1.1. | ||||
| It is beyond the scope of a protocol specification to mandate | It is beyond the scope of a protocol specification to mandate | |||
| compliance with previous versions. HTTP/1.1 was deliberately | compliance with previous versions. HTTP/1.1 was deliberately | |||
| designed, however, to make supporting previous versions easy. It is | designed, however, to make supporting previous versions easy. It is | |||
| worth noting that, at the time of composing this specification | worth noting that, at the time of composing this specification | |||
| (1996), we would expect commercial HTTP/1.1 servers to: | (1996), we would expect commercial HTTP/1.1 servers to: | |||
| o recognize the format of the Request-Line for HTTP/0.9, 1.0, and | o recognize the format of the Request-Line for HTTP/0.9, 1.0, and | |||
| 1.1 requests; | 1.1 requests; | |||
| o understand any valid request in the format of HTTP/0.9, 1.0, or | o understand any valid request in the format of HTTP/0.9, 1.0, or | |||
| skipping to change at page 62, line 38 | skipping to change at page 57, line 38 | |||
| adding an IANA registry for transfer-codings (separate from content | adding an IANA registry for transfer-codings (separate from content | |||
| codings), a new header field (TE) and enabling trailer headers in the | codings), a new header field (TE) and enabling trailer headers in the | |||
| future. Transfer encoding is a major performance benefit, so it was | future. Transfer encoding is a major performance benefit, so it was | |||
| worth fixing [Nie1997]. TE also solves another, obscure, downward | worth fixing [Nie1997]. TE also solves another, obscure, downward | |||
| interoperability problem that could have occurred due to interactions | interoperability problem that could have occurred due to interactions | |||
| between authentication trailers, chunked encoding and HTTP/1.0 | between authentication trailers, chunked encoding and HTTP/1.0 | |||
| clients.(Section 3.4, 3.4.1, and 8.5) | clients.(Section 3.4, 3.4.1, and 8.5) | |||
| C.4. Changes from RFC 2616 | C.4. Changes from RFC 2616 | |||
| The CHAR rule does not allow the NUL character anymore (this affects | Rules about implicit linear white space between certain grammar | |||
| the comment and quoted-string rules). Furthermore, the quoted-pair | productions have been removed; now it's only allowed when | |||
| rule does not allow escaping NUL, CR or LF anymore. (Section 2.2) | specifically pointed out in the ABNF. The CHAR rule does not allow | |||
| the NUL character anymore (this affects the comment and quoted-string | ||||
| rules). Furthermore, the quoted-pair rule does not allow escaping | ||||
| NUL, CR or LF anymore. (Section 2.2) | ||||
| Clarify that HTTP-Version is case sensitive. (Section 3.1) | Clarify that HTTP-Version is case sensitive. (Section 3.1) | |||
| Remove reference to non-existant identity transfer-coding value | Remove reference to non-existant identity transfer-coding value | |||
| tokens. (Sections 3.4 and 4.4) | tokens. (Sections 3.4 and 4.4) | |||
| Clarification that the chunk length does not include the count of the | Clarification that the chunk length does not include the count of the | |||
| octets in the chunk header and trailer. (Section 3.4.1) | octets in the chunk header and trailer. (Section 3.4.1) | |||
| Update use of abs_path production from RFC1808 to the path-absolute + | ||||
| query components of RFC3986. (Section 5.1.2) | ||||
| Fix BNF to add query, as the abs_path production in Section 3 of | ||||
| [RFC2396] doesn't define it. (Section 5.1.2) | ||||
| Clarify exactly when close connection options must be sent. | Clarify exactly when close connection options must be sent. | |||
| (Section 8.1) | (Section 8.1) | |||
| Appendix D. Change Log (to be removed by RFC Editor before publication) | Appendix D. Terminology | |||
| D.1. Since RFC2616 | This specification uses a number of terms to refer to the roles | |||
| played by participants in, and objects of, the HTTP communication. | ||||
| connection | ||||
| A transport layer virtual circuit established between two programs | ||||
| for the purpose of communication. | ||||
| message | ||||
| The basic unit of HTTP communication, consisting of a structured | ||||
| sequence of octets matching the syntax defined in Section 4 and | ||||
| transmitted via the connection. | ||||
| request | ||||
| An HTTP request message, as defined in Section 5. | ||||
| response | ||||
| An HTTP response message, as defined in Section 6. | ||||
| resource | ||||
| A network data object or service that can be identified by a URI, | ||||
| as defined in Section 3.2. Resources may be available in multiple | ||||
| representations (e.g. multiple languages, data formats, size, and | ||||
| resolutions) or vary in other ways. | ||||
| entity | ||||
| The information transferred as the payload of a request or | ||||
| response. An entity consists of metainformation in the form of | ||||
| entity-header fields and content in the form of an entity-body, as | ||||
| described in Section 4 of [Part3]. | ||||
| representation | ||||
| An entity included with a response that is subject to content | ||||
| negotiation, as described in Section 5 of [Part3]. There may | ||||
| exist multiple representations associated with a particular | ||||
| response status. | ||||
| content negotiation | ||||
| The mechanism for selecting the appropriate representation when | ||||
| servicing a request, as described in Section 5 of [Part3]. The | ||||
| representation of entities in any response can be negotiated | ||||
| (including error responses). | ||||
| variant | ||||
| A resource may have one, or more than one, representation(s) | ||||
| associated with it at any given instant. Each of these | ||||
| representations is termed a `variant'. Use of the term `variant' | ||||
| does not necessarily imply that the resource is subject to content | ||||
| negotiation. | ||||
| client | ||||
| A program that establishes connections for the purpose of sending | ||||
| requests. | ||||
| user agent | ||||
| The client which initiates a request. These are often browsers, | ||||
| editors, spiders (web-traversing robots), or other end user tools. | ||||
| server | ||||
| An application program that accepts connections in order to | ||||
| service requests by sending back responses. Any given program may | ||||
| be capable of being both a client and a server; our use of these | ||||
| terms refers only to the role being performed by the program for a | ||||
| particular connection, rather than to the program's capabilities | ||||
| in general. Likewise, any server may act as an origin server, | ||||
| proxy, gateway, or tunnel, switching behavior based on the nature | ||||
| of each request. | ||||
| origin server | ||||
| The server on which a given resource resides or is to be created. | ||||
| proxy | ||||
| An intermediary program which acts as both a server and a client | ||||
| for the purpose of making requests on behalf of other clients. | ||||
| Requests are serviced internally or by passing them on, with | ||||
| possible translation, to other servers. A proxy MUST implement | ||||
| both the client and server requirements of this specification. A | ||||
| "transparent proxy" is a proxy that does not modify the request or | ||||
| response beyond what is required for proxy authentication and | ||||
| identification. A "non-transparent proxy" is a proxy that | ||||
| modifies the request or response in order to provide some added | ||||
| service to the user agent, such as group annotation services, | ||||
| media type transformation, protocol reduction, or anonymity | ||||
| filtering. Except where either transparent or non-transparent | ||||
| behavior is explicitly stated, the HTTP proxy requirements apply | ||||
| to both types of proxies. | ||||
| gateway | ||||
| A server which acts as an intermediary for some other server. | ||||
| Unlike a proxy, a gateway receives requests as if it were the | ||||
| origin server for the requested resource; the requesting client | ||||
| may not be aware that it is communicating with a gateway. | ||||
| tunnel | ||||
| An intermediary program which is acting as a blind relay between | ||||
| two connections. Once active, a tunnel is not considered a party | ||||
| to the HTTP communication, though the tunnel may have been | ||||
| initiated by an HTTP request. The tunnel ceases to exist when | ||||
| both ends of the relayed connections are closed. | ||||
| cache | ||||
| A program's local store of response messages and the subsystem | ||||
| that controls its message storage, retrieval, and deletion. A | ||||
| cache stores cacheable responses in order to reduce the response | ||||
| time and network bandwidth consumption on future, equivalent | ||||
| requests. Any client or server may include a cache, though a | ||||
| cache cannot be used by a server that is acting as a tunnel. | ||||
| cacheable | ||||
| A response is cacheable if a cache is allowed to store a copy of | ||||
| the response message for use in answering subsequent requests. | ||||
| The rules for determining the cacheability of HTTP responses are | ||||
| defined in Section 1 of [Part6]. Even if a resource is cacheable, | ||||
| there may be additional constraints on whether a cache can use the | ||||
| cached copy for a particular request. | ||||
| upstream/downstream | ||||
| Upstream and downstream describe the flow of a message: all | ||||
| messages flow from upstream to downstream. | ||||
| inbound/outbound | ||||
| Inbound and outbound refer to the request and response paths for | ||||
| messages: "inbound" means "traveling toward the origin server", | ||||
| and "outbound" means "traveling toward the user agent" | ||||
| Appendix E. Change Log (to be removed by RFC Editor before publication) | ||||
| E.1. Since RFC2616 | ||||
| Extracted relevant partitions from [RFC2616]. | Extracted relevant partitions from [RFC2616]. | |||
| D.2. Since draft-ietf-httpbis-p1-messaging-00 | E.2. Since draft-ietf-httpbis-p1-messaging-00 | |||
| Closed issues: | Closed issues: | |||
| o <http://www3.tools.ietf.org/wg/httpbis/trac/ticket/1>: "HTTP | o <http://tools.ietf.org/wg/httpbis/trac/ticket/1>: "HTTP Version | |||
| Version should be case sensitive" | should be case sensitive" | |||
| (<http://purl.org/NET/http-errata#verscase>) | (<http://purl.org/NET/http-errata#verscase>) | |||
| o <http://www3.tools.ietf.org/wg/httpbis/trac/ticket/2>: "'unsafe' | o <http://tools.ietf.org/wg/httpbis/trac/ticket/2>: "'unsafe' | |||
| characters" (<http://purl.org/NET/http-errata#unsafe-uri>) | characters" (<http://purl.org/NET/http-errata#unsafe-uri>) | |||
| o <http://www3.tools.ietf.org/wg/httpbis/trac/ticket/3>: "Chunk Size | o <http://tools.ietf.org/wg/httpbis/trac/ticket/3>: "Chunk Size | |||
| Definition" (<http://purl.org/NET/http-errata#chunk-size>) | Definition" (<http://purl.org/NET/http-errata#chunk-size>) | |||
| o <http://www3.tools.ietf.org/wg/httpbis/trac/ticket/4>: "Message | o <http://tools.ietf.org/wg/httpbis/trac/ticket/4>: "Message Length" | |||
| Length" (<http://purl.org/NET/http-errata#msg-len-chars>) | (<http://purl.org/NET/http-errata#msg-len-chars>) | |||
| o <http://www3.tools.ietf.org/wg/httpbis/trac/ticket/8>: "Media Type | o <http://tools.ietf.org/wg/httpbis/trac/ticket/8>: "Media Type | |||
| Registrations" (<http://purl.org/NET/http-errata#media-reg>) | Registrations" (<http://purl.org/NET/http-errata#media-reg>) | |||
| o <http://www3.tools.ietf.org/wg/httpbis/trac/ticket/11>: "URI | o <http://tools.ietf.org/wg/httpbis/trac/ticket/11>: "URI includes | |||
| includes query" (<http://purl.org/NET/http-errata#uriquery>) | query" (<http://purl.org/NET/http-errata#uriquery>) | |||
| o <http://www3.tools.ietf.org/wg/httpbis/trac/ticket/15>: "No close | o <http://tools.ietf.org/wg/httpbis/trac/ticket/15>: "No close on | |||
| on 1xx responses" (<http://purl.org/NET/http-errata#noclose1xx>) | 1xx responses" (<http://purl.org/NET/http-errata#noclose1xx>) | |||
| o <http://www3.tools.ietf.org/wg/httpbis/trac/ticket/16>: "Remove | o <http://tools.ietf.org/wg/httpbis/trac/ticket/16>: "Remove | |||
| 'identity' token references" | 'identity' token references" | |||
| (<http://purl.org/NET/http-errata#identity>) | (<http://purl.org/NET/http-errata#identity>) | |||
| o <http://tools.ietf.org/wg/httpbis/trac/ticket/26>: "Import query | ||||
| BNF" | ||||
| o <http://www3.tools.ietf.org/wg/httpbis/trac/ticket/26>: "Import | o <http://tools.ietf.org/wg/httpbis/trac/ticket/31>: "qdtext BNF" | |||
| query BNF" | ||||
| o <http://www3.tools.ietf.org/wg/httpbis/trac/ticket/31>: "qdtext | o <http://tools.ietf.org/wg/httpbis/trac/ticket/35>: "Normative and | |||
| BNF" | Informative references" | |||
| o <http://www3.tools.ietf.org/wg/httpbis/trac/ticket/35>: "Normative | o <http://tools.ietf.org/wg/httpbis/trac/ticket/42>: "RFC2606 | |||
| and Informative references" | ||||
| o <http://www3.tools.ietf.org/wg/httpbis/trac/ticket/42>: "RFC2606 | ||||
| Compliance" | Compliance" | |||
| o <http://www3.tools.ietf.org/wg/httpbis/trac/ticket/45>: "RFC977 | o <http://tools.ietf.org/wg/httpbis/trac/ticket/45>: "RFC977 | |||
| reference" | reference" | |||
| o <http://www3.tools.ietf.org/wg/httpbis/trac/ticket/46>: "RFC1700 | o <http://tools.ietf.org/wg/httpbis/trac/ticket/46>: "RFC1700 | |||
| references" | references" | |||
| o <http://www3.tools.ietf.org/wg/httpbis/trac/ticket/47>: | o <http://tools.ietf.org/wg/httpbis/trac/ticket/47>: "inconsistency | |||
| "inconsistency in date format explanation" | in date format explanation" | |||
| o <http://www3.tools.ietf.org/wg/httpbis/trac/ticket/48>: "Date | o <http://tools.ietf.org/wg/httpbis/trac/ticket/48>: "Date reference | |||
| reference typo" | typo" | |||
| o <http://www3.tools.ietf.org/wg/httpbis/trac/ticket/65>: | o <http://tools.ietf.org/wg/httpbis/trac/ticket/65>: "Informative | |||
| "Informative references" | references" | |||
| o <http://www3.tools.ietf.org/wg/httpbis/trac/ticket/66>: | o <http://tools.ietf.org/wg/httpbis/trac/ticket/66>: "ISO-8859-1 | |||
| "ISO-8859-1 Reference" | Reference" | |||
| o <http://www3.tools.ietf.org/wg/httpbis/trac/ticket/86>: "Normative | o <http://tools.ietf.org/wg/httpbis/trac/ticket/86>: "Normative up- | |||
| up-to-date references" | to-date references" | |||
| Other changes: | Other changes: | |||
| o Update media type registrations to use RFC4288 template. | o Update media type registrations to use RFC4288 template. | |||
| o Use names of RFC4234 core rules DQUOTE and HTAB, fix broken ABNF | o Use names of RFC4234 core rules DQUOTE and HTAB, fix broken ABNF | |||
| for chunk-data (work in progress on | for chunk-data (work in progress on | |||
| <http://www3.tools.ietf.org/wg/httpbis/trac/ticket/36>) | <http://tools.ietf.org/wg/httpbis/trac/ticket/36>) | |||
| D.3. Since draft-ietf-httpbis-p1-messaging-01 | E.3. Since draft-ietf-httpbis-p1-messaging-01 | |||
| Closed issues: | Closed issues: | |||
| o <http://www3.tools.ietf.org/wg/httpbis/trac/ticket/19>: "Bodies on | o <http://tools.ietf.org/wg/httpbis/trac/ticket/19>: "Bodies on GET | |||
| GET (and other) requests" | (and other) requests" | |||
| o <http://tools.ietf.org/wg/httpbis/trac/ticket/55>: "Updating to | ||||
| RFC4288" | ||||
| o <http://www3.tools.ietf.org/wg/httpbis/trac/ticket/55>: "Updating | o <http://tools.ietf.org/wg/httpbis/trac/ticket/57>: "Status Code | |||
| to RFC4288" | and Reason Phrase" | |||
| o <http://www3.tools.ietf.org/wg/httpbis/trac/ticket/57>: "Status | o <http://tools.ietf.org/wg/httpbis/trac/ticket/82>: "rel_path not | |||
| Code and Reason Phrase" | used" | |||
| o <http://www3.tools.ietf.org/wg/httpbis/trac/ticket/82>: "rel_path | ||||
| not used" | ||||
| Ongoing work on ABNF conversion | Ongoing work on ABNF conversion | |||
| (<http://www3.tools.ietf.org/wg/httpbis/trac/ticket/36>): | (<http://tools.ietf.org/wg/httpbis/trac/ticket/36>): | |||
| o Get rid of duplicate BNF rule names ("host" -> "uri-host", | o Get rid of duplicate BNF rule names ("host" -> "uri-host", | |||
| "trailer" -> "trailer-part"). | "trailer" -> "trailer-part"). | |||
| o Avoid underscore character in rule names ("http_URL" -> "http- | o Avoid underscore character in rule names ("http_URL" -> "http- | |||
| URL", "abs_path" -> "path-absolute"). | URL", "abs_path" -> "path-absolute"). | |||
| o Add rules for terms imported from URI spec ("absoluteURI", | o Add rules for terms imported from URI spec ("absoluteURI", | |||
| "authority", "path-absolute", "port", "query", "relativeURI", | "authority", "path-absolute", "port", "query", "relativeURI", | |||
| "host) -- these will have to be updated when switching over to | "host) -- these will have to be updated when switching over to | |||
| skipping to change at page 65, line 34 | skipping to change at page 63, line 43 | |||
| o Move "Product Tokens" section (back) into Part 1, as "token" is | o Move "Product Tokens" section (back) into Part 1, as "token" is | |||
| used in the definition of the Upgrade header. | used in the definition of the Upgrade header. | |||
| o Add explicit references to BNF syntax and rules imported from | o Add explicit references to BNF syntax and rules imported from | |||
| other parts of the specification. | other parts of the specification. | |||
| o Rewrite prose rule "token" in terms of "tchar", rewrite prose rule | o Rewrite prose rule "token" in terms of "tchar", rewrite prose rule | |||
| "TEXT". | "TEXT". | |||
| D.4. Since draft-ietf-httpbis-p1-messaging-02 | E.4. Since draft-ietf-httpbis-p1-messaging-02 | |||
| Closed issues: | Closed issues: | |||
| o <http://www3.tools.ietf.org/wg/httpbis/trac/ticket/51>: "HTTP-date | o <http://tools.ietf.org/wg/httpbis/trac/ticket/51>: "HTTP-date vs. | |||
| vs. rfc1123-date" | rfc1123-date" | |||
| o <http://www3.tools.ietf.org/wg/httpbis/trac/ticket/64>: "WS in | ||||
| quoted-pair" | ||||
| o <http://tools.ietf.org/wg/httpbis/trac/ticket/64>: "WS in quoted- | ||||
| pair" | ||||
| Ongoing work on IANA Message Header Registration | Ongoing work on IANA Message Header Registration | |||
| (<http://www3.tools.ietf.org/wg/httpbis/trac/ticket/40>): | (<http://tools.ietf.org/wg/httpbis/trac/ticket/40>): | |||
| o Reference RFC 3984, and update header registrations for headers | o Reference RFC 3984, and update header registrations for headers | |||
| defined in this document. | defined in this document. | |||
| Ongoing work on ABNF conversion | Ongoing work on ABNF conversion | |||
| (<http://www3.tools.ietf.org/wg/httpbis/trac/ticket/36>): | (<http://tools.ietf.org/wg/httpbis/trac/ticket/36>): | |||
| o Replace string literals when the string really is case-sensitive | o Replace string literals when the string really is case-sensitive | |||
| (HTTP-Version). | (HTTP-Version). | |||
| D.5. Since draft-ietf-httpbis-p1-messaging-03 | E.5. Since draft-ietf-httpbis-p1-messaging-03 | |||
| Closed issues: | Closed issues: | |||
| o <http://www3.tools.ietf.org/wg/httpbis/trac/ticket/28>: | o <http://tools.ietf.org/wg/httpbis/trac/ticket/28>: "Connection | |||
| "Connection closing" | closing" | |||
| o <http://www3.tools.ietf.org/wg/httpbis/trac/ticket/97>: "Move | o <http://tools.ietf.org/wg/httpbis/trac/ticket/97>: "Move | |||
| registrations and registry information to IANA Considerations" | registrations and registry information to IANA Considerations" | |||
| o <http://www3.tools.ietf.org/wg/httpbis/trac/ticket/120>: "need new | o <http://tools.ietf.org/wg/httpbis/trac/ticket/120>: "need new URL | |||
| URL for PAD1995 reference" | for PAD1995 reference" | |||
| o <http://www3.tools.ietf.org/wg/httpbis/trac/ticket/127>: "IANA | o <http://tools.ietf.org/wg/httpbis/trac/ticket/127>: "IANA | |||
| Considerations: update HTTP URI scheme registration" | Considerations: update HTTP URI scheme registration" | |||
| o <http://www3.tools.ietf.org/wg/httpbis/trac/ticket/128>: "Cite | o <http://tools.ietf.org/wg/httpbis/trac/ticket/128>: "Cite HTTPS | |||
| HTTPS URI scheme definition" | URI scheme definition" | |||
| o <http://www3.tools.ietf.org/wg/httpbis/trac/ticket/129>: "List- | o <http://tools.ietf.org/wg/httpbis/trac/ticket/129>: "List-type | |||
| type headers vs Set-Cookie" | headers vs Set-Cookie" | |||
| Ongoing work on ABNF conversion | Ongoing work on ABNF conversion | |||
| (<http://www3.tools.ietf.org/wg/httpbis/trac/ticket/36>): | (<http://tools.ietf.org/wg/httpbis/trac/ticket/36>): | |||
| o Replace string literals when the string really is case-sensitive | o Replace string literals when the string really is case-sensitive | |||
| (HTTP-Date). | (HTTP-Date). | |||
| o Replace HEX by HEXDIG for future consistence with RFC 5234's core | o Replace HEX by HEXDIG for future consistence with RFC 5234's core | |||
| rules. | rules. | |||
| E.6. Since draft-ietf-httpbis-p1-messaging-04 | ||||
| Closed issues: | ||||
| o <http://tools.ietf.org/wg/httpbis/trac/ticket/34>: "Out-of-date | ||||
| reference for URIs" | ||||
| o <http://tools.ietf.org/wg/httpbis/trac/ticket/132>: "RFC 2822 is | ||||
| updated by RFC 5322" | ||||
| Ongoing work on ABNF conversion | ||||
| (<http://tools.ietf.org/wg/httpbis/trac/ticket/36>): | ||||
| o Use "/" instead of "|" for alternatives. | ||||
| o Get rid of RFC822 dependency; use RFC5234 plus extensions instead. | ||||
| o Only reference RFC 5234's core rules. | ||||
| o Introduce new ABNF rules for "bad" whitespace ("BWS"), optional | ||||
| whitespace ("OWS") and required whitespace ("RWS"). | ||||
| o Rewrite ABNFs to spell out whitespace rules, factor out header | ||||
| value format definitions. | ||||
| Index | Index | |||
| A | A | |||
| application/http Media Type 50 | application/http Media Type 45 | |||
| C | C | |||
| cache 8 | cache 60 | |||
| cacheable 9 | cacheable 60 | |||
| client 7 | client 59 | |||
| connection 6 | connection 58 | |||
| Connection header 40 | Connection header 35 | |||
| content negotiation 7 | content negotiation 59 | |||
| Content-Length header 41 | Content-Length header 36 | |||
| D | D | |||
| Date header 42 | Date header 36 | |||
| downstream 9 | downstream 61 | |||
| E | E | |||
| entity 7 | entity 58 | |||
| G | G | |||
| gateway 8 | gateway 60 | |||
| Grammar | Grammar | |||
| absoluteURI 18 | absolute-URI 12 | |||
| ALPHA 14 | asctime-date 14 | |||
| asctime-date 20 | attribute 16 | |||
| attribute 21 | authority 12 | |||
| authority 18 | BWS 9 | |||
| CHAR 14 | chunk 17 | |||
| chunk 22 | chunk-data 17 | |||
| chunk-data 22 | chunk-ext 17 | |||
| chunk-ext-name 22 | chunk-ext-name 17 | |||
| chunk-ext-val 22 | chunk-ext-val 17 | |||
| chunk-extension 22 | chunk-size 17 | |||
| chunk-size 22 | Chunked-Body 17 | |||
| Chunked-Body 22 | comment 10 | |||
| comment 15 | Connection 35 | |||
| Connection 40 | connection-token 35 | |||
| connection-token 40 | Connection-v 35 | |||
| Content-Length 41 | Content-Length 36 | |||
| CR 14 | Content-Length-v 36 | |||
| CRLF 14 | ctext 10 | |||
| ctext 15 | Date 36 | |||
| CTL 14 | Date-v 36 | |||
| Date 42 | date1 14 | |||
| date1 20 | date2 14 | |||
| date2 20 | date3 14 | |||
| date3 20 | extension-code 27 | |||
| DIGIT 14 | extension-method 24 | |||
| DQUOTE 14 | field-content 20 | |||
| extension-code 33 | field-name 20 | |||
| extension-method 29 | field-value 20 | |||
| field-content 25 | general-header 23 | |||
| field-name 25 | generic-message 19 | |||
| field-value 25 | Host 38 | |||
| general-header 29 | Host-v 38 | |||
| generic-message 25 | HTTP-date 14 | |||
| HEXDIG 15 | HTTP-message 19 | |||
| Host 43 | HTTP-Prot-Name 11 | |||
| HTAB 14 | http-URI 13 | |||
| HTTP-date 20 | HTTP-Version 11 | |||
| HTTP-message 24 | last-chunk 17 | |||
| HTTP-Prot-Name 16 | message-body 21 | |||
| http-URL 18 | message-header 20 | |||
| HTTP-Version 16 | Method 24 | |||
| last-chunk 22 | month 14 | |||
| LF 14 | obsolete-date 14 | |||
| LWS 14 | OWS 9 | |||
| message-body 26 | parameter 16 | |||
| message-header 25 | path-absolute 12 | |||
| Method 29 | port 12 | |||
| month 20 | product 18 | |||
| obsolete-date 20 | product-version 18 | |||
| OCTET 14 | protocol-name 42 | |||
| parameter 21 | protocol-version 42 | |||
| path-absolute 18 | pseudonym 42 | |||
| port 18 | qdtext 10 | |||
| product 24 | query 12 | |||
| product-version 24 | quoted-pair 10 | |||
| protocol-name 47 | quoted-string 10 | |||
| protocol-version 47 | quoted-text 10 | |||
| pseudonym 47 | Reason-Phrase 27 | |||
| qdtext 15 | received-by 42 | |||
| query 18 | received-protocol 42 | |||
| quoted-pair 15 | relative-part 12 | |||
| quoted-string 15 | relativeURI 12 | |||
| quoted-text 15 | Request 24 | |||
| Reason-Phrase 33 | Request-Line 24 | |||
| received-by 47 | Request-URI 24 | |||
| received-protocol 47 | Response 26 | |||
| relativeURI 18 | rfc850-date 14 | |||
| Request 29 | rfc1123-date 14 | |||
| Request-Line 29 | RWS 9 | |||
| Request-URI 30 | start-line 19 | |||
| Response 32 | Status-Code 27 | |||
| rfc850-date 20 | Status-Line 27 | |||
| rfc1123-date 20 | t-codings 38 | |||
| separators 15 | tchar 10 | |||
| SP 14 | TE 38 | |||
| start-line 25 | TE-v 38 | |||
| Status-Code 33 | TEXT 9 | |||
| Status-Line 32 | time 14 | |||
| t-codings 44 | token 10 | |||
| tchar 15 | Trailer 40 | |||
| TE 44 | trailer-part 17 | |||
| TEXT 14 | Trailer-v 40 | |||
| time 20 | transfer-coding 16 | |||
| token 15 | Transfer-Encoding 40 | |||
| Trailer 45 | Transfer-Encoding-v 40 | |||
| trailer-part 22 | transfer-extension 16 | |||
| transfer-coding 21 | Upgrade 41 | |||
| Transfer-Encoding 45 | Upgrade-v 41 | |||
| transfer-extension 21 | uri-host 12 | |||
| Upgrade 46 | URI-reference 12 | |||
| uri-host 18 | value 16 | |||
| value 21 | Via 42 | |||
| Via 47 | Via-v 42 | |||
| weekday 20 | weekday 14 | |||
| wkday 20 | wkday 14 | |||
| H | H | |||
| Headers | Headers | |||
| Connection 40 | Connection 35 | |||
| Content-Length 41 | Content-Length 36 | |||
| Date 42 | Date 36 | |||
| Host 43 | Host 38 | |||
| TE 44 | TE 38 | |||
| Trailer 45 | Trailer 39 | |||
| Transfer-Encoding 45 | Transfer-Encoding 40 | |||
| Upgrade 46 | Upgrade 41 | |||
| Via 47 | Via 42 | |||
| Host header 43 | Host header 38 | |||
| http URI scheme 18 | http URI scheme 13 | |||
| https URI scheme 18 | https URI scheme 13 | |||
| I | I | |||
| implied *LWS 13 | inbound 61 | |||
| inbound 9 | ||||
| M | M | |||
| Media Type | Media Type | |||
| application/http 50 | application/http 45 | |||
| message/http 49 | message/http 44 | |||
| message 6 | message 58 | |||
| message/http Media Type 49 | message/http Media Type 44 | |||
| O | O | |||
| origin server 8 | origin server 59 | |||
| outbound 9 | outbound 61 | |||
| P | P | |||
| proxy 8 | proxy 59 | |||
| R | R | |||
| representation 7 | representation 58 | |||
| request 6 | request 58 | |||
| resource 7 | resource 58 | |||
| response 6 | response 58 | |||
| S | S | |||
| server 8 | server 59 | |||
| T | T | |||
| TE header 44 | TE header 38 | |||
| Trailer header 45 | Trailer header 39 | |||
| Transfer-Encoding header 45 | Transfer-Encoding header 40 | |||
| tunnel 8 | tunnel 60 | |||
| U | U | |||
| Upgrade header 46 | Upgrade header 41 | |||
| upstream 9 | upstream 61 | |||
| URI scheme | URI scheme | |||
| http 18 | http 13 | |||
| https 18 | https 13 | |||
| user agent 7 | user agent 59 | |||
| V | V | |||
| variant 7 | variant 59 | |||
| Via header 47 | Via header 42 | |||
| Authors' Addresses | Authors' Addresses | |||
| Roy T. Fielding (editor) | Roy T. Fielding (editor) | |||
| Day Software | Day Software | |||
| 23 Corporate Plaza DR, Suite 280 | 23 Corporate Plaza DR, Suite 280 | |||
| Newport Beach, CA 92660 | Newport Beach, CA 92660 | |||
| USA | USA | |||
| Phone: +1-949-706-5300 | Phone: +1-949-706-5300 | |||
| End of changes. 172 change blocks. | ||||
| 805 lines changed or deleted | 743 lines changed or added | |||
This html diff was produced by rfcdiff 1.34. The latest version is available from http://tools.ietf.org/tools/rfcdiff/ | ||||