X-Git-Url: http://git.efficios.com/?a=blobdiff_plain;f=gdb%2Fsolib.h;h=2628ca0c2b799c3904a931fa9f06e1cf3f5653d1;hb=441af85bd9c68dbc0c2a1dbe23bf07c6cb3c3f5d;hp=aba26d455891072c19cb23731955fbee703c1395;hpb=6730b1398753e93900ac57c7c4ac102b7eec9f72;p=deliverable%2Fbinutils-gdb.git diff --git a/gdb/solib.h b/gdb/solib.h index aba26d4558..2628ca0c2b 100644 --- a/gdb/solib.h +++ b/gdb/solib.h @@ -1,57 +1,126 @@ /* Shared library declarations for GDB, the GNU Debugger. - Copyright (C) 1992 Free Software Foundation, Inc. + + Copyright (C) 1992-2020 Free Software Foundation, Inc. -This file is part of GDB. + This file is part of GDB. -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 -the Free Software Foundation; either version 2 of the License, or -(at your option) any later version. + 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 + the Free Software Foundation; either version 3 of the License, or + (at your option) any later version. -This program is distributed in the hope that it will be useful, -but WITHOUT ANY WARRANTY; without even the implied warranty of -MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the -GNU General Public License for more details. + This program is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU General Public License for more details. -You should have received a copy of the GNU General Public License -along with this program; if not, write to the Free Software -Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. */ + You should have received a copy of the GNU General Public License + along with this program. If not, see . */ -#ifdef __STDC__ /* Forward decl's for prototypes */ +#ifndef SOLIB_H +#define SOLIB_H + +/* Forward decl's for prototypes */ +struct so_list; struct target_ops; -#endif +struct target_so_ops; +struct program_space; + +#include "symfile-add-flags.h" + +/* List of known shared objects */ +#define so_list_head current_program_space->so_list /* Called when we free all symtabs, to free the shared library information - as well. */ + as well. */ + +extern void clear_solib (void); + +/* Called to add symbols from a shared library to gdb's symbol table. */ + +extern void solib_add (const char *, int, int); +extern bool solib_read_symbols (struct so_list *, symfile_add_flags); + +/* Function to be called when the inferior starts up, to discover the + names of shared libraries that are dynamically linked, the base + addresses to which they are linked, and sufficient information to + read in their symbols at a later time. */ + +extern void solib_create_inferior_hook (int from_tty); + +/* If ADDR lies in a shared library, return its name. */ + +extern char *solib_name_from_address (struct program_space *, CORE_ADDR); + +/* Return true if ADDR lies within SOLIB. */ + +extern bool solib_contains_address_p (const struct so_list *, CORE_ADDR); + +/* Return whether the data starting at VADDR, size SIZE, must be kept + in a core file for shared libraries loaded before "gcore" is used + to be handled correctly when the core file is loaded. This only + applies when the section would otherwise not be kept in the core + file (in particular, for readonly sections). */ + +extern bool solib_keep_data_in_core (CORE_ADDR vaddr, unsigned long size); + +/* Return true if PC lies in the dynamic symbol resolution code of the + run time loader. */ + +extern bool in_solib_dynsym_resolve_code (CORE_ADDR); + +/* Discard symbols that were auto-loaded from shared libraries. */ + +extern void no_shared_libraries (const char *ignored, int from_tty); + +/* Set the solib operations for GDBARCH to NEW_OPS. */ + +extern void set_solib_ops (struct gdbarch *gdbarch, + const struct target_so_ops *new_ops); + +/* Synchronize GDB's shared object list with inferior's. + + Extract the list of currently loaded shared objects from the + inferior, and compare it with the list of shared objects currently + in GDB's so_list_head list. Edit so_list_head to bring it in sync + with the inferior's new list. + + If we notice that the inferior has unloaded some shared objects, + free any symbolic info GDB had read about those shared objects. + + Don't load symbolic info for any new shared objects; just add them + to the list, and leave their symbols_loaded flag clear. + + If FROM_TTY is non-null, feel free to print messages about what + we're doing. */ -#define CLEAR_SOLIB clear_solib +extern void update_solib_list (int from_tty); -extern void -clear_solib PARAMS ((void)); +/* Return true if NAME is the libpthread shared library. */ -/* Called to add symbols from a shared library to gdb's symbol table. */ +extern bool libpthread_name_p (const char *name); -#define SOLIB_ADD(filename, from_tty, targ) \ - solib_add (filename, from_tty, targ) +/* Look up symbol from both symbol table and dynamic string table. */ -extern void -solib_add PARAMS ((char *, int, struct target_ops *)); +extern CORE_ADDR gdb_bfd_lookup_symbol (bfd *abfd, + int (*match_sym) (const asymbol *, + const void *), + const void *data); -/* Function to be called when the inferior starts up, to discover the names - of shared libraries that are dynamically linked, the base addresses to - which they are linked, and sufficient information to read in their symbols - at a later time. */ +/* Look up symbol from symbol table. */ -#define SOLIB_CREATE_INFERIOR_HOOK(PID) solib_create_inferior_hook() +extern CORE_ADDR gdb_bfd_lookup_symbol_from_symtab (bfd *abfd, + int (*match_sym) + (const asymbol *, + const void *), + const void *data); -extern void -solib_create_inferior_hook PARAMS((void)); /* solib.c */ +/* Enable or disable optional solib event breakpoints as appropriate. */ -/* If we can't set a breakpoint, and it's in a shared library, just - disable it. */ +extern void update_solib_breakpoints (void); -#define DISABLE_UNSETTABLE_BREAK(addr) solib_address(addr) +/* Handle an solib event by calling solib_add. */ -extern int -solib_address PARAMS ((CORE_ADDR)); /* solib.c */ +extern void handle_solib_event (void); +#endif /* SOLIB_H */