Re: vm.conf(5) manual tweak for switches

2016-10-20 Thread Jason McIntyre
On Sun, Oct 16, 2016 at 07:15:41PM +0100, Edd Barrett wrote:
> Hi,
> 
> In vm.conf(5):
> 
> ---8<---
> 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.
> --->8---
> 
> 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.
> 
> Comments, OK?
> 

fixed, thanks.
jmc

> 
> Index: vm.conf.5
> ===
> 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 -  1.8
> +++ vm.conf.5 16 Oct 2016 18:14:00 -
> @@ -165,23 +165,36 @@ is greater than the number of
>  statements, additional default interfaces will be added.
>  .El
>  .Sh SWITCH CONFIGURATION
> -Virtual switches can be configured at any point in the configuration file;
> -they allow
> -.Nm switchd
> -to add network interfaces of VMs to the underlying switch interfaces
> -automatically.
> -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
> +or
> +.Xr switch 4 .
> +The network interface for each virtual switch defined in
> +.Nm
> +is automatically created by
> +.Xr vmd 8 ,
> +but it is also possible to pre-configure switch interfaces using
>  .Xr hostname.if 5
>  or
> -.Xr ifconfig 8 ,
> -see the sections
> +.Xr ifconfig 8
> +(see the
>  .Sx BRIDGE
> -or
> +and
>  .Sx SWITCH
> -in
> +sections in
>  .Xr ifconfig 8
> -accordingly.
> +accordingly).
> +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
> +or
> +.Xr switch 4
> +interface underlying the virtual switch.
>  .Pp
> +Virtual switches can be configured at any point in the configuration file.
>  Each
>  .Ic switch
>  section starts with a declaration of the virtual switch:
> 
> -- 
> Best Regards
> Edd Barrett
> 
> http://www.theunixzoo.co.uk
> 



Re: vm.conf(5) manual tweak for switches

2016-10-19 Thread Jason McIntyre
On Wed, Oct 19, 2016 at 05:10:26PM +0100, Edd Barrett wrote:
> On Sun, Oct 16, 2016 at 07:15:41PM +0100, Edd Barrett wrote:
> > The following diff attempts to fix this, and tweaks the surrounding text
> > a bit too.
> 
> Any love for this?
> 

just be patient, please.
jmc



Re: vm.conf(5) manual tweak for switches

2016-10-19 Thread Edd Barrett
On Sun, Oct 16, 2016 at 07:15:41PM +0100, Edd Barrett wrote:
> The following diff attempts to fix this, and tweaks the surrounding text
> a bit too.

Any love for this?

-- 
Best Regards
Edd Barrett

http://www.theunixzoo.co.uk



vm.conf(5) manual tweak for switches

2016-10-16 Thread Edd Barrett
Hi,

In vm.conf(5):

---8<---
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.
--->8---

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.

Comments, OK?


Index: vm.conf.5
===
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 -  1.8
+++ vm.conf.5   16 Oct 2016 18:14:00 -
@@ -165,23 +165,36 @@ is greater than the number of
 statements, additional default interfaces will be added.
 .El
 .Sh SWITCH CONFIGURATION
-Virtual switches can be configured at any point in the configuration file;
-they allow
-.Nm switchd
-to add network interfaces of VMs to the underlying switch interfaces
-automatically.
-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
+or
+.Xr switch 4 .
+The network interface for each virtual switch defined in
+.Nm
+is automatically created by
+.Xr vmd 8 ,
+but it is also possible to pre-configure switch interfaces using
 .Xr hostname.if 5
 or
-.Xr ifconfig 8 ,
-see the sections
+.Xr ifconfig 8
+(see the
 .Sx BRIDGE
-or
+and
 .Sx SWITCH
-in
+sections in
 .Xr ifconfig 8
-accordingly.
+accordingly).
+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
+or
+.Xr switch 4
+interface underlying the virtual switch.
 .Pp
+Virtual switches can be configured at any point in the configuration file.
 Each
 .Ic switch
 section starts with a declaration of the virtual switch:

-- 
Best Regards
Edd Barrett

http://www.theunixzoo.co.uk