1 /* Debug logging for the symbol file functions for the GNU debugger, GDB.
3 Copyright (C) 2013-2018 Free Software Foundation, Inc.
5 Contributed by Cygnus Support, using pieces from other GDB modules.
7 This file is part of GDB.
9 This program is free software; you can redistribute it and/or modify
10 it under the terms of the GNU General Public License as published by
11 the Free Software Foundation; either version 3 of the License, or
12 (at your option) any later version.
14 This program is distributed in the hope that it will be useful,
15 but WITHOUT ANY WARRANTY; without even the implied warranty of
16 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 GNU General Public License for more details.
19 You should have received a copy of the GNU General Public License
20 along with this program. If not, see <http://www.gnu.org/licenses/>. */
22 /* Note: Be careful with functions that can throw errors.
23 We want to see a logging message regardless of whether an error was thrown.
24 This typically means printing a message before calling the real function
25 and then if the function returns a result printing a message after it
36 /* We need to save a pointer to the real symbol functions.
37 Plus, the debug versions are malloc'd because we have to NULL out the
38 ones that are NULL in the real copy. */
40 struct debug_sym_fns_data
42 const struct sym_fns *real_sf;
43 struct sym_fns debug_sf;
46 /* We need to record a pointer to the real set of functions for each
48 static const struct objfile_data *symfile_debug_objfile_data_key;
50 /* If non-zero all calls to the symfile functions are logged. */
51 static int debug_symfile = 0;
53 /* Return non-zero if symfile debug logging is installed. */
56 symfile_debug_installed (struct objfile *objfile)
58 return (objfile->sf != NULL
59 && objfile_data (objfile, symfile_debug_objfile_data_key) != NULL);
62 /* Utility return the name to print for SYMTAB. */
65 debug_symtab_name (struct symtab *symtab)
67 return symtab_to_filename_for_display (symtab);
70 /* Debugging version of struct quick_symbol_functions. */
73 debug_qf_has_symbols (struct objfile *objfile)
75 const struct debug_sym_fns_data *debug_data
76 = ((const struct debug_sym_fns_data *)
77 objfile_data (objfile, symfile_debug_objfile_data_key));
80 retval = debug_data->real_sf->qf->has_symbols (objfile);
82 fprintf_filtered (gdb_stdlog, "qf->has_symbols (%s) = %d\n",
83 objfile_debug_name (objfile), retval);
88 static struct symtab *
89 debug_qf_find_last_source_symtab (struct objfile *objfile)
91 const struct debug_sym_fns_data *debug_data
92 = ((const struct debug_sym_fns_data *)
93 objfile_data (objfile, symfile_debug_objfile_data_key));
94 struct symtab *retval;
96 fprintf_filtered (gdb_stdlog, "qf->find_last_source_symtab (%s)\n",
97 objfile_debug_name (objfile));
99 retval = debug_data->real_sf->qf->find_last_source_symtab (objfile);
101 fprintf_filtered (gdb_stdlog, "qf->find_last_source_symtab (...) = %s\n",
102 retval ? debug_symtab_name (retval) : "NULL");
108 debug_qf_forget_cached_source_info (struct objfile *objfile)
110 const struct debug_sym_fns_data *debug_data
111 = ((const struct debug_sym_fns_data *)
112 objfile_data (objfile, symfile_debug_objfile_data_key));
114 fprintf_filtered (gdb_stdlog, "qf->forget_cached_source_info (%s)\n",
115 objfile_debug_name (objfile));
117 debug_data->real_sf->qf->forget_cached_source_info (objfile);
121 debug_qf_map_symtabs_matching_filename
122 (struct objfile *objfile, const char *name, const char *real_path,
123 gdb::function_view<bool (symtab *)> callback)
125 const struct debug_sym_fns_data *debug_data
126 = ((const struct debug_sym_fns_data *)
127 objfile_data (objfile, symfile_debug_objfile_data_key));
129 fprintf_filtered (gdb_stdlog,
130 "qf->map_symtabs_matching_filename (%s, \"%s\", \"%s\", %s)\n",
131 objfile_debug_name (objfile), name,
132 real_path ? real_path : NULL,
133 host_address_to_string (&callback));
135 bool retval = (debug_data->real_sf->qf->map_symtabs_matching_filename
136 (objfile, name, real_path, callback));
138 fprintf_filtered (gdb_stdlog,
139 "qf->map_symtabs_matching_filename (...) = %d\n",
145 static struct compunit_symtab *
146 debug_qf_lookup_symbol (struct objfile *objfile, int kind, const char *name,
149 const struct debug_sym_fns_data *debug_data
150 = ((const struct debug_sym_fns_data *)
151 objfile_data (objfile, symfile_debug_objfile_data_key));
152 struct compunit_symtab *retval;
154 fprintf_filtered (gdb_stdlog,
155 "qf->lookup_symbol (%s, %d, \"%s\", %s)\n",
156 objfile_debug_name (objfile), kind, name,
157 domain_name (domain));
159 retval = debug_data->real_sf->qf->lookup_symbol (objfile, kind, name,
162 fprintf_filtered (gdb_stdlog, "qf->lookup_symbol (...) = %s\n",
164 ? debug_symtab_name (compunit_primary_filetab (retval))
171 debug_qf_print_stats (struct objfile *objfile)
173 const struct debug_sym_fns_data *debug_data
174 = ((const struct debug_sym_fns_data *)
175 objfile_data (objfile, symfile_debug_objfile_data_key));
177 fprintf_filtered (gdb_stdlog, "qf->print_stats (%s)\n",
178 objfile_debug_name (objfile));
180 debug_data->real_sf->qf->print_stats (objfile);
184 debug_qf_dump (struct objfile *objfile)
186 const struct debug_sym_fns_data *debug_data
187 = ((const struct debug_sym_fns_data *)
188 objfile_data (objfile, symfile_debug_objfile_data_key));
190 fprintf_filtered (gdb_stdlog, "qf->dump (%s)\n",
191 objfile_debug_name (objfile));
193 debug_data->real_sf->qf->dump (objfile);
197 debug_qf_relocate (struct objfile *objfile,
198 const struct section_offsets *new_offsets,
199 const struct section_offsets *delta)
201 const struct debug_sym_fns_data *debug_data
202 = ((const struct debug_sym_fns_data *)
203 objfile_data (objfile, symfile_debug_objfile_data_key));
205 fprintf_filtered (gdb_stdlog, "qf->relocate (%s, %s, %s)\n",
206 objfile_debug_name (objfile),
207 host_address_to_string (new_offsets),
208 host_address_to_string (delta));
210 debug_data->real_sf->qf->relocate (objfile, new_offsets, delta);
214 debug_qf_expand_symtabs_for_function (struct objfile *objfile,
215 const char *func_name)
217 const struct debug_sym_fns_data *debug_data
218 = ((const struct debug_sym_fns_data *)
219 objfile_data (objfile, symfile_debug_objfile_data_key));
221 fprintf_filtered (gdb_stdlog,
222 "qf->expand_symtabs_for_function (%s, \"%s\")\n",
223 objfile_debug_name (objfile), func_name);
225 debug_data->real_sf->qf->expand_symtabs_for_function (objfile, func_name);
229 debug_qf_expand_all_symtabs (struct objfile *objfile)
231 const struct debug_sym_fns_data *debug_data
232 = ((const struct debug_sym_fns_data *)
233 objfile_data (objfile, symfile_debug_objfile_data_key));
235 fprintf_filtered (gdb_stdlog, "qf->expand_all_symtabs (%s)\n",
236 objfile_debug_name (objfile));
238 debug_data->real_sf->qf->expand_all_symtabs (objfile);
242 debug_qf_expand_symtabs_with_fullname (struct objfile *objfile,
243 const char *fullname)
245 const struct debug_sym_fns_data *debug_data
246 = ((const struct debug_sym_fns_data *)
247 objfile_data (objfile, symfile_debug_objfile_data_key));
249 fprintf_filtered (gdb_stdlog,
250 "qf->expand_symtabs_with_fullname (%s, \"%s\")\n",
251 objfile_debug_name (objfile), fullname);
253 debug_data->real_sf->qf->expand_symtabs_with_fullname (objfile, fullname);
257 debug_qf_map_matching_symbols (struct objfile *objfile,
258 const char *name, domain_enum domain,
260 int (*callback) (struct block *,
261 struct symbol *, void *),
263 symbol_name_match_type match,
264 symbol_compare_ftype *ordered_compare)
266 const struct debug_sym_fns_data *debug_data
267 = ((const struct debug_sym_fns_data *)
268 objfile_data (objfile, symfile_debug_objfile_data_key));
270 fprintf_filtered (gdb_stdlog,
271 "qf->map_matching_symbols (%s, \"%s\", %s, %d, %s, %s, %s, %s)\n",
272 objfile_debug_name (objfile), name,
273 domain_name (domain), global,
274 host_address_to_string (callback),
275 host_address_to_string (data),
276 plongest ((LONGEST) match),
277 host_address_to_string (ordered_compare));
279 debug_data->real_sf->qf->map_matching_symbols (objfile, name,
287 debug_qf_expand_symtabs_matching
288 (struct objfile *objfile,
289 gdb::function_view<expand_symtabs_file_matcher_ftype> file_matcher,
290 const lookup_name_info &lookup_name,
291 gdb::function_view<expand_symtabs_symbol_matcher_ftype> symbol_matcher,
292 gdb::function_view<expand_symtabs_exp_notify_ftype> expansion_notify,
293 enum search_domain kind)
295 const struct debug_sym_fns_data *debug_data
296 = ((const struct debug_sym_fns_data *)
297 objfile_data (objfile, symfile_debug_objfile_data_key));
299 fprintf_filtered (gdb_stdlog,
300 "qf->expand_symtabs_matching (%s, %s, %s, %s, %s)\n",
301 objfile_debug_name (objfile),
302 host_address_to_string (&file_matcher),
303 host_address_to_string (&symbol_matcher),
304 host_address_to_string (&expansion_notify),
305 search_domain_name (kind));
307 debug_data->real_sf->qf->expand_symtabs_matching (objfile,
315 static struct compunit_symtab *
316 debug_qf_find_pc_sect_compunit_symtab (struct objfile *objfile,
317 struct bound_minimal_symbol msymbol,
319 struct obj_section *section,
322 const struct debug_sym_fns_data *debug_data
323 = ((const struct debug_sym_fns_data *)
324 objfile_data (objfile, symfile_debug_objfile_data_key));
325 struct compunit_symtab *retval;
327 fprintf_filtered (gdb_stdlog,
328 "qf->find_pc_sect_compunit_symtab (%s, %s, %s, %s, %d)\n",
329 objfile_debug_name (objfile),
330 host_address_to_string (msymbol.minsym),
332 host_address_to_string (section),
336 = debug_data->real_sf->qf->find_pc_sect_compunit_symtab (objfile, msymbol,
340 fprintf_filtered (gdb_stdlog,
341 "qf->find_pc_sect_compunit_symtab (...) = %s\n",
343 ? debug_symtab_name (compunit_primary_filetab (retval))
350 debug_qf_map_symbol_filenames (struct objfile *objfile,
351 symbol_filename_ftype *fun, void *data,
354 const struct debug_sym_fns_data *debug_data
355 = ((const struct debug_sym_fns_data *)
356 objfile_data (objfile, symfile_debug_objfile_data_key));
357 fprintf_filtered (gdb_stdlog,
358 "qf->map_symbol_filenames (%s, %s, %s, %d)\n",
359 objfile_debug_name (objfile),
360 host_address_to_string (fun),
361 host_address_to_string (data),
364 debug_data->real_sf->qf->map_symbol_filenames (objfile, fun, data,
368 static struct compunit_symtab *
369 debug_qf_find_compunit_symtab_by_address (struct objfile *objfile,
372 const struct debug_sym_fns_data *debug_data
373 = ((const struct debug_sym_fns_data *)
374 objfile_data (objfile, symfile_debug_objfile_data_key));
375 fprintf_filtered (gdb_stdlog,
376 "qf->find_compunit_symtab_by_address (%s, %s)\n",
377 objfile_debug_name (objfile),
378 hex_string (address));
380 struct compunit_symtab *result = NULL;
381 if (debug_data->real_sf->qf->map_symbol_filenames != NULL)
383 = debug_data->real_sf->qf->find_compunit_symtab_by_address (objfile,
386 fprintf_filtered (gdb_stdlog,
387 "qf->find_compunit_symtab_by_address (...) = %s\n",
389 ? debug_symtab_name (compunit_primary_filetab (result))
395 static const struct quick_symbol_functions debug_sym_quick_functions =
397 debug_qf_has_symbols,
398 debug_qf_find_last_source_symtab,
399 debug_qf_forget_cached_source_info,
400 debug_qf_map_symtabs_matching_filename,
401 debug_qf_lookup_symbol,
402 debug_qf_print_stats,
405 debug_qf_expand_symtabs_for_function,
406 debug_qf_expand_all_symtabs,
407 debug_qf_expand_symtabs_with_fullname,
408 debug_qf_map_matching_symbols,
409 debug_qf_expand_symtabs_matching,
410 debug_qf_find_pc_sect_compunit_symtab,
411 debug_qf_find_compunit_symtab_by_address,
412 debug_qf_map_symbol_filenames
415 /* Debugging version of struct sym_probe_fns. */
417 static const std::vector<probe *> &
418 debug_sym_get_probes (struct objfile *objfile)
420 const struct debug_sym_fns_data *debug_data
421 = ((const struct debug_sym_fns_data *)
422 objfile_data (objfile, symfile_debug_objfile_data_key));
424 const std::vector<probe *> &retval
425 = debug_data->real_sf->sym_probe_fns->sym_get_probes (objfile);
427 fprintf_filtered (gdb_stdlog,
428 "probes->sym_get_probes (%s) = %s\n",
429 objfile_debug_name (objfile),
430 host_address_to_string (retval.data ()));
435 static const struct sym_probe_fns debug_sym_probe_fns =
437 debug_sym_get_probes,
440 /* Debugging version of struct sym_fns. */
443 debug_sym_new_init (struct objfile *objfile)
445 const struct debug_sym_fns_data *debug_data
446 = ((const struct debug_sym_fns_data *)
447 objfile_data (objfile, symfile_debug_objfile_data_key));
449 fprintf_filtered (gdb_stdlog, "sf->sym_new_init (%s)\n",
450 objfile_debug_name (objfile));
452 debug_data->real_sf->sym_new_init (objfile);
456 debug_sym_init (struct objfile *objfile)
458 const struct debug_sym_fns_data *debug_data
459 = ((const struct debug_sym_fns_data *)
460 objfile_data (objfile, symfile_debug_objfile_data_key));
462 fprintf_filtered (gdb_stdlog, "sf->sym_init (%s)\n",
463 objfile_debug_name (objfile));
465 debug_data->real_sf->sym_init (objfile);
469 debug_sym_read (struct objfile *objfile, symfile_add_flags symfile_flags)
471 const struct debug_sym_fns_data *debug_data
472 = ((const struct debug_sym_fns_data *)
473 objfile_data (objfile, symfile_debug_objfile_data_key));
475 fprintf_filtered (gdb_stdlog, "sf->sym_read (%s, 0x%x)\n",
476 objfile_debug_name (objfile), (unsigned) symfile_flags);
478 debug_data->real_sf->sym_read (objfile, symfile_flags);
482 debug_sym_read_psymbols (struct objfile *objfile)
484 const struct debug_sym_fns_data *debug_data
485 = ((const struct debug_sym_fns_data *)
486 objfile_data (objfile, symfile_debug_objfile_data_key));
488 fprintf_filtered (gdb_stdlog, "sf->sym_read_psymbols (%s)\n",
489 objfile_debug_name (objfile));
491 debug_data->real_sf->sym_read_psymbols (objfile);
495 debug_sym_finish (struct objfile *objfile)
497 const struct debug_sym_fns_data *debug_data
498 = ((const struct debug_sym_fns_data *)
499 objfile_data (objfile, symfile_debug_objfile_data_key));
501 fprintf_filtered (gdb_stdlog, "sf->sym_finish (%s)\n",
502 objfile_debug_name (objfile));
504 debug_data->real_sf->sym_finish (objfile);
508 debug_sym_offsets (struct objfile *objfile,
509 const struct section_addr_info *info)
511 const struct debug_sym_fns_data *debug_data
512 = ((const struct debug_sym_fns_data *)
513 objfile_data (objfile, symfile_debug_objfile_data_key));
515 fprintf_filtered (gdb_stdlog, "sf->sym_offsets (%s, %s)\n",
516 objfile_debug_name (objfile),
517 host_address_to_string (info));
519 debug_data->real_sf->sym_offsets (objfile, info);
522 static struct symfile_segment_data *
523 debug_sym_segments (bfd *abfd)
525 /* This API function is annoying, it doesn't take a "this" pointer.
526 Fortunately it is only used in one place where we (re-)lookup the
527 sym_fns table to use. Thus we will never be called. */
528 gdb_assert_not_reached ("debug_sym_segments called");
532 debug_sym_read_linetable (struct objfile *objfile)
534 const struct debug_sym_fns_data *debug_data
535 = ((const struct debug_sym_fns_data *)
536 objfile_data (objfile, symfile_debug_objfile_data_key));
538 fprintf_filtered (gdb_stdlog, "sf->sym_read_linetable (%s)\n",
539 objfile_debug_name (objfile));
541 debug_data->real_sf->sym_read_linetable (objfile);
545 debug_sym_relocate (struct objfile *objfile, asection *sectp, bfd_byte *buf)
547 const struct debug_sym_fns_data *debug_data
548 = ((const struct debug_sym_fns_data *)
549 objfile_data (objfile, symfile_debug_objfile_data_key));
552 retval = debug_data->real_sf->sym_relocate (objfile, sectp, buf);
554 fprintf_filtered (gdb_stdlog,
555 "sf->sym_relocate (%s, %s, %s) = %s\n",
556 objfile_debug_name (objfile),
557 host_address_to_string (sectp),
558 host_address_to_string (buf),
559 host_address_to_string (retval));
564 /* Template of debugging version of struct sym_fns.
565 A copy is made, with sym_flavour updated, and a pointer to the real table
566 installed in real_sf, and then a pointer to the copy is installed in the
569 static const struct sym_fns debug_sym_fns =
574 debug_sym_read_psymbols,
578 debug_sym_read_linetable,
580 &debug_sym_probe_fns,
581 &debug_sym_quick_functions
584 /* Free the copy of sym_fns recorded in the registry. */
587 symfile_debug_free_objfile (struct objfile *objfile, void *datum)
592 /* Install the debugging versions of the symfile functions for OBJFILE.
593 Do not call this if the debug versions are already installed. */
596 install_symfile_debug_logging (struct objfile *objfile)
598 const struct sym_fns *real_sf;
599 struct debug_sym_fns_data *debug_data;
601 /* The debug versions should not already be installed. */
602 gdb_assert (!symfile_debug_installed (objfile));
604 real_sf = objfile->sf;
606 /* Alas we have to preserve NULL entries in REAL_SF. */
607 debug_data = XCNEW (struct debug_sym_fns_data);
609 #define COPY_SF_PTR(from, to, name, func) \
612 (to)->debug_sf.name = func; \
615 COPY_SF_PTR (real_sf, debug_data, sym_new_init, debug_sym_new_init);
616 COPY_SF_PTR (real_sf, debug_data, sym_init, debug_sym_init);
617 COPY_SF_PTR (real_sf, debug_data, sym_read, debug_sym_read);
618 COPY_SF_PTR (real_sf, debug_data, sym_read_psymbols,
619 debug_sym_read_psymbols);
620 COPY_SF_PTR (real_sf, debug_data, sym_finish, debug_sym_finish);
621 COPY_SF_PTR (real_sf, debug_data, sym_offsets, debug_sym_offsets);
622 COPY_SF_PTR (real_sf, debug_data, sym_segments, debug_sym_segments);
623 COPY_SF_PTR (real_sf, debug_data, sym_read_linetable,
624 debug_sym_read_linetable);
625 COPY_SF_PTR (real_sf, debug_data, sym_relocate, debug_sym_relocate);
626 if (real_sf->sym_probe_fns)
627 debug_data->debug_sf.sym_probe_fns = &debug_sym_probe_fns;
628 debug_data->debug_sf.qf = &debug_sym_quick_functions;
632 debug_data->real_sf = real_sf;
633 set_objfile_data (objfile, symfile_debug_objfile_data_key, debug_data);
634 objfile->sf = &debug_data->debug_sf;
637 /* Uninstall the debugging versions of the symfile functions for OBJFILE.
638 Do not call this if the debug versions are not installed. */
641 uninstall_symfile_debug_logging (struct objfile *objfile)
643 struct debug_sym_fns_data *debug_data;
645 /* The debug versions should be currently installed. */
646 gdb_assert (symfile_debug_installed (objfile));
648 debug_data = ((struct debug_sym_fns_data *)
649 objfile_data (objfile, symfile_debug_objfile_data_key));
651 objfile->sf = debug_data->real_sf;
653 set_objfile_data (objfile, symfile_debug_objfile_data_key, NULL);
656 /* Call this function to set OBJFILE->SF.
657 Do not set OBJFILE->SF directly. */
660 objfile_set_sym_fns (struct objfile *objfile, const struct sym_fns *sf)
662 if (symfile_debug_installed (objfile))
664 gdb_assert (debug_symfile);
665 /* Remove the current one, and reinstall a new one later. */
666 uninstall_symfile_debug_logging (objfile);
669 /* Assume debug logging is disabled. */
672 /* Turn debug logging on if enabled. */
674 install_symfile_debug_logging (objfile);
678 set_debug_symfile (const char *args, int from_tty, struct cmd_list_element *c)
680 struct program_space *pspace;
681 struct objfile *objfile;
684 ALL_PSPACE_OBJFILES (pspace, objfile)
688 if (!symfile_debug_installed (objfile))
689 install_symfile_debug_logging (objfile);
693 if (symfile_debug_installed (objfile))
694 uninstall_symfile_debug_logging (objfile);
700 show_debug_symfile (struct ui_file *file, int from_tty,
701 struct cmd_list_element *c, const char *value)
703 fprintf_filtered (file, _("Symfile debugging is %s.\n"), value);
707 _initialize_symfile_debug (void)
709 symfile_debug_objfile_data_key
710 = register_objfile_data_with_cleanup (NULL, symfile_debug_free_objfile);
712 add_setshow_boolean_cmd ("symfile", no_class, &debug_symfile, _("\
713 Set debugging of the symfile functions."), _("\
714 Show debugging of the symfile functions."), _("\
715 When enabled, all calls to the symfile functions are logged."),
716 set_debug_symfile, show_debug_symfile,
717 &setdebuglist, &showdebuglist);
719 /* Note: We don't need a new-objfile observer because debug logging
720 will be installed when objfile init'n calls objfile_set_sym_fns. */