Mobile Ad hoc Networking (MANET) T. Clausen Internet-Draft LIX, Ecole Polytechnique, France Expires: August 5, 2007 C. Dearlove BAE Systems Advanced Technology Centre P. Jacquet Project Hipercom, INRIA The OLSRv2 Design Team MANET Working Group February 2007 The Optimized Link State Routing Protocol version 2 draft-ietf-manet-olsrv2-03 Status of this Memo By submitting this Internet-Draft, each author represents that any 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 aware will be disclosed, in accordance with Section 6 of BCP 79. Internet-Drafts are working documents of the Internet Engineering Task Force (IETF), its areas, and its working groups. Note that other groups may also distribute working documents as Internet- Drafts. Internet-Drafts are draft documents valid for a maximum of six months and may be updated, replaced, or obsoleted by other documents at any time. It is inappropriate to use Internet-Drafts as reference material or to cite them other than as "work in progress." The list of current Internet-Drafts can be accessed at http://www.ietf.org/ietf/1id-abstracts.txt. The list of Internet-Draft Shadow Directories can be accessed at http://www.ietf.org/shadow.html. This Internet-Draft will expire on August 5, 2007. Copyright Notice Copyright (C) The IETF Trust (2007). Clausen, et al. Expires August 5, 2007 [Page 1] Internet-Draft OLSRv2 February 2007 Abstract This document describes version 2 of the Optimized Link State Routing (OLSRv2) protocol for mobile ad hoc networks. The protocol embodies an optimization of the classical link state algorithm tailored to the requirements of a mobile ad hoc network (MANET). The key optimization of OLSRv2 is that of multipoint relays, providing an efficient mechanism for network-wide broadcast of link state information (i.e. reducing the cost of performing a network- wide link state broadcast). A secondary optimization is that OLSRv2 employs partial link state information: each node maintains information about all destinations, but only a subset of links. Consequently, only selected nodes diffuse link state advertisements (thus reducing the number of network-wide link state broadcasts) and these advertisements contain only a subset of links (thus reducing the size of network-wide link state broadcasts). The partial link state information thus obtained still allows each OLSRv2 node to at all times maintain optimal (in terms of number of hops) routes to all destinations in the network. OLSRv2 imposes minimum requirements on the network by not requiring sequenced or reliable transmission of control traffic. Furthermore, the only interaction between OLSRv2 and the IP stack is routing table management. OLSRv2 is particularly suitable for large and dense networks as the technique of MPRs works well in this context. Clausen, et al. Expires August 5, 2007 [Page 2] Internet-Draft OLSRv2 February 2007 Table of Contents 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 6 2. Terminology . . . . . . . . . . . . . . . . . . . . . . . . . 7 3. Applicability Statement . . . . . . . . . . . . . . . . . . . 8 4. Protocol Overview and Functioning . . . . . . . . . . . . . . 9 5. Local Information Base . . . . . . . . . . . . . . . . . . . . 11 5.1. Local Attached Network Set . . . . . . . . . . . . . . . . 11 6. Processing and Forwarding Repositories . . . . . . . . . . . . 12 6.1. Received Set . . . . . . . . . . . . . . . . . . . . . . . 12 6.2. Processed Set . . . . . . . . . . . . . . . . . . . . . . 12 6.3. Forwarded Set . . . . . . . . . . . . . . . . . . . . . . 13 6.4. Relay Set . . . . . . . . . . . . . . . . . . . . . . . . 13 7. Packet Processing and Message Forwarding . . . . . . . . . . . 14 7.1. Actions when Receiving an OLSRv2 Packet . . . . . . . . . 14 7.2. Actions when Receiving an OLSRv2 Message . . . . . . . . . 14 7.3. Message Considered for Processing . . . . . . . . . . . . 15 7.4. Message Considered for Forwarding . . . . . . . . . . . . 15 8. Information Repositories . . . . . . . . . . . . . . . . . . . 18 8.1. Neighborhood Information Base . . . . . . . . . . . . . . 18 8.1.1. Link Set . . . . . . . . . . . . . . . . . . . . . . . 18 8.1.2. MPR Set . . . . . . . . . . . . . . . . . . . . . . . 18 8.1.3. MPR Selector Set . . . . . . . . . . . . . . . . . . . 19 8.2. Topology Information Base . . . . . . . . . . . . . . . . 19 8.2.1. Advertised Neighbor Set . . . . . . . . . . . . . . . 19 8.2.2. ANSN History Set . . . . . . . . . . . . . . . . . . . 20 8.2.3. Topology Set . . . . . . . . . . . . . . . . . . . . . 20 8.2.4. Attached Network Set . . . . . . . . . . . . . . . . . 20 8.2.5. Routing Set . . . . . . . . . . . . . . . . . . . . . 21 9. Control Message Structures . . . . . . . . . . . . . . . . . . 22 9.1. HELLO Messages . . . . . . . . . . . . . . . . . . . . . . 22 9.1.1. HELLO Message TLVs . . . . . . . . . . . . . . . . . . 23 9.1.2. HELLO Message Address Block TLVs . . . . . . . . . . . 23 9.2. TC Messages . . . . . . . . . . . . . . . . . . . . . . . 24 9.2.1. TC Message TLVs . . . . . . . . . . . . . . . . . . . 24 9.2.2. TC Message Address Block TLVs . . . . . . . . . . . . 25 10. HELLO Message Generation . . . . . . . . . . . . . . . . . . . 26 10.1. HELLO Message: Transmission . . . . . . . . . . . . . . . 26 11. HELLO Message Processing . . . . . . . . . . . . . . . . . . . 27 11.1. Populating the MPR Selector Set . . . . . . . . . . . . . 27 11.2. Symmetric Neighborhood and 2-Hop Neighborhood Changes . . 28 12. TC Message Generation . . . . . . . . . . . . . . . . . . . . 29 12.1. TC Message: Transmission . . . . . . . . . . . . . . . . . 30 13. TC Message Processing . . . . . . . . . . . . . . . . . . . . 32 13.1. Initial TC Message Processing . . . . . . . . . . . . . . 32 13.1.1. Populating the ANSN History Set . . . . . . . . . . . 32 13.1.2. Populating the Topology Set . . . . . . . . . . . . . 33 13.1.3. Populating the Attached Network Set . . . . . . . . . 34 Clausen, et al. Expires August 5, 2007 [Page 3] Internet-Draft OLSRv2 February 2007 13.2. Completing TC Message Processing . . . . . . . . . . . . . 34 13.2.1. Purging the Topology Set . . . . . . . . . . . . . . . 35 13.2.2. Purging the Attached Network Set . . . . . . . . . . . 35 14. Populating the MPR Set . . . . . . . . . . . . . . . . . . . . 36 15. Populating Derived Sets . . . . . . . . . . . . . . . . . . . 37 15.1. Populating the Relay Set . . . . . . . . . . . . . . . . . 37 15.2. Populating the Advertised Neighbor Set . . . . . . . . . . 37 16. Routing Table Calculation . . . . . . . . . . . . . . . . . . 38 17. Proposed Values for Constants . . . . . . . . . . . . . . . . 42 17.1. Neighborhood Discovery Constants . . . . . . . . . . . . . 42 17.2. Message Intervals . . . . . . . . . . . . . . . . . . . . 42 17.3. Holding Times . . . . . . . . . . . . . . . . . . . . . . 42 17.4. Jitter Times . . . . . . . . . . . . . . . . . . . . . . . 42 17.5. Willingness . . . . . . . . . . . . . . . . . . . . . . . 42 18. Sequence Numbers . . . . . . . . . . . . . . . . . . . . . . . 43 19. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 44 19.1. Message Types . . . . . . . . . . . . . . . . . . . . . . 44 19.2. TLV Types . . . . . . . . . . . . . . . . . . . . . . . . 44 20. References . . . . . . . . . . . . . . . . . . . . . . . . . . 46 20.1. Normative References . . . . . . . . . . . . . . . . . . . 46 20.2. Informative References . . . . . . . . . . . . . . . . . . 46 Appendix A. Node Configuration . . . . . . . . . . . . . . . . . 47 Appendix B. Protocol and Port Number . . . . . . . . . . . . . . 48 Appendix C. Example Heuristic for Calculating MPRs . . . . . . . 49 Appendix D. Packet and Message Layout . . . . . . . . . . . . . 52 Appendix D.1. Packet and Message Options . . . . . . . . . . . . . 52 Appendix D.2. Example HELLO Message . . . . . . . . . . . . . . . 54 Appendix D.3. Example TC Message . . . . . . . . . . . . . . . . . 55 Appendix E. Time TLVs . . . . . . . . . . . . . . . . . . . . . 58 E.1. Representing Time . . . . . . . . . . . . . . . . . . . . 58 E.2. General Time TLV Structure . . . . . . . . . . . . . . . . 58 E.3. Message TLVs . . . . . . . . . . . . . . . . . . . . . . . 60 E.3.1. VALIDITY_TIME TLV . . . . . . . . . . . . . . . . . . 60 E.3.2. INTERVAL_TIME TLV . . . . . . . . . . . . . . . . . . 60 Appendix F. Message Jitter . . . . . . . . . . . . . . . . . . . 61 F.1. Jitter . . . . . . . . . . . . . . . . . . . . . . . . . . 61 F.1.1. Periodic message generation . . . . . . . . . . . . . 61 F.1.2. Externally triggered message generation . . . . . . . 62 F.1.3. Message forwarding . . . . . . . . . . . . . . . . . . 63 F.1.4. Maximum Jitter Determination . . . . . . . . . . . . . 64 Appendix G. Security Considerations . . . . . . . . . . . . . . 65 Appendix G.1. Confidentiality . . . . . . . . . . . . . . . . . . 65 Appendix G.2. Integrity . . . . . . . . . . . . . . . . . . . . . 65 Appendix G.3. Interaction with External Routing Domains . . . . . 66 Appendix G.4. Node Identity . . . . . . . . . . . . . . . . . . . 67 Appendix H. Flow and Congestion Control . . . . . . . . . . . . 68 Appendix I. Contributors . . . . . . . . . . . . . . . . . . . . 69 Appendix J. Acknowledgements . . . . . . . . . . . . . . . . . . 70 Clausen, et al. Expires August 5, 2007 [Page 4] Internet-Draft OLSRv2 February 2007 Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . . 71 Intellectual Property and Copyright Statements . . . . . . . . . . 72 Clausen, et al. Expires August 5, 2007 [Page 5] Internet-Draft OLSRv2 February 2007 1. Introduction The Optimized Link State Routing protocol version 2 (OLSRv2) is an update to OLSRv1 as published in RFC3626 [1]. Compared to RFC3626, OLSRv2 retains the same basic mechanisms and algorithms, while providing a more flexible signaling framework and some simplification of the messages being exchanged. Also, OLSRv2 accommodates both IPv4 and IPv6 addresses in a compact manner. OLSRv2 is developed for mobile ad hoc networks. It operates as a table driven, proactive protocol, i.e. it exchanges topology information with other nodes in the network regularly. Each node selects a set of its neighbor nodes as "MultiPoint Relays" (MPRs). Control traffic may be diffused through the network using hop by hop forwarding; a node only needs to forward control traffic directly received from its MPR selectors (nodes which have selected it as an MPR). MPRs thus provide an efficient mechanism for diffusing control traffic by reducing the number of transmissions required. Nodes selected as MPRs also have a special responsibility when declaring link state information in the network. A sufficient requirement for OLSRv2 to provide shortest path routes to all destinations is that nodes declare link state information for their MPR selectors, if any. Additional available link state information may be transmitted, e.g. for redundancy. Thus, as well as being used to facilitate efficient flooding, MPRs are also allow the reduction of the number and size of link state messages. MPRs are also thus used as intermediate nodes in multi-hop route calculations. A node selects MPRs from among its one hop neighbors connected by "symmetric", i.e. bi-directional, links. Therefore, selecting routes through MPRs automatically avoids the problems associated with data packet transfer over uni-directional links (such as the problem of not getting link layer acknowledgments at each hop, for link layers employing this technique). OLSRv2 is developed to work independently from other protocols. (Parts of OLSRv2 have been published separately as [3] and [4] for wider use.) Likewise, OLSRv2 makes no assumptions about the underlying link layer. However, OLSRv2 may use link layer information and notifications when available and applicable, as described in [4]. OLSRv2, as OLSRv1, inherits its concept of forwarding and relaying from HIPERLAN (a MAC layer protocol) which is standardized by ETSI [6], [7]. Clausen, et al. Expires August 5, 2007 [Page 6] Internet-Draft OLSRv2 February 2007 2. Terminology The keywords "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in RFC2119 [2]. MANET specific terminology is to be interpreted as described in [3] and [4]. Additionally, this document uses the following terminology: Node - A MANET router which implements the Optimized Link State Routing protocol version 2 as specified in this document. OLSRv2 interface - A MANET interface, running OLSRv2. Symmetric strict 2-hop neighbor - A symmetric 2-hop neighbor which is not a symmetric 1-hop neighbor and is not a 2-hop neighbor only through a symmetric 1-hop neighbor with willingness WILL_NEVER. Symmetric strict 2-hop neighborhood - The set of the symmetric strict 2-hop neighbors of a node. Multipoint relay (MPR) - A node which is selected by its symmetric 1-hop neighbor, node X, to "re-transmit" all the broadcast messages that it receives from node X, provided that the message is not a duplicate, and that the hop limit field of the message is greater than one. MPR selector - A node which has selected its symmetric 1-hop neighbor, node X, as one of its MPRs is an MPR selector of node X. Clausen, et al. Expires August 5, 2007 [Page 7] Internet-Draft OLSRv2 February 2007 3. Applicability Statement OLSRv2 is a proactive routing protocol for mobile ad hoc networks (MANETs). The larger and more dense a network, the more optimization can be achieved by using MPRs compared to the classic link state algorithm. OLSRv2 enables hop-by-hop routing, i.e. each node using its local information provided by OLSRv2 to route packets. As OLSRv2 continuously maintains routes to all destinations in the network, the protocol is beneficial for traffic patterns where the traffic is random and sporadic between a large subset of nodes, and where the [source, destination] pairs are changing over time: no additional control traffic need be generated in this situation since routes are maintained for all known destinations at all times. Also, since routes are maintained continuously, traffic is subject to no delays due to buffering or to route discovery. OLSRv2 supports nodes which have multiple interfaces which participate in the MANET using OLSRv2. As described in [4], each OLSRv2 interface may have one or more network addresses (which may have prefix lengths). OLSRv2, additionally, supports nodes which have non-OLSRv2 interfaces which can serve as gateways towards other networks. OLSRv2 uses the format specified in [3] for all messages and packets. OLSRv2 is thereby able to allow for extensions via "external" and "internal" extensibility. External extensibility allows a protocol extension to specify and exchange new message types, which can be forwarded and delivered correctly even by nodes which do not support that extension. Internal extensibility allows a protocol extension to define additional attributes to be carried embedded in the standard OLSRv2 control messages detailed in this specification (or any new message types defined by other protocol extensions) using the TLV mechanism specified in [3], while still allowing nodes not supporting that extension to forward messages including the extension and process messages ignoring the extension. The OLSRv2 neighborhood discovery protocol using HELLO messages is specified in [4]; note that all references to MANET interfaces in [4] refer to OLSRv2 interfaces when using [4] as part of OLSRv2. This neighborhood discovery protocol serves to ensure that each OLSRv2 node has available continuously updated information repositories describing the node's 1-hop and symmetric 2-hop neighbors. This neighborhood discovery protocol, which also uses [3], is extended in this document by the addition of MPR information. Clausen, et al. Expires August 5, 2007 [Page 8] Internet-Draft OLSRv2 February 2007 4. Protocol Overview and Functioning OLSRv2 is a proactive routing protocol for mobile ad hoc networks. The protocol inherits the stability of a link state algorithm and has the advantage of having routes immediately available when needed due to its proactive nature. OLSRv2 is an optimization of the classical link state protocol, tailored for mobile ad hoc networks. The main tailoring and optimizations of OLSRv2 are: o periodic, unacknowledged transmission of all control messages; o optimized flooding for global link state information diffusion; o partial topology maintenance - each node knows only a subset of the links in the network, sufficient for a minimum hop route to all destinations. The optimized flooding and partial topology maintenance are based on the concept on MultiPoint Relays (MPRs), selected independently by nodes based on the symmetric 1-hop and 2-hop neighbor information maintained using [4]. Using the message exchange format [3] and the neighborhood discovery protocol [4], OLSRv2 also contains the following main components: o A TLV, to be included within the HELLO messages of [4], allowing a node to signal MPR selection. o An optimized flooding mechanism for global information exchange, denoted "MPR flooding". o A specification of global signaling, denoted TC (Topology Control) messages. TC messages in OLSRv2 serve to: * inject link state information into the entire network; * inject addresses of hosts and networks for which they may serve as a gateway into the entire network. TC messages are emitted periodically, thereby allowing nodes to continuously track global changes in the network. Incomplete TC messages may be used to report additions to advertised information without repeating unchanged information. Some TC messages may be flooded over only part of the network, allowing a node to ensure that nearer nodes are kept more up to date than distant nodes. Each node in the network selects an MPR Set. The MPR Set of a node X may be any subset of its symmetric 1-hop neighborhood such that every Clausen, et al. Expires August 5, 2007 [Page 9] Internet-Draft OLSRv2 February 2007 node in the symmetric strict 2-hop neighborhood of node X has a symmetric link to a node in the MPR Set of node X. The MPR Set of a node may thus be said to "cover" the node's symmetric strict 2-hop neighborhood. Each node also maintains information about the set of symmetric 1-hop neighbors that have selected it as MPR. This set is called the MPR Selector Set of the node. Note that as long as the condition above is satisfied, any algorithm selecting MPR Sets is acceptable in terms of implementation interoperability. However if smaller MPR Sets are selected then the greater the efficiency gains that are possible. Note that [8] gives an analysis and example of MPR selection algorithms. In OLSRv2, actual efficiency gains are based on the sizes of each node's Relay Set, the set of symmetric 1-hop neighbors for which it is to relay broadcast traffic, and its Advertised Neighbor Set, the set of symmetric 1-hop neighbors for which it is to advertise link state information into the network in TC messages. Each of these sets MUST contain all the nodes in the MPR Selector Set and MAY contain additional nodes. If the Advertised Neighbor Set is empty, TC messages are not generated by that node, unless needed for gateway reporting, or for a short period to accelerate the removal of unwanted links. OLSRv2 is designed to work in a completely distributed manner and does not depend on any central entity. The protocol does not require reliable transmission of control messages: each node sends control messages periodically, and can therefore sustain a reasonable loss of some such messages. Such losses may occur frequently in radio networks due to collisions or other transmission problems. OLSRv2 may use "jitter", randomized adjustments to message transmission times, to reduce the incidence of collisions. OLSRv2 does not require sequenced delivery of messages. Each control message contains a sequence number which is incremented for each message. Thus the recipient of a control message can, if required, easily identify which information is more recent - even if messages have been re-ordered while in transmission. OLSRv2 does not require any changes to the format of IP packets, any existing IP stack can be used as is: OLSRv2 only interacts with routing table management. OLSR sends its control messages using UDP. Clausen, et al. Expires August 5, 2007 [Page 10] Internet-Draft OLSRv2 February 2007 5. Local Information Base A node maintains a Local Information Base that records information about its OLSRv2 interfaces, and its non-OLSRv2 interfaces that can serve as gateways to other networks. The former is maintained using a Local Interface Set, as described in [4]. The latter is maintained using a Local Attached Network Set. All addresses in the Local Information Base have an associated prefix length; if an address otherwise does not have a prefix length then it is set equal to the address length. Two addresses are considered equal if and only if their associated prefix lengths are also equal. The Local Information Base is not modified by this protocol. This protocol may respond to changes of this Local Information Base which MUST reflect corresponding changes in the node's status. It is not the responsibility of OLSRv2 to maintain routes to networks recorded in the Local Attached Network Set in that node. 5.1. Local Attached Network Set A node's Local Attached Network Set records its local non-OLSRv2 interfaces. that can act as gateways to other networks. It consists of Local Attached Network Tuples: (AL_net_addr, AL_dist) where: AL_net_addr is the network address of an attached network which can be reached via this node. AL_dist is the number of hops to the network with address AL_net_addr from this node. Attached networks with AL_dist == 0 MUST be local to this node and MUST NOT be attached to any other node. Attached networks with AL_dist > 0 MAY be attached to other nodes. Attached networks with AL_dist > 0 MUST be advertised in TC messages generated by this node, this may result in the node originating TC messages when it has no other reason to do so. Attached networks with AL_dist == 0 MAY be advertised in HELLO messages (which causes the MPRs of this node to advertise them in their TC messages) or MAY be advertised in TC messages; they MUST be advertised in one type of message and SHOULD NOT be advertised in both. If a node is sending TC messages for any other reason, then advertising attached networks in TC messages is more efficient. A node MAY decide which form of advertisement to use depending on its circumstances. Clausen, et al. Expires August 5, 2007 [Page 11] Internet-Draft OLSRv2 February 2007 6. Processing and Forwarding Repositories The following data structures are employed in order to ensure that a message is processed at most once and is forwarded at most once per interface of a node. 6.1. Received Set A node's Received Sets, one per OLSRv2 interface, each record the signatures of messages which have been received over that interface. Each consists of Received Tuples: (RX_type, RX_orig_addr, RX_seq_number, RX_time) where: RX_type is the received message type, or zero if the received message sequence number is not type-specific; RX_orig_addr is the originator address of the received message; RX_seq_number is the message sequence number of the received message; RX_time specifies the time at which this Tuple expires and MUST be removed. 6.2. Processed Set A node's Processed Set records signatures of messages which have been processed by the node. It consists of Processed Tuples: (P_type, P_orig_addr, P_seq_number, P_time) where: P_type is the processed message type, or zero if the processed message sequence number is not type-specific; P_orig_addr is the originator address of the processed message; P_seq_number is the message sequence number of the processed message; P_time specifies the time at which this Tuple expires and MUST be removed. Clausen, et al. Expires August 5, 2007 [Page 12] Internet-Draft OLSRv2 February 2007 6.3. Forwarded Set A node's Forwarded Set records signatures of messages which have been processed by the node. It consists of Forwarded Tuples: (F_type, F_orig_addr, F_seq_number, F_time) where: F_type is the forwarded message type, or zero if the forwarded message sequence number is not type-specific; F_orig_addr is the originator address of the forwarded message; F_seq_number is the message sequence number of the forwarded message; F_time specifies the time at which this Tuple expires and MUST be removed. 6.4. Relay Set A node's Relay Set records the neighbor interface addresses for which it is to relay flooded messages. It consists of Relay Tuples: (RY_iface_addr) where: RY_iface_addr is the address of a neighbor interface for which the node SHOULD relay flooded messages. This MUST include a prefix length. Clausen, et al. Expires August 5, 2007 [Page 13] Internet-Draft OLSRv2 February 2007 7. Packet Processing and Message Forwarding On receiving a packet, as defined in [3], a node examines the packet header and each of the message headers. If the message type is known to the node, the message is processed locally according to the specifications for that message type. The message is also independently evaluated for forwarding. 7.1. Actions when Receiving an OLSRv2 Packet On receiving a packet, a node MUST perform the following tasks: 1. The packet MAY be fully parsed on reception, or the packet and its messages MAY be parsed only as required. (It is possible to parse the packet header, or determine its absence, without parsing any messages. It is possible to divide the packet into messages without even fully parsing their headers. It is possible to determine whether a message is to be forwarded, and to forward it, without parsing its body. It is possible to determine whether a message is to be processed without parsing its body.) 2. If parsing fails at any point the relevant entity (packet or message) MUST be silently discarded, other parts of the packet (up to the whole packet) MAY be silently discarded; 3. Otherwise if the packet header is present and it contains a packet TLV block, then each TLV in it is processed according to its type if recognized, otherwise the TLV is ignored; 4. Otherwise each message in the packet, if any, is treated according to Section 7.2. 7.2. Actions when Receiving an OLSRv2 Message A node MUST perform the following tasks for each received OLSRv2 message: 1. If the received OLSRv2 message header cannot be correctly parsed according to the specification in [3], or if the node recognizes from the originator address of the message that the message is one which the receiving node itself originated, then the message MUST be silently discarded; 2. Otherwise: 1. If the received message is of a known type then the message is considered for processing according to Section 7.3, AND; Clausen, et al. Expires August 5, 2007 [Page 14] Internet-Draft OLSRv2 February 2007 2. If for the received message ( + ) > 1, then the message is considered for forwarding according to Section 7.4. 7.3. Message Considered for Processing If a message (the "current message") is considered for processing, the following tasks MUST be performed: 1. If an entry exists in the Processed Set where: * P_type == the message type of the current message, or 0 if the typedep bit in the message semantics octet (in the message header) of the current message is cleared ('0'), AND; * P_orig_addr == the originator address of the current message, AND; * P_seq_number == the message sequence number of the current message. then the current message MUST NOT be processed. 2. Otherwise: 1. Create an entry in the Processed Set with: + P_type = the message type of the current message, or 0 if the typedep bit in the message semantics octet (in the message header) of the current message is cleared ('0'); + P_orig_addr = originator address of the current message; + P_seq_number = sequence number of the current message; + P_time = current time + P_HOLD_TIME. 2. Process the message according to its type. 7.4. Message Considered for Forwarding If a message is considered for forwarding, and it is either of a message type defined in this document or of an unknown message type, then it MUST use the following algorithm. A message type not defined in this document MAY specify the use of this, or another algorithm. (Such an other algorithm MAY use the Received Set for the receiving interface, it SHOULD use the Forwarded Set similarly to the following algorithm.) Clausen, et al. Expires August 5, 2007 [Page 15] Internet-Draft OLSRv2 February 2007 If a message is considered for forwarding according to this algorithm, the following tasks MUST be performed: 1. If the sending interface (as indicated by the source interface of the IP datagram containing the message) does not match (taking into account any address prefix of) any N_neighbor_iface_addr in any Symmetric Neighbor Tuple, then the message MUST be silently discarded. 2. Otherwise: 1. If an entry exists in the Received Set for the receiving interface, where: + RX_type == the message type, or 0 if the typedep bit in the message semantics octet (in the message header) is cleared ('0'), AND; + RX_orig_addr == the originator address of the received message, AND; + RX_seq_number == the sequence number of the received message. then the message MUST be silently discarded. 2. Otherwise: 1. Create an entry in the Received Set for the receiving interface with: - RX_type = the message type, or 0 if the typedep bit in the message semantics octet (in the message header) is cleared ('0'); - RX_orig_addr = originator address of the message; - RX_seq_number = sequence number of the message; - RX_time = current time + RX_HOLD_TIME. 2. If an entry exists in the Forwarded Set where: - F_type == the message type, or 0 if the typedep bit in the message semantics octet (in the message header) is cleared ('0'); Clausen, et al. Expires August 5, 2007 [Page 16] Internet-Draft OLSRv2 February 2007 - F_orig_addr == the originator address of the received message, AND; - F_seq_number == the sequence number of the received message. then the message MUST be silently discarded. 3. Otherwise if a Relay Tuple exists whose RY_iface_addr matches (taking into account any address prefix) the sending interface (as indicated by the source interface of the IP datagram containing the message): 1. Create an entry in the Forwarded Set with: o F_type = the message type, or 0 if the typedep bit in the message semantics octet (in the message header) is cleared ('0'); o F_orig_addr = originator address of the message; o F_seq_number = sequence number of the message; o F_time = current time + F_HOLD_TIME. 2. The message header is modified as follows: o Decrement in the message header by 1; o Increment in the message header by 1; 3. Transmit the message on all OLSRv2 interfaces of the node. Messages are retransmitted in the format specified by [3] with the ALL-MANET-NEIGHBORS address (see [4]) as destination IP address. Clausen, et al. Expires August 5, 2007 [Page 17] Internet-Draft OLSRv2 February 2007 8. Information Repositories The purpose of OLSRv2 is to determine the Routing Set, which may be used to update IP's Routing Table, providing "next hop" routing information for IP datagrams. In order to accomplish this, OLSRv2 uses a number of protocol sets: the Neighborhood Information Base, provided by [4], is in OLSRv2 augmented by information allowing MPR selection and signaling. Additionally, OLSRv2 specifies a Topology Information Base, which describes the information used for and acquired through TC message exchange - in other words: the Topology Information Base represents the network topology graph as seen from each node. Addresses (other than originator addresses) recorded in the Neighborhood Information Base and the Topology Information Base MUST all be recorded with prefix lengths, in order to allow comparison with addresses received in HELLO and TC messages. 8.1. Neighborhood Information Base The Neighborhood Information Base stores information about links between local interfaces and interfaces on adjacent nodes. In addition to the sets described in [4], OLSRv2 adds an element to each Link Tuple to allow a node to record the willingness of a 1-hop neighbor node to be selected as an MPR. Also, OLSRv2 adds an MPR Set and an MPR Selector Set to the Neighborhood Information Base. The MPR Set is used by a node to record which of its symmetric 1-hop neighbors are selected as MPRs, and the MPR Selector Set is used by a node to record which of its symmetric 1-hop neighbors have selected it as MPR. Thus, in addition to what is specified in [4], the MPR Set is used when generating HELLO messages, and the MPR Selector Set is populated when processing HELLO messages. 8.1.1. Link Set Link Tuples are as specified in [4], augmented with: L_willingness is the node's willingness to be selected as an MPR; 8.1.2. MPR Set A node's MPR Set contains OLSRv2 interface addresses with which the node has a symmetric link and which are of 1-hop symmetric neighbors which the node has selected as MPRs: (MP_neighbor_iface_addr) Clausen, et al. Expires August 5, 2007 [Page 18] Internet-Draft OLSRv2 February 2007 8.1.3. MPR Selector Set A node's MPR Selector Set records the nodes which have selected this node as an MPR. It consists of MPR Selector Tuples: (MS_neighbor_iface_addr, MS_time) where: MS_neighbor_iface_addr is an OLSRv2 interface address with which this node has a symmetric link and which is of a 1-hop symmetric neighbor which has selected this node as an MPR; MS_time specifies the time at which this Tuple expires and MUST be removed. 8.2. Topology Information Base The Topology Information Base stores information, required for the generation and processing of TC messages. The Advertised Neighbor Set contains OLSRv2 interface addresses of symmetric 1-hop neighbors which are to be reported in TC messages. The Topology Set and Attached Network Set both record information received through TC messages. Thus the Advertised Neighbor Set is used for generating TC messages, while the Topology Set and Attached Network Set are populated when processing TC messages. Additionally, a Routing Set is maintained, derived from the information recorded in the Neighborhood Information Base, Topology Set and Attached Network Set. 8.2.1. Advertised Neighbor Set A node's Advertised Neighbor Set contains OLSRv2 interface addresses of symmetric 1-hop neighbors which are to be advertised through TC messages: (A_neighbor_iface_addr) In addition, an Advertised Neighbor Set Sequence Number (ANSN) is maintained. Each time the Advertised Neighbor Set is updated, the ANSN MUST be incremented. The ANSN MUST also be incremented if there is a change to the set of Local Attached Network Tuples that are to be advertised in the node's TC messages. Clausen, et al. Expires August 5, 2007 [Page 19] Internet-Draft OLSRv2 February 2007 8.2.2. ANSN History Set A node's ANSN History Set records information about the freshness of the topology information received from each other node. It consists of ANSN History Tuples: (AH_orig_addr, AH_seq_number, AH_time) where: AH_orig_addr is the originator address of a received TC message, note that this does not include a prefix length; AH_seq_number is the highest ANSN in any TC message received which originated from AH_orig_addr; AH_time is the time at which this Tuple expires and MUST be removed. 8.2.3. Topology Set A node's Topology Set records topology information about the network. It consists of Topology Tuples: (T_dest_iface_addr, T_last_iface_addr, T_seq_number, T_time) where: T_dest_iface_addr is an OLSRv2 interface address of a destination node, which may be reached in one hop from the node with the OLSRv2 interface address T_last_iface_addr; T_last_iface_addr is, conversely, an OLSRv2 interface address of a node which is the last hop on a path towards the node with OLSRv2 interface address T_dest_iface_addr. T_seq_number is the highest received ANSN associated with the information contained in this Topology Tuple; T_time specifies the time at which this Tuple expires and MUST be removed. 8.2.4. Attached Network Set A node's Attached Network Set records information about networks attached to other nodes. It consists of Attached Network Tuples: (AN_net_addr, AN_gw_iface_addr, AN_dist, AN_seq_number, AN_time) Clausen, et al. Expires August 5, 2007 [Page 20] Internet-Draft OLSRv2 February 2007 where: AN_net_addr is the network address of an attached network, which may be reached via the node with the OLSRv2 interface address AN_gw_iface_addr; AN_gw_iface_addr is the address of an OLSRv2 interface of a node which can act as gateway to the network with address AN_net_addr; AN_dist is the number of hops to the network with address AL_net_addr from the node with address AN_gw_iface_addr. AN_seq_number is the highest received ANSN associated with the information contained in this Attached Network Tuple; AN_time specifies the time at which this Tuple expires and MUST be removed. 8.2.5. Routing Set A node's Routing Set records the selected path to each destination for which a route is known. It consists of Routing Tuples: (R_dest_addr, R_next_iface_addr, R_dist, R_local_iface_addr) where: R_dest_addr is the address of the destination, either the address of an OLSRv2 interface of a destination node, or the network address of an attached network; R_next_iface_addr is the OLSRv2 interface address of the "next hop" on the selected path to the destination; R_dist is the number of hops on the selected path to the destination; R_local_iface_addr is the address of the local interface over which a packet MUST be sent to reach the destination. Clausen, et al. Expires August 5, 2007 [Page 21] Internet-Draft OLSRv2 February 2007 9. Control Message Structures Nodes using OLSRv2 exchange information through messages. One or more messages sent by a node at the same time SHOULD be combined into a single packet. These messages may have originated at the sending node, or have originated at another node and are forwarded by the sending node. Messages with different originators may be combined in the same packet. The packet and message format used by OLSRv2 is defined in [3]. However this specification contains some options which are not used by OLSRv2. In particular (using the syntactical entities defined in [3]): o All OLSRv2 packets, not limited to those defined in this document, include a . o All OLSRv2 packets, not limited to those defined in this document, have the pseqnum bit of cleared ('0'), i.e. they include a packet sequence number. o OLSRv2 packets MAY include packet TLVs, however OLSRv2 itself does not specify any packet TLVs. o All OLSRv2 messages, not limited to those defined in this document, include a full and hence have the noorig and nohops bits of cleared ('0'). o All OLSRv2 message defined in this document have the typedep bit of cleared ('0'). Other options defined in [3] may be freely used, in particular any other values of , or consistent with its specification. The remainder of this section defines, within the framework of [3], message types and TLVs specific to OLSRv2. 9.1. HELLO Messages A HELLO message in OLSRv2 is generated as specified in [4]. Additionally, an OLSRv2 node: o MUST include TLV(s) with Type == MPR associated with all OLSRv2 interface addresses included in the HELLO message with a TLV with Type == LINK_STATUS and Value == SYMMETRIC if that address is also included in the node's MPR Set (if there is more than one copy of the address, this applies to the specific copy of the address to Clausen, et al. Expires August 5, 2007 [Page 22] Internet-Draft OLSRv2 February 2007 which the LINK_STATUS TLV is associated); o MUST NOT include any TLVs with Type == MPR associated with any other addresses; o MAY include a message TLV with Type == WILLINGNESS, indicating the node's willingness to be selected as an MPR. 9.1.1. HELLO Message TLVs In a HELLO message, a node MAY include a WILLINGNESS message TLV as specified in Table 1. +----------------+------+-------------------+-----------------------+ | Name | Type | Length | Value | +----------------+------+-------------------+-----------------------+ | WILLINGNESS | TBD | 8 bits | The node's | | | | | willingness to be | | | | | selected as MPR; | | | | | unused bits (based on | | | | | the maximum | | | | | willingness value | | | | | WILL_ALWAYS) are | | | | | RESERVED and SHOULD | | | | | be set to zero | +----------------+------+-------------------+-----------------------+ Table 1 A node's willingness to be selected as MPR ranges from WILL_NEVER (indicating that a node MUST NOT be selected as MPR by any node) to WILL_ALWAYS (indicating that a node MUST always be selected as MPR). If a node does not advertise a Willingness TLV in HELLO messages, the node MUST be assumed to have a willingness of WILL_DEFAULT. 9.1.2. HELLO Message Address Block TLVs In a HELLO message, a node MAY include MPR address block TLV(s) as specified in Table 2. Clausen, et al. Expires August 5, 2007 [Page 23] Internet-Draft OLSRv2 February 2007 +----------------+------+-------------------+----------------------+ | Name | Type | Length | Value | +----------------+------+-------------------+----------------------+ | MPR | TBD | 0 bits | None | +----------------+------+-------------------+----------------------+ Table 2 9.2. TC Messages A TC message MUST contain: o A message TLV with Type == CONT_SEQ_NUM, as specified in Section 9.2.1. o A message TLV with Type == VALIDITY_TIME, as specified in Appendix E. o A first address block containing all of the node's OLSRv2 interface addresses. This is similar to the Local Interface Block included in HELLO messages as specified in [4], however in a TC message these addresses MUST be included in the same order in all copies of a given TC message, regardless of which OLSRv2 interface it is transmitted on, and no OTHER_IF address block TLVs are required. o Additional address block(s) containing all addresses in the Advertised Address Set and selected addresses in the Local Attached Network Set, the latter (only) with associated GATEWAY address block TLV(s), as specified in Section 9.2.2. A TC message MAY contain: o A message TLV with Type == INTERVAL_TIME, as specified in Appendix E. o A message TLV with Type == INCOMPLETE, as specified in Section 9.2.1. 9.2.1. TC Message TLVs In a TC message, a node MUST include a CONT_SEQ_NUM message TLV, and MAY contain an INCOMPLETE message TLV, as specified in Table 3. Clausen, et al. Expires August 5, 2007 [Page 24] Internet-Draft OLSRv2 February 2007 +----------------+------+-------------------+-----------------------+ | Name | Type | Length | Value | +----------------+------+-------------------+-----------------------+ | CONT_SEQ_NUM | TBD | 8 bits | The ANSN contained in | | | | | the Advertised | | | | | Neighbor Set | | | | | | | INCOMPLETE | TBD | 0 bits | None | +----------------+------+-------------------+-----------------------+ Table 3 9.2.2. TC Message Address Block TLVs In a TC message, a node MAY include GATEWAY address block TLV(s) as specified in Table 4. +----------------+------+-------------------+-----------------------+ | Name | Type | Length | Value | +----------------+------+-------------------+-----------------------+ | GATEWAY | TBD | 8 bits | Number of hops to | | | | | attached network | +----------------+------+-------------------+-----------------------+ Table 4 Clausen, et al. Expires August 5, 2007 [Page 25] Internet-Draft OLSRv2 February 2007 10. HELLO Message Generation An OLSRv2 HELLO message is composed as defined in [4], with the following additions: o A message TLV with Type == WILLINGNESS and Value == the node's willingness to act as an MPR, MAY be included. o For each address which is included in the message with an associated TLV with Type == LINK_STATUS, and is of an MPR (i.e. is an MP_neighbor_iface_addr), an address TLV with Type == MPR MUST be included; this TLV MUST be associated with the same copy of the address as is the TLV with Type == LINK_STATUS. o For address which is included in the message and is not of an MPR (i.e. is not an MP_neighbor_iface_addr) or is not associated with a TLV with Type == LINK_STATUS, an address TLV with Type == MPR MUST NOT be included. o For each Local Attached Tuple with AL_dist == 0, a node MAY include AL_net_addr in the Local Interface Block of the message, with an associated TLV with Type == OTHER_IF. 10.1. HELLO Message: Transmission HELLO messages are included in packets as specified in [3]. These packets may contain other messages, including TC messages. Clausen, et al. Expires August 5, 2007 [Page 26] Internet-Draft OLSRv2 February 2007 11. HELLO Message Processing Subsequent to the processing of HELLO messages, as specified in [4], the node MUST: 1. Determine the willingness of the originating node to be an MPR by: * if the HELLO message contains a message TLV with Type == WILLINGNESS then the willingness is the value of that TLV, ignoring the reserved bits in that field; * otherwise the willingness is WILL_DEFAULT. 2. Update each Link Tuple for which any address in its L_neighbor_iface_addr_list is present in the Local Interface Block of the HELLO message, with: * L_willingness = the willingness of the originating node. 3. Update its MPR Selector Set, according to Section 11.1. 11.1. Populating the MPR Selector Set On receiving a HELLO message: 1. If a node finds one of its OLSRv2 interface addresses with an associated TLV with Type == MPR in the HELLO message (indicating that the originator node has selected the receiving node as an MPR), the MPR Selector Set MUST be updated as follows: 1. For each address, henceforth neighbor address, in the Local Interface Block of the received HELLO message, where the neighbor address is present as an N_neighbor_iface_addr in a Symmetric Neighbor Tuple with N_STATUS == SYMMETRIC: 1. If there exists no MPR Selector Tuple with: - MS_neighbor_iface_addr == neighbor address then a new MPR Selector Tuple is created with: - MS_neighbor_iface_addr = neighbor address 2. The MPR Selector Tuple (new or otherwise) with: - MS_neighbor_iface_addr == neighbor address Clausen, et al. Expires August 5, 2007 [Page 27] Internet-Draft OLSRv2 February 2007 is then modified as follows: - MS_time = current time + validity time 2. Otherwise if a node finds one of its own interface addresses with an associated TLV with Type == LINK_STATUS and Value == SYMMETRIC in the HELLO message, the MPR Selector Set MUST be updated as follows: 1. All MPR Selector Tuples whose MS_neighbor_iface_addr is in the Local Interface Block of the HELLO message are removed. MPR Selector Tuples are also removed upon expiration of MS_time, or upon symmetric link breakage as described in Section 11.2. 11.2. Symmetric Neighborhood and 2-Hop Neighborhood Changes A node MUST also perform the following: 1. If a Link Tuple with L_STATUS == SYMMETRIC is removed, or its L_STATUS changes from SYMMETRIC to HEARD or LOST, and for each address in that Link Tuple's L_neighbor_iface_addr_list, if it is an MS_neighbor_iface_addr of an MPR Selector Tuple, then that MPR Selector Tuple MUST be removed. 2. If any of: * a Link Tuple is added with L_STATUS == SYMMETRIC, OR; * a Link Tuple with L_STATUS == SYMMETRIC is removed, or its L_STATUS changes from SYMMETRIC to HEARD or LOST, or vice versa, OR; * a 2-Hop Neighbor Tuple is added or removed, OR; * the Neighbor Address Association Set is changed such that the subset of any NA_neighbor_iface_addr_list consisting of those addresses which are in the L_neighbor_iface_addr_list of a Link Tuple with L_STATUS == SYMMETRIC is changed, including the cases of removal or addition of a Neighbor Address Association Tuple containing any such addresses; then the MPR Set MUST be recalculated. An additional HELLO message MAY be sent when the MPR Set changes, in addition to the cases specified in [4], and subject to the same constraints. Clausen, et al. Expires August 5, 2007 [Page 28] Internet-Draft OLSRv2 February 2007 12. TC Message Generation A node with one or more OLSRv2 interfaces, and with a non-empty Advertised Neighbor Set or which acts as a gateway to an associated network which is to be advertised in the MANET, MUST generate TC messages. A node with an empty Advertised Neighbor Set and which is not acting as such a gateway SHOULD also generate "empty" TC messages for a period A_HOLD_TIME after it last generated a non-empty TC message. TC messages (non-empty and empty) are generated according to the following: 1. The message hop count MUST be set to zero. 2. The message hop limit MAY be set to any positive value, this SHOULD be at least two. A node MAY: * use the same hop limit in all TC messages, this MUST be at least equal to the network diameter in hops, a value of 255 is RECOMMENDED in this case; OR * use different hop limits in TC messages, this MUST regularly include messages with hop limit at least equal to the network diameter, a value of 255 is RECOMMENDED for these messages; other hop limits SHOULD use a regular pattern with a regular interval at any given number of hops distance. 3. The message MUST contain a message TLV with Type == CONT_SEQ_NUM and Value == ANSN from the Advertised Neighbor Set. 4. The message MUST contain a message TLV with Type == VALIDITY_TIME, as specified in Appendix E.2. If all TC messages are sent with the same hop limit (usually 255) then this TLV MUST have Value == T_HOLD_TIME. If TC messages are sent with different hop limits, then this TLV MUST specify times which vary with the number of hops distance appropriate to the chosen pattern of TC message hop limits, these times SHOULD be appropriate multiples of T_HOLD_TIME. 5. The message MAY contain a message TLV with Type == INTERVAL_TIME, as specified in Appendix E.2. If all TC messages are sent with the same hop limit (usually 255) then this TLV MUST have Value == TC_INTERVAL. If TC messages are sent with different hop limits, then this TLV MUST specify times which vary with the number of hops distance appropriate to the chosen pattern of TC message hop limits, these times SHOULD be appropriate multiples of TC_INTERVAL. Clausen, et al. Expires August 5, 2007 [Page 29] Internet-Draft OLSRv2 February 2007 6. The message MUST contain the addresses of all of its OLSRv2 interfaces in its first address block, note that the TC message generated on all OLSRv2 interfaces MUST be identical (including having identical message sequence number) and hence these addresses are not ordered or otherwise identified according to the interface on which the TC message is transmitted. 7. The message MUST contain, in address blocks other than its first: 1. A_neighbor_iface_addr from each Advertised Neighbor Tuple; 2. AL_net_addr from each Local Attached Neighbor Tuple with AL_dist > 0, each associated with a TLV with Type == GATEWAY and Value == AL_dist. 8. The message MAY contain, in address blocks other than its first: 1. AL_net_addr from each Local Attached Neighbor Tuple with AL_dist == 0, each associated with a TLV with Type == GATEWAY and Value == 0. 12.1. TC Message: Transmission TC messages are generated and transmitted periodically on all OLSRv2 interfaces, with a default interval between two consecutive TC emissions by the same node of TC_INTERVAL. TC messages MAY be generated in response to a change of contents, indicated by a change in ANSN. In this case a node MAY send a complete TC message, and if so MAY re-start its TC message schedule. Alternatively a node MAY send only new content in its address blocks (with appropriate associated TLVs) in which case it MUST include a message TLV with Type == INCOMPLETE, and MUST NOT re-start its TC message schedule. This TC message MUST include its usual message TLVs. Note that a node cannot report removal of advertised content using an incomplete TC message. When sending a TC message in response to a change of contents, a node must respect a minimum interval of TC_MIN_INTERVAL between generated TC messages. Sending an incomplete TC message MUST NOT cause the interval between complete TC messages to be increased, and thus a node MUST NOT send an incomplete TC message if within TC_MIN_INTERVAL of the next scheduled complete TC message. The generation of TC messages, whether scheduled or triggered by a change of contents, and the forwarding of TC messages, MAY be jittered as described in Appendix F. The values of MAXJITTER used SHOULD be: Clausen, et al. Expires August 5, 2007 [Page 30] Internet-Draft OLSRv2 February 2007 o TP_MAXJITTER for periodic TC message generation; o TT_MAXJITTER for triggered TC message generation; o TF_MAXJITTER for TC message forwarding; TC messages are included in packets as specified in [3]. These packets may contain other messages, including HELLO messages and TC messages with different originator addresses. TC messages are forwarded according to the specification in Section 7.4. Clausen, et al. Expires August 5, 2007 [Page 31] Internet-Draft OLSRv2 February 2007 13. TC Message Processing When according to Section 7.3 a TC message is to be processed according to its type, this means that: o if the message does not contain a message TLV with Type == INCOMPLETE, then processing according to Section 13.1 and then according to Section 13.2 is carried out; o if the message contains a message TLV with Type == INCOMPLETE, then only processing according to Section 13.1 is carried out. For all processing purposes, "ANSN" is defined as being the value of the message TLV with Type == CONT_SEQ_NUM in the TC message. If a TC message has no such TLV then it MUST NOT be processed. 13.1. Initial TC Message Processing For the purposes of this section, note the following: o "validity time" is calculated from the VALIDITY_TIME message TLV in the TC message according to the specification in Appendix E.2; o "originator address" refers to the originator address in the TC message header; o comparisons of sequence numbers are carried out as specified in Section 18. The TC message is processed as follows: 1. the ANSN History Set is updated according to Section 13.1.1; if the TC message is indicated as discarded in that processing then the following steps are not carried out; 2. the Topology Set is updated according to Section 13.1.2; 3. the Attached Network Set is updated according to Section 13.1.3. 13.1.1. Populating the ANSN History Set The node MUST update its ANSN History Set as follows: 1. If there is an ANSN History Tuple with: * AH_orig_addr == originator address; AND Clausen, et al. Expires August 5, 2007 [Page 32] Internet-Draft OLSRv2 February 2007 * AH_seq_number > ANSN then the TC message MUST be discarded. 2. Otherwise 1. If there is no ANSN History Tuple such that: + AH_orig_addr == originator address; then create a new ANSN History Tuple with: + AH_orig_addr = originator address. 2. This ANSN History Tuple (existing or new) is then modified as follows: + AH_seq_number = ANSN; + AH_time = current time + validity time. 13.1.2. Populating the Topology Set The node MUST update its Topology Set as follows: 1. For each address, henceforth local address, in the first address block in the TC message: 1. For each address, henceforth advertised address, in an address block other than the first in the TC message, and which does not have an associated TLV with Type == GATEWAY: 1. If there is no Topology Tuple such that: - T_dest_iface_addr == advertised address; AND - T_last_iface_addr == local address then create a new Topology Tuple with: - T_dest_iface_addr = advertised address; - T_last_iface_addr = local address. 2. This Topology Tuple (existing or new) is then modified as follows: Clausen, et al. Expires August 5, 2007 [Page 33] Internet-Draft OLSRv2 February 2007 - T_seq_number = ANSN; - T_time = current time + validity time. 13.1.3. Populating the Attached Network Set The node MUST update its Attached Network Set as follows: 1. For each address, henceforth gateway address, in the first address block in the TC message: 1. For each address, henceforth network address, in an address block other than the first in the TC message, and which has an associated TLV with Type == GATEWAY: 1. If there is no Attached Network Tuple such that: - AN_net_addr == network address; AND - AN_gw_iface_addr == gateway address then create a new Attached Network Tuple with: - AN_net_addr = network address; - AN_gw_iface_addr = gateway address. 2. This Attached Network Tuple (existing or new) is then modified as follows: - AN_dist = the value of the associated GATEWAY TLV; - AN_seq_number = ANSN; - AN_time = current time + validity time. 13.2. Completing TC Message Processing The TC message is processed as follows: 1. the Topology Set is updated according to Section 13.2.1; 2. the Attached Network Set is updated according to Section 13.2.2. Clausen, et al. Expires August 5, 2007 [Page 34] Internet-Draft OLSRv2 February 2007 13.2.1. Purging the Topology Set The Topology Set MUST be updated as follows: 1. for each address, henceforth local address, in the first address block of the TC message, all Topology Tuples with: * T_last_iface_addr == local address; AND * T_seq_number < ANSN MUST be removed. 13.2.2. Purging the Attached Network Set The Attached Network Set MUST be updated as follows: 1. for each address, henceforth local address, in the first address block of the TC message, all Attached Network Tuples with: * AN_gw_iface_addr == local address; AND * AN_seq_number < ANSN MUST be removed. Clausen, et al. Expires August 5, 2007 [Page 35] Internet-Draft OLSRv2 February 2007 14. Populating the MPR Set Each node MUST select, from among its symmetric 1-hop neighbors, a subset of nodes as MPRs. This subset MUST be selected such that a message transmitted by the node, and retransmitted by all its MPRs, will be received by all of its symmetric strict 2-hop neighbors. Each node selects its MPR Set individually, utilizing the information in the Symmetric Neighbor Set, the 2-Hop Neighbor Set and the Neighborhood Address Association Set. Initially these sets will be empty, as will be the MPR Set. A node SHOULD recalculate its MPR Set when a relevant change is made to the Symmetric Neighbor Set, the 2-Hop Neighbor Set or the Neighborhood Address Association Set. More specifically, a node MUST calculate MPRs per interface, the union of the MPR Sets of each interface make up the MPR Set for the node. All OLSRv2 interfaces of nodes selected as MPRs with which the node has a symmetric link MUST be added to the MPR Set. Also symmetric 1-hop neighbor nodes with willingness WILL_NEVER (as recorded in the Link Set) MUST NOT be considered as MPRs. MPRs are used to flood control messages from a node into the network while reducing the number of retransmissions that will occur in a region. Thus, the concept of MPR is an optimization of a classical flooding mechanism. While it is not essential that the MPR Set is minimal, it is essential that all symmetric strict 2-hop neighbors can be reached through the selected MPR nodes. A node MUST select an MPR Set such that any strict 2-hop neighbor is "covered" by at least one MPR node. A node MAY select additional MPRs beyond the minimum set. Keeping the MPR Set small ensures that the overhead of OLSRv2 is kept at a minimum. Appendix C contains an example heuristic for selecting MPRs. Clausen, et al. Expires August 5, 2007 [Page 36] Internet-Draft OLSRv2 February 2007 15. Populating Derived Sets The Relay Set and the Advertised Neighbor Set of OLSRv2 are denoted derived sets, since updates to these sets are not directly a function of message exchanges, but rather are derived from updates to other sets, in particular the MPR Selector Set. 15.1. Populating the Relay Set The Relay Set contains the set of OLSRv2 interface addresses of those symmetric 1-hop neighbors for which a node is supposed to relay broadcast traffic. This set MUST at least contain all addresses in the MPR Selector Set (i.e. all MS_neighbor_iface_addr). This set MAY contain additional symmetric 1-hop neighbor OLSRv2 interface addresses. 15.2. Populating the Advertised Neighbor Set The Advertised Neighbor Set contains the set of OLSRv2 interface addresses of those 1-hop neighbors to which a node advertises a symmetric link in TC messages. This set MUST at least contain all addresses in the MPR Selector Set (i.e. all MS_neighbor_iface_addr). This set MAY contain additional symmetric 1-hop neighbor OLSRv2 interface addresses. Whenever an address is added to or removed from the Advertised Neighbor Set, the ANSN MUST be incremented. Clausen, et al. Expires August 5, 2007 [Page 37] Internet-Draft OLSRv2 February 2007 16. Routing Table Calculation The Routing Set is updated when a change (an entry appearing or disappearing, or changing between SYMMETRIC and LOST) is detected in: o the Link Set, OR; o the Neighbor Address Association Set, OR; o the 2-Hop Neighbor Set, OR; o the Topology Set, OR; o the Attached Network Set. Note that some changes to these sets do not necessitate a change to the Routing Set, in particular changes to the Link Set which do not involve Link Tuples with L_STATUS == SYMMETRIC (either before or after the change), and similar changes to the Neighbor Address Association Set. A node MAY avoid updating the Routing Set in such cases. Updates to the Routing Set do not generate or trigger any messages to be transmitted. The state of the Routing Set SHOULD, however, be reflected in the IP routing table by adding and removing entries from the routing table as appropriate. To construct the Routing Set of node X, a shortest path algorithm is run on the directed graph containing o the arcs X -> Y where there exists a Link Tuple with Y in the L_neighbor_iface_addr_list and L_STATUS == SYMMETRIC (i.e. Y is a symmetric 1-hop neighbor of X), AND; o the arcs Y -> Z where Y is added as above and the Link Tuple with Y in its L_neighbor_iface_addr_list has L_willingness not equal to WILL_NEVER, and there exists a 2-Hop Neighbor Tuple with Y as N2_neighbor_iface_addr and Z as N2_2hop_iface_addr (i.e. Z is a symmetric 2-hop neighbor of Z through Y, which does not have willingness WILL_NEVER), AND; o the arcs U -> V, where there exists a Topology Tuple with U as T_last_iface_addr and V as T_dest_iface_addr (i.e. this is an advertised link in the network). The graph is complemented with: Clausen, et al. Expires August 5, 2007 [Page 38] Internet-Draft OLSRv2 February 2007 o arcs Y -> W where there exists a Link Tuple with Y in its L_neighbor_iface_addr_list and L_STATUS == SYMMETRIC and a Neighborhood Address Association Tuple with Y and W both contained in its NA_neighbor_iface_addr_list (i.e. Y and W are both addresses of the same symmetric 1-hop neighbor), AND; o arcs U -> T where there exists an Attached Network Tuple with U as AN_net_addr and T as AN_gw_iface_addr (i.e. U is a gateway to network T). The following procedure is given as an example for calculating the Routing Set using a variation of Dijkstra's algorithm. Thus: 1. All Routing Tuples are removed. 2. For each Link Tuple with L_STATUS == SYMMETRIC, and for each address (henceforth neighbor address) in that Link Tuple's L_neighbor_iface_addr_list, a new Routing Tuple is added with: * R_dest_addr = neighbor address; * R_next_iface_addr = neighbor address; * R_dist = 1; * R_local_iface_addr = neighbor address. 3. For each Neighbor Address Association Tuple, for which two addresses A1 and A2 are in NA_neighbor_iface_addr_list where: * there is a Routing Tuple with: + R_dest_addr == A1 * and there is no Routing Tuple with: + R_dest_addr == A2 then a Routing Tuple is added with: * R_dest_addr = A2; * R_next_iface_addr = R_next_iface_addr of the Routing Tuple in which R_dest_addr == A1; * R_dist = 1; Clausen, et al. Expires August 5, 2007 [Page 39] Internet-Draft OLSRv2 February 2007 * R_local_iface_addr = R_local_iface_addr of the Routing Tuple in which R_dest_addr == A1. 4. The following procedure, which adds Routing Tuples for destination nodes h+1 hops away, MUST be executed for each value of h, starting with h=2 and incrementing by 1 for each iteration. The execution MUST stop if no new Routing Tuples are added in an iteration. 1. For each Topology Tuple, if + T_dest_iface_addr is not equal to R_dest_addr of any Routing Tuple, AND; + T_last_iface_addr is equal to R_dest_addr of a Routing Tuple whose R_dist == h; then a new Routing Tuple MUST be added, with: + R_dest_addr = T_dest_iface_addr; + R_next_iface_addr = R_next_iface_addr of the Routing Tuple whose R_dest_addr == T_last_iface_addr; + R_dist = h+1; + R_local_iface_addr = R_local_iface_addr of the Routing Tuple whose R_dest_addr == T_last_iface_addr. Several Topology Tuples may be used to select a next hop R_next_iface_addr for reaching the address R_dest_addr. When h == 1, ties should be broken such that nodes with highest willingness are preferred, and between nodes of equal willingness, MPR selectors are preferred over non-MPR selectors. 2. After the above iteration has completed, if h == 1, for each 2-Hop Neighbor Tuple where: + N2_2hop_iface_addr is not equal to R_dest_addr of any Routing Tuple, AND; + N2_neighbor_iface_addr has a willingness (i.e. the L_willingness of the Link Tuple whose L_neighbor_iface_addr_list contains N2_neighbor_iface_addr) which is not equal to WILL_NEVER; a Routing Tuple is added with: Clausen, et al. Expires August 5, 2007 [Page 40] Internet-Draft OLSRv2 February 2007 + R_dest_addr = N2_2hop_iface_addr of the 2-Hop Neighbor Tuple; + R_next_iface_addr = R_next_iface_addr of the Routing Tuple in which R_dest_addr == N2_neighbor_iface_addr; + R_dist = 2; + R_local_iface_addr = R_local_iface_addr of the Routing Tuple in which R_dest_addr == N2_neighbor_iface_addr. 5. For each Attached Network Tuple, if * AN_net_addr is not equal to R_dest_addr of any Routing Tuple, AND; * AN_gw_iface_addr is equal to R_dest_addr of a Routing Tuple; then a new Routing Tuple MUST be added, with: * R_dest_addr = AN_net_addr; * R_next_iface_addr = R_next_iface_addr of the Routing Tuple whose R_dest_addr == AN_gw_iface_addr; * R_dist = (R_dist of the Routing Tuple whose R_dest_addr == AN_gw_iface_addr) + AN_dist; * R_local_iface_addr = R_local_iface_addr of the Routing Tuple whose R_dest_addr == AN_gw_iface_addr. If more than one Attached Network Tuple has the same AN_net_addr, then more than one Routing Tuple MUST NOT be added, and the added Routing Tuple MUST have minimum R_dist. Clausen, et al. Expires August 5, 2007 [Page 41] Internet-Draft OLSRv2 February 2007 17. Proposed Values for Constants This section list the values for the constants used in the description of the protocol. These proposed values are appropriate to the case where all TC messages are sent with the same hop limit (usually 255). 17.1. Neighborhood Discovery Constants The constants HELLO_INTERVAL, REFRESH_INTERVAL, HELLO_MIN_INTERVAL, H_HOLD_TIME, L_HOLD_TIME, N_HOLD_TIME, HP_MAXJITTER, HT_MAXJITTER and C are used as in [4]. 17.2. Message Intervals o TC_INTERVAL = 5 seconds o TC_MIN_INTERVAL = TC_INTERVAL/4 17.3. Holding Times o T_HOLD_TIME = 3 x TC_INTERVAL o A_HOLD_TIME = T_HOLD_TIME o P_HOLD_TIME = 30 seconds o RX_HOLD_TIME = 30 seconds o F_HOLD_TIME = 30 seconds 17.4. Jitter Times o TP_MAXJITTER = HP_MAXJITTER o TT_MAXJITTER = HT_MAXJITTER o TF_MAXJITTER = TT_MAXJITTER 17.5. Willingness o WILL_NEVER = 0 o WILL_DEFAULT = 3 o WILL_ALWAYS = 7 Clausen, et al. Expires August 5, 2007 [Page 42] Internet-Draft OLSRv2 February 2007 18. Sequence Numbers Sequence numbers are used in OLSRv2 with the purpose of discarding "old" information, i.e. messages received out of order. However with a limited number of bits for representing sequence numbers, wrap- around (that the sequence number is incremented from the maximum possible value to zero) will occur. To prevent this from interfering with the operation of OLSRv2, the following MUST be observed when determining the ordering of sequence numbers. The term MAXVALUE designates in the following one more than the largest possible value for a sequence number. For a 16 bit sequence number (as are those defined in this specification) MAXVALUE is 65536. The sequence number S1 is said to be "greater than" the sequence number S2 if: o S1 > S2 AND S1 - S2 < MAXVALUE/2 OR o S2 > S1 AND S2 - S1 > MAXVALUE/2 When sequence numbers S1 and S2 differ by MAXVALUE/2 their ordering cannot be determined. In this case, which should not occur, either ordering may be assumed. Thus when comparing two messages, it is possible - even in the presence of wrap-around - to determine which message contains the most recent information. Clausen, et al. Expires August 5, 2007 [Page 43] Internet-Draft OLSRv2 February 2007 19. IANA Considerations 19.1. Message Types OLSRv2 defines one message type, which must be allocated from the "Assigned Message Types" repository of [3]. +--------------------+-------+--------------------------------------+ | Mnemonic | Value | Description | +--------------------+-------+--------------------------------------+ | TC | TBD | Topology Control (global signaling) | +--------------------+-------+--------------------------------------+ Table 5 19.2. TLV Types OLSRv2 defines three message TLV types, which must be allocated from the "Assigned message TLV Types" repository of [3]. +--------------------+-------+--------------------------------------+ | Mnemonic | Value | Description | +--------------------+-------+--------------------------------------+ | WILLINGNESS | TBD | Specifies the originating node's | | | | willingness to act as a relay and to | | | | partake in network formation | | | | | | CONT_SEQ_NUM | TBD | Specifies a content sequence number | | | | for this message | | | | | | INCOMPLETE | TBD | Specifies that this message is | | | | incomplete | +--------------------+-------+--------------------------------------+ Table 6 OLSRv2 defines two Address Block TLV types, which must be allocated from the "Assigned address block TLV Types" repository of [3]. Clausen, et al. Expires August 5, 2007 [Page 44] Internet-Draft OLSRv2 February 2007 +--------------------+-------+--------------------------------------+ | Mnemonic | Value | Description | +--------------------+-------+--------------------------------------+ | MPR | TBD | Specifies that a given address is | | | | selected as MPR | | | | | | GATEWAY | TBD | Specifies that a given address is | | | | reached via a gateway on the | | | | originating node | +--------------------+-------+--------------------------------------+ Table 7 Clausen, et al. Expires August 5, 2007 [Page 45] Internet-Draft OLSRv2 February 2007 20. References 20.1. Normative References [1] Clausen, T. and P. Jacquet, "The Optimized Link State Routing Protocol", RFC 3626, October 2003. [2] Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels", RFC 2119, BCP 14, March 1997. [3] Clausen, T., Dean, J., Dearlove, C., and C. Adjih, "Generalized MANET Packet/Message Format", work in progress draft-ietf-manet-packetbb-03.txt, January 2007. [4] Clausen, T., Dean, J., and C. Dearlove, "MANET Neighborhood Discovery Protocol (NHDP)", work in progress draft-ietf-manet-nhdp-01.txt, February 2007. 20.2. Informative References [5] Atkins, D., Stallings, W., and P. Zimmermann, "PGP Message Exchange Formats", RFC 1991, August 1996. [6] ETSI, "ETSI STC-RES10 Committee. Radio equipment and systems: HIPERLAN type 1, functional specifications ETS 300-652", June 1996. [7] Jacquet, P., Minet, P., Muhlethaler, P., and N. Rivierre, "Increasing reliability in cable free radio LANs: Low level forwarding in HIPERLAN.", 1996. [8] Qayyum, A., Viennot, L., and A. Laouiti, "Multipoint relaying: An efficient technique for flooding in mobile wireless networks.", 2001. Clausen, et al. Expires August 5, 2007 [Page 46] Internet-Draft OLSRv2 February 2007 Appendix A. Node Configuration OLSRv2 does not make any assumption about node addresses, other than that each node is assumed to have at least one unique and routable IP address for each interface that it has which participates in the MANET. When applicable, a recommended way of connecting an OLSRv2 network to an existing IP routing domain is to assign an IP prefix (under the authority of the nodes/gateways connecting the MANET with the routing domain) exclusively to the OLSRv2 area, and to configure the gateways statically to advertise routes to that IP sequence to nodes in the existing routing domain. Clausen, et al. Expires August 5, 2007 [Page 47] Internet-Draft OLSRv2 February 2007 Appendix B. Protocol and Port Number Packets in OLSRv2 are communicated using UDP. Port 698 has been assigned by IANA for exclusive usage by the OLSR (v1 and v2) protocol. Clausen, et al. Expires August 5, 2007 [Page 48] Internet-Draft OLSRv2 February 2007 Appendix C. Example Heuristic for Calculating MPRs The following specifies a proposed heuristic for selection of MPRs. In graph theory terms, MPR computation is a "set cover" problem, which is a difficult optimization problem, but for which an easy and efficient heuristics exist: the so-called "Greedy Heuristic", a variant of which is described here. In simple terms, MPR computation constructs an MPR Set that enables a node to reach any symmetric 2-hop neighbors by relaying through an MPR node. There are several peripheral issues that the algorithm needs to address. The first one is that some nodes have some willingness WILL_NEVER. The second one is that some nodes may have several interfaces. The algorithm hence can be summarized by: o All 1-hop neighbor nodes with willingness equal to WILL_NEVER MUST ignored in the following algorithm: they are not considered as 1-hop neighbors (hence not used as MPRs). o Because link sensing is performed by interface, the local network topology is best described in terms of links: hence the algorithm is considering 1-hop neighbor OLSRv2 interfaces, and 2-hop neighbor OLSRv2 interfaces (and their addresses). Additionally, asymmetric links are ignored. This is reflected in the definitions below. o MPR computation is performed on each interface of the node: on each interface I, the node MUST select some neighbor interfaces, so that all 2-hop neighbor interfaces are reached. From now on, MPR calculation will be described for one interface I on the node, and the following terminology will be used in describing the heuristics: neighbor interface (of I) - An OLSRv2 interface of a 1-hop neighbor to which there exist a symmetric link using interface I. N - the set of such neighbor interfaces 2-hop neighbor interface (of I) An interface of a symmetric strict 2-hop neighbor which can be reached from a neighbor interface for I. Clausen, et al. Expires August 5, 2007 [Page 49] Internet-Draft OLSRv2 February 2007 N2 - the set of such 2-hop neighbor interfaces D(y): - the degree of a 1-hop neighbor interface y (where y is a member of N), is defined as the number of symmetric neighbor interfaces of node y which are in N2 MPR Set - the set of the neighbor interfaces selected as MPRs. The proposed heuristic selects iteratively some interfaces from N as MPRs in order to cover 2-hop neighbor interfaces from N2, as follows: 1. Start with an MPR Set made of all members of N with L_willingness equal to WILL_ALWAYS 2. Calculate D(y), where y is a member of N, for all interfaces in N. 3. Add to the MPR Set those interfaces in N, which are the *only* nodes to provide reachability to an interface in N2. For example, if interface B in N2 can be reached only through a symmetric link to interface A in N, then add interface B to the MPR Set. Remove the interfaces from N2 which are now covered by a interface in the MPR Set. 4. While there exist interfaces in N2 which are not covered by at least one interface in the MPR Set: 1. For each interface in N, calculate the reachability, i.e., the number of interfaces in N2 which are not yet covered by at least one node in the MPR Set, and which are reachable through this neighbor interface; 2. Select as an MPR the interface with highest L_willingness among the interfaces in N with non-zero reachability. In case of multiple choice select the interface which provides reachability to the maximum number of interfaces in N2. In case of multiple interfaces providing the same amount of reachability, select the interface as MPR whose D(y) is greater. Remove the interfaces from N2 which are now covered by an interface in the MPR Set. Other algorithms, as well as improvements over this algorithm, are possible. For example: o Assume that in a multiple interface scenario there exists more than one link between nodes 'a' and 'b'. If node 'a' has selected node 'b' as MPR for one of its interfaces, then node 'b' can be selected as MPR with minimal performance loss by any other Clausen, et al. Expires August 5, 2007 [Page 50] Internet-Draft OLSRv2 February 2007 interfaces on node 'a'. o In a multiple interface scenario MPRs are selected for each interface of the selecting node, providing full coverage of all 2-hop nodes accessible through that interface. The overall MPR Set is then the union of these sets. These sets do not however have to be selected independently, if a node is selected as an MPR for one interface it may be automatically added to the MPR selection for other interfaces. Clausen, et al. Expires August 5, 2007 [Page 51] Internet-Draft OLSRv2 February 2007 Appendix D. Packet and Message Layout This appendix illustrates the translation from the abstract descriptions of packets employed in the protocol specification, and the bit-layout packets actually exchanged between the nodes. Appendix D.1. Packet and Message Options The basic layout of an OLSRv2 packet is as described in [3]. However the following points should be noted. In the following figures, reserved bits marked Reserved or Resv MUST be cleared ('0'). Octets indicated as Padding are optional and MAY be omitted; if not omitted they SHOULD be used to pad to a 32 bit boundary and MUST all be zero. OLSRv2 uses only packets with a packet header including a packet sequence number, either with or without a packet TLV block. Thus all OLSRv2 packets have the layout of either 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 +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |0 0 0 0 0 0 0 0| Reserved |0|0| Packet Sequence Number | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | | | Message + Padding | | | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | | : ... : | | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | | | Message + Padding | | | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ or Clausen, et al. Expires August 5, 2007 [Page 52] Internet-Draft OLSRv2 February 2007 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 +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |0 0 0 0 0 0 0 0| Reserved |1|0| Packet Sequence Number | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | | | Packet TLV Block | | | | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | | Padding | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | | | Message + Padding | | | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | | : ... : | | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | | | Message + Padding | | | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ OLSRv2 uses only messages with a complete message header. Thus all OLSRv2 messages, plus padding if any, have the following layout. 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 +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | Message Type | Resv |N|0|0| Message Size | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | Originator Address | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | Hop Limit | Hop Count | Message Sequence Number | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | | | Message Body | | | | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | | Padding | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ In standard OLSRv2 messages (HELLO and TC) the type dependent sequence number bit marked N MUST be cleared ('0'). The layouts of the message body, address block, TLV block and TLV are as in [3], allowing all options. Standard (HELLO and TC) messages Clausen, et al. Expires August 5, 2007 [Page 53] Internet-Draft OLSRv2 February 2007 contain a first address block which contains local interface address information, all other address blocks contain neighbor interface address information (or for a TC message address information for which it is a gateway) specific to the message type. Appendix D.2. Example HELLO Message An example HELLO message, using IPv4 (four octet) addresses is as follows. The overall message length is 58 octets. The message has a hop limit of 1 and a hop count of 0, as sent by its originator. The message has a message TLV block with content length 12 octets containing three message TLVs. These TLVs represent message validity time, message interval time and willingness. Each uses a TLV with semantics value 4, indicating no start and stop indexes are included, and each has a value length of 1 octet. The first address block contains 1 local interface address. The semantics octet 2 indicates it has no tail section. It has head length 4, this is equal to the address length, it thus has no mid section. This address block has no TLVs (TLV block content length is 0 octets). The second, and last, address block includes 4 neighbor interface addresses. The semantics octet 2 indicates they have no tail section. The addresses have head length 3 octets, thus each mid section is of length one octet. The following address TLV block (content length 11 octets) includes two TLVs. The first of these TLVs reports the link status of all four neighbors in a single multivalue TLV, the first two addresses are HEARD, the last two addresses are SYMMETRIC. The TLV semantics octet value of 20 indicates, in addition to that this is a multivalue TLV, that no start index and stop index are included, hence values for all addresses are included. The TLV value length of 4 octets indicates one octet per value per address. The second of these TLVs indicates that the last address (start index 3, stop index 3) is an MPR. This TLV has no value, or value length, fields, as indicated by its semantics octet being equal to 2. Clausen, et al. Expires August 5, 2007 [Page 54] Internet-Draft OLSRv2 February 2007 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 +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | HELLO |0 0 0 0 0 0 0 0|0 0 0 0 0 0 0 0 0 0 1 1 1 0 1 0| +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | Originator Address | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |0 0 0 0 0 0 0 1|0 0 0 0 0 0 0 0| Message Sequence Number | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |0 0 0 0 0 0 0 0 0 0 0 0 1 1 0 0| VALIDITY_TIME |0 0 0 0 0 1 0 0| +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |0 0 0 0 0 0 0 1| Value | INTERVAL_TIME |0 0 0 0 0 1 0 0| +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |0 0 0 0 0 0 0 1| Value | WILLINGNESS |0 0 0 0 0 1 0 0| +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |0 0 0 0 0 0 0 1| Value |0 0 0 0 0 0 0 1|0 0 0 0 0 0 1 0| +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |0 0 0 0 0 1 0 0| Head | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | Head (cont) |0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0|0 0 0 0 0 1 0 0| +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |0 0 0 0 0 0 1 0|0 0 0 0 0 0 1 1| Head | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | Head (cont) | Mid | Mid | Mid | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | Mid |0 0 0 0 0 0 0 0 0 0 0 0 1 0 1 1| LINK_STATUS | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |0 0 0 1 0 1 0 0|0 0 0 0 0 1 0 0| HEARD | HEARD | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | SYMMETRIC | SYMMETRIC | MPR |0 0 0 0 0 0 1 0| +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |0 0 0 0 0 0 1 1|0 0 0 0 0 0 1 1| +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ Appendix D.3. Example TC Message An example TC message, using IPv4 (four octet) addresses, is as follows. The overall message length is 67 octets. The message has a message TLV block with content length 13 octets containing three TLVs. The first two TLVs are validity and interval times as for the HELLO message above. The third TLV is a content sequence number TLV used to carry the 2 octet ANSN. The semantics value is also 4. The message has three address blocks. The first address block contains 3 local interface addresses (with semantics octet 2, hence no tail section, head length 2 octets, and hence mid sections with Clausen, et al. Expires August 5, 2007 [Page 55] Internet-Draft OLSRv2 February 2007 length two octets) and has no TLVs (TLV block content length 0 octets). The other two address blocks contain neighbor interface addresses. The first contains 3 addresses (semantics octet 2, no tail section, head length 2 octets, hence mid sections length two octets) and has no TLVs (TLV block content length 0 octets). The second contains 1 address, with semantics octet 4 indicating that the tail section, length 2 octets, consists of zero valued octets (not included). The following TLV block (content length 6 octets) includes two TLVs, the first (semantics value 4 indicating no indexes are needed) indicates that the address has a netmask, with length given by the value (of length 1 octet) of 16. Thus this address is Head.0.0/16. The second TLV indicates that the originating node is a gateway to this network, at a given number of hops distance. The TLV semantics value of 4 indicates that no indexes are needed. Clausen, et al. Expires August 5, 2007 [Page 56] Internet-Draft OLSRv2 February 2007 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 +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | TC |0 0 0 0 0 0 0 0|0 0 0 0 0 0 0 0 0 1 0 0 0 1 0 0| +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | Originator Address | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | Hop Limit | Hop Count | Message Sequence Number | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |0 0 0 0 0 0 0 0 0 0 0 0 1 1 0 1| VALIDITY_TIME |0 0 0 0 0 1 0 0| +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |0 0 0 0 0 0 0 1| Value | INTERVAL_TIME |0 0 0 0 0 1 0 0| +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |0 0 0 0 0 0 0 1| Value | CONT_SEQ_NUM |0 0 0 0 0 1 0 0| +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |0 0 0 0 0 0 1 0| Value (ANSN) |0 0 0 0 0 0 1 1| +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | 0x02 |0 0 0 0 0 0 1 0| Head | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | Mid | Mid | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | Mid |0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0| +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |0 0 0 0 0 0 1 1| 0x02 |0 0 0 0 0 0 1 0| Head | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | Head (cont) | Mid | Mid | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | Mid (cont) | Mid |0 0 0 0 0 0 0 0| +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |0 0 0 0 0 0 0 0|0 0 0 0 0 0 0 1|0 0 0 0 0 1 0 0|0 0 0 0 0 0 1 0| +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | Head |0 0 0 0 0 0 1 0|0 0 0 0 0 0 0 0| +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |0 0 0 0 0 1 1 1| PREFIX_LENGTH |0 0 0 0 0 1 0 0|0 0 0 0 0 0 0 1| +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |0 0 0 1 0 0 0 0| GATEWAY |0 0 0 0 0 1 0 0| Number Hops | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ Clausen, et al. Expires August 5, 2007 [Page 57] Internet-Draft OLSRv2 February 2007 Appendix E. Time TLVs This appendix specifies a general time TLV structure for expressing either single time values or a set of time values with each value associated with a range of distances. Furthermore, using this general time TLV structure, this document specifies the INTERVAL_TIME and VALIDITY_TIME TLVs, which are used by OLSRv2. E.1. Representing Time This document specifies a TLV structure in which time values are each represented in an 8 bit time code, one or more of which may be used in a TLV's value field. Of these 8 bits, the least significant four bits represent the mantissa (a), and the most significant four bits represent the exponent (b), so that: o time value = (1 + a/16) * 2^b * C o time code = 16 * b + a All nodes in the network MUST use the same value of C, which will be specified in seconds, hence so will be all time values. Note that ascending values of the time code represent ascending time values, time values may thus be compared by comparison of time codes. An algorithm for computing the time code representing the smallest representable time value not less than the time value t is: 1. find the largest integer b such that t/C >= 2^b; 2. set a = 16 * (t / (C * 2^b) - 1), rounded up to the nearest integer; 3. if a == 16 then set b = b + 1 and set a = 0; 4. if a and b are in the range 0 and 15 then the required time value can be represented by the time code 16 * b + a, otherwise it can not. The minimum time value that can be represented in this manner is C. The maximum time value that can be represented in this manner is 63488 * C. E.2. General Time TLV Structure A Time TLV may be a packet, message or address block TLV. If it is a packet or message TLV then it must be a single value TLV as defined in [3]; if it is an address block TLV then it may be single value or Clausen, et al. Expires August 5, 2007 [Page 58] Internet-Draft OLSRv2 February 2007 multivalue TLV. The specific Time TLVs specified in this document, in Appendix E.3 are message, and hence single value, TLVs. Note that even a single value Time TLV may contain a multiple octet field. The purpose of a single value Time TLV is to allow a single time value to be determined by a node receiving an entity containing the Time TLV, based on its distance from the entity's originator. The Time TLV may contain information that allows that time value to be a function of distance, and thus different receiving nodes may determine different time values. If a receiving node will not be able to determine its distance from the originating node, then the form of this Time TLV with a single time code in a field (or single value subfield) SHOULD be used. The field of a single value Time TLV is specified, using the regular expression syntax of [3], by: = {