GNU bug report logs - #34161
[PATCH] doc: clarify build users must be in kvm group

Previous Next

Full log

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: Giovanni Biscuolo <g <at> xelera.eu>
To: guix-patches <at> gnu.org
Subject: [PATCH] doc: clarify build users must be in kvm group
Date: Mon, 21 Jan 2019 19:46:23 +0100

[Message part 1 (text/plain, inline)]

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!

[signature.asc (application/pgp-signature, inline)]

[0001-doc-clarify-build-users-must-be-in-kvm-group.patch (text/x-diff, inline)]

From 577f3e5750ec23cadf19cea68fe21aa5d2e7b9fa Mon Sep 17 00:00:00 2001
From: Giovanni Biscuolo <g <at> xelera.eu>
Date: Mon, 21 Jan 2019 19:10:45 +0100
Subject: [PATCH] doc: clarify build users must be in kvm group
To: guix-patches <at> 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 <at> tie{}GiB of RAM for the
 emulated machine:
-- 
q2.11.0

[Message part 4 (text/plain, inline)]

-- 
Giovanni Biscuolo

Xelera IT Infrastructures

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.