# lowlevel-eu/tyndur architecture

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

- Interactive diagram: https://gitdiagram.com/lowlevel-eu/tyndur
- Repository: https://github.com/lowlevel-eu/tyndur

## Overview

This tree is the tyndur operating system: a kernel, user-space services and libraries, and loadable drivers and applications. A representative workflow is a storage driver exposing a device through CDI storage support, which discovers partitions and makes resources available to filesystem services such as FAT; userspace clients can then use LostIO streams. The tree also shows process management, networking, service management, and desktop-oriented components. The README is empty, and most source is unsampled, so unverified subsystem links are omitted rather than inferred.

Main entry points: [`src/modules/lib/lostio/lostio.c`](https://github.com/lowlevel-eu/tyndur/blob/main/src/modules/lib/lostio/lostio.c) (LostIO Services), [`src/modules/lib/posix/exec.c`](https://github.com/lowlevel-eu/tyndur/blob/main/src/modules/lib/posix/exec.c) (User Libraries), [`src/modules/tcpip/main.c`](https://github.com/lowlevel-eu/tyndur/blob/main/src/modules/tcpip/main.c) (TCP/IP Stack), [`src/kernel/src/init.c`](https://github.com/lowlevel-eu/tyndur/blob/main/src/kernel/src/init.c) (Kernel Core)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_kernel["Kernel"]
  node_kernel_core["Kernel Core<br/>[init.c]"]
  node_processes["Process Management<br/>[pm.c]"]
  node_memory["Virtual Memory<br/>[mm_context.c]"]
  node_syscalls["System Calls<br/>[syscall.c]"]
  node_kernel_lio["Kernel LostIO<br/>[client.c]"]
end

subgraph group_io["I/O Services"]
  node_module_lio["LostIO Services<br/>[lostio.c]"]
  node_fat["FAT Filesystem<br/>[main.c]"]
  node_file_service["File Service<br/>[server.c]"]
  node_storage["Storage Integration<br/>[storage.c]"]
  node_servmgr["Service Manager<br/>[main.c]"]
  node_tcpip["TCP/IP Stack<br/>[main.c]"]
end

subgraph group_drivers["Drivers"]
  node_cdi["Driver Interface<br/>[cdi.c]"]
  node_disk_drivers["Disk Drivers<br/>[main.c]"]
  node_network_drivers["Network Drivers<br/>[main.c]"]
  node_usb["USB Subsystem<br/>[main.c]"]
end

subgraph group_userland["Userland"]
  node_user_libs["User Libraries<br/>[exec.c]"]
  node_shell["Shell<br/>[shell.c]"]
  node_desktop["Desktop<br/>[main.c]"]
  node_network_tools["Network Applications<br/>[main.c]"]
  node_c_runtime["C Runtime<br/>[malloc.c]"]
end

node_user(("User"))

node_kernel_core -.->|"initializes"| node_processes
node_kernel_core -.->|"initializes"| node_memory
node_syscalls -.->|"dispatches"| node_processes
node_kernel_lio -.->|"serves"| node_module_lio
node_module_lio -->|"routes requests"| node_fat
node_storage -->|"registers resources"| node_module_lio
node_storage -.->|"reads device blocks"| node_disk_drivers
node_disk_drivers -->|"implements driver API"| node_cdi
node_servmgr -->|"initializes interface"| node_module_lio
node_servmgr -->|"starts services"| node_user
node_tcpip -->|"registers drivers"| node_network_drivers
node_tcpip -->|"initializes interface"| node_module_lio
node_user -.->|"interacts"| node_shell
node_shell -.->|"accesses resources"| node_module_lio
node_network_tools -.->|"uses networking"| node_tcpip
node_desktop -.->|"uses"| node_user_libs
node_user_libs -.->|"invokes"| node_syscalls
node_user_libs -.->|"uses"| node_c_runtime
node_usb -.->|"uses driver interface"| node_cdi

click node_kernel_core "https://github.com/lowlevel-eu/tyndur/blob/main/src/kernel/src/init.c"
click node_processes "https://github.com/lowlevel-eu/tyndur/blob/main/src/kernel/src/tasks/pm.c"
click node_memory "https://github.com/lowlevel-eu/tyndur/blob/main/src/kernel/src/arch/i386/mm/mm_context.c"
click node_syscalls "https://github.com/lowlevel-eu/tyndur/blob/main/src/kernel/src/syscall.c"
click node_kernel_lio "https://github.com/lowlevel-eu/tyndur/blob/main/src/kernel/src/lostio/client.c"
click node_module_lio "https://github.com/lowlevel-eu/tyndur/blob/main/src/modules/lib/lostio/lostio.c"
click node_fat "https://github.com/lowlevel-eu/tyndur/blob/main/src/modules/fat/main.c"
click node_file_service "https://github.com/lowlevel-eu/tyndur/blob/main/src/modules/file/server.c"
click node_storage "https://github.com/lowlevel-eu/tyndur/blob/main/src/modules/cdi/lib/storage.c"
click node_servmgr "https://github.com/lowlevel-eu/tyndur/blob/main/src/modules/servmgr/main.c"
click node_tcpip "https://github.com/lowlevel-eu/tyndur/blob/main/src/modules/tcpip/main.c"
click node_cdi "https://github.com/lowlevel-eu/tyndur/blob/main/src/modules/cdi/lib/cdi.c"
click node_disk_drivers "https://github.com/lowlevel-eu/tyndur/blob/main/src/modules/cdi/ahci/main.c"
click node_network_drivers "https://github.com/lowlevel-eu/tyndur/blob/main/src/modules/cdi/e1000/main.c"
click node_usb "https://github.com/lowlevel-eu/tyndur/blob/main/src/modules/usb/uhci/main.c"
click node_user_libs "https://github.com/lowlevel-eu/tyndur/blob/main/src/modules/lib/posix/exec.c"
click node_shell "https://github.com/lowlevel-eu/tyndur/blob/main/src/modules/c/shell/shell.c"
click node_desktop "https://github.com/lowlevel-eu/tyndur/blob/main/src/modules/c/desktop/main.c"
click node_network_tools "https://github.com/lowlevel-eu/tyndur/blob/main/src/modules/c/ftp/main.c"
click node_c_runtime "https://github.com/lowlevel-eu/tyndur/blob/main/src/lib/stdlibc/malloc.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_core,node_processes,node_memory,node_syscalls,node_kernel_lio,node_user toneBlue
class node_module_lio,node_fat,node_file_service,node_storage,node_servmgr,node_tcpip toneAmber
class node_cdi,node_disk_drivers,node_network_drivers,node_usb toneMint
class node_user_libs,node_shell,node_desktop,node_network_tools,node_c_runtime toneRose
```

## Components

### Kernel

- [Kernel Core](https://github.com/lowlevel-eu/tyndur/blob/main/src/kernel/src/init.c): `src/kernel/src/init.c`
- [Process Management](https://github.com/lowlevel-eu/tyndur/blob/main/src/kernel/src/tasks/pm.c): `src/kernel/src/tasks/pm.c`
- [Virtual Memory](https://github.com/lowlevel-eu/tyndur/blob/main/src/kernel/src/arch/i386/mm/mm_context.c): `src/kernel/src/arch/i386/mm/mm_context.c`
- [System Calls](https://github.com/lowlevel-eu/tyndur/blob/main/src/kernel/src/syscall.c): `src/kernel/src/syscall.c`
- [Kernel LostIO](https://github.com/lowlevel-eu/tyndur/blob/main/src/kernel/src/lostio/client.c): `src/kernel/src/lostio/client.c`

### I/O Services

- [LostIO Services](https://github.com/lowlevel-eu/tyndur/blob/main/src/modules/lib/lostio/lostio.c): `src/modules/lib/lostio/lostio.c`
- [FAT Filesystem](https://github.com/lowlevel-eu/tyndur/blob/main/src/modules/fat/main.c): `src/modules/fat/main.c`
- [File Service](https://github.com/lowlevel-eu/tyndur/blob/main/src/modules/file/server.c): `src/modules/file/server.c`
- [Storage Integration](https://github.com/lowlevel-eu/tyndur/blob/main/src/modules/cdi/lib/storage.c): `src/modules/cdi/lib/storage.c`
- [Service Manager](https://github.com/lowlevel-eu/tyndur/blob/main/src/modules/servmgr/main.c): `src/modules/servmgr/main.c`
- [TCP/IP Stack](https://github.com/lowlevel-eu/tyndur/blob/main/src/modules/tcpip/main.c): `src/modules/tcpip/main.c`

### Drivers

- [Driver Interface](https://github.com/lowlevel-eu/tyndur/blob/main/src/modules/cdi/lib/cdi.c): `src/modules/cdi/lib/cdi.c`
- [Disk Drivers](https://github.com/lowlevel-eu/tyndur/blob/main/src/modules/cdi/ahci/main.c): `src/modules/cdi/ahci/main.c`
- [Network Drivers](https://github.com/lowlevel-eu/tyndur/blob/main/src/modules/cdi/e1000/main.c): `src/modules/cdi/e1000/main.c`
- [USB Subsystem](https://github.com/lowlevel-eu/tyndur/blob/main/src/modules/usb/uhci/main.c): `src/modules/usb/uhci/main.c`

### Userland

- [User Libraries](https://github.com/lowlevel-eu/tyndur/blob/main/src/modules/lib/posix/exec.c): `src/modules/lib/posix/exec.c`
- [Shell](https://github.com/lowlevel-eu/tyndur/blob/main/src/modules/c/shell/shell.c): `src/modules/c/shell/shell.c`
- [Desktop](https://github.com/lowlevel-eu/tyndur/blob/main/src/modules/c/desktop/main.c): `src/modules/c/desktop/main.c`
- [Network Applications](https://github.com/lowlevel-eu/tyndur/blob/main/src/modules/c/ftp/main.c): `src/modules/c/ftp/main.c`
- [C Runtime](https://github.com/lowlevel-eu/tyndur/blob/main/src/lib/stdlibc/malloc.c): `src/lib/stdlibc/malloc.c`

### Other components

- **User**

## Connections

- Kernel Core → Process Management: initializes
- Kernel Core → Virtual Memory: initializes
- System Calls → Process Management: dispatches
- Kernel LostIO → LostIO Services: serves
- LostIO Services → FAT Filesystem: routes requests (evidence: `src/modules/fat/main.c`)
- Storage Integration → LostIO Services: registers resources (evidence: `src/modules/cdi/lib/storage.c`)
- Storage Integration → Disk Drivers: reads device blocks
- Disk Drivers → Driver Interface: implements driver API (evidence: `src/modules/cdi/ahci/main.c`)
- Service Manager → LostIO Services: initializes interface (evidence: `src/modules/servmgr/main.c`)
- Service Manager → User: starts services (evidence: `src/modules/servmgr/main.c`)
- TCP/IP Stack → Network Drivers: registers drivers (evidence: `src/modules/tcpip/main.c`)
- TCP/IP Stack → LostIO Services: initializes interface (evidence: `src/modules/tcpip/main.c`)
- User → Shell: interacts
- Shell → LostIO Services: accesses resources
- Network Applications → TCP/IP Stack: uses networking
- Desktop → User Libraries: uses
- User Libraries → System Calls: invokes
- User Libraries → C Runtime: uses
- USB Subsystem → Driver Interface: uses driver interface
