blob: 1be6dd67b29f78f0e45f944984b4dccf26761e62 (
plain) (
blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
|
gdbstub
=======
This is a simple gdb stub that can be easily dropped in to your project. It has
no library dependencies (such as libc) and requires just standard tools to
build.
Protocol
--------
Communication between the stub and the debugger takes place via the [gdb
Remote Serial Protocol](https://sourceware.org/gdb/onlinedocs/gdb/Remote-Protocol.html).
Porting
-------
This was developed for x86 systems, but it's fairly modular. With a little
effort, it can be easily ported to other platforms. You will need to modify
`gdbstub_sys.h` and `gdbstub_sys.c` to fit your platform's needs accordingly.
Building
--------
Running `make` produces ELF binary `gdbstub.elf` with an entry point
(`dbg_start`) that will simply hook the current IDT (to support debug
interrupts) and break.
Additionally, a simple flat binary `gdbstub.bin` is created from the ELF binary.
The intent for this flat binary is to be trivially loaded and jumped to.
Demo
----
To test the GDB stub out, you can launch an instance of the full-system emulator
[QEMU](https://www.qemu.org/) as follows:
qemu-system-i386 -serial tcp:127.0.0.1:1234,server -display none -kernel gdbstub.elf
This will launch QEMU, create a virtual serial port that can be connected to
through local TCP port 1234, then load and run the stub executable.
You can then launch GDB with the `demo.gdbinit` script to get your GDB client
to connect to the virtual serial port and begin debugging the demo application:
gdb --command=demo.gdbinit
For example, step a couple of times and print out the value of `x`:
(gdb) s 2
(gdb) p/x x
$1 = 0xdeadbeef
(gdb)
License
-------
This software is published under the terms of the MIT License. See `LICENSE.txt`
for full license.
Matt Borgerson, 2016-2019
|
