From patchwork Sun Oct 15 12:00:24 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Christina O'Donnell X-Patchwork-Id: 54835 Return-Path: X-Original-To: patchwork@mira.cbaines.net Delivered-To: patchwork@mira.cbaines.net Received: by mira.cbaines.net (Postfix, from userid 113) id 00A0B27BBE2; Sun, 15 Oct 2023 15:48:59 +0100 (BST) X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on mira.cbaines.net X-Spam-Level: X-Spam-Status: No, score=-2.9 required=5.0 tests=BAYES_00,MAILING_LIST_MULTI, SPF_HELO_PASS autolearn=unavailable autolearn_force=no version=3.4.6 Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) by mira.cbaines.net (Postfix) with ESMTPS id CE55B27BBE9 for ; Sun, 15 Oct 2023 15:48:57 +0100 (BST) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1qs2Q5-0001qg-Lb; Sun, 15 Oct 2023 10:48:41 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qs2Q3-0001q7-GW for guix-patches@gnu.org; Sun, 15 Oct 2023 10:48:39 -0400 Received: from debbugs.gnu.org ([2001:470:142:5::43]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1qs2Q3-0006SG-8R for guix-patches@gnu.org; Sun, 15 Oct 2023 10:48:39 -0400 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1qs2QR-0000Ni-Ec for guix-patches@gnu.org; Sun, 15 Oct 2023 10:49:03 -0400 X-Loop: help-debbugs@gnu.org Subject: [bug#66560] [DOCUMENTATION] doc: Include steps for mounting EFI partitions. Resent-From: Christina O'Donnell Original-Sender: "Debbugs-submit" Resent-CC: guix-patches@gnu.org Resent-Date: Sun, 15 Oct 2023 14:49:03 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 66560 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: To: 66560@debbugs.gnu.org Cc: Christina O'Donnell X-Debbugs-Original-To: guix-patches@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.16973813391417 (code B ref -1); Sun, 15 Oct 2023 14:49:03 +0000 Received: (at submit) by debbugs.gnu.org; 15 Oct 2023 14:48:59 +0000 Received: from localhost ([127.0.0.1]:53905 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1qs2QL-0000MW-CU for submit@debbugs.gnu.org; Sun, 15 Oct 2023 10:48:59 -0400 Received: from lists.gnu.org ([2001:470:142::17]:43650) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1qs0p1-00085E-Hi for submit@debbugs.gnu.org; Sun, 15 Oct 2023 09:06:23 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qs0oX-0005cd-Ge for guix-patches@gnu.org; Sun, 15 Oct 2023 09:05:49 -0400 Received: from vmi993448.contaboserver.net ([194.163.141.236] helo=mutix.org) by eggs.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1qs0oV-0006gs-MX for guix-patches@gnu.org; Sun, 15 Oct 2023 09:05:49 -0400 Received: from peter.home (host217-46-73-119.range217-46.btcentralplus.com [217.46.73.119]) (Authenticated sender: cdo) by mutix.org (Postfix) with ESMTPSA id 19282A603AA; Sun, 15 Oct 2023 15:05:44 +0200 (CEST) From: Christina O'Donnell Date: Sun, 15 Oct 2023 13:00:24 +0100 Message-ID: <655dcf80f8770bd887d5c5305335d880cef7fec5.1697371222.git.cdo@mutix.org> X-Mailer: git-send-email 2.41.0 MIME-Version: 1.0 Received-SPF: pass client-ip=194.163.141.236; envelope-from=cdo@mutix.org; helo=mutix.org X-Spam_score_int: -18 X-Spam_score: -1.9 X-Spam_bar: - X-Spam_report: (-1.9 / 5.0 requ) BAYES_00=-1.9, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-Mailman-Approved-At: Sun, 15 Oct 2023 10:48:50 -0400 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+patchwork=mira.cbaines.net@gnu.org Sender: guix-patches-bounces+patchwork=mira.cbaines.net@gnu.org X-getmail-retrieved-from-mailbox: Patches This patch ammends the Chrooting section of the Guix manual to help EFI users who have misconfigured their bootloader. This was neccessary for me after the first couple botched installation attempts. * doc/guix.texi (Chrooting into an existing system): Add missing mounts for repairing broken EFI partitions. --- doc/guix.texi | 32 ++++++++++++++++++++++++++++++-- 1 file changed, 30 insertions(+), 2 deletions(-) base-commit: d2923babf3ac44cb6faa88317f77c98f3016820d diff --git a/doc/guix.texi b/doc/guix.texi index 3517c95251..72909fc0cb 100644 --- a/doc/guix.texi +++ b/doc/guix.texi @@ -3046,8 +3046,36 @@ Chrooting into an existing system mount --rbind /dev /mnt/dev @end example -If your system is EFI-based, you must also mount the ESP partition. -Assuming it is @file{/dev/sda1}, you can do so with: +@item +There are a few more steps for those who are on EFI-based systems. If +you're using another bootloader method then you may safely skip these. +They are adapted from @url{https://wiki.debian.org/GrubEFIReinstall, a +page on the Debian Wiki}. + +@item +Verify that you are booting in from UEFI by checking that +@file{/sys/firmware/efi} isn't empty. + +@item +If the directory @file{/sys/firmware/efi/efivars} is empty, you need to +boot the rescue system including the kernel option "efi=runtime" and +mount the EFI variables before proceeding: + +@example sh +mount -t efivarfs none /sys/firmware/efi/efivars +@end example + +@item +If your bootloader installation failed, you may need to bind +@file{efivars} between the two systems. + +@example sh +mount --bind /sys/firmware/efi/efivars /mnt/sys/firmware/efi/efivars +@end example + +@item +You also need to mount the ESP partition. Assuming it is +@file{/dev/sda1}, you can do so with: @example sh mount /dev/sda1 /mnt/boot/efi