link.h revision 4679:3d9b5e6569cc
190075Sobrien/*
218334Speter * CDDL HEADER START
3132718Skan *
490075Sobrien * The contents of this file are subject to the terms of the
5132718Skan * Common Development and Distribution License (the "License").
690075Sobrien * You may not use this file except in compliance with the License.
790075Sobrien *
890075Sobrien * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
990075Sobrien * or http://www.opensolaris.org/os/licensing.
10132718Skan * See the License for the specific language governing permissions
1190075Sobrien * and limitations under the License.
1290075Sobrien *
1390075Sobrien * When distributing Covered Code, include this CDDL HEADER in each
1490075Sobrien * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
1590075Sobrien * If applicable, add the following below this CDDL HEADER, with the
16132718Skan * fields enclosed by brackets "[]" replaced with your own identifying
17169689Skan * information: Portions Copyright [yyyy] [name of copyright owner]
18169689Skan *
1990075Sobrien * CDDL HEADER END
2090075Sobrien */
2190075Sobrien/*
2290075Sobrien * Copyright 2007 Sun Microsystems, Inc.  All rights reserved.
2390075Sobrien * Use is subject to license terms.
2490075Sobrien */
2590075Sobrien
2690075Sobrien#ifndef _LINK_H
2790075Sobrien#define	_LINK_H
2890075Sobrien
2990075Sobrien#pragma ident	"%Z%%M%	%I%	%E% SMI"
3090075Sobrien
3190075Sobrien#include <sys/link.h>
3290075Sobrien
3390075Sobrien#ifndef _ASM
3418334Speter#include <libelf.h>
3518334Speter#include <sys/types.h>
3618334Speter#include <dlfcn.h>
3718334Speter#endif
3818334Speter
3918334Speter#ifdef	__cplusplus
4018334Speterextern "C" {
4118334Speter#endif
4218334Speter
4318334Speter#ifndef _ASM
4418334Speter/*
4518334Speter * ld support library calls
4618334Speter */
4790075Sobrien#ifdef __STDC__
4890075Sobrienextern uint_t	ld_version(uint_t);
49extern void	ld_input_done(uint_t *);
50
51extern void	ld_start(const char *, const Elf32_Half, const char *);
52extern void	ld_atexit(int);
53extern void	ld_open(const char **, const char **, int *, int, Elf **,
54			Elf *, size_t, const Elf_Kind);
55extern void	ld_file(const char *, const Elf_Kind, int, Elf *);
56extern void	ld_input_section(const char *, Elf32_Shdr **, Elf32_Word,
57			Elf_Data *, Elf *, uint_t *);
58extern void	ld_section(const char *, Elf32_Shdr *, Elf32_Word,
59			Elf_Data *, Elf *);
60
61#if defined(_LP64) || defined(_LONGLONG_TYPE)
62extern void	ld_start64(const char *, const Elf64_Half, const char *);
63extern void	ld_atexit64(int);
64extern void	ld_open64(const char **, const char **, int *, int, Elf **,
65			Elf *, size_t, const Elf_Kind);
66extern void	ld_file64(const char *, const Elf_Kind, int, Elf *);
67extern void	ld_input_section64(const char *, Elf64_Shdr **, Elf64_Word,
68			Elf_Data *, Elf *, uint_t *);
69extern void	ld_section64(const char *, Elf64_Shdr *, Elf64_Word,
70			Elf_Data *, Elf *);
71
72#endif /* (defined(_LP64) || defined(_LONGLONG_TYPE) */
73#else
74extern void	ld_version();
75extern void	ld_input_done();
76
77extern void	ld_start();
78extern void	ld_atexit();
79extern void	ld_open();
80extern void	ld_file();
81extern void	ld_input_section();
82extern void	ld_section();
83
84#if defined(_LP64) || defined(_LONGLONG_TYPE)
85extern void	ld_start64();
86extern void	ld_atexit64();
87extern void	ld_open64();
88extern void	ld_file64();
89extern void	ld_input_section64();
90extern void	ld_section64();
91
92#endif /* (defined(_LP64) || defined(_LONGLONG_TYPE) */
93#endif /* __STDC__ */
94
95/*
96 * ld_version() version values.
97 */
98#define	LD_SUP_VNONE	0
99#define	LD_SUP_VERSION1	1
100#define	LD_SUP_VERSION2	2
101#define	LD_SUP_VERSION3	3
102#define	LD_SUP_VCURRENT	LD_SUP_VERSION3
103
104/*
105 * Flags passed to ld support calls.
106 */
107#define	LD_SUP_DERIVED		0x1	/* derived filename */
108#define	LD_SUP_INHERITED	0x2	/* file inherited from .so DT_NEEDED */
109#define	LD_SUP_EXTRACTED	0x4	/* file extracted from archive */
110#endif
111
112/*
113 * Runtime link-map identifiers.
114 */
115#define	LM_ID_BASE		0x00
116#define	LM_ID_LDSO		0x01
117#define	LM_ID_BRAND		0x02	/* marks branded objs in rd_loadobj_t */
118
119#define	LM_ID_NUM		3
120
121
122#define	LM_ID_NEWLM		0xff	/* create a new link-map */
123
124/*
125 * Runtime Link-Edit Auditing.
126 */
127#define	LAV_NONE		0
128#define	LAV_VERSION1		1
129#define	LAV_VERSION2		2
130#define	LAV_VERSION3		3
131#define	LAV_VERSION4		4
132#define	LAV_CURRENT		LAV_VERSION4
133#define	LAV_NUM			5
134
135/*
136 * Flags that can be or'd into the la_objopen() return code
137 */
138#define	LA_FLG_BINDTO		0x0001	/* audit symbinds TO this object */
139#define	LA_FLG_BINDFROM		0x0002	/* audit symbinding FROM this object */
140
141/*
142 * Flags that can be or'd into the 'flags' argument of la_symbind()
143 */
144#define	LA_SYMB_NOPLTENTER	0x0001	/* disable pltenter for this symbol */
145#define	LA_SYMB_NOPLTEXIT	0x0002	/* disable pltexit for this symbol */
146#define	LA_SYMB_STRUCTCALL	0x0004	/* this function call passes a */
147					/*	structure as it's return code */
148#define	LA_SYMB_DLSYM		0x0008	/* this symbol bindings is due to */
149					/*	a call to dlsym() */
150#define	LA_SYMB_ALTVALUE	0x0010	/* alternate symbol binding returned */
151					/*	by la_symbind() */
152
153/*
154 * Flags that describe the object passed to la_objsearch()
155 */
156#define	LA_SER_ORIG		0x001	/* original (needed) name */
157#define	LA_SER_LIBPATH		0x002	/* LD_LIBRARY_PATH entry prepended */
158#define	LA_SER_RUNPATH		0x004	/* runpath entry prepended */
159#define	LA_SER_CONFIG		0x008	/* configuration entry prepended */
160#define	LA_SER_DEFAULT		0x040	/* default path prepended */
161#define	LA_SER_SECURE		0x080	/* default (secure) path prepended */
162
163#define	LA_SER_MASK		0xfff	/* mask of known flags */
164
165/*
166 * Flags that describe the la_activity()
167 */
168#define	LA_ACT_CONSISTENT	0x00	/* add/deletion of objects complete */
169#define	LA_ACT_ADD		0x01	/* objects being added */
170#define	LA_ACT_DELETE		0x02	/* objects being deleted */
171
172
173#ifndef	_KERNEL
174#ifndef	_ASM
175
176#if defined(_LP64)
177typedef long	lagreg_t;
178#else
179typedef int	lagreg_t;
180#endif
181
182struct _la_sparc_regs {
183	lagreg_t	lr_rego0;
184	lagreg_t	lr_rego1;
185	lagreg_t	lr_rego2;
186	lagreg_t	lr_rego3;
187	lagreg_t	lr_rego4;
188	lagreg_t	lr_rego5;
189	lagreg_t	lr_rego6;
190	lagreg_t	lr_rego7;
191};
192
193#if defined(_LP64)
194typedef struct _la_sparc_regs	La_sparcv9_regs;
195typedef struct {
196	lagreg_t	lr_rsp;
197	lagreg_t	lr_rbp;
198	lagreg_t	lr_rdi;	    /* arg1 */
199	lagreg_t	lr_rsi;	    /* arg2 */
200	lagreg_t	lr_rdx;	    /* arg3 */
201	lagreg_t	lr_rcx;	    /* arg4 */
202	lagreg_t	lr_r8;	    /* arg5 */
203	lagreg_t	lr_r9;	    /* arg6 */
204} La_amd64_regs;
205#else
206typedef struct _la_sparc_regs	La_sparcv8_regs;
207typedef struct {
208	lagreg_t	lr_esp;
209	lagreg_t	lr_ebp;
210} La_i86_regs;
211#endif
212
213#if	!defined(_SYS_INT_TYPES_H)
214#if	defined(_LP64) || defined(_I32LPx)
215typedef unsigned long		uintptr_t;
216#else
217typedef	unsigned int		uintptr_t;
218#endif
219#endif
220
221
222#ifdef	__STDC__
223extern uint_t		la_version(uint_t);
224extern void		la_activity(uintptr_t *, uint_t);
225extern void		la_preinit(uintptr_t *);
226extern char		*la_objsearch(const char *, uintptr_t *, uint_t);
227extern uint_t		la_objopen(Link_map *, Lmid_t, uintptr_t *);
228extern uint_t		la_objclose(uintptr_t *);
229extern int		la_objfilter(uintptr_t *, const char *, uintptr_t *,
230				uint_t);
231#if	defined(_LP64)
232extern uintptr_t	la_amd64_pltenter(Elf64_Sym *, uint_t, uintptr_t *,
233				uintptr_t *, La_amd64_regs *,	uint_t *,
234				const char *);
235extern uintptr_t	la_symbind64(Elf64_Sym *, uint_t, uintptr_t *,
236				uintptr_t *, uint_t *, const char *);
237extern uintptr_t	la_sparcv9_pltenter(Elf64_Sym *, uint_t, uintptr_t *,
238				uintptr_t *, La_sparcv9_regs *,	uint_t *,
239				const char *);
240extern uintptr_t	la_pltexit64(Elf64_Sym *, uint_t, uintptr_t *,
241				uintptr_t *, uintptr_t, const char *);
242#else  /* !defined(_LP64) */
243extern uintptr_t	la_symbind32(Elf32_Sym *, uint_t, uintptr_t *,
244				uintptr_t *, uint_t *);
245extern uintptr_t	la_sparcv8_pltenter(Elf32_Sym *, uint_t, uintptr_t *,
246				uintptr_t *, La_sparcv8_regs *, uint_t *);
247extern uintptr_t	la_i86_pltenter(Elf32_Sym *, uint_t, uintptr_t *,
248				uintptr_t *, La_i86_regs *, uint_t *);
249extern uintptr_t	la_pltexit(Elf32_Sym *, uint_t, uintptr_t *,
250				uintptr_t *, uintptr_t);
251#endif /* _LP64 */
252#else  /* __STDC__ */
253extern uint_t		la_version();
254extern void		la_preinit();
255extern uint_t		la_objopen();
256extern uint_t		la_objclose();
257extern int		la_objfilter();
258#if	defined(_LP64)
259extern uintptr_t	la_sparcv9_pltenter();
260extern uintptr_t	la_pltexit64();
261extern uintptr_t	la_symbind64();
262#else  /* _ILP32 */
263extern uintptr_t	la_sparcv8_pltenter();
264extern uintptr_t	la_i86_pltenter();
265extern uintptr_t	la_pltexit();
266extern uintptr_t	la_symbind32();
267#endif /* _LP64 */
268#endif /* __STDC__ */
269
270
271#endif /* _ASM */
272#endif /* _KERNEL */
273
274#ifdef __cplusplus
275}
276#endif
277
278#endif	/* _LINK_H */
279