Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org 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 smtp.lore.kernel.org (Postfix) with ESMTPS id 3A538C001E0 for ; Wed, 16 Aug 2023 08:42:22 +0000 (UTC) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1qWC6F-0001Qn-MC; Wed, 16 Aug 2023 04:41:55 -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 1qWC6E-0001QN-0Q for grub-devel@gnu.org; Wed, 16 Aug 2023 04:41:54 -0400 Received: from mo4-p00-ob.smtp.rzone.de ([81.169.146.163]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qWC6B-0007e6-7p for grub-devel@gnu.org; Wed, 16 Aug 2023 04:41:53 -0400 ARC-Seal: i=1; a=rsa-sha256; t=1692175307; cv=none; d=strato.com; s=strato-dkim-0002; b=hlI8pvYqaOytCL+FZw/PgpztQfI6gi/I6741EeSOI24aULMhnw8s2SBoqM86W8LeqT eqlNFZMKXLoA99VxOCwJ/xXsRc8ZC5Q677GGN0B4H/JwA1W23fzotbDQyRQccIxEcvLT /MPshNNA/ui8kDB/sMMnuBrRteiCd6Ei1jWspHYUN1YMOtV+tHYqjD+xYqPRRmLunl6/ 9vLKC8eMf0kKyKHLj2IZEob9u/ej8y1t0CLR1MmfILZZcSi+mwiF/hYTlBKHrD1nTqqf 4R0XLRaQXdQcSsHUIej1/Z9hYVJx2Cz1JXzj4G/Jnm129Ib8qPyYstL39yO95+F5jcRW f01Q== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; t=1692175307; s=strato-dkim-0002; d=strato.com; h=References:In-Reply-To:Message-ID:Subject:Cc:To:From:Date:Cc:Date: From:Subject:Sender; bh=JVt1cICgH//DxhU0ZNkLXDPPJxcECPC8Bqo7blqN+NE=; b=OLMki8FodWXZehDsgsY0JDijuxTyl4sF0QiHj2XzLrJg5zIHgmhd7HQZymVqKXjTuV 39QFOU4pNBiBxSMaNUp+FA3iQlWKays9Kt9KLAv/fJI829B/rW2Hs6lUoy7uVWHNpV3k /5DQrrcMuOOmEXs+ImSgXgVDrV5se7kxPfdOxruBOVpI/vHzV/aSZKP3jwvXKJ4NJ4hI iLDD0k8aN9sS3eucXiyH0nwCD3k7DVYXP+JnE24wDQb8ZMIJeOq+0wxkWoFntjPa9R2B FV7bSj0Rl0hVdGv1V7qDrsOPc0qNgV+zbEwIWtE1Y+TWLU1CvxD+vaEcV3MtFBB3Of0g bbCA== ARC-Authentication-Results: i=1; strato.com; arc=none; dkim=none X-RZG-CLASS-ID: mo00 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; t=1692175307; s=strato-dkim-0002; d=aepfle.de; h=References:In-Reply-To:Message-ID:Subject:Cc:To:From:Date:Cc:Date: From:Subject:Sender; bh=JVt1cICgH//DxhU0ZNkLXDPPJxcECPC8Bqo7blqN+NE=; b=m4s/1ND+gm1LN5YzBhCbq3Vthv6z2j9ZP321qBM7f6Km3jVxcrEILnvZctT7Ni4bh7 HP1GReHD4ZQCR33SV6/pXfWphfLVJW5yItjG/u9snT3YZfK1ufPaU9BU5KHhjcXQfyMO EwB9pW5ntzBNIKAOiytTPYV/RE0jAfls0iL4SS1ivE2Z9kt2dv2TRH/IEBiuVu14REI3 o4ay5+jz+2NMgHtsnXt8r5j5rU/ltS6bmys9yJF31jFaJ03NmeAqz606MTGrxTS2mBzy ns5R92AojsBYqimaVBses3wIPbTsf+Wc8OSW3QAQgYjV8zSRzHfo0m3E9d36bm+Gawhi Yk4Q== DKIM-Signature: v=1; a=ed25519-sha256; c=relaxed/relaxed; t=1692175307; s=strato-dkim-0003; d=aepfle.de; h=References:In-Reply-To:Message-ID:Subject:Cc:To:From:Date:Cc:Date: From:Subject:Sender; bh=JVt1cICgH//DxhU0ZNkLXDPPJxcECPC8Bqo7blqN+NE=; b=41Pv9Mvll74/zNhG+22qYRyur2OXqTKk4VCjQzgPA7tvU4TSkdRJOU+FDblG9z3i3y wGdCv/h951hNBVhu4zAQ== X-RZG-AUTH: ":P2EQZWCpfu+qG7CngxMFH1J+3q8wa/QLpd5ylWvMDX3y/OuD5rXVisR5W0GIOBLsFlYBLP6a70ck8itmkUBIgogr7HPCVw==" Received: from sender by smtp.strato.de (RZmta 49.8.0 AUTH) with ESMTPSA id n86f7az7G8fl2fG (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256 bits)) (Client did not present a certificate); Wed, 16 Aug 2023 10:41:47 +0200 (CEST) Date: Wed, 16 Aug 2023 10:41:40 +0200 From: Olaf Hering To: Glenn Washburn Cc: Daniel Kiper , The development of GNU GRUB , xxc3ncoredxx@gmail.com Subject: Re: [PATCH v3] docs: Add debugging chapter to development documentation Message-ID: <20230816104140.293419ad.olaf@aepfle.de> In-Reply-To: <20230816002928.2035689d@crass-HP-ZBook-15-G2> References: <20230606054839.212197-1-development@efficientek.com> <20230615110609.63hpjjf3kzfp3nye@tomti.i.net-space.pl> <20230815101407.6123b042.olaf@aepfle.de> <20230815123129.57bc8207@crass-HP-ZBook-15-G2> <20230815223708.779e712d.olaf@aepfle.de> <20230816002928.2035689d@crass-HP-ZBook-15-G2> X-Mailer: Claws Mail 20230724T063118.58ae3d58 hat ein Softwareproblem, kann man nichts machen. MIME-Version: 1.0 Received-SPF: none client-ip=81.169.146.163; envelope-from=olaf@aepfle.de; helo=mo4-p00-ob.smtp.rzone.de X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H3=0.001, RCVD_IN_MSPIKE_WL=0.001, SPF_HELO_PASS=-0.001, SPF_NONE=0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: grub-devel@gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: The development of GNU GRUB List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Reply-To: The development of GNU GRUB Content-Type: multipart/mixed; boundary="===============4018211894790085253==" Errors-To: grub-devel-bounces+grub-devel=archiver.kernel.org@gnu.org Sender: grub-devel-bounces+grub-devel=archiver.kernel.org@gnu.org --===============4018211894790085253== Content-Type: multipart/signed; boundary="Sig_/En2LCo._W+A98P7SElKwnlg"; protocol="application/pgp-signature"; micalg=pgp-sha256 Content-Transfer-Encoding: 7bit --Sig_/En2LCo._W+A98P7SElKwnlg Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: quoted-printable Wed, 16 Aug 2023 00:29:28 -0500 Glenn Washburn : > Anyway, since you're the first and *so far* only person seeing this, > could you submit a patch that fixes this for you? It would be great to > support older makeinfos (if that is indeed the issue) in the upcoming > release. The change below fixes the following errors: grub.texi:960: warning: `.' or `,' must follow @xref, not `)'. grub.texi:960: warning: for cross-references in parentheses, use @pxref. grub-dev.texi:815: `Using the gdbinfo command' has no Up field (perhaps inc= orrect sectioning?). grub-dev.texi:791: `OVMF debug log' has no Up field (perhaps incorrect sect= ioning?). grub-dev.texi:815: warning: unreferenced node `Using the gdbinfo command'. With some rewording the first error could be fixed properly. Olaf --- a/docs/grub-dev.texi +++ b/docs/grub-dev.texi @@ -632,6 +632,8 @@ various targets using @command{gdb} and the @samp{gdb_g= rub} GDB script. @menu * i386-pc:: * x86_64-efi:: +* OVMF debug log:: +* Using the gdbinfo command:: @end menu =20 @node i386-pc @@ -789,7 +791,7 @@ briefly as possible when needed, thus allowing the user= to have a maximal number at their disposal. =20 @node OVMF debug log -@subsection OVMF debug log +@section OVMF debug log =20 In order to get the GRUB2 load address from OVMF, first, a debug build of OVMF must be obtained (@uref{https://github.com/retrage/edk2-nightly/ra= w/master/bin/DEBUGX64_OVMF.fd, @@ -813,7 +815,7 @@ means that the GRUB2 EFI application was loaded at @sam= p{0x00006AEE000} and its .text section is at @samp{0x00006AEE756}. =20 @node Using the gdbinfo command -@subsection Using the gdbinfo command +@section Using the gdbinfo command =20 On EFI platforms the command @command{gdbinfo} will output a string that is to be run in a GDB session running with the @file{gdb_grub} GDB script. --- a/docs/grub.texi +++ b/docs/grub.texi @@ -957,7 +957,7 @@ information. =20 GRUB can be run in userspace by invoking the grub2-emu tool. It will read all configuration scripts as if booting directly (see @xref{Loading -an operating system directly}). With the @code{--kexec} flag, and +an operating system directly}.) With the @code{--kexec} flag, and kexec(8) support from the operating system, the @command{linux} command will directly boot the target image. For systems that lack working systemctl(1) support for kexec, passing the @code{--kexec} flag twice --Sig_/En2LCo._W+A98P7SElKwnlg Content-Type: application/pgp-signature Content-Description: Digitale Signatur von OpenPGP -----BEGIN PGP SIGNATURE----- iQIzBAEBCAAdFiEE97o7Um30LT3B+5b/86SN7mm1DoAFAmTci8QACgkQ86SN7mm1 DoDW5Q/+Lw2vaU65Wuu4pGpgW+w4SReQs9S37ci0UQaWQ4S+/MBNkco6yg7OsYfe YQ1GhPEjRBv0d/7smwLoZjOz5b4GDwPvznhETqmWrdm9lDgwdNOGe3kji6DJ9j1M DMGBWkz6RIKjFDFWkanHpzO1zRwq77lP2InWRDnDdat5eCHRPoowKTTg3tZX/ad/ eWjgcIHS9lvat17KwNTO6kH9CmT4xa/2OMYT6R4LQBUXahbugcG3ofMvMdar5sf9 zmGdqTRKcbBnjLxs0BytPf059QygmxiOZF61n4ZxeX8QLADNZZ3uABV7+I7RcvzY UJhyqXzYlEETb3bWj1yrUvUWNa3xIcGE5ctHWPACGhzr8PwbKc+dZWQpnG1aQiCb LIhrOL3Z/lPHh7E+yMN80Y9OHFYMKkVuiWv07bXiz5ewSrRSiJFwjMroDURqKqTK qbt3HKFsKtQofYtf8jw2hDPd9OduQDDmYMiwsvzUF/2ddxxGmHaS7Adoalpj2LJe Nb8XUacFu73OOVEyJ4E+o8YcrX0BmBSXeBQPsrk8+EpKwW2mgAIu/zAR6mesK2Q+ bhf7AQk0874p4HUgwIDavQ1DDMJsLqFN0FkaQG9biN6XgGZmbbr23QMB5CUtudIY /cuA7NeZEb05znPm1pygxRMRrAU4oUBd9qlmRAcHLoJBiqrIBVM= =iGNj -----END PGP SIGNATURE----- --Sig_/En2LCo._W+A98P7SElKwnlg-- --===============4018211894790085253== Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: base64 Content-Disposition: inline X19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX18KR3J1Yi1kZXZl bCBtYWlsaW5nIGxpc3QKR3J1Yi1kZXZlbEBnbnUub3JnCmh0dHBzOi8vbGlzdHMuZ251Lm9yZy9t YWlsbWFuL2xpc3RpbmZvL2dydWItZGV2ZWwK --===============4018211894790085253==--