From 7581fb5bfb735b2253a478902ed784550600b0f0 Mon Sep 17 00:00:00 2001 From: 45mg <45mg.writes@gmail.com> Date: Sat, 22 Mar 2025 22:33:16 +0530 Subject: [PATCH] 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 --- doc/guix-cookbook.texi | 21 +++++++++++++-------- 1 file changed, 13 insertions(+), 8 deletions(-) diff --git a/doc/guix-cookbook.texi b/doc/guix-cookbook.texi index 13ff5bf8143a626f9c7f040edc5c39f863e428bb..7dc8a3d2f5049e604c635df751ce7baaa4fe1602 100644 --- a/doc/guix-cookbook.texi +++ b/doc/guix-cookbook.texi @@ -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