AssemblyResolvedBackfill

java.lang.Object
- ghidra.app.plugin.assembler.sleigh.sem.AssemblyResolution
- - ghidra.app.plugin.assembler.sleigh.sem.AssemblyResolvedBackfill

All Implemented Interfaces:

java.lang.Comparable<AssemblyResolution>
```
public class AssemblyResolvedBackfill
extends AssemblyResolution
```
A AssemblyResolution indicating the need to solve an expression in the future Such records are collected within a AssemblyResolvedConstructor and then solved just before the final result(s) are assembled. This is typically required by instructions that refer to the inst_next symbol.

Field Summary

Fields
Change	Modifier and Type	Field	Description
NEW	`protected PatternExpression`	`exp`
NEW	`protected MaskedLong`	`goal`
NEW	`protected int`	`inslen`
NEW	`protected int`	`offset`
NEW	`protected java.util.Map<java.lang.Integer,java.lang.Object>`	`res`

Fields inherited from class ghidra.app.plugin.assembler.sleigh.sem.AssemblyResolution
children, description

Method Summary

All Methods Instance Methods Concrete Methods
Change	Modifier and Type	Method	Description
NEW	`protected int`	`computeHash()`
	`int`	`getInstructionLength()`	Get the expected length of the instruction portion of the future encoding This is used to make sure that operands following a to-be-determined encoding are placed properly.
	`boolean`	`isBackfill()`	Check if this record describes a backfill
	`boolean`	`isError()`	Check if this record describes an error
NEW	`protected java.lang.String`	`lineToString()`	Display the resolution result in one line (omitting child details)
	`AssemblyResolvedBackfill`	`shift(int amt)`	Shift the back-fill record's "instruction" pattern to the right.
	`AssemblyResolution`	`solve(RecursiveDescentSolver solver, java.util.Map<java.lang.String,java.lang.Long> vals, AssemblyResolvedConstructor cur)`	Attempt (again) to solve the expression that generated this backfill record This will attempt to solve the same expression and goal again, using the same parameters as were given to the original attempt, except with additional defined symbols.

Methods inherited from class ghidra.app.plugin.assembler.sleigh.sem.AssemblyResolution
backfill, childrenToString, compareTo, contextOnly, error, error, fromPattern, hasChildren, hashCode, instrOnly, nop, resolved, toString, toString

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

exp NEW
```
protected final PatternExpression exp
```

goal NEW
```
protected final MaskedLong goal
```

res NEW

protected final java.util.Map<java.lang.Integer,java.lang.Object> res

inslen NEW
```
protected final int inslen
```

offset NEW
```
protected final int offset
```

Method Detail

computeHash NEW
```
protected int computeHash()
```
Specified by:

computeHash in class AssemblyResolution

getInstructionLength
```
public int getInstructionLength()
```
Get the expected length of the instruction portion of the future encoding This is used to make sure that operands following a to-be-determined encoding are placed properly. Even though the actual encoding cannot yet be determined, its length can.

Returns:

the total expected length (including the offset)

isError
```
public boolean isError()
```
Description copied from class: AssemblyResolution

Check if this record describes an error

Specified by:

isError in class AssemblyResolution

Returns:

true if the record is an error

isBackfill
```
public boolean isBackfill()
```
Description copied from class: AssemblyResolution

Check if this record describes a backfill

Specified by:

isBackfill in class AssemblyResolution

Returns:

true if the record is a backfill

lineToString NEW
```
protected java.lang.String lineToString()
```
Description copied from class: AssemblyResolution

Display the resolution result in one line (omitting child details)

Specified by:

lineToString in class AssemblyResolution

Returns:

the display description

shift
```
public AssemblyResolvedBackfill shift(int amt)
```
Shift the back-fill record's "instruction" pattern to the right.

Parameters:

amt - the number of bytes to shift the result when solved.

Returns:

the result

solve
```
public AssemblyResolution solve(RecursiveDescentSolver solver,
                                java.util.Map<java.lang.String,java.lang.Long> vals,
                                AssemblyResolvedConstructor cur)
```
Attempt (again) to solve the expression that generated this backfill record This will attempt to solve the same expression and goal again, using the same parameters as were given to the original attempt, except with additional defined symbols. Typically, the symbol that required backfill is inst_next. This method will not throw NeedsBackfillException, since that would imply the missing symbol(s) from the original attempt are still missing. Instead, the method returns an instance of AssemblyResolvedError.

Parameters:

solver - a solver, usually the same as the one from the original attempt.

vals - the defined symbols, usually the same, but with the missing symbol(s).

Returns:

the solution result