GNU bug report logs - #27869
[PATCH] doc: Add note about overwritting /gnu/store/...-run-vm.sh

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 27869 in the body.
You can then email your comments to 27869 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: Oleg Pykhalov <go.wigust <at> gmail.com>
To: guix-patches <at> gnu.org
Subject: [PATCH] doc: Add note about overwritting /gnu/store/...-run-vm.sh
Date: Sat, 29 Jul 2017 14:59:07 +0300

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

Ludovic's hack from
https://debbugs.gnu.org/cgi/bugreport.cgi?bug=27691#49

[0001-doc-Add-note-about-overwritting-gnu-store-.-run-vm.s.patch (text/x-patch, inline)]

From 26088eca8d584a635954e121e0e6b2e64b1f568d Mon Sep 17 00:00:00 2001
From: Oleg Pykhalov <go.wigust <at> gmail.com>
Date: Sat, 29 Jul 2017 14:50:41 +0300
Subject: [PATCH] doc: Add note about overwritting /gnu/store/...-run-vm.sh
 defaults.

* doc/guix.texi (Invoking guix system): Add note about overwritting
  /gnu/store/...-run-vm.sh defaults.
---
 doc/guix.texi | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/doc/guix.texi b/doc/guix.texi
index 27ba68d67..840232b37 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -16429,6 +16429,13 @@ guix system vm my-config.scm \
    --expose=$HOME --share=$HOME/tmp=/exchange
 @end example
 
+will return a @file{/gnu/store/…-run-vm.sh} shell-script on success.
+You can overwrite defaults:
+
+@example
+/gnu/store/…-run-vm.sh -m 1024
+@end example
+
 On GNU/Linux, the default is to boot directly to the kernel; this has
 the advantage of requiring only a very tiny root disk image since the
 store of the host can then be mounted.
-- 
2.13.3

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

From: ludo <at> gnu.org (Ludovic Courtès)
To: Oleg Pykhalov <go.wigust <at> gmail.com>
Cc: 27869 <at> debbugs.gnu.org
Subject: Re: [bug#27869] [PATCH] doc: Add note about overwritting
 /gnu/store/...-run-vm.sh
Date: Sat, 29 Jul 2017 22:21:11 +0200

Hi Oleg,

Oleg Pykhalov <go.wigust <at> gmail.com> skribis:

> Ludovic's hack from
> https://debbugs.gnu.org/cgi/bugreport.cgi?bug=27691#49

The manual already states (info "(guix) Invoking guix system"):

--8<---------------cut here---------------start------------->8---
‘vm’
     Build a virtual machine that contains the operating system declared
     in FILE, and return a script to run that virtual machine (VM).
     Arguments given to the script are passed to QEMU.
--8<---------------cut here---------------end--------------->8---

Perhaps we should add the example to illustrate this last sentence?

Ludo’.

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

From: Oleg Pykhalov <go.wigust <at> gmail.com>
To: ludo <at> gnu.org (Ludovic Courtès)
Cc: 27869 <at> debbugs.gnu.org
Subject: Re: [bug#27869] [PATCH] doc: Add note about overwritting
 /gnu/store/...-run-vm.sh
Date: Sat, 29 Jul 2017 23:46:21 +0300

Hi Ludovic,

ludo <at> gnu.org (Ludovic Courtès) writes:

[...]

> Perhaps we should add the example to illustrate this last sentence?

Yea, it will be great, because it's not obvious for me and maybe
somebody else.  Is current example OK?

[...]

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

From: ludo <at> gnu.org (Ludovic Courtès)
To: Oleg Pykhalov <go.wigust <at> gmail.com>
Cc: 27869-done <at> debbugs.gnu.org
Subject: Re: [bug#27869] [PATCH] doc: Add note about overwritting
 /gnu/store/...-run-vm.sh
Date: Sun, 30 Jul 2017 14:23:38 +0200

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

Heya,

Oleg Pykhalov <go.wigust <at> gmail.com> skribis:

> Hi Ludovic,
>
> ludo <at> gnu.org (Ludovic Courtès) writes:
>
> [...]
>
>> Perhaps we should add the example to illustrate this last sentence?
>
> Yea, it will be great, because it's not obvious for me and maybe
> somebody else.  Is current example OK?

Yes, I’ve committed this:

[Message part 2 (text/x-patch, inline)]

diff --git a/doc/guix.texi b/doc/guix.texi
index 345285031..77909f886 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -16440,7 +16440,13 @@ 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).
-Arguments given to the script are passed to QEMU.
+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:
+
+@example
+$ /gnu/store/@dots{}-run-vm.sh -m 1024 -net user
+@end example
 
 The VM shares its store with the host system.
 

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

Thanks,
Ludo’.

Previous Next

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