Add support for dynamic routing on ipv6 (ospfv3 and ripng)

doc/ChangeLog.md

@@ -12,6 +12,9 @@ All notable changes to the project are documented in this file.
 - Upgrade Buildroot to 2025.02.15 (LTS)
 - Add support for firewall address-set (ipset): named sets of IP addresses and
   networks, usable as zone sources for per-IP access control, issue #1189
+- Add IPv6 dynamic routing: RIPng and OSPFv3.  Both reuse the existing
+  ietf-rip and ietf-ospf models, selected per control-plane-protocol by the
+  `ripng`/`ospfv3` type and the IPv6 address-family
 - Build RPi64 SD card images in release builds
 - Include .pkg files in release builds
 

doc/routing.md

@@ -7,8 +7,8 @@ Currently supported YANG models:
 | ietf-routing              | Base model for all other models |
 | ietf-ipv4-unicast-routing | Static IPv4 unicast routing     |
 | ietf-ipv6-unicast-routing | Static IPv6 unicast routing     |
-| ietf-ospf                 | OSPF routing                    |
-| ietf-rip                  | RIP routing                     |
+| ietf-ospf                 | OSPFv2 and OSPFv3 routing        |
+| ietf-rip                  | RIPv2 and RIPng routing          |
 | infix-routing             | Infix deviations and extensions |
 
 The base model, ietf-routing, is where all the other models hook in.  It
@@ -305,6 +305,62 @@ admin@example:/>
 </code></pre>
 
 
+## OSPFv3 Routing
+
+The system also supports OSPF for IPv6, i.e., OSPFv3.  It uses the same
+`ietf-ospf` model as OSPFv2, selected by the control plane protocol type
+`ospfv3`.  OSPFv3 has no IPv4 interface address to derive a router ID
+from, so an `explicit-router-id` must be set.
+
+<pre class="cli"><code>admin@example:/config/> <b>edit routing control-plane-protocol ospfv3 name default ospf</b>
+admin@example:/config/routing/…/ospf/> <b>set explicit-router-id 1.1.1.1</b>
+admin@example:/config/routing/…/ospf/> <b>set area 0.0.0.0 interface e0 enabled</b>
+admin@example:/config/routing/…/ospf/> <b>leave</b>
+admin@example:/>
+</code></pre>
+
+> [!TIP]
+> Remember to enable [IPv6 forwarding](ip.md#ipv6-forwarding) for all the
+> interfaces you want to route between.
+
+Areas, interface settings (cost, timers, BFD, `point-to-point`),
+redistribution and default route advertisement work the same way as for
+[OSPFv2](#ospfv2-routing), with the differences listed below.
+
+
+### Differences from OSPFv2
+
+OSPFv3 runs on FRR's `ospf6d`, which does not implement every feature
+available for OSPFv2:
+
+- OSPFv3 carries IPv6 routes only; IPv4-over-OSPFv3 (RFC 5838) is not
+  supported, so there is no `address-family` setting.
+- `explicit-router-id` is required (there is no IPv4 address to derive it
+  from).
+- Interface types are limited to `broadcast`, `point-to-point` and
+  multicast Point-to-Multipoint (`hybrid`).  Non-broadcast interfaces and
+  static neighbors are not supported and are rejected by the model.
+- NSSA areas are supported as regular NSSA only; the `summary` flag has no
+  effect (no totally-NSSA).  Stub areas do support totally-stubby
+  (`summary false`).
+- Per-area `default-cost` is not available.
+
+
+### OSPFv3 status
+
+The CLI mirrors the OSPFv2 commands under `show ipv6 ospf`:
+
+<pre class="cli"><code>admin@example:/> <b>show ipv6 ospf</b>
+admin@example:/> <b>show ipv6 ospf neighbor</b>
+admin@example:/> <b>show ipv6 ospf interface</b>
+admin@example:/> <b>show ipv6 ospf route</b>
+</code></pre>
+
+Debug logging is configured under the `ospfv3` protocol `debug` container,
+analogous to OSPFv2.  Available categories are `packet`, `ism`, `nsm` and
+`nssa`.
+
+
 ## RIP Routing
 
 The system supports RIP dynamic routing for IPv4, i.e., RIPv2.  To enable
@@ -425,6 +481,51 @@ admin@example:/>
 </code></pre>
 
 
+## RIPng Routing
+
+RIPng is RIP for IPv6.  It uses the same `ietf-rip` model as RIPv2,
+selected by the control plane protocol type `ripng`:
+
+<pre class="cli"><code>admin@example:/config/> <b>edit routing control-plane-protocol ripng name default rip</b>
+admin@example:/config/routing/…/rip/> <b>set interfaces interface e0</b>
+admin@example:/config/routing/…/rip/> <b>set interfaces interface e1</b>
+admin@example:/config/routing/…/rip/> <b>leave</b>
+admin@example:/>
+</code></pre>
+
+> [!TIP]
+> Remember to enable [IPv6 forwarding](ip.md#ipv6-forwarding) for all the
+> interfaces you want to route between.
+
+Passive interfaces, redistribution (`set redistribute connected` /
+`static`) and timers are configured the same way as for
+[RIPv2](#rip-routing), with the differences below.
+
+
+### Differences from RIPv2
+
+RIPng runs on FRR's `ripngd`:
+
+- RIPng has no protocol version, so the per-interface `send-version` and
+  `receive-version` settings do not apply.
+- The global `distance` and unicast `neighbor` settings are not supported
+  (`ripngd` has no such commands).
+- `set redistribute ospf` redistributes OSPFv3, as there is no OSPFv2 in
+  an IPv6 domain.
+
+
+### RIPng status
+
+RIPng-learned routes appear in the [IPv6 routing table](#ipv6-routing-table):
+
+<pre class="cli"><code>admin@example:/> <b>show ipv6 route</b>
+</code></pre>
+
+Debug logging is configured under the `ripng` protocol `debug` container,
+analogous to RIPv2.  Available categories are `events`, `packet` and
+`kernel`.
+
+
 ## View routing table
 
 The routing table can be inspected from the operational datastore, XPath
@@ -500,7 +601,8 @@ Default distances used (lower numeric value wins):
 | 0            | Kernel routes, i.e., connected routes   |
 | 1            | Static routes                           |
 | 5            | DHCP routes                             |
-| 110          | OSPF                                    |
+| 110          | OSPF (OSPFv2 and OSPFv3)                 |
+| 120          | RIP (RIPv2 and RIPng)                   |
 | 254          | IPv4LL (ZeroConf) device routes         |
 | 255          | Route will not be used or redistributed |
 
@@ -527,6 +629,8 @@ The source protocol describes the origin of the route.
 | kernel       | Added when setting a subnet address on an interface |
 | static       | User created, learned from DHCP, or IPv4LL          |
 | ospfv2       | Routes learned from OSPFv2                          |
+| ospfv3       | Routes learned from OSPFv3                          |
+| rip          | Routes learned from RIPv2 or RIPng                  |
 
 The YANG model *ietf-routing* support multiple ribs but only two are
 currently supported, namely `ipv4` and `ipv6`.

package/skeleton-init-finit/skeleton-init-finit.mk

@@ -92,7 +92,7 @@ define SKELETON_INIT_FINIT_SET_FRR
 endef
 else
 define SKELETON_INIT_FINIT_SET_FRR
-	for svc in babeld bfdd bgpd mgmtd eigrpd isisd ldpd ospfd ospf6d pathd ripd ripng staticd vrrpd zebra; do	\
+	for svc in babeld bfdd bgpd mgmtd eigrpd isisd ldpd ospfd ospf6d pathd ripd ripngd staticd vrrpd zebra; do	\
 		cp $(SKELETON_INIT_FINIT_AVAILABLE)/frr/$$svc.conf $(FINIT_D)/available/$$svc.conf;		\
 	done
 	ln -sf ../available/zebra.conf $(FINIT_D)/enabled/zebra.conf

package/skeleton-init-finit/skeleton/etc/default/ospf6d

@@ -0,0 +1,2 @@
+# --log-level debug
+OSPF6D_ARGS="-A 127.0.0.1 -u frr -g frr -f /etc/frr/ospf6d.conf --log syslog"

package/skeleton-init-finit/skeleton/etc/default/ripngd

@@ -0,0 +1,2 @@
+# --log-level debug
+RIPNGD_ARGS="-A 127.0.0.1 -u frr -g frr --log syslog"

package/skeleton-init-finit/skeleton/etc/finit.d/available/frr/ospf6d.conf

@@ -1 +1,3 @@
-service [2345] log:null <!pid/zebra> ospf6d -A 127.0.0.1 -u frr -g frr -- OSPF IPv6 daemon
+service <!pid/zebra> pid:!/run/frr/ospf6d.pid env:-/etc/default/ospf6d \
+	[2345] ospf6d $OSPF6D_ARGS \
+	-- OSPF IPv6 daemon

package/skeleton-init-finit/skeleton/etc/finit.d/available/frr/ripngd.conf

@@ -0,0 +1,3 @@
+service <pid/zebra> pid:!/run/frr/ripngd.pid env:-/etc/default/ripngd \
+	[2345] ripngd $RIPNGD_ARGS \
+	-- RIPng daemon

src/bin/show/__init__.py

@@ -387,8 +387,10 @@ def bfd(args: List[str]) -> None:
         print(f"Unknown BFD subcommand: {subcommand}")
 
 
-def ospf(args: List[str]) -> None:
-    """Handle show ospf [subcommand] [ifname] [detail]
+def _ospf(args: List[str], afi: str) -> None:
+    """Handle show [ip|ipv6] ospf [subcommand] [ifname] [detail]
+
+    afi selects the address family: 'ipv4' (OSPFv2) or 'ipv6' (OSPFv3).
 
     Subcommands:
         (none)      - General OSPF instance information
@@ -409,6 +411,9 @@ def ospf(args: List[str]) -> None:
         print(json.dumps(data, indent=2))
         return
 
+    # Tell the formatters which address family (OSPFv2 vs OSPFv3) to select.
+    data['_afi'] = afi
+
     # Parse arguments: subcommand, optional interface name, optional detail flag
     subcommand = args[0] if len(args) > 0 and args[0] else ""
 
@@ -454,6 +459,16 @@ def ospf(args: List[str]) -> None:
         print(f"Unknown OSPF subcommand: {subcommand}")
 
 
+def ospf(args: List[str]) -> None:
+    """Show OSPFv2 (IPv4) operational status."""
+    _ospf(args, "ipv4")
+
+
+def ospf6(args: List[str]) -> None:
+    """Show OSPFv3 (IPv6) operational status."""
+    _ospf(args, "ipv6")
+
+
 def rip(args: List[str]) -> None:
     """Handle show rip [subcommand] [ifname]
 
@@ -761,6 +776,7 @@ def execute_command(command: str, args: List[str]):
         'nacm': nacm,
         'ntp': ntp,
         'ospf': ospf,
+        'ospf6': ospf6,
         'ptp': ptp,
         'rip': rip,
         'routes': routes,