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