From 6e6949a0d18e26eaecbedc86ac92cf7f58d63f8f Mon Sep 17 00:00:00 2001
From: Willy Tarreau <w@1wt.eu>
Date: Sun, 21 May 2023 09:51:22 +0200
Subject: network: update a few comments regarding IPv6 auto-config

IPv6 auto-configuration depends on accept_ra, accept_ra_pinfo,
autoconf and forwarding. Let's mention this in the documentation
part as it's not necessarily intuitive.
---
 sbin/init.d/network | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/sbin/init.d/network b/sbin/init.d/network
index 692d007..93a6830 100755
--- a/sbin/init.d/network
+++ b/sbin/init.d/network
@@ -1,6 +1,6 @@
 #!/bin/bash
 
-# service network [<ifname>]       # interface name -> int_<ifname>=enable
+# service network [<ifname>]
 #     ip [[addr <address>] | dhcp | autoconfig] [<args>]
 #     ip [{arp|neigh} <ip> {<mac>|pub}] [<args>]
 #     ip [route <dest> <-|gw>] [<args>]
@@ -41,6 +41,12 @@
 #     dhcptimeout <timeout_sec> (def: 10)
 #     autoconf_script <path> (def: /usr/libexec/ipautoconfig)
 
+# Notes for IPv6 addressing: accept_ra defaults to 1 which means that an
+# address and a default route may be assigned by a local default gateway for
+# a given duration if forwarding=0 (default). Disable this by setting either
+# accept_ra=0, accept_ra_pinfo=0 or autoconf=0. Force it even when forwarding=1
+# by enabling all these and setting accept_ra=2.
+
 # we want ALL instances to stop and restart at once
 if [ "$1" = "restart" ]; then
   shift
-- 
2.35.3