dev(kdbg): Working on NeKernel Debugger.

how:

 - Load vmkrnl.efi.
 - Keep track of IP, Stack, and debugging information related to the
   kernel.
 - Make use of breakpoints and provide lldb grade experience.

Signed-off-by: Amlal El Mahrouss <amlal@nekernel.org>

1 files changed, 95 insertions, 0 deletions

diff --git a/dev/LibDebugger/src/POSIXMachContractCLI.cc b/dev/LibDebugger/src/POSIXMachContractCLI.cc
new file mode 100644
index 0000000..90cebc3
--- /dev/null
+++ b/dev/LibDebugger/src/POSIXMachContractCLI.cc
@@ -0,0 +1,95 @@
+/***
+  LibDebugger
+  (C) 2025 Amlal El Mahrouss
+  File: POSIXMachContract.cc
+  Purpose: OS X/Darwin Debugger
+*/
+
+#ifdef LD_MACH_DEBUGGER
+
+#include <LibCompiler/Defines.h>
+#include <LibDebugger/POSIXMachContract.h>
+#include <Vendor/Dialogs.h>
+#include <cstdint>
+#include <iostream>
+#include <string>
+
+#include <LibDebugger/CommonCLI.inl>
+
+/// @internal
+/// @brief Handles CTRL-C signal on debugger.
+static void dbgi_ctrlc_handler(std::int32_t _) {
+  if (!kPID) {
+    return;
+  }
+
+  auto list = kDebugger.Get();
+
+  kDebugger.Break();
+
+  pfd::notify("Debugger Event", "Breakpoint hit!");
+
+  kKeepRunning = false;
+}
+
+LIBCOMPILER_MODULE(DebuggerMachPOSIX) {
+  pfd::notify("Debugger Event",
+              "Userland Debugger\n(C) 2025 Amlal El Mahrouss, all rights reserved.");
+
+  if (argc >= 3 && std::string(argv[1]) == "-p" && argv[2] != nullptr) {
+    kPath = argv[2];
+    kDebugger.SetPath(kPath);
+
+    kStdOut << "[+] Image set to: " << kPath << "\n";
+  }
+
+  ::signal(SIGINT, dbgi_ctrlc_handler);
+
+  while (YES) {
+    if (kKeepRunning) {
+      continue;
+    }
+
+    std::string cmd;
+    std::getline(std::cin, cmd);
+
+    if (cmd == "c" || cmd == "cont" || cmd == "continue") {
+      if (kDebugger.Continue()) {
+        kKeepRunning = true;
+
+        kStdOut << "[+] Continuing...\n";
+
+        pfd::notify("Debugger Event", "Continuing...");
+      }
+    }
+
+    if (cmd == "d" || cmd == "detach") kDebugger.Detach();
+
+    if (cmd == "start") {
+      kStdOut << "[?] Enter a argument to use: ";
+      std::getline(std::cin, cmd);
+
+      kDebugger.Attach(kPath, cmd, kPID);
+    }
+
+    if (cmd == "exit") {
+      if (kPID > 0) kDebugger.Detach();
+
+      break;
+    }
+
+    if (cmd == "break" || cmd == "b") {
+      kStdOut << "[?] Enter a symbol to break on: ";
+
+      std::getline(std::cin, cmd);
+
+      if (kDebugger.Breakpoint(cmd)) {
+        pfd::notify("Debugger Event", "Add Breakpoint at: " + cmd);
+      }
+    }
+  }
+
+  return EXIT_SUCCESS;
+}
+
+#endif
\ No newline at end of file