LIEF: Library to Instrument Executable Formats Version 0.17.0
Loading...
Searching...
No Matches
ResourceData.hpp
Go to the documentation of this file.
1/* Copyright 2017 - 2025 R. Thomas
2 * Copyright 2017 - 2025 Quarkslab
3 *
4 * Licensed under the Apache License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at
7 *
8 * http://www.apache.org/licenses/LICENSE-2.0
9 *
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License.
15 */
16#ifndef LIEF_PE_RESOURCE_DATA_H
17#define LIEF_PE_RESOURCE_DATA_H
18
19#include <vector>
20
21#include "LIEF/visibility.h"
23#include "LIEF/span.hpp"
24#include "LIEF/iostream.hpp"
25
26namespace LIEF {
27namespace PE {
28
29class Parser;
30class Builder;
31class LIEF_API ResourceData : public ResourceNode {
34 friend class Parser;
35 friend class Builder;
36
37 public:
39 ResourceNode(ResourceNode::TYPE::DATA)
40 {}
41 ResourceData(std::vector<uint8_t> content, uint32_t code_page = 0) :
42 ResourceNode(ResourceNode::TYPE::DATA),
43 content_(std::move(content)),
44 code_page_(code_page)
45 {}
46
47 ResourceData(const std::string& str, uint32_t code_page = 0) :
48 ResourceNode(ResourceNode::TYPE::DATA),
49 content_{str.begin(), str.end()},
50 code_page_(code_page)
51 {}
52
53 ResourceData(const ResourceData& other) = default;
54 ResourceData& operator=(const ResourceData& other) = default;
55 void swap(ResourceData& other) noexcept;
56
57 ~ResourceData() override = default;
58
59 std::unique_ptr<ResourceNode> clone() const override {
60 return std::unique_ptr<ResourceData>{new ResourceData{*this}};
61 }
62 uint32_t code_page() const {
66 return code_page_;
67 }
68 span<const uint8_t> content() const {
71 return content_;
72 }
73
74 span<uint8_t> content() {
75 return content_;
76 }
77 uint32_t reserved() const {
80 return reserved_;
81 }
82 uint32_t offset() const {
87 return offset_;
88 }
89
90 void code_page(uint32_t code_page) {
91 code_page_ = code_page;
92 }
93
94 void content(std::vector<uint8_t> content) {
95 content_ = std::move(content);
96 }
97
98 void content(const std::string& string) {
99 content_ = {string.begin(), string.end()};
100 }
101
102 void content(const uint8_t* buffer, size_t size) {
103 content_ = {buffer, buffer + size};
104 }
105
106 void reserved(uint32_t value) {
107 reserved_ = value;
108 }
109 LIEF_LOCAL vector_iostream edit() {
112 return vector_iostream(content_);
113 }
114 LIEF_LOCAL const std::vector<uint8_t> raw_content() const {
117 return content_;
118 }
119 LIEF_LOCAL void set_offset(uint32_t offset) {
122 offset_ = offset;
123 }
124
125 static bool classof(const ResourceNode* node) {
126 return node->is_data();
127 }
128
129 void accept(Visitor& visitor) const override;
130
131 private:
132 std::vector<uint8_t> content_;
133 uint32_t code_page_ = 0;
134 uint32_t reserved_ = 0;
135 uint32_t offset_ = 0;
136};
137
138} // namespace PE
139} // namepsace LIEF
140#endif /* RESOURCEDATA_H */
ResourceNode.hpp
LIEF::PE::Builder
Class that is used to rebuild a raw PE binary from a PE::Binary object.
Definition PE/Builder.hpp:45
LIEF::PE::Parser
Main interface to parse PE binaries. In particular the static functions: Parser::parse should be used...
Definition PE/Parser.hpp:52
LIEF::PE::ResourceData
Class which represents a Data Node in the PE resources tree.
Definition ResourceData.hpp:33
LIEF::PE::ResourceData::ResourceData
ResourceData(const std::string &str, uint32_t code_page=0)
Definition ResourceData.hpp:47
LIEF::PE::ResourceData::content
span< uint8_t > content()
Definition ResourceData.hpp:74
LIEF::PE::ResourceData::ResourceData
ResourceData()
Definition ResourceData.hpp:38
LIEF::PE::ResourceData::operator=
ResourceData & operator=(const ResourceData &other)=default
LIEF::PE::ResourceData::content
void content(const uint8_t *buffer, size_t size)
Definition ResourceData.hpp:102
LIEF::PE::ResourceData::offset
uint32_t offset() const
Offset of the content within the resource.
Definition ResourceData.hpp:86
LIEF::PE::ResourceData::clone
std::unique_ptr< ResourceNode > clone() const override
Definition ResourceData.hpp:59
LIEF::PE::ResourceData::reserved
uint32_t reserved() const
Reserved value. Should be 0
Definition ResourceData.hpp:79
LIEF::PE::ResourceData::code_page
void code_page(uint32_t code_page)
Definition ResourceData.hpp:90
LIEF::PE::ResourceData::accept
void accept(Visitor &visitor) const override
LIEF::PE::ResourceData::reserved
void reserved(uint32_t value)
Definition ResourceData.hpp:106
LIEF::PE::ResourceData::classof
static bool classof(const ResourceNode *node)
Definition ResourceData.hpp:125
LIEF::PE::ResourceData::content
span< const uint8_t > content() const
Resource content.
Definition ResourceData.hpp:70
LIEF::PE::ResourceData::code_page
uint32_t code_page() const
Return the code page that is used to decode code point values within the resource data....
Definition ResourceData.hpp:65
LIEF::PE::ResourceData::ResourceData
ResourceData(const ResourceData &other)=default
LIEF::PE::ResourceData::content
void content(const std::string &string)
Definition ResourceData.hpp:98
LIEF::PE::ResourceData::~ResourceData
~ResourceData() override=default
LIEF::PE::ResourceData::ResourceData
ResourceData(std::vector< uint8_t > content, uint32_t code_page=0)
Definition ResourceData.hpp:41
LIEF::PE::ResourceData::swap
void swap(ResourceData &other) noexcept
LIEF::PE::ResourceData::content
void content(std::vector< uint8_t > content)
Definition ResourceData.hpp:94
LIEF::PE::ResourceNode
Class which represents a Node in the resource tree.
Definition ResourceNode.hpp:45
LIEF::PE::ResourceNode::is_data
bool is_data() const
True if the current entry is a ResourceData.
Definition ResourceNode.hpp:155
iostream.hpp
LIEF::PE
Namespace related to the LIEF's PE module.
Definition Abstract/Header.hpp:32
LIEF
LIEF namespace.
Definition Abstract/Binary.hpp:36
span.hpp
visibility.h
LIEF_API
#define LIEF_API
Definition visibility.h:41
LIEF_LOCAL
#define LIEF_LOCAL
Definition visibility.h:42