How vitoplantamura/bugchecker works
BugChecker is an in-place Windows kernel/user debugger: the user enters commands or scripts, the debugger controls execution and inspects machine state through the kernel-debugger interface, then presents results in its UI. The README also documents symbol-file loading and KDCOM installation as setup capabilities. Source excerpts are limited, so edges for major documented behavior cite the README; implementation-level links are included only where the source index or excerpt supports them.
Main entry points: SymLoader.cpp Symbol Loader · Main.cpp Debugger entry · quickjs.c JavaScript runtime · InputLine.cpp Command input
Components 23
Debugger interaction
- Debugger entry
BugChecker/Main.cpp - Debugger state
BugChecker/Root.cpp - Command input
BugChecker/InputLine.cpp - Debugger commands
BugChecker/Cmd.cpp - Script window
BugChecker/CodeWnd.cpp - JavaScript runtime
BugChecker/QuickJS/quickjs.c - JavaScript bridge
BugChecker/QuickJSCppInterface.cpp
Execution control
- Breakpoints and stepping
BugChecker/Main.cpp - Async debugger operations
BugChecker/BcCoroutine.h - KD packet interface
BugChecker/KdCom.h - Kernel/platform access
BugChecker/Platform.cpp
Inspection and symbols
- Disassembly
BugChecker/DisasmWnd.cpp - Registers view
BugChecker/RegsWnd.cpp - Debugger log
BugChecker/LogWnd.cpp - PDB symbols
BugChecker/Symbols.cpp - Symbol-file handling
BugChecker/SymbolFile.cpp
Installation and support
- Symbol Loader
SymLoader/SymLoader.cpp - KDCOM installation
SymLoader/KdcomInstall.cpp - PS/2 keyboard
BugChecker/Ps2Keyb.cpp - Framebuffer output
BugChecker/Platform.cpp
Other components
- Debugger user
- Symbol server
- Windows kernel
Connections 23
- Debugger user → Command input: enters commands
- Debugger user → Script window: writes scripts
- Debugger entry → Debugger state: uses debugger state
BugChecker/Main.cpp - Debugger entry → Kernel/platform access: uses platform
BugChecker/Main.cpp - Command input → Debugger commands: dispatches commands
- Debugger commands → JavaScript bridge: evaluates expressions
- Script window → JavaScript runtime: runs JavaScript
- JavaScript bridge → JavaScript runtime: interfaces with
- JavaScript runtime → Async debugger operations: requests async operations
- Async debugger operations → KD packet interface: issues KD operations
BugChecker/BcCoroutine.h - KD packet interface → Windows kernel: controls debug state
- Breakpoints and stepping → Debugger log: records breakpoint hits
BugChecker/Main.cpp - Breakpoints and stepping → Disassembly: steps instructions
BugChecker/Main.cpp - Debugger user → Registers view: views registers
- Debugger user → Debugger log: views messages
- Debugger user → Disassembly: inspects code
- PDB symbols → Symbol-file handling: uses symbol files
- Symbol Loader → Symbol server: downloads symbols
- Symbol Loader → Symbol-file handling: provides PDB files
- Symbol Loader → KDCOM installation: installs KDCOM
- KDCOM installation → Windows kernel: replaces KDCOM
- PS/2 keyboard → Debugger entry: supplies input
BugChecker/Main.cpp - Kernel/platform access → Framebuffer output: draws interface