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, Version 1.0 only 6 * (the "License"). You may not use this file except in compliance 7 * with the License. 8 * 9 * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE 10 * or http://www.opensolaris.org/os/licensing. 11 * See the License for the specific language governing permissions 12 * and limitations under the License. 13 * 14 * When distributing Covered Code, include this CDDL HEADER in each 15 * file and include the License file at usr/src/OPENSOLARIS.LICENSE. 16 * If applicable, add the following below this CDDL HEADER, with the 17 * fields enclosed by brackets "[]" replaced with your own identifying 18 * information: Portions Copyright [yyyy] [name of copyright owner] 19 * 20 * CDDL HEADER END 21 */ 22 /* 23 * Copyright 2005 Sun Microsystems, Inc. All rights reserved. 24 * Use is subject to license terms. 25 */ 26 27 #ifndef _RTLD_H 28 #define _RTLD_H 29 30 #pragma ident "%Z%%M% %I% %E% SMI" 31 32 /* 33 * Global include file for the runtime linker support library. 34 */ 35 #include <time.h> 36 #include <sgs.h> 37 #include <thread.h> 38 #include <synch.h> 39 #include <machdep.h> 40 #include <sys/avl.h> 41 #include <alist.h> 42 43 #ifdef _SYSCALL32 44 #include <inttypes.h> 45 #endif 46 47 #ifdef __cplusplus 48 extern "C" { 49 #endif 50 51 52 /* 53 * Linked list of directories or filenames (built from colon separated string). 54 */ 55 typedef struct pnode { 56 const char *p_name; 57 const char *p_oname; 58 size_t p_len; 59 uint_t p_orig; 60 void *p_info; 61 struct pnode *p_next; 62 } Pnode; 63 64 typedef struct rt_map Rt_map; 65 66 /* 67 * A binding descriptor. Establishes the binding relationship between two 68 * objects, the caller (originator and the dependency (destination). 69 */ 70 typedef struct { 71 Rt_map *b_caller; /* caller (originator) of a binding */ 72 Rt_map *b_depend; /* dependency (destination) of a */ 73 /* binding */ 74 uint_t b_flags; /* relationship of caller to the */ 75 /* dependency */ 76 } Bnd_desc; 77 78 #define BND_NEEDED 0x0001 /* caller NEEDED the dependency */ 79 #define BND_REFER 0x0002 /* caller relocation references the */ 80 /* dependency */ 81 82 /* 83 * Private structure for communication between rtld_db and rtld. 84 * 85 * We must bump the version number whenever a update in one of 86 * the structures/fields that rtld_db reads is updated. This hopefully 87 * permits rtld_db implementations of the future recognize corefiles 88 * produced on older system and deal accordingly. 89 * 90 * As of version 'RTLD_DB_VERSION <= 2' the following fields 91 * were valid for core file examination (basically the public 92 * Link_map): 93 * 94 * ADDR() 95 * NAME() 96 * DYN() 97 * NEXT() 98 * PREV() 99 * 100 * Valid fields for RTLD_DB_VERSION3 101 * 102 * PATHNAME() 103 * PADSTART() 104 * PADIMLEN() 105 * MSIZE() 106 * FLAGS() 107 * FLAGS1() 108 * 109 * Valid fields for RTLD_DB_VERSION4 110 * 111 * TLSMODID() 112 * 113 * Valid fields for RTLD_DB_VERSION5 114 * 115 * Added rtld_flags & FLG_RT_RELOCED to stable flags range 116 * 117 */ 118 #define R_RTLDDB_VERSION1 1 /* base version level - used for core */ 119 /* file examination */ 120 #define R_RTLDDB_VERSION2 2 /* minor revision - not relavant for */ 121 /* core files */ 122 #define R_RTLDDB_VERSION3 3 123 #define R_RTLDDB_VERSION4 4 124 #define R_RTLDDB_VERSION5 5 125 #define R_RTLDDB_VERSION R_RTLDDB_VERSION5 /* current version */ 126 127 typedef struct rtld_db_priv { 128 struct r_debug rtd_rdebug; /* original r_debug structure */ 129 Word rtd_version; /* version no. */ 130 size_t rtd_objpad; /* padding around mmap()ed objects */ 131 List * rtd_dynlmlst; /* pointer to Dynlm_list */ 132 } Rtld_db_priv; 133 134 #ifdef _SYSCALL32 135 typedef struct rtld_db_priv32 { 136 struct r_debug32 rtd_rdebug; /* original r_debug structure */ 137 Elf32_Word rtd_version; /* version no. */ 138 Elf32_Word rtd_objpad; /* padding around mmap()ed objects */ 139 Elf32_Addr rtd_dynlmlst; /* pointer to Dynlm_list */ 140 } Rtld_db_priv32; 141 #endif /* _SYSCALL32 */ 142 143 144 /* 145 * Link map list definition. Link-maps are used to describe each loaded object. 146 * Lists of these link-maps describe the various namespaces within a process. 147 * The process executable and its dependencies are maintained on the lml_main 148 * list. The runtime linker, and its dependencies are maintained on the 149 * lml_rtld list. Additional lists can be created (see dlmopen()) for such 150 * things as auditors and their dependencies. 151 * 152 * Each link-map list maintains an Alist of one, or more, linked lists of 153 * link-maps. For backward compatibility, the lm_head/lm_tail elements are 154 * initialized to the first linked-list of link-maps: 155 * 156 * Lm_list 157 * ---------- 158 * | lm_tail | ------------------------------------ 159 * | lm_head | -------------------- | 160 * | | | Rt_map | Rt_map 161 * | | | ------ | ------ 162 * | | Alist --> | | |--> | | 163 * | | --------- | | | -- | | 164 * | lm_lists | ----> | | | | | --> | | 165 * | | |---------| | | | | | | 166 * | | | lc_head | -- ------ | ------ 167 * | | | lc_tail | ------------------ 168 * | | |---------| 169 * | lc_head | 170 * | lc_tail | 171 * |---------| 172 * 173 * Multiple link-map lists exist to support the addition of lazy loaded 174 * families, filtee families, and dlopen() families. The intent of these 175 * lists is to insure that a family of objects that are to be loaded are 176 * fully relocatable, and hence usable, before they become part of the main 177 * (al_data[0]) link-map control list. This main link-map control list is 178 * the only list in existence when control is transferred to user code. 179 * 180 * During process initialization, the dynamic executable and its non-lazy 181 * dependencies are maintained on al_data[0]. If a new object is loaded, then 182 * this object is added to the next available control list [1], typically 183 * al_data[1]. Any dependencies of this object that have not already been 184 * loaded are added to the same control list. Once all of the objects on the 185 * new control list have been successfully relocated, the objects are moved from 186 * the new control list to the highest control list to which objects of the new 187 * control list bound to, typically al_data[1] to al_data[0]. 188 * 189 * Each loading scenario can be broken down as follows: 190 * 191 * setup() - only the initial link-map control list is used: 192 * i. create al_data[0] 193 * ii. add new link-map for main on al_data[0] 194 * iii. analyze al_data[0] to add all non-lazy dependencies 195 * iv. relocate al_data[0] dependencies. 196 * 197 * dlopen() - the initiator can only be the initial link-map control list: 198 * i. create al_data[1] from caller al_data[0] 199 * ii. add new link-map for the dlopen'ed object on al_data[1] 200 * iii. analyze al_data[1] to add all non-lazy dependencies 201 * iv. relocate al_data[1] dependencies, and move to al_data[0]. 202 * 203 * filtee and lazy loading processing - the initiator can be any link-map 204 * control list that is being relocated: 205 * i. create al_data[y] from caller al_data[x] 206 * ii. add new link-map for the new object on al_data[y] 207 * iii. analyze al_data[y] to add all non-lazy dependencies 208 * iv. relocate al_data[y] dependencies, and move to al_data[x]. 209 * 210 * This Alist therefore maintains a stack of link-map control lists. The newest 211 * link-map control list can locate symbols within any of the former lists, 212 * however, control is not passed to a former list until the newest lists 213 * processing is complete. Thus, objects can't bind to new objects until they 214 * have been fully analyzed and relocated. 215 * 216 * [1] Note, additional link-map control list creation occurs after the head 217 * link-map object (typically the dynamic executable) has been relocated. This 218 * staging is required to satisfy the binding requirements of copy relocations. 219 * Copy relocations, effectively, transfer the bindings of the copied data 220 * (say _iob in libc.so.1) to the copy location (_iob in the application). 221 * Thus an object that might bind to the original copy data must be redirected 222 * to the copy reference. As the knowledge of a copy relocation having taken 223 * place is only known after relocating the application, link-map control list 224 * additions are suspended until after this relocation has completed. 225 */ 226 typedef struct { 227 Rt_map *lc_head; 228 Rt_map *lc_tail; 229 Alist *lc_now; /* pending promoted bind-now objects */ 230 uint_t lc_flags; 231 } Lm_cntl; 232 233 #define LMC_FLG_ANALYZING 0x01 /* control list is being analyzed */ 234 #define LMC_FLG_RELOCATING 0x02 /* control list is being relocated */ 235 #define LMC_FLG_REANALYZE 0x04 /* repeat analysis (established when */ 236 /* interposers are added */ 237 238 typedef struct { 239 /* 240 * BEGIN: Exposed to rtld_db - don't move, don't delete 241 */ 242 Rt_map *lm_head; /* linked list pointers to active */ 243 Rt_map *lm_tail; /* link-map list */ 244 Alist *lm_handle; /* not used by rtld_db - but spacing */ 245 /* is required for flags */ 246 Word lm_flags; 247 /* 248 * END: Exposed to rtld_db - don't move, don't delete 249 */ 250 int (*lm_peh)(); /* atexit() preexec_exit_handlers */ 251 Rt_map *lm_peh_lmp; /* and object that contributed them */ 252 Rt_map *lm_info_lmp; /* the first object with rtld_info */ 253 Alist *lm_rtldinfo; /* list of RTLDINFO tables */ 254 Audit_list *lm_alp; /* audit list descripter */ 255 avl_tree_t *lm_fpavl; /* avl tree of objects loaded */ 256 Alist *lm_lists; /* active and pending link-map lists */ 257 Word lm_tflags; /* transferable flags */ 258 int lm_obj; /* total number of objs on link-map */ 259 int lm_init; /* new obj since last init processing */ 260 int lm_lazy; /* obj with pending lazy dependencies */ 261 } Lm_list; 262 263 #ifdef _SYSCALL32 264 typedef struct { 265 /* 266 * BEGIN: Exposed to rtld_db - don't move, don't delete 267 */ 268 Elf32_Addr lm_head; 269 Elf32_Addr lm_tail; 270 Elf32_Addr lm_handle; 271 Elf32_Word lm_flags; 272 /* 273 * END: Exposed to rtld_db - don't move, don't delete 274 */ 275 Elf32_Addr lm_peh; 276 Elf32_Addr lm_peh_lmp; 277 Elf32_Addr lm_info_lmp; 278 Elf32_Addr lm_alp; 279 Elf32_Addr lm_fpavl; 280 Elf32_Addr lm_lists; 281 Elf32_Word lm_tflags; 282 int lm_obj; 283 int lm_init; 284 int lm_lazy; 285 } Lm_list32; 286 #endif /* _SYSCALL32 */ 287 288 /* 289 * Possible Link_map list flags (Lm_list.lm_flags) 290 */ 291 /* 292 * BEGIN: Exposed to rtld_db - don't move, don't delete 293 */ 294 #define LML_FLG_BASELM 0x00000001 /* primary link-map */ 295 #define LML_FLG_RTLDLM 0x00000002 /* rtld link-map */ 296 /* 297 * END: Exposed to rtld_db - don't move, don't delete 298 */ 299 #define LML_FLG_NOAUDIT 0x00000004 /* symbol auditing disabled */ 300 #define LML_FLG_PLTREL 0x00000008 /* deferred plt relocation */ 301 /* initialization */ 302 /* (ld.so.1 only) */ 303 #define LML_FLG_HOLDLOCK 0x00000010 /* hold the rtld mutex lock */ 304 #define LML_FLG_ENVIRON 0x00000020 /* environ var initialized */ 305 #define LML_FLG_INTRPOSE 0x00000040 /* interposing objs on list */ 306 #define LML_FLG_LOCAUDIT 0x00000080 /* local auditors exists for */ 307 /* this link-map list */ 308 #define LML_FLG_LOADAVAIL 0x00000100 /* load anything available */ 309 #define LML_FLG_IGNRELERR 0x00000200 /* ignore relocation errors - */ 310 /* internal for crle(1) */ 311 #define LML_FLG_DBNOTIF 0x00000400 /* binding activity going on */ 312 #define LML_FLG_BNDUNINIT 0x00000800 /* binding to a existing */ 313 /* uninit'd object */ 314 #define LML_FLG_STARTREL 0x00001000 /* relocation started */ 315 316 #define LML_FLG_TRC_LDDSTUB 0x00100000 /* identify lddstub */ 317 #define LML_FLG_TRC_ENABLE 0x00200000 /* tracing enabled (ldd) */ 318 #define LML_FLG_TRC_WARN 0x00400000 /* print warnings for undefs */ 319 #define LML_FLG_TRC_VERBOSE 0x00800000 /* verbose (versioning) trace */ 320 #define LML_FLG_TRC_SEARCH 0x01000000 /* trace search paths */ 321 #define LML_FLG_TRC_UNREF 0x02000000 /* trace unreferenced */ 322 /* dependencies */ 323 #define LML_FLG_TRC_UNUSED 0x04000000 /* trace unused dependencies */ 324 #define LML_FLG_TRC_INIT 0x08000000 /* print .init order */ 325 326 #define LML_MSK_TRC 0xfff00000 /* tracing mask */ 327 328 /* 329 * Possible Link_map transferable flags (Lm_list.lm_tflags), i.e., link-map 330 * list flags that can be propagated to any new link-map list created. 331 */ 332 #define LML_TFLG_NOLAZYLD 0x00000001 /* lazy loading disabled */ 333 #define LML_TFLG_NODIRECT 0x00000002 /* direct bindings disabled */ 334 335 #define LML_TFLG_LOADFLTR 0x00000008 /* trigger filtee loading */ 336 337 #define LML_TFLG_AUD_PREINIT 0x00100000 /* preinit (audit) exists */ 338 #define LML_TFLG_AUD_OBJSEARCH 0x00200000 /* objsearch (audit) exists */ 339 #define LML_TFLG_AUD_OBJOPEN 0x00400000 /* objopen (audit) exists */ 340 #define LML_TFLG_AUD_OBJFILTER 0x00800000 /* objfilter (audit) exists */ 341 #define LML_TFLG_AUD_OBJCLOSE 0x01000000 /* objclose (audit) exists */ 342 #define LML_TFLG_AUD_SYMBIND 0x02000000 /* symbind (audit) exists */ 343 #define LML_TFLG_AUD_PLTENTER 0x04000000 /* pltenter (audit) exists */ 344 #define LML_TFLG_AUD_PLTEXIT 0x08000000 /* pltexit (audit) exists */ 345 #define LML_TFLG_AUD_ACTIVITY 0x10000000 /* activity (audit) exists */ 346 347 /* 348 * NOTE: Audit flags have duplicated FLAGS1() values. If more audit flags are 349 * added, update the FLAGS1() reservation FL1_AUD_RS_STR to FL1_AUD_RS_END 350 * defined later. 351 */ 352 #define LML_TFLG_AUD_MASK 0xfff00000 /* audit interfaces mask */ 353 354 355 /* 356 * Information for dlopen(), dlsym(), and dlclose() on libraries linked by rtld. 357 * Each shared object referred from a dlopen call has an associated group 358 * handle structure returned that describes a group of one or more objects. 359 */ 360 typedef struct { 361 Alist * gh_depends; /* handle dependency list */ 362 Rt_map * gh_owner; /* handle owner and the link-map */ 363 uint_t gh_refcnt; /* handle reference count */ 364 uint_t gh_flags; /* handle flags */ 365 } Grp_hdl; 366 367 #define GPH_ZERO 0x0001 /* special handle for dlopen(0) */ 368 #define GPH_LDSO 0x0002 /* special handle for ld.so.1 */ 369 #define GPH_FIRST 0x0004 /* dlsym() can only use originating */ 370 /* dependency */ 371 #define GPH_PARENT 0x0008 /* assign caller as a parent */ 372 #define GPH_FILTEE 0x0010 /* handle used to specify a filtee */ 373 #define GPH_INITIAL 0x0020 /* handle is initialized */ 374 #define GPH_STICKY 0x0040 /* handle is unreferenced, but should */ 375 /* not trigger object removal */ 376 377 /* 378 * A group descriptor. A group handle (Grp_hdl) refers to a group of objects, 379 * each object, and its relationship to the handle, is maintained within a 380 * group descriptor. 381 */ 382 typedef struct { 383 Rt_map * gd_depend; /* dependency */ 384 uint_t gd_flags; /* dependency flags */ 385 } Grp_desc; 386 387 #define GPD_AVAIL 0x0001 /* dependency available to dlsym() */ 388 #define GPD_ADDEPS 0x0002 /* dependencies of this dependency */ 389 /* should be added to handle */ 390 #define GPD_PARENT 0x0004 /* dependency is a parent */ 391 #define GPD_FILTER 0x0008 /* dependency is our filter */ 392 #define GPD_REMOVE 0x1000 /* descriptor is a candidate for */ 393 /* removal from the group */ 394 395 /* 396 * Define threading structures. For compatibility with libthread (T1_VERSION 1 397 * and TI_VERSION 2) our locking structure is sufficient to hold a mutex or a 398 * readers/writers lock. 399 */ 400 typedef struct { 401 union { 402 mutex_t l_mutex; 403 rwlock_t l_rwlock; 404 } u; 405 } Rt_lock; 406 407 typedef cond_t Rt_cond; 408 409 /* 410 * Define a dynamic section information descriptor. This parallels the entries 411 * in the .dynamic section and holds auxiliary information to implement lazy 412 * loading and filtee processing. 413 */ 414 typedef struct { 415 uint_t di_flags; 416 void *di_info; 417 } Dyninfo; 418 419 #define FLG_DI_STDFLTR 0x00001 /* .dynamic entry for DT_FILTER */ 420 #define FLG_DI_AUXFLTR 0x00002 /* .dynamic entry for DT_AUXILIARY */ 421 #define FLG_DI_SYMFLTR 0x00004 /* .dynamic entry for DT_SYMFILTER */ 422 /* and DT_SYMAUXILIARY */ 423 #define MSK_DI_FILTER 0x0000f /* mask for all filter possibilities */ 424 425 #define FLG_DI_NEEDED 0x00010 /* entry represents a dependency */ 426 #define FLG_DI_GROUP 0x00020 /* open dependency as a group */ 427 #define FLG_DI_PROCESSD 0x00040 /* entry has been processed */ 428 429 /* 430 * Data Structure to track AVL tree for pathnames of objects 431 * loaded into memory 432 */ 433 typedef struct { 434 const char *fpn_name; /* object name */ 435 Rt_map *fpn_lmp; /* object link-map */ 436 avl_node_t fpn_avl; /* avl book-keeping (see SGSOFFSETOF) */ 437 uint_t fpn_hash; /* object name hash value */ 438 } FullpathNode; 439 440 /* 441 * Define a mapping structure, which is maintained to describe each mapping 442 * of an object, ie. the text segment, data segment, bss segment, etc. 443 */ 444 typedef struct { 445 caddr_t m_vaddr; /* mapping address */ 446 size_t m_fsize; /* backing file size */ 447 size_t m_msize; /* mapping size */ 448 int m_perm; /* mapping permissions */ 449 } Mmap; 450 451 /* 452 * Link-map definition. 453 */ 454 struct rt_map { 455 /* 456 * BEGIN: Exposed to rtld_db - don't move, don't delete 457 */ 458 Link_map rt_public; /* public data */ 459 char *rt_pathname; /* full pathname of loaded object */ 460 ulong_t rt_padstart; /* start of image (including padding) */ 461 ulong_t rt_padimlen; /* size of image (including padding */ 462 ulong_t rt_msize; /* total memory mapped */ 463 uint_t rt_flags; /* state flags, see FLG below */ 464 uint_t rt_flags1; /* state flags1, see FL1 below */ 465 ulong_t rt_tlsmodid; /* TLS module id */ 466 /* 467 * END: Exposed to rtld_db - don't move, don't delete 468 */ 469 Alist *rt_alias; /* list of linked file names */ 470 Alist *rt_fpnode; /* list of FullpathNode AVL nodes */ 471 void (*rt_init)(); /* address of _init */ 472 void (*rt_fini)(); /* address of _fini */ 473 char *rt_runpath; /* LD_RUN_PATH and its equivalent */ 474 Pnode *rt_runlist; /* Pnode structures */ 475 Alist *rt_depends; /* list of dependencies */ 476 Alist *rt_callers; /* list of callers */ 477 Alist *rt_handles; /* dlopen handles */ 478 Alist *rt_groups; /* groups we're a member of */ 479 ulong_t rt_etext; /* etext address */ 480 struct fct *rt_fct; /* file class table for this object */ 481 Sym *(*rt_symintp)(); /* link map symbol interpreter */ 482 void *rt_priv; /* private data, object type specific */ 483 Lm_list *rt_list; /* link map list we belong to */ 484 uint_t rt_objfltrndx; /* object filtees .dynamic index */ 485 uint_t rt_symsfltrcnt; /* number of standard symbol filtees */ 486 uint_t rt_symafltrcnt; /* number of auxiliary symbol filtees */ 487 int rt_mode; /* usage mode, see RTLD mode flags */ 488 uint_t rt_sortval; /* temporary buffer to traverse graph */ 489 uint_t rt_cycgroup; /* cyclic group */ 490 dev_t rt_stdev; /* device id and inode number for .so */ 491 ino_t rt_stino; /* multiple inclusion checks */ 492 char *rt_origname; /* original pathname of loaded object */ 493 size_t rt_dirsz; /* and its size */ 494 Alist *rt_copy; /* list of copy relocations */ 495 Audit_desc *rt_auditors; /* audit descriptor array */ 496 Audit_info *rt_audinfo; /* audit information descriptor */ 497 Syminfo *rt_syminfo; /* elf .syminfo section - here */ 498 /* because it is checked in */ 499 /* common code */ 500 Addr *rt_initarray; /* .initarray table */ 501 Addr *rt_finiarray; /* .finiarray table */ 502 Addr *rt_preinitarray; /* .preinitarray table */ 503 Mmap *rt_mmaps; /* array of mapping information */ 504 uint_t rt_mmapcnt; /* and associated number */ 505 uint_t rt_initarraysz; /* size of .initarray table */ 506 uint_t rt_finiarraysz; /* size of .finiarray table */ 507 uint_t rt_preinitarraysz; /* size of .preinitarray table */ 508 Dyninfo *rt_dyninfo; /* .dynamic information descriptors */ 509 uint_t rt_dyninfocnt; /* count of dyninfo entries */ 510 uint_t rt_relacount; /* no. of RELATIVE relocations */ 511 uint_t rt_idx; /* hold index within linkmap list */ 512 uint_t rt_lazy; /* lazy dependencies pending */ 513 Rt_cond *rt_condvar; /* variables */ 514 Xword rt_hwcap; /* hardware capabilities */ 515 Xword rt_sfcap; /* software capabilities */ 516 thread_t rt_threadid; /* thread init/fini synchronization */ 517 uint_t rt_cntl; /* link-map control list we belong to */ 518 }; 519 520 521 #ifdef _SYSCALL32 522 /* 523 * Structure to allow 64-bit rtld_db to read 32-bit processes out of procfs. 524 */ 525 typedef struct rt_map32 { 526 /* 527 * BEGIN: Exposed to rtld_db - don't move, don't delete 528 */ 529 Link_map32 rt_public; 530 uint32_t rt_pathname; 531 uint32_t rt_padstart; 532 uint32_t rt_padimlen; 533 uint32_t rt_msize; 534 uint32_t rt_flags; 535 uint32_t rt_flags1; 536 uint32_t rt_tlsmodid; 537 /* 538 * END: Exposed to rtld_db - don't move, don't delete 539 */ 540 uint32_t rt_alias; 541 uint32_t rt_fpnode; 542 uint32_t rt_init; 543 uint32_t rt_fini; 544 uint32_t rt_runpath; 545 uint32_t rt_runlist; 546 uint32_t rt_depends; 547 uint32_t rt_callers; 548 uint32_t rt_handles; 549 uint32_t rt_groups; 550 uint32_t rt_etext; 551 uint32_t rt_fct; 552 uint32_t rt_symintp; 553 uint32_t rt_priv; 554 uint32_t rt_list; 555 uint32_t rt_objfltrndx; 556 uint32_t rt_symsfltrcnt; 557 uint32_t rt_symafltrcnt; 558 uint32_t rt_mode; 559 uint32_t rt_sortval; 560 uint32_t rt_cycgroup; 561 uint32_t rt_stdev; 562 uint32_t rt_stino; 563 uint32_t rt_origname; 564 uint32_t rt_dirsz; 565 uint32_t rt_copy; 566 uint32_t rt_auditors; 567 uint32_t rt_audinfo; 568 uint32_t rt_syminfo; 569 uint32_t rt_initarray; 570 uint32_t rt_finiarray; 571 uint32_t rt_preinitarray; 572 uint32_t rt_mmaps; 573 uint32_t rt_mmapcnt; 574 uint32_t rt_initarraysz; 575 uint32_t rt_finiarraysz; 576 uint32_t rt_preinitarraysz; 577 uint32_t rt_dyninfo; 578 uint32_t rt_dyninfocnt; 579 uint32_t rt_relacount; 580 uint32_t rt_idx; 581 uint32_t rt_lazy; 582 uint32_t rt_condvar; 583 uint32_t rt_hwcap; 584 uint32_t rt_sfcap; 585 uint32_t rt_threadid; 586 uint32_t rt_cntl; 587 } Rt_map32; 588 589 #endif /* _SYSCALL32 */ 590 591 /* 592 * Link map state flags. 593 */ 594 /* 595 * BEGIN: Exposed to rtld_db - don't move, don't delete 596 */ 597 #define FLG_RT_ISMAIN 0x00000001 /* object represents main executable */ 598 #define FLG_RT_IMGALLOC 0x00000002 /* image is allocated (not mmap'ed) */ 599 /* 600 * Available for r_debug version >= RTLD_DB_VERSION5 601 */ 602 #define FLG_RT_RELOCED 0x00000004 /* object has been relocated */ 603 /* 604 * END: Exposed to rtld_db - don't move, don't delete 605 */ 606 #define FLG_RT_SETGROUP 0x00000008 /* group establishment required */ 607 #define FLG_RT_HWCAP 0x00000010 /* process $HWCAP expansion */ 608 #define FLG_RT_OBJECT 0x00000020 /* object processing (ie. .o's) */ 609 610 #define FLG_RT_NODUMP 0x00000080 /* object can't be dldump(3x)'ed */ 611 #define FLG_RT_DELETE 0x00000100 /* object can be deleted */ 612 #define FLG_RT_ANALYZED 0x00000200 /* object has been analyzed */ 613 #define FLG_RT_INITDONE 0x00000400 /* objects .init has been completed */ 614 #define FLG_RT_TRANS 0x00000800 /* object is acting as a translator */ 615 #define FLG_RT_FIXED 0x00001000 /* image location is fixed */ 616 #define FLG_RT_PRELOAD 0x00002000 /* object was preloaded */ 617 #define FLG_RT_ALTER 0x00004000 /* alternative object used */ 618 #define FLG_RT_LOADFLTR 0x00008000 /* trigger filtee loading */ 619 #define FLG_RT_AUDIT 0x00010000 /* object is an auditor */ 620 #define FLG_RT_MODESET 0x00020000 /* MODE() has been initialized */ 621 #define FLG_RT_ANALZING 0x00040000 /* object is being analyzed */ 622 #define FLG_RT_INITFRST 0x00080000 /* execute .init first */ 623 #define FLG_RT_NOOPEN 0x00100000 /* dlopen() not allowed */ 624 #define FLG_RT_FINICLCT 0x00200000 /* fini has been collected (tsort) */ 625 #define FLG_RT_INITCALL 0x00400000 /* objects .init has been called */ 626 #define FLG_RT_INTRPOSE 0x00800000 /* object is an INTERPOSER */ 627 #define FLG_RT_DIRECT 0x01000000 /* object has DIRECT bindings enabled */ 628 #define FLG_RT_SUNWBSS 0x02000000 /* object with PT_SUNWBSS, not mapped */ 629 #define FLG_RT_MOVE 0x04000000 /* object needs move operation */ 630 #define FLG_RT_DLSYM 0x08000000 /* dlsym in progress on object */ 631 #define FLG_RT_REGSYMS 0x10000000 /* object has DT_REGISTER entries */ 632 #define FLG_RT_INITCLCT 0x20000000 /* init has been collected (tsort) */ 633 #define FLG_RT_HANDLE 0x40000000 /* generate a handle for this object */ 634 #define FLG_RT_RELOCING 0x80000000 /* object is being relocated */ 635 636 #define FL1_RT_COPYTOOK 0x00000001 /* copy relocation taken */ 637 #define FL1_RT_RELATIVE 0x00000002 /* relative path expansion required */ 638 #define FL1_RT_CONFSET 0x00000004 /* object was loaded by crle(1) */ 639 #define FL1_RT_NODEFLIB 0x00000008 /* ignore default library search */ 640 #define FL1_RT_ENDFILTE 0x00000010 /* filtee terminates filters search */ 641 #define FL1_RT_DISPREL 0x00000020 /* object has *disp* relocation */ 642 #define FL1_RT_TEXTREL 0x00000040 /* DT_TEXTREL set in object */ 643 #define FL1_RT_INITWAIT 0x00000080 /* threads are waiting on .init */ 644 #define FL1_RT_LDDSTUB 0x00000100 /* identify lddstub */ 645 #define FL1_RT_NOINIFIN 0x00000200 /* no .init or .fini exists */ 646 #define FL1_RT_USED 0x00000400 /* symbol referenced from this object */ 647 #define FL1_RT_SYMBOLIC 0x00000800 /* DF_SYMBOLIC was set - use */ 648 /* symbolic sym resolution */ 649 #define FL1_RT_OBJSFLTR 0x00001000 /* object is acting as a standard */ 650 #define FL1_RT_OBJAFLTR 0x00002000 /* or auxiliary filter */ 651 #define FL1_RT_SYMSFLTR 0x00004000 /* symbol is acting as a standard */ 652 #define FL1_RT_SYMAFLTR 0x00008000 /* or auxiliary filter */ 653 #define MSK_RT_FILTER 0x0000f000 /* mask for all filter possibilites */ 654 655 /* 656 * The following range of bits are reserved to hold LML_TFLG_AUD_ values 657 * (although the definitions themselves aren't used anywhere). 658 */ 659 #define FL1_AUD_RS_STR 0x00100000 /* RESERVATION start for AU flags */ 660 #define FL1_AUD_RS_END 0x80000000 /* RESERVATION end for AU flags */ 661 662 663 /* 664 * Flags for the tls_modactivity() routine 665 */ 666 #define TM_FLG_MODADD 0x01 /* call tls_modadd() interface */ 667 #define TM_FLG_MODREM 0x02 /* call tls_modrem() interface */ 668 669 /* 670 * Macros for getting to link_map data. 671 */ 672 #define ADDR(X) ((X)->rt_public.l_addr) 673 #define NAME(X) ((X)->rt_public.l_name) 674 #define DYN(X) ((X)->rt_public.l_ld) 675 #define NEXT(X) ((X)->rt_public.l_next) 676 #define PREV(X) ((X)->rt_public.l_prev) 677 #define REFNAME(X) ((X)->rt_public.l_refname) 678 679 /* 680 * Macros for getting to linker private data. 681 */ 682 #define PATHNAME(X) ((X)->rt_pathname) 683 #define PADSTART(X) ((X)->rt_padstart) 684 #define PADIMLEN(X) ((X)->rt_padimlen) 685 #define MSIZE(X) ((X)->rt_msize) 686 #define FLAGS(X) ((X)->rt_flags) 687 #define FLAGS1(X) ((X)->rt_flags1) 688 #define TLSMODID(X) ((X)->rt_tlsmodid) 689 690 #define ALIAS(X) ((X)->rt_alias) 691 #define FPNODE(X) ((X)->rt_fpnode) 692 #define INIT(X) ((X)->rt_init) 693 #define FINI(X) ((X)->rt_fini) 694 #define RPATH(X) ((X)->rt_runpath) 695 #define RLIST(X) ((X)->rt_runlist) 696 #define DEPENDS(X) ((X)->rt_depends) 697 #define CALLERS(X) ((X)->rt_callers) 698 #define HANDLES(X) ((X)->rt_handles) 699 #define GROUPS(X) ((X)->rt_groups) 700 #define ETEXT(X) ((X)->rt_etext) 701 #define FCT(X) ((X)->rt_fct) 702 #define SYMINTP(X) ((X)->rt_symintp) 703 #define LIST(X) ((X)->rt_list) 704 #define OBJFLTRNDX(X) ((X)->rt_objfltrndx) 705 #define SYMSFLTRCNT(X) ((X)->rt_symsfltrcnt) 706 #define SYMAFLTRCNT(X) ((X)->rt_symafltrcnt) 707 #define MODE(X) ((X)->rt_mode) 708 #define SORTVAL(X) ((X)->rt_sortval) 709 #define CYCGROUP(X) ((X)->rt_cycgroup) 710 #define STDEV(X) ((X)->rt_stdev) 711 #define STINO(X) ((X)->rt_stino) 712 #define ORIGNAME(X) ((X)->rt_origname) 713 #define DIRSZ(X) ((X)->rt_dirsz) 714 #define COPY(X) ((X)->rt_copy) 715 #define AUDITORS(X) ((X)->rt_auditors) 716 #define AUDINFO(X) ((X)->rt_audinfo) 717 #define SYMINFO(X) ((X)->rt_syminfo) 718 #define INITARRAY(X) ((X)->rt_initarray) 719 #define FINIARRAY(X) ((X)->rt_finiarray) 720 #define PREINITARRAY(X) ((X)->rt_preinitarray) 721 #define MMAPS(X) ((X)->rt_mmaps) 722 #define MMAPCNT(X) ((X)->rt_mmapcnt) 723 #define INITARRAYSZ(X) ((X)->rt_initarraysz) 724 #define FINIARRAYSZ(X) ((X)->rt_finiarraysz) 725 #define PREINITARRAYSZ(X) ((X)->rt_preinitarraysz) 726 #define DYNINFO(X) ((X)->rt_dyninfo) 727 #define DYNINFOCNT(X) ((X)->rt_dyninfocnt) 728 #define RELACOUNT(X) ((X)->rt_relacount) 729 #define IDX(X) ((X)->rt_idx) 730 #define LAZY(X) ((X)->rt_lazy) 731 #define CONDVAR(X) ((X)->rt_condvar) 732 #define CNTL(X) ((X)->rt_cntl) 733 #define HWCAP(X) ((X)->rt_hwcap) 734 #define SFCAP(X) ((X)->rt_sfcap) 735 #define THREADID(X) ((X)->rt_threadid) 736 737 738 /* 739 * Flags for lookup_sym (and hence find_sym) routines. 740 */ 741 #define LKUP_DEFT 0x0000 /* simple lookup request */ 742 #define LKUP_SPEC 0x0001 /* special ELF lookup (allows address */ 743 /* resolutions to plt[] entries) */ 744 #define LKUP_LDOT 0x0002 /* indicates the original A_OUT */ 745 /* symbol had a leading `.' */ 746 #define LKUP_FIRST 0x0004 /* lookup symbol in first link map */ 747 /* only */ 748 #define LKUP_COPY 0x0008 /* lookup symbol for a COPY reloc, do */ 749 /* not bind to symbol at head */ 750 #define LKUP_ALLCNTLIST 0x0010 /* lookup symbol in all control lists */ 751 #define LKUP_SELF 0x0020 /* lookup symbol in ourself - undef */ 752 /* is valid */ 753 #define LKUP_WEAK 0x0040 /* relocation reference is weak */ 754 #define LKUP_NEXT 0x0080 /* request originates from RTLD_NEXT */ 755 #define LKUP_NODESCENT 0x0100 /* don't descend through dependencies */ 756 #define LKUP_NOFALBACK 0x0200 /* don't fall back to loading */ 757 /* pending lazy dependencies */ 758 #define LKUP_DIRECT 0x0400 /* direct binding request */ 759 760 /* 761 * Data structure for calling lookup_sym() 762 */ 763 typedef struct { 764 const char *sl_name; /* symbol name */ 765 Rt_map *sl_cmap; /* callers link-map */ 766 Rt_map *sl_imap; /* initial link-map to search */ 767 ulong_t sl_hash; /* symbol hash value */ 768 ulong_t sl_rsymndx; /* referencing reloc symndx */ 769 uint_t sl_flags; /* lookup flags */ 770 } Slookup; 771 772 773 typedef enum { 774 PLT_T_NONE = 0, 775 PLT_T_21D, 776 PLT_T_24D, 777 PLT_T_U32, 778 PLT_T_U44, 779 PLT_T_FULL, 780 PLT_T_FAR, 781 PLT_T_NUM /* Must be last */ 782 } Pltbindtype; 783 784 /* 785 * Prototypes. 786 */ 787 extern Lm_list lml_main; /* main's link map list */ 788 extern Lm_list lml_rtld; /* rtld's link map list */ 789 extern Lm_list *lml_list[]; 790 791 extern int do_reloc(uchar_t, uchar_t *, Xword *, const char *, 792 const char *); 793 extern Pltbindtype elf_plt_write(uintptr_t, uintptr_t, void *, uintptr_t, 794 Xword); 795 extern void eprintf(Error, const char *, ...); 796 extern Rt_map *is_so_loaded(Lm_list *, const char *, int); 797 extern Sym *lookup_sym(Slookup *, Rt_map **, uint_t *); 798 extern int rt_dldump(Rt_map *, const char *, int, Addr); 799 800 #ifdef __cplusplus 801 } 802 #endif 803 804 #endif /* _RTLD_H */ 805