2014-05-03 20:31:52 +00:00
|
|
|
# DBG
|
|
|
|
|
|
2014-07-21 16:40:21 +00:00
|
|
|
### What is DBG?
|
2014-05-03 20:31:52 +00:00
|
|
|
|
2014-07-21 16:44:53 +00:00
|
|
|
DBG is a Go debugger, written primarily in Go. It really needs a new name.
|
2014-05-03 20:31:52 +00:00
|
|
|
|
2014-08-23 13:50:18 +00:00
|
|
|
### Building
|
|
|
|
|
|
|
|
|
|
Currently, DBG requires 2 patches to be applied to Go source to build.
|
|
|
|
|
|
|
|
|
|
1. [Dwarf Fix](https://codereview.appspot.com/117280043/)
|
2014-08-27 14:08:17 +00:00
|
|
|
2. [Process.Wait() fix](https://codereview.appspot.com/132220044).
|
2014-08-23 13:50:18 +00:00
|
|
|
|
2014-07-21 16:40:21 +00:00
|
|
|
### Features
|
|
|
|
|
|
|
|
|
|
* Attach to (trace) a running process
|
|
|
|
|
* Set breakpoints
|
|
|
|
|
* Single step through a process
|
|
|
|
|
* Next through a process (step over / out of subroutines)
|
|
|
|
|
* Never retype commands, empty line defaults to previous command
|
|
|
|
|
|
|
|
|
|
### Usage
|
|
|
|
|
|
2014-07-21 16:41:50 +00:00
|
|
|
* `break` - Set break point at the entry point of a function, or at a specific file/line. Example: `break foo.go:13`.
|
2014-07-21 16:40:21 +00:00
|
|
|
|
2014-07-21 16:41:50 +00:00
|
|
|
* `step` - Single step through program.
|
2014-07-21 16:40:21 +00:00
|
|
|
|
2014-07-21 16:41:50 +00:00
|
|
|
* `next` - Step over to next source line.
|
2014-07-21 16:40:21 +00:00
|
|
|
|
|
|
|
|
### Upcoming features
|
|
|
|
|
|
|
|
|
|
* Handle Gos multithreaded nature better (follow goroutine accross thread contexts)
|
|
|
|
|
* In-scope variable evaluation
|
|
|
|
|
* In-scope variable setting
|
|
|
|
|
* Readline integration
|
|
|
|
|
* Ability to launch debugging session from debugged program, with breakpoint set correctly
|
2014-07-30 00:00:03 +00:00
|
|
|
* Support for OS X
|
2014-07-21 16:40:21 +00:00
|
|
|
|
|
|
|
|
### License
|
2014-05-03 20:31:52 +00:00
|
|
|
|
|
|
|
|
MIT
|
