amiga-bootcamp/13_toolchain/debugging.md

63 lines
1.4 KiB
Markdown
Raw Normal View History

[← Home](../README.md) · [Toolchain](README.md)
# Debugging Tools — BareFoot, wack, GDB Remote
## Overview
Debugging Amiga programs ranges from ROM-resident kernel debuggers (wack/SAD) through software monitors to modern cross-debugging via GDB stubs.
---
## Tool Comparison
| Tool | Type | Target | Best for |
|---|---|---|---|
| BareFoot | Serial debugger | Real hardware / UAE | OS-level, Exec kernel |
| wack/SAD | ROM debugger | Real hardware | Boot-time, crash analysis |
| MonAm | Software monitor | AmigaOS | Breakpoints, disassembly |
| IDA Pro | Static + remote | Cross-platform | Static RE, decompilation |
| GDB (m68k-elf-gdb) | Cross-debugger | FS-UAE / Basilisk | Source-level C debugging |
| Enforcer | Memory watchdog | AmigaOS (68020+) | Illegal memory access detection |
| MuForce | Memory watchdog | AmigaOS (68040+) | Same as Enforcer for 040/060 |
---
## Enforcer / MuForce
Detects invalid memory accesses using MMU:
```
Enforcer Hit! $0000000C read by task "myapp" at $00020456
```
```
; Install:
run >NIL: Enforcer
; or for 040/060:
run >NIL: MuForce
```
---
## FS-UAE GDB Debugging
```bash
# In fs-uae.conf:
remote_debugger = 1
remote_debugger_port = 6860
# Connect from host:
m68k-elf-gdb myapp
(gdb) target remote localhost:6860
(gdb) break main
(gdb) continue
```
---
## References
- BareFoot: Aminet `dev/debug/BareFoot.lha`
- Enforcer: Aminet `dev/debug/Enforcer.lha`
- MuForce: Aminet `dev/debug/MuForce.lha`