1 /* Generic symbol file reading for the GNU debugger, GDB.
2 Copyright 1990, 1991, 1992, 1993 Free Software Foundation, Inc.
3 Contributed by Cygnus Support, using pieces from other GDB modules.
5 This file is part of GDB.
7 This program is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 2 of the License, or
10 (at your option) any later version.
12 This program is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with this program; if not, write to the Free Software
19 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. */
31 #include "breakpoint.h"
33 #include "complaints.h"
35 #include "inferior.h" /* for write_pc */
40 #include <sys/types.h>
50 /* Global variables owned by this file */
52 int readnow_symbol_files
; /* Read full symbols immediately */
54 struct complaint oldsyms_complaint
= {
55 "Replacing old symbols for `%s'", 0, 0
58 struct complaint empty_symtab_complaint
= {
59 "Empty symbol table found for `%s'", 0, 0
62 /* External variables and functions referenced. */
64 extern int info_verbose
;
66 /* Functions this file defines */
69 set_initial_language
PARAMS ((void));
72 load_command
PARAMS ((char *, int));
75 add_symbol_file_command
PARAMS ((char *, int));
78 cashier_psymtab
PARAMS ((struct partial_symtab
*));
81 compare_psymbols
PARAMS ((const void *, const void *));
84 compare_symbols
PARAMS ((const void *, const void *));
87 symfile_bfd_open
PARAMS ((char *));
90 find_sym_fns
PARAMS ((struct objfile
*));
92 /* List of all available sym_fns. On gdb startup, each object file reader
93 calls add_symtab_fns() to register information on each format it is
96 static struct sym_fns
*symtab_fns
= NULL
;
98 /* Structures with which to manage partial symbol allocation. */
100 struct psymbol_allocation_list global_psymbols
= {0}, static_psymbols
= {0};
102 /* Flag for whether user will be reloading symbols multiple times.
103 Defaults to ON for VxWorks, otherwise OFF. */
105 #ifdef SYMBOL_RELOADING_DEFAULT
106 int symbol_reloading
= SYMBOL_RELOADING_DEFAULT
;
108 int symbol_reloading
= 0;
112 /* Since this function is called from within qsort, in an ANSI environment
113 it must conform to the prototype for qsort, which specifies that the
114 comparison function takes two "void *" pointers. */
117 compare_symbols (s1p
, s2p
)
121 register struct symbol
**s1
, **s2
;
123 s1
= (struct symbol
**) s1p
;
124 s2
= (struct symbol
**) s2p
;
126 return (STRCMP (SYMBOL_NAME (*s1
), SYMBOL_NAME (*s2
)));
133 compare_psymbols -- compare two partial symbols by name
137 Given pointer to two partial symbol table entries, compare
138 them by name and return -N, 0, or +N (ala strcmp). Typically
139 used by sorting routines like qsort().
143 Does direct compare of first two characters before punting
144 and passing to strcmp for longer compares. Note that the
145 original version had a bug whereby two null strings or two
146 identically named one character strings would return the
147 comparison of memory following the null byte.
152 compare_psymbols (s1p
, s2p
)
156 register char *st1
= SYMBOL_NAME ((struct partial_symbol
*) s1p
);
157 register char *st2
= SYMBOL_NAME ((struct partial_symbol
*) s2p
);
159 if ((st1
[0] - st2
[0]) || !st1
[0])
161 return (st1
[0] - st2
[0]);
163 else if ((st1
[1] - st2
[1]) || !st1
[1])
165 return (st1
[1] - st2
[1]);
169 return (STRCMP (st1
+ 2, st2
+ 2));
174 sort_pst_symbols (pst
)
175 struct partial_symtab
*pst
;
177 /* Sort the global list; don't sort the static list */
179 qsort (pst
-> objfile
-> global_psymbols
.list
+ pst
-> globals_offset
,
180 pst
-> n_global_syms
, sizeof (struct partial_symbol
),
184 /* Call sort_block_syms to sort alphabetically the symbols of one block. */
188 register struct block
*b
;
190 qsort (&BLOCK_SYM (b
, 0), BLOCK_NSYMS (b
),
191 sizeof (struct symbol
*), compare_symbols
);
194 /* Call sort_symtab_syms to sort alphabetically
195 the symbols of each block of one symtab. */
199 register struct symtab
*s
;
201 register struct blockvector
*bv
;
204 register struct block
*b
;
208 bv
= BLOCKVECTOR (s
);
209 nbl
= BLOCKVECTOR_NBLOCKS (bv
);
210 for (i
= 0; i
< nbl
; i
++)
212 b
= BLOCKVECTOR_BLOCK (bv
, i
);
213 if (BLOCK_SHOULD_SORT (b
))
218 /* Make a copy of the string at PTR with SIZE characters in the symbol obstack
219 (and add a null character at the end in the copy).
220 Returns the address of the copy. */
223 obsavestring (ptr
, size
, obstackp
)
226 struct obstack
*obstackp
;
228 register char *p
= (char *) obstack_alloc (obstackp
, size
+ 1);
229 /* Open-coded memcpy--saves function call time.
230 These strings are usually short. */
232 register char *p1
= ptr
;
233 register char *p2
= p
;
234 char *end
= ptr
+ size
;
242 /* Concatenate strings S1, S2 and S3; return the new string.
243 Space is found in the symbol_obstack. */
246 obconcat (obstackp
, s1
, s2
, s3
)
247 struct obstack
*obstackp
;
248 const char *s1
, *s2
, *s3
;
250 register int len
= strlen (s1
) + strlen (s2
) + strlen (s3
) + 1;
251 register char *val
= (char *) obstack_alloc (obstackp
, len
);
258 /* Get the symbol table that corresponds to a partial_symtab.
259 This is fast after the first time you do it. In fact, there
260 is an even faster macro PSYMTAB_TO_SYMTAB that does the fast
264 psymtab_to_symtab (pst
)
265 register struct partial_symtab
*pst
;
267 /* If it's been looked up before, return it. */
271 /* If it has not yet been read in, read it. */
274 (*pst
->read_symtab
) (pst
);
280 /* Initialize entry point information for this objfile. */
283 init_entry_point_info (objfile
)
284 struct objfile
*objfile
;
286 /* Save startup file's range of PC addresses to help blockframe.c
287 decide where the bottom of the stack is. */
289 if (bfd_get_file_flags (objfile
-> obfd
) & EXEC_P
)
291 /* Executable file -- record its entry point so we'll recognize
292 the startup file because it contains the entry point. */
293 objfile
-> ei
.entry_point
= bfd_get_start_address (objfile
-> obfd
);
297 /* Examination of non-executable.o files. Short-circuit this stuff. */
298 /* ~0 will not be in any file, we hope. */
299 objfile
-> ei
.entry_point
= ~0;
300 /* set the startup file to be an empty range. */
301 objfile
-> ei
.entry_file_lowpc
= 0;
302 objfile
-> ei
.entry_file_highpc
= 0;
306 /* Get current entry point address. */
309 entry_point_address()
311 return symfile_objfile
? symfile_objfile
->ei
.entry_point
: 0;
314 /* Remember the lowest-addressed loadable section we've seen.
315 This function is called via bfd_map_over_sections. */
317 #if 0 /* Not used yet */
319 find_lowest_section (abfd
, sect
, obj
)
324 asection
**lowest
= (asection
**)obj
;
326 if (0 == (bfd_get_section_flags (abfd
, sect
) & SEC_LOAD
))
329 *lowest
= sect
; /* First loadable section */
330 else if (bfd_section_vma (abfd
, *lowest
) >= bfd_section_vma (abfd
, sect
))
331 *lowest
= sect
; /* A lower loadable section */
335 /* Process a symbol file, as either the main file or as a dynamically
338 NAME is the file name (which will be tilde-expanded and made
339 absolute herein) (but we don't free or modify NAME itself).
340 FROM_TTY says how verbose to be. MAINLINE specifies whether this
341 is the main symbol file, or whether it's an extra symbol file such
342 as dynamically loaded code. If !mainline, ADDR is the address
343 where the text segment was loaded. If VERBO, the caller has printed
344 a verbose message about the symbol reading (and complaints can be
345 more terse about it). */
348 syms_from_objfile (objfile
, addr
, mainline
, verbo
)
349 struct objfile
*objfile
;
354 struct section_offsets
*section_offsets
;
355 asection
*lowest_sect
;
356 struct cleanup
*old_chain
;
358 init_entry_point_info (objfile
);
359 find_sym_fns (objfile
);
361 /* Make sure that partially constructed symbol tables will be cleaned up
362 if an error occurs during symbol reading. */
363 old_chain
= make_cleanup (free_objfile
, objfile
);
367 /* We will modify the main symbol table, make sure that all its users
368 will be cleaned up if an error occurs during symbol reading. */
369 make_cleanup (clear_symtab_users
, 0);
371 /* Since no error yet, throw away the old symbol table. */
373 if (symfile_objfile
!= NULL
)
375 free_objfile (symfile_objfile
);
376 symfile_objfile
= NULL
;
379 /* Currently we keep symbols from the add-symbol-file command.
380 If the user wants to get rid of them, they should do "symbol-file"
381 without arguments first. Not sure this is the best behavior
384 (*objfile
-> sf
-> sym_new_init
) (objfile
);
387 /* Convert addr into an offset rather than an absolute address.
388 We find the lowest address of a loaded segment in the objfile,
389 and assume that <addr> is where that got loaded. Due to historical
390 precedent, we warn if that doesn't happen to be the ".text"
395 addr
= 0; /* No offset from objfile addresses. */
399 lowest_sect
= bfd_get_section_by_name (objfile
->obfd
, ".text");
402 bfd_map_over_sections (objfile
->obfd
, find_lowest_section
,
406 if (lowest_sect
== 0)
407 warning ("no loadable sections found in added symbol-file %s",
409 else if (0 == bfd_get_section_name (objfile
->obfd
, lowest_sect
)
411 bfd_get_section_name (objfile
->obfd
, lowest_sect
)))
412 warning ("Lowest section in %s is %s at 0x%lx",
414 bfd_section_name (objfile
->obfd
, lowest_sect
),
415 (unsigned long) bfd_section_vma (objfile
->obfd
, lowest_sect
));
418 addr
-= bfd_section_vma (objfile
->obfd
, lowest_sect
);
421 /* Initialize symbol reading routines for this objfile, allow complaints to
422 appear for this new file, and record how verbose to be, then do the
423 initial symbol reading for this file. */
425 (*objfile
-> sf
-> sym_init
) (objfile
);
426 clear_complaints (1, verbo
);
428 section_offsets
= (*objfile
-> sf
-> sym_offsets
) (objfile
, addr
);
429 objfile
->section_offsets
= section_offsets
;
431 #ifndef IBM6000_TARGET
432 /* This is a SVR4/SunOS specific hack, I think. In any event, it
433 screws RS/6000. sym_offsets should be doing this sort of thing,
434 because it knows the mapping between bfd sections and
436 /* This is a hack. As far as I can tell, section offsets are not
437 target dependent. They are all set to addr with a couple of
438 exceptions. The exceptions are sysvr4 shared libraries, whose
439 offsets are kept in solib structures anyway and rs6000 xcoff
440 which handles shared libraries in a completely unique way.
442 Section offsets are built similarly, except that they are built
443 by adding addr in all cases because there is no clear mapping
444 from section_offsets into actual sections. Note that solib.c
445 has a different algorythm for finding section offsets.
447 These should probably all be collapsed into some target
448 independent form of shared library support. FIXME. */
452 struct obj_section
*s
;
454 for (s
= objfile
->sections
; s
< objfile
->sections_end
; ++s
)
456 s
->addr
-= s
->offset
;
458 s
->endaddr
-= s
->offset
;
463 #endif /* not IBM6000_TARGET */
465 (*objfile
-> sf
-> sym_read
) (objfile
, section_offsets
, mainline
);
467 /* Don't allow char * to have a typename (else would get caddr_t).
468 Ditto void *. FIXME: Check whether this is now done by all the
469 symbol readers themselves (many of them now do), and if so remove
472 TYPE_NAME (lookup_pointer_type (builtin_type_char
)) = 0;
473 TYPE_NAME (lookup_pointer_type (builtin_type_void
)) = 0;
475 /* Mark the objfile has having had initial symbol read attempted. Note
476 that this does not mean we found any symbols... */
478 objfile
-> flags
|= OBJF_SYMS
;
480 /* Discard cleanups as symbol reading was successful. */
482 discard_cleanups (old_chain
);
485 /* Perform required actions after either reading in the initial
486 symbols for a new objfile, or mapping in the symbols from a reusable
490 new_symfile_objfile (objfile
, mainline
, verbo
)
491 struct objfile
*objfile
;
496 /* If this is the main symbol file we have to clean up all users of the
497 old main symbol file. Otherwise it is sufficient to fixup all the
498 breakpoints that may have been redefined by this symbol file. */
501 /* OK, make it the "real" symbol file. */
502 symfile_objfile
= objfile
;
504 clear_symtab_users ();
508 breakpoint_re_set ();
511 /* We're done reading the symbol file; finish off complaints. */
512 clear_complaints (0, verbo
);
515 /* Process a symbol file, as either the main file or as a dynamically
518 NAME is the file name (which will be tilde-expanded and made
519 absolute herein) (but we don't free or modify NAME itself).
520 FROM_TTY says how verbose to be. MAINLINE specifies whether this
521 is the main symbol file, or whether it's an extra symbol file such
522 as dynamically loaded code. If !mainline, ADDR is the address
523 where the text segment was loaded.
525 Upon success, returns a pointer to the objfile that was added.
526 Upon failure, jumps back to command level (never returns). */
529 symbol_file_add (name
, from_tty
, addr
, mainline
, mapped
, readnow
)
537 struct objfile
*objfile
;
538 struct partial_symtab
*psymtab
;
541 /* Open a bfd for the file, and give user a chance to burp if we'd be
542 interactively wiping out any existing symbols. */
544 abfd
= symfile_bfd_open (name
);
546 if ((have_full_symbols () || have_partial_symbols ())
549 && !query ("Load new symbol table from \"%s\"? ", name
))
550 error ("Not confirmed.");
552 objfile
= allocate_objfile (abfd
, mapped
);
554 /* If the objfile uses a mapped symbol file, and we have a psymtab for
555 it, then skip reading any symbols at this time. */
557 if ((objfile
-> flags
& OBJF_MAPPED
) && (objfile
-> flags
& OBJF_SYMS
))
559 /* We mapped in an existing symbol table file that already has had
560 initial symbol reading performed, so we can skip that part. Notify
561 the user that instead of reading the symbols, they have been mapped.
563 if (from_tty
|| info_verbose
)
565 printf_filtered ("Mapped symbols for %s...", name
);
569 init_entry_point_info (objfile
);
570 find_sym_fns (objfile
);
574 /* We either created a new mapped symbol table, mapped an existing
575 symbol table file which has not had initial symbol reading
576 performed, or need to read an unmapped symbol table. */
577 if (from_tty
|| info_verbose
)
579 printf_filtered ("Reading symbols from %s...", name
);
583 syms_from_objfile (objfile
, addr
, mainline
, from_tty
);
586 /* We now have at least a partial symbol table. Check to see if the
587 user requested that all symbols be read on initial access via either
588 the gdb startup command line or on a per symbol file basis. Expand
589 all partial symbol tables for this objfile if so. */
591 if (readnow
|| readnow_symbol_files
)
593 if (from_tty
|| info_verbose
)
595 printf_filtered ("expanding to full symbols...");
600 for (psymtab
= objfile
-> psymtabs
;
602 psymtab
= psymtab
-> next
)
604 psymtab_to_symtab (psymtab
);
608 if (from_tty
|| info_verbose
)
610 printf_filtered ("done.\n");
614 new_symfile_objfile (objfile
, mainline
, from_tty
);
616 /* Getting new symbols may change our opinion about what is
619 reinit_frame_cache ();
624 /* This is the symbol-file command. Read the file, analyze its symbols,
625 and add a struct symtab to a symtab list. */
628 symbol_file_command (args
, from_tty
)
634 struct cleanup
*cleanups
;
642 if ((have_full_symbols () || have_partial_symbols ())
644 && !query ("Discard symbol table from `%s'? ",
645 symfile_objfile
-> name
))
646 error ("Not confirmed.");
647 free_all_objfiles ();
648 symfile_objfile
= NULL
;
651 printf ("No symbol file now.\n");
656 if ((argv
= buildargv (args
)) == NULL
)
660 cleanups
= make_cleanup (freeargv
, (char *) argv
);
661 while (*argv
!= NULL
)
663 if (STREQ (*argv
, "-mapped"))
667 else if (STREQ (*argv
, "-readnow"))
671 else if (**argv
== '-')
673 error ("unknown option `%s'", *argv
);
684 error ("no symbol file name was specified");
688 symbol_file_add (name
, from_tty
, (CORE_ADDR
)0, 1, mapped
, readnow
);
689 set_initial_language ();
691 do_cleanups (cleanups
);
695 /* Set the initial language.
697 A better solution would be to record the language in the psymtab when reading
698 partial symbols, and then use it (if known) to set the language. This would
699 be a win for formats that encode the language in an easily discoverable place,
700 such as DWARF. For stabs, we can jump through hoops looking for specially
701 named symbols or try to intuit the language from the specific type of stabs
702 we find, but we can't do that until later when we read in full symbols.
706 set_initial_language ()
708 struct partial_symtab
*pst
;
709 enum language lang
= language_unknown
;
711 pst
= find_main_psymtab ();
714 if (pst
-> filename
!= NULL
)
716 lang
= deduce_language_from_filename (pst
-> filename
);
718 if (lang
== language_unknown
)
720 /* Make C the default language */
724 expected_language
= current_language
; /* Don't warn the user */
728 /* Open file specified by NAME and hand it off to BFD for preliminary
729 analysis. Result is a newly initialized bfd *, which includes a newly
730 malloc'd` copy of NAME (tilde-expanded and made absolute).
731 In case of trouble, error() is called. */
734 symfile_bfd_open (name
)
741 name
= tilde_expand (name
); /* Returns 1st new malloc'd copy */
743 /* Look down path for it, allocate 2nd new malloc'd copy. */
744 desc
= openp (getenv ("PATH"), 1, name
, O_RDONLY
| O_BINARY
, 0, &absolute_name
);
747 make_cleanup (free
, name
);
748 perror_with_name (name
);
750 free (name
); /* Free 1st new malloc'd copy */
751 name
= absolute_name
; /* Keep 2nd malloc'd copy in bfd */
752 /* It'll be freed in free_objfile(). */
754 sym_bfd
= bfd_fdopenr (name
, gnutarget
, desc
);
758 make_cleanup (free
, name
);
759 error ("\"%s\": can't open to read symbols: %s.", name
,
760 bfd_errmsg (bfd_error
));
762 sym_bfd
->cacheable
= true;
764 if (!bfd_check_format (sym_bfd
, bfd_object
))
766 bfd_close (sym_bfd
); /* This also closes desc */
767 make_cleanup (free
, name
);
768 error ("\"%s\": can't read symbols: %s.", name
,
769 bfd_errmsg (bfd_error
));
775 /* Link a new symtab_fns into the global symtab_fns list. Called on gdb
776 startup by the _initialize routine in each object file format reader,
777 to register information about each format the the reader is prepared
784 sf
->next
= symtab_fns
;
789 /* Initialize to read symbols from the symbol file sym_bfd. It either
790 returns or calls error(). The result is an initialized struct sym_fns
791 in the objfile structure, that contains cached information about the
795 find_sym_fns (objfile
)
796 struct objfile
*objfile
;
800 for (sf
= symtab_fns
; sf
!= NULL
; sf
= sf
-> next
)
802 if (strncmp (bfd_get_target (objfile
-> obfd
),
803 sf
-> sym_name
, sf
-> sym_namelen
) == 0)
809 error ("I'm sorry, Dave, I can't do that. Symbol format `%s' unknown.",
810 bfd_get_target (objfile
-> obfd
));
813 /* This function runs the load command of our current target. */
816 load_command (arg
, from_tty
)
820 target_load (arg
, from_tty
);
823 /* This version of "load" should be usable for any target. Currently
824 it is just used for remote targets, not inftarg.c or core files,
825 on the theory that only in that case is it useful.
827 Avoiding xmodem and the like seems like a win (a) because we don't have
828 to worry about finding it, and (b) On VMS, fork() is very slow and so
829 we don't want to run a subprocess. On the other hand, I'm not sure how
830 performance compares. */
832 generic_load (filename
, from_tty
)
836 struct cleanup
*old_cleanups
;
838 bfd
*loadfile_bfd
= bfd_openr (filename
, gnutarget
);
839 if (loadfile_bfd
== NULL
)
841 perror_with_name (filename
);
844 old_cleanups
= make_cleanup (bfd_close
, loadfile_bfd
);
846 if (!bfd_check_format (loadfile_bfd
, bfd_object
))
848 error ("\"%s\" is not an object file: %s", filename
,
849 bfd_errmsg (bfd_error
));
852 for (s
= loadfile_bfd
->sections
; s
; s
= s
->next
)
854 if (s
->flags
& SEC_LOAD
)
858 size
= bfd_get_section_size_before_reloc (s
);
862 struct cleanup
*old_chain
;
865 buffer
= xmalloc (size
);
866 old_chain
= make_cleanup (free
, buffer
);
868 vma
= bfd_get_section_vma (loadfile_bfd
, s
);
870 /* Is this really necessary? I guess it gives the user something
871 to look at during a long download. */
872 printf_filtered ("Loading section %s, size 0x%lx vma 0x%lx\n",
873 bfd_get_section_name (loadfile_bfd
, s
),
874 (unsigned long) size
, (unsigned long) vma
);
876 bfd_get_section_contents (loadfile_bfd
, s
, buffer
, 0, size
);
878 target_write_memory (vma
, buffer
, size
);
880 do_cleanups (old_chain
);
885 /* We were doing this in remote-mips.c, I suspect it is right
886 for other targets too. */
887 write_pc (loadfile_bfd
->start_address
);
889 /* FIXME: are we supposed to call symbol_file_add or not? According to
890 a comment from remote-mips.c (where a call to symbol_file_add was
891 commented out), making the call confuses GDB if more than one file is
892 loaded in. remote-nindy.c had no call to symbol_file_add, but remote-vx.c
895 do_cleanups (old_cleanups
);
898 /* This function allows the addition of incrementally linked object files.
899 It does not modify any state in the target, only in the debugger. */
903 add_symbol_file_command (args
, from_tty
)
917 error ("add-symbol-file takes a file name and an address");
920 /* Make a copy of the string that we can safely write into. */
922 args
= strdup (args
);
923 make_cleanup (free
, args
);
925 /* Pick off any -option args and the file name. */
927 while ((*args
!= '\000') && (name
== NULL
))
929 while (isspace (*args
)) {args
++;}
931 while ((*args
!= '\000') && !isspace (*args
)) {args
++;}
940 else if (STREQ (arg
, "-mapped"))
944 else if (STREQ (arg
, "-readnow"))
950 error ("unknown option `%s'", arg
);
954 /* After picking off any options and the file name, args should be
955 left pointing at the remainder of the command line, which should
956 be the address expression to evaluate. */
958 if ((name
== NULL
) || (*args
== '\000') )
960 error ("add-symbol-file takes a file name and an address");
962 name
= tilde_expand (name
);
963 make_cleanup (free
, name
);
965 text_addr
= parse_and_eval_address (args
);
967 if (!query ("add symbol table from file \"%s\" at text_addr = %s?\n",
968 name
, local_hex_string ((unsigned long)text_addr
)))
969 error ("Not confirmed.");
971 symbol_file_add (name
, 0, text_addr
, 0, mapped
, readnow
);
974 /* Re-read symbols if a symbol-file has changed. */
978 struct objfile
*objfile
;
981 struct stat new_statbuf
;
984 /* With the addition of shared libraries, this should be modified,
985 the load time should be saved in the partial symbol tables, since
986 different tables may come from different source files. FIXME.
987 This routine should then walk down each partial symbol table
988 and see if the symbol table that it originates from has been changed */
990 for (objfile
= object_files
; objfile
; objfile
= objfile
->next
) {
992 #ifdef IBM6000_TARGET
993 /* If this object is from a shared library, then you should
994 stat on the library name, not member name. */
996 if (objfile
->obfd
->my_archive
)
997 res
= stat (objfile
->obfd
->my_archive
->filename
, &new_statbuf
);
1000 res
= stat (objfile
->name
, &new_statbuf
);
1002 /* FIXME, should use print_sys_errmsg but it's not filtered. */
1003 printf_filtered ("`%s' has disappeared; keeping its symbols.\n",
1007 new_modtime
= new_statbuf
.st_mtime
;
1008 if (new_modtime
!= objfile
->mtime
)
1010 struct cleanup
*old_cleanups
;
1011 struct section_offsets
*offsets
;
1013 int section_offsets_size
;
1015 printf_filtered ("`%s' has changed; re-reading symbols.\n",
1018 /* There are various functions like symbol_file_add,
1019 symfile_bfd_open, syms_from_objfile, etc., which might
1020 appear to do what we want. But they have various other
1021 effects which we *don't* want. So we just do stuff
1022 ourselves. We don't worry about mapped files (for one thing,
1023 any mapped file will be out of date). */
1025 /* If we get an error, blow away this objfile (not sure if
1026 that is the correct response for things like shared
1028 old_cleanups
= make_cleanup (free_objfile
, objfile
);
1029 /* We need to do this whenever any symbols go away. */
1030 make_cleanup (clear_symtab_users
, 0);
1032 /* Clean up any state BFD has sitting around. We don't need
1033 to close the descriptor but BFD lacks a way of closing the
1034 BFD without closing the descriptor. */
1035 if (!bfd_close (objfile
->obfd
))
1036 error ("Can't close BFD for %s.", objfile
->name
);
1037 objfile
->obfd
= bfd_openr (objfile
->name
, gnutarget
);
1038 if (objfile
->obfd
== NULL
)
1039 error ("Can't open %s to read symbols.", objfile
->name
);
1040 /* bfd_openr sets cacheable to true, which is what we want. */
1041 if (!bfd_check_format (objfile
->obfd
, bfd_object
))
1042 error ("Can't read symbols from %s: %s.", objfile
->name
,
1043 bfd_errmsg (bfd_error
));
1045 /* Save the offsets, we will nuke them with the rest of the
1047 num_offsets
= objfile
->num_sections
;
1048 section_offsets_size
=
1049 sizeof (struct section_offsets
)
1050 + sizeof (objfile
->section_offsets
->offsets
) * num_offsets
;
1051 offsets
= (struct section_offsets
*) alloca (section_offsets_size
);
1052 memcpy (offsets
, objfile
->section_offsets
, section_offsets_size
);
1054 /* Nuke all the state that we will re-read. Much of the following
1055 code which sets things to NULL really is necessary to tell
1056 other parts of GDB that there is nothing currently there. */
1058 /* FIXME: Do we have to free a whole linked list, or is this
1060 if (objfile
->global_psymbols
.list
)
1061 mfree (objfile
->md
, objfile
->global_psymbols
.list
);
1062 objfile
->global_psymbols
.list
= NULL
;
1063 objfile
->global_psymbols
.size
= 0;
1064 if (objfile
->static_psymbols
.list
)
1065 mfree (objfile
->md
, objfile
->static_psymbols
.list
);
1066 objfile
->static_psymbols
.list
= NULL
;
1067 objfile
->static_psymbols
.size
= 0;
1069 /* Free the obstacks for non-reusable objfiles */
1070 obstack_free (&objfile
-> psymbol_obstack
, 0);
1071 obstack_free (&objfile
-> symbol_obstack
, 0);
1072 obstack_free (&objfile
-> type_obstack
, 0);
1073 objfile
->sections
= NULL
;
1074 objfile
->symtabs
= NULL
;
1075 objfile
->psymtabs
= NULL
;
1076 objfile
->free_psymtabs
= NULL
;
1077 objfile
->msymbols
= NULL
;
1078 objfile
->minimal_symbol_count
= 0;
1079 objfile
->fundamental_types
= NULL
;
1080 if (objfile
-> sf
!= NULL
)
1082 (*objfile
-> sf
-> sym_finish
) (objfile
);
1085 /* We never make this a mapped file. */
1086 objfile
-> md
= NULL
;
1087 /* obstack_specify_allocation also initializes the obstack so
1089 obstack_specify_allocation (&objfile
-> psymbol_obstack
, 0, 0,
1091 obstack_specify_allocation (&objfile
-> symbol_obstack
, 0, 0,
1093 obstack_specify_allocation (&objfile
-> type_obstack
, 0, 0,
1095 if (build_objfile_section_table (objfile
))
1097 error ("Can't find the file sections in `%s': %s",
1098 objfile
-> name
, bfd_errmsg (bfd_error
));
1101 /* We use the same section offsets as from last time. I'm not
1102 sure whether that is always correct for shared libraries. */
1103 objfile
->section_offsets
= (struct section_offsets
*)
1104 obstack_alloc (&objfile
-> psymbol_obstack
, section_offsets_size
);
1105 memcpy (objfile
->section_offsets
, offsets
, section_offsets_size
);
1106 objfile
->num_sections
= num_offsets
;
1108 /* What the hell is sym_new_init for, anyway? The concept of
1109 distinguishing between the main file and additional files
1110 in this way seems rather dubious. */
1111 if (objfile
== symfile_objfile
)
1112 (*objfile
->sf
->sym_new_init
) (objfile
);
1114 (*objfile
->sf
->sym_init
) (objfile
);
1115 clear_complaints (1, 1);
1116 /* The "mainline" parameter is a hideous hack; I think leaving it
1117 zero is OK since dbxread.c also does what it needs to do if
1118 objfile->global_psymbols.size is 0. */
1119 (*objfile
->sf
->sym_read
) (objfile
, objfile
->section_offsets
, 0);
1120 objfile
-> flags
|= OBJF_SYMS
;
1122 /* We're done reading the symbol file; finish off complaints. */
1123 clear_complaints (0, 1);
1125 /* Getting new symbols may change our opinion about what is
1128 reinit_frame_cache ();
1130 /* Discard cleanups as symbol reading was successful. */
1131 discard_cleanups (old_cleanups
);
1133 /* If the mtime has changed between the time we set new_modtime
1134 and now, we *want* this to be out of date, so don't call stat
1136 objfile
->mtime
= new_modtime
;
1143 clear_symtab_users ();
1148 deduce_language_from_filename (filename
)
1155 else if (0 == (c
= strrchr (filename
, '.')))
1156 ; /* Get default. */
1157 else if (STREQ(c
,".mod"))
1159 else if (STREQ(c
,".c"))
1161 else if (STREQ (c
,".cc") || STREQ (c
,".C") || STREQ (c
, ".cxx"))
1162 return language_cplus
;
1163 else if (STREQ (c
,".ch") || STREQ (c
,".c186") || STREQ (c
,".c286"))
1164 return language_chill
;
1166 return language_unknown
; /* default */
1171 Allocate and partly initialize a new symbol table. Return a pointer
1172 to it. error() if no space.
1174 Caller must set these fields:
1180 initialize any EXTRA_SYMTAB_INFO
1181 possibly free_named_symtabs (symtab->filename);
1185 allocate_symtab (filename
, objfile
)
1187 struct objfile
*objfile
;
1189 register struct symtab
*symtab
;
1191 symtab
= (struct symtab
*)
1192 obstack_alloc (&objfile
-> symbol_obstack
, sizeof (struct symtab
));
1193 memset (symtab
, 0, sizeof (*symtab
));
1194 symtab
-> filename
= obsavestring (filename
, strlen (filename
),
1195 &objfile
-> symbol_obstack
);
1196 symtab
-> fullname
= NULL
;
1197 symtab
-> language
= deduce_language_from_filename (filename
);
1199 /* Hook it to the objfile it comes from */
1201 symtab
-> objfile
= objfile
;
1202 symtab
-> next
= objfile
-> symtabs
;
1203 objfile
-> symtabs
= symtab
;
1205 #ifdef INIT_EXTRA_SYMTAB_INFO
1206 INIT_EXTRA_SYMTAB_INFO (symtab
);
1212 struct partial_symtab
*
1213 allocate_psymtab (filename
, objfile
)
1215 struct objfile
*objfile
;
1217 struct partial_symtab
*psymtab
;
1219 if (objfile
-> free_psymtabs
)
1221 psymtab
= objfile
-> free_psymtabs
;
1222 objfile
-> free_psymtabs
= psymtab
-> next
;
1225 psymtab
= (struct partial_symtab
*)
1226 obstack_alloc (&objfile
-> psymbol_obstack
,
1227 sizeof (struct partial_symtab
));
1229 memset (psymtab
, 0, sizeof (struct partial_symtab
));
1230 psymtab
-> filename
= obsavestring (filename
, strlen (filename
),
1231 &objfile
-> psymbol_obstack
);
1232 psymtab
-> symtab
= NULL
;
1234 /* Hook it to the objfile it comes from */
1236 psymtab
-> objfile
= objfile
;
1237 psymtab
-> next
= objfile
-> psymtabs
;
1238 objfile
-> psymtabs
= psymtab
;
1244 /* Reset all data structures in gdb which may contain references to symbol
1248 clear_symtab_users ()
1250 /* Someday, we should do better than this, by only blowing away
1251 the things that really need to be blown. */
1252 clear_value_history ();
1254 clear_internalvars ();
1255 breakpoint_re_set ();
1256 set_default_breakpoint (0, 0, 0, 0);
1257 current_source_symtab
= 0;
1258 current_source_line
= 0;
1259 clear_pc_function_cache ();
1262 /* clear_symtab_users_once:
1264 This function is run after symbol reading, or from a cleanup.
1265 If an old symbol table was obsoleted, the old symbol table
1266 has been blown away, but the other GDB data structures that may
1267 reference it have not yet been cleared or re-directed. (The old
1268 symtab was zapped, and the cleanup queued, in free_named_symtab()
1271 This function can be queued N times as a cleanup, or called
1272 directly; it will do all the work the first time, and then will be a
1273 no-op until the next time it is queued. This works by bumping a
1274 counter at queueing time. Much later when the cleanup is run, or at
1275 the end of symbol processing (in case the cleanup is discarded), if
1276 the queued count is greater than the "done-count", we do the work
1277 and set the done-count to the queued count. If the queued count is
1278 less than or equal to the done-count, we just ignore the call. This
1279 is needed because reading a single .o file will often replace many
1280 symtabs (one per .h file, for example), and we don't want to reset
1281 the breakpoints N times in the user's face.
1283 The reason we both queue a cleanup, and call it directly after symbol
1284 reading, is because the cleanup protects us in case of errors, but is
1285 discarded if symbol reading is successful. */
1288 /* FIXME: As free_named_symtabs is currently a big noop this function
1289 is no longer needed. */
1291 clear_symtab_users_once
PARAMS ((void));
1293 static int clear_symtab_users_queued
;
1294 static int clear_symtab_users_done
;
1297 clear_symtab_users_once ()
1299 /* Enforce once-per-`do_cleanups'-semantics */
1300 if (clear_symtab_users_queued
<= clear_symtab_users_done
)
1302 clear_symtab_users_done
= clear_symtab_users_queued
;
1304 clear_symtab_users ();
1308 /* Delete the specified psymtab, and any others that reference it. */
1311 cashier_psymtab (pst
)
1312 struct partial_symtab
*pst
;
1314 struct partial_symtab
*ps
, *pprev
= NULL
;
1317 /* Find its previous psymtab in the chain */
1318 for (ps
= pst
->objfile
->psymtabs
; ps
; ps
= ps
->next
) {
1325 /* Unhook it from the chain. */
1326 if (ps
== pst
->objfile
->psymtabs
)
1327 pst
->objfile
->psymtabs
= ps
->next
;
1329 pprev
->next
= ps
->next
;
1331 /* FIXME, we can't conveniently deallocate the entries in the
1332 partial_symbol lists (global_psymbols/static_psymbols) that
1333 this psymtab points to. These just take up space until all
1334 the psymtabs are reclaimed. Ditto the dependencies list and
1335 filename, which are all in the psymbol_obstack. */
1337 /* We need to cashier any psymtab that has this one as a dependency... */
1339 for (ps
= pst
->objfile
->psymtabs
; ps
; ps
= ps
->next
) {
1340 for (i
= 0; i
< ps
->number_of_dependencies
; i
++) {
1341 if (ps
->dependencies
[i
] == pst
) {
1342 cashier_psymtab (ps
);
1343 goto again
; /* Must restart, chain has been munged. */
1350 /* If a symtab or psymtab for filename NAME is found, free it along
1351 with any dependent breakpoints, displays, etc.
1352 Used when loading new versions of object modules with the "add-file"
1353 command. This is only called on the top-level symtab or psymtab's name;
1354 it is not called for subsidiary files such as .h files.
1356 Return value is 1 if we blew away the environment, 0 if not.
1357 FIXME. The return valu appears to never be used.
1359 FIXME. I think this is not the best way to do this. We should
1360 work on being gentler to the environment while still cleaning up
1361 all stray pointers into the freed symtab. */
1364 free_named_symtabs (name
)
1368 /* FIXME: With the new method of each objfile having it's own
1369 psymtab list, this function needs serious rethinking. In particular,
1370 why was it ever necessary to toss psymtabs with specific compilation
1371 unit filenames, as opposed to all psymtabs from a particular symbol
1373 Well, the answer is that some systems permit reloading of particular
1374 compilation units. We want to blow away any old info about these
1375 compilation units, regardless of which objfiles they arrived in. --gnu. */
1377 register struct symtab
*s
;
1378 register struct symtab
*prev
;
1379 register struct partial_symtab
*ps
;
1380 struct blockvector
*bv
;
1383 /* We only wack things if the symbol-reload switch is set. */
1384 if (!symbol_reloading
)
1387 /* Some symbol formats have trouble providing file names... */
1388 if (name
== 0 || *name
== '\0')
1391 /* Look for a psymtab with the specified name. */
1394 for (ps
= partial_symtab_list
; ps
; ps
= ps
->next
) {
1395 if (STREQ (name
, ps
->filename
)) {
1396 cashier_psymtab (ps
); /* Blow it away...and its little dog, too. */
1397 goto again2
; /* Must restart, chain has been munged */
1401 /* Look for a symtab with the specified name. */
1403 for (s
= symtab_list
; s
; s
= s
->next
)
1405 if (STREQ (name
, s
->filename
))
1412 if (s
== symtab_list
)
1413 symtab_list
= s
->next
;
1415 prev
->next
= s
->next
;
1417 /* For now, queue a delete for all breakpoints, displays, etc., whether
1418 or not they depend on the symtab being freed. This should be
1419 changed so that only those data structures affected are deleted. */
1421 /* But don't delete anything if the symtab is empty.
1422 This test is necessary due to a bug in "dbxread.c" that
1423 causes empty symtabs to be created for N_SO symbols that
1424 contain the pathname of the object file. (This problem
1425 has been fixed in GDB 3.9x). */
1427 bv
= BLOCKVECTOR (s
);
1428 if (BLOCKVECTOR_NBLOCKS (bv
) > 2
1429 || BLOCK_NSYMS (BLOCKVECTOR_BLOCK (bv
, GLOBAL_BLOCK
))
1430 || BLOCK_NSYMS (BLOCKVECTOR_BLOCK (bv
, STATIC_BLOCK
)))
1432 complain (&oldsyms_complaint
, name
);
1434 clear_symtab_users_queued
++;
1435 make_cleanup (clear_symtab_users_once
, 0);
1438 complain (&empty_symtab_complaint
, name
);
1445 /* It is still possible that some breakpoints will be affected
1446 even though no symtab was found, since the file might have
1447 been compiled without debugging, and hence not be associated
1448 with a symtab. In order to handle this correctly, we would need
1449 to keep a list of text address ranges for undebuggable files.
1450 For now, we do nothing, since this is a fairly obscure case. */
1454 /* FIXME, what about the minimal symbol table? */
1461 /* Allocate and partially fill a partial symtab. It will be
1462 completely filled at the end of the symbol list.
1464 SYMFILE_NAME is the name of the symbol-file we are reading from, and ADDR
1465 is the address relative to which its symbols are (incremental) or 0
1469 struct partial_symtab
*
1470 start_psymtab_common (objfile
, section_offsets
,
1471 filename
, textlow
, global_syms
, static_syms
)
1472 struct objfile
*objfile
;
1473 struct section_offsets
*section_offsets
;
1476 struct partial_symbol
*global_syms
;
1477 struct partial_symbol
*static_syms
;
1479 struct partial_symtab
*psymtab
;
1481 psymtab
= allocate_psymtab (filename
, objfile
);
1482 psymtab
-> section_offsets
= section_offsets
;
1483 psymtab
-> textlow
= textlow
;
1484 psymtab
-> texthigh
= psymtab
-> textlow
; /* default */
1485 psymtab
-> globals_offset
= global_syms
- objfile
-> global_psymbols
.list
;
1486 psymtab
-> statics_offset
= static_syms
- objfile
-> static_psymbols
.list
;
1490 /* Debugging versions of functions that are usually inline macros
1493 #if !INLINE_ADD_PSYMBOL
1495 /* Add a symbol with a long value to a psymtab.
1496 Since one arg is a struct, we pass in a ptr and deref it (sigh). */
1499 add_psymbol_to_list (name
, namelength
, namespace, class, list
, val
, language
,
1503 enum namespace namespace;
1504 enum address_class
class;
1505 struct psymbol_allocation_list
*list
;
1507 enum language language
;
1508 struct objfile
*objfile
;
1510 register struct partial_symbol
*psym
;
1511 register char *demangled_name
;
1513 if (list
->next
>= list
->list
+ list
->size
)
1515 extend_psymbol_list (list
,objfile
);
1517 psym
= list
->next
++;
1519 SYMBOL_NAME (psym
) =
1520 (char *) obstack_alloc (&objfile
->psymbol_obstack
, namelength
+ 1);
1521 memcpy (SYMBOL_NAME (psym
), name
, namelength
);
1522 SYMBOL_NAME (psym
)[namelength
] = '\0';
1523 SYMBOL_VALUE (psym
) = val
;
1524 SYMBOL_LANGUAGE (psym
) = language
;
1525 PSYMBOL_NAMESPACE (psym
) = namespace;
1526 PSYMBOL_CLASS (psym
) = class;
1527 SYMBOL_INIT_DEMANGLED_NAME (psym
, &objfile
->psymbol_obstack
);
1530 /* Add a symbol with a CORE_ADDR value to a psymtab. */
1533 add_psymbol_addr_to_list (name
, namelength
, namespace, class, list
, val
,
1537 enum namespace namespace;
1538 enum address_class
class;
1539 struct psymbol_allocation_list
*list
;
1541 enum language language
;
1542 struct objfile
*objfile
;
1544 register struct partial_symbol
*psym
;
1545 register char *demangled_name
;
1547 if (list
->next
>= list
->list
+ list
->size
)
1549 extend_psymbol_list (list
,objfile
);
1551 psym
= list
->next
++;
1553 SYMBOL_NAME (psym
) =
1554 (char *) obstack_alloc (&objfile
->psymbol_obstack
, namelength
+ 1);
1555 memcpy (SYMBOL_NAME (psym
), name
, namelength
);
1556 SYMBOL_NAME (psym
)[namelength
] = '\0';
1557 SYMBOL_VALUE_ADDRESS (psym
) = val
;
1558 SYMBOL_LANGUAGE (psym
) = language
;
1559 PSYMBOL_NAMESPACE (psym
) = namespace;
1560 PSYMBOL_CLASS (psym
) = class;
1561 SYMBOL_INIT_DEMANGLED_NAME (psym
, &objfile
->psymbol_obstack
);
1564 #endif /* !INLINE_ADD_PSYMBOL */
1568 _initialize_symfile ()
1570 struct cmd_list_element
*c
;
1572 c
= add_cmd ("symbol-file", class_files
, symbol_file_command
,
1573 "Load symbol table from executable file FILE.\n\
1574 The `file' command can also load symbol tables, as well as setting the file\n\
1575 to execute.", &cmdlist
);
1576 c
->completer
= filename_completer
;
1578 c
= add_cmd ("add-symbol-file", class_files
, add_symbol_file_command
,
1579 "Load the symbols from FILE, assuming FILE has been dynamically loaded.\n\
1580 The second argument provides the starting address of the file's text.",
1582 c
->completer
= filename_completer
;
1584 c
= add_cmd ("load", class_files
, load_command
,
1585 "Dynamically load FILE into the running program, and record its symbols\n\
1586 for access from GDB.", &cmdlist
);
1587 c
->completer
= filename_completer
;
1590 (add_set_cmd ("symbol-reloading", class_support
, var_boolean
,
1591 (char *)&symbol_reloading
,
1592 "Set dynamic symbol table reloading multiple times in one run.",