~ruther/guix-local

7581fb5bfb735b2253a478902ed784550600b0f0 — 45mg 1 year, 3 months ago 18763ba
doc: cookbook: Clarify virtual network switches.

* doc/guix-cookbook.texi (Virtual Machines): [Routed network for
libvirt] {Creating a virtual network switch}: Remove unnecessarily
noncommital language ("a few components/configurations, such as...").
Correct 'TUN interface', as bridges are currently used.  Add a link to
the libvirt Wiki for more information.

Change-Id: I6ffdeca8e4d32155c8cce547d4930bf1b0cb471b
Signed-off-by: Maxim Cournoyer <maxim.cournoyer@gmail.com>
1 files changed, 13 insertions(+), 8 deletions(-)

M doc/guix-cookbook.texi
M doc/guix-cookbook.texi => doc/guix-cookbook.texi +13 -8
@@ 3897,14 3897,19 @@ hosted on the virtual machine.

@subsection Creating a virtual network switch

A virtual network switch consists of a few components/configurations,
such as a @abbr{TUN, network tunnel} interface, DHCP server (dnsmasq)
and firewall rules (iptables).  The @command{virsh} command, provided by
the @code{libvirt} package, makes it very easy to create a virtual
switch.  You first need to choose a network subnet for your virtual
switch; if your home LAN is in the @samp{192.168.1.0/24} network, you
could opt to use e.g.@: @samp{192.168.2.0/24}.  Define an XML file,
e.g.@: @file{/tmp/virbr0.xml}, containing the following:
A virtual network switch consists of a virtual network device called a
`virtual bridge', DHCP server (dnsmasq) and firewall rules
(iptables). See the
@url{https://wiki.libvirt.org/VirtualNetworking.html, libvirt Wiki
article on Virtual Networking} for more details on the modes of
operation, management and implementation of virtual network switches.

The @command{virsh} command, provided by the @code{libvirt}
package, makes it very easy to create a virtual switch.  You first need
to choose a network subnet for your virtual switch; if your home LAN is
in the @samp{192.168.1.0/24} network, you could opt to use e.g.@:
@samp{192.168.2.0/24}.  Define an XML file, e.g.@:
@file{/tmp/virbr0.xml}, containing the following:

@example
<network>