PenaDevops/delve
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Update documentation

Browse Source
This commit is contained in:
Derek Parker 2015-06-17 22:01:31 -05:00
parent c720919b04
commit b7d4815d15
1 changed files with 14 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

19
proc/threads.go
View File

@ -26,6 +26,9 @@ type Thread struct {
os *OSSpecificDetails os *OSSpecificDetails
} }
// Represents the location of a thread.
// Holds information on the current instruction
// address, the source file:line, and the function.
type Location struct { type Location struct {
PC uint64 PC uint64
File string File string
@ -53,8 +56,12 @@ func (thread *Thread) Continue() error {
return thread.resume() return thread.resume()
} }
// Single steps this thread a single instruction, ensuring that // Step a single instruction.
// we correctly handle the likely case that we are at a breakpoint. //
// Executes exactly one instruction and then returns.
// If the thread is at a breakpoint, we first clear it,
// execute the instruction, and then replace the breakpoint.
// Otherwise we simply execute the next instruction.
func (thread *Thread) Step() (err error) { func (thread *Thread) Step() (err error) {
thread.singleStepping = true thread.singleStepping = true
defer func() { thread.singleStepping = false }() defer func() { thread.singleStepping = false }()
@ -91,7 +98,7 @@ func (thread *Thread) Break(addr uint64) (*Breakpoint, error) {
return thread.dbp.setBreakpoint(thread.Id, addr, false) return thread.dbp.setBreakpoint(thread.Id, addr, false)
} }
// Set breakpoint using this thread. // Set temp breakpoint using this thread. Primarily used for next'ing.
func (thread *Thread) TempBreak(addr uint64) (*Breakpoint, error) { func (thread *Thread) TempBreak(addr uint64) (*Breakpoint, error) {
return thread.dbp.setBreakpoint(thread.Id, addr, true) return thread.dbp.setBreakpoint(thread.Id, addr, true)
} }
@ -101,6 +108,9 @@ func (thread *Thread) Clear(addr uint64) (*Breakpoint, error) {
return thread.dbp.clearBreakpoint(thread.Id, addr) return thread.dbp.clearBreakpoint(thread.Id, addr)
} }
// Returns the threads location, including the file:line
// of the corresponding source code, the function we're in
// and the current instruction address.
func (thread *Thread) Location() (*Location, error) { func (thread *Thread) Location() (*Location, error) {
pc, err := thread.PC() pc, err := thread.PC()
if err != nil { if err != nil {
@ -163,8 +173,7 @@ func (ge GoroutineExitingError) Error() string {
return fmt.Sprintf("goroutine %d is exiting", ge.goid) return fmt.Sprintf("goroutine %d is exiting", ge.goid)
} }
// This version of next uses the AST from the current source file to figure out all of the potential source lines // Use the AST to determine potential next lines.
// we could end up at.
func (thread *Thread) next(curpc uint64, fde *frame.FrameDescriptionEntry, file string, line int) error { func (thread *Thread) next(curpc uint64, fde *frame.FrameDescriptionEntry, file string, line int) error {
lines, err := thread.dbp.ast.NextLines(file, line) lines, err := thread.dbp.ast.NextLines(file, line)
if err != nil { if err != nil {