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

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 34161 in the body.
You can then email your comments to 34161 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

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

Message #10 received at 34161-done <at> debbugs.gnu.org (full text, mbox):

From: Ludovic Courtès <ludo <at> gnu.org>
To: Giovanni Biscuolo <g <at> xelera.eu>
Cc: 34161-done <at> debbugs.gnu.org
Subject: Re: [bug#34161] [PATCH] doc: clarify build users must be in kvm group
Date: Fri, 25 Jan 2019 22:55:27 +0100

Hi Giovanni,

Giovanni Biscuolo <g <at> xelera.eu> skribis:

>>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`

There’s already a note a few lines below that links to “Build
Environment Setup” for more details:

  https://www.gnu.org/software/guix/manual/en/html_node/Invoking-guix-system.html

However, the note is admittedly too far away from the description of
‘vm’ so I’ve moved it higher (will push shortly.)

Thanks,
Ludo’.

Previous Next

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