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