Commit | Line | Data |
---|---|---|
c35384fb TT |
1 | /* Minimal symbol table definitions for GDB. |
2 | ||
42a4f53d | 3 | Copyright (C) 2011-2019 Free Software Foundation, Inc. |
c35384fb TT |
4 | |
5 | This file is part of GDB. | |
6 | ||
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 | |
9 | the Free Software Foundation; either version 3 of the License, or | |
10 | (at your option) any later version. | |
11 | ||
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. | |
16 | ||
17 | You should have received a copy of the GNU General Public License | |
18 | along with this program. If not, see <http://www.gnu.org/licenses/>. */ | |
19 | ||
20 | #ifndef MINSYMS_H | |
21 | #define MINSYMS_H | |
22 | ||
74ea4be4 PA |
23 | struct type; |
24 | ||
7cbd4a93 TT |
25 | /* Several lookup functions return both a minimal symbol and the |
26 | objfile in which it is found. This structure is used in these | |
27 | cases. */ | |
28 | ||
29 | struct bound_minimal_symbol | |
30 | { | |
31 | /* The minimal symbol that was found, or NULL if no minimal symbol | |
32 | was found. */ | |
33 | ||
34 | struct minimal_symbol *minsym; | |
35 | ||
36 | /* If MINSYM is not NULL, then this is the objfile in which the | |
37 | symbol is defined. */ | |
38 | ||
39 | struct objfile *objfile; | |
40 | }; | |
41 | ||
b19686e0 TT |
42 | /* This header declares most of the API for dealing with minimal |
43 | symbols and minimal symbol tables. A few things are declared | |
44 | elsewhere; see below. | |
c35384fb | 45 | |
b19686e0 TT |
46 | A minimal symbol is a symbol for which there is no direct debug |
47 | information. For example, for an ELF binary, minimal symbols are | |
48 | created from the ELF symbol table. | |
49 | ||
50 | For the definition of the minimal symbol structure, see struct | |
51 | minimal_symbol in symtab.h. | |
52 | ||
53 | Minimal symbols are stored in tables attached to an objfile; see | |
54 | objfiles.h for details. Code should generally treat these tables | |
55 | as opaque and use functions provided by minsyms.c to inspect them. | |
56 | */ | |
57 | ||
8dddcb8f TT |
58 | struct msym_bunch; |
59 | ||
873a915e TT |
60 | /* An RAII-based object that is used to record minimal symbols while |
61 | they are being read. */ | |
62 | class minimal_symbol_reader | |
63 | { | |
64 | public: | |
65 | ||
8dddcb8f TT |
66 | /* Prepare to start collecting minimal symbols. This should be |
67 | called by a symbol reader to initialize the minimal symbol | |
68 | module. */ | |
873a915e | 69 | |
d25e8719 | 70 | explicit minimal_symbol_reader (struct objfile *); |
873a915e TT |
71 | |
72 | ~minimal_symbol_reader (); | |
b19686e0 | 73 | |
873a915e TT |
74 | /* Install the minimal symbols that have been collected into the |
75 | given objfile. */ | |
b19686e0 | 76 | |
d25e8719 | 77 | void install (); |
b19686e0 | 78 | |
8dddcb8f TT |
79 | /* Record a new minimal symbol. This is the "full" entry point; |
80 | simpler convenience entry points are also provided below. | |
81 | ||
82 | This returns a new minimal symbol. It is ok to modify the returned | |
83 | minimal symbol (though generally not necessary). It is not ok, | |
84 | though, to stash the pointer anywhere; as minimal symbols may be | |
85 | moved after creation. The memory for the returned minimal symbol | |
86 | is still owned by the minsyms.c code, and should not be freed. | |
87 | ||
88 | Arguments are: | |
89 | ||
90 | NAME - the symbol's name | |
91 | NAME_LEN - the length of the name | |
92 | COPY_NAME - if true, the minsym code must make a copy of NAME. If | |
93 | false, then NAME must be NUL-terminated, and must have a lifetime | |
94 | that is at least as long as OBJFILE's lifetime. | |
95 | ADDRESS - the address of the symbol | |
96 | MS_TYPE - the type of the symbol | |
97 | SECTION - the symbol's section | |
ce6c454e | 98 | */ |
8dddcb8f TT |
99 | |
100 | struct minimal_symbol *record_full (const char *name, | |
101 | int name_len, | |
ce6c454e | 102 | bool copy_name, |
8dddcb8f TT |
103 | CORE_ADDR address, |
104 | enum minimal_symbol_type ms_type, | |
105 | int section); | |
106 | ||
107 | /* Like record_full, but: | |
108 | - uses strlen to compute NAME_LEN, | |
ce6c454e | 109 | - passes COPY_NAME = true, |
8dddcb8f TT |
110 | - and passes a default SECTION, depending on the type |
111 | ||
112 | This variant does not return the new symbol. */ | |
113 | ||
ce6c454e TT |
114 | void record (const char *name, CORE_ADDR address, |
115 | enum minimal_symbol_type ms_type); | |
8dddcb8f TT |
116 | |
117 | /* Like record_full, but: | |
118 | - uses strlen to compute NAME_LEN, | |
ce6c454e | 119 | - passes COPY_NAME = true. */ |
8dddcb8f TT |
120 | |
121 | struct minimal_symbol *record_with_info (const char *name, | |
122 | CORE_ADDR address, | |
123 | enum minimal_symbol_type ms_type, | |
124 | int section) | |
125 | { | |
ce6c454e | 126 | return record_full (name, strlen (name), true, address, ms_type, section); |
8dddcb8f TT |
127 | } |
128 | ||
873a915e TT |
129 | private: |
130 | ||
af9a2161 | 131 | DISABLE_COPY_AND_ASSIGN (minimal_symbol_reader); |
d25e8719 TT |
132 | |
133 | struct objfile *m_objfile; | |
b19686e0 | 134 | |
8dddcb8f TT |
135 | /* Bunch currently being filled up. |
136 | The next field points to chain of filled bunches. */ | |
137 | ||
138 | struct msym_bunch *m_msym_bunch; | |
139 | ||
140 | /* Number of slots filled in current bunch. */ | |
141 | ||
142 | int m_msym_bunch_index; | |
143 | ||
144 | /* Total number of minimal symbols recorded so far for the | |
145 | objfile. */ | |
146 | ||
147 | int m_msym_count; | |
148 | }; | |
c35384fb | 149 | |
b19686e0 TT |
150 | /* Create the terminating entry of OBJFILE's minimal symbol table. |
151 | If OBJFILE->msymbols is zero, allocate a single entry from | |
152 | OBJFILE->objfile_obstack; otherwise, just initialize | |
153 | OBJFILE->msymbols[OBJFILE->minimal_symbol_count]. */ | |
154 | ||
155 | void terminate_minimal_symbol_table (struct objfile *objfile); | |
156 | ||
b19686e0 TT |
157 | \f |
158 | ||
4024cf2b PA |
159 | /* Return whether MSYMBOL is a function/method. If FUNC_ADDRESS_P is |
160 | non-NULL, and the MSYMBOL is a function, then *FUNC_ADDRESS_P is | |
161 | set to the function's address, already resolved if MINSYM points to | |
162 | a function descriptor. */ | |
163 | ||
164 | bool msymbol_is_function (struct objfile *objfile, | |
165 | minimal_symbol *minsym, | |
166 | CORE_ADDR *func_address_p = NULL); | |
bf223d3e | 167 | |
b19686e0 | 168 | /* Compute a hash code for the string argument. */ |
c35384fb TT |
169 | |
170 | unsigned int msymbol_hash (const char *); | |
171 | ||
b19686e0 TT |
172 | /* Like msymbol_hash, but compute a hash code that is compatible with |
173 | strcmp_iw. */ | |
174 | ||
175 | unsigned int msymbol_hash_iw (const char *); | |
176 | ||
c35384fb TT |
177 | /* Compute the next hash value from previous HASH and the character C. This |
178 | is only a GDB in-memory computed value with no external files compatibility | |
179 | requirements. */ | |
180 | ||
181 | #define SYMBOL_HASH_NEXT(hash, c) \ | |
deeeba55 | 182 | ((hash) * 67 + TOLOWER ((unsigned char) (c)) - 113) |
c35384fb | 183 | |
b19686e0 TT |
184 | \f |
185 | ||
b19686e0 TT |
186 | /* Look through all the current minimal symbol tables and find the |
187 | first minimal symbol that matches NAME. If OBJF is non-NULL, limit | |
3b7344d5 TT |
188 | the search to that objfile. If SFILE is non-NULL, the only |
189 | file-scope symbols considered will be from that source file (global | |
190 | symbols are still preferred). Returns a bound minimal symbol that | |
191 | matches, or an empty bound minimal symbol if no match is found. */ | |
b19686e0 | 192 | |
3b7344d5 TT |
193 | struct bound_minimal_symbol lookup_minimal_symbol (const char *, |
194 | const char *, | |
195 | struct objfile *); | |
c35384fb | 196 | |
3b7344d5 TT |
197 | /* Like lookup_minimal_symbol, but searches all files and |
198 | objfiles. */ | |
7c7b6655 TT |
199 | |
200 | struct bound_minimal_symbol lookup_bound_minimal_symbol (const char *); | |
201 | ||
b19686e0 TT |
202 | /* Look through all the current minimal symbol tables and find the |
203 | first minimal symbol that matches NAME and has text type. If OBJF | |
3b7344d5 TT |
204 | is non-NULL, limit the search to that objfile. Returns a bound |
205 | minimal symbol that matches, or an "empty" bound minimal symbol | |
206 | otherwise. | |
b19686e0 TT |
207 | |
208 | This function only searches the mangled (linkage) names. */ | |
209 | ||
3b7344d5 TT |
210 | struct bound_minimal_symbol lookup_minimal_symbol_text (const char *, |
211 | struct objfile *); | |
c35384fb | 212 | |
b19686e0 TT |
213 | /* Look through all the current minimal symbol tables and find the |
214 | first minimal symbol that matches NAME and is a solib trampoline. | |
215 | If OBJF is non-NULL, limit the search to that objfile. Returns a | |
216 | pointer to the minimal symbol that matches, or NULL if no match is | |
217 | found. | |
218 | ||
219 | This function only searches the mangled (linkage) names. */ | |
220 | ||
3b7344d5 | 221 | struct bound_minimal_symbol lookup_minimal_symbol_solib_trampoline |
c35384fb TT |
222 | (const char *, |
223 | struct objfile *); | |
224 | ||
b19686e0 TT |
225 | /* Look through all the current minimal symbol tables and find the |
226 | first minimal symbol that matches NAME and PC. If OBJF is non-NULL, | |
227 | limit the search to that objfile. Returns a pointer to the minimal | |
228 | symbol that matches, or NULL if no match is found. */ | |
229 | ||
c35384fb | 230 | struct minimal_symbol *lookup_minimal_symbol_by_pc_name |
b19686e0 | 231 | (CORE_ADDR, const char *, struct objfile *); |
c35384fb | 232 | |
20944a6e PA |
233 | enum class lookup_msym_prefer |
234 | { | |
235 | /* Prefer mst_text symbols. */ | |
236 | TEXT, | |
237 | ||
238 | /* Prefer mst_solib_trampoline symbols when there are text and | |
239 | trampoline symbols at the same address. Otherwise prefer | |
240 | mst_text symbols. */ | |
241 | TRAMPOLINE, | |
242 | ||
243 | /* Prefer mst_text_gnu_ifunc symbols when there are text and ifunc | |
244 | symbols at the same address. Otherwise prefer mst_text | |
245 | symbols. */ | |
246 | GNU_IFUNC, | |
247 | }; | |
248 | ||
b19686e0 TT |
249 | /* Search through the minimal symbol table for each objfile and find |
250 | the symbol whose address is the largest address that is still less | |
251 | than or equal to PC, and which matches SECTION. | |
c35384fb | 252 | |
b19686e0 TT |
253 | If SECTION is NULL, this uses the result of find_pc_section |
254 | instead. | |
255 | ||
7cbd4a93 | 256 | The result has a non-NULL 'minsym' member if such a symbol is |
20944a6e PA |
257 | found, or NULL if PC is not in a suitable range. |
258 | ||
259 | See definition of lookup_msym_prefer for description of PREFER. By | |
260 | default mst_text symbols are preferred. */ | |
c35384fb | 261 | |
7cbd4a93 | 262 | struct bound_minimal_symbol lookup_minimal_symbol_by_pc_section |
20944a6e PA |
263 | (CORE_ADDR, |
264 | struct obj_section *, | |
265 | lookup_msym_prefer prefer = lookup_msym_prefer::TEXT); | |
c35384fb | 266 | |
b19686e0 TT |
267 | /* Backward compatibility: search through the minimal symbol table |
268 | for a matching PC (no section given). | |
269 | ||
270 | This is a wrapper that calls lookup_minimal_symbol_by_pc_section | |
271 | with a NULL section argument. */ | |
c35384fb | 272 | |
7cbd4a93 | 273 | struct bound_minimal_symbol lookup_minimal_symbol_by_pc (CORE_ADDR); |
c35384fb | 274 | |
b19686e0 TT |
275 | /* Iterate over all the minimal symbols in the objfile OBJF which |
276 | match NAME. Both the ordinary and demangled names of each symbol | |
277 | are considered. The caller is responsible for canonicalizing NAME, | |
278 | should that need to be done. | |
c35384fb | 279 | |
41c1efc6 TT |
280 | For each matching symbol, CALLBACK is called with the symbol. */ |
281 | ||
282 | void iterate_over_minimal_symbols | |
283 | (struct objfile *objf, const lookup_name_info &name, | |
ca31ab1d | 284 | gdb::function_view<bool (struct minimal_symbol *)> callback); |
c35384fb | 285 | |
50e65b17 TT |
286 | /* Compute the upper bound of MINSYM. The upper bound is the last |
287 | address thought to be part of the symbol. If the symbol has a | |
288 | size, it is used. Otherwise use the lesser of the next minimal | |
289 | symbol in the same section, or the end of the section, as the end | |
290 | of the function. */ | |
291 | ||
292 | CORE_ADDR minimal_symbol_upper_bound (struct bound_minimal_symbol minsym); | |
293 | ||
74ea4be4 PA |
294 | /* Return the type of MSYMBOL, a minimal symbol of OBJFILE. If |
295 | ADDRESS_P is not NULL, set it to the MSYMBOL's resolved | |
296 | address. */ | |
297 | ||
298 | type *find_minsym_type_and_address (minimal_symbol *msymbol, objfile *objf, | |
299 | CORE_ADDR *address_p); | |
300 | ||
c35384fb | 301 | #endif /* MINSYMS_H */ |