DARPA Internet gateway
RFC 823
This RFC was published on the Legacy stream.
This RFC is not endorsed by the IETF and has no formal standing in the
IETF standards process.
Document | Type | RFC - Historic (September 1982) Errata | |
---|---|---|---|
Author | Bob Hinden | ||
Last updated | 2022-02-01 | ||
RFC stream | Legacy | ||
Formats | |||
IESG | Responsible AD | (None) | |
Send notices to | (None) |
RFC 823
Request for Comments: 823 Obsoletes IEN-30 and IEN-109 THE DARPA INTERNET GATEWAY RFC 823 Robert Hinden Alan Sheltzer Bolt Beranek and Newman Inc. 10 Moulton St. Cambridge, Massachusetts 02238 September 1982 Prepared for Defense Advanced Research Projects Agency Information Processing Techniques Office 1400 Wilson Boulevard Arlington, Virginia 22209 This RFC is a status report on the Internet Gateway developed by BBN. It describes the Internet Gateway as of September 1982. This memo presents detailed descriptions of message formats and gateway procedures, however this is not an implementation specification, and such details are subject to change. DARPA Internet Gateway September 1982 RFC 823 Table of Contents 1 INTRODUCTION.......................................... 1 2 BACKGROUND............................................ 2 3 FORWARDING INTERNET DATAGRAMS......................... 5 3.1 Input............................................... 5 3.2 IP Header Checks.................................... 6 3.3 Routing............................................. 7 3.4 Redirects........................................... 9 3.5 Fragmentation....................................... 9 3.6 Header Rebuild..................................... 10 3.7 Output............................................. 10 4 PROTOCOLS SUPPORTED BY THE GATEWAY................... 12 4.1 Cross-Net Debugging Protocol....................... 12 4.2 Host Monitoring Protocol........................... 12 4.3 ICMP............................................... 14 4.4 Gateway-to-Gateway Protocol........................ 14 4.4.1 Determining Connectivity to Networks............. 14 4.4.2 Determining Connectivity to Neighbors............ 16 4.4.3 Exchanging Routing Information................... 17 4.4.4 Computing Routes................................. 19 4.4.5 Non-Routing Gateways............................. 22 4.4.6 Adding New Neighbors and Networks................ 23 4.5 Exterior Gateway Protocol.......................... 24 5 GATEWAY SOFTWARE..................................... 26 5.1 Software Structure................................. 26 5.1.1 Device Drivers................................... 27 5.1.2 Network Software................................. 27 5.1.3 Shared Gateway Software.......................... 29 5.2 Gateway Processes.................................. 29 5.2.1 Network Processes................................ 29 5.2.2 GGP Process...................................... 30 5.2.3 HMP Process...................................... 31 APPENDIX A. GGP Message Formats.......................... 32 APPENDIX B. Information Maintained by Gateways........... 39 APPENDIX C. GGP Events and Responses..................... 41 REFERENCES............................................... 43 -i- DARPA Internet Gateway September 1982 RFC 823 1 INTRODUCTION This document explains the design of the Internet gateway used in the Defense Advanced Research Project Agency (DARPA) Internet program. The gateway design was originally documented in IEN-30, "Gateway Routing: An Implementation Specification" [2], and was later updated in IEN-109, "How to Build a Gateway" [3]. This document reflects changes made both in the internet protocols and in the gateway design since these documents were released. It supersedes both IEN-30 and IEN-109. The Internet gateway described in this document is based on the work of many people; in particular, special credit is given to V. Strazisar, M. Brescia, E. Rosen, and J. Haverty. The gateway's primary purpose is to route internet datagrams to their destination networks. These datagrams are generated and processed as described in RFC 791, "Internet Protocol - DARPA Internet Program Protocol Specification" [1]. This document describes how the gateway forwards datagrams, the routing algorithm and protocol used to route them, and the software structure of the current gateway. The current gateway implementation is written in macro-11 assembly language and runs in the DEC PDP-11 or LSI-11 16-bit processor. -1- DARPA Internet Gateway September 1982 RFC 823 2 BACKGROUND The gateway system has undergone a series of changes since its inception, and it is continuing to evolve as research proceeds in the Internet community. This document describes the implementation as of mid-1982. Early versions of gateway software were implemented using the BCPL language and the ELF operating system. This implementation evolved into one which used the MOS operating system for increased performance. In late 1981, we began an effort to produce a totally new gateway implementation. The primary motivation for this was the need for a system oriented towards the requirements of an operational communications facility, rather than the research testbed environment which was associated with the BCPL implementation. In addition, it was generally recognized that the complexity and buffering requirements of future gateway configurations were beyond the capabilities of the PDP-11/LSI-11 and BCPL architecture. The new gateway implementation therefore had a second goal of producing a highly space-efficient implementation in order to provide space for buffers and for the extra mechanisms, such as monitoring, which are needed for an operational environment. -2- DARPA Internet Gateway September 1982 RFC 823 This document describes the implementation of this new gateway which incorporates several mechanisms for operations activities, is coded in assembly language for maximum space- efficiency, but otherwise is fundamentally the same architecture as the older, research-oriented, implementations. One of the results of recent research is the thesis that gateways should be viewed as elements of a gateway system, where the gateways act as a loosely-coupled packet-switching communications system. For reasons of maintainability and operability, it is easiest to build such a system in an homogeneous fashion where all gateways are under a single authority and control, as is the practice in other network implementations. In order to create a system architecture that permitted multiple sets of gateways with each set under single control but acting together to implement a composite single Internet System, new protocols needed to be developed. These protocols, such as the "Exterior Gateway Protocol," will be introduced in the later releases of the gateway implementation. We also anticipate further changes to the gateway architecture and implementation to introduce support for new -3- DARPA Internet Gateway September 1982 RFC 823 capabilities, such as large numbers of networks, access control, and other requirements which have been proposed by the Internet research community. This document represents a snapshot of the current implementation, rather than a specification. -4- DARPA Internet Gateway September 1982 RFC 823 3 FORWARDING INTERNET DATAGRAMS This section describes how the gateway forwards datagrams between networks. A host computer that wants an IP datagram to reach a host on another network must send the datagram to a gateway to be forwarded. Before it is sent into the network, the host attaches to the datagram a local network header containing the address of the gateway. 3.1 Input When a gateway receives a message, the gateway checks the message's local network header for possible errors and performs any actions required by the host-to-network protocol. This processing involves functions such as verifying the local network header checksum or generating a local network acknowledgment message. If the header indicates that the message contains an Internet datagram, the datagram is passed to the Internet header check routine. All other messages received that do not pass these tests are discarded. -5- DARPA Internet Gateway September 1982 RFC 823 3.2 IP Header Checks The Internet header check routine performs a number of validity tests on the IP header. Datagrams that fail these tests are discarded causing an HMP trap to be sent to the Internet Network Operations Center (INOC) [7]. The following checks are currently performed: o Proper IP Version Number o Valid IP Header Length ( >= 20 bytes) o Valid IP Message Length o Valid IP Header Checksum o Non-Zero Time to Live field After a datagram passes these checks, its Internet destination address is examined to determine if the datagram is addressed to the gateway. Each of the gateway's internet addresses (one for each network interface) is checked against the destination address in the datagram. If a match is not found, the datagram is passed to the forwarding routine. If the datagram is addressed to the gateway itself, the IP options in the IP header are processed. Currently, the gateway supports the following IP options: -6- DARPA Internet Gateway September 1982 RFC 823 o NOP o End of Option List o Loose Source and Record Route o Strict Source and Record Route The datagram is next processed according to the protocol in the IP header. If the protocol is not supported by the gateway, it replies with an ICMP error message and discards the datagram. The gateway does not support IP reassembly, so fragmented datagrams which are addressed to the gateway are discarded. 3.3 Routing The gateway must make a routing decision for all datagrams that are to be to forwarded. The routing algorithm provides two pieces of information for the gateway: 1) the network interface that should be used to send this datagram and 2) the destination address that should be put in the local network header of the datagram. The gateway maintains a dynamic Routing Table which contains an entry for each reachable network. The entry consists of a network number and the address of the neighbor gateway on the shortest route to the network, or else an indication that the -7- DARPA Internet Gateway September 1982 RFC 823 gateway is directly connected to the network. A neighbor gateway is one which shares a common network with this gateway. The distance metric that is used to determine which neighbor is closest is defined as the "number of hops," where a gateway is considered to be zero hops from its directly connected networks, one hop from a network that is reachable via one other gateway, etc. The Gateway-to-Gateway Protocol (GGP) is used to update the Routing Table (see Section 4.4 describing the Gateway-to-Gateway Protocol). The gateway tries to match the destination network address in the IP header of the datagram to be forwarded, with a network in its Routing Table. If no match is found, the gateway drops the datagram and sends an ICMP Destination Unreachable message to the IP source. If the gateway does find an entry for the network in its table, it will use the network address of the neighbor gateway entry as the local network destination address of the datagram. However, if the final destination network is one that the gateway is directly connected to, the destination address in the local network header is created from the destination address in the IP header of the datagram. -8- DARPA Internet Gateway September 1982 RFC 823 3.4 Redirects If the routing procedure decides that an IP datagram is to be sent back out the same network interface that it was read in, then this gateway is not on the shortest path to the IP final destination. Nevertheless, the datagram will still be forwarded to the next address chosen by the routing procedure. If the datagram is not using the IP Source Route Option, and the IP source network of the datagram is the same as the network of the next gateway chosen by the routing procedure, an ICMP Redirect message will be sent to the IP source host indicating that another gateway should be used to send traffic to the final IP destination. 3.5 Fragmentation The datagram is passed to the fragmentation routine after the routing decision has been made. If the next network through which the datagram must pass has a maximum message size that is smaller than the size of the datagram, the datagram must be fragmented. Fragmentation is performed according to the algorithm described in the Internet Protocol Specification [1]. Certain IP options must be copied into the IP header of all -9- DARPA Internet Gateway September 1982 RFC 823 fragments, and others appear only in the first fragment according to the IP specification. If a datagram must be fragmented, but the Don't fragment bit is set, the datagram is discarded and an ICMP error message is sent to the IP source of the datagram. 3.6 Header Rebuild The datagram (or the fragments of the original datagram if fragmentation was needed) is next passed to a routine that rebuilds the Internet header. The Time to Live field is decremented by one and the IP checksum is recomputed. The local network header is now built. Using the information obtained from its routing procedure, the gateway chooses the network interface it considers proper to send the datagram and to build the destination address in the local network header. 3.7 Output The datagram is now enqueued on an output queue for delivery towards its destination. A limit is enforced on the size of the output queue for each network interface so that a slow network -10- DARPA Internet Gateway September 1982 RFC 823 does not unfairly use up all of the gateway's buffers. If a datagram cannot be enqueued due to the limit on the output queue length, it is dropped and an HMP trap is sent to the INOC. These traps, and others of a similar nature, are used by operational personnel to monitor the operations of the gateways. -11- DARPA Internet Gateway September 1982 RFC 823 4 PROTOCOLS SUPPORTED BY THE GATEWAY A number of protocols are supported by the gateway to provide dynamic routing, monitoring, debugging, and error reporting. These protocols are described below. 4.1 Cross-Net Debugging Protocol The Cross-Net Debugging Protocol (XNET) [8] is used to load the gateway and to examine and deposit data. The gateway supports the following XNET op-codes: o NOP o Debug o End Debug o Deposit o Examine o Create Process 4.2 Host Monitoring Protocol The Host Monitoring Protocol (HMP) [6] is used to collect measurements and status information from the gateways. Exceptional conditions in the gateways are reported in HMP traps. The status of a gateway's interfaces, neighbors, and the networks which it can reach are reported in the HMP status message. -12- DARPA Internet Gateway September 1982 RFC 823 Two types of gateway statistics, the Host Traffic Matrix and the gateway throughput, are currently defined by the HMP. The Host Traffic Matrix records the number of datagrams that pass through the gateway with a given IP source, destination, and protocol number. The gateway throughput message collects a number of important counters that are kept by the gateway. The current gateway reports the following values: o Datagrams dropped because destination net unreachable o Datagrams dropped because destination host unreachable o Per Interface: Datagrams received with IP errors Datagrams received for this gateway Datagrams received to be forwarded Datagrams looped Bytes received Datagrams sent, originating at this gateway Datagrams sent to destination hosts Datagrams dropped due to flow control limitations Datagrams dropped due to full queue Bytes sent o Per Neighbor: Routing updates sent to Routing updates received from Datagrams sent, originating here Datagrams forwarded to Datagrams dropped due to flow control limitations Datagrams dropped due to full queue Bytes sent -13- DARPA Internet Gateway September 1982 RFC 823 4.3 ICMP The gateway will generate the following ICMP messages under appropriate circumstances as defined by the ICMP specification [4]: o Echo Reply o Destination Unreachable o Source Quench o Redirect o Time Exceeded o Parameter Problem o Information Reply 4.4 Gateway-to-Gateway Protocol The gateway uses the Gateway-to-Gateway Protocol (GGP) to determine connectivity to networks and neighbor gateways; it is also used in the implementation of a dynamic, shortest-path routing algorithm. The current GGP message formats (for release 1003 of the gateway software) are presented in Appendix A. 4.4.1 Determining Connectivity to Networks When a gateway starts running it assumes that all its neighbor gateways are "down," that it is disconnected from -14- DARPA Internet Gateway September 1982 RFC 823 networks to which it is attached, and that the distance reported in routing updates from each neighbor to each network is "infinity." The gateway first determines the state of its connectivity to networks to which it is physically attached. The gateway's connection to a network is declared up if it can send and receive internet datagrams on its interface to that network. Note that the method that the gateway uses to determine its connectivity to a network is network-dependent. In some networks, the host-to- network protocol determines whether or not datagrams can be sent and received on the host interface. In these networks, the gateway simply checks-status information provided by the protocol in order to determine if it can communicate with the network. In other networks, where the host-to-network protocols are less sophisticated, it may be necessary for the gateway to send datagrams to itself to determine if it can communicate with the network. In these networks, the gateways periodically poll the network using GGP network interface status messages [Appendix A] to determine if the network interface is operational. The gateway has two rules relevant to computing distances to networks: 1) if the gateway can send and receive traffic on its -15- DARPA Internet Gateway September 1982 RFC 823 network interface, its distance to the network is zero; 2) if it cannot send and receive traffic on the interface, its distance to the network is "infinity." Note that if a gateway's network interface is not working, it may still be able to send traffic to the network on an alternate route via one of its neighbor gateways. 4.4.2 Determining Connectivity to Neighbors The gateway determines connectivity to neighbors using a "K out of N" algorithm. Every 15 seconds, the gateway sends GGP Echo messages [Appendix A] to each of its neighbors. The neighbors respond by sending GGP echo replies. If there is no reply to K out of N (current values are K=3 and N=4) echo messages sent to a neighbor, the neighbor is declared down. If a neighbor is down and J out of M (current values are J=2 and M=4) echo replies are received, the neighbor is declared to be up. The values of J,K,M,N and the time interval are operational parameters which can be adjusted as required. -16- DARPA Internet Gateway September 1982 RFC 823 4.4.3 Exchanging Routing Information The gateway sends routing information in GGP Routing Update messages. The gateway receives and transmits routing information reliably using sequence-numbered messages and a retransmission and acknowledgment scheme as explained below. For each neighbor, the gateway remembers the Receive Sequence Number, R, that it received in the most recent routing update from that neighbor. This value is initialized with the sequence number in the first Routing Update received from a neighbor after that neighbor's status is set to "up." On receipt of a routing update from a neighbor, the gateway subtracts the Receive Sequence Number, R, from the sequence number in the routing update, S. If this value (S-R) is greater than or equal to zero, then the gateway accepts the routing update, sends an acknowledgment (see Appendix A) to the neighbor containing the sequence number S, and replaces the Receive Sequence Number, R, with S. If this value (S-R) is less than zero, the gateway rejects the routing update and sends a negative acknowledgment [Appendix A] to the neighbor with sequence number R. The gateway has a Send Sequence Number, N, for sending routing updates to all of its neighbors. This sequence number -17- DARPA Internet Gateway September 1982 RFC 823 can be initialized to any value. The Send Sequence Number is incremented each time a new routing update is created. On receiving an acknowledgment for a routing update, the gateway subtracts the sequence number acknowledged, A, from the Send Sequence Number, N. If the value (N-A) is non-zero, then an old routing update is being acknowledged. The gateway continues to retransmit the most recent routing update to the neighbor that sent the acknowledgment. If (N-A) is zero, the routing update has been acknowledged. Note that only the most recent routing update must be acknowledged; if a second routing update is generated before the first routing update is acknowledged, only the second routing update must be acknowledged. If a negative acknowledgment is received, the gateway subtracts the sequence number negatively acknowledged, A, from its Send Sequence Number, N. If this value (N-A) is less than zero, then the gateway replaces its Send Sequence Number, N, with the sequence number negatively acknowledged plus one, A+1, and retransmits the routing update to all of its neighbors. If (N-A) is greater than or equal to zero, then the gateway continues to retransmit the routing update using sequence number N. In order to maintain the correct sequence numbers at all gateways, routing updates must be retransmitted to all neighbors if the Send -18- DARPA Internet Gateway September 1982 RFC 823 Sequence Number changes, even if the routing information does not change. The gateway retransmits routing updates periodically until they are acknowledged and whenever its Send Sequence Number changes. The gateway sends routing updates only to neighbors that are in the "up" state. 4.4.4 Computing Routes A routing update contains a list of networks that are reachable through this gateway, and the distance in "number of hops" to each network mentioned. The routing update only contains information about a network if the gateway believes that it is as close or closer to that network then the neighbor which is to receive the routing update. The network address may be an internet class A, B, or C address. The information inside a routing update is processed as follows. The gateway contains an N x K distance matrix, where N is the number of networks and K is the number of neighbor gateways. An entry in this matrix, represented as dm(I,J), is the distance to network I from neighbor J as reported in the most -19- DARPA Internet Gateway September 1982 RFC 823 recent routing update from neighbor J. The gateway also contains a vector indicating the connectivity between itself and its neighbor gateways. The values in this vector are computed as discussed above (see Section 4.4.2, Determining Connectivity to Neighbors). The value of the Jth entry of this vector, which is the connectivity between the gateway and the Jth neighbor, is represented as d(J). The gateway copies the routing update received from the Jth neighbor into the appropriate row of the distance matrix, then updates its routes as follows. The gateway calculates a minimum distance vector which contains the minimum distance to each network from the gateway. The Ith entry of this vector, represented as MinD(I) is: MinD(I) = minimum over all neighbors of d(J) + dm(I,J) where d(J) is the distance between the gateway and the Jth neighbor, and dm(I,J) is the distance from the Jth neighbor to the Ith network. If the Ith network is attached to the gateway and the gateway can send and receive traffic on its network interface (see Section 4.4.2), then the gateway sets the Ith entry of the minimum distance vector to zero. -20- DARPA Internet Gateway September 1982 RFC 823 Using the minimum distance vector, the gateway computes a list of neighbor gateways through which to send traffic to each network. The entry for a given network contains one of the neighbors that is the minimum distance away from that network. After updating its routes to the networks, the gateway computes the new routing updates to be sent to its neighbors. The gateway reports a network to a neighbor only if it is as close to or closer to that network than its neighbor. For each network I, the routing update contains the address of the network and the minimum distance to that network which is MinD(I). Finally, the gateway must determine whether it should send routing updates to its neighbors. The gateway sends new updates to its neighbors if every one of the following three conditions occurs: 1) one of the gateway's interfaces changes state, 2) one of the gateway's neighbor gateways changes state, and 3) the gateway receives a routing update from a neighbor that is different from the update that it had previously received from that neighbor. The gateway sends routing updates only to neighbors that are currently in the "up" state. The gateway requests a routing update from neighbors that are in the "up" state, but from which it has yet received a -21- DARPA Internet Gateway September 1982 RFC 823 routing update. Routing updates are requested by setting the appropriate bit in the routing update being sent [Appendix A]. Similarly, if a gateway receives from a neighbor a routing update in which the bit requesting a routing update is set, the gateway sends the neighbor the most recent routing update. 4.4.5 Non-Routing Gateways A Non-routing Gateway is a gateway that forwards internet traffic, but does not implement the GGP routing algorithm. Networks that are behind a Non-routing Gateway are known a-priori to Routing Gateways. There can be one or more of these networks which are considered to be directly connected to the Non-routing Gateway. A Routing Gateway will forward a datagram to a Non- routing Gateway if it is addressed to a network behind the Non- routing Gateway. Routing Gateways currently do not send Redirects for Non-routing Gateways. A Routing Gateway will always use another Routing Gateway as a path instead of a Non- routing Gateways if both exist and are the same number of hops away from the destination network. The Non-routing Gateways path will be used only when the Routing Gateway path is down; when the Routing Gateway path comes back up, it will be used again. -22- DARPA Internet Gateway September 1982 RFC 823 4.4.6 Adding New Neighbors and Networks Gateways dynamically add routing information about new neighbors and new networks to their tables. The gateway maintains a list of neighbor gateway addresses. When a routing update is received, the gateway searches this list of addresses for the Internet source address of the routing update message. If the Internet source address of the routing update is not contained in the list of neighbor addresses, the gateway adds this address to the list of neighbor addresses and sets the neighbor's connectivity status to "down." Routing updates are not accepted from neighbors until the GGP polling mechanism has determined that the neighbor is up. This strategy of adding new neighbors requires that one gateway in each pair of neighbor gateways must have the neighbor's address configured in its tables. The newest gateway can be given a complete list of neighbors, thus avoiding the need to re-configure older gateways when new gateways are installed. Gateways obtain routing information about new networks in several steps. The gateway has a list of all the networks for which it currently maintains routing information. When a routing update is received, if the routing update contains information -23- DARPA Internet Gateway September 1982 RFC 823 about a new network, the gateway adds this network to the list of networks for which it maintains routing information. Next, the gateway adds the new network to its distance matrix. The distance matrix comprises the is the matrix of distances (number of hops) to networks as reported in routing updates from the neighbor gateways. The gateway sets the distance to all new networks to "infinity," and then computes new routes and new routing updates as outlined above. 4.5 Exterior Gateway Protocol The Exterior Gateway Protocol (EGP) is used to permit other gateways and gateway systems to pass routing information to the DARPA Internet gateways. The use of the EGP permits the user to perceive all of the networks and gateways as part of one total Internet system, even though the "exterior" gateways are disjoint and may use a routing algorithm that is different and not compatible with that used in the "interior" gateways. The important elements of the EGP are: o Neighbor Acquisition The procedure by which a gateway requests that it become a neighbor of another gateway. This is used when a gateway wants to become a neighbor of another in order to pass -24- DARPA Internet Gateway September 1982 RFC 823 routing information. This includes the capability to accept or refuse the request. o Neighbor Up/Down The procedure by which a gateway decides if another gateway is up or down. o Network Reachability Information The facility used to pass routing and neighbor information between gateways. o Gateway Going Down The ability of a gateway to inform other gateways that it is going down and no longer has any routes to any other networks. This permits a gateway to go down in an orderly way without disrupting the rest of the Internet system. A complete description of the EGP can be found in IEN-209, the "Exterior Gateway Protocol" [10]. -25- DARPA Internet Gateway September 1982 RFC 823 5 GATEWAY SOFTWARE The DARPA Internet Gateway runs under the MOS operating system [9] which provides facilities for: o Multiple processes o Interprocess communication o Buffer management o Asynchronous input/output o Shareable real-time clock There is a MOS process for each network that the gateway is directly connected to. A data structure called a NETBLOCK contains variables of interest for each network and pointers to local network routines. Network processes run common gateway code while network-specific functions are dispatched to the routines pointed to in the NETBLOCK. There are also processes for gateway functions which require their own timing, such as GGP and HMP. 5.1 Software Structure The gateway software can be divided conceptually into three parts: MOS Device Drivers, Network software, and Shared Gateway software. -26- DARPA Internet Gateway September 1982 RFC 823 5.1.1 Device Drivers The gateway has a set of routines to handle sending and receiving data for each type of hardware interface. There are routines for initialization, initiation, and interruption for both the transmit and receive sides of a device. The gateway supports the following types of devices: a) ACC LSI-11 1822 b) DEC IMP11a 1822 c) ACC LHDH 1822 d) ACC VDH11E e) ACC VDH11C f) Proteon Ring Network g) RSRE HDLC h) Interlan Ethernet i) BBN Fibernet j) ACC XQ/CP X.25 ** k) ACC XQ/CP HDH ** 5.1.2 Network Software For each connected network, the gateway has a set of eight routines which handle local network functions. The network routines and their functions are described briefly below. _______________ ** Planned, not yet supported. -27- DARPA Internet Gateway September 1982 RFC 823 Up.net Perform local network initialization such as flapping the 1822 ready line. Sg.net Handle specific local network timing functions such as timing out 1822 Destination Deads. Rc.net A message has been received from the network interface. Check for any input errors. Wc.net A message has been transmitted to the network interface. Check for any output errors. Rs.net Set up a buffer (or buffers) to receive messages on the network interface. Ws.net Transmit a message to the network interface. Hc.net Check the local network header of the received message. Perform any local network protocol tasks. Hb.net Rebuild the local network header. There are network routines for the following types of networks: o Arpanet (a,b,c,k) o Satnet (d,e,k) o Proteon Ring Network (f) o Packet Radio Network (a,b,c) o Rsre HDLC Null Network (g) o Ethernet (h) o Fibernet (i) o Telenet X.25 (j) ** Note: The letters in parentheses refer to the device drivers used _______________ ** Planned, not yet supported. -28- DARPA Internet Gateway September 1982 RFC 823 for each type of network as described in the previous section. 5.1.3 Shared Gateway Software The internet processing of a datagram is performed by a body of code which is shared by the network processes. This code includes routines to check the IP header, perform IP fragmentation, calculate the IP checksum, forward a datagram, and implement the routing, monitoring, and error reporting protocols. 5.2 Gateway Processes 5.2.1 Network Processes When the gateway starts up, each network process calls its local network initialization routine and read start routine. The read start routine sets up two maximum network size buffers for receiving datagrams. The network process then waits for an input complete signal from the network device driver. When a message has been received, the MOS Operating System signals the appropriate network process with an input complete signal. The network process wakes up and executes the net read -29- DARPA Internet Gateway September 1982 RFC 823 complete routine. After the message has been processed, the network process waits for more input. The net read complete routine is the major message processing loop in the gateway. The following actions are performed when a message has been received: o Call Local Network Read Complete Routine o Start more reads o Check local Network Header o Check Internet header o Check if datagram is for the gateway o Forward the datagram if necessary o Send ICMP error message if necessary. 5.2.2 GGP Process The GGP process periodically sends GGP echos to each of the gateway's neighbors to determine neighbor connectivity, and sends interface status messages addressed to itself to determine network connectivity. The GGP process also sends out routing updates when necessary. The details of the algorithms currently implemented by the GGP process are given in Section 4.4, Gateway-to-Gateway Protocol, and in Appendix C. -30- DARPA Internet Gateway September 1982 RFC 823 5.2.3 HMP Process The HMP process handles timer-based gateway statistics collection and the periodic transmission of traps. -31- DARPA Internet Gateway September 1982 RFC 823 APPENDIX A. GGP Message Formats Note that the GGP protocol is currently undergoing extensive changes to introduce the Exterior Gateway Protocol facility; this is the vehicle needed to permit gateways in other systems to exchange routing information with the gateways described in this document. Each GGP message consists of an Internet header followed by one of the messages explained below. The values (in decimal) in the Internet header used in a GGP message are as follows. Version 4. IHL Internet header length in 32-bit words. Type of Service 0. Total Length Length of Internet header and data in octets. ID, Flags, Fragment Offset 0. Time to Live Time to live in seconds. This field is decremented at least once by each machine that processes the datagram. Protocol Gateway Protocol = 3. Header Checksum The 16 bit one's complement of the one's complement sum of all 16-bit words in the header. For computing the checksum, the checksum field should be zero. -32- DARPA Internet Gateway September 1982 RFC 823 Source Address The address of the gateway's interface from which the message is sent. Destination Address The address of the gateway to which the message is sent. -33- DARPA Internet Gateway September 1982 RFC 823 ROUTING UPDATE 0 1 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ !Gateway Type ! unused (0) ! ; 2 bytes +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ ! Sequence Number ! ; 2 bytes +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ ! need-update ! n-distances ! ; 2 bytes +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ ! distance 1 ! n1-dist ! ; 2 bytes +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ ! net11 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! ; 1, 2 or 3 +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ ; bytes ! net12 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! ; 1, 2 or 3 +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ ; bytes . . +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ ! net1n1 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! ; n1 nets at +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ ; dist 1 . ... . ; ndist groups +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ ; of nets ! distance n ! nn-dist ! ; 2 bytes +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ ! netn1 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! ; 1, 2 or 3 +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ ; bytes ! netn2 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! ; 1, 2 or 3 +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ ; bytes . . +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ ! netnnn !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! ; nn nets at +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ ; dist n Gateway Type 12 (decimal) Sequence Number The 16-bit sequence number used to identify routing updates. need-update An 8-bit field. This byte is set to 1 -34- DARPA Internet Gateway September 1982 RFC 823 if the source gateway requests a routing update from the destination gateway, and set to 0 if not. n-distances An 8-bit field. The number of distance-groups reported in this update. Each distance-group consists of a distance value and a number of nets, followed by the actual net numbers which are reachable at that distance. Not all distances need be reported. distance 1 hop count (or other distance measure) which applies to this distance-group. n1-dist number of nets which are reported in this distance-group. net11 1, 2, or 3 bytes for the first net at distance "distance 1". net12 second net ... net1n1 etc. -35- DARPA Internet Gateway September 1982 RFC 823 ACKNOWLEDGMENT or NEGATIVE ACKNOWLEDGMENT 0 1 2 3 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | Gateway Type | Unused | Sequence number | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ Gateway Type Acknowledgments are type 2. Negative acknowledgments are type 10. Sequence Number The 16-bit sequence number that the gateway is acknowledging or negatively acknowledging. -36- DARPA Internet Gateway September 1982 RFC 823 GGP ECHO and ECHO REPLY 0 1 2 3 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | Gateway Type | Unused | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ Gateway Type 8 for echo message; 0 for echo reply. Source Address In an echo message, this is the address of the gateway on the same network as the neighbor to which it is sending the echo message. In an echo reply message, the source and destination addresses are simply reversed, and the remainder is returned unchanged. -37- DARPA Internet Gateway September 1982 RFC 823 NETWORK INTERFACE STATUS 0 1 2 3 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ ! Gateway Type ! unused ! +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ Gateway Type 9 Source Address Destination Address The address of the gateway's network interface. The gateway can send Net Interface Status messages to itself to determine if it is able to send and receive traffic on its network interface. -38- DARPA Internet Gateway September 1982 RFC 823 APPENDIX B. Information Maintained by Gateways In order to implement the shortest-path routing algorithm, gateways must maintain information about their connectivity to networks and other gateways. This section explains the information maintained by each gateway; this information can be organized into the following tables and variables. o Number of Networks The number of networks for which the gateway maintains routing information and to which it can forward traffic. o Number of Neighbors The number of neighbor gateways with which the gateway exchanges routing information. o Gateway Addresses The addresses of the gateway's network interfaces. o Neighbor Gateway Addresses The address of each neighbor gateway's network interface that is on the same network as this gateway. o Neighbor Connectivity Vector A vector of the connectivity between this gateway and each of its neighbors. o Distance Matrix A matrix of the routing updates received from the neighbor gateways. -39- DARPA Internet Gateway September 1982 RFC 823 o Minimum Distance Vector A vector containing the minimum distance to each network. o Routing Updates from Non-Routing Gateways The routing updates that would have been received from each non-routing neighbor gateway which does not participate in this routing strategy. o Routing Table A table containing, for each network, a list of the neighbor gateways on a minimum-distance route to the network. o Send Sequence Number The sequence number that will be used to send the next routing update. o Receive Sequence Numbers The sequence numbers that the gateway received in the last routing update from each of its neighbors. o Received Acknowledgment Vector A vector indicating whether or not each neighbor has acknowledged the sequence number in the most recent routing update sent. -40- DARPA Internet Gateway September 1982 RFC 823 APPENDIX C. GGP Events and Responses The following list shows the GGP events that occur at a gateway and the gateway's responses. The variables and tables referred to are listed above. o Connectivity to an attached network changes. a. Update the Minimum Distance Vector. b. Recompute the Routing Updates. c. Recompute the Routing Table. d. If any routing update has changed, send the new routing updates to the neighbors. o Connectivity to a neighbor gateway changes. a. Update the Neighbor Connectivity Vector. b. Recompute the Minimum Distance Vector. c. Recompute the Routing Updates. d. Recompute the Routing Table. e. If any routing update has changed, send the new routing updates to the neighbors. o A Routing Update message is received. a. Compare the Internet source address of the Routing Update message to the Neighbor Addresses. If the address is not on the list, add it to the list of Neighbor Addresses, increment the Number of Neighbors, and set the Receive Sequence Number for this neighbor to the sequence number in the Routing Update message. b. Compare the Receive Sequence Number for this neighbor to the sequence number in the Routing Update message to determine whether or not to accept this message. If the message is rejected, send a Negative Acknowledgment message. If the message is accepted, send an Acknowledgment message and proceed with the following steps. -41- DARPA Internet Gateway September 1982 RFC 823 c. Compare the networks reported in the Routing Update message to the Number of Networks. If new networks are reported, enter them in the network vectors, increase the number of networks, and expand the Distance Matrix to account for the new networks. d. Copy the routing update received into the appropriate row of the Distance Matrix. e. Recompute the Minimum Distance Vector. f. Recompute the Routing Updates. g. Recompute the Routing Table. h. If any routing update has changed, send the new routing updates to the neighbors. o An Acknowledgment message is received. Compare the sequence number in the message to the Send Sequence Number. If the Send Sequence Number is acknowledged, update the entry in the Received Acknowledgment Vector for the neighbor that sent the acknowledgment. o A Negative Acknowledgment message is received. Compare the sequence number in the message to the Send Sequence Number. If necessary, replace the Send Sequence Number, and retransmit the routing updates. -42- DARPA Internet Gateway September 1982 RFC 823 REFERENCES [1] Postel, J. (ed.), "Internet Protocol - DARPA Internet Program Protocol Specification," RFC 791, USC/Information Sciences Institute, September 1981. [2] Strazisar, V., "Gateway Routing: An Implementation Specification," IEN-30, Bolt Beranek and Newman Inc., August 1979. [3] Strazisar, V., "How to Build a Gateway," IEN-109, Bolt Beranek and Newman Inc., August 1979. [4] Postel, J., "Internet Control Message Protocol - DARPA Internet Program Protocol Specification," RFC 792, USC/Information Sciences Institute, September 1981. [5] Postel, J., "Assigned Numbers," RFC 790, USC/Information Sciences Institute, September 1981. [6] Littauer, B., Huang, A., Hinden, R., "A Host Monitoring Protocol," IEN-197, Bolt Beranek and Newman Inc., September 1981. [7] Santos, P., Chalstrom, H., Linn, J., Herman, J., "Architecture of a Network Monitoring, Control and Management System," Proc. of the 5th Int. Conference on Computer Communication, October 1980. [8] Haverty, J., "XNET Formats for Internet Protocol Version 4," IEN-158, Bolt Beranek and Newman Inc., October 1980. [9] Mathis, J., Klemba, K., Poggio, "TIU Notebook- Volume 2, Software Documentation," SRI, May 1979. [10] Rosen, E., "Exterior Gateway Protocol," IEN-209, Bolt Beranek and Newman Inc., August 1982. -43-