This is the mail archive of the
gdb-patches@sources.redhat.com
mailing list for the GDB project.
-symbol-list-lines doco update
- From: Bob Rossi <bob at brasko dot net>
- To: gdb-patches at sources dot redhat dot com
- Date: Tue, 17 Feb 2004 10:43:39 -0500
- Subject: -symbol-list-lines doco update
This documents several of the special case's that -symbol-list-lines
outputs.
2004-02-17 Bob Rossi <bob@brasko.net>
* gdb.texinfo (-symbol-list-lines): Add info about the special
case's that this command outputs.
Index: gdb.texinfo
===================================================================
RCS file: /cvs/src/src/gdb/doc/gdb.texinfo,v
retrieving revision 1.195
diff -w -u -r1.195 gdb.texinfo
--- gdb.texinfo 17 Feb 2004 14:54:32 -0000 1.195
+++ gdb.texinfo 17 Feb 2004 15:35:21 -0000
@@ -17463,6 +17465,17 @@
addresses for the given source filename. The entries are sorted in
ascending PC order.
+There are two interesting points to be mentioned here.
+
+- The line number can be returned as "0". The line number "0" means
+end-of-sequence. For example, PCs greater than 0x8048406 that
+don't have a new starting line do not belong to this line number table.
+
+- Also, entries can be duplicated when returned. This means the front end
+must be capable of receiving several PC/line entries with the same value.
+Duplicated line numbers are emitted by the compiler to mark, mostly,
+the ends of prologues. Sometimes the prologue is zero-sized.
+
@subsubheading @value{GDBN} Command
There is no corresponding @value{GDBN} command.
@@ -17471,7 +17484,21 @@
@smallexample
(@value{GDBP})
-symbol-list-lines basics.c
-^done,lines=[@{pc="0x08048554",line="7"@},@{pc="0x0804855a",line="8"@}]
+^done,lines=[
+@{pc="0x080483e0",line="7"@},@{pc="0x080483e6",line="8"@},
+@{pc="0x080483ed",line="9"@},@{pc="0x080483f4",line="12"@},
+@{pc="0x08048400",line="13"@},@{pc="0x08048404",line="14"@},
+@{pc="0x08048404",line="14"@},@{pc="0x08048406",line="0"@},
+@{pc="0x08048408",line="16"@},@{pc="0x0804840e",line="17"@},
+@{pc="0x08048413",line="18"@},@{pc="0x08048415",line="0"@},
+@{pc="0x08048418",line="21"@},@{pc="0x0804841e",line="22"@},
+@{pc="0x0804842d",line="23"@},@{pc="0x0804842f",line="0"@},
+@{pc="0x08048430",line="26"@},@{pc="0x08048436",line="27"@},
+@{pc="0x08048449",line="28"@},@{pc="0x0804844b",line="0"@},
+@{pc="0x0804844c",line="31"@},@{pc="0x08048452",line="32"@},
+@{pc="0x0804846d",line="33"@},@{pc="0x08048488",line="35"@},
+@{pc="0x08048498",line="37"@},@{pc="0x0804849c",line="38"@},
+@{pc="0x0804849c",line="38"@},@{pc="0x080484a2",line="0"@}]
(@value{GDBP})
@end smallexample