Merge pull request #9 from nekernel-org/dev

v0.0.3

3 files changed, 243 insertions, 0 deletions

diff --git a/dev/DebuggerKit/src/NeKernelContract.cc b/dev/DebuggerKit/src/NeKernelContract.cc
new file mode 100644
index 0000000..a469e46
--- /dev/null
+++ b/dev/DebuggerKit/src/NeKernelContract.cc
@@ -0,0 +1,47 @@
+/***
+  DebuggerKit
+  (C) 2025 Amlal El Mahrouss
+  File: NeKernelContract.cc
+  Purpose: NeKernel Debugger
+*/
+
+#ifdef DK_NEKERNEL_DEBUGGER
+
+/// @author Amlal El Mahrouss
+/// @brief Kernel Debugger Protocol
+
+#include <CompilerKit/Defines.h>
+#include <DebuggerKit/NeKernelContract.h>
+#include <ThirdParty/Dialogs.h>
+
+#include <DebuggerKit/Platform.h>
+
+using namespace DebuggerKit::NeKernel;
+
+NeKernelContract::NeKernelContract() = default;
+
+NeKernelContract::~NeKernelContract() = default;
+
+BOOL NeKernelContract::Attach(CompilerKit::STLString path, CompilerKit::STLString argv,
+                              ProcessID& pid) noexcept {
+  if (path.empty() || argv.empty()) return NO;
+  return NO;
+}
+
+BOOL NeKernelContract::BreakAt(CompilerKit::STLString symbol) noexcept {
+  return NO;
+}
+
+BOOL NeKernelContract::Break() noexcept {
+  return NO;
+}
+
+BOOL NeKernelContract::Continue() noexcept {
+  return NO;
+}
+
+BOOL NeKernelContract::Detach() noexcept {
+  return NO;
+}
+
+#endif  // DK_NEKERNEL_DEBUGGER
\ No newline at end of file
diff --git a/dev/DebuggerKit/src/NeKernelContractCLI.cc b/dev/DebuggerKit/src/NeKernelContractCLI.cc
new file mode 100644
index 0000000..0eb04d3
--- /dev/null
+++ b/dev/DebuggerKit/src/NeKernelContractCLI.cc
@@ -0,0 +1,102 @@
+/***
+  DebuggerKit
+  (C) 2025 Amlal El Mahrouss
+  File: NeKernelContract.cc
+  Purpose: NeKernel Debugger CLI.
+*/
+
+#ifdef DK_NEKERNEL_DEBUGGER
+
+#include <CompilerKit/Defines.h>
+#include <DebuggerKit/NeKernelContract.h>
+#include <ThirdParty/Dialogs.h>
+#include <string>
+
+#include <DebuggerKit/CommonCLI.inl>
+
+using namespace DebuggerKit::NeKernel;
+
+static void dbgi_ctrlc_handler(std::int32_t _) {
+  if (!kPID || kPath.empty()) {
+    return;
+  }
+
+  kKernelDebugger.Break();
+
+  pfd::notify("Debugger Event", "Breakpoint hit!");
+
+  kKeepRunning = false;
+}
+
+NECTI_MODULE(DebuggerNeKernel) {
+  pfd::notify("Debugger Event",
+              "NeKernel Debugger\n(C) 2025 Amlal El Mahrouss and NeKernel.org contributors, all "
+              "rights reserved.");
+
+  if (argc >= 5 && std::string(argv[1]) == "-k" && argv[2] != nullptr &&
+      std::string(argv[3]) == "-ip" && argv[4] != nullptr) {
+    kPath = argv[2];
+    kPath += ":";
+    kPath += argv[4];
+
+    kStdOut << "[+] KIP (Kernel:IP) set to: " << kPath << "\n";
+
+    CompilerKit::install_signal(SIGINT, dbgi_ctrlc_handler);
+
+    kKernelDebugger.Attach(kPath, "", kPID);
+    kKernelDebugger.BreakAt("$HANDOVER_START");
+
+    while (YES) {
+      if (kKeepRunning) {
+        continue;
+      }
+
+      std::string cmd;
+      if (!std::getline(std::cin, cmd)) break;
+
+      if (cmd == "c" || cmd == "cont" || cmd == "continue") {
+        if (kKernelDebugger.Continue()) {
+          kKeepRunning = true;
+
+          kStdOut << "[+] Continuing...\n";
+
+          pfd::notify("Debugger Event", "Continuing...");
+        }
+      }
+
+      if (cmd == "d" || cmd == "detach") kKernelDebugger.Detach();
+
+      if (cmd == "start") {
+        kStdOut << "[?] Enter a argument to use: ";
+        std::getline(std::cin, cmd);
+
+        kKernelDebugger.Attach(kPath, cmd, kPID);
+      }
+
+      if (cmd == "exit") {
+        if (kPID > 0) kKernelDebugger.Detach();
+
+        break;
+      }
+
+      if (cmd == "break" || cmd == "b") {
+        kStdOut << "[?] Enter a symbol to break on: ";
+
+        std::getline(std::cin, cmd);
+
+        if (kKernelDebugger.BreakAt(cmd)) {
+          pfd::notify("Debugger Event", "Add BreakAt at: " + cmd);
+        }
+      }
+    }
+
+    return EXIT_SUCCESS;
+  }
+
+  kStdOut << "usage: " << argv[0] << " -k <kernel_path> -ip <ip4>\n";
+  kStdOut << "example: " << argv[0] << " -k /path/to/ne_kernel -ip 127.0.0.1\n";
+
+  return EXIT_FAILURE;
+}
+
+#endif  // DK_NEKERNEL_DEBUGGER
\ No newline at end of file
diff --git a/dev/DebuggerKit/src/POSIXMachContractCLI.cc b/dev/DebuggerKit/src/POSIXMachContractCLI.cc
new file mode 100644
index 0000000..2b2ebc5
--- /dev/null
+++ b/dev/DebuggerKit/src/POSIXMachContractCLI.cc
@@ -0,0 +1,94 @@
+/***
+  DebuggerKit
+  (C) 2025 Amlal El Mahrouss
+  File: POSIXMachContract.cc
+  Purpose: OS X/Darwin Debugger
+*/
+
+#ifdef DK_MACH_DEBUGGER
+
+#include <CompilerKit/Defines.h>
+#include <DebuggerKit/POSIXMachContract.h>
+#include <ThirdParty/Dialogs.h>
+#include <DebuggerKit/CommonCLI.inl>
+
+/// @internal
+/// @brief Handles CTRL-C signal on debugger.
+static void dbgi_ctrlc_handler(std::int32_t _) {
+  if (!kPID) {
+    return;
+  }
+
+  kDebugger.Break();
+
+  pfd::notify("Debugger Event", "Breakpoint hit!");
+
+  kKeepRunning = false;
+}
+
+NECTI_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";
+  } else {
+    kStdOut << "usage: " << argv[0] << " -p <path>\n";
+    kStdOut << "example: " << argv[0] << " -p /path/to/program\n";
+
+    return EXIT_FAILURE;
+  }
+
+  CompilerKit::install_signal(SIGINT, dbgi_ctrlc_handler);
+
+  while (YES) {
+    if (kKeepRunning) {
+      continue;
+    }
+
+    std::string cmd;
+    if (!std::getline(std::cin, cmd)) break;
+
+    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.BreakAt(cmd)) {
+        pfd::notify("Debugger Event", "Add BreakAt at: " + cmd);
+      }
+    }
+  }
+
+  return EXIT_SUCCESS;
+}
+
+#endif
\ No newline at end of file