xref: /onnv-gate/usr/src/uts/common/sys/link.h (revision 6206:6b0ed502a8e7)
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  *
26*6206Sab196087  * Copyright 2008 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 
1083492Sab196087 /*
1093492Sab196087  * DT_* encoding rules: The value of each dynamic tag determines the
1103492Sab196087  * interpretation of the d_un union. This convention provides for simpler
1113492Sab196087  * interpretation of dynamic tags by external tools. A tag whose value
1123492Sab196087  * is an even number indicates a dynamic section entry that uses d_ptr.
1133492Sab196087  * A tag whose value is an odd number indicates a dynamic section entry
1143492Sab196087  * that uses d_val, or that uses neither d_ptr nor d_val.
1153492Sab196087  *
1163492Sab196087  * There are exceptions to the above rule:
1173492Sab196087  *	- Tags with values that are less than DT_ENCODING.
1183492Sab196087  *	- Tags with values that fall between DT_LOOS and DT_SUNW_ENCODING
1193492Sab196087  *	- Tags with values that fall between DT_HIOS and DT_LOPROC
1203492Sab196087  *
1213492Sab196087  * Third party tools must handle these exception ranges explicitly
1223492Sab196087  * on an item by item basis.
1233492Sab196087  */
1243492Sab196087 #define	DT_ENCODING		32	/* positive tag DT_* encoding rules */
1253492Sab196087 					/*	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 
1313492Sab196087 /*
1323492Sab196087  * DT_* encoding rules do not apply between DT_LOOS and DT_SUNW_ENCODING
1333492Sab196087  */
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 */
1433492Sab196087 #define	DT_SUNW_SYMSZ		0x60000012	/* Size of SUNW_SYMTAB table */
1443492Sab196087 
1453492Sab196087 /*
1463492Sab196087  * DT_* encoding rules apply between DT_SUNW_ENCODING and DT_HIOS
1473492Sab196087  */
1483492Sab196087 #define	DT_SUNW_ENCODING	0x60000013	/* DT_* encoding rules resume */
1493492Sab196087 						/*	after this */
1503492Sab196087 #define	DT_SUNW_SORTENT		0x60000013	/* sizeof [SYM|TLS]SORT entrt */
1513492Sab196087 #define	DT_SUNW_SYMSORT		0x60000014	/* sym indices sorted by addr */
1523492Sab196087 #define	DT_SUNW_SYMSORTSZ	0x60000015	/* size of SUNW_SYMSORT */
1533492Sab196087 #define	DT_SUNW_TLSSORT		0x60000016	/* tls sym ndx sort by offset */
1543492Sab196087 #define	DT_SUNW_TLSSORTSZ	0x60000017	/* size of SUNW_TLSSORT */
1553492Sab196087 
1563850Sab196087 #define	DT_SUNW_STRPAD		0x60000019	/* # of unused bytes at the */
1573850Sab196087 						/*	end of dynstr */
158*6206Sab196087 #define	DT_SUNW_LDMACH		0x6000001b	/* EM_ machine code of linker */
159*6206Sab196087 						/*	that produced object */
1603850Sab196087 
1613492Sab196087 /*
1623492Sab196087  * DT_* encoding rules do not apply between DT_HIOS and DT_LOPROC
1633492Sab196087  */
1640Sstevel@tonic-gate #define	DT_HIOS			0x6ffff000
1650Sstevel@tonic-gate 
1660Sstevel@tonic-gate /*
1670Sstevel@tonic-gate  * The following values have been deprecated and remain here to allow
1680Sstevel@tonic-gate  * compatibility with older binaries.
1690Sstevel@tonic-gate  */
1700Sstevel@tonic-gate #define	DT_DEPRECATED_SPARC_REGISTER	0x7000001
1710Sstevel@tonic-gate 
1720Sstevel@tonic-gate /*
1730Sstevel@tonic-gate  * DT_* entries which fall between DT_VALRNGHI & DT_VALRNGLO use the
1740Sstevel@tonic-gate  * Dyn.d_un.d_val field of the Elf*_Dyn structure.
1750Sstevel@tonic-gate  */
1760Sstevel@tonic-gate #define	DT_VALRNGLO	0x6ffffd00
1770Sstevel@tonic-gate #define	DT_CHECKSUM	0x6ffffdf8	/* elf checksum */
1780Sstevel@tonic-gate #define	DT_PLTPADSZ	0x6ffffdf9	/* pltpadding size */
1790Sstevel@tonic-gate #define	DT_MOVEENT	0x6ffffdfa	/* move table entry size */
1800Sstevel@tonic-gate #define	DT_MOVESZ	0x6ffffdfb	/* move table size */
1810Sstevel@tonic-gate #define	DT_FEATURE_1	0x6ffffdfc	/* feature holder */
1820Sstevel@tonic-gate #define	DT_POSFLAG_1	0x6ffffdfd	/* flags for DT_* entries, effecting */
1830Sstevel@tonic-gate 					/*	the following DT_* entry. */
1840Sstevel@tonic-gate 					/*	See DF_P1_* definitions */
1850Sstevel@tonic-gate #define	DT_SYMINSZ	0x6ffffdfe	/* syminfo table size (in bytes) */
1860Sstevel@tonic-gate #define	DT_SYMINENT	0x6ffffdff	/* syminfo entry size (in bytes) */
1870Sstevel@tonic-gate #define	DT_VALRNGHI	0x6ffffdff
1880Sstevel@tonic-gate 
1890Sstevel@tonic-gate /*
1900Sstevel@tonic-gate  * DT_* entries which fall between DT_ADDRRNGHI & DT_ADDRRNGLO use the
1910Sstevel@tonic-gate  * Dyn.d_un.d_ptr field of the Elf*_Dyn structure.
1920Sstevel@tonic-gate  *
1930Sstevel@tonic-gate  * If any adjustment is made to the ELF object after it has been
1940Sstevel@tonic-gate  * built, these entries will need to be adjusted.
1950Sstevel@tonic-gate  */
1960Sstevel@tonic-gate #define	DT_ADDRRNGLO	0x6ffffe00
1970Sstevel@tonic-gate #define	DT_CONFIG	0x6ffffefa	/* configuration information */
1980Sstevel@tonic-gate #define	DT_DEPAUDIT	0x6ffffefb	/* dependency auditing */
1990Sstevel@tonic-gate #define	DT_AUDIT	0x6ffffefc	/* object auditing */
2000Sstevel@tonic-gate #define	DT_PLTPAD	0x6ffffefd	/* pltpadding (sparcv9) */
2010Sstevel@tonic-gate #define	DT_MOVETAB	0x6ffffefe	/* move table */
2020Sstevel@tonic-gate #define	DT_SYMINFO	0x6ffffeff	/* syminfo table */
2030Sstevel@tonic-gate #define	DT_ADDRRNGHI	0x6ffffeff
2040Sstevel@tonic-gate 
2050Sstevel@tonic-gate /*
2060Sstevel@tonic-gate  * The following DT_* entries should have been assigned within one of the
2070Sstevel@tonic-gate  * DT_* ranges, but existed before such ranges had been established.
2080Sstevel@tonic-gate  */
2094716Sab196087 #define	DT_VERSYM	0x6ffffff0	/* version symbol table - unused by */
2104716Sab196087 					/*	Solaris (see libld/update.c) */
2110Sstevel@tonic-gate 
2120Sstevel@tonic-gate #define	DT_RELACOUNT	0x6ffffff9	/* number of RELATIVE relocations */
2130Sstevel@tonic-gate #define	DT_RELCOUNT	0x6ffffffa	/* number of RELATIVE relocations */
2140Sstevel@tonic-gate #define	DT_FLAGS_1	0x6ffffffb	/* state flags - see DF_1_* defs */
2150Sstevel@tonic-gate #define	DT_VERDEF	0x6ffffffc	/* version definition table and */
2160Sstevel@tonic-gate #define	DT_VERDEFNUM	0x6ffffffd	/*	associated no. of entries */
2170Sstevel@tonic-gate #define	DT_VERNEED	0x6ffffffe	/* version needed table and */
2180Sstevel@tonic-gate #define	DT_VERNEEDNUM	0x6fffffff	/* 	associated no. of entries */
2190Sstevel@tonic-gate 
2200Sstevel@tonic-gate /*
2210Sstevel@tonic-gate  * DT_* entries between DT_HIPROC and DT_LOPROC are reserved for processor
2220Sstevel@tonic-gate  * specific semantics.
2233492Sab196087  *
2243492Sab196087  * DT_* encoding rules apply to all tag values larger than DT_LOPROC.
2250Sstevel@tonic-gate  */
2260Sstevel@tonic-gate #define	DT_LOPROC	0x70000000	/* processor specific range */
2270Sstevel@tonic-gate #define	DT_AUXILIARY	0x7ffffffd	/* shared library auxiliary name */
2280Sstevel@tonic-gate #define	DT_USED		0x7ffffffe	/* ignored - same as needed */
2290Sstevel@tonic-gate #define	DT_FILTER	0x7fffffff	/* shared library filter name */
2300Sstevel@tonic-gate #define	DT_HIPROC	0x7fffffff
2310Sstevel@tonic-gate 
2320Sstevel@tonic-gate 
2330Sstevel@tonic-gate /*
2340Sstevel@tonic-gate  * Values for DT_FLAGS
2350Sstevel@tonic-gate  */
2360Sstevel@tonic-gate #define	DF_ORIGIN	0x00000001	/* ORIGIN processing required */
2370Sstevel@tonic-gate #define	DF_SYMBOLIC	0x00000002	/* symbolic bindings in effect */
2380Sstevel@tonic-gate #define	DF_TEXTREL	0x00000004	/* text relocations remain */
2390Sstevel@tonic-gate #define	DF_BIND_NOW	0x00000008	/* process all relocations */
2400Sstevel@tonic-gate #define	DF_STATIC_TLS	0x00000010	/* obj. contains static TLS refs */
2410Sstevel@tonic-gate 
2420Sstevel@tonic-gate /*
2430Sstevel@tonic-gate  * Values for the DT_POSFLAG_1 .dynamic entry.
2440Sstevel@tonic-gate  * These values only affect the following DT_* entry.
2450Sstevel@tonic-gate  */
2460Sstevel@tonic-gate #define	DF_P1_LAZYLOAD	0x00000001	/* following object is to be */
2470Sstevel@tonic-gate 					/*	lazy loaded */
2480Sstevel@tonic-gate #define	DF_P1_GROUPPERM	0x00000002	/* following object's symbols are */
2490Sstevel@tonic-gate 					/*	not available for general */
2500Sstevel@tonic-gate 					/*	symbol bindings. */
2510Sstevel@tonic-gate /*
2520Sstevel@tonic-gate  * Values for the DT_FLAGS_1 .dynamic entry.
2530Sstevel@tonic-gate  */
2540Sstevel@tonic-gate #define	DF_1_NOW	0x00000001	/* set RTLD_NOW for this object */
2550Sstevel@tonic-gate #define	DF_1_GLOBAL	0x00000002	/* set RTLD_GLOBAL for this object */
2560Sstevel@tonic-gate #define	DF_1_GROUP	0x00000004	/* set RTLD_GROUP for this object */
2570Sstevel@tonic-gate #define	DF_1_NODELETE	0x00000008	/* set RTLD_NODELETE for this object */
2580Sstevel@tonic-gate #define	DF_1_LOADFLTR	0x00000010	/* trigger filtee loading at runtime */
2590Sstevel@tonic-gate #define	DF_1_INITFIRST	0x00000020	/* set RTLD_INITFIRST for this object */
2600Sstevel@tonic-gate #define	DF_1_NOOPEN	0x00000040	/* set RTLD_NOOPEN for this object */
2610Sstevel@tonic-gate #define	DF_1_ORIGIN	0x00000080	/* ORIGIN processing required */
2620Sstevel@tonic-gate #define	DF_1_DIRECT	0x00000100	/* direct binding enabled */
2630Sstevel@tonic-gate #define	DF_1_TRANS	0x00000200
2643466Srie #define	DF_1_INTERPOSE	0x00000400	/* object is an interposer */
2650Sstevel@tonic-gate #define	DF_1_NODEFLIB	0x00000800	/* ignore default library search path */
2660Sstevel@tonic-gate #define	DF_1_NODUMP	0x00001000	/* object can't be dldump(3x)'ed */
2670Sstevel@tonic-gate #define	DF_1_CONFALT	0x00002000	/* configuration alternative created */
2680Sstevel@tonic-gate #define	DF_1_ENDFILTEE	0x00004000	/* filtee terminates filters search */
2690Sstevel@tonic-gate #define	DF_1_DISPRELDNE	0x00008000	/* disp reloc applied at build time */
2700Sstevel@tonic-gate #define	DF_1_DISPRELPND	0x00010000	/* disp reloc applied at run-time */
2710Sstevel@tonic-gate #define	DF_1_NODIRECT	0x00020000	/* object contains symbols that */
2720Sstevel@tonic-gate 					/*	cannot be directly bound to */
2731682Srie #define	DF_1_IGNMULDEF	0x00040000	/* internal: krtld ignore muldefs */
2741682Srie #define	DF_1_NOKSYMS	0x00080000	/* internal: don't export object's */
2751682Srie 					/*	symbols via /dev/ksyms */
2761698Sab196087 #define	DF_1_NOHDR	0x00100000	/* mapfile ?N:1st segment mapping */
2771698Sab196087 					/*	omits ELF & program headers */
2783850Sab196087 #define	DF_1_EDITED	0x00200000	/* object has been modified since */
2793850Sab196087 					/*	being built by 'ld' */
2801682Srie #define	DF_1_NORELOC	0x00400000	/* internal: unrelocated object */
2813466Srie #define	DF_1_SYMINTPOSE	0x00800000	/* individual symbol interposers */
2823466Srie 					/*	exist */
2834679Srie #define	DF_1_GLOBAUDIT	0x01000000	/* establish global auditing */
2845220Srie #define	DF_1_SINGLETON	0x02000000	/* singleton symbols exist */
2850Sstevel@tonic-gate 
2860Sstevel@tonic-gate /*
2871698Sab196087  * Values set to DT_FEATURE_1 tag's d_val.
2880Sstevel@tonic-gate  */
2890Sstevel@tonic-gate #define	DTF_1_PARINIT	0x00000001	/* partially initialization feature */
2900Sstevel@tonic-gate #define	DTF_1_CONFEXP	0x00000002	/* configuration file expected */
2910Sstevel@tonic-gate 
2920Sstevel@tonic-gate 
2930Sstevel@tonic-gate /*
2940Sstevel@tonic-gate  * Version structures.  There are three types of version structure:
2950Sstevel@tonic-gate  *
2960Sstevel@tonic-gate  *  o	A definition of the versions within the image itself.
2970Sstevel@tonic-gate  *	Each version definition is assigned a unique index (starting from
2980Sstevel@tonic-gate  *	VER_NDX_BGNDEF)	which is used to cross-reference symbols associated to
2990Sstevel@tonic-gate  *	the version.  Each version can have one or more dependencies on other
3000Sstevel@tonic-gate  *	version definitions within the image.  The version name, and any
3010Sstevel@tonic-gate  *	dependency names, are specified in the version definition auxiliary
3020Sstevel@tonic-gate  *	array.  Version definition entries require a version symbol index table.
3030Sstevel@tonic-gate  *
3040Sstevel@tonic-gate  *  o	A version requirement on a needed dependency.  Each needed entry
3050Sstevel@tonic-gate  *	specifies the shared object dependency (as specified in DT_NEEDED).
3060Sstevel@tonic-gate  *	One or more versions required from this dependency are specified in the
3070Sstevel@tonic-gate  *	version needed auxiliary array.
3080Sstevel@tonic-gate  *
3090Sstevel@tonic-gate  *  o	A version symbol index table.  Each symbol indexes into this array
3100Sstevel@tonic-gate  *	to determine its version index.  Index values of VER_NDX_BGNDEF or
3110Sstevel@tonic-gate  *	greater indicate the version definition to which a symbol is associated.
3120Sstevel@tonic-gate  *	(the size of a symbol index entry is recorded in the sh_info field).
3130Sstevel@tonic-gate  */
3140Sstevel@tonic-gate #ifndef	_ASM
3150Sstevel@tonic-gate 
3160Sstevel@tonic-gate typedef struct {			/* Version Definition Structure. */
3170Sstevel@tonic-gate 	Elf32_Half	vd_version;	/* this structures version revision */
3180Sstevel@tonic-gate 	Elf32_Half	vd_flags;	/* version information */
3190Sstevel@tonic-gate 	Elf32_Half	vd_ndx;		/* version index */
3200Sstevel@tonic-gate 	Elf32_Half	vd_cnt;		/* no. of associated aux entries */
3210Sstevel@tonic-gate 	Elf32_Word	vd_hash;	/* version name hash value */
3220Sstevel@tonic-gate 	Elf32_Word	vd_aux;		/* no. of bytes from start of this */
3230Sstevel@tonic-gate 					/*	verdef to verdaux array */
3240Sstevel@tonic-gate 	Elf32_Word	vd_next;	/* no. of bytes from start of this */
3250Sstevel@tonic-gate } Elf32_Verdef;				/*	verdef to next verdef entry */
3260Sstevel@tonic-gate 
3270Sstevel@tonic-gate typedef struct {			/* Verdef Auxiliary Structure. */
3280Sstevel@tonic-gate 	Elf32_Word	vda_name;	/* first element defines the version */
3290Sstevel@tonic-gate 					/*	name. Additional entries */
3300Sstevel@tonic-gate 					/*	define dependency names. */
3310Sstevel@tonic-gate 	Elf32_Word	vda_next;	/* no. of bytes from start of this */
3320Sstevel@tonic-gate } Elf32_Verdaux;			/*	verdaux to next verdaux entry */
3330Sstevel@tonic-gate 
3340Sstevel@tonic-gate 
3350Sstevel@tonic-gate typedef	struct {			/* Version Requirement Structure. */
3360Sstevel@tonic-gate 	Elf32_Half	vn_version;	/* this structures version revision */
3370Sstevel@tonic-gate 	Elf32_Half	vn_cnt;		/* no. of associated aux entries */
3380Sstevel@tonic-gate 	Elf32_Word	vn_file;	/* name of needed dependency (file) */
3390Sstevel@tonic-gate 	Elf32_Word	vn_aux;		/* no. of bytes from start of this */
3400Sstevel@tonic-gate 					/*	verneed to vernaux array */
3410Sstevel@tonic-gate 	Elf32_Word	vn_next;	/* no. of bytes from start of this */
3420Sstevel@tonic-gate } Elf32_Verneed;			/*	verneed to next verneed entry */
3430Sstevel@tonic-gate 
3440Sstevel@tonic-gate typedef struct {			/* Verneed Auxiliary Structure. */
3450Sstevel@tonic-gate 	Elf32_Word	vna_hash;	/* version name hash value */
3460Sstevel@tonic-gate 	Elf32_Half	vna_flags;	/* version information */
3470Sstevel@tonic-gate 	Elf32_Half	vna_other;
3480Sstevel@tonic-gate 	Elf32_Word	vna_name;	/* version name */
3490Sstevel@tonic-gate 	Elf32_Word	vna_next;	/* no. of bytes from start of this */
3500Sstevel@tonic-gate } Elf32_Vernaux;			/*	vernaux to next vernaux entry */
3510Sstevel@tonic-gate 
3520Sstevel@tonic-gate typedef	Elf32_Half 	Elf32_Versym;	/* Version symbol index array */
3530Sstevel@tonic-gate 
3540Sstevel@tonic-gate typedef struct {
3550Sstevel@tonic-gate 	Elf32_Half	si_boundto;	/* direct bindings - symbol bound to */
3560Sstevel@tonic-gate 	Elf32_Half	si_flags;	/* per symbol flags */
3570Sstevel@tonic-gate } Elf32_Syminfo;
3580Sstevel@tonic-gate 
3590Sstevel@tonic-gate 
3600Sstevel@tonic-gate #if defined(_LP64) || defined(_LONGLONG_TYPE)
3610Sstevel@tonic-gate typedef struct {
3620Sstevel@tonic-gate 	Elf64_Half	vd_version;	/* this structures version revision */
3630Sstevel@tonic-gate 	Elf64_Half	vd_flags;	/* version information */
3640Sstevel@tonic-gate 	Elf64_Half	vd_ndx;		/* version index */
3650Sstevel@tonic-gate 	Elf64_Half	vd_cnt;		/* no. of associated aux entries */
3660Sstevel@tonic-gate 	Elf64_Word	vd_hash;	/* version name hash value */
3670Sstevel@tonic-gate 	Elf64_Word	vd_aux;		/* no. of bytes from start of this */
3680Sstevel@tonic-gate 					/*	verdef to verdaux array */
3690Sstevel@tonic-gate 	Elf64_Word	vd_next;	/* no. of bytes from start of this */
3700Sstevel@tonic-gate } Elf64_Verdef;				/*	verdef to next verdef entry */
3710Sstevel@tonic-gate 
3720Sstevel@tonic-gate typedef struct {
3730Sstevel@tonic-gate 	Elf64_Word	vda_name;	/* first element defines the version */
3740Sstevel@tonic-gate 					/*	name. Additional entries */
3750Sstevel@tonic-gate 					/*	define dependency names. */
3760Sstevel@tonic-gate 	Elf64_Word	vda_next;	/* no. of bytes from start of this */
3770Sstevel@tonic-gate } Elf64_Verdaux;			/*	verdaux to next verdaux entry */
3780Sstevel@tonic-gate 
3790Sstevel@tonic-gate typedef struct {
3800Sstevel@tonic-gate 	Elf64_Half	vn_version;	/* this structures version revision */
3810Sstevel@tonic-gate 	Elf64_Half	vn_cnt;		/* no. of associated aux entries */
3820Sstevel@tonic-gate 	Elf64_Word	vn_file;	/* name of needed dependency (file) */
3830Sstevel@tonic-gate 	Elf64_Word	vn_aux;		/* no. of bytes from start of this */
3840Sstevel@tonic-gate 					/*	verneed to vernaux array */
3850Sstevel@tonic-gate 	Elf64_Word	vn_next;	/* no. of bytes from start of this */
3860Sstevel@tonic-gate } Elf64_Verneed;			/*	verneed to next verneed entry */
3870Sstevel@tonic-gate 
3880Sstevel@tonic-gate typedef struct {
3890Sstevel@tonic-gate 	Elf64_Word	vna_hash;	/* version name hash value */
3900Sstevel@tonic-gate 	Elf64_Half	vna_flags;	/* version information */
3910Sstevel@tonic-gate 	Elf64_Half	vna_other;
3920Sstevel@tonic-gate 	Elf64_Word	vna_name;	/* version name */
3930Sstevel@tonic-gate 	Elf64_Word	vna_next;	/* no. of bytes from start of this */
3940Sstevel@tonic-gate } Elf64_Vernaux;			/*	vernaux to next vernaux entry */
3950Sstevel@tonic-gate 
3960Sstevel@tonic-gate typedef	Elf64_Half	Elf64_Versym;
3970Sstevel@tonic-gate 
3980Sstevel@tonic-gate typedef struct {
3990Sstevel@tonic-gate 	Elf64_Half	si_boundto;	/* direct bindings - symbol bound to */
4000Sstevel@tonic-gate 	Elf64_Half	si_flags;	/* per symbol flags */
4010Sstevel@tonic-gate } Elf64_Syminfo;
4020Sstevel@tonic-gate #endif	/* defined(_LP64) || defined(_LONGLONG_TYPE) */
4030Sstevel@tonic-gate 
4040Sstevel@tonic-gate #endif	/* _ASM */
4050Sstevel@tonic-gate 
4060Sstevel@tonic-gate /*
4070Sstevel@tonic-gate  * Versym symbol index values.  Values greater than VER_NDX_GLOBAL
4080Sstevel@tonic-gate  * and less then VER_NDX_LORESERVE associate symbols with user
4090Sstevel@tonic-gate  * specified version descriptors.
4100Sstevel@tonic-gate  */
4110Sstevel@tonic-gate #define	VER_NDX_LOCAL		0	/* symbol is local */
4120Sstevel@tonic-gate #define	VER_NDX_GLOBAL		1	/* symbol is global and assigned to */
4130Sstevel@tonic-gate 					/*	the base version */
4140Sstevel@tonic-gate #define	VER_NDX_LORESERVE	0xff00	/* beginning of RESERVED entries */
4150Sstevel@tonic-gate #define	VER_NDX_ELIMINATE	0xff01	/* symbol is to be eliminated */
4160Sstevel@tonic-gate 
4170Sstevel@tonic-gate /*
4180Sstevel@tonic-gate  * Verdef and Verneed (via Veraux) flags values.
4190Sstevel@tonic-gate  */
4200Sstevel@tonic-gate #define	VER_FLG_BASE		0x1	/* version definition of file itself */
4210Sstevel@tonic-gate #define	VER_FLG_WEAK		0x2	/* weak version identifier */
4220Sstevel@tonic-gate 
4230Sstevel@tonic-gate /*
4240Sstevel@tonic-gate  * Verdef version values.
4250Sstevel@tonic-gate  */
4260Sstevel@tonic-gate #define	VER_DEF_NONE		0	/* Ver_def version */
4270Sstevel@tonic-gate #define	VER_DEF_CURRENT		1
4280Sstevel@tonic-gate #define	VER_DEF_NUM		2
4290Sstevel@tonic-gate 
4300Sstevel@tonic-gate /*
4310Sstevel@tonic-gate  * Verneed version values.
4320Sstevel@tonic-gate  */
4330Sstevel@tonic-gate #define	VER_NEED_NONE		0	/* Ver_need version */
4340Sstevel@tonic-gate #define	VER_NEED_CURRENT	1
4350Sstevel@tonic-gate #define	VER_NEED_NUM		2
4360Sstevel@tonic-gate 
4370Sstevel@tonic-gate 
4380Sstevel@tonic-gate /*
4390Sstevel@tonic-gate  * Syminfo flag values
4400Sstevel@tonic-gate  */
4410Sstevel@tonic-gate #define	SYMINFO_FLG_DIRECT	0x0001	/* symbol ref has direct association */
4420Sstevel@tonic-gate 					/*	to object containing defn. */
4430Sstevel@tonic-gate #define	SYMINFO_FLG_PASSTHRU	0x0002	/* ignored - see SYMINFO_FLG_FILTER */
4440Sstevel@tonic-gate #define	SYMINFO_FLG_COPY	0x0004	/* symbol is a copy-reloc */
4453466Srie #define	SYMINFO_FLG_LAZYLOAD	0x0008	/* object containing defn. should be */
4460Sstevel@tonic-gate 					/*	lazily-loaded */
4470Sstevel@tonic-gate #define	SYMINFO_FLG_DIRECTBIND	0x0010	/* ref should be bound directly to */
4480Sstevel@tonic-gate 					/*	object containing defn. */
4490Sstevel@tonic-gate #define	SYMINFO_FLG_NOEXTDIRECT	0x0020	/* don't let an external reference */
4500Sstevel@tonic-gate 					/*	directly bind to this symbol */
4510Sstevel@tonic-gate #define	SYMINFO_FLG_FILTER	0x0002	/* symbol ref is associated to a */
4520Sstevel@tonic-gate #define	SYMINFO_FLG_AUXILIARY	0x0040	/* 	standard or auxiliary filter */
4533466Srie #define	SYMINFO_FLG_INTERPOSE	0x0080	/* symbol defines an interposer */
4540Sstevel@tonic-gate 
4550Sstevel@tonic-gate /*
4560Sstevel@tonic-gate  * Syminfo.si_boundto values.
4570Sstevel@tonic-gate  */
4580Sstevel@tonic-gate #define	SYMINFO_BT_SELF		0xffff	/* symbol bound to self */
4590Sstevel@tonic-gate #define	SYMINFO_BT_PARENT	0xfffe	/* symbol bound to parent */
4600Sstevel@tonic-gate #define	SYMINFO_BT_NONE		0xfffd	/* no special symbol binding */
4610Sstevel@tonic-gate #define	SYMINFO_BT_EXTERN	0xfffc	/* symbol defined as external */
4620Sstevel@tonic-gate #define	SYMINFO_BT_LOWRESERVE	0xff00	/* beginning of reserved entries */
4630Sstevel@tonic-gate 
4640Sstevel@tonic-gate /*
4650Sstevel@tonic-gate  * Syminfo version values.
4660Sstevel@tonic-gate  */
4670Sstevel@tonic-gate #define	SYMINFO_NONE		0	/* Syminfo version */
4680Sstevel@tonic-gate #define	SYMINFO_CURRENT		1
4690Sstevel@tonic-gate #define	SYMINFO_NUM		2
4700Sstevel@tonic-gate 
4710Sstevel@tonic-gate 
4720Sstevel@tonic-gate /*
4730Sstevel@tonic-gate  * Public structure defined and maintained within the runtime linker
4740Sstevel@tonic-gate  */
4750Sstevel@tonic-gate #ifndef	_ASM
4760Sstevel@tonic-gate 
4770Sstevel@tonic-gate typedef struct link_map	Link_map;
4780Sstevel@tonic-gate 
4790Sstevel@tonic-gate struct link_map {
4800Sstevel@tonic-gate 	unsigned long	l_addr;		/* address at which object is mapped */
4810Sstevel@tonic-gate 	char 		*l_name;	/* full name of loaded object */
4820Sstevel@tonic-gate #ifdef _LP64
4830Sstevel@tonic-gate 	Elf64_Dyn	*l_ld;		/* dynamic structure of object */
4840Sstevel@tonic-gate #else
4850Sstevel@tonic-gate 	Elf32_Dyn	*l_ld;		/* dynamic structure of object */
4860Sstevel@tonic-gate #endif
4870Sstevel@tonic-gate 	Link_map	*l_next;	/* next link object */
4880Sstevel@tonic-gate 	Link_map	*l_prev;	/* previous link object */
4890Sstevel@tonic-gate 	char		*l_refname;	/* filters reference name */
4900Sstevel@tonic-gate };
4910Sstevel@tonic-gate 
4920Sstevel@tonic-gate #ifdef _SYSCALL32
4930Sstevel@tonic-gate typedef struct link_map32 Link_map32;
4940Sstevel@tonic-gate 
4950Sstevel@tonic-gate struct link_map32 {
4960Sstevel@tonic-gate 	Elf32_Word	l_addr;
4970Sstevel@tonic-gate 	Elf32_Addr	l_name;
4980Sstevel@tonic-gate 	Elf32_Addr	l_ld;
4990Sstevel@tonic-gate 	Elf32_Addr	l_next;
5000Sstevel@tonic-gate 	Elf32_Addr	l_prev;
5010Sstevel@tonic-gate 	Elf32_Addr	l_refname;
5020Sstevel@tonic-gate };
5030Sstevel@tonic-gate #endif
5040Sstevel@tonic-gate 
5050Sstevel@tonic-gate typedef enum {
5060Sstevel@tonic-gate 	RT_CONSISTENT,
5070Sstevel@tonic-gate 	RT_ADD,
5080Sstevel@tonic-gate 	RT_DELETE
5090Sstevel@tonic-gate } r_state_e;
5100Sstevel@tonic-gate 
5110Sstevel@tonic-gate typedef enum {
5120Sstevel@tonic-gate 	RD_FL_NONE = 0,		/* no flags */
5130Sstevel@tonic-gate 	RD_FL_ODBG = (1<<0),	/* old style debugger present */
5140Sstevel@tonic-gate 	RD_FL_DBG = (1<<1)	/* debugging enabled */
5150Sstevel@tonic-gate } rd_flags_e;
5160Sstevel@tonic-gate 
5170Sstevel@tonic-gate 
5180Sstevel@tonic-gate 
5190Sstevel@tonic-gate /*
5200Sstevel@tonic-gate  * Debugging events enabled inside of the runtime linker.  To
5210Sstevel@tonic-gate  * access these events see the librtld_db interface.
5220Sstevel@tonic-gate  */
5230Sstevel@tonic-gate typedef enum {
5240Sstevel@tonic-gate 	RD_NONE = 0,		/* no event */
5250Sstevel@tonic-gate 	RD_PREINIT,		/* the Initial rendezvous before .init */
5260Sstevel@tonic-gate 	RD_POSTINIT,		/* the Second rendezvous after .init */
5270Sstevel@tonic-gate 	RD_DLACTIVITY		/* a dlopen or dlclose has happened */
5280Sstevel@tonic-gate } rd_event_e;
5290Sstevel@tonic-gate 
5300Sstevel@tonic-gate struct r_debug {
5310Sstevel@tonic-gate 	int		r_version;	/* debugging info version no. */
5320Sstevel@tonic-gate 	Link_map	*r_map;		/* address of link_map */
5330Sstevel@tonic-gate 	unsigned long	r_brk;		/* address of update routine */
5340Sstevel@tonic-gate 	r_state_e	r_state;
5350Sstevel@tonic-gate 	unsigned long	r_ldbase;	/* base addr of ld.so */
5360Sstevel@tonic-gate 	Link_map	*r_ldsomap;	/* address of ld.so.1's link map */
5370Sstevel@tonic-gate 	rd_event_e	r_rdevent;	/* debug event */
5380Sstevel@tonic-gate 	rd_flags_e	r_flags;	/* misc flags. */
5390Sstevel@tonic-gate };
5400Sstevel@tonic-gate 
5410Sstevel@tonic-gate #ifdef _SYSCALL32
5420Sstevel@tonic-gate struct r_debug32 {
5430Sstevel@tonic-gate 	Elf32_Word	r_version;	/* debugging info version no. */
5440Sstevel@tonic-gate 	Elf32_Addr	r_map;		/* address of link_map */
5450Sstevel@tonic-gate 	Elf32_Word	r_brk;		/* address of update routine */
5460Sstevel@tonic-gate 	r_state_e	r_state;
5470Sstevel@tonic-gate 	Elf32_Word	r_ldbase;	/* base addr of ld.so */
5480Sstevel@tonic-gate 	Elf32_Addr	r_ldsomap;	/* address of ld.so.1's link map */
5490Sstevel@tonic-gate 	rd_event_e	r_rdevent;	/* debug event */
5500Sstevel@tonic-gate 	rd_flags_e	r_flags;	/* misc flags. */
5510Sstevel@tonic-gate };
5520Sstevel@tonic-gate #endif
5530Sstevel@tonic-gate 
5540Sstevel@tonic-gate 
5550Sstevel@tonic-gate #define	R_DEBUG_VERSION	2		/* current r_debug version */
5560Sstevel@tonic-gate #endif	/* _ASM */
5570Sstevel@tonic-gate 
5580Sstevel@tonic-gate /*
5590Sstevel@tonic-gate  * Attribute/value structures used to bootstrap ELF-based dynamic linker.
5600Sstevel@tonic-gate  */
5610Sstevel@tonic-gate #ifndef	_ASM
5620Sstevel@tonic-gate typedef struct {
5630Sstevel@tonic-gate 	Elf32_Sword eb_tag;		/* what this one is */
5640Sstevel@tonic-gate 	union {				/* possible values */
5650Sstevel@tonic-gate 		Elf32_Word eb_val;
5660Sstevel@tonic-gate 		Elf32_Addr eb_ptr;
5670Sstevel@tonic-gate 		Elf32_Off  eb_off;
5680Sstevel@tonic-gate 	} eb_un;
5690Sstevel@tonic-gate } Elf32_Boot;
5700Sstevel@tonic-gate 
5710Sstevel@tonic-gate #if defined(_LP64) || defined(_LONGLONG_TYPE)
5720Sstevel@tonic-gate typedef struct {
5730Sstevel@tonic-gate 	Elf64_Xword eb_tag;		/* what this one is */
5740Sstevel@tonic-gate 	union {				/* possible values */
5750Sstevel@tonic-gate 		Elf64_Xword eb_val;
5760Sstevel@tonic-gate 		Elf64_Addr eb_ptr;
5770Sstevel@tonic-gate 		Elf64_Off eb_off;
5780Sstevel@tonic-gate 	} eb_un;
5790Sstevel@tonic-gate } Elf64_Boot;
5800Sstevel@tonic-gate #endif	/* defined(_LP64) || defined(_LONGLONG_TYPE) */
5810Sstevel@tonic-gate #endif	/* _ASM */
5820Sstevel@tonic-gate 
5830Sstevel@tonic-gate /*
5840Sstevel@tonic-gate  * Attributes
5850Sstevel@tonic-gate  */
5860Sstevel@tonic-gate #define	EB_NULL		0		/* (void) last entry */
5870Sstevel@tonic-gate #define	EB_DYNAMIC	1		/* (*) dynamic structure of subject */
5880Sstevel@tonic-gate #define	EB_LDSO_BASE	2		/* (caddr_t) base address of ld.so */
5890Sstevel@tonic-gate #define	EB_ARGV		3		/* (caddr_t) argument vector */
5900Sstevel@tonic-gate #define	EB_ENVP		4		/* (char **) environment strings */
5910Sstevel@tonic-gate #define	EB_AUXV		5		/* (auxv_t *) auxiliary vector */
5920Sstevel@tonic-gate #define	EB_DEVZERO	6		/* (int) fd for /dev/zero */
5930Sstevel@tonic-gate #define	EB_PAGESIZE	7		/* (int) page size */
5940Sstevel@tonic-gate #define	EB_MAX		8		/* number of "EBs" */
5950Sstevel@tonic-gate #define	EB_MAX_SIZE32	64		/* size in bytes, _ILP32 */
5960Sstevel@tonic-gate #define	EB_MAX_SIZE64	128		/* size in bytes, _LP64 */
5970Sstevel@tonic-gate 
5980Sstevel@tonic-gate 
5990Sstevel@tonic-gate #ifndef	_ASM
6000Sstevel@tonic-gate 
6010Sstevel@tonic-gate #ifdef __STDC__
6020Sstevel@tonic-gate 
6030Sstevel@tonic-gate /*
6040Sstevel@tonic-gate  * Concurrency communication structure for libc callbacks.
6050Sstevel@tonic-gate  */
6060Sstevel@tonic-gate extern void	_ld_libc(void *);
6070Sstevel@tonic-gate #else /* __STDC__ */
6080Sstevel@tonic-gate extern void	_ld_libc();
6090Sstevel@tonic-gate #endif /* __STDC__ */
6100Sstevel@tonic-gate 
6110Sstevel@tonic-gate #pragma unknown_control_flow(_ld_libc)
6120Sstevel@tonic-gate #endif /* _ASM */
6130Sstevel@tonic-gate 
6140Sstevel@tonic-gate #ifdef	__cplusplus
6150Sstevel@tonic-gate }
6160Sstevel@tonic-gate #endif
6170Sstevel@tonic-gate 
6180Sstevel@tonic-gate #endif	/* _SYS_LINK_H */
619