amaharaneko/guix-mirrors
1
1
Fork 0
mirror of https://codeberg.org/guix/guix.git synced 2025-10-02 02:15:12 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

doc: cookbook: Fix terminology for libvirt virtual network switches.

Browse source 
* doc/guix-cookbook.texi (Virtual Machines) [Routed network for
libvirt]: Replace the term 'virtual bridge' with 'virtual network
switch'.  This is the term used by the libvirt Wiki to refer to the
combined setup of a 'virtual bridge' network interface, dnsmasq instance
bound to it, and firewall rules associated with it; 'bridge' is
ambiguous because it is sometimes used with this meaning, and sometimes
to refer specifically to the virtual network device called a 'bridge'.

Change-Id: Ibd10fe76321eb61e9ca23d8124634d1108d4faad
Signed-off-by: Maxim Cournoyer <maxim.cournoyer@gmail.com>
This commit is contained in:
45mg 2025-03-22 22:33:15 +05:30 • committed by Maxim Cournoyer
parent 475d21cad8
commit 18763ba3fc
No known key found for this signature in database
GPG key ID: 1260E46482E63562
1 changed files with 12 additions and 11 deletions
Download patch file Download diff file Expand all files Collapse all files

23
doc/guix-cookbook.texi
View file

@ -25,6 +25,7 @@ Copyright @copyright{} 2022, 2023 Maxim Cournoyer@*
Copyright @copyright{} 2023-2024 Ludovic Courtès@* Copyright @copyright{} 2023-2024 Ludovic Courtès@*
Copyright @copyright{} 2023 Thomas Ieong@* Copyright @copyright{} 2023 Thomas Ieong@*
Copyright @copyright{} 2024 Florian Pelz@* Copyright @copyright{} 2024 Florian Pelz@*
Copyright @copyright{} 2025 45mg@*
Permission is granted to copy, distribute and/or modify this document Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3 or under the terms of the GNU Free Documentation License, Version 1.3 or
@ -3879,29 +3880,29 @@ COMMIT
@section Routed network for libvirt @section Routed network for libvirt
@cindex Virtual network bridge interface @cindex Virtual network bridge interface
@cindex networking, virtual bridge @cindex networking, virtual bridge
@cindex libvirt, virtual network bridge @cindex libvirt, virtual network switch
If the machine hosting your virtual machines is connected wirelessly to If the machine hosting your virtual machines is connected wirelessly to
the network, you won't be able to use a true network bridge as explained the network, you won't be able to use a true network bridge as explained
in the preceding section (@pxref{Network bridge for QEMU}). In this in the preceding section (@pxref{Network bridge for QEMU}). In this
case, the next best option is to use a @emph{virtual} bridge with static case, the next best option is to use a @emph{virtual network switch}
routing and to configure a libvirt-powered virtual machine to use it with static routing and to configure a libvirt-powered virtual machine
(via the @command{virt-manager} GUI for example). This is similar to to use it (via the @command{virt-manager} GUI for example). This is
the default mode of operation of QEMU/libvirt, except that instead of similar to the default mode of operation of QEMU/libvirt, except that
using @abbr{NAT, Network Address Translation}, it relies on static instead of using @abbr{NAT, Network Address Translation}, it relies on
routes to join the @abbr{VM, virtual machine} IP address to the static routes to join the @abbr{VM, virtual machine} IP address to the
@abbr{LAN, local area network}. This provides two-way connectivity to @abbr{LAN, local area network}. This provides two-way connectivity to
and from the virtual machine, which is needed for exposing services and from the virtual machine, which is needed for exposing services
hosted on the virtual machine. hosted on the virtual machine.
@subsection Creating a virtual network bridge @subsection Creating a virtual network switch
A virtual network bridge consists of a few components/configurations, A virtual network switch consists of a few components/configurations,
such as a @abbr{TUN, network tunnel} interface, DHCP server (dnsmasq) such as a @abbr{TUN, network tunnel} interface, DHCP server (dnsmasq)
and firewall rules (iptables). The @command{virsh} command, provided by and firewall rules (iptables). The @command{virsh} command, provided by
the @code{libvirt} package, makes it very easy to create a virtual the @code{libvirt} package, makes it very easy to create a virtual
bridge. You first need to choose a network subnet for your virtual switch. You first need to choose a network subnet for your virtual
bridge; if your home LAN is in the @samp{192.168.1.0/24} network, you 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, 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: e.g.@: @file{/tmp/virbr0.xml}, containing the following: