mirror of
https://github.com/subhobhai943/SUB-OS.git
synced 2026-10-25 16:52:29 +00:00
feat: Add SLAB allocator, Ramdisk, Kernel Namespaces, Event Tracing, NetFilter Firewall, 8-Bit Melodies, and Shell Scripting (sh)
This commit is contained in:
subhobhai943 committed
1 parent
9f9a19bab0
commit
2f1f785cee
17 files changed
+1021
-115
No files matched your search
@@ -12,11 +12,11 @@
|
||||
[]()
|
||||
[]()
|
||||
[-purple.svg?style=flat-square)]()
|
||||
[]()
|
||||
[]()
|
||||
[]()
|
||||
[]()
|
||||
[](LICENSE)
|
||||
|
||||
**SUB-OS** is an open-source, production-grade 64-bit modular monolithic operating system engineered from the ground up for the `x86_64` architecture. Built adhering to the internal design principles of modern UNIX/Linux kernels, SUB-OS features a full bare-metal hardware driver tree, physical and dynamic memory management, a virtual file system (VFS) with FAT32, ext2, sysfs, and devfs, full L2-L4 networking protocol stack with BSD Sockets, cryptographic engine, Linux Security Modules (LSM), asynchronous `io_uring` ringbuffers, Inter-Process Communication (IPC) engine, Text-to-Speech (TTS) voice synthesizer, AC'97 sound architecture, full-screen visual `nano` editor, and the **LazyBox** multi-call userland environment with 50+ Linux utilities.
|
||||
**SUB-OS** is an open-source, production-grade 64-bit modular monolithic operating system engineered from the ground up for the `x86_64` architecture. Built adhering to the internal design principles of modern UNIX/Linux kernels while maintaining an elegant, easy-to-understand codebase, SUB-OS features a bare-metal driver tree, physical and dynamic memory management with a **SLAB Object Allocator**, an advanced virtual file system (VFS) with FAT32, ext2, sysfs, and devfs, **Lightweight Process & Container Namespaces**, **Kernel Event Tracing (FTrace-like ringbuffers)**, **Stateful Packet Inspection (NetFilter Firewall)**, **Ramdisk (`/dev/ram0`)**, a full L2-L4 networking protocol stack with BSD Sockets, **8-Bit Retro Melody Synth & Formant Text-to-Speech (TTS)** voice synthesizer, AC'97 sound architecture, full-screen visual `nano` editor, and the **LazyBox** multi-call userland environment with **55+ Linux-compatible utilities** and shell scripting (`sh`).
|
||||
|
||||
---
|
||||
|
||||
@@ -25,28 +25,28 @@
|
||||
```text
|
||||
+------------------------------------------------------------------------------------+
|
||||
| USERLAND & SYSTEM SUITE |
|
||||
| Interactive Shell | GNU Nano 2.0.0 | LazyBox Multi-Call Suite (50+ Coreutils) |
|
||||
| Interactive Shell | GNU Nano 2.0.0 | Script Runner (sh) | LazyBox (55+ Tools) |
|
||||
+------------------------------------------------------------------------------------+
|
||||
| VIRTUAL FILE SYSTEM LAYER (VFS) |
|
||||
| vfs_namei | RAMFS (/) | /dev (devfs) | /proc (procfs) | /sys (sysfs) | FAT32 | ext2|
|
||||
+------------------------------------------------------------------------------------+
|
||||
| INTER-PROCESS COMMUNICATION & ASYNC I/O ENGINE |
|
||||
| Anonymous Pipes | Message Queues | Shared Memory | Semaphores | io_uring Rings |
|
||||
| NAMESPACES, INTER-PROCESS COMMUNICATION & ASYNC I/O ENGINE |
|
||||
| PID & UTS Isolation | Anonymous Pipes | Message Queues | SHM | Semaphores | io_uring|
|
||||
+------------------------------------------------------------------------------------+
|
||||
| CORE KERNEL SERVICES & SECURITY MODULE (LSM) |
|
||||
| CORE KERNEL SERVICES, SECURITY & TRACING |
|
||||
| Preemptive Scheduler | Task Control | POSIX Signals | Fast Syscalls | Workqueues |
|
||||
| High-Res Timer Wheel | Dynamic Module Loader | X.509 Keyring | POSIX Capabilities |
|
||||
| High-Res Timer Wheel | Dynamic Module Loader | Kernel Event Tracer | LSM Security |
|
||||
+------------------------------------------------------------------------------------+
|
||||
| NETWORK PROTOCOL STACK (L2 -> L4) & SOUND |
|
||||
| Ethernet L2 | ARP | IPv4 | ICMP | UDP | TCP | DHCP | DNS | BSD Sockets |
|
||||
| ALSA Sound Architecture | AC'97 Audio | PCM Streams | Formant TTS Synthesizer |
|
||||
| NETWORKING, NETFILTER FIREWALL & SOUND ARCHITECTURE |
|
||||
| Ethernet L2 | ARP | IPv4 | ICMP | UDP | TCP | DHCP | DNS | Sockets | NetFilter FW |
|
||||
| ALSA Sound Core | AC'97 Audio | Formant TTS Synthesizer | 8-Bit Melody Engine |
|
||||
+------------------------------------------------------------------------------------+
|
||||
| MEMORY MANAGEMENT (MM) |
|
||||
| Physical Page Frame Allocator (PMM) | Kernel Dynamic Heap (kmalloc/kfree) |
|
||||
| Physical Page Allocator (PMM) | Dynamic Heap | SLAB / SLUB Object Cache |
|
||||
+------------------------------------------------------------------------------------+
|
||||
| DEVICE DRIVER TREE & VIRT |
|
||||
| VGA / TTY1-4 | 16550 UART Serial | PS/2 Keyboard | PS/2 Mouse | ATA / IDE Disk |
|
||||
| PCI Enumerator | Intel E1000 NIC | VESA FB | CMOS RTC | ACPI Power | USB Core |
|
||||
| VGA / TTY1-4 | 16550 UART Serial | PS/2 Keyboard | PS/2 Mouse | ATA Hard Disk |
|
||||
| PCI Enumerator | Intel E1000 NIC | Ramdisk (/dev/ram0) | VESA FB | CMOS RTC |
|
||||
+------------------------------------------------------------------------------------+
|
||||
| HARDWARE ABSTRACTION LAYER (HAL) |
|
||||
| x86_64 Long Mode | GDT / TSS | IDT / ISRs | Dual 8259A PIC | 8254 PIT Timer |
|
||||
@@ -57,8 +57,6 @@
|
||||
|
||||
## ⚡ 18-Step Master Boot Pipeline
|
||||
|
||||
During boot, the kernel executes a deterministic 18-step master initialization sequence:
|
||||
|
||||
| Step | Subsystem | Description |
|
||||
|:---:|:---|:---|
|
||||
| **[1/18]** | **64-Bit GDT & TSS** | Configures flat kernel/user code & data segments and Task State Segment with dedicated 64KB kernel stack. |
|
||||
@@ -66,103 +64,32 @@ During boot, the kernel executes a deterministic 18-step master initialization s
|
||||
| **[3/18]** | **Dual 8259A PIC** | Remaps master (IRQ 0-7 -> 0x20-0x27) and slave (IRQ 8-15 -> 0x28-0x2F) interrupt controllers. |
|
||||
| **[4/18]** | **PIT & Timer Wheel** | Configures 8254 PIT channel 0 for 100 Hz (10ms resolution) driving quantum preemption & timer wheel. |
|
||||
| **[5/18]** | **Input & ACPI** | PS/2 Keyboard scancode decoder, PS/2 Mouse packet tracker, and ACPI power management subsystem. |
|
||||
| **[6/18]** | **PMM & Dynamic Heap** | 64-bit bitmap frame allocator tracking usable RAM via BIOS E820 map and 4 MB dynamic kernel heap. |
|
||||
| **[7/18]** | **Block Layer & ATA** | Generic Block Layer with request queues, 'noop' elevator scheduler, and 28-bit LBA ATA driver. |
|
||||
| **[6/18]** | **PMM, Heap & SLAB** | 64-bit bitmap frame allocator, 4 MB kernel heap, and high-performance SLAB object cache layer. |
|
||||
| **[7/18]** | **Block Layer, Ramdisk & ATA** | Generic Block Layer with request queues, Ramdisk (`/dev/ram0`), 'noop' elevator, and ATA driver. |
|
||||
| **[8/18]** | **PCI, VirtIO, FB & USB** | PCI bus enumerator, VirtIO core, Linear 32-bit Framebuffer graphics, and USB host controller. |
|
||||
| **[9/18]** | **L2-L4 Network Stack** | Intel E1000 NIC, ARP cache, IPv4 routing, ICMP Ping, UDP, TCP state machine, DHCP & DNS. |
|
||||
| **[10/18]** | **Sound Architecture** | Audio core driver, AC'97 soundcard, PCM stream buffer, and Formant Text-to-Speech synthesizer. |
|
||||
| **[11/18]** | **Keyring & Security** | Loads X.509 trusted certificate authority keyring and enforces POSIX Capabilities Linux Security Module. |
|
||||
| **[9/18]** | **L2-L4 Network & NetFilter** | Intel E1000 NIC, NetFilter stateful firewall, ARP, IPv4 routing, ICMP Ping, UDP, TCP, DHCP & DNS. |
|
||||
| **[10/18]** | **Sound & Melody Synth** | Audio core driver, AC'97 soundcard, 8-Bit Melody player, and Formant Text-to-Speech synthesizer. |
|
||||
| **[11/18]** | **Keyring, LSM & Namespaces** | Loads X.509 trusted keyring, POSIX Capabilities LSM, and initializes container namespaces. |
|
||||
| **[12/18]** | **IPC Engine** | Anonymous Pipes, System V & POSIX Message Queues, Shared Memory segments, and Semaphore sets. |
|
||||
| **[13/18]** | **io_uring Subsystem** | Lockless Submission Queue Entry (SQE) & Completion Queue Entry (CQE) asynchronous I/O engine. |
|
||||
| **[14/18]** | **Multi-VFS Mount** | Root RAMFS, synthetic `/dev` devfs, `/proc` procfs, `/sys` sysfs, FAT32 driver, ext2 driver & initramfs. |
|
||||
| **[15/18]** | **Kernel Core Services** | POSIX Signal manager (32 signals), Async Workqueues, 64-bit Fast Syscalls, and Dynamic Module Loader. |
|
||||
| **[15/18]** | **Kernel Core & Tracing** | POSIX Signals, Workqueues, 64-bit Fast Syscalls, Dynamic Module Loader, and Event Tracer. |
|
||||
| **[16/18]** | **Scheduler & LazyBox** | Starts round-robin preemptive scheduler and launches LazyBox interactive userland environment. |
|
||||
| **[17/18]** | **Hardware Interrupts** | Enables processor interrupts (`sti`) and transitions to userland shell. |
|
||||
| **[18/18]** | **Interactive Shell** | Launches multi-TTY interactive terminal console on TTY1. |
|
||||
| **[18/18]** | **Interactive Shell** | Launches multi-TTY interactive terminal console on TTY1 with dynamic CWD prompt. |
|
||||
|
||||
---
|
||||
|
||||
## 🌟 Subsystems & Codebase Architecture
|
||||
|
||||
```text
|
||||
SUB-OS/
|
||||
├── arch/x86_64/ # Long Mode bootstrap, GDT, IDT, ISRs, PIC, PIT, CPUID, Paging
|
||||
├── block/ # Block Layer Core, Request Queues, Elevator I/O Schedulers
|
||||
├── boot/ # Stage 1 MBR Bootloader & Stage 2 64-Bit Protected Mode Switcher
|
||||
├── certs/ # X.509 ASN.1 DER Parser, Public Key Verification & Root Keyring
|
||||
├── crypto/ # FIPS SHA-256, RFC 1321 MD5, IEEE 802.3 CRC32, Xorshift128+ PRNG
|
||||
├── drivers/
|
||||
│ ├── block/ # ATA / IDE Hard Disk PIO Driver (28-bit LBA)
|
||||
│ ├── char/ # VGA Text, TTY1-4 with ANSI sequences, 16550 UART Serial, PS/2 Keyboard
|
||||
│ ├── input/ # PS/2 Mouse Driver with packet tracking
|
||||
│ ├── net/ # Intel 82540EM Gigabit Ethernet NIC with DMA Descriptors
|
||||
│ ├── pci/ # PCI Bus Enumeration & BAR Configuration
|
||||
│ ├── power/ # ACPI S5 Soft-Off Power Management & Reset
|
||||
│ ├── rtc/ # CMOS Real-Time Clock Hardware Driver (BCD conversion)
|
||||
│ ├── sound/ # PC Speaker Tone Generator
|
||||
│ ├── usb/ # USB Host Controller Abstraction
|
||||
│ └── video/ # 32-bit Linear Framebuffer Graphics Engine
|
||||
├── fs/ # VFS Layer, RAMFS, devfs (/dev), procfs (/proc), sysfs (/sys), FAT32, ext2
|
||||
├── include/ # Modular Subsystem Header Files
|
||||
├── init/ # Early Initialization, Boot Command Line Parser, Versioning & Runlevels
|
||||
├── io_uring/ # Asynchronous I/O Engine with SQE & CQE Lockless Ringbuffers
|
||||
├── ipc/ # Anonymous Pipes, Message Queues, Shared Memory, Counting Semaphores
|
||||
├── kernel/ # Task Scheduler, Mutexes, Signals, Syscalls, Timers, Workqueues, Modules
|
||||
├── lib/ # Standard C Library (string, sprintf, bitmap, list)
|
||||
├── mm/ # Physical Page Frame Allocator (PMM) & Dynamic Heap (kmalloc)
|
||||
├── net/ # Ethernet, ARP, IPv4, ICMP, UDP, TCP, DHCP, DNS, BSD Sockets
|
||||
├── security/ # Linux Security Modules (LSM) & POSIX Capabilities
|
||||
├── sound/ # ALSA Sound Core, AC'97 Driver, PCM Audio & Text-to-Speech (TTS) Engine
|
||||
├── usr/ # Embedded Initramfs Payload Tree (/etc/passwd, /etc/fstab, /usr/bin)
|
||||
└── userland/ # Full-Screen GNU Nano Editor & 50+ LazyBox Core Utilities
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📝 Full-Screen Visual Nano Editor
|
||||
|
||||
SUB-OS includes a full-screen interactive ANSI text editor (`nano`):
|
||||
|
||||
```text
|
||||
GNU nano 2.0.0 File: /home/user/notes.txt [Modified]
|
||||
Hello from nano editor in SUB-OS!
|
||||
This is a production-level modular operating system.
|
||||
You can write, edit, search, and save files directly to the VFS.
|
||||
~
|
||||
~
|
||||
~
|
||||
~
|
||||
~
|
||||
~
|
||||
~
|
||||
~
|
||||
~
|
||||
~
|
||||
~
|
||||
[ Wrote 148 bytes to /home/user/notes.txt ]
|
||||
^G Get Help ^O WriteOut ^W Where Is ^K Cut Line ^U Paste ^X Exit
|
||||
```
|
||||
|
||||
### Keybindings:
|
||||
- **`^O` (Ctrl+O)**: WriteOut / Save file to Virtual File System.
|
||||
- **`^X` (Ctrl+X)**: Exit Nano and return to shell.
|
||||
- **`^K` (Ctrl+K)**: Cut current line to cut-buffer.
|
||||
- **`^U` (Ctrl+U)**: Uncut / Paste line at cursor position.
|
||||
- **`^G` (Ctrl+G)**: Display help cheat sheet.
|
||||
- **`Arrow Keys` / `Home` / `End` / `PgUp` / `PgDn`**: Smooth cursor navigation.
|
||||
|
||||
---
|
||||
|
||||
## 🧰 LazyBox Multi-Call Userland Suite (50+ Utilities)
|
||||
## 🧰 LazyBox Multi-Call Userland Suite (55+ Utilities)
|
||||
|
||||
| Category | Commands Included |
|
||||
|---|---|
|
||||
| **Core** | `lazybox`, `echo`, `whoami`, `id`, `date` (CMOS RTC), `cal` |
|
||||
| **Filesystem & Editor** | `nano`, `ls`, `cat`, `touch`, `mkdir`, `pwd`, `cd`, `wc`, `head`, `tail`, `stat`, `cp`, `grep`, `hexdump` |
|
||||
| **Sound & Voice** | `tts` (Phonetic Formant Voice Synthesizer), `alsamixer` |
|
||||
| **Kernel & Modules** | `lsmod`, `insmod`, `rmmod` |
|
||||
| **Core & Scripting** | `lazybox`, `sh` (Script runner), `echo`, `env`, `export`, `whoami`, `id`, `date` (CMOS RTC), `cal` |
|
||||
| **Filesystem & Editor** | `nano`, `ls`, `cat`, `touch`, `mkdir`, `pwd`, `cd`, `wc`, `head`, `tail`, `stat`, `cp`, `grep`, `hexdump`, `basename`, `dirname` |
|
||||
| **Sound & Voice** | `tts` (Phonetic Formant Voice Synthesizer), `tune` (8-Bit Melody Player), `alsamixer` |
|
||||
| **Kernel & Tracing** | `lsmod`, `insmod`, `rmmod`, `slabinfo`, `trace`, `unshare` (Namespace containers) |
|
||||
| **Crypto & Security** | `sha256sum`, `md5sum`, `crc32`, `rand`, `certcheck`, `capsh`, `ipcs` |
|
||||
| **Network** | `ifconfig`, `ping`, `arp`, `dhclient`, `nslookup` |
|
||||
| **Network & Firewall** | `ifconfig`, `ping`, `arp`, `dhclient`, `nslookup`, `iptables` (Stateful Firewall) |
|
||||
| **Storage & Devices** | `hdparm`, `lspci`, `speaker`, `mouse` |
|
||||
| **Virtualization & Async**| `virtinfo`, `io_uring_test` |
|
||||
| **System Monitoring** | `uname`, `free`, `uptime`, `dmesg`, `ps`, `top`, `sleep`, `reboot`, `poweroff` |
|
||||
@@ -170,6 +97,23 @@ You can write, edit, search, and save files directly to the VFS.
|
||||
|
||||
---
|
||||
|
||||
## 📜 Shell Scripting Example (`.sub` scripts)
|
||||
|
||||
Create a script with `nano /test.sub` and execute it with `sh /test.sub`:
|
||||
|
||||
```bash
|
||||
# SUB-OS Automation Script
|
||||
echo "Starting System Self-Check..."
|
||||
uname -a
|
||||
free
|
||||
slabinfo
|
||||
iptables
|
||||
tune startup
|
||||
echo "All subsystems operational!"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🚀 Building & Running
|
||||
|
||||
### Compilation
|
||||
|
||||
Reference in new issue
Block a user