Print this page
7319 Need a way to turn off ld "multiple inclusion" warnings
Reviewed by: Martin Bochnig <opensxce@mail.ru>
Reviewed by: Kim Shrier <kshrier@racktopsystems.com>
Reviewed by: Robert Mustacchi <rm@joyent.com>
Split |
Close |
Expand all |
Collapse all |
--- old/usr/src/cmd/sgs/include/libld.h
+++ new/usr/src/cmd/sgs/include/libld.h
1 1 /*
2 2 * CDDL HEADER START
3 3 *
4 4 * The contents of this file are subject to the terms of the
5 5 * Common Development and Distribution License (the "License").
6 6 * You may not use this file except in compliance with the License.
7 7 *
8 8 * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
9 9 * or http://www.opensolaris.org/os/licensing.
10 10 * See the License for the specific language governing permissions
11 11 * and limitations under the License.
12 12 *
13 13 * When distributing Covered Code, include this CDDL HEADER in each
14 14 * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
15 15 * If applicable, add the following below this CDDL HEADER, with the
16 16 * fields enclosed by brackets "[]" replaced with your own identifying
↓ open down ↓ |
16 lines elided |
↑ open up ↑ |
17 17 * information: Portions Copyright [yyyy] [name of copyright owner]
18 18 *
19 19 * CDDL HEADER END
20 20 */
21 21
22 22 /*
23 23 * Copyright (c) 1988 AT&T
24 24 * All Rights Reserved
25 25 *
26 26 * Copyright (c) 1992, 2010, Oracle and/or its affiliates. All rights reserved.
27 + * Copyright 2016 RackTop Systems.
27 28 */
28 29
29 30 #ifndef _LIBLD_H
30 31 #define _LIBLD_H
31 32
32 33 #include <stdlib.h>
33 34 #include <libelf.h>
34 35 #include <sgs.h>
35 36 #include <_machelf.h>
36 37 #include <string_table.h>
37 38 #include <sys/avl.h>
38 39 #include <alist.h>
39 40 #include <elfcap.h>
40 41
41 42 #ifdef __cplusplus
42 43 extern "C" {
43 44 #endif
44 45
45 46 /*
46 47 * Default directory search path manipulation for the link-editor. YLDIR
47 48 * indicates which directory in LIBPATH is replaced by the -YL option to cc
48 49 * and ld. YUDIR indicates which directory is replaced by -YU.
49 50 */
50 51 #define YLDIR 1
51 52 #define YUDIR 2
52 53
53 54 /*
54 55 * Define a hash value that can never be returned from elf_hash().
55 56 */
56 57 #define SYM_NOHASH (~(Word)0)
57 58
58 59 /*
59 60 * Macro that can be used to represent both ORDER flags
60 61 * in a section header.
61 62 */
62 63 #define ALL_SHF_ORDER (SHF_ORDERED | SHF_LINK_ORDER)
63 64
64 65 /*
65 66 * The linker merges (concatenates) sections with the same name and
66 67 * compatible section header flags. When comparing these flags,
67 68 * there are some that should not be included in the decision.
68 69 * The ALL_SHF_IGNORE constant defines these flags.
69 70 *
70 71 * NOTE: SHF_MERGE|SHF_STRINGS:
71 72 * The compiler is allowed to set the SHF_MERGE|SHF_STRINGS flags in
72 73 * order to tell the linker that:
73 74 *
74 75 * 1) There is nothing in the section except null terminated strings.
75 76 * 2) Those strings do not contain NULL bytes, except as termination.
76 77 * 3) All references to these strings occur via standard relocation
77 78 * records.
78 79 *
79 80 * As a result, if two compatible sections both have these flags set, it is
80 81 * OK to combine the strings they contain into a single merged string table
81 82 * with duplicates removed and tail strings merged.
82 83 *
83 84 * This is a different meaning than the simple concatenating of sections
84 85 * that the linker always does. It is a hint that an additional optimization
85 86 * is possible, but not required. This means that sections that do not
86 87 * share the same SHF_MERGE|SHF_STRINGS values can be concatenated,
87 88 * but cannot have their duplicate strings combined. Hence, the
88 89 * SHF_MERGE|SHF_STRINGS flags should be ignored when deciding whether
89 90 * two sections can be concatenated.
90 91 */
91 92 #define ALL_SHF_IGNORE (ALL_SHF_ORDER | SHF_GROUP | SHF_MERGE | SHF_STRINGS)
92 93
93 94 /*
94 95 * Define symbol reference types for use in symbol resolution.
95 96 */
96 97 typedef enum {
97 98 REF_DYN_SEEN, /* a .so symbol has been seen */
98 99 REF_DYN_NEED, /* a .so symbol satisfies a .o symbol */
99 100 REF_REL_NEED, /* a .o symbol */
100 101 REF_NUM /* the number of symbol references */
101 102 } Symref;
102 103
103 104 /*
104 105 * Relocation descriptor cache
105 106 */
106 107 struct rel_cache {
107 108 APlist *rc_list; /* list of Rel_cachebuf */
108 109 Word rc_cnt; /* and count */
109 110 };
110 111
111 112 /*
112 113 * GOT reference models
113 114 */
114 115 typedef enum {
115 116 GOT_REF_GENERIC, /* generic symbol reference */
116 117 GOT_REF_TLSIE, /* TLS initial exec (gnu) reference */
117 118 GOT_REF_TLSLD, /* TLS local dynamic reference */
118 119 GOT_REF_TLSGD /* TLS general dynamic reference */
119 120 } Gotref;
120 121
121 122 typedef struct {
122 123 Xword gn_addend; /* addend associated with GOT entry */
123 124 Sword gn_gotndx; /* GOT table index */
124 125 Gotref gn_gotref;
125 126 } Gotndx;
126 127
127 128 /*
128 129 * Got debugging structure. The got index is defined as a signed value as we
129 130 * do so much mucking around with negative and positive gots on SPARC, and sign
130 131 * extension is necessary when building 64-bit objects. On intel we explicitly
131 132 * cast this variable to an unsigned value.
132 133 */
133 134 typedef struct {
134 135 Sym_desc *gt_sym;
135 136 Gotndx gt_gndx;
136 137 } Gottable;
137 138
138 139 /*
139 140 * The link-editor caches the results of sloppy relocation processing
140 141 * in a variable of type Rlxrel_cache. Symbols come for processing in sorted
141 142 * order, so a single item cache suffices to eliminate duplicate lookups.
142 143 *
143 144 * When sloppy relocation processing fails, the Rlxrel_rej enum reports
144 145 * the underlying reason.
145 146 */
146 147 typedef enum {
147 148 RLXREL_REJ_NONE = 0, /* Replacement symbol was found */
148 149 RLXREL_REJ_TARGET, /* Target sec disallows relaxed relocations */
149 150 RLXREL_REJ_SECTION, /* Either there is no replacement section, */
150 151 /* or its attributes are incompatible */
151 152 RLXREL_REJ_SYMBOL, /* Replacement symbol not found */
152 153 } Rlxrel_rej;
153 154
154 155 typedef struct sreloc_cache {
155 156 Sym_desc *sr_osdp; /* Original symbol */
156 157 Sym_desc *sr_rsdp; /* Replacement symbol */
157 158 Rlxrel_rej sr_rej; /* Reason for failure if NULL sr_rsdp */
158 159 } Rlxrel_cache;
159 160
160 161 /*
161 162 * Nodes in an ofl_wrap AVL tree
162 163 *
163 164 * wsn_name is the name of the symbol to be wrapped. wsn_wrapname is used
164 165 * when we need to refer to the wrap symbol, and consists of the symbol
165 166 * name with a __wrap_ prefix.
166 167 */
167 168 typedef struct wrap_sym_node {
168 169 avl_node_t wsn_avlnode; /* AVL book-keeping */
169 170 const char *wsn_name; /* Symbol name: XXX */
170 171 const char *wsn_wrapname; /* Wrap symbol name: __wrap_XXX */
171 172 } WrapSymNode;
172 173
173 174 /*
174 175 * Capabilities structures, used to maintain a capabilities set.
175 176 *
176 177 * Capabilities can be defined within input relocatable objects, and can be
177 178 * augmented or replaced by mapfile directives. In addition, mapfile directives
178 179 * can be used to exclude capabilities that would otherwise be carried over to
179 180 * the output object.
180 181 *
181 182 * CA_SUNW_HW_1, CA_SUNW_SF_1 and CA_SUNW_HW_2 values are bitmasks. A current
182 183 * value, and an exclude value are maintained for each capability.
183 184 *
184 185 * There can be multiple CA_SUNW_PLAT and CA_SUNW_MACH entries and thus Alists
185 186 * are used to collect these entries. A current list for each capability is
186 187 * maintained as Capstr entries, which provide for maintaining the strings
187 188 * eventual index into a string table. An exclude list is maintained as a
188 189 * list of string pointers.
189 190 */
190 191 typedef struct {
191 192 elfcap_mask_t cm_val; /* bitmask value */
192 193 elfcap_mask_t cm_exc; /* bits to exclude from final object */
193 194 } Capmask;
194 195
195 196 typedef struct {
196 197 Alist *cl_val; /* string (Capstr) value */
197 198 APlist *cl_exc; /* strings to exclude from final */
198 199 } Caplist; /* object */
199 200
200 201 typedef struct {
201 202 char *cs_str; /* platform or machine name */
202 203 Word cs_ndx; /* the entries output Cap index */
203 204 } Capstr;
204 205
205 206 typedef uint_t oc_flag_t;
206 207 typedef struct {
207 208 Capmask oc_hw_1; /* CA_SUNW_HW_1 capabilities */
208 209 Capmask oc_sf_1; /* CA_SUNW_SF_1 capabilities */
209 210 Capmask oc_hw_2; /* CA_SUNW_HW_2 capabilities */
210 211 Caplist oc_plat; /* CA_SUNW_PLAT capabilities */
211 212 Caplist oc_mach; /* CA_SUNW_MACH capabilities */
212 213 Capstr oc_id; /* CA_SUNW_ID capability */
213 214 oc_flag_t oc_flags;
214 215 } Objcapset;
215 216
216 217 #define FLG_OCS_USRDEFID 0x1 /* user defined CA_SUNW_ID */
217 218
218 219 /*
219 220 * Bitmasks for a single capability. Capabilities come from input objects,
220 221 * augmented or replaced by mapfile directives. In addition, mapfile directives
221 222 * can be used to exclude bits that would otherwise be set in the output object.
222 223 */
223 224 typedef struct {
224 225 elfcap_mask_t cm_value; /* Bitmask value */
225 226 elfcap_mask_t cm_exclude; /* Bits to remove from final object */
226 227 } CapMask;
227 228
228 229 /*
229 230 * Combine the bitmask in a CapMask with the exclusion mask and
230 231 * return the resulting final value.
231 232 */
232 233 #define CAPMASK_VALUE(_cbmp) ((_cbmp)->cm_value & ~(_cbmp)->cm_exclude)
233 234
234 235 typedef struct {
235 236 CapMask c_hw_1; /* CA_SUNW_HW_1 capabilities */
236 237 CapMask c_sf_1; /* CA_SUNW_SF_1 capabilities */
237 238 CapMask c_hw_2; /* CA_SUNW_HW_2 capabilities */
238 239 } Outcapset;
239 240
240 241
241 242 /*
242 243 * Output file processing structure
243 244 */
244 245 typedef Lword ofl_flag_t;
245 246 typedef Word ofl_guideflag_t;
246 247 struct ofl_desc {
247 248 char *ofl_sgsid; /* link-editor identification */
248 249 const char *ofl_name; /* full file name */
249 250 Elf *ofl_elf; /* elf_memory() elf descriptor */
250 251 Elf *ofl_welf; /* ELF_C_WRITE elf descriptor */
251 252 Ehdr *ofl_dehdr; /* default elf header, and new elf */
252 253 Ehdr *ofl_nehdr; /* header describing this file */
253 254 Phdr *ofl_phdr; /* program header descriptor */
254 255 Phdr *ofl_tlsphdr; /* TLS phdr */
255 256 int ofl_fd; /* file descriptor */
256 257 size_t ofl_size; /* image size */
257 258 APlist *ofl_maps; /* list of input mapfiles */
258 259 APlist *ofl_segs; /* list of segments */
259 260 APlist *ofl_segs_order; /* SEGMENT_ORDER segments */
260 261 avl_tree_t ofl_segs_avl; /* O(log N) access to named segments */
261 262 APlist *ofl_ents; /* list of entrance descriptors */
262 263 avl_tree_t ofl_ents_avl; /* O(log N) access to named ent. desc */
263 264 APlist *ofl_objs; /* relocatable object file list */
264 265 Word ofl_objscnt; /* and count */
265 266 APlist *ofl_ars; /* archive library list */
266 267 Word ofl_arscnt; /* and count */
267 268 int ofl_ars_gsandx; /* archive group argv index. 0 means */
268 269 /* no current group, < 0 means */
269 270 /* error reported. >0 is cur ndx */
270 271 Word ofl_ars_gsndx; /* current -zrescan-start ofl_ars ndx */
271 272 APlist *ofl_sos; /* shared object list */
272 273 Word ofl_soscnt; /* and count */
273 274 APlist *ofl_soneed; /* list of implicitly required .so's */
274 275 APlist *ofl_socntl; /* list of .so control definitions */
275 276 Rel_cache ofl_outrels; /* list of output relocations */
276 277 Rel_cache ofl_actrels; /* list of relocations to perform */
277 278 APlist *ofl_relaux; /* Rel_aux cache for outrels/actrels */
278 279 Word ofl_entrelscnt; /* no of relocations entered */
279 280 Alist *ofl_copyrels; /* list of copy relocations */
280 281 APlist *ofl_ordered; /* list of shf_ordered sections */
281 282 APlist *ofl_symdtent; /* list of syminfo symbols that need */
282 283 /* to reference .dynamic entries */
283 284 APlist *ofl_ismove; /* list of .SUNW_move sections */
284 285 APlist *ofl_ismoverel; /* list of relocation input section */
285 286 /* targeting to expanded area */
286 287 APlist *ofl_parsyms; /* list of partially initialized */
287 288 /* symbols (ie. move symbols) */
288 289 APlist *ofl_extrarels; /* relocation sections which have */
289 290 /* a NULL sh_info */
290 291 avl_tree_t *ofl_groups; /* pointer to head of Groups AVL tree */
291 292 APlist *ofl_initarray; /* list of init array func names */
292 293 APlist *ofl_finiarray; /* list of fini array func names */
293 294 APlist *ofl_preiarray; /* list of preinit array func names */
294 295 APlist *ofl_rtldinfo; /* list of rtldinfo syms */
295 296 APlist *ofl_osgroups; /* list of output GROUP sections */
296 297 APlist *ofl_ostlsseg; /* pointer to sections in TLS segment */
297 298 APlist *ofl_unwind; /* list of unwind output sections */
298 299 Os_desc *ofl_unwindhdr; /* Unwind hdr */
299 300 avl_tree_t ofl_symavl; /* pointer to head of Syms AVL tree */
300 301 Sym_desc **ofl_regsyms; /* array of potential register */
301 302 Word ofl_regsymsno; /* symbols and array count */
302 303 Word ofl_regsymcnt; /* no. of output register symbols */
303 304 Word ofl_lregsymcnt; /* no. of local register symbols */
304 305 Sym_desc *ofl_dtracesym; /* ld -zdtrace= */
305 306 ofl_flag_t ofl_flags; /* various state bits, args etc. */
306 307 ofl_flag_t ofl_flags1; /* more flags */
307 308 void *ofl_entry; /* entry point (-e and Sym_desc *) */
308 309 char *ofl_filtees; /* shared objects we are a filter for */
309 310 const char *ofl_soname; /* (-h option) output file name for */
310 311 /* dynamic structure */
311 312 const char *ofl_interp; /* interpreter name used by exec() */
312 313 char *ofl_rpath; /* run path to store in .dynamic */
313 314 char *ofl_config; /* config path to store in .dynamic */
314 315 APlist *ofl_ulibdirs; /* user supplied library search list */
315 316 APlist *ofl_dlibdirs; /* default library search list */
316 317 Word ofl_vercnt; /* number of versions to generate */
317 318 APlist *ofl_verdesc; /* list of version descriptors */
318 319 size_t ofl_verdefsz; /* size of version definition section */
319 320 size_t ofl_verneedsz; /* size of version needed section */
320 321 Word ofl_entercnt; /* no. of global symbols entered */
321 322 Word ofl_globcnt; /* no. of global symbols to output */
322 323 Word ofl_scopecnt; /* no. of scoped symbols to output */
323 324 Word ofl_dynscopecnt; /* no. scoped syms in .SUNW_ldynsym */
324 325 Word ofl_elimcnt; /* no. of eliminated symbols */
325 326 Word ofl_locscnt; /* no. of local symbols in .symtab */
326 327 Word ofl_dynlocscnt; /* no. local symbols in .SUNW_ldynsym */
327 328 Word ofl_dynsymsortcnt; /* no. ndx in .SUNW_dynsymsort */
328 329 Word ofl_dyntlssortcnt; /* no. ndx in .SUNW_dyntlssort */
329 330 Word ofl_dynshdrcnt; /* no. of output section in .dynsym */
330 331 Word ofl_shdrcnt; /* no. of output sections */
331 332 Word ofl_caploclcnt; /* no. of local capabilities symbols */
332 333 Word ofl_capsymcnt; /* no. of symbol capabilities entries */
333 334 /* required */
334 335 Word ofl_capchaincnt; /* no. of Capchain symbols */
335 336 APlist *ofl_capgroups; /* list of capabilities groups */
336 337 avl_tree_t *ofl_capfamilies; /* capability family AVL tree */
337 338 Str_tbl *ofl_shdrsttab; /* Str_tbl for shdr strtab */
338 339 Str_tbl *ofl_strtab; /* Str_tbl for symtab strtab */
339 340 Str_tbl *ofl_dynstrtab; /* Str_tbl for dymsym strtab */
340 341 Gotndx *ofl_tlsldgotndx; /* index to LD TLS_index structure */
341 342 Xword ofl_relocsz; /* size of output relocations */
342 343 Xword ofl_relocgotsz; /* size of .got relocations */
343 344 Xword ofl_relocpltsz; /* size of .plt relocations */
344 345 Xword ofl_relocbsssz; /* size of .bss (copy) relocations */
345 346 Xword ofl_relocrelsz; /* size of .rel[a] relocations */
346 347 Word ofl_relocincnt; /* no. of input relocations */
347 348 Word ofl_reloccnt; /* tot number of output relocations */
348 349 Word ofl_reloccntsub; /* tot numb of output relocations to */
349 350 /* skip (-zignore) */
350 351 Word ofl_relocrelcnt; /* tot number of relative */
351 352 /* relocations */
352 353 Word ofl_gotcnt; /* no. of .got entries */
353 354 Word ofl_pltcnt; /* no. of .plt entries */
354 355 Word ofl_pltpad; /* no. of .plt padd entries */
355 356 Word ofl_hashbkts; /* no. of hash buckets required */
356 357 Is_desc *ofl_isbss; /* .bss input section (globals) */
357 358 Is_desc *ofl_islbss; /* .lbss input section (globals) */
358 359 Is_desc *ofl_istlsbss; /* .tlsbss input section (globals) */
359 360 Is_desc *ofl_isparexpn; /* -z nopartial .data input section */
360 361 Os_desc *ofl_osdynamic; /* .dynamic output section */
361 362 Os_desc *ofl_osdynsym; /* .dynsym output section */
362 363 Os_desc *ofl_osldynsym; /* .SUNW_ldynsym output section */
363 364 Os_desc *ofl_osdynstr; /* .dynstr output section */
364 365 Os_desc *ofl_osdynsymsort; /* .SUNW_dynsymsort output section */
365 366 Os_desc *ofl_osdyntlssort; /* .SUNW_dyntlssort output section */
366 367 Os_desc *ofl_osgot; /* .got output section */
367 368 Os_desc *ofl_oshash; /* .hash output section */
368 369 Os_desc *ofl_osinitarray; /* .init_array output section */
369 370 Os_desc *ofl_osfiniarray; /* .fini_array output section */
370 371 Os_desc *ofl_ospreinitarray; /* .preinit_array output section */
371 372 Os_desc *ofl_osinterp; /* .interp output section */
372 373 Os_desc *ofl_oscap; /* .SUNW_cap output section */
373 374 Os_desc *ofl_oscapinfo; /* .SUNW_capinfo output section */
374 375 Os_desc *ofl_oscapchain; /* .SUNW_capchain output section */
375 376 Os_desc *ofl_osplt; /* .plt output section */
376 377 Os_desc *ofl_osmove; /* .SUNW_move output section */
377 378 Os_desc *ofl_osrelhead; /* first relocation section */
378 379 Os_desc *ofl_osrel; /* .rel[a] relocation section */
379 380 Os_desc *ofl_osshstrtab; /* .shstrtab output section */
380 381 Os_desc *ofl_osstrtab; /* .strtab output section */
381 382 Os_desc *ofl_ossymtab; /* .symtab output section */
382 383 Os_desc *ofl_ossymshndx; /* .symtab_shndx output section */
383 384 Os_desc *ofl_osdynshndx; /* .dynsym_shndx output section */
384 385 Os_desc *ofl_osldynshndx; /* .SUNW_ldynsym_shndx output sec */
385 386 Os_desc *ofl_osverdef; /* .version definition output section */
386 387 Os_desc *ofl_osverneed; /* .version needed output section */
387 388 Os_desc *ofl_osversym; /* .version symbol ndx output section */
388 389 Word ofl_dtflags_1; /* DT_FLAGS_1 entries */
389 390 Word ofl_dtflags; /* DT_FLAGS entries */
390 391 Os_desc *ofl_ossyminfo; /* .SUNW_syminfo output section */
391 392 Half ofl_parexpnndx; /* -z nopartial section index */
392 393 /* Ref. at perform_outreloc() in */
393 394 /* libld/{mach}/machrel.c */
394 395 Xword *ofl_checksum; /* DT_CHECKSUM value address */
395 396 char *ofl_depaudit; /* dependency auditing required (-P) */
396 397 char *ofl_audit; /* object auditing required (-p) */
397 398 Alist *ofl_symfltrs; /* per-symbol filtees and their */
398 399 Alist *ofl_dtsfltrs; /* associated .dynamic/.dynstrs */
399 400 Objcapset ofl_ocapset; /* object capabilities */
400 401 Lm_list *ofl_lml; /* runtime link-map list */
401 402 Gottable *ofl_gottable; /* debugging got information */
402 403 Rlxrel_cache ofl_sr_cache; /* Cache last result from */
403 404 /* sloppy_comdat_reloc() */
404 405 APlist *ofl_maptext; /* mapfile added text sections */
405 406 APlist *ofl_mapdata; /* mapfile added data sections */
406 407 avl_tree_t *ofl_wrap; /* -z wrap symbols */
407 408 ofl_guideflag_t ofl_guideflags; /* -z guide flags */
408 409 APlist *ofl_assdeflib; /* -z assert-deflib exceptions */
409 410 };
410 411
411 412 #define FLG_OF_DYNAMIC 0x00000001 /* generate dynamic output module */
412 413 #define FLG_OF_STATIC 0x00000002 /* generate static output module */
413 414 #define FLG_OF_EXEC 0x00000004 /* generate an executable */
414 415 #define FLG_OF_RELOBJ 0x00000008 /* generate a relocatable object */
415 416 #define FLG_OF_SHAROBJ 0x00000010 /* generate a shared object */
416 417 #define FLG_OF_BFLAG 0x00000020 /* do no special plt building: -b */
417 418 #define FLG_OF_IGNENV 0x00000040 /* ignore LD_LIBRARY_PATH: -i */
418 419 #define FLG_OF_STRIP 0x00000080 /* strip output: -s */
419 420 #define FLG_OF_NOWARN 0x00000100 /* disable symbol warnings: -t */
420 421 #define FLG_OF_NOUNDEF 0x00000200 /* allow no undefined symbols: -zdefs */
421 422 #define FLG_OF_PURETXT 0x00000400 /* allow no text relocations: -ztext */
422 423 #define FLG_OF_GENMAP 0x00000800 /* generate a memory map: -m */
423 424 #define FLG_OF_DYNLIBS 0x00001000 /* dynamic input allowed: -Bdynamic */
424 425 #define FLG_OF_SYMBOLIC 0x00002000 /* bind global symbols: -Bsymbolic */
425 426 #define FLG_OF_ADDVERS 0x00004000 /* add version stamp: -Qy */
426 427 #define FLG_OF_NOLDYNSYM 0x00008000 /* -znoldynsym set */
427 428 #define FLG_OF_IS_ORDER 0x00010000 /* input section ordering within a */
428 429 /* segment is required */
429 430 #define FLG_OF_EC_FILES 0x00020000 /* Ent_desc exist w/non-NULL ec_files */
430 431 #define FLG_OF_TEXTREL 0x00040000 /* text relocations have been found */
431 432 #define FLG_OF_MULDEFS 0x00080000 /* multiple symbols are allowed */
432 433 #define FLG_OF_TLSPHDR 0x00100000 /* a TLS program header is required */
433 434 #define FLG_OF_BLDGOT 0x00200000 /* build GOT table */
434 435 #define FLG_OF_VERDEF 0x00400000 /* record version definitions */
435 436 #define FLG_OF_VERNEED 0x00800000 /* record version dependencies */
436 437 #define FLG_OF_NOVERSEC 0x01000000 /* don't record version sections */
437 438 #define FLG_OF_KEY 0x02000000 /* file requires sort keys */
438 439 #define FLG_OF_PROCRED 0x04000000 /* process any symbol reductions by */
439 440 /* effecting the symbol table */
440 441 /* output and relocations */
441 442 #define FLG_OF_SYMINFO 0x08000000 /* create a syminfo section */
442 443 #define FLG_OF_AUX 0x10000000 /* ofl_filter is an auxiliary filter */
443 444 #define FLG_OF_FATAL 0x20000000 /* fatal error during input */
444 445 #define FLG_OF_WARN 0x40000000 /* warning during input processing. */
445 446 #define FLG_OF_VERBOSE 0x80000000 /* -z verbose flag set */
446 447
447 448 #define FLG_OF_MAPSYMB 0x000100000000 /* symbolic scope definition seen */
448 449 #define FLG_OF_MAPGLOB 0x000200000000 /* global scope definition seen */
449 450 #define FLG_OF_COMREL 0x000400000000 /* -z combreloc set, which enables */
450 451 /* DT_RELACNT tracking, */
451 452 #define FLG_OF_NOCOMREL 0x000800000000 /* -z nocombreloc set */
452 453 #define FLG_OF_AUTOLCL 0x001000000000 /* automatically reduce unspecified */
453 454 /* global symbols to locals */
454 455 #define FLG_OF_AUTOELM 0x002000000000 /* automatically eliminate */
455 456 /* unspecified global symbols */
456 457 #define FLG_OF_REDLSYM 0x004000000000 /* reduce local symbols */
457 458 #define FLG_OF_OS_ORDER 0x008000000000 /* output section ordering required */
↓ open down ↓ |
421 lines elided |
↑ open up ↑ |
458 459 #define FLG_OF_OSABI 0x010000000000 /* tag object as ELFOSABI_SOLARIS */
459 460 #define FLG_OF_ADJOSCNT 0x020000000000 /* adjust ofl_shdrcnt to accommodate */
460 461 /* discarded sections */
461 462 #define FLG_OF_OTOSCAP 0x040000000000 /* convert object capabilities to */
462 463 /* symbol capabilities */
463 464 #define FLG_OF_PTCAP 0x080000000000 /* PT_SUNWCAP required */
464 465 #define FLG_OF_CAPSTRS 0x100000000000 /* capability strings are required */
465 466 #define FLG_OF_EHFRAME 0x200000000000 /* output contains .eh_frame section */
466 467 #define FLG_OF_FATWARN 0x400000000000 /* make warnings fatal */
467 468 #define FLG_OF_ADEFLIB 0x800000000000 /* no libraries in default path */
469 +#define FLG_OF_MULINCL 0x1000000000000 /* allow multiple inclusions */
468 470
469 471 /*
470 472 * In the flags1 arena, establish any options that are applicable to archive
471 473 * extraction first, and associate a mask. These values are recorded with any
472 474 * archive descriptor so that they may be reset should the archive require a
473 475 * rescan to try and resolve undefined symbols.
474 476 */
475 477 #define FLG_OF1_ALLEXRT 0x0000000001 /* extract all members from an */
476 478 /* archive file */
477 479 #define FLG_OF1_WEAKEXT 0x0000000002 /* allow archive extraction to */
478 480 /* resolve weak references */
479 481 #define MSK_OF1_ARCHIVE 0x0000000003 /* archive flags mask */
480 482
481 483 #define FLG_OF1_NOINTRP 0x0000000008 /* -z nointerp flag set */
482 484 #define FLG_OF1_ZDIRECT 0x0000000010 /* -z direct flag set */
483 485 #define FLG_OF1_NDIRECT 0x0000000020 /* no-direct bindings specified */
484 486 #define FLG_OF1_DEFERRED 0x0000000040 /* deferred dependency recording */
485 487
486 488 #define FLG_OF1_RELDYN 0x0000000100 /* process .dynamic in rel obj */
487 489 #define FLG_OF1_NRLXREL 0x0000000200 /* -z norelaxreloc flag set */
488 490 #define FLG_OF1_RLXREL 0x0000000400 /* -z relaxreloc flag set */
489 491 #define FLG_OF1_IGNORE 0x0000000800 /* ignore unused dependencies */
490 492 #define FLG_OF1_NOSGHND 0x0000001000 /* -z nosighandler flag set */
491 493 #define FLG_OF1_TEXTOFF 0x0000002000 /* text relocations are ok */
492 494 #define FLG_OF1_ABSEXEC 0x0000004000 /* -zabsexec set */
493 495 #define FLG_OF1_LAZYLD 0x0000008000 /* lazy loading of objects enabled */
494 496 #define FLG_OF1_GRPPRM 0x0000010000 /* dependencies are to have */
495 497 /* GROUPPERM enabled */
496 498
497 499 #define FLG_OF1_NOPARTI 0x0000040000 /* -znopartial set */
498 500 #define FLG_OF1_BSSOREL 0x0000080000 /* output relocation against bss */
499 501 /* section */
500 502 #define FLG_OF1_TLSOREL 0x0000100000 /* output relocation against .tlsbss */
501 503 /* section */
502 504 #define FLG_OF1_MEMORY 0x0000200000 /* produce a memory model */
503 505 #define FLG_OF1_NGLBDIR 0x0000400000 /* no DT_1_DIRECT flag allowed */
504 506 #define FLG_OF1_ENCDIFF 0x0000800000 /* host running linker has different */
505 507 /* byte order than output object */
506 508 #define FLG_OF1_VADDR 0x0001000000 /* a segment defines explicit vaddr */
507 509 #define FLG_OF1_EXTRACT 0x0002000000 /* archive member has been extracted */
508 510 #define FLG_OF1_RESCAN 0x0004000000 /* any archives should be rescanned */
509 511 #define FLG_OF1_IGNPRC 0x0008000000 /* ignore processing required */
510 512 #define FLG_OF1_NCSTTAB 0x0010000000 /* -znocompstrtab set */
511 513 #define FLG_OF1_DONE 0x0020000000 /* link-editor processing complete */
512 514 #define FLG_OF1_NONREG 0x0040000000 /* non-regular file specified as */
513 515 /* the output file */
514 516 #define FLG_OF1_ALNODIR 0x0080000000 /* establish NODIRECT for all */
515 517 /* exported interfaces. */
516 518 #define FLG_OF1_OVHWCAP1 0x0100000000 /* override CA_SUNW_HW_1 capabilities */
517 519 #define FLG_OF1_OVSFCAP1 0x0200000000 /* override CA_SUNW_SF_1 capabilities */
518 520 #define FLG_OF1_OVHWCAP2 0x0400000000 /* override CA_SUNW_HW_2 capabilities */
519 521 #define FLG_OF1_OVMACHCAP 0x0800000000 /* override CA_SUNW_MACH capability */
520 522 #define FLG_OF1_OVPLATCAP 0x1000000000 /* override CA_SUNW_PLAT capability */
521 523 #define FLG_OF1_OVIDCAP 0x2000000000 /* override CA_SUNW_ID capability */
522 524
523 525 /*
524 526 * Guidance flags. The flags with the FLG_OFG_NO_ prefix are used to suppress
525 527 * messages for a given category, and use the lower 28 bits of the word,
526 528 * The upper nibble is reserved for other guidance status.
527 529 */
528 530 #define FLG_OFG_ENABLE 0x10000000 /* -z guidance option active */
529 531 #define FLG_OFG_ISSUED 0x20000000 /* -z guidance message issued */
530 532
531 533 #define FLG_OFG_NO_ALL 0x0fffffff /* disable all guidance */
532 534 #define FLG_OFG_NO_DEFS 0x00000001 /* specify all dependencies */
533 535 #define FLG_OFG_NO_DB 0x00000002 /* use direct bindings */
534 536 #define FLG_OFG_NO_LAZY 0x00000004 /* be explicit about lazyload */
535 537 #define FLG_OFG_NO_MF 0x00000008 /* use v2 mapfile syntax */
536 538 #define FLG_OFG_NO_TEXT 0x00000010 /* verify pure text segment */
537 539 #define FLG_OFG_NO_UNUSED 0x00000020 /* remove unused dependency */
538 540
539 541 /*
540 542 * Test to see if a guidance should be given for a given category
541 543 * or not. _no_flag is one of the FLG_OFG_NO_xxx flags. Returns TRUE
542 544 * if the guidance should be issued, and FALSE to remain silent.
543 545 */
544 546 #define OFL_GUIDANCE(_ofl, _no_flag) (((_ofl)->ofl_guideflags & \
545 547 (FLG_OFG_ENABLE | (_no_flag))) == FLG_OFG_ENABLE)
546 548
547 549 /*
548 550 * Test to see if the output file would allow the presence of
549 551 * a .dynsym section.
550 552 */
551 553 #define OFL_ALLOW_DYNSYM(_ofl) (((_ofl)->ofl_flags & \
552 554 (FLG_OF_DYNAMIC | FLG_OF_RELOBJ)) == FLG_OF_DYNAMIC)
553 555
554 556 /*
555 557 * Test to see if the output file would allow the presence of
556 558 * a .SUNW_ldynsym section. The requirements are that a .dynsym
557 559 * is allowed, and -znoldynsym has not been specified. Note that
558 560 * even if the answer is True (1), we will only generate one if there
559 561 * are local symbols that require it.
560 562 */
561 563 #define OFL_ALLOW_LDYNSYM(_ofl) (((_ofl)->ofl_flags & \
562 564 (FLG_OF_DYNAMIC | FLG_OF_RELOBJ | FLG_OF_NOLDYNSYM)) == FLG_OF_DYNAMIC)
563 565
564 566 /*
565 567 * Test to see if relocation processing should be done. This is normally
566 568 * true, but can be disabled via the '-z noreloc' option. Note that
567 569 * relocatable objects are still relocated even if '-z noreloc' is present.
568 570 */
569 571 #define OFL_DO_RELOC(_ofl) (((_ofl)->ofl_flags & FLG_OF_RELOBJ) || \
570 572 !((_ofl)->ofl_dtflags_1 & DF_1_NORELOC))
571 573
572 574 /*
573 575 * Determine whether a static executable is being built.
574 576 */
575 577 #define OFL_IS_STATIC_EXEC(_ofl) (((_ofl)->ofl_flags & \
576 578 (FLG_OF_STATIC | FLG_OF_EXEC)) == (FLG_OF_STATIC | FLG_OF_EXEC))
577 579
578 580 /*
579 581 * Determine whether a static object is being built. This macro is used
580 582 * to select the appropriate string table, and symbol table that other
581 583 * sections need to reference.
582 584 */
583 585 #define OFL_IS_STATIC_OBJ(_ofl) ((_ofl)->ofl_flags & \
584 586 (FLG_OF_RELOBJ | FLG_OF_STATIC))
585 587
586 588 /*
587 589 * Macros for counting symbol table entries. These are used to size symbol
588 590 * tables and associated sections (.syminfo, SUNW_capinfo, .hash, etc.) and
589 591 * set required sh_info entries (the offset to the first global symbol).
590 592 */
591 593 #define SYMTAB_LOC_CNT(_ofl) /* local .symtab entries */ \
592 594 (2 + /* NULL and STT_FILE */ \
593 595 (_ofl)->ofl_shdrcnt + /* section symbol */ \
594 596 (_ofl)->ofl_caploclcnt + /* local capabilities */ \
595 597 (_ofl)->ofl_scopecnt + /* scoped symbols */ \
596 598 (_ofl)->ofl_locscnt) /* standard locals */
597 599 #define SYMTAB_ALL_CNT(_ofl) /* all .symtab entries */ \
598 600 (SYMTAB_LOC_CNT(_ofl) + /* .symtab locals */ \
599 601 (_ofl)->ofl_globcnt) /* standard globals */
600 602
601 603 #define DYNSYM_LOC_CNT(_ofl) /* local .dynsym entries */ \
602 604 (1 + /* NULL */ \
603 605 (_ofl)->ofl_dynshdrcnt + /* section symbols */ \
604 606 (_ofl)->ofl_caploclcnt + /* local capabilities */ \
605 607 (_ofl)->ofl_lregsymcnt) /* local register symbols */
606 608 #define DYNSYM_ALL_CNT(_ofl) /* all .dynsym entries */ \
607 609 (DYNSYM_LOC_CNT(_ofl) + /* .dynsym locals */ \
608 610 (_ofl)->ofl_globcnt) /* standard globals */
609 611
610 612 /*
611 613 * Define a move descriptor used within relocation structures.
612 614 */
613 615 typedef struct {
614 616 Move *mr_move;
615 617 Sym_desc *mr_sym;
616 618 } Mv_reloc;
617 619
618 620 /*
619 621 * Relocation (active & output) processing structure - transparent to common
620 622 * code. There can be millions of these structures in a large link, so it
621 623 * is important to keep it small. You should only add new items to Rel_desc
622 624 * if they are critical, apply to most relocations, and cannot be easily
623 625 * computed from the other information.
624 626 *
625 627 * Items that can be derived should be implemented as a function that accepts
626 628 * a Rel_desc argument, and returns the desired data. ld_reloc_sym_name() is
627 629 * an example of this.
628 630 *
629 631 * Lesser used relocation data is kept in an auxiliary block, Rel_aux,
630 632 * that is only allocated as necessary. In exchange for adding one pointer
631 633 * of overhead to Rel_desc (rel_aux), most relocations are reduced in size
632 634 * by the size of Rel_aux. This strategy relies on the data in Rel_aux
633 635 * being rarely needed --- otherwise it will backfire badly.
634 636 *
635 637 * Note that rel_raddend is primarily only of interest to RELA relocations,
636 638 * and is set to 0 for REL. However, there is an exception: If FLG_REL_NADDEND
637 639 * is set, then rel_raddend contains a replacement value for the implicit
638 640 * addend found in the relocation target.
639 641 *
640 642 * Fields should be ordered from largest to smallest, to minimize packing
641 643 * holes in the struct layout.
642 644 */
643 645 struct rel_desc {
644 646 Is_desc *rel_isdesc; /* input section reloc is against */
645 647 Sym_desc *rel_sym; /* sym relocation is against */
646 648 Rel_aux *rel_aux; /* NULL, or auxiliary data */
647 649 Xword rel_roffset; /* relocation offset */
648 650 Sxword rel_raddend; /* addend from input relocation */
649 651 Word rel_flags; /* misc. flags for relocations */
650 652 Word rel_rtype; /* relocation type */
651 653 };
652 654
653 655 /*
654 656 * Data that would be kept in Rel_desc if the size of that structure was
655 657 * not an issue. This auxiliary block is only allocated as needed,
656 658 * and must only contain rarely needed items. The goal is for the vast
657 659 * majority of Rel_desc structs to not have an auxiliary block.
658 660 *
659 661 * When a Rel_desc does not have an auxiliary block, a default value
660 662 * is assumed for each auxiliary item:
661 663 *
662 664 * - ra_osdesc:
663 665 * Output section to which relocation applies. The default
664 666 * value for this is the output section associated with the
665 667 * input section (rel_isdesc->is_osdesc), or NULL if there
666 668 * is no associated input section.
667 669 *
668 670 * - ra_usym:
669 671 * If the symbol associated with a relocation is part of a weak/strong
670 672 * pair, then ra_usym contains the strong symbol and rel_sym the weak.
671 673 * Otherwise, the default value is the same value as rel_sym.
672 674 *
673 675 * - ra_move:
674 676 * Move table data. The default value is NULL.
675 677 *
676 678 * - ra_typedata:
677 679 * ELF_R_TYPE_DATA(info). This value applies only to a small
678 680 * subset of 64-bit sparc relocations, and is otherwise 0. The
679 681 * default value is 0.
680 682 *
681 683 * If any value in Rel_aux is non-default, then an auxiliary block is
682 684 * necessary, and each field contains its actual value. If all the auxiliary
683 685 * values are default, no Rel_aux is needed, and the RELAUX_GET_xxx()
684 686 * macros below are able to supply the proper default.
685 687 *
686 688 * To set a Rel_aux value, use the ld_reloc_set_aux_XXX() functions.
687 689 * These functions are written to avoid unnecessary auxiliary allocations,
688 690 * and know the rules for each item.
689 691 */
690 692 struct rel_aux {
691 693 Os_desc *ra_osdesc; /* output section reloc is against */
692 694 Sym_desc *ra_usym; /* strong sym if this is a weak pair */
693 695 Mv_reloc *ra_move; /* move table information */
694 696 Word ra_typedata; /* ELF_R_TYPE_DATA(info) */
695 697 };
696 698
697 699 /*
698 700 * Test a given auxiliary value to determine if it has the default value
699 701 * for that item, as described above. If all the auxiliary items have
700 702 * their default values, no auxiliary place is necessary to represent them.
701 703 * If any one of them is non-default, the auxiliary block is needed.
702 704 */
703 705 #define RELAUX_ISDEFAULT_MOVE(_rdesc, _mv) (_mv == NULL)
704 706 #define RELAUX_ISDEFAULT_USYM(_rdesc, _usym) ((_rdesc)->rel_sym == _usym)
705 707 #define RELAUX_ISDEFAULT_OSDESC(_rdesc, _osdesc) \
706 708 ((((_rdesc)->rel_isdesc == NULL) && (_osdesc == NULL)) || \
707 709 ((_rdesc)->rel_isdesc && ((_rdesc)->rel_isdesc->is_osdesc == _osdesc)))
708 710 #define RELAUX_ISDEFAULT_TYPEDATA(_rdesc, _typedata) (_typedata == 0)
709 711
710 712 /*
711 713 * Retrieve the value of an auxiliary relocation item, preserving the illusion
712 714 * that every relocation descriptor has an auxiliary block attached. The
713 715 * real implementation is that an auxiliary block is only present if one or
714 716 * more auxiliary items have non-default values. These macros return the true
715 717 * value if an auxiliary block is present, and the default value for the
716 718 * item otherwise.
717 719 */
718 720 #define RELAUX_GET_MOVE(_rdesc) \
719 721 ((_rdesc)->rel_aux ? (_rdesc)->rel_aux->ra_move : NULL)
720 722 #define RELAUX_GET_USYM(_rdesc) \
721 723 ((_rdesc)->rel_aux ? (_rdesc)->rel_aux->ra_usym : (_rdesc)->rel_sym)
722 724 #define RELAUX_GET_OSDESC(_rdesc) \
723 725 ((_rdesc)->rel_aux ? (_rdesc)->rel_aux->ra_osdesc : \
724 726 ((_rdesc)->rel_isdesc ? (_rdesc)->rel_isdesc->is_osdesc : NULL))
725 727 #define RELAUX_GET_TYPEDATA(_rdesc) \
726 728 ((_rdesc)->rel_aux ? (_rdesc)->rel_aux->ra_typedata : 0)
727 729
728 730 /*
729 731 * common flags used on the Rel_desc structure (defined in machrel.h).
730 732 */
731 733 #define FLG_REL_GOT 0x00000001 /* relocation against GOT */
732 734 #define FLG_REL_PLT 0x00000002 /* relocation against PLT */
733 735 #define FLG_REL_BSS 0x00000004 /* relocation against BSS */
734 736 #define FLG_REL_LOAD 0x00000008 /* section loadable */
735 737 #define FLG_REL_SCNNDX 0x00000010 /* use section index for symbol ndx */
736 738 #define FLG_REL_CLVAL 0x00000020 /* clear VALUE for active relocation */
737 739 #define FLG_REL_ADVAL 0x00000040 /* add VALUE for output relocation, */
738 740 /* only relevant to SPARC and */
739 741 /* R_SPARC_RELATIVE */
740 742 #define FLG_REL_GOTCL 0x00000080 /* clear the GOT entry. This is */
741 743 /* relevant to RELA relocations, */
742 744 /* not REL (i386) relocations */
743 745 #define FLG_REL_MOVETAB 0x00000100 /* Relocation against .SUNW_move */
744 746 /* adjustments required before */
745 747 /* actual relocation */
746 748 #define FLG_REL_NOINFO 0x00000200 /* Relocation comes from a section */
747 749 /* with a null sh_info field */
748 750 #define FLG_REL_REG 0x00000400 /* Relocation target is reg sym */
749 751 #define FLG_REL_FPTR 0x00000800 /* relocation against func. desc. */
750 752 #define FLG_REL_RFPTR1 0x00001000 /* Relative relocation against */
751 753 /* 1st part of FD */
752 754 #define FLG_REL_RFPTR2 0x00002000 /* Relative relocation against */
753 755 /* 2nd part of FD */
754 756 #define FLG_REL_DISP 0x00004000 /* *disp* relocation */
755 757 #define FLG_REL_STLS 0x00008000 /* IE TLS reference to */
756 758 /* static TLS GOT index */
757 759 #define FLG_REL_DTLS 0x00010000 /* GD TLS reference relative to */
758 760 /* dynamic TLS GOT index */
759 761 #define FLG_REL_MTLS 0x00020000 /* LD TLS reference against GOT */
760 762 #define FLG_REL_STTLS 0x00040000 /* LE TLS reference directly */
761 763 /* to static tls index */
762 764 #define FLG_REL_TLSFIX 0x00080000 /* relocation points to TLS instr. */
763 765 /* which needs updating */
764 766 #define FLG_REL_RELA 0x00100000 /* descriptor captures a Rela */
765 767 #define FLG_REL_GOTFIX 0x00200000 /* relocation points to GOTOP instr. */
766 768 /* which needs updating */
767 769 #define FLG_REL_NADDEND 0x00400000 /* Replace implicit addend in dest */
768 770 /* with value in rel_raddend */
769 771 /* Relevant to REL (i386) */
770 772 /* relocations, not to RELA. */
771 773
772 774 /*
773 775 * We often need the name of the symbol contained in a relocation descriptor
774 776 * for diagnostic or error output. This is usually the symbol name, but
775 777 * we substitute a constructed name in some cases. Hence, the name is
776 778 * generated on the fly by a private function within libld. This is the
777 779 * prototype for that function.
778 780 */
779 781 typedef const char *(* rel_desc_sname_func_t)(Rel_desc *);
780 782
781 783 /*
782 784 * Header for a relocation descriptor cache buffer.
783 785 */
784 786 struct rel_cachebuf {
785 787 Rel_desc *rc_end;
786 788 Rel_desc *rc_free;
787 789 Rel_desc rc_arr[1];
788 790 };
789 791
790 792 /*
791 793 * Header for a relocation auxiliary descriptor cache buffer.
792 794 */
793 795 struct rel_aux_cachebuf {
794 796 Rel_aux *rac_end;
795 797 Rel_aux *rac_free;
796 798 Rel_aux rac_arr[1];
797 799 };
798 800
799 801 /*
800 802 * Convenience macro for traversing every relocation descriptor found within
801 803 * a given relocation cache, transparently handling the cache buffers and
802 804 * skipping any unallocated descriptors within the buffers.
803 805 *
804 806 * entry:
805 807 * _rel_cache - Relocate descriptor cache (Rel_cache) to traverse
806 808 * _idx - Aliste index variable for use by the macro
807 809 * _rcbp - Cache buffer pointer, for use by the macro
808 810 * _orsp - Rel_desc pointer, which will take on the value of a different
809 811 * relocation descriptor in the cache in each iteration.
810 812 *
811 813 * The caller must not assign new values to _idx, _rcbp, or _orsp within
812 814 * the scope of REL_CACHE_TRAVERSE.
813 815 */
814 816 #define REL_CACHE_TRAVERSE(_rel_cache, _idx, _rcbp, _orsp) \
815 817 for (APLIST_TRAVERSE((_rel_cache)->rc_list, _idx, _rcbp)) \
816 818 for (_orsp = _rcbp->rc_arr; _orsp < _rcbp->rc_free; _orsp++)
817 819
818 820 /*
819 821 * Symbol value descriptor. For relocatable objects, each symbols value is
820 822 * its offset within its associated section. Therefore, to uniquely define
821 823 * each symbol within a relocatable object, record and sort the sh_offset and
822 824 * symbol value. This information is used to search for displacement
823 825 * relocations as part of copy relocation validation.
824 826 */
825 827 typedef struct {
826 828 Addr ssv_value;
827 829 Sym_desc *ssv_sdp;
828 830 } Ssv_desc;
829 831
830 832 /*
831 833 * Input file processing structures.
832 834 */
833 835 struct ifl_desc { /* input file descriptor */
834 836 const char *ifl_name; /* full file name */
835 837 const char *ifl_soname; /* shared object name */
836 838 dev_t ifl_stdev; /* device id and inode number for .so */
837 839 ino_t ifl_stino; /* multiple inclusion checks */
838 840 Ehdr *ifl_ehdr; /* elf header describing this file */
839 841 Elf *ifl_elf; /* elf descriptor for this file */
840 842 Sym_desc **ifl_oldndx; /* original symbol table indices */
841 843 Sym_desc *ifl_locs; /* symbol desc version of locals */
842 844 Ssv_desc *ifl_sortsyms; /* sorted list of symbols by value */
843 845 Word ifl_locscnt; /* no. of local symbols to process */
844 846 Word ifl_symscnt; /* total no. of symbols to process */
845 847 Word ifl_sortcnt; /* no. of sorted symbols to process */
846 848 Word ifl_shnum; /* number of sections in file */
847 849 Word ifl_shstrndx; /* index to .shstrtab */
848 850 Word ifl_vercnt; /* number of versions in file */
849 851 Half ifl_neededndx; /* index to NEEDED in .dyn section */
850 852 Word ifl_flags; /* explicit/implicit reference */
851 853 Is_desc **ifl_isdesc; /* isdesc[scn ndx] = Is_desc ptr */
852 854 Sdf_desc *ifl_sdfdesc; /* control definition */
853 855 Versym *ifl_versym; /* version symbol table array */
854 856 Ver_index *ifl_verndx; /* verndx[ver ndx] = Ver_index */
855 857 APlist *ifl_verdesc; /* version descriptor list */
856 858 APlist *ifl_relsect; /* relocation section list */
857 859 Alist *ifl_groups; /* SHT_GROUP section list */
858 860 Cap_desc *ifl_caps; /* capabilities descriptor */
859 861 };
860 862
861 863 #define FLG_IF_CMDLINE 0x00000001 /* full filename specified from the */
862 864 /* command line (no -l) */
863 865 #define FLG_IF_NEEDED 0x00000002 /* shared object should be recorded */
864 866 #define FLG_IF_DIRECT 0x00000004 /* establish direct bindings to this */
865 867 /* object */
866 868 #define FLG_IF_EXTRACT 0x00000008 /* file extracted from an archive */
867 869 #define FLG_IF_VERNEED 0x00000010 /* version dependency information is */
868 870 /* required */
869 871 #define FLG_IF_DEPREQD 0x00000020 /* dependency is required to satisfy */
870 872 /* symbol references */
871 873 #define FLG_IF_NEEDSTR 0x00000040 /* dependency specified by -Nn */
872 874 /* flag */
873 875 #define FLG_IF_IGNORE 0x00000080 /* ignore unused dependencies */
874 876 #define FLG_IF_NODIRECT 0x00000100 /* object contains symbols that */
875 877 /* cannot be directly bound to */
876 878 #define FLG_IF_LAZYLD 0x00000200 /* dependency should be lazy loaded */
877 879 #define FLG_IF_GRPPRM 0x00000400 /* dependency establishes a group */
878 880 #define FLG_IF_DISPPEND 0x00000800 /* displacement relocation done */
879 881 /* in the ld time. */
880 882 #define FLG_IF_DISPDONE 0x00001000 /* displacement relocation done */
881 883 /* at the run time */
882 884 #define FLG_IF_MAPFILE 0x00002000 /* file is a mapfile */
883 885 #define FLG_IF_HSTRTAB 0x00004000 /* file has a string section */
884 886 #define FLG_IF_FILEREF 0x00008000 /* file contains a section which */
885 887 /* is included in the output */
886 888 /* allocatable image */
887 889 #define FLG_IF_GNUVER 0x00010000 /* file used GNU-style versioning */
888 890 #define FLG_IF_ORDERED 0x00020000 /* ordered section processing */
889 891 /* required */
890 892 #define FLG_IF_OTOSCAP 0x00040000 /* convert object capabilities to */
891 893 /* symbol capabilities */
892 894 #define FLG_IF_DEFERRED 0x00080000 /* dependency is deferred */
893 895 #define FLG_IF_RTLDINF 0x00100000 /* dependency has DT_SUNW_RTLTINF set */
894 896 #define FLG_IF_GROUPS 0x00200000 /* input file has groups to process */
895 897
896 898 /*
897 899 * Symbol states that require the generation of a DT_POSFLAG_1 .dynamic entry.
898 900 */
899 901 #define MSK_IF_POSFLAG1 (FLG_IF_LAZYLD | FLG_IF_GRPPRM | FLG_IF_DEFERRED)
900 902
901 903 /*
902 904 * Symbol states that require an associated Syminfo entry.
903 905 */
904 906 #define MSK_IF_SYMINFO (FLG_IF_LAZYLD | FLG_IF_DIRECT | FLG_IF_DEFERRED)
905 907
906 908
907 909 struct is_desc { /* input section descriptor */
908 910 const char *is_name; /* original section name */
909 911 const char *is_sym_name; /* NULL, or name string to use for */
910 912 /* related STT_SECTION symbols */
911 913 Shdr *is_shdr; /* the elf section header */
912 914 Ifl_desc *is_file; /* infile desc for this section */
913 915 Os_desc *is_osdesc; /* new output section for this */
914 916 /* input section */
915 917 Elf_Data *is_indata; /* input sections raw data */
916 918 Is_desc *is_symshndx; /* related SHT_SYM_SHNDX section */
917 919 Is_desc *is_comdatkeep; /* If COMDAT section is discarded, */
918 920 /* this is section that was kept */
919 921 Word is_scnndx; /* original section index in file */
920 922 Word is_ordndx; /* index for section. Used to decide */
921 923 /* where to insert section when */
922 924 /* reordering sections */
923 925 Word is_keyident; /* key for SHF_{ORDERED|LINK_ORDER} */
924 926 /* processing and ident used for */
925 927 /* placing/ordering sections */
926 928 Word is_flags; /* Various flags */
927 929 };
928 930
929 931 #define FLG_IS_ORDERED 0x0001 /* this is a SHF_ORDERED section */
930 932 #define FLG_IS_KEY 0x0002 /* section requires sort keys */
931 933 #define FLG_IS_DISCARD 0x0004 /* section is to be discarded */
932 934 #define FLG_IS_RELUPD 0x0008 /* symbol defined here may have moved */
933 935 #define FLG_IS_SECTREF 0x0010 /* section has been referenced */
934 936 #define FLG_IS_GDATADEF 0x0020 /* section contains global data sym */
935 937 #define FLG_IS_EXTERNAL 0x0040 /* isp from a user file */
936 938 #define FLG_IS_INSTRMRG 0x0080 /* Usable SHF_MERGE|SHF_STRINGS sec */
937 939 #define FLG_IS_GNSTRMRG 0x0100 /* Generated mergeable string section */
938 940
939 941 #define FLG_IS_PLACE 0x0400 /* section requires to be placed */
940 942 #define FLG_IS_COMDAT 0x0800 /* section is COMDAT */
941 943 #define FLG_IS_EHFRAME 0x1000 /* section is .eh_frame */
942 944
943 945 /*
944 946 * Output sections contain lists of input sections that are assigned to them.
945 947 * These items fall into 4 categories:
946 948 * BEFORE - Ordered sections that specify SHN_BEFORE, in input order.
947 949 * ORDERED - Ordered sections that are sorted using unsorted sections
948 950 * as the sort key.
949 951 * DEFAULT - Sections that are placed into the output section
950 952 * in input order.
951 953 * AFTER - Ordered sections that specify SHN_AFTER, in input order.
952 954 */
953 955 #define OS_ISD_BEFORE 0
954 956 #define OS_ISD_ORDERED 1
955 957 #define OS_ISD_DEFAULT 2
956 958 #define OS_ISD_AFTER 3
957 959 #define OS_ISD_NUM 4
958 960 typedef APlist *os_isdecs_arr[OS_ISD_NUM];
959 961
960 962 /*
961 963 * Convenience macro for traversing every input section associated
962 964 * with a given output section. The primary benefit of this macro
963 965 * is that it preserves a precious level of code indentation in the
964 966 * code that uses it.
965 967 */
966 968 #define OS_ISDESCS_TRAVERSE(_list_idx, _osp, _idx, _isp) \
967 969 for (_list_idx = 0; _list_idx < OS_ISD_NUM; _list_idx++) \
968 970 for (APLIST_TRAVERSE(_osp->os_isdescs[_list_idx], _idx, _isp))
969 971
970 972
971 973 /*
972 974 * Map file and output file processing structures
973 975 */
974 976 struct os_desc { /* Output section descriptor */
975 977 const char *os_name; /* the section name */
976 978 Elf_Scn *os_scn; /* the elf section descriptor */
977 979 Shdr *os_shdr; /* the elf section header */
978 980 Os_desc *os_relosdesc; /* the output relocation section */
979 981 APlist *os_relisdescs; /* reloc input section descriptors */
980 982 /* for this output section */
981 983 os_isdecs_arr os_isdescs; /* lists of input sections in output */
982 984 APlist *os_mstrisdescs; /* FLG_IS_INSTRMRG input sections */
983 985 Sg_desc *os_sgdesc; /* segment os_desc is placed on */
984 986 Elf_Data *os_outdata; /* output sections raw data */
985 987 avl_tree_t *os_comdats; /* AVL tree of COMDAT input sections */
986 988 /* associated to output section */
987 989 Word os_identndx; /* section identifier for input */
988 990 /* section processing, followed */
989 991 /* by section symbol index */
990 992 Word os_ordndx; /* index for section. Used to decide */
991 993 /* where to insert section when */
992 994 /* reordering sections */
993 995 Xword os_szoutrels; /* size of output relocation section */
994 996 uint_t os_namehash; /* hash on section name */
995 997 uchar_t os_flags; /* various flags */
996 998 };
997 999
998 1000 #define FLG_OS_KEY 0x01 /* section requires sort keys */
999 1001 #define FLG_OS_OUTREL 0x02 /* output rel against this section */
1000 1002 #define FLG_OS_SECTREF 0x04 /* isps are not affected by -zignore */
1001 1003 #define FLG_OS_EHFRAME 0x08 /* section is .eh_frame */
1002 1004
1003 1005 /*
1004 1006 * The sg_id field of the segment descriptor is used to establish the default
1005 1007 * order for program headers and segments in the output object. Segments are
1006 1008 * ordered according to the following SGID values that classify them based on
1007 1009 * their attributes. The initial set of built in segments are in this order,
1008 1010 * and new mapfile defined segments are inserted into these groups. Within a
1009 1011 * given SGID group, the position of new segments depends on the syntax
1010 1012 * version of the mapfile that creates them. Version 1 (original sysv)
1011 1013 * mapfiles place the new segment at the head of their group (reverse creation
1012 1014 * order). The newer syntax places them at the end, following the others
1013 1015 * (creation order).
1014 1016 *
1015 1017 * Note that any new segments must always be added after PT_PHDR and
1016 1018 * PT_INTERP (refer Generic ABI, Page 5-4).
1017 1019 */
1018 1020 #define SGID_PHDR 0 /* PT_PHDR */
1019 1021 #define SGID_INTERP 1 /* PT_INTERP */
1020 1022 #define SGID_SUNWCAP 2 /* PT_SUNWCAP */
1021 1023 #define SGID_TEXT 3 /* PT_LOAD */
1022 1024 #define SGID_DATA 4 /* PT_LOAD */
1023 1025 #define SGID_BSS 5 /* PT_LOAD */
1024 1026 #if defined(_ELF64)
1025 1027 #define SGID_LRODATA 6 /* PT_LOAD (amd64-only) */
1026 1028 #define SGID_LDATA 7 /* PT_LOAD (amd64-only) */
1027 1029 #endif
1028 1030 #define SGID_TEXT_EMPTY 8 /* PT_LOAD, reserved (?E in version 1 syntax) */
1029 1031 #define SGID_NULL_EMPTY 9 /* PT_NULL, reserved (?E in version 1 syntax) */
1030 1032 #define SGID_DYN 10 /* PT_DYNAMIC */
1031 1033 #define SGID_DTRACE 11 /* PT_SUNWDTRACE */
1032 1034 #define SGID_TLS 12 /* PT_TLS */
1033 1035 #define SGID_UNWIND 13 /* PT_SUNW_UNWIND */
1034 1036 #define SGID_SUNWSTACK 14 /* PT_SUNWSTACK */
1035 1037 #define SGID_NOTE 15 /* PT_NOTE */
1036 1038 #define SGID_NULL 16 /* PT_NULL, mapfile defined empty phdr slots */
1037 1039 /* for use by post processors */
1038 1040 #define SGID_EXTRA 17 /* PT_NULL (final catchall) */
1039 1041
1040 1042 typedef Half sg_flags_t;
1041 1043 struct sg_desc { /* output segment descriptor */
1042 1044 Word sg_id; /* segment identifier (for sorting) */
1043 1045 Phdr sg_phdr; /* segment header for output file */
1044 1046 const char *sg_name; /* segment name for PT_LOAD, PT_NOTE, */
1045 1047 /* and PT_NULL, otherwise NULL */
1046 1048 Xword sg_round; /* data rounding required (mapfile) */
1047 1049 Xword sg_length; /* maximum segment length; if 0 */
1048 1050 /* segment is not specified */
1049 1051 APlist *sg_osdescs; /* list of output section descriptors */
1050 1052 APlist *sg_is_order; /* list of entry criteria */
1051 1053 /* giving input section order */
1052 1054 Alist *sg_os_order; /* list specifying output section */
1053 1055 /* ordering for the segment */
1054 1056 sg_flags_t sg_flags;
1055 1057 APlist *sg_sizesym; /* size symbols for this segment */
1056 1058 Xword sg_align; /* LCM of sh_addralign */
1057 1059 Elf_Scn *sg_fscn; /* the SCN of the first section. */
1058 1060 avl_node_t sg_avlnode; /* AVL book-keeping */
1059 1061 };
1060 1062
1061 1063 #define FLG_SG_P_VADDR 0x0001 /* p_vaddr segment attribute set */
1062 1064 #define FLG_SG_P_PADDR 0x0002 /* p_paddr segment attribute set */
1063 1065 #define FLG_SG_LENGTH 0x0004 /* length segment attribute set */
1064 1066 #define FLG_SG_P_ALIGN 0x0008 /* p_align segment attribute set */
1065 1067 #define FLG_SG_ROUND 0x0010 /* round segment attribute set */
1066 1068 #define FLG_SG_P_FLAGS 0x0020 /* p_flags segment attribute set */
1067 1069 #define FLG_SG_P_TYPE 0x0040 /* p_type segment attribute set */
1068 1070 #define FLG_SG_IS_ORDER 0x0080 /* input section ordering is required */
1069 1071 /* for this segment. */
1070 1072 #define FLG_SG_NOHDR 0x0100 /* don't map ELF or phdrs into */
1071 1073 /* this segment */
1072 1074 #define FLG_SG_EMPTY 0x0200 /* an empty segment specification */
1073 1075 /* no input sections will be */
1074 1076 /* associated to this section */
1075 1077 #define FLG_SG_KEY 0x0400 /* segment requires sort keys */
1076 1078 #define FLG_SG_NODISABLE 0x0800 /* FLG_SG_DISABLED is not allowed on */
1077 1079 /* this segment */
1078 1080 #define FLG_SG_DISABLED 0x1000 /* this segment is disabled */
1079 1081 #define FLG_SG_PHREQ 0x2000 /* this segment requires a program */
1080 1082 /* header */
1081 1083 #define FLG_SG_ORDERED 0x4000 /* SEGMENT_ORDER segment */
1082 1084
1083 1085 struct sec_order {
1084 1086 const char *sco_secname; /* section name to be ordered */
1085 1087 Half sco_flags;
1086 1088 };
1087 1089
1088 1090 #define FLG_SGO_USED 0x0001 /* was ordering used? */
1089 1091
1090 1092 typedef Half ec_flags_t;
1091 1093 struct ent_desc { /* input section entrance criteria */
1092 1094 const char *ec_name; /* entrace criteria name, or NULL */
1093 1095 Alist *ec_files; /* files from which to accept */
1094 1096 /* sections */
1095 1097 const char *ec_is_name; /* input section name to match */
1096 1098 /* (NULL if none) */
1097 1099 Word ec_type; /* section type */
1098 1100 Word ec_attrmask; /* section attribute mask (AWX) */
1099 1101 Word ec_attrbits; /* sections attribute bits */
1100 1102 Sg_desc *ec_segment; /* output segment to enter if matched */
1101 1103 Word ec_ordndx; /* index to determine where section */
1102 1104 /* meeting this criteria should */
1103 1105 /* inserted. Used for reordering */
1104 1106 /* of sections. */
1105 1107 ec_flags_t ec_flags;
1106 1108 avl_node_t ec_avlnode; /* AVL book-keeping */
1107 1109 };
1108 1110
1109 1111 #define FLG_EC_BUILTIN 0x0001 /* built in descriptor */
1110 1112 #define FLG_EC_USED 0x0002 /* entrance criteria met? */
1111 1113 #define FLG_EC_CATCHALL 0x0004 /* Catches any section */
1112 1114
1113 1115 /*
1114 1116 * Ent_desc_file is the type of element maintained in the ec_files Alist
1115 1117 * of an entrance criteria descriptor. Each item maintains one file
1116 1118 * path, and a set of flags that specify the type of comparison it implies,
1117 1119 * and other information about it. The comparison type is maintained in
1118 1120 * the bottom byte of the flags.
1119 1121 */
1120 1122 #define TYP_ECF_MASK 0x00ff /* Comparison type mask */
1121 1123 #define TYP_ECF_PATH 0 /* Compare to file path */
1122 1124 #define TYP_ECF_BASENAME 1 /* Compare to file basename */
1123 1125 #define TYP_ECF_OBJNAME 2 /* Compare to regular file basename, */
1124 1126 /* or to archive member name */
1125 1127 #define TYP_ECF_NUM 3
1126 1128
1127 1129 #define FLG_ECF_ARMEMBER 0x0100 /* name includes archive member */
1128 1130
1129 1131 typedef struct {
1130 1132 Word edf_flags; /* Type of comparison */
1131 1133 const char *edf_name; /* String to compare to */
1132 1134 size_t edf_name_len; /* strlen(edf_name) */
1133 1135 } Ent_desc_file;
1134 1136
1135 1137 /*
1136 1138 * One structure is allocated for a move entry, and associated to the symbol
1137 1139 * against which a move is targeted.
1138 1140 */
1139 1141 typedef struct {
1140 1142 Move *md_move; /* original Move entry */
1141 1143 Xword md_start; /* start position */
1142 1144 Xword md_len; /* length of initialization */
1143 1145 Word md_oidx; /* output Move entry index */
1144 1146 } Mv_desc;
1145 1147
1146 1148 /*
1147 1149 * Symbol descriptor.
1148 1150 */
1149 1151 typedef Lword sd_flag_t;
1150 1152 struct sym_desc {
1151 1153 Alist *sd_GOTndxs; /* list of associated GOT entries */
1152 1154 Sym *sd_sym; /* pointer to symbol table entry */
1153 1155 Sym *sd_osym; /* copy of the original symbol entry */
1154 1156 /* used only for local partial */
1155 1157 Alist *sd_move; /* move information associated with a */
1156 1158 /* partially initialized symbol */
1157 1159 const char *sd_name; /* symbols name */
1158 1160 Ifl_desc *sd_file; /* file where symbol is taken */
1159 1161 Is_desc *sd_isc; /* input section of symbol definition */
1160 1162 Sym_aux *sd_aux; /* auxiliary global symbol info. */
1161 1163 Word sd_symndx; /* index in output symbol table */
1162 1164 Word sd_shndx; /* sect. index sym is associated w/ */
1163 1165 sd_flag_t sd_flags; /* state flags */
1164 1166 Half sd_ref; /* reference definition of symbol */
1165 1167 };
1166 1168
1167 1169 /*
1168 1170 * The auxiliary symbol descriptor contains the additional information (beyond
1169 1171 * the symbol descriptor) required to process global symbols. These symbols are
1170 1172 * accessed via an internal symbol hash table where locality of reference is
1171 1173 * important for performance.
1172 1174 */
1173 1175 struct sym_aux {
1174 1176 APlist *sa_dfiles; /* files where symbol is defined */
1175 1177 Sym sa_sym; /* copy of symtab entry */
1176 1178 const char *sa_vfile; /* first unavailable definition */
1177 1179 const char *sa_rfile; /* file with first symbol referenced */
1178 1180 Word sa_hash; /* the pure hash value of symbol */
1179 1181 Word sa_PLTndx; /* index into PLT for symbol */
1180 1182 Word sa_PLTGOTndx; /* GOT entry indx for PLT indirection */
1181 1183 Word sa_linkndx; /* index of associated symbol from */
1182 1184 /* ET_DYN file */
1183 1185 Half sa_symspec; /* special symbol ids */
1184 1186 Half sa_overndx; /* output file versioning index */
1185 1187 Half sa_dverndx; /* dependency versioning index */
1186 1188 };
1187 1189
1188 1190 /*
1189 1191 * Nodes used to track symbols in the global AVL symbol dictionary.
1190 1192 */
1191 1193 struct sym_avlnode {
1192 1194 avl_node_t sav_node; /* AVL node */
1193 1195 Word sav_hash; /* symbol hash value */
1194 1196 const char *sav_name; /* symbol name */
1195 1197 Sym_desc *sav_sdp; /* symbol descriptor */
1196 1198 };
1197 1199
1198 1200 /*
1199 1201 * These are the ids for processing of `Special symbols'. They are used
1200 1202 * to set the sym->sd_aux->sa_symspec field.
1201 1203 */
1202 1204 #define SDAUX_ID_ETEXT 1 /* etext && _etext symbol */
1203 1205 #define SDAUX_ID_EDATA 2 /* edata && _edata symbol */
1204 1206 #define SDAUX_ID_END 3 /* end, _end, && _END_ symbol */
1205 1207 #define SDAUX_ID_DYN 4 /* DYNAMIC && _DYNAMIC symbol */
1206 1208 #define SDAUX_ID_PLT 5 /* _PROCEDURE_LINKAGE_TABLE_ symbol */
1207 1209 #define SDAUX_ID_GOT 6 /* _GLOBAL_OFFSET_TABLE_ symbol */
1208 1210 #define SDAUX_ID_START 7 /* START_ && _START_ symbol */
1209 1211
1210 1212 /*
1211 1213 * Flags for sym_desc.sd_flags
1212 1214 */
1213 1215 #define FLG_SY_MVTOCOMM 0x00000001 /* assign symbol to common (.bss) */
1214 1216 /* this is a result of a */
1215 1217 /* copy reloc against sym */
1216 1218 #define FLG_SY_GLOBREF 0x00000002 /* a global reference has been seen */
1217 1219 #define FLG_SY_WEAKDEF 0x00000004 /* a weak definition has been used */
1218 1220 #define FLG_SY_CLEAN 0x00000008 /* `Sym' entry points to original */
1219 1221 /* input file (read-only). */
1220 1222 #define FLG_SY_UPREQD 0x00000010 /* symbol value update is required, */
1221 1223 /* either it's used as an entry */
1222 1224 /* point or for relocation, but */
1223 1225 /* it must be updated even if */
1224 1226 /* the -s flag is in effect */
1225 1227 #define FLG_SY_NOTAVAIL 0x00000020 /* symbol is not available to the */
1226 1228 /* application either because it */
1227 1229 /* originates from an implicitly */
1228 1230 /* referenced shared object, or */
1229 1231 /* because it is not part of a */
1230 1232 /* specified version. */
1231 1233 #define FLG_SY_REDUCED 0x00000040 /* a global is reduced to local */
1232 1234 #define FLG_SY_VERSPROM 0x00000080 /* version definition has been */
1233 1235 /* promoted to output file */
1234 1236 #define FLG_SY_PROT 0x00000100 /* stv_protected visibility seen */
1235 1237 #define FLG_SY_MAPREF 0x00000200 /* symbol reference generated by user */
1236 1238 /* from mapfile */
1237 1239 #define FLG_SY_REFRSD 0x00000400 /* symbols sd_ref has been raised */
1238 1240 /* due to a copy-relocs */
1239 1241 /* weak-strong pairing */
1240 1242 #define FLG_SY_INTPOSE 0x00000800 /* symbol defines an interposer */
1241 1243 #define FLG_SY_INVALID 0x00001000 /* unwanted/erroneous symbol */
1242 1244 #define FLG_SY_SMGOT 0x00002000 /* small got index assigned to symbol */
1243 1245 /* sparc only */
1244 1246 #define FLG_SY_PARENT 0x00004000 /* symbol to be found in parent */
1245 1247 /* only used with direct bindings */
1246 1248 #define FLG_SY_LAZYLD 0x00008000 /* symbol to cause lazyloading of */
1247 1249 /* parent object */
1248 1250 #define FLG_SY_ISDISC 0x00010000 /* symbol is a member of a DISCARDED */
1249 1251 /* section (COMDAT) */
1250 1252 #define FLG_SY_PAREXPN 0x00020000 /* partially init. symbol to be */
1251 1253 /* expanded */
1252 1254 #define FLG_SY_PLTPAD 0x00040000 /* pltpadding has been allocated for */
1253 1255 /* this symbol */
1254 1256 #define FLG_SY_REGSYM 0x00080000 /* REGISTER symbol (sparc only) */
1255 1257 #define FLG_SY_SOFOUND 0x00100000 /* compared against an SO definition */
1256 1258 #define FLG_SY_EXTERN 0x00200000 /* symbol is external, allows -zdefs */
1257 1259 /* error suppression */
1258 1260 #define FLG_SY_MAPUSED 0x00400000 /* mapfile symbol used (occurred */
1259 1261 /* within a relocatable object) */
1260 1262 #define FLG_SY_COMMEXP 0x00800000 /* COMMON symbol which has been */
1261 1263 /* allocated */
1262 1264 #define FLG_SY_CMDREF 0x01000000 /* symbol was referenced from the */
1263 1265 /* command line. (ld -u <>, */
1264 1266 /* ld -zrtldinfo=<>, ...) */
1265 1267 #define FLG_SY_SPECSEC 0x02000000 /* section index is reserved value */
1266 1268 /* ABS, COMMON, ... */
1267 1269 #define FLG_SY_TENTSYM 0x04000000 /* tentative symbol */
1268 1270 #define FLG_SY_VISIBLE 0x08000000 /* symbols visibility determined */
1269 1271 #define FLG_SY_STDFLTR 0x10000000 /* symbol is a standard filter */
1270 1272 #define FLG_SY_AUXFLTR 0x20000000 /* symbol is an auxiliary filter */
1271 1273 #define FLG_SY_DYNSORT 0x40000000 /* req. in dyn[sym|tls]sort section */
1272 1274 #define FLG_SY_NODYNSORT 0x80000000 /* excluded from dyn[sym_tls]sort sec */
1273 1275
1274 1276 #define FLG_SY_DEFAULT 0x0000100000000 /* global symbol, default */
1275 1277 #define FLG_SY_SINGLE 0x0000200000000 /* global symbol, singleton defined */
1276 1278 #define FLG_SY_PROTECT 0x0000400000000 /* global symbol, protected defined */
1277 1279 #define FLG_SY_EXPORT 0x0000800000000 /* global symbol, exported defined */
1278 1280
1279 1281 #define MSK_SY_GLOBAL \
1280 1282 (FLG_SY_DEFAULT | FLG_SY_SINGLE | FLG_SY_PROTECT | FLG_SY_EXPORT)
1281 1283 /* this mask indicates that the */
1282 1284 /* symbol has been explicitly */
1283 1285 /* defined within a mapfile */
1284 1286 /* definition, and is a candidate */
1285 1287 /* for versioning */
1286 1288
1287 1289 #define FLG_SY_HIDDEN 0x0001000000000 /* global symbol, reduce to local */
1288 1290 #define FLG_SY_ELIM 0x0002000000000 /* global symbol, eliminate */
1289 1291 #define FLG_SY_IGNORE 0x0004000000000 /* global symbol, ignored */
1290 1292
1291 1293 #define MSK_SY_LOCAL (FLG_SY_HIDDEN | FLG_SY_ELIM | FLG_SY_IGNORE)
1292 1294 /* this mask allows all local state */
1293 1295 /* flags to be removed when the */
1294 1296 /* symbol is copy relocated */
1295 1297
1296 1298 #define FLG_SY_EXPDEF 0x0008000000000 /* symbol visibility defined */
1297 1299 /* explicitly */
1298 1300
1299 1301 #define MSK_SY_NOAUTO (FLG_SY_SINGLE | FLG_SY_EXPORT | FLG_SY_EXPDEF)
1300 1302 /* this mask indicates that the */
1301 1303 /* symbol is not a candidate for */
1302 1304 /* auto-reduction/elimination */
1303 1305
1304 1306 #define FLG_SY_MAPFILE 0x0010000000000 /* symbol attribute defined in a */
1305 1307 /* mapfile */
1306 1308 #define FLG_SY_DIR 0x0020000000000 /* global symbol, direct bindings */
1307 1309 #define FLG_SY_NDIR 0x0040000000000 /* global symbol, nondirect bindings */
1308 1310 #define FLG_SY_OVERLAP 0x0080000000000 /* move entry overlap detected */
1309 1311 #define FLG_SY_CAP 0x0100000000000 /* symbol is associated with */
1310 1312 /* capabilities */
1311 1313 #define FLG_SY_DEFERRED 0x0200000000000 /* symbol should not be bound to */
1312 1314 /* during BIND_NOW relocations */
1313 1315
1314 1316 /*
1315 1317 * A symbol can only be truly hidden if it is not a capabilities symbol.
1316 1318 */
1317 1319 #define SYM_IS_HIDDEN(_sdp) \
1318 1320 (((_sdp)->sd_flags & (FLG_SY_HIDDEN | FLG_SY_CAP)) == FLG_SY_HIDDEN)
1319 1321
1320 1322 /*
1321 1323 * Create a mask for (sym.st_other & visibility) since the gABI does not yet
1322 1324 * define a ELF*_ST_OTHER macro.
1323 1325 */
1324 1326 #define MSK_SYM_VISIBILITY 0x7
1325 1327
1326 1328 /*
1327 1329 * Structure to manage the shared object definition lists. There are two lists
1328 1330 * that use this structure:
1329 1331 *
1330 1332 * - ofl_soneed; maintain the list of implicitly required dependencies
1331 1333 * (ie. shared objects needed by other shared objects). These definitions
1332 1334 * may include RPATH's required to locate the dependencies, and any
1333 1335 * version requirements.
1334 1336 *
1335 1337 * - ofl_socntl; maintains the shared object control definitions. These are
1336 1338 * provided by the user (via a mapfile) and are used to indicate any
1337 1339 * version control requirements.
1338 1340 */
1339 1341 struct sdf_desc {
1340 1342 const char *sdf_name; /* the shared objects file name */
1341 1343 char *sdf_rpath; /* library search path DT_RPATH */
1342 1344 const char *sdf_rfile; /* referencing file for diagnostics */
1343 1345 Ifl_desc *sdf_file; /* the final input file descriptor */
1344 1346 Alist *sdf_vers; /* list of versions that are required */
1345 1347 /* from this object */
1346 1348 Alist *sdf_verneed; /* list of VERNEEDS to create for */
1347 1349 /* object via mapfile ADDVERS */
1348 1350 Word sdf_flags;
1349 1351 };
1350 1352
1351 1353 #define FLG_SDF_SELECT 0x01 /* version control selection required */
1352 1354 #define FLG_SDF_VERIFY 0x02 /* version definition verification */
1353 1355 /* required */
1354 1356 #define FLG_SDF_ADDVER 0x04 /* add VERNEED references */
1355 1357
1356 1358 /*
1357 1359 * Structure to manage shared object version usage requirements.
1358 1360 */
1359 1361 struct sdv_desc {
1360 1362 const char *sdv_name; /* version name */
1361 1363 const char *sdv_ref; /* versions reference */
1362 1364 Word sdv_flags; /* flags */
1363 1365 };
1364 1366
1365 1367 #define FLG_SDV_MATCHED 0x01 /* VERDEF found and matched */
1366 1368
1367 1369 /*
1368 1370 * Structures to manage versioning information. Two versioning structures are
1369 1371 * defined:
1370 1372 *
1371 1373 * - a version descriptor maintains a linked list of versions and their
1372 1374 * associated dependencies. This is used to build the version definitions
1373 1375 * for an image being created (see map_symbol), and to determine the
1374 1376 * version dependency graph for any input files that are versioned.
1375 1377 *
1376 1378 * - a version index array contains each version of an input file that is
1377 1379 * being processed. It informs us which versions are available for
1378 1380 * binding, and is used to generate any version dependency information.
1379 1381 */
1380 1382 struct ver_desc {
1381 1383 const char *vd_name; /* version name */
1382 1384 Ifl_desc *vd_file; /* file that defined version */
1383 1385 Word vd_hash; /* hash value of name */
1384 1386 Half vd_ndx; /* coordinates with symbol index */
1385 1387 Half vd_flags; /* version information */
1386 1388 APlist *vd_deps; /* version dependencies */
1387 1389 Ver_desc *vd_ref; /* dependency's first reference */
1388 1390 };
1389 1391
1390 1392 struct ver_index {
1391 1393 const char *vi_name; /* dependency version name */
1392 1394 Half vi_flags; /* communicates availability */
1393 1395 Half vi_overndx; /* index assigned to this version in */
1394 1396 /* output object Verneed section */
1395 1397 Ver_desc *vi_desc; /* cross reference to descriptor */
1396 1398 };
1397 1399
1398 1400 /*
1399 1401 * Define any internal version descriptor flags ([vd|vi]_flags). Note that the
1400 1402 * first byte is reserved for user visible flags (refer VER_FLG's in link.h).
1401 1403 */
1402 1404 #define MSK_VER_USER 0x0f /* mask for user visible flags */
1403 1405
1404 1406 #define FLG_VER_AVAIL 0x10 /* version is available for binding */
1405 1407 #define FLG_VER_REFER 0x20 /* version has been referenced */
1406 1408 #define FLG_VER_CYCLIC 0x40 /* a member of cyclic dependency */
1407 1409
1408 1410 /*
1409 1411 * isalist(1) descriptor - used to break an isalist string into its component
1410 1412 * options.
1411 1413 */
1412 1414 struct isa_opt {
1413 1415 char *isa_name; /* individual isa option name */
1414 1416 size_t isa_namesz; /* and associated size */
1415 1417 };
1416 1418
1417 1419 struct isa_desc {
1418 1420 char *isa_list; /* sysinfo(SI_ISALIST) list */
1419 1421 size_t isa_listsz; /* and associated size */
1420 1422 Isa_opt *isa_opt; /* table of individual isa options */
1421 1423 size_t isa_optno; /* and associated number */
1422 1424 };
1423 1425
1424 1426 /*
1425 1427 * uname(2) descriptor - used to break a utsname structure into its component
1426 1428 * options (at least those that we're interested in).
1427 1429 */
1428 1430 struct uts_desc {
1429 1431 char *uts_osname; /* operating system name */
1430 1432 size_t uts_osnamesz; /* and associated size */
1431 1433 char *uts_osrel; /* operating system release */
1432 1434 size_t uts_osrelsz; /* and associated size */
1433 1435 };
1434 1436
1435 1437 /*
1436 1438 * SHT_GROUP descriptor - used to track group sections at the global
1437 1439 * level to resolve conflicts and determine which to keep.
1438 1440 */
1439 1441 struct group_desc {
1440 1442 Is_desc *gd_isc; /* input section descriptor */
1441 1443 Is_desc *gd_oisc; /* overriding input section */
1442 1444 /* descriptor when discarded */
1443 1445 const char *gd_name; /* group name (signature symbol) */
1444 1446 Word *gd_data; /* data for group section */
1445 1447 size_t gd_cnt; /* number of entries in group data */
1446 1448 };
1447 1449
1448 1450 /*
1449 1451 * Indexes into the ld_support_funcs[] table.
1450 1452 */
1451 1453 typedef enum {
1452 1454 LDS_VERSION = 0, /* Must be first and have value 0 */
1453 1455 LDS_INPUT_DONE,
1454 1456 LDS_START,
1455 1457 LDS_ATEXIT,
1456 1458 LDS_OPEN,
1457 1459 LDS_FILE,
1458 1460 LDS_INSEC,
1459 1461 LDS_SEC,
1460 1462 LDS_NUM
1461 1463 } Support_ndx;
1462 1464
1463 1465 /*
1464 1466 * Structure to manage archive member caching. Each archive has an archive
1465 1467 * descriptor (Ar_desc) associated with it. This contains pointers to the
1466 1468 * archive symbol table (obtained by elf_getarsyms(3e)) and an auxiliary
1467 1469 * structure (Ar_uax[]) that parallels this symbol table. The member element
1468 1470 * of this auxiliary table indicates whether the archive member associated with
1469 1471 * the symbol offset has already been extracted (AREXTRACTED) or partially
1470 1472 * processed (refer process_member()).
1471 1473 */
1472 1474 typedef struct ar_mem {
1473 1475 Elf *am_elf; /* elf descriptor for this member */
1474 1476 const char *am_name; /* members name */
1475 1477 const char *am_path; /* path (ie. lib(foo.o)) */
1476 1478 Sym *am_syms; /* start of global symbols */
1477 1479 char *am_strs; /* associated string table start */
1478 1480 Xword am_symn; /* no. of global symbols */
1479 1481 } Ar_mem;
1480 1482
1481 1483 typedef struct ar_aux {
1482 1484 Sym_desc *au_syms; /* internal symbol descriptor */
1483 1485 Ar_mem *au_mem; /* associated member */
1484 1486 } Ar_aux;
1485 1487
1486 1488 #define FLG_ARMEM_PROC (Ar_mem *)-1
1487 1489
1488 1490 typedef struct ar_desc {
1489 1491 const char *ad_name; /* archive file name */
1490 1492 Elf *ad_elf; /* elf descriptor for the archive */
1491 1493 Elf_Arsym *ad_start; /* archive symbol table start */
1492 1494 Ar_aux *ad_aux; /* auxiliary symbol information */
1493 1495 dev_t ad_stdev; /* device id and inode number for */
1494 1496 ino_t ad_stino; /* multiple inclusion checks */
1495 1497 ofl_flag_t ad_flags; /* archive specific cmd line flags */
1496 1498 } Ar_desc;
1497 1499
1498 1500 /*
1499 1501 * Define any archive descriptor flags. NOTE, make sure they do not clash with
1500 1502 * any output file descriptor archive extraction flags, as these are saved in
1501 1503 * the same entry (see MSK_OF1_ARCHIVE).
1502 1504 */
1503 1505 #define FLG_ARD_EXTRACT 0x00010000 /* archive member has been extracted */
1504 1506
1505 1507 /* Mapfile versions supported by libld */
1506 1508 #define MFV_NONE 0 /* Not a valid version */
1507 1509 #define MFV_SYSV 1 /* Original System V syntax */
1508 1510 #define MFV_SOLARIS 2 /* Solaris mapfile syntax */
1509 1511 #define MFV_NUM 3 /* # of mapfile versions */
1510 1512
1511 1513
1512 1514 /*
1513 1515 * Function Declarations.
1514 1516 */
1515 1517 #if defined(_ELF64)
1516 1518
1517 1519 #define ld_create_outfile ld64_create_outfile
1518 1520 #define ld_ent_setup ld64_ent_setup
1519 1521 #define ld_init_strings ld64_init_strings
1520 1522 #define ld_init_target ld64_init_target
1521 1523 #define ld_make_sections ld64_make_sections
1522 1524 #define ld_main ld64_main
1523 1525 #define ld_ofl_cleanup ld64_ofl_cleanup
1524 1526 #define ld_process_mem ld64_process_mem
1525 1527 #define ld_reloc_init ld64_reloc_init
1526 1528 #define ld_reloc_process ld64_reloc_process
1527 1529 #define ld_sym_validate ld64_sym_validate
1528 1530 #define ld_update_outfile ld64_update_outfile
1529 1531
1530 1532 #else
1531 1533
1532 1534 #define ld_create_outfile ld32_create_outfile
1533 1535 #define ld_ent_setup ld32_ent_setup
1534 1536 #define ld_init_strings ld32_init_strings
1535 1537 #define ld_init_target ld32_init_target
1536 1538 #define ld_make_sections ld32_make_sections
1537 1539 #define ld_main ld32_main
1538 1540 #define ld_ofl_cleanup ld32_ofl_cleanup
1539 1541 #define ld_process_mem ld32_process_mem
1540 1542 #define ld_reloc_init ld32_reloc_init
1541 1543 #define ld_reloc_process ld32_reloc_process
1542 1544 #define ld_sym_validate ld32_sym_validate
1543 1545 #define ld_update_outfile ld32_update_outfile
1544 1546
1545 1547 #endif
1546 1548
1547 1549 extern int ld_getopt(Lm_list *, int, int, char **);
1548 1550
1549 1551 extern int ld32_main(int, char **, Half);
1550 1552 extern int ld64_main(int, char **, Half);
1551 1553
1552 1554 extern uintptr_t ld_create_outfile(Ofl_desc *);
1553 1555 extern uintptr_t ld_ent_setup(Ofl_desc *, Xword);
1554 1556 extern uintptr_t ld_init_strings(Ofl_desc *);
1555 1557 extern int ld_init_target(Lm_list *, Half mach);
1556 1558 extern uintptr_t ld_make_sections(Ofl_desc *);
1557 1559 extern void ld_ofl_cleanup(Ofl_desc *);
1558 1560 extern Ifl_desc *ld_process_mem(const char *, const char *, char *,
1559 1561 size_t, Ofl_desc *, Rej_desc *);
1560 1562 extern uintptr_t ld_reloc_init(Ofl_desc *);
1561 1563 extern uintptr_t ld_reloc_process(Ofl_desc *);
1562 1564 extern uintptr_t ld_sym_validate(Ofl_desc *);
1563 1565 extern uintptr_t ld_update_outfile(Ofl_desc *);
1564 1566
1565 1567 #ifdef __cplusplus
1566 1568 }
1567 1569 #endif
1568 1570
1569 1571 #endif /* _LIBLD_H */
↓ open down ↓ |
1092 lines elided |
↑ open up ↑ |
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX