From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp11.migadu.com ([2001:41d0:403:478a::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms8.migadu.com with LMTPS id UDTBCtr7K2WtgQEA9RJhRA:P1 (envelope-from ) for ; Sun, 15 Oct 2023 16:48:58 +0200 Received: from aspmx1.migadu.com ([2001:41d0:403:478a::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp11.migadu.com with LMTPS id UDTBCtr7K2WtgQEA9RJhRA (envelope-from ) for ; Sun, 15 Oct 2023 16:48:58 +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 B60CD525B0 for ; Sun, 15 Oct 2023 16:48:57 +0200 (CEST) Authentication-Results: aspmx1.migadu.com; dkim=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"; dmarc=none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1697381338; 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:list-id:list-help: list-unsubscribe:list-subscribe:list-post; bh=YfReZUtG62yMTBanMZZ7jxp6K4RdIepV6DyKgWD64Hw=; b=LZD5nm8+aQUnHxS0cc//Ezh1Hr8KDslTy0hm/rEAauNlVsWLwBew2fPEGc/6APxyb1If2m aLn4/xLMzxcnfYCKIdjBICTY4eDcSSX433N+h0my3feQ6h+1pIomebWiw9gtV/52qNoSJ/ IN+AF9LgonGoiFXeoKw8zuD+EZ6YQiRrYp77+BdmfIc1/muXknU8XYBfFX2Zd+dimaFip6 M0IFH4gSeunkYQjLDZRBvho/xpGMLqCHk0/b5G5qTe55Be/6W8VOWc/Oo9l8rJ9CpNneuu VFr/QcfZfAam16wDPY38PnTmoPqmzIDQX+5+0kvF4RVqpeh3UEEXwgMgb/cY4A== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1697381338; a=rsa-sha256; cv=none; b=pw9Mu7Srt7eXwxJaGIslnAzMGfKOBFrZGdXTzJmus7H+nYAtPW+5MvYHxDy/KFuWBR4vj7 3kAdrI06oeG6n1+XDdRbVXU2GSxF7uFVhNI/ouDLhLdMZp2CRmmNrSdG7JDMAX5JBDuJSe x9KRyk8P7lZJOWjD6ZvnuTF4Mf4yQVDtWlc/u20Kd19izZrUWWRxayWBDX/y2v2tv+lwPb RjBFXdaJOLORAQt3bMvPYXqpbqSL/9v+BwZ5kOrn2Ke3St6t8J4LsGhI7O3WLm97IjS0Ta NcktLUPaxwhMa0S4ewj4g61AqP79MvuTidz2iMIGRLiSE9xNdE7Lrr/hjmzhiw== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=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"; dmarc=none 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 Content-Transfer-Encoding: 8bit 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+larch=yhetil.org@gnu.org Sender: guix-patches-bounces+larch=yhetil.org@gnu.org X-Migadu-Flow: FLOW_IN X-Migadu-Country: US X-Spam-Score: -4.67 X-Migadu-Queue-Id: B60CD525B0 X-Migadu-Scanner: mx0.migadu.com X-Migadu-Spam-Score: -4.67 X-TUID: Ay3V73RFtweV 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(-) 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 base-commit: d2923babf3ac44cb6faa88317f77c98f3016820d -- 2.41.0