Files
clang-p2996/lldb/test/API/commands/memory/read/TestMemoryRead.py
Dave Lee 4cc8f2a017 [lldb][tests] Automatically call compute_mydir (NFC)
Eliminate boilerplate of having each test manually assign to `mydir` by calling
`compute_mydir` in lldbtest.py.

Differential Revision: https://reviews.llvm.org/D128077
2022-06-17 14:34:49 -07:00

171 lines
6.5 KiB
Python

"""
Test the 'memory read' command.
"""
import lldb
import lldbsuite.test.lldbutil as lldbutil
from lldbsuite.test.decorators import *
from lldbsuite.test.lldbtest import *
class MemoryReadTestCase(TestBase):
NO_DEBUG_INFO_TESTCASE = True
def build_run_stop(self):
self.build()
lldbutil.run_to_source_breakpoint(self, "// break here",
lldb.SBFileSpec("main.c"))
def test_memory_read_c_string(self):
"""Test that reading memory as a c string respects the size limit given
and warns if the null terminator is missing."""
self.build_run_stop()
# The size here is the size in memory so it includes the null terminator.
cmd = "memory read --format \"c-string\" --size {} &my_string"
# Size matches the size of the array.
self.expect(cmd.format(8), substrs=['\"abcdefg\"'])
# If size would take us past the terminator we stop at the terminator.
self.expect(cmd.format(10), substrs=['\"abcdefg\"'])
# Size 3 means 2 chars and a terminator. So we print 2 chars but warn because
# the third isn't 0 as expected.
self.expect(cmd.format(3), substrs=['\"ab\"'])
self.assertRegex(self.res.GetError(),
"unable to find a NULL terminated string at 0x[0-9A-Fa-f]+."
" Consider increasing the maximum read length.")
def test_memory_read(self):
"""Test the 'memory read' command with plain and vector formats."""
self.build_run_stop()
# (lldb) memory read -f d -c 1 `&argc`
# 0x7fff5fbff9a0: 1
self.runCmd("memory read -f d -c 1 `&argc`")
# Find the starting address for variable 'argc' to verify later that the
# '--format uint32_t[] --size 4 --count 4' option increments the address
# correctly.
line = self.res.GetOutput().splitlines()[0]
items = line.split(':')
address = int(items[0], 0)
argc = int(items[1], 0)
self.assertGreater(address, 0)
self.assertEquals(argc, 1)
# (lldb) memory read --format uint32_t[] --size 4 --count 4 `&argc`
# 0x7fff5fbff9a0: {0x00000001}
# 0x7fff5fbff9a4: {0x00000000}
# 0x7fff5fbff9a8: {0x0ec0bf27}
# 0x7fff5fbff9ac: {0x215db505}
self.runCmd(
"memory read --format uint32_t[] --size 4 --count 4 `&argc`")
lines = self.res.GetOutput().splitlines()
for i in range(4):
if i == 0:
# Verify that the printout for argc is correct.
self.assertEqual(
argc, int(lines[i].split(':')[1].strip(' {}'), 0))
addr = int(lines[i].split(':')[0], 0)
# Verify that the printout for addr is incremented correctly.
self.assertEqual(addr, (address + i * 4))
# (lldb) memory read --format char[] --size 7 --count 1 `&my_string`
# 0x7fff5fbff990: {abcdefg}
self.expect(
"memory read --format char[] --size 7 --count 1 `&my_string`",
substrs=['abcdefg'])
# (lldb) memory read --format 'hex float' --size 16 `&argc`
# 0x7fff5fbff5b0: error: unsupported byte size (16) for hex float
# format
self.expect(
"memory read --format 'hex float' --size 16 `&argc`",
substrs=['unsupported byte size (16) for hex float format'])
self.expect(
"memory read --format 'float' --count 1 --size 8 `&my_double`",
substrs=['1234.'])
# (lldb) memory read --format 'float' --count 1 --size 20 `&my_double`
# 0x7fff5fbff598: error: unsupported byte size (20) for float format
self.expect(
"memory read --format 'float' --count 1 --size 20 `&my_double`",
substrs=['unsupported byte size (20) for float format'])
self.expect('memory read --type int --count 5 `&my_ints[0]`',
substrs=['(int) 0x', '2', '4', '6', '8', '10'])
self.expect(
'memory read --type int --count 5 --format hex `&my_ints[0]`',
substrs=[
'(int) 0x',
'0x',
'0a'])
self.expect(
'memory read --type int --count 5 --offset 5 `&my_ints[0]`',
substrs=[
'(int) 0x',
'12',
'14',
'16',
'18',
'20'])
# the gdb format specifier and the size in characters for
# the returned values including the 0x prefix.
variations = [['b', 4], ['h', 6], ['w', 10], ['g', 18]]
for v in variations:
formatter = v[0]
expected_object_length = v[1]
self.runCmd(
"memory read --gdb-format 4%s &my_uint64s" % formatter)
lines = self.res.GetOutput().splitlines()
objects_read = []
for l in lines:
objects_read.extend(l.split(':')[1].split())
# Check that we got back 4 0x0000 etc bytes
for o in objects_read:
self.assertEqual(len(o), expected_object_length)
self.assertEquals(len(objects_read), 4)
def test_memory_read_file(self):
self.build_run_stop()
res = lldb.SBCommandReturnObject()
self.ci.HandleCommand("memory read -f d -c 1 `&argc`", res)
self.assertTrue(res.Succeeded(), "memory read failed:" + res.GetError())
# Record golden output.
golden_output = res.GetOutput()
memory_read_file = self.getBuildArtifact("memory-read-output")
def check_file_content(expected):
with open(memory_read_file) as f:
lines = f.readlines()
lines = [s.strip() for s in lines]
expected = [s.strip() for s in expected]
self.assertEqual(lines, expected)
# Sanity check.
self.runCmd("memory read -f d -c 1 -o '{}' `&argc`".format(memory_read_file))
check_file_content([golden_output])
# Write some garbage to the file.
with open(memory_read_file, 'w') as f:
f.write("some garbage")
# Make sure the file is truncated when we run the command again.
self.runCmd("memory read -f d -c 1 -o '{}' `&argc`".format(memory_read_file))
check_file_content([golden_output])
# Make sure the file is appended when we run the command with --append-outfile.
self.runCmd(
"memory read -f d -c 1 -o '{}' --append-outfile `&argc`".format(
memory_read_file))
check_file_content([golden_output, golden_output])