[v2] gdb: Update doc of the "maintenance info line-table"

Message ID 20230322172046.529306-1-lancelot.six@amd.com
State New
Headers
Series [v2] gdb: Update doc of the "maintenance info line-table" |

Commit Message

Lancelot SIX March 22, 2023, 5:20 p.m. UTC
  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
  

Patch

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