Subject: [bug#34161] [PATCH] doc: clarify build users must be in kvm group

From: Giovanni Biscuolo <[email-masked]>
Date: Mon, 21 Jan 2019 19:46:23 +0100

Hi maitainers!

here is a small patch to (guix)Invoking guix system

rationale in
https://lists.gnu.org/archive/html/help-guix/2019-01/msg00272.html

Thanks!

>From 577f3e5750ec23cadf19cea68fe21aa5d2e7b9fa Mon Sep 17 00:00:00 2001
From: Giovanni Biscuolo <[email-masked]>
Date: Mon, 21 Jan 2019 19:10:45 +0100
Subject: [PATCH] doc: clarify build users must be in kvm group
To: [email-masked]

* 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

-- 
Giovanni Biscuolo

Xelera IT Infrastructures