rfc2756.txt

本程序为在linux下实现FTP传输文件的实现

组织：中国互动出版网（http://www.china-pub.com/）
RF文档中文翻译计划（http://www.china-pub.com/compters/emook/aboutemook.htm）
E-mail：[e-mail]
译者：陈贵敏（efoxxx   [e-mail]）
译文发布时间：2001-10-20
版权：本中文翻译文档版权归中国互动出版网所有。可以用于非商业用途自由转载，但必须保留本文档的翻译及版权信息。

Network Working Group                                            P. Vixie
Request for Comments: 2756                                            ISC
Category: Experimental                                         D. Wessels
                                                                    NLANR
                                                             January 2000

超文本缓存协议(HTCP/0.0)
(Hyper Text Caching Protocol (HTCP/0.0))

本备忘录的状态
本备忘录定义了一种Internet社区的试验性的协议。它并没有具体指定任何一种Internet标准。它需要进一步进行讨论和建议以得到改进。本备忘录的发布不受任何限制。


版权声明

   Copyright (C) The Internet Society (2000).  All Rights Reserved.

摘要
  
   本文档描述了超文本缓冲协议（HTCP），它是一个用来发现HTTP缓冲区并储存数据、管理整套的HTTP缓冲区和监测缓冲区活动的协议。这是一个试验性协议，用来完成这些功能的几个建议中其中的一个。



1.  定义、基本原理及其范围Definitions, Rationale and Scope

   1．1．HTTP/1.1 （参见 [RFC2616]）支持从“原始服务器”到“客户端”的网络对象的传输，或许是经由“代理服务器”（在某些情况下，这样做允许“缓存”这些对象以备以后重用）。“客户端”将得到的对象以某种方式消费，通常就将它作为“网页”的一部分显示出来。HTTP/1.0以及后来的版本允许在请求或者响应中包含有“headers”，这就扩充了HTTP/0.9（以及更早的版本）的在请求中仅指定一个URI（Uniform Resource Identifiers）和在响应中仅仅提供一个实体行为。

  1．2． ICP（参见[RFC2186]）支持象查询其内容一样的方式来查询缓冲区，通常是通过其它缓冲区， 这是希望能避免从一台远程源服务器上高代价地索取资源。   ICP是用HTTP/0.9的思想设计的，因此呢，仅仅使用了URI（不包括任何的标题）来描述缓冲区的内容，而且，针对（for）同一个URI的多路可兼容的实体至今仍没有好的方案。

 1．3． 此文档详细描述了一个超文本缓冲协议（HTCP），此超文本缓冲协议（HTCP）完全支持在缓冲区管理中使用请求和响应标题，并扩展了缓冲区管理的范围――包括了一个远程缓冲区添加和删除的监控，以及发送有关网络对象的提示信息，比如说象可缓冲对象的第三方的地址，或者是网络对象被测的不可缓冲性或不可用性。

2.  HTCP 协议

2.1.  所有多字节的HTCP协议元素都是以网络字节顺序传送的。所有的保留字段都应当由发送端设置为二进制0（zero）并接受端没有检查。同HTTP一样，标题必须置于CRLF行的末尾。

   2.2.  任何指定的主机名都应当在发送端和接受端之间互相兼容，这样如果正在使用一私有命名方案（比如HOSTS.TXT 或者NIS），依此方案命名的名称将仅发送给那些已知的参与此方案的HTCP邻居。原始地址（由点号连接的四个小于255的数字代表IP地址的IPv4，或格式的IPv6）是通用的，就如同公用DNS名称。使用私有名称或者地址特别需要一些操作上的注意事项。

   2.3.  HTCP消息可以已数据报的形式发送，或者通过TCP连接发送。必须支持UDP协议。HTCP代理商决不能对网络故障和网络延迟袖手旁观。HTCP代理商应当时刻准备着，一旦出现没有得到响应，或者响应延迟了或者被重新安排了或者被破坏了的情况，就要采取有效的措施。TCP协议是可选的，只是在协议除错的时候才可能拥到它。IANA已经为HTCP指定了标准TCP和UDP端口号4827。

   2.4.  应当为每一个代理商维护一套关于传输特性的配置变量，这些变量能够初始化HTCP交易，或许是一套每代理商全局缺省值。这些变量是：

――认为是“失败” 交易的最大未回复交易数。
――对于某些交易认为是“失败”交易的最大无响应间隔时间。
――交易“失败”后尝试开始一个新交易的最小间隔时间。

应当为每一个代理维护一组关于传输特性的配置变量。代理能够初始化HTCP交易，或许它还带有一组每代理全局缺省值。 

   2.5. 一般来说HTCP消息的格式如下所示：

   +---------------------+
   |        HEADER       |  说明消息的长度和协议的版本
   +---------------------+
   |         DATA        |  HTCP消息体 (每一个主版本号都会有所不同)
   +---------------------+
   |         AUTH        |  可选的交易认证
   +---------------------+

   2.6. HTCP/*.* 的HEADER 的具体格式如下：

                 +0 (MSB)                            +1 (LSB)
      +---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+
   0: |                             LENGTH                            |
      +   +   +   +   +   +   +   +   +   +   +   +   +   +   +   +   +
   2: |                             LENGTH                            |
      +---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+
   2: |             MAJOR             |             MINOR             |
      +---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+

   LENGTH  消息的长度，其中包括了所有的HEADER以及八字节数据，还包括LENGTH字段自身所占长度。如果在使用数据报协议的话，此字段与商务流量的大小（“记录的长度”）是一致的，并且还包括多余的空白，也就是说在DATA和AUTH部分并不是所有的八字节的消息都会有用。

   MAJOR   是主版本号（0代表规格）。HTCP消息的DATA部分需要向上或者向下兼容不同的主版本号。

   MINOR   是次版本号（0代表规格）。不同的特性标准和翻译规则依此字段而定，特别地，预留（RESERVED）字段（虽然是可选的）在同一主版本号中的后续次版本号可能会有有新的含义。

   2.6.1.  我们希望HTCP的发出者知道即将到来的HTCP响应者的版本号，或者HTCP的发出者通过使用数值降序法探测MINOR和MAJOR版本号（以本地可支持的最大数值开始）并在本地缓存探测到的HTCP响应者的版本号。

   2.6.2.  较高的主版本号优先级更高，因为较高的次版本号也是被在特定的主版本号中的。

   2.7.  HTCP/0.* 的DATA 的具体格式如下：

                 +0 (MSB)                            +1 (LSB)
      +---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+
   0: |                             LENGTH                            |
      +---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+
   2: |    OPCODE     |   RESPONSE    |        RESERVED       |F1 |RR |
      +---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+
   4: |                           TRANS-ID                            |
      +   +   +   +   +   +   +   +   +   +   +   +   +   +   +   +   +
   6: |                           TRANS-ID                            |
      +---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+
   8: |                                                               |
      /                            OP-DATA                            /
      /                                                               /
      +---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+

   LENGTH    是HTCP消息用来存放DATA部分的字节数，其中包括LENGTH字段本身所占的长度。此数还包括多余的空白，也就是说LENGTH所预留的字节数并不是所有的都用于OP-DATA字段。

   OPCODE    是HTCP交易的操作编码字段。一个HTCP交易可以包括多个HTCP消息，比如说，一个请求消息（由发出者发送），或者一个响应消息（由响应者发送）。

   RESPONSE  此为一个数值型编码，用来指示交易成功或者失败的。此字段应该由请求者置为零（zero），而响应者不去管它。每一操作都有自己的一套响应编码，这套编码将在后边才被确定下来。整个消息的响应编码如下所示：

            0   必须使用认证但是还没有使用
            1   已经使用了认证，可是并不符合要求
            2   操作编码未被执行
            3   不被支持的主版本号
            4   不被支持的次版本号（主版本号符合要求）
            5   不适当的、不允许的或者是不受欢迎的操作编码

            上面的响应编码都是错误提示，它们的能见性完全取决于MO=1（接下来会有说明）是否成立。

   RR       是一个标志位，指示一条消息是否请求(0)还是响应(1)。

   F1       此位被重载，因此它对于请求者和响应者有着不同的用法。如果RR＝0，那么F1被定义为RD。如果RR＝1，则F1定义为MO。

   RD        是一个标志位，当它是1时，意味着要求响应。某些操作编码（OPCODE）需要将RD置为1才有意义。

   MO        (em-oh) 是一个标志位，它指示是把响应编码解释为对整个消息的一个响应（ DATA中确定的字段或者是AUTH中的任一个字段）[ MO = 1时 ]，还是在             OP－DATA中的字段的一个响应[ MO = 0 时]。

   TRANS-ID  是一个32位字节的值，当它与发出者的网络地址加起来，就可以唯一确定此次HTCP交易。需要谨慎的是，在UDP数据报的生命周期内不要重用此交易代号TRANS－ID。

   OP-DATA   它依赖于操作编码（opcode-dependent），其对每一操作代码的定义见下边。

   2.8. HTCP/0.0 的AUTH的具体格式如下:

                 +0 (MSB)                            +1 (LSB)
       +---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+
    0: |                             LENGTH                            |
       +---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+
    2: |                            SIG-TIME                           |
       +   +   +   +   +   +   +   +   +   +   +   +   +   +   +   +   +
    4: |                            SIG-TIME                           |
       +---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+
    6: |                           SIG-EXPIRE                          |
       +   +   +   +   +   +   +   +   +   +   +   +   +   +   +   +   +
    8: |                           SIG-EXPIRE                          |
       +---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+
   10: |                                                               |
       /                            KEY-NAME                           /
       /                                                               /
       +---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+
    n: |                                                               |
       /                            SIGNATURE                          /
       /                                                               /
       +---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+

   LENGTH      是用来存放AUTH部分的字节数，其中包括LENGTH字段本身所占的长度。如果可选项AUTH不被传送的话，此字段应该置为2（two）。LENGTH还可以包括多余的空白，也就是说LENGTH所预留的字节数并不是所有的都用于SIGNATURE字段。

   SIG-TIME   是一个无符号二进制计数器，它指示着从1970年11月1号的00:00:00，（UTC，Coordinated Universal Time）开始计数，到SIGNATURE产生的所经历的时间（以秒计）。

   SIG-EXPIRE  是一个无符号二进制计数器，它指示着从1970年11月1号的00:00:00，（UTC，Coordinated Universal Time）开始计数，到SIGNATURE被认为过期所经历的时间（以秒计）。

   KEY-NAME    是一 COUNTSTR 结构[ 参见3.1 ]，它具体指定了共享密钥的名称。（每一个HTCP的实现都容许有几个共享密钥的配置，而且每一密钥都有一个名称）。

   SIGNATURE    是一带有一个值为64的B 的COUNTSTR 结构[ 参见3.1 ]， 它包含 HMAC-MD5 下边所示的各个要素的摘要（请见[RFC 2104]），其中每一个摘要都是以其“on the wire”格式整理的，如果有被与字段相关的LENGTH覆盖的话还包括传送的多余空白：

               IP SRC ADDR                           [4 字节]
               IP SRC PORT                           [2字节]
               IP DST ADDR                           [4字节]
               IP DST PORT                           [2字节]
               HTCP MAJOR 版本号                     [1字节]
               HTCP MINOR 版本号                     [1字节]
               SIG-TIME                              [4字节]
               SIG-EXPIRE                            [4字节]
               HTCP DATA                             [长度可变]
               KEY-NAME (全部的 COUNTSTR [3.1])      [长度可变]

   2.8.1.  共享的密钥应当随机且秘密地生成，而且密钥的长度至少应该有几百个字节。

3.  数据类型

   HTCP/0.* 的数据类型定义如下：

   3.1. COUNTSTR 是一个记长度（counted）的字符串，其格式为：

                 +0 (MSB)                            +1 (LSB)
      +---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+
   0: |                             LENGTH                            |
      +---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+
   2: |                                                               |
      /                              TEXT                             /
      /                                                               /
      +---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+

   LENGTH   为后面TEXT字段中的字节数。此字段与上边讲到的其它的HTCP协议中的LENGTH字段一样的是，它不包括自身所占的字节数。

   TEXT    是一段未被解释的字节流，通常为ISO8859-1标准的字符。

   3.2.  SPECIFIER（说明符）用于TST 和CLR请求消息。下面有它的定义。它其格式是：

      +---------------------+
      |        METHOD       | : COUNTSTR
      +---------------------+
      |         URI         | : COUNTSTR
      +---------------------+
      |       VERSION       | : COUNTSTR
      +---------------------+
      |       REQ-HDRS      | : COUNTSTR
      +---------------------+

   METHOD    （因为HTCP仅返回标题，所以GET和HEAD方法是等价的。）

   URI       （如果URI是一个URL，它通常应当还包括一个“：”<port(端口号)>说明符。若是没有的话，接收器会使用端口80。）

   VERSION   是一个完整的HTTP版本字符串，比如说“HTTP/1.1”。不是以“HTTP/”版本字符串打头的以及版本号小于“1.1” 的版本字符串均不在此规格之内。

   REQ-HDRS  这些标题是由HTTP发起者提供的。它们应包括端对端标题（end-to-end），而不是hop-by-hop标题，并且可以将它们标准化（例如：允许有“Accept:”集成。）

   3.3.  DETAIL域用于TST响应消息，定义如下。它的格式：

      +---------------------+
      |      RESP-HDRS      | : COUNTSTR
      +---------------------+
      |     ENTITY-HDRS     | : COUNTSTR
      +---------------------+
      |     CACHE-HDRS      | : COUNTSTR
      +---------------------+

   3.4.  IDENTITY 用于MON请求消息和SET响应消息，其定义如下。格式为：

      +---------------------+
      |      SPECIFIER      |
      +---------------------+
      |        DETAIL       |
      +---------------------+

4.  缓冲标题

   HTCP/0.0的 CACHE-HDRS字段是由零个或者多个下面列出来的标题组合而成的：

   Cache-Vary: < header-name> ...
      
标题的发送端知道其内容会随着一组不同于在对象的Vary: header标题中给定的那一组的标题而变化。如果有Cache-Vary:的话，对象的Vary: header就会失效。

   Cache-Location: <cache-hostname>:<port> ...
      标题的发送端知道有一个以上的代理缓冲区保留了一份儿此对象的拷贝。使用HTCP探测这些缓冲区，可能会发现新的、距离近的（亦即当前更好的选择）HTCP“邻居”。

   Cache-Policy: [no-cache] [no-share] [no-cache-cookie]
      标题的发送端知道此对象的缓存策略中有比在它的响应标题中所给出的更多的详细资料。