/* Read NLM (NetWare Loadable Module) format executable files for GDB.
|
/* Read NLM (NetWare Loadable Module) format executable files for GDB.
|
Copyright 1993, 1994, 1998 Free Software Foundation, Inc.
|
Copyright 1993, 1994, 1998 Free Software Foundation, Inc.
|
Written by Fred Fish at Cygnus Support (fnf@cygnus.com).
|
Written by Fred Fish at Cygnus Support (fnf@cygnus.com).
|
|
|
This file is part of GDB.
|
This file is part of GDB.
|
|
|
This program is free software; you can redistribute it and/or modify
|
This program is free software; you can redistribute it and/or modify
|
it under the terms of the GNU General Public License as published by
|
it under the terms of the GNU General Public License as published by
|
the Free Software Foundation; either version 2 of the License, or
|
the Free Software Foundation; either version 2 of the License, or
|
(at your option) any later version.
|
(at your option) any later version.
|
|
|
This program is distributed in the hope that it will be useful,
|
This program is distributed in the hope that it will be useful,
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
GNU General Public License for more details.
|
GNU General Public License for more details.
|
|
|
You should have received a copy of the GNU General Public License
|
You should have received a copy of the GNU General Public License
|
along with this program; if not, write to the Free Software
|
along with this program; if not, write to the Free Software
|
Foundation, Inc., 59 Temple Place - Suite 330,
|
Foundation, Inc., 59 Temple Place - Suite 330,
|
Boston, MA 02111-1307, USA. */
|
Boston, MA 02111-1307, USA. */
|
|
|
#include "defs.h"
|
#include "defs.h"
|
#include "gdb_string.h"
|
#include "gdb_string.h"
|
#include "bfd.h"
|
#include "bfd.h"
|
#include "symtab.h"
|
#include "symtab.h"
|
#include "symfile.h"
|
#include "symfile.h"
|
#include "objfiles.h"
|
#include "objfiles.h"
|
#include "gdb-stabs.h"
|
#include "gdb-stabs.h"
|
#include "buildsym.h"
|
#include "buildsym.h"
|
#include "stabsread.h"
|
#include "stabsread.h"
|
|
|
extern void _initialize_nlmread PARAMS ((void));
|
extern void _initialize_nlmread PARAMS ((void));
|
|
|
static void
|
static void
|
nlm_new_init PARAMS ((struct objfile *));
|
nlm_new_init PARAMS ((struct objfile *));
|
|
|
static void
|
static void
|
nlm_symfile_init PARAMS ((struct objfile *));
|
nlm_symfile_init PARAMS ((struct objfile *));
|
|
|
static void
|
static void
|
nlm_symfile_read PARAMS ((struct objfile *, int));
|
nlm_symfile_read PARAMS ((struct objfile *, int));
|
|
|
static void
|
static void
|
nlm_symfile_finish PARAMS ((struct objfile *));
|
nlm_symfile_finish PARAMS ((struct objfile *));
|
|
|
static void
|
static void
|
nlm_symtab_read PARAMS ((bfd *, CORE_ADDR, struct objfile *));
|
nlm_symtab_read PARAMS ((bfd *, CORE_ADDR, struct objfile *));
|
|
|
/* Initialize anything that needs initializing when a completely new symbol
|
/* Initialize anything that needs initializing when a completely new symbol
|
file is specified (not just adding some symbols from another file, e.g. a
|
file is specified (not just adding some symbols from another file, e.g. a
|
shared library).
|
shared library).
|
|
|
We reinitialize buildsym, since gdb will be able to read stabs from an NLM
|
We reinitialize buildsym, since gdb will be able to read stabs from an NLM
|
file at some point in the near future. */
|
file at some point in the near future. */
|
|
|
static void
|
static void
|
nlm_new_init (ignore)
|
nlm_new_init (ignore)
|
struct objfile *ignore;
|
struct objfile *ignore;
|
{
|
{
|
stabsread_new_init ();
|
stabsread_new_init ();
|
buildsym_new_init ();
|
buildsym_new_init ();
|
}
|
}
|
|
|
|
|
/* NLM specific initialization routine for reading symbols.
|
/* NLM specific initialization routine for reading symbols.
|
|
|
It is passed a pointer to a struct sym_fns which contains, among other
|
It is passed a pointer to a struct sym_fns which contains, among other
|
things, the BFD for the file whose symbols are being read, and a slot for
|
things, the BFD for the file whose symbols are being read, and a slot for
|
a pointer to "private data" which we can fill with goodies.
|
a pointer to "private data" which we can fill with goodies.
|
|
|
For now at least, we have nothing in particular to do, so this function is
|
For now at least, we have nothing in particular to do, so this function is
|
just a stub. */
|
just a stub. */
|
|
|
static void
|
static void
|
nlm_symfile_init (ignore)
|
nlm_symfile_init (ignore)
|
struct objfile *ignore;
|
struct objfile *ignore;
|
{
|
{
|
}
|
}
|
|
|
/*
|
/*
|
|
|
LOCAL FUNCTION
|
LOCAL FUNCTION
|
|
|
nlm_symtab_read -- read the symbol table of an NLM file
|
nlm_symtab_read -- read the symbol table of an NLM file
|
|
|
SYNOPSIS
|
SYNOPSIS
|
|
|
void nlm_symtab_read (bfd *abfd, CORE_ADDR addr,
|
void nlm_symtab_read (bfd *abfd, CORE_ADDR addr,
|
struct objfile *objfile)
|
struct objfile *objfile)
|
|
|
DESCRIPTION
|
DESCRIPTION
|
|
|
Given an open bfd, a base address to relocate symbols to, and a
|
Given an open bfd, a base address to relocate symbols to, and a
|
flag that specifies whether or not this bfd is for an executable
|
flag that specifies whether or not this bfd is for an executable
|
or not (may be shared library for example), add all the global
|
or not (may be shared library for example), add all the global
|
function and data symbols to the minimal symbol table.
|
function and data symbols to the minimal symbol table.
|
*/
|
*/
|
|
|
static void
|
static void
|
nlm_symtab_read (abfd, addr, objfile)
|
nlm_symtab_read (abfd, addr, objfile)
|
bfd *abfd;
|
bfd *abfd;
|
CORE_ADDR addr;
|
CORE_ADDR addr;
|
struct objfile *objfile;
|
struct objfile *objfile;
|
{
|
{
|
long storage_needed;
|
long storage_needed;
|
asymbol *sym;
|
asymbol *sym;
|
asymbol **symbol_table;
|
asymbol **symbol_table;
|
long number_of_symbols;
|
long number_of_symbols;
|
long i;
|
long i;
|
struct cleanup *back_to;
|
struct cleanup *back_to;
|
CORE_ADDR symaddr;
|
CORE_ADDR symaddr;
|
enum minimal_symbol_type ms_type;
|
enum minimal_symbol_type ms_type;
|
|
|
storage_needed = bfd_get_symtab_upper_bound (abfd);
|
storage_needed = bfd_get_symtab_upper_bound (abfd);
|
if (storage_needed < 0)
|
if (storage_needed < 0)
|
error ("Can't read symbols from %s: %s", bfd_get_filename (abfd),
|
error ("Can't read symbols from %s: %s", bfd_get_filename (abfd),
|
bfd_errmsg (bfd_get_error ()));
|
bfd_errmsg (bfd_get_error ()));
|
if (storage_needed > 0)
|
if (storage_needed > 0)
|
{
|
{
|
symbol_table = (asymbol **) xmalloc (storage_needed);
|
symbol_table = (asymbol **) xmalloc (storage_needed);
|
back_to = make_cleanup (free, symbol_table);
|
back_to = make_cleanup (free, symbol_table);
|
number_of_symbols = bfd_canonicalize_symtab (abfd, symbol_table);
|
number_of_symbols = bfd_canonicalize_symtab (abfd, symbol_table);
|
if (number_of_symbols < 0)
|
if (number_of_symbols < 0)
|
error ("Can't read symbols from %s: %s", bfd_get_filename (abfd),
|
error ("Can't read symbols from %s: %s", bfd_get_filename (abfd),
|
bfd_errmsg (bfd_get_error ()));
|
bfd_errmsg (bfd_get_error ()));
|
|
|
for (i = 0; i < number_of_symbols; i++)
|
for (i = 0; i < number_of_symbols; i++)
|
{
|
{
|
sym = symbol_table[i];
|
sym = symbol_table[i];
|
if ( /*sym -> flags & BSF_GLOBAL */ 1)
|
if ( /*sym -> flags & BSF_GLOBAL */ 1)
|
{
|
{
|
/* Bfd symbols are section relative. */
|
/* Bfd symbols are section relative. */
|
symaddr = sym->value + sym->section->vma;
|
symaddr = sym->value + sym->section->vma;
|
/* Relocate all non-absolute symbols by base address. */
|
/* Relocate all non-absolute symbols by base address. */
|
if (sym->section != &bfd_abs_section)
|
if (sym->section != &bfd_abs_section)
|
symaddr += addr;
|
symaddr += addr;
|
|
|
/* For non-absolute symbols, use the type of the section
|
/* For non-absolute symbols, use the type of the section
|
they are relative to, to intuit text/data. BFD provides
|
they are relative to, to intuit text/data. BFD provides
|
no way of figuring this out for absolute symbols. */
|
no way of figuring this out for absolute symbols. */
|
if (sym->section->flags & SEC_CODE)
|
if (sym->section->flags & SEC_CODE)
|
ms_type = mst_text;
|
ms_type = mst_text;
|
else if (sym->section->flags & SEC_DATA)
|
else if (sym->section->flags & SEC_DATA)
|
ms_type = mst_data;
|
ms_type = mst_data;
|
else
|
else
|
ms_type = mst_unknown;
|
ms_type = mst_unknown;
|
|
|
prim_record_minimal_symbol (sym->name, symaddr, ms_type,
|
prim_record_minimal_symbol (sym->name, symaddr, ms_type,
|
objfile);
|
objfile);
|
}
|
}
|
}
|
}
|
do_cleanups (back_to);
|
do_cleanups (back_to);
|
}
|
}
|
}
|
}
|
|
|
|
|
/* Scan and build partial symbols for a symbol file.
|
/* Scan and build partial symbols for a symbol file.
|
We have been initialized by a call to nlm_symfile_init, which
|
We have been initialized by a call to nlm_symfile_init, which
|
currently does nothing.
|
currently does nothing.
|
|
|
SECTION_OFFSETS is a set of offsets to apply to relocate the symbols
|
SECTION_OFFSETS is a set of offsets to apply to relocate the symbols
|
in each section. We simplify it down to a single offset for all
|
in each section. We simplify it down to a single offset for all
|
symbols. FIXME.
|
symbols. FIXME.
|
|
|
MAINLINE is true if we are reading the main symbol
|
MAINLINE is true if we are reading the main symbol
|
table (as opposed to a shared lib or dynamically loaded file).
|
table (as opposed to a shared lib or dynamically loaded file).
|
|
|
This function only does the minimum work necessary for letting the
|
This function only does the minimum work necessary for letting the
|
user "name" things symbolically; it does not read the entire symtab.
|
user "name" things symbolically; it does not read the entire symtab.
|
Instead, it reads the external and static symbols and puts them in partial
|
Instead, it reads the external and static symbols and puts them in partial
|
symbol tables. When more extensive information is requested of a
|
symbol tables. When more extensive information is requested of a
|
file, the corresponding partial symbol table is mutated into a full
|
file, the corresponding partial symbol table is mutated into a full
|
fledged symbol table by going back and reading the symbols
|
fledged symbol table by going back and reading the symbols
|
for real.
|
for real.
|
|
|
Note that NLM files have two sets of information that is potentially
|
Note that NLM files have two sets of information that is potentially
|
useful for building gdb's minimal symbol table. The first is a list
|
useful for building gdb's minimal symbol table. The first is a list
|
of the publically exported symbols, and is currently used to build
|
of the publically exported symbols, and is currently used to build
|
bfd's canonical symbol table. The second is an optional native debugging
|
bfd's canonical symbol table. The second is an optional native debugging
|
format which contains additional symbols (and possibly duplicates of
|
format which contains additional symbols (and possibly duplicates of
|
the publically exported symbols). The optional native debugging format
|
the publically exported symbols). The optional native debugging format
|
is not currently used. */
|
is not currently used. */
|
|
|
static void
|
static void
|
nlm_symfile_read (objfile, mainline)
|
nlm_symfile_read (objfile, mainline)
|
struct objfile *objfile;
|
struct objfile *objfile;
|
int mainline;
|
int mainline;
|
{
|
{
|
bfd *abfd = objfile->obfd;
|
bfd *abfd = objfile->obfd;
|
struct cleanup *back_to;
|
struct cleanup *back_to;
|
CORE_ADDR offset;
|
CORE_ADDR offset;
|
struct symbol *mainsym;
|
struct symbol *mainsym;
|
|
|
init_minimal_symbol_collection ();
|
init_minimal_symbol_collection ();
|
back_to = make_cleanup ((make_cleanup_func) discard_minimal_symbols, 0);
|
back_to = make_cleanup ((make_cleanup_func) discard_minimal_symbols, 0);
|
|
|
/* FIXME, should take a section_offsets param, not just an offset. */
|
/* FIXME, should take a section_offsets param, not just an offset. */
|
|
|
offset = ANOFFSET (objfile->section_offsets, 0);
|
offset = ANOFFSET (objfile->section_offsets, 0);
|
|
|
/* Process the NLM export records, which become the bfd's canonical symbol
|
/* Process the NLM export records, which become the bfd's canonical symbol
|
table. */
|
table. */
|
|
|
nlm_symtab_read (abfd, offset, objfile);
|
nlm_symtab_read (abfd, offset, objfile);
|
|
|
stabsect_build_psymtabs (objfile, mainline, ".stab",
|
stabsect_build_psymtabs (objfile, mainline, ".stab",
|
".stabstr", ".text");
|
".stabstr", ".text");
|
|
|
mainsym = lookup_symbol ("main", NULL, VAR_NAMESPACE, NULL, NULL);
|
mainsym = lookup_symbol ("main", NULL, VAR_NAMESPACE, NULL, NULL);
|
|
|
if (mainsym
|
if (mainsym
|
&& SYMBOL_CLASS (mainsym) == LOC_BLOCK)
|
&& SYMBOL_CLASS (mainsym) == LOC_BLOCK)
|
{
|
{
|
objfile->ei.main_func_lowpc = BLOCK_START (SYMBOL_BLOCK_VALUE (mainsym));
|
objfile->ei.main_func_lowpc = BLOCK_START (SYMBOL_BLOCK_VALUE (mainsym));
|
objfile->ei.main_func_highpc = BLOCK_END (SYMBOL_BLOCK_VALUE (mainsym));
|
objfile->ei.main_func_highpc = BLOCK_END (SYMBOL_BLOCK_VALUE (mainsym));
|
}
|
}
|
|
|
/* FIXME: We could locate and read the optional native debugging format
|
/* FIXME: We could locate and read the optional native debugging format
|
here and add the symbols to the minimal symbol table. */
|
here and add the symbols to the minimal symbol table. */
|
|
|
/* Install any minimal symbols that have been collected as the current
|
/* Install any minimal symbols that have been collected as the current
|
minimal symbols for this objfile. */
|
minimal symbols for this objfile. */
|
|
|
install_minimal_symbols (objfile);
|
install_minimal_symbols (objfile);
|
|
|
do_cleanups (back_to);
|
do_cleanups (back_to);
|
}
|
}
|
|
|
|
|
/* Perform any local cleanups required when we are done with a particular
|
/* Perform any local cleanups required when we are done with a particular
|
objfile. I.E, we are in the process of discarding all symbol information
|
objfile. I.E, we are in the process of discarding all symbol information
|
for an objfile, freeing up all memory held for it, and unlinking the
|
for an objfile, freeing up all memory held for it, and unlinking the
|
objfile struct from the global list of known objfiles. */
|
objfile struct from the global list of known objfiles. */
|
|
|
static void
|
static void
|
nlm_symfile_finish (objfile)
|
nlm_symfile_finish (objfile)
|
struct objfile *objfile;
|
struct objfile *objfile;
|
{
|
{
|
if (objfile->sym_private != NULL)
|
if (objfile->sym_private != NULL)
|
{
|
{
|
mfree (objfile->md, objfile->sym_private);
|
mfree (objfile->md, objfile->sym_private);
|
}
|
}
|
}
|
}
|
|
|
/* Register that we are able to handle NLM file format. */
|
/* Register that we are able to handle NLM file format. */
|
|
|
static struct sym_fns nlm_sym_fns =
|
static struct sym_fns nlm_sym_fns =
|
{
|
{
|
bfd_target_nlm_flavour,
|
bfd_target_nlm_flavour,
|
nlm_new_init, /* sym_new_init: init anything gbl to entire symtab */
|
nlm_new_init, /* sym_new_init: init anything gbl to entire symtab */
|
nlm_symfile_init, /* sym_init: read initial info, setup for sym_read() */
|
nlm_symfile_init, /* sym_init: read initial info, setup for sym_read() */
|
nlm_symfile_read, /* sym_read: read a symbol file into symtab */
|
nlm_symfile_read, /* sym_read: read a symbol file into symtab */
|
nlm_symfile_finish, /* sym_finish: finished with file, cleanup */
|
nlm_symfile_finish, /* sym_finish: finished with file, cleanup */
|
default_symfile_offsets, /* sym_offsets: Translate ext. to int. relocation */
|
default_symfile_offsets, /* sym_offsets: Translate ext. to int. relocation */
|
NULL /* next: pointer to next struct sym_fns */
|
NULL /* next: pointer to next struct sym_fns */
|
};
|
};
|
|
|
void
|
void
|
_initialize_nlmread ()
|
_initialize_nlmread ()
|
{
|
{
|
add_symtab_fns (&nlm_sym_fns);
|
add_symtab_fns (&nlm_sym_fns);
|
}
|
}
|
|
|
