libelf.h revision 4484:7c56a6c9c265
1/*-
2 * Copyright (c) 2006 Joseph Koshy
3 * All rights reserved.
4 *
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions
7 * are met:
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.
13 *
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
24 * SUCH DAMAGE.
25 *
26 * $FreeBSD: src/lib/libelf/libelf.h,v 1.1 2006/11/11 17:16:33 jkoshy Exp $
27 */
28
29#ifndef	_LIBELF_H_
30#define	_LIBELF_H_
31
32#include <sys/types.h>
33
34#ifdef __cplusplus
35extern "C" {
36#endif
37
38#include "elf_queue.h"
39#include "elf32.h"
40#include "elf64.h"
41
42/* Library private data structures */
43typedef struct _Elf Elf;
44typedef struct _Elf_Scn Elf_Scn;
45
46/* File types */
47typedef enum {
48        ELF_K_NONE = 0,
49        ELF_K_AR,	/* `ar' archives */
50        ELF_K_COFF,	/* COFF files (unsupported) */
51        ELF_K_ELF,	/* ELF files */
52        ELF_K_NUM
53} Elf_Kind;
54
55#define	ELF_K_FIRST	ELF_K_NONE
56#define	ELF_K_LAST	ELF_K_NUM
57
58/* Data types */
59typedef enum {
60        ELF_T_ADDR,
61        ELF_T_BYTE,
62        ELF_T_CAP,
63        ELF_T_DYN,
64        ELF_T_EHDR,
65        ELF_T_HALF,
66        ELF_T_LWORD,
67        ELF_T_MOVE,
68        ELF_T_MOVEP,
69        ELF_T_NOTE,
70        ELF_T_OFF,
71        ELF_T_PHDR,
72        ELF_T_REL,
73        ELF_T_RELA,
74        ELF_T_SHDR,
75        ELF_T_SWORD,
76        ELF_T_SXWORD,
77        ELF_T_SYMINFO,
78        ELF_T_SYM,
79        ELF_T_VDEF,
80        ELF_T_VNEED,
81        ELF_T_WORD,
82        ELF_T_XWORD,
83        ELF_T_NUM
84} Elf_Type;
85
86#define	ELF_T_FIRST	ELF_T_ADDR
87#define	ELF_T_LAST	ELF_T_XWORD
88
89/* Commands */
90typedef enum {
91        ELF_C_NULL = 0,
92        ELF_C_CLR,
93        ELF_C_FDDONE,
94        ELF_C_FDREAD,
95        ELF_C_RDWR,
96        ELF_C_READ,
97        ELF_C_SET,
98        ELF_C_WRITE,
99        ELF_C_NUM
100} Elf_Cmd;
101
102#define	ELF_C_FIRST	ELF_C_NULL
103#define	ELF_C_LAST	ELF_C_NUM
104
105/*
106 * An `Elf_Data' structure describes data in an
107 * ELF section.
108 */
109typedef struct _Elf_Data {
110        /*
111         * `Public' members that are part of the ELF(3) API.
112         */
113        uint64_t	d_align;
114        void		*d_buf;
115        uint64_t	d_off;
116        uint64_t	d_size;
117        Elf_Type	d_type;
118        unsigned int	d_version;
119
120        /*
121         * Members that are not part of the public API.
122         */
123        Elf_Scn		*d_scn;		/* containing section */
124        unsigned int	d_flags;
125        STAILQ_ENTRY(_Elf_Data)	d_next;
126} Elf_Data;
127
128/*
129 * An `Elf_Arhdr' structure describes an archive
130 * header.
131 */
132typedef struct {
133        time_t		ar_date;
134        char		*ar_name;	/* archive member name */
135        gid_t		ar_gid;
136        mode_t		ar_mode;
137        char		*ar_rawname;	/* 'raw' member name */
138        size_t		ar_size;
139        uid_t		ar_uid;
140} Elf_Arhdr;
141
142/*
143 * An `Elf_Arsym' describes an entry in the archive
144 * symbol table.
145 */
146typedef struct {
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 */
150} Elf_Arsym;
151
152/*
153 * Error numbers.
154 */
155
156enum Elf_Error {
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 */
173};
174
175/*
176 * Flags defined by the API.
177 */
178
179#define	ELF_F_LAYOUT	0x001U	/* application will layout the file */
180#define	ELF_F_DIRTY	0x002U	/* a section or ELF file is dirty */
181
182Elf		*elf_begin(int _fd, Elf_Cmd _cmd, Elf *_elf);
183int		elf_cntl(Elf *_elf, Elf_Cmd _cmd);
184int		elf_end(Elf *_elf);
185const char	*elf_errmsg(int _error);
186int		elf_errno(void);
187void		elf_fill(int _fill);
188unsigned int	elf_flagdata(Elf_Data *_data, Elf_Cmd _cmd, unsigned int _flags);
189unsigned int	elf_flagehdr(Elf *_elf, Elf_Cmd _cmd, unsigned int _flags);
190unsigned int	elf_flagelf(Elf *_elf, Elf_Cmd _cmd, unsigned int _flags);
191unsigned int	elf_flagphdr(Elf *_elf, Elf_Cmd _cmd, unsigned int _flags);
192unsigned int	elf_flagscn(Elf_Scn *_scn, Elf_Cmd _cmd, unsigned int _flags);
193unsigned int	elf_flagshdr(Elf_Scn *_scn, Elf_Cmd _cmd, unsigned int _flags);
194Elf_Arhdr	*elf_getarhdr(Elf *_elf);
195Elf_Arsym	*elf_getarsym(Elf *_elf, size_t *_ptr);
196off_t		elf_getbase(Elf *_elf);
197Elf_Data	*elf_getdata(Elf_Scn *, Elf_Data *);
198char		*elf_getident(Elf *_elf, size_t *_ptr);
199int		elf_getphnum(Elf *_elf, size_t *_dst);
200Elf_Scn		*elf_getscn(Elf *_elf, size_t _index);
201int		elf_getshnum(Elf *_elf, size_t *_dst);
202int		elf_getshstrndx(Elf *_elf, size_t *_dst);
203unsigned long	elf_hash(const char *_name);
204Elf_Kind	elf_kind(Elf *_elf);
205Elf		*elf_memory(char *_image, size_t _size);
206size_t		elf_ndxscn(Elf_Scn *_scn);
207Elf_Data	*elf_newdata(Elf_Scn *_scn);
208Elf_Scn		*elf_newscn(Elf *_elf);
209Elf_Scn		*elf_nextscn(Elf *_elf, Elf_Scn *_scn);
210Elf_Cmd		elf_next(Elf *_elf);
211off_t		elf_rand(Elf *_elf, off_t _off);
212Elf_Data	*elf_rawdata(Elf_Scn *_scn, Elf_Data *_data);
213char		*elf_rawfile(Elf *_elf, size_t *_size);
214int		elf_setshstrndx(Elf *_elf, size_t _shnum);
215char		*elf_strptr(Elf *_elf, size_t _section, size_t _offset);
216off_t		elf_update(Elf *_elf, Elf_Cmd _cmd);
217unsigned int	elf_version(unsigned int _version);
218
219long		elf32_checksum(Elf *_elf);
220size_t		elf32_fsize(Elf_Type _type, size_t _count,
221                        unsigned int _version);
222Elf32_Ehdr	*elf32_getehdr(Elf *_elf);
223Elf32_Phdr	*elf32_getphdr(Elf *_elf);
224Elf32_Shdr	*elf32_getshdr(Elf_Scn *_scn);
225Elf32_Ehdr	*elf32_newehdr(Elf *_elf);
226Elf32_Phdr	*elf32_newphdr(Elf *_elf, size_t _count);
227Elf_Data	*elf32_xlatetof(Elf_Data *_dst, const Elf_Data *_src,
228                        unsigned int _enc);
229Elf_Data	*elf32_xlatetom(Elf_Data *_dst, const Elf_Data *_src,
230                        unsigned int _enc);
231
232long		elf64_checksum(Elf *_elf);
233size_t		elf64_fsize(Elf_Type _type, size_t _count,
234                        unsigned int _version);
235Elf64_Ehdr	*elf64_getehdr(Elf *_elf);
236Elf64_Phdr	*elf64_getphdr(Elf *_elf);
237Elf64_Shdr	*elf64_getshdr(Elf_Scn *_scn);
238Elf64_Ehdr	*elf64_newehdr(Elf *_elf);
239Elf64_Phdr	*elf64_newphdr(Elf *_elf, size_t _count);
240Elf_Data	*elf64_xlatetof(Elf_Data *_dst, const Elf_Data *_src,
241                        unsigned int _enc);
242Elf_Data	*elf64_xlatetom(Elf_Data *_dst, const Elf_Data *_src,
243                        unsigned int _enc);
244
245#ifdef __cplusplus
246}
247#endif
248
249#endif	/* _LIBELF_H_ */
250