aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
author45mg <45mg.writes@gmail.com>2025-03-22 22:33:16 +0530
committerMaxim Cournoyer <maxim.cournoyer@gmail.com>2025-03-23 11:29:41 +0900
commit7581fb5bfb735b2253a478902ed784550600b0f0 (patch)
treea8a14767eb5d5cdd2c20efa978206260a59fb01c
parent18763ba3fc2861b661f91b3010d7ffebe4d2eb2e (diff)
downloadguix-7581fb5bfb735b2253a478902ed784550600b0f0.tar.gz
guix-7581fb5bfb735b2253a478902ed784550600b0f0.zip
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>
-rw-r--r--doc/guix-cookbook.texi21
1 files changed, 13 insertions, 8 deletions
diff --git a/doc/guix-cookbook.texi b/doc/guix-cookbook.texi
index 13ff5bf814..7dc8a3d2f5 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
<network>