1 /* 2 * CDDL HEADER START 3 * 4 * The contents of this file are subject to the terms of the 5 * Common Development and Distribution License (the "License"). 6 * You may not use this file except in compliance with the License. 7 * 8 * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE 9 * or http://www.opensolaris.org/os/licensing. 10 * See the License for the specific language governing permissions 11 * and limitations under the License. 12 * 13 * When distributing Covered Code, include this CDDL HEADER in each 14 * file and include the License file at usr/src/OPENSOLARIS.LICENSE. 15 * If applicable, add the following below this CDDL HEADER, with the 16 * fields enclosed by brackets "[]" replaced with your own identifying 17 * information: Portions Copyright [yyyy] [name of copyright owner] 18 * 19 * CDDL HEADER END 20 */ 21 22 /* 23 * Copyright (c) 1988 AT&T 24 * All Rights Reserved 25 * 26 * Copyright 2007 Sun Microsystems, Inc. All rights reserved. 27 * Use is subject to license terms. 28 */ 29 30 #ifndef _LIBLD_H 31 #define _LIBLD_H 32 33 #pragma ident "%Z%%M% %I% %E% SMI" 34 35 #include <stdlib.h> 36 #include <libelf.h> 37 #include <sgs.h> 38 #include <machdep.h> 39 #include <string_table.h> 40 #include <sys/avl.h> 41 #include <alist.h> 42 43 #ifdef __cplusplus 44 extern "C" { 45 #endif 46 47 /* 48 * Default directory search path manipulation for the link-editor. YLDIR 49 * indicates which directory in LIBPATH is replaced by the -YL option to cc 50 * and ld. YUDIR indicates which directory is replaced by -YU. 51 */ 52 #define YLDIR 1 53 #define YUDIR 2 54 55 /* 56 * Define a hash value that can never be returned from elf_hash(). 57 */ 58 #define SYM_NOHASH (~(Word)0) 59 60 /* 61 * Macro that can be used to represent both ORDER flags 62 * in a section header. 63 */ 64 #define ALL_SHF_ORDER (SHF_ORDERED | SHF_LINK_ORDER) 65 66 /* 67 * The linker merges (concatenates) sections with the same name and 68 * compatible section header flags. When comparing these flags, 69 * there are some that should not be included in the decision. 70 * The ALL_SHF_IGNORE constant defines these flags. 71 * 72 * NOTE: SHF_MERGE|SHF_STRINGS: 73 * The compiler is allowed to set the SHF_MERGE|SHF_STRINGS flags in 74 * order to tell the linker that: 75 * 76 * 1) There is nothing in the section except null terminated strings. 77 * 2) If two compatible sections both have these flags set, it is 78 * OK to combine identical strings into single instances. 79 * In this case, the two sections would be modified to both 80 * reference a single string copy. 81 * 82 * This is a different meaning than the simple concatenating of sections 83 * that the linker always does. It is a hint that an additional optimization 84 * is possible, but not required. This means that sections that do not 85 * share the same SHF_MERGE|SHF_STRINGS values can be merged (concatenated), 86 * but cannot have their duplicate strings combined. Hence, the values 87 * of SHF_MERGE|SHF_STRINGS should be ignored when deciding whether two 88 * sections can be merged (concatenated). 89 * 90 * We do not currently implement the SHF_MERGE|SHF_STRINGS optimization, 91 * but it is possible to add it. If we did, the procedure would be to 92 * first combine the compatible sections that have these flag bits set, 93 * and then to concatenate any others to the result. 94 */ 95 #define ALL_SHF_IGNORE (ALL_SHF_ORDER | SHF_GROUP | SHF_MERGE | SHF_STRINGS) 96 97 /* 98 * Define symbol reference types for use in symbol resolution. 99 */ 100 typedef enum { 101 REF_DYN_SEEN, /* a .so symbol has been seen */ 102 REF_DYN_NEED, /* a .so symbol satisfies a .o symbol */ 103 REF_REL_NEED, /* a .o symbol */ 104 REF_NUM /* the number of symbol references */ 105 } Symref; 106 107 108 /* 109 * GOT reference models 110 */ 111 typedef enum { 112 GOT_REF_GENERIC, /* generic symbol reference */ 113 GOT_REF_TLSIE, /* TLS initial exec (gnu) reference */ 114 GOT_REF_TLSLD, /* TLS local dynamic reference */ 115 GOT_REF_TLSGD /* TLS general dynamic reference */ 116 } Gotref; 117 118 typedef struct { 119 Xword gn_addend; /* addend associated with GOT entry */ 120 Sword gn_gotndx; /* GOT table index */ 121 Gotref gn_gotref; 122 } Gotndx; 123 124 /* 125 * Got debugging structure. The got index is defined as a signed value as we 126 * do so much mucking around with negative and positive gots on SPARC, and sign 127 * extension is necessary when building 64-bit objects. On intel we explicitly 128 * cast this variable to an unsigned value. 129 */ 130 typedef struct { 131 Sym_desc * gt_sym; 132 Gotndx gt_gndx; 133 } Gottable; 134 135 /* 136 * Output file processing structure 137 */ 138 struct ofl_desc { 139 char *ofl_sgsid; /* link-editor identification */ 140 const char *ofl_name; /* full file name */ 141 Elf *ofl_elf; /* elf_memory() elf descriptor */ 142 Elf *ofl_welf; /* ELF_C_WRITE elf descriptor */ 143 Ehdr *ofl_dehdr; /* default elf header, and new elf */ 144 Ehdr *ofl_nehdr; /* header describing this file */ 145 Phdr *ofl_phdr; /* program header descriptor */ 146 Phdr *ofl_tlsphdr; /* TLS phdr */ 147 int ofl_fd; /* file descriptor */ 148 size_t ofl_size; /* image size */ 149 List ofl_maps; /* list of input mapfiles */ 150 List ofl_segs; /* list of segments */ 151 List ofl_ents; /* list of entrance descriptors */ 152 List ofl_objs; /* relocatable object file list */ 153 Word ofl_objscnt; /* and count */ 154 List ofl_ars; /* archive library list */ 155 Word ofl_arscnt; /* and count */ 156 List ofl_sos; /* shared object list */ 157 Word ofl_soscnt; /* and count */ 158 List ofl_soneed; /* list of implicitly required .so's */ 159 List ofl_socntl; /* list of .so control definitions */ 160 List ofl_outrels; /* list of output relocations */ 161 Word ofl_outrelscnt; /* and count */ 162 List ofl_actrels; /* list of relocations to perform */ 163 Word ofl_actrelscnt; /* and count */ 164 Word ofl_entrelscnt; /* no of relocations entered */ 165 List ofl_copyrels; /* list of copy relocations */ 166 List ofl_ordered; /* list of shf_ordered sections */ 167 List ofl_syminfsyms; /* list of interesting syms */ 168 /* for syminfo processing */ 169 List ofl_ismove; /* list of .SUNW_move sections */ 170 List ofl_mvrelisdescs; /* list of relocation input section */ 171 /* targeting to expanded area */ 172 List ofl_parsym; /* list of Parsym_info */ 173 List ofl_extrarels; /* relocation sections which have */ 174 /* a NULL sh_info */ 175 avl_tree_t *ofl_groups; /* pointer to head of Groups AVL tree */ 176 List ofl_initarray; /* list of init array func names */ 177 List ofl_finiarray; /* list of fini array func names */ 178 List ofl_preiarray; /* list of preinit array func names */ 179 List ofl_rtldinfo; /* list of rtldinfo syms */ 180 List ofl_osgroups; /* list of output GROUP sections */ 181 List ofl_ostlsseg; /* pointer to sections in TLS segment */ 182 #if defined(__x86) && defined(_ELF64) 183 List ofl_unwind; /* list of unwind output sections */ 184 Os_desc *ofl_unwindhdr; /* Unwind hdr */ 185 #endif 186 avl_tree_t ofl_symavl; /* pointer to head of Syms AVL tree */ 187 Sym_desc **ofl_regsyms; /* array of potential register */ 188 Word ofl_regsymsno; /* symbols and array count */ 189 Word ofl_regsymcnt; /* no. of output register symbols */ 190 Word ofl_lregsymcnt; /* no. of local register symbols */ 191 Sym_desc *ofl_dtracesym; /* ld -zdtrace= */ 192 Lword ofl_flags; /* various state bits, args etc. */ 193 Lword ofl_flags1; /* more flags */ 194 Xword ofl_segorigin; /* segment origin (start) */ 195 void *ofl_entry; /* entry point (-e and Sym_desc *) */ 196 char *ofl_filtees; /* shared objects we are a filter for */ 197 const char *ofl_soname; /* (-h option) output file name for */ 198 /* dynamic structure */ 199 const char *ofl_interp; /* interpreter name used by exec() */ 200 char *ofl_rpath; /* run path to store in .dynamic */ 201 char *ofl_config; /* config path to store in .dynamic */ 202 List ofl_ulibdirs; /* user supplied library search list */ 203 List ofl_dlibdirs; /* default library search list */ 204 Word ofl_vercnt; /* number of versions to generate */ 205 List ofl_verdesc; /* list of version descriptors */ 206 size_t ofl_verdefsz; /* size of version definition section */ 207 size_t ofl_verneedsz; /* size of version needed section */ 208 Word ofl_entercnt; /* no. of global symbols entered */ 209 Word ofl_globcnt; /* no. of global symbols to output */ 210 Word ofl_scopecnt; /* no. of scoped symbols to output */ 211 Word ofl_dynscopecnt; /* no. scoped syms in .SUNW_ldynsym */ 212 Word ofl_elimcnt; /* no. of eliminated symbols */ 213 Word ofl_locscnt; /* no. of local symbols in .symtab */ 214 Word ofl_dynlocscnt; /* no. local symbols in .SUNW_ldynsym */ 215 Word ofl_dynsymsortcnt; /* no. ndx in .SUNW_dynsymsort */ 216 Word ofl_dyntlssortcnt; /* no. ndx in .SUNW_dyntlssort */ 217 Word ofl_dynshdrcnt; /* no. of output section in .dynsym */ 218 Word ofl_shdrcnt; /* no. of output sections */ 219 Str_tbl *ofl_shdrsttab; /* Str_tbl for shdr strtab */ 220 Str_tbl *ofl_strtab; /* Str_tbl for symtab strtab */ 221 Str_tbl *ofl_dynstrtab; /* Str_tbl for dymsym strtab */ 222 Gotndx *ofl_tlsldgotndx; /* index to LD TLS_index structure */ 223 Xword ofl_relocsz; /* size of output relocations */ 224 Xword ofl_relocgotsz; /* size of .got relocations */ 225 Xword ofl_relocpltsz; /* size of .plt relocations */ 226 Xword ofl_relocbsssz; /* size of .bss (copy) relocations */ 227 Xword ofl_relocrelsz; /* size of .rel[a] relocations */ 228 Word ofl_relocincnt; /* no. of input relocations */ 229 Word ofl_reloccnt; /* tot number of output relocations */ 230 Word ofl_reloccntsub; /* tot numb of output relocations to */ 231 /* skip (-zignore) */ 232 Word ofl_relocrelcnt; /* tot number of relative */ 233 /* relocations */ 234 Word ofl_gotcnt; /* no. of .got entries */ 235 Word ofl_pltcnt; /* no. of .plt entries */ 236 Word ofl_pltpad; /* no. of .plt padd entries */ 237 Word ofl_hashbkts; /* no. of hash buckets required */ 238 Is_desc *ofl_isbss; /* .bss input section (globals) */ 239 Is_desc *ofl_islbss; /* .lbss input section (globals) */ 240 Is_desc *ofl_istlsbss; /* .tlsbss input section (globals) */ 241 Is_desc *ofl_issunwdata1; /* .data input section */ 242 /* partially expanded. */ 243 Is_desc *ofl_issunwbss; /* .SUNW_bss input section (globals) */ 244 Os_desc *ofl_osdynamic; /* .dynamic output section */ 245 Os_desc *ofl_osdynsym; /* .dynsym output section */ 246 Os_desc *ofl_osldynsym; /* .SUNW_ldynsym output section */ 247 Os_desc *ofl_osdynstr; /* .dynstr output section */ 248 Os_desc *ofl_osdynsymsort; /* .SUNW_dynsymsort output section */ 249 Os_desc *ofl_osdyntlssort; /* .SUNW_dyntlssort output section */ 250 Os_desc *ofl_osgot; /* .got output section */ 251 Os_desc *ofl_oshash; /* .hash output section */ 252 Os_desc *ofl_osinitarray; /* .initarray output section */ 253 Os_desc *ofl_osfiniarray; /* .finiarray output section */ 254 Os_desc *ofl_ospreinitarray; /* .preinitarray output section */ 255 Os_desc *ofl_osinterp; /* .interp output section */ 256 Os_desc *ofl_oscap; /* .SUNW_cap output section */ 257 Os_desc *ofl_osplt; /* .plt output section */ 258 Os_desc *ofl_osmove; /* .SUNW_move output section */ 259 Os_desc *ofl_osrelhead; /* first relocation section */ 260 Os_desc *ofl_osrel; /* .rel[a] relocation section */ 261 Os_desc *ofl_osshstrtab; /* .shstrtab output section */ 262 Os_desc *ofl_osstrtab; /* .strtab output section */ 263 Os_desc *ofl_ossymtab; /* .symtab output section */ 264 Os_desc *ofl_ossymshndx; /* .symtab_shndx output section */ 265 Os_desc *ofl_osdynshndx; /* .dynsym_shndx output section */ 266 Os_desc *ofl_osldynshndx; /* .SUNW_ldynsym_shndx output sec */ 267 Os_desc *ofl_osverdef; /* .version definition output section */ 268 Os_desc *ofl_osverneed; /* .version needed output section */ 269 Os_desc *ofl_osversym; /* .version symbol ndx output section */ 270 Word ofl_dtflags_1; /* DT_FLAGS_1 entries */ 271 Word ofl_dtflags; /* DT_FLAGS entries */ 272 Os_desc *ofl_ossyminfo; /* .SUNW_syminfo output section */ 273 Half ofl_sunwdata1ndx; /* section index for sunwdata1 */ 274 /* Ref. at perform_outreloc() in */ 275 /* libld/{mach}/machrel.c */ 276 Xword *ofl_checksum; /* DT_CHECKSUM value address */ 277 char *ofl_depaudit; /* dependency auditing required (-P) */ 278 char *ofl_audit; /* object auditing required (-p) */ 279 Alist *ofl_symfltrs; /* per-symbol filtees and their */ 280 Alist *ofl_dtsfltrs; /* associated .dynamic/.dynstrs */ 281 Xword ofl_hwcap_1; /* hardware capabilities */ 282 Xword ofl_sfcap_1; /* software capabilities */ 283 Lm_list *ofl_lml; /* runtime link-map list */ 284 Gottable *ofl_gottable; /* debugging got information */ 285 }; 286 287 #define FLG_OF_DYNAMIC 0x00000001 /* generate dynamic output module */ 288 #define FLG_OF_STATIC 0x00000002 /* generate static output module */ 289 #define FLG_OF_EXEC 0x00000004 /* generate an executable */ 290 #define FLG_OF_RELOBJ 0x00000008 /* generate a relocatable object */ 291 #define FLG_OF_SHAROBJ 0x00000010 /* generate a shared object */ 292 #define FLG_OF_BFLAG 0x00000020 /* do no special plt building: -b */ 293 #define FLG_OF_IGNENV 0x00000040 /* ignore LD_LIBRARY_PATH: -i */ 294 #define FLG_OF_STRIP 0x00000080 /* strip output: -s */ 295 #define FLG_OF_NOWARN 0x00000100 /* disable symbol warnings: -t */ 296 #define FLG_OF_NOUNDEF 0x00000200 /* allow no undefined symbols: -zdefs */ 297 #define FLG_OF_PURETXT 0x00000400 /* allow no text relocations: -ztext */ 298 #define FLG_OF_GENMAP 0x00000800 /* generate a memory map: -m */ 299 #define FLG_OF_DYNLIBS 0x00001000 /* dynamic input allowed: -Bdynamic */ 300 #define FLG_OF_SYMBOLIC 0x00002000 /* bind global symbols: -Bsymbolic */ 301 #define FLG_OF_ADDVERS 0x00004000 /* add version stamp: -Qy */ 302 #define FLG_OF_NOLDYNSYM 0x00008000 /* -znoldynsym set */ 303 #define FLG_OF_SEGORDER 0x00010000 /* segment ordering is required */ 304 #define FLG_OF_SEGSORT 0x00020000 /* segment sorting is required */ 305 #define FLG_OF_TEXTREL 0x00040000 /* text relocations have been found */ 306 #define FLG_OF_MULDEFS 0x00080000 /* multiple symbols are allowed */ 307 #define FLG_OF_TLSPHDR 0x00100000 /* a TLS program header is required */ 308 #define FLG_OF_BLDGOT 0x00200000 /* build GOT table */ 309 #define FLG_OF_VERDEF 0x00400000 /* record version definitions */ 310 #define FLG_OF_VERNEED 0x00800000 /* record version dependencies */ 311 #define FLG_OF_NOVERSEC 0x01000000 /* don't record version sections */ 312 #define FLG_OF_AUTOLCL 0x02000000 /* automatically reduce unspecified */ 313 /* global symbols to locals */ 314 #define FLG_OF_PROCRED 0x04000000 /* process any symbol reductions by */ 315 /* effecting the symbol table */ 316 /* output and relocations */ 317 #define FLG_OF_SYMINFO 0x08000000 /* create a syminfo section */ 318 #define FLG_OF_AUX 0x10000000 /* ofl_filter is an auxiliary filter */ 319 #define FLG_OF_FATAL 0x20000000 /* fatal error during input */ 320 #define FLG_OF_WARN 0x40000000 /* warning during input processing. */ 321 #define FLG_OF_VERBOSE 0x80000000 /* -z verbose flag set */ 322 323 #define FLG_OF_MAPSYMB 0x000100000000 /* symbolic scope definition seen */ 324 #define FLG_OF_MAPGLOB 0x000200000000 /* global scope definition seen */ 325 326 /* 327 * In the flags1 arena, establish any options that are applicable to archive 328 * extraction first, and associate a mask. These values are recorded with any 329 * archive descriptor so that they may be reset should the archive require a 330 * rescan to try and resolve undefined symbols. 331 */ 332 #define FLG_OF1_ALLEXRT 0x00000001 /* extract all members from an */ 333 /* archive file */ 334 #define FLG_OF1_WEAKEXT 0x00000002 /* allow archive extraction to */ 335 /* resolve weak references */ 336 #define MSK_OF1_ARCHIVE 0x00000003 /* archive flags mask */ 337 338 #define FLG_OF1_NOINTRP 0x00000008 /* -z nointerp flag set */ 339 #define FLG_OF1_ZDIRECT 0x00000010 /* -z direct flag set */ 340 #define FLG_OF1_NDIRECT 0x00000020 /* no-direct bindings specified */ 341 #define FLG_OF1_OVHWCAP 0x00000040 /* override any input hardware or */ 342 #define FLG_OF1_OVSFCAP 0x00000080 /* software capabilities */ 343 #define FLG_OF1_RELDYN 0x00000100 /* process .dynamic in rel obj */ 344 #define FLG_OF1_REDLSYM 0x00000200 /* reduce local symbols */ 345 #define FLG_OF1_AUTOELM 0x00000400 /* automatically eliminate */ 346 /* unspecified global symbols */ 347 #define FLG_OF1_IGNORE 0x00000800 /* ignore unused dependencies */ 348 #define FLG_OF1_RELCNT 0x00001000 /* enable DT_RELACNT tracking */ 349 #define FLG_OF1_TEXTOFF 0x00002000 /* text relocations are ok */ 350 #define FLG_OF1_ABSEXEC 0x00004000 /* -zabsexec set */ 351 #define FLG_OF1_LAZYLD 0x00008000 /* lazy loading of objects enabled */ 352 #define FLG_OF1_GRPPRM 0x00010000 /* dependencies are to have */ 353 /* GROUPPERM enabled */ 354 #define FLG_OF1_OVRFLW 0x00020000 /* size exceeds 32-bit limitation */ 355 /* of 32-bit libld */ 356 #define FLG_OF1_NOPARTI 0x00040000 /* -znopartial set */ 357 #define FLG_OF1_BSSOREL 0x00080000 /* output relocation against bss */ 358 /* section */ 359 #define FLG_OF1_TLSOREL 0x00100000 /* output relocation against .tlsbss */ 360 /* section */ 361 #define FLG_OF1_MEMORY 0x00200000 /* produce a memory model */ 362 #define FLG_OF1_RLXREL 0x00400000 /* -z relaxreloc flag set */ 363 #define FLG_OF1_ENCDIFF 0x00800000 /* Host running linker has different */ 364 /* byte order than output object */ 365 #define FLG_OF1_VADDR 0x01000000 /* vaddr was explicitly set */ 366 #define FLG_OF1_EXTRACT 0x02000000 /* archive member has been extracted */ 367 #define FLG_OF1_RESCAN 0x04000000 /* any archives should be rescanned */ 368 #define FLG_OF1_IGNPRC 0x08000000 /* ignore processing required */ 369 #define FLG_OF1_NCSTTAB 0x10000000 /* -znocompstrtab set */ 370 #define FLG_OF1_DONE 0x20000000 /* link-editor processing complete */ 371 #define FLG_OF1_NONREG 0x40000000 /* non-regular file specified as */ 372 /* the output file */ 373 #define FLG_OF1_ALNODIR 0x80000000 /* establish NODIRECT for all */ 374 /* exported interfaces. */ 375 376 /* 377 * Test to see if the output file would allow the presence of 378 * a .dynsym section. 379 */ 380 #define OFL_ALLOW_DYNSYM(_ofl) (((_ofl)->ofl_flags & \ 381 (FLG_OF_DYNAMIC | FLG_OF_RELOBJ)) == FLG_OF_DYNAMIC) 382 383 /* 384 * Test to see if the output file would allow the presence of 385 * a .SUNW_ldynsym section. The requirements are that a .dynsym 386 * is allowed, and -znoldynsym has not been specified. Note that 387 * even if the answer is True (1), we will only generate one if there 388 * are local symbols that require it. 389 */ 390 #define OFL_ALLOW_LDYNSYM(_ofl) (((_ofl)->ofl_flags & \ 391 (FLG_OF_DYNAMIC | FLG_OF_RELOBJ | FLG_OF_NOLDYNSYM)) == FLG_OF_DYNAMIC) 392 393 /* 394 * Test to see if relocation processing should be done. This is normally 395 * true, but can be disabled via the '-z noreloc' option. Note that 396 * relocatable objects are still relocated even if '-z noreloc' is present. 397 */ 398 #define OFL_DO_RELOC(_ofl) (((_ofl)->ofl_flags & FLG_OF_RELOBJ) || \ 399 !((_ofl)->ofl_dtflags_1 & DF_1_NORELOC)) 400 401 /* 402 * Determine whether relocation processing needs to swap the 403 * data being relocated. 404 */ 405 #define OFL_SWAP_RELOC_DATA(_ofl, _rel) \ 406 ((((_ofl)->ofl_flags1 & FLG_OF1_ENCDIFF) != 0) && \ 407 ((_rel)->rel_osdesc->os_shdr->sh_type == SHT_PROGBITS)) 408 409 /* 410 * Relocation (active & output) processing structure - transparent to common 411 * code. 412 */ 413 struct rel_desc { 414 Os_desc *rel_osdesc; /* output section reloc is against */ 415 Is_desc *rel_isdesc; /* input section reloc is against */ 416 const char *rel_sname; /* symbol name (may be "unknown") */ 417 Sym_desc *rel_sym; /* sym relocation is against */ 418 Sym_desc *rel_usym; /* strong sym if this is a weak pair */ 419 Mv_desc *rel_move; /* move table information */ 420 Word rel_flags; /* misc. flags for relocations */ 421 Word rel_rtype; /* relocation type */ 422 Xword rel_roffset; /* relocation offset */ 423 Sxword rel_raddend; /* addend from input relocation */ 424 Word rel_typedata; /* ELF_R_TYPE_DATA(info) */ 425 }; 426 427 /* 428 * common flags used on the Rel_desc structure (defined in machrel.h). 429 */ 430 #define FLG_REL_GOT 0x00000001 /* relocation against GOT */ 431 #define FLG_REL_PLT 0x00000002 /* relocation against PLT */ 432 #define FLG_REL_BSS 0x00000004 /* relocation against BSS */ 433 #define FLG_REL_LOAD 0x00000008 /* section loadable */ 434 #define FLG_REL_SCNNDX 0x00000010 /* use section index for symbol ndx */ 435 #define FLG_REL_CLVAL 0x00000020 /* clear VALUE for active relocation */ 436 #define FLG_REL_ADVAL 0x00000040 /* add VALUE for output relocation, */ 437 /* only relevant to SPARC and */ 438 /* R_SPARC_RELATIVE */ 439 #define FLG_REL_GOTCL 0x00000080 /* clear the GOT entry. This is */ 440 /* relevant to RELA relocations, */ 441 /* not REL (i386) relocations */ 442 #define FLG_REL_MOVETAB 0x00000100 /* Relocation against .SUNW_move */ 443 /* adjustments required before */ 444 /* actual relocation */ 445 #define FLG_REL_NOINFO 0x00000200 /* Relocation comes from a section */ 446 /* with a null sh_info field */ 447 #define FLG_REL_REG 0x00000400 /* Relocation target is reg sym */ 448 #define FLG_REL_FPTR 0x00000800 /* relocation against func. desc. */ 449 #define FLG_REL_RFPTR1 0x00001000 /* Relative relocation against */ 450 /* 1st part of FD */ 451 #define FLG_REL_RFPTR2 0x00002000 /* Relative relocation against */ 452 /* 2nd part of FD */ 453 #define FLG_REL_DISP 0x00004000 /* *disp* relocation */ 454 #define FLG_REL_STLS 0x00008000 /* IE TLS reference to */ 455 /* static TLS GOT index */ 456 #define FLG_REL_DTLS 0x00010000 /* GD TLS reference relative to */ 457 /* dynamic TLS GOT index */ 458 #define FLG_REL_MTLS 0x00020000 /* LD TLS reference against GOT */ 459 #define FLG_REL_STTLS 0x00040000 /* LE TLS reference directly */ 460 /* to static tls index */ 461 #define FLG_REL_TLSFIX 0x00080000 /* relocation points to TLS instr. */ 462 /* which needs updating */ 463 #define FLG_REL_RELA 0x00100000 /* descripter captures a Rela */ 464 #define FLG_REL_GOTFIX 0x00200000 /* relocation points to GOTOP instr. */ 465 /* which needs updating */ 466 467 /* 468 * Structure to hold a cache of Relocations. 469 */ 470 struct rel_cache { 471 Rel_desc *rc_end; 472 Rel_desc *rc_free; 473 }; 474 475 /* 476 * Symbol value descriptor. For relocatable objects, each symbols value is 477 * its offset within its associated section. Therefore, to uniquely define 478 * each symbol within a reloctable object, record and sort the sh_offset and 479 * symbol value. This information is used to seach for displacement 480 * relocations as part of copy relocation validation. 481 */ 482 typedef struct { 483 Addr ssv_value; 484 Sym_desc *ssv_sdp; 485 } Ssv_desc; 486 487 /* 488 * Input file processing structures. 489 */ 490 struct ifl_desc { /* input file descriptor */ 491 const char *ifl_name; /* full file name */ 492 const char *ifl_soname; /* shared object name */ 493 dev_t ifl_stdev; /* device id and inode number for .so */ 494 ino_t ifl_stino; /* multiple inclusion checks */ 495 Ehdr *ifl_ehdr; /* elf header describing this file */ 496 Elf *ifl_elf; /* elf descriptor for this file */ 497 Sym_desc **ifl_oldndx; /* original symbol table indices */ 498 Sym_desc *ifl_locs; /* symbol desc version of locals */ 499 Ssv_desc *ifl_sortsyms; /* sorted list of symbols by value */ 500 Word ifl_locscnt; /* no. of local symbols to process */ 501 Word ifl_symscnt; /* total no. of symbols to process */ 502 Word ifl_sortcnt; /* no. of sorted symbols to process */ 503 Word ifl_shnum; /* number of sections in file */ 504 Word ifl_shstrndx; /* index to .shstrtab */ 505 Word ifl_vercnt; /* number of versions in file */ 506 Is_desc **ifl_isdesc; /* isdesc[scn ndx] = Is_desc ptr */ 507 Sdf_desc *ifl_sdfdesc; /* control definition */ 508 Versym *ifl_versym; /* version symbol table array */ 509 Ver_index *ifl_verndx; /* verndx[ver ndx] = Ver_index */ 510 List ifl_verdesc; /* version descriptor list */ 511 List ifl_relsect; /* relocation section list */ 512 Alist *ifl_groups; /* SHT_GROUP section list */ 513 Half ifl_neededndx; /* index to NEEDED in .dyn section */ 514 Word ifl_flags; /* Explicit/implicit reference */ 515 }; 516 517 #define FLG_IF_CMDLINE 0x00000001 /* full filename specified from the */ 518 /* command line (no -l) */ 519 #define FLG_IF_NEEDED 0x00000002 /* shared object should be recorded */ 520 #define FLG_IF_DIRECT 0x00000004 /* establish direct bindings to this */ 521 /* object */ 522 #define FLG_IF_EXTRACT 0x00000008 /* file extracted from an archive */ 523 #define FLG_IF_VERNEED 0x00000010 /* version dependency information is */ 524 /* required */ 525 #define FLG_IF_DEPREQD 0x00000020 /* dependency is required to satisfy */ 526 /* symbol references */ 527 #define FLG_IF_NEEDSTR 0x00000040 /* dependency specified by -Nn */ 528 /* flag */ 529 #define FLG_IF_IGNORE 0x00000080 /* ignore unused dependencies */ 530 #define FLG_IF_NODIRECT 0x00000100 /* object contains symbols that */ 531 /* cannot be directly bound to. */ 532 #define FLG_IF_LAZYLD 0x00000200 /* bindings to this object should be */ 533 /* lazy loaded */ 534 #define FLG_IF_GRPPRM 0x00000400 /* this dependency should have the */ 535 /* DF_P1_GROUPPERM flag set */ 536 #define FLG_IF_DISPPEND 0x00000800 /* displacement relocation done */ 537 /* in the ld time. */ 538 #define FLG_IF_DISPDONE 0x00001000 /* displacement relocation done */ 539 /* at the run time */ 540 #define FLG_IF_MAPFILE 0x00002000 /* file is a mapfile */ 541 #define FLG_IF_HSTRTAB 0x00004000 /* file has a string section */ 542 #define FLG_IF_FILEREF 0x00008000 /* file contains a section which */ 543 /* is included in the output */ 544 /* allocatable image */ 545 #define FLG_IF_GNUVER 0x00010000 /* file used GNU-style versioning */ 546 547 struct is_desc { /* input section descriptor */ 548 const char *is_name; /* the section name */ 549 const char *is_basename; /* original section name (without */ 550 /* .<sect>%<func> munging */ 551 Shdr *is_shdr; /* the elf section header */ 552 Ifl_desc *is_file; /* infile desc for this section */ 553 Os_desc *is_osdesc; /* new output section for this */ 554 /* input section */ 555 Elf_Data *is_indata; /* input sections raw data */ 556 Is_desc *is_symshndx; /* related SHT_SYM_SHNDX section */ 557 Word is_scnndx; /* original section index in file */ 558 Word is_txtndx; /* Index for section. Used to decide */ 559 /* where to insert section when */ 560 /* reordering sections */ 561 Word is_ident; /* preserved IDENT used for ordered */ 562 /* sections. */ 563 uint_t is_namehash; /* hash on section name */ 564 Half is_key; /* Used for SHF_ORDERED */ 565 Half is_flags; /* Various flags */ 566 }; 567 568 #define FLG_IS_ORDERED 0x0001 /* This is a SHF_ORDERED section */ 569 #define FLG_IS_KEY 0x0002 /* This is a section pointed by */ 570 /* sh_info of a SHF_ORDERED section */ 571 #define FLG_IS_DISCARD 0x0004 /* section is to be discarded */ 572 #define FLG_IS_RELUPD 0x0008 /* symbol defined here may have moved */ 573 #define FLG_IS_SECTREF 0x0010 /* section has been referenced */ 574 #define FLG_IS_GDATADEF 0x0020 /* section contains global data sym */ 575 #define FLG_IS_EXTERNAL 0x0040 /* isp from an user file */ 576 577 578 /* 579 * Map file and output file processing structures 580 */ 581 struct os_desc { /* Output section descriptor */ 582 const char *os_name; /* the section name */ 583 Elf_Scn *os_scn; /* the elf section descriptor */ 584 Shdr *os_shdr; /* the elf section header */ 585 Os_desc *os_relosdesc; /* the output relocation section */ 586 List os_relisdescs; /* reloc input section descriptors */ 587 /* for this output section */ 588 List os_isdescs; /* list of input sections in output */ 589 Sort_desc *os_sort; /* used for sorting sections */ 590 Sg_desc *os_sgdesc; /* segment os_desc is placed on */ 591 Elf_Data *os_outdata; /* output sections raw data */ 592 List os_comdats; /* list of COMDAT sections present */ 593 /* in current output section */ 594 Word os_scnsymndx; /* index in output symtab of section */ 595 /* symbol for this section */ 596 Word os_txtndx; /* Index for section. Used to decide */ 597 /* where to insert section when */ 598 /* reordering sections */ 599 Xword os_szoutrels; /* size of output relocation section */ 600 uint_t os_namehash; /* hash on section name */ 601 uchar_t os_flags; /* various flags */ 602 }; 603 604 #define FLG_OS_ORDER_KEY 0x01 /* include a sort key section */ 605 #define FLG_OS_OUTREL 0x02 /* output rel against this section */ 606 #define FLG_OS_SECTREF 0x04 /* isps are not affected by -zignore */ 607 608 /* 609 * For sorting sections. 610 */ 611 struct sort_desc { 612 Is_desc **st_order; 613 Word st_ordercnt; 614 Is_desc **st_before; 615 Word st_beforecnt; 616 Is_desc **st_after; 617 Word st_aftercnt; 618 }; 619 620 struct sg_desc { /* output segment descriptor */ 621 Phdr sg_phdr; /* segment header for output file */ 622 const char *sg_name; /* segment name */ 623 Xword sg_round; /* data rounding required (mapfile) */ 624 Xword sg_length; /* maximum segment length; if 0 */ 625 /* segment is not specified */ 626 Alist *sg_osdescs; /* list of output section descriptors */ 627 Alist *sg_secorder; /* list specifying section ordering */ 628 /* for the segment */ 629 Half sg_flags; 630 Sym_desc *sg_sizesym; /* size symbol for this segment */ 631 Xword sg_addralign; /* LCM of sh_addralign */ 632 Elf_Scn *sg_fscn; /* the SCN of the first section. */ 633 }; 634 635 636 #define FLG_SG_VADDR 0x0001 /* vaddr segment attribute set */ 637 #define FLG_SG_PADDR 0x0002 /* paddr segment attribute set */ 638 #define FLG_SG_LENGTH 0x0004 /* length segment attribute set */ 639 #define FLG_SG_ALIGN 0x0008 /* align segment attribute set */ 640 #define FLG_SG_ROUND 0x0010 /* round segment attribute set */ 641 #define FLG_SG_FLAGS 0x0020 /* flags segment attribute set */ 642 #define FLG_SG_TYPE 0x0040 /* type segment attribute set */ 643 #define FLG_SG_ORDER 0x0080 /* has ordering been turned on for */ 644 /* this segment. */ 645 /* i.e. ?[O] option in mapfile */ 646 #define FLG_SG_NOHDR 0x0100 /* don't map ELF or phdrs into */ 647 /* this segment */ 648 #define FLG_SG_EMPTY 0x0200 /* an empty segment specification */ 649 /* no input sections will be */ 650 /* associated to this section */ 651 #define FLG_SG_KEY 0x0400 /* include a key section */ 652 #define FLG_SG_DISABLED 0x0800 /* this segment is disabled */ 653 #define FLG_SG_PHREQ 0x1000 /* this segment requires a program */ 654 /* header */ 655 656 struct sec_order { 657 const char *sco_secname; /* section name to be ordered */ 658 Word sco_index; /* ordering index for section */ 659 Half sco_flags; 660 }; 661 662 #define FLG_SGO_USED 0x0001 /* was ordering used? */ 663 664 struct ent_desc { /* input section entrance criteria */ 665 List ec_files; /* files from which to accept */ 666 /* sections */ 667 const char *ec_name; /* name to match (NULL if none) */ 668 Word ec_type; /* section type */ 669 Word ec_attrmask; /* section attribute mask (AWX) */ 670 Word ec_attrbits; /* sections attribute bits */ 671 Sg_desc *ec_segment; /* output segment to enter if matched */ 672 Word ec_ndx; /* index to determine where section */ 673 /* meeting this criteria should */ 674 /* inserted. Used for reordering */ 675 /* of sections. */ 676 Half ec_flags; 677 }; 678 679 #define FLG_EC_USED 0x0001 /* entrance criteria met? */ 680 681 /* 682 * Move supplementary structures 683 * Sorted by symbol local/global and then by name. 684 */ 685 typedef struct psym_info { 686 Sym_desc *psym_symd; /* partially initialized symbol */ 687 Word psym_num; /* number of move entires */ 688 Half psym_flag; /* various flag */ 689 List psym_mvs; /* the list of move entries */ 690 } Psym_info; 691 692 #define FLG_PSYM_OVERLAP 0x01 /* Overlapping */ 693 694 /* 695 * One structure is allocated for a move entry. 696 */ 697 typedef struct mv_itm { 698 Xword mv_start; /* start position */ 699 Xword mv_length; /* The length of initialization */ 700 Half mv_flag; /* various flags */ 701 Is_desc *mv_isp; /* input desc. this entry is from */ 702 Move *mv_ientry; /* Input Move_entry */ 703 Word mv_oidx; /* Output Move_entry index */ 704 } Mv_itm; 705 706 #define FLG_MV_OUTSECT 0x01 /* Will be in move section */ 707 708 /* 709 * Define a move descripter used within relocation structures. 710 */ 711 struct mv_desc { 712 Move *mvd_move; 713 Sym_desc *mvd_sym; 714 }; 715 716 struct sym_desc { 717 List sd_GOTndxs; /* list of associated GOT entries */ 718 Sym *sd_sym; /* pointer to symbol table entry */ 719 Sym *sd_osym; /* copy of the original symbol entry */ 720 /* used only for local partial */ 721 Psym_info *sd_psyminfo; /* for partial symbols, maintain a */ 722 /* pointer to parsym_info */ 723 const char *sd_name; /* symbols name */ 724 Ifl_desc *sd_file; /* file where symbol is taken */ 725 Is_desc *sd_isc; /* input section of symbol definition */ 726 Sym_aux *sd_aux; /* auxiliary global symbol info. */ 727 Word sd_symndx; /* index in output symbol table */ 728 Word sd_shndx; /* sect. index sym is associated w/ */ 729 Word sd_flags; /* state flags */ 730 Half sd_flags1; /* more symbol flags */ 731 Half sd_ref; /* reference definition of symbol */ 732 }; 733 734 /* 735 * The auxiliary symbol descriptor contains the additional information (beyond 736 * the symbol descriptor) required to process global symbols. These symbols are 737 * accessed via an internal symbol hash table where locality of reference is 738 * important for performance. 739 */ 740 struct sym_aux { 741 List sa_dfiles; /* files where symbol is defined */ 742 Sym sa_sym; /* copy of symtab entry */ 743 const char *sa_vfile; /* first unavailable definition */ 744 Ifl_desc *sa_bindto; /* symbol to bind to - for translator */ 745 const char *sa_rfile; /* file with first symbol referenced */ 746 Word sa_hash; /* the pure hash value of symbol */ 747 Word sa_PLTndx; /* index into PLT for symbol */ 748 Word sa_PLTGOTndx; /* GOT entry indx for PLT indirection */ 749 Word sa_linkndx; /* index of associated symbol from */ 750 /* ET_DYN file */ 751 Half sa_symspec; /* special symbol ids */ 752 Half sa_overndx; /* output file versioning index */ 753 Half sa_dverndx; /* dependency versioning index */ 754 }; 755 756 757 /* 758 * Nodes used to track symbols in the global AVL symbol dictionary. 759 */ 760 struct sym_avlnode { 761 avl_node_t sav_node; /* AVL node */ 762 Word sav_hash; /* symbol hash value */ 763 const char *sav_name; /* symbol name */ 764 Sym_desc *sav_symdesc; /* SymDesc entry */ 765 }; 766 767 /* 768 * These are the ids for processing of `Special symbols'. They are used 769 * to set the sym->sd_aux->sa_symspec field. 770 */ 771 #define SDAUX_ID_ETEXT 1 /* etext && _etext symbol */ 772 #define SDAUX_ID_EDATA 2 /* edata && _edata symbol */ 773 #define SDAUX_ID_END 3 /* end, _end, && _END_ symbol */ 774 #define SDAUX_ID_DYN 4 /* DYNAMIC && _DYNAMIC symbol */ 775 #define SDAUX_ID_PLT 5 /* _PROCEDURE_LINKAGE_TABLE_ symbol */ 776 #define SDAUX_ID_GOT 6 /* _GLOBAL_OFFSET_TABLE_ symbol */ 777 #define SDAUX_ID_START 7 /* START_ && _START_ symbol */ 778 779 /* 780 * Flags for sym_desc.sd_flags 781 */ 782 #define FLG_SY_MVTOCOMM 0x00000001 /* assign symbol to common (.bss) */ 783 /* this is a result of a */ 784 /* copy reloc against sym */ 785 #define FLG_SY_GLOBREF 0x00000002 /* a global reference has been seen */ 786 #define FLG_SY_WEAKDEF 0x00000004 /* a weak definition has been used */ 787 #define FLG_SY_CLEAN 0x00000008 /* `Sym' entry points to original */ 788 /* input file (read-only). */ 789 #define FLG_SY_UPREQD 0x00000010 /* symbol value update is required, */ 790 /* either it's used as an entry */ 791 /* point or for relocation, but */ 792 /* it must be updated even if */ 793 /* the -s flag is in effect */ 794 #define FLG_SY_NOTAVAIL 0x00000020 /* symbol is not available to the */ 795 /* application either because it */ 796 /* originates from an implicitly */ 797 /* referenced shared object, or */ 798 /* because it is not part of a */ 799 /* specified version. */ 800 #define FLG_SY_REDUCED 0x00000040 /* a global is reduced to local */ 801 #define FLG_SY_VERSPROM 0x00000080 /* version definition has been */ 802 /* promoted to output file */ 803 #define FLG_SY_PROT 0x00000100 /* stv_protected visibility seen */ 804 805 #define FLG_SY_MAPREF 0x00000200 /* symbol reference generated by user */ 806 /* from mapfile */ 807 #define FLG_SY_REFRSD 0x00000400 /* symbols sd_ref has been raised */ 808 /* due to a copy-relocs */ 809 /* weak-strong pairing */ 810 #define FLG_SY_INTPOSE 0x00000800 /* symbol defines an interposer */ 811 #define FLG_SY_INVALID 0x00001000 /* unwanted/erroneous symbol */ 812 #define FLG_SY_SMGOT 0x00002000 /* small got index assigned to symbol */ 813 /* sparc only */ 814 #define FLG_SY_PARENT 0x00004000 /* symbol to be found in parent */ 815 /* only used with direct bindings */ 816 #define FLG_SY_LAZYLD 0x00008000 /* symbol to cause lazyloading of */ 817 /* parent object */ 818 #define FLG_SY_ISDISC 0x00010000 /* symbol is a member of a DISCARDED */ 819 /* section (COMDAT) */ 820 #define FLG_SY_PAREXPN 0x00020000 /* partially init. symbol to be */ 821 /* expanded */ 822 #define FLG_SY_PLTPAD 0x00040000 /* pltpadding has been allocated for */ 823 /* this symbol */ 824 #define FLG_SY_REGSYM 0x00080000 /* REGISTER symbol (sparc only) */ 825 #define FLG_SY_SOFOUND 0x00100000 /* compared against an SO definition */ 826 #define FLG_SY_EXTERN 0x00200000 /* symbol is external, allows -zdefs */ 827 /* error suppression */ 828 #define FLG_SY_MAPUSED 0x00400000 /* mapfile symbol used (occurred */ 829 /* within a relocatable object) */ 830 #define FLG_SY_COMMEXP 0x00800000 /* COMMON symbol which has been */ 831 /* allocated */ 832 #define FLG_SY_CMDREF 0x01000000 /* symbol was referenced from the */ 833 /* command line. (ld -u <>, */ 834 /* ld -zrtldinfo=<>, ...) */ 835 #define FLG_SY_SPECSEC 0x02000000 /* section index is reserved value */ 836 /* ABS, COMMON, ... */ 837 #define FLG_SY_TENTSYM 0x04000000 /* tentative symbol */ 838 #define FLG_SY_VISIBLE 0x08000000 /* symbols visibility determined */ 839 #define FLG_SY_STDFLTR 0x10000000 /* symbol is a standard filter */ 840 #define FLG_SY_AUXFLTR 0x20000000 /* symbol is an auxiliary filter */ 841 #define FLG_SY_DYNSORT 0x40000000 /* req. in dyn[sym|tls]sort section */ 842 #define FLG_SY_NODYNSORT 0x80000000 /* excluded from dyn[sym_tls]sort sec */ 843 844 /* 845 * Sym_desc.sd_flags1 846 */ 847 #define FLG_SY1_GLOB 0x00000001 /* global symbol, remain global */ 848 #define FLG_SY1_PROT 0x00000002 /* global symbol, reduce to protected */ 849 #define FLG_SY1_LOCL 0x00000004 /* global symbol, reduce to local */ 850 #define FLG_SY1_DIR 0x00000008 /* global symbol, direct bindings */ 851 #define FLG_SY1_NDIR 0x00000010 /* global symbol, nondirect bindings */ 852 #define FLG_SY1_ELIM 0x00000020 /* global symbol, eliminate */ 853 #define FLG_SY1_IGNORE 0x00000040 /* symbol should be ignored */ 854 855 #define MSK_SY1_DEFINED (FLG_SY1_GLOB | FLG_SY1_PROT | FLG_SY1_LOCL) 856 /* The above mask indicates that */ 857 /* a symbol has been explicitly */ 858 /* scoped, and therefore is not */ 859 /* a candidate for auto-reduction */ 860 861 /* 862 * create a mask for (Sym.St_other & visibility) since the 863 * gABI does not yet define a ELF*_ST_OTHER macro. 864 */ 865 #define MSK_SYM_VISIBILITY 0x03 866 867 /* 868 * Structure to manage the shared object definition lists. There are two lists 869 * that use this structure: 870 * 871 * o ofl_soneed; maintain the list of implicitly required dependencies 872 * (ie. shared objects needed by other shared objects). These definitions 873 * may include RPATH's required to locate the dependencies, and any 874 * version requirements. 875 * 876 * o ofl_socntl; maintains the shared object control definitions. These are 877 * provided by the user (via a mapfile) and are used to indicate any 878 * SONAME translations and verion control requirements. 879 */ 880 struct sdf_desc { 881 const char *sdf_name; /* the shared objects file name */ 882 const char *sdf_soname; /* the shared objects SONAME */ 883 char *sdf_rpath; /* library search path DT_RPATH */ 884 const char *sdf_rfile; /* referencing file for diagnostics */ 885 Ifl_desc *sdf_file; /* the final input file descriptor */ 886 List sdf_vers; /* list of versions that are required */ 887 /* from this object */ 888 List sdf_verneed; /* list of VERNEEDS to create for */ 889 /* this object (via SPECVERS or */ 890 /* ADDVERS) */ 891 Word sdf_flags; 892 }; 893 894 #define FLG_SDF_SONAME 0x02 /* An alternative SONAME is supplied */ 895 #define FLG_SDF_SELECT 0x04 /* version control selection required */ 896 #define FLG_SDF_VERIFY 0x08 /* version definition verification */ 897 /* required */ 898 #define FLG_SDF_SPECVER 0x10 /* specify VERNEEDS */ 899 #define FLG_SDF_ADDVER 0x20 /* add VERNEED references */ 900 901 /* 902 * Structure to manage shared object version usage requirements. 903 */ 904 struct sdv_desc { 905 const char *sdv_name; /* version name */ 906 const char *sdv_ref; /* versions reference */ 907 Word sdv_flags; /* flags */ 908 }; 909 910 #define FLG_SDV_MATCHED 0x01 /* VERDEF found and matched */ 911 912 /* 913 * Structures to manage versioning information. Two versioning structures are 914 * defined: 915 * 916 * o a version descriptor maintains a linked list of versions and their 917 * associated dependencies. This is used to build the version definitions 918 * for an image being created (see map_symbol), and to determine the 919 * version dependency graph for any input files that are versioned. 920 * 921 * o a version index array contains each version of an input file that is 922 * being processed. It informs us which versions are available for 923 * binding, and is used to generate any version dependency information. 924 */ 925 struct ver_desc { 926 const char *vd_name; /* version name */ 927 Word vd_hash; /* hash value of name */ 928 Ifl_desc *vd_file; /* file that defined version */ 929 Half vd_ndx; /* coordinates with symbol index */ 930 Half vd_flags; /* version information */ 931 List vd_deps; /* version dependencies */ 932 Ver_desc *vd_ref; /* dependency's first reference */ 933 }; 934 935 struct ver_index { 936 const char *vi_name; /* dependency version name */ 937 Half vi_flags; /* communicates availability */ 938 Ver_desc *vi_desc; /* cross reference to descriptor */ 939 }; 940 941 /* 942 * Define any internal version descriptor flags ([vd|vi]_flags). Note that the 943 * first byte is reserved for user visible flags (refer VER_FLG's in link.h). 944 */ 945 #define MSK_VER_USER 0x0f /* mask for user visible flags */ 946 947 #define FLG_VER_AVAIL 0x10 /* version is available for binding */ 948 #define FLG_VER_REFER 0x20 /* version has been referenced */ 949 #define FLG_VER_SELECT 0x40 /* version has been selected by user */ 950 #define FLG_VER_CYCLIC 0x80 /* a member of cyclic dependency */ 951 952 953 /* 954 * isalist(1) descriptor - used to break an isalist string into its component 955 * options. 956 */ 957 struct isa_opt { 958 char *isa_name; /* individual isa option name */ 959 size_t isa_namesz; /* and associated size */ 960 }; 961 962 struct isa_desc { 963 char *isa_list; /* sysinfo(SI_ISALIST) list */ 964 size_t isa_listsz; /* and associated size */ 965 Isa_opt *isa_opt; /* table of individual isa options */ 966 size_t isa_optno; /* and associated number */ 967 }; 968 969 /* 970 * uname(2) descriptor - used to break a utsname structure into its component 971 * options (at least those that we're interested in). 972 */ 973 struct uts_desc { 974 char *uts_osname; /* operating system name */ 975 size_t uts_osnamesz; /* and associated size */ 976 char *uts_osrel; /* operating system release */ 977 size_t uts_osrelsz; /* and associated size */ 978 }; 979 980 981 /* 982 * SHT_GROUP descriptor - used to track group sections at the global 983 * level to resolve conflicts/determine which to keep. 984 */ 985 struct group_desc { 986 const char *gd_gsectname; /* group section name */ 987 const char *gd_symname; /* symbol name */ 988 Word *gd_data; /* data for group section */ 989 size_t gd_scnndx; /* group section index */ 990 size_t gd_cnt; /* number of entries in group data */ 991 Word gd_flags; 992 }; 993 994 #define GRP_FLG_DISCARD 0x0001 /* group is to be discarded */ 995 996 /* 997 * Indexes into the ld_support_funcs[] table. 998 */ 999 typedef enum { 1000 LDS_VERSION = 0, 1001 LDS_INPUT_DONE, 1002 LDS_START, 1003 LDS_ATEXIT, 1004 LDS_OPEN, 1005 LDS_FILE, 1006 LDS_INSEC, 1007 LDS_SEC, 1008 LDS_NUM 1009 } Support_ndx; 1010 1011 1012 /* 1013 * Structure to manage archive member caching. Each archive has an archive 1014 * descriptor (Ar_desc) associated with it. This contains pointers to the 1015 * archive symbol table (obtained by elf_getarsyms(3e)) and an auxiliary 1016 * structure (Ar_uax[]) that parallels this symbol table. The member element 1017 * of this auxiliary table indicates whether the archive member associated with 1018 * the symbol offset has already been extracted (AREXTRACTED) or partially 1019 * processed (refer process_member()). 1020 */ 1021 typedef struct ar_mem { 1022 Elf *am_elf; /* elf descriptor for this member */ 1023 char *am_name; /* members name */ 1024 char *am_path; /* path (ie. lib(foo.o)) */ 1025 Sym *am_syms; /* start of global symbols */ 1026 char *am_strs; /* associated string table start */ 1027 Xword am_symn; /* no. of global symbols */ 1028 } Ar_mem; 1029 1030 typedef struct ar_aux { 1031 Sym_desc *au_syms; /* internal symbol descriptor */ 1032 Ar_mem *au_mem; /* associated member */ 1033 } Ar_aux; 1034 1035 #define FLG_ARMEM_PROC (Ar_mem *)-1 1036 1037 typedef struct ar_desc { 1038 const char *ad_name; /* archive file name */ 1039 Elf *ad_elf; /* elf descriptor for the archive */ 1040 Elf_Arsym *ad_start; /* archive symbol table start */ 1041 Ar_aux *ad_aux; /* auxiliary symbol information */ 1042 dev_t ad_stdev; /* device id and inode number for */ 1043 ino_t ad_stino; /* multiple inclusion checks */ 1044 Word ad_flags; /* archive specific cmd line flags */ 1045 } Ar_desc; 1046 1047 /* 1048 * Define any archive descriptor flags. NOTE, make sure they do not clash with 1049 * any output file descriptor archive extraction flags, as these are saved in 1050 * the same entry (see MSK_OF1_ARCHIVE). 1051 */ 1052 #define FLG_ARD_EXTRACT 0x00010000 /* archive member has been extracted */ 1053 1054 /* 1055 * Function Declarations. 1056 */ 1057 #if defined(_ELF64) 1058 1059 #define ld_create_outfile ld64_create_outfile 1060 #define ld_ent_setup ld64_ent_setup 1061 #define ld_init_strings ld64_init_strings 1062 #define ld_make_sections ld64_make_sections 1063 #define ld_main ld64_main 1064 #define ld_ofl_cleanup ld64_ofl_cleanup 1065 #define ld_process_open ld64_process_open 1066 #define ld_reloc_init ld64_reloc_init 1067 #define ld_reloc_process ld64_reloc_process 1068 #define ld_sym_validate ld64_sym_validate 1069 #define ld_update_outfile ld64_update_outfile 1070 1071 #else 1072 1073 #define ld_create_outfile ld32_create_outfile 1074 #define ld_ent_setup ld32_ent_setup 1075 #define ld_init_strings ld32_init_strings 1076 #define ld_make_sections ld32_make_sections 1077 #define ld_main ld32_main 1078 #define ld_ofl_cleanup ld32_ofl_cleanup 1079 #define ld_process_open ld32_process_open 1080 #define ld_reloc_init ld32_reloc_init 1081 #define ld_reloc_process ld32_reloc_process 1082 #define ld_sym_validate ld32_sym_validate 1083 #define ld_update_outfile ld32_update_outfile 1084 1085 #endif 1086 1087 extern int ld32_main(int, char **); 1088 extern int ld64_main(int, char **); 1089 1090 extern uintptr_t ld_create_outfile(Ofl_desc *); 1091 extern uintptr_t ld_ent_setup(Ofl_desc *, Xword); 1092 extern uintptr_t ld_init_strings(Ofl_desc *); 1093 extern uintptr_t ld_make_sections(Ofl_desc *); 1094 extern void ld_ofl_cleanup(Ofl_desc *); 1095 extern Ifl_desc *ld_process_open(const char *, const char *, int *, 1096 Ofl_desc *, Word, Rej_desc *); 1097 extern uintptr_t ld_reloc_init(Ofl_desc *); 1098 extern uintptr_t ld_reloc_process(Ofl_desc *); 1099 extern uintptr_t ld_sym_validate(Ofl_desc *); 1100 extern uintptr_t ld_update_outfile(Ofl_desc *); 1101 1102 #ifdef __cplusplus 1103 } 1104 #endif 1105 1106 #endif /* _LIBLD_H */ 1107