1/* COFF (SVR3) Shared library declarations for GDB, the GNU Debugger. 2 Copyright 1992, 1993, 1998, 1999, 2000, 2003 Free Software Foundation, Inc. 3 4 This file is part of GDB. 5 6 This program is free software; you can redistribute it and/or modify 7 it under the terms of the GNU General Public License as published by 8 the Free Software Foundation; either version 2 of the License, or 9 (at your option) any later version. 10 11 This program is distributed in the hope that it will be useful, 12 but WITHOUT ANY WARRANTY; without even the implied warranty of 13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 14 GNU General Public License for more details. 15 16 You should have received a copy of the GNU General Public License 17 along with this program; if not, write to the Free Software 18 Foundation, Inc., 59 Temple Place - Suite 330, 19 Boston, MA 02111-1307, USA. */ 20 21/* Forward decl's for prototypes */ 22struct target_ops; 23 24/* Called when we free all symtabs, to free the shared library information 25 as well. */ 26 27#if 0 28#define CLEAR_SOLIB coff_clear_solib 29 30extern void coff_clear_solib (void); 31#endif 32 33/* Called to add symbols from a shared library to gdb's symbol table. */ 34 35#define SOLIB_ADD(filename, from_tty, targ, readsyms) \ 36 coff_solib_add (filename, from_tty, targ, readsyms) 37 38extern void coff_solib_add (char *, int, struct target_ops *, int); 39 40/* Function to be called when the inferior starts up, to discover the names 41 of shared libraries that are dynamically linked, the base addresses to 42 which they are linked, and sufficient information to read in their symbols 43 at a later time. */ 44 45#define SOLIB_CREATE_INFERIOR_HOOK(PID) coff_solib_create_inferior_hook() 46 47extern void coff_solib_create_inferior_hook (void); /* solib.c */ 48 49/* Function to be called to remove the connection between debugger and 50 dynamic linker that was established by SOLIB_CREATE_INFERIOR_HOOK. 51 (This operation does not remove shared library information from 52 the debugger, as CLEAR_SOLIB does.) 53 54 This functionality is presently not implemented for this target. 55 */ 56#define SOLIB_REMOVE_INFERIOR_HOOK(PID) (0) 57 58/* This function is called by the "catch load" command. It allows 59 the debugger to be notified by the dynamic linker when a specified 60 library file (or any library file, if filename is NULL) is loaded. 61 62 Presently, this functionality is not implemented. 63 */ 64#define SOLIB_CREATE_CATCH_LOAD_HOOK(pid,tempflag,filename,cond_string) \ 65 error("catch of library loads/unloads not yet implemented on this platform") 66 67/* This function is called by the "catch unload" command. It allows 68 the debugger to be notified by the dynamic linker when a specified 69 library file (or any library file, if filename is NULL) is unloaded. 70 71 Presently, this functionality is not implemented. 72 */ 73#define SOLIB_CREATE_CATCH_UNLOAD_HOOK(pid,tempflag,filename,cond_string) \ 74 error("catch of library loads/unloads not yet implemented on this platform") 75 76/* This function returns TRUE if the dynamic linker has just reported 77 a load of a library. 78 79 This function must be used only when the inferior has stopped in 80 the dynamic linker hook, or undefined results are guaranteed. 81 82 Presently, this functionality is not implemented. 83 */ 84/* 85 #define SOLIB_HAVE_LOAD_EVENT(pid) \ 86 error("catch of library loads/unloads not yet implemented on this platform") 87 */ 88 89#define SOLIB_HAVE_LOAD_EVENT(pid) \ 90(0) 91 92/* This function returns a pointer to the string representation of the 93 pathname of the dynamically-linked library that has just been loaded. 94 95 This function must be used only when SOLIB_HAVE_LOAD_EVENT is TRUE, 96 or undefined results are guaranteed. 97 98 This string's contents are only valid immediately after the inferior 99 has stopped in the dynamic linker hook, and becomes invalid as soon 100 as the inferior is continued. Clients should make a copy of this 101 string if they wish to continue the inferior and then access the string. 102 103 Presently, this functionality is not implemented. 104 */ 105 106/* 107 #define SOLIB_LOADED_LIBRARY_PATHNAME(pid) \ 108 error("catch of library loads/unloads not yet implemented on this platform") 109 */ 110 111#define SOLIB_LOADED_LIBRARY_PATHNAME(pid) \ 112"" 113 114/* This function returns TRUE if the dynamic linker has just reported 115 an unload of a library. 116 117 This function must be used only when the inferior has stopped in 118 the dynamic linker hook, or undefined results are guaranteed. 119 120 Presently, this functionality is not implemented. 121 */ 122/* 123 #define SOLIB_HAVE_UNLOAD_EVENT(pid) \ 124 error("catch of library loads/unloads not yet implemented on this platform") 125 */ 126 127#define SOLIB_HAVE_UNLOAD_EVENT(pid) \ 128(0) 129 130/* This function returns a pointer to the string representation of the 131 pathname of the dynamically-linked library that has just been unloaded. 132 133 This function must be used only when SOLIB_HAVE_UNLOAD_EVENT is TRUE, 134 or undefined results are guaranteed. 135 136 This string's contents are only valid immediately after the inferior 137 has stopped in the dynamic linker hook, and becomes invalid as soon 138 as the inferior is continued. Clients should make a copy of this 139 string if they wish to continue the inferior and then access the string. 140 141 Presently, this functionality is not implemented. 142 */ 143/* 144 #define SOLIB_UNLOADED_LIBRARY_PATHNAME(pid) \ 145 error("catch of library loads/unloads not yet implemented on this platform") 146 */ 147 148#define SOLIB_UNLOADED_LIBRARY_PATHNAME(pid) \ 149(0) 150 151/* This function returns TRUE if pc is the address of an instruction that 152 lies within the dynamic linker (such as the event hook, or the dld 153 itself). 154 155 This function must be used only when a dynamic linker event has been 156 caught, and the inferior is being stepped out of the hook, or undefined 157 results are guaranteed. 158 159 Presently, this functionality is not implemented. 160 */ 161 162/* 163 #define SOLIB_IN_DYNAMIC_LINKER(pid,pc) \ 164 error("catch of library loads/unloads not yet implemented on this platform") 165 */ 166 167#define SOLIB_IN_DYNAMIC_LINKER(pid,pc) \ 168(0) 169 170/* This function must be called when the inferior is killed, and the program 171 restarted. This is not the same as CLEAR_SOLIB, in that it doesn't discard 172 any symbol tables. 173 174 Presently, this functionality is not implemented. 175 */ 176#define SOLIB_RESTART() \ 177 (0) 178 179/* If we can't set a breakpoint, and it's in a shared library, just 180 disable it. */ 181 182#if 0 183#define DISABLE_UNSETTABLE_BREAK(addr) coff_solib_address(addr) 184 185extern int solib_address (CORE_ADDR); /* solib.c */ 186#endif 187