From patchwork Wed Mar 22 17:20:46 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lancelot SIX X-Patchwork-Id: 66759 Return-Path: X-Original-To: patchwork@sourceware.org Delivered-To: patchwork@sourceware.org Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id 6EFB83857C48 for ; Wed, 22 Mar 2023 17:22:17 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 6EFB83857C48 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=sourceware.org; s=default; t=1679505737; bh=vpqghpO2DK1R8Ha94BZXoc3XtlL2qgxuhIaOO6mbMao=; h=To:Cc:Subject:Date:In-Reply-To:References:List-Id: List-Unsubscribe:List-Archive:List-Post:List-Help:List-Subscribe: From:Reply-To:From; b=aiUPwLZMUXiMRp+Ik+N6VL8B45Bf2XzAh5qFrXNU52yrp+DOgt0bVmjlgABl9JmPa YrPNymqfyJrGHoVxu6ADGKjjtV9+22jmjEvL1t5o8ELSib4EzUTrg6KTjyMQ0LnZxd loei8R2XnAtGyLv+rxv6BXe+DgbvGrOBKV+0/kaI= X-Original-To: gdb-patches@sourceware.org Delivered-To: gdb-patches@sourceware.org Received: from lndn.lancelotsix.com (vps-42846194.vps.ovh.net [IPv6:2001:41d0:801:2000::2400]) by sourceware.org (Postfix) with ESMTPS id D774B3858C1F for ; Wed, 22 Mar 2023 17:21:53 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org D774B3858C1F Received: from localhost.localdomain (cust120-dsl54.idnet.net [212.69.54.120]) by lndn.lancelotsix.com (Postfix) with ESMTPSA id EB55B89DC9; Wed, 22 Mar 2023 17:21:52 +0000 (UTC) To: gdb-patches@sourceware.org Cc: lsix@lancelotsix.com, Lancelot SIX Subject: [PATCH v2] gdb: Update doc of the "maintenance info line-table" Date: Wed, 22 Mar 2023 17:20:46 +0000 Message-Id: <20230322172046.529306-1-lancelot.six@amd.com> X-Mailer: git-send-email 2.34.1 In-Reply-To: <3a38867b-e481-c4be-95db-0058afbaf2b3@simark.ca> References: <3a38867b-e481-c4be-95db-0058afbaf2b3@simark.ca> MIME-Version: 1.0 X-Greylist: Sender succeeded SMTP AUTH, not delayed by milter-greylist-4.5.11 (lndn.lancelotsix.com [0.0.0.0]); Wed, 22 Mar 2023 17:21:53 +0000 (UTC) X-Spam-Status: No, score=-8.5 required=5.0 tests=BAYES_00, GIT_PATCH_0, KAM_DMARC_QUARANTINE, KAM_DMARC_STATUS, KAM_LAZY_DOMAIN_SECURITY, KHOP_HELO_FCRDNS, RCVD_IN_SBL_CSS, SPF_HELO_NONE, SPF_NONE, TXREP autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on server2.sourceware.org X-BeenThere: gdb-patches@sourceware.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Gdb-patches mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-Patchwork-Original-From: Lancelot SIX via Gdb-patches From: Lancelot SIX Reply-To: Lancelot SIX Errors-To: gdb-patches-bounces+patchwork=sourceware.org@sourceware.org Sender: "Gdb-patches" Commit 904d9b02a18 (gdb: make "maintenance info line-table" show relocated addresses again) have updated the "maintenance info line-table" command, but did not update the associated documentation. This patch updates the documentation to reflect the new command output. --- gdb/doc/gdb.texinfo | 33 ++++++++++++++++++++------------- 1 file changed, 20 insertions(+), 13 deletions(-) base-commit: bf3f6c02d73f9823b8cb4f59524f29fbbfb6126d diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index 6c811b8be2e..6b071c0cb1d 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -20345,21 +20345,28 @@ objfile: /home/gnu/build/a.out ((struct objfile *) 0x6120000e0d40) compunit_symtab: simple.cpp ((struct compunit_symtab *) 0x6210000ff450) symtab: /home/gnu/src/simple.cpp ((struct symtab *) 0x6210000ff4d0) linetable: ((struct linetable *) 0x62100012b760): -INDEX LINE ADDRESS IS-STMT PROLOGUE-END -0 3 0x0000000000401110 Y -1 4 0x0000000000401114 Y Y -2 9 0x0000000000401120 Y -3 10 0x0000000000401124 Y Y -4 10 0x0000000000401129 -5 15 0x0000000000401130 Y -6 16 0x0000000000401134 Y Y -7 16 0x0000000000401139 -8 21 0x0000000000401140 Y -9 22 0x000000000040114f Y Y -10 22 0x0000000000401154 -11 END 0x000000000040115a Y +INDEX LINE REL-ADDRESS UNREL-ADDRESS IS-STMT PROLOGUE-END +0 3 0x0000555555955110 0x0000000000401110 Y +1 4 0x0000555555955114 0x0000000000401114 Y Y +2 9 0x0000555555955120 0x0000000000401120 Y +3 10 0x0000555555955124 0x0000000000401124 Y Y +4 10 0x0000555555955129 0x0000000000401129 +5 15 0x0000555555955130 0x0000000000401130 Y +6 16 0x0000555555955134 0x0000000000401134 Y Y +7 16 0x0000555555955139 0x0000000000401139 +8 21 0x0000555555955140 0x0000000000401140 Y +9 22 0x000055555595514f 0x000000000040114f Y Y +10 22 0x0000555555955154 0x0000000000401154 +11 END 0x000055555595515a 0x000000000040115a Y @end smallexample @noindent +The @samp{UNREL-ADDRESS} column gives the unrelocated address of the +instruction as read from the debug information. The @samp{REL-ADDRESS} column +gives the corresponding address in the current inferior's memory (relocated +address). If the current inferior is not running when executing the command or +if the executable does not require relocation, the relocated address is the +same as the unrelocated address. + The @samp{IS-STMT} column indicates if the address is a recommended breakpoint location to represent a line or a statement. The @samp{PROLOGUE-END} column indicates that a given address is an adequate place to set a breakpoint at the