mirror/guix
mirror/guix
1
Fork 0
mirror of https://https.git.savannah.gnu.org/git/guix.git/ synced 2025-07-16 20:10:39 +02:00
Code Releases Activity

services: Add xe-guest-utilities-service-type.

Browse source 
* gnu/services/virtualization.scm (xe-guest-utilities-configuration,
  xe-guest-utilities-service-type): New variables.
* doc/guix.texi: Document them.

Change-Id: Ife4e79fa6d1a9d5a21bf7479488884f2a5cf8d56
Signed-off-by: Ludovic Courtès <ludo@gnu.org>
This commit is contained in:
Karl Hallsby 2025-01-10 01:00:59 -06:00 • committed by Ludovic Courtès
parent fb597f28b8
commit 145b51aeb3
No known key found for this signature in database
GPG key ID: 090B11993D9AEBB5
2 changed files with 152 additions and 1 deletions
Download patch file Download diff file Expand all files Collapse all files

71
doc/guix.texi
View file

@ -37518,6 +37518,77 @@ host. If empty, QEMU uses a default file name.
@end table
@end deftp
@subsubheading Xen Guest Agent
@cindex Xen
@cindex Xen guest agent
The Xen guest agent allows a Xen host to control the emulated system.
The @code{xe-guest-utilities} service runs the agent on Guix guests.
@url{https://github.com/xenserver/xe-guest-utilities, xe-guest-utilities} collects information about the running virtualized guest. This includes:
@itemize
@item
static information
@itemize
@item
The operating system running
@item
The Linux kernel version
@end itemize
@item
dynamic information
@itemize
@item
Network interfaces (devices) being added/removed
@item
Network connections being unplugged/plugged-in
@item
CPUs being added or removed
@item
The guest migrating, being paused/resumed, etc.
@end itemize
@item
ephemeral information
@itemize
@item
The amount of memory currently in-use and free
@item
The amount of disk-space used
@end itemize
@end itemize
@quotation Note
The default Linux-libre kernel that Guix ships already enables the
necessary paravirtualization features for a guest. There is nothing you
need to do for the guest to support Xen's paravirtualization features.
The guest utilities are used to have the guest report information
@emph{back} to the virtualizing host and support tasks that require
cooperation between host and guest, like CPU hotplugging.
@end quotation
@defvar xe-guest-utilities-service-type
Service type for the Xen guest utilities service.
@end defvar
@deftp {Data Type} xe-guest-utilities-configuration
Configuration for the @code{xe-guest-utilities} service.
@table @asis
@item @code{package} (default: @code{xe-guest-utilities})
The Xen guest utilities package to use.
@item @code{pid-file} (default: @code{"/var/run/xe-daemon.pid"})
Name of the file holding the PID of @code{xe-deamon}.
@item @code{log-file} (default: @code{"/var/log/xe-guest-utilities.log"})
Name of the @code{xe-guest-utilities} log file.
@end table
@end deftp
@anchor{build-vm}
@subsubheading Virtual Build Machines