X-Git-Url: http://git.efficios.com/?a=blobdiff_plain;f=gdb%2Fsolib.h;h=fd5684c6cc81c11819225d7f1f42c5e1f333fbe6;hb=2dc4b12fcd647b883223efeb308c277e629b369c;hp=04be72da4659f93690ecb39820962ec181dc1008;hpb=2ee563b53258d390d7446e90a67f465d504ae44c;p=deliverable%2Fbinutils-gdb.git diff --git a/gdb/solib.h b/gdb/solib.h index 04be72da46..fd5684c6cc 100644 --- a/gdb/solib.h +++ b/gdb/solib.h @@ -1,12 +1,12 @@ /* Shared library declarations for GDB, the GNU Debugger. - Copyright 1992, 1993, 1995, 1998, 1999, 2000, 2001 - Free Software Foundation, Inc. + + Copyright (C) 1992-2019 Free Software Foundation, Inc. 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 + 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, @@ -15,190 +15,112 @@ 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., 59 Temple Place - Suite 330, - Boston, MA 02111-1307, USA. */ + along with this program. If not, see . */ #ifndef SOLIB_H #define SOLIB_H /* Forward decl's for prototypes */ +struct so_list; struct target_ops; +struct target_so_ops; +struct program_space; -/* Called when we free all symtabs, to free the shared library information - as well. */ - -#define CLEAR_SOLIB clear_solib - -extern void clear_solib (void); - -/* Called to add symbols from a shared library to gdb's symbol table. */ - -#define SOLIB_ADD(filename, from_tty, targ, readsyms) \ - solib_add (filename, from_tty, targ, readsyms) - -extern void solib_add (char *, int, struct target_ops *, int); - -/* 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. */ - -#define SOLIB_CREATE_INFERIOR_HOOK(PID) solib_create_inferior_hook() - -/* Function to be called to remove the connection between debugger and - dynamic linker that was established by SOLIB_CREATE_INFERIOR_HOOK. - (This operation does not remove shared library information from - the debugger, as CLEAR_SOLIB does.) - - This functionality is presently not implemented for this target. - */ -#define SOLIB_REMOVE_INFERIOR_HOOK(PID) (0) - -extern void solib_create_inferior_hook (void); /* solib.c */ +#include "symfile-add-flags.h" -/* This function is called by the "catch load" command. It allows - the debugger to be notified by the dynamic linker when a specified - library file (or any library file, if filename is NULL) is loaded. +/* List of known shared objects */ +#define so_list_head current_program_space->so_list - Presently, this functionality is not implemented. - */ -#define SOLIB_CREATE_CATCH_LOAD_HOOK(pid,tempflag,filename,cond_string) \ - error("catch of library loads/unloads not yet implemented on this platform") - -/* This function is called by the "catch unload" command. It allows - the debugger to be notified by the dynamic linker when a specified - library file (or any library file, if filename is NULL) is unloaded. - - Presently, this functionality is not implemented. - */ -#define SOLIB_CREATE_CATCH_UNLOAD_HOOK(pid,tempflag,filename,cond_string) \ - error("catch of library loads/unloads not yet implemented on this platform") - -/* This function returns TRUE if the dynamic linker has just reported - a load of a library. - - This function must be used only when the inferior has stopped in - the dynamic linker hook, or undefined results are guaranteed. - - Presently, this functionality is not implemented. - */ - -/* - #define SOLIB_HAVE_LOAD_EVENT(pid) \ - error("catch of library loads/unloads not yet implemented on this platform") - */ +/* Called when we free all symtabs, to free the shared library information + as well. */ -#define SOLIB_HAVE_LOAD_EVENT(pid) \ -(0) +extern void clear_solib (void); -/* This function returns a pointer to the string representation of the - pathname of the dynamically-linked library that has just been loaded. +/* Called to add symbols from a shared library to gdb's symbol table. */ - This function must be used only when SOLIB_HAVE_LOAD_EVENT is TRUE, - or undefined results are guaranteed. +extern void solib_add (const char *, int, int); +extern bool solib_read_symbols (struct so_list *, symfile_add_flags); - This string's contents are only valid immediately after the inferior - has stopped in the dynamic linker hook, and becomes invalid as soon - as the inferior is continued. Clients should make a copy of this - string if they wish to continue the inferior and then access the string. +/* 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. */ - Presently, this functionality is not implemented. - */ +extern void solib_create_inferior_hook (int from_tty); -/* - #define SOLIB_LOADED_LIBRARY_PATHNAME(pid) \ - error("catch of library loads/unloads not yet implemented on this platform") - */ +/* If ADDR lies in a shared library, return its name. */ -#define SOLIB_LOADED_LIBRARY_PATHNAME(pid) \ -(0) +extern char *solib_name_from_address (struct program_space *, CORE_ADDR); -/* This function returns TRUE if the dynamic linker has just reported - an unload of a library. +/* Return true if ADDR lies within SOLIB. */ - This function must be used only when the inferior has stopped in - the dynamic linker hook, or undefined results are guaranteed. +extern bool solib_contains_address_p (const struct so_list *, CORE_ADDR); - Presently, this functionality is not implemented. - */ -/* - #define SOLIB_HAVE_UNLOAD_EVENT(pid) \ - error("catch of library loads/unloads not yet implemented on this platform") - */ +/* 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). */ -#define SOLIB_HAVE_UNLOAD_EVENT(pid) \ -(0) +extern bool solib_keep_data_in_core (CORE_ADDR vaddr, unsigned long size); -/* This function returns a pointer to the string representation of the - pathname of the dynamically-linked library that has just been unloaded. +/* Return true if PC lies in the dynamic symbol resolution code of the + run time loader. */ - This function must be used only when SOLIB_HAVE_UNLOAD_EVENT is TRUE, - or undefined results are guaranteed. +extern bool in_solib_dynsym_resolve_code (CORE_ADDR); - This string's contents are only valid immediately after the inferior - has stopped in the dynamic linker hook, and becomes invalid as soon - as the inferior is continued. Clients should make a copy of this - string if they wish to continue the inferior and then access the string. +/* Discard symbols that were auto-loaded from shared libraries. */ - Presently, this functionality is not implemented. - */ -/* - #define SOLIB_UNLOADED_LIBRARY_PATHNAME(pid) \ - error("catch of library loads/unloads not yet implemented on this platform") - */ +extern void no_shared_libraries (const char *ignored, int from_tty); -#define SOLIB_UNLOADED_LIBRARY_PATHNAME(pid) \ -(0) +/* Set the solib operations for GDBARCH to NEW_OPS. */ -/* This function returns TRUE if pc is the address of an instruction that - lies within the dynamic linker (such as the event hook, or the dld - itself). +extern void set_solib_ops (struct gdbarch *gdbarch, + const struct target_so_ops *new_ops); - This function must be used only when a dynamic linker event has been - caught, and the inferior is being stepped out of the hook, or undefined - results are guaranteed. +/* Synchronize GDB's shared object list with inferior's. - Presently, this functionality is not implemented. - */ + 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. -/* - #define SOLIB_IN_DYNAMIC_LINKER(pid,pc) \ - error("catch of library loads/unloads not yet implemented on this platform") - */ + If we notice that the inferior has unloaded some shared objects, + free any symbolic info GDB had read about those shared objects. -#define SOLIB_IN_DYNAMIC_LINKER(pid,pc) \ -(0) + Don't load symbolic info for any new shared objects; just add them + to the list, and leave their symbols_loaded flag clear. -/* This function must be called when the inferior is killed, and the program - restarted. This is not the same as CLEAR_SOLIB, in that it doesn't discard - any symbol tables. + If FROM_TTY is non-null, feel free to print messages about what + we're doing. */ - Presently, this functionality is not implemented. - */ -#define SOLIB_RESTART() \ - (0) +extern void update_solib_list (int from_tty); -/* If we can't set a breakpoint, and it's in a shared library, just - disable it. */ +/* Return true if NAME is the libpthread shared library. */ -#define DISABLE_UNSETTABLE_BREAK(addr) (solib_address(addr) != NULL) +extern bool libpthread_name_p (const char *name); -extern char *solib_address (CORE_ADDR); /* solib.c */ +/* Look up symbol from both symbol table and dynamic string table. */ -/* If ADDR lies in a shared library, return its name. */ +extern CORE_ADDR gdb_bfd_lookup_symbol (bfd *abfd, + int (*match_sym) (const asymbol *, + const void *), + const void *data); -#define PC_SOLIB(addr) solib_address (addr) +/* Look up symbol from symbol table. */ -/* Return 1 if PC lies in the dynamic symbol resolution code of the - run time loader. */ +extern CORE_ADDR gdb_bfd_lookup_symbol_from_symtab (bfd *abfd, + int (*match_sym) + (const asymbol *, + const void *), + const void *data); -#define IN_SOLIB_DYNSYM_RESOLVE_CODE(pc) in_solib_dynsym_resolve_code (pc) +/* Enable or disable optional solib event breakpoints as appropriate. */ -extern int in_solib_dynsym_resolve_code (CORE_ADDR); /* solib.c */ +extern void update_solib_breakpoints (void); -/* Discard symbols that were auto-loaded from shared libraries. */ +/* Handle an solib event by calling solib_add. */ -extern void no_shared_libraries (char *ignored, int from_tty); +extern void handle_solib_event (void); #endif /* SOLIB_H */