03fc414908
This is the first piece of the wasm debugging prototype (besides the changes to
add/remove breakpoints in WasmModuleObject made with
e699f39cae).
This changelist adds the infrastructure for a GDB-remote stub that will be used
to manage debugging sessions via the gdb-remote protocol.
It enables the creation and termination of debugging sessions over TCP
connections that are managed in a separate thread.
The logic to actually send, receive and decode GDB-remote packets will be part
of a future changelist.
Build with: v8_enable_wasm_gdb_remote_debugging = true
Run with:
--wasm-gdb-remote Enables Wasm debugging with LLDB
(default: false)
--wasm-gdb-remote-port TCP port to be used for debugging
(default: 8765)
--wasm-pause-waiting-for-debugger Pauses the execution of Wasm code waiting
for a debugger (default: false)
--trace-wasm-gdb-remote Enables tracing of Gdb-remote packets
(default: false)
Note that most of this code is "borrowed" from the code of the Chromium NaCL
GDB-remote stub (located in Chromium in src\native_client\src\trusted\debug_stub).
Implementation details:
- class GdbServer acts as a singleton manager for the gdb-remote stub. It is
instantiated as soon as the first Wasm module is loaded in the Wasm engine.
- class GdbServerThread spawns the worker thread for the TCP connection.
- class Transport manages the socket connection, in a portable way.
- class Session represents a remote debugging session.
- class Target represents a debugging target and it’s the place where the
debugging packets will be processed and will implement the logic to debug
a Wasm engine.
Bug: chromium:1010467
Change-Id: Ib2324e5901f5ae1d855b96b99ef0995d407322b6
Reviewed-on: https://chromium-review.googlesource.com/c/v8/v8/+/1923407
Reviewed-by: Clemens Backes <clemensb@chromium.org>
Reviewed-by: Benedikt Meurer <bmeurer@chromium.org>
Reviewed-by: Michael Achenbach <machenbach@chromium.org>
Commit-Queue: Paolo Severini <paolosev@microsoft.com>
Cr-Commit-Position: refs/heads/master@{#66379}
100 lines
2.4 KiB
Python
100 lines
2.4 KiB
Python
# Copyright 2019 the V8 project authors. All rights reserved.
|
|
# Use of this source code is governed by a BSD-style license that can be
|
|
# found in the LICENSE file.
|
|
|
|
import os
|
|
import re
|
|
import shlex
|
|
import sys
|
|
|
|
from testrunner.local import testsuite
|
|
from testrunner.local import utils
|
|
from testrunner.objects import testcase
|
|
from testrunner.outproc import message
|
|
|
|
PY_FLAGS_PATTERN = re.compile(r"#\s+Flags:(.*)")
|
|
|
|
class PYTestCase(testcase.TestCase):
|
|
|
|
def get_shell(self):
|
|
return os.path.splitext(sys.executable)[0]
|
|
|
|
def get_command(self):
|
|
return super(PYTestCase, self).get_command()
|
|
|
|
def _get_cmd_params(self):
|
|
return self._get_files_params() + ['--', os.path.join(self._test_config.shell_dir, 'd8')] + self._get_source_flags()
|
|
|
|
def _get_shell_flags(self):
|
|
return []
|
|
|
|
|
|
class TestCase(PYTestCase):
|
|
|
|
def __init__(self, *args, **kwargs):
|
|
super(TestCase, self).__init__(*args, **kwargs)
|
|
|
|
source = self.get_source()
|
|
self._source_files = self._parse_source_files(source)
|
|
self._source_flags = self._parse_source_flags(source)
|
|
|
|
def _parse_source_files(self, source):
|
|
files = []
|
|
files.append(self._get_source_path())
|
|
return files
|
|
|
|
def _parse_source_flags(self, source=None):
|
|
source = source or self.get_source()
|
|
flags = []
|
|
for match in re.findall(PY_FLAGS_PATTERN, source):
|
|
flags += shlex.split(match.strip())
|
|
return flags
|
|
|
|
def _expected_fail(self):
|
|
path = self.path
|
|
while path:
|
|
head, tail = os.path.split(path)
|
|
if tail == 'fail':
|
|
return True
|
|
path = head
|
|
return False
|
|
|
|
def _get_files_params(self):
|
|
return self._source_files
|
|
|
|
def _get_source_flags(self):
|
|
return self._source_flags
|
|
|
|
def _get_source_path(self):
|
|
base_path = os.path.join(self.suite.root, self.path)
|
|
if os.path.exists(base_path + self._get_suffix()):
|
|
return base_path + self._get_suffix()
|
|
return base_path + '.py'
|
|
|
|
def skip_predictable(self):
|
|
return super(TestCase, self).skip_predictable() or self._expected_fail()
|
|
|
|
|
|
class PYTestLoader(testsuite.GenericTestLoader):
|
|
|
|
@property
|
|
def excluded_files(self):
|
|
return {'gdb_rsp.py', 'testcfg.py', '__init__.py'}
|
|
|
|
@property
|
|
def extensions(self):
|
|
return ['.py']
|
|
|
|
|
|
class TestSuite(testsuite.TestSuite):
|
|
|
|
def _test_loader_class(self):
|
|
return PYTestLoader
|
|
|
|
def _test_class(self):
|
|
return TestCase
|
|
|
|
|
|
def GetSuite(*args, **kwargs):
|
|
return TestSuite(*args, **kwargs)
|