refactor(memory): complete PMM/VMM/LMM rewrite - bitmap allocators, bug fixes, hardening

PMM Rewrite: - Replace ~8KB record array with compact bitmaps (PhysPresent/PhysAlloc/PhysScanned, 128B each) - Add PhysOwner[0..1023] for per-block ownership tracking - new_block: O(1) amortised via NextFreeHint + dword-level BSF scan, returns 0 as OOM sentinel - free_block: O(1) direct bit clear with double-free detection - alloc_block: validates PhysPresent and PhysAlloc bits before allocation - Add pmm_free_blocks/pmm_total_blocks stats functions VMM Correctness Fixes: - Fix free_page block extraction (Address SHR 10, was using raw Address field) - Fix invlpg operand (use virtual address, was passing PDE index) - Clear PDE entry on free_page before returning block to PMM - Remove map_page double-write (delegate to map_page_ex only) - Add OOM propagation (new_page returns false if PMM returns 0) - Fix missing pop_trace in new_page error path LMM Rewrite: - Replace per-entry record array with bitmap allocator (93% vs 43% page efficiency) - Layout: Header(24B) + Bitmap(64512B) + Padding + Data at 0x10000 - SIZE_PREFIX=16 for 16-byte aligned returns (SSE MOVAPS requirement) - Next-fit bitmap scan with roving hint (NextFree) and dword-level fast skip - Large alloc sentinel (LARGE_ALLOC_MAGIC=$FFFFFFFE) so kfree detects klalloc'd memory - Implement klfree (was previously a no-op - pages could never be returned) - Implement try_release_page (return fully-free heap pages to VMM/PMM) - Fix interrupt safety: stack-balanced pushfd/cli/pop + restore_if (sti only) Fixes Bad TSS caused by popfd restoring dangerous EFLAGS bits (NT, IOPL) - Zero memory via rep stosd instead of byte-by-byte loop Hardening: - kalloc OOM now triggers BSOD instead of returning nil (90% of callers don't check) - Double-free detection in kfree (verify bitmap bits set before clearing) - Guard bytes ({$IFDEF DEBUG_LMM}): $DEADBEEF sentinel for buffer overrun detection - kpalloc: bounds check (block >= 1024 -> GPF) + syslog MMIO mapping audit log Observability: - Add MEMINFO command as src/prog/meminfo.pas (moved from inline kernel.pas) - Displays multiboot memory, PMM block stats, LMM heap stats - Register via progmanager.pas following standard prog pattern Files changed: - src/pmemorymanager.pas - src/vmemorymanager.pas - src/lmemorymanager.pas - src/kernel.pas - src/progmanager.pas - src/prog/meminfo.pas
Merge pull request 'feature/Queues' (#37 ) from feature/Queues into develop
2026-03-04 19:23:46 +00:00 · 2026-03-04 00:06:10 +00:00 · 2026-03-04 00:05:01 +00:00 · 2026-03-04 00:00:56 +00:00 · 2026-03-04 00:00:56 +00:00 · 2026-03-04 00:00:56 +00:00
148 changed files with 74656 additions and 7165 deletions
@@ -0,0 +1,66 @@
 kind: pipeline
 type: docker
 name: build
 steps:
  - name: build-image
    image: plugins/docker
    settings:
      repo: t3hn3rd/asuro-build
      tags: latest
      dockerfile: Dockerfile
      registry: docker.io
      username:
        from_secret: docker_username
      password:
        from_secret: docker_password
  - name: compile
    image: t3hn3rd/asuro-build:latest
    depends_on:
      - build-image
    commands:
      - git fetch --tags
      - find . -type f -print0 | xargs -0 dos2unix
      - chmod +x /drone/src/*.sh
      - /drone/src/compile.sh
  - name: upload-iso-artifact
    image: alpine/git
    depends_on:
      - compile
    when:
      branch:
        - master
    environment:
      GITEA_TOKEN:
        from_secret: gitea_token
    commands:
      - apk add --no-cache curl
      - chmod +w Asuro.iso
      - cp Asuro.iso "Asuro-$(git rev-parse --short HEAD).iso"
      - echo "Uploading Asuro-$(git rev-parse --short HEAD).iso to Gitea Packages..."
      - |
         curl -X PUT "https://gitea.spexeah.com/api/packages/Spexeah/generic/asuro-iso/$(git rev-parse --short HEAD)/Asuro.iso" \
         -H "Authorization: token $GITEA_TOKEN" --upload-file "Asuro-$(git rev-parse --short HEAD).iso"
      - echo "Updating latest ISO reference..."
      - |
        curl -X DELETE https://gitea.spexeah.com/api/packages/Spexeah/generic/asuro-iso/latest/Asuro.iso \
        -H "Authorization: token $GITEA_TOKEN" || echo "No previous latest version found."
      - |
        curl -X PUT https://gitea.spexeah.com/api/packages/Spexeah/generic/asuro-iso/latest/Asuro.iso \
        -H "Authorization: token $GITEA_TOKEN" --upload-file "Asuro-$(git rev-parse --short HEAD).iso"
  - name: msg status
    image: appleboy/drone-discord
    failure: ignore
    depends_on:
      - compile
    when:
      status: [success, failure, changed]
    settings:
      webhook_id:
        from_secret: discord_webhook_id
      webhook_token:
        from_secret: discord_webhook_secret
      message: "**Asuro Build**\n\n{{#success build.status}}✅ Build successful!\n\n{{else}}❌ Build failed!\n\n{{/success}}Repository: `{{repo.namespace}}/{{repo.name}}`\nBranch: `{{commit.branch}}`\nCommit: `{{commit.sha}}`\nAuthor: `{{commit.author}} <{{commit.email}}>`\n\nGitea Diff: [Link](<{{commit.link}}>)\nDrone Build: [Link](<{{build.link}}>)\n\nMessage: {{commit.message}}"
@@ -1 +1,8 @@
 * text=auto eol=lf
 lvglh/** linguist-vendored
 lvgl/** linguist-vendored
 .vscode/* linguist-vendored
 lib/* linguist-generated
 release/* linguist-generated
 iso/* linguist-generated
 *.asm linguist-detectable
@@ -10,5 +10,9 @@
 /*.sh~
 /*.img
 src/include/asuro.pas
-.vscode/launch.json
+localenv.json
-.vscode
+/lvgl/
 dockerout.txt
 AGENTS.md
 *.log
 /doc/*.md
@@ -1,73 +0,0 @@
 stages:
  - Compile Versions
  - Compile Sources
  - Link
  - Generate Documentation
  - Deploy
 cache:
  - key: ${CI_COMMIT_REF_SLUG}
    paths:
      - lib/*.o
      - bin/kernel.bin
      - doc
 before_script:
  - chmod +x *.sh
 versions:
  stage: Compile Versions
  script:
    - ./compile_vergen.sh
  artifacts:
    paths:
      - release/*.svg
      - src/include/asuro.pas
 compile_sources:
  stage: Compile Sources
  script:
    - rm -f lib/*.so
    - ./compile_sources.sh
  needs:
    - versions
 link:
  stage: Link
  script:
    - ./compile_stub.sh
    - ./compile_link.sh
  needs:
    - versions
    - compile_sources
 isogen:
  stage: Deploy
  script:
    - ./compile_isogen.sh
    - ./compile_sumgen.sh
  artifacts:
    paths:
      - ./Asuro.iso
      - ./release/checksum.svg
  needs:
    - link
 docgen:
  stage: Generate Documentation
  only:
    - master
    - develop
  script:
    - ./compile_sourcelist.sh
    - ./compile_docs.sh
    # Remove comments when we want to use gitlab pages.
    #- cp doc public
  allow_failure: true
  artifacts:
    paths:
      - doc
      #- public/*
      #- ./sources.list
  needs:
    - versions
@@ -0,0 +1,13 @@
 # Map all Aaron identities to a single preferred identity
 Aaron Hance <[email protected]> aaron <aaron@6dbc8c32-bb84-406f-8558-d1cf31a0ab0c>
 Aaron Hance <[email protected]> aaronhance <[email protected]>
 Aaron Hance <[email protected]> aaron hance <[email protected]>
 Aaron Hance <[email protected]> Aaron <[email protected]>
 # Map all Kieron identities to a single preferred identity
 Kieron Morris <[email protected]> kieron <kieron@6dbc8c32-bb84-406f-8558-d1cf31a0ab0c>
 Kieron Morris <[email protected]> Kieron <[email protected]>
 Kieron Morris <[email protected]> t3hn3rd <[email protected]>
 # Map goose's multiple identities
 goose <goose@6dbc8c32-bb84-406f-8558-d1cf31a0ab0c> goose <[email protected]>
@@ -3,18 +3,11 @@
        {
            "name":"Run",
            "request": "launch",
-            "type": "coreclr",
+            "type": "PowerShell",
            "preLaunchTask": "Build",
-            "program": "VBoxSDL",
+            "script": "${workspaceFolder}/virtualbox-wrapper.ps1",
-            "args": [
+            "args": ["-Command", "up"],
                "--comment", 
                "Asuro", 
                "--startvm", 
                "7d395c96-891c-4139-b77d-9b6b144b0b93"
            ],
            "cwd": "${workspaceFolder}",
            "console": "internalConsole",
            "internalConsoleOptions": "neverOpen"
        }
    ]
 }
@@ -9,14 +9,18 @@
            "command": "docker-compose",
            "args": [
                "run",
-                "builder"
+                "builder",
            ],
            "type": "shell",
            "problemMatcher": [],
            "group": {
                "kind": "build",
                "isDefault": true
-            }
+            },
            "dependsOn": [
                "Close VirtualBox",
                "Clean"
            ]
        },
        {
            "label": "Build (Builder)",
@@ -26,6 +30,24 @@
                "builder"
            ],
            "type": "shell"
        },
        {
            "label": "Clean",
            "command": "docker-compose",
            "args": [
                "down",
                "--remove-orphans"
            ],
            "type": "shell"
        },
        {
            "label": "Close VirtualBox",
            "command": "./virtualbox-wrapper.ps1",
            "args": [
                "-Command", 
                "down"
            ],
            "type": "shell"
        }
    ]
 }
@@ -5,18 +5,18 @@ VOLUME ["/code"]
 ENV DEBIAN_FRONTEND=noninteractive
 RUN dpkg --add-architecture i386
 RUN apt-get update && apt-get install -y \
-	curl dos2unix wget git make nasm binutils:i386 xorriso grub-pc-bin && \
+	curl dos2unix wget git make nasm binutils xorriso grub-pc-bin gcc gcc-multilib && \
 	apt-get clean my room
 SHELL ["/bin/bash", "-c"]
-ARG FPC_VERSION=2.6.4
+ARG FPC_VERSION=3.2.2
 RUN curl -sL https://sourceforge.net/projects/freepascal/files/Linux/$FPC_VERSION/fpc-$FPC_VERSION.i386-linux.tar/download | tar -xf - && \
 	pushd fpc-$FPC_VERSION.i386-linux && ./install.sh && popd && \
 	rm -rf fpc-$FPC_VERSION.i386-linux
 COPY compile.sh /compile.sh
 ADD https://raw.githubusercontent.com/fsaintjacques/semver-tool/master/src/semver /usr/bin/semver
-RUN mkdir /code && chmod +x /usr/bin/semver
+RUN chmod +x /usr/bin/semver
 WORKDIR /code
 RUN find . -type f -print0 | xargs -0 dos2unix
 ENTRYPOINT ["/bin/bash", "-c"]
@@ -7,7 +7,7 @@ echo "Asuro Compilation"
 echo " "
 #Compile Stub.asm
-rm lib/*
+rm -f lib/*
 runOrFail() {
 	local binary=$1
@@ -20,26 +20,31 @@ runOrFail() {
 	fi
 }
-runOrFail $(pwd)/compile_stub.sh "Failed to compile stub!"
+declare -a run_steps=(
 	"compile_stub.sh" "Failed to compile stub!"
 	"compile_vergen.sh" "Versions failed to compile"
 	"compile_lvgl.sh" "Failed to compile LVGL!"
 	"compile_sources.sh" "Failed to compile FPC Sources!"
 	"compile_link.sh" "Failed linking!"
 	"compile_isogen.sh" "Failed to create ISO!"
 )
-#Generate .pas with versioning headers.
+for ((i=0; i<${#run_steps[@]}; i+=2))
-runOrFail $(pwd)/compile_vergen.sh "Versions failed to compile"
+do
-
+	if [ "$ERRCOUNT" -eq "0" ]
-#Compile all .pas sources
+	then
-runOrFail $(pwd)/compile_sources.sh "Failed to compile FPC Sources!"
+			script=$(pwd)/"${run_steps[$i]}"
-
+			message="${run_steps[$i+1]}"
-#Link into a binary.
+			runOrFail "$script" "$message"
-runOrFail $(pwd)/compile_link.sh "Failed linking!"
+	fi
-
+done
 #Generate an ISO with GRUB as the Bootloader.
 runOrFail ./compile_isogen.sh "Failed to create ISO!"
 #Call generate final artifacts based on failure or success of the above.
 if [ "$ERRCOUNT" -ne "0" ]
 then
-	./compile_finish.sh "failed"
+	. ./compile_finish.sh "failed"
 else
-	./compile_finish.sh "success"
+	. ./compile_finish.sh "success"
 fi
 cd ..
@@ -14,4 +14,9 @@ done;
 objstring=lib/stub.o" "$objstring 
 echo "Object Files: "$objstring
 echo " "
-ld -m elf_i386 -s --gc-sections -Tlinker.script -o bin/kernel.bin $objstring
+
 # Find libgcc for i386 (needed by LVGL compiled with gcc)
 LIBGCC=$(gcc -m32 -print-libgcc-file-name)
 echo "libgcc: ${LIBGCC}"
 ld -m elf_i386 -s --gc-sections -Tlinker.script -o bin/kernel.bin $objstring --start-group lib/liblvgl.a ${LIBGCC} --end-group
@@ -0,0 +1,132 @@
 #!/usr/bin/env bash
 # compile_lvgl.sh — Download LVGL v9.2 source and compile into lib/liblvgl.a
 # Clone & compile in /tmp (fast container-local fs).
 # Cache liblvgl.a on host mount (/code/lvgl/) to skip rebuild.
 set -e
 LVGL_VERSION="v9.2.2"
 LVGL_REPO="https://github.com/lvgl/lvgl.git"
 LVGL_DIR="/tmp/lvgl"
 OBJ_DIR="/tmp/lvgl_obj"
 CONF_DIR="$(pwd)/lvglh"
 OUT_DIR="$(pwd)/lib"
 CACHE_DIR="/code/lvgl"
 CC="gcc"
 CFLAGS="-m32 -march=i686 -ffreestanding \
    -fno-builtin -fno-stack-protector -fno-pic -fno-pie \
    -O2 -Wall -Wno-unused-function -Wno-unused-variable \
    -I${CONF_DIR} \
    -I${LVGL_DIR} \
    -I${LVGL_DIR}/.. \
    -DLV_CONF_INCLUDE_SIMPLE"
 echo " "
 echo "======================="
 echo " "
 echo "Compiling LVGL..."
 echo " "
 # If cached liblvgl.a exists on host mount, just copy it and skip everything
 if [ -f "${CACHE_DIR}/liblvgl.a" ]; then
    echo "Found cached liblvgl.a in ${CACHE_DIR}, copying to ${OUT_DIR}..."
    cp "${CACHE_DIR}/liblvgl.a" "${OUT_DIR}/liblvgl.a"
    echo "(Delete lvgl/liblvgl.a to force a full rebuild.)"
    echo " "
    echo "LVGL compilation complete (cached)."
    echo " "
    exit 0
 fi
 # Clone LVGL into /tmp (container-local)
 rm -rf "$LVGL_DIR"
 echo "Downloading LVGL ${LVGL_VERSION}..."
 git clone --depth 1 --branch "${LVGL_VERSION}" "${LVGL_REPO}" "${LVGL_DIR}" 2>&1
 echo "Download complete."
 # Gather all LVGL .c source files (core library only, no demos/examples)
 SOURCES=$(find "${LVGL_DIR}/src" -name '*.c' -not -path '*/test/*')
 TOTAL=$(echo "$SOURCES" | wc -l)
 echo "Found ${TOTAL} LVGL source files."
 # Compile each .c file to .o (container-local)
 rm -rf "$OBJ_DIR"
 mkdir -p "$OBJ_DIR"
 COUNT=0
 ERRORS=0
 for src in $SOURCES; do
    COUNT=$((COUNT + 1))
    rel="${src#${LVGL_DIR}/src/}"
    obj_path="${OBJ_DIR}/${rel%.c}.o"
    mkdir -p "$(dirname "$obj_path")"
    if ! $CC $CFLAGS -c "$src" -o "$obj_path" 2>&1; then
        echo "FAILED: $rel"
        ERRORS=$((ERRORS + 1))
    fi
    if [ $((COUNT % 50)) -eq 0 ]; then
        echo "  Compiled ${COUNT}/${TOTAL}..."
    fi
 done
 echo "Compiled ${COUNT} files (${ERRORS} errors)."
 if [ "$ERRORS" -ne 0 ]; then
    echo "LVGL compilation FAILED with ${ERRORS} errors."
    exit 1
 fi
 # Archive into static library
 OBJECTS=$(find "$OBJ_DIR" -name '*.o')
 ar rcs "${OUT_DIR}/liblvgl.a" $OBJECTS
 echo "Created ${OUT_DIR}/liblvgl.a"
 # Compile custom LVGL extension files from lvglh/
 LVGLH_SOURCES=$(find "${CONF_DIR}" -name '*.c' 2>/dev/null || true)
 if [ -n "$LVGLH_SOURCES" ]; then
    echo " "
    echo "Compiling custom LVGL files from lvglh/..."
    LVGLH_OBJ_DIR="/tmp/lvglh_obj"
    rm -rf "$LVGLH_OBJ_DIR"
    mkdir -p "$LVGLH_OBJ_DIR"
    HCOUNT=0
    HERRORS=0
    for src in $LVGLH_SOURCES; do
        HCOUNT=$((HCOUNT + 1))
        rel="${src#${CONF_DIR}/}"
        obj_path="${LVGLH_OBJ_DIR}/${rel%.c}.o"
        mkdir -p "$(dirname "$obj_path")"
        echo "  [lvglh] $rel"
        if ! $CC $CFLAGS -c "$src" -o "$obj_path" 2>&1; then
            echo "  FAILED: $rel"
            HERRORS=$((HERRORS + 1))
        fi
    done
    echo "Compiled ${HCOUNT} custom files (${HERRORS} errors)."
    if [ "$HERRORS" -ne 0 ]; then
        echo "Custom LVGL compilation FAILED."
        exit 1
    fi
    # Append custom objects into the existing archive
    HOBJECTS=$(find "$LVGLH_OBJ_DIR" -name '*.o')
    ar rcs "${OUT_DIR}/liblvgl.a" $HOBJECTS
    echo "Updated ${OUT_DIR}/liblvgl.a with custom objects."
 else
    echo "No custom LVGL files in lvglh/."
 fi
 # Cache liblvgl.a and source to host mount for next build
 echo "Caching LVGL to host mount..."
 mkdir -p "$CACHE_DIR"
 rm -rf ${CACHE_DIR}/* ${CACHE_DIR}/.[!.]* ${CACHE_DIR}/..?* 2>/dev/null || true
 cp "${OUT_DIR}/liblvgl.a" "${CACHE_DIR}/liblvgl.a"
 cp -a "$LVGL_DIR/src" "${CACHE_DIR}/src"
 cp -a "$LVGL_DIR"/*.h "${CACHE_DIR}/" 2>/dev/null || true
 cp -a "$OBJ_DIR" "${CACHE_DIR}/obj"
 echo "Done."
 echo " "
 echo "LVGL compilation complete."
 echo " "
@@ -4,4 +4,4 @@ echo "======================="
 echo " "
 echo "Compiling FPC Sources..."
 echo " "
-fpc -Aelf -gw -n -va -O3 -Op3 -Si -Sc -Sg -Xd -CX -XXs -CfSSE -CfSSE2 -Rintel -Pi386 -Tlinux -FElib/ -Fusrc/* -Fusrc/driver/* -Fusrc/driver/net/* src/kernel.pas
+fpc -Aelf -gw -g -gl -n -v0ew -O3 -OpPENTIUM3 -Si -Sc -Sg -Xd -CX -XXs -CfSSE -CfSSE2 -Rintel -Pi386 -Tlinux -FElib/ -Fusrc/* -Fusrc/include/* -Fusrc/driver/* -Fusrc/driver/net/* -Fusrc/driver/bus/* -Fusrc/driver/bus/usb/* -Fusrc/driver/hid/* src/kernel.pas
@@ -1,4 +1,3 @@
 version: "3.9"
 services:
  builder:
    build: .
@@ -2,7 +2,7 @@ ENTRY(loader)
 SECTIONS
 {
  . = 0xC0100000;
-
+  kernel_start = .;
  .text : AT(ADDR(.text) - 0xC0000000)
  {
    text = .; _text = .; __text = .;
@@ -33,4 +33,15 @@ SECTIONS
    . = ALIGN(4096);
  }
  end = .; _end = .; __end = .;
  kernel_end = .;
  /DISCARD/ : {
    *(.init_array*)
    *(.fini_array*)
    *(.ctors)
    *(.dtors)
    *(.eh_frame*)
    *(.gcc_except_table*)
    *(.note.GNU-stack)
  }
 }
@@ -13,8 +13,8 @@ We welcome everyone to give building/breaking/fixing/shooting Asuro a go, feel f
    I don't think this needs an explaination.
 * [VSCode (Optional, but highly recommended)](https://code.visualstudio.com/)
    Visual Studio code is our IDE of choice, and we have a number of recommended plugins.
-    * [C# Plugin by Microsoft](https://marketplace.visualstudio.com/items?itemName=ms-dotnettools.csharp)
+    * [PowerShell Plugin by Microsoft](https://marketplace.visualstudio.com/items?itemName=ms-vscode.powershell)
-        This plugin gives you the ability to use the 'coreclr' task type, allowing the automatic launching of virtualbox with the resulting image generated during compilation of Asuro.
+        This plugin gives you the ability to use the 'PowerShell' task type, allowing the automatic launching of virtualbox with the resulting image generated during compilation of Asuro.
 * [VirtualBox](https://www.virtualbox.org/)
    Virtualbox is our Virtualisation environment of choice, don't ask why, it just is.
@@ -27,15 +27,15 @@ We welcome everyone to give building/breaking/fixing/shooting Asuro a go, feel f
 3. Install Docker for Windows.
 4. Install Git for Windows.
 5. Install VSCode & the listed plugins.
-6. Install VirtualBox.
+6. Install VirtualBox (v7+).
 7. Clone this repository.
 8. Run the following command in the root of the repo to build the docker image:
    ```powershell
-    docker-compose build builder
+    docker compose build builder
    ```
 9. Run the following command to compile Asuro:
    ```powershell
-    docker-compose run builder
+    docker compose run builder
    ```
 10. Create a new virtual machine in Virtualbox and mount the `Asuro.iso` generated in step 9 as a boot image.
 11. Add the virtualbox installation directory to your `%PATH%` environment variable, usually:
@@ -50,32 +50,29 @@ We welcome everyone to give building/breaking/fixing/shooting Asuro a go, feel f
    ```xml
    <Machine uuid="{7d395c96-891c-4139-b77d-9b6b144b0b93}" name="Asuro" OSType="Linux" snapshotFolder="Snapshots" lastStateChange="2021-06-20T20:33:07Z">
    ```
-    Copy the uuid, in our case `7d395c96-891c-4139-b77d-9b6b144b0b93` and replace the uuid found in `.vscode\launch.json` under `args`, so that it looks something like this:
+    Copy the uuid, in our case `7d395c96-891c-4139-b77d-9b6b144b0b93` & create a `localenv.json` file in the project root with the following content:
    ```json
    {
-        "configurations": [
+        "VirtualBox":{
-            {
+            "MachineName":"<YOUR_UUID_OR_MACHINE_NAME>"
-                "name":"Run",
+        }
                "request": "launch",
                "type": "coreclr",
                "preLaunchTask": "Build",
                "program": "VBoxSDL",
                "args": [
                    "--comment", 
                    "Asuro", 
                    "--startvm", 
                    "<YOUR UUID HERE>"
                ],
                "cwd": "${workspaceFolder}",
                "console": "internalConsole",
                "internalConsoleOptions": "neverOpen"
            }
        ]
    }
    ```
    This will allow VSCode to automatically launch VirtualBox once Asuro has been compiled.
    You can also enable the serial adapter "COM1" in mode "Raw File", give it a path, and provide this path in the `localenv.json` as follows:
    ```json
    {
        "VirtualBox" : {
            "MachineName": "<YOUR_UUID_OR_MACHINE_NAME>",
            "LogLocation": "Fully\\Qualified\\Path\\To\\Your\\Log\\File"
        }
    }
    ```
    This will allow you to see the console output from Asuro in your host terminal.
 13. Open your project folder in VSCode, use CTRL+SHIFT+B to build & F5 to build + run in VBox.
 14. Congratulations! You can now play with Asuro!
-### Gotchas
+### Notes & Gotchas
 - The above process has been updated to be compatible with VirtualBox 7+, in which VBoxSDL was removed and vboxmanage should be used in its place. A small wrapper powershell script is used to achieve this.
 - It was noted that Windows builds above `20H2` seem to have issues installing WSL2. We may have to wait for a patch from Microsoft to fix this. Our devs are currently using build `20H2`.
--- a/Show More
+++ b/Show More