/* Shared library declarations for GDB, the GNU Debugger.
- Copyright (C) 1992, 1998 Free Software Foundation, Inc.
+
+ Copyright (C) 1992-2019 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., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. */
+ You should have received a copy of the GNU General Public License
+ along with this program. If not, see <http://www.gnu.org/licenses/>. */
-#ifdef __STDC__ /* Forward decl's for prototypes */
-struct target_ops;
-#endif
-
-/* Called when we free all symtabs, to free the shared library information
- as well. */
-
-#define CLEAR_SOLIB clear_solib
-
-extern void
-clear_solib PARAMS ((void));
-
-/* Called to add symbols from a shared library to gdb's symbol table. */
-
-#define SOLIB_ADD(filename, from_tty, targ) \
- solib_add (filename, from_tty, targ)
-
-extern void
-solib_add PARAMS ((char *, int, struct target_ops *));
-
-/* 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()
+#ifndef SOLIB_H
+#define SOLIB_H
-/* 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 PARAMS((void)); /* solib.c */
-
-/* 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.
-
- 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")
+/* Forward decl's for prototypes */
+struct so_list;
+struct target_ops;
+struct target_so_ops;
+struct program_space;
-/* This function returns TRUE if the dynamic linker has just reported
- a load of a library.
+#include "symfile-add-flags.h"
- This function must be used only when the inferior has stopped in
- the dynamic linker hook, or undefined results are guaranteed.
+/* List of known shared objects */
+#define so_list_head current_program_space->so_list
- Presently, this functionality is not implemented.
- */
+/* Called when we free all symtabs, to free the shared library information
+ as well. */
-/*
-#define SOLIB_HAVE_LOAD_EVENT(pid) \
- error("catch of library loads/unloads not yet implemented on this platform")
-*/
+extern void clear_solib (void);
-#define SOLIB_HAVE_LOAD_EVENT(pid) \
-(0)
+/* Called to add symbols from a shared library to gdb's symbol table. */
-/* This function returns a pointer to the string representation of the
- pathname of the dynamically-linked library that has just been loaded.
+extern void solib_add (const char *, int, int);
+extern bool solib_read_symbols (struct so_list *, symfile_add_flags);
- This function must be used only when SOLIB_HAVE_LOAD_EVENT is TRUE,
- or undefined results are guaranteed.
+/* 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. */
- 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.
+extern void solib_create_inferior_hook (int from_tty);
- Presently, this functionality is not implemented.
- */
+/* If ADDR lies in a shared library, return its name. */
-/*
-#define SOLIB_LOADED_LIBRARY_PATHNAME(pid) \
- error("catch of library loads/unloads not yet implemented on this platform")
-*/
+extern char *solib_name_from_address (struct program_space *, CORE_ADDR);
-#define SOLIB_LOADED_LIBRARY_PATHNAME(pid) \
-(0)
+/* Return true if ADDR lies within SOLIB. */
-/* This function returns TRUE if the dynamic linker has just reported
- an unload of a library.
+extern bool solib_contains_address_p (const struct so_list *, CORE_ADDR);
- This function must be used only when the inferior has stopped in
- the dynamic linker hook, or undefined results are guaranteed.
+/* 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). */
- Presently, this functionality is not implemented.
- */
-/*
-#define SOLIB_HAVE_UNLOAD_EVENT(pid) \
- error("catch of library loads/unloads not yet implemented on this platform")
-*/
+extern bool solib_keep_data_in_core (CORE_ADDR vaddr, unsigned long size);
-#define SOLIB_HAVE_UNLOAD_EVENT(pid) \
-(0)
+/* Return true if PC lies in the dynamic symbol resolution code of the
+ run time loader. */
-/* This function returns a pointer to the string representation of the
- pathname of the dynamically-linked library that has just been unloaded.
+extern bool in_solib_dynsym_resolve_code (CORE_ADDR);
- This function must be used only when SOLIB_HAVE_UNLOAD_EVENT is TRUE,
- or undefined results are guaranteed.
+/* Discard symbols that were auto-loaded from shared libraries. */
- 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.
+extern void no_shared_libraries (const char *ignored, int from_tty);
- Presently, this functionality is not implemented.
- */
-/*
-#define SOLIB_UNLOADED_LIBRARY_PATHNAME(pid) \
- error("catch of library loads/unloads not yet implemented on this platform")
-*/
+/* Set the solib operations for GDBARCH to NEW_OPS. */
-#define SOLIB_UNLOADED_LIBRARY_PATHNAME(pid) \
-(0)
+extern void set_solib_ops (struct gdbarch *gdbarch,
+ const struct target_so_ops *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).
+/* Synchronize GDB's shared object list with inferior's.
- 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.
+ 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.
- Presently, this functionality is not implemented.
- */
+ 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) \
- error("catch of library loads/unloads not yet implemented on this platform")
-*/
+ Don't load symbolic info for any new shared objects; just add them
+ to the list, and leave their symbols_loaded flag clear.
-#define SOLIB_IN_DYNAMIC_LINKER(pid,pc) \
-(0)
+ If FROM_TTY is non-null, feel free to print messages about what
+ we're doing. */
-/* 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.
+extern void update_solib_list (int from_tty);
- Presently, this functionality is not implemented.
- */
-#define SOLIB_RESTART() \
- (0)
+/* Return true if NAME is the libpthread shared library. */
-/* If we can't set a breakpoint, and it's in a shared library, just
- disable it. */
+extern bool libpthread_name_p (const char *name);
-#define DISABLE_UNSETTABLE_BREAK(addr) (solib_address(addr) != NULL)
+/* Look up symbol from both symbol table and dynamic string table. */
-extern char *
-solib_address PARAMS ((CORE_ADDR)); /* solib.c */
+extern CORE_ADDR gdb_bfd_lookup_symbol (bfd *abfd,
+ int (*match_sym) (const asymbol *,
+ const void *),
+ const void *data);
-/* If ADDR lies in a shared library, return its name. */
+/* Look up symbol from symbol table. */
-#define PC_SOLIB(addr) solib_address (addr)
+extern CORE_ADDR gdb_bfd_lookup_symbol_from_symtab (bfd *abfd,
+ int (*match_sym)
+ (const asymbol *,
+ const void *),
+ const void *data);
-#ifdef SVR4_SHARED_LIBS
+/* Enable or disable optional solib event breakpoints as appropriate. */
-/* Return 1 if PC lies in the dynamic symbol resolution code of the
- SVR4 run time loader. */
+extern void update_solib_breakpoints (void);
-#define IN_SOLIB_DYNSYM_RESOLVE_CODE(pc) in_svr4_dynsym_resolve_code (pc)
+/* Handle an solib event by calling solib_add. */
-extern int
-in_svr4_dynsym_resolve_code PARAMS ((CORE_ADDR));
+extern void handle_solib_event (void);
-#endif
+#endif /* SOLIB_H */