delve/Documentation/usage
Alessandro Arzilli 2c1a822632
terminal,service,proc/*: adds dump command (gcore equivalent) (#2173)
* proc/core: off-by-one error reading ELF core files

core.(*splicedMemory).ReadMemory checked the entry interval
erroneously when dealing with contiguous entries.

* terminal,service,proc/*: adds dump command (gcore equivalent)

Adds the `dump` command that creates a core file from the target process.

Backends will need to implement a new, optional, method `MemoryMap` that
returns a list of mapped memory regions.
Additionally the method `DumpProcessNotes` can be implemented to write out
to the core file notes describing the target process and its threads. If
DumpProcessNotes is not implemented `proc.Dump` will write a description of
the process and its threads in a OS/arch-independent format (that only Delve
understands).

Currently only linux/amd64 implements `DumpProcessNotes`.

Core files are only written in ELF, there is no minidump or macho-o writers.

# Conflicts:
#	pkg/proc/proc_test.go
2021-01-29 13:39:33 -08: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 cmd: update dlv dap --help (#2299) 2021-01-13 13:10:15 +01: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 *: Expand --build-flags= description in the document (#2273) 2021-01-05 10:57:30 -08: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 *: Expand --build-flags= description in the document (#2273) 2021-01-05 10:57:30 -08: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.