]> git.ipfire.org Git - thirdparty/binutils-gdb.git/blame - gdb/solib.c
gdb/solib: Refactor scan_dyntag
[thirdparty/binutils-gdb.git] / gdb / solib.c
CommitLineData
13437d4b 1/* Handle shared libraries for GDB, the GNU Debugger.
14a5e767 2
3666a048 3 Copyright (C) 1990-2021 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.
16
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
c906108c
SS
20#include "defs.h"
21
c906108c 22#include <sys/types.h>
c906108c 23#include <fcntl.h>
c906108c
SS
24#include "symtab.h"
25#include "bfd.h"
26#include "symfile.h"
27#include "objfiles.h"
28#include "gdbcore.h"
29#include "command.h"
30#include "target.h"
31#include "frame.h"
88987551 32#include "gdb_regex.h"
c906108c 33#include "inferior.h"
268a13a5 34#include "gdbsupport/environ.h"
c906108c
SS
35#include "language.h"
36#include "gdbcmd.h"
fa58ee11 37#include "completer.h"
8ddf4645
AM
38#include "elf/external.h"
39#include "elf/common.h"
fe4e3eb8 40#include "filenames.h" /* for DOSish file names */
4646aa9d 41#include "exec.h"
13437d4b 42#include "solist.h"
76727919 43#include "observable.h"
e0eac551 44#include "readline/tilde.h"
f1838a98 45#include "remote.h"
2c0b251b 46#include "solib.h"
55333a84 47#include "interps.h"
ab38a727 48#include "filesystem.h"
cbb099e8 49#include "gdb_bfd.h"
268a13a5 50#include "gdbsupport/filestuff.h"
b46a8d7c 51#include "source.h"
e43b10e1 52#include "cli/cli-style.h"
c906108c 53
66aba65d
MK
54/* Architecture-specific operations. */
55
56/* Per-architecture data key. */
57static struct gdbarch_data *solib_data;
58
59static void *
60solib_init (struct obstack *obstack)
61{
62 struct target_so_ops **ops;
63
64 ops = OBSTACK_ZALLOC (obstack, struct target_so_ops *);
65 *ops = current_target_so_ops;
66 return ops;
67}
68
3641da11 69static const struct target_so_ops *
66aba65d
MK
70solib_ops (struct gdbarch *gdbarch)
71{
19ba03f4
SM
72 const struct target_so_ops **ops
73 = (const struct target_so_ops **) gdbarch_data (gdbarch, solib_data);
433759f7 74
66aba65d
MK
75 return *ops;
76}
7d522c90
DJ
77
78/* Set the solib operations for GDBARCH to NEW_OPS. */
79
80void
3641da11 81set_solib_ops (struct gdbarch *gdbarch, const struct target_so_ops *new_ops)
7d522c90 82{
19ba03f4
SM
83 const struct target_so_ops **ops
84 = (const struct target_so_ops **) gdbarch_data (gdbarch, solib_data);
433759f7 85
7d522c90
DJ
86 *ops = new_ops;
87}
66aba65d
MK
88\f
89
13437d4b 90/* external data declarations */
c906108c 91
7d522c90
DJ
92/* FIXME: gdbarch needs to control this variable, or else every
93 configuration needs to call set_solib_ops. */
13437d4b 94struct target_so_ops *current_target_so_ops;
23e04971 95
c906108c
SS
96/* Local function prototypes */
97
c906108c
SS
98/* If non-empty, this is a search path for loading non-absolute shared library
99 symbol files. This takes precedence over the environment variables PATH
100 and LD_LIBRARY_PATH. */
101static char *solib_search_path = NULL;
920d2a44
AC
102static void
103show_solib_search_path (struct ui_file *file, int from_tty,
104 struct cmd_list_element *c, const char *value)
105{
3e43a32a
MS
106 fprintf_filtered (file, _("The search path for loading non-absolute "
107 "shared library symbol files is %s.\n"),
920d2a44
AC
108 value);
109}
c906108c 110
ab38a727
PA
111/* Same as HAVE_DOS_BASED_FILE_SYSTEM, but useable as an rvalue. */
112#if (HAVE_DOS_BASED_FILE_SYSTEM)
113# define DOS_BASED_FILE_SYSTEM 1
114#else
115# define DOS_BASED_FILE_SYSTEM 0
116#endif
117
797bc1cb
TT
118/* Return the full pathname of a binary file (the main executable or a
119 shared library file), or NULL if not found. If FD is non-NULL, *FD
120 is set to either -1 or an open file handle for the binary file.
e4f7b8c8 121
f822c95b 122 Global variable GDB_SYSROOT is used as a prefix directory
af1900b0 123 to search for binary files if they have an absolute path.
b57fbfba
GB
124 If GDB_SYSROOT starts with "target:" and target filesystem
125 is the local filesystem then the "target:" prefix will be
126 stripped before the search starts. This ensures that the
127 same search algorithm is used for local files regardless of
128 whether a "target:" prefix was used.
e4f7b8c8
MS
129
130 Global variable SOLIB_SEARCH_PATH is used as a prefix directory
131 (or set of directories, as in LD_LIBRARY_PATH) to search for all
b57fbfba 132 shared libraries if not found in either the sysroot (if set) or
af1900b0
GB
133 the local filesystem. SOLIB_SEARCH_PATH is not used when searching
134 for the main executable.
e4f7b8c8 135
c8c18e65 136 Search algorithm:
b57fbfba
GB
137 * If a sysroot is set and path is absolute:
138 * Search for sysroot/path.
c8c18e65
KW
139 * else
140 * Look for it literally (unmodified).
af1900b0
GB
141 * If IS_SOLIB is non-zero:
142 * Look in SOLIB_SEARCH_PATH.
143 * If available, use target defined search function.
b57fbfba 144 * If NO sysroot is set, perform the following two searches:
c8c18e65 145 * Look in inferior's $PATH.
af1900b0
GB
146 * If IS_SOLIB is non-zero:
147 * Look in inferior's $LD_LIBRARY_PATH.
ab38a727 148 *
85102364 149 * The last check avoids doing this search when targeting remote
b57fbfba 150 * machines since a sysroot will almost always be set.
7f86f058 151*/
e4f7b8c8 152
797bc1cb 153static gdb::unique_xmalloc_ptr<char>
5b89c67a 154solib_find_1 (const char *in_pathname, int *fd, bool is_solib)
e4f7b8c8 155{
3641da11 156 const struct target_so_ops *ops = solib_ops (target_gdbarch ());
e4f7b8c8 157 int found_file = -1;
e0cc99a6 158 gdb::unique_xmalloc_ptr<char> temp_pathname;
ab38a727 159 const char *fskind = effective_target_file_system_kind ();
9a897d43 160 const char *sysroot = gdb_sysroot;
f8773be1 161 int prefix_len, orig_prefix_len;
08105857 162
a3be80c3
GB
163 /* If the absolute prefix starts with "target:" but the filesystem
164 accessed by the target_fileio_* methods is the local filesystem
165 then we strip the "target:" prefix now and work with the local
166 filesystem. This ensures that the same search algorithm is used
167 for all local files regardless of whether a "target:" prefix was
168 used. */
169 if (is_target_filename (sysroot) && target_filesystem_is_local ())
170 sysroot += strlen (TARGET_SYSROOT_PREFIX);
171
f8773be1
GB
172 /* Strip any trailing slashes from the absolute prefix. */
173 prefix_len = orig_prefix_len = strlen (sysroot);
f1d10cfb 174
f8773be1
GB
175 while (prefix_len > 0 && IS_DIR_SEPARATOR (sysroot[prefix_len - 1]))
176 prefix_len--;
f1d10cfb 177
9a897d43 178 std::string sysroot_holder;
f8773be1
GB
179 if (prefix_len == 0)
180 sysroot = NULL;
181 else if (prefix_len != orig_prefix_len)
182 {
9a897d43
TT
183 sysroot_holder = std::string (sysroot, prefix_len);
184 sysroot = sysroot_holder.c_str ();
ab38a727
PA
185 }
186
187 /* If we're on a non-DOS-based system, backslashes won't be
188 understood as directory separator, so, convert them to forward
189 slashes, iff we're supposed to handle DOS-based file system
190 semantics for target paths. */
191 if (!DOS_BASED_FILE_SYSTEM && fskind == file_system_kind_dos_based)
192 {
193 char *p;
194
195 /* Avoid clobbering our input. */
224c3ddb 196 p = (char *) alloca (strlen (in_pathname) + 1);
ab38a727
PA
197 strcpy (p, in_pathname);
198 in_pathname = p;
199
200 for (; *p; p++)
201 {
202 if (*p == '\\')
203 *p = '/';
204 }
205 }
206
207 /* Note, we're interested in IS_TARGET_ABSOLUTE_PATH, not
208 IS_ABSOLUTE_PATH. The latter is for host paths only, while
209 IN_PATHNAME is a target path. For example, if we're supposed to
210 be handling DOS-like semantics we want to consider a
211 'c:/foo/bar.dll' path as an absolute path, even on a Unix box.
212 With such a path, before giving up on the sysroot, we'll try:
213
214 1st attempt, c:/foo/bar.dll ==> /sysroot/c:/foo/bar.dll
215 2nd attempt, c:/foo/bar.dll ==> /sysroot/c/foo/bar.dll
216 3rd attempt, c:/foo/bar.dll ==> /sysroot/foo/bar.dll
217 */
218
b57fbfba 219 if (!IS_TARGET_ABSOLUTE_PATH (fskind, in_pathname) || sysroot == NULL)
e0cc99a6 220 temp_pathname.reset (xstrdup (in_pathname));
ab38a727
PA
221 else
222 {
5b89c67a 223 bool need_dir_separator;
ab38a727 224
3736004f
PA
225 /* Concatenate the sysroot and the target reported filename. We
226 may need to glue them with a directory separator. Cases to
227 consider:
228
dda83cd7
SM
229 | sysroot | separator | in_pathname |
230 |-----------------+-----------+----------------|
231 | /some/dir | / | c:/foo/bar.dll |
232 | /some/dir | | /foo/bar.dll |
233 | target: | | c:/foo/bar.dll |
234 | target: | | /foo/bar.dll |
235 | target:some/dir | / | c:/foo/bar.dll |
236 | target:some/dir | | /foo/bar.dll |
3736004f
PA
237
238 IOW, we don't need to add a separator if IN_PATHNAME already
6471e7d2 239 has one, or when the sysroot is exactly "target:".
3736004f
PA
240 There's no need to check for drive spec explicitly, as we only
241 get here if IN_PATHNAME is considered an absolute path. */
242 need_dir_separator = !(IS_DIR_SEPARATOR (in_pathname[0])
2938e6cf 243 || strcmp (TARGET_SYSROOT_PREFIX, sysroot) == 0);
ab38a727 244
f1d10cfb 245 /* Cat the prefixed pathname together. */
e0cc99a6
TT
246 temp_pathname.reset (concat (sysroot,
247 need_dir_separator ? SLASH_STRING : "",
248 in_pathname, (char *) NULL));
e4f7b8c8
MS
249 }
250
2938e6cf 251 /* Handle files to be accessed via the target. */
e0cc99a6 252 if (is_target_filename (temp_pathname.get ()))
f1838a98 253 {
998d2a3e
GB
254 if (fd != NULL)
255 *fd = -1;
e0cc99a6 256 return temp_pathname;
f1838a98
UW
257 }
258
f1d10cfb 259 /* Now see if we can open it. */
e0cc99a6 260 found_file = gdb_open_cloexec (temp_pathname.get (), O_RDONLY | O_BINARY, 0);
ab38a727
PA
261
262 /* If the search in gdb_sysroot failed, and the path name has a
263 drive spec (e.g, c:/foo), try stripping ':' from the drive spec,
264 and retrying in the sysroot:
265 c:/foo/bar.dll ==> /sysroot/c/foo/bar.dll. */
f1d10cfb 266
ab38a727 267 if (found_file < 0
b57fbfba 268 && sysroot != NULL
ab38a727
PA
269 && HAS_TARGET_DRIVE_SPEC (fskind, in_pathname))
270 {
5b89c67a 271 bool need_dir_separator = !IS_DIR_SEPARATOR (in_pathname[2]);
e0cc99a6 272 char drive[2] = { in_pathname[0], '\0' };
ab38a727 273
e0cc99a6
TT
274 temp_pathname.reset (concat (sysroot,
275 SLASH_STRING,
276 drive,
277 need_dir_separator ? SLASH_STRING : "",
278 in_pathname + 2, (char *) NULL));
ab38a727 279
e0cc99a6
TT
280 found_file = gdb_open_cloexec (temp_pathname.get (),
281 O_RDONLY | O_BINARY, 0);
ab38a727
PA
282 if (found_file < 0)
283 {
ab38a727
PA
284 /* If the search in gdb_sysroot still failed, try fully
285 stripping the drive spec, and trying once more in the
286 sysroot before giving up.
287
288 c:/foo/bar.dll ==> /sysroot/foo/bar.dll. */
289
e0cc99a6
TT
290 temp_pathname.reset (concat (sysroot,
291 need_dir_separator ? SLASH_STRING : "",
292 in_pathname + 2, (char *) NULL));
ab38a727 293
e0cc99a6
TT
294 found_file = gdb_open_cloexec (temp_pathname.get (),
295 O_RDONLY | O_BINARY, 0);
ab38a727
PA
296 }
297 }
0997b535 298
ab38a727
PA
299 /* We try to find the library in various ways. After each attempt,
300 either found_file >= 0 and temp_pathname is a malloc'd string, or
301 found_file < 0 and temp_pathname does not point to storage that
302 needs to be freed. */
303
304 if (found_file < 0)
e0cc99a6 305 temp_pathname.reset (NULL);
ab38a727 306
f822c95b 307 /* If the search in gdb_sysroot failed, and the path name is
ba5f0d88
OF
308 absolute at this point, make it relative. (openp will try and open the
309 file according to its absolute path otherwise, which is not what we want.)
310 Affects subsequent searches for this solib. */
ab38a727 311 if (found_file < 0 && IS_TARGET_ABSOLUTE_PATH (fskind, in_pathname))
ba5f0d88
OF
312 {
313 /* First, get rid of any drive letters etc. */
ab38a727
PA
314 while (!IS_TARGET_DIR_SEPARATOR (fskind, *in_pathname))
315 in_pathname++;
ba5f0d88
OF
316
317 /* Next, get rid of all leading dir separators. */
ab38a727
PA
318 while (IS_TARGET_DIR_SEPARATOR (fskind, *in_pathname))
319 in_pathname++;
ba5f0d88 320 }
ab38a727 321
af1900b0
GB
322 /* If not found, and we're looking for a solib, search the
323 solib_search_path (if any). */
324 if (is_solib && found_file < 0 && solib_search_path != NULL)
492c0ab7
JK
325 found_file = openp (solib_search_path,
326 OPF_TRY_CWD_FIRST | OPF_RETURN_REALPATH,
fbdebf46 327 in_pathname, O_RDONLY | O_BINARY, &temp_pathname);
ab38a727 328
af1900b0
GB
329 /* If not found, and we're looking for a solib, next search the
330 solib_search_path (if any) for the basename only (ignoring the
331 path). This is to allow reading solibs from a path that differs
332 from the opened path. */
333 if (is_solib && found_file < 0 && solib_search_path != NULL)
492c0ab7
JK
334 found_file = openp (solib_search_path,
335 OPF_TRY_CWD_FIRST | OPF_RETURN_REALPATH,
ab38a727
PA
336 target_lbasename (fskind, in_pathname),
337 O_RDONLY | O_BINARY, &temp_pathname);
e4f7b8c8 338
af1900b0
GB
339 /* If not found, and we're looking for a solib, try to use target
340 supplied solib search method. */
341 if (is_solib && found_file < 0 && ops->find_and_open_solib)
637d6690 342 found_file = ops->find_and_open_solib (in_pathname, O_RDONLY | O_BINARY,
66aba65d 343 &temp_pathname);
2610b0bf 344
c378eb4e 345 /* If not found, next search the inferior's $PATH environment variable. */
b57fbfba 346 if (found_file < 0 && sysroot == NULL)
9a6c7d9c 347 found_file = openp (current_inferior ()->environment.get ("PATH"),
492c0ab7
JK
348 OPF_TRY_CWD_FIRST | OPF_RETURN_REALPATH, in_pathname,
349 O_RDONLY | O_BINARY, &temp_pathname);
e4f7b8c8 350
af1900b0
GB
351 /* If not found, and we're looking for a solib, next search the
352 inferior's $LD_LIBRARY_PATH environment variable. */
353 if (is_solib && found_file < 0 && sysroot == NULL)
9a6c7d9c
SDJ
354 found_file = openp (current_inferior ()->environment.get
355 ("LD_LIBRARY_PATH"),
492c0ab7
JK
356 OPF_TRY_CWD_FIRST | OPF_RETURN_REALPATH, in_pathname,
357 O_RDONLY | O_BINARY, &temp_pathname);
e4f7b8c8 358
998d2a3e
GB
359 if (fd == NULL)
360 {
361 if (found_file >= 0)
362 close (found_file);
363 }
364 else
365 *fd = found_file;
366
e0cc99a6 367 return temp_pathname;
572d275c
UW
368}
369
af1900b0 370/* Return the full pathname of the main executable, or NULL if not
797bc1cb
TT
371 found. If FD is non-NULL, *FD is set to either -1 or an open file
372 handle for the main executable. */
af1900b0 373
797bc1cb 374gdb::unique_xmalloc_ptr<char>
992f1ddc 375exec_file_find (const char *in_pathname, int *fd)
af1900b0 376{
797bc1cb 377 gdb::unique_xmalloc_ptr<char> result;
ecf45d2c
SL
378 const char *fskind = effective_target_file_system_kind ();
379
380 if (in_pathname == NULL)
381 return NULL;
af1900b0 382
ecf45d2c 383 if (*gdb_sysroot != '\0' && IS_TARGET_ABSOLUTE_PATH (fskind, in_pathname))
af1900b0 384 {
5b89c67a 385 result = solib_find_1 (in_pathname, fd, false);
af1900b0 386
ecf45d2c 387 if (result == NULL && fskind == file_system_kind_dos_based)
af1900b0
GB
388 {
389 char *new_pathname;
390
224c3ddb 391 new_pathname = (char *) alloca (strlen (in_pathname) + 5);
af1900b0
GB
392 strcpy (new_pathname, in_pathname);
393 strcat (new_pathname, ".exe");
394
5b89c67a 395 result = solib_find_1 (new_pathname, fd, false);
af1900b0
GB
396 }
397 }
ecf45d2c
SL
398 else
399 {
400 /* It's possible we don't have a full path, but rather just a
401 filename. Some targets, such as HP-UX, don't provide the
402 full path, sigh.
403
404 Attempt to qualify the filename against the source path.
405 (If that fails, we'll just fall back on the original
406 filename. Not much more we can do...) */
407
e0cc99a6 408 if (!source_full_path_of (in_pathname, &result))
797bc1cb 409 result.reset (xstrdup (in_pathname));
ecf45d2c
SL
410 if (fd != NULL)
411 *fd = -1;
412 }
af1900b0
GB
413
414 return result;
415}
416
417/* Return the full pathname of a shared library file, or NULL if not
797bc1cb
TT
418 found. If FD is non-NULL, *FD is set to either -1 or an open file
419 handle for the shared library.
af1900b0
GB
420
421 The search algorithm used is described in solib_find_1's comment
422 above. */
423
797bc1cb 424gdb::unique_xmalloc_ptr<char>
992f1ddc 425solib_find (const char *in_pathname, int *fd)
af1900b0
GB
426{
427 const char *solib_symbols_extension
428 = gdbarch_solib_symbols_extension (target_gdbarch ());
429
430 /* If solib_symbols_extension is set, replace the file's
431 extension. */
432 if (solib_symbols_extension != NULL)
433 {
992f1ddc 434 const char *p = in_pathname + strlen (in_pathname);
af1900b0
GB
435
436 while (p > in_pathname && *p != '.')
437 p--;
438
439 if (*p == '.')
440 {
441 char *new_pathname;
442
224c3ddb
SM
443 new_pathname
444 = (char *) alloca (p - in_pathname + 1
445 + strlen (solib_symbols_extension) + 1);
af1900b0
GB
446 memcpy (new_pathname, in_pathname, p - in_pathname + 1);
447 strcpy (new_pathname + (p - in_pathname) + 1,
448 solib_symbols_extension);
449
450 in_pathname = new_pathname;
451 }
452 }
453
5b89c67a 454 return solib_find_1 (in_pathname, fd, true);
af1900b0
GB
455}
456
572d275c
UW
457/* Open and return a BFD for the shared library PATHNAME. If FD is not -1,
458 it is used as file handle to open the file. Throws an error if the file
459 could not be opened. Handles both local and remote file access.
460
797bc1cb 461 If unsuccessful, the FD will be closed (unless FD was -1). */
572d275c 462
192b62ce 463gdb_bfd_ref_ptr
797bc1cb 464solib_bfd_fopen (const char *pathname, int fd)
572d275c 465{
192b62ce 466 gdb_bfd_ref_ptr abfd (gdb_bfd_open (pathname, gnutarget, fd));
572d275c 467
192b62ce
TT
468 if (abfd != NULL && !gdb_bfd_has_target_filename (abfd.get ()))
469 bfd_set_cacheable (abfd.get (), 1);
f1838a98 470
192b62ce 471 if (abfd == NULL)
f1838a98 472 {
9a897d43 473 /* Arrange to free PATHNAME when the error is thrown. */
f1838a98 474 error (_("Could not open `%s' as an executable file: %s"),
572d275c 475 pathname, bfd_errmsg (bfd_get_error ()));
f1838a98
UW
476 }
477
520b0001 478 return abfd;
572d275c
UW
479}
480
481/* Find shared library PATHNAME and open a BFD for it. */
482
192b62ce 483gdb_bfd_ref_ptr
692d6f97 484solib_bfd_open (const char *pathname)
572d275c 485{
572d275c 486 int found_file;
378d2b72 487 const struct bfd_arch_info *b;
572d275c 488
572d275c 489 /* Search for shared library file. */
797bc1cb
TT
490 gdb::unique_xmalloc_ptr<char> found_pathname
491 = solib_find (pathname, &found_file);
572d275c 492 if (found_pathname == NULL)
048d532d
PA
493 {
494 /* Return failure if the file could not be found, so that we can
495 accumulate messages about missing libraries. */
496 if (errno == ENOENT)
497 return NULL;
498
499 perror_with_name (pathname);
500 }
572d275c
UW
501
502 /* Open bfd for shared library. */
797bc1cb 503 gdb_bfd_ref_ptr abfd (solib_bfd_fopen (found_pathname.get (), found_file));
572d275c
UW
504
505 /* Check bfd format. */
192b62ce
TT
506 if (!bfd_check_format (abfd.get (), bfd_object))
507 error (_("`%s': not in executable format: %s"),
00f93c44 508 bfd_get_filename (abfd.get ()), bfd_errmsg (bfd_get_error ()));
f1838a98 509
378d2b72 510 /* Check bfd arch. */
f5656ead 511 b = gdbarch_bfd_arch_info (target_gdbarch ());
192b62ce 512 if (!b->compatible (b, bfd_get_arch_info (abfd.get ())))
378d2b72 513 warning (_("`%s': Shared library architecture %s is not compatible "
00f93c44
AM
514 "with target architecture %s."), bfd_get_filename (abfd.get ()),
515 bfd_get_arch_info (abfd.get ())->printable_name,
192b62ce 516 b->printable_name);
378d2b72 517
f1838a98 518 return abfd;
e4f7b8c8
MS
519}
520
7f86f058
PA
521/* Given a pointer to one of the shared objects in our list of mapped
522 objects, use the recorded name to open a bfd descriptor for the
523 object, build a section table, relocate all the section addresses
524 by the base address at which the shared object was mapped, and then
525 add the sections to the target's section table.
e4f7b8c8 526
7f86f058
PA
527 FIXME: In most (all?) cases the shared object file name recorded in
528 the dynamic linkage tables will be a fully qualified pathname. For
c5aa993b
JM
529 cases where it isn't, do we really mimic the systems search
530 mechanism correctly in the below code (particularly the tilde
7f86f058 531 expansion stuff?). */
c906108c
SS
532
533static int
048d532d 534solib_map_sections (struct so_list *so)
c906108c 535{
3641da11 536 const struct target_so_ops *ops = solib_ops (target_gdbarch ());
c5aa993b 537
ee0c3293
TT
538 gdb::unique_xmalloc_ptr<char> filename (tilde_expand (so->so_name));
539 gdb_bfd_ref_ptr abfd (ops->bfd_open (filename.get ()));
e4f7b8c8 540
048d532d
PA
541 if (abfd == NULL)
542 return 0;
543
13437d4b 544 /* Leave bfd open, core_xfer_memory and "info files" need it. */
192b62ce 545 so->abfd = abfd.release ();
23e04971 546
b030cf11
JB
547 /* Copy the full path name into so_name, allowing symbol_file_add
548 to find it later. This also affects the =library-loaded GDB/MI
549 event, and in particular the part of that notification providing
550 the library's host-side path. If we let the target dictate
551 that objfile's path, and the target is different from the host,
552 GDB/MI will not provide the correct host-side path. */
192b62ce 553 if (strlen (bfd_get_filename (so->abfd)) >= SO_NAME_MAX_PATH_SIZE)
b030cf11 554 error (_("Shared library file name is too long."));
192b62ce 555 strcpy (so->so_name, bfd_get_filename (so->abfd));
b030cf11 556
bb2a6777
TT
557 if (so->sections == nullptr)
558 so->sections = new target_section_table;
2d128614 559 *so->sections = build_section_table (so->abfd);
104c1213 560
d7a78e5c 561 for (target_section &p : *so->sections)
104c1213 562 {
13437d4b 563 /* Relocate the section binding addresses as recorded in the shared
dda83cd7
SM
564 object's file by the base address to which the object was actually
565 mapped. */
bb2a6777 566 ops->relocate_section_addresses (so, &p);
cfa9d6d9
DJ
567
568 /* If the target didn't provide information about the address
569 range of the shared object, assume we want the location of
570 the .text section. */
571 if (so->addr_low == 0 && so->addr_high == 0
bb2a6777 572 && strcmp (p.the_bfd_section->name, ".text") == 0)
13437d4b 573 {
bb2a6777
TT
574 so->addr_low = p.addr;
575 so->addr_high = p.endaddr;
13437d4b 576 }
104c1213
JM
577 }
578
048d532d
PA
579 /* Add the shared object's sections to the current set of file
580 section tables. Do this immediately after mapping the object so
581 that later nodes in the list can query this object, as is needed
582 in solib-osf.c. */
3769e227 583 current_program_space->add_target_sections (so, *so->sections);
048d532d
PA
584
585 return 1;
104c1213 586}
c906108c 587
0892cb63
DE
588/* Free symbol-file related contents of SO and reset for possible reloading
589 of SO. If we have opened a BFD for SO, close it. If we have placed SO's
590 sections in some target's section table, the caller is responsible for
591 removing them.
a86988f2
PA
592
593 This function doesn't mess with objfiles at all. If there is an
594 objfile associated with SO that needs to be removed, the caller is
595 responsible for taking care of that. */
596
597static void
0892cb63 598clear_so (struct so_list *so)
a86988f2 599{
3641da11 600 const struct target_so_ops *ops = solib_ops (target_gdbarch ());
0892cb63 601
bb2a6777
TT
602 delete so->sections;
603 so->sections = NULL;
a86988f2
PA
604
605 gdb_bfd_unref (so->abfd);
606 so->abfd = NULL;
607
608 /* Our caller closed the objfile, possibly via objfile_purge_solibs. */
609 so->symbols_loaded = 0;
610 so->objfile = NULL;
611
612 so->addr_low = so->addr_high = 0;
613
614 /* Restore the target-supplied file name. SO_NAME may be the path
615 of the symbol file. */
616 strcpy (so->so_name, so->so_original_name);
0892cb63
DE
617
618 /* Do the same for target-specific data. */
619 if (ops->clear_so != NULL)
620 ops->clear_so (so);
a86988f2
PA
621}
622
7f86f058 623/* Free the storage associated with the `struct so_list' object SO.
c378eb4e 624 If we have opened a BFD for SO, close it.
c906108c 625
07cd4b97
JB
626 The caller is responsible for removing SO from whatever list it is
627 a member of. If we have placed SO's sections in some target's
628 section table, the caller is responsible for removing them.
c906108c 629
07cd4b97
JB
630 This function doesn't mess with objfiles at all. If there is an
631 objfile associated with SO that needs to be removed, the caller is
632 responsible for taking care of that. */
633
13437d4b 634void
07cd4b97 635free_so (struct so_list *so)
c906108c 636{
3641da11 637 const struct target_so_ops *ops = solib_ops (target_gdbarch ());
c5aa993b 638
0892cb63 639 clear_so (so);
66aba65d 640 ops->free_so (so);
07cd4b97 641
b8c9b27d 642 xfree (so);
c906108c
SS
643}
644
07cd4b97 645
7eedccfa 646/* Read in symbols for shared object SO. If SYMFILE_VERBOSE is set in FLAGS,
5b89c67a 647 be chatty about it. Return true if any symbols were actually loaded. */
42a6e6a0 648
5b89c67a 649bool
b15cc25c 650solib_read_symbols (struct so_list *so, symfile_add_flags flags)
42a6e6a0
MK
651{
652 if (so->symbols_loaded)
653 {
a86988f2 654 /* If needed, we've already warned in our caller. */
42a6e6a0 655 }
8bb75286
DJ
656 else if (so->abfd == NULL)
657 {
048d532d
PA
658 /* We've already warned about this library, when trying to open
659 it. */
8bb75286 660 }
42a6e6a0
MK
661 else
662 {
048d532d 663
7dcd53a0
TT
664 flags |= current_inferior ()->symfile_flags;
665
a70b8144 666 try
048d532d 667 {
048d532d 668 /* Have we already loaded this shared object? */
aed57c53 669 so->objfile = nullptr;
2030c079 670 for (objfile *objfile : current_program_space->objfiles ())
048d532d 671 {
aed57c53
TT
672 if (filename_cmp (objfile_name (objfile), so->so_name) == 0
673 && objfile->addr_low == so->addr_low)
674 {
675 so->objfile = objfile;
676 break;
677 }
048d532d 678 }
9c6595ab
PA
679 if (so->objfile == NULL)
680 {
37e136b1 681 section_addr_info sap
bb2a6777 682 = build_section_addr_info_from_section_table (*so->sections);
9c6595ab 683 so->objfile = symbol_file_add_from_bfd (so->abfd, so->so_name,
37e136b1
TT
684 flags, &sap,
685 OBJF_SHARED, NULL);
9c6595ab 686 so->objfile->addr_low = so->addr_low;
9c6595ab 687 }
492d29ea
PA
688
689 so->symbols_loaded = 1;
690 }
230d2906 691 catch (const gdb_exception_error &e)
492d29ea
PA
692 {
693 exception_fprintf (gdb_stderr, e, _("Error while reading shared"
694 " library symbols for %s:\n"),
695 so->so_name);
048d532d
PA
696 }
697
5b89c67a 698 return true;
42a6e6a0
MK
699 }
700
5b89c67a 701 return false;
42a6e6a0 702}
c906108c 703
a1fd1ac9
TT
704/* Return true if KNOWN->objfile is used by any other so_list object
705 in the list of shared libraries. Return false otherwise. */
59145f8c 706
5b89c67a 707static bool
59145f8c
AR
708solib_used (const struct so_list *const known)
709{
a1fd1ac9 710 for (const struct so_list *pivot : current_program_space->solibs ())
59145f8c 711 if (pivot != known && pivot->objfile == known->objfile)
5b89c67a
CB
712 return true;
713 return false;
59145f8c
AR
714}
715
51457a05 716/* See solib.h. */
c906108c 717
e696b3ad
MAL
718void
719update_solib_list (int from_tty)
07cd4b97 720{
3641da11 721 const struct target_so_ops *ops = solib_ops (target_gdbarch ());
66aba65d 722 struct so_list *inferior = ops->current_sos();
07cd4b97
JB
723 struct so_list *gdb, **gdb_link;
724
181e7f93
PA
725 /* We can reach here due to changing solib-search-path or the
726 sysroot, before having any inferior. */
55f6301a 727 if (target_has_execution () && inferior_ptid != null_ptid)
181e7f93
PA
728 {
729 struct inferior *inf = current_inferior ();
730
731 /* If we are attaching to a running process for which we
732 have not opened a symbol file, we may be able to get its
733 symbols now! */
a42d7dd8
TT
734 if (inf->attach_flag
735 && current_program_space->symfile_object_file == NULL)
bf469271 736 {
a70b8144 737 try
bf469271
PA
738 {
739 ops->open_symbol_file_object (from_tty);
740 }
230d2906 741 catch (const gdb_exception &ex)
bf469271
PA
742 {
743 exception_fprintf (gdb_stderr, ex,
744 "Error reading attached "
745 "process's symbol file.\n");
746 }
bf469271 747 }
181e7f93 748 }
104c1213 749
07cd4b97
JB
750 /* GDB and the inferior's dynamic linker each maintain their own
751 list of currently loaded shared objects; we want to bring the
752 former in sync with the latter. Scan both lists, seeing which
753 shared objects appear where. There are three cases:
754
755 - A shared object appears on both lists. This means that GDB
105b175f
JB
756 knows about it already, and it's still loaded in the inferior.
757 Nothing needs to happen.
07cd4b97
JB
758
759 - A shared object appears only on GDB's list. This means that
105b175f
JB
760 the inferior has unloaded it. We should remove the shared
761 object from GDB's tables.
07cd4b97
JB
762
763 - A shared object appears only on the inferior's list. This
105b175f
JB
764 means that it's just been loaded. We should add it to GDB's
765 tables.
07cd4b97
JB
766
767 So we walk GDB's list, checking each entry to see if it appears
768 in the inferior's list too. If it does, no action is needed, and
769 we remove it from the inferior's list. If it doesn't, the
770 inferior has unloaded it, and we remove it from GDB's list. By
771 the time we're done walking GDB's list, the inferior's list
772 contains only the new shared objects, which we then add. */
773
a1fd1ac9
TT
774 gdb = current_program_space->so_list;
775 gdb_link = &current_program_space->so_list;
07cd4b97 776 while (gdb)
c906108c 777 {
07cd4b97
JB
778 struct so_list *i = inferior;
779 struct so_list **i_link = &inferior;
780
781 /* Check to see whether the shared object *gdb also appears in
782 the inferior's current list. */
783 while (i)
c906108c 784 {
a7c02bc8
VP
785 if (ops->same)
786 {
787 if (ops->same (gdb, i))
788 break;
789 }
790 else
791 {
0ba1096a 792 if (! filename_cmp (gdb->so_original_name, i->so_original_name))
a7c02bc8
VP
793 break;
794 }
07cd4b97
JB
795
796 i_link = &i->next;
797 i = *i_link;
c906108c 798 }
c5aa993b 799
07cd4b97 800 /* If the shared object appears on the inferior's list too, then
dda83cd7
SM
801 it's still loaded, so we don't need to do anything. Delete
802 it from the inferior's list, and leave it on GDB's list. */
07cd4b97 803 if (i)
c906108c 804 {
07cd4b97 805 *i_link = i->next;
07cd4b97
JB
806 free_so (i);
807 gdb_link = &gdb->next;
808 gdb = *gdb_link;
809 }
810
811 /* If it's not on the inferior's list, remove it from GDB's tables. */
812 else
813 {
42a6e6a0
MK
814 /* Notify any observer that the shared object has been
815 unloaded before we remove it from GDB's tables. */
76727919 816 gdb::observers::solib_unloaded.notify (gdb);
84acb35a 817
6fb16ce6 818 current_program_space->deleted_solibs.push_back (gdb->so_name);
edcc5120 819
07cd4b97 820 *gdb_link = gdb->next;
07cd4b97
JB
821
822 /* Unless the user loaded it explicitly, free SO's objfile. */
59145f8c
AR
823 if (gdb->objfile && ! (gdb->objfile->flags & OBJF_USERLOADED)
824 && !solib_used (gdb))
268e4f09 825 gdb->objfile->unlink ();
07cd4b97
JB
826
827 /* Some targets' section tables might be referring to
828 sections from so->abfd; remove them. */
2a3f84af 829 current_program_space->remove_target_sections (gdb);
07cd4b97
JB
830
831 free_so (gdb);
832 gdb = *gdb_link;
c906108c
SS
833 }
834 }
c5aa993b 835
07cd4b97
JB
836 /* Now the inferior's list contains only shared objects that don't
837 appear in GDB's list --- those that are newly loaded. Add them
e8930304 838 to GDB's shared object list. */
07cd4b97 839 if (inferior)
c906108c 840 {
048d532d
PA
841 int not_found = 0;
842 const char *not_found_filename = NULL;
843
07cd4b97
JB
844 struct so_list *i;
845
846 /* Add the new shared objects to GDB's list. */
847 *gdb_link = inferior;
848
e8930304 849 /* Fill in the rest of each of the `struct so_list' nodes. */
07cd4b97 850 for (i = inferior; i; i = i->next)
c906108c 851 {
048d532d 852
6c95b8df 853 i->pspace = current_program_space;
bcb430e4 854 current_program_space->added_solibs.push_back (i);
07cd4b97 855
a70b8144 856 try
048d532d
PA
857 {
858 /* Fill in the rest of the `struct so_list' node. */
859 if (!solib_map_sections (i))
860 {
861 not_found++;
862 if (not_found_filename == NULL)
863 not_found_filename = i->so_original_name;
864 }
865 }
07cd4b97 866
230d2906 867 catch (const gdb_exception_error &e)
492d29ea
PA
868 {
869 exception_fprintf (gdb_stderr, e,
870 _("Error while mapping shared "
871 "library sections:\n"));
872 }
42a6e6a0
MK
873
874 /* Notify any observer that the shared object has been
048d532d 875 loaded now that we've added it to GDB's tables. */
76727919 876 gdb::observers::solib_loaded.notify (i);
c906108c 877 }
048d532d
PA
878
879 /* If a library was not found, issue an appropriate warning
880 message. We have to use a single call to warning in case the
881 front end does something special with warnings, e.g., pop up
882 a dialog box. It Would Be Nice if we could get a "warning: "
883 prefix on each line in the CLI front end, though - it doesn't
884 stand out well. */
885
886 if (not_found == 1)
3e43a32a
MS
887 warning (_("Could not load shared library symbols for %s.\n"
888 "Do you need \"set solib-search-path\" "
889 "or \"set sysroot\"?"),
048d532d
PA
890 not_found_filename);
891 else if (not_found > 1)
892 warning (_("\
893Could not load shared library symbols for %d libraries, e.g. %s.\n\
894Use the \"info sharedlibrary\" command to see the complete listing.\n\
895Do you need \"set solib-search-path\" or \"set sysroot\"?"),
896 not_found, not_found_filename);
e8930304 897 }
105b175f
JB
898}
899
17a37d48
PP
900
901/* Return non-zero if NAME is the libpthread shared library.
6612ad7f
JB
902
903 Uses a fairly simplistic heuristic approach where we check
904 the file name against "/libpthread". This can lead to false
e2b9ea4b
KB
905 positives, but this should be good enough in practice.
906
907 As of glibc-2.34, functions formerly residing in libpthread have
908 been moved to libc, so "/libc." needs to be checked too. (Matching
909 the "." will avoid matching libraries such as libcrypt.) */
6612ad7f 910
5b89c67a 911bool
17a37d48
PP
912libpthread_name_p (const char *name)
913{
e2b9ea4b
KB
914 return (strstr (name, "/libpthread") != NULL
915 || strstr (name, "/libc.") != NULL );
17a37d48
PP
916}
917
918/* Return non-zero if SO is the libpthread shared library. */
919
5b89c67a 920static bool
6612ad7f
JB
921libpthread_solib_p (struct so_list *so)
922{
17a37d48 923 return libpthread_name_p (so->so_name);
6612ad7f 924}
105b175f 925
7f86f058 926/* Read in symbolic information for any shared objects whose names
105b175f
JB
927 match PATTERN. (If we've already read a shared object's symbol
928 info, leave it alone.) If PATTERN is zero, read them all.
929
990f9fe3
FF
930 If READSYMS is 0, defer reading symbolic information until later
931 but still do any needed low level processing.
932
e696b3ad 933 FROM_TTY is described for update_solib_list, above. */
105b175f
JB
934
935void
e696b3ad 936solib_add (const char *pattern, int from_tty, int readsyms)
105b175f 937{
770e7fc7
DE
938 if (print_symbol_loading_p (from_tty, 0, 0))
939 {
940 if (pattern != NULL)
941 {
942 printf_unfiltered (_("Loading symbols for shared libraries: %s\n"),
943 pattern);
944 }
945 else
946 printf_unfiltered (_("Loading symbols for shared libraries.\n"));
947 }
948
2eff07b3
PP
949 current_program_space->solib_add_generation++;
950
105b175f
JB
951 if (pattern)
952 {
953 char *re_err = re_comp (pattern);
954
955 if (re_err)
8a3fe4f8 956 error (_("Invalid regexp: %s"), re_err);
105b175f
JB
957 }
958
e696b3ad 959 update_solib_list (from_tty);
c906108c 960
105b175f
JB
961 /* Walk the list of currently loaded shared libraries, and read
962 symbols for any that match the pattern --- or any whose symbols
963 aren't already loaded, if no pattern was given. */
e8930304 964 {
5b89c67a
CB
965 bool any_matches = false;
966 bool loaded_any_symbols = false;
b15cc25c
PA
967 symfile_add_flags add_flags = SYMFILE_DEFER_BP_RESET;
968
969 if (from_tty)
dda83cd7 970 add_flags |= SYMFILE_VERBOSE;
c906108c 971
a1fd1ac9 972 for (struct so_list *gdb : current_program_space->solibs ())
e8930304
JB
973 if (! pattern || re_exec (gdb->so_name))
974 {
dda83cd7
SM
975 /* Normally, we would read the symbols from that library
976 only if READSYMS is set. However, we're making a small
977 exception for the pthread library, because we sometimes
978 need the library symbols to be loaded in order to provide
979 thread support (x86-linux for instance). */
980 const int add_this_solib =
981 (readsyms || libpthread_solib_p (gdb));
6612ad7f 982
5b89c67a 983 any_matches = true;
a86988f2
PA
984 if (add_this_solib)
985 {
986 if (gdb->symbols_loaded)
987 {
988 /* If no pattern was given, be quiet for shared
989 libraries we have already loaded. */
990 if (pattern && (from_tty || info_verbose))
991 printf_unfiltered (_("Symbols already loaded for %s\n"),
992 gdb->so_name);
993 }
b15cc25c 994 else if (solib_read_symbols (gdb, add_flags))
5b89c67a 995 loaded_any_symbols = true;
a86988f2 996 }
e8930304
JB
997 }
998
7eedccfa
PP
999 if (loaded_any_symbols)
1000 breakpoint_re_set ();
1001
e8930304
JB
1002 if (from_tty && pattern && ! any_matches)
1003 printf_unfiltered
1004 ("No loaded shared libraries match the pattern `%s'.\n", pattern);
1005
1006 if (loaded_any_symbols)
1007 {
1008 /* Getting new symbols may change our opinion about what is
1009 frameless. */
1010 reinit_frame_cache ();
e8930304
JB
1011 }
1012 }
c906108c
SS
1013}
1014
7f86f058
PA
1015/* Implement the "info sharedlibrary" command. Walk through the
1016 shared library list and print information about each attached
1017 library matching PATTERN. If PATTERN is elided, print them
1018 all. */
c906108c
SS
1019
1020static void
1d12d88f 1021info_sharedlibrary_command (const char *pattern, int from_tty)
c906108c 1022{
5b89c67a 1023 bool so_missing_debug_info = false;
c906108c 1024 int addr_width;
55333a84 1025 int nr_libs;
f5656ead 1026 struct gdbarch *gdbarch = target_gdbarch ();
79a45e25 1027 struct ui_out *uiout = current_uiout;
55333a84
DE
1028
1029 if (pattern)
1030 {
1031 char *re_err = re_comp (pattern);
1032
1033 if (re_err)
1034 error (_("Invalid regexp: %s"), re_err);
1035 }
c906108c 1036
84eb3c4f 1037 /* "0x", a little whitespace, and two hex digits per byte of pointers. */
55333a84 1038 addr_width = 4 + (gdbarch_ptr_bit (gdbarch) / 4);
c906108c 1039
e696b3ad 1040 update_solib_list (from_tty);
07cd4b97 1041
4a2b031d
TT
1042 /* ui_out_emit_table table_emitter needs to know the number of rows,
1043 so we need to make two passes over the libs. */
55333a84 1044
a1fd1ac9
TT
1045 nr_libs = 0;
1046 for (struct so_list *so : current_program_space->solibs ())
c906108c 1047 {
c5aa993b 1048 if (so->so_name[0])
c906108c 1049 {
55333a84
DE
1050 if (pattern && ! re_exec (so->so_name))
1051 continue;
1052 ++nr_libs;
1053 }
1054 }
1055
4a2b031d
TT
1056 {
1057 ui_out_emit_table table_emitter (uiout, 4, nr_libs, "SharedLibraryTable");
55333a84 1058
4a2b031d
TT
1059 /* The "- 1" is because ui_out adds one space between columns. */
1060 uiout->table_header (addr_width - 1, ui_left, "from", "From");
1061 uiout->table_header (addr_width - 1, ui_left, "to", "To");
1062 uiout->table_header (12 - 1, ui_left, "syms-read", "Syms Read");
1063 uiout->table_header (0, ui_noalign, "name", "Shared Object Library");
55333a84 1064
4a2b031d 1065 uiout->table_body ();
55333a84 1066
a1fd1ac9 1067 for (struct so_list *so : current_program_space->solibs ())
4a2b031d
TT
1068 {
1069 if (! so->so_name[0])
1070 continue;
1071 if (pattern && ! re_exec (so->so_name))
1072 continue;
1073
1074 ui_out_emit_tuple tuple_emitter (uiout, "lib");
1075
1076 if (so->addr_high != 0)
1077 {
1078 uiout->field_core_addr ("from", gdbarch, so->addr_low);
1079 uiout->field_core_addr ("to", gdbarch, so->addr_high);
1080 }
1081 else
1082 {
1083 uiout->field_skip ("from");
1084 uiout->field_skip ("to");
1085 }
1086
29f94340 1087 if (! top_level_interpreter ()->interp_ui_out ()->is_mi_like_p ()
4a2b031d
TT
1088 && so->symbols_loaded
1089 && !objfile_has_symbols (so->objfile))
1090 {
5b89c67a 1091 so_missing_debug_info = true;
4a2b031d
TT
1092 uiout->field_string ("syms-read", "Yes (*)");
1093 }
1094 else
1095 uiout->field_string ("syms-read", so->symbols_loaded ? "Yes" : "No");
1096
e43b10e1 1097 uiout->field_string ("name", so->so_name, file_name_style.style ());
4a2b031d
TT
1098
1099 uiout->text ("\n");
1100 }
1101 }
55333a84
DE
1102
1103 if (nr_libs == 0)
1104 {
1105 if (pattern)
112e8700 1106 uiout->message (_("No shared libraries matched.\n"));
55333a84 1107 else
112e8700 1108 uiout->message (_("No shared libraries loaded at this time.\n"));
55333a84
DE
1109 }
1110 else
c906108c 1111 {
55333a84 1112 if (so_missing_debug_info)
112e8700 1113 uiout->message (_("(*): Shared library is missing "
3e43a32a 1114 "debugging information.\n"));
c906108c
SS
1115 }
1116}
1117
5b89c67a 1118/* See solib.h. */
5fd1a349 1119
5b89c67a 1120bool
5fd1a349
PP
1121solib_contains_address_p (const struct so_list *const solib,
1122 CORE_ADDR address)
1123{
76547ab3
TV
1124 if (solib->sections == nullptr)
1125 return false;
1126
d7a78e5c 1127 for (target_section &p : *solib->sections)
bb2a6777 1128 if (p.addr <= address && address < p.endaddr)
5b89c67a 1129 return true;
5fd1a349 1130
5b89c67a 1131 return false;
5fd1a349
PP
1132}
1133
7f86f058
PA
1134/* If ADDRESS is in a shared lib in program space PSPACE, return its
1135 name.
c906108c 1136
7f86f058
PA
1137 Provides a hook for other gdb routines to discover whether or not a
1138 particular address is within the mapped address space of a shared
1139 library.
c906108c 1140
c5aa993b
JM
1141 For example, this routine is called at one point to disable
1142 breakpoints which are in shared libraries that are not currently
7f86f058 1143 mapped in. */
c906108c
SS
1144
1145char *
6c95b8df 1146solib_name_from_address (struct program_space *pspace, CORE_ADDR address)
c906108c 1147{
6c95b8df 1148 struct so_list *so = NULL;
c5aa993b 1149
6c95b8df 1150 for (so = pspace->so_list; so; so = so->next)
5fd1a349
PP
1151 if (solib_contains_address_p (so, address))
1152 return (so->so_name);
07cd4b97 1153
c906108c
SS
1154 return (0);
1155}
1156
5b89c67a 1157/* See solib.h. */
de18c1d8 1158
5b89c67a 1159bool
de18c1d8
JM
1160solib_keep_data_in_core (CORE_ADDR vaddr, unsigned long size)
1161{
3641da11 1162 const struct target_so_ops *ops = solib_ops (target_gdbarch ());
de18c1d8
JM
1163
1164 if (ops->keep_data_in_core)
5b89c67a 1165 return ops->keep_data_in_core (vaddr, size) != 0;
de18c1d8 1166 else
5b89c67a 1167 return false;
de18c1d8
JM
1168}
1169
c906108c
SS
1170/* Called by free_all_symtabs */
1171
c5aa993b 1172void
fba45db2 1173clear_solib (void)
c906108c 1174{
3641da11 1175 const struct target_so_ops *ops = solib_ops (target_gdbarch ());
66aba65d 1176
1736a7bd 1177 disable_breakpoints_in_shlibs ();
085dd6e6 1178
a1fd1ac9 1179 while (current_program_space->so_list)
c906108c 1180 {
a1fd1ac9 1181 struct so_list *so = current_program_space->so_list;
433759f7 1182
a1fd1ac9 1183 current_program_space->so_list = so->next;
76727919 1184 gdb::observers::solib_unloaded.notify (so);
2a3f84af 1185 current_program_space->remove_target_sections (so);
07cd4b97 1186 free_so (so);
c906108c 1187 }
07cd4b97 1188
66aba65d 1189 ops->clear_solib ();
c906108c
SS
1190}
1191
7f86f058
PA
1192/* Shared library startup support. When GDB starts up the inferior,
1193 it nurses it along (through the shell) until it is ready to execute
1194 its first instruction. At this point, this function gets
1195 called. */
c5aa993b
JM
1196
1197void
268a4a75 1198solib_create_inferior_hook (int from_tty)
c906108c 1199{
3641da11 1200 const struct target_so_ops *ops = solib_ops (target_gdbarch ());
433759f7 1201
268a4a75 1202 ops->solib_create_inferior_hook (from_tty);
c906108c
SS
1203}
1204
5b89c67a 1205/* See solib.h. */
d7fa2ae2 1206
5b89c67a 1207bool
d7fa2ae2
KB
1208in_solib_dynsym_resolve_code (CORE_ADDR pc)
1209{
3641da11 1210 const struct target_so_ops *ops = solib_ops (target_gdbarch ());
433759f7 1211
5b89c67a 1212 return ops->in_dynsym_resolve_code (pc) != 0;
d7fa2ae2 1213}
c906108c 1214
7f86f058 1215/* Implements the "sharedlibrary" command. */
c906108c
SS
1216
1217static void
0b39b52e 1218sharedlibrary_command (const char *args, int from_tty)
c906108c
SS
1219{
1220 dont_repeat ();
e696b3ad 1221 solib_add (args, from_tty, 1);
c906108c
SS
1222}
1223
7f86f058 1224/* Implements the command "nosharedlibrary", which discards symbols
cb0ba49e
MS
1225 that have been auto-loaded from shared libraries. Symbols from
1226 shared libraries that were added by explicit request of the user
1227 are not discarded. Also called from remote.c. */
1228
c60a7562 1229void
0b39b52e 1230no_shared_libraries (const char *ignored, int from_tty)
c60a7562 1231{
a3247a22
PP
1232 /* The order of the two routines below is important: clear_solib notifies
1233 the solib_unloaded observers, and some of these observers might need
1234 access to their associated objfiles. Therefore, we can not purge the
1235 solibs' objfiles before clear_solib has been called. */
1236
615b9dba 1237 clear_solib ();
a3247a22 1238 objfile_purge_solibs ();
c60a7562 1239}
c906108c 1240
f9e14852
GB
1241/* See solib.h. */
1242
1243void
1244update_solib_breakpoints (void)
1245{
1246 const struct target_so_ops *ops = solib_ops (target_gdbarch ());
1247
1248 if (ops->update_breakpoints != NULL)
1249 ops->update_breakpoints ();
1250}
1251
1252/* See solib.h. */
1253
1254void
1255handle_solib_event (void)
1256{
1257 const struct target_so_ops *ops = solib_ops (target_gdbarch ());
1258
1259 if (ops->handle_event != NULL)
1260 ops->handle_event ();
1261
e39fb971 1262 current_inferior ()->pspace->clear_solib_cache ();
f9e14852
GB
1263
1264 /* Check for any newly added shared libraries if we're supposed to
1265 be adding them automatically. Switch terminal for any messages
1266 produced by breakpoint_re_set. */
223ffa71 1267 target_terminal::ours_for_output ();
e696b3ad 1268 solib_add (NULL, 0, auto_solib_add);
223ffa71 1269 target_terminal::inferior ();
f9e14852
GB
1270}
1271
a86988f2
PA
1272/* Reload shared libraries, but avoid reloading the same symbol file
1273 we already have loaded. */
1274
1275static void
1276reload_shared_libraries_1 (int from_tty)
1277{
770e7fc7
DE
1278 if (print_symbol_loading_p (from_tty, 0, 0))
1279 printf_unfiltered (_("Loading symbols for shared libraries.\n"));
1280
a1fd1ac9 1281 for (struct so_list *so : current_program_space->solibs ())
a86988f2 1282 {
b16c44de 1283 const char *found_pathname = NULL;
5b89c67a 1284 bool was_loaded = so->symbols_loaded != 0;
b15cc25c
PA
1285 symfile_add_flags add_flags = SYMFILE_DEFER_BP_RESET;
1286
1287 if (from_tty)
1288 add_flags |= SYMFILE_VERBOSE;
a86988f2 1289
ee0c3293
TT
1290 gdb::unique_xmalloc_ptr<char> filename
1291 (tilde_expand (so->so_original_name));
1292 gdb_bfd_ref_ptr abfd (solib_bfd_open (filename.get ()));
a86988f2 1293 if (abfd != NULL)
ee0c3293 1294 found_pathname = bfd_get_filename (abfd.get ());
a86988f2
PA
1295
1296 /* If this shared library is no longer associated with its previous
1297 symbol file, close that. */
1298 if ((found_pathname == NULL && was_loaded)
1299 || (found_pathname != NULL
0ba1096a 1300 && filename_cmp (found_pathname, so->so_name) != 0))
a86988f2 1301 {
59145f8c
AR
1302 if (so->objfile && ! (so->objfile->flags & OBJF_USERLOADED)
1303 && !solib_used (so))
268e4f09 1304 so->objfile->unlink ();
2a3f84af 1305 current_program_space->remove_target_sections (so);
0892cb63 1306 clear_so (so);
a86988f2
PA
1307 }
1308
1309 /* If this shared library is now associated with a new symbol
1310 file, open it. */
1311 if (found_pathname != NULL
1312 && (!was_loaded
0ba1096a 1313 || filename_cmp (found_pathname, so->so_name) != 0))
a86988f2 1314 {
5b89c67a 1315 bool got_error = false;
a86988f2 1316
a70b8144 1317 try
492d29ea
PA
1318 {
1319 solib_map_sections (so);
1320 }
1321
230d2906 1322 catch (const gdb_exception_error &e)
492d29ea
PA
1323 {
1324 exception_fprintf (gdb_stderr, e,
1325 _("Error while mapping "
1326 "shared library sections:\n"));
5b89c67a 1327 got_error = true;
492d29ea 1328 }
a86988f2 1329
492d29ea
PA
1330 if (!got_error
1331 && (auto_solib_add || was_loaded || libpthread_solib_p (so)))
b15cc25c 1332 solib_read_symbols (so, add_flags);
a86988f2
PA
1333 }
1334 }
a86988f2
PA
1335}
1336
cf466558 1337static void
eb4c3f4a 1338reload_shared_libraries (const char *ignored, int from_tty,
f397e303 1339 struct cmd_list_element *e)
cf466558 1340{
3641da11 1341 const struct target_so_ops *ops;
a86988f2
PA
1342
1343 reload_shared_libraries_1 (from_tty);
1344
f5656ead 1345 ops = solib_ops (target_gdbarch ());
a86988f2 1346
c378eb4e 1347 /* Creating inferior hooks here has two purposes. First, if we reload
c8fa6cdd
VP
1348 shared libraries then the address of solib breakpoint we've computed
1349 previously might be no longer valid. For example, if we forgot to set
1350 solib-absolute-prefix and are setting it right now, then the previous
1351 breakpoint address is plain wrong. Second, installing solib hooks
1352 also implicitly figures were ld.so is and loads symbols for it.
1353 Absent this call, if we've just connected to a target and set
1354 solib-absolute-prefix or solib-search-path, we'll lose all information
1355 about ld.so. */
55f6301a 1356 if (target_has_execution ())
c8fa6cdd 1357 {
a86988f2
PA
1358 /* Reset or free private data structures not associated with
1359 so_list entries. */
1360 ops->clear_solib ();
1361
1362 /* Remove any previous solib event breakpoint. This is usually
1363 done in common code, at breakpoint_init_inferior time, but
1364 we're not really starting up the inferior here. */
1365 remove_solib_event_breakpoints ();
1366
268a4a75 1367 solib_create_inferior_hook (from_tty);
c8fa6cdd 1368 }
268a4a75
JK
1369
1370 /* Sometimes the platform-specific hook loads initial shared
1371 libraries, and sometimes it doesn't. If it doesn't FROM_TTY will be
1372 incorrectly 0 but such solib targets should be fixed anyway. If we
1373 made all the inferior hook methods consistent, this call could be
1374 removed. Call it only after the solib target has been initialized by
1375 solib_create_inferior_hook. */
1376
e696b3ad 1377 solib_add (NULL, 0, auto_solib_add);
268a4a75 1378
a86988f2
PA
1379 breakpoint_re_set ();
1380
1381 /* We may have loaded or unloaded debug info for some (or all)
1382 shared libraries. However, frames may still reference them. For
1383 example, a frame's unwinder might still point at DWARF FDE
1384 structures that are now freed. Also, getting new symbols may
1385 change our opinion about what is frameless. */
c8fa6cdd 1386 reinit_frame_cache ();
cf466558
KB
1387}
1388
2938e6cf
GB
1389/* Wrapper for reload_shared_libraries that replaces "remote:"
1390 at the start of gdb_sysroot with "target:". */
1391
1392static void
eb4c3f4a 1393gdb_sysroot_changed (const char *ignored, int from_tty,
2938e6cf
GB
1394 struct cmd_list_element *e)
1395{
1396 const char *old_prefix = "remote:";
1397 const char *new_prefix = TARGET_SYSROOT_PREFIX;
1398
1399 if (startswith (gdb_sysroot, old_prefix))
1400 {
5b89c67a 1401 static bool warning_issued = false;
2938e6cf
GB
1402
1403 gdb_assert (strlen (old_prefix) == strlen (new_prefix));
1404 memcpy (gdb_sysroot, new_prefix, strlen (new_prefix));
1405
1406 if (!warning_issued)
1407 {
1408 warning (_("\"%s\" is deprecated, use \"%s\" instead."),
1409 old_prefix, new_prefix);
1410 warning (_("sysroot set to \"%s\"."), gdb_sysroot);
1411
5b89c67a 1412 warning_issued = true;
2938e6cf
GB
1413 }
1414 }
1415
1416 reload_shared_libraries (ignored, from_tty, e);
1417}
1418
920d2a44
AC
1419static void
1420show_auto_solib_add (struct ui_file *file, int from_tty,
1421 struct cmd_list_element *c, const char *value)
1422{
1423 fprintf_filtered (file, _("Autoloading of shared library symbols is %s.\n"),
1424 value);
1425}
1426
1427
cb457ae2
YQ
1428/* Lookup the value for a specific symbol from dynamic symbol table. Look
1429 up symbol from ABFD. MATCH_SYM is a callback function to determine
1430 whether to pick up a symbol. DATA is the input of this callback
1431 function. Return NULL if symbol is not found. */
1432
1433CORE_ADDR
1434gdb_bfd_lookup_symbol_from_symtab (bfd *abfd,
3953f15c
SM
1435 int (*match_sym) (const asymbol *,
1436 const void *),
1437 const void *data)
cb457ae2
YQ
1438{
1439 long storage_needed = bfd_get_symtab_upper_bound (abfd);
1440 CORE_ADDR symaddr = 0;
1441
1442 if (storage_needed > 0)
1443 {
1444 unsigned int i;
1445
1cb1f3da
TT
1446 gdb::def_vector<asymbol *> storage (storage_needed / sizeof (asymbol *));
1447 asymbol **symbol_table = storage.data ();
cb457ae2
YQ
1448 unsigned int number_of_symbols =
1449 bfd_canonicalize_symtab (abfd, symbol_table);
1450
1451 for (i = 0; i < number_of_symbols; i++)
1452 {
1453 asymbol *sym = *symbol_table++;
1454
1455 if (match_sym (sym, data))
1456 {
3e29f34a
MR
1457 struct gdbarch *gdbarch = target_gdbarch ();
1458 symaddr = sym->value;
1459
1460 /* Some ELF targets fiddle with addresses of symbols they
dda83cd7
SM
1461 consider special. They use minimal symbols to do that
1462 and this is needed for correct breakpoint placement,
1463 but we do not have full data here to build a complete
1464 minimal symbol, so just set the address and let the
1465 targets cope with that. */
3e29f34a
MR
1466 if (bfd_get_flavour (abfd) == bfd_target_elf_flavour
1467 && gdbarch_elf_make_msymbol_special_p (gdbarch))
1468 {
eefba3da 1469 struct minimal_symbol msym {};
3e29f34a 1470
3e29f34a
MR
1471 SET_MSYMBOL_VALUE_ADDRESS (&msym, symaddr);
1472 gdbarch_elf_make_msymbol_special (gdbarch, sym, &msym);
1473 symaddr = MSYMBOL_VALUE_RAW_ADDRESS (&msym);
1474 }
1475
cb457ae2 1476 /* BFD symbols are section relative. */
3e29f34a 1477 symaddr += sym->section->vma;
cb457ae2
YQ
1478 break;
1479 }
1480 }
cb457ae2
YQ
1481 }
1482
1483 return symaddr;
1484}
1485
8ddf4645
AM
1486/* See solib.h. */
1487
1488int
1489gdb_bfd_scan_elf_dyntag (const int desired_dyntag, bfd *abfd, CORE_ADDR *ptr,
1490 CORE_ADDR *ptr_addr)
1491{
1492 int arch_size, step, sect_size;
1493 long current_dyntag;
1494 CORE_ADDR dyn_ptr, dyn_addr;
1495 gdb_byte *bufend, *bufstart, *buf;
1496 Elf32_External_Dyn *x_dynp_32;
1497 Elf64_External_Dyn *x_dynp_64;
1498 struct bfd_section *sect;
1499
1500 if (abfd == NULL)
1501 return 0;
1502
1503 if (bfd_get_flavour (abfd) != bfd_target_elf_flavour)
1504 return 0;
1505
1506 arch_size = bfd_get_arch_size (abfd);
1507 if (arch_size == -1)
1508 return 0;
1509
1510 /* Find the start address of the .dynamic section. */
1511 sect = bfd_get_section_by_name (abfd, ".dynamic");
1512 if (sect == NULL)
1513 return 0;
1514
1515 bool found = false;
1516 for (const target_section &target_section
1517 : current_program_space->target_sections ())
1518 if (sect == target_section.the_bfd_section)
1519 {
1520 dyn_addr = target_section.addr;
1521 found = true;
1522 break;
1523 }
1524 if (!found)
1525 {
1526 /* ABFD may come from OBJFILE acting only as a symbol file without being
1527 loaded into the target (see add_symbol_file_command). This case is
1528 such fallback to the file VMA address without the possibility of
1529 having the section relocated to its actual in-memory address. */
1530
1531 dyn_addr = bfd_section_vma (sect);
1532 }
1533
1534 /* Read in .dynamic from the BFD. We will get the actual value
1535 from memory later. */
1536 sect_size = bfd_section_size (sect);
1537 buf = bufstart = (gdb_byte *) alloca (sect_size);
1538 if (!bfd_get_section_contents (abfd, sect,
1539 buf, 0, sect_size))
1540 return 0;
1541
1542 /* Iterate over BUF and scan for DYNTAG. If found, set PTR and return. */
1543 step = (arch_size == 32) ? sizeof (Elf32_External_Dyn)
1544 : sizeof (Elf64_External_Dyn);
1545 for (bufend = buf + sect_size;
1546 buf < bufend;
1547 buf += step)
1548 {
1549 if (arch_size == 32)
1550 {
1551 x_dynp_32 = (Elf32_External_Dyn *) buf;
1552 current_dyntag = bfd_h_get_32 (abfd, (bfd_byte *) x_dynp_32->d_tag);
1553 dyn_ptr = bfd_h_get_32 (abfd, (bfd_byte *) x_dynp_32->d_un.d_ptr);
1554 }
1555 else
1556 {
1557 x_dynp_64 = (Elf64_External_Dyn *) buf;
1558 current_dyntag = bfd_h_get_64 (abfd, (bfd_byte *) x_dynp_64->d_tag);
1559 dyn_ptr = bfd_h_get_64 (abfd, (bfd_byte *) x_dynp_64->d_un.d_ptr);
1560 }
1561 if (current_dyntag == DT_NULL)
1562 return 0;
1563 if (current_dyntag == desired_dyntag)
1564 {
1565 /* If requested, try to read the runtime value of this .dynamic
1566 entry. */
1567 if (ptr)
1568 {
1569 struct type *ptr_type;
1570 gdb_byte ptr_buf[8];
1571 CORE_ADDR ptr_addr_1;
1572
1573 ptr_type = builtin_type (target_gdbarch ())->builtin_data_ptr;
1574 ptr_addr_1 = dyn_addr + (buf - bufstart) + arch_size / 8;
1575 if (target_read_memory (ptr_addr_1, ptr_buf, arch_size / 8) == 0)
1576 dyn_ptr = extract_typed_address (ptr_buf, ptr_type);
1577 *ptr = dyn_ptr;
1578 if (ptr_addr)
1579 *ptr_addr = dyn_addr + (buf - bufstart);
1580 }
1581 return 1;
1582 }
1583 }
1584
1585 return 0;
1586}
1587
cb457ae2
YQ
1588/* Lookup the value for a specific symbol from symbol table. Look up symbol
1589 from ABFD. MATCH_SYM is a callback function to determine whether to pick
1590 up a symbol. DATA is the input of this callback function. Return NULL
1591 if symbol is not found. */
1592
1593static CORE_ADDR
1594bfd_lookup_symbol_from_dyn_symtab (bfd *abfd,
3953f15c
SM
1595 int (*match_sym) (const asymbol *,
1596 const void *),
1597 const void *data)
cb457ae2
YQ
1598{
1599 long storage_needed = bfd_get_dynamic_symtab_upper_bound (abfd);
1600 CORE_ADDR symaddr = 0;
1601
1602 if (storage_needed > 0)
1603 {
1604 unsigned int i;
1cb1f3da
TT
1605 gdb::def_vector<asymbol *> storage (storage_needed / sizeof (asymbol *));
1606 asymbol **symbol_table = storage.data ();
cb457ae2
YQ
1607 unsigned int number_of_symbols =
1608 bfd_canonicalize_dynamic_symtab (abfd, symbol_table);
1609
1610 for (i = 0; i < number_of_symbols; i++)
1611 {
1612 asymbol *sym = *symbol_table++;
1613
1614 if (match_sym (sym, data))
1615 {
1616 /* BFD symbols are section relative. */
1617 symaddr = sym->value + sym->section->vma;
1618 break;
1619 }
1620 }
cb457ae2
YQ
1621 }
1622 return symaddr;
1623}
1624
1625/* Lookup the value for a specific symbol from symbol table and dynamic
1626 symbol table. Look up symbol from ABFD. MATCH_SYM is a callback
1627 function to determine whether to pick up a symbol. DATA is the
1628 input of this callback function. Return NULL if symbol is not
1629 found. */
1630
1631CORE_ADDR
1632gdb_bfd_lookup_symbol (bfd *abfd,
3953f15c
SM
1633 int (*match_sym) (const asymbol *, const void *),
1634 const void *data)
cb457ae2
YQ
1635{
1636 CORE_ADDR symaddr = gdb_bfd_lookup_symbol_from_symtab (abfd, match_sym, data);
1637
1638 /* On FreeBSD, the dynamic linker is stripped by default. So we'll
1639 have to check the dynamic string table too. */
1640 if (symaddr == 0)
1641 symaddr = bfd_lookup_symbol_from_dyn_symtab (abfd, match_sym, data);
1642
1643 return symaddr;
1644}
3a40aaa0 1645
a1fd1ac9
TT
1646/* The shared library list may contain user-loaded object files that
1647 can be removed out-of-band by the user. So upon notification of
1648 free_objfile remove all references to any user-loaded file that is
1649 about to be freed. */
63644780
NB
1650
1651static void
1652remove_user_added_objfile (struct objfile *objfile)
1653{
63644780
NB
1654 if (objfile != 0 && objfile->flags & OBJF_USERLOADED)
1655 {
a1fd1ac9 1656 for (struct so_list *so : current_program_space->solibs ())
63644780
NB
1657 if (so->objfile == objfile)
1658 so->objfile = NULL;
1659 }
1660}
1661
6c265988 1662void _initialize_solib ();
c906108c 1663void
6c265988 1664_initialize_solib ()
c906108c 1665{
66aba65d
MK
1666 solib_data = gdbarch_data_register_pre_init (solib_init);
1667
c90e7d63
SM
1668 gdb::observers::free_objfile.attach (remove_user_added_objfile,
1669 "solib");
42a4fec5
SM
1670 gdb::observers::inferior_execd.attach ([] (inferior *inf)
1671 {
1672 solib_create_inferior_hook (0);
c90e7d63 1673 }, "solib");
63644780 1674
c906108c 1675 add_com ("sharedlibrary", class_files, sharedlibrary_command,
1bedd215 1676 _("Load shared object library symbols for files matching REGEXP."));
e0f25bd9
SM
1677 cmd_list_element *info_sharedlibrary_cmd
1678 = add_info ("sharedlibrary", info_sharedlibrary_command,
1679 _("Status of loaded shared object libraries."));
1680 add_info_alias ("dll", info_sharedlibrary_cmd, 1);
c60a7562 1681 add_com ("nosharedlibrary", class_files, no_shared_libraries,
1bedd215 1682 _("Unload all shared object library symbols."));
c906108c 1683
5bf193a2
AC
1684 add_setshow_boolean_cmd ("auto-solib-add", class_support,
1685 &auto_solib_add, _("\
1686Set autoloading of shared library symbols."), _("\
1687Show autoloading of shared library symbols."), _("\
b7209cb4
FF
1688If \"on\", symbols from all shared object libraries will be loaded\n\
1689automatically when the inferior begins execution, when the dynamic linker\n\
1690informs gdb that a new library has been loaded, or when attaching to the\n\
3e43a32a
MS
1691inferior. Otherwise, symbols must be loaded manually, using \
1692`sharedlibrary'."),
5bf193a2 1693 NULL,
920d2a44 1694 show_auto_solib_add,
5bf193a2 1695 &setlist, &showlist);
c906108c 1696
5e84b7ee
SM
1697 set_show_commands sysroot_cmds
1698 = add_setshow_optional_filename_cmd ("sysroot", class_support,
1699 &gdb_sysroot, _("\
f822c95b
DJ
1700Set an alternate system root."), _("\
1701Show the current system root."), _("\
1702The system root is used to load absolute shared library symbol files.\n\
1703For other (relative) files, you can add directories using\n\
1704`set solib-search-path'."),
5e84b7ee
SM
1705 gdb_sysroot_changed,
1706 NULL,
1707 &setlist, &showlist);
c906108c 1708
5e84b7ee 1709 add_alias_cmd ("solib-absolute-prefix", sysroot_cmds.set, class_support, 0,
f822c95b 1710 &setlist);
5e84b7ee 1711 add_alias_cmd ("solib-absolute-prefix", sysroot_cmds.show, class_support, 0,
f822c95b 1712 &showlist);
030292b7 1713
525226b5
AC
1714 add_setshow_optional_filename_cmd ("solib-search-path", class_support,
1715 &solib_search_path, _("\
3e43a32a
MS
1716Set the search path for loading non-absolute shared library symbol files."),
1717 _("\
1718Show the search path for loading non-absolute shared library symbol files."),
1719 _("\
1720This takes precedence over the environment variables \
1721PATH and LD_LIBRARY_PATH."),
525226b5 1722 reload_shared_libraries,
920d2a44 1723 show_solib_search_path,
525226b5 1724 &setlist, &showlist);
c906108c 1725}