# ps5-payload-dev/sdk architecture

> Architecture diagram of the GitHub repository ps5-payload-dev/sdk, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ps5-payload-dev/sdk
- Repository: https://github.com/ps5-payload-dev/sdk

## Overview

This repository is an SDK for developing payloads for exploited PS5s. The principal workflow is a payload developer building a payload for execution by a compatible external ELF loader; within the SDK, runtime support includes kernel access and dynamic-library loading, alongside platform headers, SCE stubs, and selected libc implementations. The README documents the developer/loader workflow, while sampled sources show kernel and loader dependencies. Several listed modules were not sampled, so their internal connections are omitted where evidence is unavailable.

Main entry points: [`crt/kernel.c`](https://github.com/ps5-payload-dev/sdk/blob/master/crt/kernel.c) (Kernel access), [`crt/rtld.c`](https://github.com/ps5-payload-dev/sdk/blob/master/crt/rtld.c) (Runtime linker), [`crt/rtld_so.c`](https://github.com/ps5-payload-dev/sdk/blob/master/crt/rtld_so.c) (ELF shared loader), [`crt/rtld_sprx.c`](https://github.com/ps5-payload-dev/sdk/blob/master/crt/rtld_sprx.c) (SPRX loader)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Payload runtime"]
  node_kernel_api["Kernel access<br/>[kernel.c]"]
  node_kernel_iommu["IOMMU support<br/>[kernel_iommu.c]"]
  node_syscalls["Syscall interface<br/>[syscall.c]"]
  node_rtld_core["Runtime linker<br/>[rtld.c]"]
  node_elf_loader_impl["ELF shared loader<br/>[rtld_so.c]"]
  node_sprx_loader["SPRX loader<br/>[rtld_sprx.c]"]
  node_payload_loader["Payload loader<br/>[rtld_payload.c]"]
end

subgraph group_platform["PS5 platform support"]
  node_kernel_headers["Kernel API headers<br/>[kernel.h]"]
  node_nid_encoding["NID encoding<br/>[nid.c]"]
  node_platform_headers["PS5 platform headers<br/>[kernel.h]"]
end

subgraph group_compat["Compatibility libraries"]
  node_sce_stubs["SCE library stubs"]
  node_libc_regex["Regex implementation<br/>[regcomp.c]"]
  node_libc_search["Tree search<br/>[tsearch.c]"]
end

subgraph group_tools["Host tools"]
  node_host_nid["NID host tool<br/>[prospero-nid.c]"]
  node_host_linker["Linker host tool<br/>[prospero-lld.c]"]
end

node_developer(("Payload developer"))
node_elf_loader(("External ELF loader"))

node_developer -->|"runs payloads"| node_elf_loader
node_developer -->|"uses SDK"| node_kernel_api
node_kernel_api -->|"includes support"| node_kernel_iommu
node_kernel_api -->|"uses definitions"| node_kernel_headers
node_kernel_api -->|"encodes symbols"| node_nid_encoding
node_kernel_api -->|"uses syscalls"| node_syscalls
node_elf_loader_impl -->|"uses kernel APIs"| node_kernel_api
node_elf_loader_impl -->|"reads files"| node_syscalls
node_sprx_loader -->|"inspects modules"| node_kernel_api
node_sprx_loader -->|"uses NIDs"| node_nid_encoding
node_payload_loader -.->|"dispatches loading"| node_rtld_core
node_rtld_core -.->|"selects loader"| node_elf_loader_impl
node_rtld_core -.->|"selects loader"| node_sprx_loader
node_host_nid -.->|"supports encoding"| node_nid_encoding

click node_kernel_api "https://github.com/ps5-payload-dev/sdk/blob/master/crt/kernel.c"
click node_kernel_iommu "https://github.com/ps5-payload-dev/sdk/blob/master/crt/kernel_iommu.c"
click node_syscalls "https://github.com/ps5-payload-dev/sdk/blob/master/crt/syscall.c"
click node_rtld_core "https://github.com/ps5-payload-dev/sdk/blob/master/crt/rtld.c"
click node_elf_loader_impl "https://github.com/ps5-payload-dev/sdk/blob/master/crt/rtld_so.c"
click node_sprx_loader "https://github.com/ps5-payload-dev/sdk/blob/master/crt/rtld_sprx.c"
click node_payload_loader "https://github.com/ps5-payload-dev/sdk/blob/master/crt/rtld_payload.c"
click node_kernel_headers "https://github.com/ps5-payload-dev/sdk/blob/master/crt/kernel.h"
click node_nid_encoding "https://github.com/ps5-payload-dev/sdk/blob/master/crt/nid.c"
click node_platform_headers "https://github.com/ps5-payload-dev/sdk/blob/master/include/ps5/kernel.h"
click node_sce_stubs "https://github.com/ps5-payload-dev/sdk/blob/master/sce_stubs/libSceLibcInternal.c"
click node_libc_regex "https://github.com/ps5-payload-dev/sdk/blob/master/libc/regcomp.c"
click node_libc_search "https://github.com/ps5-payload-dev/sdk/blob/master/libc/tsearch.c"
click node_host_nid "https://github.com/ps5-payload-dev/sdk/blob/master/host/bin/prospero-nid.c"
click node_host_linker "https://github.com/ps5-payload-dev/sdk/blob/master/host/win/prospero-lld.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_kernel_api,node_kernel_iommu,node_syscalls,node_rtld_core,node_elf_loader_impl,node_sprx_loader,node_payload_loader toneBlue
class node_kernel_headers,node_nid_encoding,node_platform_headers toneAmber
class node_sce_stubs,node_libc_regex,node_libc_search toneMint
class node_host_nid,node_host_linker toneRose
class node_developer,node_elf_loader toneIndigo
```

## Components

### Payload runtime

- [Kernel access](https://github.com/ps5-payload-dev/sdk/blob/master/crt/kernel.c): `crt/kernel.c`
- [IOMMU support](https://github.com/ps5-payload-dev/sdk/blob/master/crt/kernel_iommu.c): `crt/kernel_iommu.c`
- [Syscall interface](https://github.com/ps5-payload-dev/sdk/blob/master/crt/syscall.c): `crt/syscall.c`
- [Runtime linker](https://github.com/ps5-payload-dev/sdk/blob/master/crt/rtld.c): `crt/rtld.c`
- [ELF shared loader](https://github.com/ps5-payload-dev/sdk/blob/master/crt/rtld_so.c): `crt/rtld_so.c`
- [SPRX loader](https://github.com/ps5-payload-dev/sdk/blob/master/crt/rtld_sprx.c): `crt/rtld_sprx.c`
- [Payload loader](https://github.com/ps5-payload-dev/sdk/blob/master/crt/rtld_payload.c): `crt/rtld_payload.c`

### PS5 platform support

- [Kernel API headers](https://github.com/ps5-payload-dev/sdk/blob/master/crt/kernel.h): `crt/kernel.h`
- [NID encoding](https://github.com/ps5-payload-dev/sdk/blob/master/crt/nid.c): `crt/nid.c`
- [PS5 platform headers](https://github.com/ps5-payload-dev/sdk/blob/master/include/ps5/kernel.h): `include/ps5/kernel.h`

### Compatibility libraries

- [SCE library stubs](https://github.com/ps5-payload-dev/sdk/blob/master/sce_stubs/libSceLibcInternal.c): `sce_stubs/libSceLibcInternal.c`
- [Regex implementation](https://github.com/ps5-payload-dev/sdk/blob/master/libc/regcomp.c): `libc/regcomp.c`
- [Tree search](https://github.com/ps5-payload-dev/sdk/blob/master/libc/tsearch.c): `libc/tsearch.c`

### Host tools

- [NID host tool](https://github.com/ps5-payload-dev/sdk/blob/master/host/bin/prospero-nid.c): `host/bin/prospero-nid.c`
- [Linker host tool](https://github.com/ps5-payload-dev/sdk/blob/master/host/win/prospero-lld.c): `host/win/prospero-lld.c`

### Other components

- **Payload developer**
- **External ELF loader**

## Connections

- Payload developer → External ELF loader: runs payloads
- Payload developer → Kernel access: uses SDK
- Kernel access → IOMMU support: includes support (evidence: `crt/kernel.c`)
- Kernel access → Kernel API headers: uses definitions (evidence: `crt/kernel.c`)
- Kernel access → NID encoding: encodes symbols (evidence: `crt/kernel.c`)
- Kernel access → Syscall interface: uses syscalls (evidence: `crt/kernel.c`)
- ELF shared loader → Kernel access: uses kernel APIs (evidence: `crt/rtld_so.c`)
- ELF shared loader → Syscall interface: reads files (evidence: `crt/rtld_so.c`)
- SPRX loader → Kernel access: inspects modules (evidence: `crt/rtld_sprx.c`)
- SPRX loader → NID encoding: uses NIDs (evidence: `crt/rtld_sprx.c`)
- Payload loader → Runtime linker: dispatches loading
- Runtime linker → ELF shared loader: selects loader
- Runtime linker → SPRX loader: selects loader
- NID host tool → NID encoding: supports encoding
