static void clear_symtab_users_cleanup (void *ignore);
-/* Global variables owned by this file */
-int readnow_symbol_files; /* Read full symbols immediately */
+/* Global variables owned by this file. */
+int readnow_symbol_files; /* Read full symbols immediately. */
-/* External variables and functions referenced. */
+/* External variables and functions referenced. */
extern void report_transfer_performance (unsigned long, time_t, time_t);
-/* Functions this file defines */
+/* Functions this file defines. */
static void load_command (char *, int);
/* List of all available sym_fns. On gdb startup, each object file reader
calls add_symtab_fns() to register information on each format it is
- prepared to read. */
+ prepared to read. */
typedef const struct sym_fns *sym_fns_ptr;
DEF_VEC_P (sym_fns_ptr);
/* Make a null terminated copy of the string at PTR with SIZE characters in
the obstack pointed to by OBSTACKP . Returns the address of the copy.
- Note that the string at PTR does not have to be null terminated, I.E. it
+ Note that the string at PTR does not have to be null terminated, I.e. it
may be part of a larger string and we are only saving a substring. */
char *
char *p = (char *) obstack_alloc (obstackp, size + 1);
/* Open-coded memcpy--saves function call time. These strings are usually
short. FIXME: Is this really still true with a compiler that can
- inline memcpy? */
+ inline memcpy? */
{
const char *p1 = ptr;
char *p2 = p;
}
/* Build (allocate and populate) a section_addr_info struct from
- an existing section table. */
+ an existing section table. */
extern struct section_addr_info *
build_section_addr_info_from_section_table (const struct target_section *start,
return sap;
}
-/* Free all memory allocated by build_section_addr_info_from_section_table. */
+/* Free all memory allocated by build_section_addr_info_from_section_table. */
extern void
free_section_addr_info (struct section_addr_info *sap)
memset (section_offsets, 0, SIZEOF_N_SECTION_OFFSETS (num_sections));
- /* Now calculate offsets for section that were specified by the caller. */
+ /* Now calculate offsets for section that were specified by the caller. */
for (i = 0; i < addrs->num_sections && addrs->other[i].name; i++)
{
struct other_sections *osp;
if (osp->addr == 0)
continue;
- /* Record all sections in offsets */
+ /* Record all sections in offsets. */
/* The section_offsets in the objfile are here filled in using
- the BFD index. */
+ the BFD index. */
section_offsets->offsets[osp->sectindex] = osp->addr;
}
}
abfd_addrs_sorted = addrs_section_sort (abfd_addrs);
make_cleanup (xfree, abfd_addrs_sorted);
- /* Now create ADDRS_TO_ABFD_ADDRS from ADDRS_SORTED and ABFD_ADDRS_SORTED. */
+ /* Now create ADDRS_TO_ABFD_ADDRS from ADDRS_SORTED and
+ ABFD_ADDRS_SORTED. */
addrs_to_abfd_addrs = xzalloc (sizeof (*addrs_to_abfd_addrs)
* addrs->num_sections);
if (sect)
{
- /* This is the index used by BFD. */
+ /* This is the index used by BFD. */
addrs->other[i].sectindex = sect->sectindex;
if (addrs->other[i].addr != 0)
}
/* Remember the bfd indexes for the .text, .data, .bss and
- .rodata sections. */
+ .rodata sections. */
init_objfile_sect_indices (objfile);
}
objfile->sf = find_sym_fns (objfile->obfd);
if (objfile->sf == NULL)
- return; /* No symbols. */
+ return; /* No symbols. */
/* Make sure that partially constructed symbol tables will be cleaned up
if an error occurs during symbol reading. */
/* If ADDRS and OFFSETS are both NULL, put together a dummy address
list. We now establish the convention that an addr of zero means
- no load address was specified. */
+ no load address was specified. */
if (! addrs && ! offsets)
{
local_addr
/* Initialize symbol reading routines for this objfile, allow complaints to
appear for this new file, and record how verbose to be, then do the
- initial symbol reading for this file. */
+ initial symbol reading for this file. */
(*objfile->sf->sym_init) (objfile);
clear_complaints (&symfile_complaints, 1, add_flags & SYMFILE_VERBOSE);
new_symfile_objfile (struct objfile *objfile, int add_flags)
{
/* If this is the main symbol file we have to clean up all users of the
- old main symbol file. Otherwise it is sufficient to fixup all the
+ old main symbol file. Otherwise it is sufficient to fixup all the
breakpoints that may have been redefined by this symbol file. */
if (add_flags & SYMFILE_MAINLINE)
{
ADDRS is ignored when SYMFILE_MAINLINE bit is set in ADD_FLAGS.
Upon success, returns a pointer to the objfile that was added.
- Upon failure, jumps back to command level (never returns). */
+ Upon failure, jumps back to command level (never returns). */
static struct objfile *
symbol_file_add_with_addrs_or_offsets (bfd *abfd,
/* We either created a new mapped symbol table, mapped an existing
symbol table file which has not had initial symbol reading
- performed, or need to read an unmapped symbol table. */
+ performed, or need to read an unmapped symbol table. */
if (from_tty || info_verbose)
{
if (deprecated_pre_add_symbol_hook)
/* We now have at least a partial symbol table. Check to see if the
user requested that all symbols be read on initial access via either
the gdb startup command line or on a per symbol file basis. Expand
- all partial symbol tables for this objfile if so. */
+ all partial symbol tables for this objfile if so. */
if ((flags & OBJF_READNOW))
{
if (objfile->sf == NULL)
{
observer_notify_new_objfile (objfile);
- return objfile; /* No symbols. */
+ return objfile; /* No symbols. */
}
new_symfile_objfile (objfile, add_flags);
bfd_get_section_contents (objfile->obfd, sect, contents,
(file_ptr)0, (bfd_size_type)debuglink_size);
- /* Crc value is stored after the filename, aligned up to 4 bytes. */
+ /* Crc value is stored after the filename, aligned up to 4 bytes. */
crc_offset = strlen (contents) + 1;
crc_offset = (crc_offset + 3) & ~3;
PARENT_OBJFILE itself this function would not be called. .gnu_debuglink
section can contain just the basename of PARENT_OBJFILE without any
".debug" suffix as "/usr/lib/debug/path/to/file" is a separate tree where
- the separate debug infos with the same basename can exist. */
+ the separate debug infos with the same basename can exist. */
if (strcmp (name, parent_objfile->name) == 0)
return 0;
/* If I is -1 then no directory is present there and DIR will be "". */
dir[i+1] = '\0';
- /* Set I to max (strlen (canon_name), strlen (dir)). */
+ /* Set I to max (strlen (canon_name), strlen (dir)). */
canon_name = lrealpath (dir);
i = strlen (dir);
if (canon_name && strlen (canon_name) > i)
}
/* Free 1st new malloc'd copy, but keep the 2nd malloc'd copy in
- bfd. It'll be freed in free_objfile(). */
+ bfd. It'll be freed in free_objfile(). */
xfree (name);
name = absolute_name;
/* Link SF into the global symtab_fns list. Called on startup by the
_initialize routine in each object file format reader, to register
information about each format the the reader is prepared to
- handle. */
+ handle. */
void
add_symtab_fns (const struct sym_fns *sf)
error (_("Too many parameters."));
}
- /* Open the file for loading. */
+ /* Open the file for loading. */
loadfile_bfd = bfd_openr (filename, gnutarget);
if (loadfile_bfd == NULL)
{
do_cleanups (old_cleanups);
}
-/* Report how fast the transfer went. */
+/* Report how fast the transfer went. */
/* DEPRECATED: cagney/1999-10-18: report_transfer_performance is being
replaced by print_transfer_performance (with a very different
- function signature). */
+ function signature). */
void
report_transfer_performance (unsigned long data_count, time_t start_time,
monitor for Microware's OS-9 / OS-9000, see remote-os9k.c). In the
rombug case, the user doesn't need to supply a text address,
instead a call to target_link() (in target.c) would supply the
- value to use. We are now discontinuing this type of ad hoc syntax. */
+ value to use. We are now discontinuing this type of ad hoc syntax. */
static void
add_symbol_file_command (char *args, int from_tty)
for (arg = argv[0], argcnt = 0; arg != NULL; arg = argv[++argcnt])
{
- /* Process the argument. */
+ /* Process the argument. */
if (argcnt == 0)
{
- /* The first argument is the file name. */
+ /* The first argument is the file name. */
filename = tilde_expand (arg);
make_cleanup (xfree, filename);
}
if (argcnt == 1)
{
/* The second argument is always the text address at which
- to load the program. */
+ to load the program. */
sect_opts[section_index].name = ".text";
sect_opts[section_index].value = arg;
if (++section_index >= num_sect_opts)
else
{
/* It's an option (starting with '-') or it's an argument
- to an option */
+ to an option. */
if (*arg == '-')
{
if (section_index < 1)
error (_("The address where %s has been loaded is missing"), filename);
- /* Print the prompt for the query below. And save the arguments into
+ /* Print the prompt for the query below. And save the arguments into
a sect_addr_info structure to be passed around to other
functions. We have to split this up into separate print
statements because hex_string returns a local static
- string. */
+ string. */
printf_unfiltered (_("add symbol table from file \"%s\" at\n"), filename);
section_addrs = alloc_section_addr_info (section_index);
addr = parse_and_eval_address (val);
/* Here we store the section offsets in the order they were
- entered on the command line. */
+ entered on the command line. */
section_addrs->other[sec_num].name = sec;
section_addrs->other[sec_num].addr = addr;
printf_unfiltered ("\t%s_addr = %s\n", sec,
the load time should be saved in the partial symbol tables, since
different tables may come from different source files. FIXME.
This routine should then walk down each partial symbol table
- and see if the symbol table that it originates from has been changed */
+ and see if the symbol table that it originates from has been changed. */
for (objfile = object_files; objfile; objfile = objfile->next)
{
res = stat (objfile->name, &new_statbuf);
if (res != 0)
{
- /* FIXME, should use print_sys_errmsg but it's not filtered. */
+ /* FIXME, should use print_sys_errmsg but it's not filtered. */
printf_unfiltered (_("`%s' has disappeared; keeping its symbols.\n"),
objfile->name);
continue;
memset (&objfile->static_psymbols, 0,
sizeof (objfile->static_psymbols));
- /* Free the obstacks for non-reusable objfiles */
+ /* Free the obstacks for non-reusable objfiles. */
psymbol_bcache_free (objfile->psymbol_cache);
objfile->psymbol_cache = psymbol_bcache_init ();
bcache_xfree (objfile->macro_cache);
char *cp = ext_args;
enum language lang;
- /* First arg is filename extension, starting with '.' */
+ /* First arg is filename extension, starting with '.' */
if (*cp != '.')
error (_("'%s': Filename extension must begin with '.'"), ext_args);
"filename extension and language"),
ext_args);
- /* Null-terminate first arg */
+ /* Null-terminate first arg. */
*cp++ = '\0';
/* Find beginning of second arg, which should be a source language. */
if (i >= fl_table_next)
{
- /* new file extension */
+ /* New file extension. */
add_filename_language (ext_args, lang);
}
else
{
- /* redefining a previously known filename extension */
+ /* Redefining a previously known filename extension. */
/* if (from_tty) */
/* query ("Really make files of type %s '%s'?", */
static void
init_filename_language_table (void)
{
- if (fl_table_size == 0) /* protect against repetition */
+ if (fl_table_size == 0) /* Protect against repetition. */
{
fl_table_size = 20;
fl_table_next = 0;
symtab->language = deduce_language_from_filename (filename);
symtab->debugformat = "unknown";
- /* Hook it to the objfile it comes from */
+ /* Hook it to the objfile it comes from. */
symtab->objfile = objfile;
symtab->next = objfile->symtabs;
overlay_unmapped_address(...): map an address from section's VMA to LMA
symbol_overlayed_address(...): Return a "current" address for symbol:
either in VMA or LMA depending on whether
- the symbol's section is currently mapped
- */
+ the symbol's section is currently mapped. */
/* Overlay debugging state: */
enum overlay_debugging_state overlay_debugging = ovly_off;
-int overlay_cache_invalid = 0; /* True if need to refresh mapped state */
+int overlay_cache_invalid = 0; /* True if need to refresh mapped state. */
/* Function: section_is_overlay (SECTION)
Returns true if SECTION has VMA not equal to LMA, ie.
return 0; /* overlay debugging off */
case ovly_auto: /* overlay debugging automatic */
/* Unles there is a gdbarch_overlay_update function,
- there's really nothing useful to do here (can't really go auto) */
+ there's really nothing useful to do here (can't really go auto). */
gdbarch = get_objfile_arch (osect->objfile);
if (gdbarch_overlay_update_p (gdbarch))
{
{
if (overlay_debugging)
{
- /* If the symbol has no section, just return its regular address. */
+ /* If the symbol has no section, just return its regular address. */
if (section == 0)
return address;
- /* If the symbol's section is not an overlay, just return its address */
+ /* If the symbol's section is not an overlay, just return its
+ address. */
if (!section_is_overlay (section))
return address;
- /* If the symbol's section is mapped, just return its address */
+ /* If the symbol's section is mapped, just return its address. */
if (section_is_mapped (section))
return address;
/*
}
/* Function: list_overlays_command
- Print a list of mapped sections and their PC ranges */
+ Print a list of mapped sections and their PC ranges. */
void
list_overlays_command (char *args, int from_tty)
if (args == 0 || *args == 0)
error (_("Argument required: name of an overlay section"));
- /* First, find a section matching the user supplied argument */
+ /* First, find a section matching the user supplied argument. */
ALL_OBJSECTIONS (objfile, sec)
if (!strcmp (bfd_section_name (objfile->obfd, sec->the_bfd_section), args))
{
- /* Now, check to see if the section is an overlay. */
+ /* Now, check to see if the section is an overlay. */
if (!section_is_overlay (sec))
continue; /* not an overlay section */
- /* Mark the overlay as "mapped" */
+ /* Mark the overlay as "mapped". */
sec->ovly_mapped = 1;
/* Next, make a pass and unmap any sections that are
printf_unfiltered (_("Note: section %s unmapped by overlap\n"),
bfd_section_name (objfile->obfd,
sec2->the_bfd_section));
- sec2->ovly_mapped = 0; /* sec2 overlaps sec: unmap sec2 */
+ sec2->ovly_mapped = 0; /* sec2 overlaps sec: unmap sec2. */
}
return;
}
if (args == 0 || *args == 0)
error (_("Argument required: name of an overlay section"));
- /* First, find a section matching the user supplied argument */
+ /* First, find a section matching the user supplied argument. */
ALL_OBJSECTIONS (objfile, sec)
if (!strcmp (bfd_section_name (objfile->obfd, sec->the_bfd_section), args))
{
/* Function: overlay_auto_command
A utility command to turn on overlay debugging.
- Possibly this should be done via a set/show command. */
+ Possibly this should be done via a set/show command. */
static void
overlay_auto_command (char *args, int from_tty)
/* Function: overlay_manual_command
A utility command to turn on overlay debugging.
- Possibly this should be done via a set/show command. */
+ Possibly this should be done via a set/show command. */
static void
overlay_manual_command (char *args, int from_tty)
/* Function: overlay_off_command
A utility command to turn on overlay debugging.
- Possibly this should be done via a set/show command. */
+ Possibly this should be done via a set/show command. */
static void
overlay_off_command (char *args, int from_tty)
}
/* Function: overlay_command
- A place-holder for a mis-typed command */
+ A place-holder for a mis-typed command. */
-/* Command list chain containing all defined "overlay" subcommands. */
+/* Command list chain containing all defined "overlay" subcommands. */
struct cmd_list_element *overlaylist;
static void
attempt to detect when the cached copy is invalidated. The main
entry point is "simple_overlay_update(SECT), which looks up SECT in
the cached table and re-reads only the entry for that section from
- the target (whenever possible).
- */
+ the target (whenever possible). */
/* Cached, dynamically allocated copies of the target data structures: */
static unsigned (*cache_ovly_table)[4] = 0;
VMA, SIZE, LMA, MAPPED
};
-/* Throw away the cached copy of _ovly_table */
+/* Throw away the cached copy of _ovly_table. */
static void
simple_free_overlay_table (void)
{
}
/* Read an array of ints of size SIZE from the target into a local buffer.
- Convert to host order. int LEN is number of ints */
+ Convert to host order. int LEN is number of ints. */
static void
read_target_long_array (CORE_ADDR memaddr, unsigned int *myaddr,
int len, int size, enum bfd_endian byte_order)
{
- /* FIXME (alloca): Not safe if array is very large. */
+ /* FIXME (alloca): Not safe if array is very large. */
gdb_byte *buf = alloca (len * size);
int i;
}
/* Find and grab a copy of the target _ovly_table
- (and _novlys, which is needed for the table's size) */
+ (and _novlys, which is needed for the table's size). */
static int
simple_read_overlay_table (void)
{
osect->ovly_mapped = cache_ovly_table[i][MAPPED];
return 1;
}
- else /* Warning! Warning! Target's ovly table has changed! */
+ else /* Warning! Warning! Target's ovly table has changed! */
return 0;
}
return 0;
{
struct objfile *objfile;
- /* Were we given an osect to look up? NULL means do all of them. */
+ /* Were we given an osect to look up? NULL means do all of them. */
if (osect)
- /* Have we got a cached copy of the target's overlay table? */
+ /* Have we got a cached copy of the target's overlay table? */
if (cache_ovly_table != NULL)
- /* Does its cached location match what's currently in the symtab? */
+ /* Does its cached location match what's currently in the symtab? */
if (cache_ovly_table_base ==
SYMBOL_VALUE_ADDRESS (lookup_minimal_symbol ("_ovly_table",
NULL, NULL)))
- /* Then go ahead and try to look up this single section in the cache */
+ /* Then go ahead and try to look up this single section in the
+ cache. */
if (simple_overlay_update_1 (osect))
- /* Found it! We're done. */
+ /* Found it! We're done. */
return;
/* Cached table no good: need to read the entire table anew.
if (! simple_read_overlay_table ())
return;
- /* Now may as well update all sections, even if only one was requested. */
+ /* Now may as well update all sections, even if only one was requested. */
ALL_OBJSECTIONS (objfile, osect)
if (section_is_overlay (osect))
{
if (cache_ovly_table[i][VMA] == bfd_section_vma (obfd, bsect)
&& cache_ovly_table[i][LMA] == bfd_section_lma (obfd, bsect)
/* && cache_ovly_table[i][SIZE] == size */ )
- { /* obj_section matches i'th entry in ovly_table */
+ { /* obj_section matches i'th entry in ovly_table. */
osect->ovly_mapped = cache_ovly_table[i][MAPPED];
- break; /* finished with inner for loop: break out */
+ break; /* finished with inner for loop: break out. */
}
}
}
projects / thirdparty / binutils-gdb.git / blobdiff