delve/Documentation/usage
Luis Gabriel Gomez 69615b3604
service/dap: Support for replay and core modes (#2367)
This PR aims to add support for rr replay and core actions from the DAP layer. This basically encloses the following:
New launch modes: replay and core

The following modes are added:

    replay: Replays an rr trace, allowing backwards flows (reverse continue and stepback). Requires a traceDirPath property on launch.json pointing to a valid rr trace directory.
    Equivalent to dlv replay <tracedir> command.
    core: Replays a core dump file, showing its callstack and the file matching the callsite. Requires a coreFilePath property on launch.json pointing to a valid coredump file.
    Equivalent to dlv core <exe> <corefile> command.

Dependencies

To achieve this the following additional changes were made:

    Implement the onStepBackRequest and onReverseContinueRequest methods on service/dap
    Adapt onLaunchRequest with the requried validations and logic for these new modes
    Use CapabilitiesEvent responses to enable the StepBack controls on the supported scenarios (see dicussion here)
    Add the corresponding launch.json support on vs code: 

Support for replay and core modes golang/vscode-go#1268
2021-07-21 07:38:04 -07:00
..
dlv_attach.md *: Expand --build-flags= description in the document (#2273) 2021-01-05 10:57:30 -08:00
dlv_backend.md *: Expand --build-flags= description in the document (#2273) 2021-01-05 10:57:30 -08:00
dlv_connect.md *: Expand --build-flags= description in the document (#2273) 2021-01-05 10:57:30 -08:00
dlv_core.md terminal,service,proc/*: adds dump command (gcore equivalent) (#2173) 2021-01-29 13:39:33 -08:00
dlv_dap.md service/dap: Support for replay and core modes (#2367) 2021-07-21 07:38:04 -07:00
dlv_debug.md *: Expand --build-flags= description in the document (#2273) 2021-01-05 10:57:30 -08:00
dlv_exec.md *: Expand --build-flags= description in the document (#2273) 2021-01-05 10:57:30 -08:00
dlv_log.md *: Expand --build-flags= description in the document (#2273) 2021-01-05 10:57:30 -08:00
dlv_redirect.md *: Expand --build-flags= description in the document (#2273) 2021-01-05 10:57:30 -08:00
dlv_replay.md *: Expand --build-flags= description in the document (#2273) 2021-01-05 10:57:30 -08:00
dlv_run.md *: Expand --build-flags= description in the document (#2273) 2021-01-05 10:57:30 -08:00
dlv_test.md Documentation: document passing arguments to the test program (#2459) 2021-05-04 12:37:09 -07:00
dlv_trace.md *: Expand --build-flags= description in the document (#2273) 2021-01-05 10:57:30 -08:00
dlv_version.md *: Expand --build-flags= description in the document (#2273) 2021-01-05 10:57:30 -08:00
dlv.md cmd/dap: server - always headless, target - always foregrounded (#2589) 2021-07-16 09:49:16 -07:00
README.md docs: Move wiki docs into Documentation dir 2016-02-19 10:47:46 -08:00

Using Delve

You can invoke Delve in multiple ways, depending on your usage needs. Delve makes every attempt to be user-friendly, ensuring the user has to do the least amount of work possible to begin debugging their program.

Refer to the main usage document to further explore commands.