Package ghidra.program.database.symbol

Class VariableSymbolDB

java.lang.Object

ghidra.program.database.DatabaseObject

ghidra.program.database.symbol.SymbolDB

ghidra.program.database.symbol.VariableSymbolDB

All Implemented Interfaces:

Symbol

Direct Known Subclasses:

GlobalVariableSymbolDB

public class VariableSymbolDB
extends SymbolDB

Symbol class for function variables. Symbol Data Usage: long data1 - data type ID int data2 - first-use-offset / ordinal String data3 - variable comment

Field Summary

Fields inherited from class ghidra.program.database.symbol.SymbolDB

address, lock, symbolMgr

Fields inherited from class ghidra.program.database.DatabaseObject

key

Constructor Summary

Constructors

Constructor	Description
VariableSymbolDB(SymbolManager symbolMgr, DBObjectCache<SymbolDB> cache, SymbolType type, VariableStorageManagerDB variableMgr, Address address, Record record)	Constructs a new VariableSymbol

Method Summary

Modifier and Type	Method	Description
boolean	delete()	Delete the symbol and its associated resources.
boolean	equals(java.lang.Object obj)
DataType	getDataType()
int	getFirstUseOffset()
FunctionDB	getFunction()
java.lang.String	getName()
java.lang.Object	getObject()
int	getOrdinal()
ProgramLocation	getProgramLocation()
int	getReferenceCount()
Reference[]	getReferences(TaskMonitor monitor)	Returns all memory references to the address of this symbol.
SymbolType	getSymbolType()	Returns the symbol type
VariableStorage	getVariableStorage()
boolean	hasMultipleReferences()
boolean	hasReferences()
boolean	isExternal()	Returns true if this an external symbol.
boolean	isPrimary()
boolean	isValidParent(Namespace parent)	Returns whether the given parent is valid for this Symbol.
void	setFirstUseOffset(int firstUseOffset)
void	setInvalid()	Invalidate this object.
void	setOrdinal(int ordinal)
void	setStorageAndDataType(VariableStorage newStorage, DataType dt)	Change the storage address and data-type associated with this variable symbol.
protected SourceType	validateNameSource(java.lang.String newName, SourceType source)	Allow symbol implementations to validate the source when setting the name of this symbol.

Methods inherited from class ghidra.program.database.symbol.SymbolDB

doIsPinned, doSetPinned, getAddress, getID, getName, getParentNamespace, getParentSymbol, getPath, getProgram, getReferences, getSource, getSymbolData1, getSymbolData2, getSymbolData3, getSymbolsDynamicallyRenamedByMyRename, hashCode, isDeleting, isDescendant, isDynamic, isExternalEntryPoint, isGlobal, isPinned, move, refresh, refresh, removeAllReferencesTo, setAddress, setName, setNameAndNamespace, setNamespace, setPinned, setPrimary, setSource, setSymbolData1, setSymbolData2, setSymbolData3, toString

Methods inherited from class ghidra.program.database.DatabaseObject

checkDeleted, checkIsValid, checkIsValid, getKey, isDeleted, isInvalid, keyChanged, validate

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface ghidra.program.model.symbol.Symbol

checkIsValid

Constructor Detail

VariableSymbolDB

public VariableSymbolDB(SymbolManager symbolMgr,
                        DBObjectCache<SymbolDB> cache,
                        SymbolType type,
                        VariableStorageManagerDB variableMgr,
                        Address address,
                        Record record)

Constructs a new VariableSymbol

Parameters:

symbolMgr - the symbol manager

cache - symbol object cache

type - the symbol type.

address - the address of the symbol (stack address)

record - the record for the symbol

Method Detail

setInvalid

public void setInvalid()

Description copied from class: DatabaseObject

Invalidate this object. This does not necessarily mean that this object can never be used again. If the object can refresh itself, it may still be useable.

Overrides:

setInvalid in class DatabaseObject

getVariableStorage

public VariableStorage getVariableStorage()

getSymbolType

public SymbolType getSymbolType()

Description copied from interface: Symbol

Returns the symbol type

See Also:

Symbol.getSymbolType()

equals

public boolean equals(java.lang.Object obj)

Overrides:

equals in class SymbolDB

See Also:

SymbolDB.equals(java.lang.Object)

delete

public boolean delete()

Description copied from interface: Symbol

Delete the symbol and its associated resources.

Specified by:

delete in interface Symbol

Overrides:

delete in class SymbolDB

See Also:

Symbol.delete()

getObject

public java.lang.Object getObject()

See Also:

Symbol.getObject()

isPrimary

public boolean isPrimary()

Specified by:

isPrimary in interface Symbol

Specified by:

isPrimary in class SymbolDB

See Also:

Symbol.isPrimary()

isExternal

public boolean isExternal()

Description copied from interface: Symbol

Returns true if this an external symbol.

Returns:

true if this an external symbol.

See Also:

Address.isExternalAddress()

getFunction

public FunctionDB getFunction()

getProgramLocation

public ProgramLocation getProgramLocation()

See Also:

Symbol.getProgramLocation()

isValidParent

public boolean isValidParent(Namespace parent)

Description copied from interface: Symbol

Returns whether the given parent is valid for this Symbol.

Specified by:

isValidParent in interface Symbol

Specified by:

isValidParent in class SymbolDB

See Also:

Symbol.isValidParent(ghidra.program.model.symbol.Namespace)

getName

public java.lang.String getName()

Specified by:

getName in interface Symbol

Overrides:

getName in class SymbolDB

validateNameSource

protected SourceType validateNameSource(java.lang.String newName,
                                        SourceType source)

Description copied from class: SymbolDB

Allow symbol implementations to validate the source when setting the name of this symbol.

Overrides:

validateNameSource in class SymbolDB

getDataType

public DataType getDataType()

setStorageAndDataType

public void setStorageAndDataType(VariableStorage newStorage,
                                  DataType dt)

Change the storage address and data-type associated with this variable symbol.

Parameters:

newStorage -

dt - data-type

getFirstUseOffset

public int getFirstUseOffset()

setFirstUseOffset

public void setFirstUseOffset(int firstUseOffset)

getOrdinal

public int getOrdinal()

setOrdinal

public void setOrdinal(int ordinal)

getReferenceCount

public int getReferenceCount()

Specified by:

getReferenceCount in interface Symbol

Overrides:

getReferenceCount in class SymbolDB

getReferences

public Reference[] getReferences(TaskMonitor monitor)

Description copied from interface: Symbol

Returns all memory references to the address of this symbol. If you do not have a TaskMonitor instance, then you can pass TaskMonitorAdapter.DUMMY_MONITOR or null.

Specified by:

getReferences in interface Symbol

Overrides:

getReferences in class SymbolDB

Parameters:

monitor - the monitor that is used to report progress and to cancel this potentially long-running call

hasMultipleReferences

public boolean hasMultipleReferences()

Specified by:

hasMultipleReferences in interface Symbol

Overrides:

hasMultipleReferences in class SymbolDB

hasReferences

public boolean hasReferences()

Specified by:

hasReferences in interface Symbol

Overrides:

hasReferences in class SymbolDB