diff --git a/doc/models/Makefile b/doc/models/Makefile index 23fbb4072..b723cf45f 100644 --- a/doc/models/Makefile +++ b/doc/models/Makefile @@ -126,6 +126,7 @@ SOURCEFIGS = \ $(SRC)/internet/doc/internet-node-recv.dia \ $(SRC)/internet/doc/routing.dia \ $(SRC)/internet/doc/routing-specialization.dia \ + $(SRC)/internet/doc/global-routing-limitation.dia \ $(SRC)/internet/doc/figures/tcp-state-machine.png \ $(SRC)/internet/doc/figures/dctcp-10ms-50mbps-tcp-throughput.pdf \ $(SRC)/internet/doc/figures/dctcp-10ms-50mbps-tcp-throughput.png \ @@ -394,6 +395,7 @@ IMAGES_EPS = \ $(FIGURES)/internet-node-recv.eps \ $(FIGURES)/routing.eps \ $(FIGURES)/routing-specialization.eps \ + $(FIGURES)/global-routing-limitation.eps \ $(FIGURES)/WifiArchitecture.eps \ $(FIGURES)/PhyEntityHierarchy.eps \ $(FIGURES)/WifiPpduHierarchy.eps \ @@ -523,6 +525,7 @@ $(FIGURES)/internet-node-send.pdf_width = 5in $(FIGURES)/internet-node-recv.pdf_width = 5in $(FIGURES)/routing.pdf_width = 6in $(FIGURES)/routing-specialization.pdf_width = 5in +$(FIGURES)/global-routing-limitation.pdf_width = 6in $(FIGURES)/snir.pdf_width = 3in $(FIGURES)/lte-interference-test-scenario.pdf_width = 3in $(FIGURES)/epc-ctrl-arch.pdf_width = 8cm diff --git a/src/internet/doc/global-routing-limitation.dia b/src/internet/doc/global-routing-limitation.dia new file mode 100644 index 000000000..72bb68dae --- /dev/null +++ b/src/internet/doc/global-routing-limitation.dia @@ -0,0 +1,688 @@ + + + + + + + + + + + + + #A4# + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + ## + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + ## + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + ## + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + ## + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + ## + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + ## + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + #Source# + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + #10.1.2.1/24# + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + #10.1.2.2/24# + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + #Packet with destination 10.1.2.10# + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + #10.1.2.10/24# + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/internet/doc/routing-overview.rst b/src/internet/doc/routing-overview.rst index 157498714..88db37d43 100644 --- a/src/internet/doc/routing-overview.rst +++ b/src/internet/doc/routing-overview.rst @@ -285,6 +285,33 @@ Advertisement for each router, and this link state database is fed into the OSPF shortest path computation logic. The Ipv4 API is finally used to populate the routes themselves. +Limitations +~~~~~~~~~~~ + +The following are the known limitations of the GlobalRouting implementation: + +#. When calculating routes for networks using GlobalRouting, + if multiple exit Interfaces are present from the root node to a network, + then Packets may travel an extra hop to reach their destination in that network. + Clarifying this further, the following is the generalized conditions: + + #. Assume that there is a network (e.g., 10.1.2.0/24) and the network has 2 (or more) routers (2 egress points, or more). + #. Assume that a node has 2 (or more) equal-cost paths toward said network. + #. Assume that multiple IP addresses with that network prefix are present on one or more interfaces. + + This will mean that, to reach the internal interfaces of the "other" router(s), the packets will + do one unnecessary hop, passing through the designated router, and discarding the (shorter) path + leading directly to the destination. + + .. _Global-Routing-Limitation: + + .. figure:: figures/global-routing-limitation.* + +#. Although adding Multiple IP addresses on the same interface + and Equal Cost Multi Path are both supported individually, + the combination of both is not fully supported and may lead to unexpected results + and in some specific cases routing loops. + This limitation is tracked in issue #1242 of the issue tracker. RIP and RIPng +++++++++++++