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