Feat/x86 64 ptrace clean

.gitignore

@@ -62,4 +62,7 @@ third_party/
 os/StarryOS-REF
 .Ds_Store
 starry-*.log
-loongarch64-axvisor-guest-tests.md
+loongarch64-axvisor-guest-tests.md
+
+# GitHub page snapshots accidentally saved into the repo
+*rcore-os_tgoskits*.html

apps/starry/gdb/build-x86_64-unknown-none.toml

@@ -0,0 +1,10 @@
+target = "x86_64-unknown-none"
+env = { AX_IP = "10.0.2.15", AX_GW = "10.0.2.2" }
+log = "Warn"
+features = [
+  "ax-driver/virtio-blk",
+  "ax-driver/virtio-net",
+  "ax-driver/virtio-gpu",
+  "ax-driver/virtio-input",
+  "ax-driver/virtio-socket",
+]

apps/starry/gdb/prebuild.sh

@@ -0,0 +1,177 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+app_dir="${STARRY_APP_DIR:-$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)}"
+base_rootfs="${STARRY_ROOTFS:-${STARRY_BASE_ROOTFS:-}}"
+staging_root="${STARRY_STAGING_ROOT:-}"
+overlay_dir="${STARRY_OVERLAY_DIR:-}"
+
+READELF="${READELF:-readelf}"
+
+require_env() {
+    local name="$1"
+    local value="$2"
+    if [[ -z "$value" ]]; then
+        echo "error: $name is required" >&2
+        exit 1
+    fi
+}
+
+ensure_host_tools() {
+    local missing=()
+
+    command -v debugfs >/dev/null 2>&1 || missing+=(e2fsprogs)
+    command -v install >/dev/null 2>&1 || missing+=(coreutils)
+    command -v "$READELF" >/dev/null 2>&1 || missing+=("readelf (binutils)")
+
+    if [[ ${#missing[@]} -eq 0 ]]; then
+        return
+    fi
+
+    if ! command -v apt-get >/dev/null 2>&1; then
+        echo "error: missing required host packages and apt-get is unavailable: ${missing[*]}" >&2
+        exit 1
+    fi
+
+    echo "installing missing host packages: ${missing[*]}"
+    apt-get update
+    apt-get install -y --no-install-recommends "${missing[@]}"
+}
+
+extract_base_rootfs() {
+    debugfs -R "rdump / $staging_root" "$base_rootfs"
+}
+
+ensure_musl_ld() {
+    local musl_ld="$staging_root/lib/ld-musl-x86_64.so.1"
+
+    if [[ ! -x "$musl_ld" ]]; then
+        echo "error: musl dynamic linker not found: $musl_ld" >&2
+        exit 1
+    fi
+}
+
+install_gdb_package() {
+    local musl_ld="$staging_root/lib/ld-musl-x86_64.so.1"
+    local guest_apk="$staging_root/sbin/apk"
+    local apk_cache="${STARRY_WORKSPACE:-$(cd "$app_dir/../../.." && pwd)}/target/gdb-apk-cache"
+
+    mkdir -p "$apk_cache"
+
+    if [[ ! -x "$guest_apk" ]]; then
+        echo "error: staging root is missing guest apk: $guest_apk" >&2
+        exit 1
+    fi
+
+    if [[ -f /etc/resolv.conf ]]; then
+        cp /etc/resolv.conf "$staging_root/etc/resolv.conf"
+    fi
+
+    echo "Installing gdb via musl ld (Alpine x86_64)..."
+    "$musl_ld" \
+        --library-path "$staging_root/lib:$staging_root/usr/lib:$staging_root/usr/local/lib" \
+        "$guest_apk" \
+        --root "$staging_root" \
+        --repositories-file "$staging_root/etc/apk/repositories" \
+        --keys-dir "$staging_root/etc/apk/keys" \
+        --cache-dir "$apk_cache" \
+        --update-cache \
+        --timeout 60 \
+        --no-interactive \
+        --force-no-chroot \
+        --scripts=no \
+        add gdb
+}
+
+copy_file_to_overlay() {
+    local guest_path="$1"
+    local mode="$2"
+    local source="$staging_root${guest_path}"
+    local target="$overlay_dir${guest_path}"
+
+    if [[ ! -e "$source" ]]; then
+        echo "error: missing guest file after gdb package install: $guest_path" >&2
+        exit 1
+    fi
+
+    if [[ -L "$source" ]]; then
+        source="$(readlink -f "$source")"
+    fi
+
+    install -Dm"$mode" "$source" "$target"
+}
+
+find_library_path() {
+    local library="$1"
+    local dir
+
+    for dir in lib usr/lib usr/local/lib; do
+        if [[ -e "$staging_root/$dir/$library" ]]; then
+            printf '/%s/%s\n' "$dir" "$library"
+            return 0
+        fi
+    done
+
+    return 1
+}
+
+copy_runtime_dependencies() {
+    local pending=("$@")
+    local seen=" "
+    local guest_path library
+
+    while [[ ${#pending[@]} -gt 0 ]]; do
+        guest_path="${pending[0]}"
+        pending=("${pending[@]:1}")
+
+        if [[ "$seen" == *" $guest_path "* ]]; then
+            continue
+        fi
+        seen+="$guest_path "
+
+        while IFS= read -r library; do
+            local library_path
+            if ! library_path="$(find_library_path "$library")"; then
+                continue
+            fi
+            copy_file_to_overlay "$library_path" 0644
+            pending+=("$library_path")
+        done < <(
+            "$READELF" -d "$staging_root$guest_path" 2>/dev/null |
+                sed -n 's/.*Shared library: \[\(.*\)\].*/\1/p'
+        )
+    done
+}
+
+populate_overlay() {
+    copy_file_to_overlay /usr/bin/gdb 0755
+    copy_file_to_overlay /usr/bin/python3 0755
+    copy_runtime_dependencies /usr/bin/gdb /usr/bin/python3
+
+    if [[ -d "$staging_root/usr/share/gdb" ]]; then
+        mkdir -p "$overlay_dir/usr/share"
+        cp -rL "$staging_root/usr/share/gdb" "$overlay_dir/usr/share/"
+    fi
+    if [[ -d "$staging_root/usr/lib/python3.12" ]]; then
+        mkdir -p "$overlay_dir/usr/lib"
+        cp -rL "$staging_root/usr/lib/python3.12" "$overlay_dir/usr/lib/"
+    fi
+    if [[ -e "$staging_root/usr/lib/python312.zip" ]]; then
+        copy_file_to_overlay /usr/lib/python312.zip 0644
+    fi
+    for lib in "$staging_root"/usr/lib/libpython3.12.so*; do
+        if [[ -f "$lib" ]] && [[ ! -L "$lib" ]]; then
+            copy_file_to_overlay "/usr/lib/$(basename "$lib")" 0644
+        fi
+    done
+}
+
+require_env STARRY_ROOTFS "$base_rootfs"
+require_env STARRY_STAGING_ROOT "$staging_root"
+require_env STARRY_OVERLAY_DIR "$overlay_dir"
+
+ensure_host_tools
+extract_base_rootfs
+ensure_musl_ld
+install_gdb_package
+populate_overlay

apps/starry/gdb/qemu-x86_64-interactive.toml

@@ -0,0 +1,17 @@
+args = [
+    "-nographic",
+    "-m",
+    "512M",
+    "-device",
+    "virtio-blk-pci,drive=disk0",
+    "-drive",
+    "id=disk0,if=none,format=raw,file=${workspace}/tmp/axbuild/rootfs/rootfs-x86_64-alpine.img",
+    "-device",
+    "virtio-net-pci,netdev=net0",
+    "-netdev",
+    "user,id=net0",
+]
+uefi = false
+to_bin = false
+shell_prefix = "root@starry:"
+timeout = 3600

apps/starry/gdb/qemu-x86_64.toml

@@ -0,0 +1,20 @@
+args = [
+    "-nographic",
+    "-m",
+    "512M",
+    "-device",
+    "virtio-blk-pci,drive=disk0",
+    "-drive",
+    "id=disk0,if=none,format=raw,file=${workspace}/tmp/axbuild/rootfs/rootfs-x86_64-alpine.img",
+    "-device",
+    "virtio-net-pci,netdev=net0",
+    "-netdev",
+    "user,id=net0",
+]
+uefi = false
+to_bin = false
+shell_prefix = "root@starry:"
+shell_init_cmd = "gdb --version && echo GDB_SMOKE_PASSED"
+success_regex = ["(?m)^GDB_SMOKE_PASSED\\s*$"]
+fail_regex = ['(?i)\bpanic(?:ked)?\b']
+timeout = 120

components/axcpu/src/x86_64/context.rs

@@ -160,7 +160,7 @@ struct ContextSwitchFrame {
 /// See <https://www.felixcloutier.com/x86/fxsave> for more details.
 #[allow(missing_docs)]
 #[repr(C, align(16))]
-#[derive(Debug)]
+#[derive(Clone, Copy, Debug)]
 pub struct FxsaveArea {
     pub fcw: u16,
     pub fsw: u16,

components/axcpu/src/x86_64/trap.rs

@@ -53,6 +53,13 @@ fn handle_debug(tf: &mut TrapFrame) {
     if crate::trap::debug_handler(tf) {
         return;
     }
+    // Kernel-mode #DB was not claimed by any handler.
+    // Unclaimed user-mode #DB is routed through the user-space exception loop
+    // (.Ltrap_user → .Lexit_user in trap.S), so `x86_trap_handler` is only
+    // reached for kernel-mode traps. An unhandled kernel #DB is a fatal
+    // condition: if resumed the CPU re-executes the faulting instruction,
+    // likely looping into a triple fault.
+    warn!("Unhandled kernel #DB @ {:#x}", tf.rip);
     let bt = tf.backtrace();
     panic!(
         "Unhandled #DB @ {:#x}, error_code={:#x}:\n{:#x?}\n{}",