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 2008 Sun Microsystems, Inc. All rights reserved. 27 * Use is subject to license terms. 28 */ 29 30 #ifndef _SYS_LINK_H 31 #define _SYS_LINK_H 32 33 #ifndef _ASM 34 #include <sys/types.h> 35 #include <sys/elftypes.h> 36 #endif 37 38 #ifdef __cplusplus 39 extern "C" { 40 #endif 41 42 /* 43 * Communication structures for the runtime linker. 44 */ 45 46 /* 47 * The following data structure provides a self-identifying union consisting 48 * of a tag from a known list and a value. 49 */ 50 #ifndef _ASM 51 typedef struct { 52 Elf32_Sword d_tag; /* how to interpret value */ 53 union { 54 Elf32_Word d_val; 55 Elf32_Addr d_ptr; 56 Elf32_Off d_off; 57 } d_un; 58 } Elf32_Dyn; 59 60 #if defined(_LP64) || defined(_LONGLONG_TYPE) 61 typedef struct { 62 Elf64_Xword d_tag; /* how to interpret value */ 63 union { 64 Elf64_Xword d_val; 65 Elf64_Addr d_ptr; 66 } d_un; 67 } Elf64_Dyn; 68 #endif /* defined(_LP64) || defined(_LONGLONG_TYPE) */ 69 #endif /* _ASM */ 70 71 /* 72 * Tag values 73 */ 74 #define DT_NULL 0 /* last entry in list */ 75 #define DT_NEEDED 1 /* a needed object */ 76 #define DT_PLTRELSZ 2 /* size of relocations for the PLT */ 77 #define DT_PLTGOT 3 /* addresses used by procedure linkage table */ 78 #define DT_HASH 4 /* hash table */ 79 #define DT_STRTAB 5 /* string table */ 80 #define DT_SYMTAB 6 /* symbol table */ 81 #define DT_RELA 7 /* addr of relocation entries */ 82 #define DT_RELASZ 8 /* size of relocation table */ 83 #define DT_RELAENT 9 /* base size of relocation entry */ 84 #define DT_STRSZ 10 /* size of string table */ 85 #define DT_SYMENT 11 /* size of symbol table entry */ 86 #define DT_INIT 12 /* _init addr */ 87 #define DT_FINI 13 /* _fini addr */ 88 #define DT_SONAME 14 /* name of this shared object */ 89 #define DT_RPATH 15 /* run-time search path */ 90 #define DT_SYMBOLIC 16 /* shared object linked -Bsymbolic */ 91 #define DT_REL 17 /* addr of relocation entries */ 92 #define DT_RELSZ 18 /* size of relocation table */ 93 #define DT_RELENT 19 /* base size of relocation entry */ 94 #define DT_PLTREL 20 /* relocation type for PLT entry */ 95 #define DT_DEBUG 21 /* pointer to r_debug structure */ 96 #define DT_TEXTREL 22 /* text relocations remain for this object */ 97 #define DT_JMPREL 23 /* pointer to the PLT relocation entries */ 98 #define DT_BIND_NOW 24 /* perform all relocations at load of object */ 99 #define DT_INIT_ARRAY 25 /* pointer to .initarray */ 100 #define DT_FINI_ARRAY 26 /* pointer to .finiarray */ 101 #define DT_INIT_ARRAYSZ 27 /* size of .initarray */ 102 #define DT_FINI_ARRAYSZ 28 /* size of .finiarray */ 103 #define DT_RUNPATH 29 /* run-time search path */ 104 #define DT_FLAGS 30 /* state flags - see DF_* */ 105 106 /* 107 * DT_* encoding rules: The value of each dynamic tag determines the 108 * interpretation of the d_un union. This convention provides for simpler 109 * interpretation of dynamic tags by external tools. A tag whose value 110 * is an even number indicates a dynamic section entry that uses d_ptr. 111 * A tag whose value is an odd number indicates a dynamic section entry 112 * that uses d_val, or that uses neither d_ptr nor d_val. 113 * 114 * There are exceptions to the above rule: 115 * - Tags with values that are less than DT_ENCODING. 116 * - Tags with values that fall between DT_LOOS and DT_SUNW_ENCODING 117 * - Tags with values that fall between DT_HIOS and DT_LOPROC 118 * 119 * Third party tools must handle these exception ranges explicitly 120 * on an item by item basis. 121 */ 122 #define DT_ENCODING 32 /* positive tag DT_* encoding rules */ 123 /* start after this */ 124 #define DT_PREINIT_ARRAY 32 /* pointer to .preinitarray segment */ 125 #define DT_PREINIT_ARRAYSZ 33 /* size of .preinitarray segment */ 126 127 #define DT_MAXPOSTAGS 34 /* number of positive tags */ 128 129 /* 130 * DT_* encoding rules do not apply between DT_LOOS and DT_SUNW_ENCODING 131 */ 132 #define DT_LOOS 0x6000000d /* OS specific range */ 133 #define DT_SUNW_AUXILIARY 0x6000000d /* symbol auxiliary name */ 134 #define DT_SUNW_RTLDINF 0x6000000e /* ld.so.1 info (private) */ 135 #define DT_SUNW_FILTER 0x6000000f /* symbol filter name */ 136 #define DT_SUNW_CAP 0x60000010 /* hardware/software */ 137 /* capabilities */ 138 #define DT_SUNW_SYMTAB 0x60000011 /* symtab with local fcn */ 139 /* symbols immediately */ 140 /* preceding DT_SYMTAB */ 141 #define DT_SUNW_SYMSZ 0x60000012 /* Size of SUNW_SYMTAB table */ 142 143 /* 144 * DT_* encoding rules apply between DT_SUNW_ENCODING and DT_HIOS 145 */ 146 #define DT_SUNW_ENCODING 0x60000013 /* DT_* encoding rules resume */ 147 /* after this */ 148 #define DT_SUNW_SORTENT 0x60000013 /* sizeof [SYM|TLS]SORT entrt */ 149 #define DT_SUNW_SYMSORT 0x60000014 /* sym indices sorted by addr */ 150 #define DT_SUNW_SYMSORTSZ 0x60000015 /* size of SUNW_SYMSORT */ 151 #define DT_SUNW_TLSSORT 0x60000016 /* tls sym ndx sort by offset */ 152 #define DT_SUNW_TLSSORTSZ 0x60000017 /* size of SUNW_TLSSORT */ 153 154 #define DT_SUNW_STRPAD 0x60000019 /* # of unused bytes at the */ 155 /* end of dynstr */ 156 #define DT_SUNW_LDMACH 0x6000001b /* EM_ machine code of linker */ 157 /* that produced object */ 158 159 /* 160 * DT_* encoding rules do not apply between DT_HIOS and DT_LOPROC 161 */ 162 #define DT_HIOS 0x6ffff000 163 164 /* 165 * The following values have been deprecated and remain here to allow 166 * compatibility with older binaries. 167 */ 168 #define DT_DEPRECATED_SPARC_REGISTER 0x7000001 169 170 /* 171 * DT_* entries which fall between DT_VALRNGHI & DT_VALRNGLO use the 172 * Dyn.d_un.d_val field of the Elf*_Dyn structure. 173 */ 174 #define DT_VALRNGLO 0x6ffffd00 175 #define DT_CHECKSUM 0x6ffffdf8 /* elf checksum */ 176 #define DT_PLTPADSZ 0x6ffffdf9 /* pltpadding size */ 177 #define DT_MOVEENT 0x6ffffdfa /* move table entry size */ 178 #define DT_MOVESZ 0x6ffffdfb /* move table size */ 179 #define DT_FEATURE_1 0x6ffffdfc /* feature holder */ 180 #define DT_POSFLAG_1 0x6ffffdfd /* flags for DT_* entries, effecting */ 181 /* the following DT_* entry. */ 182 /* See DF_P1_* definitions */ 183 #define DT_SYMINSZ 0x6ffffdfe /* syminfo table size (in bytes) */ 184 #define DT_SYMINENT 0x6ffffdff /* syminfo entry size (in bytes) */ 185 #define DT_VALRNGHI 0x6ffffdff 186 187 /* 188 * DT_* entries which fall between DT_ADDRRNGHI & DT_ADDRRNGLO use the 189 * Dyn.d_un.d_ptr field of the Elf*_Dyn structure. 190 * 191 * If any adjustment is made to the ELF object after it has been 192 * built, these entries will need to be adjusted. 193 */ 194 #define DT_ADDRRNGLO 0x6ffffe00 195 #define DT_CONFIG 0x6ffffefa /* configuration information */ 196 #define DT_DEPAUDIT 0x6ffffefb /* dependency auditing */ 197 #define DT_AUDIT 0x6ffffefc /* object auditing */ 198 #define DT_PLTPAD 0x6ffffefd /* pltpadding (sparcv9) */ 199 #define DT_MOVETAB 0x6ffffefe /* move table */ 200 #define DT_SYMINFO 0x6ffffeff /* syminfo table */ 201 #define DT_ADDRRNGHI 0x6ffffeff 202 203 /* 204 * The following DT_* entries should have been assigned within one of the 205 * DT_* ranges, but existed before such ranges had been established. 206 */ 207 #define DT_VERSYM 0x6ffffff0 /* version symbol table - unused by */ 208 /* Solaris (see libld/update.c) */ 209 210 #define DT_RELACOUNT 0x6ffffff9 /* number of RELATIVE relocations */ 211 #define DT_RELCOUNT 0x6ffffffa /* number of RELATIVE relocations */ 212 #define DT_FLAGS_1 0x6ffffffb /* state flags - see DF_1_* defs */ 213 #define DT_VERDEF 0x6ffffffc /* version definition table and */ 214 #define DT_VERDEFNUM 0x6ffffffd /* associated no. of entries */ 215 #define DT_VERNEED 0x6ffffffe /* version needed table and */ 216 #define DT_VERNEEDNUM 0x6fffffff /* associated no. of entries */ 217 218 /* 219 * DT_* entries between DT_HIPROC and DT_LOPROC are reserved for processor 220 * specific semantics. 221 * 222 * DT_* encoding rules apply to all tag values larger than DT_LOPROC. 223 */ 224 #define DT_LOPROC 0x70000000 /* processor specific range */ 225 #define DT_AUXILIARY 0x7ffffffd /* shared library auxiliary name */ 226 #define DT_USED 0x7ffffffe /* ignored - same as needed */ 227 #define DT_FILTER 0x7fffffff /* shared library filter name */ 228 #define DT_HIPROC 0x7fffffff 229 230 231 /* 232 * Values for DT_FLAGS 233 */ 234 #define DF_ORIGIN 0x00000001 /* ORIGIN processing required */ 235 #define DF_SYMBOLIC 0x00000002 /* symbolic bindings in effect */ 236 #define DF_TEXTREL 0x00000004 /* text relocations remain */ 237 #define DF_BIND_NOW 0x00000008 /* process all relocations */ 238 #define DF_STATIC_TLS 0x00000010 /* obj. contains static TLS refs */ 239 240 /* 241 * Values for the DT_POSFLAG_1 .dynamic entry. 242 * These values only affect the following DT_* entry. 243 */ 244 #define DF_P1_LAZYLOAD 0x00000001 /* following object is to be */ 245 /* lazy loaded */ 246 #define DF_P1_GROUPPERM 0x00000002 /* following object's symbols are */ 247 /* not available for general */ 248 /* symbol bindings. */ 249 /* 250 * Values for the DT_FLAGS_1 .dynamic entry. 251 */ 252 #define DF_1_NOW 0x00000001 /* set RTLD_NOW for this object */ 253 #define DF_1_GLOBAL 0x00000002 /* set RTLD_GLOBAL for this object */ 254 #define DF_1_GROUP 0x00000004 /* set RTLD_GROUP for this object */ 255 #define DF_1_NODELETE 0x00000008 /* set RTLD_NODELETE for this object */ 256 #define DF_1_LOADFLTR 0x00000010 /* trigger filtee loading at runtime */ 257 #define DF_1_INITFIRST 0x00000020 /* set RTLD_INITFIRST for this object */ 258 #define DF_1_NOOPEN 0x00000040 /* set RTLD_NOOPEN for this object */ 259 #define DF_1_ORIGIN 0x00000080 /* ORIGIN processing required */ 260 #define DF_1_DIRECT 0x00000100 /* direct binding enabled */ 261 #define DF_1_TRANS 0x00000200 262 #define DF_1_INTERPOSE 0x00000400 /* object is an interposer */ 263 #define DF_1_NODEFLIB 0x00000800 /* ignore default library search path */ 264 #define DF_1_NODUMP 0x00001000 /* object can't be dldump(3x)'ed */ 265 #define DF_1_CONFALT 0x00002000 /* configuration alternative created */ 266 #define DF_1_ENDFILTEE 0x00004000 /* filtee terminates filters search */ 267 #define DF_1_DISPRELDNE 0x00008000 /* disp reloc applied at build time */ 268 #define DF_1_DISPRELPND 0x00010000 /* disp reloc applied at run-time */ 269 #define DF_1_NODIRECT 0x00020000 /* object contains symbols that */ 270 /* cannot be directly bound to */ 271 #define DF_1_IGNMULDEF 0x00040000 /* internal: krtld ignore muldefs */ 272 #define DF_1_NOKSYMS 0x00080000 /* internal: don't export object's */ 273 /* symbols via /dev/ksyms */ 274 #define DF_1_NOHDR 0x00100000 /* mapfile ?N:1st segment mapping */ 275 /* omits ELF & program headers */ 276 #define DF_1_EDITED 0x00200000 /* object has been modified since */ 277 /* being built by 'ld' */ 278 #define DF_1_NORELOC 0x00400000 /* internal: unrelocated object */ 279 #define DF_1_SYMINTPOSE 0x00800000 /* individual symbol interposers */ 280 /* exist */ 281 #define DF_1_GLOBAUDIT 0x01000000 /* establish global auditing */ 282 #define DF_1_SINGLETON 0x02000000 /* singleton symbols exist */ 283 284 /* 285 * Values set to DT_FEATURE_1 tag's d_val. 286 */ 287 #define DTF_1_PARINIT 0x00000001 /* partially initialization feature */ 288 #define DTF_1_CONFEXP 0x00000002 /* configuration file expected */ 289 290 291 /* 292 * Version structures. There are three types of version structure: 293 * 294 * o A definition of the versions within the image itself. 295 * Each version definition is assigned a unique index (starting from 296 * VER_NDX_BGNDEF) which is used to cross-reference symbols associated to 297 * the version. Each version can have one or more dependencies on other 298 * version definitions within the image. The version name, and any 299 * dependency names, are specified in the version definition auxiliary 300 * array. Version definition entries require a version symbol index table. 301 * 302 * o A version requirement on a needed dependency. Each needed entry 303 * specifies the shared object dependency (as specified in DT_NEEDED). 304 * One or more versions required from this dependency are specified in the 305 * version needed auxiliary array. 306 * 307 * o A version symbol index table. Each symbol indexes into this array 308 * to determine its version index. Index values of VER_NDX_BGNDEF or 309 * greater indicate the version definition to which a symbol is associated. 310 * (the size of a symbol index entry is recorded in the sh_info field). 311 */ 312 #ifndef _ASM 313 314 typedef struct { /* Version Definition Structure. */ 315 Elf32_Half vd_version; /* this structures version revision */ 316 Elf32_Half vd_flags; /* version information */ 317 Elf32_Half vd_ndx; /* version index */ 318 Elf32_Half vd_cnt; /* no. of associated aux entries */ 319 Elf32_Word vd_hash; /* version name hash value */ 320 Elf32_Word vd_aux; /* no. of bytes from start of this */ 321 /* verdef to verdaux array */ 322 Elf32_Word vd_next; /* no. of bytes from start of this */ 323 } Elf32_Verdef; /* verdef to next verdef entry */ 324 325 typedef struct { /* Verdef Auxiliary Structure. */ 326 Elf32_Word vda_name; /* first element defines the version */ 327 /* name. Additional entries */ 328 /* define dependency names. */ 329 Elf32_Word vda_next; /* no. of bytes from start of this */ 330 } Elf32_Verdaux; /* verdaux to next verdaux entry */ 331 332 333 typedef struct { /* Version Requirement Structure. */ 334 Elf32_Half vn_version; /* this structures version revision */ 335 Elf32_Half vn_cnt; /* no. of associated aux entries */ 336 Elf32_Word vn_file; /* name of needed dependency (file) */ 337 Elf32_Word vn_aux; /* no. of bytes from start of this */ 338 /* verneed to vernaux array */ 339 Elf32_Word vn_next; /* no. of bytes from start of this */ 340 } Elf32_Verneed; /* verneed to next verneed entry */ 341 342 typedef struct { /* Verneed Auxiliary Structure. */ 343 Elf32_Word vna_hash; /* version name hash value */ 344 Elf32_Half vna_flags; /* version information */ 345 Elf32_Half vna_other; 346 Elf32_Word vna_name; /* version name */ 347 Elf32_Word vna_next; /* no. of bytes from start of this */ 348 } Elf32_Vernaux; /* vernaux to next vernaux entry */ 349 350 typedef Elf32_Half Elf32_Versym; /* Version symbol index array */ 351 352 typedef struct { 353 Elf32_Half si_boundto; /* direct bindings - symbol bound to */ 354 Elf32_Half si_flags; /* per symbol flags */ 355 } Elf32_Syminfo; 356 357 358 #if defined(_LP64) || defined(_LONGLONG_TYPE) 359 typedef struct { 360 Elf64_Half vd_version; /* this structures version revision */ 361 Elf64_Half vd_flags; /* version information */ 362 Elf64_Half vd_ndx; /* version index */ 363 Elf64_Half vd_cnt; /* no. of associated aux entries */ 364 Elf64_Word vd_hash; /* version name hash value */ 365 Elf64_Word vd_aux; /* no. of bytes from start of this */ 366 /* verdef to verdaux array */ 367 Elf64_Word vd_next; /* no. of bytes from start of this */ 368 } Elf64_Verdef; /* verdef to next verdef entry */ 369 370 typedef struct { 371 Elf64_Word vda_name; /* first element defines the version */ 372 /* name. Additional entries */ 373 /* define dependency names. */ 374 Elf64_Word vda_next; /* no. of bytes from start of this */ 375 } Elf64_Verdaux; /* verdaux to next verdaux entry */ 376 377 typedef struct { 378 Elf64_Half vn_version; /* this structures version revision */ 379 Elf64_Half vn_cnt; /* no. of associated aux entries */ 380 Elf64_Word vn_file; /* name of needed dependency (file) */ 381 Elf64_Word vn_aux; /* no. of bytes from start of this */ 382 /* verneed to vernaux array */ 383 Elf64_Word vn_next; /* no. of bytes from start of this */ 384 } Elf64_Verneed; /* verneed to next verneed entry */ 385 386 typedef struct { 387 Elf64_Word vna_hash; /* version name hash value */ 388 Elf64_Half vna_flags; /* version information */ 389 Elf64_Half vna_other; 390 Elf64_Word vna_name; /* version name */ 391 Elf64_Word vna_next; /* no. of bytes from start of this */ 392 } Elf64_Vernaux; /* vernaux to next vernaux entry */ 393 394 typedef Elf64_Half Elf64_Versym; 395 396 typedef struct { 397 Elf64_Half si_boundto; /* direct bindings - symbol bound to */ 398 Elf64_Half si_flags; /* per symbol flags */ 399 } Elf64_Syminfo; 400 #endif /* defined(_LP64) || defined(_LONGLONG_TYPE) */ 401 402 #endif /* _ASM */ 403 404 /* 405 * Versym symbol index values. Values greater than VER_NDX_GLOBAL 406 * and less then VER_NDX_LORESERVE associate symbols with user 407 * specified version descriptors. 408 */ 409 #define VER_NDX_LOCAL 0 /* symbol is local */ 410 #define VER_NDX_GLOBAL 1 /* symbol is global and assigned to */ 411 /* the base version */ 412 #define VER_NDX_LORESERVE 0xff00 /* beginning of RESERVED entries */ 413 #define VER_NDX_ELIMINATE 0xff01 /* symbol is to be eliminated */ 414 415 /* 416 * Verdef (vd_flags) and Vernaux (vna_flags) flags values. 417 */ 418 #define VER_FLG_BASE 0x1 /* version definition of file itself */ 419 /* (Verdef only) */ 420 #define VER_FLG_WEAK 0x2 /* weak version identifier */ 421 #define VER_FLG_INFO 0x4 /* version is recorded in object for */ 422 /* informational purposes */ 423 /* (Versym reference) only. No */ 424 /* runtime verification is */ 425 /* required. (Vernaux only) */ 426 427 /* 428 * Verdef version values. 429 */ 430 #define VER_DEF_NONE 0 /* Ver_def version */ 431 #define VER_DEF_CURRENT 1 432 #define VER_DEF_NUM 2 433 434 /* 435 * Verneed version values. 436 */ 437 #define VER_NEED_NONE 0 /* Ver_need version */ 438 #define VER_NEED_CURRENT 1 439 #define VER_NEED_NUM 2 440 441 442 /* 443 * Syminfo flag values 444 */ 445 #define SYMINFO_FLG_DIRECT 0x0001 /* symbol ref has direct association */ 446 /* to object containing defn. */ 447 #define SYMINFO_FLG_PASSTHRU 0x0002 /* ignored - see SYMINFO_FLG_FILTER */ 448 #define SYMINFO_FLG_COPY 0x0004 /* symbol is a copy-reloc */ 449 #define SYMINFO_FLG_LAZYLOAD 0x0008 /* object containing defn. should be */ 450 /* lazily-loaded */ 451 #define SYMINFO_FLG_DIRECTBIND 0x0010 /* ref should be bound directly to */ 452 /* object containing defn. */ 453 #define SYMINFO_FLG_NOEXTDIRECT 0x0020 /* don't let an external reference */ 454 /* directly bind to this symbol */ 455 #define SYMINFO_FLG_FILTER 0x0002 /* symbol ref is associated to a */ 456 #define SYMINFO_FLG_AUXILIARY 0x0040 /* standard or auxiliary filter */ 457 #define SYMINFO_FLG_INTERPOSE 0x0080 /* symbol defines an interposer */ 458 459 /* 460 * Syminfo.si_boundto values. 461 */ 462 #define SYMINFO_BT_SELF 0xffff /* symbol bound to self */ 463 #define SYMINFO_BT_PARENT 0xfffe /* symbol bound to parent */ 464 #define SYMINFO_BT_NONE 0xfffd /* no special symbol binding */ 465 #define SYMINFO_BT_EXTERN 0xfffc /* symbol defined as external */ 466 #define SYMINFO_BT_LOWRESERVE 0xff00 /* beginning of reserved entries */ 467 468 /* 469 * Syminfo version values. 470 */ 471 #define SYMINFO_NONE 0 /* Syminfo version */ 472 #define SYMINFO_CURRENT 1 473 #define SYMINFO_NUM 2 474 475 476 /* 477 * Public structure defined and maintained within the runtime linker 478 */ 479 #ifndef _ASM 480 481 typedef struct link_map Link_map; 482 483 struct link_map { 484 unsigned long l_addr; /* address at which object is mapped */ 485 char *l_name; /* full name of loaded object */ 486 #ifdef _LP64 487 Elf64_Dyn *l_ld; /* dynamic structure of object */ 488 #else 489 Elf32_Dyn *l_ld; /* dynamic structure of object */ 490 #endif 491 Link_map *l_next; /* next link object */ 492 Link_map *l_prev; /* previous link object */ 493 char *l_refname; /* filters reference name */ 494 }; 495 496 #ifdef _SYSCALL32 497 typedef struct link_map32 Link_map32; 498 499 struct link_map32 { 500 Elf32_Word l_addr; 501 Elf32_Addr l_name; 502 Elf32_Addr l_ld; 503 Elf32_Addr l_next; 504 Elf32_Addr l_prev; 505 Elf32_Addr l_refname; 506 }; 507 #endif 508 509 typedef enum { 510 RT_CONSISTENT, 511 RT_ADD, 512 RT_DELETE 513 } r_state_e; 514 515 typedef enum { 516 RD_FL_NONE = 0, /* no flags */ 517 RD_FL_ODBG = (1<<0), /* old style debugger present */ 518 RD_FL_DBG = (1<<1) /* debugging enabled */ 519 } rd_flags_e; 520 521 522 523 /* 524 * Debugging events enabled inside of the runtime linker. To 525 * access these events see the librtld_db interface. 526 */ 527 typedef enum { 528 RD_NONE = 0, /* no event */ 529 RD_PREINIT, /* the Initial rendezvous before .init */ 530 RD_POSTINIT, /* the Second rendezvous after .init */ 531 RD_DLACTIVITY /* a dlopen or dlclose has happened */ 532 } rd_event_e; 533 534 struct r_debug { 535 int r_version; /* debugging info version no. */ 536 Link_map *r_map; /* address of link_map */ 537 unsigned long r_brk; /* address of update routine */ 538 r_state_e r_state; 539 unsigned long r_ldbase; /* base addr of ld.so */ 540 Link_map *r_ldsomap; /* address of ld.so.1's link map */ 541 rd_event_e r_rdevent; /* debug event */ 542 rd_flags_e r_flags; /* misc flags. */ 543 }; 544 545 #ifdef _SYSCALL32 546 struct r_debug32 { 547 Elf32_Word r_version; /* debugging info version no. */ 548 Elf32_Addr r_map; /* address of link_map */ 549 Elf32_Word r_brk; /* address of update routine */ 550 r_state_e r_state; 551 Elf32_Word r_ldbase; /* base addr of ld.so */ 552 Elf32_Addr r_ldsomap; /* address of ld.so.1's link map */ 553 rd_event_e r_rdevent; /* debug event */ 554 rd_flags_e r_flags; /* misc flags. */ 555 }; 556 #endif 557 558 559 #define R_DEBUG_VERSION 2 /* current r_debug version */ 560 #endif /* _ASM */ 561 562 /* 563 * Attribute/value structures used to bootstrap ELF-based dynamic linker. 564 */ 565 #ifndef _ASM 566 typedef struct { 567 Elf32_Sword eb_tag; /* what this one is */ 568 union { /* possible values */ 569 Elf32_Word eb_val; 570 Elf32_Addr eb_ptr; 571 Elf32_Off eb_off; 572 } eb_un; 573 } Elf32_Boot; 574 575 #if defined(_LP64) || defined(_LONGLONG_TYPE) 576 typedef struct { 577 Elf64_Xword eb_tag; /* what this one is */ 578 union { /* possible values */ 579 Elf64_Xword eb_val; 580 Elf64_Addr eb_ptr; 581 Elf64_Off eb_off; 582 } eb_un; 583 } Elf64_Boot; 584 #endif /* defined(_LP64) || defined(_LONGLONG_TYPE) */ 585 #endif /* _ASM */ 586 587 /* 588 * Attributes 589 */ 590 #define EB_NULL 0 /* (void) last entry */ 591 #define EB_DYNAMIC 1 /* (*) dynamic structure of subject */ 592 #define EB_LDSO_BASE 2 /* (caddr_t) base address of ld.so */ 593 #define EB_ARGV 3 /* (caddr_t) argument vector */ 594 #define EB_ENVP 4 /* (char **) environment strings */ 595 #define EB_AUXV 5 /* (auxv_t *) auxiliary vector */ 596 #define EB_DEVZERO 6 /* (int) fd for /dev/zero */ 597 #define EB_PAGESIZE 7 /* (int) page size */ 598 #define EB_MAX 8 /* number of "EBs" */ 599 #define EB_MAX_SIZE32 64 /* size in bytes, _ILP32 */ 600 #define EB_MAX_SIZE64 128 /* size in bytes, _LP64 */ 601 602 603 #ifndef _ASM 604 605 #ifdef __STDC__ 606 607 /* 608 * Concurrency communication structure for libc callbacks. 609 */ 610 extern void _ld_libc(void *); 611 #else /* __STDC__ */ 612 extern void _ld_libc(); 613 #endif /* __STDC__ */ 614 615 #pragma unknown_control_flow(_ld_libc) 616 #endif /* _ASM */ 617 618 #ifdef __cplusplus 619 } 620 #endif 621 622 #endif /* _SYS_LINK_H */ 623