gdb/python/lib/gdb/dap/next.py

# Copyright 2022-2023 Free Software Foundation, Inc.

# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; either version 3 of the License, or
# (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program.  If not, see <http://www.gnu.org/licenses/>.

import gdb

from .events import StopKinds, ExecutionInvoker
from .server import capability, request
from .startup import in_gdb_thread, send_gdb, send_gdb_with_response
from .state import set_thread


# Helper function to set the current thread and the scheduler-locking
# mode.  Returns True if scheduler-locking was successfully set to
# 'on', False in all other cases, including error.
@in_gdb_thread
def _handle_thread_step(thread_id, single_thread):
    # Ensure we're going to step the correct thread.
    set_thread(thread_id)
    if single_thread:
        result = True
        arg = "on"
    else:
        result = False
        arg = "off"
    try:
        # This can fail, depending on the target, so catch the error
        # and report to our caller.  We can't use exec_and_log because
        # that does not propagate exceptions.
        gdb.execute("set scheduler-locking " + arg, from_tty=True, to_string=True)
    except gdb.error:
        result = False
    return result


@request("next")
def next(
    *, threadId: int, singleThread: bool = False, granularity: str = "statement", **args
):
    send_gdb(lambda: _handle_thread_step(threadId, singleThread))
    cmd = "next"
    if granularity == "instruction":
        cmd += "i"
    send_gdb(ExecutionInvoker(cmd, StopKinds.STEP))


@capability("supportsSteppingGranularity")
@capability("supportsSingleThreadExecutionRequests")
@request("stepIn")
def step_in(
    *, threadId: int, singleThread: bool = False, granularity: str = "statement", **args
):
    send_gdb(lambda: _handle_thread_step(threadId, singleThread))
    cmd = "step"
    if granularity == "instruction":
        cmd += "i"
    send_gdb(ExecutionInvoker(cmd, StopKinds.STEP))


@request("stepOut")
def step_out(*, threadId: int, singleThread: bool = False):
    send_gdb(lambda: _handle_thread_step(threadId, singleThread))
    send_gdb(ExecutionInvoker("finish", StopKinds.STEP))


@request("continue")
def continue_request(*, threadId: int, singleThread: bool = False, **args):
    locked = send_gdb_with_response(lambda: _handle_thread_step(threadId, singleThread))
    send_gdb(ExecutionInvoker("continue", None))
    return {"allThreadsContinued": not locked}