# elabbas0/icda architecture

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

- Interactive diagram: https://gitdiagram.com/elabbas0/icda
- Repository: https://github.com/elabbas0/icda

## Overview

ICDA is a modular x86-64 operating system. Its principal runtime path is kernel boot and initialization, starting the userspace init process, then running interactive applications whose kernel-facing operations pass through the syscall dispatcher to OS services. The repository also includes networking with TLS, graphical and text interfaces, audio, and storage/filesystem support. The graph uses boot and syscall excerpts plus SOURCE INDEX references for relationships; several application and subsystem links are indicative only because their source was not sampled.

Main entry points: [`kernel/syscall/syscall.c`](https://github.com/elabbas0/icda/blob/Production/kernel/syscall/syscall.c) (Syscall dispatcher), [`kernel/kernel.c`](https://github.com/elabbas0/icda/blob/Production/kernel/kernel.c) (Kernel boot), [`userspace/init.c`](https://github.com/elabbas0/icda/blob/Production/userspace/init.c) (Userspace init), [`userspace/desktop.c`](https://github.com/elabbas0/icda/blob/Production/userspace/desktop.c) (Desktop)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_boot["Boot and hardware"]
  node_bootseq["Kernel boot<br/>[kernel.c]"]
  node_irq["Interrupt control<br/>[irq_controller.c]"]
  node_drivers["Hardware drivers"]
  node_audio["Audio services"]
end

subgraph group_kernel["Kernel services"]
  node_memory["Memory management"]
  node_scheduler["Process scheduler<br/>[sched.c]"]
  node_loader["User process loader<br/>[user.c]"]
  node_syscalls["Syscall dispatcher<br/>[syscall.c]"]
  node_devnodes["Device nodes<br/>[devnodes.c]"]
  node_ipc["IPC services"]
end

subgraph group_storage["Storage and filesystems"]
  node_vfs["Virtual filesystem<br/>[vfs.h]"]
  node_diskfmt["Disk formats<br/>[diskfmt.c]"]
  node_persist[("Persistent filesystem<br/>[persistfs.c]")]
  node_block["Block storage<br/>[block.h]"]
end

subgraph group_user["Userspace experience"]
  node_init["Userspace init<br/>[init.c]"]
  node_desktop["Desktop<br/>[desktop.c]"]
  node_windowmgr["Window manager<br/>[wm.c]"]
  node_gui["GUI toolkit<br/>[gui.c]"]
  node_shell["Shell and terminal<br/>[shell.c]"]
  node_apps["User applications"]
end

subgraph group_network["Networking"]
  node_netstack["Network stack<br/>[net.c]"]
  node_tls["TLS security<br/>[tls.c]"]
  node_crypto["Cryptography"]
end

node_person(("Computer user"))

node_person -.->|"interacts with"| node_desktop
node_person -.->|"interacts with"| node_shell
node_bootseq -->|"initializes"| node_memory
node_bootseq -->|"initializes"| node_irq
node_bootseq -->|"initializes"| node_drivers
node_bootseq -->|"initializes"| node_vfs
node_bootseq -->|"populates"| node_devnodes
node_bootseq -->|"starts"| node_init
node_bootseq -->|"schedules via"| node_scheduler
node_init -.->|"launches"| node_desktop
node_init -.->|"launches"| node_shell
node_desktop -.->|"uses"| node_windowmgr
node_windowmgr -.->|"uses"| node_gui
node_apps -.->|"requests services"| node_syscalls
node_syscalls -->|"runs programs"| node_loader
node_loader -->|"creates processes"| node_scheduler
node_syscalls -->|"reads and writes"| node_vfs
node_syscalls -->|"reads input"| node_devnodes
node_syscalls -->|"dispatches IPC"| node_ipc
node_syscalls -->|"queries device"| node_persist
node_diskfmt -->|"reads storage"| node_block
node_diskfmt -->|"uses filesystem"| node_persist
node_syscalls -->|"plays audio"| node_audio
node_syscalls -->|"resolves names"| node_netstack
node_tls -->|"uses transport"| node_netstack
node_tls -->|"uses primitives"| node_crypto
node_netstack -->|"uses network devices"| node_drivers

click node_bootseq "https://github.com/elabbas0/icda/blob/Production/kernel/kernel.c"
click node_irq "https://github.com/elabbas0/icda/blob/Production/kernel/cpu/irq_controller.c"
click node_drivers "https://github.com/elabbas0/icda/tree/Production/kernel/drivers"
click node_memory "https://github.com/elabbas0/icda/tree/Production/kernel/memory"
click node_scheduler "https://github.com/elabbas0/icda/blob/Production/kernel/proc/sched.c"
click node_loader "https://github.com/elabbas0/icda/blob/Production/kernel/proc/user.c"
click node_syscalls "https://github.com/elabbas0/icda/blob/Production/kernel/syscall/syscall.c"
click node_devnodes "https://github.com/elabbas0/icda/blob/Production/kernel/dev/devnodes.c"
click node_ipc "https://github.com/elabbas0/icda/tree/Production/kernel/ipc"
click node_vfs "https://github.com/elabbas0/icda/blob/Production/kernel/fs/vfs.h"
click node_diskfmt "https://github.com/elabbas0/icda/blob/Production/kernel/fs/diskfmt.c"
click node_persist "https://github.com/elabbas0/icda/blob/Production/kernel/fs/persistfs.c"
click node_block "https://github.com/elabbas0/icda/blob/Production/kernel/drivers/storage/block.h"
click node_init "https://github.com/elabbas0/icda/blob/Production/userspace/init.c"
click node_desktop "https://github.com/elabbas0/icda/blob/Production/userspace/desktop.c"
click node_windowmgr "https://github.com/elabbas0/icda/blob/Production/userspace/wm.c"
click node_gui "https://github.com/elabbas0/icda/blob/Production/userspace/gui.c"
click node_shell "https://github.com/elabbas0/icda/blob/Production/userspace/shell.c"
click node_apps "https://github.com/elabbas0/icda/tree/Production/userspace"
click node_netstack "https://github.com/elabbas0/icda/blob/Production/kernel/net/net.c"
click node_tls "https://github.com/elabbas0/icda/blob/Production/kernel/net/tls.c"
click node_crypto "https://github.com/elabbas0/icda/tree/Production/kernel/crypto"
click node_audio "https://github.com/elabbas0/icda/tree/Production/kernel/drivers/audio"

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_bootseq,node_irq,node_drivers,node_audio,node_person toneBlue
class node_memory,node_scheduler,node_loader,node_syscalls,node_devnodes,node_ipc toneAmber
class node_vfs,node_diskfmt,node_persist,node_block toneMint
class node_init,node_desktop,node_windowmgr,node_gui,node_shell,node_apps toneRose
class node_netstack,node_tls,node_crypto toneIndigo
```

## Components

### Boot and hardware

- [Kernel boot](https://github.com/elabbas0/icda/blob/Production/kernel/kernel.c): `kernel/kernel.c`
- [Interrupt control](https://github.com/elabbas0/icda/blob/Production/kernel/cpu/irq_controller.c): `kernel/cpu/irq_controller.c`
- [Hardware drivers](https://github.com/elabbas0/icda/tree/Production/kernel/drivers): `kernel/drivers`
- [Audio services](https://github.com/elabbas0/icda/tree/Production/kernel/drivers/audio): `kernel/drivers/audio`

### Kernel services

- [Memory management](https://github.com/elabbas0/icda/tree/Production/kernel/memory): `kernel/memory`
- [Process scheduler](https://github.com/elabbas0/icda/blob/Production/kernel/proc/sched.c): `kernel/proc/sched.c`
- [User process loader](https://github.com/elabbas0/icda/blob/Production/kernel/proc/user.c): `kernel/proc/user.c`
- [Syscall dispatcher](https://github.com/elabbas0/icda/blob/Production/kernel/syscall/syscall.c): `kernel/syscall/syscall.c`
- [Device nodes](https://github.com/elabbas0/icda/blob/Production/kernel/dev/devnodes.c): `kernel/dev/devnodes.c`
- [IPC services](https://github.com/elabbas0/icda/tree/Production/kernel/ipc): `kernel/ipc`

### Storage and filesystems

- [Virtual filesystem](https://github.com/elabbas0/icda/blob/Production/kernel/fs/vfs.h): `kernel/fs/vfs.h`
- [Disk formats](https://github.com/elabbas0/icda/blob/Production/kernel/fs/diskfmt.c): `kernel/fs/diskfmt.c`
- [Persistent filesystem](https://github.com/elabbas0/icda/blob/Production/kernel/fs/persistfs.c): `kernel/fs/persistfs.c`
- [Block storage](https://github.com/elabbas0/icda/blob/Production/kernel/drivers/storage/block.h): `kernel/drivers/storage/block.h`

### Userspace experience

- [Userspace init](https://github.com/elabbas0/icda/blob/Production/userspace/init.c): `userspace/init.c`
- [Desktop](https://github.com/elabbas0/icda/blob/Production/userspace/desktop.c): `userspace/desktop.c`
- [Window manager](https://github.com/elabbas0/icda/blob/Production/userspace/wm.c): `userspace/wm.c`
- [GUI toolkit](https://github.com/elabbas0/icda/blob/Production/userspace/gui.c): `userspace/gui.c`
- [Shell and terminal](https://github.com/elabbas0/icda/blob/Production/userspace/shell.c): `userspace/shell.c`
- [User applications](https://github.com/elabbas0/icda/tree/Production/userspace): `userspace`

### Networking

- [Network stack](https://github.com/elabbas0/icda/blob/Production/kernel/net/net.c): `kernel/net/net.c`
- [TLS security](https://github.com/elabbas0/icda/blob/Production/kernel/net/tls.c): `kernel/net/tls.c`
- [Cryptography](https://github.com/elabbas0/icda/tree/Production/kernel/crypto): `kernel/crypto`

### Other components

- **Computer user**

## Connections

- Computer user → Desktop: interacts with
- Computer user → Shell and terminal: interacts with
- Kernel boot → Memory management: initializes (evidence: `kernel/kernel.c`)
- Kernel boot → Interrupt control: initializes (evidence: `kernel/kernel.c`)
- Kernel boot → Hardware drivers: initializes (evidence: `kernel/kernel.c`)
- Kernel boot → Virtual filesystem: initializes (evidence: `kernel/kernel.c`)
- Kernel boot → Device nodes: populates (evidence: `kernel/kernel.c`)
- Kernel boot → Userspace init: starts (evidence: `kernel/kernel.c`)
- Kernel boot → Process scheduler: schedules via (evidence: `kernel/kernel.c`)
- Userspace init → Desktop: launches
- Userspace init → Shell and terminal: launches
- Desktop → Window manager: uses
- Window manager → GUI toolkit: uses
- User applications → Syscall dispatcher: requests services
- Syscall dispatcher → User process loader: runs programs (evidence: `kernel/syscall/syscall.c`)
- User process loader → Process scheduler: creates processes (evidence: `kernel/proc/user.c`)
- Syscall dispatcher → Virtual filesystem: reads and writes (evidence: `kernel/syscall/syscall.c`)
- Syscall dispatcher → Device nodes: reads input (evidence: `kernel/syscall/syscall.c`)
- Syscall dispatcher → IPC services: dispatches IPC (evidence: `kernel/syscall/syscall.c`)
- Syscall dispatcher → Persistent filesystem: queries device (evidence: `kernel/syscall/syscall.c`)
- Disk formats → Block storage: reads storage (evidence: `kernel/fs/diskfmt.c`)
- Disk formats → Persistent filesystem: uses filesystem (evidence: `kernel/fs/diskfmt.c`)
- Syscall dispatcher → Audio services: plays audio (evidence: `kernel/syscall/syscall.c`)
- Syscall dispatcher → Network stack: resolves names (evidence: `kernel/syscall/syscall.c`)
- TLS security → Network stack: uses transport (evidence: `kernel/net/tls.c`)
- TLS security → Cryptography: uses primitives (evidence: `kernel/net/tls.c`)
- Network stack → Hardware drivers: uses network devices (evidence: `kernel/net/net.c`)
