[gdb/testsuite] Restore breakpoint command in ui-redirect.exp
[external/binutils.git] / gdb / dbxread.c
1 /* Read dbx symbol tables and convert to internal format, for GDB.
2    Copyright (C) 1986-2019 Free Software Foundation, Inc.
3
4    This file is part of GDB.
5
6    This program is free software; you can redistribute it and/or modify
7    it under the terms of the GNU General Public License as published by
8    the Free Software Foundation; either version 3 of the License, or
9    (at your option) any later version.
10
11    This program is distributed in the hope that it will be useful,
12    but WITHOUT ANY WARRANTY; without even the implied warranty of
13    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14    GNU General Public License for more details.
15
16    You should have received a copy of the GNU General Public License
17    along with this program.  If not, see <http://www.gnu.org/licenses/>.  */
18
19 /* This module provides three functions: dbx_symfile_init,
20    which initializes to read a symbol file; dbx_new_init, which 
21    discards existing cached information when all symbols are being
22    discarded; and dbx_symfile_read, which reads a symbol table
23    from a file.
24
25    dbx_symfile_read only does the minimum work necessary for letting the
26    user "name" things symbolically; it does not read the entire symtab.
27    Instead, it reads the external and static symbols and puts them in partial
28    symbol tables.  When more extensive information is requested of a
29    file, the corresponding partial symbol table is mutated into a full
30    fledged symbol table by going back and reading the symbols
31    for real.  dbx_psymtab_to_symtab() is the function that does this */
32
33 #include "defs.h"
34 #if defined(__CYGNUSCLIB__)
35 #include <sys/types.h>
36 #include <fcntl.h>
37 #endif
38
39 #include "gdb_obstack.h"
40 #include <sys/stat.h>
41 #include "symtab.h"
42 #include "breakpoint.h"
43 #include "target.h"
44 #include "gdbcore.h"            /* for bfd stuff */
45 #include "libaout.h"            /* FIXME Secret internal BFD stuff for a.out */
46 #include "filenames.h"
47 #include "objfiles.h"
48 #include "buildsym-legacy.h"
49 #include "stabsread.h"
50 #include "gdb-stabs.h"
51 #include "demangle.h"
52 #include "complaints.h"
53 #include "cp-abi.h"
54 #include "cp-support.h"
55 #include "psympriv.h"
56 #include "block.h"
57 #include "aout/aout64.h"
58 #include "aout/stab_gnu.h"      /* We always use GNU stabs, not
59                                    native, now.  */
60 \f
61
62 /* Key for dbx-associated data.  */
63
64 objfile_key<dbx_symfile_info> dbx_objfile_data_key;
65
66 /* We put a pointer to this structure in the read_symtab_private field
67    of the psymtab.  */
68
69 struct symloc
70   {
71     /* Offset within the file symbol table of first local symbol for this
72        file.  */
73
74     int ldsymoff;
75
76     /* Length (in bytes) of the section of the symbol table devoted to
77        this file's symbols (actually, the section bracketed may contain
78        more than just this file's symbols).  If ldsymlen is 0, the only
79        reason for this thing's existence is the dependency list.  Nothing
80        else will happen when it is read in.  */
81
82     int ldsymlen;
83
84     /* The size of each symbol in the symbol file (in external form).  */
85
86     int symbol_size;
87
88     /* Further information needed to locate the symbols if they are in
89        an ELF file.  */
90
91     int symbol_offset;
92     int string_offset;
93     int file_string_offset;
94     enum language pst_language;
95   };
96
97 #define LDSYMOFF(p) (((struct symloc *)((p)->read_symtab_private))->ldsymoff)
98 #define LDSYMLEN(p) (((struct symloc *)((p)->read_symtab_private))->ldsymlen)
99 #define SYMLOC(p) ((struct symloc *)((p)->read_symtab_private))
100 #define SYMBOL_SIZE(p) (SYMLOC(p)->symbol_size)
101 #define SYMBOL_OFFSET(p) (SYMLOC(p)->symbol_offset)
102 #define STRING_OFFSET(p) (SYMLOC(p)->string_offset)
103 #define FILE_STRING_OFFSET(p) (SYMLOC(p)->file_string_offset)
104 #define PST_LANGUAGE(p) (SYMLOC(p)->pst_language)
105 \f
106
107 /* The objfile we are currently reading.  */
108
109 static struct objfile *dbxread_objfile;
110
111 /* Remember what we deduced to be the source language of this psymtab.  */
112
113 static enum language psymtab_language = language_unknown;
114
115 /* The BFD for this file -- implicit parameter to next_symbol_text.  */
116
117 static bfd *symfile_bfd;
118
119 /* The size of each symbol in the symbol file (in external form).
120    This is set by dbx_symfile_read when building psymtabs, and by
121    dbx_psymtab_to_symtab when building symtabs.  */
122
123 static unsigned symbol_size;
124
125 /* This is the offset of the symbol table in the executable file.  */
126
127 static unsigned symbol_table_offset;
128
129 /* This is the offset of the string table in the executable file.  */
130
131 static unsigned string_table_offset;
132
133 /* For elf+stab executables, the n_strx field is not a simple index
134    into the string table.  Instead, each .o file has a base offset in
135    the string table, and the associated symbols contain offsets from
136    this base.  The following two variables contain the base offset for
137    the current and next .o files.  */
138
139 static unsigned int file_string_table_offset;
140 static unsigned int next_file_string_table_offset;
141
142 /* .o and NLM files contain unrelocated addresses which are based at
143    0.  When non-zero, this flag disables some of the special cases for
144    Solaris elf+stab text addresses at location 0.  */
145
146 static int symfile_relocatable = 0;
147
148 /* When set, we are processing a .o file compiled by sun acc.  This is
149    misnamed; it refers to all stabs-in-elf implementations which use
150    N_UNDF the way Sun does, including Solaris gcc.  Hopefully all
151    stabs-in-elf implementations ever invented will choose to be
152    compatible.  */
153
154 static unsigned char processing_acc_compilation;
155
156 \f
157 /* The lowest text address we have yet encountered.  This is needed
158    because in an a.out file, there is no header field which tells us
159    what address the program is actually going to be loaded at, so we
160    need to make guesses based on the symbols (which *are* relocated to
161    reflect the address it will be loaded at).  */
162
163 static CORE_ADDR lowest_text_address;
164
165 /* Non-zero if there is any line number info in the objfile.  Prevents
166    dbx_end_psymtab from discarding an otherwise empty psymtab.  */
167
168 static int has_line_numbers;
169
170 /* Complaints about the symbols we have encountered.  */
171
172 static void
173 unknown_symtype_complaint (const char *arg1)
174 {
175   complaint (_("unknown symbol type %s"), arg1);
176 }
177
178 static void
179 lbrac_mismatch_complaint (int arg1)
180 {
181   complaint (_("N_LBRAC/N_RBRAC symbol mismatch at symtab pos %d"), arg1);
182 }
183
184 static void
185 repeated_header_complaint (const char *arg1, int arg2)
186 {
187   complaint (_("\"repeated\" header file %s not "
188                "previously seen, at symtab pos %d"),
189              arg1, arg2);
190 }
191
192 /* find_text_range --- find start and end of loadable code sections
193
194    The find_text_range function finds the shortest address range that
195    encloses all sections containing executable code, and stores it in
196    objfile's text_addr and text_size members.
197
198    dbx_symfile_read will use this to finish off the partial symbol
199    table, in some cases.  */
200
201 static void
202 find_text_range (bfd * sym_bfd, struct objfile *objfile)
203 {
204   asection *sec;
205   int found_any = 0;
206   CORE_ADDR start = 0;
207   CORE_ADDR end = 0;
208
209   for (sec = sym_bfd->sections; sec; sec = sec->next)
210     if (bfd_get_section_flags (sym_bfd, sec) & SEC_CODE)
211       {
212         CORE_ADDR sec_start = bfd_section_vma (sym_bfd, sec);
213         CORE_ADDR sec_end = sec_start + bfd_section_size (sym_bfd, sec);
214
215         if (found_any)
216           {
217             if (sec_start < start)
218               start = sec_start;
219             if (sec_end > end)
220               end = sec_end;
221           }
222         else
223           {
224             start = sec_start;
225             end = sec_end;
226           }
227
228         found_any = 1;
229       }
230
231   if (!found_any)
232     error (_("Can't find any code sections in symbol file"));
233
234   DBX_TEXT_ADDR (objfile) = start;
235   DBX_TEXT_SIZE (objfile) = end - start;
236 }
237 \f
238
239
240 /* During initial symbol readin, we need to have a structure to keep
241    track of which psymtabs have which bincls in them.  This structure
242    is used during readin to setup the list of dependencies within each
243    partial symbol table.  */
244
245 struct header_file_location
246 {
247   header_file_location (const char *name_, int instance_,
248                         struct partial_symtab *pst_)
249     : name (name_),
250       instance (instance_),
251       pst (pst_)
252   {
253   }
254
255   const char *name;             /* Name of header file */
256   int instance;                 /* See above */
257   struct partial_symtab *pst;   /* Partial symtab that has the
258                                    BINCL/EINCL defs for this file.  */
259 };
260
261 /* The list of bincls.  */
262 static std::vector<struct header_file_location> *bincl_list;
263
264 /* Local function prototypes.  */
265
266 static void read_ofile_symtab (struct objfile *, struct partial_symtab *);
267
268 static void dbx_read_symtab (struct partial_symtab *self,
269                              struct objfile *objfile);
270
271 static void dbx_psymtab_to_symtab_1 (struct objfile *, struct partial_symtab *);
272
273 static void read_dbx_symtab (minimal_symbol_reader &, struct objfile *);
274
275 static struct partial_symtab *find_corresponding_bincl_psymtab (const char *,
276                                                                 int);
277
278 static const char *dbx_next_symbol_text (struct objfile *);
279
280 static void fill_symbuf (bfd *);
281
282 static void dbx_symfile_init (struct objfile *);
283
284 static void dbx_new_init (struct objfile *);
285
286 static void dbx_symfile_read (struct objfile *, symfile_add_flags);
287
288 static void dbx_symfile_finish (struct objfile *);
289
290 static void record_minimal_symbol (minimal_symbol_reader &,
291                                    const char *, CORE_ADDR, int,
292                                    struct objfile *);
293
294 static void add_new_header_file (const char *, int);
295
296 static void add_old_header_file (const char *, int);
297
298 static void add_this_object_header_file (int);
299
300 static struct partial_symtab *start_psymtab (struct objfile *, const char *,
301                                              CORE_ADDR, int);
302
303 /* Free up old header file tables.  */
304
305 void
306 free_header_files (void)
307 {
308   if (this_object_header_files)
309     {
310       xfree (this_object_header_files);
311       this_object_header_files = NULL;
312     }
313   n_allocated_this_object_header_files = 0;
314 }
315
316 /* Allocate new header file tables.  */
317
318 void
319 init_header_files (void)
320 {
321   n_allocated_this_object_header_files = 10;
322   this_object_header_files = XNEWVEC (int, 10);
323 }
324
325 /* Add header file number I for this object file
326    at the next successive FILENUM.  */
327
328 static void
329 add_this_object_header_file (int i)
330 {
331   if (n_this_object_header_files == n_allocated_this_object_header_files)
332     {
333       n_allocated_this_object_header_files *= 2;
334       this_object_header_files
335         = (int *) xrealloc ((char *) this_object_header_files,
336                        n_allocated_this_object_header_files * sizeof (int));
337     }
338
339   this_object_header_files[n_this_object_header_files++] = i;
340 }
341
342 /* Add to this file an "old" header file, one already seen in
343    a previous object file.  NAME is the header file's name.
344    INSTANCE is its instance code, to select among multiple
345    symbol tables for the same header file.  */
346
347 static void
348 add_old_header_file (const char *name, int instance)
349 {
350   struct header_file *p = HEADER_FILES (dbxread_objfile);
351   int i;
352
353   for (i = 0; i < N_HEADER_FILES (dbxread_objfile); i++)
354     if (filename_cmp (p[i].name, name) == 0 && instance == p[i].instance)
355       {
356         add_this_object_header_file (i);
357         return;
358       }
359   repeated_header_complaint (name, symnum);
360 }
361
362 /* Add to this file a "new" header file: definitions for its types follow.
363    NAME is the header file's name.
364    Most often this happens only once for each distinct header file,
365    but not necessarily.  If it happens more than once, INSTANCE has
366    a different value each time, and references to the header file
367    use INSTANCE values to select among them.
368
369    dbx output contains "begin" and "end" markers for each new header file,
370    but at this level we just need to know which files there have been;
371    so we record the file when its "begin" is seen and ignore the "end".  */
372
373 static void
374 add_new_header_file (const char *name, int instance)
375 {
376   int i;
377   struct header_file *hfile;
378
379   /* Make sure there is room for one more header file.  */
380
381   i = N_ALLOCATED_HEADER_FILES (dbxread_objfile);
382
383   if (N_HEADER_FILES (dbxread_objfile) == i)
384     {
385       if (i == 0)
386         {
387           N_ALLOCATED_HEADER_FILES (dbxread_objfile) = 10;
388           HEADER_FILES (dbxread_objfile) = (struct header_file *)
389             xmalloc (10 * sizeof (struct header_file));
390         }
391       else
392         {
393           i *= 2;
394           N_ALLOCATED_HEADER_FILES (dbxread_objfile) = i;
395           HEADER_FILES (dbxread_objfile) = (struct header_file *)
396             xrealloc ((char *) HEADER_FILES (dbxread_objfile),
397                       (i * sizeof (struct header_file)));
398         }
399     }
400
401   /* Create an entry for this header file.  */
402
403   i = N_HEADER_FILES (dbxread_objfile)++;
404   hfile = HEADER_FILES (dbxread_objfile) + i;
405   hfile->name = xstrdup (name);
406   hfile->instance = instance;
407   hfile->length = 10;
408   hfile->vector = XCNEWVEC (struct type *, 10);
409
410   add_this_object_header_file (i);
411 }
412
413 #if 0
414 static struct type **
415 explicit_lookup_type (int real_filenum, int index)
416 {
417   struct header_file *f = &HEADER_FILES (dbxread_objfile)[real_filenum];
418
419   if (index >= f->length)
420     {
421       f->length *= 2;
422       f->vector = (struct type **)
423         xrealloc (f->vector, f->length * sizeof (struct type *));
424       memset (&f->vector[f->length / 2],
425               '\0', f->length * sizeof (struct type *) / 2);
426     }
427   return &f->vector[index];
428 }
429 #endif
430 \f
431 static void
432 record_minimal_symbol (minimal_symbol_reader &reader,
433                        const char *name, CORE_ADDR address, int type,
434                        struct objfile *objfile)
435 {
436   enum minimal_symbol_type ms_type;
437   int section;
438
439   switch (type)
440     {
441     case N_TEXT | N_EXT:
442       ms_type = mst_text;
443       section = SECT_OFF_TEXT (objfile);
444       break;
445     case N_DATA | N_EXT:
446       ms_type = mst_data;
447       section = SECT_OFF_DATA (objfile);
448       break;
449     case N_BSS | N_EXT:
450       ms_type = mst_bss;
451       section = SECT_OFF_BSS (objfile);
452       break;
453     case N_ABS | N_EXT:
454       ms_type = mst_abs;
455       section = -1;
456       break;
457 #ifdef N_SETV
458     case N_SETV | N_EXT:
459       ms_type = mst_data;
460       section = SECT_OFF_DATA (objfile);
461       break;
462     case N_SETV:
463       /* I don't think this type actually exists; since a N_SETV is the result
464          of going over many .o files, it doesn't make sense to have one
465          file local.  */
466       ms_type = mst_file_data;
467       section = SECT_OFF_DATA (objfile);
468       break;
469 #endif
470     case N_TEXT:
471     case N_NBTEXT:
472     case N_FN:
473     case N_FN_SEQ:
474       ms_type = mst_file_text;
475       section = SECT_OFF_TEXT (objfile);
476       break;
477     case N_DATA:
478       ms_type = mst_file_data;
479
480       /* Check for __DYNAMIC, which is used by Sun shared libraries. 
481          Record it as global even if it's local, not global, so
482          lookup_minimal_symbol can find it.  We don't check symbol_leading_char
483          because for SunOS4 it always is '_'.  */
484       if (name[8] == 'C' && strcmp ("__DYNAMIC", name) == 0)
485         ms_type = mst_data;
486
487       /* Same with virtual function tables, both global and static.  */
488       {
489         const char *tempstring = name;
490
491         if (tempstring[0] == bfd_get_symbol_leading_char (objfile->obfd))
492           ++tempstring;
493         if (is_vtable_name (tempstring))
494           ms_type = mst_data;
495       }
496       section = SECT_OFF_DATA (objfile);
497       break;
498     case N_BSS:
499       ms_type = mst_file_bss;
500       section = SECT_OFF_BSS (objfile);
501       break;
502     default:
503       ms_type = mst_unknown;
504       section = -1;
505       break;
506     }
507
508   if ((ms_type == mst_file_text || ms_type == mst_text)
509       && address < lowest_text_address)
510     lowest_text_address = address;
511
512   reader.record_with_info (name, address, ms_type, section);
513 }
514 \f
515 /* Scan and build partial symbols for a symbol file.
516    We have been initialized by a call to dbx_symfile_init, which 
517    put all the relevant info into a "struct dbx_symfile_info",
518    hung off the objfile structure.  */
519
520 static void
521 dbx_symfile_read (struct objfile *objfile, symfile_add_flags symfile_flags)
522 {
523   bfd *sym_bfd;
524   int val;
525
526   sym_bfd = objfile->obfd;
527
528   /* .o and .nlm files are relocatables with text, data and bss segs based at
529      0.  This flag disables special (Solaris stabs-in-elf only) fixups for
530      symbols with a value of 0.  */
531
532   symfile_relocatable = bfd_get_file_flags (sym_bfd) & HAS_RELOC;
533
534   val = bfd_seek (sym_bfd, DBX_SYMTAB_OFFSET (objfile), SEEK_SET);
535   if (val < 0)
536     perror_with_name (objfile_name (objfile));
537
538   /* Size the symbol table.  */
539   init_psymbol_list (objfile, DBX_SYMCOUNT (objfile));
540
541   symbol_size = DBX_SYMBOL_SIZE (objfile);
542   symbol_table_offset = DBX_SYMTAB_OFFSET (objfile);
543
544   scoped_free_pendings free_pending;
545
546   minimal_symbol_reader reader (objfile);
547
548   /* Read stabs data from executable file and define symbols.  */
549
550   read_dbx_symtab (reader, objfile);
551
552   /* Install any minimal symbols that have been collected as the current
553      minimal symbols for this objfile.  */
554
555   reader.install ();
556 }
557
558 /* Initialize anything that needs initializing when a completely new
559    symbol file is specified (not just adding some symbols from another
560    file, e.g. a shared library).  */
561
562 static void
563 dbx_new_init (struct objfile *ignore)
564 {
565   stabsread_new_init ();
566   init_header_files ();
567 }
568
569
570 /* dbx_symfile_init ()
571    is the dbx-specific initialization routine for reading symbols.
572    It is passed a struct objfile which contains, among other things,
573    the BFD for the file whose symbols are being read, and a slot for a pointer
574    to "private data" which we fill with goodies.
575
576    We read the string table into malloc'd space and stash a pointer to it.
577
578    Since BFD doesn't know how to read debug symbols in a format-independent
579    way (and may never do so...), we have to do it ourselves.  We will never
580    be called unless this is an a.out (or very similar) file.
581    FIXME, there should be a cleaner peephole into the BFD environment here.  */
582
583 #define DBX_STRINGTAB_SIZE_SIZE sizeof(long)    /* FIXME */
584
585 static void
586 dbx_symfile_init (struct objfile *objfile)
587 {
588   int val;
589   bfd *sym_bfd = objfile->obfd;
590   char *name = bfd_get_filename (sym_bfd);
591   asection *text_sect;
592   unsigned char size_temp[DBX_STRINGTAB_SIZE_SIZE];
593
594   /* Allocate struct to keep track of the symfile.  */
595   dbx_objfile_data_key.emplace (objfile);
596
597   DBX_TEXT_SECTION (objfile) = bfd_get_section_by_name (sym_bfd, ".text");
598   DBX_DATA_SECTION (objfile) = bfd_get_section_by_name (sym_bfd, ".data");
599   DBX_BSS_SECTION (objfile) = bfd_get_section_by_name (sym_bfd, ".bss");
600
601   /* FIXME POKING INSIDE BFD DATA STRUCTURES.  */
602 #define STRING_TABLE_OFFSET     (sym_bfd->origin + obj_str_filepos (sym_bfd))
603 #define SYMBOL_TABLE_OFFSET     (sym_bfd->origin + obj_sym_filepos (sym_bfd))
604
605   /* FIXME POKING INSIDE BFD DATA STRUCTURES.  */
606
607   text_sect = bfd_get_section_by_name (sym_bfd, ".text");
608   if (!text_sect)
609     error (_("Can't find .text section in symbol file"));
610   DBX_TEXT_ADDR (objfile) = bfd_section_vma (sym_bfd, text_sect);
611   DBX_TEXT_SIZE (objfile) = bfd_section_size (sym_bfd, text_sect);
612
613   DBX_SYMBOL_SIZE (objfile) = obj_symbol_entry_size (sym_bfd);
614   DBX_SYMCOUNT (objfile) = bfd_get_symcount (sym_bfd);
615   DBX_SYMTAB_OFFSET (objfile) = SYMBOL_TABLE_OFFSET;
616
617   /* Read the string table and stash it away in the objfile_obstack.
618      When we blow away the objfile the string table goes away as well.
619      Note that gdb used to use the results of attempting to malloc the
620      string table, based on the size it read, as a form of sanity check
621      for botched byte swapping, on the theory that a byte swapped string
622      table size would be so totally bogus that the malloc would fail.  Now
623      that we put in on the objfile_obstack, we can't do this since gdb gets
624      a fatal error (out of virtual memory) if the size is bogus.  We can
625      however at least check to see if the size is less than the size of
626      the size field itself, or larger than the size of the entire file.
627      Note that all valid string tables have a size greater than zero, since
628      the bytes used to hold the size are included in the count.  */
629
630   if (STRING_TABLE_OFFSET == 0)
631     {
632       /* It appears that with the existing bfd code, STRING_TABLE_OFFSET
633          will never be zero, even when there is no string table.  This
634          would appear to be a bug in bfd.  */
635       DBX_STRINGTAB_SIZE (objfile) = 0;
636       DBX_STRINGTAB (objfile) = NULL;
637     }
638   else
639     {
640       val = bfd_seek (sym_bfd, STRING_TABLE_OFFSET, SEEK_SET);
641       if (val < 0)
642         perror_with_name (name);
643
644       memset (size_temp, 0, sizeof (size_temp));
645       val = bfd_bread (size_temp, sizeof (size_temp), sym_bfd);
646       if (val < 0)
647         {
648           perror_with_name (name);
649         }
650       else if (val == 0)
651         {
652           /* With the existing bfd code, STRING_TABLE_OFFSET will be set to
653              EOF if there is no string table, and attempting to read the size
654              from EOF will read zero bytes.  */
655           DBX_STRINGTAB_SIZE (objfile) = 0;
656           DBX_STRINGTAB (objfile) = NULL;
657         }
658       else
659         {
660           /* Read some data that would appear to be the string table size.
661              If there really is a string table, then it is probably the right
662              size.  Byteswap if necessary and validate the size.  Note that
663              the minimum is DBX_STRINGTAB_SIZE_SIZE.  If we just read some
664              random data that happened to be at STRING_TABLE_OFFSET, because
665              bfd can't tell us there is no string table, the sanity checks may
666              or may not catch this.  */
667           DBX_STRINGTAB_SIZE (objfile) = bfd_h_get_32 (sym_bfd, size_temp);
668
669           if (DBX_STRINGTAB_SIZE (objfile) < sizeof (size_temp)
670               || DBX_STRINGTAB_SIZE (objfile) > bfd_get_size (sym_bfd))
671             error (_("ridiculous string table size (%d bytes)."),
672                    DBX_STRINGTAB_SIZE (objfile));
673
674           DBX_STRINGTAB (objfile) =
675             (char *) obstack_alloc (&objfile->objfile_obstack,
676                                     DBX_STRINGTAB_SIZE (objfile));
677           OBJSTAT (objfile, sz_strtab += DBX_STRINGTAB_SIZE (objfile));
678
679           /* Now read in the string table in one big gulp.  */
680
681           val = bfd_seek (sym_bfd, STRING_TABLE_OFFSET, SEEK_SET);
682           if (val < 0)
683             perror_with_name (name);
684           val = bfd_bread (DBX_STRINGTAB (objfile),
685                            DBX_STRINGTAB_SIZE (objfile),
686                            sym_bfd);
687           if (val != DBX_STRINGTAB_SIZE (objfile))
688             perror_with_name (name);
689         }
690     }
691 }
692
693 /* Perform any local cleanups required when we are done with a particular
694    objfile.  I.E, we are in the process of discarding all symbol information
695    for an objfile, freeing up all memory held for it, and unlinking the
696    objfile struct from the global list of known objfiles.  */
697
698 static void
699 dbx_symfile_finish (struct objfile *objfile)
700 {
701   free_header_files ();
702 }
703
704 dbx_symfile_info::~dbx_symfile_info ()
705 {
706   if (header_files != NULL)
707     {
708       int i = n_header_files;
709       struct header_file *hfiles = header_files;
710
711       while (--i >= 0)
712         {
713           xfree (hfiles[i].name);
714           xfree (hfiles[i].vector);
715         }
716       xfree (hfiles);
717     }
718 }
719
720 \f
721
722 /* Buffer for reading the symbol table entries.  */
723 static struct external_nlist symbuf[4096];
724 static int symbuf_idx;
725 static int symbuf_end;
726
727 /* Name of last function encountered.  Used in Solaris to approximate
728    object file boundaries.  */
729 static const char *last_function_name;
730
731 /* The address in memory of the string table of the object file we are
732    reading (which might not be the "main" object file, but might be a
733    shared library or some other dynamically loaded thing).  This is
734    set by read_dbx_symtab when building psymtabs, and by
735    read_ofile_symtab when building symtabs, and is used only by
736    next_symbol_text.  FIXME: If that is true, we don't need it when
737    building psymtabs, right?  */
738 static char *stringtab_global;
739
740 /* These variables are used to control fill_symbuf when the stabs
741    symbols are not contiguous (as may be the case when a COFF file is
742    linked using --split-by-reloc).  */
743 static const std::vector<asection *> *symbuf_sections;
744 static size_t sect_idx;
745 static unsigned int symbuf_left;
746 static unsigned int symbuf_read;
747
748 /* This variable stores a global stabs buffer, if we read stabs into
749    memory in one chunk in order to process relocations.  */
750 static bfd_byte *stabs_data;
751
752 /* Refill the symbol table input buffer
753    and set the variables that control fetching entries from it.
754    Reports an error if no data available.
755    This function can read past the end of the symbol table
756    (into the string table) but this does no harm.  */
757
758 static void
759 fill_symbuf (bfd *sym_bfd)
760 {
761   unsigned int count;
762   int nbytes;
763
764   if (stabs_data)
765     {
766       nbytes = sizeof (symbuf);
767       if (nbytes > symbuf_left)
768         nbytes = symbuf_left;
769       memcpy (symbuf, stabs_data + symbuf_read, nbytes);
770     }
771   else if (symbuf_sections == NULL)
772     {
773       count = sizeof (symbuf);
774       nbytes = bfd_bread (symbuf, count, sym_bfd);
775     }
776   else
777     {
778       if (symbuf_left <= 0)
779         {
780           file_ptr filepos = (*symbuf_sections)[sect_idx]->filepos;
781
782           if (bfd_seek (sym_bfd, filepos, SEEK_SET) != 0)
783             perror_with_name (bfd_get_filename (sym_bfd));
784           symbuf_left = bfd_section_size (sym_bfd, (*symbuf_sections)[sect_idx]);
785           symbol_table_offset = filepos - symbuf_read;
786           ++sect_idx;
787         }
788
789       count = symbuf_left;
790       if (count > sizeof (symbuf))
791         count = sizeof (symbuf);
792       nbytes = bfd_bread (symbuf, count, sym_bfd);
793     }
794
795   if (nbytes < 0)
796     perror_with_name (bfd_get_filename (sym_bfd));
797   else if (nbytes == 0)
798     error (_("Premature end of file reading symbol table"));
799   symbuf_end = nbytes / symbol_size;
800   symbuf_idx = 0;
801   symbuf_left -= nbytes;
802   symbuf_read += nbytes;
803 }
804
805 static void
806 stabs_seek (int sym_offset)
807 {
808   if (stabs_data)
809     {
810       symbuf_read += sym_offset;
811       symbuf_left -= sym_offset;
812     }
813   else
814     bfd_seek (symfile_bfd, sym_offset, SEEK_CUR);
815 }
816
817 #define INTERNALIZE_SYMBOL(intern, extern, abfd)                        \
818   {                                                                     \
819     (intern).n_strx = bfd_h_get_32 (abfd, (extern)->e_strx);            \
820     (intern).n_type = bfd_h_get_8 (abfd, (extern)->e_type);             \
821     (intern).n_other = 0;                                               \
822     (intern).n_desc = bfd_h_get_16 (abfd, (extern)->e_desc);            \
823     if (bfd_get_sign_extend_vma (abfd))                                 \
824       (intern).n_value = bfd_h_get_signed_32 (abfd, (extern)->e_value); \
825     else                                                                \
826       (intern).n_value = bfd_h_get_32 (abfd, (extern)->e_value);        \
827   }
828
829 /* Invariant: The symbol pointed to by symbuf_idx is the first one
830    that hasn't been swapped.  Swap the symbol at the same time
831    that symbuf_idx is incremented.  */
832
833 /* dbx allows the text of a symbol name to be continued into the
834    next symbol name!  When such a continuation is encountered
835    (a \ at the end of the text of a name)
836    call this function to get the continuation.  */
837
838 static const char *
839 dbx_next_symbol_text (struct objfile *objfile)
840 {
841   struct internal_nlist nlist;
842
843   if (symbuf_idx == symbuf_end)
844     fill_symbuf (symfile_bfd);
845
846   symnum++;
847   INTERNALIZE_SYMBOL (nlist, &symbuf[symbuf_idx], symfile_bfd);
848   OBJSTAT (objfile, n_stabs++);
849
850   symbuf_idx++;
851
852   return nlist.n_strx + stringtab_global + file_string_table_offset;
853 }
854 \f
855
856 /* Given a name, value pair, find the corresponding
857    bincl in the list.  Return the partial symtab associated
858    with that header_file_location.  */
859
860 static struct partial_symtab *
861 find_corresponding_bincl_psymtab (const char *name, int instance)
862 {
863   for (const header_file_location &bincl : *bincl_list)
864     if (bincl.instance == instance
865         && strcmp (name, bincl.name) == 0)
866       return bincl.pst;
867
868   repeated_header_complaint (name, symnum);
869   return (struct partial_symtab *) 0;
870 }
871
872 /* Set namestring based on nlist.  If the string table index is invalid, 
873    give a fake name, and print a single error message per symbol file read,
874    rather than abort the symbol reading or flood the user with messages.  */
875
876 static const char *
877 set_namestring (struct objfile *objfile, const struct internal_nlist *nlist)
878 {
879   const char *namestring;
880
881   if (nlist->n_strx + file_string_table_offset
882       >= DBX_STRINGTAB_SIZE (objfile)
883       || nlist->n_strx + file_string_table_offset < nlist->n_strx)
884     {
885       complaint (_("bad string table offset in symbol %d"),
886                  symnum);
887       namestring = "<bad string table offset>";
888     } 
889   else
890     namestring = (nlist->n_strx + file_string_table_offset
891                   + DBX_STRINGTAB (objfile));
892   return namestring;
893 }
894
895 static struct bound_minimal_symbol
896 find_stab_function (const char *namestring, const char *filename,
897                     struct objfile *objfile)
898 {
899   struct bound_minimal_symbol msym;
900   int n;
901
902   const char *colon = strchr (namestring, ':');
903   if (colon == NULL)
904     n = 0;
905   else
906     n = colon - namestring;
907
908   char *p = (char *) alloca (n + 2);
909   strncpy (p, namestring, n);
910   p[n] = 0;
911
912   msym = lookup_minimal_symbol (p, filename, objfile);
913   if (msym.minsym == NULL)
914     {
915       /* Sun Fortran appends an underscore to the minimal symbol name,
916          try again with an appended underscore if the minimal symbol
917          was not found.  */
918       p[n] = '_';
919       p[n + 1] = 0;
920       msym = lookup_minimal_symbol (p, filename, objfile);
921     }
922
923   if (msym.minsym == NULL && filename != NULL)
924     {
925       /* Try again without the filename.  */
926       p[n] = 0;
927       msym = lookup_minimal_symbol (p, NULL, objfile);
928     }
929   if (msym.minsym == NULL && filename != NULL)
930     {
931       /* And try again for Sun Fortran, but without the filename.  */
932       p[n] = '_';
933       p[n + 1] = 0;
934       msym = lookup_minimal_symbol (p, NULL, objfile);
935     }
936
937   return msym;
938 }
939
940 static void
941 function_outside_compilation_unit_complaint (const char *arg1)
942 {
943   complaint (_("function `%s' appears to be defined "
944                "outside of all compilation units"),
945              arg1);
946 }
947
948 /* Setup partial_symtab's describing each source file for which
949    debugging information is available.  */
950
951 static void
952 read_dbx_symtab (minimal_symbol_reader &reader, struct objfile *objfile)
953 {
954   struct gdbarch *gdbarch = get_objfile_arch (objfile);
955   struct external_nlist *bufp = 0;      /* =0 avoids gcc -Wall glitch.  */
956   struct internal_nlist nlist;
957   CORE_ADDR text_addr;
958   int text_size;
959   const char *sym_name;
960   int sym_len;
961
962   const char *namestring;
963   int nsl;
964   int past_first_source_file = 0;
965   CORE_ADDR last_function_start = 0;
966   bfd *abfd;
967   int textlow_not_set;
968   int data_sect_index;
969
970   /* Current partial symtab.  */
971   struct partial_symtab *pst;
972
973   /* List of current psymtab's include files.  */
974   const char **psymtab_include_list;
975   int includes_allocated;
976   int includes_used;
977
978   /* Index within current psymtab dependency list.  */
979   struct partial_symtab **dependency_list;
980   int dependencies_used, dependencies_allocated;
981
982   text_addr = DBX_TEXT_ADDR (objfile);
983   text_size = DBX_TEXT_SIZE (objfile);
984
985   /* FIXME.  We probably want to change stringtab_global rather than add this
986      while processing every symbol entry.  FIXME.  */
987   file_string_table_offset = 0;
988   next_file_string_table_offset = 0;
989
990   stringtab_global = DBX_STRINGTAB (objfile);
991
992   pst = (struct partial_symtab *) 0;
993
994   includes_allocated = 30;
995   includes_used = 0;
996   psymtab_include_list = (const char **) alloca (includes_allocated *
997                                                  sizeof (const char *));
998
999   dependencies_allocated = 30;
1000   dependencies_used = 0;
1001   dependency_list =
1002     (struct partial_symtab **) alloca (dependencies_allocated *
1003                                        sizeof (struct partial_symtab *));
1004
1005   /* Init bincl list */
1006   std::vector<struct header_file_location> bincl_storage;
1007   scoped_restore restore_bincl_global
1008     = make_scoped_restore (&bincl_list, &bincl_storage);
1009
1010   set_last_source_file (NULL);
1011
1012   lowest_text_address = (CORE_ADDR) -1;
1013
1014   symfile_bfd = objfile->obfd;  /* For next_text_symbol.  */
1015   abfd = objfile->obfd;
1016   symbuf_end = symbuf_idx = 0;
1017   next_symbol_text_func = dbx_next_symbol_text;
1018   textlow_not_set = 1;
1019   has_line_numbers = 0;
1020
1021   /* FIXME: jimb/2003-09-12: We don't apply the right section's offset
1022      to global and static variables.  The stab for a global or static
1023      variable doesn't give us any indication of which section it's in,
1024      so we can't tell immediately which offset in
1025      objfile->section_offsets we should apply to the variable's
1026      address.
1027
1028      We could certainly find out which section contains the variable
1029      by looking up the variable's unrelocated address with
1030      find_pc_section, but that would be expensive; this is the
1031      function that constructs the partial symbol tables by examining
1032      every symbol in the entire executable, and it's
1033      performance-critical.  So that expense would not be welcome.  I'm
1034      not sure what to do about this at the moment.
1035
1036      What we have done for years is to simply assume that the .data
1037      section's offset is appropriate for all global and static
1038      variables.  Recently, this was expanded to fall back to the .bss
1039      section's offset if there is no .data section, and then to the
1040      .rodata section's offset.  */
1041   data_sect_index = objfile->sect_index_data;
1042   if (data_sect_index == -1)
1043     data_sect_index = SECT_OFF_BSS (objfile);
1044   if (data_sect_index == -1)
1045     data_sect_index = SECT_OFF_RODATA (objfile);
1046
1047   /* If data_sect_index is still -1, that's okay.  It's perfectly fine
1048      for the file to have no .data, no .bss, and no .text at all, if
1049      it also has no global or static variables.  If it does, we will
1050      get an internal error from an ANOFFSET macro below when we try to
1051      use data_sect_index.  */
1052
1053   for (symnum = 0; symnum < DBX_SYMCOUNT (objfile); symnum++)
1054     {
1055       /* Get the symbol for this run and pull out some info.  */
1056       QUIT;                     /* Allow this to be interruptable.  */
1057       if (symbuf_idx == symbuf_end)
1058         fill_symbuf (abfd);
1059       bufp = &symbuf[symbuf_idx++];
1060
1061       /*
1062        * Special case to speed up readin.
1063        */
1064       if (bfd_h_get_8 (abfd, bufp->e_type) == N_SLINE)
1065         {
1066           has_line_numbers = 1;
1067           continue;
1068         }
1069
1070       INTERNALIZE_SYMBOL (nlist, bufp, abfd);
1071       OBJSTAT (objfile, n_stabs++);
1072
1073       /* Ok.  There is a lot of code duplicated in the rest of this
1074          switch statement (for efficiency reasons).  Since I don't
1075          like duplicating code, I will do my penance here, and
1076          describe the code which is duplicated:
1077
1078          *) The assignment to namestring.
1079          *) The call to strchr.
1080          *) The addition of a partial symbol the two partial
1081          symbol lists.  This last is a large section of code, so
1082          I've imbedded it in the following macro.  */
1083
1084       switch (nlist.n_type)
1085         {
1086           /*
1087            * Standard, external, non-debugger, symbols
1088            */
1089
1090         case N_TEXT | N_EXT:
1091         case N_NBTEXT | N_EXT:
1092           goto record_it;
1093
1094         case N_DATA | N_EXT:
1095         case N_NBDATA | N_EXT:
1096           goto record_it;
1097
1098         case N_BSS:
1099         case N_BSS | N_EXT:
1100         case N_NBBSS | N_EXT:
1101         case N_SETV | N_EXT:            /* FIXME, is this in BSS? */
1102           goto record_it;
1103
1104         case N_ABS | N_EXT:
1105           record_it:
1106           namestring = set_namestring (objfile, &nlist);
1107
1108           record_minimal_symbol (reader, namestring, nlist.n_value,
1109                                  nlist.n_type, objfile);        /* Always */
1110           continue;
1111
1112           /* Standard, local, non-debugger, symbols.  */
1113
1114         case N_NBTEXT:
1115
1116           /* We need to be able to deal with both N_FN or N_TEXT,
1117              because we have no way of knowing whether the sys-supplied ld
1118              or GNU ld was used to make the executable.  Sequents throw
1119              in another wrinkle -- they renumbered N_FN.  */
1120
1121         case N_FN:
1122         case N_FN_SEQ:
1123         case N_TEXT:
1124           namestring = set_namestring (objfile, &nlist);
1125
1126           if ((namestring[0] == '-' && namestring[1] == 'l')
1127               || (namestring[(nsl = strlen (namestring)) - 1] == 'o'
1128                   && namestring[nsl - 2] == '.'))
1129             {
1130               if (past_first_source_file && pst
1131                   /* The gould NP1 uses low values for .o and -l symbols
1132                      which are not the address.  */
1133                   && nlist.n_value >= pst->raw_text_low ())
1134                 {
1135                   dbx_end_psymtab (objfile, pst, psymtab_include_list,
1136                                    includes_used, symnum * symbol_size,
1137                                    nlist.n_value > pst->raw_text_high ()
1138                                    ? nlist.n_value : pst->raw_text_high (),
1139                                    dependency_list, dependencies_used,
1140                                    textlow_not_set);
1141                   pst = (struct partial_symtab *) 0;
1142                   includes_used = 0;
1143                   dependencies_used = 0;
1144                   has_line_numbers = 0;
1145                 }
1146               else
1147                 past_first_source_file = 1;
1148             }
1149           else
1150             goto record_it;
1151           continue;
1152
1153         case N_DATA:
1154           goto record_it;
1155
1156         case N_UNDF | N_EXT:
1157           /* The case (nlist.n_value != 0) is a "Fortran COMMON" symbol.
1158              We used to rely on the target to tell us whether it knows
1159              where the symbol has been relocated to, but none of the
1160              target implementations actually provided that operation.
1161              So we just ignore the symbol, the same way we would do if
1162              we had a target-side symbol lookup which returned no match.
1163
1164              All other symbols (with nlist.n_value == 0), are really
1165              undefined, and so we ignore them too.  */
1166           continue;
1167
1168         case N_UNDF:
1169           if (processing_acc_compilation && nlist.n_strx == 1)
1170             {
1171               /* Deal with relative offsets in the string table
1172                  used in ELF+STAB under Solaris.  If we want to use the
1173                  n_strx field, which contains the name of the file,
1174                  we must adjust file_string_table_offset *before* calling
1175                  set_namestring().  */
1176               past_first_source_file = 1;
1177               file_string_table_offset = next_file_string_table_offset;
1178               next_file_string_table_offset =
1179                 file_string_table_offset + nlist.n_value;
1180               if (next_file_string_table_offset < file_string_table_offset)
1181                 error (_("string table offset backs up at %d"), symnum);
1182               /* FIXME -- replace error() with complaint.  */
1183               continue;
1184             }
1185           continue;
1186
1187           /* Lots of symbol types we can just ignore.  */
1188
1189         case N_ABS:
1190         case N_NBDATA:
1191         case N_NBBSS:
1192           continue;
1193
1194           /* Keep going . . .  */
1195
1196           /*
1197            * Special symbol types for GNU
1198            */
1199         case N_INDR:
1200         case N_INDR | N_EXT:
1201         case N_SETA:
1202         case N_SETA | N_EXT:
1203         case N_SETT:
1204         case N_SETT | N_EXT:
1205         case N_SETD:
1206         case N_SETD | N_EXT:
1207         case N_SETB:
1208         case N_SETB | N_EXT:
1209         case N_SETV:
1210           continue;
1211
1212           /*
1213            * Debugger symbols
1214            */
1215
1216         case N_SO:
1217           {
1218             CORE_ADDR valu;
1219             static int prev_so_symnum = -10;
1220             static int first_so_symnum;
1221             const char *p;
1222             static const char *dirname_nso;
1223             int prev_textlow_not_set;
1224
1225             valu = nlist.n_value;
1226
1227             prev_textlow_not_set = textlow_not_set;
1228
1229             /* A zero value is probably an indication for the SunPRO 3.0
1230                compiler.  dbx_end_psymtab explicitly tests for zero, so
1231                don't relocate it.  */
1232
1233             if (nlist.n_value == 0
1234                 && gdbarch_sofun_address_maybe_missing (gdbarch))
1235               {
1236                 textlow_not_set = 1;
1237                 valu = 0;
1238               }
1239             else
1240               textlow_not_set = 0;
1241
1242             past_first_source_file = 1;
1243
1244             if (prev_so_symnum != symnum - 1)
1245               {                 /* Here if prev stab wasn't N_SO.  */
1246                 first_so_symnum = symnum;
1247
1248                 if (pst)
1249                   {
1250                     dbx_end_psymtab (objfile, pst, psymtab_include_list,
1251                                      includes_used, symnum * symbol_size,
1252                                      (valu > pst->raw_text_high ()
1253                                       ? valu : pst->raw_text_high ()),
1254                                      dependency_list, dependencies_used,
1255                                      prev_textlow_not_set);
1256                     pst = (struct partial_symtab *) 0;
1257                     includes_used = 0;
1258                     dependencies_used = 0;
1259                     has_line_numbers = 0;
1260                   }
1261               }
1262
1263             prev_so_symnum = symnum;
1264
1265             /* End the current partial symtab and start a new one.  */
1266
1267             namestring = set_namestring (objfile, &nlist);
1268
1269             /* Null name means end of .o file.  Don't start a new one.  */
1270             if (*namestring == '\000')
1271               continue;
1272
1273             /* Some compilers (including gcc) emit a pair of initial N_SOs.
1274                The first one is a directory name; the second the file name.
1275                If pst exists, is empty, and has a filename ending in '/',
1276                we assume the previous N_SO was a directory name.  */
1277
1278             p = lbasename (namestring);
1279             if (p != namestring && *p == '\000')
1280               {
1281                 /* Save the directory name SOs locally, then save it into
1282                    the psymtab when it's created below.  */
1283                 dirname_nso = namestring;
1284                 continue;               
1285               }
1286
1287             /* Some other compilers (C++ ones in particular) emit useless
1288                SOs for non-existant .c files.  We ignore all subsequent SOs
1289                that immediately follow the first.  */
1290
1291             if (!pst)
1292               {
1293                 pst = start_psymtab (objfile,
1294                                      namestring, valu,
1295                                      first_so_symnum * symbol_size);
1296                 pst->dirname = dirname_nso;
1297                 dirname_nso = NULL;
1298               }
1299             continue;
1300           }
1301
1302         case N_BINCL:
1303           {
1304             enum language tmp_language;
1305
1306             /* Add this bincl to the bincl_list for future EXCLs.  No
1307                need to save the string; it'll be around until
1308                read_dbx_symtab function returns.  */
1309
1310             namestring = set_namestring (objfile, &nlist);
1311             tmp_language = deduce_language_from_filename (namestring);
1312
1313             /* Only change the psymtab's language if we've learned
1314                something useful (eg. tmp_language is not language_unknown).
1315                In addition, to match what start_subfile does, never change
1316                from C++ to C.  */
1317             if (tmp_language != language_unknown
1318                 && (tmp_language != language_c
1319                     || psymtab_language != language_cplus))
1320               psymtab_language = tmp_language;
1321
1322             if (pst == NULL)
1323               {
1324                 /* FIXME: we should not get here without a PST to work on.
1325                    Attempt to recover.  */
1326                 complaint (_("N_BINCL %s not in entries for "
1327                              "any file, at symtab pos %d"),
1328                            namestring, symnum);
1329                 continue;
1330               }
1331             bincl_list->emplace_back (namestring, nlist.n_value, pst);
1332
1333             /* Mark down an include file in the current psymtab.  */
1334
1335             goto record_include_file;
1336           }
1337
1338         case N_SOL:
1339           {
1340             enum language tmp_language;
1341
1342             /* Mark down an include file in the current psymtab.  */
1343             namestring = set_namestring (objfile, &nlist);
1344             tmp_language = deduce_language_from_filename (namestring);
1345
1346             /* Only change the psymtab's language if we've learned
1347                something useful (eg. tmp_language is not language_unknown).
1348                In addition, to match what start_subfile does, never change
1349                from C++ to C.  */
1350             if (tmp_language != language_unknown
1351                 && (tmp_language != language_c
1352                     || psymtab_language != language_cplus))
1353               psymtab_language = tmp_language;
1354
1355             /* In C++, one may expect the same filename to come round many
1356                times, when code is coming alternately from the main file
1357                and from inline functions in other files.  So I check to see
1358                if this is a file we've seen before -- either the main
1359                source file, or a previously included file.
1360
1361                This seems to be a lot of time to be spending on N_SOL, but
1362                things like "break c-exp.y:435" need to work (I
1363                suppose the psymtab_include_list could be hashed or put
1364                in a binary tree, if profiling shows this is a major hog).  */
1365             if (pst && filename_cmp (namestring, pst->filename) == 0)
1366               continue;
1367             {
1368               int i;
1369
1370               for (i = 0; i < includes_used; i++)
1371                 if (filename_cmp (namestring, psymtab_include_list[i]) == 0)
1372                   {
1373                     i = -1;
1374                     break;
1375                   }
1376               if (i == -1)
1377                 continue;
1378             }
1379
1380           record_include_file:
1381
1382             psymtab_include_list[includes_used++] = namestring;
1383             if (includes_used >= includes_allocated)
1384               {
1385                 const char **orig = psymtab_include_list;
1386
1387                 psymtab_include_list = (const char **)
1388                   alloca ((includes_allocated *= 2) * sizeof (const char *));
1389                 memcpy (psymtab_include_list, orig,
1390                         includes_used * sizeof (const char *));
1391               }
1392             continue;
1393           }
1394         case N_LSYM:            /* Typedef or automatic variable.  */
1395         case N_STSYM:           /* Data seg var -- static.  */
1396         case N_LCSYM:           /* BSS      "  */
1397         case N_ROSYM:           /* Read-only data seg var -- static.  */
1398         case N_NBSTS:           /* Gould nobase.  */
1399         case N_NBLCS:           /* symbols.  */
1400         case N_FUN:
1401         case N_GSYM:            /* Global (extern) variable; can be
1402                                    data or bss (sigh FIXME).  */
1403
1404           /* Following may probably be ignored; I'll leave them here
1405              for now (until I do Pascal and Modula 2 extensions).  */
1406
1407         case N_PC:              /* I may or may not need this; I
1408                                    suspect not.  */
1409         case N_M2C:             /* I suspect that I can ignore this here.  */
1410         case N_SCOPE:           /* Same.   */
1411         {
1412           const char *p;
1413
1414           namestring = set_namestring (objfile, &nlist);
1415
1416           /* See if this is an end of function stab.  */
1417           if (pst && nlist.n_type == N_FUN && *namestring == '\000')
1418             {
1419               CORE_ADDR valu;
1420
1421               /* It's value is the size (in bytes) of the function for
1422                  function relative stabs, or the address of the function's
1423                  end for old style stabs.  */
1424               valu = nlist.n_value + last_function_start;
1425               if (pst->raw_text_high () == 0 || valu > pst->raw_text_high ())
1426                 pst->set_text_high (valu);
1427               break;
1428             }
1429
1430           p = (char *) strchr (namestring, ':');
1431           if (!p)
1432             continue;           /* Not a debugging symbol.   */
1433
1434           sym_len = 0;
1435           sym_name = NULL;      /* pacify "gcc -Werror" */
1436           if (psymtab_language == language_cplus)
1437             {
1438               std::string name (namestring, p - namestring);
1439               std::string new_name = cp_canonicalize_string (name.c_str ());
1440               if (!new_name.empty ())
1441                 {
1442                   sym_len = new_name.length ();
1443                   sym_name = obstack_strdup (&objfile->objfile_obstack,
1444                                              new_name);
1445                 }
1446             }
1447
1448           if (sym_len == 0)
1449             {
1450               sym_name = namestring;
1451               sym_len = p - namestring;
1452             }
1453
1454           /* Main processing section for debugging symbols which
1455              the initial read through the symbol tables needs to worry
1456              about.  If we reach this point, the symbol which we are
1457              considering is definitely one we are interested in.
1458              p must also contain the (valid) index into the namestring
1459              which indicates the debugging type symbol.  */
1460
1461           switch (p[1])
1462             {
1463             case 'S':
1464               if (gdbarch_static_transform_name_p (gdbarch))
1465                 gdbarch_static_transform_name (gdbarch, namestring);
1466
1467               add_psymbol_to_list (sym_name, sym_len, 1,
1468                                    VAR_DOMAIN, LOC_STATIC,
1469                                    data_sect_index,
1470                                    psymbol_placement::STATIC,
1471                                    nlist.n_value, psymtab_language, objfile);
1472               continue;
1473
1474             case 'G':
1475               /* The addresses in these entries are reported to be
1476                  wrong.  See the code that reads 'G's for symtabs.  */
1477               add_psymbol_to_list (sym_name, sym_len, 1,
1478                                    VAR_DOMAIN, LOC_STATIC,
1479                                    data_sect_index,
1480                                    psymbol_placement::GLOBAL,
1481                                    nlist.n_value, psymtab_language, objfile);
1482               continue;
1483
1484             case 'T':
1485               /* When a 'T' entry is defining an anonymous enum, it
1486                  may have a name which is the empty string, or a
1487                  single space.  Since they're not really defining a
1488                  symbol, those shouldn't go in the partial symbol
1489                  table.  We do pick up the elements of such enums at
1490                  'check_enum:', below.  */
1491               if (p >= namestring + 2
1492                   || (p == namestring + 1
1493                       && namestring[0] != ' '))
1494                 {
1495                   add_psymbol_to_list (sym_name, sym_len, 1,
1496                                        STRUCT_DOMAIN, LOC_TYPEDEF, -1,
1497                                        psymbol_placement::STATIC,
1498                                        0, psymtab_language, objfile);
1499                   if (p[2] == 't')
1500                     {
1501                       /* Also a typedef with the same name.  */
1502                       add_psymbol_to_list (sym_name, sym_len, 1,
1503                                            VAR_DOMAIN, LOC_TYPEDEF, -1,
1504                                            psymbol_placement::STATIC,
1505                                            0, psymtab_language, objfile);
1506                       p += 1;
1507                     }
1508                 }
1509               goto check_enum;
1510
1511             case 't':
1512               if (p != namestring)      /* a name is there, not just :T...  */
1513                 {
1514                   add_psymbol_to_list (sym_name, sym_len, 1,
1515                                        VAR_DOMAIN, LOC_TYPEDEF, -1,
1516                                        psymbol_placement::STATIC,
1517                                        0, psymtab_language, objfile);
1518                 }
1519             check_enum:
1520               /* If this is an enumerated type, we need to
1521                  add all the enum constants to the partial symbol
1522                  table.  This does not cover enums without names, e.g.
1523                  "enum {a, b} c;" in C, but fortunately those are
1524                  rare.  There is no way for GDB to find those from the
1525                  enum type without spending too much time on it.  Thus
1526                  to solve this problem, the compiler needs to put out the
1527                  enum in a nameless type.  GCC2 does this.  */
1528
1529               /* We are looking for something of the form
1530                  <name> ":" ("t" | "T") [<number> "="] "e"
1531                  {<constant> ":" <value> ","} ";".  */
1532
1533               /* Skip over the colon and the 't' or 'T'.  */
1534               p += 2;
1535               /* This type may be given a number.  Also, numbers can come
1536                  in pairs like (0,26).  Skip over it.  */
1537               while ((*p >= '0' && *p <= '9')
1538                      || *p == '(' || *p == ',' || *p == ')'
1539                      || *p == '=')
1540                 p++;
1541
1542               if (*p++ == 'e')
1543                 {
1544                   /* The aix4 compiler emits extra crud before the members.  */
1545                   if (*p == '-')
1546                     {
1547                       /* Skip over the type (?).  */
1548                       while (*p != ':')
1549                         p++;
1550
1551                       /* Skip over the colon.  */
1552                       p++;
1553                     }
1554
1555                   /* We have found an enumerated type.  */
1556                   /* According to comments in read_enum_type
1557                      a comma could end it instead of a semicolon.
1558                      I don't know where that happens.
1559                      Accept either.  */
1560                   while (*p && *p != ';' && *p != ',')
1561                     {
1562                       const char *q;
1563
1564                       /* Check for and handle cretinous dbx symbol name
1565                          continuation!  */
1566                       if (*p == '\\' || (*p == '?' && p[1] == '\0'))
1567                         p = next_symbol_text (objfile);
1568
1569                       /* Point to the character after the name
1570                          of the enum constant.  */
1571                       for (q = p; *q && *q != ':'; q++)
1572                         ;
1573                       /* Note that the value doesn't matter for
1574                          enum constants in psymtabs, just in symtabs.  */
1575                       add_psymbol_to_list (p, q - p, 1,
1576                                            VAR_DOMAIN, LOC_CONST, -1,
1577                                            psymbol_placement::STATIC, 0,
1578                                            psymtab_language, objfile);
1579                       /* Point past the name.  */
1580                       p = q;
1581                       /* Skip over the value.  */
1582                       while (*p && *p != ',')
1583                         p++;
1584                       /* Advance past the comma.  */
1585                       if (*p)
1586                         p++;
1587                     }
1588                 }
1589               continue;
1590
1591             case 'c':
1592               /* Constant, e.g. from "const" in Pascal.  */
1593               add_psymbol_to_list (sym_name, sym_len, 1,
1594                                    VAR_DOMAIN, LOC_CONST, -1,
1595                                    psymbol_placement::STATIC, 0,
1596                                    psymtab_language, objfile);
1597               continue;
1598
1599             case 'f':
1600               if (! pst)
1601                 {
1602                   int name_len = p - namestring;
1603                   char *name = (char *) xmalloc (name_len + 1);
1604
1605                   memcpy (name, namestring, name_len);
1606                   name[name_len] = '\0';
1607                   function_outside_compilation_unit_complaint (name);
1608                   xfree (name);
1609                 }
1610               /* Kludges for ELF/STABS with Sun ACC.  */
1611               last_function_name = namestring;
1612               /* Do not fix textlow==0 for .o or NLM files, as 0 is a legit
1613                  value for the bottom of the text seg in those cases.  */
1614               if (nlist.n_value == 0
1615                   && gdbarch_sofun_address_maybe_missing (gdbarch))
1616                 {
1617                   struct bound_minimal_symbol minsym
1618                     = find_stab_function (namestring,
1619                                           pst ? pst->filename : NULL,
1620                                           objfile);
1621                   if (minsym.minsym != NULL)
1622                     nlist.n_value = MSYMBOL_VALUE_RAW_ADDRESS (minsym.minsym);
1623                 }
1624               if (pst && textlow_not_set
1625                   && gdbarch_sofun_address_maybe_missing (gdbarch))
1626                 {
1627                   pst->set_text_low (nlist.n_value);
1628                   textlow_not_set = 0;
1629                 }
1630               /* End kludge.  */
1631
1632               /* Keep track of the start of the last function so we
1633                  can handle end of function symbols.  */
1634               last_function_start = nlist.n_value;
1635
1636               /* In reordered executables this function may lie outside
1637                  the bounds created by N_SO symbols.  If that's the case
1638                  use the address of this function as the low bound for
1639                  the partial symbol table.  */
1640               if (pst
1641                   && (textlow_not_set
1642                       || (nlist.n_value < pst->raw_text_low ()
1643                           && (nlist.n_value != 0))))
1644                 {
1645                   pst->set_text_low (nlist.n_value);
1646                   textlow_not_set = 0;
1647                 }
1648               add_psymbol_to_list (sym_name, sym_len, 1,
1649                                    VAR_DOMAIN, LOC_BLOCK,
1650                                    SECT_OFF_TEXT (objfile),
1651                                    psymbol_placement::STATIC,
1652                                    nlist.n_value, psymtab_language, objfile);
1653               continue;
1654
1655               /* Global functions were ignored here, but now they
1656                  are put into the global psymtab like one would expect.
1657                  They're also in the minimal symbol table.  */
1658             case 'F':
1659               if (! pst)
1660                 {
1661                   int name_len = p - namestring;
1662                   char *name = (char *) xmalloc (name_len + 1);
1663
1664                   memcpy (name, namestring, name_len);
1665                   name[name_len] = '\0';
1666                   function_outside_compilation_unit_complaint (name);
1667                   xfree (name);
1668                 }
1669               /* Kludges for ELF/STABS with Sun ACC.  */
1670               last_function_name = namestring;
1671               /* Do not fix textlow==0 for .o or NLM files, as 0 is a legit
1672                  value for the bottom of the text seg in those cases.  */
1673               if (nlist.n_value == 0
1674                   && gdbarch_sofun_address_maybe_missing (gdbarch))
1675                 {
1676                   struct bound_minimal_symbol minsym
1677                     = find_stab_function (namestring,
1678                                           pst ? pst->filename : NULL,
1679                                           objfile);
1680                   if (minsym.minsym != NULL)
1681                     nlist.n_value = MSYMBOL_VALUE_RAW_ADDRESS (minsym.minsym);
1682                 }
1683               if (pst && textlow_not_set
1684                   && gdbarch_sofun_address_maybe_missing (gdbarch))
1685                 {
1686                   pst->set_text_low (nlist.n_value);
1687                   textlow_not_set = 0;
1688                 }
1689               /* End kludge.  */
1690
1691               /* Keep track of the start of the last function so we
1692                  can handle end of function symbols.  */
1693               last_function_start = nlist.n_value;
1694
1695               /* In reordered executables this function may lie outside
1696                  the bounds created by N_SO symbols.  If that's the case
1697                  use the address of this function as the low bound for
1698                  the partial symbol table.  */
1699               if (pst
1700                   && (textlow_not_set
1701                       || (nlist.n_value < pst->raw_text_low ()
1702                           && (nlist.n_value != 0))))
1703                 {
1704                   pst->set_text_low (nlist.n_value);
1705                   textlow_not_set = 0;
1706                 }
1707               add_psymbol_to_list (sym_name, sym_len, 1,
1708                                    VAR_DOMAIN, LOC_BLOCK,
1709                                    SECT_OFF_TEXT (objfile),
1710                                    psymbol_placement::GLOBAL,
1711                                    nlist.n_value, psymtab_language, objfile);
1712               continue;
1713
1714               /* Two things show up here (hopefully); static symbols of
1715                  local scope (static used inside braces) or extensions
1716                  of structure symbols.  We can ignore both.  */
1717             case 'V':
1718             case '(':
1719             case '0':
1720             case '1':
1721             case '2':
1722             case '3':
1723             case '4':
1724             case '5':
1725             case '6':
1726             case '7':
1727             case '8':
1728             case '9':
1729             case '-':
1730             case '#':   /* For symbol identification (used in live ranges).  */
1731               continue;
1732
1733             case ':':
1734               /* It is a C++ nested symbol.  We don't need to record it
1735                  (I don't think); if we try to look up foo::bar::baz,
1736                  then symbols for the symtab containing foo should get
1737                  read in, I think.  */
1738               /* Someone says sun cc puts out symbols like
1739                  /foo/baz/maclib::/usr/local/bin/maclib,
1740                  which would get here with a symbol type of ':'.  */
1741               continue;
1742
1743             default:
1744               /* Unexpected symbol descriptor.  The second and subsequent stabs
1745                  of a continued stab can show up here.  The question is
1746                  whether they ever can mimic a normal stab--it would be
1747                  nice if not, since we certainly don't want to spend the
1748                  time searching to the end of every string looking for
1749                  a backslash.  */
1750
1751               complaint (_("unknown symbol descriptor `%c'"),
1752                          p[1]);
1753
1754               /* Ignore it; perhaps it is an extension that we don't
1755                  know about.  */
1756               continue;
1757             }
1758         }
1759
1760         case N_EXCL:
1761
1762           namestring = set_namestring (objfile, &nlist);
1763
1764           /* Find the corresponding bincl and mark that psymtab on the
1765              psymtab dependency list.  */
1766           {
1767             struct partial_symtab *needed_pst =
1768               find_corresponding_bincl_psymtab (namestring, nlist.n_value);
1769
1770             /* If this include file was defined earlier in this file,
1771                leave it alone.  */
1772             if (needed_pst == pst)
1773               continue;
1774
1775             if (needed_pst)
1776               {
1777                 int i;
1778                 int found = 0;
1779
1780                 for (i = 0; i < dependencies_used; i++)
1781                   if (dependency_list[i] == needed_pst)
1782                     {
1783                       found = 1;
1784                       break;
1785                     }
1786
1787                 /* If it's already in the list, skip the rest.  */
1788                 if (found)
1789                   continue;
1790
1791                 dependency_list[dependencies_used++] = needed_pst;
1792                 if (dependencies_used >= dependencies_allocated)
1793                   {
1794                     struct partial_symtab **orig = dependency_list;
1795
1796                     dependency_list =
1797                       (struct partial_symtab **)
1798                       alloca ((dependencies_allocated *= 2)
1799                               * sizeof (struct partial_symtab *));
1800                     memcpy (dependency_list, orig,
1801                             (dependencies_used
1802                              * sizeof (struct partial_symtab *)));
1803 #ifdef DEBUG_INFO
1804                     fprintf_unfiltered (gdb_stderr,
1805                                         "Had to reallocate "
1806                                         "dependency list.\n");
1807                     fprintf_unfiltered (gdb_stderr,
1808                                         "New dependencies allocated: %d\n",
1809                                         dependencies_allocated);
1810 #endif
1811                   }
1812               }
1813           }
1814           continue;
1815
1816         case N_ENDM:
1817           /* Solaris 2 end of module, finish current partial symbol
1818              table.  dbx_end_psymtab will set the high text address of
1819              PST to the proper value, which is necessary if a module
1820              compiled without debugging info follows this module.  */
1821           if (pst && gdbarch_sofun_address_maybe_missing (gdbarch))
1822             {
1823               dbx_end_psymtab (objfile, pst,
1824                                psymtab_include_list, includes_used,
1825                                symnum * symbol_size,
1826                                (CORE_ADDR) 0, dependency_list,
1827                                dependencies_used, textlow_not_set);
1828               pst = (struct partial_symtab *) 0;
1829               includes_used = 0;
1830               dependencies_used = 0;
1831               has_line_numbers = 0;
1832             }
1833           continue;
1834
1835         case N_RBRAC:
1836 #ifdef HANDLE_RBRAC
1837           HANDLE_RBRAC (nlist.n_value);
1838           continue;
1839 #endif
1840         case N_EINCL:
1841         case N_DSLINE:
1842         case N_BSLINE:
1843         case N_SSYM:            /* Claim: Structure or union element.
1844                                    Hopefully, I can ignore this.  */
1845         case N_ENTRY:           /* Alternate entry point; can ignore.  */
1846         case N_MAIN:            /* Can definitely ignore this.   */
1847         case N_CATCH:           /* These are GNU C++ extensions */
1848         case N_EHDECL:          /* that can safely be ignored here.  */
1849         case N_LENG:
1850         case N_BCOMM:
1851         case N_ECOMM:
1852         case N_ECOML:
1853         case N_FNAME:
1854         case N_SLINE:
1855         case N_RSYM:
1856         case N_PSYM:
1857         case N_BNSYM:
1858         case N_ENSYM:
1859         case N_LBRAC:
1860         case N_NSYMS:           /* Ultrix 4.0: symbol count */
1861         case N_DEFD:            /* GNU Modula-2 */
1862         case N_ALIAS:           /* SunPro F77: alias name, ignore for now.  */
1863
1864         case N_OBJ:             /* Useless types from Solaris.  */
1865         case N_OPT:
1866         case N_PATCH:
1867           /* These symbols aren't interesting; don't worry about them.  */
1868           continue;
1869
1870         default:
1871           /* If we haven't found it yet, ignore it.  It's probably some
1872              new type we don't know about yet.  */
1873           unknown_symtype_complaint (hex_string (nlist.n_type));
1874           continue;
1875         }
1876     }
1877
1878   /* If there's stuff to be cleaned up, clean it up.  */
1879   if (pst)
1880     {
1881       /* Don't set high text address of PST lower than it already
1882          is.  */
1883       CORE_ADDR text_end =
1884         (lowest_text_address == (CORE_ADDR) -1
1885          ? text_addr
1886          : lowest_text_address)
1887         + text_size;
1888
1889       dbx_end_psymtab (objfile, pst, psymtab_include_list, includes_used,
1890                        symnum * symbol_size,
1891                        (text_end > pst->raw_text_high ()
1892                         ? text_end : pst->raw_text_high ()),
1893                        dependency_list, dependencies_used, textlow_not_set);
1894     }
1895 }
1896
1897 /* Allocate and partially fill a partial symtab.  It will be
1898    completely filled at the end of the symbol list.
1899
1900    SYMFILE_NAME is the name of the symbol-file we are reading from, and ADDR
1901    is the address relative to which its symbols are (incremental) or 0
1902    (normal).  */
1903
1904 static struct partial_symtab *
1905 start_psymtab (struct objfile *objfile, const char *filename, CORE_ADDR textlow,
1906                int ldsymoff)
1907 {
1908   struct partial_symtab *result =
1909     start_psymtab_common (objfile, filename, textlow);
1910
1911   result->read_symtab_private =
1912     XOBNEW (&objfile->objfile_obstack, struct symloc);
1913   LDSYMOFF (result) = ldsymoff;
1914   result->read_symtab = dbx_read_symtab;
1915   SYMBOL_SIZE (result) = symbol_size;
1916   SYMBOL_OFFSET (result) = symbol_table_offset;
1917   STRING_OFFSET (result) = string_table_offset;
1918   FILE_STRING_OFFSET (result) = file_string_table_offset;
1919
1920   /* Deduce the source language from the filename for this psymtab.  */
1921   psymtab_language = deduce_language_from_filename (filename);
1922   PST_LANGUAGE (result) = psymtab_language;
1923
1924   return result;
1925 }
1926
1927 /* Close off the current usage of PST.
1928    Returns PST or NULL if the partial symtab was empty and thrown away.
1929
1930    FIXME:  List variables and peculiarities of same.  */
1931
1932 struct partial_symtab *
1933 dbx_end_psymtab (struct objfile *objfile, struct partial_symtab *pst,
1934                  const char **include_list, int num_includes,
1935                  int capping_symbol_offset, CORE_ADDR capping_text,
1936                  struct partial_symtab **dependency_list,
1937                  int number_dependencies,
1938                  int textlow_not_set)
1939 {
1940   int i;
1941   struct gdbarch *gdbarch = get_objfile_arch (objfile);
1942
1943   if (capping_symbol_offset != -1)
1944     LDSYMLEN (pst) = capping_symbol_offset - LDSYMOFF (pst);
1945   pst->set_text_high (capping_text);
1946
1947   /* Under Solaris, the N_SO symbols always have a value of 0,
1948      instead of the usual address of the .o file.  Therefore,
1949      we have to do some tricks to fill in texthigh and textlow.
1950      The first trick is: if we see a static
1951      or global function, and the textlow for the current pst
1952      is not set (ie: textlow_not_set), then we use that function's
1953      address for the textlow of the pst.  */
1954
1955   /* Now, to fill in texthigh, we remember the last function seen
1956      in the .o file.  Also, there's a hack in
1957      bfd/elf.c and gdb/elfread.c to pass the ELF st_size field
1958      to here via the misc_info field.  Therefore, we can fill in
1959      a reliable texthigh by taking the address plus size of the
1960      last function in the file.  */
1961
1962   if (!pst->text_high_valid && last_function_name
1963       && gdbarch_sofun_address_maybe_missing (gdbarch))
1964     {
1965       int n;
1966       struct bound_minimal_symbol minsym;
1967
1968       const char *colon = strchr (last_function_name, ':');
1969       if (colon == NULL)
1970         n = 0;
1971       else
1972         n = colon - last_function_name;
1973       char *p = (char *) alloca (n + 2);
1974       strncpy (p, last_function_name, n);
1975       p[n] = 0;
1976
1977       minsym = lookup_minimal_symbol (p, pst->filename, objfile);
1978       if (minsym.minsym == NULL)
1979         {
1980           /* Sun Fortran appends an underscore to the minimal symbol name,
1981              try again with an appended underscore if the minimal symbol
1982              was not found.  */
1983           p[n] = '_';
1984           p[n + 1] = 0;
1985           minsym = lookup_minimal_symbol (p, pst->filename, objfile);
1986         }
1987
1988       if (minsym.minsym)
1989         pst->set_text_high (MSYMBOL_VALUE_RAW_ADDRESS (minsym.minsym)
1990                             + MSYMBOL_SIZE (minsym.minsym));
1991
1992       last_function_name = NULL;
1993     }
1994
1995   if (!gdbarch_sofun_address_maybe_missing (gdbarch))
1996     ;
1997   /* This test will be true if the last .o file is only data.  */
1998   else if (textlow_not_set)
1999     pst->set_text_low (pst->raw_text_high ());
2000   else
2001     {
2002       /* If we know our own starting text address, then walk through all other
2003          psymtabs for this objfile, and if any didn't know their ending text
2004          address, set it to our starting address.  Take care to not set our
2005          own ending address to our starting address.  */
2006
2007       for (partial_symtab *p1 : objfile->psymtabs ())
2008         if (!p1->text_high_valid && p1->text_low_valid && p1 != pst)
2009           p1->set_text_high (pst->raw_text_low ());
2010     }
2011
2012   /* End of kludge for patching Solaris textlow and texthigh.  */
2013
2014   end_psymtab_common (objfile, pst);
2015
2016   pst->number_of_dependencies = number_dependencies;
2017   if (number_dependencies)
2018     {
2019       pst->dependencies
2020         = objfile->partial_symtabs->allocate_dependencies (number_dependencies);
2021       memcpy (pst->dependencies, dependency_list,
2022               number_dependencies * sizeof (struct partial_symtab *));
2023     }
2024   else
2025     pst->dependencies = 0;
2026
2027   for (i = 0; i < num_includes; i++)
2028     {
2029       struct partial_symtab *subpst =
2030         allocate_psymtab (include_list[i], objfile);
2031
2032       subpst->read_symtab_private =
2033         XOBNEW (&objfile->objfile_obstack, struct symloc);
2034       LDSYMOFF (subpst) =
2035         LDSYMLEN (subpst) = 0;
2036
2037       /* We could save slight bits of space by only making one of these,
2038          shared by the entire set of include files.  FIXME-someday.  */
2039       subpst->dependencies =
2040         objfile->partial_symtabs->allocate_dependencies (1);
2041       subpst->dependencies[0] = pst;
2042       subpst->number_of_dependencies = 1;
2043
2044       subpst->read_symtab = pst->read_symtab;
2045     }
2046
2047   if (num_includes == 0
2048       && number_dependencies == 0
2049       && pst->n_global_syms == 0
2050       && pst->n_static_syms == 0
2051       && has_line_numbers == 0)
2052     {
2053       /* Throw away this psymtab, it's empty.  We can't deallocate it, since
2054          it is on the obstack, but we can forget to chain it on the list.  */
2055       /* Empty psymtabs happen as a result of header files which don't have
2056          any symbols in them.  There can be a lot of them.  But this check
2057          is wrong, in that a psymtab with N_SLINE entries but nothing else
2058          is not empty, but we don't realize that.  Fixing that without slowing
2059          things down might be tricky.  */
2060
2061       discard_psymtab (objfile, pst);
2062
2063       /* Indicate that psymtab was thrown away.  */
2064       pst = NULL;
2065     }
2066   return pst;
2067 }
2068 \f
2069 static void
2070 dbx_psymtab_to_symtab_1 (struct objfile *objfile, struct partial_symtab *pst)
2071 {
2072   int i;
2073
2074   if (pst->readin)
2075     {
2076       fprintf_unfiltered (gdb_stderr, "Psymtab for %s already read in.  "
2077                           "Shouldn't happen.\n",
2078                           pst->filename);
2079       return;
2080     }
2081
2082   /* Read in all partial symtabs on which this one is dependent.  */
2083   for (i = 0; i < pst->number_of_dependencies; i++)
2084     if (!pst->dependencies[i]->readin)
2085       {
2086         /* Inform about additional files that need to be read in.  */
2087         if (info_verbose)
2088           {
2089             fputs_filtered (" ", gdb_stdout);
2090             wrap_here ("");
2091             fputs_filtered ("and ", gdb_stdout);
2092             wrap_here ("");
2093             printf_filtered ("%s...", pst->dependencies[i]->filename);
2094             wrap_here ("");     /* Flush output.  */
2095             gdb_flush (gdb_stdout);
2096           }
2097         dbx_psymtab_to_symtab_1 (objfile, pst->dependencies[i]);
2098       }
2099
2100   if (LDSYMLEN (pst))           /* Otherwise it's a dummy.  */
2101     {
2102       /* Init stuff necessary for reading in symbols */
2103       stabsread_init ();
2104       scoped_free_pendings free_pending;
2105       file_string_table_offset = FILE_STRING_OFFSET (pst);
2106       symbol_size = SYMBOL_SIZE (pst);
2107
2108       /* Read in this file's symbols.  */
2109       bfd_seek (objfile->obfd, SYMBOL_OFFSET (pst), SEEK_SET);
2110       read_ofile_symtab (objfile, pst);
2111     }
2112
2113   pst->readin = 1;
2114 }
2115
2116 /* Read in all of the symbols for a given psymtab for real.
2117    Be verbose about it if the user wants that.  SELF is not NULL.  */
2118
2119 static void
2120 dbx_read_symtab (struct partial_symtab *self, struct objfile *objfile)
2121 {
2122   if (self->readin)
2123     {
2124       fprintf_unfiltered (gdb_stderr, "Psymtab for %s already read in.  "
2125                           "Shouldn't happen.\n",
2126                           self->filename);
2127       return;
2128     }
2129
2130   if (LDSYMLEN (self) || self->number_of_dependencies)
2131     {
2132       /* Print the message now, before reading the string table,
2133          to avoid disconcerting pauses.  */
2134       if (info_verbose)
2135         {
2136           printf_filtered ("Reading in symbols for %s...", self->filename);
2137           gdb_flush (gdb_stdout);
2138         }
2139
2140       next_symbol_text_func = dbx_next_symbol_text;
2141
2142       {
2143         scoped_restore restore_stabs_data = make_scoped_restore (&stabs_data);
2144         gdb::unique_xmalloc_ptr<gdb_byte> data_holder;
2145         if (DBX_STAB_SECTION (objfile))
2146           {
2147             stabs_data
2148               = symfile_relocate_debug_section (objfile,
2149                                                 DBX_STAB_SECTION (objfile),
2150                                                 NULL);
2151             data_holder.reset (stabs_data);
2152           }
2153
2154         dbx_psymtab_to_symtab_1 (objfile, self);
2155       }
2156
2157       /* Match with global symbols.  This only needs to be done once,
2158          after all of the symtabs and dependencies have been read in.   */
2159       scan_file_globals (objfile);
2160
2161       /* Finish up the debug error message.  */
2162       if (info_verbose)
2163         printf_filtered ("done.\n");
2164     }
2165 }
2166
2167 /* Read in a defined section of a specific object file's symbols.  */
2168
2169 static void
2170 read_ofile_symtab (struct objfile *objfile, struct partial_symtab *pst)
2171 {
2172   const char *namestring;
2173   struct external_nlist *bufp;
2174   struct internal_nlist nlist;
2175   unsigned char type;
2176   unsigned max_symnum;
2177   bfd *abfd;
2178   int sym_offset;               /* Offset to start of symbols to read */
2179   int sym_size;                 /* Size of symbols to read */
2180   CORE_ADDR text_offset;        /* Start of text segment for symbols */
2181   int text_size;                /* Size of text segment for symbols */
2182   struct section_offsets *section_offsets;
2183
2184   sym_offset = LDSYMOFF (pst);
2185   sym_size = LDSYMLEN (pst);
2186   text_offset = pst->text_low (objfile);
2187   text_size = pst->text_high (objfile) - pst->text_low (objfile);
2188   section_offsets = objfile->section_offsets;
2189
2190   dbxread_objfile = objfile;
2191
2192   stringtab_global = DBX_STRINGTAB (objfile);
2193   set_last_source_file (NULL);
2194
2195   abfd = objfile->obfd;
2196   symfile_bfd = objfile->obfd;  /* Implicit param to next_text_symbol.  */
2197   symbuf_end = symbuf_idx = 0;
2198   symbuf_read = 0;
2199   symbuf_left = sym_offset + sym_size;
2200
2201   /* It is necessary to actually read one symbol *before* the start
2202      of this symtab's symbols, because the GCC_COMPILED_FLAG_SYMBOL
2203      occurs before the N_SO symbol.
2204
2205      Detecting this in read_dbx_symtab
2206      would slow down initial readin, so we look for it here instead.  */
2207   if (!processing_acc_compilation && sym_offset >= (int) symbol_size)
2208     {
2209       stabs_seek (sym_offset - symbol_size);
2210       fill_symbuf (abfd);
2211       bufp = &symbuf[symbuf_idx++];
2212       INTERNALIZE_SYMBOL (nlist, bufp, abfd);
2213       OBJSTAT (objfile, n_stabs++);
2214
2215       namestring = set_namestring (objfile, &nlist);
2216
2217       processing_gcc_compilation = 0;
2218       if (nlist.n_type == N_TEXT)
2219         {
2220           const char *tempstring = namestring;
2221
2222           if (strcmp (namestring, GCC_COMPILED_FLAG_SYMBOL) == 0)
2223             processing_gcc_compilation = 1;
2224           else if (strcmp (namestring, GCC2_COMPILED_FLAG_SYMBOL) == 0)
2225             processing_gcc_compilation = 2;
2226           if (tempstring[0] == bfd_get_symbol_leading_char (symfile_bfd))
2227             ++tempstring;
2228           if (startswith (tempstring, "__gnu_compiled"))
2229             processing_gcc_compilation = 2;
2230         }
2231     }
2232   else
2233     {
2234       /* The N_SO starting this symtab is the first symbol, so we
2235          better not check the symbol before it.  I'm not this can
2236          happen, but it doesn't hurt to check for it.  */
2237       stabs_seek (sym_offset);
2238       processing_gcc_compilation = 0;
2239     }
2240
2241   if (symbuf_idx == symbuf_end)
2242     fill_symbuf (abfd);
2243   bufp = &symbuf[symbuf_idx];
2244   if (bfd_h_get_8 (abfd, bufp->e_type) != N_SO)
2245     error (_("First symbol in segment of executable not a source symbol"));
2246
2247   max_symnum = sym_size / symbol_size;
2248
2249   for (symnum = 0;
2250        symnum < max_symnum;
2251        symnum++)
2252     {
2253       QUIT;                     /* Allow this to be interruptable.  */
2254       if (symbuf_idx == symbuf_end)
2255         fill_symbuf (abfd);
2256       bufp = &symbuf[symbuf_idx++];
2257       INTERNALIZE_SYMBOL (nlist, bufp, abfd);
2258       OBJSTAT (objfile, n_stabs++);
2259
2260       type = bfd_h_get_8 (abfd, bufp->e_type);
2261
2262       namestring = set_namestring (objfile, &nlist);
2263
2264       if (type & N_STAB)
2265         {
2266           if (sizeof (nlist.n_value) > 4
2267               /* We are a 64-bit debugger debugging a 32-bit program.  */
2268               && (type == N_LSYM || type == N_PSYM))
2269               /* We have to be careful with the n_value in the case of N_LSYM
2270                  and N_PSYM entries, because they are signed offsets from frame
2271                  pointer, but we actually read them as unsigned 32-bit values.
2272                  This is not a problem for 32-bit debuggers, for which negative
2273                  values end up being interpreted correctly (as negative
2274                  offsets) due to integer overflow.
2275                  But we need to sign-extend the value for 64-bit debuggers,
2276                  or we'll end up interpreting negative values as very large
2277                  positive offsets.  */
2278             nlist.n_value = (nlist.n_value ^ 0x80000000) - 0x80000000;
2279           process_one_symbol (type, nlist.n_desc, nlist.n_value,
2280                               namestring, section_offsets, objfile,
2281                               PST_LANGUAGE (pst));
2282         }
2283       /* We skip checking for a new .o or -l file; that should never
2284          happen in this routine.  */
2285       else if (type == N_TEXT)
2286         {
2287           /* I don't think this code will ever be executed, because
2288              the GCC_COMPILED_FLAG_SYMBOL usually is right before
2289              the N_SO symbol which starts this source file.
2290              However, there is no reason not to accept
2291              the GCC_COMPILED_FLAG_SYMBOL anywhere.  */
2292
2293           if (strcmp (namestring, GCC_COMPILED_FLAG_SYMBOL) == 0)
2294             processing_gcc_compilation = 1;
2295           else if (strcmp (namestring, GCC2_COMPILED_FLAG_SYMBOL) == 0)
2296             processing_gcc_compilation = 2;
2297         }
2298       else if (type & N_EXT || type == (unsigned char) N_TEXT
2299                || type == (unsigned char) N_NBTEXT)
2300         {
2301           /* Global symbol: see if we came across a dbx defintion for
2302              a corresponding symbol.  If so, store the value.  Remove
2303              syms from the chain when their values are stored, but
2304              search the whole chain, as there may be several syms from
2305              different files with the same name.  */
2306           /* This is probably not true.  Since the files will be read
2307              in one at a time, each reference to a global symbol will
2308              be satisfied in each file as it appears.  So we skip this
2309              section.  */
2310           ;
2311         }
2312     }
2313
2314   /* In a Solaris elf file, this variable, which comes from the value
2315      of the N_SO symbol, will still be 0.  Luckily, text_offset, which
2316      comes from low text address of PST, is correct.  */
2317   if (get_last_source_start_addr () == 0)
2318     set_last_source_start_addr (text_offset);
2319
2320   /* In reordered executables last_source_start_addr may not be the
2321      lower bound for this symtab, instead use text_offset which comes
2322      from the low text address of PST, which is correct.  */
2323   if (get_last_source_start_addr () > text_offset)
2324     set_last_source_start_addr (text_offset);
2325
2326   pst->compunit_symtab = end_symtab (text_offset + text_size,
2327                                      SECT_OFF_TEXT (objfile));
2328
2329   end_stabs ();
2330
2331   dbxread_objfile = NULL;
2332 }
2333 \f
2334
2335 /* Record the namespace that the function defined by SYMBOL was
2336    defined in, if necessary.  BLOCK is the associated block; use
2337    OBSTACK for allocation.  */
2338
2339 static void
2340 cp_set_block_scope (const struct symbol *symbol,
2341                     struct block *block,
2342                     struct obstack *obstack)
2343 {
2344   if (SYMBOL_DEMANGLED_NAME (symbol) != NULL)
2345     {
2346       /* Try to figure out the appropriate namespace from the
2347          demangled name.  */
2348
2349       /* FIXME: carlton/2003-04-15: If the function in question is
2350          a method of a class, the name will actually include the
2351          name of the class as well.  This should be harmless, but
2352          is a little unfortunate.  */
2353
2354       const char *name = SYMBOL_DEMANGLED_NAME (symbol);
2355       unsigned int prefix_len = cp_entire_prefix_len (name);
2356
2357       block_set_scope (block, obstack_strndup (obstack, name, prefix_len),
2358                        obstack);
2359     }
2360 }
2361
2362 /* This handles a single symbol from the symbol-file, building symbols
2363    into a GDB symtab.  It takes these arguments and an implicit argument.
2364
2365    TYPE is the type field of the ".stab" symbol entry.
2366    DESC is the desc field of the ".stab" entry.
2367    VALU is the value field of the ".stab" entry.
2368    NAME is the symbol name, in our address space.
2369    SECTION_OFFSETS is a set of amounts by which the sections of this
2370    object file were relocated when it was loaded into memory.  Note
2371    that these section_offsets are not the objfile->section_offsets but
2372    the pst->section_offsets.  All symbols that refer to memory
2373    locations need to be offset by these amounts.
2374    OBJFILE is the object file from which we are reading symbols.  It
2375    is used in end_symtab.
2376    LANGUAGE is the language of the symtab.
2377 */
2378
2379 void
2380 process_one_symbol (int type, int desc, CORE_ADDR valu, const char *name,
2381                     const struct section_offsets *section_offsets,
2382                     struct objfile *objfile, enum language language)
2383 {
2384   struct gdbarch *gdbarch = get_objfile_arch (objfile);
2385   struct context_stack *newobj;
2386   struct context_stack cstk;
2387   /* This remembers the address of the start of a function.  It is
2388      used because in Solaris 2, N_LBRAC, N_RBRAC, and N_SLINE entries
2389      are relative to the current function's start address.  On systems
2390      other than Solaris 2, this just holds the SECT_OFF_TEXT value,
2391      and is used to relocate these symbol types rather than
2392      SECTION_OFFSETS.  */
2393   static CORE_ADDR function_start_offset;
2394
2395   /* This holds the address of the start of a function, without the
2396      system peculiarities of function_start_offset.  */
2397   static CORE_ADDR last_function_start;
2398
2399   /* If this is nonzero, we've seen an N_SLINE since the start of the
2400      current function.  We use this to tell us to move the first sline
2401      to the beginning of the function regardless of what its given
2402      value is.  */
2403   static int sline_found_in_function = 1;
2404
2405   /* If this is nonzero, we've seen a non-gcc N_OPT symbol for this
2406      source file.  Used to detect the SunPRO solaris compiler.  */
2407   static int n_opt_found;
2408
2409   /* Something is wrong if we see real data before seeing a source
2410      file name.  */
2411
2412   if (get_last_source_file () == NULL && type != (unsigned char) N_SO)
2413     {
2414       /* Ignore any symbols which appear before an N_SO symbol.
2415          Currently no one puts symbols there, but we should deal
2416          gracefully with the case.  A complain()t might be in order,
2417          but this should not be an error ().  */
2418       return;
2419     }
2420
2421   switch (type)
2422     {
2423     case N_FUN:
2424     case N_FNAME:
2425
2426       if (*name == '\000')
2427         {
2428           /* This N_FUN marks the end of a function.  This closes off
2429              the current block.  */
2430           struct block *block;
2431
2432           if (outermost_context_p ())
2433             {
2434               lbrac_mismatch_complaint (symnum);
2435               break;
2436             }
2437
2438           /* The following check is added before recording line 0 at
2439              end of function so as to handle hand-generated stabs
2440              which may have an N_FUN stabs at the end of the function,
2441              but no N_SLINE stabs.  */
2442           if (sline_found_in_function)
2443             {
2444               CORE_ADDR addr = last_function_start + valu;
2445
2446               record_line (get_current_subfile (), 0,
2447                            gdbarch_addr_bits_remove (gdbarch, addr));
2448             }
2449
2450           within_function = 0;
2451           cstk = pop_context ();
2452
2453           /* Make a block for the local symbols within.  */
2454           block = finish_block (cstk.name,
2455                                 cstk.old_blocks, NULL,
2456                                 cstk.start_addr, cstk.start_addr + valu);
2457
2458           /* For C++, set the block's scope.  */
2459           if (SYMBOL_LANGUAGE (cstk.name) == language_cplus)
2460             cp_set_block_scope (cstk.name, block, &objfile->objfile_obstack);
2461
2462           /* May be switching to an assembler file which may not be using
2463              block relative stabs, so reset the offset.  */
2464           function_start_offset = 0;
2465
2466           break;
2467         }
2468
2469       sline_found_in_function = 0;
2470
2471       /* Relocate for dynamic loading.  */
2472       valu += ANOFFSET (section_offsets, SECT_OFF_TEXT (objfile));
2473       valu = gdbarch_addr_bits_remove (gdbarch, valu);
2474       last_function_start = valu;
2475
2476       goto define_a_symbol;
2477
2478     case N_LBRAC:
2479       /* This "symbol" just indicates the start of an inner lexical
2480          context within a function.  */
2481
2482       /* Ignore extra outermost context from SunPRO cc and acc.  */
2483       if (n_opt_found && desc == 1)
2484         break;
2485
2486       valu += function_start_offset;
2487
2488       push_context (desc, valu);
2489       break;
2490
2491     case N_RBRAC:
2492       /* This "symbol" just indicates the end of an inner lexical
2493          context that was started with N_LBRAC.  */
2494
2495       /* Ignore extra outermost context from SunPRO cc and acc.  */
2496       if (n_opt_found && desc == 1)
2497         break;
2498
2499       valu += function_start_offset;
2500
2501       if (outermost_context_p ())
2502         {
2503           lbrac_mismatch_complaint (symnum);
2504           break;
2505         }
2506
2507       cstk = pop_context ();
2508       if (desc != cstk.depth)
2509         lbrac_mismatch_complaint (symnum);
2510
2511       if (*get_local_symbols () != NULL)
2512         {
2513           /* GCC development snapshots from March to December of
2514              2000 would output N_LSYM entries after N_LBRAC
2515              entries.  As a consequence, these symbols are simply
2516              discarded.  Complain if this is the case.  */
2517           complaint (_("misplaced N_LBRAC entry; discarding local "
2518                        "symbols which have no enclosing block"));
2519         }
2520       *get_local_symbols () = cstk.locals;
2521
2522       if (get_context_stack_depth () > 1)
2523         {
2524           /* This is not the outermost LBRAC...RBRAC pair in the
2525              function, its local symbols preceded it, and are the ones
2526              just recovered from the context stack.  Define the block
2527              for them (but don't bother if the block contains no
2528              symbols.  Should we complain on blocks without symbols?
2529              I can't think of any useful purpose for them).  */
2530           if (*get_local_symbols () != NULL)
2531             {
2532               /* Muzzle a compiler bug that makes end < start.
2533
2534                  ??? Which compilers?  Is this ever harmful?.  */
2535               if (cstk.start_addr > valu)
2536                 {
2537                   complaint (_("block start larger than block end"));
2538                   cstk.start_addr = valu;
2539                 }
2540               /* Make a block for the local symbols within.  */
2541               finish_block (0, cstk.old_blocks, NULL,
2542                             cstk.start_addr, valu);
2543             }
2544         }
2545       else
2546         {
2547           /* This is the outermost LBRAC...RBRAC pair.  There is no
2548              need to do anything; leave the symbols that preceded it
2549              to be attached to the function's own block.  We need to
2550              indicate that we just moved outside of the function.  */
2551           within_function = 0;
2552         }
2553
2554       break;
2555
2556     case N_FN:
2557     case N_FN_SEQ:
2558       /* This kind of symbol indicates the start of an object file.
2559          Relocate for dynamic loading.  */
2560       valu += ANOFFSET (section_offsets, SECT_OFF_TEXT (objfile));
2561       break;
2562
2563     case N_SO:
2564       /* This type of symbol indicates the start of data for one
2565          source file.  Finish the symbol table of the previous source
2566          file (if any) and start accumulating a new symbol table.
2567          Relocate for dynamic loading.  */
2568       valu += ANOFFSET (section_offsets, SECT_OFF_TEXT (objfile));
2569
2570       n_opt_found = 0;
2571
2572       if (get_last_source_file ())
2573         {
2574           /* Check if previous symbol was also an N_SO (with some
2575              sanity checks).  If so, that one was actually the
2576              directory name, and the current one is the real file
2577              name.  Patch things up.  */
2578           if (previous_stab_code == (unsigned char) N_SO)
2579             {
2580               patch_subfile_names (get_current_subfile (), name);
2581               break;            /* Ignore repeated SOs.  */
2582             }
2583           end_symtab (valu, SECT_OFF_TEXT (objfile));
2584           end_stabs ();
2585         }
2586
2587       /* Null name means this just marks the end of text for this .o
2588          file.  Don't start a new symtab in this case.  */
2589       if (*name == '\000')
2590         break;
2591
2592       function_start_offset = 0;
2593
2594       start_stabs ();
2595       start_symtab (objfile, name, NULL, valu, language);
2596       record_debugformat ("stabs");
2597       break;
2598
2599     case N_SOL:
2600       /* This type of symbol indicates the start of data for a
2601          sub-source-file, one whose contents were copied or included
2602          in the compilation of the main source file (whose name was
2603          given in the N_SO symbol).  Relocate for dynamic loading.  */
2604       valu += ANOFFSET (section_offsets, SECT_OFF_TEXT (objfile));
2605       start_subfile (name);
2606       break;
2607
2608     case N_BINCL:
2609       push_subfile ();
2610       add_new_header_file (name, valu);
2611       start_subfile (name);
2612       break;
2613
2614     case N_EINCL:
2615       start_subfile (pop_subfile ());
2616       break;
2617
2618     case N_EXCL:
2619       add_old_header_file (name, valu);
2620       break;
2621
2622     case N_SLINE:
2623       /* This type of "symbol" really just records one line-number --
2624          core-address correspondence.  Enter it in the line list for
2625          this symbol table.  */
2626
2627       /* Relocate for dynamic loading and for ELF acc
2628          function-relative symbols.  */
2629       valu += function_start_offset;
2630
2631       /* GCC 2.95.3 emits the first N_SLINE stab somwehere in the
2632          middle of the prologue instead of right at the start of the
2633          function.  To deal with this we record the address for the
2634          first N_SLINE stab to be the start of the function instead of
2635          the listed location.  We really shouldn't to this.  When
2636          compiling with optimization, this first N_SLINE stab might be
2637          optimized away.  Other (non-GCC) compilers don't emit this
2638          stab at all.  There is no real harm in having an extra
2639          numbered line, although it can be a bit annoying for the
2640          user.  However, it totally screws up our testsuite.
2641
2642          So for now, keep adjusting the address of the first N_SLINE
2643          stab, but only for code compiled with GCC.  */
2644
2645       if (within_function && sline_found_in_function == 0)
2646         {
2647           CORE_ADDR addr = processing_gcc_compilation == 2 ?
2648                            last_function_start : valu;
2649
2650           record_line (get_current_subfile (), desc,
2651                        gdbarch_addr_bits_remove (gdbarch, addr));
2652           sline_found_in_function = 1;
2653         }
2654       else
2655         record_line (get_current_subfile (), desc,
2656                      gdbarch_addr_bits_remove (gdbarch, valu));
2657       break;
2658
2659     case N_BCOMM:
2660       common_block_start (name, objfile);
2661       break;
2662
2663     case N_ECOMM:
2664       common_block_end (objfile);
2665       break;
2666
2667       /* The following symbol types need to have the appropriate
2668          offset added to their value; then we process symbol
2669          definitions in the name.  */
2670
2671     case N_STSYM:               /* Static symbol in data segment.  */
2672     case N_LCSYM:               /* Static symbol in BSS segment.  */
2673     case N_ROSYM:               /* Static symbol in read-only data segment.  */
2674       /* HORRID HACK DEPT.  However, it's Sun's furgin' fault.
2675          Solaris 2's stabs-in-elf makes *most* symbols relative but
2676          leaves a few absolute (at least for Solaris 2.1 and version
2677          2.0.1 of the SunPRO compiler).  N_STSYM and friends sit on
2678          the fence.  .stab "foo:S...",N_STSYM is absolute (ld
2679          relocates it) .stab "foo:V...",N_STSYM is relative (section
2680          base subtracted).  This leaves us no choice but to search for
2681          the 'S' or 'V'...  (or pass the whole section_offsets stuff
2682          down ONE MORE function call level, which we really don't want
2683          to do).  */
2684       {
2685         const char *p;
2686
2687         /* Normal object file and NLMs have non-zero text seg offsets,
2688            but don't need their static syms offset in this fashion.
2689            XXX - This is really a crock that should be fixed in the
2690            solib handling code so that I don't have to work around it
2691            here.  */
2692
2693         if (!symfile_relocatable)
2694           {
2695             p = strchr (name, ':');
2696             if (p != 0 && p[1] == 'S')
2697               {
2698                 /* The linker relocated it.  We don't want to add a
2699                    Sun-stabs Tfoo.foo-like offset, but we *do*
2700                    want to add whatever solib.c passed to
2701                    symbol_file_add as addr (this is known to affect
2702                    SunOS 4, and I suspect ELF too).  Since there is no
2703                    Ttext.text symbol, we can get addr from the text offset.  */
2704                 valu += ANOFFSET (section_offsets, SECT_OFF_TEXT (objfile));
2705                 goto define_a_symbol;
2706               }
2707           }
2708         /* Since it's not the kludge case, re-dispatch to the right
2709            handler.  */
2710         switch (type)
2711           {
2712           case N_STSYM:
2713             goto case_N_STSYM;
2714           case N_LCSYM:
2715             goto case_N_LCSYM;
2716           case N_ROSYM:
2717             goto case_N_ROSYM;
2718           default:
2719             internal_error (__FILE__, __LINE__,
2720                             _("failed internal consistency check"));
2721           }
2722       }
2723
2724     case_N_STSYM:               /* Static symbol in data segment.  */
2725     case N_DSLINE:              /* Source line number, data segment.  */
2726       valu += ANOFFSET (section_offsets, SECT_OFF_DATA (objfile));
2727       goto define_a_symbol;
2728
2729     case_N_LCSYM:               /* Static symbol in BSS segment.  */
2730     case N_BSLINE:              /* Source line number, BSS segment.  */
2731       /* N_BROWS: overlaps with N_BSLINE.  */
2732       valu += ANOFFSET (section_offsets, SECT_OFF_BSS (objfile));
2733       goto define_a_symbol;
2734
2735     case_N_ROSYM:               /* Static symbol in read-only data segment.  */
2736       valu += ANOFFSET (section_offsets, SECT_OFF_RODATA (objfile));
2737       goto define_a_symbol;
2738
2739     case N_ENTRY:               /* Alternate entry point.  */
2740       /* Relocate for dynamic loading.  */
2741       valu += ANOFFSET (section_offsets, SECT_OFF_TEXT (objfile));
2742       goto define_a_symbol;
2743
2744       /* The following symbol types we don't know how to process.
2745          Handle them in a "default" way, but complain to people who
2746          care.  */
2747     default:
2748     case N_CATCH:               /* Exception handler catcher.  */
2749     case N_EHDECL:              /* Exception handler name.  */
2750     case N_PC:                  /* Global symbol in Pascal.  */
2751     case N_M2C:                 /* Modula-2 compilation unit.  */
2752       /* N_MOD2: overlaps with N_EHDECL.  */
2753     case N_SCOPE:               /* Modula-2 scope information.  */
2754     case N_ECOML:               /* End common (local name).  */
2755     case N_NBTEXT:              /* Gould Non-Base-Register symbols???  */
2756     case N_NBDATA:
2757     case N_NBBSS:
2758     case N_NBSTS:
2759     case N_NBLCS:
2760       unknown_symtype_complaint (hex_string (type));
2761       /* FALLTHROUGH */
2762
2763     define_a_symbol:
2764       /* These symbol types don't need the address field relocated,
2765          since it is either unused, or is absolute.  */
2766     case N_GSYM:                /* Global variable.  */
2767     case N_NSYMS:               /* Number of symbols (Ultrix).  */
2768     case N_NOMAP:               /* No map?  (Ultrix).  */
2769     case N_RSYM:                /* Register variable.  */
2770     case N_DEFD:                /* Modula-2 GNU module dependency.  */
2771     case N_SSYM:                /* Struct or union element.  */
2772     case N_LSYM:                /* Local symbol in stack.  */
2773     case N_PSYM:                /* Parameter variable.  */
2774     case N_LENG:                /* Length of preceding symbol type.  */
2775       if (name)
2776         {
2777           int deftype;
2778           const char *colon_pos = strchr (name, ':');
2779
2780           if (colon_pos == NULL)
2781             deftype = '\0';
2782           else
2783             deftype = colon_pos[1];
2784
2785           switch (deftype)
2786             {
2787             case 'f':
2788             case 'F':
2789               /* Deal with the SunPRO 3.0 compiler which omits the
2790                  address from N_FUN symbols.  */
2791               if (type == N_FUN
2792                   && valu == ANOFFSET (section_offsets,
2793                                        SECT_OFF_TEXT (objfile))
2794                   && gdbarch_sofun_address_maybe_missing (gdbarch))
2795                 {
2796                   struct bound_minimal_symbol minsym
2797                     = find_stab_function (name, get_last_source_file (),
2798                                           objfile);
2799                   if (minsym.minsym != NULL)
2800                     valu = BMSYMBOL_VALUE_ADDRESS (minsym);
2801                 }
2802
2803               /* These addresses are absolute.  */
2804               function_start_offset = valu;
2805
2806               within_function = 1;
2807
2808               if (get_context_stack_depth () > 1)
2809                 {
2810                   complaint (_("unmatched N_LBRAC before symtab pos %d"),
2811                              symnum);
2812                   break;
2813                 }
2814
2815               if (!outermost_context_p ())
2816                 {
2817                   struct block *block;
2818
2819                   cstk = pop_context ();
2820                   /* Make a block for the local symbols within.  */
2821                   block = finish_block (cstk.name,
2822                                         cstk.old_blocks, NULL,
2823                                         cstk.start_addr, valu);
2824
2825                   /* For C++, set the block's scope.  */
2826                   if (SYMBOL_LANGUAGE (cstk.name) == language_cplus)
2827                     cp_set_block_scope (cstk.name, block,
2828                                         &objfile->objfile_obstack);
2829                 }
2830
2831               newobj = push_context (0, valu);
2832               newobj->name = define_symbol (valu, name, desc, type, objfile);
2833               break;
2834
2835             default:
2836               define_symbol (valu, name, desc, type, objfile);
2837               break;
2838             }
2839         }
2840       break;
2841
2842       /* We use N_OPT to carry the gcc2_compiled flag.  Sun uses it
2843          for a bunch of other flags, too.  Someday we may parse their
2844          flags; for now we ignore theirs and hope they'll ignore ours.  */
2845     case N_OPT:                 /* Solaris 2: Compiler options.  */
2846       if (name)
2847         {
2848           if (strcmp (name, GCC2_COMPILED_FLAG_SYMBOL) == 0)
2849             {
2850               processing_gcc_compilation = 2;
2851             }
2852           else
2853             n_opt_found = 1;
2854         }
2855       break;
2856
2857     case N_MAIN:                /* Name of main routine.  */
2858       /* FIXME: If one has a symbol file with N_MAIN and then replaces
2859          it with a symbol file with "main" and without N_MAIN.  I'm
2860          not sure exactly what rule to follow but probably something
2861          like: N_MAIN takes precedence over "main" no matter what
2862          objfile it is in; If there is more than one N_MAIN, choose
2863          the one in the symfile_objfile; If there is more than one
2864          N_MAIN within a given objfile, complain() and choose
2865          arbitrarily.  (kingdon) */
2866       if (name != NULL)
2867         set_objfile_main_name (objfile, name, language_unknown);
2868       break;
2869
2870       /* The following symbol types can be ignored.  */
2871     case N_OBJ:                 /* Solaris 2: Object file dir and name.  */
2872     case N_PATCH:               /* Solaris 2: Patch Run Time Checker.  */
2873       /* N_UNDF:                   Solaris 2: File separator mark.  */
2874       /* N_UNDF: -- we will never encounter it, since we only process
2875          one file's symbols at once.  */
2876     case N_ENDM:                /* Solaris 2: End of module.  */
2877     case N_ALIAS:               /* SunPro F77: alias name, ignore for now.  */
2878       break;
2879     }
2880
2881   /* '#' is a GNU C extension to allow one symbol to refer to another
2882      related symbol.
2883
2884      Generally this is used so that an alias can refer to its main
2885      symbol.  */
2886   gdb_assert (name);
2887   if (name[0] == '#')
2888     {
2889       /* Initialize symbol reference names and determine if this is a
2890          definition.  If a symbol reference is being defined, go ahead
2891          and add it.  Otherwise, just return.  */
2892
2893       const char *s = name;
2894       int refnum;
2895
2896       /* If this stab defines a new reference ID that is not on the
2897          reference list, then put it on the reference list.
2898
2899          We go ahead and advance NAME past the reference, even though
2900          it is not strictly necessary at this time.  */
2901       refnum = symbol_reference_defined (&s);
2902       if (refnum >= 0)
2903         if (!ref_search (refnum))
2904           ref_add (refnum, 0, name, valu);
2905       name = s;
2906     }
2907
2908   previous_stab_code = type;
2909 }
2910 \f
2911 /* FIXME: The only difference between this and elfstab_build_psymtabs
2912    is the call to install_minimal_symbols for elf, and the support for
2913    split sections.  If the differences are really that small, the code
2914    should be shared.  */
2915
2916 /* Scan and build partial symbols for an coff symbol file.
2917    The coff file has already been processed to get its minimal symbols.
2918
2919    This routine is the equivalent of dbx_symfile_init and dbx_symfile_read
2920    rolled into one.
2921
2922    OBJFILE is the object file we are reading symbols from.
2923    ADDR is the address relative to which the symbols are (e.g.
2924    the base address of the text segment).
2925    TEXTADDR is the address of the text section.
2926    TEXTSIZE is the size of the text section.
2927    STABSECTS is the list of .stab sections in OBJFILE.
2928    STABSTROFFSET and STABSTRSIZE define the location in OBJFILE where the
2929    .stabstr section exists.
2930
2931    This routine is mostly copied from dbx_symfile_init and dbx_symfile_read,
2932    adjusted for coff details.  */
2933
2934 void
2935 coffstab_build_psymtabs (struct objfile *objfile,
2936                          CORE_ADDR textaddr, unsigned int textsize,
2937                          const std::vector<asection *> &stabsects,
2938                          file_ptr stabstroffset, unsigned int stabstrsize)
2939 {
2940   int val;
2941   bfd *sym_bfd = objfile->obfd;
2942   char *name = bfd_get_filename (sym_bfd);
2943   unsigned int stabsize;
2944
2945   /* Allocate struct to keep track of stab reading.  */
2946   dbx_objfile_data_key.emplace (objfile);
2947
2948   DBX_TEXT_ADDR (objfile) = textaddr;
2949   DBX_TEXT_SIZE (objfile) = textsize;
2950
2951 #define COFF_STABS_SYMBOL_SIZE  12      /* XXX FIXME XXX */
2952   DBX_SYMBOL_SIZE (objfile) = COFF_STABS_SYMBOL_SIZE;
2953   DBX_STRINGTAB_SIZE (objfile) = stabstrsize;
2954
2955   if (stabstrsize > bfd_get_size (sym_bfd))
2956     error (_("ridiculous string table size: %d bytes"), stabstrsize);
2957   DBX_STRINGTAB (objfile) = (char *)
2958     obstack_alloc (&objfile->objfile_obstack, stabstrsize + 1);
2959   OBJSTAT (objfile, sz_strtab += stabstrsize + 1);
2960
2961   /* Now read in the string table in one big gulp.  */
2962
2963   val = bfd_seek (sym_bfd, stabstroffset, SEEK_SET);
2964   if (val < 0)
2965     perror_with_name (name);
2966   val = bfd_bread (DBX_STRINGTAB (objfile), stabstrsize, sym_bfd);
2967   if (val != stabstrsize)
2968     perror_with_name (name);
2969
2970   stabsread_new_init ();
2971   free_header_files ();
2972   init_header_files ();
2973
2974   processing_acc_compilation = 1;
2975
2976   /* In a coff file, we've already installed the minimal symbols that came
2977      from the coff (non-stab) symbol table, so always act like an
2978      incremental load here.  */
2979   scoped_restore save_symbuf_sections
2980     = make_scoped_restore (&symbuf_sections);
2981   if (stabsects.size () == 1)
2982     {
2983       stabsize = bfd_section_size (sym_bfd, stabsects[0]);
2984       DBX_SYMCOUNT (objfile) = stabsize / DBX_SYMBOL_SIZE (objfile);
2985       DBX_SYMTAB_OFFSET (objfile) = stabsects[0]->filepos;
2986     }
2987   else
2988     {
2989       DBX_SYMCOUNT (objfile) = 0;
2990       for (asection *section : stabsects)
2991         {
2992           stabsize = bfd_section_size (sym_bfd, section);
2993           DBX_SYMCOUNT (objfile) += stabsize / DBX_SYMBOL_SIZE (objfile);
2994         }
2995
2996       DBX_SYMTAB_OFFSET (objfile) = stabsects[0]->filepos;
2997
2998       sect_idx = 1;
2999       symbuf_sections = &stabsects;
3000       symbuf_left = bfd_section_size (sym_bfd, stabsects[0]);
3001       symbuf_read = 0;
3002     }
3003
3004   dbx_symfile_read (objfile, 0);
3005 }
3006 \f
3007 /* Scan and build partial symbols for an ELF symbol file.
3008    This ELF file has already been processed to get its minimal symbols.
3009
3010    This routine is the equivalent of dbx_symfile_init and dbx_symfile_read
3011    rolled into one.
3012
3013    OBJFILE is the object file we are reading symbols from.
3014    ADDR is the address relative to which the symbols are (e.g.
3015    the base address of the text segment).
3016    STABSECT is the BFD section information for the .stab section.
3017    STABSTROFFSET and STABSTRSIZE define the location in OBJFILE where the
3018    .stabstr section exists.
3019
3020    This routine is mostly copied from dbx_symfile_init and dbx_symfile_read,
3021    adjusted for elf details.  */
3022
3023 void
3024 elfstab_build_psymtabs (struct objfile *objfile, asection *stabsect,
3025                         file_ptr stabstroffset, unsigned int stabstrsize)
3026 {
3027   int val;
3028   bfd *sym_bfd = objfile->obfd;
3029   char *name = bfd_get_filename (sym_bfd);
3030
3031   stabsread_new_init ();
3032
3033   /* Allocate struct to keep track of stab reading.  */
3034   dbx_objfile_data_key.emplace (objfile);
3035
3036   /* Find the first and last text address.  dbx_symfile_read seems to
3037      want this.  */
3038   find_text_range (sym_bfd, objfile);
3039
3040 #define ELF_STABS_SYMBOL_SIZE   12      /* XXX FIXME XXX */
3041   DBX_SYMBOL_SIZE (objfile) = ELF_STABS_SYMBOL_SIZE;
3042   DBX_SYMCOUNT (objfile)
3043     = bfd_section_size (objfile->obfd, stabsect) / DBX_SYMBOL_SIZE (objfile);
3044   DBX_STRINGTAB_SIZE (objfile) = stabstrsize;
3045   DBX_SYMTAB_OFFSET (objfile) = stabsect->filepos;
3046   DBX_STAB_SECTION (objfile) = stabsect;
3047
3048   if (stabstrsize > bfd_get_size (sym_bfd))
3049     error (_("ridiculous string table size: %d bytes"), stabstrsize);
3050   DBX_STRINGTAB (objfile) = (char *)
3051     obstack_alloc (&objfile->objfile_obstack, stabstrsize + 1);
3052   OBJSTAT (objfile, sz_strtab += stabstrsize + 1);
3053
3054   /* Now read in the string table in one big gulp.  */
3055
3056   val = bfd_seek (sym_bfd, stabstroffset, SEEK_SET);
3057   if (val < 0)
3058     perror_with_name (name);
3059   val = bfd_bread (DBX_STRINGTAB (objfile), stabstrsize, sym_bfd);
3060   if (val != stabstrsize)
3061     perror_with_name (name);
3062
3063   stabsread_new_init ();
3064   free_header_files ();
3065   init_header_files ();
3066
3067   processing_acc_compilation = 1;
3068
3069   symbuf_read = 0;
3070   symbuf_left = bfd_section_size (objfile->obfd, stabsect);
3071
3072   scoped_restore restore_stabs_data = make_scoped_restore (&stabs_data);
3073   gdb::unique_xmalloc_ptr<gdb_byte> data_holder;
3074
3075   stabs_data = symfile_relocate_debug_section (objfile, stabsect, NULL);
3076   if (stabs_data)
3077     data_holder.reset (stabs_data);
3078
3079   /* In an elf file, we've already installed the minimal symbols that came
3080      from the elf (non-stab) symbol table, so always act like an
3081      incremental load here.  dbx_symfile_read should not generate any new
3082      minimal symbols, since we will have already read the ELF dynamic symbol
3083      table and normal symbol entries won't be in the ".stab" section; but in
3084      case it does, it will install them itself.  */
3085   dbx_symfile_read (objfile, 0);
3086 }
3087 \f
3088 /* Scan and build partial symbols for a file with special sections for stabs
3089    and stabstrings.  The file has already been processed to get its minimal
3090    symbols, and any other symbols that might be necessary to resolve GSYMs.
3091
3092    This routine is the equivalent of dbx_symfile_init and dbx_symfile_read
3093    rolled into one.
3094
3095    OBJFILE is the object file we are reading symbols from.
3096    ADDR is the address relative to which the symbols are (e.g. the base address
3097    of the text segment).
3098    STAB_NAME is the name of the section that contains the stabs.
3099    STABSTR_NAME is the name of the section that contains the stab strings.
3100
3101    This routine is mostly copied from dbx_symfile_init and
3102    dbx_symfile_read.  */
3103
3104 void
3105 stabsect_build_psymtabs (struct objfile *objfile, char *stab_name,
3106                          char *stabstr_name, char *text_name)
3107 {
3108   int val;
3109   bfd *sym_bfd = objfile->obfd;
3110   char *name = bfd_get_filename (sym_bfd);
3111   asection *stabsect;
3112   asection *stabstrsect;
3113   asection *text_sect;
3114
3115   stabsect = bfd_get_section_by_name (sym_bfd, stab_name);
3116   stabstrsect = bfd_get_section_by_name (sym_bfd, stabstr_name);
3117
3118   if (!stabsect)
3119     return;
3120
3121   if (!stabstrsect)
3122     error (_("stabsect_build_psymtabs:  Found stabs (%s), "
3123              "but not string section (%s)"),
3124            stab_name, stabstr_name);
3125
3126   dbx_objfile_data_key.emplace (objfile);
3127
3128   text_sect = bfd_get_section_by_name (sym_bfd, text_name);
3129   if (!text_sect)
3130     error (_("Can't find %s section in symbol file"), text_name);
3131   DBX_TEXT_ADDR (objfile) = bfd_section_vma (sym_bfd, text_sect);
3132   DBX_TEXT_SIZE (objfile) = bfd_section_size (sym_bfd, text_sect);
3133
3134   DBX_SYMBOL_SIZE (objfile) = sizeof (struct external_nlist);
3135   DBX_SYMCOUNT (objfile) = bfd_section_size (sym_bfd, stabsect)
3136     / DBX_SYMBOL_SIZE (objfile);
3137   DBX_STRINGTAB_SIZE (objfile) = bfd_section_size (sym_bfd, stabstrsect);
3138   DBX_SYMTAB_OFFSET (objfile) = stabsect->filepos;      /* XXX - FIXME: POKING
3139                                                            INSIDE BFD DATA
3140                                                            STRUCTURES */
3141
3142   if (DBX_STRINGTAB_SIZE (objfile) > bfd_get_size (sym_bfd))
3143     error (_("ridiculous string table size: %d bytes"),
3144            DBX_STRINGTAB_SIZE (objfile));
3145   DBX_STRINGTAB (objfile) = (char *)
3146     obstack_alloc (&objfile->objfile_obstack,
3147                    DBX_STRINGTAB_SIZE (objfile) + 1);
3148   OBJSTAT (objfile, sz_strtab += DBX_STRINGTAB_SIZE (objfile) + 1);
3149
3150   /* Now read in the string table in one big gulp.  */
3151
3152   val = bfd_get_section_contents (sym_bfd,      /* bfd */
3153                                   stabstrsect,  /* bfd section */
3154                                   DBX_STRINGTAB (objfile), /* input buffer */
3155                                   0,            /* offset into section */
3156                                   DBX_STRINGTAB_SIZE (objfile)); /* amount to
3157                                                                     read */
3158
3159   if (!val)
3160     perror_with_name (name);
3161
3162   stabsread_new_init ();
3163   free_header_files ();
3164   init_header_files ();
3165
3166   /* Now, do an incremental load.  */
3167
3168   processing_acc_compilation = 1;
3169   dbx_symfile_read (objfile, 0);
3170 }
3171 \f
3172 static const struct sym_fns aout_sym_fns =
3173 {
3174   dbx_new_init,                 /* init anything gbl to entire symtab */
3175   dbx_symfile_init,             /* read initial info, setup for sym_read() */
3176   dbx_symfile_read,             /* read a symbol file into symtab */
3177   NULL,                         /* sym_read_psymbols */
3178   dbx_symfile_finish,           /* finished with file, cleanup */
3179   default_symfile_offsets,      /* parse user's offsets to internal form */
3180   default_symfile_segments,     /* Get segment information from a file.  */
3181   NULL,
3182   default_symfile_relocate,     /* Relocate a debug section.  */
3183   NULL,                         /* sym_probe_fns */
3184   &psym_functions
3185 };
3186
3187 void
3188 _initialize_dbxread (void)
3189 {
3190   add_symtab_fns (bfd_target_aout_flavour, &aout_sym_fns);
3191 }