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
|
/*
* 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 (c) 1989 AT&T */
/* All Rights Reserved */
/*
* Copyright 2009 Sun Microsystems, Inc. All rights reserved.
* Use is subject to license terms.
*/
#ifndef _DWARF_H
#define _DWARF_H
#include <sys/types.h>
#ifdef __cplusplus
extern "C" {
#endif
/* dwarf.h - manifest constants used in the .debug section of ELF files */
/* the "tag" - the first short of any legal record */
#define TAG_padding 0x0000
#define TAG_array_type 0x0001
#define TAG_class_type 0x0002
#define TAG_entry_point 0x0003
#define TAG_enumeration_type 0x0004
#define TAG_formal_parameter 0x0005
#define TAG_global_subroutine 0x0006
#define TAG_global_variable 0x0007
#define TAG_imported_declaration 0x0008
#define TAG_inline_subroutine 0x0009
#define TAG_label 0x000a
#define TAG_lexical_block 0x000b
#define TAG_local_variable 0x000c
#define TAG_member 0x000d
#define TAG_member_function 0x000e
#define TAG_pointer_type 0x000f
#define TAG_reference_type 0x0010
#define TAG_source_file 0x0011
#define TAG_string_type 0x0012
#define TAG_structure_type 0x0013
#define TAG_subroutine 0x0014
#define TAG_subroutine_type 0x0015
#define TAG_typedef 0x0016
#define TAG_union_type 0x0017
#define TAG_unspecified_parameters 0x0018
#define TAG_variant 0x0019
/* attribute forms are encoded as part */
/* of the attribute name and must fit */
/* into 4 bits */
#define FORM_MASK 0xf
#define FORM_NONE 0x0 /* error */
#define FORM_ADDR 0x1 /* relocated address */
#define FORM_REF 0x2 /* reference to another .debug entry */
#define FORM_BLOCK2 0x3 /* block with 2-byte length */
#define FORM_BLOCK4 0x4 /* block with 4-byte length (unused) */
#define FORM_DATA2 0x5 /* 2 bytes */
#define FORM_DATA4 0x6 /* 4 bytes */
#define FORM_DATA8 0x7 /* 8 bytes (two 4-byte values) */
#define FORM_STRING 0x8 /* NUL-terminated string */
/* attribute names, halfwords with low 4 bits indicating the form */
#define AT_padding (0x0000|FORM_NONE) /* just padding */
#define AT_sibling (0x0010|FORM_REF) /* next owned declaration */
#define AT_location (0x0020|FORM_BLOCK2) /* location description */
#define AT_name (0x0030|FORM_STRING) /* symbol name */
#define AT_dimensions (0x0040|FORM_DATA2) /* array dimensions */
#define AT_fund_type (0x0050|FORM_DATA2) /* fund type enum */
#define AT_mod_fund_type (0x0060|FORM_BLOCK2) /* modifiers & fund type enum */
#define AT_user_def_type (0x0070|FORM_REF) /* type entry */
#define AT_mod_u_d_type (0x0080|FORM_BLOCK2) /* modifiers & type entry ref */
#define AT_ordering (0x0090|FORM_DATA2) /* array row/column major */
#define AT_subscr_data (0x00a0|FORM_BLOCK2) /* list of array dim info */
#define AT_byte_size (0x00b0|FORM_DATA4) /* number bytes per instance */
#define AT_bit_offset (0x00c0|FORM_DATA2) /* number bits padding */
#define AT_bit_size (0x00d0|FORM_DATA4) /* number bits per instance */
#define AT_deriv_list (0x00e0|FORM_BLOCK2) /* list of base class refs */
#define AT_element_list (0x00f0|FORM_BLOCK4) /* list of enum data elements */
#define AT_stmt_list (0x0100|FORM_DATA4) /* offset in .line sect */
#define AT_low_pc (0x0110|FORM_ADDR) /* first machine instr */
#define AT_high_pc (0x0120|FORM_ADDR) /* beyond last machine instr */
#define AT_language (0x0130|FORM_DATA4) /* compiler enumeration */
#define AT_member (0x0140|FORM_REF) /* class description */
#define AT_discr (0x0150|FORM_REF) /* discriminant entry */
#define AT_discr_value (0x0160|FORM_BLOCK2) /* value of discr */
#define AT_visibility (0x0170|FORM_DATA2) /* visibility enumeration */
#define AT_import (0x0180|FORM_REF) /* imported declaration */
#define AT_string_length (0x0190|FORM_BLOCK2) /* runtime string size */
/* atoms which compose a location description; must fit in a byte */
#define OP_UNK 0x00 /* error */
#define OP_REG 0x01 /* push register (number) */
#define OP_BASEREG 0x02 /* push value of register (number) */
#define OP_ADDR 0x03 /* push address (relocated address) */
#define OP_CONST 0x04 /* push constant (number) */
#define OP_DEREF2 0x05 /* pop, deref and push 2 bytes (as a long) */
#define OP_DEREF4 0x06 /* pop, deref and push 4 bytes (as a long) */
#define OP_ADD 0x07 /* pop top 2 items, add, push result */
/* fundamental types; must fit in two bytes */
#define FT_none 0x0000 /* error */
#define FT_char 0x0001 /* "plain" char */
#define FT_signed_char 0x0002
#define FT_unsigned_char 0x0003
#define FT_short 0x0004 /* "plain" short */
#define FT_signed_short 0x0005
#define FT_unsigned_short 0x0006
#define FT_integer 0x0007 /* "plain" integer */
#define FT_signed_integer 0x0008
#define FT_unsigned_integer 0x0009
#define FT_long 0x000a /* "plain" long */
#define FT_signed_long 0x000b
#define FT_unsigned_long 0x000c
#define FT_pointer 0x000d /* (void *) */
#define FT_float 0x000e
#define FT_dbl_prec_float 0x000f
#define FT_ext_prec_float 0x0010
#define FT_complex 0x0011
#define FT_dbl_prec_complex 0x0012
#define FT_set 0x0013
#define FT_void 0x0014
/* type modifiers; must fit in a byte */
#define MOD_none 0x00 /* error */
#define MOD_pointer_to 0x01
#define MOD_reference_to 0x02
/* the "format" byte for array descriptions; formed from three */
/* one-bit fields */
#define FMT_FT 0 /* fundamental type */
#define FMT_UDT 1 /* user-defined type */
#define FMT_CONST 0 /* 4-byte constant */
#define FMT_EXPR 1 /* block with 2-byte length (loc descr) */
#define FMT_FT_C_C ((FMT_FT <<2) | (FMT_CONST<<1) | (FMT_CONST))
#define FMT_FT_C_X ((FMT_FT <<2) | (FMT_CONST<<1) | (FMT_EXPR))
#define FMT_FT_X_C ((FMT_FT <<2) | (FMT_EXPR <<1) | (FMT_CONST))
#define FMT_FT_X_X ((FMT_FT <<2) | (FMT_EXPR <<1) | (FMT_EXPR))
#define FMT_UT_C_C ((FMT_UDT<<2) | (FMT_CONST<<1) | (FMT_CONST))
#define FMT_UT_C_X ((FMT_UDT<<2) | (FMT_CONST<<1) | (FMT_EXPR))
#define FMT_UT_X_C ((FMT_UDT<<2) | (FMT_EXPR <<1) | (FMT_CONST))
#define FMT_UT_X_X ((FMT_UDT<<2) | (FMT_EXPR <<1) | (FMT_EXPR))
#define FMT_ET 8 /* element type */
/* ordering of arrays */
#define ORD_row_major 0
#define ORD_col_major 1
/* visibility values */
#define VIS_local 0 /* for static functions in C */
#define VIS_exported 1 /* for Modula */
/*
* DWARF Exception Header Encoding
*
* The DWARF Exception Header Encoding is used to describe the type of data
* used in the .eh_frame_hdr section. The upper 4 bits indicate how the value
* is to be applied. The lower 4 bits indicate the format of the data.
*/
/*
* Dwarf Exception Header Value format
*/
#define DW_EH_PE_omit 0xff /* No value is present. */
#define DW_EH_PE_absptr 0x00 /* Value is a void* */
#define DW_EH_PE_uleb128 0x01 /* Unsigned value is encoded using */
/* the Little Endian */
/* Base 128 (LEB128) */
#define DW_EH_PE_udata2 0x02 /* A 2 bytes unsigned value. */
#define DW_EH_PE_udata4 0x03 /* A 4 bytes unsigned value. */
#define DW_EH_PE_udata8 0x04 /* An 8 bytes unsigned value. */
#define DW_EH_PE_signed 0x08 /* bit on for all signed encodings */
#define DW_EH_PE_sleb128 0x09 /* Signed value is encoded using */
/* the Little Endian */
/* Base 128 (LEB128) */
#define DW_EH_PE_sdata2 0x0a /* A 2 bytes signed value. */
#define DW_EH_PE_sdata4 0x0b /* A 4 bytes signed value. */
#define DW_EH_PE_sdata8 0x0c /* An 8 bytes signed value. */
/*
* Dwarf Exception Header application
*/
#define DW_EH_PE_absptr 0x00 /* Value is used with no */
/* modification. */
#define DW_EH_PE_pcrel 0x10 /* Value is reletive to the location */
/* of itself */
#define DW_EH_PE_textrel 0x20
#define DW_EH_PE_datarel 0x30 /* Value is reletive to the beginning */
/* of the eh_frame_hdr segment */
/* ( segment type PT_AMD64_UNWIND ) */
/* when within that segment, or to */
/* the GOT when without. */
#define DW_EH_PE_funcrel 0x40
#define DW_EH_PE_aligned 0x50 /* value is an aligned void* */
#define DW_EH_PE_indirect 0x80 /* bit to signal indirection after */
/* relocation */
/* language/compiler enumeration */
typedef enum _LANG {
LANG_UNK = 0,
LANG_ANSI_C_V1 = 1
} LANG;
typedef enum {
DW_SUCCESS = 0,
DW_BAD_ENCODING,
DW_OVERFLOW,
} dwarf_error_t;
/*
* Little Endian Base 128 (leb128) encoding/decoding routines
*/
extern dwarf_error_t uleb_extract(unsigned char *, uint64_t *, size_t,
uint64_t *);
extern dwarf_error_t sleb_extract(unsigned char *, uint64_t *, size_t,
int64_t *);
extern dwarf_error_t dwarf_ehe_extract(unsigned char *, size_t, uint64_t *,
uint64_t *, uint_t, unsigned char *, boolean_t,
uint64_t, uint64_t, uint64_t);
#ifdef __cplusplus
}
#endif
#endif /* _DWARF_H */
|
