67 lines
1.5 KiB
Go
67 lines
1.5 KiB
Go
// Copyright (c) 2026 Petr Balvín <opensource@petrbalvin.org> (https://petrbalvin.org)
|
|
// SPDX-License-Identifier: BSD-3-Clause
|
|
|
|
//go:build linux || (freebsd && (amd64 || arm64 || riscv64))
|
|
|
|
package debug
|
|
|
|
// tracer abstracts the minimal ptrace operations needed by the breakpoint
|
|
// manager and the stop-information helpers. The live implementation is
|
|
// *Session (ptrace_linux_amd64.go); tests supply a mock.
|
|
type tracer interface {
|
|
Peek(addr uint64) (uint64, error)
|
|
Poke(addr uint64, val uint64) error
|
|
SetRegs(regs *Regs) error
|
|
Step() error
|
|
Pid() int
|
|
}
|
|
|
|
// mockTracer records Peek/Poke/Step calls and provides fake register state.
|
|
type mockTracer struct {
|
|
mem map[uint64]byte
|
|
peeks []uint64
|
|
pokes []struct {
|
|
addr uint64
|
|
val uint64
|
|
}
|
|
steps int
|
|
regs *Regs
|
|
}
|
|
|
|
func newMockTracer() *mockTracer {
|
|
return &mockTracer{
|
|
mem: make(map[uint64]byte),
|
|
regs: &Regs{},
|
|
}
|
|
}
|
|
|
|
func (m *mockTracer) Peek(addr uint64) (uint64, error) {
|
|
m.peeks = append(m.peeks, addr)
|
|
var val uint64
|
|
for i := range uint64(8) {
|
|
val |= uint64(m.mem[addr+i]) << (i * 8)
|
|
}
|
|
return val, nil
|
|
}
|
|
|
|
func (m *mockTracer) Poke(addr uint64, val uint64) error {
|
|
m.pokes = append(m.pokes, struct {
|
|
addr uint64
|
|
val uint64
|
|
}{addr, val})
|
|
for i := range uint64(8) {
|
|
m.mem[addr+i] = byte(val >> (i * 8))
|
|
}
|
|
return nil
|
|
}
|
|
|
|
func (m *mockTracer) SetRegs(regs *Regs) error {
|
|
m.regs = regs
|
|
return nil
|
|
}
|
|
func (m *mockTracer) Step() error {
|
|
m.steps++
|
|
return nil
|
|
}
|
|
func (m *mockTracer) Pid() int { return 42 }
|