mirror of
https://github.com/NationalSecurityAgency/ghidra.git
synced 2026-09-25 17:00:36 -09:00
GP-7090 PR and additional test case for split AdressTable from
references and address table sizes
This commit is contained in:
@@ -23,34 +23,40 @@ import org.junit.*;
|
||||
import generic.test.AbstractGenericTest;
|
||||
import ghidra.app.cmd.data.CreateDataCmd;
|
||||
import ghidra.app.util.importer.MessageLog;
|
||||
import ghidra.framework.options.Options;
|
||||
import ghidra.program.database.ProgramBuilder;
|
||||
import ghidra.program.database.ProgramDB;
|
||||
import ghidra.program.model.address.Address;
|
||||
import ghidra.program.model.address.AddressSet;
|
||||
import ghidra.program.model.data.ArrayDataType;
|
||||
import ghidra.program.model.data.Undefined1DataType;
|
||||
import ghidra.program.model.listing.Bookmark;
|
||||
import ghidra.program.model.listing.BookmarkType;
|
||||
import ghidra.program.model.listing.Data;
|
||||
import ghidra.program.model.listing.Listing;
|
||||
import ghidra.program.model.data.*;
|
||||
import ghidra.program.model.listing.*;
|
||||
import ghidra.util.exception.CancelledException;
|
||||
import ghidra.util.task.TaskMonitor;
|
||||
|
||||
public class AddressTableAnalyzerTest extends AbstractGenericTest {
|
||||
|
||||
private static final String BaseUndefinedAddrStr = "0x101100";
|
||||
private ProgramDB program;
|
||||
private ProgramBuilder builder;
|
||||
private int pointerSize;
|
||||
private String[] targets;
|
||||
private Address[] tableAddrs;
|
||||
private AddressTableAnalyzer tableAnalyzer = new AddressTableAnalyzer();
|
||||
|
||||
@Before
|
||||
public void setUp() throws Exception {
|
||||
targets = new String[] { "0x101000", "0x101100", "0x101200", "0x101300" };
|
||||
targets = new String[] { "0x101000", "0x101100", "0x101200", "0x101300", "0x0", "0x101400", "0x101500", "0x0", "0x101600" };
|
||||
|
||||
builder = new ProgramBuilder("AddressTableAnalyzerTest", ProgramBuilder._X64);
|
||||
builder.createMemory(".text", "0x100000", 0x1000);
|
||||
builder.createMemory(".data", "0x101000", 0x1000);
|
||||
program = builder.getProgram();
|
||||
pointerSize = program.getDefaultPointerSize();
|
||||
|
||||
tableAddrs = new Address[targets.length];
|
||||
for (int i = 0; i < tableAddrs.length; i++) {
|
||||
tableAddrs[i] = builder.addr(BaseUndefinedAddrStr).add(i*pointerSize);
|
||||
}
|
||||
}
|
||||
|
||||
@After
|
||||
@@ -59,33 +65,172 @@ public class AddressTableAnalyzerTest extends AbstractGenericTest {
|
||||
}
|
||||
|
||||
@Test
|
||||
public void testAnalyzerCreatesTableOverUndefinedData() throws Exception {
|
||||
assertAnalyzerCreatesTableOver(undefinedDataType());
|
||||
public void testAnalyzerCreatesTableOverDefaultData() throws Exception {
|
||||
setMinTableSize(1);
|
||||
setupAndAnalyzeTables(Undefined.getUndefinedDataType(1));
|
||||
assertBookmarkAt(BaseUndefinedAddrStr);
|
||||
assertAnalyzerCreatesTableAt(BaseUndefinedAddrStr,4,true);
|
||||
assertBookmarkAt("0x101128");
|
||||
assertAnalyzerCreatesTableAt("0x101128",2,true);
|
||||
assertBookmarkAt("0x101140");
|
||||
assertAnalyzerCreatesTableAt("0x101140",1,false);
|
||||
}
|
||||
|
||||
@Test
|
||||
public void testAnalyzerCreatesTableOverUndefined1Data() throws Exception {
|
||||
setMinTableSize(1);
|
||||
setupAndAnalyzeTables(Undefined.getUndefinedDataType(1));
|
||||
assertBookmarkAt(BaseUndefinedAddrStr);
|
||||
assertAnalyzerCreatesTableAt(BaseUndefinedAddrStr,4,true);
|
||||
assertBookmarkAt("0x101128");
|
||||
assertAnalyzerCreatesTableAt("0x101128",2,true);
|
||||
assertBookmarkAt("0x101140");
|
||||
assertAnalyzerCreatesTableAt("0x101140",1,false);
|
||||
}
|
||||
|
||||
@Test
|
||||
public void testAnalyzerCreatesTableOverUndefined4Data() throws Exception {
|
||||
setMinTableSize(1);
|
||||
setupAndAnalyzeTables(Undefined.getUndefinedDataType(4));
|
||||
assertBookmarkAt(BaseUndefinedAddrStr);
|
||||
assertAnalyzerCreatesTableAt(BaseUndefinedAddrStr,4,true);
|
||||
assertBookmarkAt("0x101128");
|
||||
assertAnalyzerCreatesTableAt("0x101128",2,true);
|
||||
assertBookmarkAt("0x101140");
|
||||
assertAnalyzerCreatesTableAt("0x101140",1,false);
|
||||
}
|
||||
|
||||
|
||||
@Test
|
||||
public void testAnalyzerCreatesTableOverUndefinedArray() throws Exception {
|
||||
assertAnalyzerCreatesTableOver(undefinedArrayDataType(targets.length * pointerSize));
|
||||
public void testAnalyzerCreatesTableOverUndefinedPointerArray() throws Exception {
|
||||
setMinTableSize(1);
|
||||
setupAndAnalyzeTables(Undefined.getUndefinedDataType(pointerSize));
|
||||
assertBookmarkAt(BaseUndefinedAddrStr);
|
||||
assertAnalyzerCreatesTableAt(BaseUndefinedAddrStr,4,true);
|
||||
assertBookmarkAt("0x101128");
|
||||
assertAnalyzerCreatesTableAt("0x101128",2,true);
|
||||
assertBookmarkAt("0x101140");
|
||||
assertAnalyzerCreatesTableAt("0x101140",1,false);
|
||||
}
|
||||
|
||||
@Test
|
||||
public void testAnalyzerCreatesTableMinSize2() throws Exception {
|
||||
setMinTableSize(2);
|
||||
setupAndAnalyzeTables(Undefined.getUndefinedDataType(1));
|
||||
assertBookmarkAt(BaseUndefinedAddrStr);
|
||||
assertAnalyzerCreatesTableAt(BaseUndefinedAddrStr,4,true);
|
||||
assertNoBookmarkAt("0x101120");
|
||||
assertNoDataAt("0x101120");
|
||||
assertBookmarkAt("0x101128");
|
||||
assertAnalyzerCreatesTableAt("0x101128",2,true);
|
||||
assertNoBookmarkAt("0x101140");
|
||||
assertNoDataAt("0x101140");
|
||||
}
|
||||
|
||||
@Test
|
||||
public void testAnalyzerCreatesTableWithReference() throws Exception {
|
||||
String InternalTableRefAddrStr = "0x101108";
|
||||
// reference should split tables
|
||||
builder.createMemoryReadReference("0x100000", InternalTableRefAddrStr);
|
||||
setupAndAnalyzeTables(Undefined.getUndefinedDataType(1));
|
||||
assertBookmarkAt(BaseUndefinedAddrStr);
|
||||
assertAnalyzerCreatesTableAt(BaseUndefinedAddrStr,1,false);
|
||||
assertAnalyzerCreatesTableAt(InternalTableRefAddrStr,3,true);
|
||||
assertBookmarkAt(InternalTableRefAddrStr);
|
||||
}
|
||||
|
||||
@Test
|
||||
public void testAnalyzerCreatesTableWithReferenceMinSize2() throws Exception {
|
||||
String InternalTableRefAddrStr = "0x101108";
|
||||
// reference should split tables
|
||||
builder.createMemoryReadReference("0x100000", InternalTableRefAddrStr);
|
||||
setMinTableSize(2);
|
||||
setupAndAnalyzeTables(null);
|
||||
assertNoBookmarkAt(BaseUndefinedAddrStr);
|
||||
assertNoDataAt(BaseUndefinedAddrStr);
|
||||
assertAnalyzerCreatesTableAt(InternalTableRefAddrStr,3,true);
|
||||
assertBookmarkAt(InternalTableRefAddrStr);
|
||||
}
|
||||
|
||||
private void assertAnalyzerCreatesTableOver(ArrayDataType dataType) throws Exception {
|
||||
Address tableStart = builder.addr("0x101100");
|
||||
|
||||
@Test
|
||||
public void testAnalyzerCreatesTableOverUndefinedArrayDataMinSize() throws Exception {
|
||||
setMinTableSize(2);
|
||||
setupAndAnalyzeTables(Undefined.getUndefinedDataType(pointerSize));
|
||||
assertAnalyzerCreatesTableAt(BaseUndefinedAddrStr,4,true);
|
||||
assertNoBookmarkAt("0x101120");
|
||||
assertNoDataAt("0x101120");
|
||||
assertBookmarkAt("0x101128");
|
||||
assertAnalyzerCreatesTableAt("0x101128",2,true);
|
||||
assertNoBookmarkAt("0x101140");
|
||||
assertNoDataAt("0x101140");
|
||||
}
|
||||
|
||||
|
||||
@Test
|
||||
public void testAnalyzerCreatesTableWithReferenceOverUndefinedArrayData() throws Exception {
|
||||
String InternalTableRefAddrStr = "0x101108";
|
||||
// reference should split tables
|
||||
builder.createMemoryReadReference("0x100000", InternalTableRefAddrStr);
|
||||
setMinTableSize(1);
|
||||
setupAndAnalyzeTables(Undefined.getUndefinedDataType(pointerSize));
|
||||
assertBookmarkAt(BaseUndefinedAddrStr);
|
||||
assertAnalyzerCreatesTableAt(BaseUndefinedAddrStr,1,false);
|
||||
assertAnalyzerCreatesTableAt(InternalTableRefAddrStr,3,true);
|
||||
assertBookmarkAt(InternalTableRefAddrStr);
|
||||
}
|
||||
|
||||
private void setupAndAnalyzeTables(DataType elemDataType) throws Exception {
|
||||
Address tableStart = builder.addr(BaseUndefinedAddrStr);
|
||||
|
||||
layOutAddressTable(tableStart);
|
||||
defineUndefinedArray(tableStart, dataType.getLength());
|
||||
if (elemDataType != null) {
|
||||
defineUndefinedArray(tableStart, elemDataType, (targets.length*pointerSize) / elemDataType.getLength());
|
||||
}
|
||||
|
||||
runAnalyzer(tableStart);
|
||||
runAnalyzer(tableStart,tableStart.add(targets.length*pointerSize));
|
||||
}
|
||||
|
||||
private void assertAnalyzerCreatesTableAt(String tableStartStr, int size, boolean nothingFollows) throws Exception {
|
||||
Address tableStart = builder.addr(tableStartStr);
|
||||
|
||||
Listing listing = program.getListing();
|
||||
for (int i = 0; i < targets.length; i++) {
|
||||
for (int i = 0; i < size; i++) {
|
||||
Data slot = listing.getDefinedDataAt(tableStart.add(i * pointerSize));
|
||||
assertNotNull("missing pointer at table[" + i + "]", slot);
|
||||
assertTrue("table[" + i + "] should be a pointer", slot.isPointer());
|
||||
}
|
||||
if (nothingFollows) {
|
||||
Data slot = listing.getDefinedDataAt(tableStart.add(size * pointerSize));
|
||||
assertNull("Should not be a pointer defined", slot);
|
||||
}
|
||||
}
|
||||
|
||||
|
||||
private void assertNoDataAt(String addrStr) {
|
||||
Address addr = builder.addr(addrStr);
|
||||
|
||||
Data data = program.getListing().getDefinedDataAt(addr);
|
||||
if (data == null) {
|
||||
return;
|
||||
}
|
||||
assertTrue(Undefined.isUndefined(data.getDataType()));
|
||||
}
|
||||
|
||||
private void assertBookmarkAt(String tableStartStr) {
|
||||
Address tableStart = builder.addr(tableStartStr);
|
||||
|
||||
Bookmark bookmark = program.getBookmarkManager()
|
||||
.getBookmark(tableStart, BookmarkType.ANALYSIS, "Address Table");
|
||||
assertNotNull("bookmark should have been created", bookmark);
|
||||
assertNotNull("bookmark should have been created at " + tableStart, bookmark);
|
||||
}
|
||||
|
||||
private void assertNoBookmarkAt(String tableStartStr) {
|
||||
Address tableStart = builder.addr(tableStartStr);
|
||||
|
||||
Bookmark bookmark = program.getBookmarkManager()
|
||||
.getBookmark(tableStart, BookmarkType.ANALYSIS, "Address Table");
|
||||
assertNull("bookmark should NOT have been created at " + tableStart, bookmark);
|
||||
}
|
||||
|
||||
private void layOutAddressTable(Address tableStart) throws Exception {
|
||||
@@ -95,28 +240,34 @@ public class AddressTableAnalyzerTest extends AbstractGenericTest {
|
||||
}
|
||||
}
|
||||
|
||||
private ArrayDataType undefinedDataType() {
|
||||
return undefinedArrayDataType(pointerSize);
|
||||
}
|
||||
|
||||
private ArrayDataType undefinedArrayDataType(int byteLength) {
|
||||
return new ArrayDataType(new Undefined1DataType(), byteLength, 1);
|
||||
}
|
||||
|
||||
private void defineUndefinedArray(Address at, int byteLength) {
|
||||
private void defineUndefinedArray(Address at, DataType elementType, int numElements) {
|
||||
builder.withTransaction(() -> {
|
||||
new CreateDataCmd(at, undefinedArrayDataType(byteLength))
|
||||
new CreateDataCmd(at, new ArrayDataType(elementType,numElements))
|
||||
.applyTo(program);
|
||||
});
|
||||
}
|
||||
|
||||
private void setMinTableSize(int size) {
|
||||
builder.tx(() -> {
|
||||
int txId = program.startTransaction("Analyze");
|
||||
Options analysisOptions = program.getOptions(Program.ANALYSIS_PROPERTIES);
|
||||
|
||||
analysisOptions.setInt("Create Address Tables.Minimum Table Size", size);
|
||||
|
||||
tableAnalyzer.optionsChanged(analysisOptions.getOptions("Create Address Tables"), program);
|
||||
|
||||
program.endTransaction(txId, true);
|
||||
});
|
||||
}
|
||||
|
||||
private void runAnalyzer(Address inSet) throws CancelledException {
|
||||
int tx = program.startTransaction("analyze");
|
||||
try {
|
||||
new AddressTableAnalyzer().added(program, new AddressSet(inSet, inSet),
|
||||
private void runAnalyzer(Address start, Address end) {
|
||||
builder.tx(() -> {
|
||||
tableAnalyzer.added(program, new AddressSet(start, end),
|
||||
TaskMonitor.DUMMY, new MessageLog());
|
||||
} finally {
|
||||
program.endTransaction(tx, true);
|
||||
}
|
||||
// need to let full analysis run, as each table found schedules
|
||||
// follow on create table analysis so that effects of found table can be processed,
|
||||
// then new tables found
|
||||
builder.analyze();
|
||||
});
|
||||
}
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user