summaryrefslogtreecommitdiffhomepage
path: root/include/perk/perk.h
blob: 00d24d59943bf892a2c99bfa21e738c073c162c5 (plain)
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
#ifndef PERK_H
#define PERK_H

#include <stdint.h>
#include <stdio.h>

#include <perk/perk_consts.h>
#include <perk/perk_structs.h>
#include <perk/perk_meta.h>
#include <perk/perk_output.h>

#ifdef __cplusplus
extern "C" {
#endif

/* pre-alpha */
#ifndef PERK_APP
#ifndef PERK_PRE_ALPHA
#error  libperk: pre-alpha: ABI is not final!
#error  to use the library, please pass -DPERK_PRE_ALPHA to the compiler.
#endif
#endif

/* exec flags */
#define PERK_HELP		0x01

/* errors */
#define PERK_OK			0x00
#define PERK_BAD_OPT		0xA1
#define PERK_BAD_OPT_VAL	0xA2
#define PERK_IO_ERROR		0xA3
#define PERK_MAP_ERROR		0xA4
#define PERK_BAD_DOS_HEADER	0xA5
#define PERK_BAD_COFF_HEADER	0xA6
#define PERK_BAD_IMAGE_TYPE	0xA7
#define PERK_MALFORMED_IMAGE	0xA8

struct pe_raw_image {
	char *	addr;
	size_t	size;
};

struct pe_image_summary {
	uint32_t	num_of_export_syms;
	uint32_t	num_of_implibs;
	uint32_t	num_of_relocs;
};

struct pe_image_meta {
	struct pe_raw_image		image;
	struct pe_image_summary		summary;

	struct pe_meta_image_dos_hdr	dos;
	struct pe_meta_coff_file_hdr	coff;
	struct pe_meta_opt_hdr		opt;
	struct pe_meta_sec_hdr *	sectbl;

	struct pe_image_dos_hdr *	ados;
	struct pe_coff_file_hdr *	acoff;
	union  pe_opt_hdr *		aopt;
	struct pe_sec_hdr *		asectbl;

	struct pe_meta_export_hdr	edata;
	struct pe_export_hdr *		aedata;
	struct pe_meta_sec_hdr *	hedata;

	struct pe_meta_import_hdr *	idata;
	struct pe_import_hdr *		aidata;
	struct pe_meta_sec_hdr *	hidata;
};

/* utility api */
int pe_output_export_symbols	(const struct pe_image_meta *, uint32_t flags, FILE *);

/* high-level api */
int pe_map_raw_image		(int fd, const char * name, struct pe_raw_image *);
int pe_unmap_raw_image		(struct pe_raw_image *);

int pe_get_image_meta		(const struct pe_raw_image *, struct pe_image_meta **);
int pe_free_image_meta		(struct pe_image_meta *);

int pe_get_named_section_index	(const struct pe_image_meta *, const char * name);
int pe_get_block_section_index	(const struct pe_image_meta *, const struct pe_block *);

/* low-level api */
int pe_read_dos_header		(const struct pe_image_dos_hdr *,	struct pe_meta_image_dos_hdr *);
int pe_read_coff_header		(const struct pe_coff_file_hdr *,	struct pe_meta_coff_file_hdr *);
int pe_read_optional_header	(const union  pe_opt_hdr *,		struct pe_meta_opt_hdr *);
int pe_read_section_header	(const struct pe_sec_hdr *,		struct pe_meta_sec_hdr *);
int pe_read_export_header	(const struct pe_export_hdr *,		struct pe_meta_export_hdr *);
int pe_read_import_header	(const struct pe_import_hdr *,		struct pe_meta_import_hdr *);
int pe_read_import_lookup_item	(const struct pe_import_lookup_item *,	struct pe_meta_import_lookup_item *,uint32_t magic);

#ifdef __cplusplus
}
#endif

#endif