1 /* Handle HP SOM shared libraries for GDB, the GNU Debugger.
2 Copyright 1993, 1994, 1995, 1996, 1998, 1999, 2000, 2001
3 Free Software Foundation, Inc.
5 This file is part of GDB.
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 2 of the License, or
10 (at your option) any later version.
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.
17 You should have received a copy of the GNU General Public License
18 along with this program; if not, write to the Free Software
19 Foundation, Inc., 59 Temple Place - Suite 330,
20 Boston, MA 02111-1307, USA.
22 Written by the Center for Software Science at the Univerity of Utah
23 and by Cygnus Support. */
34 #include "breakpoint.h"
38 #include "gdb-stabs.h"
51 /* Uncomment this to turn on some debugging output.
54 /* #define SOLIB_DEBUG
57 /* Defined in exec.c; used to prevent dangling pointer bug.
59 extern struct target_ops exec_ops;
61 /* This lives in hppa-tdep.c. */
62 extern struct unwind_table_entry *find_unwind_entry (CORE_ADDR pc);
64 /* These ought to be defined in some public interface, but aren't. They
65 define the meaning of the various bits in the distinguished __dld_flags
66 variable that is declared in every debuggable a.out on HP-UX, and that
67 is shared between the debugger and the dynamic linker.
69 #define DLD_FLAGS_MAPPRIVATE 0x1
70 #define DLD_FLAGS_HOOKVALID 0x2
71 #define DLD_FLAGS_LISTVALID 0x4
72 #define DLD_FLAGS_BOR_ENABLE 0x8
76 * Most of this code should work for hp300 shared libraries. Does
77 anyone care enough to weed out any SOM-isms.
79 * Support for hpux8 dynamic linker. */
81 /* The basic structure which describes a dynamically loaded object. This
82 data structure is private to the dynamic linker and isn't found in
83 any HPUX include file. */
85 struct som_solib_mapped_entry
87 /* The name of the library. */
90 /* Version of this structure (it is expected to change again in hpux10). */
91 unsigned char struct_version;
93 /* Binding mode for this library. */
94 unsigned char bind_mode;
96 /* Version of this library. */
97 short library_version;
99 /* Start of text address,
100 * link-time text location (length of text area),
101 * end of text address. */
103 CORE_ADDR text_link_addr;
106 /* Start of data, start of bss and end of data. */
107 CORE_ADDR data_start;
111 /* Value of linkage pointer (%r19). */
115 struct som_solib_mapped_entry *next;
117 /* There are other fields, but I don't have information as to what is
118 contained in them. */
120 /* For versions from HPUX-10.30 and up */
122 /* Address in target of offset from thread-local register of
123 * start of this thread's data. I.e., the first thread-local
124 * variable in this shared library starts at *(tsd_start_addr)
125 * from that area pointed to by cr27 (mpsfu_hi).
127 * We do the indirection as soon as we read it, so from then
128 * on it's the offset itself.
130 CORE_ADDR tsd_start_addr;
132 /* Following this are longwords holding:
134 * ?, ?, ?, ptr to -1, ptr to-1, ptr to lib name (leaf name),
135 * ptr to __data_start, ptr to __data_end
141 /* A structure to keep track of all the known shared objects. */
144 struct som_solib_mapped_entry som_solib;
145 struct objfile *objfile;
147 struct section_table *sections;
148 struct section_table *sections_end;
149 /* elz: added this field to store the address in target space (in the
150 library) of the library descriptor (handle) which we read into
151 som_solib_mapped_entry structure */
152 CORE_ADDR solib_addr;
153 struct so_list *next;
157 static struct so_list *so_list_head;
160 /* This is the cumulative size in bytes of the symbol tables of all
161 shared objects on the so_list_head list. (When we say size, here
162 we mean of the information before it is brought into memory and
163 potentially expanded by GDB.) When adding a new shlib, this value
164 is compared against the threshold size, held by auto_solib_add
165 (in megabytes). If adding symbols for the new shlib would cause
166 the total size to exceed the threshold, then the new shlib's symbols
169 static LONGEST som_solib_total_st_size;
171 /* When the threshold is reached for any shlib, we refuse to add
172 symbols for subsequent shlibs, even if those shlibs' symbols would
173 be small enough to fit under the threshold. (Although this may
174 result in one, early large shlib preventing the loading of later,
175 smalller shlibs' symbols, it allows us to issue one informational
176 message. The alternative, to issue a message for each shlib whose
177 symbols aren't loaded, could be a big annoyance where the threshold
178 is exceeded due to a very large number of shlibs.)
180 static int som_solib_st_size_threshold_exceeded;
182 /* These addresses should be filled in by som_solib_create_inferior_hook.
183 They are also used elsewhere in this module.
188 struct unwind_table_entry *unwind;
192 /* When adding fields, be sure to clear them in _initialize_som_solib. */
196 addr_and_unwind_t hook;
197 addr_and_unwind_t hook_stub;
198 addr_and_unwind_t load;
199 addr_and_unwind_t load_stub;
200 addr_and_unwind_t unload;
201 addr_and_unwind_t unload2;
202 addr_and_unwind_t unload_stub;
208 static void som_sharedlibrary_info_command (char *, int);
210 static void som_solib_sharedlibrary_command (char *, int);
213 som_solib_sizeof_symbol_table (char *filename)
218 LONGEST st_size = (LONGEST) 0;
221 /* We believe that filename was handed to us by the dynamic linker, and
222 is therefore always an absolute path.
224 desc = openp (getenv ("PATH"), 1, filename, O_RDONLY | O_BINARY, 0, &absolute_name);
227 perror_with_name (filename);
229 filename = absolute_name;
231 abfd = bfd_fdopenr (filename, gnutarget, desc);
235 make_cleanup (xfree, filename);
236 error ("\"%s\": can't open to read symbols: %s.", filename,
237 bfd_errmsg (bfd_get_error ()));
240 if (!bfd_check_format (abfd, bfd_object)) /* Reads in section info */
242 bfd_close (abfd); /* This also closes desc */
243 make_cleanup (xfree, filename);
244 error ("\"%s\": can't read symbols: %s.", filename,
245 bfd_errmsg (bfd_get_error ()));
248 /* Sum the sizes of the various sections that compose debug info. */
250 /* This contains non-DOC information. */
251 sect = bfd_get_section_by_name (abfd, "$DEBUG$");
253 st_size += (LONGEST) bfd_section_size (abfd, sect);
255 /* This contains DOC information. */
256 sect = bfd_get_section_by_name (abfd, "$PINFO$");
258 st_size += (LONGEST) bfd_section_size (abfd, sect);
260 bfd_close (abfd); /* This also closes desc */
263 /* Unfortunately, just summing the sizes of various debug info
264 sections isn't a very accurate measurement of how much heap
265 space the debugger will need to hold them. It also doesn't
266 account for space needed by linker (aka "minimal") symbols.
268 Anecdotal evidence suggests that just summing the sizes of
269 debug-info-related sections understates the heap space needed
270 to represent it internally by about an order of magnitude.
272 Since it's not exactly brain surgery we're doing here, rather
273 than attempt to more accurately measure the size of a shlib's
274 symbol table in GDB's heap, we'll just apply a 10x fudge-
275 factor to the debug info sections' size-sum. No, this doesn't
276 account for minimal symbols in non-debuggable shlibs. But it
277 all roughly washes out in the end.
279 return st_size * (LONGEST) 10;
284 som_solib_add_solib_objfile (struct so_list *so, char *name, int from_tty,
287 obj_private_data_t *obj_private;
288 struct obj_section *s;
290 so->objfile = symbol_file_add (name, from_tty, NULL, 0, OBJF_SHARED);
291 so->abfd = so->objfile->obfd;
293 /* syms_from_objfile has bizarre section offset code,
294 so I do my own right here. */
295 for (s = so->objfile->sections; s < so->objfile->sections_end; s++)
297 flagword aflag = bfd_get_section_flags(so->abfd, s->the_bfd_section);
298 if (aflag & SEC_CODE)
300 s->addr += so->som_solib.text_addr - so->som_solib.text_link_addr;
301 s->endaddr += so->som_solib.text_addr - so->som_solib.text_link_addr;
303 else if (aflag & SEC_DATA)
305 s->addr += so->som_solib.data_start;
306 s->endaddr += so->som_solib.data_start;
312 /* Mark this as a shared library and save private data.
314 so->objfile->flags |= OBJF_SHARED;
316 if (so->objfile->obj_private == NULL)
318 obj_private = (obj_private_data_t *)
319 obstack_alloc (&so->objfile->psymbol_obstack,
320 sizeof (obj_private_data_t));
321 obj_private->unwind_info = NULL;
322 obj_private->so_info = NULL;
323 so->objfile->obj_private = (PTR) obj_private;
326 obj_private = (obj_private_data_t *) so->objfile->obj_private;
327 obj_private->so_info = so;
329 if (!bfd_check_format (so->abfd, bfd_object))
331 error ("\"%s\": not in executable format: %s.",
332 name, bfd_errmsg (bfd_get_error ()));
338 som_solib_load_symbols (struct so_list *so, char *name, int from_tty,
339 CORE_ADDR text_addr, struct target_ops *target)
341 struct section_table *p;
344 CORE_ADDR presumed_data_start;
347 printf ("--Adding symbols for shared library \"%s\"\n", name);
350 som_solib_add_solib_objfile (so, name, from_tty, text_addr);
352 /* Now we need to build a section table for this library since
353 we might be debugging a core file from a dynamically linked
354 executable in which the libraries were not privately mapped. */
355 if (build_section_table (so->abfd,
359 error ("Unable to build section table for shared library\n.");
363 /* Relocate all the sections based on where they got loaded. */
364 for (p = so->sections; p < so->sections_end; p++)
366 if (p->the_bfd_section->flags & SEC_CODE)
368 p->addr += ANOFFSET (so->objfile->section_offsets, SECT_OFF_TEXT (so->objfile));
369 p->endaddr += ANOFFSET (so->objfile->section_offsets, SECT_OFF_TEXT (so->objfile));
371 else if (p->the_bfd_section->flags & SEC_DATA)
373 p->addr += ANOFFSET (so->objfile->section_offsets, SECT_OFF_DATA (so->objfile));
374 p->endaddr += ANOFFSET (so->objfile->section_offsets, SECT_OFF_DATA (so->objfile));
378 /* Now see if we need to map in the text and data for this shared
379 library (for example debugging a core file which does not use
380 private shared libraries.).
382 Carefully peek at the first text address in the library. If the
383 read succeeds, then the libraries were privately mapped and were
384 included in the core dump file.
386 If the peek failed, then the libraries were not privately mapped
387 and are not in the core file, we'll have to read them in ourselves. */
388 status = target_read_memory (text_addr, buf, 4);
393 new = so->sections_end - so->sections;
395 old = target_resize_to_sections (target, new);
397 /* Copy over the old data before it gets clobbered. */
398 memcpy ((char *) (target->to_sections + old),
400 ((sizeof (struct section_table)) * new));
405 /* Add symbols from shared libraries into the symtab list, unless the
406 size threshold (specified by auto_solib_add, in megabytes) would
410 som_solib_add (char *arg_string, int from_tty, struct target_ops *target)
412 struct minimal_symbol *msymbol;
413 struct so_list *so_list_tail;
415 asection *shlib_info;
417 unsigned int dld_flags;
418 char buf[4], *re_err;
419 int threshold_warning_given = 0;
421 /* First validate our arguments. */
422 if ((re_err = re_comp (arg_string ? arg_string : ".")) != NULL)
424 error ("Invalid regexp: %s", re_err);
427 /* If we're debugging a core file, or have attached to a running
428 process, then som_solib_create_inferior_hook will not have been
431 We need to first determine if we're dealing with a dynamically
432 linked executable. If not, then return without an error or warning.
434 We also need to examine __dld_flags to determine if the shared library
435 list is valid and to determine if the libraries have been privately
437 if (symfile_objfile == NULL)
440 /* First see if the objfile was dynamically linked. */
441 shlib_info = bfd_get_section_by_name (symfile_objfile->obfd, "$SHLIB_INFO$");
445 /* It's got a $SHLIB_INFO$ section, make sure it's not empty. */
446 if (bfd_section_size (symfile_objfile->obfd, shlib_info) == 0)
449 msymbol = lookup_minimal_symbol ("__dld_flags", NULL, NULL);
452 error ("Unable to find __dld_flags symbol in object file.\n");
456 addr = SYMBOL_VALUE_ADDRESS (msymbol);
457 /* Read the current contents. */
458 status = target_read_memory (addr, buf, 4);
461 error ("Unable to read __dld_flags\n");
464 dld_flags = extract_unsigned_integer (buf, 4);
466 /* __dld_list may not be valid. If not, then we punt, warning the user if
467 we were called as a result of the add-symfile command.
469 if ((dld_flags & DLD_FLAGS_LISTVALID) == 0)
472 error ("__dld_list is not valid according to __dld_flags.\n");
476 /* If the libraries were not mapped private, warn the user. */
477 if ((dld_flags & DLD_FLAGS_MAPPRIVATE) == 0)
478 warning ("The shared libraries were not privately mapped; setting a\nbreakpoint in a shared library will not work until you rerun the program.\n");
480 msymbol = lookup_minimal_symbol ("__dld_list", NULL, NULL);
483 /* Older crt0.o files (hpux8) don't have __dld_list as a symbol,
484 but the data is still available if you know where to look. */
485 msymbol = lookup_minimal_symbol ("__dld_flags", NULL, NULL);
488 error ("Unable to find dynamic library list.\n");
491 addr = SYMBOL_VALUE_ADDRESS (msymbol) - 8;
494 addr = SYMBOL_VALUE_ADDRESS (msymbol);
496 status = target_read_memory (addr, buf, 4);
499 error ("Unable to find dynamic library list.\n");
503 addr = extract_unsigned_integer (buf, 4);
505 /* If addr is zero, then we're using an old dynamic loader which
506 doesn't maintain __dld_list. We'll have to use a completely
507 different approach to get shared library information. */
511 /* Using the information in __dld_list is the preferred method
512 to get at shared library information. It doesn't depend on
513 any functions in /opt/langtools/lib/end.o and has a chance of working
514 with hpux10 when it is released. */
515 status = target_read_memory (addr, buf, 4);
518 error ("Unable to find dynamic library list.\n");
522 /* addr now holds the address of the first entry in the dynamic
524 addr = extract_unsigned_integer (buf, 4);
526 /* Now that we have a pointer to the dynamic library list, walk
527 through it and add the symbols for each library. */
529 so_list_tail = so_list_head;
530 /* Find the end of the list of shared objects. */
531 while (so_list_tail && so_list_tail->next)
532 so_list_tail = so_list_tail->next;
535 printf ("--About to read shared library list data\n");
538 /* "addr" will always point to the base of the
539 * current data entry describing the current
544 CORE_ADDR name_addr, text_addr;
545 unsigned int name_len;
547 struct so_list *new_so;
548 struct so_list *so_list = so_list_head;
556 /* Get a pointer to the name of this library. */
557 status = target_read_memory (addr, buf, 4);
561 name_addr = extract_unsigned_integer (buf, 4);
565 target_read_memory (name_addr + name_len, buf, 1);
573 name = alloca (name_len);
574 status = target_read_memory (name_addr, name, name_len);
578 /* See if we've already loaded something with this name. */
581 if (!strcmp (so_list->som_solib.name, name))
583 so_list = so_list->next;
586 /* See if the file exists. If not, give a warning, but don't
588 status = stat (name, &statbuf);
591 warning ("Can't find file %s referenced in dld_list.", name);
593 status = target_read_memory (addr + 36, buf, 4);
597 addr = (CORE_ADDR) extract_unsigned_integer (buf, 4);
601 /* If we've already loaded this one or it's the main program, skip it. */
602 is_main_program = (strcmp (name, symfile_objfile->name) == 0);
603 if (so_list || is_main_program)
605 /* This is the "next" pointer in the strcuture.
607 status = target_read_memory (addr + 36, buf, 4);
611 addr = (CORE_ADDR) extract_unsigned_integer (buf, 4);
613 /* Record the main program's symbol table size. */
614 if (is_main_program && !so_list)
616 st_size = som_solib_sizeof_symbol_table (name);
617 som_solib_total_st_size += st_size;
620 /* Was this a shlib that we noted but didn't load the symbols for?
621 If so, were we invoked this time from the command-line, via
622 a 'sharedlibrary' or 'add-symbol-file' command? If yes to
623 both, we'd better load the symbols this time.
625 if (from_tty && so_list && !is_main_program && (so_list->objfile == NULL))
626 som_solib_load_symbols (so_list,
629 so_list->som_solib.text_addr,
635 name = obsavestring (name, name_len - 1,
636 &symfile_objfile->symbol_obstack);
638 status = target_read_memory (addr + 8, buf, 4);
642 text_addr = extract_unsigned_integer (buf, 4);
644 new_so = (struct so_list *) xmalloc (sizeof (struct so_list));
645 memset ((char *) new_so, 0, sizeof (struct so_list));
646 if (so_list_head == NULL)
648 so_list_head = new_so;
649 so_list_tail = new_so;
653 so_list_tail->next = new_so;
654 so_list_tail = new_so;
657 /* Fill in all the entries in GDB's shared library list.
660 new_so->solib_addr = addr;
661 new_so->som_solib.name = name;
662 status = target_read_memory (addr + 4, buf, 4);
666 new_so->som_solib.struct_version = extract_unsigned_integer (buf + 3, 1);
667 new_so->som_solib.bind_mode = extract_unsigned_integer (buf + 2, 1);
668 /* Following is "high water mark", highest version number
669 * seen, rather than plain version number.
671 new_so->som_solib.library_version = extract_unsigned_integer (buf, 2);
672 new_so->som_solib.text_addr = text_addr;
674 /* Q: What about longword at "addr + 8"?
675 * A: It's read above, out of order, into "text_addr".
678 status = target_read_memory (addr + 12, buf, 4);
682 new_so->som_solib.text_link_addr = extract_unsigned_integer (buf, 4);
684 status = target_read_memory (addr + 16, buf, 4);
688 new_so->som_solib.text_end = extract_unsigned_integer (buf, 4);
690 status = target_read_memory (addr + 20, buf, 4);
694 new_so->som_solib.data_start = extract_unsigned_integer (buf, 4);
696 status = target_read_memory (addr + 24, buf, 4);
700 new_so->som_solib.bss_start = extract_unsigned_integer (buf, 4);
702 status = target_read_memory (addr + 28, buf, 4);
706 new_so->som_solib.data_end = extract_unsigned_integer (buf, 4);
708 status = target_read_memory (addr + 32, buf, 4);
712 new_so->som_solib.got_value = extract_unsigned_integer (buf, 4);
714 status = target_read_memory (addr + 36, buf, 4);
718 new_so->som_solib.next = (void *) extract_unsigned_integer (buf, 4);
720 /* Note that we don't re-set "addr" to the next pointer
721 * until after we've read the trailing data.
724 status = target_read_memory (addr + 40, buf, 4);
725 new_so->som_solib.tsd_start_addr = extract_unsigned_integer (buf, 4);
729 /* Now indirect via that value!
731 status = target_read_memory (new_so->som_solib.tsd_start_addr, buf, 4);
732 new_so->som_solib.tsd_start_addr = extract_unsigned_integer (buf, 4);
736 printf ("\n+ library \"%s\" is described at 0x%x\n", name, addr);
737 printf (" 'version' is %d\n", new_so->som_solib.struct_version);
738 printf (" 'bind_mode' is %d\n", new_so->som_solib.bind_mode);
739 printf (" 'library_version' is %d\n", new_so->som_solib.library_version);
740 printf (" 'text_addr' is 0x%x\n", new_so->som_solib.text_addr);
741 printf (" 'text_link_addr' is 0x%x\n", new_so->som_solib.text_link_addr);
742 printf (" 'text_end' is 0x%x\n", new_so->som_solib.text_end);
743 printf (" 'data_start' is 0x%x\n", new_so->som_solib.data_start);
744 printf (" 'bss_start' is 0x%x\n", new_so->som_solib.bss_start);
745 printf (" 'data_end' is 0x%x\n", new_so->som_solib.data_end);
746 printf (" 'got_value' is %x\n", new_so->som_solib.got_value);
747 printf (" 'next' is 0x%x\n", new_so->som_solib.next);
748 printf (" 'tsd_start_addr' is 0x%x\n", new_so->som_solib.tsd_start_addr);
751 /* Go on to the next shared library descriptor.
753 addr = (CORE_ADDR) new_so->som_solib.next;
757 /* At this point, we have essentially hooked the shlib into the
758 "info share" command. However, we haven't yet loaded its
759 symbol table. We must now decide whether we ought to, i.e.,
760 whether doing so would exceed the symbol table size threshold.
762 If the threshold has just now been exceeded, then we'll issue
763 a warning message (which explains how to load symbols manually,
764 if the user so desires).
766 If the threshold has just now or previously been exceeded,
767 we'll just add the shlib to the list of object files, but won't
768 actually load its symbols. (This is more useful than it might
769 sound, for it allows us to e.g., still load and use the shlibs'
770 unwind information for stack tracebacks.)
773 /* Note that we DON'T want to preclude the user from using the
774 add-symbol-file command! Thus, we only worry about the threshold
775 when we're invoked for other reasons.
777 st_size = som_solib_sizeof_symbol_table (name);
778 som_solib_st_size_threshold_exceeded =
780 ((st_size + som_solib_total_st_size) > (auto_solib_add * (LONGEST) 1000000));
782 if (som_solib_st_size_threshold_exceeded)
784 if (!threshold_warning_given)
785 warning ("Symbols for some libraries have not been loaded, because\ndoing so would exceed the size threshold specified by auto-solib-add.\nTo manually load symbols, use the 'sharedlibrary' command.\nTo raise the threshold, set auto-solib-add to a larger value and rerun\nthe program.\n");
786 threshold_warning_given = 1;
788 /* We'll still make note of this shlib, even if we don't
789 read its symbols. This allows us to use its unwind
790 information well enough to know how to e.g., correctly
791 do a traceback from a PC within the shlib, even if we
792 can't symbolize those PCs...
794 som_solib_add_solib_objfile (new_so, name, from_tty, text_addr);
798 som_solib_total_st_size += st_size;
800 /* This fills in new_so->objfile, among others. */
801 som_solib_load_symbols (new_so, name, from_tty, text_addr, target);
805 printf ("--Done reading shared library data\n");
808 /* Getting new symbols may change our opinion about what is
810 reinit_frame_cache ();
814 error ("Debugging dynamic executables loaded via the hpux8 dld.sl is not supported.\n");
818 error ("Error while reading dynamic library list.\n");
823 /* This hook gets called just before the first instruction in the
824 inferior process is executed.
826 This is our opportunity to set magic flags in the inferior so
827 that GDB can be notified when a shared library is mapped in and
828 to tell the dynamic linker that a private copy of the library is
829 needed (so GDB can set breakpoints in the library).
831 __dld_flags is the location of the magic flags; as of this implementation
832 there are 3 flags of interest:
834 bit 0 when set indicates that private copies of the libraries are needed
835 bit 1 when set indicates that the callback hook routine is valid
836 bit 2 when set indicates that the dynamic linker should maintain the
837 __dld_list structure when loading/unloading libraries.
839 Note that shared libraries are not mapped in at this time, so we have
840 run the inferior until the libraries are mapped in. Typically this
841 means running until the "_start" is called. */
844 som_solib_create_inferior_hook (void)
846 struct minimal_symbol *msymbol;
847 unsigned int dld_flags, status, have_endo;
848 asection *shlib_info;
850 struct objfile *objfile;
853 /* First, remove all the solib event breakpoints. Their addresses
854 may have changed since the last time we ran the program. */
855 remove_solib_event_breakpoints ();
857 if (symfile_objfile == NULL)
860 /* First see if the objfile was dynamically linked. */
861 shlib_info = bfd_get_section_by_name (symfile_objfile->obfd, "$SHLIB_INFO$");
865 /* It's got a $SHLIB_INFO$ section, make sure it's not empty. */
866 if (bfd_section_size (symfile_objfile->obfd, shlib_info) == 0)
870 /* Slam the pid of the process into __d_pid; failing is only a warning! */
871 msymbol = lookup_minimal_symbol ("__d_pid", NULL, symfile_objfile);
874 warning ("Unable to find __d_pid symbol in object file.");
875 warning ("Suggest linking with /opt/langtools/lib/end.o.");
876 warning ("GDB will be unable to track shl_load/shl_unload calls");
880 anaddr = SYMBOL_VALUE_ADDRESS (msymbol);
881 store_unsigned_integer (buf, 4, inferior_pid);
882 status = target_write_memory (anaddr, buf, 4);
885 warning ("Unable to write __d_pid");
886 warning ("Suggest linking with /opt/langtools/lib/end.o.");
887 warning ("GDB will be unable to track shl_load/shl_unload calls");
891 /* Get the value of _DLD_HOOK (an export stub) and put it in __dld_hook;
892 This will force the dynamic linker to call __d_trap when significant
895 Note that the above is the pre-HP-UX 9.0 behaviour. At 9.0 and above,
896 the dld provides an export stub named "__d_trap" as well as the
897 function named "__d_trap" itself, but doesn't provide "_DLD_HOOK".
898 We'll look first for the old flavor and then the new.
900 msymbol = lookup_minimal_symbol ("_DLD_HOOK", NULL, symfile_objfile);
902 msymbol = lookup_minimal_symbol ("__d_trap", NULL, symfile_objfile);
905 warning ("Unable to find _DLD_HOOK symbol in object file.");
906 warning ("Suggest linking with /opt/langtools/lib/end.o.");
907 warning ("GDB will be unable to track shl_load/shl_unload calls");
910 anaddr = SYMBOL_VALUE_ADDRESS (msymbol);
911 dld_cache.hook.address = anaddr;
913 /* Grrr, this might not be an export symbol! We have to find the
915 ALL_OBJFILES (objfile)
917 struct unwind_table_entry *u;
918 struct minimal_symbol *msymbol2;
921 msymbol2 = lookup_minimal_symbol_solib_trampoline (SYMBOL_NAME (msymbol),
923 /* Found a symbol with the right name. */
926 struct unwind_table_entry *u;
927 /* It must be a shared library trampoline. */
928 if (SYMBOL_TYPE (msymbol2) != mst_solib_trampoline)
931 /* It must also be an export stub. */
932 u = find_unwind_entry (SYMBOL_VALUE (msymbol2));
933 if (!u || u->stub_unwind.stub_type != EXPORT)
936 /* OK. Looks like the correct import stub. */
937 anaddr = SYMBOL_VALUE (msymbol2);
938 dld_cache.hook_stub.address = anaddr;
941 store_unsigned_integer (buf, 4, anaddr);
943 msymbol = lookup_minimal_symbol ("__dld_hook", NULL, symfile_objfile);
946 warning ("Unable to find __dld_hook symbol in object file.");
947 warning ("Suggest linking with /opt/langtools/lib/end.o.");
948 warning ("GDB will be unable to track shl_load/shl_unload calls");
951 anaddr = SYMBOL_VALUE_ADDRESS (msymbol);
952 status = target_write_memory (anaddr, buf, 4);
954 /* Now set a shlib_event breakpoint at __d_trap so we can track
955 significant shared library events. */
956 msymbol = lookup_minimal_symbol ("__d_trap", NULL, symfile_objfile);
959 warning ("Unable to find __dld_d_trap symbol in object file.");
960 warning ("Suggest linking with /opt/langtools/lib/end.o.");
961 warning ("GDB will be unable to track shl_load/shl_unload calls");
964 create_solib_event_breakpoint (SYMBOL_VALUE_ADDRESS (msymbol));
966 /* We have all the support usually found in end.o, so we can track
967 shl_load and shl_unload calls. */
972 /* Get the address of __dld_flags, if no such symbol exists, then we can
973 not debug the shared code. */
974 msymbol = lookup_minimal_symbol ("__dld_flags", NULL, NULL);
977 error ("Unable to find __dld_flags symbol in object file.\n");
980 anaddr = SYMBOL_VALUE_ADDRESS (msymbol);
982 /* Read the current contents. */
983 status = target_read_memory (anaddr, buf, 4);
986 error ("Unable to read __dld_flags\n");
988 dld_flags = extract_unsigned_integer (buf, 4);
990 /* Turn on the flags we care about. */
991 dld_flags |= DLD_FLAGS_MAPPRIVATE;
993 dld_flags |= DLD_FLAGS_HOOKVALID;
994 store_unsigned_integer (buf, 4, dld_flags);
995 status = target_write_memory (anaddr, buf, 4);
998 error ("Unable to write __dld_flags\n");
1001 /* Now find the address of _start and set a breakpoint there.
1002 We still need this code for two reasons:
1004 * Not all sites have /opt/langtools/lib/end.o, so it's not always
1005 possible to track the dynamic linker's events.
1007 * At this time no events are triggered for shared libraries
1008 loaded at startup time (what a crock). */
1010 msymbol = lookup_minimal_symbol ("_start", NULL, symfile_objfile);
1011 if (msymbol == NULL)
1013 error ("Unable to find _start symbol in object file.\n");
1016 anaddr = SYMBOL_VALUE_ADDRESS (msymbol);
1018 /* Make the breakpoint at "_start" a shared library event breakpoint. */
1019 create_solib_event_breakpoint (anaddr);
1021 /* Wipe out all knowledge of old shared libraries since their
1022 mapping can change from one exec to another! */
1023 while (so_list_head)
1025 struct so_list *temp;
1027 temp = so_list_head;
1028 xfree (so_list_head);
1029 so_list_head = temp->next;
1031 clear_symtab_users ();
1036 reset_inferior_pid (int saved_inferior_pid)
1038 inferior_pid = saved_inferior_pid;
1042 /* This operation removes the "hook" between GDB and the dynamic linker,
1043 which causes the dld to notify GDB of shared library events.
1045 After this operation completes, the dld will no longer notify GDB of
1046 shared library events. To resume notifications, GDB must call
1047 som_solib_create_inferior_hook.
1049 This operation does not remove any knowledge of shared libraries which
1050 GDB may already have been notified of.
1053 som_solib_remove_inferior_hook (int pid)
1056 struct minimal_symbol *msymbol;
1058 char dld_flags_buffer[TARGET_INT_BIT / TARGET_CHAR_BIT];
1059 unsigned int dld_flags_value;
1060 int saved_inferior_pid = inferior_pid;
1061 struct cleanup *old_cleanups = make_cleanup (reset_inferior_pid, saved_inferior_pid);
1063 /* Ensure that we're really operating on the specified process. */
1066 /* We won't bother to remove the solib breakpoints from this process.
1068 In fact, on PA64 the breakpoint is hard-coded into the dld callback,
1069 and thus we're not supposed to remove it.
1071 Rather, we'll merely clear the dld_flags bit that enables callbacks.
1073 msymbol = lookup_minimal_symbol ("__dld_flags", NULL, NULL);
1075 addr = SYMBOL_VALUE_ADDRESS (msymbol);
1076 status = target_read_memory (addr, dld_flags_buffer, TARGET_INT_BIT / TARGET_CHAR_BIT);
1078 dld_flags_value = extract_unsigned_integer (dld_flags_buffer,
1079 sizeof (dld_flags_value));
1081 dld_flags_value &= ~DLD_FLAGS_HOOKVALID;
1082 store_unsigned_integer (dld_flags_buffer,
1083 sizeof (dld_flags_value),
1085 status = target_write_memory (addr, dld_flags_buffer, TARGET_INT_BIT / TARGET_CHAR_BIT);
1087 do_cleanups (old_cleanups);
1091 /* This function creates a breakpoint on the dynamic linker hook, which
1092 is called when e.g., a shl_load or shl_unload call is made. This
1093 breakpoint will only trigger when a shl_load call is made.
1095 If filename is NULL, then loads of any dll will be caught. Else,
1096 only loads of the file whose pathname is the string contained by
1097 filename will be caught.
1099 Undefined behaviour is guaranteed if this function is called before
1100 som_solib_create_inferior_hook.
1103 som_solib_create_catch_load_hook (int pid, int tempflag, char *filename,
1106 create_solib_load_event_breakpoint ("__d_trap", tempflag, filename, cond_string);
1109 /* This function creates a breakpoint on the dynamic linker hook, which
1110 is called when e.g., a shl_load or shl_unload call is made. This
1111 breakpoint will only trigger when a shl_unload call is made.
1113 If filename is NULL, then unloads of any dll will be caught. Else,
1114 only unloads of the file whose pathname is the string contained by
1115 filename will be caught.
1117 Undefined behaviour is guaranteed if this function is called before
1118 som_solib_create_inferior_hook.
1121 som_solib_create_catch_unload_hook (int pid, int tempflag, char *filename,
1124 create_solib_unload_event_breakpoint ("__d_trap", tempflag, filename, cond_string);
1128 som_solib_have_load_event (int pid)
1130 CORE_ADDR event_kind;
1132 event_kind = read_register (ARG0_REGNUM);
1133 return (event_kind == SHL_LOAD);
1137 som_solib_have_unload_event (int pid)
1139 CORE_ADDR event_kind;
1141 event_kind = read_register (ARG0_REGNUM);
1142 return (event_kind == SHL_UNLOAD);
1146 som_solib_library_pathname (int pid)
1148 CORE_ADDR dll_handle_address;
1149 CORE_ADDR dll_pathname_address;
1150 struct som_solib_mapped_entry dll_descriptor;
1152 static char dll_pathname[1024];
1154 /* Read the descriptor of this newly-loaded library. */
1155 dll_handle_address = read_register (ARG1_REGNUM);
1156 read_memory (dll_handle_address, (char *) &dll_descriptor, sizeof (dll_descriptor));
1158 /* We can find a pointer to the dll's pathname within the descriptor. */
1159 dll_pathname_address = (CORE_ADDR) dll_descriptor.name;
1161 /* Read the pathname, one byte at a time. */
1166 read_memory (dll_pathname_address++, (char *) &b, 1);
1172 return dll_pathname;
1176 som_solib_loaded_library_pathname (int pid)
1178 if (!som_solib_have_load_event (pid))
1179 error ("Must have a load event to use this query");
1181 return som_solib_library_pathname (pid);
1185 som_solib_unloaded_library_pathname (int pid)
1187 if (!som_solib_have_unload_event (pid))
1188 error ("Must have an unload event to use this query");
1190 return som_solib_library_pathname (pid);
1194 som_solib_desire_dynamic_linker_symbols (void)
1196 struct objfile *objfile;
1197 struct unwind_table_entry *u;
1198 struct minimal_symbol *dld_msymbol;
1200 /* Do we already know the value of these symbols? If so, then
1201 we've no work to do.
1203 (If you add clauses to this test, be sure to likewise update the
1204 test within the loop.)
1206 if (dld_cache.is_valid)
1209 ALL_OBJFILES (objfile)
1211 dld_msymbol = lookup_minimal_symbol ("shl_load", NULL, objfile);
1212 if (dld_msymbol != NULL)
1214 dld_cache.load.address = SYMBOL_VALUE (dld_msymbol);
1215 dld_cache.load.unwind = find_unwind_entry (dld_cache.load.address);
1218 dld_msymbol = lookup_minimal_symbol_solib_trampoline ("shl_load",
1221 if (dld_msymbol != NULL)
1223 if (SYMBOL_TYPE (dld_msymbol) == mst_solib_trampoline)
1225 u = find_unwind_entry (SYMBOL_VALUE (dld_msymbol));
1226 if ((u != NULL) && (u->stub_unwind.stub_type == EXPORT))
1228 dld_cache.load_stub.address = SYMBOL_VALUE (dld_msymbol);
1229 dld_cache.load_stub.unwind = u;
1234 dld_msymbol = lookup_minimal_symbol ("shl_unload", NULL, objfile);
1235 if (dld_msymbol != NULL)
1237 dld_cache.unload.address = SYMBOL_VALUE (dld_msymbol);
1238 dld_cache.unload.unwind = find_unwind_entry (dld_cache.unload.address);
1240 /* ??rehrauer: I'm not sure exactly what this is, but it appears
1241 that on some HPUX 10.x versions, there's two unwind regions to
1242 cover the body of "shl_unload", the second being 4 bytes past
1243 the end of the first. This is a large hack to handle that
1244 case, but since I don't seem to have any legitimate way to
1245 look for this thing via the symbol table...
1247 if (dld_cache.unload.unwind != NULL)
1249 u = find_unwind_entry (dld_cache.unload.unwind->region_end + 4);
1252 dld_cache.unload2.address = u->region_start;
1253 dld_cache.unload2.unwind = u;
1258 dld_msymbol = lookup_minimal_symbol_solib_trampoline ("shl_unload",
1261 if (dld_msymbol != NULL)
1263 if (SYMBOL_TYPE (dld_msymbol) == mst_solib_trampoline)
1265 u = find_unwind_entry (SYMBOL_VALUE (dld_msymbol));
1266 if ((u != NULL) && (u->stub_unwind.stub_type == EXPORT))
1268 dld_cache.unload_stub.address = SYMBOL_VALUE (dld_msymbol);
1269 dld_cache.unload_stub.unwind = u;
1274 /* Did we find everything we were looking for? If so, stop. */
1275 if ((dld_cache.load.address != NULL) && (dld_cache.load_stub.address != NULL)
1276 && (dld_cache.unload.address != NULL) && (dld_cache.unload_stub.address != NULL))
1278 dld_cache.is_valid = 1;
1283 dld_cache.hook.unwind = find_unwind_entry (dld_cache.hook.address);
1284 dld_cache.hook_stub.unwind = find_unwind_entry (dld_cache.hook_stub.address);
1286 /* We're prepared not to find some of these symbols, which is why
1287 this function is a "desire" operation, and not a "require".
1292 som_solib_in_dynamic_linker (int pid, CORE_ADDR pc)
1294 struct unwind_table_entry *u_pc;
1296 /* Are we in the dld itself?
1298 ??rehrauer: Large hack -- We'll assume that any address in a
1299 shared text region is the dld's text. This would obviously
1300 fall down if the user attached to a process, whose shlibs
1301 weren't mapped to a (writeable) private region. However, in
1302 that case the debugger probably isn't able to set the fundamental
1303 breakpoint in the dld callback anyways, so this hack should be
1306 if ((pc & (CORE_ADDR) 0xc0000000) == (CORE_ADDR) 0xc0000000)
1309 /* Cache the address of some symbols that are part of the dynamic
1310 linker, if not already known.
1312 som_solib_desire_dynamic_linker_symbols ();
1314 /* Are we in the dld callback? Or its export stub? */
1315 u_pc = find_unwind_entry (pc);
1319 if ((u_pc == dld_cache.hook.unwind) || (u_pc == dld_cache.hook_stub.unwind))
1322 /* Or the interface of the dld (i.e., "shl_load" or friends)? */
1323 if ((u_pc == dld_cache.load.unwind)
1324 || (u_pc == dld_cache.unload.unwind)
1325 || (u_pc == dld_cache.unload2.unwind)
1326 || (u_pc == dld_cache.load_stub.unwind)
1327 || (u_pc == dld_cache.unload_stub.unwind))
1330 /* Apparently this address isn't part of the dld's text. */
1335 /* Return the GOT value for the shared library in which ADDR belongs. If
1336 ADDR isn't in any known shared library, return zero. */
1339 som_solib_get_got_by_pc (CORE_ADDR addr)
1341 struct so_list *so_list = so_list_head;
1342 CORE_ADDR got_value = 0;
1346 if (so_list->som_solib.text_addr <= addr
1347 && so_list->som_solib.text_end > addr)
1349 got_value = so_list->som_solib.got_value;
1352 so_list = so_list->next;
1358 Return the address of the handle of the shared library
1359 in which ADDR belongs. If
1360 ADDR isn't in any known shared library, return zero. */
1361 /* this function is used in hppa_fix_call_dummy in hppa-tdep.c */
1364 som_solib_get_solib_by_pc (CORE_ADDR addr)
1366 struct so_list *so_list = so_list_head;
1370 if (so_list->som_solib.text_addr <= addr
1371 && so_list->som_solib.text_end > addr)
1375 so_list = so_list->next;
1378 return so_list->solib_addr;
1385 som_solib_section_offsets (struct objfile *objfile,
1386 struct section_offsets *offsets)
1388 struct so_list *so_list = so_list_head;
1392 /* Oh what a pain! We need the offsets before so_list->objfile
1393 is valid. The BFDs will never match. Make a best guess. */
1394 if (strstr (objfile->name, so_list->som_solib.name))
1396 asection *private_section;
1398 /* The text offset is easy. */
1399 offsets->offsets[SECT_OFF_TEXT (objfile)]
1400 = (so_list->som_solib.text_addr
1401 - so_list->som_solib.text_link_addr);
1402 offsets->offsets[SECT_OFF_RODATA (objfile)]
1403 = ANOFFSET (offsets, SECT_OFF_TEXT (objfile));
1405 /* We should look at presumed_dp in the SOM header, but
1406 that's not easily available. This should be OK though. */
1407 private_section = bfd_get_section_by_name (objfile->obfd,
1409 if (!private_section)
1411 warning ("Unable to find $PRIVATE$ in shared library!");
1412 offsets->offsets[SECT_OFF_DATA (objfile)] = 0;
1413 offsets->offsets[SECT_OFF_BSS (objfile)] = 0;
1416 offsets->offsets[SECT_OFF_DATA (objfile)]
1417 = (so_list->som_solib.data_start - private_section->vma);
1418 offsets->offsets[SECT_OFF_BSS (objfile)]
1419 = ANOFFSET (offsets, SECT_OFF_DATA (objfile));
1422 so_list = so_list->next;
1427 /* Dump information about all the currently loaded shared libraries. */
1430 som_sharedlibrary_info_command (char *ignore, int from_tty)
1432 struct so_list *so_list = so_list_head;
1434 if (exec_bfd == NULL)
1436 printf_unfiltered ("No executable file.\n");
1440 if (so_list == NULL)
1442 printf_unfiltered ("No shared libraries loaded at this time.\n");
1446 printf_unfiltered ("Shared Object Libraries\n");
1447 printf_unfiltered (" %-12s%-12s%-12s%-12s%-12s%-12s\n",
1448 " flags", " tstart", " tend", " dstart", " dend", " dlt");
1453 flags = so_list->som_solib.struct_version << 24;
1454 flags |= so_list->som_solib.bind_mode << 16;
1455 flags |= so_list->som_solib.library_version;
1456 printf_unfiltered ("%s", so_list->som_solib.name);
1457 if (so_list->objfile == NULL)
1458 printf_unfiltered (" (symbols not loaded)");
1459 printf_unfiltered ("\n");
1460 printf_unfiltered (" %-12s", local_hex_string_custom (flags, "08l"));
1461 printf_unfiltered ("%-12s",
1462 local_hex_string_custom (so_list->som_solib.text_addr, "08l"));
1463 printf_unfiltered ("%-12s",
1464 local_hex_string_custom (so_list->som_solib.text_end, "08l"));
1465 printf_unfiltered ("%-12s",
1466 local_hex_string_custom (so_list->som_solib.data_start, "08l"));
1467 printf_unfiltered ("%-12s",
1468 local_hex_string_custom (so_list->som_solib.data_end, "08l"));
1469 printf_unfiltered ("%-12s\n",
1470 local_hex_string_custom (so_list->som_solib.got_value, "08l"));
1471 so_list = so_list->next;
1476 som_solib_sharedlibrary_command (char *args, int from_tty)
1479 som_solib_add (args, from_tty, (struct target_ops *) 0);
1485 som_solib_address (CORE_ADDR addr)
1487 struct so_list *so = so_list_head;
1491 /* Is this address within this shlib's text range? If so,
1492 return the shlib's name.
1494 if ((addr >= so->som_solib.text_addr) && (addr <= so->som_solib.text_end))
1495 return so->som_solib.name;
1497 /* Nope, keep looking... */
1501 /* No, we couldn't prove that the address is within a shlib. */
1507 som_solib_restart (void)
1509 struct so_list *sl = so_list_head;
1511 /* Before the shlib info vanishes, use it to disable any breakpoints
1512 that may still be active in those shlibs.
1514 disable_breakpoints_in_shlibs (0);
1516 /* Discard all the shlib descriptors.
1520 struct so_list *next_sl = sl->next;
1524 so_list_head = NULL;
1526 som_solib_total_st_size = (LONGEST) 0;
1527 som_solib_st_size_threshold_exceeded = 0;
1529 dld_cache.is_valid = 0;
1531 dld_cache.hook.address = 0;
1532 dld_cache.hook.unwind = NULL;
1534 dld_cache.hook_stub.address = 0;
1535 dld_cache.hook_stub.unwind = NULL;
1537 dld_cache.load.address = 0;
1538 dld_cache.load.unwind = NULL;
1540 dld_cache.load_stub.address = 0;
1541 dld_cache.load_stub.unwind = NULL;
1543 dld_cache.unload.address = 0;
1544 dld_cache.unload.unwind = NULL;
1546 dld_cache.unload2.address = 0;
1547 dld_cache.unload2.unwind = NULL;
1549 dld_cache.unload_stub.address = 0;
1550 dld_cache.unload_stub.unwind = NULL;
1556 _initialize_som_solib (void)
1558 add_com ("sharedlibrary", class_files, som_solib_sharedlibrary_command,
1559 "Load shared object library symbols for files matching REGEXP.");
1560 add_info ("sharedlibrary", som_sharedlibrary_info_command,
1561 "Status of loaded shared object libraries.");
1563 (add_set_cmd ("auto-solib-add", class_support, var_zinteger,
1564 (char *) &auto_solib_add,
1565 "Set autoloading size threshold (in megabytes) of shared library symbols.\n\
1566 If nonzero, symbols from all shared object libraries will be loaded\n\
1567 automatically when the inferior begins execution or when the dynamic linker\n\
1568 informs gdb that a new library has been loaded, until the symbol table\n\
1569 of the program and libraries exceeds this threshold.\n\
1570 Otherwise, symbols must be loaded manually, using `sharedlibrary'.",
1574 /* ??rehrauer: On HP-UX, the kernel parameter MAXDSIZ limits how much
1575 data space a process can use. We ought to be reading MAXDSIZ and
1576 setting auto_solib_add to some large fraction of that value. If
1577 not that, we maybe ought to be setting it smaller than the default
1578 for MAXDSIZ (that being 64Mb, I believe). However, [1] this threshold
1579 is only crudely approximated rather than actually measured, and [2]
1580 50 Mbytes is too small for debugging gdb itself. Thus, the arbitrary
1583 auto_solib_add = 100; /* Megabytes */
1585 som_solib_restart ();
1588 /* Get some HPUX-specific data from a shared lib.
1591 so_lib_thread_start_addr (struct so_list *so)
1593 return so->som_solib.tsd_start_addr;