Commit | Line | Data |
---|---|---|
13437d4b | 1 | /* Shared library declarations for GDB, the GNU Debugger. |
0b302171 JB |
2 | Copyright (C) 1990-1996, 1998-2001, 2007-2012 Free Software |
3 | Foundation, Inc. | |
13437d4b KB |
4 | |
5 | This file is part of GDB. | |
6 | ||
7 | This program is free software; you can redistribute it and/or modify | |
8 | it under the terms of the GNU General Public License as published by | |
a9762ec7 | 9 | the Free Software Foundation; either version 3 of the License, or |
13437d4b KB |
10 | (at your option) any later version. |
11 | ||
12 | This program is distributed in the hope that it will be useful, | |
13 | but WITHOUT ANY WARRANTY; without even the implied warranty of | |
14 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
15 | GNU General Public License for more details. | |
16 | ||
17 | You should have received a copy of the GNU General Public License | |
a9762ec7 | 18 | along with this program. If not, see <http://www.gnu.org/licenses/>. */ |
13437d4b | 19 | |
17732724 AC |
20 | #ifndef SOLIST_H |
21 | #define SOLIST_H | |
22 | ||
13437d4b | 23 | #define SO_NAME_MAX_PATH_SIZE 512 /* FIXME: Should be dynamic */ |
3a40aaa0 UW |
24 | /* For domain_enum domain. */ |
25 | #include "symtab.h" | |
13437d4b KB |
26 | |
27 | /* Forward declaration for target specific link map information. This | |
28 | struct is opaque to all but the target specific file. */ | |
29 | struct lm_info; | |
30 | ||
31 | struct so_list | |
32 | { | |
33 | /* The following fields of the structure come directly from the | |
34 | dynamic linker's tables in the inferior, and are initialized by | |
35 | current_sos. */ | |
36 | ||
37 | struct so_list *next; /* next structure in linked list */ | |
38 | ||
39 | /* A pointer to target specific link map information. Often this | |
40 | will be a copy of struct link_map from the user process, but | |
41 | it need not be; it can be any collection of data needed to | |
c378eb4e | 42 | traverse the dynamic linker's data structures. */ |
13437d4b KB |
43 | struct lm_info *lm_info; |
44 | ||
45 | /* Shared object file name, exactly as it appears in the | |
46 | inferior's link map. This may be a relative path, or something | |
47 | which needs to be looked up in LD_LIBRARY_PATH, etc. We use it | |
48 | to tell which entries in the inferior's dynamic linker's link | |
49 | map we've already loaded. */ | |
50 | char so_original_name[SO_NAME_MAX_PATH_SIZE]; | |
51 | ||
c378eb4e | 52 | /* Shared object file name, expanded to something GDB can open. */ |
13437d4b KB |
53 | char so_name[SO_NAME_MAX_PATH_SIZE]; |
54 | ||
6c95b8df PA |
55 | /* Program space this shared library belongs to. */ |
56 | struct program_space *pspace; | |
57 | ||
13437d4b KB |
58 | /* The following fields of the structure are built from |
59 | information gathered from the shared object file itself, and | |
fa3b51d2 ND |
60 | are set when we actually add it to our symbol tables. |
61 | ||
62 | current_sos must initialize these fields to 0. */ | |
13437d4b KB |
63 | |
64 | bfd *abfd; | |
c378eb4e | 65 | char symbols_loaded; /* flag: symbols read in yet? */ |
c0201579 JK |
66 | |
67 | /* objfile with symbols for a loaded library. Target memory is read from | |
68 | ABFD. OBJFILE may be NULL either before symbols have been loaded, if | |
69 | the file cannot be found or after the command "nosharedlibrary". */ | |
70 | struct objfile *objfile; | |
71 | ||
0542c86d PA |
72 | struct target_section *sections; |
73 | struct target_section *sections_end; | |
cfa9d6d9 DJ |
74 | |
75 | /* Record the range of addresses belonging to this shared library. | |
76 | There may not be just one (e.g. if two segments are relocated | |
77 | differently); but this is only used for "info sharedlibrary". */ | |
78 | CORE_ADDR addr_low, addr_high; | |
13437d4b KB |
79 | }; |
80 | ||
81 | struct target_so_ops | |
82 | { | |
749499cb KB |
83 | /* Adjust the section binding addresses by the base address at |
84 | which the object was actually mapped. */ | |
85 | void (*relocate_section_addresses) (struct so_list *so, | |
0542c86d | 86 | struct target_section *); |
749499cb | 87 | |
b021a221 MS |
88 | /* Free the link map info and any other private data structures |
89 | associated with a so_list entry. */ | |
13437d4b | 90 | void (*free_so) (struct so_list *so); |
749499cb KB |
91 | |
92 | /* Reset or free private data structures not associated with | |
93 | so_list entries. */ | |
13437d4b | 94 | void (*clear_solib) (void); |
749499cb KB |
95 | |
96 | /* Target dependent code to run after child process fork. */ | |
268a4a75 | 97 | void (*solib_create_inferior_hook) (int from_tty); |
749499cb | 98 | |
7f86f058 PA |
99 | /* Do additional symbol handling, lookup, etc. after symbols for a |
100 | shared object have been loaded in the usual way. This is | |
101 | called to do any system specific symbol handling that might be | |
102 | needed. */ | |
13437d4b | 103 | void (*special_symbol_handling) (void); |
749499cb | 104 | |
7f86f058 PA |
105 | /* Construct a list of the currently loaded shared objects. This |
106 | list does not include an entry for the main executable file. | |
107 | ||
108 | Note that we only gather information directly available from the | |
109 | inferior --- we don't examine any of the shared library files | |
110 | themselves. The declaration of `struct so_list' says which fields | |
111 | we provide values for. */ | |
13437d4b | 112 | struct so_list *(*current_sos) (void); |
749499cb | 113 | |
7f86f058 PA |
114 | /* Find, open, and read the symbols for the main executable. If |
115 | FROM_TTYP dereferences to a non-zero integer, allow messages to | |
116 | be printed. This parameter is a pointer rather than an int | |
117 | because open_symbol_file_object is called via catch_errors and | |
118 | catch_errors requires a pointer argument. */ | |
13437d4b | 119 | int (*open_symbol_file_object) (void *from_ttyp); |
d7fa2ae2 KB |
120 | |
121 | /* Determine if PC lies in the dynamic symbol resolution code of | |
c378eb4e | 122 | the run time loader. */ |
d7fa2ae2 | 123 | int (*in_dynsym_resolve_code) (CORE_ADDR pc); |
2610b0bf | 124 | |
572d275c UW |
125 | /* Find and open shared library binary file. */ |
126 | bfd *(*bfd_open) (char *pathname); | |
127 | ||
c378eb4e | 128 | /* Extra hook for finding and opening a solib. |
3636de8b | 129 | Convenience function for remote debuggers finding host libs. */ |
2610b0bf KW |
130 | int (*find_and_open_solib) (char *soname, |
131 | unsigned o_flags, char **temp_pathname); | |
3a40aaa0 UW |
132 | |
133 | /* Hook for looking up global symbols in a library-specific way. */ | |
134 | struct symbol * (*lookup_lib_global_symbol) (const struct objfile *objfile, | |
135 | const char *name, | |
21b556f4 | 136 | const domain_enum domain); |
3a40aaa0 | 137 | |
a7c02bc8 VP |
138 | /* Given two so_list objects, one from the GDB thread list |
139 | and another from the list returned by current_sos, return 1 | |
7a848be1 TG |
140 | if they represent the same library. |
141 | Falls back to using strcmp on so_original_name field when set | |
142 | to NULL. */ | |
a7c02bc8 | 143 | int (*same) (struct so_list *gdb, struct so_list *inferior); |
de18c1d8 JM |
144 | |
145 | /* Return whether a region of memory must be kept in a core file | |
146 | for shared libraries loaded before "gcore" is used to be | |
147 | handled correctly when the core file is loaded. This only | |
148 | applies when the section would otherwise not be kept in the | |
149 | core file (in particular, for readonly sections). */ | |
150 | int (*keep_data_in_core) (CORE_ADDR vaddr, | |
151 | unsigned long size); | |
13437d4b KB |
152 | }; |
153 | ||
f8766ec1 | 154 | /* Free the memory associated with a (so_list *). */ |
13437d4b KB |
155 | void free_so (struct so_list *so); |
156 | ||
f8766ec1 KB |
157 | /* Return address of first so_list entry in master shared object list. */ |
158 | struct so_list *master_so_list (void); | |
159 | ||
572d275c UW |
160 | /* Find shared library binary file. */ |
161 | extern char *solib_find (char *in_pathname, int *fd); | |
162 | ||
163 | /* Open BFD for shared library file. */ | |
164 | extern bfd *solib_bfd_fopen (char *pathname, int fd); | |
165 | ||
e4f7b8c8 | 166 | /* Find solib binary file and open it. */ |
f1838a98 | 167 | extern bfd *solib_bfd_open (char *in_pathname); |
e4f7b8c8 | 168 | |
c378eb4e | 169 | /* FIXME: gdbarch needs to control this variable. */ |
13437d4b KB |
170 | extern struct target_so_ops *current_target_so_ops; |
171 | ||
3a40aaa0 UW |
172 | /* Handler for library-specific global symbol lookup in solib.c. */ |
173 | struct symbol *solib_global_lookup (const struct objfile *objfile, | |
174 | const char *name, | |
21b556f4 | 175 | const domain_enum domain); |
3a40aaa0 | 176 | |
17732724 | 177 | #endif |