From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp11.migadu.com ([2001:41d0:8:6d80::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms5.migadu.com with LMTPS id xaYNGWvlmmIsYwAAbAwnHQ (envelope-from ) for ; Sat, 04 Jun 2022 06:54:03 +0200 Received: from aspmx1.migadu.com ([2001:41d0:8:6d80::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp11.migadu.com with LMTPS id wOv/F2vlmmJQEAAA9RJhRA (envelope-from ) for ; Sat, 04 Jun 2022 06:54:03 +0200 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 D7F8826D8E for ; Sat, 4 Jun 2022 06:54:02 +0200 (CEST) Received: from localhost ([::1]:35016 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1nxLnV-0002MT-NR for larch@yhetil.org; Sat, 04 Jun 2022 00:54:01 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:39484) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nxLRG-0008Tz-5V for guix-patches@gnu.org; Sat, 04 Jun 2022 00:31:02 -0400 Received: from debbugs.gnu.org ([209.51.188.43]:35257) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1nxLRF-0003lO-Py for guix-patches@gnu.org; Sat, 04 Jun 2022 00:31:01 -0400 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1nxLRF-0000Na-Mj for guix-patches@gnu.org; Sat, 04 Jun 2022 00:31:01 -0400 X-Loop: help-debbugs@gnu.org Subject: [bug#55631] [PATCH] gnu: grub: add documentation for new grub-efi-removable-bootloader References: <20220525043254.62715-1-karl@hallsby.com> In-Reply-To: <20220525043254.62715-1-karl@hallsby.com> Resent-From: Karl Hallsby Original-Sender: "Debbugs-submit" Resent-CC: guix-patches@gnu.org Resent-Date: Sat, 04 Jun 2022 04:31:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 55631 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: patch To: 55631@debbugs.gnu.org Cc: Karl Hallsby Received: via spool by 55631-submit@debbugs.gnu.org id=B55631.16543170311405 (code B ref 55631); Sat, 04 Jun 2022 04:31:01 +0000 Received: (at 55631) by debbugs.gnu.org; 4 Jun 2022 04:30:31 +0000 Received: from localhost ([127.0.0.1]:57387 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nxLQl-0000Mb-8z for submit@debbugs.gnu.org; Sat, 04 Jun 2022 00:30:31 -0400 Received: from mail-qk1-f181.google.com ([209.85.222.181]:39653) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nxLQi-0000MK-P8 for 55631@debbugs.gnu.org; Sat, 04 Jun 2022 00:30:29 -0400 Received: by mail-qk1-f181.google.com with SMTP id 15so2269910qki.6 for <55631@debbugs.gnu.org>; Fri, 03 Jun 2022 21:30:28 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=hallsby-com.20210112.gappssmtp.com; s=20210112; h=from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; bh=q6D1xVtiCk7uFSnYvtQX4cfSqtpIt3VU6tABNUEykbE=; b=21QwMF/Xiy2Q7QV0ulN82XXZkVQ3ga7EZDtaPLgcQ7dgokbF9WoGRcy4se7dw8CeCo akZv5BoY9jYRlKtdAvpIYdGA4Se6EqTY6nmOSTvdiA6bfl6b7wEH/Gg8RGiggRV3x9LA KRbGorfKXCXNJtWL44X7aycZ7HSYMGGUmbfAmRhMJ2YBsoXUEMCVpvanO5/4FDBcAzoX GDEWw92tI2c0jN+PVwxKJH3nYzCXU/jroEPlg4zVyq0R9XuYtVHMVh0rx5ZWzt7O756T YkC2V65ynJKk9b9H32QXenmFVzpljXOJxIV3SwCPQoytPmeKrWRMO52Qifl1kuzNMJL+ 3Fng== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; bh=q6D1xVtiCk7uFSnYvtQX4cfSqtpIt3VU6tABNUEykbE=; b=SqYC3ZIAP9czqV9BqvbTPUTBeDkTPr804ED2lGFhiFCy3ec20wNfuCa8uWZehGoy4m EsVbMEldHpnUbMBgGyVSPwN+xgeotMLXg3s9trPXNpKfhSBVwnzXlF6gtbh42nqeUkVJ freha+bvY2QCedq1el0I1Er+rQFHxkbJvzCLGV4VKPMnL7IKqtETW6Tj4suYEl5HAQH1 Soi1PTLR2zSU2d3uN8qcrjP7GOIdppnbU3GolIpC5xMXUB9npX6vBkoIeMBMsw5sa0vu E9h/d02mNVenOPSiE/zbQSZNvkWHS6m1dBY4pM2gNh9hSOA2kRhldmvyvgfV/fz/gRfC YMOA== X-Gm-Message-State: AOAM531c47sbk4DGHSI8/N82NgsOIA/4rjhuBPVKjv102hU+95ZVItX8 JFto+gZsqdcHsPQTYmf8CuHhzLLAoa+8AA== X-Google-Smtp-Source: ABdhPJxdn2hYocgh+lyyd4jzaGaJ4rcVvwuPYKuO2rUZPDIrGEKYuraZMPoSA4nfatgMyR/jwZGWsw== X-Received: by 2002:a37:42d2:0:b0:6a6:7b44:e150 with SMTP id p201-20020a3742d2000000b006a67b44e150mr7666945qka.773.1654317022878; Fri, 03 Jun 2022 21:30:22 -0700 (PDT) Received: from localhost.localdomain (dhcp68.ssv1.iit.edu. [198.37.24.68]) by smtp.gmail.com with ESMTPSA id s126-20020a375e84000000b0069fcc501851sm6231418qkb.78.2022.06.03.21.30.22 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 03 Jun 2022 21:30:22 -0700 (PDT) From: Karl Hallsby Date: Fri, 3 Jun 2022 23:29:31 -0500 Message-Id: <071e680e8bb2c56e7bf7ee4b8a7cb7e2c3e8c3fa.1654316798.git.karl@hallsby.com> X-Mailer: git-send-email 2.36.1 MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: guix-patches@gnu.org List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-patches-bounces+larch=yhetil.org@gnu.org Sender: "Guix-patches" X-Migadu-Flow: FLOW_IN X-Migadu-To: larch@yhetil.org X-Migadu-Country: US ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1654318443; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-transfer-encoding:content-transfer-encoding:resent-cc: resent-from:resent-sender:resent-message-id:in-reply-to:in-reply-to: references:references:list-id:list-help:list-unsubscribe: list-subscribe:list-post:dkim-signature; bh=q6D1xVtiCk7uFSnYvtQX4cfSqtpIt3VU6tABNUEykbE=; b=NoGv8PhWAPzdPl1erFf/mgPkL5BmdsJzUeXJpFMxljux/xcQQQUZBqwRP3Chsj41dDEi17 F/G42MvrXCr2LGXO2XlatsYBXGhwcthPH0EsavNotHK1wq2iI2/Ci9kPNFhs8L4Twv1N9B xB/h5e1JUVibK4IM5Ky+pf9t+WcsR7QeaBMXjKp5fMIgbvtx1F+lOFS7LExMsmBEa3q6nO WF3poZmicO+cEXzDLphSTsVxRgw7bxi9Yb+7HVEgmJwH6tll3EXv+qXF/r1yb2ZIBclFrs f8YlN7beiPwR/4HRKWG9pfSZlSGox+wBVe+XZUB2DN8zzKxOw4rjf1Oeyiah3A== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1654318443; a=rsa-sha256; cv=none; b=JkShlh12ZqeqxL8UPu2TWeWvvZ9m1HHvhIWn1f4XKsKFlrDnEx1zjkdBUP9nk+UGXCgSv4 geYPCzRIdPhsfImZqTGfi0v5mnzOOuCQGyHIyyiPMAmM/0MSukQLicIRy3BDNlSylndUT8 HWT7++Q7vi53sqLjvg8nhteBMQIbNTgmNmY5q4he5agHL8TRlOWK2ijjBAvgrvby9Jd2Eu E6dwEbvQPIMJILkmCc6ZzWmwAgYSwv2uVNH+XudsK/kNnnRq1JRBUnbtJz6vhNs8iG0w6k jmAZ8Z7lTDWW32cCUY/DfpzEQmi83XQ5JebLgF6Kn9CtZ6UlK8kejipgGz3Kow== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=hallsby-com.20210112.gappssmtp.com header.s=20210112 header.b="21QwMF/X"; dmarc=none; spf=pass (aspmx1.migadu.com: domain of "guix-patches-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="guix-patches-bounces+larch=yhetil.org@gnu.org" X-Migadu-Spam-Score: 1.38 Authentication-Results: aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=hallsby-com.20210112.gappssmtp.com header.s=20210112 header.b="21QwMF/X"; dmarc=none; spf=pass (aspmx1.migadu.com: domain of "guix-patches-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="guix-patches-bounces+larch=yhetil.org@gnu.org" X-Migadu-Queue-Id: D7F8826D8E X-Spam-Score: 1.38 X-Migadu-Scanner: scn0.migadu.com X-TUID: J4nuN3jrKhFs --- doc/guix.texi | 22 +++++++++++++++++++--- 1 file changed, 19 insertions(+), 3 deletions(-) diff --git a/doc/guix.texi b/doc/guix.texi index 184206bec8..fdfd024a7a 100644 --- a/doc/guix.texi +++ b/doc/guix.texi @@ -103,6 +103,7 @@ Copyright @copyright{} 2021 Josselin Poiret@* Copyright @copyright{} 2022 Remco van 't Veer@* Copyright @copyright{} 2022 Aleksandr Vityazev@* Copyright @copyright{} 2022 Philip M@sup{c}Grath@* +Copyright @copyright{} 2022 Karl Hallsby@* Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.3 or @@ -36282,8 +36283,8 @@ The type of a bootloader configuration declaration. @cindex BIOS, bootloader The bootloader to use, as a @code{bootloader} object. For now @code{grub-bootloader}, @code{grub-efi-bootloader}, -@code{grub-efi-netboot-bootloader}, @code{extlinux-bootloader} and -@code{u-boot-bootloader} are supported. +@code{grub-efi-netboot-bootloader}, @code{grub-efi-removable-bootloader}, +@code{extlinux-bootloader} and @code{u-boot-bootloader} are supported. @cindex ARM, bootloaders @cindex AArch64, bootloaders @@ -36352,6 +36353,20 @@ NFS servers, you also need a properly configured DHCP server to make the booting over netboot possible. For all this we can currently only recommend you to look for instructions about @acronym{PXE, Preboot eXecution Environment}. +@vindex grub-efi-removable-bootloader +@code{grub-efi-removable-bootloader} allows you to boot your system from +removable media by writing the GRUB file to the UEFI-specification location of +@file{/EFI/BOOT/BOOTX64.efi} of the boot directory, usually @file{/boot/efi}. +This is also useful for some UEFI firmwares that ``forget'' their configuration +from their non-volatile storage. Like @code{grub-efi-bootloader}, this can only +be used if the @file{/sys/firmware/efi} directory is available. + +@quotation Note +This @emph{will} overwrite the GRUB file from any other operating systems that +also place their GRUB file in the UEFI-specification location; making them +unbootable. +@end quotation + @item @code{targets} This is a list of strings denoting the targets onto which to install the bootloader. @@ -36360,7 +36375,8 @@ The interpretation of targets depends on the bootloader in question. For @code{grub-bootloader}, for example, they should be device names understood by the bootloader @command{installer} command, such as @code{/dev/sda} or @code{(hd0)} (@pxref{Invoking grub-install,,, grub, -GNU GRUB Manual}). For @code{grub-efi-bootloader}, they should be mount +GNU GRUB Manual}). For @code{grub-efi-bootloader} and +@code{grub-efi-removable-bootloader} they should be mount points of the EFI file system, usually @file{/boot/efi}. For @code{grub-efi-netboot-bootloader}, @code{targets} should be the mount points corresponding to TFTP root directories served by your TFTP base-commit: f47dce686a57e5eb793003e37101df63b5eb37ae -- 2.36.1