From 577f3e5750ec23cadf19cea68fe21aa5d2e7b9fa Mon Sep 17 00:00:00 2001 From: Giovanni Biscuolo Date: Mon, 21 Jan 2019 19:10:45 +0100 Subject: [PATCH] doc: clarify build users must be in kvm group To: guix-patches@gnu.org * doc/guix.texi: (guix)Invoke guix system, clarify kvm users must be in kvm group when using `guix system vm` --- doc/guix.texi | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/doc/guix.texi b/doc/guix.texi index 245a18bc7..a3a27628f 100644 --- a/doc/guix.texi +++ b/doc/guix.texi @@ -22942,6 +22942,19 @@ passed. @anchor{guix system vm} Build a virtual machine that contains the operating system declared in @var{file}, and return a script to run that virtual machine (VM). +To use this command, you may need to add the build users to the @code{kvm} +group so they can access @file{/dev/kvm} (@pxref{Build Environment Setup}). + +On a GNU/Linux system, a build user pool groups may be changed like this +(using Bash syntax and the @code{shadow} commands): + +@example +# for i in `seq -w 1 10`; + do + usermod -G guixbuild,kvm guixbuilder$i; + done +@end example + Arguments given to the script are passed to QEMU as in the example below, which enables networking and requests 1@tie{}GiB of RAM for the emulated machine: -- q2.11.0