10Sstevel@tonic-gate /* 20Sstevel@tonic-gate * CDDL HEADER START 30Sstevel@tonic-gate * 40Sstevel@tonic-gate * The contents of this file are subject to the terms of the 51682Srie * Common Development and Distribution License (the "License"). 61682Srie * You may not use this file except in compliance with the License. 70Sstevel@tonic-gate * 80Sstevel@tonic-gate * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE 90Sstevel@tonic-gate * or http://www.opensolaris.org/os/licensing. 100Sstevel@tonic-gate * See the License for the specific language governing permissions 110Sstevel@tonic-gate * and limitations under the License. 120Sstevel@tonic-gate * 130Sstevel@tonic-gate * When distributing Covered Code, include this CDDL HEADER in each 140Sstevel@tonic-gate * file and include the License file at usr/src/OPENSOLARIS.LICENSE. 150Sstevel@tonic-gate * If applicable, add the following below this CDDL HEADER, with the 160Sstevel@tonic-gate * fields enclosed by brackets "[]" replaced with your own identifying 170Sstevel@tonic-gate * information: Portions Copyright [yyyy] [name of copyright owner] 180Sstevel@tonic-gate * 190Sstevel@tonic-gate * CDDL HEADER END 200Sstevel@tonic-gate */ 210Sstevel@tonic-gate 220Sstevel@tonic-gate /* 231682Srie * Copyright (c) 1988 AT&T 241682Srie * All Rights Reserved 251682Srie * 263466Srie * Copyright 2007 Sun Microsystems, Inc. All rights reserved. 270Sstevel@tonic-gate * Use is subject to license terms. 280Sstevel@tonic-gate */ 290Sstevel@tonic-gate 300Sstevel@tonic-gate #ifndef _SYS_LINK_H 310Sstevel@tonic-gate #define _SYS_LINK_H 320Sstevel@tonic-gate 330Sstevel@tonic-gate #pragma ident "%Z%%M% %I% %E% SMI" 340Sstevel@tonic-gate 350Sstevel@tonic-gate #ifndef _ASM 360Sstevel@tonic-gate #include <sys/types.h> 370Sstevel@tonic-gate #include <sys/elftypes.h> 380Sstevel@tonic-gate #endif 390Sstevel@tonic-gate 400Sstevel@tonic-gate #ifdef __cplusplus 410Sstevel@tonic-gate extern "C" { 420Sstevel@tonic-gate #endif 430Sstevel@tonic-gate 440Sstevel@tonic-gate /* 450Sstevel@tonic-gate * Communication structures for the runtime linker. 460Sstevel@tonic-gate */ 470Sstevel@tonic-gate 480Sstevel@tonic-gate /* 490Sstevel@tonic-gate * The following data structure provides a self-identifying union consisting 500Sstevel@tonic-gate * of a tag from a known list and a value. 510Sstevel@tonic-gate */ 520Sstevel@tonic-gate #ifndef _ASM 530Sstevel@tonic-gate typedef struct { 540Sstevel@tonic-gate Elf32_Sword d_tag; /* how to interpret value */ 550Sstevel@tonic-gate union { 560Sstevel@tonic-gate Elf32_Word d_val; 570Sstevel@tonic-gate Elf32_Addr d_ptr; 580Sstevel@tonic-gate Elf32_Off d_off; 590Sstevel@tonic-gate } d_un; 600Sstevel@tonic-gate } Elf32_Dyn; 610Sstevel@tonic-gate 620Sstevel@tonic-gate #if defined(_LP64) || defined(_LONGLONG_TYPE) 630Sstevel@tonic-gate typedef struct { 640Sstevel@tonic-gate Elf64_Xword d_tag; /* how to interpret value */ 650Sstevel@tonic-gate union { 660Sstevel@tonic-gate Elf64_Xword d_val; 670Sstevel@tonic-gate Elf64_Addr d_ptr; 680Sstevel@tonic-gate } d_un; 690Sstevel@tonic-gate } Elf64_Dyn; 700Sstevel@tonic-gate #endif /* defined(_LP64) || defined(_LONGLONG_TYPE) */ 710Sstevel@tonic-gate #endif /* _ASM */ 720Sstevel@tonic-gate 730Sstevel@tonic-gate /* 740Sstevel@tonic-gate * Tag values 750Sstevel@tonic-gate */ 760Sstevel@tonic-gate #define DT_NULL 0 /* last entry in list */ 770Sstevel@tonic-gate #define DT_NEEDED 1 /* a needed object */ 780Sstevel@tonic-gate #define DT_PLTRELSZ 2 /* size of relocations for the PLT */ 790Sstevel@tonic-gate #define DT_PLTGOT 3 /* addresses used by procedure linkage table */ 800Sstevel@tonic-gate #define DT_HASH 4 /* hash table */ 810Sstevel@tonic-gate #define DT_STRTAB 5 /* string table */ 820Sstevel@tonic-gate #define DT_SYMTAB 6 /* symbol table */ 830Sstevel@tonic-gate #define DT_RELA 7 /* addr of relocation entries */ 840Sstevel@tonic-gate #define DT_RELASZ 8 /* size of relocation table */ 850Sstevel@tonic-gate #define DT_RELAENT 9 /* base size of relocation entry */ 860Sstevel@tonic-gate #define DT_STRSZ 10 /* size of string table */ 870Sstevel@tonic-gate #define DT_SYMENT 11 /* size of symbol table entry */ 880Sstevel@tonic-gate #define DT_INIT 12 /* _init addr */ 890Sstevel@tonic-gate #define DT_FINI 13 /* _fini addr */ 900Sstevel@tonic-gate #define DT_SONAME 14 /* name of this shared object */ 910Sstevel@tonic-gate #define DT_RPATH 15 /* run-time search path */ 920Sstevel@tonic-gate #define DT_SYMBOLIC 16 /* shared object linked -Bsymbolic */ 930Sstevel@tonic-gate #define DT_REL 17 /* addr of relocation entries */ 940Sstevel@tonic-gate #define DT_RELSZ 18 /* size of relocation table */ 950Sstevel@tonic-gate #define DT_RELENT 19 /* base size of relocation entry */ 960Sstevel@tonic-gate #define DT_PLTREL 20 /* relocation type for PLT entry */ 970Sstevel@tonic-gate #define DT_DEBUG 21 /* pointer to r_debug structure */ 980Sstevel@tonic-gate #define DT_TEXTREL 22 /* text relocations remain for this object */ 990Sstevel@tonic-gate #define DT_JMPREL 23 /* pointer to the PLT relocation entries */ 1000Sstevel@tonic-gate #define DT_BIND_NOW 24 /* perform all relocations at load of object */ 1010Sstevel@tonic-gate #define DT_INIT_ARRAY 25 /* pointer to .initarray */ 1020Sstevel@tonic-gate #define DT_FINI_ARRAY 26 /* pointer to .finiarray */ 1030Sstevel@tonic-gate #define DT_INIT_ARRAYSZ 27 /* size of .initarray */ 1040Sstevel@tonic-gate #define DT_FINI_ARRAYSZ 28 /* size of .finiarray */ 1050Sstevel@tonic-gate #define DT_RUNPATH 29 /* run-time search path */ 1060Sstevel@tonic-gate #define DT_FLAGS 30 /* state flags - see DF_* */ 1070Sstevel@tonic-gate 108*3492Sab196087 /* 109*3492Sab196087 * DT_* encoding rules: The value of each dynamic tag determines the 110*3492Sab196087 * interpretation of the d_un union. This convention provides for simpler 111*3492Sab196087 * interpretation of dynamic tags by external tools. A tag whose value 112*3492Sab196087 * is an even number indicates a dynamic section entry that uses d_ptr. 113*3492Sab196087 * A tag whose value is an odd number indicates a dynamic section entry 114*3492Sab196087 * that uses d_val, or that uses neither d_ptr nor d_val. 115*3492Sab196087 * 116*3492Sab196087 * There are exceptions to the above rule: 117*3492Sab196087 * - Tags with values that are less than DT_ENCODING. 118*3492Sab196087 * - Tags with values that fall between DT_LOOS and DT_SUNW_ENCODING 119*3492Sab196087 * - Tags with values that fall between DT_HIOS and DT_LOPROC 120*3492Sab196087 * 121*3492Sab196087 * Third party tools must handle these exception ranges explicitly 122*3492Sab196087 * on an item by item basis. 123*3492Sab196087 */ 124*3492Sab196087 #define DT_ENCODING 32 /* positive tag DT_* encoding rules */ 125*3492Sab196087 /* start after this */ 1260Sstevel@tonic-gate #define DT_PREINIT_ARRAY 32 /* pointer to .preinitarray segment */ 1270Sstevel@tonic-gate #define DT_PREINIT_ARRAYSZ 33 /* size of .preinitarray segment */ 1280Sstevel@tonic-gate 1290Sstevel@tonic-gate #define DT_MAXPOSTAGS 34 /* number of positive tags */ 1300Sstevel@tonic-gate 131*3492Sab196087 /* 132*3492Sab196087 * DT_* encoding rules do not apply between DT_LOOS and DT_SUNW_ENCODING 133*3492Sab196087 */ 1340Sstevel@tonic-gate #define DT_LOOS 0x6000000d /* OS specific range */ 1350Sstevel@tonic-gate #define DT_SUNW_AUXILIARY 0x6000000d /* symbol auxiliary name */ 1360Sstevel@tonic-gate #define DT_SUNW_RTLDINF 0x6000000e /* ld.so.1 info (private) */ 1370Sstevel@tonic-gate #define DT_SUNW_FILTER 0x6000000f /* symbol filter name */ 1380Sstevel@tonic-gate #define DT_SUNW_CAP 0x60000010 /* hardware/software */ 1390Sstevel@tonic-gate /* capabilities */ 1402766Sab196087 #define DT_SUNW_SYMTAB 0x60000011 /* symtab with local fcn */ 1412766Sab196087 /* symbols immediately */ 1422766Sab196087 /* preceding DT_SYMTAB */ 143*3492Sab196087 #define DT_SUNW_SYMSZ 0x60000012 /* Size of SUNW_SYMTAB table */ 144*3492Sab196087 145*3492Sab196087 /* 146*3492Sab196087 * DT_* encoding rules apply between DT_SUNW_ENCODING and DT_HIOS 147*3492Sab196087 */ 148*3492Sab196087 #define DT_SUNW_ENCODING 0x60000013 /* DT_* encoding rules resume */ 149*3492Sab196087 /* after this */ 150*3492Sab196087 #define DT_SUNW_SORTENT 0x60000013 /* sizeof [SYM|TLS]SORT entrt */ 151*3492Sab196087 #define DT_SUNW_SYMSORT 0x60000014 /* sym indices sorted by addr */ 152*3492Sab196087 #define DT_SUNW_SYMSORTSZ 0x60000015 /* size of SUNW_SYMSORT */ 153*3492Sab196087 #define DT_SUNW_TLSSORT 0x60000016 /* tls sym ndx sort by offset */ 154*3492Sab196087 #define DT_SUNW_TLSSORTSZ 0x60000017 /* size of SUNW_TLSSORT */ 155*3492Sab196087 156*3492Sab196087 /* 157*3492Sab196087 * DT_* encoding rules do not apply between DT_HIOS and DT_LOPROC 158*3492Sab196087 */ 1590Sstevel@tonic-gate #define DT_HIOS 0x6ffff000 1600Sstevel@tonic-gate 1610Sstevel@tonic-gate /* 1620Sstevel@tonic-gate * The following values have been deprecated and remain here to allow 1630Sstevel@tonic-gate * compatibility with older binaries. 1640Sstevel@tonic-gate */ 1650Sstevel@tonic-gate #define DT_DEPRECATED_SPARC_REGISTER 0x7000001 1660Sstevel@tonic-gate 1670Sstevel@tonic-gate /* 1680Sstevel@tonic-gate * DT_* entries which fall between DT_VALRNGHI & DT_VALRNGLO use the 1690Sstevel@tonic-gate * Dyn.d_un.d_val field of the Elf*_Dyn structure. 1700Sstevel@tonic-gate */ 1710Sstevel@tonic-gate #define DT_VALRNGLO 0x6ffffd00 1720Sstevel@tonic-gate #define DT_CHECKSUM 0x6ffffdf8 /* elf checksum */ 1730Sstevel@tonic-gate #define DT_PLTPADSZ 0x6ffffdf9 /* pltpadding size */ 1740Sstevel@tonic-gate #define DT_MOVEENT 0x6ffffdfa /* move table entry size */ 1750Sstevel@tonic-gate #define DT_MOVESZ 0x6ffffdfb /* move table size */ 1760Sstevel@tonic-gate #define DT_FEATURE_1 0x6ffffdfc /* feature holder */ 1770Sstevel@tonic-gate #define DT_POSFLAG_1 0x6ffffdfd /* flags for DT_* entries, effecting */ 1780Sstevel@tonic-gate /* the following DT_* entry. */ 1790Sstevel@tonic-gate /* See DF_P1_* definitions */ 1800Sstevel@tonic-gate #define DT_SYMINSZ 0x6ffffdfe /* syminfo table size (in bytes) */ 1810Sstevel@tonic-gate #define DT_SYMINENT 0x6ffffdff /* syminfo entry size (in bytes) */ 1820Sstevel@tonic-gate #define DT_VALRNGHI 0x6ffffdff 1830Sstevel@tonic-gate 1840Sstevel@tonic-gate /* 1850Sstevel@tonic-gate * DT_* entries which fall between DT_ADDRRNGHI & DT_ADDRRNGLO use the 1860Sstevel@tonic-gate * Dyn.d_un.d_ptr field of the Elf*_Dyn structure. 1870Sstevel@tonic-gate * 1880Sstevel@tonic-gate * If any adjustment is made to the ELF object after it has been 1890Sstevel@tonic-gate * built, these entries will need to be adjusted. 1900Sstevel@tonic-gate */ 1910Sstevel@tonic-gate #define DT_ADDRRNGLO 0x6ffffe00 1920Sstevel@tonic-gate #define DT_CONFIG 0x6ffffefa /* configuration information */ 1930Sstevel@tonic-gate #define DT_DEPAUDIT 0x6ffffefb /* dependency auditing */ 1940Sstevel@tonic-gate #define DT_AUDIT 0x6ffffefc /* object auditing */ 1950Sstevel@tonic-gate #define DT_PLTPAD 0x6ffffefd /* pltpadding (sparcv9) */ 1960Sstevel@tonic-gate #define DT_MOVETAB 0x6ffffefe /* move table */ 1970Sstevel@tonic-gate #define DT_SYMINFO 0x6ffffeff /* syminfo table */ 1980Sstevel@tonic-gate #define DT_ADDRRNGHI 0x6ffffeff 1990Sstevel@tonic-gate 2000Sstevel@tonic-gate /* 2010Sstevel@tonic-gate * The following DT_* entries should have been assigned within one of the 2020Sstevel@tonic-gate * DT_* ranges, but existed before such ranges had been established. 2030Sstevel@tonic-gate */ 2040Sstevel@tonic-gate #define DT_VERSYM 0x6ffffff0 /* version symbol table - unused */ 2050Sstevel@tonic-gate 2060Sstevel@tonic-gate #define DT_RELACOUNT 0x6ffffff9 /* number of RELATIVE relocations */ 2070Sstevel@tonic-gate #define DT_RELCOUNT 0x6ffffffa /* number of RELATIVE relocations */ 2080Sstevel@tonic-gate #define DT_FLAGS_1 0x6ffffffb /* state flags - see DF_1_* defs */ 2090Sstevel@tonic-gate #define DT_VERDEF 0x6ffffffc /* version definition table and */ 2100Sstevel@tonic-gate #define DT_VERDEFNUM 0x6ffffffd /* associated no. of entries */ 2110Sstevel@tonic-gate #define DT_VERNEED 0x6ffffffe /* version needed table and */ 2120Sstevel@tonic-gate #define DT_VERNEEDNUM 0x6fffffff /* associated no. of entries */ 2130Sstevel@tonic-gate 2140Sstevel@tonic-gate /* 2150Sstevel@tonic-gate * DT_* entries between DT_HIPROC and DT_LOPROC are reserved for processor 2160Sstevel@tonic-gate * specific semantics. 217*3492Sab196087 * 218*3492Sab196087 * DT_* encoding rules apply to all tag values larger than DT_LOPROC. 2190Sstevel@tonic-gate */ 2200Sstevel@tonic-gate #define DT_LOPROC 0x70000000 /* processor specific range */ 2210Sstevel@tonic-gate #define DT_AUXILIARY 0x7ffffffd /* shared library auxiliary name */ 2220Sstevel@tonic-gate #define DT_USED 0x7ffffffe /* ignored - same as needed */ 2230Sstevel@tonic-gate #define DT_FILTER 0x7fffffff /* shared library filter name */ 2240Sstevel@tonic-gate #define DT_HIPROC 0x7fffffff 2250Sstevel@tonic-gate 2260Sstevel@tonic-gate 2270Sstevel@tonic-gate /* 2280Sstevel@tonic-gate * Values for DT_FLAGS 2290Sstevel@tonic-gate */ 2300Sstevel@tonic-gate #define DF_ORIGIN 0x00000001 /* ORIGIN processing required */ 2310Sstevel@tonic-gate #define DF_SYMBOLIC 0x00000002 /* symbolic bindings in effect */ 2320Sstevel@tonic-gate #define DF_TEXTREL 0x00000004 /* text relocations remain */ 2330Sstevel@tonic-gate #define DF_BIND_NOW 0x00000008 /* process all relocations */ 2340Sstevel@tonic-gate #define DF_STATIC_TLS 0x00000010 /* obj. contains static TLS refs */ 2350Sstevel@tonic-gate 2360Sstevel@tonic-gate /* 2370Sstevel@tonic-gate * Values for the DT_POSFLAG_1 .dynamic entry. 2380Sstevel@tonic-gate * These values only affect the following DT_* entry. 2390Sstevel@tonic-gate */ 2400Sstevel@tonic-gate #define DF_P1_LAZYLOAD 0x00000001 /* following object is to be */ 2410Sstevel@tonic-gate /* lazy loaded */ 2420Sstevel@tonic-gate #define DF_P1_GROUPPERM 0x00000002 /* following object's symbols are */ 2430Sstevel@tonic-gate /* not available for general */ 2440Sstevel@tonic-gate /* symbol bindings. */ 2450Sstevel@tonic-gate /* 2460Sstevel@tonic-gate * Values for the DT_FLAGS_1 .dynamic entry. 2470Sstevel@tonic-gate */ 2480Sstevel@tonic-gate #define DF_1_NOW 0x00000001 /* set RTLD_NOW for this object */ 2490Sstevel@tonic-gate #define DF_1_GLOBAL 0x00000002 /* set RTLD_GLOBAL for this object */ 2500Sstevel@tonic-gate #define DF_1_GROUP 0x00000004 /* set RTLD_GROUP for this object */ 2510Sstevel@tonic-gate #define DF_1_NODELETE 0x00000008 /* set RTLD_NODELETE for this object */ 2520Sstevel@tonic-gate #define DF_1_LOADFLTR 0x00000010 /* trigger filtee loading at runtime */ 2530Sstevel@tonic-gate #define DF_1_INITFIRST 0x00000020 /* set RTLD_INITFIRST for this object */ 2540Sstevel@tonic-gate #define DF_1_NOOPEN 0x00000040 /* set RTLD_NOOPEN for this object */ 2550Sstevel@tonic-gate #define DF_1_ORIGIN 0x00000080 /* ORIGIN processing required */ 2560Sstevel@tonic-gate #define DF_1_DIRECT 0x00000100 /* direct binding enabled */ 2570Sstevel@tonic-gate #define DF_1_TRANS 0x00000200 2583466Srie #define DF_1_INTERPOSE 0x00000400 /* object is an interposer */ 2590Sstevel@tonic-gate #define DF_1_NODEFLIB 0x00000800 /* ignore default library search path */ 2600Sstevel@tonic-gate #define DF_1_NODUMP 0x00001000 /* object can't be dldump(3x)'ed */ 2610Sstevel@tonic-gate #define DF_1_CONFALT 0x00002000 /* configuration alternative created */ 2620Sstevel@tonic-gate #define DF_1_ENDFILTEE 0x00004000 /* filtee terminates filters search */ 2630Sstevel@tonic-gate #define DF_1_DISPRELDNE 0x00008000 /* disp reloc applied at build time */ 2640Sstevel@tonic-gate #define DF_1_DISPRELPND 0x00010000 /* disp reloc applied at run-time */ 2650Sstevel@tonic-gate #define DF_1_NODIRECT 0x00020000 /* object contains symbols that */ 2660Sstevel@tonic-gate /* cannot be directly bound to */ 2671682Srie #define DF_1_IGNMULDEF 0x00040000 /* internal: krtld ignore muldefs */ 2681682Srie #define DF_1_NOKSYMS 0x00080000 /* internal: don't export object's */ 2691682Srie /* symbols via /dev/ksyms */ 2701698Sab196087 #define DF_1_NOHDR 0x00100000 /* mapfile ?N:1st segment mapping */ 2711698Sab196087 /* omits ELF & program headers */ 2721682Srie #define DF_1_NORELOC 0x00400000 /* internal: unrelocated object */ 2733466Srie #define DF_1_SYMINTPOSE 0x00800000 /* individual symbol interposers */ 2743466Srie /* exist */ 2750Sstevel@tonic-gate 2760Sstevel@tonic-gate /* 2771698Sab196087 * Values set to DT_FEATURE_1 tag's d_val. 2780Sstevel@tonic-gate */ 2790Sstevel@tonic-gate #define DTF_1_PARINIT 0x00000001 /* partially initialization feature */ 2800Sstevel@tonic-gate #define DTF_1_CONFEXP 0x00000002 /* configuration file expected */ 2810Sstevel@tonic-gate 2820Sstevel@tonic-gate 2830Sstevel@tonic-gate /* 2840Sstevel@tonic-gate * Version structures. There are three types of version structure: 2850Sstevel@tonic-gate * 2860Sstevel@tonic-gate * o A definition of the versions within the image itself. 2870Sstevel@tonic-gate * Each version definition is assigned a unique index (starting from 2880Sstevel@tonic-gate * VER_NDX_BGNDEF) which is used to cross-reference symbols associated to 2890Sstevel@tonic-gate * the version. Each version can have one or more dependencies on other 2900Sstevel@tonic-gate * version definitions within the image. The version name, and any 2910Sstevel@tonic-gate * dependency names, are specified in the version definition auxiliary 2920Sstevel@tonic-gate * array. Version definition entries require a version symbol index table. 2930Sstevel@tonic-gate * 2940Sstevel@tonic-gate * o A version requirement on a needed dependency. Each needed entry 2950Sstevel@tonic-gate * specifies the shared object dependency (as specified in DT_NEEDED). 2960Sstevel@tonic-gate * One or more versions required from this dependency are specified in the 2970Sstevel@tonic-gate * version needed auxiliary array. 2980Sstevel@tonic-gate * 2990Sstevel@tonic-gate * o A version symbol index table. Each symbol indexes into this array 3000Sstevel@tonic-gate * to determine its version index. Index values of VER_NDX_BGNDEF or 3010Sstevel@tonic-gate * greater indicate the version definition to which a symbol is associated. 3020Sstevel@tonic-gate * (the size of a symbol index entry is recorded in the sh_info field). 3030Sstevel@tonic-gate */ 3040Sstevel@tonic-gate #ifndef _ASM 3050Sstevel@tonic-gate 3060Sstevel@tonic-gate typedef struct { /* Version Definition Structure. */ 3070Sstevel@tonic-gate Elf32_Half vd_version; /* this structures version revision */ 3080Sstevel@tonic-gate Elf32_Half vd_flags; /* version information */ 3090Sstevel@tonic-gate Elf32_Half vd_ndx; /* version index */ 3100Sstevel@tonic-gate Elf32_Half vd_cnt; /* no. of associated aux entries */ 3110Sstevel@tonic-gate Elf32_Word vd_hash; /* version name hash value */ 3120Sstevel@tonic-gate Elf32_Word vd_aux; /* no. of bytes from start of this */ 3130Sstevel@tonic-gate /* verdef to verdaux array */ 3140Sstevel@tonic-gate Elf32_Word vd_next; /* no. of bytes from start of this */ 3150Sstevel@tonic-gate } Elf32_Verdef; /* verdef to next verdef entry */ 3160Sstevel@tonic-gate 3170Sstevel@tonic-gate typedef struct { /* Verdef Auxiliary Structure. */ 3180Sstevel@tonic-gate Elf32_Word vda_name; /* first element defines the version */ 3190Sstevel@tonic-gate /* name. Additional entries */ 3200Sstevel@tonic-gate /* define dependency names. */ 3210Sstevel@tonic-gate Elf32_Word vda_next; /* no. of bytes from start of this */ 3220Sstevel@tonic-gate } Elf32_Verdaux; /* verdaux to next verdaux entry */ 3230Sstevel@tonic-gate 3240Sstevel@tonic-gate 3250Sstevel@tonic-gate typedef struct { /* Version Requirement Structure. */ 3260Sstevel@tonic-gate Elf32_Half vn_version; /* this structures version revision */ 3270Sstevel@tonic-gate Elf32_Half vn_cnt; /* no. of associated aux entries */ 3280Sstevel@tonic-gate Elf32_Word vn_file; /* name of needed dependency (file) */ 3290Sstevel@tonic-gate Elf32_Word vn_aux; /* no. of bytes from start of this */ 3300Sstevel@tonic-gate /* verneed to vernaux array */ 3310Sstevel@tonic-gate Elf32_Word vn_next; /* no. of bytes from start of this */ 3320Sstevel@tonic-gate } Elf32_Verneed; /* verneed to next verneed entry */ 3330Sstevel@tonic-gate 3340Sstevel@tonic-gate typedef struct { /* Verneed Auxiliary Structure. */ 3350Sstevel@tonic-gate Elf32_Word vna_hash; /* version name hash value */ 3360Sstevel@tonic-gate Elf32_Half vna_flags; /* version information */ 3370Sstevel@tonic-gate Elf32_Half vna_other; 3380Sstevel@tonic-gate Elf32_Word vna_name; /* version name */ 3390Sstevel@tonic-gate Elf32_Word vna_next; /* no. of bytes from start of this */ 3400Sstevel@tonic-gate } Elf32_Vernaux; /* vernaux to next vernaux entry */ 3410Sstevel@tonic-gate 3420Sstevel@tonic-gate typedef Elf32_Half Elf32_Versym; /* Version symbol index array */ 3430Sstevel@tonic-gate 3440Sstevel@tonic-gate typedef struct { 3450Sstevel@tonic-gate Elf32_Half si_boundto; /* direct bindings - symbol bound to */ 3460Sstevel@tonic-gate Elf32_Half si_flags; /* per symbol flags */ 3470Sstevel@tonic-gate } Elf32_Syminfo; 3480Sstevel@tonic-gate 3490Sstevel@tonic-gate 3500Sstevel@tonic-gate #if defined(_LP64) || defined(_LONGLONG_TYPE) 3510Sstevel@tonic-gate typedef struct { 3520Sstevel@tonic-gate Elf64_Half vd_version; /* this structures version revision */ 3530Sstevel@tonic-gate Elf64_Half vd_flags; /* version information */ 3540Sstevel@tonic-gate Elf64_Half vd_ndx; /* version index */ 3550Sstevel@tonic-gate Elf64_Half vd_cnt; /* no. of associated aux entries */ 3560Sstevel@tonic-gate Elf64_Word vd_hash; /* version name hash value */ 3570Sstevel@tonic-gate Elf64_Word vd_aux; /* no. of bytes from start of this */ 3580Sstevel@tonic-gate /* verdef to verdaux array */ 3590Sstevel@tonic-gate Elf64_Word vd_next; /* no. of bytes from start of this */ 3600Sstevel@tonic-gate } Elf64_Verdef; /* verdef to next verdef entry */ 3610Sstevel@tonic-gate 3620Sstevel@tonic-gate typedef struct { 3630Sstevel@tonic-gate Elf64_Word vda_name; /* first element defines the version */ 3640Sstevel@tonic-gate /* name. Additional entries */ 3650Sstevel@tonic-gate /* define dependency names. */ 3660Sstevel@tonic-gate Elf64_Word vda_next; /* no. of bytes from start of this */ 3670Sstevel@tonic-gate } Elf64_Verdaux; /* verdaux to next verdaux entry */ 3680Sstevel@tonic-gate 3690Sstevel@tonic-gate typedef struct { 3700Sstevel@tonic-gate Elf64_Half vn_version; /* this structures version revision */ 3710Sstevel@tonic-gate Elf64_Half vn_cnt; /* no. of associated aux entries */ 3720Sstevel@tonic-gate Elf64_Word vn_file; /* name of needed dependency (file) */ 3730Sstevel@tonic-gate Elf64_Word vn_aux; /* no. of bytes from start of this */ 3740Sstevel@tonic-gate /* verneed to vernaux array */ 3750Sstevel@tonic-gate Elf64_Word vn_next; /* no. of bytes from start of this */ 3760Sstevel@tonic-gate } Elf64_Verneed; /* verneed to next verneed entry */ 3770Sstevel@tonic-gate 3780Sstevel@tonic-gate typedef struct { 3790Sstevel@tonic-gate Elf64_Word vna_hash; /* version name hash value */ 3800Sstevel@tonic-gate Elf64_Half vna_flags; /* version information */ 3810Sstevel@tonic-gate Elf64_Half vna_other; 3820Sstevel@tonic-gate Elf64_Word vna_name; /* version name */ 3830Sstevel@tonic-gate Elf64_Word vna_next; /* no. of bytes from start of this */ 3840Sstevel@tonic-gate } Elf64_Vernaux; /* vernaux to next vernaux entry */ 3850Sstevel@tonic-gate 3860Sstevel@tonic-gate typedef Elf64_Half Elf64_Versym; 3870Sstevel@tonic-gate 3880Sstevel@tonic-gate typedef struct { 3890Sstevel@tonic-gate Elf64_Half si_boundto; /* direct bindings - symbol bound to */ 3900Sstevel@tonic-gate Elf64_Half si_flags; /* per symbol flags */ 3910Sstevel@tonic-gate } Elf64_Syminfo; 3920Sstevel@tonic-gate #endif /* defined(_LP64) || defined(_LONGLONG_TYPE) */ 3930Sstevel@tonic-gate 3940Sstevel@tonic-gate #endif /* _ASM */ 3950Sstevel@tonic-gate 3960Sstevel@tonic-gate /* 3970Sstevel@tonic-gate * Versym symbol index values. Values greater than VER_NDX_GLOBAL 3980Sstevel@tonic-gate * and less then VER_NDX_LORESERVE associate symbols with user 3990Sstevel@tonic-gate * specified version descriptors. 4000Sstevel@tonic-gate */ 4010Sstevel@tonic-gate #define VER_NDX_LOCAL 0 /* symbol is local */ 4020Sstevel@tonic-gate #define VER_NDX_GLOBAL 1 /* symbol is global and assigned to */ 4030Sstevel@tonic-gate /* the base version */ 4040Sstevel@tonic-gate #define VER_NDX_LORESERVE 0xff00 /* beginning of RESERVED entries */ 4050Sstevel@tonic-gate #define VER_NDX_ELIMINATE 0xff01 /* symbol is to be eliminated */ 4060Sstevel@tonic-gate 4070Sstevel@tonic-gate /* 4080Sstevel@tonic-gate * Verdef and Verneed (via Veraux) flags values. 4090Sstevel@tonic-gate */ 4100Sstevel@tonic-gate #define VER_FLG_BASE 0x1 /* version definition of file itself */ 4110Sstevel@tonic-gate #define VER_FLG_WEAK 0x2 /* weak version identifier */ 4120Sstevel@tonic-gate 4130Sstevel@tonic-gate /* 4140Sstevel@tonic-gate * Verdef version values. 4150Sstevel@tonic-gate */ 4160Sstevel@tonic-gate #define VER_DEF_NONE 0 /* Ver_def version */ 4170Sstevel@tonic-gate #define VER_DEF_CURRENT 1 4180Sstevel@tonic-gate #define VER_DEF_NUM 2 4190Sstevel@tonic-gate 4200Sstevel@tonic-gate /* 4210Sstevel@tonic-gate * Verneed version values. 4220Sstevel@tonic-gate */ 4230Sstevel@tonic-gate #define VER_NEED_NONE 0 /* Ver_need version */ 4240Sstevel@tonic-gate #define VER_NEED_CURRENT 1 4250Sstevel@tonic-gate #define VER_NEED_NUM 2 4260Sstevel@tonic-gate 4270Sstevel@tonic-gate 4280Sstevel@tonic-gate /* 4290Sstevel@tonic-gate * Syminfo flag values 4300Sstevel@tonic-gate */ 4310Sstevel@tonic-gate #define SYMINFO_FLG_DIRECT 0x0001 /* symbol ref has direct association */ 4320Sstevel@tonic-gate /* to object containing defn. */ 4330Sstevel@tonic-gate #define SYMINFO_FLG_PASSTHRU 0x0002 /* ignored - see SYMINFO_FLG_FILTER */ 4340Sstevel@tonic-gate #define SYMINFO_FLG_COPY 0x0004 /* symbol is a copy-reloc */ 4353466Srie #define SYMINFO_FLG_LAZYLOAD 0x0008 /* object containing defn. should be */ 4360Sstevel@tonic-gate /* lazily-loaded */ 4370Sstevel@tonic-gate #define SYMINFO_FLG_DIRECTBIND 0x0010 /* ref should be bound directly to */ 4380Sstevel@tonic-gate /* object containing defn. */ 4390Sstevel@tonic-gate #define SYMINFO_FLG_NOEXTDIRECT 0x0020 /* don't let an external reference */ 4400Sstevel@tonic-gate /* directly bind to this symbol */ 4410Sstevel@tonic-gate #define SYMINFO_FLG_FILTER 0x0002 /* symbol ref is associated to a */ 4420Sstevel@tonic-gate #define SYMINFO_FLG_AUXILIARY 0x0040 /* standard or auxiliary filter */ 4433466Srie #define SYMINFO_FLG_INTERPOSE 0x0080 /* symbol defines an interposer */ 4440Sstevel@tonic-gate 4450Sstevel@tonic-gate /* 4460Sstevel@tonic-gate * Syminfo.si_boundto values. 4470Sstevel@tonic-gate */ 4480Sstevel@tonic-gate #define SYMINFO_BT_SELF 0xffff /* symbol bound to self */ 4490Sstevel@tonic-gate #define SYMINFO_BT_PARENT 0xfffe /* symbol bound to parent */ 4500Sstevel@tonic-gate #define SYMINFO_BT_NONE 0xfffd /* no special symbol binding */ 4510Sstevel@tonic-gate #define SYMINFO_BT_EXTERN 0xfffc /* symbol defined as external */ 4520Sstevel@tonic-gate #define SYMINFO_BT_LOWRESERVE 0xff00 /* beginning of reserved entries */ 4530Sstevel@tonic-gate 4540Sstevel@tonic-gate /* 4550Sstevel@tonic-gate * Syminfo version values. 4560Sstevel@tonic-gate */ 4570Sstevel@tonic-gate #define SYMINFO_NONE 0 /* Syminfo version */ 4580Sstevel@tonic-gate #define SYMINFO_CURRENT 1 4590Sstevel@tonic-gate #define SYMINFO_NUM 2 4600Sstevel@tonic-gate 4610Sstevel@tonic-gate 4620Sstevel@tonic-gate /* 4630Sstevel@tonic-gate * Public structure defined and maintained within the runtime linker 4640Sstevel@tonic-gate */ 4650Sstevel@tonic-gate #ifndef _ASM 4660Sstevel@tonic-gate 4670Sstevel@tonic-gate typedef struct link_map Link_map; 4680Sstevel@tonic-gate 4690Sstevel@tonic-gate struct link_map { 4700Sstevel@tonic-gate unsigned long l_addr; /* address at which object is mapped */ 4710Sstevel@tonic-gate char *l_name; /* full name of loaded object */ 4720Sstevel@tonic-gate #ifdef _LP64 4730Sstevel@tonic-gate Elf64_Dyn *l_ld; /* dynamic structure of object */ 4740Sstevel@tonic-gate #else 4750Sstevel@tonic-gate Elf32_Dyn *l_ld; /* dynamic structure of object */ 4760Sstevel@tonic-gate #endif 4770Sstevel@tonic-gate Link_map *l_next; /* next link object */ 4780Sstevel@tonic-gate Link_map *l_prev; /* previous link object */ 4790Sstevel@tonic-gate char *l_refname; /* filters reference name */ 4800Sstevel@tonic-gate }; 4810Sstevel@tonic-gate 4820Sstevel@tonic-gate #ifdef _SYSCALL32 4830Sstevel@tonic-gate typedef struct link_map32 Link_map32; 4840Sstevel@tonic-gate 4850Sstevel@tonic-gate struct link_map32 { 4860Sstevel@tonic-gate Elf32_Word l_addr; 4870Sstevel@tonic-gate Elf32_Addr l_name; 4880Sstevel@tonic-gate Elf32_Addr l_ld; 4890Sstevel@tonic-gate Elf32_Addr l_next; 4900Sstevel@tonic-gate Elf32_Addr l_prev; 4910Sstevel@tonic-gate Elf32_Addr l_refname; 4920Sstevel@tonic-gate }; 4930Sstevel@tonic-gate #endif 4940Sstevel@tonic-gate 4950Sstevel@tonic-gate typedef enum { 4960Sstevel@tonic-gate RT_CONSISTENT, 4970Sstevel@tonic-gate RT_ADD, 4980Sstevel@tonic-gate RT_DELETE 4990Sstevel@tonic-gate } r_state_e; 5000Sstevel@tonic-gate 5010Sstevel@tonic-gate typedef enum { 5020Sstevel@tonic-gate RD_FL_NONE = 0, /* no flags */ 5030Sstevel@tonic-gate RD_FL_ODBG = (1<<0), /* old style debugger present */ 5040Sstevel@tonic-gate RD_FL_DBG = (1<<1) /* debugging enabled */ 5050Sstevel@tonic-gate } rd_flags_e; 5060Sstevel@tonic-gate 5070Sstevel@tonic-gate 5080Sstevel@tonic-gate 5090Sstevel@tonic-gate /* 5100Sstevel@tonic-gate * Debugging events enabled inside of the runtime linker. To 5110Sstevel@tonic-gate * access these events see the librtld_db interface. 5120Sstevel@tonic-gate */ 5130Sstevel@tonic-gate typedef enum { 5140Sstevel@tonic-gate RD_NONE = 0, /* no event */ 5150Sstevel@tonic-gate RD_PREINIT, /* the Initial rendezvous before .init */ 5160Sstevel@tonic-gate RD_POSTINIT, /* the Second rendezvous after .init */ 5170Sstevel@tonic-gate RD_DLACTIVITY /* a dlopen or dlclose has happened */ 5180Sstevel@tonic-gate } rd_event_e; 5190Sstevel@tonic-gate 5200Sstevel@tonic-gate struct r_debug { 5210Sstevel@tonic-gate int r_version; /* debugging info version no. */ 5220Sstevel@tonic-gate Link_map *r_map; /* address of link_map */ 5230Sstevel@tonic-gate unsigned long r_brk; /* address of update routine */ 5240Sstevel@tonic-gate r_state_e r_state; 5250Sstevel@tonic-gate unsigned long r_ldbase; /* base addr of ld.so */ 5260Sstevel@tonic-gate Link_map *r_ldsomap; /* address of ld.so.1's link map */ 5270Sstevel@tonic-gate rd_event_e r_rdevent; /* debug event */ 5280Sstevel@tonic-gate rd_flags_e r_flags; /* misc flags. */ 5290Sstevel@tonic-gate }; 5300Sstevel@tonic-gate 5310Sstevel@tonic-gate #ifdef _SYSCALL32 5320Sstevel@tonic-gate struct r_debug32 { 5330Sstevel@tonic-gate Elf32_Word r_version; /* debugging info version no. */ 5340Sstevel@tonic-gate Elf32_Addr r_map; /* address of link_map */ 5350Sstevel@tonic-gate Elf32_Word r_brk; /* address of update routine */ 5360Sstevel@tonic-gate r_state_e r_state; 5370Sstevel@tonic-gate Elf32_Word r_ldbase; /* base addr of ld.so */ 5380Sstevel@tonic-gate Elf32_Addr r_ldsomap; /* address of ld.so.1's link map */ 5390Sstevel@tonic-gate rd_event_e r_rdevent; /* debug event */ 5400Sstevel@tonic-gate rd_flags_e r_flags; /* misc flags. */ 5410Sstevel@tonic-gate }; 5420Sstevel@tonic-gate #endif 5430Sstevel@tonic-gate 5440Sstevel@tonic-gate 5450Sstevel@tonic-gate #define R_DEBUG_VERSION 2 /* current r_debug version */ 5460Sstevel@tonic-gate #endif /* _ASM */ 5470Sstevel@tonic-gate 5480Sstevel@tonic-gate /* 5490Sstevel@tonic-gate * Attribute/value structures used to bootstrap ELF-based dynamic linker. 5500Sstevel@tonic-gate */ 5510Sstevel@tonic-gate #ifndef _ASM 5520Sstevel@tonic-gate typedef struct { 5530Sstevel@tonic-gate Elf32_Sword eb_tag; /* what this one is */ 5540Sstevel@tonic-gate union { /* possible values */ 5550Sstevel@tonic-gate Elf32_Word eb_val; 5560Sstevel@tonic-gate Elf32_Addr eb_ptr; 5570Sstevel@tonic-gate Elf32_Off eb_off; 5580Sstevel@tonic-gate } eb_un; 5590Sstevel@tonic-gate } Elf32_Boot; 5600Sstevel@tonic-gate 5610Sstevel@tonic-gate #if defined(_LP64) || defined(_LONGLONG_TYPE) 5620Sstevel@tonic-gate typedef struct { 5630Sstevel@tonic-gate Elf64_Xword eb_tag; /* what this one is */ 5640Sstevel@tonic-gate union { /* possible values */ 5650Sstevel@tonic-gate Elf64_Xword eb_val; 5660Sstevel@tonic-gate Elf64_Addr eb_ptr; 5670Sstevel@tonic-gate Elf64_Off eb_off; 5680Sstevel@tonic-gate } eb_un; 5690Sstevel@tonic-gate } Elf64_Boot; 5700Sstevel@tonic-gate #endif /* defined(_LP64) || defined(_LONGLONG_TYPE) */ 5710Sstevel@tonic-gate #endif /* _ASM */ 5720Sstevel@tonic-gate 5730Sstevel@tonic-gate /* 5740Sstevel@tonic-gate * Attributes 5750Sstevel@tonic-gate */ 5760Sstevel@tonic-gate #define EB_NULL 0 /* (void) last entry */ 5770Sstevel@tonic-gate #define EB_DYNAMIC 1 /* (*) dynamic structure of subject */ 5780Sstevel@tonic-gate #define EB_LDSO_BASE 2 /* (caddr_t) base address of ld.so */ 5790Sstevel@tonic-gate #define EB_ARGV 3 /* (caddr_t) argument vector */ 5800Sstevel@tonic-gate #define EB_ENVP 4 /* (char **) environment strings */ 5810Sstevel@tonic-gate #define EB_AUXV 5 /* (auxv_t *) auxiliary vector */ 5820Sstevel@tonic-gate #define EB_DEVZERO 6 /* (int) fd for /dev/zero */ 5830Sstevel@tonic-gate #define EB_PAGESIZE 7 /* (int) page size */ 5840Sstevel@tonic-gate #define EB_MAX 8 /* number of "EBs" */ 5850Sstevel@tonic-gate #define EB_MAX_SIZE32 64 /* size in bytes, _ILP32 */ 5860Sstevel@tonic-gate #define EB_MAX_SIZE64 128 /* size in bytes, _LP64 */ 5870Sstevel@tonic-gate 5880Sstevel@tonic-gate 5890Sstevel@tonic-gate #ifndef _ASM 5900Sstevel@tonic-gate 5910Sstevel@tonic-gate #ifdef __STDC__ 5920Sstevel@tonic-gate 5930Sstevel@tonic-gate /* 5940Sstevel@tonic-gate * Concurrency communication structure for libc callbacks. 5950Sstevel@tonic-gate */ 5960Sstevel@tonic-gate extern void _ld_libc(void *); 5970Sstevel@tonic-gate #else /* __STDC__ */ 5980Sstevel@tonic-gate extern void _ld_libc(); 5990Sstevel@tonic-gate #endif /* __STDC__ */ 6000Sstevel@tonic-gate 6010Sstevel@tonic-gate #pragma unknown_control_flow(_ld_libc) 6020Sstevel@tonic-gate #endif /* _ASM */ 6030Sstevel@tonic-gate 6040Sstevel@tonic-gate #ifdef __cplusplus 6050Sstevel@tonic-gate } 6060Sstevel@tonic-gate #endif 6070Sstevel@tonic-gate 6080Sstevel@tonic-gate #endif /* _SYS_LINK_H */ 609