feat! breaking changes on kernel sources.

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

3 files changed, 106 insertions, 0 deletions

diff --git a/src/misc/.keep b/src/misc/.keep
new file mode 100644
index 00000000..e69de29b
--- /dev/null
+++ b/src/misc/.keep
diff --git a/src/misc/BenchKit/Chronometer.h b/src/misc/BenchKit/Chronometer.h
new file mode 100644
index 00000000..8a1fa3ab
--- /dev/null
+++ b/src/misc/BenchKit/Chronometer.h
@@ -0,0 +1,40 @@
+/* ========================================
+
+Copyright (C) 2025, Amlal El Mahrouss, licensed under the Apache 2.0 license.
+
+======================================== */
+
+#ifndef BENCHKIT_CHRONO_H
+#define BENCHKIT_CHRONO_H
+
+#include <CompilerKit/CompilerKit.h>
+#include <NeKit/Defines.h>
+
+/// @author Amlal El Mahrouss
+/// @brief BenchKit Chrono contract.
+
+#define BENCHKIT_INTERFACE : public ::Kernel::ChronoInterface
+
+namespace Kernel {
+class ChronoInterface;
+
+/// @brief a Chronometer interface used for benchmarking.
+class ChronoInterface {
+ public:
+  ChronoInterface()          = default;
+  virtual ~ChronoInterface() = default;
+
+  NE_COPY_DEFAULT(ChronoInterface)
+
+  virtual Void   Start()                = 0;
+  virtual Void   Stop()                 = 0;
+  virtual Void   Reset()                = 0;
+  virtual UInt64 GetElapsedTime() const = 0;
+};
+}  // namespace Kernel
+
+namespace BenchKit {
+using namespace Kernel;
+}
+
+#endif  // BENCHKIT_CHRONO_H
diff --git a/src/misc/BenchKit/HWChronometer.h b/src/misc/BenchKit/HWChronometer.h
new file mode 100644
index 00000000..331f9a7d
--- /dev/null
+++ b/src/misc/BenchKit/HWChronometer.h
@@ -0,0 +1,66 @@
+/* ========================================
+
+Copyright (C) 2025, Amlal El Mahrouss, licensed under the Apache 2.0 license.
+
+======================================== */
+
+#pragma once
+
+#include <misc/BenchKit/Chronometer.h>
+
+namespace Kernel {
+struct HWChronoTraits;
+
+template <typename ChronoTraits = HWChronoTraits>
+class HWChrono;
+
+/// @brief BenchKit chrono logic for x64/ARM64.
+struct HWChronoTraits final {
+ private:
+  STATIC UInt64 TickImpl_(void) {
+#ifdef __NE_AMD64__
+    UInt64 a = 0, d = 0;
+
+    asm volatile("rdtsc" : "=a"(a), "=d"(d));
+
+    return (d << 32) | a;
+#elif defined(__NE_ARM64__)
+    UInt64 result;
+
+    asm volatile("mrs %0, cntvct_el1" : "=r"(result));
+
+    return result;
+#else
+#error !!! no backend defined !!!
+#endif
+  }
+
+  friend HWChrono<HWChronoTraits>;
+};
+
+/// @brief hardware chronometer implementation using a trait to extract the data.
+template <typename ChronoTraits>
+class HWChrono BENCHKIT_INTERFACE {
+ public:
+  HWChrono()                   = default;
+  virtual ~HWChrono() override = default;
+
+  NE_COPY_DEFAULT(HWChrono)
+
+ public:
+  Void Start() override { fStart = ChronoTraits::TickImpl_(); }
+
+  Void Stop() override { fStop = ChronoTraits::TickImpl_(); }
+
+  Void Reset() override {
+    fStart = 0;
+    fStop  = 0;
+  }
+
+  UInt64 GetElapsedTime() const override { return fStop - fStart; }
+
+ private:
+  UInt64 fStart{};
+  UInt64 fStop{};
+};
+}  // namespace Kernel