1 /* Handle SVR4 shared libraries for GDB, the GNU Debugger.
3 Copyright (C) 1990, 1991, 1992, 1993, 1994, 1995, 1996, 1998, 1999, 2000,
4 2001, 2003, 2004, 2005, 2006, 2007 Free Software Foundation, Inc.
6 This file is part of GDB.
8 This program is free software; you can redistribute it and/or modify
9 it under the terms of the GNU General Public License as published by
10 the Free Software Foundation; either version 2 of the License, or
11 (at your option) any later version.
13 This program is distributed in the hope that it will be useful,
14 but WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 GNU General Public License for more details.
18 You should have received a copy of the GNU General Public License
19 along with this program; if not, write to the Free Software
20 Foundation, Inc., 51 Franklin Street, Fifth Floor,
21 Boston, MA 02110-1301, USA. */
25 #include "elf/external.h"
26 #include "elf/common.h"
37 #include "gdb_assert.h"
41 #include "solib-svr4.h"
43 #include "bfd-target.h"
47 static struct link_map_offsets *svr4_fetch_link_map_offsets (void);
48 static int svr4_have_link_map_offsets (void);
50 /* This hook is set to a function that provides native link map
51 offsets if the code in solib-legacy.c is linked in. */
52 struct link_map_offsets *(*legacy_svr4_fetch_link_map_offsets_hook) (void);
54 /* Link map info to include in an allocated so_list entry */
58 /* Pointer to copy of link map from inferior. The type is char *
59 rather than void *, so that we may use byte offsets to find the
60 various fields without the need for a cast. */
63 /* Amount by which addresses in the binary should be relocated to
64 match the inferior. This could most often be taken directly
65 from lm, but when prelinking is involved and the prelink base
66 address changes, we may need a different offset, we want to
67 warn about the difference and compute it only once. */
71 /* On SVR4 systems, a list of symbols in the dynamic linker where
72 GDB can try to place a breakpoint to monitor shared library
75 If none of these symbols are found, or other errors occur, then
76 SVR4 systems will fall back to using a symbol as the "startup
77 mapping complete" breakpoint address. */
79 static char *solib_break_names[] =
90 #define BKPT_AT_SYMBOL 1
92 #if defined (BKPT_AT_SYMBOL)
93 static char *bkpt_names[] =
95 #ifdef SOLIB_BKPT_NAME
96 SOLIB_BKPT_NAME, /* Prefer configured name if it exists. */
105 static char *main_name_list[] =
111 /* link map access functions */
114 LM_ADDR_FROM_LINK_MAP (struct so_list *so)
116 struct link_map_offsets *lmo = svr4_fetch_link_map_offsets ();
118 return extract_typed_address (so->lm_info->lm + lmo->l_addr_offset,
119 builtin_type_void_data_ptr);
123 HAS_LM_DYNAMIC_FROM_LINK_MAP ()
125 struct link_map_offsets *lmo = svr4_fetch_link_map_offsets ();
127 return lmo->l_ld_offset >= 0;
131 LM_DYNAMIC_FROM_LINK_MAP (struct so_list *so)
133 struct link_map_offsets *lmo = svr4_fetch_link_map_offsets ();
135 return extract_typed_address (so->lm_info->lm + lmo->l_ld_offset,
136 builtin_type_void_data_ptr);
140 LM_ADDR_CHECK (struct so_list *so, bfd *abfd)
142 if (so->lm_info->l_addr == (CORE_ADDR)-1)
144 struct bfd_section *dyninfo_sect;
145 CORE_ADDR l_addr, l_dynaddr, dynaddr, align = 0x1000;
147 l_addr = LM_ADDR_FROM_LINK_MAP (so);
149 if (! abfd || ! HAS_LM_DYNAMIC_FROM_LINK_MAP ())
152 l_dynaddr = LM_DYNAMIC_FROM_LINK_MAP (so);
154 dyninfo_sect = bfd_get_section_by_name (abfd, ".dynamic");
155 if (dyninfo_sect == NULL)
158 dynaddr = bfd_section_vma (abfd, dyninfo_sect);
160 if (dynaddr + l_addr != l_dynaddr)
162 if (bfd_get_flavour (abfd) == bfd_target_elf_flavour)
164 Elf_Internal_Ehdr *ehdr = elf_tdata (abfd)->elf_header;
165 Elf_Internal_Phdr *phdr = elf_tdata (abfd)->phdr;
170 for (i = 0; i < ehdr->e_phnum; i++)
171 if (phdr[i].p_type == PT_LOAD && phdr[i].p_align > align)
172 align = phdr[i].p_align;
175 /* Turn it into a mask. */
178 /* If the changes match the alignment requirements, we
179 assume we're using a core file that was generated by the
180 same binary, just prelinked with a different base offset.
181 If it doesn't match, we may have a different binary, the
182 same binary with the dynamic table loaded at an unrelated
183 location, or anything, really. To avoid regressions,
184 don't adjust the base offset in the latter case, although
185 odds are that, if things really changed, debugging won't
187 if ((l_addr & align) == ((l_dynaddr - dynaddr) & align))
189 l_addr = l_dynaddr - dynaddr;
191 warning (_(".dynamic section for \"%s\" "
192 "is not at the expected address"), so->so_name);
193 warning (_("difference appears to be caused by prelink, "
194 "adjusting expectations"));
197 warning (_(".dynamic section for \"%s\" "
198 "is not at the expected address "
199 "(wrong library or version mismatch?)"), so->so_name);
203 so->lm_info->l_addr = l_addr;
206 return so->lm_info->l_addr;
210 LM_NEXT (struct so_list *so)
212 struct link_map_offsets *lmo = svr4_fetch_link_map_offsets ();
214 return extract_typed_address (so->lm_info->lm + lmo->l_next_offset,
215 builtin_type_void_data_ptr);
219 LM_NAME (struct so_list *so)
221 struct link_map_offsets *lmo = svr4_fetch_link_map_offsets ();
223 return extract_typed_address (so->lm_info->lm + lmo->l_name_offset,
224 builtin_type_void_data_ptr);
228 IGNORE_FIRST_LINK_MAP_ENTRY (struct so_list *so)
230 struct link_map_offsets *lmo = svr4_fetch_link_map_offsets ();
232 /* Assume that everything is a library if the dynamic loader was loaded
233 late by a static executable. */
234 if (bfd_get_section_by_name (exec_bfd, ".dynamic") == NULL)
237 return extract_typed_address (so->lm_info->lm + lmo->l_prev_offset,
238 builtin_type_void_data_ptr) == 0;
241 static CORE_ADDR debug_base; /* Base of dynamic linker structures */
243 /* Validity flag for debug_loader_offset. */
244 static int debug_loader_offset_p;
246 /* Load address for the dynamic linker, inferred. */
247 static CORE_ADDR debug_loader_offset;
249 /* Name of the dynamic linker, valid if debug_loader_offset_p. */
250 static char *debug_loader_name;
252 /* Local function prototypes */
254 static int match_main (char *);
256 static CORE_ADDR bfd_lookup_symbol (bfd *, char *);
262 bfd_lookup_symbol -- lookup the value for a specific symbol
266 CORE_ADDR bfd_lookup_symbol (bfd *abfd, char *symname)
270 An expensive way to lookup the value of a single symbol for
271 bfd's that are only temporary anyway. This is used by the
272 shared library support to find the address of the debugger
273 notification routine in the shared library.
275 The returned symbol may be in a code or data section; functions
276 will normally be in a code section, but may be in a data section
277 if this architecture uses function descriptors.
279 Note that 0 is specifically allowed as an error return (no
284 bfd_lookup_symbol (bfd *abfd, char *symname)
288 asymbol **symbol_table;
289 unsigned int number_of_symbols;
291 struct cleanup *back_to;
292 CORE_ADDR symaddr = 0;
294 storage_needed = bfd_get_symtab_upper_bound (abfd);
296 if (storage_needed > 0)
298 symbol_table = (asymbol **) xmalloc (storage_needed);
299 back_to = make_cleanup (xfree, symbol_table);
300 number_of_symbols = bfd_canonicalize_symtab (abfd, symbol_table);
302 for (i = 0; i < number_of_symbols; i++)
304 sym = *symbol_table++;
305 if (strcmp (sym->name, symname) == 0
306 && (sym->section->flags & (SEC_CODE | SEC_DATA)) != 0)
308 /* BFD symbols are section relative. */
309 symaddr = sym->value + sym->section->vma;
313 do_cleanups (back_to);
319 /* On FreeBSD, the dynamic linker is stripped by default. So we'll
320 have to check the dynamic string table too. */
322 storage_needed = bfd_get_dynamic_symtab_upper_bound (abfd);
324 if (storage_needed > 0)
326 symbol_table = (asymbol **) xmalloc (storage_needed);
327 back_to = make_cleanup (xfree, symbol_table);
328 number_of_symbols = bfd_canonicalize_dynamic_symtab (abfd, symbol_table);
330 for (i = 0; i < number_of_symbols; i++)
332 sym = *symbol_table++;
334 if (strcmp (sym->name, symname) == 0
335 && (sym->section->flags & (SEC_CODE | SEC_DATA)) != 0)
337 /* BFD symbols are section relative. */
338 symaddr = sym->value + sym->section->vma;
342 do_cleanups (back_to);
348 /* Scan for DYNTAG in .dynamic section of ABFD. If DYNTAG is found 1 is
349 returned and the corresponding PTR is set. */
352 scan_dyntag (int dyntag, bfd *abfd, CORE_ADDR *ptr)
354 int arch_size, step, sect_size;
356 CORE_ADDR dyn_ptr, dyn_addr;
357 gdb_byte *bufend, *bufstart, *buf;
358 Elf32_External_Dyn *x_dynp_32;
359 Elf64_External_Dyn *x_dynp_64;
360 struct bfd_section *sect;
364 arch_size = bfd_get_arch_size (abfd);
368 /* Find the start address of the .dynamic section. */
369 sect = bfd_get_section_by_name (abfd, ".dynamic");
372 dyn_addr = bfd_section_vma (abfd, sect);
374 /* Read in .dynamic from the BFD. We will get the actual value
375 from memory later. */
376 sect_size = bfd_section_size (abfd, sect);
377 buf = bufstart = alloca (sect_size);
378 if (!bfd_get_section_contents (abfd, sect,
382 /* Iterate over BUF and scan for DYNTAG. If found, set PTR and return. */
383 step = (arch_size == 32) ? sizeof (Elf32_External_Dyn)
384 : sizeof (Elf64_External_Dyn);
385 for (bufend = buf + sect_size;
391 x_dynp_32 = (Elf32_External_Dyn *) buf;
392 dyn_tag = bfd_h_get_32 (abfd, (bfd_byte *) x_dynp_32->d_tag);
393 dyn_ptr = bfd_h_get_32 (abfd, (bfd_byte *) x_dynp_32->d_un.d_ptr);
397 x_dynp_64 = (Elf64_External_Dyn *) buf;
398 dyn_tag = bfd_h_get_64 (abfd, (bfd_byte *) x_dynp_64->d_tag);
399 dyn_ptr = bfd_h_get_64 (abfd, (bfd_byte *) x_dynp_64->d_un.d_ptr);
401 if (dyn_tag == DT_NULL)
403 if (dyn_tag == dyntag)
405 /* If requested, try to read the runtime value of this .dynamic
412 ptr_addr = dyn_addr + (buf - bufstart) + arch_size / 8;
413 if (target_read_memory (ptr_addr, ptr_buf, arch_size / 8) == 0)
414 dyn_ptr = extract_typed_address (ptr_buf,
415 builtin_type_void_data_ptr);
430 elf_locate_base -- locate the base address of dynamic linker structs
431 for SVR4 elf targets.
435 CORE_ADDR elf_locate_base (void)
439 For SVR4 elf targets the address of the dynamic linker's runtime
440 structure is contained within the dynamic info section in the
441 executable file. The dynamic section is also mapped into the
442 inferior address space. Because the runtime loader fills in the
443 real address before starting the inferior, we have to read in the
444 dynamic info section from the inferior address space.
445 If there are any errors while trying to find the address, we
446 silently return 0, otherwise the found address is returned.
451 elf_locate_base (void)
453 struct minimal_symbol *msymbol;
456 /* Look for DT_MIPS_RLD_MAP first. MIPS executables use this
457 instead of DT_DEBUG, although they sometimes contain an unused
459 if (scan_dyntag (DT_MIPS_RLD_MAP, exec_bfd, &dyn_ptr))
462 int pbuf_size = TYPE_LENGTH (builtin_type_void_data_ptr);
463 pbuf = alloca (pbuf_size);
464 /* DT_MIPS_RLD_MAP contains a pointer to the address
465 of the dynamic link structure. */
466 if (target_read_memory (dyn_ptr, pbuf, pbuf_size))
468 return extract_typed_address (pbuf, builtin_type_void_data_ptr);
472 if (scan_dyntag (DT_DEBUG, exec_bfd, &dyn_ptr))
475 /* This may be a static executable. Look for the symbol
476 conventionally named _r_debug, as a last resort. */
477 msymbol = lookup_minimal_symbol ("_r_debug", NULL, symfile_objfile);
479 return SYMBOL_VALUE_ADDRESS (msymbol);
481 /* DT_DEBUG entry not found. */
489 locate_base -- locate the base address of dynamic linker structs
493 CORE_ADDR locate_base (void)
497 For both the SunOS and SVR4 shared library implementations, if the
498 inferior executable has been linked dynamically, there is a single
499 address somewhere in the inferior's data space which is the key to
500 locating all of the dynamic linker's runtime structures. This
501 address is the value of the debug base symbol. The job of this
502 function is to find and return that address, or to return 0 if there
503 is no such address (the executable is statically linked for example).
505 For SunOS, the job is almost trivial, since the dynamic linker and
506 all of it's structures are statically linked to the executable at
507 link time. Thus the symbol for the address we are looking for has
508 already been added to the minimal symbol table for the executable's
509 objfile at the time the symbol file's symbols were read, and all we
510 have to do is look it up there. Note that we explicitly do NOT want
511 to find the copies in the shared library.
513 The SVR4 version is a bit more complicated because the address
514 is contained somewhere in the dynamic info section. We have to go
515 to a lot more work to discover the address of the debug base symbol.
516 Because of this complexity, we cache the value we find and return that
517 value on subsequent invocations. Note there is no copy in the
518 executable symbol tables.
525 /* Check to see if we have a currently valid address, and if so, avoid
526 doing all this work again and just return the cached address. If
527 we have no cached address, try to locate it in the dynamic info
528 section for ELF executables. There's no point in doing any of this
529 though if we don't have some link map offsets to work with. */
531 if (debug_base == 0 && svr4_have_link_map_offsets ())
534 && bfd_get_flavour (exec_bfd) == bfd_target_elf_flavour)
535 debug_base = elf_locate_base ();
540 /* Find the first element in the inferior's dynamic link map, and
541 return its address in the inferior.
543 FIXME: Perhaps we should validate the info somehow, perhaps by
544 checking r_version for a known version number, or r_state for
548 solib_svr4_r_map (void)
550 struct link_map_offsets *lmo = svr4_fetch_link_map_offsets ();
552 return read_memory_typed_address (debug_base + lmo->r_map_offset,
553 builtin_type_void_data_ptr);
556 /* Find the link map for the dynamic linker (if it is not in the
557 normal list of loaded shared objects). */
560 solib_svr4_r_ldsomap (void)
562 struct link_map_offsets *lmo = svr4_fetch_link_map_offsets ();
565 /* Check version, and return zero if `struct r_debug' doesn't have
566 the r_ldsomap member. */
567 version = read_memory_unsigned_integer (debug_base + lmo->r_version_offset,
568 lmo->r_version_size);
569 if (version < 2 || lmo->r_ldsomap_offset == -1)
572 return read_memory_typed_address (debug_base + lmo->r_ldsomap_offset,
573 builtin_type_void_data_ptr);
580 open_symbol_file_object
584 void open_symbol_file_object (void *from_tty)
588 If no open symbol file, attempt to locate and open the main symbol
589 file. On SVR4 systems, this is the first link map entry. If its
590 name is here, we can open it. Useful when attaching to a process
591 without first loading its symbol file.
593 If FROM_TTYP dereferences to a non-zero integer, allow messages to
594 be printed. This parameter is a pointer rather than an int because
595 open_symbol_file_object() is called via catch_errors() and
596 catch_errors() requires a pointer argument. */
599 open_symbol_file_object (void *from_ttyp)
601 CORE_ADDR lm, l_name;
604 int from_tty = *(int *)from_ttyp;
605 struct link_map_offsets *lmo = svr4_fetch_link_map_offsets ();
606 int l_name_size = TYPE_LENGTH (builtin_type_void_data_ptr);
607 gdb_byte *l_name_buf = xmalloc (l_name_size);
608 struct cleanup *cleanups = make_cleanup (xfree, l_name_buf);
611 if (!query ("Attempt to reload symbols from process? "))
614 if ((debug_base = locate_base ()) == 0)
615 return 0; /* failed somehow... */
617 /* First link map member should be the executable. */
618 lm = solib_svr4_r_map ();
620 return 0; /* failed somehow... */
622 /* Read address of name from target memory to GDB. */
623 read_memory (lm + lmo->l_name_offset, l_name_buf, l_name_size);
625 /* Convert the address to host format. */
626 l_name = extract_typed_address (l_name_buf, builtin_type_void_data_ptr);
628 /* Free l_name_buf. */
629 do_cleanups (cleanups);
632 return 0; /* No filename. */
634 /* Now fetch the filename from target memory. */
635 target_read_string (l_name, &filename, SO_NAME_MAX_PATH_SIZE - 1, &errcode);
636 make_cleanup (xfree, filename);
640 warning (_("failed to read exec filename from attached file: %s"),
641 safe_strerror (errcode));
645 /* Have a pathname: read the symbol file. */
646 symbol_file_add_main (filename, from_tty);
651 /* If no shared library information is available from the dynamic
652 linker, build a fallback list from other sources. */
654 static struct so_list *
655 svr4_default_sos (void)
657 struct so_list *head = NULL;
658 struct so_list **link_ptr = &head;
660 if (debug_loader_offset_p)
662 struct so_list *new = XZALLOC (struct so_list);
664 new->lm_info = xmalloc (sizeof (struct lm_info));
666 /* Nothing will ever check the cached copy of the link
667 map if we set l_addr. */
668 new->lm_info->l_addr = debug_loader_offset;
669 new->lm_info->lm = NULL;
671 strncpy (new->so_name, debug_loader_name, SO_NAME_MAX_PATH_SIZE - 1);
672 new->so_name[SO_NAME_MAX_PATH_SIZE - 1] = '\0';
673 strcpy (new->so_original_name, new->so_name);
676 link_ptr = &new->next;
684 current_sos -- build a list of currently loaded shared objects
688 struct so_list *current_sos ()
692 Build a list of `struct so_list' objects describing the shared
693 objects currently loaded in the inferior. This list does not
694 include an entry for the main executable file.
696 Note that we only gather information directly available from the
697 inferior --- we don't examine any of the shared library files
698 themselves. The declaration of `struct so_list' says which fields
699 we provide values for. */
701 static struct so_list *
702 svr4_current_sos (void)
705 struct so_list *head = 0;
706 struct so_list **link_ptr = &head;
707 CORE_ADDR ldsomap = 0;
709 /* Make sure we've looked up the inferior's dynamic linker's base
713 debug_base = locate_base ();
715 /* If we can't find the dynamic linker's base structure, this
716 must not be a dynamically linked executable. Hmm. */
718 return svr4_default_sos ();
721 /* Walk the inferior's link map list, and build our list of
722 `struct so_list' nodes. */
723 lm = solib_svr4_r_map ();
727 struct link_map_offsets *lmo = svr4_fetch_link_map_offsets ();
728 struct so_list *new = XZALLOC (struct so_list);
729 struct cleanup *old_chain = make_cleanup (xfree, new);
731 new->lm_info = xmalloc (sizeof (struct lm_info));
732 make_cleanup (xfree, new->lm_info);
734 new->lm_info->l_addr = (CORE_ADDR)-1;
735 new->lm_info->lm = xzalloc (lmo->link_map_size);
736 make_cleanup (xfree, new->lm_info->lm);
738 read_memory (lm, new->lm_info->lm, lmo->link_map_size);
742 /* For SVR4 versions, the first entry in the link map is for the
743 inferior executable, so we must ignore it. For some versions of
744 SVR4, it has no name. For others (Solaris 2.3 for example), it
745 does have a name, so we can no longer use a missing name to
746 decide when to ignore it. */
747 if (IGNORE_FIRST_LINK_MAP_ENTRY (new) && ldsomap == 0)
754 /* Extract this shared object's name. */
755 target_read_string (LM_NAME (new), &buffer,
756 SO_NAME_MAX_PATH_SIZE - 1, &errcode);
758 warning (_("Can't read pathname for load map: %s."),
759 safe_strerror (errcode));
762 strncpy (new->so_name, buffer, SO_NAME_MAX_PATH_SIZE - 1);
763 new->so_name[SO_NAME_MAX_PATH_SIZE - 1] = '\0';
764 strcpy (new->so_original_name, new->so_name);
768 /* If this entry has no name, or its name matches the name
769 for the main executable, don't include it in the list. */
770 if (! new->so_name[0]
771 || match_main (new->so_name))
777 link_ptr = &new->next;
781 /* On Solaris, the dynamic linker is not in the normal list of
782 shared objects, so make sure we pick it up too. Having
783 symbol information for the dynamic linker is quite crucial
784 for skipping dynamic linker resolver code. */
785 if (lm == 0 && ldsomap == 0)
786 lm = ldsomap = solib_svr4_r_ldsomap ();
788 discard_cleanups (old_chain);
792 return svr4_default_sos ();
797 /* Get the address of the link_map for a given OBJFILE. Loop through
798 the link maps, and return the address of the one corresponding to
799 the given objfile. Note that this function takes into account that
800 objfile can be the main executable, not just a shared library. The
801 main executable has always an empty name field in the linkmap. */
804 svr4_fetch_objfile_link_map (struct objfile *objfile)
808 if ((debug_base = locate_base ()) == 0)
809 return 0; /* failed somehow... */
811 /* Position ourselves on the first link map. */
812 lm = solib_svr4_r_map ();
815 /* Get info on the layout of the r_debug and link_map structures. */
816 struct link_map_offsets *lmo = svr4_fetch_link_map_offsets ();
819 struct lm_info objfile_lm_info;
820 struct cleanup *old_chain;
821 CORE_ADDR name_address;
822 int l_name_size = TYPE_LENGTH (builtin_type_void_data_ptr);
823 gdb_byte *l_name_buf = xmalloc (l_name_size);
824 old_chain = make_cleanup (xfree, l_name_buf);
826 /* Set up the buffer to contain the portion of the link_map
827 structure that gdb cares about. Note that this is not the
828 whole link_map structure. */
829 objfile_lm_info.lm = xzalloc (lmo->link_map_size);
830 make_cleanup (xfree, objfile_lm_info.lm);
832 /* Read the link map into our internal structure. */
833 read_memory (lm, objfile_lm_info.lm, lmo->link_map_size);
835 /* Read address of name from target memory to GDB. */
836 read_memory (lm + lmo->l_name_offset, l_name_buf, l_name_size);
838 /* Extract this object's name. */
839 name_address = extract_typed_address (l_name_buf,
840 builtin_type_void_data_ptr);
841 target_read_string (name_address, &buffer,
842 SO_NAME_MAX_PATH_SIZE - 1, &errcode);
843 make_cleanup (xfree, buffer);
845 warning (_("Can't read pathname for load map: %s."),
846 safe_strerror (errcode));
849 /* Is this the linkmap for the file we want? */
850 /* If the file is not a shared library and has no name,
851 we are sure it is the main executable, so we return that. */
854 && ((strcmp (buffer, objfile->name) == 0)
855 || (!(objfile->flags & OBJF_SHARED)
856 && (strcmp (buffer, "") == 0))))
858 do_cleanups (old_chain);
862 /* Not the file we wanted, continue checking. */
863 lm = extract_typed_address (objfile_lm_info.lm + lmo->l_next_offset,
864 builtin_type_void_data_ptr);
865 do_cleanups (old_chain);
870 /* On some systems, the only way to recognize the link map entry for
871 the main executable file is by looking at its name. Return
872 non-zero iff SONAME matches one of the known main executable names. */
875 match_main (char *soname)
879 for (mainp = main_name_list; *mainp != NULL; mainp++)
881 if (strcmp (soname, *mainp) == 0)
888 /* Return 1 if PC lies in the dynamic symbol resolution code of the
889 SVR4 run time loader. */
890 static CORE_ADDR interp_text_sect_low;
891 static CORE_ADDR interp_text_sect_high;
892 static CORE_ADDR interp_plt_sect_low;
893 static CORE_ADDR interp_plt_sect_high;
896 svr4_in_dynsym_resolve_code (CORE_ADDR pc)
898 return ((pc >= interp_text_sect_low && pc < interp_text_sect_high)
899 || (pc >= interp_plt_sect_low && pc < interp_plt_sect_high)
900 || in_plt_section (pc, NULL));
903 /* Given an executable's ABFD and target, compute the entry-point
907 exec_entry_point (struct bfd *abfd, struct target_ops *targ)
909 /* KevinB wrote ... for most targets, the address returned by
910 bfd_get_start_address() is the entry point for the start
911 function. But, for some targets, bfd_get_start_address() returns
912 the address of a function descriptor from which the entry point
913 address may be extracted. This address is extracted by
914 gdbarch_convert_from_func_ptr_addr(). The method
915 gdbarch_convert_from_func_ptr_addr() is the merely the identify
916 function for targets which don't use function descriptors. */
917 return gdbarch_convert_from_func_ptr_addr (current_gdbarch,
918 bfd_get_start_address (abfd),
926 enable_break -- arrange for dynamic linker to hit breakpoint
930 int enable_break (void)
934 Both the SunOS and the SVR4 dynamic linkers have, as part of their
935 debugger interface, support for arranging for the inferior to hit
936 a breakpoint after mapping in the shared libraries. This function
937 enables that breakpoint.
939 For SunOS, there is a special flag location (in_debugger) which we
940 set to 1. When the dynamic linker sees this flag set, it will set
941 a breakpoint at a location known only to itself, after saving the
942 original contents of that place and the breakpoint address itself,
943 in it's own internal structures. When we resume the inferior, it
944 will eventually take a SIGTRAP when it runs into the breakpoint.
945 We handle this (in a different place) by restoring the contents of
946 the breakpointed location (which is only known after it stops),
947 chasing around to locate the shared libraries that have been
948 loaded, then resuming.
950 For SVR4, the debugger interface structure contains a member (r_brk)
951 which is statically initialized at the time the shared library is
952 built, to the offset of a function (_r_debug_state) which is guaran-
953 teed to be called once before mapping in a library, and again when
954 the mapping is complete. At the time we are examining this member,
955 it contains only the unrelocated offset of the function, so we have
956 to do our own relocation. Later, when the dynamic linker actually
957 runs, it relocates r_brk to be the actual address of _r_debug_state().
959 The debugger interface structure also contains an enumeration which
960 is set to either RT_ADD or RT_DELETE prior to changing the mapping,
961 depending upon whether or not the library is being mapped or unmapped,
962 and then set to RT_CONSISTENT after the library is mapped/unmapped.
968 #ifdef BKPT_AT_SYMBOL
970 struct minimal_symbol *msymbol;
972 asection *interp_sect;
974 /* First, remove all the solib event breakpoints. Their addresses
975 may have changed since the last time we ran the program. */
976 remove_solib_event_breakpoints ();
978 interp_text_sect_low = interp_text_sect_high = 0;
979 interp_plt_sect_low = interp_plt_sect_high = 0;
981 /* Find the .interp section; if not found, warn the user and drop
982 into the old breakpoint at symbol code. */
983 interp_sect = bfd_get_section_by_name (exec_bfd, ".interp");
986 unsigned int interp_sect_size;
988 CORE_ADDR load_addr = 0;
989 int load_addr_found = 0;
992 struct target_ops *tmp_bfd_target;
994 char *tmp_pathname = NULL;
995 CORE_ADDR sym_addr = 0;
997 /* Read the contents of the .interp section into a local buffer;
998 the contents specify the dynamic linker this program uses. */
999 interp_sect_size = bfd_section_size (exec_bfd, interp_sect);
1000 buf = alloca (interp_sect_size);
1001 bfd_get_section_contents (exec_bfd, interp_sect,
1002 buf, 0, interp_sect_size);
1004 /* Now we need to figure out where the dynamic linker was
1005 loaded so that we can load its symbols and place a breakpoint
1006 in the dynamic linker itself.
1008 This address is stored on the stack. However, I've been unable
1009 to find any magic formula to find it for Solaris (appears to
1010 be trivial on GNU/Linux). Therefore, we have to try an alternate
1011 mechanism to find the dynamic linker's base address. */
1013 /* TODO drow/2006-09-12: This is somewhat fragile, because it
1014 relies on read_pc. On both Solaris and GNU/Linux we can use
1015 the AT_BASE auxilliary entry, which GDB now knows how to
1016 access, to find the base address. */
1018 tmp_fd = solib_open (buf, &tmp_pathname);
1020 tmp_bfd = bfd_fopen (tmp_pathname, gnutarget, FOPEN_RB, tmp_fd);
1022 if (tmp_bfd == NULL)
1023 goto bkpt_at_symbol;
1025 /* Make sure the dynamic linker's really a useful object. */
1026 if (!bfd_check_format (tmp_bfd, bfd_object))
1028 warning (_("Unable to grok dynamic linker %s as an object file"), buf);
1029 bfd_close (tmp_bfd);
1030 goto bkpt_at_symbol;
1033 /* Now convert the TMP_BFD into a target. That way target, as
1034 well as BFD operations can be used. Note that closing the
1035 target will also close the underlying bfd. */
1036 tmp_bfd_target = target_bfd_reopen (tmp_bfd);
1038 /* On a running target, we can get the dynamic linker's base
1039 address from the shared library table. */
1040 solib_add (NULL, 0, ¤t_target, auto_solib_add);
1041 so = master_so_list ();
1044 if (strcmp (buf, so->so_original_name) == 0)
1046 load_addr_found = 1;
1047 load_addr = LM_ADDR_CHECK (so, tmp_bfd);
1053 /* Otherwise we find the dynamic linker's base address by examining
1054 the current pc (which should point at the entry point for the
1055 dynamic linker) and subtracting the offset of the entry point. */
1056 if (!load_addr_found)
1058 load_addr = (read_pc ()
1059 - exec_entry_point (tmp_bfd, tmp_bfd_target));
1060 debug_loader_name = xstrdup (buf);
1061 debug_loader_offset_p = 1;
1062 debug_loader_offset = load_addr;
1063 solib_add (NULL, 0, ¤t_target, auto_solib_add);
1066 /* Record the relocated start and end address of the dynamic linker
1067 text and plt section for svr4_in_dynsym_resolve_code. */
1068 interp_sect = bfd_get_section_by_name (tmp_bfd, ".text");
1071 interp_text_sect_low =
1072 bfd_section_vma (tmp_bfd, interp_sect) + load_addr;
1073 interp_text_sect_high =
1074 interp_text_sect_low + bfd_section_size (tmp_bfd, interp_sect);
1076 interp_sect = bfd_get_section_by_name (tmp_bfd, ".plt");
1079 interp_plt_sect_low =
1080 bfd_section_vma (tmp_bfd, interp_sect) + load_addr;
1081 interp_plt_sect_high =
1082 interp_plt_sect_low + bfd_section_size (tmp_bfd, interp_sect);
1085 /* Now try to set a breakpoint in the dynamic linker. */
1086 for (bkpt_namep = solib_break_names; *bkpt_namep != NULL; bkpt_namep++)
1088 sym_addr = bfd_lookup_symbol (tmp_bfd, *bkpt_namep);
1094 /* Convert 'sym_addr' from a function pointer to an address.
1095 Because we pass tmp_bfd_target instead of the current
1096 target, this will always produce an unrelocated value. */
1097 sym_addr = gdbarch_convert_from_func_ptr_addr (current_gdbarch,
1101 /* We're done with both the temporary bfd and target. Remember,
1102 closing the target closes the underlying bfd. */
1103 target_close (tmp_bfd_target, 0);
1107 create_solib_event_breakpoint (load_addr + sym_addr);
1111 /* For whatever reason we couldn't set a breakpoint in the dynamic
1112 linker. Warn and drop into the old code. */
1114 xfree (tmp_pathname);
1115 warning (_("Unable to find dynamic linker breakpoint function.\n"
1116 "GDB will be unable to debug shared library initializers\n"
1117 "and track explicitly loaded dynamic code."));
1120 /* Scan through the lists of symbols, trying to look up the symbol and
1121 set a breakpoint there. Terminate loop when we/if we succeed. */
1123 for (bkpt_namep = solib_break_names; *bkpt_namep != NULL; bkpt_namep++)
1125 msymbol = lookup_minimal_symbol (*bkpt_namep, NULL, symfile_objfile);
1126 if ((msymbol != NULL) && (SYMBOL_VALUE_ADDRESS (msymbol) != 0))
1128 create_solib_event_breakpoint (SYMBOL_VALUE_ADDRESS (msymbol));
1133 for (bkpt_namep = bkpt_names; *bkpt_namep != NULL; bkpt_namep++)
1135 msymbol = lookup_minimal_symbol (*bkpt_namep, NULL, symfile_objfile);
1136 if ((msymbol != NULL) && (SYMBOL_VALUE_ADDRESS (msymbol) != 0))
1138 create_solib_event_breakpoint (SYMBOL_VALUE_ADDRESS (msymbol));
1142 #endif /* BKPT_AT_SYMBOL */
1151 special_symbol_handling -- additional shared library symbol handling
1155 void special_symbol_handling ()
1159 Once the symbols from a shared object have been loaded in the usual
1160 way, we are called to do any system specific symbol handling that
1163 For SunOS4, this consisted of grunging around in the dynamic
1164 linkers structures to find symbol definitions for "common" symbols
1165 and adding them to the minimal symbol table for the runtime common
1168 However, for SVR4, there's nothing to do.
1173 svr4_special_symbol_handling (void)
1177 /* Relocate the main executable. This function should be called upon
1178 stopping the inferior process at the entry point to the program.
1179 The entry point from BFD is compared to the PC and if they are
1180 different, the main executable is relocated by the proper amount.
1182 As written it will only attempt to relocate executables which
1183 lack interpreter sections. It seems likely that only dynamic
1184 linker executables will get relocated, though it should work
1185 properly for a position-independent static executable as well. */
1188 svr4_relocate_main_executable (void)
1190 asection *interp_sect;
1191 CORE_ADDR pc = read_pc ();
1193 /* Decide if the objfile needs to be relocated. As indicated above,
1194 we will only be here when execution is stopped at the beginning
1195 of the program. Relocation is necessary if the address at which
1196 we are presently stopped differs from the start address stored in
1197 the executable AND there's no interpreter section. The condition
1198 regarding the interpreter section is very important because if
1199 there *is* an interpreter section, execution will begin there
1200 instead. When there is an interpreter section, the start address
1201 is (presumably) used by the interpreter at some point to start
1202 execution of the program.
1204 If there is an interpreter, it is normal for it to be set to an
1205 arbitrary address at the outset. The job of finding it is
1206 handled in enable_break().
1208 So, to summarize, relocations are necessary when there is no
1209 interpreter section and the start address obtained from the
1210 executable is different from the address at which GDB is
1213 [ The astute reader will note that we also test to make sure that
1214 the executable in question has the DYNAMIC flag set. It is my
1215 opinion that this test is unnecessary (undesirable even). It
1216 was added to avoid inadvertent relocation of an executable
1217 whose e_type member in the ELF header is not ET_DYN. There may
1218 be a time in the future when it is desirable to do relocations
1219 on other types of files as well in which case this condition
1220 should either be removed or modified to accomodate the new file
1221 type. (E.g, an ET_EXEC executable which has been built to be
1222 position-independent could safely be relocated by the OS if
1223 desired. It is true that this violates the ABI, but the ABI
1224 has been known to be bent from time to time.) - Kevin, Nov 2000. ]
1227 interp_sect = bfd_get_section_by_name (exec_bfd, ".interp");
1228 if (interp_sect == NULL
1229 && (bfd_get_file_flags (exec_bfd) & DYNAMIC) != 0
1230 && (exec_entry_point (exec_bfd, &exec_ops) != pc))
1232 struct cleanup *old_chain;
1233 struct section_offsets *new_offsets;
1235 CORE_ADDR displacement;
1237 /* It is necessary to relocate the objfile. The amount to
1238 relocate by is simply the address at which we are stopped
1239 minus the starting address from the executable.
1241 We relocate all of the sections by the same amount. This
1242 behavior is mandated by recent editions of the System V ABI.
1243 According to the System V Application Binary Interface,
1244 Edition 4.1, page 5-5:
1246 ... Though the system chooses virtual addresses for
1247 individual processes, it maintains the segments' relative
1248 positions. Because position-independent code uses relative
1249 addressesing between segments, the difference between
1250 virtual addresses in memory must match the difference
1251 between virtual addresses in the file. The difference
1252 between the virtual address of any segment in memory and
1253 the corresponding virtual address in the file is thus a
1254 single constant value for any one executable or shared
1255 object in a given process. This difference is the base
1256 address. One use of the base address is to relocate the
1257 memory image of the program during dynamic linking.
1259 The same language also appears in Edition 4.0 of the System V
1260 ABI and is left unspecified in some of the earlier editions. */
1262 displacement = pc - exec_entry_point (exec_bfd, &exec_ops);
1265 new_offsets = xcalloc (symfile_objfile->num_sections,
1266 sizeof (struct section_offsets));
1267 old_chain = make_cleanup (xfree, new_offsets);
1269 for (i = 0; i < symfile_objfile->num_sections; i++)
1271 if (displacement != ANOFFSET (symfile_objfile->section_offsets, i))
1273 new_offsets->offsets[i] = displacement;
1277 objfile_relocate (symfile_objfile, new_offsets);
1279 do_cleanups (old_chain);
1287 svr4_solib_create_inferior_hook -- shared library startup support
1291 void svr4_solib_create_inferior_hook ()
1295 When gdb starts up the inferior, it nurses it along (through the
1296 shell) until it is ready to execute it's first instruction. At this
1297 point, this function gets called via expansion of the macro
1298 SOLIB_CREATE_INFERIOR_HOOK.
1300 For SunOS executables, this first instruction is typically the
1301 one at "_start", or a similar text label, regardless of whether
1302 the executable is statically or dynamically linked. The runtime
1303 startup code takes care of dynamically linking in any shared
1304 libraries, once gdb allows the inferior to continue.
1306 For SVR4 executables, this first instruction is either the first
1307 instruction in the dynamic linker (for dynamically linked
1308 executables) or the instruction at "start" for statically linked
1309 executables. For dynamically linked executables, the system
1310 first exec's /lib/libc.so.N, which contains the dynamic linker,
1311 and starts it running. The dynamic linker maps in any needed
1312 shared libraries, maps in the actual user executable, and then
1313 jumps to "start" in the user executable.
1315 For both SunOS shared libraries, and SVR4 shared libraries, we
1316 can arrange to cooperate with the dynamic linker to discover the
1317 names of shared libraries that are dynamically linked, and the
1318 base addresses to which they are linked.
1320 This function is responsible for discovering those names and
1321 addresses, and saving sufficient information about them to allow
1322 their symbols to be read at a later time.
1326 Between enable_break() and disable_break(), this code does not
1327 properly handle hitting breakpoints which the user might have
1328 set in the startup code or in the dynamic linker itself. Proper
1329 handling will probably have to wait until the implementation is
1330 changed to use the "breakpoint handler function" method.
1332 Also, what if child has exit()ed? Must exit loop somehow.
1336 svr4_solib_create_inferior_hook (void)
1338 /* Relocate the main executable if necessary. */
1339 svr4_relocate_main_executable ();
1341 if (!svr4_have_link_map_offsets ())
1344 if (!enable_break ())
1347 #if defined(_SCO_DS)
1348 /* SCO needs the loop below, other systems should be using the
1349 special shared library breakpoints and the shared library breakpoint
1352 Now run the target. It will eventually hit the breakpoint, at
1353 which point all of the libraries will have been mapped in and we
1354 can go groveling around in the dynamic linker structures to find
1355 out what we need to know about them. */
1357 clear_proceed_status ();
1358 stop_soon = STOP_QUIETLY;
1359 stop_signal = TARGET_SIGNAL_0;
1362 target_resume (pid_to_ptid (-1), 0, stop_signal);
1363 wait_for_inferior ();
1365 while (stop_signal != TARGET_SIGNAL_TRAP);
1366 stop_soon = NO_STOP_QUIETLY;
1367 #endif /* defined(_SCO_DS) */
1371 svr4_clear_solib (void)
1374 debug_loader_offset_p = 0;
1375 debug_loader_offset = 0;
1376 xfree (debug_loader_name);
1377 debug_loader_name = NULL;
1381 svr4_free_so (struct so_list *so)
1383 xfree (so->lm_info->lm);
1384 xfree (so->lm_info);
1388 /* Clear any bits of ADDR that wouldn't fit in a target-format
1389 data pointer. "Data pointer" here refers to whatever sort of
1390 address the dynamic linker uses to manage its sections. At the
1391 moment, we don't support shared libraries on any processors where
1392 code and data pointers are different sizes.
1394 This isn't really the right solution. What we really need here is
1395 a way to do arithmetic on CORE_ADDR values that respects the
1396 natural pointer/address correspondence. (For example, on the MIPS,
1397 converting a 32-bit pointer to a 64-bit CORE_ADDR requires you to
1398 sign-extend the value. There, simply truncating the bits above
1399 gdbarch_ptr_bit, as we do below, is no good.) This should probably
1400 be a new gdbarch method or something. */
1402 svr4_truncate_ptr (CORE_ADDR addr)
1404 if (gdbarch_ptr_bit (current_gdbarch) == sizeof (CORE_ADDR) * 8)
1405 /* We don't need to truncate anything, and the bit twiddling below
1406 will fail due to overflow problems. */
1409 return addr & (((CORE_ADDR) 1 << gdbarch_ptr_bit (current_gdbarch)) - 1);
1414 svr4_relocate_section_addresses (struct so_list *so,
1415 struct section_table *sec)
1417 sec->addr = svr4_truncate_ptr (sec->addr + LM_ADDR_CHECK (so,
1419 sec->endaddr = svr4_truncate_ptr (sec->endaddr + LM_ADDR_CHECK (so,
1424 /* Architecture-specific operations. */
1426 /* Per-architecture data key. */
1427 static struct gdbarch_data *solib_svr4_data;
1429 struct solib_svr4_ops
1431 /* Return a description of the layout of `struct link_map'. */
1432 struct link_map_offsets *(*fetch_link_map_offsets)(void);
1435 /* Return a default for the architecture-specific operations. */
1438 solib_svr4_init (struct obstack *obstack)
1440 struct solib_svr4_ops *ops;
1442 ops = OBSTACK_ZALLOC (obstack, struct solib_svr4_ops);
1443 ops->fetch_link_map_offsets = legacy_svr4_fetch_link_map_offsets_hook;
1447 /* Set the architecture-specific `struct link_map_offsets' fetcher for
1451 set_solib_svr4_fetch_link_map_offsets (struct gdbarch *gdbarch,
1452 struct link_map_offsets *(*flmo) (void))
1454 struct solib_svr4_ops *ops = gdbarch_data (gdbarch, solib_svr4_data);
1456 ops->fetch_link_map_offsets = flmo;
1459 /* Fetch a link_map_offsets structure using the architecture-specific
1460 `struct link_map_offsets' fetcher. */
1462 static struct link_map_offsets *
1463 svr4_fetch_link_map_offsets (void)
1465 struct solib_svr4_ops *ops = gdbarch_data (current_gdbarch, solib_svr4_data);
1467 gdb_assert (ops->fetch_link_map_offsets);
1468 return ops->fetch_link_map_offsets ();
1471 /* Return 1 if a link map offset fetcher has been defined, 0 otherwise. */
1474 svr4_have_link_map_offsets (void)
1476 struct solib_svr4_ops *ops = gdbarch_data (current_gdbarch, solib_svr4_data);
1477 return (ops->fetch_link_map_offsets != NULL);
1481 /* Most OS'es that have SVR4-style ELF dynamic libraries define a
1482 `struct r_debug' and a `struct link_map' that are binary compatible
1483 with the origional SVR4 implementation. */
1485 /* Fetch (and possibly build) an appropriate `struct link_map_offsets'
1486 for an ILP32 SVR4 system. */
1488 struct link_map_offsets *
1489 svr4_ilp32_fetch_link_map_offsets (void)
1491 static struct link_map_offsets lmo;
1492 static struct link_map_offsets *lmp = NULL;
1498 lmo.r_version_offset = 0;
1499 lmo.r_version_size = 4;
1500 lmo.r_map_offset = 4;
1501 lmo.r_ldsomap_offset = 20;
1503 /* Everything we need is in the first 20 bytes. */
1504 lmo.link_map_size = 20;
1505 lmo.l_addr_offset = 0;
1506 lmo.l_name_offset = 4;
1507 lmo.l_ld_offset = 8;
1508 lmo.l_next_offset = 12;
1509 lmo.l_prev_offset = 16;
1515 /* Fetch (and possibly build) an appropriate `struct link_map_offsets'
1516 for an LP64 SVR4 system. */
1518 struct link_map_offsets *
1519 svr4_lp64_fetch_link_map_offsets (void)
1521 static struct link_map_offsets lmo;
1522 static struct link_map_offsets *lmp = NULL;
1528 lmo.r_version_offset = 0;
1529 lmo.r_version_size = 4;
1530 lmo.r_map_offset = 8;
1531 lmo.r_ldsomap_offset = 40;
1533 /* Everything we need is in the first 40 bytes. */
1534 lmo.link_map_size = 40;
1535 lmo.l_addr_offset = 0;
1536 lmo.l_name_offset = 8;
1537 lmo.l_ld_offset = 16;
1538 lmo.l_next_offset = 24;
1539 lmo.l_prev_offset = 32;
1546 struct target_so_ops svr4_so_ops;
1548 /* Lookup global symbol for ELF DSOs linked with -Bsymbolic. Those DSOs have a
1549 different rule for symbol lookup. The lookup begins here in the DSO, not in
1550 the main executable. */
1552 static struct symbol *
1553 elf_lookup_lib_symbol (const struct objfile *objfile,
1555 const char *linkage_name,
1556 const domain_enum domain, struct symtab **symtab)
1558 if (objfile->obfd == NULL
1559 || scan_dyntag (DT_SYMBOLIC, objfile->obfd, NULL) != 1)
1562 return lookup_global_symbol_from_objfile
1563 (objfile, name, linkage_name, domain, symtab);
1566 extern initialize_file_ftype _initialize_svr4_solib; /* -Wmissing-prototypes */
1569 _initialize_svr4_solib (void)
1571 solib_svr4_data = gdbarch_data_register_pre_init (solib_svr4_init);
1573 svr4_so_ops.relocate_section_addresses = svr4_relocate_section_addresses;
1574 svr4_so_ops.free_so = svr4_free_so;
1575 svr4_so_ops.clear_solib = svr4_clear_solib;
1576 svr4_so_ops.solib_create_inferior_hook = svr4_solib_create_inferior_hook;
1577 svr4_so_ops.special_symbol_handling = svr4_special_symbol_handling;
1578 svr4_so_ops.current_sos = svr4_current_sos;
1579 svr4_so_ops.open_symbol_file_object = open_symbol_file_object;
1580 svr4_so_ops.in_dynsym_resolve_code = svr4_in_dynsym_resolve_code;
1581 svr4_so_ops.lookup_lib_global_symbol = elf_lookup_lib_symbol;
1583 /* FIXME: Don't do this here. *_gdbarch_init() should set so_ops. */
1584 current_target_so_ops = &svr4_so_ops;