Virtual switches can be configured at any point in the configuration
file; they allow switchd to add network interfaces of VMs to the
underlying switch interfaces automatically.
This confused me, since i've been using virtual switches without
switchd. I have a suspicion that "switchd" was supposed to be "vmd" in
that sentence (?).
The following diff attempts to fix this, and tweaks the surrounding text
a bit too.
RCS file: /home/edd/cvsync/src/usr.sbin/vmd/vm.conf.5,v
retrieving revision 1.8
diff -u -p -r1.8 vm.conf.5
--- vm.conf.5 15 Oct 2016 14:02:11 -0000 1.8
+++ vm.conf.5 16 Oct 2016 18:14:00 -0000
@@ -165,23 +165,36 @@ is greater than the number of
statements, additional default interfaces will be added.
.Sh SWITCH CONFIGURATION
-Virtual switches can be configured at any point in the configuration file;
-to add network interfaces of VMs to the underlying switch interfaces
-It is possible to pre-configure switch interfaces using
+A virtual switch allows VMs to communicate with other network interfaces on the
+host system via either
+.Xr bridge 4
+.Xr switch 4 .
+The network interface for each virtual switch defined in
+is automatically created by
+.Xr vmd 8 ,
+but it is also possible to pre-configure switch interfaces using
.Xr hostname.if 5
-.Xr ifconfig 8 ,
-see the sections
+.Xr ifconfig 8
.Xr ifconfig 8
+When a VM is started, virtual network interfaces which are assigned to a
+virtual switch have their
+.Xr tap 4
+interface automatically added into the corresponding
+.Xr bridge 4
+.Xr switch 4
+interface underlying the virtual switch.
+Virtual switches can be configured at any point in the configuration file.
section starts with a declaration of the virtual switch: