]>
Commit | Line | Data |
---|---|---|
c906108c | 1 | /* Shared library declarations for GDB, the GNU Debugger. |
fcb335b0 | 2 | |
213516ef | 3 | Copyright (C) 1992-2023 Free Software Foundation, Inc. |
c906108c | 4 | |
c5aa993b | 5 | This file is part of GDB. |
c906108c | 6 | |
c5aa993b JM |
7 | This program is free software; you can redistribute it and/or modify |
8 | it under the terms of the GNU General Public License as published by | |
a9762ec7 | 9 | the Free Software Foundation; either version 3 of the License, or |
c5aa993b | 10 | (at your option) any later version. |
c906108c | 11 | |
c5aa993b JM |
12 | This program is distributed in the hope that it will be useful, |
13 | but WITHOUT ANY WARRANTY; without even the implied warranty of | |
14 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
15 | GNU General Public License for more details. | |
c906108c | 16 | |
c5aa993b | 17 | You should have received a copy of the GNU General Public License |
a9762ec7 | 18 | along with this program. If not, see <http://www.gnu.org/licenses/>. */ |
c906108c | 19 | |
010f3b2f JT |
20 | #ifndef SOLIB_H |
21 | #define SOLIB_H | |
22 | ||
104c1213 | 23 | /* Forward decl's for prototypes */ |
42a6e6a0 | 24 | struct so_list; |
c906108c | 25 | struct target_ops; |
7d522c90 | 26 | struct target_so_ops; |
6c95b8df | 27 | struct program_space; |
c906108c | 28 | |
fcb335b0 | 29 | #include "gdb_bfd.h" |
b15cc25c PA |
30 | #include "symfile-add-flags.h" |
31 | ||
e26d0dab SM |
32 | /* Value of the 'set debug solib' configuration variable. */ |
33 | ||
34 | extern bool debug_solib; | |
35 | ||
36 | /* Print an "solib" debug statement. */ | |
37 | ||
38 | #define solib_debug_printf(fmt, ...) \ | |
39 | debug_prefixed_printf_cond (debug_solib, "solib", fmt, ##__VA_ARGS__) | |
40 | ||
41 | #define SOLIB_SCOPED_DEBUG_START_END(fmt, ...) \ | |
42 | scoped_debug_start_end (debug_solib, "solib", fmt, ##__VA_ARGS__) | |
43 | ||
c906108c | 44 | /* Called when we free all symtabs, to free the shared library information |
c378eb4e | 45 | as well. */ |
c906108c | 46 | |
a14ed312 | 47 | extern void clear_solib (void); |
c906108c | 48 | |
c378eb4e | 49 | /* Called to add symbols from a shared library to gdb's symbol table. */ |
c906108c | 50 | |
e696b3ad | 51 | extern void solib_add (const char *, int, int); |
5b89c67a | 52 | extern bool solib_read_symbols (struct so_list *, symfile_add_flags); |
c906108c | 53 | |
7095b863 MS |
54 | /* Function to be called when the inferior starts up, to discover the |
55 | names of shared libraries that are dynamically linked, the base | |
56 | addresses to which they are linked, and sufficient information to | |
57 | read in their symbols at a later time. */ | |
c906108c | 58 | |
268a4a75 | 59 | extern void solib_create_inferior_hook (int from_tty); |
c906108c SS |
60 | |
61 | /* If ADDR lies in a shared library, return its name. */ | |
62 | ||
6d08aed3 | 63 | extern const char *solib_name_from_address (struct program_space *, CORE_ADDR); |
c906108c | 64 | |
5b89c67a | 65 | /* Return true if ADDR lies within SOLIB. */ |
5fd1a349 | 66 | |
5b89c67a | 67 | extern bool solib_contains_address_p (const struct so_list *, CORE_ADDR); |
5fd1a349 | 68 | |
de18c1d8 JM |
69 | /* Return whether the data starting at VADDR, size SIZE, must be kept |
70 | in a core file for shared libraries loaded before "gcore" is used | |
71 | to be handled correctly when the core file is loaded. This only | |
72 | applies when the section would otherwise not be kept in the core | |
73 | file (in particular, for readonly sections). */ | |
74 | ||
5b89c67a | 75 | extern bool solib_keep_data_in_core (CORE_ADDR vaddr, unsigned long size); |
de18c1d8 | 76 | |
5b89c67a | 77 | /* Return true if PC lies in the dynamic symbol resolution code of the |
d7fa2ae2 | 78 | run time loader. */ |
c906108c | 79 | |
5b89c67a | 80 | extern bool in_solib_dynsym_resolve_code (CORE_ADDR); |
1dd1751e | 81 | |
c378eb4e | 82 | /* Discard symbols that were auto-loaded from shared libraries. */ |
cb0ba49e | 83 | |
0b39b52e | 84 | extern void no_shared_libraries (const char *ignored, int from_tty); |
010f3b2f | 85 | |
51457a05 MAL |
86 | /* Synchronize GDB's shared object list with inferior's. |
87 | ||
88 | Extract the list of currently loaded shared objects from the | |
a1fd1ac9 TT |
89 | inferior, and compare it with the list of shared objects in the |
90 | current program space's list of shared libraries. Edit | |
91 | so_list_head to bring it in sync with the inferior's new list. | |
51457a05 MAL |
92 | |
93 | If we notice that the inferior has unloaded some shared objects, | |
94 | free any symbolic info GDB had read about those shared objects. | |
95 | ||
96 | Don't load symbolic info for any new shared objects; just add them | |
97 | to the list, and leave their symbols_loaded flag clear. | |
98 | ||
99 | If FROM_TTY is non-null, feel free to print messages about what | |
100 | we're doing. */ | |
101 | ||
102 | extern void update_solib_list (int from_tty); | |
103 | ||
5b89c67a | 104 | /* Return true if NAME is the libpthread shared library. */ |
17a37d48 | 105 | |
5b89c67a | 106 | extern bool libpthread_name_p (const char *name); |
17a37d48 | 107 | |
cb457ae2 YQ |
108 | /* Look up symbol from both symbol table and dynamic string table. */ |
109 | ||
110 | extern CORE_ADDR gdb_bfd_lookup_symbol (bfd *abfd, | |
3953f15c SM |
111 | int (*match_sym) (const asymbol *, |
112 | const void *), | |
113 | const void *data); | |
cb457ae2 YQ |
114 | |
115 | /* Look up symbol from symbol table. */ | |
116 | ||
e009ee71 | 117 | extern CORE_ADDR gdb_bfd_lookup_symbol_from_symtab (bfd *abfd, |
3953f15c SM |
118 | int (*match_sym) |
119 | (const asymbol *, | |
120 | const void *), | |
121 | const void *data); | |
cb457ae2 | 122 | |
8ddf4645 AM |
123 | /* Scan for DESIRED_DYNTAG in .dynamic section of ABFD. If DESIRED_DYNTAG is |
124 | found, 1 is returned and the corresponding PTR and PTR_ADDR are set. */ | |
125 | ||
126 | extern int gdb_bfd_scan_elf_dyntag (const int desired_dyntag, bfd *abfd, | |
127 | CORE_ADDR *ptr, CORE_ADDR *ptr_addr); | |
128 | ||
39f53acb AM |
129 | /* If FILENAME refers to an ELF shared object then attempt to return the |
130 | string referred to by its DT_SONAME tag. */ | |
131 | ||
132 | extern gdb::unique_xmalloc_ptr<char> gdb_bfd_read_elf_soname | |
133 | (const char *filename); | |
134 | ||
f9e14852 GB |
135 | /* Enable or disable optional solib event breakpoints as appropriate. */ |
136 | ||
137 | extern void update_solib_breakpoints (void); | |
138 | ||
139 | /* Handle an solib event by calling solib_add. */ | |
140 | ||
141 | extern void handle_solib_event (void); | |
142 | ||
39f53acb AM |
143 | /* Associate SONAME with BUILD_ID in ABFD's registry so that it can be |
144 | retrieved with get_cbfd_soname_build_id. */ | |
145 | ||
146 | extern void set_cbfd_soname_build_id (gdb_bfd_ref_ptr abfd, | |
147 | const char *soname, | |
148 | const bfd_build_id *build_id); | |
149 | ||
150 | /* If SONAME had a build-id associated with it in ABFD's registry by a | |
151 | previous call to set_cbfd_soname_build_id then return the build-id | |
152 | as a NULL-terminated hex string. */ | |
153 | ||
154 | extern gdb::unique_xmalloc_ptr<char> get_cbfd_soname_build_id | |
155 | (gdb_bfd_ref_ptr abfd, const char *soname); | |
156 | ||
010f3b2f | 157 | #endif /* SOLIB_H */ |