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