From 610f91d87152cbe48d3054fcf437d8239da6ef35 Mon Sep 17 00:00:00 2001
From: Amlal <amlalelmahrouss@icloud.com>
Date: Sat, 21 Dec 2024 21:59:13 +0100
Subject: IMP: :boom: Breaking changes some checks are needed to be done.

Signed-off-by: Amlal <amlalelmahrouss@icloud.com>
---
 dev/Kernel/doc/Explicit Partition Map.pdf | Bin 0 -> 12364 bytes
 dev/Kernel/doc/SPECIFICATION.md           |  63 ++++++++++++++++++++++++++++++
 dev/Kernel/doc/TODO-LIST.md               |  25 ++++++++++++
 3 files changed, 88 insertions(+)
 create mode 100644 dev/Kernel/doc/Explicit Partition Map.pdf
 create mode 100644 dev/Kernel/doc/SPECIFICATION.md
 create mode 100644 dev/Kernel/doc/TODO-LIST.md

(limited to 'dev/Kernel/doc')

diff --git a/dev/Kernel/doc/Explicit Partition Map.pdf b/dev/Kernel/doc/Explicit Partition Map.pdf
new file mode 100644
index 00000000..a73834cd
Binary files /dev/null and b/dev/Kernel/doc/Explicit Partition Map.pdf differ
diff --git a/dev/Kernel/doc/SPECIFICATION.md b/dev/Kernel/doc/SPECIFICATION.md
new file mode 100644
index 00000000..0233643a
--- /dev/null
+++ b/dev/Kernel/doc/SPECIFICATION.md
@@ -0,0 +1,63 @@
+===================================
+
+# 0: General Information
+
+===================================
+
+- ABI and Format: PEF/PE32+.
+- Kernel architecture: Portable hybrid Kernel.
+- Language: C++/(Assembly (AMD64, X64000, X86S, ARM64, POWER, RISCV))
+
+===================================
+
+# 1: The Kernel
+
+===================================
+
+- Drive/Device Abstraction.
+- SMP, Preemptive Multi Threading.
+- Separation of Files/Devices.
+- Networking.
+- Hardware Abstraction Layer.
+- Native Filesystem support (NeFS, FAT32 and ffs2).
+- Program Loaders interfaces.
+- TLS (Thread Local Storage) support.
+- Semaphore, Locks, Timers.
+- Canary mechanisms.
+- Dynamic Sys.
+- Cross Platform.
+- Permission Selectors.
+
+===================================
+
+# 2: The Filesystem
+
+===================================
+
+- Catalog object with associated forks.
+- Large storage support.
+- Long file names.
+- UNIX path style.
+
+==================================
+
+# 3: Common naming conventions:
+
+==================================
+
+- Kernel -> ke_init_x
+- RunTime -> rt_copy_mem
+- Hal -> hal_foo_bar
+- Class methods -> Class::FooBar
+
+===================================
+
+# 4: The zbaosldr
+
+===================================
+
+- Capable of booting from a network drive.
+- Loads a PE file which is the Kernel.
+- Sanity checks, based on the number of sections.
+- Handover compliant.
+- Does check for a valid partition (useful in the case of recovering)
diff --git a/dev/Kernel/doc/TODO-LIST.md b/dev/Kernel/doc/TODO-LIST.md
new file mode 100644
index 00000000..6e8e4b4d
--- /dev/null
+++ b/dev/Kernel/doc/TODO-LIST.md
@@ -0,0 +1,25 @@
+# TODO list
+
+- We need preemptive multi-threading. [ X ]
+- We then need sync primitives. [ X ]
+- We also need a system library for the OS. [ X ]
+- We need a bootloader for AMD64 [ X ]
+  - Implement Boot Services [ X ]
+  - Design Handover [ X ]
+  - Load Kernel into memory [ X ]
+  - Fix bug in Kernel loader, which causes a 06 #UD. [ X ]
+  - Load Kernel [ X ]
+  - Add IDT [ X ]
+  - AHCI driver [ WiP ]
+- Context switch x87/SSE/AVX registers [ X ]
+- Framebuffer [ X ]
+- ATA support [ X ]
+- Make installer [ X ]
+
+Status:
+
+BootZ: Need to boot from EPM partition. [ X ]
+<br>
+minoskrnl: New Filesystem is done. [ X ]
+
+**Refer to Jira please!**
-- 
cgit v1.2.3