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