summaryrefslogtreecommitdiffstats
path: root/source/n/network-scripts/README.VLANs
diff options
context:
space:
mode:
author Patrick J Volkerding <volkerdi@slackware.com>2021-03-01 20:10:44 +0000
committer Eric Hameleers <alien@slackware.com>2021-03-02 08:59:52 +0100
commit07ac5d43e50cb2039f37b4e9447c4e52789c9fb2 (patch)
tree9b2ebc687d19203f8b4ebe1ab2a0b6c485454a3b /source/n/network-scripts/README.VLANs
parentfa458b65d9d4c5e933622574d999915ecda37a25 (diff)
downloadcurrent-07ac5d43e50cb2039f37b4e9447c4e52789c9fb2.tar.gz
current-07ac5d43e50cb2039f37b4e9447c4e52789c9fb2.tar.xz
Mon Mar 1 20:10:44 UTC 202120210301201044
a/e2fsprogs-1.46.2-x86_64-1.txz: Upgraded. a/etc-15.0-x86_64-14.txz: Rebuilt. /etc/hosts: added IPv6 loopback addresses. a/hwdata-0.345-noarch-1.txz: Upgraded. ap/hplip-3.20.6-x86_64-7.txz: Rebuilt. Fixed desktop file to show category and icon properly. Thanks to upnort and ArTourter. d/git-2.30.1-x86_64-3.txz: Rebuilt. Make sure the bash-completion file is installed in the proper location. Thanks to Robby Workman. d/python-setuptools-54.0.0-x86_64-1.txz: Upgraded. d/vala-0.50.4-x86_64-1.txz: Upgraded. l/imagemagick-7.0.11_2-x86_64-1.txz: Upgraded. l/python-pillow-8.1.1-x86_64-1.txz: Upgraded. n/network-scripts-15.0-noarch-13.txz: Rebuilt. Well, apparently there was a newer branch of this than the one that was sitting in my usual pending queue, so here it is. This also includes some additional documentation on the new features. NOTE: In order to use SLAAC to configure IPv6, you'll need to have USE_SLAAC[x]="yes" for the interface in rc.inet1.conf. This is to ensure that nobody is surprised to find their machine fully exposed to the internet - better safe than sorry. Thanks to Darren "Tadgy" Austin and Robby Workman. n/wireless_tools-30.pre9-x86_64-4.txz: Rebuilt. This package contains some updates to rc.wireless and rc.wireless.conf. Thanks to Darren "Tadgy" Austin. xfce/mousepad-0.5.3-x86_64-1.txz: Upgraded.
Diffstat (limited to 'source/n/network-scripts/README.VLANs')
-rw-r--r--source/n/network-scripts/README.VLANs52
1 files changed, 52 insertions, 0 deletions
diff --git a/source/n/network-scripts/README.VLANs b/source/n/network-scripts/README.VLANs
new file mode 100644
index 000000000..108c399e1
--- /dev/null
+++ b/source/n/network-scripts/README.VLANs
@@ -0,0 +1,52 @@
+VLANs (aka, 802.1q)
+===================
+
+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. 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 aggregated 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.
+
+
+--
+Darren 'Tadgy' Austin.
+<darren (at) afterdark.org.uk>