From patchwork Wed Mar 22 10:26:42 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lancelot SIX X-Patchwork-Id: 66738 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 22D76385B52F for ; Wed, 22 Mar 2023 10:27:28 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 22D76385B52F DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=sourceware.org; s=default; t=1679480848; bh=u8wyvFcXKWeb0Ua+HhS1jmQQ7RSrlW7vwYyAxXQsvZE=; 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=q9OI326TNAM1c1wbAfv5qpcOGC20oV68bn8w3pff52WcblDI0pKStqOAS3muFRHB+ 7/K2kqRuUcFmOjI9eFuOXeh1PFNsBTeKQwstAjYsId9/5mdJb69o3X0XkP1yCwa5RL nVyWXZeWTxfhVNCJfyxMGHYQLplD0N1SL+B3UCpo= 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 64F3A385843D for ; Wed, 22 Mar 2023 10:27:03 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org 64F3A385843D 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) 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 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 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 | 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