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

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

[Oleg Pykhalov]

[-- Attachment #1: Type: text/plain, Size: 76 bytes --]

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


[-- Attachment #2: [PATCH] doc: Add note about overwritting /gnu/store/...-run-vm.sh --]
[-- Type: text/x-patch, Size: 1034 bytes --]

From 26088eca8d584a635954e121e0e6b2e64b1f568d Mon Sep 17 00:00:00 2001
From: Oleg Pykhalov <go.wigust@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

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

[Ludovic Courtès]

Hi Oleg,

Oleg Pykhalov <go.wigust@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’.

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

[Oleg Pykhalov]

Hi Ludovic,

ludo@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?

[...]

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

[Ludovic Courtès]

[-- Attachment #1: Type: text/plain, Size: 351 bytes --]

Heya,

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

> Hi Ludovic,
>
> ludo@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:


[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #2: Type: text/x-patch, Size: 651 bytes --]

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@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.
 

[-- Attachment #3: Type: text/plain, Size: 21 bytes --]


Thanks,
Ludo’.