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