Package ghidra.program.model.listing
Interface Function
- All Superinterfaces:
Namespace
- All Known Subinterfaces:
ThunkFunction
- All Known Implementing Classes:
FunctionDB
,UndefinedFunction
Interface to define methods available on a function. Functions have a single entry point.
-
Nested Class Summary
-
Field Summary
Modifier and TypeFieldDescriptionstatic final String
static final String
static final int
static final String
static final String
static final String
static final int
static final String
static final int
static final String
static final String
static final String
static final String
static final String
static final int
Default Stack depth for a function.Fields inherited from interface ghidra.program.model.symbol.Namespace
DELIMITER, GLOBAL_NAMESPACE_ID, NAMESPACE_DELIMITER
-
Method Summary
Modifier and TypeMethodDescriptionaddLocalVariable
(Variable var, SourceType source) Adds a local variable to the function.addParameter
(Variable var, SourceType source) Deprecated.The use of this method is discouraged due to the potential injection of auto-parameters which are easily overlooked when considering parameter ordinal.boolean
Adds the tag with the given name to this function; if one does not exist, one is created.Variable[]
Returns an array of all local and parameter variablesint
Gets the number of auto-parameters for this function also included in the total count provided bygetParameterCount()
.getCalledFunctions
(TaskMonitor monitor) Returns a set of functions that this function calls.Returns the current call-fixup name set on this instruction or null if one has not been setGets the calling convention prototype model for this function.Gets the calling convention's name for this function.getCallingFunctions
(TaskMonitor monitor) Returns a set of functions that call this function.Get the comment for this function.String[]
Returns the function (same as plate) comment as an array of strings where each item in the array is a line of text in the comment.Get the entry point for this function.default Address[]
Deprecated.since many use cases will likely want a complete list of thunk functions a recursive search is generally needed (seegetFunctionThunkAddresses(boolean)
).Address[]
getFunctionThunkAddresses
(boolean recursive) If this function is "Thunked", an array of Thunk Function entry points is returned.Variable[]
Get all local function variablesVariable[]
getLocalVariables
(VariableFilter filter) Get all local function variables which satisfy the specified filtergetName()
Get the name of this function.getParameter
(int ordinal) Returns the specified parameter including an auto-param at the specified ordinal.int
Gets the total number of parameters for this function.Get all function parametersgetParameters
(VariableFilter filter) Get all function parameters which satisfy the specified filterGet the program containing this function.getPrototypeString
(boolean formalSignature, boolean includeCallingConvention) Return a string representation of the function signatureReturns the repeatable comment for this function.String[]
Returns the repeatable comment as an array of strings.Get the Function's return type/storage represented by a Parameter object.Get the Function's return type.Get the function's effective signature.getSignature
(boolean formalSignature) Get the function's signature.Returns the source type for the overall signature excluding function name and parameter names whose source is carried by the corresponding symbol.Get the stack frame for this function.int
Get the change in the stack pointer resulting from calling this function.getTags()
Return allFunctionTag
objects associated with this function.getThunkedFunction
(boolean recursive) If this function is a Thunk, this method returns the referenced function.Variable[]
getVariables
(VariableFilter filter) Get all function variables which satisfy the specified filterboolean
boolean
default boolean
Determine if this signature has an unknown or unrecognized calling convention name.boolean
Returns true if this function has a variable argument list (VarArgs)insertParameter
(int ordinal, Variable var, SourceType source) Deprecated.The use of this method is discouraged due to the potential injection of auto-parameters which are easily overlooked when considering parameter ordinal.boolean
Determine if this function object has been deleted.boolean
Returns true if this namespace is external (i.e., associated with a Library)boolean
isInline()
boolean
check if stack purge size is valid.boolean
isThunk()
moveParameter
(int fromOrdinal, int toOrdinal) Deprecated.The use of this method is discouraged.void
Changes all local user-defined labels for this function to global symbols.void
removeParameter
(int ordinal) Deprecated.The use of this method is discouraged.void
Removes the given tag from this function.void
removeVariable
(Variable var) Removes the given variable from the function.void
replaceParameters
(Function.FunctionUpdateType updateType, boolean force, SourceType source, Variable... params) Replace all current parameters with the given list of parameters.void
replaceParameters
(List<? extends Variable> params, Function.FunctionUpdateType updateType, boolean force, SourceType source) Replace all current parameters with the given list of parameters.void
setBody
(AddressSetView newBody) Set the new body for this function.void
setCallFixup
(String name) Set the named call-fixup for this function.void
setCallingConvention
(String name) Sets the calling convention for this function to the named calling convention.void
setComment
(String comment) Set the comment for this function.void
setCustomVariableStorage
(boolean hasCustomVariableStorage) Set whether or not this function uses custom variable storagevoid
setInline
(boolean isInline) Sets whether or not this function is inline.void
setName
(String name, SourceType source) Set the name of this function.void
setNoReturn
(boolean hasNoReturn) Set whether or not this function has a return.void
setRepeatableComment
(String comment) Set the repeatable comment for this function.void
setReturn
(DataType type, VariableStorage storage, SourceType source) Set the return data-type and storage.void
setReturnType
(DataType type, SourceType source) Set the function's return type.void
setSignatureSource
(SourceType signatureSource) Set the source type for the overall signature excluding function name and parameter names whose source is carried by the corresponding symbol.void
setStackPurgeSize
(int purgeSize) Set the change in the stack pointer resulting from calling this function.void
setThunkedFunction
(Function thunkedFunction) Set the currently Thunked Function or null to convert to a normal functionvoid
setVarArgs
(boolean hasVarArgs) Set whether parameters can be passed as a VarArg (variable argument list)void
updateFunction
(String callingConvention, Variable returnValue, Function.FunctionUpdateType updateType, boolean force, SourceType source, Variable... newParams) Replace all current parameters with the given list of parameters and optionally change the calling convention and function return.void
updateFunction
(String callingConvention, Variable returnVar, List<? extends Variable> newParams, Function.FunctionUpdateType updateType, boolean force, SourceType source) Replace all current parameters with the given list of parameters and optionally change the calling convention and function return.Methods inherited from interface ghidra.program.model.symbol.Namespace
getBody, getID, getName, getParentNamespace, getPathList, getSymbol, isGlobal, isLibrary, setParentNamespace
-
Field Details
-
DEFAULT_PARAM_PREFIX
- See Also:
-
THIS_PARAM_NAME
- See Also:
-
RETURN_PTR_PARAM_NAME
- See Also:
-
DEFAULT_PARAM_PREFIX_LEN
static final int DEFAULT_PARAM_PREFIX_LEN -
DEFAULT_LOCAL_PREFIX
- See Also:
-
DEFAULT_LOCAL_RESERVED_PREFIX
- See Also:
-
DEFAULT_LOCAL_TEMP_PREFIX
- See Also:
-
DEFAULT_LOCAL_PREFIX_LEN
static final int DEFAULT_LOCAL_PREFIX_LEN -
UNKNOWN_CALLING_CONVENTION_STRING
- See Also:
-
DEFAULT_CALLING_CONVENTION_STRING
- See Also:
-
INLINE
- See Also:
-
NORETURN
- See Also:
-
THUNK
- See Also:
-
UNKNOWN_STACK_DEPTH_CHANGE
static final int UNKNOWN_STACK_DEPTH_CHANGEDefault Stack depth for a function.- See Also:
-
INVALID_STACK_DEPTH_CHANGE
static final int INVALID_STACK_DEPTH_CHANGE- See Also:
-
-
Method Details
-
getName
String getName()Get the name of this function. -
setName
Set the name of this function.- Parameters:
name
- the new name of the functionsource
- the source of this function name- Throws:
DuplicateNameException
- if the name is used by some other symbolInvalidInputException
- if the name is not a valid function name.
-
setCallFixup
Set the named call-fixup for this function.- Parameters:
name
- name of call-fixup specified by compiler spec. A null value will clear the current setting.
-
getCallFixup
String getCallFixup()Returns the current call-fixup name set on this instruction or null if one has not been set- Returns:
- the call fixup name or null
-
getProgram
Program getProgram()Get the program containing this function.- Returns:
- the program
-
getComment
String getComment()Get the comment for this function.- Returns:
- the comment for this function
-
getCommentAsArray
String[] getCommentAsArray()Returns the function (same as plate) comment as an array of strings where each item in the array is a line of text in the comment.- Returns:
- the comments
-
setComment
Set the comment for this function.- Parameters:
comment
- the string to set as the comment.
-
getRepeatableComment
String getRepeatableComment()Returns the repeatable comment for this function. A repeatable comment is a comment that will appear at locations that 'call' this function.- Returns:
- the repeatable comment for this function
-
getRepeatableCommentAsArray
String[] getRepeatableCommentAsArray()Returns the repeatable comment as an array of strings.- Returns:
- the repeatable comment as an array of strings
-
setRepeatableComment
Set the repeatable comment for this function.- Parameters:
comment
- the string to set as the repeatable comment.
-
getEntryPoint
Address getEntryPoint()Get the entry point for this function. Functions may only have ONE entry point.- Returns:
- the entry point
-
getReturnType
DataType getReturnType()Get the Function's return type. A null return value indicates the functions return type has never been set.- Returns:
- the DataType that this function returns.
-
setReturnType
Set the function's return type.- Parameters:
type
- the dataType that will define this functions return type.source
- signature source- Throws:
InvalidInputException
- if data type is not a fixed length.
-
getReturn
Parameter getReturn()Get the Function's return type/storage represented by a Parameter object. The parameter's ordinal value will be equal to Parameter.RETURN_ORIDINAL.- Returns:
- return data-type/storage
-
setReturn
void setReturn(DataType type, VariableStorage storage, SourceType source) throws InvalidInputException Set the return data-type and storage.NOTE: The storage and source are ignored if the function does not have custom storage enabled.
- Parameters:
type
- the data typestorage
- the storagesource
- source to be combined with the overall signature source.- Throws:
InvalidInputException
- if data type is not a fixed length or storage is improperly sized
-
getSignature
FunctionSignature getSignature()Get the function's effective signature. This is equivalent to invokinggetSignature(false)
where auto-params and forced-indirect types will be reflected in the signature if present.
WARNING! It is important to note that the calling convention may not be properly retained by the returned signature object if a non-generic calling convention is used by this function as defined by the program's compiler specification.- Returns:
- the function's signature
-
getSignature
Get the function's signature.
WARNING! It is important to note that the calling convention may not be properly retained by the returned signature object if a non-generic calling convention is used by this function as defined by the program's compiler specification.- Parameters:
formalSignature
- if true only original raw types will be retained and auto-params discarded (e.g., this, __return_storage_ptr__, etc.) within the returned signature. If false, the effective signature will be returned where forced indirect and auto-params are reflected in the signature. This option has no affect if the specified function has custom storage enabled.- Returns:
- the function's signature
-
getPrototypeString
Return a string representation of the function signature- Parameters:
formalSignature
- if true only original raw return/parameter types will be retained and auto-params discarded (e.g., this, __return_storage_ptr__, etc.) within the returned signature. If false, the effective signature will be returned where forced indirect and auto-params are reflected in the signature. This option has no affect if the specified function has custom storage enabled.includeCallingConvention
- if true prototype will include call convention declaration if known.- Returns:
- the prototype
-
getSignatureSource
SourceType getSignatureSource()Returns the source type for the overall signature excluding function name and parameter names whose source is carried by the corresponding symbol.- Returns:
- the overall SourceType of the function signature;
-
setSignatureSource
Set the source type for the overall signature excluding function name and parameter names whose source is carried by the corresponding symbol.- Parameters:
signatureSource
- function signature source type
-
getStackFrame
StackFrame getStackFrame()Get the stack frame for this function. NOTE: Use of the stack frame must be avoided during upgrade activity since the compiler spec may not be known (i.e., due to language upgrade process).- Returns:
- this functions stack frame
-
getStackPurgeSize
int getStackPurgeSize()Get the change in the stack pointer resulting from calling this function.- Returns:
- int the change in bytes to the stack pointer
-
getTags
Set<FunctionTag> getTags()Return allFunctionTag
objects associated with this function.- Returns:
- set of tag names
-
addTag
Adds the tag with the given name to this function; if one does not exist, one is created.- Parameters:
name
- the tag name to add- Returns:
- true if the tag was successfully added
-
removeTag
Removes the given tag from this function.- Parameters:
name
- the tag name to be removed.
-
setStackPurgeSize
void setStackPurgeSize(int purgeSize) Set the change in the stack pointer resulting from calling this function.- Parameters:
purgeSize
- the change in bytes to the stack pointer
-
isStackPurgeSizeValid
boolean isStackPurgeSizeValid()check if stack purge size is valid.- Returns:
- true if the stack depth is valid
-
addParameter
@Deprecated Parameter addParameter(Variable var, SourceType source) throws DuplicateNameException, InvalidInputException Deprecated.The use of this method is discouraged due to the potential injection of auto-parameters which are easily overlooked when considering parameter ordinal. The function signature should generally be adjusted with a single call toupdateFunction(String, Variable, List, FunctionUpdateType, boolean, SourceType)
Adds the given variable to the end of the parameters list. The variable storage specified for the new parameter will be ignored if custom storage mode is not enabled. TheVariableUtilities.checkVariableConflict(Function, Variable, VariableStorage, boolean)
method may be used to check and remove conflicting variables which already exist in the function.- Parameters:
var
- the variable to add as a new parameter.source
- the source of this parameter which will be applied to the parameter symbol and overall function signature source. If parameter has a null or default name a SourceType of DEFAULT will be applied to the parameter symbol.- Returns:
- the Parameter object created.
- Throws:
DuplicateNameException
- if another variable(parameter or local) already exists in the function with that name.InvalidInputException
- if data type is not a fixed length or variable name is invalid.VariableSizeException
- if data type size is too large based upon storage constraints.
-
insertParameter
@Deprecated Parameter insertParameter(int ordinal, Variable var, SourceType source) throws DuplicateNameException, InvalidInputException Deprecated.The use of this method is discouraged due to the potential injection of auto-parameters which are easily overlooked when considering parameter ordinal. The function signature should generally be adjusted with a single call toupdateFunction(String, Variable, List, FunctionUpdateType, boolean, SourceType)
Inserts the given variable into the parameters list. The variable storage specified for the new parameter will be ignored if custom storage mode is not enabled. TheVariableUtilities.checkVariableConflict(Function, Variable, VariableStorage, boolean)
method may be used to check and remove conflicting variables which already exist in the function.- Parameters:
ordinal
- the position with the parameters to insert to. This ordinal must factor in the presence of auto-parameters which may be injected dynamically based upon calling convention and return data type. Parameters may not be inserted befor an auto-parameter.var
- the variable to add as a new parameter.source
- the source of this parameter which will be applied to the parameter symbol and overall function signature source. If parameter has a null or default name a SourceType of DEFAULT will be applied to the parameter symbol.- Returns:
- the Parameter object created.
- Throws:
DuplicateNameException
- if another variable(parameter or local) already exists in the function with that name.InvalidInputException
- if data type is not a fixed length or variable name is invalid.VariableSizeException
- if data type size is too large based upon storage constraints.
-
replaceParameters
void replaceParameters(List<? extends Variable> params, Function.FunctionUpdateType updateType, boolean force, SourceType source) throws DuplicateNameException, InvalidInputException Replace all current parameters with the given list of parameters. TheVariableUtilities.checkVariableConflict(Function, Variable, VariableStorage, boolean)
method may be used to check and remove conflicting variables which already exist in the function.- Parameters:
params
- the new set of parameters for the function.updateType
- function update typeforce
- if true any conflicting local parameters will be removedsource
- the source of these parameters which will be applied to the parameter symbols and overall function signature source. If parameter names are null or a default name a SourceType of DEFAULT will be applied to the corresponding parameter symbol.- Throws:
DuplicateNameException
- if another variable(parameter or local) already exists in the function with that name.InvalidInputException
- if a parameter data type is not a fixed length or variable name is invalid.VariableSizeException
- if a parameter data type size is too large based upon storage constraints or conflicts with another variable.
-
replaceParameters
void replaceParameters(Function.FunctionUpdateType updateType, boolean force, SourceType source, Variable... params) throws DuplicateNameException, InvalidInputException Replace all current parameters with the given list of parameters. TheVariableUtilities.checkVariableConflict(Function, Variable, VariableStorage, boolean)
method may be used to check and remove conflicting variables which already exist in the function.- Parameters:
updateType
- function update typeforce
- if true any conflicting local parameters will be removedsource
- the source of these parameters which will be applied to the parameter symbols and overall function signature source. If parameter names are null or a default name a SourceType of DEFAULT will be applied to the corresponding parameter symbol.params
- the new parameters for the function.- Throws:
DuplicateNameException
- if another variable(parameter or local) already exists in the function with that name.InvalidInputException
- if a parameter data type is not a fixed length or variable name is invalid.VariableSizeException
- if a parameter data type size is too large based upon storage constraints or conflicts with another variable.
-
updateFunction
void updateFunction(String callingConvention, Variable returnValue, Function.FunctionUpdateType updateType, boolean force, SourceType source, Variable... newParams) throws DuplicateNameException, InvalidInputException Replace all current parameters with the given list of parameters and optionally change the calling convention and function return. TheVariableUtilities.checkVariableConflict(Function, Variable, VariableStorage, boolean)
method may be used to check and remove conflicting variables which already exist in the function.- Parameters:
callingConvention
- updated calling convention name or null if no change is required. Onlyknown calling convention names
may be specified which will always include those defined by the associatedCompilerSpec
.returnValue
- return variable or null if no change requiredupdateType
- function update typeforce
- if true any conflicting local parameters will be removedsource
- the source of these parameters which will be applied to the parameter symbols and overall function signature source. If parameter names are null or a default name a SourceType of DEFAULT will be applied to the corresponding parameter symbol.newParams
- a variable number of parameters for the function.- Throws:
DuplicateNameException
- if another variable(parameter or local) already exists in the function with that name.InvalidInputException
- if a parameter data type is not a fixed length or variable name is invalid.VariableSizeException
- if a parameter data type size is too large based upon storage constraints or conflicts with another variable.
-
updateFunction
void updateFunction(String callingConvention, Variable returnVar, List<? extends Variable> newParams, Function.FunctionUpdateType updateType, boolean force, SourceType source) throws DuplicateNameException, InvalidInputException Replace all current parameters with the given list of parameters and optionally change the calling convention and function return. TheVariableUtilities.checkVariableConflict(Function, Variable, VariableStorage, boolean)
method may be used to check and remove conflicting variables which already exist in the function.- Parameters:
callingConvention
- updated calling convention name or null if no change is required. Onlyknown calling convention names
may be specified which will always include those defined by the associatedCompilerSpec
.returnVar
- return variable or null if no change requirednewParams
- the list of new parameters for the function (required).updateType
- function update typeforce
- if true any conflicting local parameters will be removedsource
- the source of these parameters which will be applied to the parameter symbols and overall function signature source. If parameter names are null or a default name a SourceType of DEFAULT will be applied to the corresponding parameter symbol.- Throws:
DuplicateNameException
- if another variable(parameter or local) already exists in the function with that name.InvalidInputException
- if a parameter data type is not a fixed length or variable name is invalid.VariableSizeException
- if a parameter data type size is too large based upon storage constraints or conflicts with another variable.
-
getParameter
Returns the specified parameter including an auto-param at the specified ordinal.- Parameters:
ordinal
- the index of the parameter to return.- Returns:
- parameter or null if ordinal is out of range
-
removeParameter
Deprecated.The use of this method is discouraged. The function signature should generally be adjusted with a single call toupdateFunction(String, Variable, List, FunctionUpdateType, boolean, SourceType)
Remove the specified parameter. Auto-parameters may not be removed but must be accounted for in the specified ordinal.- Parameters:
ordinal
- the index of the parameter to be removed.
-
moveParameter
Deprecated.The use of this method is discouraged. The function signature should generally be adjusted with a single call toupdateFunction(String, Variable, List, FunctionUpdateType, boolean, SourceType)
Move the parameter which occupies the fromOrdinal position to the toOrdinal position. Parameters will be renumbered to reflect the new ordering. Auto-parameters may not be moved but must be accounted for in the specified ordinals.- Parameters:
fromOrdinal
- from ordinal position using the current numberingtoOrdinal
- the final position of the specified parameter- Returns:
- parameter which was moved
- Throws:
InvalidInputException
- if either ordinal is invalid
-
getParameterCount
int getParameterCount()Gets the total number of parameters for this function. This number also includes any auto-parameters which may have been injected when dynamic parameter storage is used.- Returns:
- the total number of parameters
-
getAutoParameterCount
int getAutoParameterCount()Gets the number of auto-parameters for this function also included in the total count provided bygetParameterCount()
. This number will always be 0 when custom parameter storage is used.- Returns:
- the number of auto-parameters
-
getParameters
Parameter[] getParameters()Get all function parameters- Returns:
- all function parameters
-
getParameters
Get all function parameters which satisfy the specified filter- Parameters:
filter
- variable filter or null for all parameters to be returned- Returns:
- all function parameters which satisfy the specified filter
-
getLocalVariables
Variable[] getLocalVariables()Get all local function variables- Returns:
- all local function variables
-
getLocalVariables
Get all local function variables which satisfy the specified filter- Parameters:
filter
- variable filter or null for all local variables to be returned- Returns:
- all function variables which satisfy the specified filter
-
getVariables
Get all function variables which satisfy the specified filter- Parameters:
filter
- variable filter or null for all variables to be returned- Returns:
- all function variables which satisfy the specified filter
-
getAllVariables
Variable[] getAllVariables()Returns an array of all local and parameter variables- Returns:
- the variables
-
addLocalVariable
Variable addLocalVariable(Variable var, SourceType source) throws DuplicateNameException, InvalidInputException Adds a local variable to the function. TheVariableUtilities.checkVariableConflict(Function, Variable, VariableStorage, boolean)
method may be used to check and remove conflicting variables which already exist in the function.- Parameters:
var
- the variable to add.source
- the source of this local variable- Returns:
- the Variable added to the program.
- Throws:
DuplicateNameException
- if another local variable or parameter already has that name.InvalidInputException
- if there is an error or conflict when resolving the variable
-
removeVariable
Removes the given variable from the function.- Parameters:
var
- the variable to remove.
-
setBody
Set the new body for this function. The entry point must be contained in the new body.- Parameters:
newBody
- address set to use as the body of this function- Throws:
OverlappingFunctionException
- if the address set overlaps that of another function
-
hasVarArgs
boolean hasVarArgs()Returns true if this function has a variable argument list (VarArgs)- Returns:
- true if this function has a variable argument list (VarArgs)
-
setVarArgs
void setVarArgs(boolean hasVarArgs) Set whether parameters can be passed as a VarArg (variable argument list)- Parameters:
hasVarArgs
- true if this function has a variable argument list (e.g., printf(fmt, ...)).
-
isInline
boolean isInline()- Returns:
- true if this is an inline function.
-
setInline
void setInline(boolean isInline) Sets whether or not this function is inline.- Parameters:
isInline
- true if this is an inline function.
-
hasNoReturn
boolean hasNoReturn()- Returns:
- true if this function does not return.
-
setNoReturn
void setNoReturn(boolean hasNoReturn) Set whether or not this function has a return.- Parameters:
hasNoReturn
- true if this function does not return.
-
hasCustomVariableStorage
boolean hasCustomVariableStorage()- Returns:
- true if function parameters utilize custom variable storage.
-
setCustomVariableStorage
void setCustomVariableStorage(boolean hasCustomVariableStorage) Set whether or not this function uses custom variable storage- Parameters:
hasCustomVariableStorage
- true if this function uses custom storage
-
getCallingConvention
PrototypeModel getCallingConvention()Gets the calling convention prototype model for this function.- Returns:
- the prototype model of the function's current calling convention or null.
-
hasUnknownCallingConventionName
default boolean hasUnknownCallingConventionName()Determine if this signature has an unknown or unrecognized calling convention name.- Returns:
- true if calling convention is unknown or unrecognized name, else false.
-
getCallingConventionName
String getCallingConventionName()Gets the calling convention's name for this function.- Returns:
- the name of the calling convention or Function.DEFAULT_CALLING_CONVENTION_STRING (i.e. "default", if the calling convention has been set to the default for this function) or Function.UNKNOWN_CALLING_CONVENTION_STRING (i.e. "unknown", if no calling convention is specified for this function).
-
setCallingConvention
Sets the calling convention for this function to the named calling convention. Onlyknown calling convention names
may be specified which will always include those defined by the associatedCompilerSpec
.- Parameters:
name
- the name of the calling convention. Onlyknown calling convention names
may be specified which will always include those defined by the associatedCompilerSpec
. In addition the reserved names"unknown"
and"default"
may also be used here.- Throws:
InvalidInputException
- if the specified name is not a recognized calling convention name.
-
isThunk
boolean isThunk()- Returns:
- true if this function is a Thunk and has a referenced Thunked Function.
- See Also:
-
getThunkedFunction
If this function is a Thunk, this method returns the referenced function.- Parameters:
recursive
- if true and the thunked-function is a thunk itself, the returned thunked-function will be the final thunked-function which will never be a thunk.- Returns:
- function referenced by this Thunk Function or null if this is not a Thunk function
-
getFunctionThunkAddresses
Deprecated.since many use cases will likely want a complete list of thunk functions a recursive search is generally needed (seegetFunctionThunkAddresses(boolean)
). This method form may be removed in a future release.If this function is "Thunked", an array of Thunk Function entry points is returned. A non-recursive search is performed (i.e., first-hop only).- Returns:
- associated thunk function entry points or null if this is not a "Thunked" function.
-
getFunctionThunkAddresses
If this function is "Thunked", an array of Thunk Function entry points is returned.- Parameters:
recursive
- if true a recursive search is performed returning all effective thunks of this function, else if false only the first-hop (i.e., direct thunks) are returned.- Returns:
- associated thunk function entry points or null if this is not a "Thunked" function.
-
setThunkedFunction
Set the currently Thunked Function or null to convert to a normal function- Parameters:
thunkedFunction
- the thunked function or null to convert this thunked function to a normal function.- Throws:
IllegalArgumentException
- if an attempt is made to thunk a function or another thunk which would result in a loop back to this function or if this function is an external function, or specified function is from a different program instance.
-
isExternal
boolean isExternal()Description copied from interface:Namespace
Returns true if this namespace is external (i.e., associated with a Library)- Specified by:
isExternal
in interfaceNamespace
- Returns:
- true if this function is external (i.e., entry point is in EXTERNAL address space)
-
getExternalLocation
ExternalLocation getExternalLocation()- Returns:
- if this is an external function return the associated external location object.
-
getCallingFunctions
Returns a set of functions that call this function.- Parameters:
monitor
- The monitor that is used to report progress and allow for canceling of the search. May be null.- Returns:
- a set of functions that call this function.
-
getCalledFunctions
Returns a set of functions that this function calls.- Parameters:
monitor
- The monitor that is used to report progress and allow for canceling of the search. May be null.- Returns:
- a set of functions that this function calls.
-
promoteLocalUserLabelsToGlobal
void promoteLocalUserLabelsToGlobal()Changes all local user-defined labels for this function to global symbols. If a global code symbol already exists with the same name at the symbols address the symbol will be removed. -
isDeleted
boolean isDeleted()Determine if this function object has been deleted. NOTE: the function could be deleted at anytime due to asynchronous activity.- Returns:
- true if function has been deleted, false if not.
-