This article is about the support protocol for IPv4 (ICMPv4). For ICMPv6, see ICMPv6.

“ICMP” redirects here. For other uses, see ICMP (disambiguation).

Internet Control Message Protocol
Communication protocol
A general header for ICMPv4
PurposeAuxiliary protocol for IPv4[1]: 52 
Developer(s)DARPA
Introduction1981
OSI layerNetwork layer
RFC(s)RFC 792

The Internet Control Message Protocol (ICMP) is a supporting protocol1 in the Internet protocol suite. It is used by network devices, including routers, to send error messages and operational information indicating success or failure when communicating with another IP address. For example, an error is indicated when a requested service is not available or that a host or router could not be reached.2 ICMP differs from transport protocols such as TCP and UDP in that it is not typically used to exchange data between systems, nor is it regularly employed by end-user network applications (with the exception of some diagnostic tools like ping and traceroute).

A separate Internet Control Message Protocol (called ICMPv6) is used with IPv6.3

Technical details

ICMP is part of the Internet protocol suite as defined in RFC 792. ICMP messages are typically used for diagnostic or control purposes or generated in response to errors in IP operations (as specified in RFC 1122). ICMP errors are directed to the source IP address of the originating packet.2

For example, every device (such as an intermediate router) forwarding an IP datagram first decrements the time to live (TTL) field in the IP header by one. If the resulting TTL is 0, the packet is discarded and an ICMP time exceeded message is sent to the datagram’s source address.

Many commonly used network utilities are based on ICMP messages. The traceroute command can be implemented by transmitting IP datagrams with specially set IP TTL header fields, and looking for ICMP time exceeded in transit and destination unreachable messages generated in response. The related ping utility is implemented using the ICMP echo request and echo reply messages.

ICMP uses the basic support of IP as if it were a higher-level protocol, however, ICMP is actually an integral part of IP. Although ICMP messages are contained within standard IP packets, ICMP messages are usually processed as a special case, distinguished from normal IP processing. In many cases, it is necessary to inspect the contents of the ICMP message and deliver the appropriate error message to the application responsible for transmitting the IP packet that prompted the ICMP message to be sent.

ICMP is a network-layer protocol; this makes it a layer 3 protocol in the seven-layer OSI model. Based on the four-layer TCP/IP model, ICMP is an internet-layer protocol, which makes it a layer 2 protocol in the Internet Standard RFC 1122 TCP/IP four-layer model or a layer 3 protocol in the modern five-layer TCP/IP protocol definitions (by Kozierok, Comer, Tanenbaum, Forouzan, Kurose, Stallings).

There is no TCP or UDP port number associated with ICMP packets as these numbers are associated with the transport layer above.4

Datagram structure

The ICMP packet is encapsulated in an IPv4 packet.2 The packet consists of header and data sections.

The ICMP header starts after the IPv4 header and is identified by its protocol number, 1.5 All ICMP packets have an eight-byte header and variable-sized data section. The first four bytes of the header have fixed format, while the last four bytes depend on the type and code of the ICMP packet.2

ICMP header format
OffsetOctet0123
OctetBit012345678910111213141516171819202122232425262728293031
00TypeCodeChecksum
432Rest of Header

Type: 8 bits

ICMP type, see § Control messages.

Code: 8 bits

ICMP subtype, see § Control messages.

Checksum: 16 bits

Internet checksum6 for error checking, calculated from the ICMP header and data with value 0 substituted for this field.

Rest of Header: 32 bits

Four-byte field, contents vary based on the ICMP type and code.

Data

ICMP error messages contain a data section that includes a copy of the entire IPv4 header, plus at least the first eight bytes of data from the IPv4 packet that caused the error message. The length of ICMP error messages should not exceed 576 bytes.7 This data is used by the host to match the message to the appropriate process. If a higher level protocol uses port numbers, they are assumed to be in the first eight bytes of the original datagram’s data.1

The variable size of the ICMP packet data section has been exploited. In the “Ping of death”, large or fragmented ICMP packets are used for denial-of-service attacks. ICMP data can also be used to create covert channels for communication. These channels are known as ICMP tunnels.

Control messages

Control messages are identified by the value in the type field. The code field gives additional context information for the message. Some control messages have been deprecated since the protocol was first introduced.

Notable control messages[8][9]
TypeCodeStatusDescription
0 – Echo Reply[2]: 14 0Echo reply (used to ping)
1 and 2unassignedReserved
3 – Destination Unreachable[2]: 4 [8]0Destination network unreachable
1Destination host unreachable
2Destination protocol unreachable
3Destination port unreachable
4Fragmentation required, and DF flag set
5Source route failed
6Destination network unknown
7Destination host unknown
8Source host isolated
9Network administratively prohibited
10Host administratively prohibited
11Network unreachable for ToS
12Host unreachable for ToS
13Communication administratively prohibited
14Host Precedence Violation
15Precedence cutoff in effect
4 – Source Quench0deprecated[10]Source quench (congestion control)
5 – Redirect Message0Redirect Datagram for the Network
1Redirect Datagram for the Host
2Redirect Datagram for the ToS & network
3Redirect Datagram for the ToS & host
6deprecated[11]Alternate Host Address
7unassignedReserved
8 – Echo Request0Echo request (used to ping)
9 – Router Advertisement0Router Advertisement
10 – Router Solicitation0Router discovery/selection/solicitation
11 – Time Exceeded[2]: 6 0Time to live (TTL) expired in transit
1Fragment reassembly time exceeded
12 – Parameter Problem: Bad IP header0Pointer indicates the error
1Missing a required option
2Bad length
13 – Timestamp0Timestamp
14 – Timestamp Reply0Timestamp reply
15 – Information Request0deprecated[11]Information Request
16 – Information Reply0deprecated[11]Information Reply
17 – Address Mask Request0deprecated[11]Address Mask Request
18 – Address Mask Reply0deprecated[11]Address Mask Reply
19unassignedReserved for security
20 through 29unassignedReserved for robustness experiment
30 – Traceroute0deprecated[11]Information Request
31deprecated[11]Datagram Conversion Error
32deprecated[11]Mobile Host Redirect
33deprecated[11]Where-Are-You (originally meant for IPv6)
34deprecated[11]Here-I-Am (originally meant for IPv6)
35deprecated[11]Mobile Registration Request
36deprecated[11]Mobile Registration Reply
37deprecated[11]Domain Name Request
38deprecated[11]Domain Name Reply
39deprecated[11]SKIP Algorithm Discovery Protocol, Simple Key-Management for Internet Protocol
40Photuris, Security failures
41ExperimentalICMP for experimental mobility protocols such as Seamoby.[12]
42 – Extended Echo Request[13]0Request Extended Echo
43 – Extended Echo Reply[13]0No Error
1Malformed Query
2No Such Interface
3No Such Table Entry
4Multiple Interfaces Satisfy Query
44 through 252unassignedReserved
253ExperimentalRFC3692-style Experiment 1[14]
254ExperimentalRFC3692-style Experiment 2[14]
255unassignedReserved

Source quench

Source Quench requests that the sender decrease the rate of messages sent to a router or host. This message may be generated if a router or host does not have sufficient buffer space to process the request, or may occur if the router or host buffer is approaching its limit.

Data is sent at a very high speed from a host or from several hosts at the same time to a particular router on a network. Although a router has buffering capabilities, the buffering is limited to within a specified range. The router cannot queue any more data than the capacity of the limited buffering space. Thus if the queue gets filled up, incoming data is discarded until the queue is no longer full. But as no acknowledgement mechanism is present in the network layer, the client does not know whether the data has reached the destination successfully. Hence some remedial measures should be taken by the network layer to avoid these kind of situations. These measures are referred to as source quench.

In a source quench mechanism, the router sees that the incoming data rate is much faster than the outgoing data rate, and sends an ICMP message to the clients, informing them that they should slow down their data transfer speeds or wait for a certain amount of time before attempting to send more data. When a client receives this message, it automatically slows down the outgoing data rate or waits for a sufficient amount of time, which enables the router to empty the queue. Thus the source quench ICMP message acts as flow control in the network layer.

Since research suggested that “ICMP Source Quench [was] an ineffective (and unfair) antidote for congestion”,8 routers’ creation of source quench messages was deprecated in 1995 by RFC 1812. Furthermore, forwarding of and any kind of reaction to (flow control actions) source quench messages was deprecated from 2012 by RFC 6633.

Source quench message[2]: 9 
0001020304050607080910111213141516171819202122232425262728293031
Type = 4Code = 0Checksum
unused
IP header and first 8 bytes of original datagram's data

Where:

Type must be set to 4

Code must be set to 0

IP header and additional data is used by the sender to match the reply with the associated request

Redirect

An example of how an ICMPv4 redirect message works

Redirect requests data packets be sent on an alternative route. ICMP Redirect is a mechanism for routers to convey routing information to hosts. The message informs a host to update its routing information (to send packets on an alternative route). If a host tries to send data through a router (R1) and R1 sends the data on another router (R2) and a direct path from the host to R2 is available (that is, the host and R2 are on the same subnetwork), then R1 will send a redirect message to inform the host that the best route for the destination is via R2. The host should then change its route information and send packets for that destination directly to R2. The router will still send the original datagram to the intended destination.9 However, if the datagram contains routing information, this message will not be sent even if a better route is available. RFC 1122 states that redirects should only be sent by gateways and should not be sent by Internet hosts.

Redirect message[2]: 11 
0001020304050607080910111213141516171819202122232425262728293031
Type = 5CodeChecksum
IP address
IP header and first 8 bytes of original datagram's data

Where:

Type must be set to 5.

Code specifies the reason for the redirection, and may be one of the following:

CodeDescription
0Redirect for Network
1Redirect for Host
2Redirect for Type of Service and Network
3Redirect for Type of Service and Host

IP address is the 32-bit address of the gateway to which the redirection should be sent.

IP header and additional data is included to allow the host to match the reply with the request that caused the redirection reply.

Time exceeded

Time Exceeded is generated by a gateway to inform the source of a discarded datagram due to the time to live field reaching zero. A time exceeded message may also be sent by a host if it fails to reassemble a fragmented datagram within its time limit.

Time exceeded messages are used by the traceroute utility to identify gateways on the path between two hosts.

Time exceeded message[2]: 5 
0001020304050607080910111213141516171819202122232425262728293031
Type = 11CodeChecksum
unused
IP header and first 8 bytes of original datagram's data

Where:

Type must be set to 11

Code specifies the reason for the time exceeded message, include the following:

CodeDescription
0Time-to-live exceeded in transit.
1Fragment reassembly time exceeded.

IP header and first 64 bits of the original payload are used by the source host to match the time exceeded message to the discarded datagram. For higher-level protocols such as UDP and TCP the 64-bit payload will include the source and destination ports of the discarded packet.

Timestamp

Timestamp is used for time synchronization. The originating timestamp is set to the time (in milliseconds since midnight) the sender last touched the packet. The receive and transmit timestamps are not used.

Timestamp message[2]: 15 
0001020304050607080910111213141516171819202122232425262728293031
Type = 13Code = 0Checksum
IdentifierSequence number
Originate timestamp
Receive timestamp
Transmit timestamp

Where:

Type must be set to 13

Code must be set to 0

Identifier and Sequence Number can be used by the client to match the timestamp reply with the timestamp request.

Originate timestamp is the number of milliseconds since midnight Universal Time (UT). If a UT reference is not available the most-significant bit can be set to indicate a non-standard time value.

Timestamp reply

Timestamp Reply replies to a Timestamp message. It consists of the originating timestamp sent by the sender of the Timestamp as well as a receive timestamp indicating when the Timestamp was received and a transmit timestamp indicating when the Timestamp reply was sent.

Timestamp reply message[2]: 15 
0001020304050607080910111213141516171819202122232425262728293031
Type = 14Code = 0Checksum
IdentifierSequence number
Originate timestamp
Receive timestamp
Transmit timestamp

Where:

Type must be set to 14

Code must be set to 0

Identifier and Sequence number can be used by the client to match the reply with the request that caused the reply.

Originate timestamp is the time the sender last touched the message before sending it.

Receive timestamp is the time the echoer first touched it on receipt.

Transmit timestamp is the time the echoer last touched the message on sending it.

All timestamps are in units of milliseconds since midnight UT. If the time is not available in milliseconds or cannot be provided with respect to midnight UT then any time can be inserted in a timestamp provided the high order bit of the timestamp is also set to indicate this non-standard value.

The use of Timestamp and Timestamp Reply messages to synchronize the clocks of Internet nodes has largely been replaced by the UDP-based Network Time Protocol and the Precision Time Protocol.10

Address mask request

Address mask request is normally sent by a host to a router in order to obtain an appropriate subnet mask.

Recipients should reply to this message with an Address mask reply message.

Address mask request
0001020304050607080910111213141516171819202122232425262728293031
Type = 17Code = 0Checksum
IdentifierSequence number
Address mask

Where:

Type must be set to 17

Code must be set to 0

Address mask can be set to 0

ICMP Address Mask Request may be used as a part of reconnaissance attack to gather information on the target network, therefore ICMP Address Mask Reply is disabled by default on Cisco IOS.11

Address mask reply

Address mask reply is used to reply to an address mask request message with an appropriate subnet mask.

Address mask reply
0001020304050607080910111213141516171819202122232425262728293031
Type = 18Code = 0Checksum
IdentifierSequence number
Address mask

Where:

Type must be set to 18

Code must be set to 0

Address mask should be set to the subnet mask

Destination unreachable

Destination unreachable is generated by the host or its inbound gateway1 to inform the client that the destination is unreachable for some reason. Reasons for this message may include: the physical connection to the host does not exist (distance is infinite); the indicated protocol or port is not active; the data must be fragmented but the ‘don’t fragment’ flag is on.12 Unreachable TCP ports notably respond with TCP RST rather than a destination unreachable type 3 as might be expected. Destination unreachable is never reported for IP multicast transmissions.

Destination unreachable message[2]: 4 [19]
OffsetOctet0123
OctetBit012345678910111213141516171819202122232425262728293031
00Type (3)CodeChecksum
432Unused(Length)(Next-hop MTU)
864IP header and first bytes of original datagram's data
5724576

With the following field contents:

Type: 8 bits; Type == 3

A value of 3 indicates ‘Destination unreachable’.

Code: 8 bits

This specifies the type of error, and can be any of the following:13

CodeDescription
0Network unreachable error.
1Host unreachable error.
2Protocol unreachable error (the designated transport protocol is not supported).
3Port unreachable error (the designated protocol is unable to inform the host of the incoming message).
4The datagram is too big. Packet fragmentation is required but the ‘don’t fragment’ (DF) flag is on.
5Source route failed error.
6Destination network unknown error.
7Destination host unknown error.
8Source host isolated error.
9The destination network is administratively prohibited.
10The destination host is administratively prohibited.
11The network is unreachable for Type Of Service.
12The host is unreachable for Type Of Service.
13Communication administratively prohibited (administrative filtering prevents packet from being forwarded).
14Host precedence violation (indicates the requested precedence is not permitted for the combination of host or network and port).
15Precedence cutoff in effect (precedence of datagram is below the level set by the network administrators).

Unused: 8 - 32 bits; Unused == 0

Unused, must be set to zero. If Length or Next-hop MTU are not used, they are considered part of this field.

Length: 8 bits

Optional. The Length field indicates the length of the original datagram data, in 32-bit words. This allows this ICMP message to be extended with extra information. If used, the original datagram data must be padded with zeroes to the nearest 32-bit boundary.

Next-hop MTU: 16 bits

Optional. Contains the MTU of the next-hop network if a code 4 error occurs.

IP header and data: 20 - 568 bytes

The IP header (20 bytes) and at most 548 bytes of the start of the original datagram (as not to exceed the minimum IPv4 reassembly buffer size). If this message is extended then this field must contain at least 128 bytes of original datagram data (padded with zeroes if necessary).
These data are included to allow the client to match the reply with the request that caused the Destination unreachable reply.

Extensions

ICMP messages can be extended with extra information. This information is carried in one or more Extension Objects, which are preceded by an ICMP Extension Header.14

ICMP Extension Header
OffsetOctet0123
OctetBit012345678910111213141516171819202122232425262728293031
00VersionReservedChecksum
432Extension Objects
864

Version: 4 bits; Version == 2

Extension header version.

Reserved: 12 bits; Reserved == 0

Reserved.

Checksum: 16 bits

Checksum over this header and all extension objects. This field itself is included, so it is set to zero while performing the calculation.

Extension objects have the following general structure:

Extension object header
OffsetOctet0123
OctetBit012345678910111213141516171819202122232425262728293031
00LengthClass-NumC-Type
432(Object payload)
864

Length: 16 bits

The length of the object in octets, including the header.

Class-Num: 8 bits

Identifies the object’s class.

C-Type: 8 bits

Identifies the object’s subtype.

Object payload: Variable

Optional payload. If nonempty, it contains a data structure, which size is a multiple of 32 bits.

See also

References

Wikiversity has learning resources about Internet Control Message Protocol

Footnotes

  1. J. Postel (September 1981). INTERNET CONTROL MESSAGE PROTOCOL - DARPA INTERNET PROGRAM PROTOCOL SPECIFICATION. Network Working Group. doi:10.17487/RFC0792. STD 5. RFC 792. Internet Standard 5. Updates RFC 760, 777, IENs 109, 128. Updated by RFC 950, 4884, 6633 and 6918. 2 3

  2. Forouzan, Behrouz A. (2007). Data Communications And Networking (Fourth ed.). Boston: McGraw-Hill. pp. 621–630. ISBN 978-0-07-296775-3. 2 3 4

  3. A. Conta; S. Deering (March 2006). M. Gupta (ed.). Internet Control Message Protocol (ICMPv6) for the Internet Protocol Version 6 (IPv6) Specification. Network Working Group. doi:10.17487/RFC4443. STD 89. RFC 4443. Internet Standard 89. Obsoletes RFC 2463. Updates RFC 2780. Updated by RFC 4884.

  4. “The OSI Model’s Seven Layers Defined and Functions Explained”. Microsoft Support. Retrieved 2014-12-28.

  5. “Protocol Numbers”. Internet Assigned Numbers Authority. Retrieved 2011-06-23.

  6. R. Braden; D. Borman; C. Partridge (September 1988). Computing the Internet Checksum. Network Working Group. doi:10.17487/RFC1071. RFC 1071. Informational. Updated by RFC 1141.

  7. F. Baker, ed. (June 1995). Requirements for IP Version 4 Routers. Network Working Group. doi:10.17487/RFC1812. RFC 1812. Proposed Standard. Obsoletes RFC 1716 and 1009. Updated by RFC 2644 and 6633.

  8. F. Gont (May 2012). Deprecation of ICMP Source Quench Messages. Internet Engineering Task Force. doi:10.17487/RFC6633. ISSN 2070-1721. RFC 6633. Proposed Standard. Updates RFC 792, 1122 and 1812.

  9. “When Are ICMP Redirects Sent?“. Cisco Systems. 2008-06-28. Retrieved 2013-08-15.

  10. D.L. Mills (September 1985). Network Time Protocol (NTP). doi:10.17487/RFC0958. RFC 958. It is evolved from the Time Protocol and the ICMP Timestamp message and is a suitable replacement for both.

  11. “Cisco IOS IP Command Reference, Volume 1 of 4: Addressing and Services, Release 12.3 - IP Addressing and Services Commands: ip mask-reply through ip web-cache”. Cisco Systems. Archived from the original on 2013-01-02. Retrieved 2013-01-07.

  12. J. Mogul; S. Deering (November 1990). Path MTU Discovery. Network Working Group. doi:10.17487/RFC1191. RFC 1191. Draft Standard. Obsoletes RFC 1063.

  13. “IANA ICMP Parameters”. Iana.org. 2012-09-21. Retrieved 2013-01-07.

  14. R. Bonica; D. Gan; D. Tappan; C. Pignataro (April 2007). Extended ICMP to Support Multi-Part Messages. Network Working Group. doi:10.17487/RFC4884. RFC 4884. Proposed Standard. Updates RFC 792 and 4443. Updated by RFC 8335.