Skip to content
kazah-png edited this page Aug 25, 2026 · 10 revisions

Index

The content-oriented catalog of this wiki: every page, one line each, organized by category. This is the machine-facing counterpart to _Sidebar (navigation) and Home (landing page) — when answering a question, check here first to find the right page, then drill in. Updated on every ingest; see Wiki-Conventions for the maintenance rules.

Raw source: the nyx-os repository (kernel/, user/, AGENTS.md, git history) — see Wiki-Conventions#The three layers. Pages: 43 · Lines: ~11000 · Tracking: v6.4.363

Tip

This wiki's root is also an Obsidian vault — open this folder directly in Obsidian for graph view, backlinks, and outgoing links over these same files. See Obsidian vault in Wiki-Conventions.


Orientation

Page Lines Summary
Home 106 Landing page — at-a-glance table, links into every section, current release
FAQ 181 Answers to recurring questions, grouped by topic
Glossary 188 ~70 terms used across the wiki and the source, NyxOS-specific ones marked
Troubleshooting 154 Symptom → cause → fix index across every subsystem

Getting started

Page Lines Summary
Building 210 Toolchain, build.ps1/run.ps1, the full QEMU invocation, stale-build traps
Installation 90 Install NyxOS to an ATA/NVMe disk from in-OS — nyxinstall, partitioning, BIOS + UEFI
Debugging 265 Serial log, interrupt tracing, a real annotated boot transcript, self-test suite

Kernel

Page Lines Summary
Architecture 170 Layer map, source layout by subsystem, address-space diagram, key constants
Boot-Process 155 GRUB → kernel_main() stage by stage, boot splash, login, desktop handoff
Memory-Management 125 Physical allocator, 4-level paging, demand paging, COW, heap, slab, user VM
Process-Management 211 Scheduler, context switching, fork/clone, signals, job control, concurrency safety
SMP 131 AP bringup, per-CPU state, locking, TLB shootdown
Syscalls 180 Calling convention, register map, boundary hardening (see Syscall-Reference for the full table)
Drivers 122 One section per device driver (incl. NVMe, AC'97), interrupt map
Security 98 Privilege boundaries, what is and is not defended

Storage and network

Page Lines Summary
Filesystem 152 VFS over ramdisk/EXT2//proc//dev, mount mechanics, persistent home
Networking-Stack 187 Ethernet through HTTP/TLS, BSD sockets, byte-order pitfalls
Cryptography-and-TLS 235 Every crypto primitive, the general-purpose crypto library, TLS 1.2, X.509

Graphics and applications

Page Lines Summary
GUI-Subsystem 151 Compositor, framebuffer, theme palette, terminal screen mode
Desktop-Applications 132 One section per built-in app and game
Selene-Browser 116 The web browser — rendering, forms, images, tabs, limits
Image-Decoders 172 DEFLATE, PNG, BMP, GIF (static + animated), JPEG

Userspace

Page Lines Summary
Userspace 218 ELF loader, crt0, shared libc, dynamic loading, every program
Shell 187 The two shells compared, builtins by category, userspace shell grammar
Toolchain 240 The in-OS C toolchain — libc, the cc builtin, the tcc port, the self-host, xbm
N-Language 190 The native NyxOS language — the ncc compiler, v0.22, N++ P1–P5, self-hosting

HOWTO — procedures

Page Lines Summary
HOWTO-Add-a-system-call 244 Worked example: SYS_GETUID end to end
HOWTO-Write-a-userspace-program 290 Worked example: a coreutil, plus pipelines/signals/sockets/threads/TUI
HOWTO-Add-a-shell-command 199 Worked example: uptime
HOWTO-Add-a-GUI-application 293 Worked example: a stopwatch window

Reference — exhaustive, field-by-field

Page Lines Summary
Syscall-Reference 1060 All 61 syscalls (incl. ring-3 windows): synopsis, arguments, returns, errors
Command-Reference 470 ~209 builtins (verbatim help strings) + ~101 ring-3 programs, man, xbm, installer
Hardware-Reference 496 GDT/TSS/IDT layout, MSRs, PTE bits, LAPIC/IOAPIC registers, I/O ports
Format-Reference 907 Every network header, TLS record/handshake, ELF64, CPIO, EXT2, image formats
Kernel-Data-Structures 313 process_t, vma_t, vfs_node_t, window_t, cpu_info_t, tss_entry_t
Source-Tree-Reference 345 Every source file with purpose and line count (folder-organised)

Project

Page Lines Summary
Contributing 193 Workflow, coding standards, verification matrix, doc-sync rule
Wiki-Conventions 133 House style, and the ingest/query/lint schema — see below
Version-History 862 Every tagged release, v1.0.0 → v6.4.363, grouped by era
Log Chronological record of wiki maintenance — see Wiki-Conventions#Index.md and Log.md

See also

  • Wiki-Conventions — how this index is maintained, and the ingest/query/lint workflow it supports
  • Log — when each page was last touched and why
  • Home — the human-facing landing page

External resources

Clone this wiki locally