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
|
/* ScummVM - Graphic Adventure Engine
*
* ScummVM is the legal property of its developers, whose names
* are too numerous to list here. Please refer to the COPYRIGHT
* file distributed with this source distribution.
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program. If not, see <http://www.gnu.org/licenses/>.
*
*/
#ifndef BACKENDS_PLUGINS_ELF_LOADER_H
#define BACKENDS_PLUGINS_ELF_LOADER_H
#include "common/scummsys.h"
#if defined(DYNAMIC_MODULES) && defined(USE_ELF_LOADER)
#include <stddef.h>
#include "backends/plugins/elf/elf32.h"
#include "backends/plugins/dynamic-plugin.h"
#include "common/stream.h"
/**
* DLObject
*
* Class that most directly handles operations on a plugin file
* (opening it for reading, loading/unloading it in memory, finding a specific symbol in the file, etc.)
* Subclasses have the same functionality, but implementations specific to different processors/platforms.
*/
class DLObject {
protected:
Common::SeekableReadStream *_file;
byte *_segment;
Elf32_Sym *_symtab;
char *_strtab;
uint32 _segmentSize;
ptrdiff_t _segmentOffset;
uint32 _segmentVMA;
uint32 _symbol_cnt;
int32 _symtab_sect;
void *_dtors_start, *_dtors_end;
virtual void unload();
bool load();
bool readElfHeader(Elf32_Ehdr *ehdr);
bool readProgramHeaders(Elf32_Ehdr *ehdr, Elf32_Phdr *phdr, Elf32_Half num);
virtual bool loadSegment(Elf32_Phdr *phdr);
Elf32_Shdr *loadSectionHeaders(Elf32_Ehdr *ehdr);
int findSymbolTableSection(Elf32_Ehdr *ehdr, Elf32_Shdr *shdr);
int loadSymbolTable(Elf32_Ehdr *ehdr, Elf32_Shdr *shdr);
bool loadStringTable(Elf32_Shdr *shdr);
virtual void relocateSymbols(ptrdiff_t offset);
void discardSegment();
// architecture specific
/**
* Follow the instruction of a relocation section.
*
* @param fileOffset Offset into the File
* @param size Size of relocation section
* @param relSegment Base address of relocated segment in memory (memory offset)
*/
virtual bool relocate(Elf32_Off offset, Elf32_Word size, byte *relSegment) = 0;
virtual bool relocateRels(Elf32_Ehdr *ehdr, Elf32_Shdr *shdr) = 0;
// platform specific
virtual void flushDataCache(void *ptr, uint32 len) const = 0;
virtual void *allocateMemory(uint32 align, uint32 size);
virtual void deallocateMemory(void *ptr, uint32 size);
virtual void protectMemory(void *ptr, uint32 len, int prot) const {};
public:
DLObject();
virtual ~DLObject();
/**
* Test the size of the plugin in memory using the memory manager.
* @param path Path of file
*/
void trackSize(const Common::Path &path);
bool open(const Common::Path &path);
bool close();
void *symbol(const char *name);
void discardSymtab();
};
#endif /* defined(DYNAMIC_MODULES) && defined(USE_ELF_LOADER) */
#endif /* BACKENDS_PLUGINS_ELF_LOADER_H */
|
