# gfunkmonk/nt35src architecture

> Architecture diagram of the GitHub repository gfunkmonk/nt35src, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/gfunkmonk/nt35src
- Repository: https://github.com/gfunkmonk/nt35src

## Overview

This is a source collection spanning unrelated Windows NT tools and libraries, not one integrated application. The clearest user-facing workflow is invoking the command-line debugger, configuring or creating a debug session, then processing debug events and commands. Separate branches cover the m4 macro processor, Expat XML parsing, and MSTest file-list processing; the source excerpts do not establish runtime links between these products. The graph uses the supplied index and excerpts for relationships; unsampled behavior is not inferred.

Main entry points: [`NTOSBE/src/sdktools/debuggers/condbg/engine.cpp`](https://github.com/gfunkmonk/nt35src/blob/main/NTOSBE/src/sdktools/debuggers/condbg/engine.cpp) (Debugger Glue), [`NTOSBE/src/sdktools/debuggers/condbg/main.cpp`](https://github.com/gfunkmonk/nt35src/blob/main/NTOSBE/src/sdktools/debuggers/condbg/main.cpp) (Debugger CLI), [`NTOSBE/src/sdktools/debuggers/windbg/engine.cpp`](https://github.com/gfunkmonk/nt35src/blob/main/NTOSBE/src/sdktools/debuggers/windbg/engine.cpp) (WinDbg Engine), [`NTOSBE/src/sdktools/m4/main.c`](https://github.com/gfunkmonk/nt35src/blob/main/NTOSBE/src/sdktools/m4/main.c) (m4 Driver)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_debug["Debuggers"]
  node_cli["Debugger CLI<br/>[main.cpp]"]
  node_engine["Debugger Glue<br/>[engine.cpp]"]
  node_console["Console I/O<br/>[conio.hpp]"]
  node_windbg["WinDbg Engine<br/>[engine.cpp]"]
end

subgraph group_preprocess["Text Processing"]
  node_m4main["m4 Driver<br/>[main.c]"]
  node_m4core["m4 Language Core<br/>[m4.h]"]
  node_xmlparse["XML Parser<br/>[xmlparse.c]"]
  node_xmltoken["XML Tokenizer<br/>[xmltok_impl.c]"]
end

subgraph group_test["Test Support"]
  node_filelist["File-List Engine<br/>[FLENGINE.C]"]
end

subgraph group_shared["Platform Interfaces"]
  node_nmakeglobals["NMAKE Globals<br/>[globals.h]"]
  node_gdiinterface["GDI Engine Interface<br/>[ENGINE.H]"]
end

node_user(("Debugger User"))
node_debugapi["Debug Engine API"]

node_user -->|"runs"| node_cli
node_cli -->|"creates session"| node_engine
node_engine -->|"uses I/O"| node_console
node_engine -.->|"controls session"| node_debugapi
node_windbg -.->|"uses interfaces"| node_debugapi
node_m4main -->|"uses definitions"| node_m4core
node_xmlparse -->|"uses tokenizer"| node_xmltoken

click node_cli "https://github.com/gfunkmonk/nt35src/blob/main/NTOSBE/src/sdktools/debuggers/condbg/main.cpp"
click node_engine "https://github.com/gfunkmonk/nt35src/blob/main/NTOSBE/src/sdktools/debuggers/condbg/engine.cpp"
click node_console "https://github.com/gfunkmonk/nt35src/blob/main/NTOSBE/src/sdktools/debuggers/condbg/conio.hpp"
click node_windbg "https://github.com/gfunkmonk/nt35src/blob/main/NTOSBE/src/sdktools/debuggers/windbg/engine.cpp"
click node_m4main "https://github.com/gfunkmonk/nt35src/blob/main/NTOSBE/src/sdktools/m4/main.c"
click node_m4core "https://github.com/gfunkmonk/nt35src/blob/main/NTOSBE/src/sdktools/m4/m4.h"
click node_xmlparse "https://github.com/gfunkmonk/nt35src/blob/main/NTOSBE/tools/x86/perl/site/lib/xml/parser/expat/xmlparse/xmlparse.c"
click node_xmltoken "https://github.com/gfunkmonk/nt35src/blob/main/NTOSBE/tools/x86/perl/site/lib/xml/parser/expat/xmltok/xmltok_impl.c"
click node_filelist "https://github.com/gfunkmonk/nt35src/blob/main/NT/PRIVATE/SDKTOOLS/MSTEST/NTDRVR/SRC/FLENGINE.C"
click node_nmakeglobals "https://github.com/gfunkmonk/nt35src/blob/main/NTOSBE/src/sdktools/nmake/globals.h"
click node_gdiinterface "https://github.com/gfunkmonk/nt35src/blob/main/NT/PRIVATE/WINDOWS/GDI/GRE/ENGINE.H"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_cli,node_engine,node_console,node_windbg,node_user toneBlue
class node_m4main,node_m4core,node_xmlparse,node_xmltoken toneAmber
class node_filelist,node_debugapi toneMint
class node_nmakeglobals,node_gdiinterface toneRose
```

## Components

### Debuggers

- [Debugger CLI](https://github.com/gfunkmonk/nt35src/blob/main/NTOSBE/src/sdktools/debuggers/condbg/main.cpp): `NTOSBE/src/sdktools/debuggers/condbg/main.cpp`
- [Debugger Glue](https://github.com/gfunkmonk/nt35src/blob/main/NTOSBE/src/sdktools/debuggers/condbg/engine.cpp): `NTOSBE/src/sdktools/debuggers/condbg/engine.cpp`
- [Console I/O](https://github.com/gfunkmonk/nt35src/blob/main/NTOSBE/src/sdktools/debuggers/condbg/conio.hpp): `NTOSBE/src/sdktools/debuggers/condbg/conio.hpp`
- [WinDbg Engine](https://github.com/gfunkmonk/nt35src/blob/main/NTOSBE/src/sdktools/debuggers/windbg/engine.cpp): `NTOSBE/src/sdktools/debuggers/windbg/engine.cpp`

### Text Processing

- [m4 Driver](https://github.com/gfunkmonk/nt35src/blob/main/NTOSBE/src/sdktools/m4/main.c): `NTOSBE/src/sdktools/m4/main.c`
- [m4 Language Core](https://github.com/gfunkmonk/nt35src/blob/main/NTOSBE/src/sdktools/m4/m4.h): `NTOSBE/src/sdktools/m4/m4.h`
- [XML Parser](https://github.com/gfunkmonk/nt35src/blob/main/NTOSBE/tools/x86/perl/site/lib/xml/parser/expat/xmlparse/xmlparse.c): `NTOSBE/tools/x86/perl/site/lib/xml/parser/expat/xmlparse/xmlparse.c`
- [XML Tokenizer](https://github.com/gfunkmonk/nt35src/blob/main/NTOSBE/tools/x86/perl/site/lib/xml/parser/expat/xmltok/xmltok_impl.c): `NTOSBE/tools/x86/perl/site/lib/xml/parser/expat/xmltok/xmltok_impl.c`

### Test Support

- [File-List Engine](https://github.com/gfunkmonk/nt35src/blob/main/NT/PRIVATE/SDKTOOLS/MSTEST/NTDRVR/SRC/FLENGINE.C): `NT/PRIVATE/SDKTOOLS/MSTEST/NTDRVR/SRC/FLENGINE.C`

### Platform Interfaces

- [NMAKE Globals](https://github.com/gfunkmonk/nt35src/blob/main/NTOSBE/src/sdktools/nmake/globals.h): `NTOSBE/src/sdktools/nmake/globals.h`
- [GDI Engine Interface](https://github.com/gfunkmonk/nt35src/blob/main/NT/PRIVATE/WINDOWS/GDI/GRE/ENGINE.H): `NT/PRIVATE/WINDOWS/GDI/GRE/ENGINE.H`

### Other components

- **Debugger User**
- **Debug Engine API**

## Connections

- Debugger User → Debugger CLI: runs (evidence: `NTOSBE/src/sdktools/debuggers/condbg/main.cpp`)
- Debugger CLI → Debugger Glue: creates session (evidence: `NTOSBE/src/sdktools/debuggers/condbg/main.cpp`)
- Debugger Glue → Console I/O: uses I/O (evidence: `NTOSBE/src/sdktools/debuggers/condbg/engine.cpp`)
- Debugger Glue → Debug Engine API: controls session
- WinDbg Engine → Debug Engine API: uses interfaces
- m4 Driver → m4 Language Core: uses definitions (evidence: `NTOSBE/src/sdktools/m4/main.c`)
- XML Parser → XML Tokenizer: uses tokenizer (evidence: `NTOSBE/tools/x86/perl/site/lib/xml/parser/expat/xmlparse/xmlparse.c`)
