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
|
/* Copyright 2017 R. Thomas
* Copyright 2017 Quarkslab
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
#include "pyPE.hpp"
#include "LIEF/PE/hash.hpp"
#include "LIEF/PE/TLS.hpp"
#include <string>
#include <sstream>
namespace LIEF {
namespace PE {
template<class T>
using getter_t = T (TLS::*)(void) const;
template<class T>
using setter_t = void (TLS::*)(T);
template<class T>
using no_const_getter = T (TLS::*)(void);
template<>
void create<TLS>(py::module& m) {
py::class_<TLS, LIEF::Object>(m, "TLS")
.def(py::init<>(),
"Default constructor")
.def_property("callbacks",
static_cast<getter_t<const std::vector<uint64_t>&>>(&TLS::callbacks),
static_cast<setter_t<const std::vector<uint64_t>&>>(&TLS::callbacks),
"List of the callbacks called before any other functions")
.def_property("addressof_index",
static_cast<getter_t<uint64_t>>(&TLS::addressof_index),
static_cast<setter_t<uint64_t>>(&TLS::addressof_index),
"The location to receive the TLS index, which the "
"loader assigns. This location is in an ordinary data "
"section, so it can be given a symbolic name that is "
"accessible to the program.")
.def_property("addressof_callbacks",
static_cast<getter_t<uint64_t>>(&TLS::addressof_callbacks),
static_cast<setter_t<uint64_t>>(&TLS::addressof_callbacks),
"The pointer to an array of TLS callback functions. "
"The array is null-terminated, so if no callback "
"function is supported, this field points to 4 bytes set "
"to zero")
.def_property("sizeof_zero_fill",
static_cast<getter_t<uint32_t>>(&TLS::sizeof_zero_fill),
static_cast<setter_t<uint32_t>>(&TLS::sizeof_zero_fill),
"The size in bytes of the template, beyond the "
"initialized data delimited by the :attr:`lief.PE.TLS.addressof_raw_data` "
"fields. The total template "
"size should be the same as the total size of TLS "
"data in the image file. The zero fill is the amount of "
"data that comes after the initialized nonzero data.")
.def_property("characteristics",
static_cast<getter_t<uint32_t>>(&TLS::characteristics),
static_cast<setter_t<uint32_t>>(&TLS::characteristics),
"The four bits [23:20] describe alignment info. "
"Possible values are those defined as "
"IMAGE_SCN_ALIGN_*, which are also used to "
"describe alignment of section in object files. The "
"other 28 bits are reserved for future use.")
.def_property("addressof_raw_data",
static_cast<getter_t<std::pair<uint64_t, uint64_t>>>(&TLS::addressof_raw_data),
static_cast<setter_t<std::pair<uint64_t, uint64_t>>>(&TLS::addressof_raw_data),
"Tuple ``(start address, end address)`` of the TLS template. The "
"template is a block of data that is used to initialize "
"TLS data. The system copies all of this data each "
"time a thread is created, so it must not be "
"corrupted. Note that these addresses are not RVA; it is "
"addresses for which there should be a base "
"relocation in the .reloc section. ")
.def_property("data_template",
static_cast<getter_t<const std::vector<uint8_t>&>>(&TLS::data_template),
static_cast<setter_t<const std::vector<uint8_t>&>>(&TLS::data_template),
"The data template content")
.def_property_readonly("has_section",
&TLS::has_section,
"``True`` if there is a " RST_CLASS_REF(lief.PE.Section) " associated with the TLS object")
.def_property_readonly("has_data_directory",
&TLS::has_data_directory,
"``True`` if there is a " RST_CLASS_REF(lief.PE.DataDirectory) " associated with the TLS object")
.def_property_readonly("directory",
static_cast<no_const_getter<DataDirectory&>>(&TLS::directory),
"" RST_CLASS_REF(lief.PE.DataDirectory) " associated with the TLS object",
py::return_value_policy::reference)
.def_property_readonly("section",
static_cast<no_const_getter<Section&>>(&TLS::section),
"" RST_CLASS_REF(lief.PE.Section) " associated with the TLS object",
py::return_value_policy::reference)
.def("__eq__", &TLS::operator==)
.def("__ne__", &TLS::operator!=)
.def("__hash__",
[] (const TLS& tls) {
return Hash::hash(tls);
})
.def("__str__", [] (const TLS& tls)
{
std::ostringstream stream;
stream << tls;
std::string str = stream.str();
return str;
});
}
}
}
|
