decompiler  1.0.0
Public Member Functions | Protected Member Functions | Protected Attributes | Private Member Functions | List of all members
ghidra::ScopeInternal Class Reference

An in-memory implementation of the Scope interface. More...

#include <database.hh>

Inheritance diagram for ghidra::ScopeInternal:
ghidra::Scope ghidra::ScopeGhidraNamespace ghidra::ScopeLocal

Public Member Functions

 ScopeInternal (uint8 id, const string &nm, Architecture *g)
 Construct the Scope. More...
 
 ScopeInternal (uint8 id, const string &nm, Architecture *g, Scope *own)
 Construct as a cache.
 
virtual void clear (void)
 Clear all symbols from this scope.
 
virtual void categorySanity (void)
 Make sure Symbol categories are sane. More...
 
virtual void clearCategory (int4 cat)
 Clear all symbols of the given category from this scope.
 
virtual void clearUnlocked (void)
 Clear all unlocked symbols from this scope.
 
virtual void clearUnlockedCategory (int4 cat)
 Clear unlocked symbols of the given category from this scope.
 
virtual void adjustCaches (void)
 Let scopes internally adjust any caches. More...
 
virtual MapIterator begin (void) const
 Beginning iterator to mapped SymbolEntrys.
 
virtual MapIterator end (void) const
 Ending iterator to mapped SymbolEntrys.
 
virtual list< SymbolEntry >::const_iterator beginDynamic (void) const
 Beginning iterator to dynamic SymbolEntrys.
 
virtual list< SymbolEntry >::const_iterator endDynamic (void) const
 Ending iterator to dynamic SymbolEntrys.
 
virtual list< SymbolEntry >::iterator beginDynamic (void)
 Beginning iterator to dynamic SymbolEntrys.
 
virtual list< SymbolEntry >::iterator endDynamic (void)
 Ending iterator to dynamic SymbolEntrys.
 
virtual void removeSymbolMappings (Symbol *symbol)
 Remove all SymbolEntrys from the given Symbol.
 
virtual void removeSymbol (Symbol *symbol)
 Remove the given Symbol from this Scope.
 
virtual void renameSymbol (Symbol *sym, const string &newname)
 Rename a Symbol within this Scope.
 
virtual void retypeSymbol (Symbol *sym, Datatype *ct)
 Change the data-type of a Symbol within this Scope. More...
 
virtual void setAttribute (Symbol *sym, uint4 attr)
 Set boolean Varnode properties on a Symbol.
 
virtual void clearAttribute (Symbol *sym, uint4 attr)
 Clear boolean Varnode properties on a Symbol.
 
virtual void setDisplayFormat (Symbol *sym, uint4 attr)
 Set the display format for a Symbol.
 
virtual SymbolEntryfindAddr (const Address &addr, const Address &usepoint) const
 Find a Symbol at a given address and usepoint. More...
 
virtual SymbolEntryfindContainer (const Address &addr, int4 size, const Address &usepoint) const
 Find the smallest Symbol containing the given memory range. More...
 
virtual SymbolEntryfindClosestFit (const Address &addr, int4 size, const Address &usepoint) const
 Find Symbol which is the closest fit to the given memory range. More...
 
virtual FuncdatafindFunction (const Address &addr) const
 Find the function starting at the given address. More...
 
virtual ExternRefSymbolfindExternalRef (const Address &addr) const
 Find an external reference at the given address. More...
 
virtual LabSymbolfindCodeLabel (const Address &addr) const
 Find a label Symbol at the given address. More...
 
virtual SymbolEntryfindOverlap (const Address &addr, int4 size) const
 Find first Symbol overlapping the given memory range. More...
 
virtual void findByName (const string &nm, vector< Symbol *> &res) const
 Find a Symbol by name within this Scope. More...
 
virtual bool isNameUsed (const string &nm, const Scope *op2) const
 Check if the given name is occurs within the given scope path. More...
 
virtual FuncdataresolveExternalRefFunction (ExternRefSymbol *sym) const
 Convert an external reference to the referenced function. More...
 
virtual string buildVariableName (const Address &addr, const Address &pc, Datatype *ct, int4 &index, uint4 flags) const
 Given an address and data-type, build a suitable generic symbol name. More...
 
virtual string buildUndefinedName (void) const
 Build a formal undefined name, used internally when a Symbol is not given a name. More...
 
virtual string makeNameUnique (const string &nm) const
 Produce a version of the given symbol name that won't collide with other names in this Scope. More...
 
virtual void encode (Encoder &encoder) const
 Encode this as a <scope> element.
 
virtual void decode (Decoder &decoder)
 Decode this Scope from a <scope> element.
 
virtual void printEntries (ostream &s) const
 Dump a description of all SymbolEntry objects to a stream.
 
virtual int4 getCategorySize (int4 cat) const
 Get the number of Symbols in the given category. More...
 
virtual SymbolgetCategorySymbol (int4 cat, int4 ind) const
 Retrieve a Symbol by index within a specific category. More...
 
virtual void setCategory (Symbol *sym, int4 cat, int4 ind)
 Set the category and index for the given Symbol. More...
 
void assignDefaultNames (int4 &base)
 Assign a default name (via buildVariableName) to any unnamed symbol. More...
 
set< Symbol * >::const_iterator beginMultiEntry (void) const
 Start of symbols with more than one entry.
 
set< Symbol * >::const_iterator endMultiEntry (void) const
 End of symbols with more than one entry.
 
- Public Member Functions inherited from ghidra::Scope
 Scope (uint8 id, const string &nm, Architecture *g, Scope *own)
 Construct an empty scope, given a name and Architecture.
 
virtual ~Scope (void)
 Destructor.
 
virtual bool inScope (const Address &addr, int4 size, const Address &usepoint) const
 Query if the given range is owned by this Scope. More...
 
virtual void decodeWrappingAttributes (Decoder &decoder)
 Restore attributes for this Scope from wrapping element.
 
virtual SymbolEntryaddSymbol (const string &nm, Datatype *ct, const Address &addr, const Address &usepoint)
 Add a new Symbol to this Scope, given a name, data-type, and a single mapping. More...
 
const string & getName (void) const
 Get the name of the Scope.
 
const string & getDisplayName (void) const
 Get name displayed in output.
 
uint8 getId (void) const
 Get the globally unique id.
 
bool isGlobal (void) const
 Return true if this scope is global.
 
void queryByName (const string &nm, vector< Symbol *> &res) const
 Look-up symbols by name. More...
 
FuncdataqueryFunction (const string &nm) const
 Look-up a function by name. More...
 
SymbolEntryqueryByAddr (const Address &addr, const Address &usepoint) const
 Get Symbol with matching address. More...
 
SymbolEntryqueryContainer (const Address &addr, int4 size, const Address &usepoint) const
 Find the smallest containing Symbol. More...
 
SymbolEntryqueryProperties (const Address &addr, int4 size, const Address &usepoint, uint4 &flags) const
 Find a Symbol or properties at the given address. More...
 
FuncdataqueryFunction (const Address &addr) const
 Look-up a function by address. More...
 
FuncdataqueryExternalRefFunction (const Address &addr) const
 Look-up a function thru an external reference. More...
 
LabSymbolqueryCodeLabel (const Address &addr) const
 Look-up a code label by address. More...
 
ScoperesolveScope (const string &nm, bool strategy) const
 Find a child Scope of this. More...
 
ScopediscoverScope (const Address &addr, int4 sz, const Address &usepoint)
 Find the owning Scope of a given memory range. More...
 
ScopeMap::const_iterator childrenBegin () const
 Beginning iterator of child scopes.
 
ScopeMap::const_iterator childrenEnd () const
 Ending iterator of child scopes.
 
void encodeRecursive (Encoder &encoder, bool onlyGlobal) const
 Encode all contained scopes to a stream. More...
 
void overrideSizeLockType (Symbol *sym, Datatype *ct)
 Change the data-type of a Symbol that is sizelocked. More...
 
void resetSizeLockType (Symbol *sym)
 Clear a Symbol's size-locked data-type. More...
 
void setThisPointer (Symbol *sym, bool val)
 Toggle the given Symbol as the "this" pointer.
 
bool isSubScope (const Scope *scp) const
 Is this a sub-scope of the given Scope. More...
 
string getFullName (void) const
 Get the full name of this Scope.
 
void getScopePath (vector< const Scope *> &vec) const
 Get the ordered list of scopes up to this. More...
 
const ScopefindDistinguishingScope (const Scope *op2) const
 Find first ancestor of this not shared by given scope. More...
 
ArchitecturegetArch (void) const
 Get the Architecture associated with this.
 
ScopegetParent (void) const
 Get the parent Scope (or NULL if this is the global Scope)
 
SymboladdSymbol (const string &nm, Datatype *ct)
 Add a new Symbol without mapping it to an address. More...
 
SymbolEntryaddMapPoint (Symbol *sym, const Address &addr, const Address &usepoint)
 Map a Symbol to a specific address. More...
 
SymboladdMapSym (Decoder &decoder)
 Parse a mapped Symbol from a <mapsym> element. More...
 
FunctionSymboladdFunction (const Address &addr, const string &nm)
 Create a function Symbol at the given address in this Scope. More...
 
ExternRefSymboladdExternalRef (const Address &addr, const Address &refaddr, const string &nm)
 
LabSymboladdCodeLabel (const Address &addr, const string &nm)
 Create a code label at the given address in this Scope. More...
 
SymboladdDynamicSymbol (const string &nm, Datatype *ct, const Address &caddr, uint8 hash)
 Create a dynamically mapped Symbol attached to a specific data-flow. More...
 
SymboladdEquateSymbol (const string &nm, uint4 format, uintb value, const Address &addr, uint8 hash)
 Create a symbol that forces display conversion on a constant. More...
 
SymboladdUnionFacetSymbol (const string &nm, Datatype *dt, int4 fieldNum, const Address &addr, uint8 hash)
 Create a symbol forcing a field interpretation for a specific access to a variable with union data-type. More...
 
string buildDefaultName (Symbol *sym, int4 &base, Varnode *vn) const
 Create a default name for the given Symbol. More...
 
bool isReadOnly (const Address &addr, int4 size, const Address &usepoint) const
 Is the given memory range marked as read-only. More...
 
void printBounds (ostream &s) const
 Print a description of this Scope's owned memory ranges.
 

Protected Member Functions

virtual ScopebuildSubScope (uint8 id, const string &nm)
 Build an unattached Scope to be associated as a sub-scope of this.
 
virtual void addSymbolInternal (Symbol *sym)
 Put a Symbol into the name map. More...
 
virtual SymbolEntryaddMapInternal (Symbol *sym, uint4 exfl, const Address &addr, int4 off, int4 sz, const RangeList &uselim)
 Create a new SymbolEntry for a Symbol given a memory range. More...
 
virtual SymbolEntryaddDynamicMapInternal (Symbol *sym, uint4 exfl, uint8 hash, int4 off, int4 sz, const RangeList &uselim)
 Create a new SymbolEntry for a Symbol given a dynamic hash. More...
 
- Protected Member Functions inherited from ghidra::Scope
const RangeListgetRangeTree (void) const
 Access the address ranges owned by this Scope.
 
virtual void restrictScope (Funcdata *f)
 Convert this to a local Scope. More...
 
virtual void addRange (AddrSpace *spc, uintb first, uintb last)
 Add a memory range to the ownership of this Scope. More...
 
virtual void removeRange (AddrSpace *spc, uintb first, uintb last)
 Remove a memory range from the ownership of this Scope. More...
 
SymbolEntryaddMap (SymbolEntry &entry)
 Integrate a SymbolEntry into the range maps. More...
 
void setSymbolId (Symbol *sym, uint8 id) const
 Adjust the id associated with a symbol.
 
void setDisplayName (const string &nm)
 Change name displayed in output.
 

Protected Attributes

SymbolNameTree nametree
 The set of Symbol objects, sorted by name.
 
vector< EntryMap * > maptable
 Rangemaps of SymbolEntry, one map for each address space.
 
vector< vector< Symbol * > > category
 References to Symbol objects organized by category.
 
list< SymbolEntrydynamicentry
 Dynamic symbol entries.
 
SymbolNameTree multiEntrySet
 Set of symbols with multiple entries.
 
uint8 nextUniqueId
 Next available symbol id.
 
- Protected Attributes inherited from ghidra::Scope
Architectureglb
 Architecture of this scope.
 
string name
 Name of this scope.
 
string displayName
 Name to display in output.
 
Funcdatafd
 (If non-null) the function which this is the local Scope for
 
uint8 uniqueId
 Unique id for the scope, for deduping scope names, assigning symbol ids.
 

Private Member Functions

void decodeHole (Decoder &decoder)
 Parse a <hole> element describing boolean properties of a memory range. More...
 
void decodeCollision (Decoder &decoder)
 Parse a <collision> element indicating a named symbol with no storage or data-type info. More...
 
void insertNameTree (Symbol *sym)
 Insert a Symbol into the nametree. More...
 
SymbolNameTree::const_iterator findFirstByName (const string &nm) const
 Find an iterator pointing to the first Symbol in the ordering with a given name. More...
 

Additional Inherited Members

- Static Protected Member Functions inherited from ghidra::Scope
static const ScopestackAddr (const Scope *scope1, const Scope *scope2, const Address &addr, const Address &usepoint, SymbolEntry **addrmatch)
 Query for Symbols starting at a given address, which match a given usepoint. More...
 
static const ScopestackContainer (const Scope *scope1, const Scope *scope2, const Address &addr, int4 size, const Address &usepoint, SymbolEntry **addrmatch)
 
static const ScopestackClosestFit (const Scope *scope1, const Scope *scope2, const Address &addr, int4 size, const Address &usepoint, SymbolEntry **addrmatch)
 
static const ScopestackFunction (const Scope *scope1, const Scope *scope2, const Address &addr, Funcdata **addrmatch)
 
static const ScopestackExternalRef (const Scope *scope1, const Scope *scope2, const Address &addr, ExternRefSymbol **addrmatch)
 
static const ScopestackCodeLabel (const Scope *scope1, const Scope *scope2, const Address &addr, LabSymbol **addrmatch)
 

Detailed Description

An in-memory implementation of the Scope interface.

This can act as a stand-alone Scope object or serve as an in-memory cache for another implementation. This implements a nametree, which is a a set of Symbol objects (the set owns the Symbol objects). It also implements a maptable, which is a list of rangemaps that own the SymbolEntry objects.

Constructor & Destructor Documentation

◆ ScopeInternal()

ghidra::ScopeInternal::ScopeInternal ( uint8  id,
const string &  nm,
Architecture g 
)

Construct the Scope.

Parameters
idis the globally unique id associated with the scope
nmis the name of the Scope
gis the Architecture it belongs to

References maptable, nextUniqueId, and ghidra::AddrSpaceManager::numSpaces().

Member Function Documentation

◆ addDynamicMapInternal()

SymbolEntry * ghidra::ScopeInternal::addDynamicMapInternal ( Symbol sym,
uint4  exfl,
uint8  hash,
int4  off,
int4  sz,
const RangeList uselim 
)
protectedvirtual

Create a new SymbolEntry for a Symbol given a dynamic hash.

The SymbolEntry is specified in terms of a hash and usepoint, which describe how to find the temporary Varnode holding the symbol value.

Parameters
symis the given Symbol being mapped
exflare any boolean Varnode properties
hashis the given dynamic hash
offis the byte offset of the new SymbolEntry (relative to the whole Symbol)
szis the number of bytes occupied by the Varnode
uselimis the given usepoint
Returns
the newly created SymbolEntry

Implements ghidra::Scope.

References ghidra::Datatype::getSize(), ghidra::Symbol::mapentry, ghidra::Symbol::type, and ghidra::Symbol::wholeCount.

◆ addMapInternal()

SymbolEntry * ghidra::ScopeInternal::addMapInternal ( Symbol sym,
uint4  exfl,
const Address addr,
int4  off,
int4  sz,
const RangeList uselim 
)
protectedvirtual

Create a new SymbolEntry for a Symbol given a memory range.

The SymbolEntry is specified in terms of a memory range and usepoint

Parameters
symis the given Symbol being mapped
exflare any boolean Varnode properties specific to the memory range
addris the starting address of the given memory range
offis the byte offset of the new SymbolEntry (relative to the whole Symbol)
szis the number of bytes in the range
uselimis the given usepoint (which may be invalid)
Returns
the newly created SymbolEntry

Implements ghidra::Scope.

Reimplemented in ghidra::ScopeGhidraNamespace.

References ghidra::AddrSpace::getIndex(), ghidra::Symbol::getName(), ghidra::Address::getOffset(), ghidra::Datatype::getSize(), ghidra::Address::getSpace(), ghidra::rangemap< _recordtype >::insert(), ghidra::Symbol::mapentry, ghidra::Symbol::type, and ghidra::Symbol::wholeCount.

Referenced by ghidra::ScopeGhidraNamespace::addMapInternal().

◆ addSymbolInternal()

void ghidra::ScopeInternal::addSymbolInternal ( Symbol sym)
protectedvirtual

◆ adjustCaches()

void ghidra::ScopeInternal::adjustCaches ( void  )
virtual

Let scopes internally adjust any caches.

This is called once after Architecture configuration is complete.

Implements ghidra::Scope.

References ghidra::Scope::glb, maptable, and ghidra::AddrSpaceManager::numSpaces().

Referenced by ghidra::ScopeGhidra::adjustCaches().

◆ assignDefaultNames()

void ghidra::ScopeInternal::assignDefaultNames ( int4 &  base)

Assign a default name (via buildVariableName) to any unnamed symbol.

Run through all the symbols whose name is undefined. Build a variable name, uniquify it, and rename the variable.

Parameters
baseis the base index to start at for generating generic names

References ghidra::Scope::buildDefaultName(), ghidra::Symbol::isNameUndefined(), nametree, and renameSymbol().

Referenced by ghidra::ActionNameVars::apply().

◆ buildUndefinedName()

string ghidra::ScopeInternal::buildUndefinedName ( void  ) const
virtual

Build a formal undefined name, used internally when a Symbol is not given a name.

Returns
a special internal name that won't collide with other names in this Scope

Implements ghidra::Scope.

References nametree.

Referenced by ghidra::ScopeGhidra::buildUndefinedName(), clearUnlocked(), and clearUnlockedCategory().

◆ buildVariableName()

string ghidra::ScopeInternal::buildVariableName ( const Address addr,
const Address pc,
Datatype ct,
int4 &  index,
uint4  flags 
) const
virtual

Given an address and data-type, build a suitable generic symbol name.

Parameters
addris the given address
pcis the address at which the name is getting used
ctis a data-type used to inform the name
indexis a reference to an index used to make the name unique, which will be updated
flagsare boolean properties of the variable we need the name for
Returns
the new variable name

Implements ghidra::Scope.

Reimplemented in ghidra::ScopeLocal.

References ghidra::Varnode::addrtied, ghidra::AddrSpace::byteToAddress(), findFirstByName(), ghidra::Address::getAddrSize(), ghidra::AddrSpace::getName(), ghidra::Address::getOffset(), ghidra::Translate::getRegisterName(), ghidra::Datatype::getSize(), ghidra::Address::getSpace(), ghidra::AddrSpace::getWordSize(), ghidra::Scope::glb, ghidra::Varnode::indirect_creation, ghidra::Varnode::input, makeNameUnique(), nametree, ghidra::Varnode::persist, ghidra::Datatype::printNameBase(), ghidra::Varnode::return_address, ghidra::Architecture::translate, and ghidra::Varnode::unaffected.

Referenced by ghidra::ScopeGhidra::buildVariableName(), and ghidra::ScopeLocal::buildVariableName().

◆ categorySanity()

void ghidra::ScopeInternal::categorySanity ( void  )
virtual

Make sure Symbol categories are sane.

Look for NULL entries in the category tables. If there are, clear out the entire category, marking all symbols as uncategorized

References category, ghidra::Symbol::no_category, and setCategory().

Referenced by decode().

◆ decodeCollision()

void ghidra::ScopeInternal::decodeCollision ( Decoder decoder)
private

Parse a <collision> element indicating a named symbol with no storage or data-type info.

Let the decompiler know that a name is occupied within the scope for isNameUsed queries, without specifying storage and data-type information about the symbol. This is modeled currently by creating an unmapped symbol.

Parameters
decoderis the stream decoder

References ghidra::Scope::addSymbol(), ghidra::Decoder::closeElement(), findFirstByName(), ghidra::TypeFactory::getBase(), ghidra::Scope::glb, nametree, ghidra::Decoder::openElement(), ghidra::Decoder::readString(), ghidra::TYPE_INT, and ghidra::Architecture::types.

Referenced by decode().

◆ decodeHole()

void ghidra::ScopeInternal::decodeHole ( Decoder decoder)
private

Parse a <hole> element describing boolean properties of a memory range.

The <scope> element is allowed to contain <hole> elements, which are really descriptions of memory globally. This method parses them and passes the info to the Database object.

Parameters
decoderis the stream decoder

References ghidra::Decoder::closeElement(), ghidra::Range::decodeFromAttributes(), ghidra::Decoder::getNextAttributeId(), ghidra::Scope::glb, ghidra::Decoder::openElement(), ghidra::Decoder::readBool(), ghidra::Varnode::readonly, ghidra::Decoder::rewindAttributes(), ghidra::Database::setPropertyRange(), ghidra::Architecture::symboltab, and ghidra::Varnode::volatil.

Referenced by decode().

◆ findAddr()

SymbolEntry * ghidra::ScopeInternal::findAddr ( const Address addr,
const Address usepoint 
) const
virtual

Find a Symbol at a given address and usepoint.

Parameters
addris the given address
usepointis the point at which the Symbol is accessed (may be invalid)
Returns
the matching SymbolEntry or NULL

Implements ghidra::Scope.

References ghidra::rangemap< _recordtype >::find(), ghidra::SymbolEntry::getAddr(), ghidra::AddrSpace::getIndex(), ghidra::Address::getOffset(), ghidra::Address::getSpace(), ghidra::SymbolEntry::inUse(), ghidra::Address::isInvalid(), and maptable.

Referenced by ghidra::ScopeGhidra::findAddr(), and ghidra::ScopeGhidra::findCodeLabel().

◆ findByName()

void ghidra::ScopeInternal::findByName ( const string &  nm,
vector< Symbol *> &  res 
) const
virtual

Find a Symbol by name within this Scope.

If there are multiple Symbols with the same name, all are passed back.

Parameters
nmis the name to search for
reswill contain any matching Symbols

Implements ghidra::Scope.

References findFirstByName(), ghidra::Symbol::name, and nametree.

◆ findClosestFit()

SymbolEntry * ghidra::ScopeInternal::findClosestFit ( const Address addr,
int4  size,
const Address usepoint 
) const
virtual

Find Symbol which is the closest fit to the given memory range.

Parameters
addris the starting address of the given memory range
sizeis the number of bytes in the range
usepointis the point at which the Symbol is accessed (may be invalid)
Returns
the matching SymbolEntry or NULL

Implements ghidra::Scope.

References ghidra::rangemap< _recordtype >::find(), ghidra::AddrSpace::getIndex(), ghidra::SymbolEntry::getLast(), ghidra::Address::getOffset(), ghidra::SymbolEntry::getSize(), ghidra::Address::getSpace(), ghidra::SymbolEntry::inUse(), ghidra::Address::isInvalid(), and maptable.

Referenced by ghidra::ScopeGhidra::findContainer().

◆ findCodeLabel()

LabSymbol * ghidra::ScopeInternal::findCodeLabel ( const Address addr) const
virtual

◆ findContainer()

SymbolEntry * ghidra::ScopeInternal::findContainer ( const Address addr,
int4  size,
const Address usepoint 
) const
virtual

Find the smallest Symbol containing the given memory range.

Parameters
addris the starting address of the given memory range
sizeis the number of bytes in the range
usepointis the point at which the Symbol is accessed (may be invalid)
Returns
the matching SymbolEntry or NULL

Implements ghidra::Scope.

References end(), ghidra::rangemap< _recordtype >::find(), ghidra::AddrSpace::getIndex(), ghidra::SymbolEntry::getLast(), ghidra::Address::getOffset(), ghidra::SymbolEntry::getSize(), ghidra::Address::getSpace(), ghidra::SymbolEntry::inUse(), ghidra::Address::isInvalid(), and maptable.

Referenced by ghidra::ScopeGhidra::findAddr(), ghidra::ScopeGhidra::findExternalRef(), and ghidra::ScopeGhidra::findFunction().

◆ findExternalRef()

ExternRefSymbol * ghidra::ScopeInternal::findExternalRef ( const Address addr) const
virtual

Find an external reference at the given address.

Parameters
addris the given address
Returns
the matching ExternRefSymbol or NULL

Implements ghidra::Scope.

References ghidra::rangemap< _recordtype >::find(), ghidra::SymbolEntry::getAddr(), ghidra::AddrSpace::getIndex(), ghidra::Address::getOffset(), ghidra::Address::getSpace(), ghidra::SymbolEntry::getSymbol(), and maptable.

Referenced by ghidra::ScopeGhidra::findExternalRef().

◆ findFirstByName()

SymbolNameTree::const_iterator ghidra::ScopeInternal::findFirstByName ( const string &  nm) const
private

Find an iterator pointing to the first Symbol in the ordering with a given name.

Parameters
nmis the name to search for
Returns
iterator pointing to the first Symbol or nametree.end() if there is no matching Symbol

References nametree.

Referenced by buildVariableName(), decodeCollision(), findByName(), and makeNameUnique().

◆ findFunction()

Funcdata * ghidra::ScopeInternal::findFunction ( const Address addr) const
virtual

◆ findOverlap()

SymbolEntry * ghidra::ScopeInternal::findOverlap ( const Address addr,
int4  size 
) const
virtual

Find first Symbol overlapping the given memory range.

Parameters
addris the starting address of the given range
sizeis the number of bytes in the range
Returns
an overlapping SymbolEntry or NULL if none exists

Implements ghidra::Scope.

References ghidra::rangemap< _recordtype >::end(), ghidra::rangemap< _recordtype >::find_overlap(), ghidra::AddrSpace::getIndex(), ghidra::Address::getOffset(), ghidra::Address::getSpace(), and maptable.

Referenced by ghidra::ScopeLocal::adjustFit(), ghidra::ScopeLocal::markNotMapped(), and ghidra::Funcdata::syncVarnodesWithSymbols().

◆ getCategorySize()

int4 ghidra::ScopeInternal::getCategorySize ( int4  cat) const
virtual

Get the number of Symbols in the given category.

Parameters
catis the Symbol category
Returns
the number in that category

Implements ghidra::Scope.

References category.

◆ getCategorySymbol()

Symbol * ghidra::ScopeInternal::getCategorySymbol ( int4  cat,
int4  ind 
) const
virtual

Retrieve a Symbol by index within a specific category.

Parameters
catis the Symbol category
indis the index (within the category) of the Symbol
Returns
the indicated Symbol or NULL if no Symbol with that index exists

Implements ghidra::Scope.

References category.

◆ insertNameTree()

void ghidra::ScopeInternal::insertNameTree ( Symbol sym)
private

Insert a Symbol into the nametree.

Duplicate symbol names are allowed for by establishing a deduplication id for the Symbol.

Parameters
symis the Symbol to insert

References ghidra::Symbol::name, ghidra::Symbol::nameDedup, and nametree.

Referenced by renameSymbol().

◆ isNameUsed()

bool ghidra::ScopeInternal::isNameUsed ( const string &  nm,
const Scope op2 
) const
virtual

Check if the given name is occurs within the given scope path.

Test for the presence of a symbol with the given name in either this scope or an ancestor scope up to but not including the given terminating scope. If the name is used true is returned.

Parameters
nmis the given name to test
op2is the terminating ancestor scope (or null)

Implements ghidra::Scope.

Reimplemented in ghidra::ScopeGhidraNamespace.

References ghidra::Scope::getParent(), ghidra::Scope::isNameUsed(), and nametree.

◆ makeNameUnique()

string ghidra::ScopeInternal::makeNameUnique ( const string &  nm) const
virtual

Produce a version of the given symbol name that won't collide with other names in this Scope.

Parameters
nmis the given name
Returns
return a unique version of the name

Implements ghidra::Scope.

References findFirstByName(), ghidra::Symbol::getName(), ghidra::Symbol::nameDedup, and nametree.

Referenced by ghidra::ScopeLocal::buildVariableName(), buildVariableName(), ghidra::ActionNameVars::lookForBadJumpTables(), and ghidra::ActionNameVars::lookForFuncParamNames().

◆ resolveExternalRefFunction()

Funcdata * ghidra::ScopeInternal::resolveExternalRefFunction ( ExternRefSymbol sym) const
virtual

Convert an external reference to the referenced function.

Parameters
symis the Symbol marking the external reference
Returns
the underlying Funcdata object or NULL if none exists

Implements ghidra::Scope.

References ghidra::ExternRefSymbol::getRefAddr(), and ghidra::Scope::queryFunction().

◆ retypeSymbol()

void ghidra::ScopeInternal::retypeSymbol ( Symbol sym,
Datatype ct 
)
virtual

◆ setCategory()

void ghidra::ScopeInternal::setCategory ( Symbol sym,
int4  cat,
int4  ind 
)
virtual

Set the category and index for the given Symbol.

Parameters
symis the given Symbol
catis the category to set for the Symbol
indis the index position to set (within the category)

Implements ghidra::Scope.

References ghidra::Symbol::category, category, and ghidra::Symbol::catindex.

Referenced by categorySanity().


The documentation for this class was generated from the following files: