Document the VLAN-id 0 special case.

This commit is contained in:
2026-05-14 15:25:48 -04:00
parent 5438fc765f
commit 0ba30c7440
3 changed files with 22 additions and 0 deletions
+8
View File
@@ -16,6 +16,13 @@ Adds an internal network segment with the specified vlan on the specified
card. The created vlan-adaptor is put into the specified group. It is setup
for IPv4.
If `${vlan}` is 0, then no tagged VLAN interfaces will be created; however,
the subnet address computations will still be performed as-if the vlan
were created. This means that `xy0` will use `0` for its subnet
computations in IPv4. If you don't intend to use
VLANs for subnets, just use VLAN ID 0 when declaring networks.
The IPv4 network will be a `/24` under `${v4_net_xy0}` if `${card}` is
`xy0`, for example. If `${v4_net_xy0}` is not set, then `${v4_net}` is
used by default. The 3rd octet will be `$(( ${vlan}/10 + ${vlan}%10 ))`. For
@@ -36,6 +43,7 @@ IPv6, and VLAN ID. Each can be visually compared to the others.)
|VLAN|IPv4 (3rd octet)|Example IPv4 |
|---:|---------------:|--------------:|
| 0| 0 |192.168.0.0/24 |
| 7| 7 |192.168.7.0/24 |
| 101|11 |192.168.11.0/24|
| 205|25 |192.168.25.0/24|