[pd] semi-automated PD on raspbian scripts

examples/platforms/debian/default

@@ -31,6 +31,7 @@
 NAT64=0
 DNS64=0
 DHCPV6_PD=0
+DHCPV6_PD_REF=1
 NETWORK_MANAGER=0
 BACKBONE_ROUTER=1
 BORDER_ROUTING=1

examples/platforms/raspbian/default

@@ -31,6 +31,7 @@
 NAT64=1
 DNS64=0
 DHCPV6_PD=0
+DHCPV6_PD_REF=1
 NETWORK_MANAGER=0
 BACKBONE_ROUTER=1
 BORDER_ROUTING=1

script/_border_routing

@@ -68,20 +68,24 @@ accept_ra_enable()
     fi
 }
 
-# This function disables IPv6 support in dhcpcd.
+# This function disables IPv6 Router Solicitation (RS) in dhcpcd.
 #
-# dhcpcd on raspberry Pi enables IPv6 support by default. The problem with
-# dhcpcd is that it does't support Route Information Option (RIO), so we need
-# to rely on the kernel implementation. dhcpcd will force set accept_ra to 0
-# for all interfaces it is currently running on, if IPv6 is enabled. This
-# conflicts with our accept_ra* configurations.
+# dhcpcd on Raspberry Pi enables IPv6 support by default, including Router
+# Solicitations (RS).  While we want to use dhcpcd for IPv6 address management,
+# dhcpcd's handling of RS can conflict with the kernel's IPv6 configuration,
+# specifically the 'accept_ra' setting.
+#
+# By disabling RS in dhcpcd with 'noipv6rs', we prevent dhcpcd from interfering
+# with the kernel's 'accept_ra' setting, allowing us to manage IPv6 routing and
+# other aspects of IPv6 configuration at the kernel level. This approach ensures
+# that we can leverage dhcpcd for IPv6 address assignment while maintaining
+# control over 'accept_ra'.
 #
 dhcpcd_disable_ipv6()
 {
     if [ -f $DHCPCD_CONF_FILE ]; then
         sudo cp $DHCPCD_CONF_FILE $DHCPCD_CONF_BACKUP_FILE
         sudo tee -a $DHCPCD_CONF_FILE <<EOF
-noipv6
 noipv6rs
 EOF
     fi

script/_dhcpv6_pd_ref

@@ -0,0 +1,44 @@
+#!/bin/bash
+
+customise_dhcpcd_conf()
+{
+    sudo tee /etc/dhcpcd.conf >/dev/null <<EOF
+noipv6rs 
+# disable routing solicitation
+interface eth0
+  ipv6rs
+  iaid 1
+  ia_pd 2/::/64 -
+
+interface wlan0
+  ipv6rs
+  iaid 2
+  ia_pd 3/::/64 -
+EOF
+}
+
+dhcpv6_pd_ref_uninstall()
+{
+    with DHCPV6_PD_REF || return 0
+
+    if [[ -f "/etc/dhcpcd.conf.orig" ]]; then
+        sudo mv /etc/dhcpcd.conf.orig /etc/dhcpcd.conf
+    fi
+    sudo systemctl restart dhcpcd
+    sudo rm -f /etc/dhcpcd.enter-hook /etc/dhcpcd.exit-hook
+
+}
+
+dhcpv6_pd_ref_install()
+{
+    with DHCPV6_PD_REF || return 0
+
+    if [[ -f "/etc/dhcpcd.conf" ]]; then
+        sudo mv /etc/dhcpcd.conf /etc/dhcpcd.conf.orig
+    fi
+    customise_dhcpcd_conf
+    # Add dhcpcd.hooks
+    sudo install -m 755 "$(dirname "$0")"/reference-device/dhcpcd.enter-hook /etc/dhcpcd.enter-hook
+    sudo install -m 755 "$(dirname "$0")"/reference-device/dhcpcd.exit-hook /etc/dhcpcd.exit-hook
+
+}

script/_otbr

@@ -91,6 +91,12 @@ otbr_install()
         )
     fi
 
+    if with DHCPV6_PD_REF; then
+        otbr_options+=(
+            "-DOTBR_DHCP6_PD=ON"
+        )
+    fi
+
     if with REST_API; then
         otbr_options+=("-DOTBR_REST=ON")
     fi

script/bootstrap

@@ -106,6 +106,20 @@ install_packages_apt()
         fi
     }
 
+    # dhcpv6 pd
+    with DHCPV6_PD_REF && if command -v apt-get &>/dev/null; then
+        sudo apt-get install --no-install-recommends -y dhcpcd
+        sudo mkdir -p /etc/systemd/system/dhcpcd.service.d
+        # allow edit system config file eg. /etc/radvd.conf
+        sudo tee /etc/systemd/system/dhcpcd.service.d/custom.conf >/dev/null <<EOF
+[Service]
+ProtectSystem=false
+EOF
+        # reload dhcpcd daemon to activate the custom.conf
+        sudo systemctl daemon-reload
+        sudo apt-get install --no-install-recommends -y radvd
+    fi
+
     # network-manager
     without NETWORK_MANAGER || sudo apt-get install --no-install-recommends -y dnsmasq network-manager
 

script/reference-device/dhcpcd.enter-hook

@@ -0,0 +1,48 @@
+#!/bin/bash
+
+WAN_INTERFACE="eth0"
+WLAN_INTERFACE="wlan0"
+WPAN_INTERFACE="wpan0"
+
+RADVD_CONF="/etc/radvd.conf"
+LOG_TAG="dhcpcd.enter.hook:"
+
+
+config_ra()
+{
+    logger "$LOG_TAG $reason start config radvd"
+
+sudo tee "${RADVD_CONF}" > /dev/null <<EOF
+interface ${WPAN_INTERFACE}
+{
+    AdvSendAdvert on;
+    prefix ${1}/${2}
+    {
+        AdvOnLink on;
+        AdvAutonomous on;
+        AdvRouterAddr off;
+        AdvPreferredLifetime ${3};
+        AdvValidLifetime ${4};
+    };
+};
+EOF
+}
+
+
+if [ "${interface}" = "eth0" ] || [ “${interface}” = “wlan0” ]; then
+
+    for var in $(env); do
+        # Split the variable into name and value
+        name="${var%%=*}"
+        value="${var#*=}"
+        logger -t "$LOG_TAG $reason sysenv: " "$name=$value"
+    done
+
+    case $reason in
+        DELEGATED6 | REBIND6 | RENEW6 | BOUND6 )
+            logger "$LOG_TAG prefix is $new_dhcp6_ia_pd1_prefix1  length is $new_dhcp6_ia_pd1_prefix1_length pltime is  $new_dhcp6_ia_pd1_prefix1_pltime vltime is $new_dhcp6_ia_pd1_prefix1_vltime"
+            config_ra $new_dhcp6_ia_pd1_prefix1 $new_dhcp6_ia_pd1_prefix1_length $new_dhcp6_ia_pd1_prefix1_pltime  $new_dhcp6_ia_pd1_prefix1_vltime
+            sudo systemctl restart radvd || logger "$LOG_TAG Failed to restart radvd"
+            ;;
+    esac
+fi

script/reference-device/dhcpcd.exit-hook

@@ -0,0 +1,49 @@
+#!/bin/bash
+#dhcpcd.exit-hook
+
+
+WAN_INTERFACE="eth0"
+WLAN_INTERFACE="wlan0"
+WPAN_INTERFACE="wpan0"
+
+RADVD_CONF="/etc/radvd.conf"
+LOG_TAG="dhcpcd.exit.hook:"
+
+config_ra()
+{
+    logger "$LOG_TAG $reason start config radvd"
+
+sudo tee "${RADVD_CONF}" > /dev/null <<EOF
+interface ${WPAN_INTERFACE}
+{
+    AdvSendAdvert on;
+    prefix ${1}/${2}
+    {
+        AdvOnLink on;
+        AdvAutonomous on;
+        AdvRouterAddr off;
+        AdvPreferredLifetime ${3};
+        AdvValidLifetime ${4};
+    };
+};
+EOF
+}
+
+if [ “${interface}” = “eth0” ] || [ “${interface}” = “wlan0” ]; then
+
+    for var in $(env); do
+        # Split the variable into name and value
+        name="${var%%=*}"
+        value="${var#*=}"
+        # Log to syslog
+        logger -t "$LOG_TAG $reason sysenv: " "$name=$value"
+    done
+
+    case $reason in
+        EXPIRE6 | STOP6)
+            config_ra $old_dhcp6_ia_pd1_prefix1 $old_dhcp6_ia_pd1_prefix1_length 0 0
+            sudo systemctl restart radvd
+            ;;
+    esac
+fi
+

script/setup

@@ -38,6 +38,7 @@
 . script/_nat64
 . script/_dns64
 . script/_dhcpv6_pd
+. script/_dhcpv6_pd_ref
 . script/_network_manager
 . script/_rt_tables
 . script/_swapfile
@@ -56,6 +57,7 @@ main()
     border_routing_uninstall
     network_manager_uninstall
     dhcpv6_pd_uninstall
+    dhcpv6_pd_ref_uninstall
     nat64_uninstall
     dns64_uninstall
     rt_tables_uninstall
@@ -69,6 +71,7 @@ main()
     dns64_install
     network_manager_install
     dhcpv6_pd_install
+    dhcpv6_pd_ref_install
     border_routing_install
     otbr_install
     # shellcheck source=/dev/null