From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp0 ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms11 with LMTPS id OFk2Aey5rF+1OQAA0tVLHw (envelope-from ) for ; Thu, 12 Nov 2020 04:28:28 +0000 Received: from aspmx1.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp0 with LMTPS id oOyUOOu5rF8lCgAA1q6Kng (envelope-from ) for ; Thu, 12 Nov 2020 04:28:27 +0000 Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by aspmx1.migadu.com (Postfix) with ESMTPS id 87076940237 for ; Thu, 12 Nov 2020 04:28:27 +0000 (UTC) Received: from localhost ([::1]:43698 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kd3kR-00008U-5d for larch@yhetil.org; Wed, 11 Nov 2020 22:58:11 -0500 Received: from eggs.gnu.org ([2001:470:142:3::10]:45336) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kd3kI-000086-If for bug-guix@gnu.org; Wed, 11 Nov 2020 22:58:02 -0500 Received: from debbugs.gnu.org ([209.51.188.43]:60052) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1kd3kI-0004Vi-9R for bug-guix@gnu.org; Wed, 11 Nov 2020 22:58:02 -0500 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1kd3kI-0005P3-98 for bug-guix@gnu.org; Wed, 11 Nov 2020 22:58:02 -0500 X-Loop: help-debbugs@gnu.org Subject: bug#44353: [PATCH version-1.2.0 v2 3/3] doc: Detail which bootloader get used with disk-image or vm-image. Resent-From: Maxim Cournoyer Original-Sender: "Debbugs-submit" Resent-CC: bug-guix@gnu.org Resent-Date: Thu, 12 Nov 2020 03:58:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 44353 X-GNU-PR-Package: guix X-GNU-PR-Keywords: patch To: 44353@debbugs.gnu.org Received: via spool by 44353-submit@debbugs.gnu.org id=B44353.160515345920725 (code B ref 44353); Thu, 12 Nov 2020 03:58:02 +0000 Received: (at 44353) by debbugs.gnu.org; 12 Nov 2020 03:57:39 +0000 Received: from localhost ([127.0.0.1]:43362 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1kd3jv-0005OD-Fv for submit@debbugs.gnu.org; Wed, 11 Nov 2020 22:57:39 -0500 Received: from mail-qv1-f65.google.com ([209.85.219.65]:42789) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1kd3jr-0005Nh-Jp for 44353@debbugs.gnu.org; Wed, 11 Nov 2020 22:57:37 -0500 Received: by mail-qv1-f65.google.com with SMTP id b11so2147010qvr.9 for <44353@debbugs.gnu.org>; Wed, 11 Nov 2020 19:57:35 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:content-transfer-encoding; bh=SQTfGgKe81CfinD4MNs+lFk23JliSXX1IGTIGpxA1Go=; b=Kdv8WsLDzKXpwmNC+c0kIuu3ilgWkiVs9xMX2YVNNyZLrT7P11sMVyjUdwBzP8jG3a 7Lg/damaf/UT5Go5GZa6per5W3P0j6gc65OjWVliyHorEavqg8AaEb9LAsBzuLT+U+jx vMA7GQ7H/j3o9WP1gUTY45WLzWRknXf2rT0rY3Y6VwYQdf3V1aroUoBcmqiXvY7d7nDs 7ZGPq/JfvTaBr5dZdlascQn68sHaA5AYnHRhl5vZ4cT5eFYDoaA10uvgAI0rIjrMk25m o0fqHsbXulYhKY56/exRh6BgTCcq+20G3Kzo7qNxEfRAHRdq3rTFYQEFxw3NFcf1zkTN 82zw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=SQTfGgKe81CfinD4MNs+lFk23JliSXX1IGTIGpxA1Go=; b=q/kPveDZzmM3PrXxGRQ9lj2x03QKmtSiEPcuD5qAmJ3rWrsoqPpoT7rzSe4UZ54XSv QOGY+nnKIUbGS1XgjjqvJAKwgUQphV4N4KR8RY4mawvq6FvcwNCzG6wtYMwo8EPDMDiz Ov41WY+/WVpP+7iAlN7nCWpAoR7PsLgt2c6BS9r9lvvGBrB7zC9o4JrY6GRSCl45lYxc XRrvXCm75O528juQ9vHoC8OdCntpiXG+eepnCy4HEPutv+9vNQO10E8RKsDmEgZmz5dm ottxOwYw0Rxo7x9j9i+mbIec6M4YAEwfG301kJoovjMf5ml5x481IGleP0+hdQSOslYo TsCw== X-Gm-Message-State: AOAM533ny8kzP3O/A/+U5sTBVR/St3A4XO3EafOuio7eq1kwegjN5AQz pBz9P/9M14KWmcvZL7SrmbHGbyRUb+A= X-Google-Smtp-Source: ABdhPJwZvuG/L4droTleiw5SNr6XP0OrfW/pAz2Fw/iIgpE1RKLMDy1Lh70ikSDJ2D60jDH6dsGsNw== X-Received: by 2002:a05:6214:964:: with SMTP id do4mr262784qvb.18.1605153449867; Wed, 11 Nov 2020 19:57:29 -0800 (PST) Received: from localhost.localdomain (dsl-10-133-153.b2b2c.ca. [72.10.133.153]) by smtp.gmail.com with ESMTPSA id m15sm4630009qtc.90.2020.11.11.19.57.29 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 11 Nov 2020 19:57:29 -0800 (PST) From: Maxim Cournoyer Date: Wed, 11 Nov 2020 22:57:13 -0500 Message-Id: <20201112035713.3789-3-maxim.cournoyer@gmail.com> X-Mailer: git-send-email 2.28.0 In-Reply-To: <20201112035713.3789-1-maxim.cournoyer@gmail.com> References: <87h7q0cdns.fsf@gnu.org> <20201112035713.3789-1-maxim.cournoyer@gmail.com> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Spam-Score: 0.0 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-Spam-Score: -1.0 (-) X-BeenThere: bug-guix@gnu.org List-Id: Bug reports for GNU Guix List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Mathieu Othacehe , Jesse Gibbons , Maxim Cournoyer Errors-To: bug-guix-bounces+larch=yhetil.org@gnu.org Sender: "bug-Guix" X-Scanner: ns3122888.ip-94-23-21.eu Authentication-Results: aspmx1.migadu.com; dkim=fail (headers rsa verify failed) header.d=gmail.com header.s=20161025 header.b=Kdv8WsLD; dmarc=fail reason="SPF not aligned (relaxed)" header.from=gmail.com (policy=none); spf=pass (aspmx1.migadu.com: domain of bug-guix-bounces@gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=bug-guix-bounces@gnu.org X-Spam-Score: 5.59 X-TUID: bK8pQgMZuiOr * doc/guix.texi (Invoking guix system): Extend doc. --- doc/guix.texi | 31 ++++++++++++++++++++++++++----- 1 file changed, 26 insertions(+), 5 deletions(-) diff --git a/doc/guix.texi b/doc/guix.texi index b7f1bc1f00..e15ee4092c 100644 --- a/doc/guix.texi +++ b/doc/guix.texi @@ -30909,11 +30909,25 @@ a value. Docker images are built to contain exactly what they need, so the @option{--image-size} option is ignored in the case of @code{docker-image}. +@cindex disk-image, creating disk images The @code{disk-image} command can produce various image types. The image type can be selected using the @command{--image-type} option. It -defaults to @code{raw}. When its value is @code{iso9660}, the +defaults to @code{raw}. When its value is @code{iso9660}, the @option{--label} option can be used to specify a volume ID with -@code{disk-image}. +@code{disk-image}. When using @code{disk-image}, the bootloader +installed on the generated image is taken from the provided +@code{operating-system} definition. The following example demonstrates +how to generate an image that uses the @code{grub-efi-bootloader} +bootloader and boot it with QEMU: + +@example +image=$(guix system disk-image --image-type=qcow2 \ + gnu/system/examples/lightweight-desktop.tmpl) +cp $image /tmp/my-image.qcow2 +chmod +rw /tmp/my-image.qcow2 +qemu-system-x86_64 -enable-kvm -hda /tmp/my-image.qcow2 -m 1000 + -bios $(guix build ovmf)/share/firmware/ovmf_x64.bin +@end example When using the @code{raw} image type, a raw disk image is produced; it can be copied as is to a USB stick, for instance. Assuming @@ -30927,10 +30941,17 @@ the image to it using the following command: The @code{--list-image-types} command lists all the available image types. +@cindex vm-image, creating virtual machine images When using @code{vm-image}, the returned image is in qcow2 format, which -the QEMU emulator can efficiently use. @xref{Running Guix in a VM}, -for more information on how to run the image in a virtual machine. - +the QEMU emulator can efficiently use. @xref{Running Guix in a VM}, for +more information on how to run the image in a virtual machine. The +@code{grub-bootloader} bootloader is always used independently of what +is declared in the @code{operating-system} file passed as argument. +This is to make it easier to work with QEMU, which uses the SeaBIOS BIOS +by default, expecting a bootloader to be installed in the Master Boot +Record (MBR). + +@cindex docker-image, creating docker images When using @code{docker-image}, a Docker image is produced. Guix builds the image from scratch, not from a pre-existing Docker base image. As a result, it contains @emph{exactly} what you define in the operating -- 2.28.0