aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorChristian Biesinger <cbiesinger@google.com>2019-07-31 17:10:50 -0500
committerChristian Biesinger <cbiesinger@google.com>2019-08-05 10:35:35 -0500
commit4ee94178afbe062bc244d28595f86d63633a7af7 (patch)
tree2a2eeb6f68df12e7abf202073a6ba71e25f299e4
parent276cbbdf990f3f09acacdf3d9603b054ac7d29da (diff)
downloadgdb-4ee94178afbe062bc244d28595f86d63633a7af7.zip
gdb-4ee94178afbe062bc244d28595f86d63633a7af7.tar.gz
gdb-4ee94178afbe062bc244d28595f86d63633a7af7.tar.bz2
Add a comment briefly explaining partial symbols
Based on an explanation by tromey on IRC. gdb/ChangeLog: 2019-08-05 Christian Biesinger <cbiesinger@google.com> * objfiles.h (objfile): Add a comment describing partial symbols.
-rw-r--r--gdb/ChangeLog4
-rw-r--r--gdb/objfiles.h8
2 files changed, 11 insertions, 1 deletions
diff --git a/gdb/ChangeLog b/gdb/ChangeLog
index 0d324a5..da1d636 100644
--- a/gdb/ChangeLog
+++ b/gdb/ChangeLog
@@ -1,3 +1,7 @@
+2019-08-05 Christian Biesinger <cbiesinger@google.com>
+
+ * objfiles.h (objfile): Add a comment describing partial symbols.
+
2019-08-05 Tom Tromey <tromey@adacore.com>
* compile/compile.c (_initialize_compile): Use _(), not N_().
diff --git a/gdb/objfiles.h b/gdb/objfiles.h
index a0c106b..239aba2 100644
--- a/gdb/objfiles.h
+++ b/gdb/objfiles.h
@@ -382,7 +382,13 @@ private:
2. Additional symbol files added by the add-symbol-file command,
3. Shared library objfiles, added by ADD_SOLIB, 4. symbol files
for modules that were loaded when GDB attached to a remote system
- (see remote-vx.c). */
+ (see remote-vx.c).
+
+ GDB typically reads symbols twice -- first an initial scan which just
+ reads "partial symbols"; these are partial information for the
+ static/global symbols in a symbol file. When later looking up symbols,
+ objfile->sf->qf->lookup_symbol is used to check if we only have a partial
+ symbol and if so, read and expand the full compunit. */
struct objfile
{