include/sys/link.h

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