1 /* HP SOM Shared library declarations for GDB, the GNU Debugger. 2 3 Copyright 1992, 1994, 1995, 1998, 1999, 2000, 2003 Free Software 4 Foundation, Inc. 5 6 This file is part of GDB. 7 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. 12 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. 17 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., 59 Temple Place - Suite 330, 21 Boston, MA 02111-1307, USA. 22 23 Written by the Center for Software Science at the Univerity of Utah 24 and by Cygnus Support. */ 25 26 #ifndef SOMSOLIB_H 27 #define SOMSOLIB_H 28 29 /* Forward decl's for prototypes */ 30 struct target_ops; 31 struct objfile; 32 struct section_offsets; 33 34 /* Called to add symbols from a shared library to gdb's symbol table. */ 35 36 #define SOLIB_ADD(filename, from_tty, targ, readsyms) \ 37 som_solib_add (filename, from_tty, targ, readsyms) 38 39 extern void som_solib_add (char *, int, struct target_ops *, int); 40 41 extern CORE_ADDR som_solib_get_got_by_pc (CORE_ADDR); 42 43 extern int som_solib_section_offsets (struct objfile *, 44 struct section_offsets *); 45 46 /* Function to be called when the inferior starts up, to discover the names 47 of shared libraries that are dynamically linked, the base addresses to 48 which they are linked, and sufficient information to read in their symbols 49 at a later time. */ 50 51 #define SOLIB_CREATE_INFERIOR_HOOK(PID) som_solib_create_inferior_hook() 52 53 extern void som_solib_create_inferior_hook (void); 54 55 /* Function to be called to remove the connection between debugger and 56 dynamic linker that was established by SOLIB_CREATE_INFERIOR_HOOK. 57 (This operation does not remove shared library information from 58 the debugger, as CLEAR_SOLIB does.) 59 */ 60 #define SOLIB_REMOVE_INFERIOR_HOOK(PID) som_solib_remove_inferior_hook(PID) 61 62 extern void som_solib_remove_inferior_hook (int); 63 64 /* This function is called by the "catch load" command. It allows 65 the debugger to be notified by the dynamic linker when a specified 66 library file (or any library file, if filename is NULL) is loaded. 67 */ 68 #define SOLIB_CREATE_CATCH_LOAD_HOOK(pid,tempflag, filename,cond_string) \ 69 som_solib_create_catch_load_hook (pid, tempflag, filename, cond_string) 70 71 extern void som_solib_create_catch_load_hook (int, int, char *, char *); 72 73 /* This function is called by the "catch unload" command. It allows 74 the debugger to be notified by the dynamic linker when a specified 75 library file (or any library file, if filename is NULL) is unloaded. 76 */ 77 #define SOLIB_CREATE_CATCH_UNLOAD_HOOK(pid,tempflag,filename, cond_string) \ 78 som_solib_create_catch_unload_hook (pid, tempflag, filename, cond_string) 79 80 extern void som_solib_create_catch_unload_hook (int, int, char *, char *); 81 82 /* This function returns TRUE if the dynamic linker has just reported 83 a load of a library. 84 85 This function must be used only when the inferior has stopped in 86 the dynamic linker hook, or undefined results are guaranteed. 87 */ 88 #define SOLIB_HAVE_LOAD_EVENT(pid) \ 89 som_solib_have_load_event (pid) 90 91 extern int som_solib_have_load_event (int); 92 93 /* This function returns a pointer to the string representation of the 94 pathname of the dynamically-linked library that has just been loaded. 95 96 This function must be used only when SOLIB_HAVE_LOAD_EVENT is TRUE, 97 or undefined results are guaranteed. 98 99 This string's contents are only valid immediately after the inferior 100 has stopped in the dynamic linker hook, and becomes invalid as soon 101 as the inferior is continued. Clients should make a copy of this 102 string if they wish to continue the inferior and then access the string. 103 */ 104 #define SOLIB_LOADED_LIBRARY_PATHNAME(pid) \ 105 som_solib_loaded_library_pathname (pid) 106 107 extern char *som_solib_loaded_library_pathname (int); 108 109 /* This function returns TRUE if the dynamic linker has just reported 110 an unload of a library. 111 112 This function must be used only when the inferior has stopped in 113 the dynamic linker hook, or undefined results are guaranteed. 114 */ 115 #define SOLIB_HAVE_UNLOAD_EVENT(pid) \ 116 som_solib_have_unload_event (pid) 117 118 extern int som_solib_have_unload_event (int); 119 120 /* This function returns a pointer to the string representation of the 121 pathname of the dynamically-linked library that has just been unloaded. 122 123 This function must be used only when SOLIB_HAVE_UNLOAD_EVENT is TRUE, 124 or undefined results are guaranteed. 125 126 This string's contents are only valid immediately after the inferior 127 has stopped in the dynamic linker hook, and becomes invalid as soon 128 as the inferior is continued. Clients should make a copy of this 129 string if they wish to continue the inferior and then access the string. 130 */ 131 #define SOLIB_UNLOADED_LIBRARY_PATHNAME(pid) \ 132 som_solib_unloaded_library_pathname (pid) 133 134 extern char *som_solib_unloaded_library_pathname (int); 135 136 /* This function returns TRUE if pc is the address of an instruction that 137 lies within the dynamic linker (such as the event hook, or the dld 138 itself). 139 140 This function must be used only when a dynamic linker event has been 141 caught, and the inferior is being stepped out of the hook, or undefined 142 results are guaranteed. 143 */ 144 #define SOLIB_IN_DYNAMIC_LINKER(pid,pc) \ 145 som_solib_in_dynamic_linker (pid, pc) 146 147 extern int som_solib_in_dynamic_linker (int, CORE_ADDR); 148 149 /* This function must be called when the inferior is killed, and the program 150 restarted. This is not the same as CLEAR_SOLIB, in that it doesn't discard 151 any symbol tables. 152 153 Presently, this functionality is not implemented. 154 */ 155 #define SOLIB_RESTART() \ 156 som_solib_restart () 157 158 extern void som_solib_restart (void); 159 160 /* If we can't set a breakpoint, and it's in a shared library, just 161 disable it. */ 162 163 #define DISABLE_UNSETTABLE_BREAK(addr) (som_solib_address(addr) != NULL) 164 165 extern char *som_solib_address (CORE_ADDR); /* somsolib.c */ 166 167 /* If ADDR lies in a shared library, return its name. */ 168 169 #define PC_SOLIB(addr) som_solib_address (addr) 170 171 extern CORE_ADDR som_solib_get_solib_by_pc (CORE_ADDR addr); 172 173 struct so_list; 174 extern CORE_ADDR so_lib_thread_start_addr (struct so_list *so); 175 176 extern void no_shared_libraries (char *ignored, int from_tty); 177 178 #endif 179