1 //===-- RegisterValue.cpp ---------------------------------------*- C++ -*-===//
3 // The LLVM Compiler Infrastructure
5 // This file is distributed under the University of Illinois Open Source
6 // License. See LICENSE.TXT for details.
8 //===----------------------------------------------------------------------===//
10 #include "lldb/Utility/RegisterValue.h"
12 #include "lldb/Utility/Args.h"
13 #include "lldb/Utility/DataExtractor.h"
14 #include "lldb/Utility/Scalar.h"
15 #include "lldb/Utility/Status.h"
16 #include "lldb/Utility/Stream.h"
17 #include "lldb/Utility/StreamString.h"
18 #include "lldb/lldb-defines.h"
19 #include "lldb/lldb-private-types.h"
21 #include "llvm/ADT/ArrayRef.h"
22 #include "llvm/ADT/StringRef.h"
34 using namespace lldb_private;
36 bool RegisterValue::GetData(DataExtractor &data) const {
37 return data.SetData(GetBytes(), GetByteSize(), GetByteOrder()) > 0;
40 uint32_t RegisterValue::GetAsMemoryData(const RegisterInfo *reg_info, void *dst,
42 lldb::ByteOrder dst_byte_order,
43 Status &error) const {
44 if (reg_info == nullptr) {
45 error.SetErrorString("invalid register info argument.");
49 // ReadRegister should have already been called on this object prior to
51 if (GetType() == eTypeInvalid) {
52 // No value has been read into this object...
53 error.SetErrorStringWithFormat(
54 "invalid register value type for register %s", reg_info->name);
58 if (dst_len > kMaxRegisterByteSize) {
59 error.SetErrorString("destination is too big");
63 const uint32_t src_len = reg_info->byte_size;
65 // Extract the register data into a data extractor
66 DataExtractor reg_data;
67 if (!GetData(reg_data)) {
68 error.SetErrorString("invalid register value to copy into");
72 // Prepare a memory buffer that contains some or all of the register value
73 const uint32_t bytes_copied =
74 reg_data.CopyByteOrderedData(0, // src offset
75 src_len, // src length
77 dst_len, // dst length
78 dst_byte_order); // dst byte order
79 if (bytes_copied == 0)
80 error.SetErrorStringWithFormat(
81 "failed to copy data for register write of %s", reg_info->name);
86 uint32_t RegisterValue::SetFromMemoryData(const RegisterInfo *reg_info,
87 const void *src, uint32_t src_len,
88 lldb::ByteOrder src_byte_order,
90 if (reg_info == nullptr) {
91 error.SetErrorString("invalid register info argument.");
95 // Moving from addr into a register
97 // Case 1: src_len == dst_len
99 // |AABBCCDD| Address contents
100 // |AABBCCDD| Register contents
102 // Case 2: src_len > dst_len
104 // Status! (The register should always be big enough to hold the data)
106 // Case 3: src_len < dst_len
108 // |AABB| Address contents
109 // |AABB0000| Register contents [on little-endian hardware]
110 // |0000AABB| Register contents [on big-endian hardware]
111 if (src_len > kMaxRegisterByteSize) {
112 error.SetErrorStringWithFormat(
113 "register buffer is too small to receive %u bytes of data.", src_len);
117 const uint32_t dst_len = reg_info->byte_size;
119 if (src_len > dst_len) {
120 error.SetErrorStringWithFormat(
121 "%u bytes is too big to store in register %s (%u bytes)", src_len,
122 reg_info->name, dst_len);
126 // Use a data extractor to correctly copy and pad the bytes read into the
128 DataExtractor src_data(src, src_len, src_byte_order, 4);
130 error = SetValueFromData(reg_info, src_data, 0, true);
134 // If SetValueFromData succeeded, we must have copied all of src_len
138 bool RegisterValue::GetScalarValue(Scalar &scalar) const {
143 switch (buffer.length) {
147 scalar = *(const uint8_t *)buffer.bytes;
150 scalar = *(const uint16_t *)buffer.bytes;
153 scalar = *(const uint32_t *)buffer.bytes;
156 scalar = *(const uint64_t *)buffer.bytes;
160 if (buffer.length % sizeof(uint64_t) == 0) {
161 const auto length_in_bits = buffer.length * 8;
162 const auto length_in_uint64 = buffer.length / sizeof(uint64_t);
164 llvm::APInt(length_in_bits,
165 llvm::ArrayRef<uint64_t>((const uint64_t *)buffer.bytes,
179 case eTypeLongDouble:
186 void RegisterValue::Clear() { m_type = eTypeInvalid; }
188 RegisterValue::Type RegisterValue::SetType(const RegisterInfo *reg_info) {
189 // To change the type, we simply copy the data in again, using the new format
191 DataExtractor copy_data;
192 if (copy.CopyValue(*this) && copy.GetData(copy_data))
193 SetValueFromData(reg_info, copy_data, 0, true);
198 Status RegisterValue::SetValueFromData(const RegisterInfo *reg_info,
200 lldb::offset_t src_offset,
201 bool partial_data_ok) {
204 if (src.GetByteSize() == 0) {
205 error.SetErrorString("empty data.");
209 if (reg_info->byte_size == 0) {
210 error.SetErrorString("invalid register info.");
214 uint32_t src_len = src.GetByteSize() - src_offset;
216 if (!partial_data_ok && (src_len < reg_info->byte_size)) {
217 error.SetErrorString("not enough data.");
221 // Cap the data length if there is more than enough bytes for this register
223 if (src_len > reg_info->byte_size)
224 src_len = reg_info->byte_size;
226 // Zero out the value in case we get partial data...
227 memset(buffer.bytes, 0, sizeof(buffer.bytes));
231 m_type = eTypeInvalid;
232 switch (reg_info->encoding) {
233 case eEncodingInvalid:
237 if (reg_info->byte_size == 1)
238 SetUInt8(src.GetMaxU32(&src_offset, src_len));
239 else if (reg_info->byte_size <= 2)
240 SetUInt16(src.GetMaxU32(&src_offset, src_len));
241 else if (reg_info->byte_size <= 4)
242 SetUInt32(src.GetMaxU32(&src_offset, src_len));
243 else if (reg_info->byte_size <= 8)
244 SetUInt64(src.GetMaxU64(&src_offset, src_len));
245 else if (reg_info->byte_size <= 16) {
246 uint64_t data1 = src.GetU64(&src_offset);
247 uint64_t data2 = src.GetU64(&src_offset);
248 if (src.GetByteSize() == eByteOrderBig) {
255 SetUInt128(llvm::APInt(128, 2, int128.x));
258 case eEncodingIEEE754:
259 if (reg_info->byte_size == sizeof(float))
260 SetFloat(src.GetFloat(&src_offset));
261 else if (reg_info->byte_size == sizeof(double))
262 SetDouble(src.GetDouble(&src_offset));
263 else if (reg_info->byte_size == sizeof(long double))
264 SetLongDouble(src.GetLongDouble(&src_offset));
266 case eEncodingVector: {
268 buffer.length = reg_info->byte_size;
269 buffer.byte_order = src.GetByteOrder();
270 assert(buffer.length <= kMaxRegisterByteSize);
271 if (buffer.length > kMaxRegisterByteSize)
272 buffer.length = kMaxRegisterByteSize;
273 if (src.CopyByteOrderedData(
274 src_offset, // offset within "src" to start extracting data
275 src_len, // src length
276 buffer.bytes, // dst buffer
277 buffer.length, // dst length
278 buffer.byte_order) == 0) // dst byte order
280 error.SetErrorStringWithFormat(
281 "failed to copy data for register write of %s", reg_info->name);
287 if (m_type == eTypeInvalid)
288 error.SetErrorStringWithFormat(
289 "invalid register value type for register %s", reg_info->name);
293 // Helper function for RegisterValue::SetValueFromString()
294 static bool ParseVectorEncoding(const RegisterInfo *reg_info,
295 llvm::StringRef vector_str,
296 const uint32_t byte_size,
297 RegisterValue *reg_value) {
298 // Example: vector_str = "{0x2c 0x4b 0x2a 0x3e 0xd0 0x4f 0x2a 0x3e 0xac 0x4a
299 // 0x2a 0x3e 0x84 0x4f 0x2a 0x3e}".
300 vector_str = vector_str.trim();
301 vector_str.consume_front("{");
302 vector_str.consume_back("}");
303 vector_str = vector_str.trim();
307 // The first split should give us:
308 // ('0x2c', '0x4b 0x2a 0x3e 0xd0 0x4f 0x2a 0x3e 0xac 0x4a 0x2a 0x3e 0x84 0x4f
311 llvm::StringRef cdr = vector_str;
312 std::tie(car, cdr) = vector_str.split(Sep);
313 std::vector<uint8_t> bytes;
316 // Using radix auto-sensing by passing 0 as the radix. Keep on processing the
317 // vector elements as long as the parsing succeeds and the vector size is <
319 while (!car.getAsInteger(0, byte) && bytes.size() < byte_size) {
320 bytes.push_back(byte);
321 std::tie(car, cdr) = cdr.split(Sep);
324 // Check for vector of exact byte_size elements.
325 if (bytes.size() != byte_size)
328 reg_value->SetBytes(&(bytes.front()), byte_size, eByteOrderLittle);
332 Status RegisterValue::SetValueFromString(const RegisterInfo *reg_info,
333 llvm::StringRef value_str) {
335 if (reg_info == nullptr) {
336 error.SetErrorString("Invalid register info argument.");
340 m_type = eTypeInvalid;
341 if (value_str.empty()) {
342 error.SetErrorString("Invalid c-string value string.");
345 const uint32_t byte_size = reg_info->byte_size;
351 long double ldbl_val;
352 switch (reg_info->encoding) {
353 case eEncodingInvalid:
354 error.SetErrorString("Invalid encoding.");
358 if (byte_size > sizeof(uint64_t)) {
359 error.SetErrorStringWithFormat(
360 "unsupported unsigned integer byte size: %u", byte_size);
363 if (value_str.getAsInteger(0, uval64)) {
364 error.SetErrorStringWithFormat(
365 "'%s' is not a valid unsigned integer string value",
366 value_str.str().c_str());
370 if (!Args::UInt64ValueIsValidForByteSize(uval64, byte_size)) {
371 error.SetErrorStringWithFormat(
373 " is too large to fit in a %u byte unsigned integer value",
378 if (!SetUInt(uval64, reg_info->byte_size)) {
379 error.SetErrorStringWithFormat(
380 "unsupported unsigned integer byte size: %u", byte_size);
386 if (byte_size > sizeof(long long)) {
387 error.SetErrorStringWithFormat("unsupported signed integer byte size: %u",
392 if (value_str.getAsInteger(0, ival64)) {
393 error.SetErrorStringWithFormat(
394 "'%s' is not a valid signed integer string value",
395 value_str.str().c_str());
399 if (!Args::SInt64ValueIsValidForByteSize(ival64, byte_size)) {
400 error.SetErrorStringWithFormat(
402 " is too large to fit in a %u byte signed integer value",
407 if (!SetUInt(ival64, reg_info->byte_size)) {
408 error.SetErrorStringWithFormat("unsupported signed integer byte size: %u",
414 case eEncodingIEEE754: {
415 std::string value_string = value_str;
416 if (byte_size == sizeof(float)) {
417 if (::sscanf(value_string.c_str(), "%f", &flt_val) != 1) {
418 error.SetErrorStringWithFormat("'%s' is not a valid float string value",
419 value_string.c_str());
424 } else if (byte_size == sizeof(double)) {
425 if (::sscanf(value_string.c_str(), "%lf", &dbl_val) != 1) {
426 error.SetErrorStringWithFormat("'%s' is not a valid float string value",
427 value_string.c_str());
431 m_type = eTypeDouble;
432 } else if (byte_size == sizeof(long double)) {
433 if (::sscanf(value_string.c_str(), "%Lf", &ldbl_val) != 1) {
434 error.SetErrorStringWithFormat("'%s' is not a valid float string value",
435 value_string.c_str());
439 m_type = eTypeLongDouble;
441 error.SetErrorStringWithFormat("unsupported float byte size: %u",
447 case eEncodingVector:
448 if (!ParseVectorEncoding(reg_info, value_str, byte_size, this))
449 error.SetErrorString("unrecognized vector encoding string value.");
456 bool RegisterValue::SignExtend(uint32_t sign_bitpos) {
466 return m_scalar.SignExtend(sign_bitpos);
469 case eTypeLongDouble:
476 bool RegisterValue::CopyValue(const RegisterValue &rhs) {
478 return rhs.m_type != eTypeInvalid;
491 case eTypeLongDouble:
492 m_scalar = rhs.m_scalar;
495 assert(rhs.buffer.length <= kMaxRegisterByteSize);
496 ::memcpy(buffer.bytes, rhs.buffer.bytes, kMaxRegisterByteSize);
497 buffer.length = rhs.buffer.length;
498 buffer.byte_order = rhs.buffer.byte_order;
504 uint16_t RegisterValue::GetAsUInt16(uint16_t fail_value,
505 bool *success_ptr) const {
514 return m_scalar.UShort(fail_value);
516 switch (buffer.length) {
521 return *(const uint16_t *)buffer.bytes;
526 *success_ptr = false;
530 uint32_t RegisterValue::GetAsUInt32(uint32_t fail_value,
531 bool *success_ptr) const {
542 case eTypeLongDouble:
543 return m_scalar.UInt(fail_value);
545 switch (buffer.length) {
551 return *(const uint32_t *)buffer.bytes;
556 *success_ptr = false;
560 uint64_t RegisterValue::GetAsUInt64(uint64_t fail_value,
561 bool *success_ptr) const {
573 case eTypeLongDouble:
574 return m_scalar.ULongLong(fail_value);
576 switch (buffer.length) {
580 return *(const uint8_t *)buffer.bytes;
582 return *(const uint16_t *)buffer.bytes;
584 return *(const uint32_t *)buffer.bytes;
586 return *(const uint64_t *)buffer.bytes;
591 *success_ptr = false;
595 llvm::APInt RegisterValue::GetAsUInt128(const llvm::APInt &fail_value,
596 bool *success_ptr) const {
609 case eTypeLongDouble:
610 return m_scalar.UInt128(fail_value);
612 switch (buffer.length) {
620 return llvm::APInt(BITWIDTH_INT128, NUM_OF_WORDS_INT128,
621 ((const type128 *)buffer.bytes)->x);
626 *success_ptr = false;
630 float RegisterValue::GetAsFloat(float fail_value, bool *success_ptr) const {
641 case eTypeLongDouble:
642 return m_scalar.Float(fail_value);
645 *success_ptr = false;
649 double RegisterValue::GetAsDouble(double fail_value, bool *success_ptr) const {
661 case eTypeLongDouble:
662 return m_scalar.Double(fail_value);
665 *success_ptr = false;
669 long double RegisterValue::GetAsLongDouble(long double fail_value,
670 bool *success_ptr) const {
682 case eTypeLongDouble:
683 return m_scalar.LongDouble();
686 *success_ptr = false;
690 const void *RegisterValue::GetBytes() const {
701 case eTypeLongDouble:
702 return m_scalar.GetBytes();
709 uint32_t RegisterValue::GetByteSize() const {
722 case eTypeLongDouble:
723 return m_scalar.GetByteSize();
725 return buffer.length;
730 bool RegisterValue::SetUInt(uint64_t uint, uint32_t byte_size) {
731 if (byte_size == 0) {
733 } else if (byte_size == 1) {
735 } else if (byte_size <= 2) {
737 } else if (byte_size <= 4) {
739 } else if (byte_size <= 8) {
741 } else if (byte_size <= 16) {
742 SetUInt128(llvm::APInt(128, uint));
748 void RegisterValue::SetBytes(const void *bytes, size_t length,
749 lldb::ByteOrder byte_order) {
750 // If this assertion fires off we need to increase the size of buffer.bytes,
751 // or make it something that is allocated on the heap. Since the data buffer
752 // is in a union, we can't make it a collection class like SmallVector...
753 if (bytes && length > 0) {
754 assert(length <= sizeof(buffer.bytes) &&
755 "Storing too many bytes in a RegisterValue.");
757 buffer.length = length;
758 memcpy(buffer.bytes, bytes, length);
759 buffer.byte_order = byte_order;
761 m_type = eTypeInvalid;
766 bool RegisterValue::operator==(const RegisterValue &rhs) const {
767 if (m_type == rhs.m_type) {
778 case eTypeLongDouble:
779 return m_scalar == rhs.m_scalar;
781 if (buffer.length != rhs.buffer.length)
784 uint8_t length = buffer.length;
785 if (length > kMaxRegisterByteSize)
786 length = kMaxRegisterByteSize;
787 return memcmp(buffer.bytes, rhs.buffer.bytes, length) == 0;
795 bool RegisterValue::operator!=(const RegisterValue &rhs) const {
796 return !(*this == rhs);
799 bool RegisterValue::ClearBit(uint32_t bit) {
809 if (bit < (GetByteSize() * 8)) {
810 return m_scalar.ClearBit(bit);
816 case eTypeLongDouble:
820 if (buffer.byte_order == eByteOrderBig ||
821 buffer.byte_order == eByteOrderLittle) {
823 if (buffer.byte_order == eByteOrderBig)
824 byte_idx = buffer.length - (bit / 8) - 1;
828 const uint32_t byte_bit = bit % 8;
829 if (byte_idx < buffer.length) {
830 buffer.bytes[byte_idx] &= ~(1u << byte_bit);
839 bool RegisterValue::SetBit(uint32_t bit) {
849 if (bit < (GetByteSize() * 8)) {
850 return m_scalar.SetBit(bit);
856 case eTypeLongDouble:
860 if (buffer.byte_order == eByteOrderBig ||
861 buffer.byte_order == eByteOrderLittle) {
863 if (buffer.byte_order == eByteOrderBig)
864 byte_idx = buffer.length - (bit / 8) - 1;
868 const uint32_t byte_bit = bit % 8;
869 if (byte_idx < buffer.length) {
870 buffer.bytes[byte_idx] |= (1u << byte_bit);