LLDB mainline
ProcessStructReader.h
Go to the documentation of this file.
1//===---------------------ProcessStructReader.h ------------------*- C++-*-===//
2//
3// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
4// See https://llvm.org/LICENSE.txt for license information.
5// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
6//
7//===----------------------------------------------------------------------===//
8
9#ifndef LLDB_TARGET_PROCESSSTRUCTREADER_H
10#define LLDB_TARGET_PROCESSSTRUCTREADER_H
11
12#include "lldb/lldb-defines.h"
13#include "lldb/lldb-types.h"
14
16#include "lldb/Target/Process.h"
20#include "lldb/Utility/Status.h"
21
22#include <initializer_list>
23#include <map>
24#include <string>
25
26namespace lldb_private {
28protected:
29 struct FieldImpl {
31 size_t offset;
32 size_t size;
33 };
34
35 std::map<ConstString, FieldImpl> m_fields;
39
40public:
42 CompilerType struct_type)
43 : m_byte_order(lldb::eByteOrderInvalid), m_addr_byte_size(0) {
44 if (!process)
45 return;
46 if (base_addr == 0 || base_addr == LLDB_INVALID_ADDRESS)
47 return;
48 m_byte_order = process->GetByteOrder();
50
51 for (size_t idx = 0; idx < struct_type.GetNumFields(); idx++) {
52 std::string name;
53 uint64_t bit_offset;
54 uint32_t bitfield_bit_size;
55 bool is_bitfield;
56 CompilerType field_type = struct_type.GetFieldAtIndex(
57 idx, name, &bit_offset, &bitfield_bit_size, &is_bitfield);
58 // no support for bitfields in here (yet)
59 if (is_bitfield)
60 return;
61 auto size = field_type.GetByteSize(nullptr);
62 // no support for things larger than a uint64_t (yet)
63 if (!size || *size > 8)
64 return;
65 ConstString const_name = ConstString(name.c_str());
66 size_t byte_index = static_cast<size_t>(bit_offset / 8);
67 m_fields[const_name] =
68 FieldImpl{field_type, byte_index, static_cast<size_t>(*size)};
69 }
70 auto total_size = struct_type.GetByteSize(nullptr);
71 if (!total_size)
72 return;
73 lldb::WritableDataBufferSP buffer_sp(new DataBufferHeap(*total_size, 0));
75 process->ReadMemoryFromInferior(base_addr, buffer_sp->GetBytes(),
76 *total_size, error);
77 if (error.Fail())
78 return;
80 }
81
82 template <typename RetType>
83 RetType GetField(ConstString name, RetType fail_value = RetType()) {
84 auto iter = m_fields.find(name), end = m_fields.end();
85 if (iter == end)
86 return fail_value;
87 auto size = iter->second.size;
88 if (sizeof(RetType) < size)
89 return fail_value;
90 lldb::offset_t offset = iter->second.offset;
91 if (offset + size > m_data.GetByteSize())
92 return fail_value;
93 return (RetType)(m_data.GetMaxU64(&offset, size));
94 }
95
96 size_t GetOffsetOf(ConstString name, size_t fail_value = SIZE_MAX) {
97 auto iter = m_fields.find(name), end = m_fields.end();
98 if (iter == end)
99 return fail_value;
100 return iter->second.offset;
101 }
102};
103}
104
105#endif // LLDB_TARGET_PROCESSSTRUCTREADER_H
static llvm::raw_ostream & error(Stream &strm)
Generic representation of a type in a programming language.
Definition: CompilerType.h:36
std::optional< uint64_t > GetByteSize(ExecutionContextScope *exe_scope) const
Return the size of the type in bytes.
CompilerType GetFieldAtIndex(size_t idx, std::string &name, uint64_t *bit_offset_ptr, uint32_t *bitfield_bit_size_ptr, bool *is_bitfield_ptr) const
uint32_t GetNumFields() const
A uniqued constant string class.
Definition: ConstString.h:39
A subclass of DataBuffer that stores a data buffer on the heap.
An data extractor class.
Definition: DataExtractor.h:48
uint64_t GetByteSize() const
Get the number of bytes contained in this object.
uint64_t GetMaxU64(lldb::offset_t *offset_ptr, size_t byte_size) const
Extract an unsigned integer of size byte_size from *offset_ptr.
ProcessStructReader(Process *process, lldb::addr_t base_addr, CompilerType struct_type)
std::map< ConstString, FieldImpl > m_fields
RetType GetField(ConstString name, RetType fail_value=RetType())
size_t GetOffsetOf(ConstString name, size_t fail_value=SIZE_MAX)
A plug-in interface definition class for debugging a process.
Definition: Process.h:343
size_t ReadMemoryFromInferior(lldb::addr_t vm_addr, void *buf, size_t size, Status &error)
Read of memory from a process.
Definition: Process.cpp:2037
lldb::ByteOrder GetByteOrder() const
Definition: Process.cpp:3379
uint32_t GetAddressByteSize() const
Definition: Process.cpp:3383
An error handling class.
Definition: Status.h:44
#define LLDB_INVALID_ADDRESS
Definition: lldb-defines.h:74
A class that represents a running process on the host machine.
Definition: SBAttachInfo.h:14
Definition: SBAddress.h:15
uint64_t offset_t
Definition: lldb-types.h:83
ByteOrder
Byte ordering definitions.
uint64_t addr_t
Definition: lldb-types.h:79