summaryrefslogtreecommitdiffhomepage
path: root/dev/libSystem/docs
diff options
context:
space:
mode:
authorAmlal El Mahrouss <amlal@nekernel.org>2025-05-27 20:03:26 +0200
committerAmlal El Mahrouss <amlal@nekernel.org>2025-05-27 20:06:13 +0200
commit1a44b4385b3250cd90e255d7d787ae69e987544b (patch)
treefb637575951b8cc98834bed59daf4072583d5a17 /dev/libSystem/docs
parentbdc831c1df0dd2af95f09fd1b86b4472c40d12b7 (diff)
feat: generic_kits: Add X64Chrono inside BenchKit.
refactor: libSystem: Refactored as a whole. Signed-off-by: Amlal El Mahrouss <amlal@nekernel.org>
Diffstat (limited to 'dev/libSystem/docs')
-rw-r--r--dev/libSystem/docs/SPECIFICATION_SYSCALLS.md25
1 files changed, 25 insertions, 0 deletions
diff --git a/dev/libSystem/docs/SPECIFICATION_SYSCALLS.md b/dev/libSystem/docs/SPECIFICATION_SYSCALLS.md
new file mode 100644
index 00000000..b4b11c8c
--- /dev/null
+++ b/dev/libSystem/docs/SPECIFICATION_SYSCALLS.md
@@ -0,0 +1,25 @@
+===================================
+# 0: General Information
+===================================
+
+- **Programming Language**: C / C++
+- **Build System**: Make / BTB (Build the Build)
+- **Purpose**: System Call Interface (SCI) for NeKernel
+
+===================================
+# 1: How It Works
+===================================
+
+- This header provides the raw API surface for accessing NeKernel's system calls.
+
+- It is **not** directly used by applications.
+ - Instead, it is abstracted by the **SystemSDK**, which presents a stable, high-level interface.
+
+- At runtime:
+ - System calls are routed from user-space code to the **kernel syscall manager**.
+ - The syscall manager executes the requested operation and returns control to `libSystem`.
+ - Finally, the result is delivered back to the originating process.
+
+- This separation ensures that:
+ - The SCI remains low-level and close to the ABI.
+ - `SystemSDK` provides portability and shielding from changes in syscall internals. \ No newline at end of file