201981b91c
Currently Travis supports only Ubuntu 12.04 linux 2.6 VMs which are terribly outdated, and trying to track down why it's hanging on Travis but not on other similar VMs is more trouble than it's worth at the moment. Certainly another more appropriate and up to date CI solution should be explored.
90 lines
2.5 KiB
Markdown
90 lines
2.5 KiB
Markdown
# Delve
|
|
|
|
[](https://godoc.org/github.com/derekparker/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:
|
|
* `args` - Prints the name and value of all arguments to the current function
|
|
* `funcs` - Prings the name of all defined functions
|
|
* `locals` - Prints the name and value of all local variables in the current context
|
|
* `sources` - Prings the path of all source files
|
|
* `vars` - Prints the name and value of all package variables in the app. Any variable that is not local or arg is considered a package variables
|
|
|
|
* `exit` - Exit the debugger.
|
|
|
|
|
|
### Upcoming features
|
|
|
|
* In-scope variable setting
|
|
* Support for OS X
|
|
* Editor integration
|
|
|
|
### License
|
|
|
|
MIT
|