Repository navigation
Home
github-actions[bot] edited this page Nov 20, 2026
·
4 revisions
Welcome to the GridLock documentation wiki, synchronized automatically from docs/ on master.

- Installation and Building: Linux dependencies (Arch, Ubuntu/Debian, Fedora), AppImage usage on Wayland and X11, Meson/Ninja build, tutorial compilation, and CLI options.
-
Quickstart and Workflows: Launching local MPI jobs, attaching to live
/procOpenMPI/MPICH/SLURM jobs (Ctrl+Alt+P), debuggingqemu-user -gandgdbservertargets (target remote), and importing#SBATCHscripts. -
Tutorials Walkthrough: Step-by-step exercises for all 8 primary C++ MPI showcase programs (including
catchpoint_exceptions.cpp) and 5 auxiliary demos intutorial/.
-
Keyboard Shortcuts and Quick Reference: Scannable lookup tables for execution controls (
nexti,Ctrl+F10, PC jump, early return), Command Palette prefixes (>,@,#), floating tools (Ctrl+Alt+C/G/S/K/P), breakpoint lifecycle, GDB readline bindings, and CFG shortcuts. -
User Manual: UI and Debugging: Perspectives (
Alt+1..3), Command Palette, non-linear execution, non-destructive/temporary/regex breakpoints,SignalCatchpointDialog(Ctrl+Alt+S),CheckpointDialog(Ctrl+Alt+K), andGdbConsoleWidgetreadline ergonomics. -
MPI Diagnostics and HPC Analysis: MPMD FIFO coordinator mechanics,
ServerRackView,DeadlockAnalyzer,MpiNetworkLogWidget,DifferentialGridoutlier highlighting, andPackage Manager(spack,dnf,pacman,apt). -
Memory, Reverse Engineering, and Profiling:
MemView(process_vm_readv,Diff Ranks,Export),MemoryProfilerWidget(smaps+LD_PRELOADheap callers),ProgrammerCalculatorDialog(Ctrl+Alt+C),ArrayPlotDialog(Ctrl+Alt+G), persistentPointerGraphDialog,DisassemblyView(2D CFG + Decompiler + Xrefs +Alt+Ppatching), andRegisterView. -
Configuration and Customization:
PreferencesDialog, 12 built-in dark and light theme palettes,config.tomland.gridlock/session files, and build auto-detection.
- Developer Architecture and Testing: Repository structure, coordinator and lazy-loading startup architecture, QSS disk cache, all 22 Meson test suites, coverage, and screenshot generation.
-
Engineering Roadmap: Completed
v0.8.7deliverables and planned milestones fromv0.8.8throughv1.0.0.
GridLock Repository | Releases | Report an Issue | Roadmap | Accessibility | License (MIT)
Documentation mirrored from docs/ on master.
Getting Started
User Reference
- Keyboard Shortcuts
- UI & Debugging Manual
- MPI Diagnostics & HPC
- Memory, RE & Profiling
- Configuration & Themes
Internals & Plan