51b9a851b9c96b9a2c5386b34ad51cf0301d47bf
2 * Copyright (c) 2006 Joseph Koshy
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions
8 * 1. Redistributions of source code must retain the above copyright
9 * notice, this list of conditions and the following disclaimer.
10 * 2. Redistributions in binary form must reproduce the above copyright
11 * notice, this list of conditions and the following disclaimer in the
12 * documentation and/or other materials provided with the distribution.
14 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
15 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
17 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
18 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
19 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
20 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
21 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
22 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
23 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
26 * $FreeBSD: src/lib/libelf/libelf.h,v 1.1 2006/11/11 17:16:33 jkoshy Exp $
32 #include <sys/types.h>
38 #include "elf_queue.h"
42 /* Library private data structures */
43 typedef struct _Elf Elf
;
44 typedef struct _Elf_Scn Elf_Scn
;
49 ELF_K_AR
, /* `ar' archives */
50 ELF_K_COFF
, /* COFF files (unsupported) */
51 ELF_K_ELF
, /* ELF files */
55 #define ELF_K_FIRST ELF_K_NONE
56 #define ELF_K_LAST ELF_K_NUM
86 #define ELF_T_FIRST ELF_T_ADDR
87 #define ELF_T_LAST ELF_T_XWORD
102 #define ELF_C_FIRST ELF_C_NULL
103 #define ELF_C_LAST ELF_C_NUM
106 * An `Elf_Data' structure describes data in an
109 typedef struct _Elf_Data
{
111 * `Public' members that are part of the ELF(3) API.
118 unsigned int d_version
;
121 * Members that are not part of the public API.
123 Elf_Scn
*d_scn
; /* containing section */
124 unsigned int d_flags
;
125 STAILQ_ENTRY(_Elf_Data
) d_next
;
129 * An `Elf_Arhdr' structure describes an archive
134 char *ar_name
; /* archive member name */
137 char *ar_rawname
; /* 'raw' member name */
143 * An `Elf_Arsym' describes an entry in the archive
147 off_t as_off
; /* byte offset to member's header */
148 unsigned long as_hash
; /* elf_hash() value for name */
149 char *as_name
; /* null terminated symbol name */
157 ELF_E_NONE
, /* No error */
158 ELF_E_ARCHIVE
, /* Malformed ar(1) archive */
159 ELF_E_ARGUMENT
, /* Invalid argument */
160 ELF_E_CLASS
, /* Mismatched ELF class */
161 ELF_E_DATA
, /* Invalid data descriptor */
162 ELF_E_HEADER
, /* Missing or malformed ELF header */
163 ELF_E_IO
, /* I/O error */
164 ELF_E_LAYOUT
, /* Layout constraint violation */
165 ELF_E_MODE
, /* Wrong mode for ELF descriptor */
166 ELF_E_RANGE
, /* Value out of range */
167 ELF_E_RESOURCE
, /* Resource exhaustion */
168 ELF_E_SECTION
, /* Invalid section descriptor */
169 ELF_E_SEQUENCE
, /* API calls out of sequence */
170 ELF_E_UNIMPL
, /* Feature is unimplemented */
171 ELF_E_VERSION
, /* Unknown API version */
172 ELF_E_NUM
/* Max error number */
176 * Flags defined by the API.
179 #define ELF_F_LAYOUT 0x001U /* application will layout the file */
180 #define ELF_F_DIRTY 0x002U /* a section or ELF file is dirty */
182 Elf
*elf_begin(int _fd
, Elf_Cmd _cmd
, Elf
*_elf
);
183 int elf_cntl(Elf
*_elf
, Elf_Cmd _cmd
);
184 int elf_end(Elf
*_elf
);
185 const char *elf_errmsg(int _error
);
187 void elf_fill(int _fill
);
188 unsigned int elf_flagdata(Elf_Data
*_data
, Elf_Cmd _cmd
, unsigned int _flags
);
189 unsigned int elf_flagehdr(Elf
*_elf
, Elf_Cmd _cmd
, unsigned int _flags
);
190 unsigned int elf_flagelf(Elf
*_elf
, Elf_Cmd _cmd
, unsigned int _flags
);
191 unsigned int elf_flagphdr(Elf
*_elf
, Elf_Cmd _cmd
, unsigned int _flags
);
192 unsigned int elf_flagscn(Elf_Scn
*_scn
, Elf_Cmd _cmd
, unsigned int _flags
);
193 unsigned int elf_flagshdr(Elf_Scn
*_scn
, Elf_Cmd _cmd
, unsigned int _flags
);
194 Elf_Arhdr
*elf_getarhdr(Elf
*_elf
);
195 Elf_Arsym
*elf_getarsym(Elf
*_elf
, size_t *_ptr
);
196 off_t
elf_getbase(Elf
*_elf
);
197 Elf_Data
*elf_getdata(Elf_Scn
*, Elf_Data
*);
198 char *elf_getident(Elf
*_elf
, size_t *_ptr
);
199 int elf_getphnum(Elf
*_elf
, size_t *_dst
);
200 Elf_Scn
*elf_getscn(Elf
*_elf
, size_t _index
);
201 int elf_getshnum(Elf
*_elf
, size_t *_dst
);
202 int elf_getshstrndx(Elf
*_elf
, size_t *_dst
);
203 unsigned long elf_hash(const char *_name
);
204 Elf_Kind
elf_kind(Elf
*_elf
);
205 Elf
*elf_memory(char *_image
, size_t _size
);
206 size_t elf_ndxscn(Elf_Scn
*_scn
);
207 Elf_Data
*elf_newdata(Elf_Scn
*_scn
);
208 Elf_Scn
*elf_newscn(Elf
*_elf
);
209 Elf_Scn
*elf_nextscn(Elf
*_elf
, Elf_Scn
*_scn
);
210 Elf_Cmd
elf_next(Elf
*_elf
);
211 off_t
elf_rand(Elf
*_elf
, off_t _off
);
212 Elf_Data
*elf_rawdata(Elf_Scn
*_scn
, Elf_Data
*_data
);
213 char *elf_rawfile(Elf
*_elf
, size_t *_size
);
214 int elf_setshstrndx(Elf
*_elf
, size_t _shnum
);
215 char *elf_strptr(Elf
*_elf
, size_t _section
, size_t _offset
);
216 off_t
elf_update(Elf
*_elf
, Elf_Cmd _cmd
);
217 unsigned int elf_version(unsigned int _version
);
219 long elf32_checksum(Elf
*_elf
);
220 size_t elf32_fsize(Elf_Type _type
, size_t _count
,
221 unsigned int _version
);
222 Elf32_Ehdr
*elf32_getehdr(Elf
*_elf
);
223 Elf32_Phdr
*elf32_getphdr(Elf
*_elf
);
224 Elf32_Shdr
*elf32_getshdr(Elf_Scn
*_scn
);
225 Elf32_Ehdr
*elf32_newehdr(Elf
*_elf
);
226 Elf32_Phdr
*elf32_newphdr(Elf
*_elf
, size_t _count
);
227 Elf_Data
*elf32_xlatetof(Elf_Data
*_dst
, const Elf_Data
*_src
,
229 Elf_Data
*elf32_xlatetom(Elf_Data
*_dst
, const Elf_Data
*_src
,
232 long elf64_checksum(Elf
*_elf
);
233 size_t elf64_fsize(Elf_Type _type
, size_t _count
,
234 unsigned int _version
);
235 Elf64_Ehdr
*elf64_getehdr(Elf
*_elf
);
236 Elf64_Phdr
*elf64_getphdr(Elf
*_elf
);
237 Elf64_Shdr
*elf64_getshdr(Elf_Scn
*_scn
);
238 Elf64_Ehdr
*elf64_newehdr(Elf
*_elf
);
239 Elf64_Phdr
*elf64_newphdr(Elf
*_elf
, size_t _count
);
240 Elf_Data
*elf64_xlatetof(Elf_Data
*_dst
, const Elf_Data
*_src
,
242 Elf_Data
*elf64_xlatetom(Elf_Data
*_dst
, const Elf_Data
*_src
,
249 #endif /* _LIBELF_H_ */