# keyzm/dlltoshellcode architecture

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

- Interactive diagram: https://gitdiagram.com/keyzm/dlltoshellcode
- Repository: https://github.com/keyzm/dlltoshellcode

## Overview

DllToShellCode is a Windows utility that converts DLLs into shellcode, optionally compressing the result and selecting a payload mode. The documented workflow is CLI input → DLL-to-shellcode conversion → optional compression → generated shellcode; it also supports binary-to-hex and standalone file compression. The repository includes separate main, Ntdll, and aPLib shellcode projects. The CLI and payload-project entry points were not sampled, so their connections are documented at the README level; no unverified internal call sequence is asserted.

Main entry points: [`DllToShellCode/DllToShellCode.c`](https://github.com/keyzm/dlltoshellcode/blob/master/DllToShellCode/DllToShellCode.c) (DLL converter), [`DllToShellCode/compress.c`](https://github.com/keyzm/dlltoshellcode/blob/master/DllToShellCode/compress.c) (Compression routines), [`ShellCode_Main/shellcode_base.c`](https://github.com/keyzm/dlltoshellcode/blob/master/ShellCode_Main/shellcode_base.c) (Main resolver helpers), [`ShellCode_Ntdll/shellcode_base.c`](https://github.com/keyzm/dlltoshellcode/blob/master/ShellCode_Ntdll/shellcode_base.c) (Ntdll resolver helpers)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_conversion["Conversion CLI"]
  node_converter["DLL converter<br/>[DllToShellCode.c]"]
end

subgraph group_payloads["Shellcode Payloads"]
  node_payload_data["Payload byte arrays<br/>[shellcode_data.c]"]
  node_payload_api["Payload accessors<br/>[shellcode_data.h]"]
  node_main_payload["Main shellcode<br/>[ShellCode_Main.c]"]
  node_ntdll_payload["Ntdll shellcode<br/>[ShellCode_Ntdll.c]"]
  node_aplib_payload["aPLib shellcode<br/>[ShellCode_Aplib.c]"]
end

subgraph group_compression["Compression"]
  node_compressor["Compression routines<br/>[compress.c]"]
  node_aplib["aPLib interface<br/>[aplib.h]"]
end

subgraph group_resolver["Runtime Resolution"]
  node_main_helpers["Main resolver helpers<br/>[shellcode_base.c]"]
  node_ntdll_helpers["Ntdll resolver helpers<br/>[shellcode_base.c]"]
end

node_user(("CLI user"))
node_windows["Windows APIs"]

node_user -->|"invokes CLI"| node_converter
node_converter -.->|"may compress"| node_compressor
node_compressor -->|"calls aP_pack"| node_aplib
node_converter -.->|"selects payload"| node_payload_data
node_payload_api -->|"exposes accessors"| node_payload_data
node_main_payload -.->|"uses helpers"| node_main_helpers
node_ntdll_payload -.->|"uses helpers"| node_ntdll_helpers
node_main_helpers -.->|"resolves APIs"| node_windows
node_ntdll_helpers -.->|"resolves APIs"| node_windows

click node_converter "https://github.com/keyzm/dlltoshellcode/blob/master/DllToShellCode/DllToShellCode.c"
click node_compressor "https://github.com/keyzm/dlltoshellcode/blob/master/DllToShellCode/compress.c"
click node_aplib "https://github.com/keyzm/dlltoshellcode/blob/master/DllToShellCode/aplib.h"
click node_payload_data "https://github.com/keyzm/dlltoshellcode/blob/master/DllToShellCode/shellcode_data.c"
click node_payload_api "https://github.com/keyzm/dlltoshellcode/blob/master/DllToShellCode/shellcode_data.h"
click node_main_payload "https://github.com/keyzm/dlltoshellcode/blob/master/ShellCode_Main/ShellCode_Main.c"
click node_ntdll_payload "https://github.com/keyzm/dlltoshellcode/blob/master/ShellCode_Ntdll/ShellCode_Ntdll.c"
click node_aplib_payload "https://github.com/keyzm/dlltoshellcode/blob/master/ShellCode_Aplib/ShellCode_Aplib.c"
click node_main_helpers "https://github.com/keyzm/dlltoshellcode/blob/master/ShellCode_Main/shellcode_base.c"
click node_ntdll_helpers "https://github.com/keyzm/dlltoshellcode/blob/master/ShellCode_Ntdll/shellcode_base.c"

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_converter,node_user toneBlue
class node_payload_data,node_payload_api,node_main_payload,node_ntdll_payload,node_aplib_payload toneAmber
class node_compressor,node_aplib,node_windows toneMint
class node_main_helpers,node_ntdll_helpers toneRose
```

## Components

### Conversion CLI

- [DLL converter](https://github.com/keyzm/dlltoshellcode/blob/master/DllToShellCode/DllToShellCode.c): `DllToShellCode/DllToShellCode.c`

### Shellcode Payloads

- [Payload byte arrays](https://github.com/keyzm/dlltoshellcode/blob/master/DllToShellCode/shellcode_data.c): `DllToShellCode/shellcode_data.c`
- [Payload accessors](https://github.com/keyzm/dlltoshellcode/blob/master/DllToShellCode/shellcode_data.h): `DllToShellCode/shellcode_data.h`
- [Main shellcode](https://github.com/keyzm/dlltoshellcode/blob/master/ShellCode_Main/ShellCode_Main.c): `ShellCode_Main/ShellCode_Main.c`
- [Ntdll shellcode](https://github.com/keyzm/dlltoshellcode/blob/master/ShellCode_Ntdll/ShellCode_Ntdll.c): `ShellCode_Ntdll/ShellCode_Ntdll.c`
- [aPLib shellcode](https://github.com/keyzm/dlltoshellcode/blob/master/ShellCode_Aplib/ShellCode_Aplib.c): `ShellCode_Aplib/ShellCode_Aplib.c`

### Compression

- [Compression routines](https://github.com/keyzm/dlltoshellcode/blob/master/DllToShellCode/compress.c): `DllToShellCode/compress.c`
- [aPLib interface](https://github.com/keyzm/dlltoshellcode/blob/master/DllToShellCode/aplib.h): `DllToShellCode/aplib.h`

### Runtime Resolution

- [Main resolver helpers](https://github.com/keyzm/dlltoshellcode/blob/master/ShellCode_Main/shellcode_base.c): `ShellCode_Main/shellcode_base.c`
- [Ntdll resolver helpers](https://github.com/keyzm/dlltoshellcode/blob/master/ShellCode_Ntdll/shellcode_base.c): `ShellCode_Ntdll/shellcode_base.c`

### Other components

- **CLI user**
- **Windows APIs**

## Connections

- CLI user → DLL converter: invokes CLI (evidence: `README.md`)
- DLL converter → Compression routines: may compress
- Compression routines → aPLib interface: calls aP_pack (evidence: `DllToShellCode/compress.c`)
- DLL converter → Payload byte arrays: selects payload
- Payload accessors → Payload byte arrays: exposes accessors (evidence: `DllToShellCode/shellcode_data.c`)
- Main shellcode → Main resolver helpers: uses helpers
- Ntdll shellcode → Ntdll resolver helpers: uses helpers
- Main resolver helpers → Windows APIs: resolves APIs
- Ntdll resolver helpers → Windows APIs: resolves APIs
