Merge dev into main

.github/workflows/actions/setup-musl/action.yml

@@ -20,8 +20,8 @@ runs:
     shell: bash
     run: |
       MUSL_PATH=${{ inputs.arch }}-linux-musl-cross
-      wget https://musl.cc/${MUSL_PATH}.tgz
-      tar -xf ${MUSL_PATH}.tgz
+      git clone -b ${{ inputs.arch }} https://github.com/syswonder/ruxos-musl-toolchain.git
+      tar -xf ruxos-musl-toolchain/${MUSL_PATH}.tgz
   - uses: actions/cache/save@v3
     if: steps.cache-musl.outputs.cache-hit != 'true'
     with:

.github/workflows/build.yml

@@ -3,11 +3,11 @@ name: Build CI
 on: [push, pull_request]
 
 env:
-  rust-toolchain: nightly-2023-09-01
+  rust-toolchain: nightly-2025-05-07
 
 jobs:
   clippy:
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-22.04
     strategy:
       fail-fast: false
     steps:
@@ -37,7 +37,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        os: [ubuntu-latest]
+        os: [ubuntu-22.04]
         arch: [x86_64, riscv64, aarch64]
     steps:
     - uses: actions/checkout@v3
@@ -51,7 +51,7 @@ jobs:
     - uses: actions-rs/[email protected]
       with:
         crate: cargo-binutils
-        version: latest
+        version: 0.3.5
         use-tool-cache: true
     - name: Install gcc multilib
       run: sudo apt update && sudo apt install -y gcc-multilib
@@ -66,7 +66,7 @@ jobs:
     - name: Build display/draw_map
       run: make ARCH=${{ matrix.arch }} A=apps/display/draw_map
     - name: Build fs/shell
-      run: make ARCH=${{ matrix.arch }} A=apps/fs/shell
+      run: make ARCH=${{ matrix.arch }} A=apps/fs/shell FEATURES=fatfs
 
     - name: Build c/helloworld
       run: make ARCH=${{ matrix.arch }} A=apps/c/helloworld
@@ -83,18 +83,18 @@ jobs:
     - name: Build c/iperf
       run: |
         git clone https://github.com/syswonder/rux-iperf ./apps/c/iperf/ \
-          && make ARCH=${{ matrix.arch }} A=apps/c/iperf
+          && make ARCH=${{ matrix.arch }} A=apps/c/iperf FEATURES=fatfs
     - name: Build c/redis
       run: |
         git clone https://github.com/syswonder/rux-redis ./apps/c/redis/ \
-          && make ARCH=${{ matrix.arch }} A=apps/c/redis SMP=4
+          && make ARCH=${{ matrix.arch }} A=apps/c/redis SMP=4 FEATURES=fatfs
 
   build-apps-for-std:
     runs-on: ${{ matrix.os }}
     strategy:
       fail-fast: false
       matrix:
-        os: [ubuntu-latest]
+        os: [ubuntu-22.04]
         arch: [x86_64]
     steps:
     - uses: actions/checkout@v3

.github/workflows/commit.yml

@@ -0,0 +1,104 @@
+name: Custom Commit Message Validator
+
+on:
+  pull_request:
+    types: [opened, reopened, synchronize] # Triggers on PR open, reopen, or new commits pushed to the PR branch
+
+jobs:
+  validate_commit_messages:
+    runs-on: ubuntu-latest # Specifies the runner environment
+
+    permissions:
+      contents: read # Needed for checkout
+      pull-requests: read # Needed to fetch PR details and commit SHAs
+
+    steps:
+      - name: Checkout Repository
+        uses: actions/checkout@v4 # Action to checkout your repository
+        with:
+          fetch-depth: 0 # Fetches the entire history for git log operations. Crucial for retrieving full commit messages.
+
+      - name: Get PR Commits SHAs
+        id: get_pr_commits
+        run: |
+          # Use GitHub CLI to get all commit SHAs associated with the current Pull Request.
+          # This robustly gets the commits that are part of the PR's changes.
+          # The jq filter extracts the 'oid' (Object ID, which is the SHA) of each commit.
+          PR_COMMIT_SHAS=$(gh pr view ${{ github.event.pull_request.number }} --json commits --jq '[.commits[].oid] | join(" ")')
+
+          # Output the SHAs as a space-separated string.
+          # This variable will be accessible via steps.get_pr_commits.outputs.PR_COMMITS_LIST
+          echo "PR_COMMITS_LIST=${PR_COMMIT_SHAS}" >> "$GITHUB_OUTPUT"
+        env:
+          # GITHUB_TOKEN is automatically provided by GitHub Actions with sufficient permissions.
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Validate Each Commit Message
+        run: |
+          # Read the space-separated list of commit SHAs into a Bash array.
+          # IFS (Internal Field Separator) is set to space to split the string correctly.
+          IFS=' ' read -r -a commit_shas <<< "${{ steps.get_pr_commits.outputs.PR_COMMITS_LIST }}"
+
+          # Initialize a flag to track if any commit fails validation.
+          has_validation_failed=false
+
+          # Loop through each commit SHA.
+          for commit_sha in "${commit_shas[@]}"; do
+            echo "--- Checking commit: ${commit_sha} ---"
+
+            # Get the full commit message (subject + body).
+            # --format=%B gets the raw body (subject and body).
+            # -n 1 limits to the latest commit for the given SHA.
+            commit_message=$(git log --format=%B -n 1 "${commit_sha}")
+            echo "Message content:"
+            echo "${commit_message}"
+            echo "" # Add a newline for readability
+
+            # --- Validation Logic ---
+
+            # 1. Check for Conventional Commit format (type(scope)!: subject)
+            # This regex allows for an optional scope and an optional breaking change marker (!).
+            # Common types: feat, fix, docs, chore, style, refactor, perf, test, build, ci, revert
+            if [[ ! "${commit_message}" =~ ^(feat|fix|docs|chore|style|refactor|perf|test|build|ci|revert)(\([a-zA-Z0-9_-]+\))?(!?): ]]; then
+              echo "::error file=COMMIT_MESSAGE::Commit ${commit_sha} does not start with a conventional commit type (e.g., 'feat:', 'fix:'). Message: '${commit_message}'"
+              has_validation_failed=true
+              continue # Move to the next commit
+            fi
+
+            # Extract the first line (subject) for further checks.
+            commit_subject=$(echo "${commit_message}" | head -n 1)
+
+            # 2. Check subject line length (e.g., max 72 characters)
+            if [[ ${#commit_subject} -gt 72 ]]; then
+              echo "::warning file=COMMIT_MESSAGE::Commit ${commit_sha} subject line exceeds 72 characters. Length: ${#commit_subject}. Subject: '${commit_subject}'"
+              # This is a warning, not a failure, adjust as needed.
+            fi
+
+            # 3. Check for empty line between subject and body (if body exists)
+            # Check if there's more than just the subject line.
+            if [[ $(echo "${commit_message}" | wc -l) -gt 1 ]]; then
+              # Check if the second line is empty.
+              # Use awk to get the second line and trim whitespace.
+              second_line=$(echo "${commit_message}" | awk 'NR==2 {print}' | xargs)
+              if [[ -n "${second_line}" ]]; then # If the second line is NOT empty
+                echo "::error file=COMMIT_MESSAGE::Commit ${commit_sha} is missing an empty line between the subject and body. Message: '${commit_message}'"
+                has_validation_failed=true
+                continue
+              fi
+            fi
+
+            # Add more custom validation rules here as needed:
+            # - Subject capitalization (e.g., must be lowercase)
+            # - Subject must not end with a period
+            # - Body line length limits
+            # - Required body content for certain types (e.g., 'fix:' requires a 'Fixes #ISSUE' line)
+
+          done # End of commit loop
+
+          # If any commit failed validation, exit with a non-zero status to fail the job.
+          if [ "$has_validation_failed" = true ]; then
+            echo "::error::One or more commit messages failed validation. Please review the errors above."
+            exit 1
+          fi
+
+          echo "All commit messages in the PR passed validation."

.github/workflows/docs.yml

@@ -3,11 +3,11 @@ name: Build & Deploy docs
 on: [push, pull_request]
 
 env:
-  rust-toolchain: nightly-2023-09-01
+  rust-toolchain: nightly-2025-05-07
 
 jobs:
   doc:
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-22.04
     strategy:
       fail-fast: false
     permissions:

.github/workflows/license.yml

@@ -0,0 +1,25 @@
+name: License Header Check
+
+on:
+  pull_request:
+    types: [opened, reopened, synchronize] # Triggers on PR open, reopen, or new commits pushed to the PR branch
+
+jobs:
+  check_license_headers:
+    runs-on: ubuntu-latest # Specifies the runner environment
+
+    permissions:
+      contents: read # Needed for checkout
+
+    steps:
+      - name: Checkout Repository
+        uses: actions/checkout@v4 # Action to checkout your repository
+        # with:
+          # fetch-depth: 0 is not strictly necessary for license check unless your script
+          # needs to read historical commits, which a basic license checker usually doesn't.
+          # Default fetch-depth is 1, which is usually sufficient.
+          # If your license checker needs to diff against a base branch, you might need fetch-depth: 0
+          # or a specific fetch-depth. For a simple "check all files" script, default is fine.
+
+      - name: Run License Checker Script
+        run: bash scripts/test/license_checker.sh # Path to your license checking script

.github/workflows/test.yml

@@ -4,11 +4,11 @@ on: [push, pull_request]
 
 env:
   qemu-version: 7.1.0
-  rust-toolchain: nightly-2023-09-01
+  rust-toolchain: nightly-2025-05-07
 
 jobs:
   unit-test:
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-22.04
     steps:
     - uses: actions/checkout@v3
       with:
@@ -26,7 +26,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        os: [ubuntu-latest]
+        os: [ubuntu-22.04]
         arch: [x86_64, riscv64, aarch64]
     steps:
     - uses: actions/checkout@v3
@@ -40,7 +40,7 @@ jobs:
     - uses: actions-rs/[email protected]
       with:
         crate: cargo-binutils
-        version: latest
+        version: 0.3.5
         use-tool-cache: true
     - name: Install gcc multilib
       run: sudo apt update && sudo apt install -y gcc-multilib

.gitignore

@@ -10,11 +10,12 @@ compile_commands.json
 /fw_dynamic.bin
 
 *.asm
-disk.img
+*.img
 actual.out
-qemu.log
+*.log
 rusty-tags.vi
 apps/c/redis/
 apps/c/iperf/
 apps/c/wamr/
 apps/c/nginx/
+apps/c/python3/

CHANGELOG.md

@@ -0,0 +1,79 @@
+# CHANGELOG
+
+## [v0.1.0] - 2025-07
+
+### ✨ New Features
+#### Architecture Support
+- **RISC-V64** (#196)
+  - mmap & process fork implementation
+  - Toolchain compatibility fixes
+- **ARM Enhancements** (#183)
+  - GICv3 interrupt controller
+  - Device Tree Blob (DTB) parsing
+
+#### Core Systems
+- **Filesystem & Storage**
+  - FUSE integration (#201)
+  - New syscalls: `fchmodat` (#190), `ftruncate` (#187)
+  - VFS refactoring with ext4/fatfs support (#152)
+  - Unified file/directory implementations (#186)
+  - FIFO/named pipes (#185) & PTY support (#189)
+- **Networking & IPC**
+  - UNIX socket enhancements (#195)
+  - DGRAM support (#164) & `socketpair` (#171)
+  - Static routing with loopback support (#179)
+- **Device Drivers**
+  - Virtio subsystem updates (#205)
+  - Virtio-console support (#143)
+  - TTY/Termios improvements (#181)
+- **Process Management**
+  - Signal handling (#178) & `rt_sigaction` (#131)
+  - CLOEXEC flag support (#162)
+
+### 🐛 Bug Fixes
+- Fixed `rename` operations (#202)
+- Resolved busybox page faults (#194)
+- Fixed network buffer memory leaks (#173)
+- Corrected page fault handling during nested forks (#151)
+- Fixed `wait4` null pointer dereference (#166)
+- Resolved file close scheduling deadlock (#175)
+- Corrected `getsockopt` implementation (#170)
+- Fixed percpu crate alignment (#184)
+
+### ⚙️ Infrastructure
+- Toolchain upgraded to `nightly-2025-05-07` (#197)
+
+### 📦 Applications
+- Support for sshd after PR #202
+
+---
+
+## [v0.0.3] - Initial Release
+
+### 🚀 Core Capabilities
+- **Architectures**: x86_64 • AArch64 • RiscV64
+- **Platforms**: QEMU pc-q35 (x86) • virt (RiscV/ARM)
+- **Schedulers**: FIFO • RR • CFS
+- **Drivers**: VirtIO (net, blk, gpu, 9p)
+- **Networking**: TCP/UDP stack (smoltcp/LwIP)
+- **Filesystems**: fatfs • ramfs • 9pfs • devfs
+- **Dynamic App Loading** (#97)
+
+### 📦 Supported Applications
+| Application | Functionality | Repository |
+|-------------|---------------|------------|
+| **Redis** | Server with `redis-cli` & benchmark | [syswonder/rux-redis](https://github.com/syswonder/rux-redis) |
+| **Nginx** | HTTP/HTTPS web server | [syswonder/rux-nginx](https://github.com/syswonder/rux-nginx) |
+| **Wamr** | WASM execution + wasi-nn | [syswonder/rux-wamr](https://github.com/syswonder/rux-wamr) |
+| **Iperf** | Network performance testing | [syswonder/rux-iperf](https://github.com/syswonder/rux-iperf) |
+| **Sqlite** | Embedded SQL database | |
+| **Python** | Python 3 runtime | [syswonder/rux-python3](https://github.com/syswonder/rux-python3) |
+
+### 🛠️ Development Ecosystem
+- **Languages**: Rust • C/C++ (musl/ruxlibc) • Perl
+- **Tools**: [RuxGo](https://github.com/syswonder/ruxgo)
+- **Documentation**:
+  - [RuxOS-Book](https://ruxos.syswonder.org)
+  - [RuxGo-Book](https://ruxgo.syswonder.org)
+
+> **Get Started**: We recommend beginning with the [RuxOS-Book](https://ruxos.syswonder.org)