draft-ietf-babel-information-model-10.txt   draft-ietf-babel-information-model-11.txt 
Babel routing protocol B. Stark Babel routing protocol B. Stark
Internet-Draft AT&T Internet-Draft AT&T
Intended status: Informational M. Jethanandani Intended status: Informational M. Jethanandani
Expires: April 11, 2020 VMware Expires: February 15, 2021 VMware
October 9, 2019 August 14, 2020
Babel Information Model Babel Information Model
draft-ietf-babel-information-model-10 draft-ietf-babel-information-model-11
Abstract Abstract
This Babel Information Model provides structured data elements for a This Babel Information Model provides structured data elements for a
Babel implementation reporting its current state and may allow Babel implementation reporting its current state and may allow
limited configuration of some such data elements. This information limited configuration of some such data elements. This information
model can be used as a basis for creating data models under various model can be used as a basis for creating data models under various
data modeling regimes. data modeling regimes.
Status of This Memo Status of This Memo
skipping to change at page 1, line 35 skipping to change at page 1, line 35
Internet-Drafts are working documents of the Internet Engineering Internet-Drafts are working documents of the Internet Engineering
Task Force (IETF). Note that other groups may also distribute Task Force (IETF). Note that other groups may also distribute
working documents as Internet-Drafts. The list of current Internet- working documents as Internet-Drafts. The list of current Internet-
Drafts is at https://datatracker.ietf.org/drafts/current/. Drafts is at https://datatracker.ietf.org/drafts/current/.
Internet-Drafts are draft documents valid for a maximum of six months Internet-Drafts are draft documents valid for a maximum of six months
and may be updated, replaced, or obsoleted by other documents at any and may be updated, replaced, or obsoleted by other documents at any
time. It is inappropriate to use Internet-Drafts as reference time. It is inappropriate to use Internet-Drafts as reference
material or to cite them other than as "work in progress." material or to cite them other than as "work in progress."
This Internet-Draft will expire on April 11, 2020. This Internet-Draft will expire on February 15, 2021.
Copyright Notice Copyright Notice
Copyright (c) 2019 IETF Trust and the persons identified as the Copyright (c) 2020 IETF Trust and the persons identified as the
document authors. All rights reserved. document authors. All rights reserved.
This document is subject to BCP 78 and the IETF Trust's Legal This document is subject to BCP 78 and the IETF Trust's Legal
Provisions Relating to IETF Documents Provisions Relating to IETF Documents
(https://trustee.ietf.org/license-info) in effect on the date of (https://trustee.ietf.org/license-info) in effect on the date of
publication of this document. Please review these documents publication of this document. Please review these documents
carefully, as they describe your rights and restrictions with respect carefully, as they describe your rights and restrictions with respect
to this document. Code Components extracted from this document must to this document. Code Components extracted from this document must
include Simplified BSD License text as described in Section 4.e of include Simplified BSD License text as described in Section 4.e of
the Trust Legal Provisions and are provided without warranty as the Trust Legal Provisions and are provided without warranty as
described in the Simplified BSD License. described in the Simplified BSD License.
Table of Contents Table of Contents
1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . 2 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . 2
1.1. Requirements Language . . . . . . . . . . . . . . . . . . 3 1.1. Requirements Language . . . . . . . . . . . . . . . . . . 3
1.2. Notation . . . . . . . . . . . . . . . . . . . . . . . . 3 1.2. Notation . . . . . . . . . . . . . . . . . . . . . . . . 3
2. Overview . . . . . . . . . . . . . . . . . . . . . . . . . . 4 2. Overview . . . . . . . . . . . . . . . . . . . . . . . . . . 4
3. The Information Model . . . . . . . . . . . . . . . . . . . . 7 3. The Information Model . . . . . . . . . . . . . . . . . . . . 7
3.1. Definition of babel-information-obj . . . . . . . . . . . 7 3.1. Definition of babel-information-obj . . . . . . . . . . . 7
3.2. Definition of babel-constants-obj . . . . . . . . . . . . 8 3.2. Definition of babel-constants-obj . . . . . . . . . . . . 9
3.3. Definition of babel-interfaces-obj . . . . . . . . . . . 9 3.3. Definition of babel-interface-obj . . . . . . . . . . . . 9
3.4. Definition of babel-if-stats-obj . . . . . . . . . . . . 11 3.4. Definition of babel-if-stats-obj . . . . . . . . . . . . 12
3.5. Definition of babel-neighbors-obj . . . . . . . . . . . . 12 3.5. Definition of babel-neighbor-obj . . . . . . . . . . . . 12
3.6. Definition of babel-routes-obj . . . . . . . . . . . . . 14 3.6. Definition of babel-route-obj . . . . . . . . . . . . . . 14
3.7. Definition of babel-mac-key-sets-obj . . . . . . . . . . 15 3.7. Definition of babel-mac-key-set-obj . . . . . . . . . . . 15
3.8. Definition of babel-mac-keys-obj . . . . . . . . . . . . 16 3.8. Definition of babel-mac-key-obj . . . . . . . . . . . . . 16
3.9. Definition of babel-dtls-cert-sets-obj . . . . . . . . . 17 3.9. Definition of babel-dtls-cert-set-obj . . . . . . . . . . 17
3.10. Definition of babel-dtls-certs-obj . . . . . . . . . . . 17 3.10. Definition of babel-dtls-cert-obj . . . . . . . . . . . . 17
4. Extending the Information Model . . . . . . . . . . . . . . . 18 4. Extending the Information Model . . . . . . . . . . . . . . . 18
5. Security Considerations . . . . . . . . . . . . . . . . . . . 18 5. Security Considerations . . . . . . . . . . . . . . . . . . . 18
6. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 19 6. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 19
7. Acknowledgements . . . . . . . . . . . . . . . . . . . . . . 19 7. Acknowledgements . . . . . . . . . . . . . . . . . . . . . . 19
8. References . . . . . . . . . . . . . . . . . . . . . . . . . 19 8. References . . . . . . . . . . . . . . . . . . . . . . . . . 19
8.1. Normative References . . . . . . . . . . . . . . . . . . 19 8.1. Normative References . . . . . . . . . . . . . . . . . . 19
8.2. Informative References . . . . . . . . . . . . . . . . . 20 8.2. Informative References . . . . . . . . . . . . . . . . . 20
Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . 21 Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . 21
1. Introduction 1. Introduction
skipping to change at page 5, line 13 skipping to change at page 5, line 13
| +-- babel-packet-log-enable | +-- babel-packet-log-enable
| +-- babel-packet-log | +-- babel-packet-log
| +-- babel-if-stats | +-- babel-if-stats
| | +-- babel-sent-mcast-hello | | +-- babel-sent-mcast-hello
| | +-- babel-sent-mcast-update | | +-- babel-sent-mcast-update
| | +-- babel-sent-ucast-hello | | +-- babel-sent-ucast-hello
| | +-- babel-sent-ucast-update | | +-- babel-sent-ucast-update
| | +-- babel-sent-IHU | | +-- babel-sent-IHU
| | +-- babel-received-packets | | +-- babel-received-packets
| +-- babel-neighbors | +-- babel-neighbors
| | +-- babel-neighbor-address | +-- babel-neighbor-address
| | +-- babel-hello-mcast-history | +-- babel-hello-mcast-history
| | +-- babel-hello-ucast-history | +-- babel-hello-ucast-history
| | +-- babel-txcost | +-- babel-txcost
| | +-- babel-exp-mcast-hello-seqno | +-- babel-exp-mcast-hello-seqno
| | +-- babel-exp-ucast-hello-seqno | +-- babel-exp-ucast-hello-seqno
| | +-- babel-ucast-hello-seqno | +-- babel-ucast-hello-seqno
| | +-- babel-ucast-hello-interval | +-- babel-ucast-hello-interval
| | +-- babel-rxcost | +-- babel-rxcost
| | +-- babel-cost | +-- babel-cost
+-- babel-routes +-- babel-routes
| +-- babel-route-prefix | +-- babel-route-prefix
| +-- babel-route-prefix-length | +-- babel-route-prefix-length
| +-- babel-route-router-id | +-- babel-route-router-id
| +-- babel-route-neighbor | +-- babel-route-neighbor
| +-- babel-route-received-metric | +-- babel-route-received-metric
| +-- babel-route-calculated-metric | +-- babel-route-calculated-metric
| +-- babel-route-seqno | +-- babel-route-seqno
| +-- babel-route-next-hop | +-- babel-route-next-hop
| +-- babel-route-feasible | +-- babel-route-feasible
| +-- babel-route-selected | +-- babel-route-selected
+-- babel-mac-key-sets +-- babel-mac-key-sets
| +-- babel-mac-default-apply | +-- babel-mac-default-apply
| +-- babel-mac-keys | +-- babel-mac-keys
| | +-- babel-mac-key-name | +-- babel-mac-key-name
| | +-- babel-mac-key-use-sign | +-- babel-mac-key-use-sign
| | +-- babel-mac-key-use-verify | +-- babel-mac-key-use-verify
| | +-- babel-mac-key-value | +-- babel-mac-key-value
| | +-- babel-mac-key-algorithm | +-- babel-mac-key-algorithm
| | +-- babel-mac-key-test | +-- babel-mac-key-test
+-- babel-dtls-cert-sets +-- babel-dtls-cert-sets
| +-- babel-dtls-default-apply +-- babel-dtls-default-apply
| +-- babel-dtls-certs +-- babel-dtls-certs
| | +-- babel-cert-name +-- babel-cert-name
| | +-- babel-cert-value +-- babel-cert-value
| | +-- babel-cert-type +-- babel-cert-type
| | +-- babel-cert-private-key +-- babel-cert-private-key
| | +-- babel-cert-test +-- babel-cert-test
Most parameters are read-only. Following is a descriptive list of Most parameters are read-only. Following is a descriptive list of
the parameters that are not required to be read-only: the parameters that are not required to be read-only:
o enable/disable Babel o enable/disable Babel
o create/delete Babel MAC Key sets o create/delete Babel MAC Key sets
o create/delete Babel DTLS Certificate sets o create/delete Babel DTLS Certificate sets
skipping to change at page 7, line 13 skipping to change at page 7, line 13
o DTLS certificate values o DTLS certificate values
Note that this overview is intended simply to be informative and is Note that this overview is intended simply to be informative and is
not normative. If there is any discrepancy between this overview and not normative. If there is any discrepancy between this overview and
the detailed information model definitions in subsequent sections, the detailed information model definitions in subsequent sections,
the error is in this overview. the error is in this overview.
3. The Information Model 3. The Information Model
3.1. Definition of babel-information-obj 3.1. Definition of babel-information-obj
object { object {
string ro babel-implementation-version; string ro babel-implementation-version;
boolean rw babel-enable; boolean rw babel-enable;
binary ro babel-self-router-id; binary ro babel-self-router-id;
[uint ro babel-self-seqno;] [uint ro babel-self-seqno;]
string ro babel-metric-comp-algorithms<1..*>; string ro babel-metric-comp-algorithms<1..*>;
string ro babel-security-supported<0..*>; string ro babel-security-supported<0..*>;
[string ro babel-mac-algorithms<1..*>;] [string ro babel-mac-algorithms<1..*>;]
[string ro babel-dtls-cert-types<1..*>;] [string ro babel-dtls-cert-types<1..*>;]
[boolean rw babel-stats-enable;] [boolean rw babel-stats-enable;]
[operation babel-stats-reset;] [operation babel-stats-reset;]
babel-constants-obj ro babel-constants; babel-constants-obj ro babel-constants;
babel-interfaces-obj ro babel-interfaces<0..*>; babel-interface-obj ro babel-interfaces<0..*>;
babel-routes-obj ro babel-routes<0..*>; babel-route-obj ro babel-routes<0..*>;
[babel-mac-key-sets-obj rw babel-mac-key-sets<0..*>;] [babel-mac-key-set-obj rw babel-mac-key-sets<0..*>;]
[babel-dtls-cert-sets-obj rw babel-dtls-cert-sets<0..*>;] [babel-dtls-cert-set-obj rw babel-dtls-cert-sets<0..*>;]
} babel-information-obj; } babel-information-obj;
babel-implementation-version: The name and version of this babel-implementation-version: The name and version of this
implementation of the Babel protocol. implementation of the Babel protocol.
babel-enable: When written, it configures whether the protocol babel-enable: When written, it configures whether the protocol
should be enabled (true) or disabled (false). A read from the should be enabled (true) or disabled (false). A read from the
running or intended datastore indicates the configured running or intended datastore indicates the configured
administrative value of whether the protocol is enabled (true) or administrative value of whether the protocol is enabled (true) or
not (false). A read from the operational datastore indicates not (false). A read from the operational datastore indicates
whether the protocol is actually running (true) or not (i.e., it whether the protocol is actually running (true) or not (i.e., it
skipping to change at page 8, line 10 skipping to change at page 8, line 10
babel-self-router-id: The router-id used by this instance of the babel-self-router-id: The router-id used by this instance of the
Babel protocol to identify itself. [I-D.ietf-babel-rfc6126bis] Babel protocol to identify itself. [I-D.ietf-babel-rfc6126bis]
describes this as an arbitrary string of 8 octets. The router-id describes this as an arbitrary string of 8 octets. The router-id
value MUST NOT consist of all zeroes or all ones. value MUST NOT consist of all zeroes or all ones.
babel-self-seqno: The current sequence number included in route babel-self-seqno: The current sequence number included in route
updates for routes originated by this node. This is a 16-bit updates for routes originated by this node. This is a 16-bit
unsigned integer. unsigned integer.
babel-metric-comp-algorithms: List of supported cost computation babel-metric-comp-algorithms: List of supported cost computation
algorithms. Possible values include "2-out-of-3", and "ETX". "2- algorithms. Possible values include "2-out-of-3", and "ETX". "2-
out-of-3" is described in [I-D.ietf-babel-rfc6126bis], section out-of-3" is described in [I-D.ietf-babel-rfc6126bis], section
A.2.1. "ETX" is described in [I-D.ietf-babel-rfc6126bis], section A.2.1. "ETX" is described in [I-D.ietf-babel-rfc6126bis], section
A.2.2. A.2.2.
babel-security-supported: List of supported security mechanisms. babel-security-supported: List of supported security mechanisms.
Possible values include "MAC" and "DTLS". Possible values include "MAC" and "DTLS".
babel-mac-algorithms: List of supported MAC computation algorithms. babel-mac-algorithms: List of supported MAC computation algorithms.
Possible values include "HMAC-SHA256", "BLAKE2s". Possible values include "HMAC-SHA256", "BLAKE2s".
babel-dtls-cert-types: List of supported DTLS certificate types. babel-dtls-cert-types: List of supported DTLS certificate types.
Possible values include "X.509" and "RawPublicKey". Possible values include "X.509" and "RawPublicKey".
babel-stats-enable: Indicates whether statistics collection is babel-stats-enable: Indicates whether statistics collection is
enabled (true) or disabled (false) on all interfaces. enabled (true) or disabled (false) on all interfaces. When
enabled, existing statistics values are not cleared and will be
incremented as new packets are counted.
babel-stats-reset: An operation that resets all babel-if-stats babel-stats-reset: An operation that resets all babel-if-stats
parameters to zero. This operation has no input or output parameters to zero. This operation has no input or output
parameters. parameters.
babel-constants: A babel-constants-obj object. babel-constants: A babel-constants-obj object.
babel-interfaces: A set of babel-interface-obj objects. babel-interfaces: A set of babel-interface-obj objects.
babel-routes: A set of babel-route-obj objects. Contains the routes babel-routes: A set of babel-route-obj objects. Contains the routes
known to this node. known to this node.
babel-mac-key-sets: A babel-mac-key-sets-obj object. If this object babel-mac-key-sets: A set of babel-mac-key-set-obj objects. If this
is implemented, it provides access to parameters related to the
MAC security mechanism. An implementation MAY choose to expose
this object as read-only ("ro").
babel-dtls-cert-sets: A babel-dtls-cert-sets-obj object. If this
object is implemented, it provides access to parameters related to object is implemented, it provides access to parameters related to
the DTLS security mechanism. An implementation MAY choose to the MAC security mechanism. An implementation MAY choose to
expose this object as read-only ("ro"). expose this object as read-only ("ro").
babel-dtls-cert-sets: A set of babel-dtls-cert-set-obj objects. If
this object is implemented, it provides access to parameters
related to the DTLS security mechanism. An implementation MAY
choose to expose this object as read-only ("ro").
3.2. Definition of babel-constants-obj 3.2. Definition of babel-constants-obj
object {
uint rw babel-udp-port; object {
[ip-address rw babel-mcast-group;] uint rw babel-udp-port;
} babel-constants-obj; [ip-address rw babel-mcast-group;]
} babel-constants-obj;
babel-udp-port: UDP port for sending and listening for Babel babel-udp-port: UDP port for sending and listening for Babel
packets. Default is 6696. An implementation MAY choose to expose packets. Default is 6696. An implementation MAY choose to expose
this parameter as read-only ("ro"). This is a 16-bit unsigned this parameter as read-only ("ro"). This is a 16-bit unsigned
integer. integer.
babel-mcast-group: Multicast group for sending and listening to babel-mcast-group: Multicast group for sending and listening to
multicast announcements on IPv6. Default is ff02::1:6. An multicast announcements on IPv6. Default is ff02::1:6. An
implementation MAY choose to expose this parameter as read-only implementation MAY choose to expose this parameter as read-only
("ro"). ("ro").
3.3. Definition of babel-interfaces-obj 3.3. Definition of babel-interface-obj
object { object {
reference ro babel-interface-reference; reference ro babel-interface-reference;
[boolean rw babel-interface-enable;] [boolean rw babel-interface-enable;]
string rw babel-interface-metric-algorithm; string rw babel-interface-metric-algorithm;
[boolean rw babel-interface-split-horizon;] [boolean rw babel-interface-split-horizon;]
[uint ro babel-mcast-hello-seqno;] [uint ro babel-mcast-hello-seqno;]
[uint ro babel-mcast-hello-interval;] [uint ro babel-mcast-hello-interval;]
[uint ro babel-update-interval;] [uint ro babel-update-interval;]
[boolean rw babel-mac-enable;] [boolean rw babel-mac-enable;]
[reference rw babel-if-mac-key-sets<0..*>;] [reference rw babel-if-mac-key-sets<0..*>;]
[boolean rw babel-mac-verify;] [boolean rw babel-mac-verify;]
[boolean rw babel-dtls-enable;] [boolean rw babel-dtls-enable;]
[reference rw babel-if-dtls-cert-sets<0..*>;] [reference rw babel-if-dtls-cert-sets<0..*>;]
[boolean rw babel-dtls-cached-info;] [boolean rw babel-dtls-cached-info;]
[string rw babel-dtls-cert-prefer<0..*>;] [string rw babel-dtls-cert-prefer<0..*>;]
[boolean rw babel-packet-log-enable;] [boolean rw babel-packet-log-enable;]
[reference ro babel-packet-log;] [reference ro babel-packet-log;]
[babel-if-stats-obj ro babel-if-stats;] [babel-if-stats-obj ro babel-if-stats;]
babel-neighbors-obj ro babel-neighbors<0..*>; babel-neighbor-obj ro babel-neighbors<0..*>;
} babel-interfaces-obj; } babel-interface-obj;
babel-interface-reference: Reference to an interface object that can babel-interface-reference: Reference to an interface object that can
be used to send and receive IPv6 packets, as defined by the data be used to send and receive IPv6 packets, as defined by the data
model (e.g., YANG [RFC7950], BBF [TR-181]). Referencing syntax model (e.g., YANG [RFC7950], BBF [TR-181]). Referencing syntax
will be specific to the data model. If there is no set of will be specific to the data model. If there is no set of
interface objects available, this should be a string that interface objects available, this should be a string that
indicates the interface name used by the underlying operating indicates the interface name used by the underlying operating
system. system.
babel-interface-enable: When written, it configures whether the babel-interface-enable: When written, it configures whether the
skipping to change at page 11, line 39 skipping to change at page 11, line 43
empty babel-cert-private-key will be used to populate the empty babel-cert-private-key will be used to populate the
client_certificate_type extension in a Client Hello. client_certificate_type extension in a Client Hello.
babel-packet-log-enable: Indicates whether packet logging is enabled babel-packet-log-enable: Indicates whether packet logging is enabled
(true) or disabled (false) on this interface. (true) or disabled (false) on this interface.
babel-packet-log: A reference or url link to a file that contains a babel-packet-log: A reference or url link to a file that contains a
timestamped log of packets received and sent on babel-udp-port on timestamped log of packets received and sent on babel-udp-port on
this interface. The [libpcap] file format with .pcap file this interface. The [libpcap] file format with .pcap file
extension SHOULD be supported for packet log files. Logging is extension SHOULD be supported for packet log files. Logging is
enabled / disabled by babel-packet-log-enable. enabled / disabled by babel-packet-log-enable. Implementations
will need to carefully manage and limit memory used by packet
logs.
babel-if-stats: Statistics collection object for this interface. babel-if-stats: Statistics collection object for this interface.
babel-neighbors: A set of babel-neighbors-obj objects. babel-neighbors: A set of babel-neighbor-obj objects.
3.4. Definition of babel-if-stats-obj 3.4. Definition of babel-if-stats-obj
object {
uint ro babel-sent-mcast-hello; object {
uint ro babel-sent-mcast-update; uint ro babel-sent-mcast-hello;
uint ro babel-sent-ucast-hello; uint ro babel-sent-mcast-update;
uint ro babel-sent-ucast-update; uint ro babel-sent-ucast-hello;
uint ro babel-sent-IHU; uint ro babel-sent-ucast-update;
uint ro babel-received-packets; uint ro babel-sent-IHU;
} babel-if-stats-obj; uint ro babel-received-packets;
} babel-if-stats-obj;
babel-sent-mcast-hello: A count of the number of multicast Hello babel-sent-mcast-hello: A count of the number of multicast Hello
packets sent on this interface. packets sent on this interface.
babel-sent-mcast-update: A count of the number of multicast update babel-sent-mcast-update: A count of the number of multicast update
packets sent on this interface. packets sent on this interface.
babel-sent-ucast-hello: A count of the number of unicast Hello babel-sent-ucast-hello: A count of the number of unicast Hello
packets sent on this interface. packets sent on this interface.
babel-sent-ucast-update: A count of the number of unicast update babel-sent-ucast-update: A count of the number of unicast update
packets sent on this interface. packets sent on this interface.
babel-sent-IHU: A count of the number of IHU packets sent on this babel-sent-IHU: A count of the number of IHU packets sent on this
interface. interface.
babel-received-packets: A count of the number of Babel packets babel-received-packets: A count of the number of Babel packets
received on this interface. received on this interface.
3.5. Definition of babel-neighbors-obj 3.5. Definition of babel-neighbor-obj
object { object {
ip-address ro babel-neighbor-address; ip-address ro babel-neighbor-address;
[binary ro babel-hello-mcast-history;] [binary ro babel-hello-mcast-history;]
[binary ro babel-hello-ucast-history;] [binary ro babel-hello-ucast-history;]
uint ro babel-txcost; uint ro babel-txcost;
uint ro babel-exp-mcast-hello-seqno; uint ro babel-exp-mcast-hello-seqno;
uint ro babel-exp-ucast-hello-seqno; uint ro babel-exp-ucast-hello-seqno;
[uint ro babel-ucast-hello-seqno;] [uint ro babel-ucast-hello-seqno;]
[uint ro babel-ucast-hello-interval;] [uint ro babel-ucast-hello-interval;]
[uint ro babel-rxcost;] [uint ro babel-rxcost;]
[uint ro babel-cost;] [uint ro babel-cost;]
} babel-neighbors-obj; } babel-neighbor-obj;
babel-neighbor-address: IPv4 or IPv6 address the neighbor sends babel-neighbor-address: IPv4 or IPv6 address the neighbor sends
packets from. packets from.
babel-hello-mcast-history: The multicast Hello history of whether or babel-hello-mcast-history: The multicast Hello history of whether or
not the multicast Hello packets prior to babel-exp-mcast-hello- not the multicast Hello packets prior to babel-exp-mcast-hello-
seqno were received. A binary sequence where the most recently seqno were received. A binary sequence where the most recently
received Hello is expressed as a "1" placed in the left-most bit, received Hello is expressed as a "1" placed in the left-most bit,
with prior bits shifted right (and "0" bits placed between prior with prior bits shifted right (and "0" bits placed between prior
Hello bits and most recent Hello for any not-received Hellos). Hello bits and most recent Hello for any not-received Hellos).
skipping to change at page 14, line 17 skipping to change at page 14, line 21
combined with other data, such as statistics maintained by the combined with other data, such as statistics maintained by the
link layer. The rxcost is sent to a neighbor in each IHU. See link layer. The rxcost is sent to a neighbor in each IHU. See
[I-D.ietf-babel-rfc6126bis], section 3.4.3. This is a 16-bit [I-D.ietf-babel-rfc6126bis], section 3.4.3. This is a 16-bit
unsigned integer. unsigned integer.
babel-cost: The link cost, as computed from the values maintained in babel-cost: The link cost, as computed from the values maintained in
the neighbor table: the statistics kept in the neighbor table the neighbor table: the statistics kept in the neighbor table
about the reception of Hellos, and the txcost computed from about the reception of Hellos, and the txcost computed from
received IHU packets. This is a 16-bit unsigned integer. received IHU packets. This is a 16-bit unsigned integer.
3.6. Definition of babel-routes-obj 3.6. Definition of babel-route-obj
object { object {
ip-address ro babel-route-prefix; ip-address ro babel-route-prefix;
uint ro babel-route-prefix-length; uint ro babel-route-prefix-length;
binary ro babel-route-router-id; binary ro babel-route-router-id;
string ro babel-route-neighbor; string ro babel-route-neighbor;
uint ro babel-route-received-metric; uint ro babel-route-received-metric;
uint ro babel-route-calculated-metric; uint ro babel-route-calculated-metric;
uint ro babel-route-seqno; uint ro babel-route-seqno;
ip-address ro babel-route-next-hop; ip-address ro babel-route-next-hop;
boolean ro babel-route-feasible; boolean ro babel-route-feasible;
boolean ro babel-route-selected; boolean ro babel-route-selected;
} babel-routes-obj; } babel-route-obj;
babel-route-prefix: Prefix (expressed in IP address format) for babel-route-prefix: Prefix (expressed in IP address format) for
which this route is advertised. which this route is advertised.
babel-route-prefix-length: Length of the prefix for which this route babel-route-prefix-length: Length of the prefix for which this route
is advertised. is advertised.
babel-route-router-id: The router-id of the router that originated babel-route-router-id: The router-id of the router that originated
this route. this route.
skipping to change at page 15, line 34 skipping to change at page 15, line 38
be empty if this route has no next-hop address. be empty if this route has no next-hop address.
babel-route-feasible: A Boolean flag indicating whether this route babel-route-feasible: A Boolean flag indicating whether this route
is feasible, as defined in Section 3.5.1 of is feasible, as defined in Section 3.5.1 of
[I-D.ietf-babel-rfc6126bis]). [I-D.ietf-babel-rfc6126bis]).
babel-route-selected: A Boolean flag indicating whether this route babel-route-selected: A Boolean flag indicating whether this route
is selected (i.e., whether it is currently being used for is selected (i.e., whether it is currently being used for
forwarding and is being advertised). forwarding and is being advertised).
3.7. Definition of babel-mac-key-sets-obj 3.7. Definition of babel-mac-key-set-obj
object { object {
boolean rw babel-mac-default-apply; boolean rw babel-mac-default-apply;
babel-mac-keys-obj rw babel-mac-keys<0..*>; babel-mac-key-obj rw babel-mac-keys<0..*>;
} babel-mac-obj; } babel-mac-obj;
babel-mac-default-apply: A Boolean flag indicating whether this babel-mac-default-apply: A Boolean flag indicating whether this
babel-mac instance is applied to all new babel-interface babel-mac instance is applied to all new babel-interface
instances, by default. If "true", this instance is applied to new instances, by default. If "true", this instance is applied to new
babel-interfaces instances at the time they are created, by babel-interfaces instances at the time they are created, by
including it in the babel-interface-mac-keys list. If "false", including it in the babel-interface-mac-keys list. If "false",
this instance is not applied to new babel-interfaces instances this instance is not applied to new babel-interfaces instances
when they are created. An implementation MAY choose to expose when they are created. An implementation MAY choose to expose
this parameter as read-only ("ro"). this parameter as read-only ("ro").
babel-mac-keys: A set of babel-mac-keys-obj objects. babel-mac-keys: A set of babel-mac-key-obj objects.
3.8. Definition of babel-mac-keys-obj 3.8. Definition of babel-mac-key-obj
object { object {
string rw babel-mac-key-name; string rw babel-mac-key-name;
boolean rw babel-mac-key-use-sign; boolean rw babel-mac-key-use-sign;
boolean rw babel-mac-key-use-verify; boolean rw babel-mac-key-use-verify;
binary -- babel-mac-key-value; binary -- babel-mac-key-value;
string rw babel-mac-key-algorithm; string rw babel-mac-key-algorithm;
[operation babel-mac-key-test;] [operation babel-mac-key-test;]
} babel-mac-keys-obj; } babel-mac-key-obj;
babel-mac-key-name: A unique name for this MAC key that can be used babel-mac-key-name: A unique name for this MAC key that can be used
to identify the key in this object instance, since the key value to identify the key in this object instance, since the key value
is not allowed to be read. This value MUST NOT be empty and can is not allowed to be read. This value MUST NOT be empty and can
only be provided when this instance is created (i.e., it is not only be provided when this instance is created (i.e., it is not
subsequently writable). The value MAY be auto-generated if not subsequently writable). The value MAY be auto-generated if not
explicitly supplied when the instance is created. explicitly supplied when the instance is created.
babel-key-use-sign: Indicates whether this key value is used to sign babel-mac-key-use-sign: Indicates whether this key value is used to
sent Babel packets. Sent packets are signed using this key if the sign sent Babel packets. Sent packets are signed using this key
value is "true". If the value is "false", this key is not used to if the value is "true". If the value is "false", this key is not
sign sent Babel packets. An implementation MAY choose to expose used to sign sent Babel packets. An implementation MAY choose to
this parameter as read-only ("ro"). expose this parameter as read-only ("ro").
babel-key-use-verify: Indicates whether this key value is used to babel-mac-key-use-verify: Indicates whether this key value is used
verify incoming Babel packets. This key is used to verify to verify incoming Babel packets. This key is used to verify
incoming packets if the value is "true". If the value is "false", incoming packets if the value is "true". If the value is "false",
no MAC is computed from this key for comparing with the MAC in an no MAC is computed from this key for comparing with the MAC in an
incoming packet. An implementation MAY choose to expose this incoming packet. An implementation MAY choose to expose this
parameter as read-only ("ro"). parameter as read-only ("ro").
babel-key-value: The value of the MAC key. An implementation MUST babel-mac-key-value: The value of the MAC key. An implementation
NOT allow this parameter to be read. This can be done by always MUST NOT allow this parameter to be read. This can be done by
providing an empty string when read, or through permissions, or always providing an empty string when read, or through
other means. This value MUST be provided when this instance is permissions, or other means. This value MUST be provided when
created, and is not subsequently writable. This value is of a this instance is created, and is not subsequently writable. This
length suitable for the associated babel-mac-key-algorithm. If value is of a length suitable for the associated babel-mac-key-
the algorithm is based on the HMAC construction [RFC2104], the algorithm. If the algorithm is based on the HMAC construction
length MUST be between 0 and the block size of the underlying hash [RFC2104], the length MUST be between 0 and the block size of the
inclusive (where "HMAC-SHA256" block size is 64 bytes as described underlying hash inclusive (where "HMAC-SHA256" block size is 64
in [RFC4868]). If the algorithm is "BLAKE2s", the length MUST be bytes as described in [RFC4868]). If the algorithm is "BLAKE2s",
between 0 and 32 bytes inclusive, as described in [RFC7693]. the length MUST be between 0 and 32 bytes inclusive, as described
in [RFC7693].
babel-mac-key-algorithm The name of the MAC algorithm used with this babel-mac-key-algorithm The name of the MAC algorithm used with this
key. The value MUST be the same as one of the enumerations listed key. The value MUST be the same as one of the enumerations listed
in the babel-mac-algorithms parameter. An implementation MAY in the babel-mac-algorithms parameter. An implementation MAY
choose to expose this parameter as read-only ("ro"). choose to expose this parameter as read-only ("ro").
babel-mac-test: An operation that allows the MAC key and hash babel-mac-key-test: An operation that allows the MAC key and hash
algorithm to be tested to see if they produce an expected outcome. algorithm to be tested to see if they produce an expected outcome.
Input to this operation is a binary string. The implementation is Input to this operation is a binary string. The implementation is
expected to create a hash of this string using the babel-mac-key- expected to create a hash of this string using the babel-mac-key-
value and the babel-mac-algorithm. The output of this operation value and the babel-mac-key-algorithm. The output of this
is the resulting hash, as a binary string. operation is the resulting hash, as a binary string.
3.9. Definition of babel-dtls-cert-sets-obj 3.9. Definition of babel-dtls-cert-set-obj
object { object {
boolean rw babel-dtls-default-apply; boolean rw babel-dtls-default-apply;
babel-dtls-certs-obj rw babel-dtls-certs<0..*>; babel-dtls-cert-obj rw babel-dtls-certs<0..*>;
} babel-dtls-obj; } babel-dtls-cert-set-obj;
babel-dtls-default-apply: A Boolean flag indicating whether this babel-dtls-default-apply: A Boolean flag indicating whether this
babel-dtls instance is applied to all new babel-interface babel-dtls instance is applied to all new babel-interface
instances, by default. If "true", this instance is applied to new instances, by default. If "true", this instance is applied to new
babel-interfaces instances at the time they are created, by babel-interfaces instances at the time they are created, by
including it in the babel-interface-dtls-certs list. If "false", including it in the babel-interface-dtls-certs list. If "false",
this instance is not applied to new babel-interfaces instances this instance is not applied to new babel-interfaces instances
when they are created. An implementation MAY choose to expose when they are created. An implementation MAY choose to expose
this parameter as read-only ("ro"). this parameter as read-only ("ro").
babel-dtls-certs: A set of babel-dtls-keys-obj objects. This babel-dtls-certs: A set of babel-dtls-cert-obj objects. This
contains both certificates for this implementation to present for contains both certificates for this implementation to present for
authentication, and to accept from others. Certificates with a authentication, and to accept from others. Certificates with a
non-empty babel-cert-private-key can be presented by this non-empty babel-cert-private-key can be presented by this
implementation for authentication. implementation for authentication.
3.10. Definition of babel-dtls-certs-obj 3.10. Definition of babel-dtls-cert-obj
object { object {
string rw babel-cert-name; string rw babel-cert-name;
string rw babel-cert-value; string rw babel-cert-value;
string rw babel-cert-type; string rw babel-cert-type;
binary -- babel-cert-private-key; binary -- babel-cert-private-key;
[operation babel-cert-test;] [operation babel-cert-test;]
} babel-dtls-certs-obj; } babel-dtls-cert-obj;
babel-cert-name: A unique name for this DTLS certificate that can be babel-cert-name: A unique name for this DTLS certificate that can be
used to identify the certificate in this object instance, since used to identify the certificate in this object instance, since
the value is too long to be useful for identification. This value the value is too long to be useful for identification. This value
MUST NOT be empty and can only be provided when this instance is MUST NOT be empty and can only be provided when this instance is
created (i.e., it is not subsequently writable). The value MAY be created (i.e., it is not subsequently writable). The value MAY be
auto-generated if not explicitly supplied when the instance is auto-generated if not explicitly supplied when the instance is
created. created.
babel-cert-value: The DTLS certificate in PEM format [RFC7468]. babel-cert-value: The DTLS certificate in PEM format [RFC7468].
skipping to change at page 19, line 29 skipping to change at page 19, line 34
algorithm associated with the key. Short (and zero-length) keys and algorithm associated with the key. Short (and zero-length) keys and
keys that make use of only alphanumeric characters are highly keys that make use of only alphanumeric characters are highly
susceptible to brute force attacks. susceptible to brute force attacks.
6. IANA Considerations 6. IANA Considerations
This document has no IANA actions. This document has no IANA actions.
7. Acknowledgements 7. Acknowledgements
Juliusz Chroboczek, Toke Hoeiland-Joergensen, David Schinazi, Acee Juliusz Chroboczek, Toke Hoeiland-Joergensen, David Schinazi, Antonin
Lindem, and Carsten Bormann have been very helpful in refining this Decimo, Acee Lindem, and Carsten Bormann have been very helpful in
information model. refining this information model.
The language in the Notation section was mostly taken from [RFC8193]. The language in the Notation section was mostly taken from [RFC8193].
8. References 8. References
8.1. Normative References 8.1. Normative References
[I-D.ietf-babel-rfc6126bis] [I-D.ietf-babel-rfc6126bis]
Chroboczek, J. and D. Schinazi, "The Babel Routing Chroboczek, J. and D. Schinazi, "The Babel Routing
Protocol", draft-ietf-babel-rfc6126bis-14 (work in Protocol", draft-ietf-babel-rfc6126bis-19 (work in
progress), August 2019. progress), August 2020.
[libpcap] Wireshark, "Libpcap File Format", 2015, [libpcap] Wireshark, "Libpcap File Format", 2015,
<https://wiki.wireshark.org/Development/ <https://wiki.wireshark.org/Development/
LibpcapFileFormat>. LibpcapFileFormat>.
[RFC2119] Bradner, S., "Key words for use in RFCs to Indicate [RFC2119] Bradner, S., "Key words for use in RFCs to Indicate
Requirement Levels", BCP 14, RFC 2119, Requirement Levels", BCP 14, RFC 2119,
DOI 10.17487/RFC2119, March 1997, DOI 10.17487/RFC2119, March 1997,
<https://www.rfc-editor.org/info/rfc2119>. <https://www.rfc-editor.org/info/rfc2119>.
skipping to change at page 20, line 18 skipping to change at page 20, line 23
[RFC8174] Leiba, B., "Ambiguity of Uppercase vs Lowercase in RFC [RFC8174] Leiba, B., "Ambiguity of Uppercase vs Lowercase in RFC
2119 Key Words", BCP 14, RFC 8174, DOI 10.17487/RFC8174, 2119 Key Words", BCP 14, RFC 8174, DOI 10.17487/RFC8174,
May 2017, <https://www.rfc-editor.org/info/rfc8174>. May 2017, <https://www.rfc-editor.org/info/rfc8174>.
8.2. Informative References 8.2. Informative References
[I-D.ietf-babel-dtls] [I-D.ietf-babel-dtls]
Decimo, A., Schinazi, D., and J. Chroboczek, "Babel Decimo, A., Schinazi, D., and J. Chroboczek, "Babel
Routing Protocol over Datagram Transport Layer Security", Routing Protocol over Datagram Transport Layer Security",
draft-ietf-babel-dtls-09 (work in progress), August 2019. draft-ietf-babel-dtls-10 (work in progress), June 2020.
[I-D.ietf-babel-hmac] [I-D.ietf-babel-hmac]
Do, C., Kolodziejak, W., and J. Chroboczek, "MAC Do, C., Kolodziejak, W., and J. Chroboczek, "MAC
authentication for the Babel routing protocol", draft- authentication for the Babel routing protocol", draft-
ietf-babel-hmac-10 (work in progress), August 2019. ietf-babel-hmac-10 (work in progress), August 2019.
[ISO.10646] [ISO.10646]
International Organization for Standardization, International Organization for Standardization,
"Information Technology - Universal Multiple-Octet Coded "Information Technology - Universal Multiple-Octet Coded
Character Set (UCS)", ISO Standard 10646:2014, 2014. Character Set (UCS)", ISO Standard 10646:2014, 2014.
 End of changes. 42 change blocks. 
180 lines changed or deleted 187 lines changed or added

This html diff was produced by rfcdiff 1.48. The latest version is available from http://tools.ietf.org/tools/rfcdiff/