xref: /illumos-gate/usr/src/head/link.h (revision ba3594ba)
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  * Copyright 2014 Garrett D'Amore <garrett@damore.org>
23  * Copyright (c) 1989, 2010, Oracle and/or its affiliates. All rights reserved.
24  */
25 
26 #ifndef _LINK_H
27 #define	_LINK_H
28 
29 #include <sys/link.h>
30 
31 #ifndef _ASM
32 #include <elf.h>
33 #include <sys/types.h>
34 #include <dlfcn.h>
35 #endif
36 
37 #ifdef	__cplusplus
38 extern "C" {
39 #endif
40 
41 #ifndef _ASM
42 /*
43  * ld support library calls.
44  *
45  * These cannot be used in a 32bit large file capable environment because
46  * libelf is not large-file safe.  Only define these interfaces if we are not
47  * 32bit, or not in the large file environment.
48  */
49 #if !defined(_ILP32) || _FILE_OFFSET_BITS != 64
50 #include <libelf.h>
51 extern uint_t	ld_version(uint_t);
52 extern void	ld_input_done(uint_t *);
53 
54 extern void	ld_start(const char *, const Elf32_Half, const char *);
55 extern void	ld_atexit(int);
56 extern void	ld_open(const char **, const char **, int *, int, Elf **,
57 			Elf *, size_t, const Elf_Kind);
58 extern void	ld_file(const char *, const Elf_Kind, int, Elf *);
59 extern void	ld_input_section(const char *, Elf32_Shdr **, Elf32_Word,
60 			Elf_Data *, Elf *, uint_t *);
61 extern void	ld_section(const char *, Elf32_Shdr *, Elf32_Word,
62 			Elf_Data *, Elf *);
63 
64 #if defined(_LP64) || defined(_LONGLONG_TYPE)
65 extern void	ld_start64(const char *, const Elf64_Half, const char *);
66 extern void	ld_atexit64(int);
67 extern void	ld_open64(const char **, const char **, int *, int, Elf **,
68 			Elf *, size_t, const Elf_Kind);
69 extern void	ld_file64(const char *, const Elf_Kind, int, Elf *);
70 extern void	ld_input_section64(const char *, Elf64_Shdr **, Elf64_Word,
71 			Elf_Data *, Elf *, uint_t *);
72 extern void	ld_section64(const char *, Elf64_Shdr *, Elf64_Word,
73 			Elf_Data *, Elf *);
74 
75 #endif /* (defined(_LP64) || defined(_LONGLONG_TYPE) */
76 #endif /* !defined(_ILP32) || _FILE_OFFSET_BITS != 64 */
77 
78 /*
79  * ld_version() version values.
80  */
81 #define	LD_SUP_VNONE	0
82 #define	LD_SUP_VERSION1	1
83 #define	LD_SUP_VERSION2	2
84 #define	LD_SUP_VERSION3	3
85 #define	LD_SUP_VCURRENT	LD_SUP_VERSION3
86 
87 /*
88  * Flags passed to ld support calls.
89  */
90 #define	LD_SUP_DERIVED		0x1	/* derived filename */
91 #define	LD_SUP_INHERITED	0x2	/* file inherited from .so DT_NEEDED */
92 #define	LD_SUP_EXTRACTED	0x4	/* file extracted from archive */
93 #endif
94 
95 /*
96  * Runtime link-map identifiers.
97  */
98 #define	LM_ID_BASE		0x00
99 #define	LM_ID_LDSO		0x01
100 #define	LM_ID_NUM		2
101 
102 #define	LM_ID_BRAND		0xfd	/* brand emulation linkmap objs */
103 #define	LM_ID_NONE		0xfe	/* no link map specified */
104 #define	LM_ID_NEWLM		0xff	/* create a new link-map */
105 
106 /*
107  * Runtime Link-Edit Auditing.
108  */
109 #define	LAV_NONE		0
110 #define	LAV_VERSION1		1
111 #define	LAV_VERSION2		2
112 #define	LAV_VERSION3		3
113 #define	LAV_VERSION4		4
114 #define	LAV_VERSION5		5
115 #define	LAV_CURRENT		LAV_VERSION5
116 #define	LAV_NUM			6
117 
118 /*
119  * Flags that can be or'd into the la_objopen() return code
120  */
121 #define	LA_FLG_BINDTO		0x0001	/* audit symbinds TO this object */
122 #define	LA_FLG_BINDFROM		0x0002	/* audit symbinding FROM this object */
123 
124 /*
125  * Flags that can be or'd into the 'flags' argument of la_symbind()
126  */
127 #define	LA_SYMB_NOPLTENTER	0x0001	/* disable pltenter for this symbol */
128 #define	LA_SYMB_NOPLTEXIT	0x0002	/* disable pltexit for this symbol */
129 #define	LA_SYMB_STRUCTCALL	0x0004	/* this function call passes a */
130 					/*	structure as it's return code */
131 #define	LA_SYMB_DLSYM		0x0008	/* this symbol bindings is due to */
132 					/*	a call to dlsym() */
133 #define	LA_SYMB_ALTVALUE	0x0010	/* alternate symbol binding returned */
134 					/*	by la_symbind() */
135 
136 /*
137  * Flags that describe the object passed to la_objsearch()
138  */
139 #define	LA_SER_ORIG		0x001	/* original (needed) name */
140 #define	LA_SER_LIBPATH		0x002	/* LD_LIBRARY_PATH entry prepended */
141 #define	LA_SER_RUNPATH		0x004	/* runpath entry prepended */
142 #define	LA_SER_CONFIG		0x008	/* configuration entry prepended */
143 #define	LA_SER_DEFAULT		0x040	/* default path prepended */
144 #define	LA_SER_SECURE		0x080	/* default (secure) path prepended */
145 
146 #define	LA_SER_MASK		0xfff	/* mask of known flags */
147 
148 /*
149  * Flags that describe the la_activity()
150  */
151 #define	LA_ACT_CONSISTENT	0x00	/* add/deletion of objects complete */
152 #define	LA_ACT_ADD		0x01	/* objects being added */
153 #define	LA_ACT_DELETE		0x02	/* objects being deleted */
154 #define	LA_ACT_MAX		3
155 
156 
157 #ifndef	_KERNEL
158 #ifndef	_ASM
159 
160 #if defined(_LP64)
161 typedef long	lagreg_t;
162 #else
163 typedef int	lagreg_t;
164 #endif
165 
166 struct _la_sparc_regs {
167 	lagreg_t	lr_rego0;
168 	lagreg_t	lr_rego1;
169 	lagreg_t	lr_rego2;
170 	lagreg_t	lr_rego3;
171 	lagreg_t	lr_rego4;
172 	lagreg_t	lr_rego5;
173 	lagreg_t	lr_rego6;
174 	lagreg_t	lr_rego7;
175 };
176 
177 #if defined(_LP64)
178 typedef struct _la_sparc_regs	La_sparcv9_regs;
179 typedef struct {
180 	lagreg_t	lr_rsp;
181 	lagreg_t	lr_rbp;
182 	lagreg_t	lr_rdi;	    /* arg1 */
183 	lagreg_t	lr_rsi;	    /* arg2 */
184 	lagreg_t	lr_rdx;	    /* arg3 */
185 	lagreg_t	lr_rcx;	    /* arg4 */
186 	lagreg_t	lr_r8;	    /* arg5 */
187 	lagreg_t	lr_r9;	    /* arg6 */
188 } La_amd64_regs;
189 #else
190 typedef struct _la_sparc_regs	La_sparcv8_regs;
191 typedef struct {
192 	lagreg_t	lr_esp;
193 	lagreg_t	lr_ebp;
194 } La_i86_regs;
195 #endif
196 
197 #if	!defined(_SYS_INT_TYPES_H)
198 #if	defined(_LP64) || defined(_I32LPx)
199 typedef unsigned long		uintptr_t;
200 #else
201 typedef	unsigned int		uintptr_t;
202 #endif
203 #endif
204 
205 
206 extern uint_t		la_version(uint_t);
207 extern void		la_activity(uintptr_t *, uint_t);
208 extern void		la_preinit(uintptr_t *);
209 extern char		*la_objsearch(const char *, uintptr_t *, uint_t);
210 extern uint_t		la_objopen(Link_map *, Lmid_t, uintptr_t *);
211 extern uint_t		la_objclose(uintptr_t *);
212 extern int		la_objfilter(uintptr_t *, const char *, uintptr_t *,
213 				uint_t);
214 #if	defined(_LP64)
215 extern uintptr_t	la_amd64_pltenter(Elf64_Sym *, uint_t, uintptr_t *,
216 				uintptr_t *, La_amd64_regs *,	uint_t *,
217 				const char *);
218 extern uintptr_t	la_symbind64(Elf64_Sym *, uint_t, uintptr_t *,
219 				uintptr_t *, uint_t *, const char *);
220 extern uintptr_t	la_sparcv9_pltenter(Elf64_Sym *, uint_t, uintptr_t *,
221 				uintptr_t *, La_sparcv9_regs *,	uint_t *,
222 				const char *);
223 extern uintptr_t	la_pltexit64(Elf64_Sym *, uint_t, uintptr_t *,
224 				uintptr_t *, uintptr_t, const char *);
225 #else  /* !defined(_LP64) */
226 extern uintptr_t	la_symbind32(Elf32_Sym *, uint_t, uintptr_t *,
227 				uintptr_t *, uint_t *);
228 extern uintptr_t	la_sparcv8_pltenter(Elf32_Sym *, uint_t, uintptr_t *,
229 				uintptr_t *, La_sparcv8_regs *, uint_t *);
230 extern uintptr_t	la_i86_pltenter(Elf32_Sym *, uint_t, uintptr_t *,
231 				uintptr_t *, La_i86_regs *, uint_t *);
232 extern uintptr_t	la_pltexit(Elf32_Sym *, uint_t, uintptr_t *,
233 				uintptr_t *, uintptr_t);
234 #endif /* _LP64 */
235 
236 /*
237  * The ElfW() macro is a GNU/Linux feature, provided as support for
238  * the dl_phdr_info structure used by dl_phdr_iterate(), which also
239  * originated under Linux. Given an ELF data type, without the ElfXX_
240  * prefix, it supplies the appropriate prefix (Elf32_ or Elf64_) for
241  * the ELFCLASS of the code being compiled.
242  *
243  * Note that ElfW() is not suitable in situations in which the ELFCLASS
244  * of the code being compiled does not match that of the objects that
245  * code is intended to operate on (e.g. a 32-bit link-editor building
246  * a 64-bit object). The macros defined in <sys/machelf.h> are
247  * recommended in such cases.
248  */
249 #ifdef _LP64
250 #define	ElfW(type)	Elf64_ ## type
251 #else
252 #define	ElfW(type)	Elf32_ ## type
253 #endif
254 
255 /*
256  * The callback function to dl_interate_phdr() receives a pointer
257  * to a structure of this type.
258  *
259  * dlpi_addr is defined such that the address of any segment in
260  * the program header array can be calculated as:
261  *
262  *	addr == info->dlpi_addr + info->dlpi_phdr[x].p_vaddr;
263  *
264  * It is therefore 0 for ET_EXEC objects, and the base address at
265  * which the object is mapped otherwise.
266  */
267 struct dl_phdr_info {
268 	ElfW(Addr)		dlpi_addr;	/* Base address of object */
269 	const char		*dlpi_name;	/* Null-terminated obj name */
270 	const ElfW(Phdr)	*dlpi_phdr;	/* Ptr to ELF program hdr arr */
271 	ElfW(Half)		dlpi_phnum;	/* # of items in dlpi_phdr[] */
272 
273 	/*
274 	 * Note: Following members were introduced after the first version
275 	 * of this structure was available.  The dl_iterate_phdr() callback
276 	 * function is passed a 'size' argument giving the size of the info
277 	 * structure, and must compare that size to the offset of these fields
278 	 * before accessing them to ensure that they are present.
279 	 */
280 
281 	/* Incremented when a new object is mapped into the process */
282 	u_longlong_t		dlpi_adds;
283 	/* Incremented when an object is unmapped from the process */
284 	u_longlong_t		dlpi_subs;
285 };
286 
287 extern  int dl_iterate_phdr(int (*)(struct dl_phdr_info *, size_t, void *),
288 	    void *);
289 
290 #endif	/* _ASM */
291 #endif /* _KERNEL */
292 
293 
294 #ifdef __cplusplus
295 }
296 #endif
297 
298 #endif	/* _LINK_H */
299