From cb60cdebdc36dd2358fe1ce06eec197e213af491 Mon Sep 17 00:00:00 2001
From: Felix Morgner <felix.morgner@ost.ch>
Date: Tue, 24 Mar 2026 17:35:54 +0100
Subject: kapi/cpu: introduce CPU API

---
 kernel/src/cpu.cpp  | 46 ++++++++++++++++++++++++++++++++++++++++++++++
 kernel/src/main.cpp |  5 +++++
 2 files changed, 51 insertions(+)
 create mode 100644 kernel/src/cpu.cpp

(limited to 'kernel/src')

diff --git a/kernel/src/cpu.cpp b/kernel/src/cpu.cpp
new file mode 100644
index 0000000..fc460c9
--- /dev/null
+++ b/kernel/src/cpu.cpp
@@ -0,0 +1,46 @@
+#include "kernel/cpu.hpp"
+
+#include "kapi/cpu.hpp"
+#include "kapi/system.hpp"
+
+#include <kstd/print>
+
+namespace kernel::cpu
+{
+
+  namespace
+  {
+    struct exception_handler : kapi::cpu::exception_handler
+    {
+      auto handle(kapi::cpu::exception const & context) -> bool override
+      {
+        switch (context.type)
+        {
+          case kapi::cpu::exception::type::page_fault:
+            return handle_page_fault(context);
+          default:
+            return false;
+        }
+      }
+
+    private:
+      auto handle_page_fault(kapi::cpu::exception const & context) -> bool
+      {
+        kstd::println(kstd::print_sink::stderr, "[OS:CPU] PAGE FAULT!");
+        kstd::println(kstd::print_sink::stderr, "\tFault address: {:#018x}", context.access_address);
+        kstd::println(kstd::print_sink::stderr, "\tPresent: {}", context.is_present);
+        kstd::println(kstd::print_sink::stderr, "\tWrite: {}", context.is_write_access);
+        kstd::println(kstd::print_sink::stderr, "\tUser: {}", context.is_user_mode);
+        kstd::println(kstd::print_sink::stderr, "\tRIP: {:#018x}", context.instruction_pointer);
+
+        kapi::system::panic("Halting the system due to an unrecoverable page fault.");
+      }
+    } static constinit handler;
+  }  // namespace
+
+  auto init() -> void
+  {
+    kapi::cpu::set_exception_handler(handler);
+  }
+
+}  // namespace kernel::cpu
\ No newline at end of file
diff --git a/kernel/src/main.cpp b/kernel/src/main.cpp
index eb59402..0416ee9 100644
--- a/kernel/src/main.cpp
+++ b/kernel/src/main.cpp
@@ -1,8 +1,10 @@
 #include "kapi/boot_modules.hpp"
 #include "kapi/cio.hpp"
+#include "kapi/cpu.hpp"
 #include "kapi/memory.hpp"
 #include "kapi/system.hpp"
 
+#include "kernel/cpu.hpp"
 #include "kernel/devices/storage/storage_management.hpp"
 #include "kernel/filesystem/device_file.hpp"
 #include "kernel/filesystem/file_descriptor_table.hpp"
@@ -90,6 +92,9 @@ auto main() -> int
   kapi::cio::init();
   kstd::println("[OS] IO subsystem initialized.");
 
+  kapi::cpu::init();
+  kernel::cpu::init();
+
   kapi::memory::init();
   kernel::memory::init_heap(kapi::memory::heap_base);
   kstd::println("[OS] Memory subsystem initialized.");
-- 
cgit v1.2.3