]>
Commit | Line | Data |
---|---|---|
7e6d3809 UD |
1 | /* Data structure for communication from the run-time dynamic linker for |
2 | loaded ELF shared objects. | |
688903eb | 3 | Copyright (C) 1995-2018 Free Software Foundation, Inc. |
7e6d3809 UD |
4 | This file is part of the GNU C Library. |
5 | ||
6 | The GNU C Library is free software; you can redistribute it and/or | |
41bdb6e2 AJ |
7 | modify it under the terms of the GNU Lesser General Public |
8 | License as published by the Free Software Foundation; either | |
9 | version 2.1 of the License, or (at your option) any later version. | |
7e6d3809 UD |
10 | |
11 | The GNU C Library 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 GNU | |
41bdb6e2 | 14 | Lesser General Public License for more details. |
7e6d3809 | 15 | |
41bdb6e2 | 16 | You should have received a copy of the GNU Lesser General Public |
59ba27a6 PE |
17 | License along with the GNU C Library; if not, see |
18 | <http://www.gnu.org/licenses/>. */ | |
7e6d3809 | 19 | |
d78efd9f RM |
20 | #ifndef _PRIVATE_LINK_H |
21 | #define _PRIVATE_LINK_H 1 | |
7e6d3809 | 22 | |
d78efd9f RM |
23 | #ifdef _LINK_H |
24 | # error this should be impossible | |
25 | #endif | |
26 | ||
47755784 | 27 | # ifndef _ISOMAC |
d78efd9f RM |
28 | /* Get most of the contents from the public header, but we define a |
29 | different `struct link_map' type for private use. The la_objopen | |
30 | prototype uses the type, so we have to declare it separately. */ | |
47755784 ZW |
31 | # define link_map link_map_public |
32 | # define la_objopen la_objopen_wrongproto | |
33 | # endif | |
34 | ||
d78efd9f | 35 | #include <elf/link.h> |
47755784 ZW |
36 | |
37 | # ifndef _ISOMAC | |
38 | ||
d78efd9f RM |
39 | #undef link_map |
40 | #undef la_objopen | |
41 | ||
42 | struct link_map; | |
43 | extern unsigned int la_objopen (struct link_map *__map, Lmid_t __lmid, | |
44 | uintptr_t *__cookie); | |
7e6d3809 | 45 | |
e054f494 | 46 | #include <stdint.h> |
d78efd9f | 47 | #include <stddef.h> |
522e02ab | 48 | #include <linkmap.h> |
c01ae97e | 49 | #include <dl-fileid.h> |
a334319f | 50 | #include <dl-lookupcfg.h> |
b52bbc1b | 51 | #include <tls.h> |
ec999b8e | 52 | #include <libc-lock.h> |
7e6d3809 | 53 | |
7e6d3809 UD |
54 | |
55 | /* Some internal data structures of the dynamic linker used in the | |
56 | linker map. We only provide forward declarations. */ | |
57 | struct libname_list; | |
58 | struct r_found_version; | |
59 | struct r_search_path_elem; | |
60 | ||
61 | /* Forward declaration. */ | |
62 | struct link_map; | |
63 | ||
64 | /* Structure to describe a single list of scope elements. The lookup | |
65 | functions get passed an array of pointers to such structures. */ | |
66 | struct r_scope_elem | |
67 | { | |
68 | /* Array of maps for the scope. */ | |
69 | struct link_map **r_list; | |
70 | /* Number of entries in the scope. */ | |
71 | unsigned int r_nlist; | |
7e6d3809 UD |
72 | }; |
73 | ||
74 | ||
f55727ca UD |
75 | /* Structure to record search path and allocation mechanism. */ |
76 | struct r_search_path_struct | |
77 | { | |
78 | struct r_search_path_elem **dirs; | |
79 | int malloced; | |
80 | }; | |
81 | ||
82 | ||
7e6d3809 UD |
83 | /* Structure describing a loaded shared object. The `l_next' and `l_prev' |
84 | members form a chain of all the shared objects loaded at startup. | |
85 | ||
86 | These data structures exist in space used by the run-time dynamic linker; | |
87 | modifying them may have disastrous results. | |
88 | ||
89 | This data structure might change in future, if necessary. User-level | |
90 | programs must avoid defining objects of this type. */ | |
91 | ||
92 | struct link_map | |
93 | { | |
94 | /* These first few members are part of the protocol with the debugger. | |
95 | This is the same format used in SVR4. */ | |
96 | ||
542f9466 JK |
97 | ElfW(Addr) l_addr; /* Difference between the address in the ELF |
98 | file and the addresses in memory. */ | |
7e6d3809 UD |
99 | char *l_name; /* Absolute file name object was found in. */ |
100 | ElfW(Dyn) *l_ld; /* Dynamic section of the shared object. */ | |
101 | struct link_map *l_next, *l_prev; /* Chain of loaded objects. */ | |
102 | ||
103 | /* All following members are internal to the dynamic linker. | |
104 | They may change without notice. */ | |
105 | ||
c0f62c56 UD |
106 | /* This is an element which is only ever different from a pointer to |
107 | the very same copy of this type for ld.so when it is used in more | |
108 | than one namespace. */ | |
109 | struct link_map *l_real; | |
110 | ||
111 | /* Number of the namespace this link map belongs to. */ | |
112 | Lmid_t l_ns; | |
113 | ||
7e6d3809 UD |
114 | struct libname_list *l_libname; |
115 | /* Indexed pointers to dynamic section. | |
116 | [0,DT_NUM) are indexed by the processor-independent tags. | |
117 | [DT_NUM,DT_NUM+DT_THISPROCNUM) are indexed by the tag minus DT_LOPROC. | |
32e6df36 UD |
118 | [DT_NUM+DT_THISPROCNUM,DT_NUM+DT_THISPROCNUM+DT_VERSIONTAGNUM) are |
119 | indexed by DT_VERSIONTAGIDX(tagvalue). | |
7e6d3809 | 120 | [DT_NUM+DT_THISPROCNUM+DT_VERSIONTAGNUM, |
32e6df36 UD |
121 | DT_NUM+DT_THISPROCNUM+DT_VERSIONTAGNUM+DT_EXTRANUM) are indexed by |
122 | DT_EXTRATAGIDX(tagvalue). | |
123 | [DT_NUM+DT_THISPROCNUM+DT_VERSIONTAGNUM+DT_EXTRANUM, | |
124 | DT_NUM+DT_THISPROCNUM+DT_VERSIONTAGNUM+DT_EXTRANUM+DT_VALNUM) are | |
125 | indexed by DT_VALTAGIDX(tagvalue) and | |
126 | [DT_NUM+DT_THISPROCNUM+DT_VERSIONTAGNUM+DT_EXTRANUM+DT_VALNUM, | |
127 | DT_NUM+DT_THISPROCNUM+DT_VERSIONTAGNUM+DT_EXTRANUM+DT_VALNUM+DT_ADDRNUM) | |
128 | are indexed by DT_ADDRTAGIDX(tagvalue), see <elf.h>. */ | |
7e6d3809 UD |
129 | |
130 | ElfW(Dyn) *l_info[DT_NUM + DT_THISPROCNUM + DT_VERSIONTAGNUM | |
11bf311e | 131 | + DT_EXTRANUM + DT_VALNUM + DT_ADDRNUM]; |
7e6d3809 UD |
132 | const ElfW(Phdr) *l_phdr; /* Pointer to program header table in core. */ |
133 | ElfW(Addr) l_entry; /* Entry point location. */ | |
134 | ElfW(Half) l_phnum; /* Number of program header entries. */ | |
871b9158 | 135 | ElfW(Half) l_ldnum; /* Number of dynamic segment entries. */ |
7e6d3809 UD |
136 | |
137 | /* Array of DT_NEEDED dependencies and their dependencies, in | |
138 | dependency order for symbol lookup (with and without | |
139 | duplicates). There is no entry before the dependencies have | |
140 | been loaded. */ | |
141 | struct r_scope_elem l_searchlist; | |
142 | ||
143 | /* We need a special searchlist to process objects marked with | |
144 | DT_SYMBOLIC. */ | |
145 | struct r_scope_elem l_symbolic_searchlist; | |
146 | ||
147 | /* Dependent object that first caused this object to be loaded. */ | |
148 | struct link_map *l_loader; | |
149 | ||
341c566f UD |
150 | /* Array with version names. */ |
151 | struct r_found_version *l_versions; | |
152 | unsigned int l_nversions; | |
153 | ||
7e6d3809 UD |
154 | /* Symbol hash table. */ |
155 | Elf_Symndx l_nbuckets; | |
871b9158 UD |
156 | Elf32_Word l_gnu_bitmask_idxbits; |
157 | Elf32_Word l_gnu_shift; | |
158 | const ElfW(Addr) *l_gnu_bitmask; | |
159 | union | |
160 | { | |
161 | const Elf32_Word *l_gnu_buckets; | |
162 | const Elf_Symndx *l_chain; | |
163 | }; | |
164 | union | |
165 | { | |
166 | const Elf32_Word *l_gnu_chain_zero; | |
167 | const Elf_Symndx *l_buckets; | |
168 | }; | |
7e6d3809 | 169 | |
c0f62c56 | 170 | unsigned int l_direct_opencount; /* Reference count for dlopen/dlclose. */ |
7e6d3809 UD |
171 | enum /* Where this object came from. */ |
172 | { | |
173 | lt_executable, /* The main executable program. */ | |
174 | lt_library, /* Library needed by main executable. */ | |
175 | lt_loaded /* Extra run-time loaded shared object. */ | |
176 | } l_type:2; | |
177 | unsigned int l_relocated:1; /* Nonzero if object's relocations done. */ | |
178 | unsigned int l_init_called:1; /* Nonzero if DT_INIT function called. */ | |
179 | unsigned int l_global:1; /* Nonzero if object in _dl_global_scope. */ | |
180 | unsigned int l_reserved:2; /* Reserved for internal use. */ | |
181 | unsigned int l_phdr_allocated:1; /* Nonzero if the data structure pointed | |
182 | to by `l_phdr' is allocated. */ | |
c91bc73e UD |
183 | unsigned int l_soname_added:1; /* Nonzero if the SONAME is for sure in |
184 | the l_libname list. */ | |
a881e0a0 UD |
185 | unsigned int l_faked:1; /* Nonzero if this is a faked descriptor |
186 | without associated file. */ | |
adc12574 UD |
187 | unsigned int l_need_tls_init:1; /* Nonzero if GL(dl_init_static_tls) |
188 | should be called on this link map | |
189 | when relocation finishes. */ | |
9dcafc55 UD |
190 | unsigned int l_auditing:1; /* Nonzero if the DSO is used in auditing. */ |
191 | unsigned int l_audit_any_plt:1; /* Nonzero if at least one audit module | |
192 | is interested in the PLT interception.*/ | |
20fe49b9 UD |
193 | unsigned int l_removed:1; /* Nozero if the object cannot be used anymore |
194 | since it is removed. */ | |
9be09e06 UD |
195 | unsigned int l_contiguous:1; /* Nonzero if inter-segment holes are |
196 | mprotected or if no holes are present at | |
197 | all. */ | |
4ad43b62 UD |
198 | unsigned int l_symbolic_in_local_scope:1; /* Nonzero if l_local_scope |
199 | during LD_TRACE_PRELINKING=1 | |
200 | contains any DT_SYMBOLIC | |
201 | libraries. */ | |
0479b305 AS |
202 | unsigned int l_free_initfini:1; /* Nonzero if l_initfini can be |
203 | freed, ie. not allocated with | |
204 | the dummy malloc in ld.so. */ | |
9dcafc55 | 205 | |
4a306ef1 L |
206 | #include <link_map.h> |
207 | ||
7e6d3809 | 208 | /* Collected information about own RPATH directories. */ |
f55727ca | 209 | struct r_search_path_struct l_rpath_dirs; |
7e6d3809 UD |
210 | |
211 | /* Collected results of relocation while profiling. */ | |
9dcafc55 UD |
212 | struct reloc_result |
213 | { | |
6aa10807 | 214 | DL_FIXUP_VALUE_TYPE addr; |
9dcafc55 UD |
215 | struct link_map *bound; |
216 | unsigned int boundndx; | |
217 | uint32_t enterexit; | |
218 | unsigned int flags; | |
e5d262ef TMQMF |
219 | /* CONCURRENCY NOTE: This is used to guard the concurrent initialization |
220 | of the relocation result across multiple threads. See the more | |
221 | detailed notes in elf/dl-runtime.c. */ | |
222 | unsigned int init; | |
9dcafc55 | 223 | } *l_reloc_result; |
7e6d3809 UD |
224 | |
225 | /* Pointer to the version information if available. */ | |
226 | ElfW(Versym) *l_versyms; | |
227 | ||
228 | /* String specifying the path where this object was found. */ | |
229 | const char *l_origin; | |
230 | ||
231 | /* Start and finish of memory map for this object. l_map_start | |
232 | need not be the same as l_addr. */ | |
233 | ElfW(Addr) l_map_start, l_map_end; | |
eec8b6ca UD |
234 | /* End of the executable part of the mapping. */ |
235 | ElfW(Addr) l_text_end; | |
7e6d3809 | 236 | |
b98e518f | 237 | /* Default array for 'l_scope'. */ |
c0a777e8 | 238 | struct r_scope_elem *l_scope_mem[4]; |
b98e518f UD |
239 | /* Size of array allocated for 'l_scope'. */ |
240 | size_t l_scope_max; | |
7e6d3809 | 241 | /* This is an array defining the lookup scope for this link map. |
c69136ae | 242 | There are initially at most three different scope lists. */ |
c0a777e8 | 243 | struct r_scope_elem **l_scope; |
7e6d3809 UD |
244 | |
245 | /* A similar array, this time only with the local scope. This is | |
246 | used occasionally. */ | |
247 | struct r_scope_elem *l_local_scope[2]; | |
248 | ||
249 | /* This information is kept to check for sure whether a shared | |
250 | object is the same as one already loaded. */ | |
c01ae97e | 251 | struct r_file_id l_file_id; |
7e6d3809 UD |
252 | |
253 | /* Collected information about own RUNPATH directories. */ | |
f55727ca | 254 | struct r_search_path_struct l_runpath_dirs; |
7e6d3809 UD |
255 | |
256 | /* List of object in order of the init and fini calls. */ | |
257 | struct link_map **l_initfini; | |
258 | ||
259 | /* List of the dependencies introduced through symbol binding. */ | |
385b4cf4 UD |
260 | struct link_map_reldeps |
261 | { | |
262 | unsigned int act; | |
263 | struct link_map *list[]; | |
264 | } *l_reldeps; | |
2af63968 UD |
265 | unsigned int l_reldepsmax; |
266 | ||
267 | /* Nonzero if the DSO is used. */ | |
268 | unsigned int l_used; | |
bf8b3e74 UD |
269 | |
270 | /* Various flag words. */ | |
271 | ElfW(Word) l_feature_1; | |
272 | ElfW(Word) l_flags_1; | |
ec70c011 | 273 | ElfW(Word) l_flags; |
69c33254 UD |
274 | |
275 | /* Temporarily used in `dl_close'. */ | |
20fe49b9 | 276 | int l_idx; |
370f00c3 UD |
277 | |
278 | struct link_map_machine l_mach; | |
680254fe UD |
279 | |
280 | struct | |
281 | { | |
282 | const ElfW(Sym) *sym; | |
cf5a372e | 283 | int type_class; |
680254fe | 284 | struct link_map *value; |
680254fe UD |
285 | const ElfW(Sym) *ret; |
286 | } l_lookup_cache; | |
5d6feea8 UD |
287 | |
288 | /* Thread-local storage related info. */ | |
289 | ||
5d6feea8 UD |
290 | /* Start of the initialization image. */ |
291 | void *l_tls_initimage; | |
292 | /* Size of the initialization image. */ | |
293 | size_t l_tls_initimage_size; | |
294 | /* Size of the TLS block. */ | |
295 | size_t l_tls_blocksize; | |
877e0d8e | 296 | /* Alignment requirement of the TLS block. */ |
3fb55878 | 297 | size_t l_tls_align; |
99fe3b0e UD |
298 | /* Offset of first byte module alignment. */ |
299 | size_t l_tls_firstbyte_offset; | |
11bf311e UD |
300 | #ifndef NO_TLS_OFFSET |
301 | # define NO_TLS_OFFSET 0 | |
4c533566 UD |
302 | #endif |
303 | #ifndef FORCED_DYNAMIC_TLS_OFFSET | |
304 | # if NO_TLS_OFFSET == 0 | |
67cbf9a2 | 305 | # define FORCED_DYNAMIC_TLS_OFFSET -1 |
4c533566 UD |
306 | # elif NO_TLS_OFFSET == -1 |
307 | # define FORCED_DYNAMIC_TLS_OFFSET -2 | |
308 | # else | |
309 | # error "FORCED_DYNAMIC_TLS_OFFSET is not defined" | |
310 | # endif | |
11bf311e | 311 | #endif |
5d6feea8 UD |
312 | /* For objects present at startup time: offset in the static TLS block. */ |
313 | ptrdiff_t l_tls_offset; | |
314 | /* Index of the module in the dtv array. */ | |
315 | size_t l_tls_modid; | |
ed20b3d9 | 316 | |
90b37cac SP |
317 | /* Number of thread_local objects constructed by this DSO. This is |
318 | atomically accessed and modified and is not always protected by the load | |
319 | lock. See also: CONCURRENCY NOTES in cxa_thread_atexit_impl.c. */ | |
ba384f6e SP |
320 | size_t l_tls_dtor_count; |
321 | ||
ed20b3d9 UD |
322 | /* Information used to change permission after the relocations are |
323 | done. */ | |
324 | ElfW(Addr) l_relro_addr; | |
325 | size_t l_relro_size; | |
9dcafc55 | 326 | |
b90395e6 UD |
327 | unsigned long long int l_serial; |
328 | ||
9dcafc55 UD |
329 | /* Audit information. This array apparent must be the last in the |
330 | structure. Never add something after it. */ | |
331 | struct auditstate | |
332 | { | |
333 | uintptr_t cookie; | |
334 | unsigned int bindflags; | |
335 | } l_audit[0]; | |
336 | }; | |
337 | ||
9dcafc55 UD |
338 | |
339 | #if __ELF_NATIVE_CLASS == 32 | |
340 | # define symbind symbind32 | |
9dcafc55 UD |
341 | #elif __ELF_NATIVE_CLASS == 64 |
342 | # define symbind symbind64 | |
343 | #else | |
344 | # error "__ELF_NATIVE_CLASS must be defined" | |
345 | #endif | |
346 | ||
48ab1c2f UD |
347 | extern int __dl_iterate_phdr (int (*callback) (struct dl_phdr_info *info, |
348 | size_t size, void *data), | |
349 | void *data); | |
a0aef783 | 350 | hidden_proto (__dl_iterate_phdr) |
48ab1c2f | 351 | |
81b035fe L |
352 | /* We use this macro to refer to ELF macros independent of the native |
353 | wordsize. `ELFW(R_TYPE)' is used in place of `ELF32_R_TYPE' or | |
354 | `ELF64_R_TYPE'. */ | |
355 | #define ELFW(type) _ElfW (ELF, __ELF_NATIVE_CLASS, type) | |
356 | ||
47755784 | 357 | # endif /* !_ISOMAC */ |
d78efd9f | 358 | #endif /* include/link.h */ |