remote

Documentation

Overview

Package remote provides remote access to a debugproxy server.

Index

• Variables
• type File
  • func (f *File) Close() error
  • func (f *File) ReadAt(p []byte, offset int64) (int, error)
  • func (f *File) WriteAt(p []byte, offset int64) (int, error)
• type Program
  • func New(host string, textFile string) (*Program, error)
  • func (p *Program) Breakpoint(address uint64) ([]uint64, error)
  • func (p *Program) BreakpointAtFunction(name string) ([]uint64, error)
  • func (p *Program) BreakpointAtLine(file string, line uint64) ([]uint64, error)
  • func (p *Program) DeleteBreakpoints(pcs []uint64) error
  • func (p *Program) Eval(expr string) ([]string, error)
  • func (p *Program) Evaluate(e string) (debug.Value, error)
  • func (p *Program) Frames(count int) ([]debug.Frame, error)
  • func (p *Program) Goroutines() ([]*debug.Goroutine, error)
  • func (p *Program) Kill() (debug.Status, error)
  • func (p *Program) MapElement(m debug.Map, index uint64) (debug.Var, debug.Var, error)
  • func (p *Program) Open(name string, mode string) (debug.File, error)
  • func (p *Program) Resume() (debug.Status, error)
  • func (p *Program) Run(args ...string) (debug.Status, error)
  • func (p *Program) Stop() (debug.Status, error)
  • func (p *Program) Value(v debug.Var) (debug.Value, error)
  • func (p *Program) VarByName(name string) (debug.Var, error)

Variables

var DebugproxyCmd = "debugproxy"

DebugproxyCmd is the path to the debugproxy command. It is a variable in case the default value, "debugproxy", is not in the $PATH.

Types

type File

type File struct {
	// contains filtered or unexported fields
}

File implements the debug.File interface, providing access to file-like resources associated with the target program.

func (*File) Close

func (f *File) Close() error

func (*File) ReadAt

func (f *File) ReadAt(p []byte, offset int64) (int, error)

func (*File) WriteAt

func (f *File) WriteAt(p []byte, offset int64) (int, error)

type Program

type Program struct {
	// contains filtered or unexported fields
}

Program implements the debug.Program interface. Through that interface it provides access to a program being debugged on a possibly remote machine by communicating with a debugproxy adjacent to the target program.

func New

func New(host string, textFile string) (*Program, error)

New connects to the specified host using SSH, starts DebugproxyCmd there, and creates a new program from the specified file. The program can then be started by the Run method.

func (*Program) Breakpoint

func (p *Program) Breakpoint(address uint64) ([]uint64, error)

func (*Program) BreakpointAtFunction

func (p *Program) BreakpointAtFunction(name string) ([]uint64, error)

func (*Program) BreakpointAtLine

func (p *Program) BreakpointAtLine(file string, line uint64) ([]uint64, error)

func (*Program) DeleteBreakpoints

func (p *Program) DeleteBreakpoints(pcs []uint64) error

func (*Program) Eval

func (p *Program) Eval(expr string) ([]string, error)

func (*Program) Evaluate

func (p *Program) Evaluate(e string) (debug.Value, error)

func (*Program) Frames

func (p *Program) Frames(count int) ([]debug.Frame, error)

func (*Program) Goroutines

func (p *Program) Goroutines() ([]*debug.Goroutine, error)

func (*Program) Kill

func (p *Program) Kill() (debug.Status, error)

func (*Program) MapElement

func (p *Program) MapElement(m debug.Map, index uint64) (debug.Var, debug.Var, error)

func (*Program) Open

func (p *Program) Open(name string, mode string) (debug.File, error)

func (*Program) Resume

func (p *Program) Resume() (debug.Status, error)

func (*Program) Run

func (p *Program) Run(args ...string) (debug.Status, error)

func (*Program) Stop

func (p *Program) Stop() (debug.Status, error)

func (*Program) Value

func (p *Program) Value(v debug.Var) (debug.Value, error)

func (*Program) VarByName

func (p *Program) VarByName(name string) (debug.Var, error)