From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from lndn.lancelotsix.com (vps-42846194.vps.ovh.net [IPv6:2001:41d0:801:2000::2400]) by sourceware.org (Postfix) with ESMTPS id 64F3A385843D for ; Wed, 22 Mar 2023 10:27:03 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org 64F3A385843D Authentication-Results: sourceware.org; dmarc=fail (p=quarantine dis=none) header.from=amd.com Authentication-Results: sourceware.org; spf=fail smtp.mailfrom=amd.com Received: from localhost.localdomain (cust120-dsl54.idnet.net [212.69.54.120]) by lndn.lancelotsix.com (Postfix) with ESMTPSA id 140A789DA4; Wed, 22 Mar 2023 10:27:02 +0000 (UTC) From: Lancelot SIX To: gdb-patches@sourceware.org, simon.marchi@efficios.com Cc: lsix@lancelotsix.com, Lancelot SIX Subject: [PATCH 1/1] gdb: Update doc of the "maintenance info line-table" Date: Wed, 22 Mar 2023 10:26:42 +0000 Message-Id: <20230322102642.510635-2-lancelot.six@amd.com> X-Mailer: git-send-email 2.34.1 In-Reply-To: <20230322102642.510635-1-lancelot.six@amd.com> References: <7c2ba695-c6ec-5854-c81a-e84db28cc66b@simark.ca> <20230322102642.510635-1-lancelot.six@amd.com> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit 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 10:27:02 +0000 (UTC) X-Spam-Status: No, score=-8.9 required=5.0 tests=BAYES_00,GIT_PATCH_0,KAM_DMARC_QUARANTINE,KAM_DMARC_STATUS,KHOP_HELO_FCRDNS,RCVD_IN_SBL_CSS,SPF_HELO_NONE,SPF_SOFTFAIL,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 List-Id: 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 | 32 +++++++++++++++++++------------- 1 file changed, 19 insertions(+), 13 deletions(-) diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index 6c811b8be2e..dbb6267f3fd 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -20345,21 +20345,27 @@ 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 process memory (relocated address). If +no process is started when executing this command, 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 -- 2.34.1