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
|
/* Interface for libebl.
Copyright (C) 2000, 2001, 2002, 2004 Red Hat, Inc.
This program is Open Source software; you can redistribute it and/or
modify it under the terms of the Open Software License version 1.0 as
published by the Open Source Initiative.
You should have received a copy of the Open Software License along
with this program; if not, you may obtain a copy of the Open Software
License version 1.0 from http://www.opensource.org/licenses/osl.php or
by writing the Open Source Initiative c/o Lawrence Rosen, Esq.,
3001 King Ranch Road, Ukiah, CA 95482. */
#ifndef _LIBEBL_H
#define _LIBEBL_H 1
#include <gelf.h>
#include <stdbool.h>
#include <stddef.h>
#include <stdint.h>
#include <elf-knowledge.h>
/* Backend handle. */
typedef struct ebl
{
/* Machine name. */
const char *name;
/* Emulation name. */
const char *emulation;
/* The libelf handle (if known). */
Elf *elf;
/* Return symbol representaton of object file type. */
const char *(*object_type_name) (int, char *, size_t);
/* Return symbolic representation of relocation type. */
const char *(*reloc_type_name) (int, char *, size_t);
/* Check relocation type. */
bool (*reloc_type_check) (int);
/* Check relocation type use. */
bool (*reloc_valid_use) (Elf *, int);
/* Return true if the symbol type is that referencing the GOT. */
bool (*gotpc_reloc_check) (Elf *, int);
/* Return symbolic representation of segment type. */
const char *(*segment_type_name) (int, char *, size_t);
/* Return symbolic representation of section type. */
const char *(*section_type_name) (int, char *, size_t);
/* Return section name. */
const char *(*section_name) (int, int, char *, size_t);
/* Return next machine flag name. */
const char *(*machine_flag_name) (GElf_Word *);
/* Check whether machine flags are valid. */
bool (*machine_flag_check) (GElf_Word);
/* Return symbolic representation of symbol type. */
const char *(*symbol_type_name) (int, char *, size_t);
/* Return symbolic representation of symbol binding. */
const char *(*symbol_binding_name) (int, char *, size_t);
/* Return symbolic representation of dynamic tag. */
const char *(*dynamic_tag_name) (int64_t, char *, size_t);
/* Check dynamic tag. */
bool (*dynamic_tag_check) (int64_t);
/* Combine section header flags values. */
GElf_Word (*sh_flags_combine) (GElf_Word, GElf_Word);
/* Return symbolic representation of OS ABI. */
const char *(*osabi_name) (int, char *, size_t);
/* Name of a note entry type for core files. */
const char *(*core_note_type_name) (uint32_t, char *, size_t);
/* Name of a note entry type for object files. */
const char *(*object_note_type_name) (uint32_t, char *, size_t);
/* Handle core note. */
bool (*core_note) (const char *, uint32_t, uint32_t, const char *);
/* Handle object file note. */
bool (*object_note) (const char *, uint32_t, uint32_t, const char *);
/* Check section name for being that of a debug informatino section. */
bool (*debugscn_p) (const char *);
/* Destructor for ELF backend handle. */
void (*destr) (struct ebl *);
/* Internal data. */
void *dlhandle;
} Ebl;
/* Get backend handle for object associated with ELF handle. */
extern Ebl *ebl_openbackend (Elf *elf);
/* Similar but without underlying ELF file. */
extern Ebl *ebl_openbackend_machine (GElf_Half machine);
/* Similar but with emulation name given. */
extern Ebl *ebl_openbackend_emulation (const char *emulation);
/* Free resources allocated for backend handle. */
extern void ebl_closebackend (Ebl *bh);
/* Function to call the callback functions including default ELF
handling. */
/* Return backend name. */
extern const char *ebl_backend_name (Ebl *ebl);
/* Return relocation type name. */
extern const char *ebl_object_type_name (Ebl *ebl, int object,
char *buf, size_t len);
/* Return relocation type name. */
extern const char *ebl_reloc_type_name (Ebl *ebl, int reloc,
char *buf, size_t len);
/* Check relocation type. */
extern bool ebl_reloc_type_check (Ebl *ebl, int reloc);
/* Check relocation type use. */
extern bool ebl_reloc_valid_use (Ebl *ebl, int reloc);
/* Return true if the symbol type is that referencing the GOT. E.g.,
R_386_GOTPC. */
extern bool ebl_gotpc_reloc_check (Ebl *ebl, int reloc);
/* Return segment type name. */
extern const char *ebl_segment_type_name (Ebl *ebl, int segment,
char *buf, size_t len);
/* Return section type name. */
extern const char *ebl_section_type_name (Ebl *ebl, int section,
char *buf, size_t len);
/* Return section name. */
extern const char *ebl_section_name (Ebl *ebl, int section, int xsection,
char *buf, size_t len,
const char *scnnames[], size_t shnum);
/* Return machine flag names. */
extern const char *ebl_machine_flag_name (Ebl *ebl, GElf_Word flags,
char *buf, size_t len);
/* Check whether machine flag is valid. */
extern bool ebl_machine_flag_check (Ebl *ebl, GElf_Word flags);
/* Return symbol type name. */
extern const char *ebl_symbol_type_name (Ebl *ebl, int symbol,
char *buf, size_t len);
/* Return symbol binding name. */
extern const char *ebl_symbol_binding_name (Ebl *ebl, int binding,
char *buf, size_t len);
/* Return dynamic tag name. */
extern const char *ebl_dynamic_tag_name (Ebl *ebl, int64_t tag,
char *buf, size_t len);
/* Check dynamic tag. */
extern bool ebl_dynamic_tag_check (Ebl *ebl, int64_t tag);
/* Return combined section header flags value. */
extern GElf_Word ebl_sh_flags_combine (Ebl *ebl, GElf_Word flags1,
GElf_Word flags2);
/* Return symbolic representation of OS ABI. */
extern const char *ebl_osabi_name (Ebl *ebl, int osabi, char *buf, size_t len);
/* Return name of the note section type for a core file. */
extern const char *ebl_core_note_type_name (Ebl *ebl, uint32_t type, char *buf,
size_t len);
/* Return name of the note section type for an object file. */
extern const char *ebl_object_note_type_name (Ebl *ebl, uint32_t type,
char *buf, size_t len);
/* Print information about core note if available. */
extern void ebl_core_note (Ebl *ebl, const char *name, uint32_t type,
uint32_t descsz, const char *desc);
/* Print information about object note if available. */
extern void ebl_object_note (Ebl *ebl, const char *name, uint32_t type,
uint32_t descsz, const char *desc);
/* Check section name for being that of a debug informatino section. */
extern bool ebl_debugscn_p (Ebl *ebl, const char *name);
/* ELF string table handling. */
struct Ebl_Strtab;
struct Ebl_Strent;
/* Create new ELF string table object in memory. */
extern struct Ebl_Strtab *ebl_strtabinit (bool nullstr);
/* Free resources allocated for ELF string table ST. */
extern void ebl_strtabfree (struct Ebl_Strtab *st);
/* Add string STR (length LEN is != 0) to ELF string table ST. */
extern struct Ebl_Strent *ebl_strtabadd (struct Ebl_Strtab *st,
const char *str, size_t len);
/* Finalize string table ST and store size and memory location information
in DATA. */
extern void ebl_strtabfinalize (struct Ebl_Strtab *st, Elf_Data *data);
/* Get offset in string table for string associated with SE. */
extern size_t ebl_strtaboffset (struct Ebl_Strent *se);
/* Return the string associated with SE. */
extern const char *ebl_string (struct Ebl_Strent *se);
/* ELF wide char string table handling. */
struct Ebl_WStrtab;
struct Ebl_WStrent;
/* Create new ELF wide char string table object in memory. */
extern struct Ebl_WStrtab *ebl_wstrtabinit (bool nullstr);
/* Free resources allocated for ELF wide char string table ST. */
extern void ebl_wstrtabfree (struct Ebl_WStrtab *st);
/* Add string STR (length LEN is != 0) to ELF string table ST. */
extern struct Ebl_WStrent *ebl_wstrtabadd (struct Ebl_WStrtab *st,
const wchar_t *str, size_t len);
/* Finalize string table ST and store size and memory location information
in DATA. */
extern void ebl_wstrtabfinalize (struct Ebl_WStrtab *st, Elf_Data *data);
/* Get offset in wide char string table for string associated with SE. */
extern size_t ebl_wstrtaboffset (struct Ebl_WStrent *se);
/* Generic string table handling. */
struct Ebl_GStrtab;
struct Ebl_GStrent;
/* Create new string table object in memory. */
extern struct Ebl_GStrtab *ebl_gstrtabinit (unsigned int width, bool nullstr);
/* Free resources allocated for string table ST. */
extern void ebl_gstrtabfree (struct Ebl_GStrtab *st);
/* Add string STR (length LEN is != 0) to string table ST. */
extern struct Ebl_GStrent *ebl_gstrtabadd (struct Ebl_GStrtab *st,
const char *str, size_t len);
/* Finalize string table ST and store size and memory location information
in DATA. */
extern void ebl_gstrtabfinalize (struct Ebl_GStrtab *st, Elf_Data *data);
/* Get offset in wide char string table for string associated with SE. */
extern size_t ebl_gstrtaboffset (struct Ebl_GStrent *se);
#endif /* libebl.h */
|
