usr/src/uts/common/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 #define DT_SUNW_KMOD            0x60000027      /* object is a kernel module */
 165
 166 /*
 167  * DT_* encoding rules do not apply between DT_HIOS and DT_LOPROC
 168  */
 169 #define DT_HIOS                 0x6ffff000
 170
 171 /*
 172  * The following values have been deprecated and remain here to allow
 173  * compatibility with older binaries.
 174  */
 175 #define DT_DEPRECATED_SPARC_REGISTER    0x7000001
 176
 177 /*
 178  * DT_* entries which fall between DT_VALRNGHI & DT_VALRNGLO use the
 179  * Dyn.d_un.d_val field of the Elf*_Dyn structure.
 180  */
 181 #define DT_VALRNGLO     0x6ffffd00
 182
 183 #define DT_GNU_PRELINKED 0x6ffffdf5     /* prelinking timestamp (unused) */
 184 #define DT_GNU_CONFLICTSZ 0x6ffffdf6    /* size of conflict section (unused) */
 185 #define DT_GNU_LIBLISTSZ 0x6ffffdf7     /* size of library list (unused) */
 186 #define DT_CHECKSUM     0x6ffffdf8      /* elf checksum */
 187 #define DT_PLTPADSZ     0x6ffffdf9      /* pltpadding size */
 188 #define DT_MOVEENT      0x6ffffdfa      /* move table entry size */
 189 #define DT_MOVESZ       0x6ffffdfb      /* move table size */
 190 #define DT_FEATURE_1    0x6ffffdfc      /* feature holder (unused) */
 191 #define DT_POSFLAG_1    0x6ffffdfd      /* flags for DT_* entries, effecting */
 192                                         /*      the following DT_* entry. */
 193                                         /*      See DF_P1_* definitions */
 194 #define DT_SYMINSZ      0x6ffffdfe      /* syminfo table size (in bytes) */
 195 #define DT_SYMINENT     0x6ffffdff      /* syminfo entry size (in bytes) */
 196 #define DT_VALRNGHI     0x6ffffdff
 197
 198 /*
 199  * DT_* entries which fall between DT_ADDRRNGHI & DT_ADDRRNGLO use the
 200  * Dyn.d_un.d_ptr field of the Elf*_Dyn structure.
 201  *
 202  * If any adjustment is made to the ELF object after it has been
 203  * built, these entries will need to be adjusted.
 204  */
 205 #define DT_ADDRRNGLO    0x6ffffe00
 206
 207 #define DT_GNU_HASH     0x6ffffef5      /* GNU-style hash table (unused) */
 208 #define DT_TLSDESC_PLT  0x6ffffef6      /* GNU (unused) */
 209 #define DT_TLSDESC_GOT  0x6ffffef7      /* GNU (unused) */
 210 #define DT_GNU_CONFLICT 0x6ffffef8      /* start of conflict section (unused) */
 211 #define DT_GNU_LIBLIST  0x6ffffef9      /* Library list (unused) */
 212
 213 #define DT_CONFIG       0x6ffffefa      /* configuration information */
 214 #define DT_DEPAUDIT     0x6ffffefb      /* dependency auditing */
 215 #define DT_AUDIT        0x6ffffefc      /* object auditing */
 216 #define DT_PLTPAD       0x6ffffefd      /* pltpadding (sparcv9) */
 217 #define DT_MOVETAB      0x6ffffefe      /* move table */
 218 #define DT_SYMINFO      0x6ffffeff      /* syminfo table */
 219 #define DT_ADDRRNGHI    0x6ffffeff
 220
 221 /*
 222  * The following DT_* entries should have been assigned within one of the
 223  * DT_* ranges, but existed before such ranges had been established.
 224  */
 225 #define DT_VERSYM       0x6ffffff0      /* version symbol table - unused by */
 226                                         /*      Solaris (see libld/update.c) */
 227
 228 #define DT_RELACOUNT    0x6ffffff9      /* number of RELATIVE relocations */
 229 #define DT_RELCOUNT     0x6ffffffa      /* number of RELATIVE relocations */
 230 #define DT_FLAGS_1      0x6ffffffb      /* state flags - see DF_1_* defs */
 231 #define DT_VERDEF       0x6ffffffc      /* version definition table and */
 232 #define DT_VERDEFNUM    0x6ffffffd      /*      associated no. of entries */
 233 #define DT_VERNEED      0x6ffffffe      /* version needed table and */
 234 #define DT_VERNEEDNUM   0x6fffffff      /*      associated no. of entries */
 235
 236 /*
 237  * DT_* entries between DT_HIPROC and DT_LOPROC are reserved for processor
 238  * specific semantics.
 239  *
 240  * DT_* encoding rules apply to all tag values larger than DT_LOPROC.
 241  */
 242 #define DT_LOPROC       0x70000000      /* processor specific range */
 243 #define DT_AUXILIARY    0x7ffffffd      /* shared library auxiliary name */
 244 #define DT_USED         0x7ffffffe      /* ignored - same as needed */
 245 #define DT_FILTER       0x7fffffff      /* shared library filter name */
 246 #define DT_HIPROC       0x7fffffff
 247
 248
 249 /*
 250  * Values for DT_FLAGS
 251  */
 252 #define DF_ORIGIN       0x00000001      /* ORIGIN processing required */
 253 #define DF_SYMBOLIC     0x00000002      /* symbolic bindings in effect */
 254 #define DF_TEXTREL      0x00000004      /* text relocations remain */
 255 #define DF_BIND_NOW     0x00000008      /* process all relocations */
 256 #define DF_STATIC_TLS   0x00000010      /* obj. contains static TLS refs */
 257
 258 /*
 259  * Values for the DT_POSFLAG_1 .dynamic entry.
 260  * These values only affect the following DT_* entry.
 261  */
 262 #define DF_P1_LAZYLOAD  0x00000001      /* following object is to be */
 263                                         /*      lazy loaded */
 264 #define DF_P1_GROUPPERM 0x00000002      /* following object's symbols are */
 265                                         /*      not available for general */
 266                                         /*      symbol bindings. */
 267 #define DF_P1_DEFERRED  0x00000004      /* following object is deferred */
 268
 269 /*
 270  * Values for the DT_FLAGS_1 .dynamic entry.
 271  */
 272 #define DF_1_NOW        0x00000001      /* set RTLD_NOW for this object */
 273 #define DF_1_GLOBAL     0x00000002      /* set RTLD_GLOBAL for this object */
 274 #define DF_1_GROUP      0x00000004      /* set RTLD_GROUP for this object */
 275 #define DF_1_NODELETE   0x00000008      /* set RTLD_NODELETE for this object */
 276 #define DF_1_LOADFLTR   0x00000010      /* trigger filtee loading at runtime */
 277 #define DF_1_INITFIRST  0x00000020      /* set RTLD_INITFIRST for this object */
 278 #define DF_1_NOOPEN     0x00000040      /* set RTLD_NOOPEN for this object */
 279 #define DF_1_ORIGIN     0x00000080      /* ORIGIN processing required */
 280 #define DF_1_DIRECT     0x00000100      /* direct binding enabled */
 281 #define DF_1_TRANS      0x00000200      /* unused obsolete name */
 282 #define DF_1_INTERPOSE  0x00000400      /* object is an interposer */
 283 #define DF_1_NODEFLIB   0x00000800      /* ignore default library search path */
 284 #define DF_1_NODUMP     0x00001000      /* object can't be dldump(3x)'ed */
 285 #define DF_1_CONFALT    0x00002000      /* configuration alternative created */
 286 #define DF_1_ENDFILTEE  0x00004000      /* filtee terminates filters search */
 287 #define DF_1_DISPRELDNE 0x00008000      /* disp reloc applied at build time */
 288 #define DF_1_DISPRELPND 0x00010000      /* disp reloc applied at run-time */
 289 #define DF_1_NODIRECT   0x00020000      /* object contains symbols that */
 290                                         /*      cannot be directly bound to */
 291 #define DF_1_IGNMULDEF  0x00040000      /* internal: krtld ignore muldefs */
 292 #define DF_1_NOKSYMS    0x00080000      /* internal: don't export object's */
 293                                         /*      symbols via /dev/ksyms */
 294 #define DF_1_NOHDR      0x00100000      /* mapfile: 1st segment mapping */
 295                                         /*      omits ELF & program headers */
 296 #define DF_1_EDITED     0x00200000      /* object has been modified since */
 297                                         /*      being built by 'ld' */
 298 #define DF_1_NORELOC    0x00400000      /* internal: unrelocated object */
 299 #define DF_1_SYMINTPOSE 0x00800000      /* individual symbol interposers */
 300                                         /*      exist */
 301 #define DF_1_GLOBAUDIT  0x01000000      /* establish global auditing */
 302 #define DF_1_SINGLETON  0x02000000      /* singleton symbols exist */
 303
 304 /*
 305  * Values set to DT_FEATURE_1 tag's d_val (unused obsolete tag)
 306  */
 307 #define DTF_1_PARINIT   0x00000001      /* partially initialization feature */
 308 #define DTF_1_CONFEXP   0x00000002      /* configuration file expected */
 309
 310
 311 /*
 312  * Version structures.  There are three types of version structure:
 313  *
 314  *  o   A definition of the versions within the image itself.
 315  *      Each version definition is assigned a unique index (starting from
 316  *      VER_NDX_BGNDEF) which is used to cross-reference symbols associated to
 317  *      the version.  Each version can have one or more dependencies on other
 318  *      version definitions within the image.  The version name, and any
 319  *      dependency names, are specified in the version definition auxiliary
 320  *      array.  Version definition entries require a version symbol index table.
 321  *
 322  *  o   A version requirement on a needed dependency.  Each needed entry
 323  *      specifies the shared object dependency (as specified in DT_NEEDED).
 324  *      One or more versions required from this dependency are specified in the
 325  *      version needed auxiliary array.
 326  *
 327  *  o   A version symbol index table.  Each symbol indexes into this array
 328  *      to determine its version index.  Index values of VER_NDX_BGNDEF or
 329  *      greater indicate the version definition to which a symbol is associated.
 330  *      (the size of a symbol index entry is recorded in the sh_info field).
 331  */
 332 #ifndef _ASM
 333
 334 typedef struct {                        /* Version Definition Structure. */
 335         Elf32_Half      vd_version;     /* this structures version revision */
 336         Elf32_Half      vd_flags;       /* version information */
 337         Elf32_Half      vd_ndx;         /* version index */
 338         Elf32_Half      vd_cnt;         /* no. of associated aux entries */
 339         Elf32_Word      vd_hash;        /* version name hash value */
 340         Elf32_Word      vd_aux;         /* no. of bytes from start of this */
 341                                         /*      verdef to verdaux array */
 342         Elf32_Word      vd_next;        /* no. of bytes from start of this */
 343 } Elf32_Verdef;                         /*      verdef to next verdef entry */
 344
 345 typedef struct {                        /* Verdef Auxiliary Structure. */
 346         Elf32_Word      vda_name;       /* first element defines the version */
 347                                         /*      name. Additional entries */
 348                                         /*      define dependency names. */
 349         Elf32_Word      vda_next;       /* no. of bytes from start of this */
 350 } Elf32_Verdaux;                        /*      verdaux to next verdaux entry */
 351
 352
 353 typedef struct {                        /* Version Requirement Structure. */
 354         Elf32_Half      vn_version;     /* this structures version revision */
 355         Elf32_Half      vn_cnt;         /* no. of associated aux entries */
 356         Elf32_Word      vn_file;        /* name of needed dependency (file) */
 357         Elf32_Word      vn_aux;         /* no. of bytes from start of this */
 358                                         /*      verneed to vernaux array */
 359         Elf32_Word      vn_next;        /* no. of bytes from start of this */
 360 } Elf32_Verneed;                        /*      verneed to next verneed entry */
 361
 362 typedef struct {                        /* Verneed Auxiliary Structure. */
 363         Elf32_Word      vna_hash;       /* version name hash value */
 364         Elf32_Half      vna_flags;      /* version information */
 365         Elf32_Half      vna_other;
 366         Elf32_Word      vna_name;       /* version name */
 367         Elf32_Word      vna_next;       /* no. of bytes from start of this */
 368 } Elf32_Vernaux;                        /*      vernaux to next vernaux entry */
 369
 370 typedef Elf32_Half      Elf32_Versym;   /* Version symbol index array */
 371
 372 typedef struct {
 373         Elf32_Half      si_boundto;     /* direct bindings - symbol bound to */
 374         Elf32_Half      si_flags;       /* per symbol flags */
 375 } Elf32_Syminfo;
 376
 377
 378 #if defined(_LP64) || defined(_LONGLONG_TYPE)
 379 typedef struct {
 380         Elf64_Half      vd_version;     /* this structures version revision */
 381         Elf64_Half      vd_flags;       /* version information */
 382         Elf64_Half      vd_ndx;         /* version index */
 383         Elf64_Half      vd_cnt;         /* no. of associated aux entries */
 384         Elf64_Word      vd_hash;        /* version name hash value */
 385         Elf64_Word      vd_aux;         /* no. of bytes from start of this */
 386                                         /*      verdef to verdaux array */
 387         Elf64_Word      vd_next;        /* no. of bytes from start of this */
 388 } Elf64_Verdef;                         /*      verdef to next verdef entry */
 389
 390 typedef struct {
 391         Elf64_Word      vda_name;       /* first element defines the version */
 392                                         /*      name. Additional entries */
 393                                         /*      define dependency names. */
 394         Elf64_Word      vda_next;       /* no. of bytes from start of this */
 395 } Elf64_Verdaux;                        /*      verdaux to next verdaux entry */
 396
 397 typedef struct {
 398         Elf64_Half      vn_version;     /* this structures version revision */
 399         Elf64_Half      vn_cnt;         /* no. of associated aux entries */
 400         Elf64_Word      vn_file;        /* name of needed dependency (file) */
 401         Elf64_Word      vn_aux;         /* no. of bytes from start of this */
 402                                         /*      verneed to vernaux array */
 403         Elf64_Word      vn_next;        /* no. of bytes from start of this */
 404 } Elf64_Verneed;                        /*      verneed to next verneed entry */
 405
 406 typedef struct {
 407         Elf64_Word      vna_hash;       /* version name hash value */
 408         Elf64_Half      vna_flags;      /* version information */
 409         Elf64_Half      vna_other;
 410         Elf64_Word      vna_name;       /* version name */
 411         Elf64_Word      vna_next;       /* no. of bytes from start of this */
 412 } Elf64_Vernaux;                        /*      vernaux to next vernaux entry */
 413
 414 typedef Elf64_Half      Elf64_Versym;
 415
 416 typedef struct {
 417         Elf64_Half      si_boundto;     /* direct bindings - symbol bound to */
 418         Elf64_Half      si_flags;       /* per symbol flags */
 419 } Elf64_Syminfo;
 420 #endif  /* defined(_LP64) || defined(_LONGLONG_TYPE) */
 421
 422 #endif  /* _ASM */
 423
 424 /*
 425  * Versym symbol index values.  Values greater than VER_NDX_GLOBAL
 426  * and less then VER_NDX_LORESERVE associate symbols with user
 427  * specified version descriptors.
 428  */
 429 #define VER_NDX_LOCAL           0       /* symbol is local */
 430 #define VER_NDX_GLOBAL          1       /* symbol is global and assigned to */
 431                                         /*      the base version */
 432 #define VER_NDX_LORESERVE       0xff00  /* beginning of RESERVED entries */
 433 #define VER_NDX_ELIMINATE       0xff01  /* symbol is to be eliminated */
 434
 435 /*
 436  * Verdef (vd_flags) and Vernaux (vna_flags) flags values.
 437  */
 438 #define VER_FLG_BASE            0x1     /* version definition of file itself */
 439                                         /*      (Verdef only) */
 440 #define VER_FLG_WEAK            0x2     /* weak version identifier */
 441 #define VER_FLG_INFO            0x4     /* version is recorded in object for */
 442                                         /*      informational purposes */
 443                                         /*      (Versym reference) only. No */
 444                                         /*      runtime verification is */
 445                                         /*      required. (Vernaux only) */
 446
 447 /*
 448  * Verdef version values.
 449  */
 450 #define VER_DEF_NONE            0       /* Ver_def version */
 451 #define VER_DEF_CURRENT         1
 452 #define VER_DEF_NUM             2
 453
 454 /*
 455  * Verneed version values.
 456  */
 457 #define VER_NEED_NONE           0       /* Ver_need version */
 458 #define VER_NEED_CURRENT        1
 459 #define VER_NEED_NUM            2
 460
 461
 462 /*
 463  * Syminfo flag values
 464  */
 465 #define SYMINFO_FLG_DIRECT      0x0001  /* symbol ref has direct association */
 466                                         /*      to object containing defn. */
 467 #define SYMINFO_FLG_FILTER      0x0002  /* symbol ref is associated to a */
 468                                         /*      standard filter */
 469 #define SYMINFO_FLG_PASSTHRU    SYMINFO_FLG_FILTER /* unused obsolete name */
 470 #define SYMINFO_FLG_COPY        0x0004  /* symbol is a copy-reloc */
 471 #define SYMINFO_FLG_LAZYLOAD    0x0008  /* object containing defn. should be */
 472                                         /*      lazily-loaded */
 473 #define SYMINFO_FLG_DIRECTBIND  0x0010  /* ref should be bound directly to */
 474                                         /*      object containing defn. */
 475 #define SYMINFO_FLG_NOEXTDIRECT 0x0020  /* don't let an external reference */
 476                                         /*      directly bind to this symbol */
 477 #define SYMINFO_FLG_AUXILIARY   0x0040  /* symbol ref is associated to a */
 478                                         /*      auxiliary filter */
 479 #define SYMINFO_FLG_INTERPOSE   0x0080  /* symbol defines an interposer */
 480 #define SYMINFO_FLG_CAP         0x0100  /* symbol is capabilities specific */
 481 #define SYMINFO_FLG_DEFERRED    0x0200  /* symbol should not be included in */
 482                                         /*      BIND_NOW relocations */
 483
 484 /*
 485  * Syminfo.si_boundto values.
 486  */
 487 #define SYMINFO_BT_SELF         0xffff  /* symbol bound to self */
 488 #define SYMINFO_BT_PARENT       0xfffe  /* symbol bound to parent */
 489 #define SYMINFO_BT_NONE         0xfffd  /* no special symbol binding */
 490 #define SYMINFO_BT_EXTERN       0xfffc  /* symbol defined as external */
 491 #define SYMINFO_BT_LOWRESERVE   0xff00  /* beginning of reserved entries */
 492
 493 /*
 494  * Syminfo version values.
 495  */
 496 #define SYMINFO_NONE            0       /* Syminfo version */
 497 #define SYMINFO_CURRENT         1
 498 #define SYMINFO_NUM             2
 499
 500
 501 /*
 502  * Public structure defined and maintained within the runtime linker
 503  */
 504 #ifndef _ASM
 505
 506 typedef struct link_map Link_map;
 507
 508 struct link_map {
 509         unsigned long   l_addr;         /* address at which object is mapped */
 510         char            *l_name;        /* full name of loaded object */
 511 #ifdef _LP64
 512         Elf64_Dyn       *l_ld;          /* dynamic structure of object */
 513 #else
 514         Elf32_Dyn       *l_ld;          /* dynamic structure of object */
 515 #endif
 516         Link_map        *l_next;        /* next link object */
 517         Link_map        *l_prev;        /* previous link object */
 518         char            *l_refname;     /* filters reference name */
 519 };
 520
 521 #ifdef _SYSCALL32
 522 typedef struct link_map32 Link_map32;
 523
 524 struct link_map32 {
 525         Elf32_Word      l_addr;
 526         Elf32_Addr      l_name;
 527         Elf32_Addr      l_ld;
 528         Elf32_Addr      l_next;
 529         Elf32_Addr      l_prev;
 530         Elf32_Addr      l_refname;
 531 };
 532 #endif
 533
 534 typedef enum {
 535         RT_CONSISTENT,
 536         RT_ADD,
 537         RT_DELETE
 538 } r_state_e;
 539
 540 typedef enum {
 541         RD_FL_NONE = 0,         /* no flags */
 542         RD_FL_ODBG = (1<<0),    /* old style debugger present */
 543         RD_FL_DBG = (1<<1)      /* debugging enabled */
 544 } rd_flags_e;
 545
 546
 547
 548 /*
 549  * Debugging events enabled inside of the runtime linker.  To
 550  * access these events see the librtld_db interface.
 551  */
 552 typedef enum {
 553         RD_NONE = 0,            /* no event */
 554         RD_PREINIT,             /* the Initial rendezvous before .init */
 555         RD_POSTINIT,            /* the Second rendezvous after .init */
 556         RD_DLACTIVITY           /* a dlopen or dlclose has happened */
 557 } rd_event_e;
 558
 559 struct r_debug {
 560         int             r_version;      /* debugging info version no. */
 561         Link_map        *r_map;         /* address of link_map */
 562         unsigned long   r_brk;          /* address of update routine */
 563         r_state_e       r_state;
 564         unsigned long   r_ldbase;       /* base addr of ld.so */
 565         Link_map        *r_ldsomap;     /* address of ld.so.1's link map */
 566         rd_event_e      r_rdevent;      /* debug event */
 567         rd_flags_e      r_flags;        /* misc flags. */
 568 };
 569
 570 #ifdef _SYSCALL32
 571 struct r_debug32 {
 572         Elf32_Word      r_version;      /* debugging info version no. */
 573         Elf32_Addr      r_map;          /* address of link_map */
 574         Elf32_Word      r_brk;          /* address of update routine */
 575         r_state_e       r_state;
 576         Elf32_Word      r_ldbase;       /* base addr of ld.so */
 577         Elf32_Addr      r_ldsomap;      /* address of ld.so.1's link map */
 578         rd_event_e      r_rdevent;      /* debug event */
 579         rd_flags_e      r_flags;        /* misc flags. */
 580 };
 581 #endif
 582
 583
 584 #define R_DEBUG_VERSION 2               /* current r_debug version */
 585 #endif  /* _ASM */
 586
 587 /*
 588  * Attribute/value structures used to bootstrap ELF-based dynamic linker.
 589  */
 590 #ifndef _ASM
 591 typedef struct {
 592         Elf32_Sword eb_tag;             /* what this one is */
 593         union {                         /* possible values */
 594                 Elf32_Word eb_val;
 595                 Elf32_Addr eb_ptr;
 596                 Elf32_Off  eb_off;
 597         } eb_un;
 598 } Elf32_Boot;
 599
 600 #if defined(_LP64) || defined(_LONGLONG_TYPE)
 601 typedef struct {
 602         Elf64_Xword eb_tag;             /* what this one is */
 603         union {                         /* possible values */
 604                 Elf64_Xword eb_val;
 605                 Elf64_Addr eb_ptr;
 606                 Elf64_Off eb_off;
 607         } eb_un;
 608 } Elf64_Boot;
 609 #endif  /* defined(_LP64) || defined(_LONGLONG_TYPE) */
 610 #endif  /* _ASM */
 611
 612 /*
 613  * Attributes
 614  */
 615 #define EB_NULL         0               /* (void) last entry */
 616 #define EB_DYNAMIC      1               /* (*) dynamic structure of subject */
 617 #define EB_LDSO_BASE    2               /* (caddr_t) base address of ld.so */
 618 #define EB_ARGV         3               /* (caddr_t) argument vector */
 619 #define EB_ENVP         4               /* (char **) environment strings */
 620 #define EB_AUXV         5               /* (auxv_t *) auxiliary vector */
 621 #define EB_DEVZERO      6               /* (int) fd for /dev/zero */
 622 #define EB_PAGESIZE     7               /* (int) page size */
 623 #define EB_MAX          8               /* number of "EBs" */
 624 #define EB_MAX_SIZE32   64              /* size in bytes, _ILP32 */
 625 #define EB_MAX_SIZE64   128             /* size in bytes, _LP64 */
 626
 627
 628 #ifndef _ASM
 629
 630 /*
 631  * Concurrency communication structure for libc callbacks.
 632  */
 633 extern void     _ld_libc(void *);
 634
 635 #pragma unknown_control_flow(_ld_libc)
 636 #endif /* _ASM */
 637
 638 #ifdef  __cplusplus
 639 }
 640 #endif
 641
 642 #endif  /* _SYS_LINK_H */