diff options
Diffstat (limited to 'python/function.py')
| -rw-r--r-- | python/function.py | 30 |
1 files changed, 30 insertions, 0 deletions
diff --git a/python/function.py b/python/function.py index d571bc55..cf8bafdd 100644 --- a/python/function.py +++ b/python/function.py @@ -2213,6 +2213,16 @@ class Function: self, graph_type: FunctionViewTypeOrName = FunctionGraphType.NormalFunctionGraph, settings: Optional['DisassemblySettings'] = None ) -> flowgraph.CoreFlowGraph: + """ + Create a flow graph with the disassembly of this function. + + .. note:: This graph waits for function analysis, so Workflow Activities should instead use + :py:func:`create_graph_immediate` to create graphs with the function contents as-is. + + :param graph_type: IL form of the disassembly in the graph + :param settings: Optional settings for the disassembly text renderer + :return: Flow graph object + """ if settings is not None: settings_obj = settings.handle else: @@ -2220,6 +2230,26 @@ class Function: graph_type = FunctionViewType(graph_type)._to_core_struct() return flowgraph.CoreFlowGraph(core.BNCreateFunctionGraph(self.handle, graph_type, settings_obj)) + def create_graph_immediate( + self, graph_type: FunctionViewTypeOrName = FunctionGraphType.NormalFunctionGraph, + settings: Optional['DisassemblySettings'] = None + ) -> flowgraph.CoreFlowGraph: + """ + Create a flow graph with the disassembly of this function, specifically using the + instructions as they are in the function when this is called. You probably want to use + this if you are creating a Debug Report in a Workflow Activity. + + :param graph_type: IL form of the disassembly in the graph + :param settings: Optional settings for the disassembly text renderer + :return: Flow graph object + """ + if settings is not None: + settings_obj = settings.handle + else: + settings_obj = None + graph_type = FunctionViewType(graph_type)._to_core_struct() + return flowgraph.CoreFlowGraph(core.BNCreateImmediateFunctionGraph(self.handle, graph_type, settings_obj)) + def apply_imported_types(self, sym: 'types.CoreSymbol', type: Optional[StringOrType] = None) -> None: if isinstance(type, str): (type, _) = self.view.parse_type_string(type) |