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
|
/* =========================================
Copyright (C) 2024-2025 Amlal El Mahrouss, Licensed under the Apache 2.0 license
======================================== */
#pragma once
#include <CompilerKit/Config.h>
// @file PEF.h
// @brief Preferred Executable Format
#define kPefMagic "Open"
#define kPefMagicFat "nepO"
#define kPefExt ".exec"
#define kPefDylibExt ".dylib"
#define kPefLibExt ".lib"
#define kPefObjectExt ".obj"
#define kPefDebugExt ".dbg"
#define kPefDriverExt ".sys"
#define kPefZero128 ".zero128"
#define kPefCode128 ".code128"
#define kPefData128 ".data128"
#define kPefZero64 ".zero64"
#define kPefCode64 ".code64"
#define kPefData64 ".data64"
/* @note counting the \0 at the end */
#define kPefMagicLen (5)
#define kPefVersion (0x0500)
#define kPefNameLen (255)
#define kPefBaseOrigin (0x40000000)
/* @note this doesn't have to be __ImageStart only, any C initialization stub will do. */
#define kPefStart "__ImageStart"
namespace CompilerKit {
/* @brief Architecture type. */
enum {
kPefArchIntel86S,
kPefArchAMD64,
kPefArchRISCV,
kPefArch64000, /* Open64x0 RISC architecture. */
kPefArch32000,
kPefArchPowerPC, /* 64-bit POWER architecture. */
kPefArchARM64,
kPefArchCount = (kPefArchARM64 - kPefArchIntel86S) + 1,
kPefArchInvalid = 0xFF,
};
/* @brief Architecture vendor. */
enum {
kPefSubArchGeneric = 0,
kPefSubArchAMD = 200,
kPefSubArchIntel,
kPefSubArchARM,
kPefSubArchIBM,
};
enum {
kPefKindInvalid = 0,
kPefKindExec = 1, /* .exec */
kPefKindDylib = 2, /* .dylib */
kPefKindObject = 4, /* .obj */
kPefKindDebug = 5, /* .dbg */
kPefKindDriver = 6,
kPefKindCount,
};
/* PEF container information */
typedef struct PEFContainer final {
Char Magic[kPefMagicLen];
UInt32 Linker; /* Linker used to link executable */
UInt32 Version;
UInt32 Kind;
UInt32 Abi;
UInt32 Cpu;
UInt32 SubCpu; /* Cpu specific information */
UIntPtr Start; /* Origin of code */
SizeType HdrSz; /* Size of header */
SizeType Count; /* container header count */
UInt32 Checksum; /* Whole binary checksum */
} PACKED PEFContainer, *PEFContainerPtr;
/* First PEFCommandHeader starts after PEFContainer */
/* Last container is __exec_end */
/* PEF executable section and commands. */
/* @brief Command Header, a la Mach-O, designed with FAT binaries and virtual memory in mind. */
typedef struct PEFCommandHeader final {
Char Name[kPefNameLen]; /* container name */
UInt32 Cpu; /* container cpu */
UInt32 SubCpu; /* container sub-cpu */
UInt32 Flags; /* container flags */
UInt16 Kind; /* container kind */
UIntPtr Offset; /* File offset */
SizeType OffsetSize;
UIntPtr VirtualAddress; /* Virtual Address */
SizeType VirtualSize; /* Virtual Size */
} PACKED PEFCommandHeader, *PEFCommandHeaderPtr;
enum {
kPefInvalid = 0x0,
kPefCode = 0xC,
kPefData = 0xD,
kPefZero = 0xE,
kPefLinkerID = 0x1,
kPefCount = 4,
};
} // namespace CompilerKit
inline std::ofstream& operator<<(std::ofstream& fp, CompilerKit::PEFContainer& container) {
fp.write((char*) &container, sizeof(CompilerKit::PEFContainer));
return fp;
}
inline std::ofstream& operator<<(std::ofstream& fp, CompilerKit::PEFCommandHeader& container) {
fp.write((char*) &container, sizeof(CompilerKit::PEFCommandHeader));
return fp;
}
inline std::ifstream& operator>>(std::ifstream& fp, CompilerKit::PEFContainer& container) {
fp.read((char*) &container, sizeof(CompilerKit::PEFContainer));
return fp;
}
inline std::ifstream& operator>>(std::ifstream& fp, CompilerKit::PEFCommandHeader& container) {
fp.read((char*) &container, sizeof(CompilerKit::PEFCommandHeader));
return fp;
}
|
