docs: document the BusyBox ifup CIDR trap in the docker init path

BusyBox ifup — what runs in /gns3/init.sh unless the image ships its
own ifupdown — only brings up 'auto' stanzas and rejects CIDR notation
in the address line ("don't have all variables for <iface>/inet"),
leaving the interface unconfigured after a container restart.

Document the constraint next to the ifup call and in the generated
/etc/network/interfaces sample, where addressing gets written.
This commit is contained in:
YueGuobin committed 2026-08-28 23:26:24 +08:00
1 parent ae317608e8
commit c3cc067eea
2 files changed
+10

No files matched your search

@@ -87,6 +87,11 @@ sed -n 's/^ *\(eth[0-9]*\):.*/\1/p' < /proc/net/dev | while read dev; do
done
# configure network interfaces
# NOTE: unless the image ships its own ifupdown in /sbin this is BusyBox ifup,
# which only brings up 'auto' stanzas and does NOT understand CIDR notation:
# 'address <ip>' and 'netmask <mask>' must be separate lines, otherwise the
# stanza fails with "don't have all variables for <iface>/inet" and the
# interface comes up unconfigured.
ifup -a -f
# continue normal docker startup