Merge branch 'release/v0.5.3'

Debugging hotfix

.github/workflows/main.yml

@@ -1,52 +1,90 @@
 name: Main
 on:
-  push:
+    push:
-    branches-ignore:
+        branches-ignore:
-      - "releases/**"
+            - "releases/**"
-    paths-ignore:
+        paths-ignore:
-      - "**.md"
+            - "**.md"
-      - ".gitignore"
+            - ".gitignore"
-  pull_request:
+    pull_request:
-    paths-ignore:
+        paths-ignore:
-      - "**.md"
+            - "**.md"
-      - ".gitignore"
+            - ".gitignore"
 jobs:
-  doxygen:
+    doxygen:
-    name: Doxygen
+        name: Doxygen
-    runs-on: ubuntu-latest
+        runs-on: ubuntu-latest
-    steps:
+        steps:
-      - name: Clone repo
+            - name: Clone repo
-        uses: actions/checkout@v2
+              uses: actions/checkout@v3
 
-      - name: Install Doxygen Ubuntu
+            - name: Install Doxygen Ubuntu
-        run: |
+              run: |
-          sudo apt-get update
+                  sudo apt-get update
-          sudo apt-get install -y doxygen nasm
+                  sudo apt-get install -y doxygen nasm
 
-      - name: Generate documentation
+            - name: Generate documentation
-        run: |
+              run: |
-          cmake -B build -D DOXYGEN_WARN_AS_ERROR=NO
+                  cmake -B build -D DOXYGEN_WARN_AS_ERROR=NO
-          cmake --build build --target doxygen_doc
+                  cmake --build build --target mentos_documentation
 
-  test:
+    test:
-    name: Build
+        name: Build
-    strategy:
+        strategy:
-      fail-fast: false
+            fail-fast: false
-      matrix:
+            matrix:
-        os: [ubuntu-latest]
+                include: [
+                    # You can access the following values via ${{ matrix.??? }}
+                    #
+                    #   pkgs         : apt-get package names.  It can include multiple package names which are delimited by space.
+                    #   cc           : C compiler executable.
+                    #   cxx          : C++ compiler executable for `make ctocpptest`.
+                    #   x32          : Set 'true' if compiler supports x32.  Otherwise, set 'false'.
+                    #                  Set 'fail' if it supports x32 but fails for now.  'fail' cases must be removed.
+                    #   x86          : Set 'true' if compiler supports x86 (-m32).  Otherwise, set 'false'.
+                    #                  Set 'fail' if it supports x86 but fails for now.  'fail' cases must be removed.
+                    #   cxxtest      : Set 'true' if it can be compiled as C++ code.  Otherwise, set 'false'.
+                    #   freestanding : Set 'true' if it can be compiled and execute freestanding code.  Otherwise, set 'false'.
+                    #                  Usually, it requires Linux, x86_64 and gcc/g++.
+                    #   os           : GitHub Actions YAML workflow label.  See https://github.com/actions/virtual-environments#available-environments
+                    # gcc
+                    { pkgs: 'nasm',               cc: gcc,    cxx: g++,    os: ubuntu-latest, },
+                    { pkgs: 'gcc-12 g++-12 nasm', cc: gcc-12, cxx: g++-12, os: ubuntu-22.04,  },
+                    { pkgs: 'gcc-11 g++-11 nasm', cc: gcc-11, cxx: g++-11, os: ubuntu-22.04,  },
+                    { pkgs: 'gcc-10 g++-10 nasm', cc: gcc-10, cxx: g++-10, os: ubuntu-22.04,  },
+                    { pkgs: 'gcc-9 g++-9 nasm',   cc: gcc-9,  cxx: g++-9,  os: ubuntu-22.04,  },
+                    { pkgs: 'gcc-8 g++-8 nasm',   cc: gcc-8,  cxx: g++-8,  os: ubuntu-20.04,  },
+                    { pkgs: 'gcc-7 g++-7 nasm',   cc: gcc-7,  cxx: g++-7,  os: ubuntu-20.04,  },
+                    # clang
+                    { pkgs: 'nasm',          cc: clang,    cxx: clang++,    os: ubuntu-latest, },
+                    { pkgs: 'clang-14 nasm', cc: clang-14, cxx: clang++-14, os: ubuntu-22.04,  },
+                    { pkgs: 'clang-13 nasm', cc: clang-13, cxx: clang++-13, os: ubuntu-22.04,  },
+                    { pkgs: 'clang-12 nasm', cc: clang-12, cxx: clang++-12, os: ubuntu-22.04,  },
+                    { pkgs: 'clang-11 nasm', cc: clang-11, cxx: clang++-11, os: ubuntu-22.04,  },
+                    { pkgs: 'clang-10 nasm', cc: clang-10, cxx: clang++-10, os: ubuntu-20.04,  },
+                    { pkgs: 'clang-9 nasm',  cc: clang-9,  cxx: clang++-9,  os: ubuntu-20.04,  },
+                    { pkgs: 'clang-8 nasm',  cc: clang-8,  cxx: clang++-8,  os: ubuntu-20.04,  },
+                    { pkgs: 'clang-7 nasm',  cc: clang-7,  cxx: clang++-7,  os: ubuntu-20.04,  },
+                ]
 
-    runs-on: ${{ matrix.os }}
+        runs-on: ${{ matrix.os }}
-    steps:
-      - name: Clone repo
-        uses: actions/checkout@v2
 
-      - name: Install NASM Ubuntu
+        # Set environment variables
-        if: matrix.os == 'ubuntu-latest'
+        env:
-        run: |
+            # We globally set CC and CXX to improve compatibility with .travis.yml
-          sudo apt-get update
+            CC: ${{ matrix.cc }}
-          sudo apt-get install -y nasm
+            CXX: ${{ matrix.cxx }}
 
-      - name: Build
+        steps:
-        run: |
+            - name: Clone repo
-          cmake -B build
+              uses: actions/checkout@v3
-          cmake --build build --parallel 2
+
+            - name: Install dependencies
+              run: |
+                  sudo apt-get update
+                  sudo apt-get install -y ${{ matrix.pkgs }}
+
+            - name: Build
+              run: |
+                  cmake -B build
+                  cmake --build build --parallel 2 --verbose

CMakeLists.txt

@@ -17,7 +17,7 @@ endif()
 # =============================================================================
 # DOCUMENTATION
 # =============================================================================
-add_subdirectory(doc/doxygen)
+add_subdirectory(doc)
 
 # =============================================================================
 # OS-SPECIFIC COMPILERS
@@ -68,6 +68,8 @@ else()
     else()
         # set(EMULATOR_FLAGS ${EMULATOR_FLAGS} -sdl)
     endif()
+    # Speicfy the linker.
+    set(CMAKE_LINKER ld)
 endif()
 
 # =============================================================================
@@ -93,7 +95,7 @@ add_custom_target(filesystem
     COMMAND echo '============================================================================='
     COMMAND mkdir -p ${CMAKE_SOURCE_DIR}/files/proc
     COMMAND mkdir -p ${CMAKE_SOURCE_DIR}/files/dev
-    COMMAND mke2fs -L 'rootfs' -N 0 -d ${CMAKE_SOURCE_DIR}/files -m 5 -r 1 -t ext2 -v -F ${CMAKE_BINARY_DIR}/rootfs.img 32M
+    COMMAND mke2fs -L 'rootfs' -N 0 -d ${CMAKE_SOURCE_DIR}/files -b 4096 -m 5 -r 1 -t ext2 -v -F ${CMAKE_BINARY_DIR}/rootfs.img 32M
     COMMAND echo '============================================================================='
     COMMAND echo 'Done!'
     COMMAND echo '============================================================================='
@@ -155,7 +157,7 @@ add_custom_target(
 # First, we need to generate a GDB file containing all the symbols of all our
 # executables.
 add_custom_target(
-    .gdbinit
+    gdbinit
     BYPRODUCTS ${CMAKE_BINARY_DIR}/.gdbinit
     COMMAND bash ${CMAKE_SOURCE_DIR}/scripts/get_text_address.sh ${CMAKE_BINARY_DIR}/mentos/kernel.bin > ${CMAKE_BINARY_DIR}/.gdbinit
     COMMAND bash ${CMAKE_SOURCE_DIR}/scripts/get_text_address.sh ${CMAKE_BINARY_DIR}/mentos/kernel-bootloader.bin >> ${CMAKE_BINARY_DIR}/.gdbinit

README.md

@@ -202,29 +202,42 @@ This example sets the `__DEBUG_LEVEL__`, so that all the messages from `INFO` an
 
 ## 7. Change the scheduling algorithm
 
-MentOS provides three different scheduling algorithms:
+MentOS supports scheduling algorithms for aperiodic:
 
- - Round-Robin
+ - Round-Robin (RR)
- - Priority
+ - Highest Priority
- - Completely Fair Scheduling
+ - Completely Fair Scheduling (CFS)
+ - Aperiodic Earliest Deadline First (AEDF)
 
-If you want to change the scheduling algorithm:
+It also supports periodic algorithms:
+
+ - Earliest Deadline First (EDF)
+ - Rate Monotonic (RM)
+
+If you want to change the scheduling algorithm, to Round-Robin (RR) for instance:
 
 ```bash
-
 cd build
-
-# Round Robin scheduling algorithm
 cmake -DSCHEDULER_TYPE=SCHEDULER_RR ..
-# Priority scheduling algorithm
-cmake -DSCHEDULER_TYPE=SCHEDULER_PRIORITY ..
-# Completely Fair Scheduling algorithm
-cmake -DSCHEDULER_TYPE=SCHEDULER_CFS ..
-
 make
 make qemu
 ```
 
+or you can activate one of the others:
+
+```bash
+# Highest Priority
+cmake -DSCHEDULER_TYPE=SCHEDULER_PRIORITY ..
+# Completely Fair Scheduling (CFS)
+cmake -DSCHEDULER_TYPE=SCHEDULER_CFS      ..
+# Earliest Deadline First (EDF)
+cmake -DSCHEDULER_TYPE=SCHEDULER_EDF      ..
+# Rate Monotonic (RM)
+cmake -DSCHEDULER_TYPE=SCHEDULER_RM       ..
+# Aperiodic Earliest Deadline First (AEDF)
+cmake -DSCHEDULER_TYPE=SCHEDULER_AEDF     ..
+```
+
 Otherwise you can use `ccmake`:
 
 ```bash
@@ -244,8 +257,7 @@ ENABLE_BUDDY_SYSTEM              OFF
 SCHEDULER_TYPE                   SCHEDULER_RR
 ```
 
-Select SCHEDULER_TYPE, and type Enter to scroll the three available algorithms
+Select SCHEDULER_TYPE, and type Enter to scroll the three available algorithms (SCHEDULER_RR, SCHEDULER_PRIORITY, SCHEDULER_CFS, SCHEDULER_EDF, SCHEDULER_RM, SCHEDULER_AEDF). Afterwards, you need to
-(SCHEDULER_RR, SCHEDULER_PRIORITY, SCHEDULER_CFS). Afterwards,
 
 ```bash
 <press c>
@@ -264,33 +276,34 @@ cmake ..
 make
 ```
 
-Then, you need to generate a file called `.gdbinit` placed inside the `build` directory, which will tell **gdb** which *object* file he needs to read in order to allow proper debugging.
+Then, you need to generate a file called `.gdbinit` placed inside the `build` directory, which will tell **gdb** which *object* file he needs to read in order to allow proper debugging. Basically, it provides for each binary file, the location of their `.text` section. To generate the file, just execute:
 ```bash
-make gdb_file
+make gdbinit
 ```
 
 Finally, you run qemu in debugging mode with:
 ```bash
 make qemu-gdb
 ```
+
 If you did everything correctly, you should see an empty QEMU window. Basically, QEMU is waiting for you to connect *remotely* with gdb. Anyway, running `make qemu-gdb` will make your current shell busy, you cannot call `gdb` in it. You need to open a new shell inside the `build` folder and do a:
 ```bash
 cgdb -q -iex 'add-auto-load-safe-path .'
 ```
 
-Now you will have:
+Now you should have in front of you:
-1. the QEMU window waiting for you,
+ 1. the QEMU window waiting for you;
-2. the shell where you ran `make qemu-gdb` also waiting for you,
+ 2. the **first** shell where you ran `make qemu-gdb`, which is also waiting for you;
-3. the debugger that loaded a series of symbol files and the location of their `.text` section.
+ 3. the **second** shell where `gdb` is runnign and, you guessed it, is waiting for you.
 
-By default I placed a breakpoint at the begginning of 1) the bootloader, 2) the `kmain` function of the kernel.
+By default I placed a breakpoint at the begginning of (1) the *bootloader* and (2) the *kernel* itself.
 
 So, when gdb starts you need to first give a continue:
 ```bash
 (gdb) continue
 ```
 
-This will make the kernel run, and stop at the first breakpoint which is inside the *bootloader*:
+This will make the kernel run, and stop at the **first** breakpoint which is inside the *bootloader*:
 ```bash
 Breakpoint 1, boot_main (...) at .../mentos/src/boot.c:220
 220     {
@@ -298,7 +311,7 @@ Breakpoint 1, boot_main (...) at .../mentos/src/boot.c:220
 
 giving a second `continue` will get you to the start of the operating system:
 
-This will make the kernel run, and stop at the first breakpoint which is inside the *bootloader*:
+This will make the kernel run, and stop at the **second** breakpoint which is inside the *kernel*:
 ```bash
 Breakpoint 2, kmain (...) at .../mentos/src/kernel.c:95
 95      {

doc/CMakeLists.txt

@@ -0,0 +1,290 @@
+# Find Doxygen
+find_package(Doxygen)
+
+if (DOXYGEN_FOUND)
+    # Read the file with the version.
+    file(READ ${PROJECT_SOURCE_DIR}/mentos/inc/version.h version_file)
+    # Extract the OS version.
+    string(REGEX MATCH "OS_MAJOR_VERSION ([0-9]*)" _ ${version_file})
+    set(OS_MAJOR_VERSION ${CMAKE_MATCH_1})
+    string(REGEX MATCH "OS_MINOR_VERSION ([0-9]*)" _ ${version_file})
+    set(OS_MINOR_VERSION ${CMAKE_MATCH_1})
+    string(REGEX MATCH "OS_MICRO_VERSION ([0-9]*)" _ ${version_file})
+    set(OS_MICRO_VERSION ${CMAKE_MATCH_1})
+    # Setup the Doxygen documentation.
+    set(DOXYGEN_PROJECT_NAME "MentOS")
+    set(DOXYGEN_PROJECT_NUMBER "${OS_MAJOR_VERSION}.${OS_MINOR_VERSION}.${OS_MICRO_VERSION}")
+    set(DOXYGEN_PROJECT_BRIEF "The Mentoring Operating System")
+    set(DOXYGEN_USE_MDFILE_AS_MAINPAGE ${PROJECT_SOURCE_DIR}/README.md)
+    set(DOXYGEN_IMAGE_PATH ${PROJECT_SOURCE_DIR}/doc/resources)
+    set(DOXYGEN_SHOW_INCLUDE_FILES NO)
+    set(DOXYGEN_GENERATE_TREEVIEW NO)
+    set(DOXYGEN_WARN_NO_PARAMDOC YES)
+    set(DOXYGEN_HTML_STYLESHEET ${PROJECT_SOURCE_DIR}/doc/doxygen.css)
+    doxygen_add_docs(
+        ${PROJECT_NAME}_documentation
+        ${PROJECT_SOURCE_DIR}/README.md
+        ${PROJECT_SOURCE_DIR}/CODING_STYLE.md
+        ${PROJECT_SOURCE_DIR}/LICENSE.md
+        ${PROJECT_SOURCE_DIR}/TODO.md
+        ${PROJECT_SOURCE_DIR}/doc/signal.md
+        ${PROJECT_SOURCE_DIR}/doc/syscall.md
+        ${PROJECT_SOURCE_DIR}/libc/src/crt0.S
+        ${PROJECT_SOURCE_DIR}/libc/inc/array.h
+        ${PROJECT_SOURCE_DIR}/libc/inc/assert.h
+        ${PROJECT_SOURCE_DIR}/libc/inc/bits/ioctls.h
+        ${PROJECT_SOURCE_DIR}/libc/inc/bits/stat.h
+        ${PROJECT_SOURCE_DIR}/libc/inc/bits/termios-struct.h
+        ${PROJECT_SOURCE_DIR}/libc/inc/ctype.h
+        ${PROJECT_SOURCE_DIR}/libc/inc/debug.h
+        ${PROJECT_SOURCE_DIR}/libc/inc/fcntl.h
+        ${PROJECT_SOURCE_DIR}/libc/inc/fcvt.h
+        ${PROJECT_SOURCE_DIR}/libc/inc/grp.h
+        ${PROJECT_SOURCE_DIR}/libc/inc/io/mm_io.h
+        ${PROJECT_SOURCE_DIR}/libc/inc/io/port_io.h
+        ${PROJECT_SOURCE_DIR}/libc/inc/ipc/ipc.h
+        ${PROJECT_SOURCE_DIR}/libc/inc/ipc/msg.h
+        ${PROJECT_SOURCE_DIR}/libc/inc/ipc/sem.h
+        ${PROJECT_SOURCE_DIR}/libc/inc/ipc/shm.h
+        ${PROJECT_SOURCE_DIR}/libc/inc/libgen.h
+        ${PROJECT_SOURCE_DIR}/libc/inc/limits.h
+        ${PROJECT_SOURCE_DIR}/libc/inc/math.h
+        ${PROJECT_SOURCE_DIR}/libc/inc/pwd.h
+        ${PROJECT_SOURCE_DIR}/libc/inc/ring_buffer.h
+        ${PROJECT_SOURCE_DIR}/libc/inc/sched.h
+        ${PROJECT_SOURCE_DIR}/libc/inc/signal.h
+        ${PROJECT_SOURCE_DIR}/libc/inc/stdarg.h
+        ${PROJECT_SOURCE_DIR}/libc/inc/stdbool.h
+        ${PROJECT_SOURCE_DIR}/libc/inc/stddef.h
+        ${PROJECT_SOURCE_DIR}/libc/inc/stdint.h
+        ${PROJECT_SOURCE_DIR}/libc/inc/stdio.h
+        ${PROJECT_SOURCE_DIR}/libc/inc/stdlib.h
+        ${PROJECT_SOURCE_DIR}/libc/inc/strerror.h
+        ${PROJECT_SOURCE_DIR}/libc/inc/string.h
+        ${PROJECT_SOURCE_DIR}/libc/inc/sys/bitops.h
+        ${PROJECT_SOURCE_DIR}/libc/inc/sys/dirent.h
+        ${PROJECT_SOURCE_DIR}/libc/inc/sys/errno.h
+        ${PROJECT_SOURCE_DIR}/libc/inc/sys/ioctl.h
+        ${PROJECT_SOURCE_DIR}/libc/inc/sys/reboot.h
+        ${PROJECT_SOURCE_DIR}/libc/inc/sys/stat.h
+        ${PROJECT_SOURCE_DIR}/libc/inc/sys/types.h
+        ${PROJECT_SOURCE_DIR}/libc/inc/sys/unistd.h
+        ${PROJECT_SOURCE_DIR}/libc/inc/sys/utsname.h
+        ${PROJECT_SOURCE_DIR}/libc/inc/sys/wait.h
+        ${PROJECT_SOURCE_DIR}/libc/inc/system/syscall_types.h
+        ${PROJECT_SOURCE_DIR}/libc/inc/termios.h
+        ${PROJECT_SOURCE_DIR}/libc/inc/time.h
+        ${PROJECT_SOURCE_DIR}/libc/src/abort.c
+        ${PROJECT_SOURCE_DIR}/libc/src/assert.c
+        ${PROJECT_SOURCE_DIR}/libc/src/ctype.c
+        ${PROJECT_SOURCE_DIR}/libc/src/debug.c
+        ${PROJECT_SOURCE_DIR}/libc/src/fcvt.c
+        ${PROJECT_SOURCE_DIR}/libc/src/grp.c
+        ${PROJECT_SOURCE_DIR}/libc/src/io/mm_io.c
+        ${PROJECT_SOURCE_DIR}/libc/src/io/port_io.c
+        ${PROJECT_SOURCE_DIR}/libc/src/ipc/ipc.c
+        ${PROJECT_SOURCE_DIR}/libc/src/libc_start.c
+        ${PROJECT_SOURCE_DIR}/libc/src/libgen.c
+        ${PROJECT_SOURCE_DIR}/libc/src/math.c
+        ${PROJECT_SOURCE_DIR}/libc/src/pwd.c
+        ${PROJECT_SOURCE_DIR}/libc/src/sched.c
+        ${PROJECT_SOURCE_DIR}/libc/src/setenv.c
+        ${PROJECT_SOURCE_DIR}/libc/src/stdio.c
+        ${PROJECT_SOURCE_DIR}/libc/src/stdlib.c
+        ${PROJECT_SOURCE_DIR}/libc/src/strerror.c
+        ${PROJECT_SOURCE_DIR}/libc/src/string.c
+        ${PROJECT_SOURCE_DIR}/libc/src/sys/errno.c
+        ${PROJECT_SOURCE_DIR}/libc/src/sys/ioctl.c
+        ${PROJECT_SOURCE_DIR}/libc/src/sys/unistd.c
+        ${PROJECT_SOURCE_DIR}/libc/src/sys/utsname.c
+        ${PROJECT_SOURCE_DIR}/libc/src/termios.c
+        ${PROJECT_SOURCE_DIR}/libc/src/time.c
+        ${PROJECT_SOURCE_DIR}/libc/src/unistd/chdir.c
+        ${PROJECT_SOURCE_DIR}/libc/src/unistd/close.c
+        ${PROJECT_SOURCE_DIR}/libc/src/unistd/creat.c
+        ${PROJECT_SOURCE_DIR}/libc/src/unistd/exec.c
+        ${PROJECT_SOURCE_DIR}/libc/src/unistd/exit.c
+        ${PROJECT_SOURCE_DIR}/libc/src/unistd/fork.c
+        ${PROJECT_SOURCE_DIR}/libc/src/unistd/getcwd.c
+        ${PROJECT_SOURCE_DIR}/libc/src/unistd/getdents.c
+        ${PROJECT_SOURCE_DIR}/libc/src/unistd/getgid.c
+        ${PROJECT_SOURCE_DIR}/libc/src/unistd/getpgid.c
+        ${PROJECT_SOURCE_DIR}/libc/src/unistd/getpid.c
+        ${PROJECT_SOURCE_DIR}/libc/src/unistd/getppid.c
+        ${PROJECT_SOURCE_DIR}/libc/src/unistd/getsid.c
+        ${PROJECT_SOURCE_DIR}/libc/src/unistd/getuid.c
+        ${PROJECT_SOURCE_DIR}/libc/src/unistd/interval.c
+        ${PROJECT_SOURCE_DIR}/libc/src/unistd/kill.c
+        ${PROJECT_SOURCE_DIR}/libc/src/unistd/lseek.c
+        ${PROJECT_SOURCE_DIR}/libc/src/unistd/mkdir.c
+        ${PROJECT_SOURCE_DIR}/libc/src/unistd/nice.c
+        ${PROJECT_SOURCE_DIR}/libc/src/unistd/open.c
+        ${PROJECT_SOURCE_DIR}/libc/src/unistd/read.c
+        ${PROJECT_SOURCE_DIR}/libc/src/unistd/reboot.c
+        ${PROJECT_SOURCE_DIR}/libc/src/unistd/rmdir.c
+        ${PROJECT_SOURCE_DIR}/libc/src/unistd/setgid.c
+        ${PROJECT_SOURCE_DIR}/libc/src/unistd/setpgid.c
+        ${PROJECT_SOURCE_DIR}/libc/src/unistd/setsid.c
+        ${PROJECT_SOURCE_DIR}/libc/src/unistd/setuid.c
+        ${PROJECT_SOURCE_DIR}/libc/src/unistd/signal.c
+        ${PROJECT_SOURCE_DIR}/libc/src/unistd/stat.c
+        ${PROJECT_SOURCE_DIR}/libc/src/unistd/unlink.c
+        ${PROJECT_SOURCE_DIR}/libc/src/unistd/waitpid.c
+        ${PROJECT_SOURCE_DIR}/libc/src/unistd/write.c
+        ${PROJECT_SOURCE_DIR}/libc/src/vscanf.c
+        ${PROJECT_SOURCE_DIR}/libc/src/vsprintf.c
+        ${PROJECT_SOURCE_DIR}/mentos/src/boot.S
+        ${PROJECT_SOURCE_DIR}/mentos/src/descriptor_tables/exception.S
+        ${PROJECT_SOURCE_DIR}/mentos/src/descriptor_tables/gdt.S
+        ${PROJECT_SOURCE_DIR}/mentos/src/descriptor_tables/idt.S
+        ${PROJECT_SOURCE_DIR}/mentos/src/descriptor_tables/interrupt.S
+        ${PROJECT_SOURCE_DIR}/mentos/src/descriptor_tables/tss.S
+        ${PROJECT_SOURCE_DIR}/mentos/src/process/user.S
+        ${PROJECT_SOURCE_DIR}/mentos/inc/boot.h
+        ${PROJECT_SOURCE_DIR}/mentos/inc/descriptor_tables/gdt.h
+        ${PROJECT_SOURCE_DIR}/mentos/inc/descriptor_tables/idt.h
+        ${PROJECT_SOURCE_DIR}/mentos/inc/descriptor_tables/isr.h
+        ${PROJECT_SOURCE_DIR}/mentos/inc/descriptor_tables/tss.h
+        ${PROJECT_SOURCE_DIR}/mentos/inc/devices/fpu.h
+        ${PROJECT_SOURCE_DIR}/mentos/inc/devices/pci.h
+        ${PROJECT_SOURCE_DIR}/mentos/inc/drivers/ata.h
+        ${PROJECT_SOURCE_DIR}/mentos/inc/drivers/fdc.h
+        ${PROJECT_SOURCE_DIR}/mentos/inc/drivers/keyboard/keyboard.h
+        ${PROJECT_SOURCE_DIR}/mentos/inc/drivers/keyboard/keymap.h
+        ${PROJECT_SOURCE_DIR}/mentos/inc/drivers/mouse.h
+        ${PROJECT_SOURCE_DIR}/mentos/inc/drivers/ps2.h
+        ${PROJECT_SOURCE_DIR}/mentos/inc/drivers/rtc.h
+        ${PROJECT_SOURCE_DIR}/mentos/inc/elf/elf.h
+        ${PROJECT_SOURCE_DIR}/mentos/inc/fs/ext2.h
+        ${PROJECT_SOURCE_DIR}/mentos/inc/fs/ioctl.h
+        ${PROJECT_SOURCE_DIR}/mentos/inc/fs/procfs.h
+        ${PROJECT_SOURCE_DIR}/mentos/inc/fs/vfs.h
+        ${PROJECT_SOURCE_DIR}/mentos/inc/fs/vfs_types.h
+        ${PROJECT_SOURCE_DIR}/mentos/inc/hardware/cpuid.h
+        ${PROJECT_SOURCE_DIR}/mentos/inc/hardware/pic8259.h
+        ${PROJECT_SOURCE_DIR}/mentos/inc/hardware/timer.h
+        ${PROJECT_SOURCE_DIR}/mentos/inc/io/debug.h
+        ${PROJECT_SOURCE_DIR}/mentos/inc/io/mm_io.h
+        ${PROJECT_SOURCE_DIR}/mentos/inc/io/port_io.h
+        ${PROJECT_SOURCE_DIR}/mentos/inc/io/proc_modules.h
+        ${PROJECT_SOURCE_DIR}/mentos/inc/io/vga/vga.h
+        ${PROJECT_SOURCE_DIR}/mentos/inc/io/vga/vga_font.h
+        ${PROJECT_SOURCE_DIR}/mentos/inc/io/vga/vga_mode.h
+        ${PROJECT_SOURCE_DIR}/mentos/inc/io/vga/vga_palette.h
+        ${PROJECT_SOURCE_DIR}/mentos/inc/io/video.h
+        ${PROJECT_SOURCE_DIR}/mentos/inc/kernel.h
+        ${PROJECT_SOURCE_DIR}/mentos/inc/klib/compiler.h
+        ${PROJECT_SOURCE_DIR}/mentos/inc/klib/hashmap.h
+        ${PROJECT_SOURCE_DIR}/mentos/inc/klib/irqflags.h
+        ${PROJECT_SOURCE_DIR}/mentos/inc/klib/list.h
+        ${PROJECT_SOURCE_DIR}/mentos/inc/klib/list_head.h
+        ${PROJECT_SOURCE_DIR}/mentos/inc/klib/mutex.h
+        ${PROJECT_SOURCE_DIR}/mentos/inc/klib/ndtree.h
+        ${PROJECT_SOURCE_DIR}/mentos/inc/klib/rbtree.h
+        ${PROJECT_SOURCE_DIR}/mentos/inc/klib/spinlock.h
+        ${PROJECT_SOURCE_DIR}/mentos/inc/klib/stack_helper.h
+        ${PROJECT_SOURCE_DIR}/mentos/inc/klib/stdatomic.h
+        ${PROJECT_SOURCE_DIR}/mentos/inc/link_access.h
+        ${PROJECT_SOURCE_DIR}/mentos/inc/mem/buddysystem.h
+        ${PROJECT_SOURCE_DIR}/mentos/inc/mem/gfp.h
+        ${PROJECT_SOURCE_DIR}/mentos/inc/mem/kheap.h
+        ${PROJECT_SOURCE_DIR}/mentos/inc/mem/paging.h
+        ${PROJECT_SOURCE_DIR}/mentos/inc/mem/slab.h
+        ${PROJECT_SOURCE_DIR}/mentos/inc/mem/vmem_map.h
+        ${PROJECT_SOURCE_DIR}/mentos/inc/mem/zone_allocator.h
+        ${PROJECT_SOURCE_DIR}/mentos/inc/multiboot.h
+        ${PROJECT_SOURCE_DIR}/mentos/inc/process/prio.h
+        ${PROJECT_SOURCE_DIR}/mentos/inc/process/process.h
+        ${PROJECT_SOURCE_DIR}/mentos/inc/process/scheduler.h
+        ${PROJECT_SOURCE_DIR}/mentos/inc/process/wait.h
+        ${PROJECT_SOURCE_DIR}/mentos/inc/proc_access.h
+        ${PROJECT_SOURCE_DIR}/mentos/inc/sys/errno.h
+        ${PROJECT_SOURCE_DIR}/mentos/inc/sys/ipc.h
+        ${PROJECT_SOURCE_DIR}/mentos/inc/sys/kernel_levels.h
+        ${PROJECT_SOURCE_DIR}/mentos/inc/sys/module.h
+        ${PROJECT_SOURCE_DIR}/mentos/inc/sys/reboot.h
+        ${PROJECT_SOURCE_DIR}/mentos/inc/sys/types.h
+        ${PROJECT_SOURCE_DIR}/mentos/inc/sys/utsname.h
+        ${PROJECT_SOURCE_DIR}/mentos/inc/system/panic.h
+        ${PROJECT_SOURCE_DIR}/mentos/inc/system/printk.h
+        ${PROJECT_SOURCE_DIR}/mentos/inc/system/signal.h
+        ${PROJECT_SOURCE_DIR}/mentos/inc/system/syscall.h
+        ${PROJECT_SOURCE_DIR}/mentos/inc/version.h
+        ${PROJECT_SOURCE_DIR}/mentos/src/boot.c
+        ${PROJECT_SOURCE_DIR}/mentos/src/descriptor_tables/exception.c
+        ${PROJECT_SOURCE_DIR}/mentos/src/descriptor_tables/gdt.c
+        ${PROJECT_SOURCE_DIR}/mentos/src/descriptor_tables/idt.c
+        ${PROJECT_SOURCE_DIR}/mentos/src/descriptor_tables/interrupt.c
+        ${PROJECT_SOURCE_DIR}/mentos/src/descriptor_tables/tss.c
+        ${PROJECT_SOURCE_DIR}/mentos/src/devices/fpu.c
+        ${PROJECT_SOURCE_DIR}/mentos/src/devices/pci.c
+        ${PROJECT_SOURCE_DIR}/mentos/src/drivers/ata.c
+        ${PROJECT_SOURCE_DIR}/mentos/src/drivers/fdc.c
+        ${PROJECT_SOURCE_DIR}/mentos/src/drivers/keyboard/keyboard.c
+        ${PROJECT_SOURCE_DIR}/mentos/src/drivers/keyboard/keymap.c
+        ${PROJECT_SOURCE_DIR}/mentos/src/drivers/mouse.c
+        ${PROJECT_SOURCE_DIR}/mentos/src/drivers/ps2.c
+        ${PROJECT_SOURCE_DIR}/mentos/src/drivers/rtc.c
+        ${PROJECT_SOURCE_DIR}/mentos/src/elf/elf.c
+        ${PROJECT_SOURCE_DIR}/mentos/src/fs/ext2.c
+        ${PROJECT_SOURCE_DIR}/mentos/src/fs/ioctl.c
+        ${PROJECT_SOURCE_DIR}/mentos/src/fs/namei.c
+        ${PROJECT_SOURCE_DIR}/mentos/src/fs/open.c
+        ${PROJECT_SOURCE_DIR}/mentos/src/fs/procfs.c
+        ${PROJECT_SOURCE_DIR}/mentos/src/fs/readdir.c
+        ${PROJECT_SOURCE_DIR}/mentos/src/fs/read_write.c
+        ${PROJECT_SOURCE_DIR}/mentos/src/fs/stat.c
+        ${PROJECT_SOURCE_DIR}/mentos/src/fs/vfs.c
+        ${PROJECT_SOURCE_DIR}/mentos/src/hardware/cpuid.c
+        ${PROJECT_SOURCE_DIR}/mentos/src/hardware/pic8259.c
+        ${PROJECT_SOURCE_DIR}/mentos/src/hardware/timer.c
+        ${PROJECT_SOURCE_DIR}/mentos/src/io/debug.c
+        ${PROJECT_SOURCE_DIR}/mentos/src/io/mm_io.c
+        ${PROJECT_SOURCE_DIR}/mentos/src/io/port_io.c
+        ${PROJECT_SOURCE_DIR}/mentos/src/io/proc_running.c
+        ${PROJECT_SOURCE_DIR}/mentos/src/io/proc_system.c
+        ${PROJECT_SOURCE_DIR}/mentos/src/io/proc_video.c
+        ${PROJECT_SOURCE_DIR}/mentos/src/io/stdio.c
+        ${PROJECT_SOURCE_DIR}/mentos/src/io/vga/vga.c
+        ${PROJECT_SOURCE_DIR}/mentos/src/io/video.c
+        ${PROJECT_SOURCE_DIR}/mentos/src/ipc/msg.c
+        ${PROJECT_SOURCE_DIR}/mentos/src/ipc/sem.c
+        ${PROJECT_SOURCE_DIR}/mentos/src/ipc/shm.c
+        ${PROJECT_SOURCE_DIR}/mentos/src/kernel/sys.c
+        ${PROJECT_SOURCE_DIR}/mentos/src/kernel.c
+        ${PROJECT_SOURCE_DIR}/mentos/src/klib/assert.c
+        ${PROJECT_SOURCE_DIR}/mentos/src/klib/ctype.c
+        ${PROJECT_SOURCE_DIR}/mentos/src/klib/fcvt.c
+        ${PROJECT_SOURCE_DIR}/mentos/src/klib/hashmap.c
+        ${PROJECT_SOURCE_DIR}/mentos/src/klib/libgen.c
+        ${PROJECT_SOURCE_DIR}/mentos/src/klib/list.c
+        ${PROJECT_SOURCE_DIR}/mentos/src/klib/math.c
+        ${PROJECT_SOURCE_DIR}/mentos/src/klib/mutex.c
+        ${PROJECT_SOURCE_DIR}/mentos/src/klib/ndtree.c
+        ${PROJECT_SOURCE_DIR}/mentos/src/klib/rbtree.c
+        ${PROJECT_SOURCE_DIR}/mentos/src/klib/spinlock.c
+        ${PROJECT_SOURCE_DIR}/mentos/src/klib/strerror.c
+        ${PROJECT_SOURCE_DIR}/mentos/src/klib/string.c
+        ${PROJECT_SOURCE_DIR}/mentos/src/klib/time.c
+        ${PROJECT_SOURCE_DIR}/mentos/src/klib/vscanf.c
+        ${PROJECT_SOURCE_DIR}/mentos/src/klib/vsprintf.c
+        ${PROJECT_SOURCE_DIR}/mentos/src/mem/buddysystem.c
+        ${PROJECT_SOURCE_DIR}/mentos/src/mem/kheap.c
+        ${PROJECT_SOURCE_DIR}/mentos/src/mem/paging.c
+        ${PROJECT_SOURCE_DIR}/mentos/src/mem/slab.c
+        ${PROJECT_SOURCE_DIR}/mentos/src/mem/vmem_map.c
+        ${PROJECT_SOURCE_DIR}/mentos/src/mem/zone_allocator.c
+        ${PROJECT_SOURCE_DIR}/mentos/src/multiboot.c
+        ${PROJECT_SOURCE_DIR}/mentos/src/process/process.c
+        ${PROJECT_SOURCE_DIR}/mentos/src/process/scheduler.c
+        ${PROJECT_SOURCE_DIR}/mentos/src/process/scheduler_algorithm.c
+        ${PROJECT_SOURCE_DIR}/mentos/src/process/wait.c
+        ${PROJECT_SOURCE_DIR}/mentos/src/sys/module.c
+        ${PROJECT_SOURCE_DIR}/mentos/src/sys/utsname.c
+        ${PROJECT_SOURCE_DIR}/mentos/src/system/errno.c
+        ${PROJECT_SOURCE_DIR}/mentos/src/system/panic.c
+        ${PROJECT_SOURCE_DIR}/mentos/src/system/printk.c
+        ${PROJECT_SOURCE_DIR}/mentos/src/system/signal.c
+        ${PROJECT_SOURCE_DIR}/mentos/src/system/syscall.c
+    )
+endif (DOXYGEN_FOUND)

doc/doxygen.css

@@ -26,6 +26,31 @@
   outline: none;
 }
 
+.sm-dox a:hover {
+  color: #4b5263;
+  background-color: #A9B7C6;
+}
+
+.sm-dox ul,
+.sm-dox ul a {
+  color: #A9B7C6;
+  background-color: #4b5263;
+}
+
+.sm-dox ul a.highlighted {
+  color: #4b5263;
+  background-color: #A9B7C6;
+}
+
+.sm-dox ul a:hover {
+  color: #4b5263;
+  background-color: #A9B7C6;
+  background-image: none;
+  background-repeat: no-repeat;
+  text-shadow: none;
+  outline: none;
+}
+
 .memberdecls tr:not(:first-child) {
   background-color: #333842;
 }
@@ -599,7 +624,8 @@ table.memberdecls {
 }
 
 .memTemplParams {
-  color: #4665A2;
+  color: #728dc2;
+  font-weight: bold;
   white-space: nowrap;
   font-size: 80%;
 }
@@ -633,9 +659,10 @@ table.memberdecls {
 
 .memtemplate {
   font-size: 80%;
-  color: #4665A2;
+  color: #728dc2;
-  font-weight: normal;
+  font-weight: bold;
   margin-left: 9px;
+  white-space: nowrap;
 }
 
 .memnav {
@@ -686,6 +713,12 @@ dl.reflist dd {
   padding: 1em;
 }
 
+.memdoc p {
+  padding: 0.25em;
+  border-radius: 4px;
+  background-color: #3A3F49;
+}
+
 dl.reflist dt {
   padding: 5px;
 }
@@ -857,6 +890,7 @@ div.directory {
   font-family: Arial, Helvetica;
   font-weight: bold;
   font-size: 12px;
+  line-height: 16px;
   height: 16px;
   width: 16px;
   display: inline-block;
@@ -879,7 +913,7 @@ div.directory {
   height: 18px;
   margin-bottom: 4px;
   background-image: url("folderopen.png");
-  background-position: 0px -4px;
+  /* background-position: 0px -4px; */
   background-repeat: repeat-y;
   vertical-align: top;
   display: inline-block;
@@ -890,7 +924,7 @@ div.directory {
   height: 18px;
   margin-bottom: 4px;
   background-image: url("folderclosed.png");
-  background-position: 0px -4px;
+  /* background-position: 0px -4px; */
   background-repeat: repeat-y;
   vertical-align: top;
   display: inline-block;
@@ -901,7 +935,7 @@ div.directory {
   height: 18px;
   margin-bottom: 4px;
   background-image: url("doc.png");
-  background-position: 0px -4px;
+  /* background-position: 0px -4px; */
   background-repeat: repeat-y;
   vertical-align: top;
   display: inline-block;
@@ -950,7 +984,7 @@ table.doxtable th {
 }
 
 table.fieldtable {
-  /*width: 100%;*/
+  width: fit-content;
   margin-bottom: 10px;
   border: 1px solid #A8B8D9;
   border-spacing: 0px;
@@ -960,7 +994,6 @@ table.fieldtable {
   -moz-box-shadow: rgba(0, 0, 0, 0.15) 2px 2px 2px;
   -webkit-box-shadow: 2px 2px 2px rgba(0, 0, 0, 0.15);
   box-shadow: 2px 2px 2px rgba(0, 0, 0, 0.15);
-  width: fit-content;
 }
 
 .fieldtable td,
@@ -998,11 +1031,9 @@ table.fieldtable {
 }
 
 .fieldtable th {
-  background-image: url("nav_f.png");
+  font-size: 100%;
-  background-repeat: repeat-x;
+  color: #d7dee4;
-  background-color: #E2E8F2;
+  background-color: #49515f;
-  font-size: 90%;
-  color: #253555;
   padding-bottom: 4px;
   padding-top: 5px;
   text-align: left;

doc/doxygen/CMakeLists.txt

@@ -1,37 +0,0 @@
-# Find Doxygen
-find_package(Doxygen)
-
-if (DOXYGEN_FOUND)
-    set(DOXYGEN_OUTPUT_DIR ${CMAKE_CURRENT_BINARY_DIR})
-    set(DOXYGEN_INDEX_FILE ${DOXYGEN_OUTPUT_DIR}/html/index.html)
-
-    # Replace variables inside @@ with the current values.
-    set(DOXYFILE_IN  ${CMAKE_CURRENT_SOURCE_DIR}/Doxyfile)
-    set(DOXYFILE_OUT ${CMAKE_CURRENT_BINARY_DIR}/Doxyfile)
-    configure_file(${DOXYFILE_IN} ${DOXYFILE_OUT} @ONLY)
-
-    # Copy the files needd by the documentation.
-    set(DOXYFILE_CSS    ${CMAKE_CURRENT_SOURCE_DIR}/doxygen.css)
-    set(DOXYFILE_HEADER ${CMAKE_CURRENT_SOURCE_DIR}/header.html)
-    set(DOXYFILE_FOOTER ${CMAKE_CURRENT_SOURCE_DIR}/footer.html)
-
-    # Doxygen won't create this for us.
-    file(MAKE_DIRECTORY ${DOXYGEN_OUTPUT_DIR})
-
-    add_custom_command(
-        OUTPUT ${DOXYGEN_INDEX_FILE}
-        COMMAND ${DOXYGEN_EXECUTABLE} ${DOXYFILE_OUT}
-
-        MAIN_DEPENDENCY ${DOXYFILE_OUT} ${DOXYFILE_IN}
-        COMMENT "Generating docs"
-    )
-    add_custom_target(
-        doxygen_doc
-        DEPENDS
-        ${DOXYGEN_INDEX_FILE}
-        ${DOXYFILE_IN}
-        ${DOXYFILE_CSS}
-        ${DOXYFILE_HEADER}
-        ${DOXYFILE_FOOTER}
-    )
-endif (DOXYGEN_FOUND)

doc/doxygen/footer.html

@@ -1,40 +0,0 @@
-        <!-- HTML footer for doxygen 1.8.16-->
-        <!-- start footer part -->
-        <!--BEGIN GENERATE_TREEVIEW-->
-        <div id="nav-path" class="navpath">
-            <!-- id is needed for treeview function! -->
-            <ul>
-                $navpath
-                <li class="footer">$generatedby
-                    <a href="http://www.doxygen.org/index.html">
-                        <img class="footer" src="$relpath^doxygen.png" alt="doxygen" />
-                    </a> $doxygenversion
-                </li>
-            </ul>
-        </div>
-        <!--END GENERATE_TREEVIEW-->
-        <!--BEGIN !GENERATE_TREEVIEW-->
-        <div class="footer">
-            <hr class="footer" />
-            <ul class="footer-info">
-                <li class="footer-info-lastmode">
-                    This page was last modified on $datetime.
-                </li>
-                <li class="footer-info-copyright">
-                    MentOs © 2014–2022 the MentOs-Team, and numerous contributors.<br>
-                    It is available for use and modification under the&#160;
-                    <a href="$relpath^md_LICENSE.html">MIT License</a>.<br>
-                </li>
-            </ul>
-            <hr class="footer" />
-            <address class="footer">
-                $generatedby&#160;
-                <a href="http://www.doxygen.org/index.html">
-                    <img class="footer" src="$relpath^doxygen.png" alt="doxygen" />
-                </a> $doxygenversion
-            </address>
-        </div>
-    <!--END !GENERATE_TREEVIEW-->
-    </body>
-
-</html>

doc/doxygen/header.html

@@ -1,66 +0,0 @@
-<!-- HTML header for doxygen 1.8.17-->
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml">
-
-<head>
-    <meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8" />
-    <meta http-equiv="X-UA-Compatible" content="IE=9" />
-    <meta name="generator" content="Doxygen $doxygenversion" />
-    <meta name="viewport" content="width=device-width, initial-scale=1" />
-    <!--BEGIN PROJECT_NAME-->
-    <title>$projectname: $title</title>
-    <!--END PROJECT_NAME-->
-    <!--BEGIN !PROJECT_NAME-->
-    <title>$title</title>
-    <!--END !PROJECT_NAME-->
-    <link href="$relpath^tabs.css" rel="stylesheet" type="text/css" />
-    <script type="text/javascript" src="$relpath^jquery.js"></script>
-    <script type="text/javascript" src="$relpath^dynsections.js"></script>
-    $treeview
-    $search
-    $mathjax
-    <link href="$relpath^$stylesheet" rel="stylesheet" type="text/css" />
-    $extrastylesheet
-</head>
-
-<body>
-    <div id="top">
-        <!-- do not remove this div, it is closed by doxygen! -->
-
-        <!--BEGIN TITLEAREA-->
-        <div id="titlearea">
-            <table cellspacing="0" cellpadding="0">
-                <tbody>
-                    <tr style="height: 56px;">
-                        <!--BEGIN PROJECT_LOGO-->
-                        <td id="projectlogo"><img alt="Logo" src="$relpath^$projectlogo" /></td>
-                        <!--END PROJECT_LOGO-->
-                        <!--BEGIN PROJECT_NAME-->
-                        <td id="projectalign" style="padding-left: 0.5em;">
-                            <div id="projectname">$projectname
-                                <!--BEGIN PROJECT_NUMBER-->&#160;<span id="projectnumber">$projectnumber</span>
-                                <!--END PROJECT_NUMBER-->
-                            </div>
-                            <!--BEGIN PROJECT_BRIEF-->
-                            <div id="projectbrief">$projectbrief</div>
-                            <!--END PROJECT_BRIEF-->
-                        </td>
-                        <!--END PROJECT_NAME-->
-                        <!--BEGIN !PROJECT_NAME-->
-                        <!--BEGIN PROJECT_BRIEF-->
-                        <td style="padding-left: 0.5em;">
-                            <div id="projectbrief">$projectbrief</div>
-                        </td>
-                        <!--END PROJECT_BRIEF-->
-                        <!--END !PROJECT_NAME-->
-                        <!--BEGIN DISABLE_INDEX-->
-                        <!--BEGIN SEARCHENGINE-->
-                        <td>$searchbox</td>
-                        <!--END SEARCHENGINE-->
-                        <!--END DISABLE_INDEX-->
-                    </tr>
-                </tbody>
-            </table>
-        </div>
-        <!--END TITLEAREA-->
-        <!-- end header part -->

files/usr/share/man/cat.man

@@ -0,0 +1,8 @@
+SYNOPSIS
+    cat [FILE]
+
+DESCRIPTION
+    Prints the content of the given file.
+
+OPTIONS
+    -h --help : shows command help.

files/usr/share/man/clear.man

@@ -0,0 +1,5 @@
+SYNOPSIS
+    clear
+
+DESCRIPTION
+    Clears the screen.

files/usr/share/man/cpuid.man

@@ -0,0 +1,5 @@
+SYNOPSIS
+    cpuid
+
+DESCRIPTION
+    Not currently implemented.

files/usr/share/man/date.man

@@ -0,0 +1,5 @@
+SYNOPSIS
+    date
+
+DESCRIPTION
+    Shows the current date.

files/usr/share/man/echo.man

@@ -0,0 +1,6 @@
+SYNOPSIS
+    echo [STRING]
+
+DESCRIPTION
+    Displays a line of text.
+    

files/usr/share/man/ls.man

@@ -1,6 +1,3 @@
-NAME
-    ls - list directory contents
-
 SYNOPSIS
     ls [OPTIONS] [FILE/FOLDER]
 
@@ -10,5 +7,6 @@ DESCRIPTION
     inside the current folder.
     
 OPTIONS
-    -a  : list all entries.
+    -h --help : shows command help.
-    -l  : show the entries as a detailed list.
+    -a --all  : list all entries.
+    -l --long : show the entries as a detailed long list.

libc/CMakeLists.txt

@@ -50,7 +50,7 @@ set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -std=gnu99")
 set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -Wno-unused-function")
 set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -Wno-unused-variable")
 set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -Wno-unknown-pragmas")
-set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -Wno-unused-but-set-variable")
+set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -Wno-missing-braces")
 
 # Set the compiler options.
 set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -static")

libc/inc/sys/bitops.h

@@ -22,6 +22,8 @@
 #define bitmask_check(V, M)        ((V) & (M))   ///< Checks if the bits identified by the mask are all 1.
 
 /// @brief Finds the first bit at zero, starting from the less significative bit.
+/// @param value the value we need to analyze.
+/// @return the position of the first zero bit.
 static inline int find_first_zero(unsigned long value)
 {
     for (int i = 0; i < 32; ++i)
@@ -31,6 +33,8 @@ static inline int find_first_zero(unsigned long value)
 }
 
 /// @brief Finds the first bit not zero, starting from the less significative bit.
+/// @param value the value we need to analyze.
+/// @return the position of the first non-zero bit.
 static inline int find_first_non_zero(unsigned long value)
 {
     for (int i = 0; i < 32; ++i)

libc/inc/sys/dirent.h

@@ -21,22 +21,23 @@ enum {
     DT_WHT     = 14
 };
 
+/// @brief Characters describing the direactory entry.
 static const char dt_char_array[] = {
     '?', // DT_UNKNOWN = 0,
-    'p', //DT_FIFO = 1,
+    'p', // DT_FIFO = 1,
-    'c', //DT_CHR  = 2,
+    'c', // DT_CHR  = 2,
     '*',
-    'd', //DT_DIR  = 4,
+    'd', // DT_DIR  = 4,
     '*',
-    'b', //DT_BLK  = 6,
+    'b', // DT_BLK  = 6,
     '*',
-    '-', //DT_REG  = 8,
+    '-', // DT_REG  = 8,
     '*',
-    'l', //DT_LNK  = 10,
+    'l', // DT_LNK  = 10,
     '*',
-    's', //DT_SOCK = 12,
+    's', // DT_SOCK = 12,
     '*',
-    '?', //DT_WHT  = 14
+    '?', // DT_WHT  = 14
 };
 
 /// Directory entry.

libc/src/abort.c

@@ -8,8 +8,8 @@
 #include "signal.h"
 #include "stdio.h"
 
-// Since there could be signal handlers listening for the abort, we
+/// @brief Since there could be signal handlers listening for the abort, we need
-//  need to keep track at which stage of the abort we are.
+/// to keep track at which stage of the abort we are.
 static int stage = 0;
 
 void abort(void)

libc/src/grp.c

@@ -14,6 +14,10 @@
 
 static int __fd = -1;
 
+/// @brief It parses the line (as string) and saves its content inside the
+/// group_t structure.
+/// @param grp the struct where we store the information.
+/// @param buf the buffer from which we extract the information.
 static inline void __parse_line(group_t *grp, char *buf)
 {
     assert(grp && "Received null grp!");

libc/src/io/port_io.c

@@ -33,7 +33,6 @@ inline uint32_t inportl(uint16_t port)
 {
     uint32_t rv;
     __asm__ __volatile__("inl %%dx, %%eax" : "=a"(rv) : "dN"(port));
-
     return rv;
 }
 
@@ -49,7 +48,7 @@ inline void outports(uint16_t port, uint16_t data)
 
 void outportsm(uint16_t port, uint8_t *data, uint16_t size)
 {
-    asm volatile("rep outsw" : "+S"(data), "+c"(size) : "d"(port));
+    __asm__ __volatile__("rep outsw" : "+S"(data), "+c"(size) : "d"(port));
 }
 
 inline void outportl(uint16_t port, uint32_t data)

libc/src/pwd.c

@@ -81,6 +81,13 @@ ssize_t __readline(int fd, char *buffer, size_t buflen)
     return newline_len;
 }
 
+/// @brief Searches for the given entry inside the buffer.
+/// @param fd the file descriptor of the file.
+/// @param buffer the support buffer we use to read the file.
+/// @param buflen the length of the support buffer.
+/// @param name the username we are looking for.
+/// @param uid the user-id of the user we are looking for.
+/// @return the buffer itself if we have found the entry, NULL otherwise.
 static inline char *__search_entry(int fd, char *buffer, int buflen, const char *name, uid_t uid)
 {
     while (__readline(fd, buffer, buflen)) {

libc/src/setenv.c

@@ -13,6 +13,10 @@ char **environ;
 static char **__environ      = NULL;
 static size_t __environ_size = 0;
 
+/// @brief Finds the entry in the environ.
+/// @param name the name of the entry we are looking for.
+/// @param name_len the length of the name we received.
+/// @return the index of the entry, or -1 if we did not find it.
 static inline int __find_entry(const char *name, const size_t name_len)
 {
     if (environ) {
@@ -24,6 +28,7 @@ static inline int __find_entry(const char *name, const size_t name_len)
     return -1;
 }
 
+/// @brief Makes a clone of the current environ.
 static void __clone_environ()
 {
     if (environ) {

libc/src/stdlib.c

@@ -12,6 +12,9 @@
 /// malloc(), calloc() or realloc().
 #define MALLOC_MAGIC_NUMBER 0x600DC0DE
 
+/// @brief Checks if the pointer is a valid malloc entry.
+/// @param ptr the pointer we are checking.
+/// @return 1 of success, 0 on failure.
 static inline int __malloc_is_valid_ptr(void *ptr)
 {
     return (ptr && (((size_t *)ptr)[-1] == MALLOC_MAGIC_NUMBER));

mentos/CMakeLists.txt

@@ -67,7 +67,7 @@ set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -std=gnu99")
 set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -Wno-unused-function")
 set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -Wno-unused-variable")
 set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -Wno-unknown-pragmas")
-set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -Wno-unused-but-set-variable")
+set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -Wno-missing-braces")
 
 # Set the compiler options.
 set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -static")
@@ -216,7 +216,7 @@ endif(ENABLE_ALLOC_TRACE)
 
 # =============================================================================
 # Set the list of valid scheduling options.
-set(SCHEDULER_TYPES SCHEDULER_RR SCHEDULER_PRIORITY SCHEDULER_CFS SCHEDULER_EDF SCHEDULER_RM)
+set(SCHEDULER_TYPES SCHEDULER_RR SCHEDULER_PRIORITY SCHEDULER_CFS SCHEDULER_EDF SCHEDULER_RM SCHEDULER_AEDF)
 # Add the scheduling option.
 set(SCHEDULER_TYPE "SCHEDULER_RR" CACHE STRING "Chose the type of scheduler: ${SCHEDULER_TYPES}")
 # List of schedulers.

mentos/boot.lds

@@ -1,17 +1,14 @@
-OUTPUT_FORMAT("elf")
+OUTPUT_FORMAT("elf32-i386")
-OUTPUT_ARCH(i386)
 
 ENTRY(boot_entry)
 
-BOOTLOADER_PHYSICAL_ADDRESS = 0x00100000;
-
 MEMORY {
 	BOOTLOADER_MEM : ORIGIN = 0x00000000, LENGTH = 128M
 }
 
 SECTIONS
 {
-	. = BOOTLOADER_PHYSICAL_ADDRESS;
+	. = 0x00100000;
 	_bootloader_start = .;
 	.multiboot . : AT(ADDR(.multiboot))
 	{

mentos/inc/klib/compiler.h

@@ -41,9 +41,8 @@
 
 #pragma once
 
-
 /// @brief Assign the value to the given variable.
-#define WRITE_ONCE(var, val) (*((volatile typeof(val) *)(&(var))) = (val))
+#define WRITE_ONCE(var, val) (*((__volatile__ __typeof__(val) *)(&(var))) = (val))
 
 /// @brief Read the value from the given variable.
-#define READ_ONCE(var) (*((volatile typeof(var) *)(&(var))))
+#define READ_ONCE(var) (*((__volatile__ __typeof__(var) *)(&(var))))

mentos/inc/klib/stack_helper.h

@@ -12,6 +12,6 @@
 /// @brief Moves the pointer up.
 #define __MOVE_PTR_UP(type, ptr) ((ptr) += sizeof(type))
 /// @brief First, it moves the pointer down, and then it pushes the value at that memory location.
-#define PUSH_VALUE_ON_STACK(ptr, value) (__ACCESS_PTR(typeof(value), __MOVE_PTR_DOWN(typeof(value), ptr)) = (value))
+#define PUSH_VALUE_ON_STACK(ptr, value) (__ACCESS_PTR(__typeof__(value), __MOVE_PTR_DOWN(__typeof__(value), ptr)) = (value))
 /// @brief First, it access the value at the given memory location, and then it moves the pointer up.
-#define POP_VALUE_FROM_STACK(value, ptr) ({value = __ACCESS_PTR(typeof(value), ptr); __MOVE_PTR_UP(typeof(value), ptr); })
+#define POP_VALUE_FROM_STACK(value, ptr) ({value = __ACCESS_PTR(__typeof__(value), ptr); __MOVE_PTR_UP(__typeof__(value), ptr); })

mentos/inc/klib/stdatomic.h

@@ -162,4 +162,3 @@ static inline int test_bit(int offset, volatile unsigned long *base)
 // is discouraged by many C/C++ groups.
 
 // == xchg/xchgl ==============================================================
-//

mentos/inc/mem/zone_allocator.h

@@ -23,29 +23,30 @@
 /// @brief Page descriptor. Use as a bitmap to understand the order of the block
 /// and if it is free or allocated.
 typedef struct page_t {
-    /// Array of flags encoding also the zone number to which the page frame
+    /// @brief Array of flags encoding also the zone number to which the page
-    /// belongs.
+    /// frame belongs.
     unsigned long flags;
-    /// Page frame’s reference counter. 0 free, 1 used, 2+ copy on write
+    /// @brief Page frame’s reference counter. 0 free, 1 used, 2+ copy on write
     atomic_t count;
-    /// Buddy system page definition
+    /// @brief Buddy system page definition
     bb_page_t bbpage;
-    /// Contains pointers to the slabs doubly linked list of pages.
+    /// @brief Contains pointers to the slabs doubly linked list of pages.
     list_head slabs;
 
-    // Slab allocator variables / Contains the total number of objects in this
+    /// @brief Slab allocator variables / Contains the total number of objects
-    //page, 0 if not managed by the slub
+    /// in this page, 0 if not managed by the slub.
     unsigned int slab_objcnt;
-    ///  Tracks the number of free objects in the current page
+    /// @brief Tracks the number of free objects in the current page
     unsigned int slab_objfree;
-    /// Holds the first free object (if slab_objfree is > 0)
+    /// @brief Holds the first free object (if slab_objfree is > 0)
     list_head slab_freelist;
     /// @brief This union can either contain the pointer to the slab main page
     /// that handles this page, or the cache that contains it.
     union {
-        /// Holds the slab page used to handle this memory region (root page)
+        /// @brief Holds the slab page used to handle this memory region (root
+        /// page).
         struct page_t *slab_main_page;
-        /// Holds the slab cache pointer on the main page
+        /// @brief Holds the slab cache pointer on the main page.
         kmem_cache_t *slab_cache;
     } container;
 } page_t;

mentos/inc/system/signal.h

@@ -268,13 +268,15 @@ int sys_kill(pid_t pid, int sig);
 /// @brief Sets the disposition of the signal signum to handler.
 /// @param signum  The signal number.
 /// @param handler The handler for the signal.
+/// @param sigreturn_addr The address of the sigreturn function.
 /// @return The previous value of the signal handler, or SIG_ERR on error.
 sighandler_t sys_signal(int signum, sighandler_t handler, uint32_t sigreturn_addr);
 
 /// @brief Examine and change a signal action.
 /// @param signum Specifies the signal and can be any valid signal except SIGKILL and SIGSTOP.
-/// @param act    If non-NULL, the new action for signal signum is installed from act.
+/// @param act If non-NULL, the new action for signal signum is installed from act.
 /// @param oldact If non-NULL, the previous action is saved in oldact.
+/// @param sigreturn_addr The address of the sigreturn function.
 /// @return returns 0 on success; on error, -1 is returned, and errno is set to indicate the error.
 int sys_sigaction(int signum, const sigaction_t *act, sigaction_t *oldact, uint32_t sigreturn_addr);
 

mentos/inc/version.h

@@ -21,7 +21,7 @@
 #define OS_MINOR_VERSION 5
 
 /// Micro version of the operating system.
-#define OS_MICRO_VERSION 1
+#define OS_MICRO_VERSION 3
 
 /// Helper to transform the given argument into a string.
 #define OS_STR_HELPER(x) #x

mentos/kernel.lds

@@ -1,20 +1,17 @@
-OUTPUT_FORMAT("elf")
+OUTPUT_FORMAT("elf32-i386")
-OUTPUT_ARCH(i386)
 
 ENTRY(kmain)
 
-KERNEL_VIRTUAL_ADDRESS = 0xC0000000;
-
 MEMORY {
 	USER_SPACE : ORIGIN = 0x00000000, LENGTH = 3072M
-	KERNEL_LOWMEM : ORIGIN = KERNEL_VIRTUAL_ADDRESS, LENGTH = 896M
+	KERNEL_LOWMEM : ORIGIN = 0xC0000000, LENGTH = 896M
 	KERNEL_HIGHMEM : ORIGIN = 0xF8000000, LENGTH = 128M
 }
 
 
 SECTIONS
 {
-	. = KERNEL_VIRTUAL_ADDRESS;
+	. = 0xC0000000;
     /* Put the .text section. */
     .text . : AT(ADDR(.text))
     {

mentos/src/devices/fpu.c

@@ -29,23 +29,23 @@ uint8_t saves[512] __attribute__((aligned(16)));
 /// @param cw What to set the control word to.
 static inline void __set_fpu_cw(const uint16_t cw)
 {
-    asm volatile("fldcw %0" ::"m"(cw));
+    __asm__ __volatile__("fldcw %0" ::"m"(cw));
 }
 
 /// @brief Enable the FPU and SSE.
 static inline void __enable_fpu()
 {
-    asm volatile("clts");
+    __asm__ __volatile__("clts");
     size_t t;
-    asm volatile("mov %%cr0, %0"
+    __asm__ __volatile__("mov %%cr0, %0"
                  : "=r"(t));
     t &= ~(1U << 2U);
     t |= (1U << 1U);
-    asm volatile("mov %0, %%cr0" ::"r"(t));
+    __asm__ __volatile__("mov %0, %%cr0" ::"r"(t));
-    asm volatile("mov %%cr4, %0"
+    __asm__ __volatile__("mov %%cr4, %0"
                  : "=r"(t));
     t |= 3U << 9U;
-    asm volatile("mov %0, %%cr4" ::"r"(t));
+    __asm__ __volatile__("mov %0, %%cr4" ::"r"(t));
 }
 
 /// Disable FPU and SSE so it traps to the kernel.
@@ -53,12 +53,12 @@ static inline void __disable_fpu()
 {
     size_t t;
 
-    asm volatile("mov %%cr0, %0"
+    __asm__ __volatile__("mov %%cr0, %0"
                  : "=r"(t));
 
     t |= 1U << 3U;
 
-    asm volatile("mov %0, %%cr0" ::"r"(t));
+    __asm__ __volatile__("mov %0, %%cr0" ::"r"(t));
 }
 
 /// @brief Restore the FPU for a process.
@@ -68,7 +68,7 @@ static inline void __restore_fpu(task_struct *proc)
 
     memcpy(&saves, (uint8_t *)&proc->thread.fpu_register, 512);
 
-    asm volatile("fxrstor (%0)" ::"r"(saves));
+    __asm__ __volatile__("fxrstor (%0)" ::"r"(saves));
 }
 
 /// Save the FPU for a process.
@@ -76,7 +76,7 @@ static inline void __save_fpu(task_struct *proc)
 {
     assert(proc && "Trying to save FPU of NULL process.");
 
-    asm volatile("fxsave (%0)" ::"r"(saves));
+    __asm__ __volatile__("fxsave (%0)" ::"r"(saves));
 
     memcpy((uint8_t *)&proc->thread.fpu_register, &saves, 512);
 }
@@ -84,7 +84,7 @@ static inline void __save_fpu(task_struct *proc)
 /// Initialize the FPU.
 static inline void __init_fpu()
 {
-    asm volatile("fninit");
+    __asm__ __volatile__("fninit");
 }
 
 /// Kernel trap for FPU usage when FPU is disabled.

mentos/src/fs/ext2.c

@@ -620,6 +620,7 @@ static void ext2_dump_inode(ext2_inode_t *inode)
     pr_debug("Symlink : %s\n", inode->data.symlink);
     pr_debug("Generation : %u file_acl : %u dir_acl : %u\n",
              inode->generation, inode->file_acl, inode->dir_acl);
+    (void)timeinfo;
 }
 
 /// @brief Dumps on debugging output the dirent.

mentos/src/hardware/timer.c

@@ -229,6 +229,7 @@ static void __print_tvec_slots(tvec_base_t *base, int tv_index)
     }
 
     pr_debug("base->tv%d.vec:\n\t%s\n", tv_index, result);
+    (void) result;
 }
 
 /// Dump all timer vector in base
@@ -327,6 +328,7 @@ static void __rem_timer_tvec_base(tvec_base_t *base, struct timer_list *timer)
     int index = 0, tv_index = 0;
     __find_tvec(base, timer, &index, &tv_index);
 
+    // TODO: Check why we do not use vec.
     struct list_head *vec;
     switch (tv_index) {
     case 1:
@@ -352,6 +354,7 @@ static void __rem_timer_tvec_base(tvec_base_t *base, struct timer_list *timer)
 #ifdef ENABLE_REAL_TIMER_SYSTEM_DUMP
     __dump_all_tvec_slots(base);
 #endif
+    (void)vec;
 }
 
 /// Move all timers from tv up one level

mentos/src/io/port_io.c

@@ -57,7 +57,7 @@ inline void outports(uint16_t port, uint16_t data)
 
 void outportsm(uint16_t port, uint8_t *data, uint16_t size)
 {
-    asm volatile("rep outsw"
+    __asm__ __volatile__("rep outsw"
                  : "+S"(data), "+c"(size)
                  : "d"(port));
 }

mentos/src/io/proc_running.c

@@ -393,11 +393,10 @@ static inline ssize_t __procr_read(vfs_file_t *file, char *buffer, off_t offset,
     char support[BUFSIZ];
     memset(support, 0, BUFSIZ);
     // Call the specific function.
-    int ret = 0;
     if (strcmp(entry->name, "cmdline") == 0)
-        ret = __procr_do_cmdline(support, BUFSIZ, task);
+        __procr_do_cmdline(support, BUFSIZ, task);
     else if (strcmp(entry->name, "stat") == 0)
-        ret = __procr_do_stat(support, BUFSIZ, task);
+        __procr_do_stat(support, BUFSIZ, task);
     // Copmute the amounts of bytes we want (and can) read.
     ssize_t bytes_to_read = max(0, min(strlen(support) - offset, nbyte));
     // Perform the read.

mentos/src/klib/mutex.c

@@ -14,12 +14,12 @@ void mutex_lock(mutex_t *mutex, uint32_t owner)
     while (mutex->state == 0 || failure || mutex->owner != owner) {
         failure = 1;
         if (mutex->state == 0) {
-            asm("movl $0x01,%%eax\n\t" // move 1 to eax
+            __asm__ __volatile__("movl $0x01,%%eax\n\t" // move 1 to eax
-                "xchg    %%eax,%0\n\t" // try to set the lock bit
+                                 "xchg    %%eax,%0\n\t" // try to set the lock bit
-                "mov     %%eax,%1\n\t" // export our result to a test var
+                                 "mov     %%eax,%1\n\t" // export our result to a test var
-                : "=m"(mutex->state), "=r"(failure)
+                                 : "=m"(mutex->state), "=r"(failure)
-                : "m"(mutex->state)
+                                 : "m"(mutex->state)
-                : "%eax");
+                                 : "%eax");
         }
         if (failure == 0) {
             mutex->owner = owner; //test to see if we got the lock bit

mentos/src/mem/kheap.c

@@ -846,7 +846,6 @@ void kheap_dump()
                  (char *)it + OVERHEAD + blkmngr_get_real_size(it->size));
         total += blkmngr_get_real_size(it->size);
         total_overhead += OVERHEAD;
-
         it = it->next;
     }
     pr_debug("\nTotal usable bytes   : %d", total);
@@ -857,4 +856,5 @@ void kheap_dump()
         pr_debug("(%p)->", it);
     }
     pr_debug("\n\n");
+    (void) total, (void) total_overhead;
 }

mentos/src/mem/paging.c

@@ -165,12 +165,12 @@ uint32_t clone_vm_area(mm_struct_t *mm, vm_area_struct_t *area, int cow, uint32_
 
 static void __init_pagedir(page_directory_t *pdir)
 {
-    *pdir = (page_directory_t){ 0 };
+    *pdir = (page_directory_t){ {0} };
 }
 
 static void __init_pagetable(page_table_t *ptable)
 {
-    *ptable = (page_table_t){ 0 };
+    *ptable = (page_table_t){ {0} };
 }
 
 void paging_init(boot_info_t *info)
@@ -221,7 +221,7 @@ static inline void __set_pg_table_flags(page_table_entry_t *table, uint32_t flag
 /// @param addr The faulting address.
 static void __page_fault_panic(pt_regs *f, uint32_t addr)
 {
-    asm volatile("cli");
+    __asm__ __volatile__("cli");
 
     // Gather fault info and print to screen
     pr_err("Faulting address (cr2): 0x%p\n", addr);
@@ -250,7 +250,7 @@ static void __page_fault_panic(pt_regs *f, uint32_t addr)
     //    main_mm->pgd->entries[addr/(1024*4096)].user = 1;
     //    main_directory->entries[addr/(1024*4096)]. = 1;
 
-    asm volatile("cli");
+    __asm__ __volatile__("cli");
 }
 
 static void __page_handle_cow(page_table_entry_t *entry)
@@ -327,8 +327,8 @@ void page_fault_handler(pt_regs *f)
     // When the exception occurs, the CPU control unit stores that
     // value in the cr2 control register.
     uint32_t faulting_addr;
-    asm volatile("mov %%cr2, %0"
+    __asm__ __volatile__("mov %%cr2, %0"
-                 : "=r"(faulting_addr));
+                         : "=r"(faulting_addr));
     // Get the physical address of the current page directory.
     uint32_t phy_dir = (uint32_t)paging_get_current_directory();
     // Get the page directory.

mentos/src/process/scheduler_algorithm.c

@@ -75,7 +75,37 @@ static inline task_struct *__scheduler_rr(runqueue_t *runqueue, bool_t skip_peri
 /// @return the next task on success, NULL on failure.
 static inline task_struct *__scheduler_priority(runqueue_t *runqueue, bool_t skip_periodic)
 {
+#ifdef SCHEDULER_PRIORITY
+    // Get the first element of the list.
+    task_struct *next = list_entry(runqueue->queue.next, struct task_struct, run_list);
+
+    // Get its static priority.
+    time_t min = /*...*/;
+
+    // Search for the task with the smallest static priority.
+    list_for_each_decl(it, &runqueue->curr->run_list)
+    {
+        // Check if we reached the head of list_head, and skip it.
+        if (it == &runqueue->queue)
+            continue;
+        // Get the current entry.
+        task_struct *entry = list_entry(it, task_struct, run_list);
+        // We consider only runnable processes
+        if (entry->state != TASK_RUNNING)
+            continue;
+        // If entry is a periodic task, and we were asked to skip periodic tasks, skip it.
+        if (__is_periodic_task(entry) && skip_periodic)
+            continue;
+        // Check if the entry has a lower priority.
+        if (/*...*/) {
+            // Chose the `entry` as the `next` task.
+            /*...*/
+        }
+    }
+    return next;
+#else
     return __scheduler_rr(runqueue, skip_periodic);
+#endif
 }
 
 /// @brief It aims at giving a fair share of CPU time to processes, and achieves
@@ -89,7 +119,35 @@ static inline task_struct *__scheduler_priority(runqueue_t *runqueue, bool_t ski
 /// @return the next task on success, NULL on failure.
 static inline task_struct *__scheduler_cfs(runqueue_t *runqueue, bool_t skip_periodic)
 {
+#ifdef SCHEDULER_CFS
+    // Get the first element of the list.
+    task_struct *next = list_entry(runqueue->queue.next, struct task_struct, run_list);
+
+    // Get its virtual runtime.
+    time_t min = /* ... */;
+
+    // Search for the task with the smallest vruntime value.
+    list_for_each_decl(it, &runqueue->curr->run_list)
+    {
+        // Check if we reached the head of list_head, and skip it.
+        if (it == &runqueue->queue)
+            continue;
+        // Get the current entry.
+        task_struct *entry = list_entry(it, task_struct, run_list);
+        // We consider only runnable processes
+        if (entry->state != TASK_RUNNING)
+            continue;
+        // If entry is a periodic task, and we were asked to skip periodic tasks, skip it.
+        if (__is_periodic_task(entry) && skip_periodic)
+            continue;
+
+        // Check if the element in the list has a smaller vruntime value.
+        /* ... */
+    }
+    return next;
+#else
     return __scheduler_rr(runqueue, skip_periodic);
+#endif
 }
 
 /// @brief Executes the task with the earliest absolute deadline among all the
@@ -157,6 +215,8 @@ task_struct *scheduler_pick_next_task(runqueue_t *runqueue)
 
 static void __update_task_statistics(task_struct *task)
 {
+    // See `prio.h` for more support functions.
+#if defined(SCHEDULER_CFS) || defined(SCHEDULER_EDF) || defined(SCHEDULER_RM) || defined(SCHEDULER_AEDF)
     assert(task && "Current task is not valid.");
 
     // While periodic task is under analysis is executed with aperiodic
@@ -165,6 +225,8 @@ static void __update_task_statistics(task_struct *task)
     // if is a more pessimistic evaluation.
     // Update the delta exec.
     task->se.exec_runtime = timer_get_ticks() - task->se.exec_start;
+
+    // Perform timer-related checks.
     update_process_profiling_timer(task);
 
     // Set the sum_exec_runtime.
@@ -173,15 +235,16 @@ static void __update_task_statistics(task_struct *task)
     // If the task is not a periodic task we have to update the virtual runtime.
     if (!task->se.is_periodic) {
         // Get the weight of the current task.
-        time_t weight = GET_WEIGHT(task->se.prio);
+        time_t weight = /* ... */;
         // If the weight is different from the default load, compute it.
         if (weight != NICE_0_LOAD) {
             // Get the multiplicative factor for its delta_exec.
-            double factor = ((double)NICE_0_LOAD) / ((double)weight);
+            double factor = /* ... */;
             // Weight the delta_exec with the multiplicative factor.
-            task->se.exec_runtime = (int)(((double)task->se.exec_runtime) * factor);
+            task->se.exec_runtime = /* ... */;
         }
         // Update vruntime of the current task.
-        task->se.vruntime += task->se.exec_runtime;
+        task->se.vruntime += /* ... */;
     }
+#endif
 }

mentos/src/system/panic.c

@@ -10,6 +10,6 @@ void kernel_panic(const char *msg)
 {
     pr_emerg("\nPANIC:\n%s\n\nWelcome to Kernel Debugging Land...\n\n", msg);
     pr_emerg("\n");
-    asm("cli"); // Disable interrupts
+    __asm__ __volatile__("cli"); // Disable interrupts
-    for (;;) asm("hlt"); // Decrease power consumption with hlt
+    for (;;) __asm__ __volatile__("hlt"); // Decrease power consumption with hlt
 }

programs/CMakeLists.txt

@@ -25,7 +25,8 @@ set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -std=gnu99")
 set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -Wno-unused-function")
 set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -Wno-unused-variable")
 set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -Wno-unknown-pragmas")
-set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -Wno-unused-but-set-variable")
+set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -Wno-missing-braces")
+set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -Wno-unused-command-line-argument")
 
 # Set the compiler options.
 set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -static")

programs/cat.c

@@ -19,7 +19,7 @@ int main(int argc, char **argv)
     }
     // Check if `--help` is provided.
     for (int i = 1; i < argc; ++i) {
-        if (strcmp(argv[i], "--help") == 0) {
+        if ((strcmp(argv[i], "--help") == 0) || (strcmp(argv[i], "-h") == 0)) {
             printf("Prints the content of the given file.\n");
             printf("Usage:\n");
             printf("    cat <file>\n\n");

programs/edit.c

@@ -12,24 +12,15 @@
 #define CTRL_KEY(k) ((k)&0x1f)
 #define BUFFER_SIZE 4096
 
-static struct termios _original_termios, _termios;
+static inline void __set_echo(bool_t active)
-
-static inline void die(const char *s)
 {
-    printf("error: %s\n", s);
+    struct termios _termios;
-    exit(1);
+    tcgetattr(STDIN_FILENO, &_termios);
-}
+    if (active) {
-
+        _termios.c_lflag |= (ICANON | ECHO);
-static inline void disable_raw_mode()
+    } else {
-{
+        _termios.c_lflag &= ~(ICANON | ECHO);
-    tcsetattr(STDIN_FILENO, 0, &_original_termios);
+    }
-}
-
-static inline void enable_raw_mode()
-{
-    tcgetattr(STDIN_FILENO, &_original_termios);
-    _termios = _original_termios;
-    _termios.c_lflag &= ~(ICANON | ECHO | IEXTEN | ISIG);
     tcsetattr(STDIN_FILENO, 0, &_termios);
 }
 
@@ -72,33 +63,61 @@ int main(int argc, char *argv[])
     // Close the file descriptor.
     close(fd);
 
-    enable_raw_mode();
+    struct termios _termios;
+    tcgetattr(STDIN_FILENO, &_termios);
+    _termios.c_lflag &= ~ISIG;
+    tcsetattr(STDIN_FILENO, 0, &_termios);
+
+    __set_echo(false);
 
-    int c;
     do {
-        c = getchar();
+        int c = getchar();
         // Return Key
         if (c == '\n') {
             putchar('\n');
+            // Break the while loop.
+            continue;
         } else if (c == '\033') {
             c = getchar();
             if (c == '[') {
-                c = getchar();
+                c = getchar(); // Get the char.
-                if (c == 'D') {
+                if ((c == 'A') || (c == 'B')) {
-                    puts("\033[1D");
+                    pr_debug("UP\n");
+                } else if (c == 'D') {
+                    pr_debug("RIGHT\n");
                 } else if (c == 'C') {
-                    puts("\033[1C");
+                    pr_debug("LEFT\n");
                 } else if (c == 'H') {
-                    printf("\033[%dD", 0);
+                    pr_debug("HOME\n");
                 } else if (c == 'F') {
-                    printf("\033[%dC", 60);
+                    pr_debug("END\n");
+                } else if (c == '3') {
+                    pr_debug("NO-IDEA\n");
                 }
             }
-        } else {
+        } else if (c == '\b') {
+            putchar('\b');
+        } else if (c == '\t') {
+            pr_debug("TAB\n");
+        } else if (c == 127) {
+            pr_debug("127\n");
+            putchar(127);
+        } else if (iscntrl(c)) {
+            if (c == CTRL('C')) {
+                pr_debug("CTRL(C)\n");
+                break;
+            } else if (c == CTRL('U')) {
+                pr_debug("CTRL(U)\n");
+            } else if (c == CTRL('D')) {
+                pr_debug("CTRL(D)\n");
+            }
+        } else if ((c > 0) && (c != '\n')) {
             putchar(c);
+        } else {
+            pr_debug("Unrecognized character %02x (%c)\n", c, c);
         }
-    } while (c != 'q');
+    } while (true);
 
-    disable_raw_mode();
+    __set_echo(true);
     return 0;
 }

programs/ls.c

@@ -122,18 +122,16 @@ int main(int argc, char *argv[])
     uint32_t flags = 0;
     // Check the number of arguments.
     for (int i = 1; i < argc; ++i) {
-        if (strcmp(argv[i], "--help") == 0) {
+        if ((strcmp(argv[i], "--help") == 0) || (strcmp(argv[i], "-h") == 0)) {
             printf("List information about files inside a given directory.\n");
             printf("Usage:\n");
             printf("    ls [options] [directory]\n\n");
             return 0;
         } else if (argv[i][0] == '-') {
-            for (int j = 0; j < strlen(argv[i]); ++j) {
+            if ((strcmp(argv[i], "-l") == 0) || (strcmp(argv[i], "--long") == 0))
-                if (argv[i][j] == 'l')
+                bitmask_set_assign(flags, FLAG_L);
-                    bitmask_set_assign(flags, FLAG_L);
+            else if ((strcmp(argv[i], "-a") == 0) || (strcmp(argv[i], "--all") == 0))
-                else if (argv[i][j] == 'a')
+                bitmask_set_assign(flags, FLAG_A);
-                    bitmask_set_assign(flags, FLAG_A);
-            }
         }
     }
 

programs/tests/CMakeLists.txt

@@ -25,7 +25,8 @@ set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -std=gnu99")
 set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -Wno-unused-function")
 set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -Wno-unused-variable")
 set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -Wno-unknown-pragmas")
-set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -Wno-unused-but-set-variable")
+set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -Wno-missing-braces")
+set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -Wno-unused-command-line-argument")
 
 # Set the compiler options.
 set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -static")

programs/tests/t_kill.c

@@ -11,7 +11,7 @@
 #include <strerror.h>
 #include <sys/wait.h>
 
-#define cpu_relax() asm volatile("pause\n" \
+#define cpu_relax() __asm__ __volatile__("pause\n" \
                                  :         \
                                  :         \
                                  : "memory")

programs/tests/t_sigfpe.c

@@ -46,4 +46,5 @@ int main(int argc, char *argv[])
         d /= e;
         e -= 1;
     }
+    printf("d: %d, e: %d\n", d, e);
 }

programs/tests/t_siginfo.c

@@ -47,4 +47,5 @@ int main(int argc, char *argv[])
         d /= e;
         e -= 1;
     }
+    printf("d: %d, e: %d\n", d, e);
 }