Method step_return

api/python/debuggercontroller.py:874–892

Perform a step return on the target. Step return completes the execution of the current function and returns to its caller. This operation relies heavily on stack frame analysis, which is done by the DebugAdapters. If a DebugAdapter does not support (i.e., overload

(self)

        return dbgcore.BNDebuggerStepOver(self.handle, il)

    def step_return(self) -> bool:
        """
        Perform a step return on the target.

        Step return completes the execution of the current function and returns to its caller. This operation relies
        heavily on stack frame analysis, which is done by the DebugAdapters.

        If a DebugAdapter does not support (i.e., overload) this function, a fallback handling is provided by the
        DebuggerController. It checks the MLIL function and put breakpoints on all returning instructions and then resume
        the target. By the time it breaks, the target is about to return from the current function.

        This fallback behavior is slightly different from that offered by the LLDB and DbgEng adapter, which returns
        from the current function and break afterwards.

        The call is asynchronous and returns before the target stops.

        :return: the reason for the stop
        """
        return dbgcore.BNDebuggerStepReturn(self.handle)

    def run_to(self, address) -> bool:
        """