/* 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 <http://www.gnu.org/licenses/>. */
-#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 */