summaryrefslogtreecommitdiffhomepage
path: root/dev/libSystem/docs/SPECIFICATION_SYSCALLS.md
diff options
context:
space:
mode:
authorAmlal El Mahrouss <amlal@nekernel.org>2025-05-29 10:51:53 +0200
committerGitHub <noreply@github.com>2025-05-29 10:51:53 +0200
commit5c0bb7ee7b1b0fee02cc179fb21f4c57a61d6c2d (patch)
treecb17577bcdc9714c97a84ce417a075117097f146 /dev/libSystem/docs/SPECIFICATION_SYSCALLS.md
parentd608230b1350b064ceb01e6572519b108f6139b0 (diff)
parent3167f59dbb401d6a79b1524537e04218baf49ee3 (diff)
Merge pull request #32 from nekernel-org/dev
0.0.2e3
Diffstat (limited to 'dev/libSystem/docs/SPECIFICATION_SYSCALLS.md')
-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