Merge develop into main for release v0.9.2

Author: Galfurian

CMakeLists.txt

@@ -73,8 +73,6 @@ else()
     else()
         # set(EMULATOR_FLAGS ${EMULATOR_FLAGS} -sdl)
     endif()
-    # Speicfy the linker.
-    set(CMAKE_LINKER ld)
 endif()
 
 # =============================================================================

README.md

@@ -7,14 +7,27 @@
 [![Ubuntu](https://github.com/mentos-team/MentOS/actions/workflows/ubuntu.yml/badge.svg)](https://github.com/mentos-team/MentOS/actions/workflows/ubuntu.yml)
 [![Documentation](https://github.com/mentos-team/MentOS/actions/workflows/documentation.yml/badge.svg)](https://github.com/mentos-team/MentOS/actions/workflows/documentation.yml)
 
+---
+
+> 📢 **Note:** The new default branch is `main`.  
+> The old `master` branch will remain available temporarily but is no longer updated.
+
+---
+
 ## Table of Contents
 
 - [MentOS (Mentoring Operating System)](#mentos-mentoring-operating-system)
   - [Table of Contents](#table-of-contents)
   - [What is MentOS](#what-is-mentos)
   - [Implemented features](#implemented-features)
+    - [Processes and Events](#processes-and-events)
+    - [Memory](#memory)
+    - [Filesystem](#filesystem)
+    - [Input/Output](#inputoutput)
+    - [Inter-Process Communication (IPC)](#inter-process-communication-ipc)
   - [Prerequisites](#prerequisites)
-    - [Installing the prerequisites](#installing-the-prerequisites)
+    - [Compiling on Ubuntu / WSL1 / WSL2](#compiling-on-ubuntu--wsl1--wsl2)
+    - [Compiling on ARM (e.g., Ubuntu ARM / Apple Silicon in a Linux VM)](#compiling-on-arm-eg-ubuntu-arm--apple-silicon-in-a-linux-vm)
   - [Compiling MentOS](#compiling-mentos)
   - [Generating the EXT2 filesystem](#generating-the-ext2-filesystem)
   - [Running MentOS](#running-mentos)
@@ -28,6 +41,8 @@
   - [Debugging the kernel](#debugging-the-kernel)
   - [Contributors](#contributors)
 
+---
+
 ## What is MentOS
 
 MentOS (Mentoring Operating System) is an open source educational operating
@@ -52,6 +67,8 @@ Gualandri.
 
 *[Back to the Table of Contents](#table-of-contents)*
 
+---
+
 ## Implemented features
 
 Follows the list of implemented features:
@@ -107,37 +124,31 @@ I will try to keep it updated...
 
 *[Back to the Table of Contents](#table-of-contents)*
 
-## Prerequisites
-
-MentOS is compatible with the main **unix-based** operating systems. It has been
-tested with *Ubuntu*, and under Windows with *WSL1* and *WSL2*.
-
-For **compiling** the system we need:
-
-- git
-- gcc
-- nasm
-- make
-- cmake
-- ccmake (suggested)
-- e2fsprogs (should be already installed)
+---
 
-Under **MacOS**, for compiling, you have additional dependencies:
-
-- i386-elf-binutils
-- i386-elf-gcc
+## Prerequisites
 
-For **executing** the operating system we need:
+MentOS is compatible with the main **Unix-based** operating systems. It has been tested with:
 
-- qemu-system-i386 (or qemu-system-x86)
+- **Ubuntu**
+- **WSL1 / WSL2**
+- **macOS** (via cross-compilation using i386 toolchains)
 
-For **debugging** we suggest using:
+The prerequisites vary depending on your platform. Follow the section below that matches your system.
 
-- gdb or cgdb
+### Compiling on Ubuntu / WSL1 / WSL2
 
-### Installing the prerequisites
+To **build and run** MentOS, install:
 
-Under **Ubuntu**, you can type the following commands:
+- `git`
+- `gcc`
+- `nasm`
+- `make`
+- `cmake`
+- `ccmake` (optional, for curses-based CMake GUI)
+- `e2fsprogs`
+- `qemu-system-x86` (or `qemu-system-i386` on older versions)
+- `gdb` or `cgdb` (recommended for debugging)
 
 ```bash
 sudo apt-get update && sudo apt-get upgrade -y
@@ -146,13 +157,21 @@ sudo apt-get install -y qemu-system-x86
 sudo apt-get install -y gdb cgdb
 ```
 
-Note: Older versions might have `qemu-system-i386` instead of `qemu-system-x86`.
+On older Ubuntu systems, the QEMU package might be named qemu-system-i386.
 
-*[Back to the Table of Contents](#table-of-contents)*
+### Compiling on ARM (e.g., Ubuntu ARM / Apple Silicon in a Linux VM)
+
+To compile MentOS on **ARM-based Linux** (e.g., Ubuntu ARM or Apple Silicon using UTM/Parallels), you must install a cross-compilation toolchain for i386:
+
+```bash
+sudo apt-get install -y gcc-i686-linux-gnu libc6-dev-i386-cross
+```
+
+---
 
 ## Compiling MentOS
 
-Compile MentOS with:
+To **compile** MentOS on **Ubuntu / WSL1 / WSL2**:
 
 ```bash
 cd <clone_directory>
@@ -162,8 +181,20 @@ cmake ..
 make
 ```
 
+To **compile** MentOS on **ARM** (cross-compilation):
+
+```bash
+cd <clone_directory>
+mkdir build
+cd build
+cmake .. -DCMAKE_C_COMPILER=i686-linux-gnu-gcc -DCMAKE_LINKER=i686-linux-gnu-ld
+make
+```
+
 *[Back to the Table of Contents](#table-of-contents)*
 
+---
+
 ## Generating the EXT2 filesystem
 
 Generate the EXT2 filesystem with:
@@ -176,6 +207,8 @@ you just need to generate the filesystem once. If you change a `program` you nee
 
 *[Back to the Table of Contents](#table-of-contents)*
 
+---
+
 ## Running MentOS
 
 Boot MentOS with qemu:
@@ -188,6 +221,8 @@ To login, use one of the usernames listed in `files/etc/passwd`.
 
 *[Back to the Table of Contents](#table-of-contents)*
 
+---
+
 ## Running MentOS from GRUB
 
 For booting MentOS from GRUB in QEMU we need the following tools:
@@ -212,6 +247,8 @@ make qemu-grub
 
 *[Back to the Table of Contents](#table-of-contents)*
 
+---
+
 ## Running and adding new programs to MentOS
 
 This section explains how to add a new program to MentOS, and also how to run programs in mentos. It also explains how to add new tests, which are located in the `programs/tests` folder.
@@ -278,6 +315,8 @@ However, the `/bin/tests` folder is not listed in `PATH`, so, if you want to exe
 
 *[Back to the Table of Contents](#table-of-contents)*
 
+---
+
 ## Kernel logging
 
 The kernel provides ways of printing logging messages *from* inside the kernel code *to* the bash where you executed the `make qemu`.
@@ -338,6 +377,8 @@ This example sets the `__DEBUG_LEVEL__`, so that all the messages from `INFO` an
 
 *[Back to the Table of Contents](#table-of-contents)*
 
+---
+
 ## Change the scheduling algorithm
 
 MentOS supports scheduling algorithms for aperiodic:
@@ -406,6 +447,8 @@ make qemu
 
 *[Back to the Table of Contents](#table-of-contents)*
 
+---
+
 ## Debugging the kernel
 
 If you want to use GDB to debug MentOS, first you need to compile everything:
@@ -475,6 +518,8 @@ to connect to the running process.
 
 *[Back to the Table of Contents](#table-of-contents)*
 
+---
+
 ## Contributors
 
 Project Manager: