https://github.com/csimplestring/delve
Go debugger
https://github.com/csimplestring/delve
Last synced: 5 months ago
JSON representation
Go debugger
- Host: GitHub
- URL: https://github.com/csimplestring/delve
- Owner: csimplestring
- License: mit
- Fork: true (go-delve/delve)
- Created: 2015-01-11T20:28:33.000Z (over 11 years ago)
- Default Branch: master
- Last Pushed: 2015-01-10T23:33:12.000Z (over 11 years ago)
- Last Synced: 2024-04-16T00:22:24.555Z (about 2 years ago)
- Language: Go
- Size: 8.35 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Delve
### What is Delve?
Delve is a (Beta) Go debugger, written in Go.
This project is currently in beta. Most of the functionality is there, but there are various improvements to be made.
### Building
Delve requires Go 1.4 to build.
```
go get github.com/derekparker/delve/cmd/dlv
```
You will need readline installed on your system. With apt simply: `sudo apt-get install libreadline-dev` .
### Features
* Attach to an already running process
* Launch a process and begin debug session
* Set breakpoints, single step, step over functions, print variable contents, print thread and goroutine information
### Usage
The debugger can be launched in three ways:
* Compile, run, and attach in one step:
```
$ dlv -run
```
* Provide the name of the program you want to debug, and the debugger will launch it for you.
```
$ dlv path/to/program
```
* Provide the pid of a currently running process, and the debugger will attach and begin the session.
```
$ sudo dlv -pid 44839
```
### Breakpoints
Delve can insert breakpoints via the `breakpoint` command once inside a debug session, however for ease of debugging, you can also call `runtime.Breakpoint()` and Delve will handle the breakpoint and stop the program at the next source line.
### Commands
Once inside a debugging session, the following commands may be used:
* `break` - Set break point at the entry point of a function, or at a specific file/line. Example: `break foo.go:13`.
* `continue` - Run until breakpoint or program termination.
* `step` - Single step through program.
* `next` - Step over to next source line.
* `threads` - Print status of all traced threads.
* `goroutines` - Print status of all goroutines.
* `print $var` - Evaluate a variable.
* `info $type [regex]` - Outputs information about the symbol table. An optional regex filters the list. Example `info funcs unicode`. Valid types are:
* `sources` - Prings the path of all source files
* `funcs` - Prings the name of all defined functions
* `locals` - Prints the name and value of all local variables in the current context
* `args` - Prints the name and value of all arguments to the current function
* `exit` - Exit the debugger.
### Upcoming features
* In-scope variable setting
* Support for OS X
* Editor integration
### License
MIT