ICP, Internet Cache Protocol |
Description | Glossary | RFCs | Publications | Obsolete RFCs |
Protocol suite: | TCP/IP. |
Protocol type: | Application layer protocol. |
Ports: | 3130 (UDP). |
URI: | |
MIME subtype: | |
SNMP MIBs: | |
Working groups: | |
Links: |
ICP is a lightweight message format used for communicating among Web caches. ICP is used to exchange hints about the existence of URLs in neighbor caches. Caches exchange ICP queries and replies to gather information to use in selecting the most appropriate location from which to retrieve an object.
ICP is a message format used for communicating between Web caches. Although Web caches use HTTP for the transfer of object data, caches benefit from a simpler, lighter communication protocol. ICP is primarily used in a cache mesh to locate specific Web objects in neighboring caches. One cache sends an ICP query to its neighbors. The neighbors send back ICP replies indicating a "HIT" or a "MISS."
In current practice, ICP is implemented on top of UDP, but there is no requirement that it be limited to UDP. We feel that ICP over UDP offers features important to Web caching applications. An ICP query/reply exchange needs to occur quickly, typically within a second or two. A cache cannot wait longer than that before beginning to retrieve an object. Failure to receive a reply message most likely means the network path is either congested or broken. In either case we would not want to select that neighbor. As an indication of immediate network conditions between neighbor caches, ICP over a lightweight protocol such as UDP is better than one with the overhead of TCP.
In addition to its use as an object location protocol, ICP messages can be used for cache selection. Failure to receive a reply from a cache may indicate a network or system failure. The ICP reply may include information that could assist selection of the most appropriate source from which to retrieve an object.
RFC 2187, page 1:
ICP queries and replies refer to the existence of URLs (or objects) in neighbor caches. Caches exchange ICP messages and use the gathered information to select the most appropriate location from which to retrieve an object.
RFC 2187, page 15:
ICP is notably different from HTTP. HTTP supports a rich and sophisticated set of features. In contrast, ICP was designed to be simple, small, and efficient. HTTP request and reply headers consist of lines of ASCII text delimited by a CRLF pair, whereas ICP uses a fixed size header and represents numbers in binary. The only thing ICP and HTTP have in common is the URL.
MAC header | IP header | UDP header | ICP message |
ICP message:
00 | 01 | 02 | 03 | 04 | 05 | 06 | 07 | 08 | 09 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 23 | 24 | 25 | 26 | 27 | 28 | 29 | 30 | 31 |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Opcode | Version | Message Length | |||||||||||||||||||||||||||||
Request Number | |||||||||||||||||||||||||||||||
Options | |||||||||||||||||||||||||||||||
Option Data | |||||||||||||||||||||||||||||||
Sender Host Address | |||||||||||||||||||||||||||||||
Payload ::: |
The ICP message format consists of a 20 byte header followed by a variable sized payload. All fields are represented in network byte order.
ICP messages MUST not exceed 16,384 bytes in length.
Opcode. 8 bits.
Value | Name |
---|---|
0 | ICP_OP_INVALID |
1 | ICP_OP_QUERY. |
2 | ICP_OP_HIT. |
3 | ICP_OP_MISS. |
4 | ICP_OP_ERR. |
5 - 9 |
|
10 | ICP_OP_SECHO. |
11 | ICP_OP_DECHO. |
12 - 20 |
|
21 | ICP_OP_MISS_NOFETCH. |
22 | ICP_OP_DENIED. |
23 | ICP_OP_HIT_OBJ. |
Version.
8 bits.
The ICP protocol version number.
Message Length.
16 bits.
The total length of the ICP message in bytes.
Request Number.
32 bits.
An opaque identifier.
When responding to a query, this value must be copied into the reply message.
Options.
32 bits.
Option flags that allows extension of this version of the protocol in certain, limited ways.
Value | Flag | Description |
---|---|---|
0x40000000 | ICP_FLAG_SRC_RTT | This flag is set in an ICP_OP_QUERY message indicating that the requester would like the ICP reply to include the responder's measured RTT to the origin server. |
0x80000000 | ICP_FLAG_HIT_OBJ | This flag is set in an ICP_OP_QUERY message indicating that it is okay to respond with an ICP_OP_HIT_OBJ message if the object data will fit in the reply. |
Option Data.
32 bits.
Optional features.
The following ICP features make use of this field: The ICP_FLAG_SRC_RTT
option uses the low 16-bits of Option Data to return RTT measurements.
Sender Host Address.
32 bits.
The IPv4 address of the host sending the ICP message.
This field should probably not be trusted over what is provided by getpeer- name(), accept(), and recvfrom().
There is some ambiguity over the original purpose of this field.
In practice it is not used.
Payload. Variable length.
RFCs:
[RFC 2186] Internet Cache Protocol (ICP), version 2.
[RFC 2187] Application of Internet Cache Protocol (ICP), version 2.
[RFC 3143] Known HTTP Proxy/Caching Problems.
Description | Glossary | RFCs | Publications | Obsolete RFCs |