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
56
57
58
59
60
61
62
63
64
|
"""
GDB Python script for debugging raisernics under QEMU.
Usage:
1. Terminal 1: ./tools/qemu.sh --debug
2. Terminal 2: gdb -x tools/debug-kernel.py target/x86_64-unknown-uefi/debug/raisernics.efi
"""
import gdb
import os
# Find the kernel binary
script_dir = os.path.dirname(os.path.abspath(__file__))
project_root = os.path.dirname(script_dir)
binary = os.path.join(
project_root,
"target/x86_64-unknown-uefi/debug/raisernics.efi"
)
# Connect to QEMU's GDB stub
gdb.execute("target remote :1234")
# Load the binary (add symbol table)
if os.path.exists(binary):
gdb.execute(f"symbol-file {binary}")
print(f"Loaded symbols from {binary}")
else:
print(f"WARNING: {binary} not found. Build with debug symbols first.")
gdb.execute("set breakpoint pending on")
# Helper commands
class DumpBootServices(gdb.Command):
"""Dump EFI boot services signature and key pointers"""
def __init__(self):
super().__init__("dump-bs", gdb.COMMAND_USER)
def invoke(self, argument, from_tty):
del argument, from_tty
gdb.execute("printf \"SystemTable, BootServices, and key function pointers\\n\"")
gdb.execute("info functions efi_main")
class DumpGop(gdb.Command):
"""Dump GOP framebuffer info"""
def __init__(self):
super().__init__("dump-gop", gdb.COMMAND_USER)
def invoke(self, argument, from_tty):
del argument, from_tty
gdb.execute("printf \"Check the gop::Framebuffer static\\n\"")
DumpBootServices()
DumpGop()
print("")
print("raisernics GDB session ready.")
print(" target remote :1234 (connected)")
print(" Commands: continue, stepi, bt, info registers, etc.")
print(" Custom: dump-bs, dump-gop")
|
