From 74a3127d8b2c7fdfb7692334acf3ce6594e5a508 Mon Sep 17 00:00:00 2001 From: Darren 'Tadgy' Austin Date: Thu, 14 Nov 2019 06:18:24 +0000 Subject: Update documentation. Default BONDMODE to balance-rr. Update rc.inet1.conf. --- README.VLANs | 58 +++++++++++++++++++++++++++++++++++++++++++++------------- 1 file changed, 45 insertions(+), 13 deletions(-) (limited to 'README.VLANs') diff --git a/README.VLANs b/README.VLANs index 22e6866..f5f9aec 100644 --- a/README.VLANs +++ b/README.VLANs @@ -1,20 +1,52 @@ -VLAN support -============ +VLANs (aka, 802.1q) +=================== -Slackware's rc.inet1 is now VLAN aware, and can be used to bring up interfaces -bound to specific VLAN IDs. The interfaces support IPv4 and IPv6 IP addressing, -and can be configured on top of a bonded interface. +Features +-------- +* Simple configuration of VLAN interfaces using standard rc.inet1.conf + variables. +* Utilises the new IFOPTS[x]="" paramter, which allows VLAN interface + specific configuration, supporting the use of any option. +* VLAN interfaces can be built on top of bonds and virtual or physical + interfaces. + + +Configuration +------------- +Configuring VLAN bound interfaces utilises the standard Slackware networking +configuration syntax in rc.inet1.conf, with setting up an interface as simple +as changing the IFNAME[x]. VLAN interfaces can be configured quite simply in rc.inet1.conf, in the standard Slackware way of defining an interface. The key to the configuration is to use the correct IFNAME[x]="" setting for the underlying ethernet (or bond) interface -and the tagged VLAN ID that should be exposed. +and the tagged VLAN ID that should be exposed. For example: + IFNAME[0]="eth0.10" + IFOPTS[0]="" + IPADDR[0]="192.168.10.1" + NETMASK[0]="24" + +The VLAN ID is taken from the full interface name, which is comprised of the +underlying interface name, a period (.) and then the VLAN ID to expose. +The above example would use the physical interface 'eth0', and expose the VLAN +with ID '10'. + +It is also possible to use a bond as the underlying interface, which allows +link aggrigated VLAN interfaces to be created for network redundancy. + +The interfaces support IPv4 and IPv6 IP addressing, configured in the Slackware +way in rc.inet1.conf. + +IFOPTS[x] is a pipe (|) delimited list of VLAN kernel module specific settings +to be applied to the interface. The ip-link(8) man page contains details of +exactly what settings can be used with this option (search for "VLAN Type +Support"). For example: + VLANOPTS[x]="protocol 802.1ad | reorder_hdr off" + +Under normal circumstances, where a standard VLAN interface is required, no +options should be supplied. -Here are the basic settings for a VLAN with ID 100 on the eth0 interface, -configured with a static IPv4 address: - IFNAME[0]="eth0.100" - IPADDR[0]="192.168.100.10" - NETMASK[0]="24" -As you can see, the IFNAME of the interface contains the underlying ethernet -device name (eth0), a period (.), and the VLAN ID to be exposed. +-- +Darren 'Tadgy' Austin. + -- cgit v1.2.3