Update translated documentation (#1264)

Co-authored-by: bot <bot@dragonos.org>

docs/.translation_cache.json

@@ -277,5 +277,8 @@
   },
   "en:kernel/filesystem/vfs/mountable_fs.md": {
     "hash": "d2ba6ab80dfbc436408ee23e81bbe2ae"
+  },
+  "en:community/ChangeLog/V0.2.x/V0.2.0.md": {
+    "hash": "a14e68302c9478f8acc7368b9f30a95a"
   }
 }

docs/locales/en/community/ChangeLog/V0.2.x/V0.2.0.md

@@ -0,0 +1,222 @@
+:::{note}
+**AI Translation Notice**
+
+This document was automatically translated by `hunyuan-turbos-latest` model, for reference only.
+
+- Source document: community/ChangeLog/V0.2.x/V0.2.0.md
+
+- Translation time: 2025-08-22 15:04:16
+
+- Translation model: `hunyuan-turbos-latest`
+
+Please report issues via [Community Channel](https://github.com/DragonOS-Community/DragonOS/issues)
+
+:::
+
+# DragonOS 0.2.0 Release Notes
+
+> Release Date: 2025-08-22  
+> Version Positioning: 0.2.0 is a milestone release of DragonOS in three dimensions - "Usability, Observability, and Extensibility" - introducing support for **ext4, dynamic linking, eBPF, virtualization, namespaces (initial PID/Mount/User), multi-architecture (x86_64 / RISC-V64 / LoongArch64)**, as well as significant restructuring of the system call subsystem and memory/file cache subsystems, laying the foundation for containerization, networking, and scheduling enhancements in subsequent 0.3.x versions.
+
+---
+
+## 📌 Executive Summary
+
+**Key Highlights:**
+
+1. **File Systems & Storage**: Added ext4; completed mount/umount2; implemented gendisk/partition scanning; `/proc/mounts`; systematic page cache and file mapping; experimental overlayfs support; improved FAT & VFS metadata (statx / newfstatat).
+2. **Processes & Namespaces**: Introduced PID Namespace, Mount Namespace, Namespace Proxy; implemented `unshare()`; improved process group / Session / TTY job control; enhanced `/proc` process information.
+3. **Memory & Virtual Memory**: mmap lazy allocation, `msync`, private/shared file mappings; PageCache dirty page synchronization/recycling; multiple stack usage optimizations and stack overflow fixes; SLAB and buddy recycling improvements.
+4. **Observability & Extensibility**: Initial eBPF support (rbpf → mainline / kprobe / tracepoint / Aya ecosystem); tracepoint framework; static keys.
+5. **Virtualization**: Introduced KVM/VMX basic framework and EPT; cleaned up old KVM code; improved boot stability.
+6. **Architecture**: Added LoongArch64 boot & early exception handling; RISC-V64 improvements; multi-boot protocol abstraction (Multiboot2 / HVM / Serial Console / Framebuffer).
+7. **System Calls & Kernel Structure**: Unified syscall table; modular migration of numerous subsystems; `ERESTARTSYS` mechanism; added/completed numerous system calls (poll/epoll/select, eventfd, execveat, unshare, msync, etc.).
+8. **Security & Permissions**: Cred framework (UID/GID/FSUID/permission determination); `set*id / setres*`; `chown/chmod` migration and fixes.
+9. **Devices & I/O**: virtio console, virtio blk partition recognition, loopback network card, TTY + epoll, HVC, PCI configuration space access, network device sysfs registration.
+10. **Toolchain & Ecosystem**: Dynamic linking (ELF interpreter); Dadk 0.2.0 accelerated builds; unified user-space program builds; experimental integration with Tokio single-threaded runtime; automated documentation translation and versioning.
+11. **Stability & Quality**: Numerous stack frame/deadlock/memory out-of-bounds/race/semantics/wait/PageCache fixes; improved backtrace/unwind; unified logging system.
+
+---
+
+## ⚠️ Breaking / Important Changes
+
+- Dadk upgraded to 0.2.0: Legacy configurations incompatible, migration required per new documentation.
+- Syscall structure reorganization: Subsystems migrated to table-driven architecture; custom patches need adaptation.
+- Default kernel stack size increased from 16K → 32K, with Guard Pages / write protection (x86_64).
+- PageCache semantics upgraded: `mmap` + direct read/write requires combination with `msync`; legacy behavior assumptions need adjustment.
+- Namespace architecture initial: Interfaces may change in the future (still experimental).
+- eBPF interface in early form: Maps / Helpers / type restrictions may change subsequently.
+
+---
+
+## ✨ New / Enhanced Features
+
+### 1. File Systems & VFS
+- **ext4**: Integrated based on another_ext4, mountable from block devices.
+- **mount/umount2**: Real block device mount chain + partition scanning (MBR); supports MountFlags; `/proc/mounts`.
+- **overlayfs (experimental)**: Multiple read-only layers + top-layer write copy-up + whiteout.
+- gendisk abstraction; virtio disk as root file system; automatic block device registration in devfs.
+- FAT/vfat: `rename/move` refactored; `statx` creation time (btime); file mapping; page cache synchronization fixes.
+- VFS: `statx/newfstatat`, `faccessat2`, `linkat/renameat2`, `readlinkat`, etc.; split open/close/stat/ioctl; LookUpFlags; `/proc` extended (kthread marking / FD occupancy / exe link / run/start times / TTY info).
+
+### 2. Processes / Namespaces / Sessions
+- PID Namespace: ID mapping and isolation; nsproxy unified mounting.
+- Mount Namespace: Isolated root mount tree.
+- `unshare()`: New namespace creation (currently covering PID/Mount basics).
+- Session / Process Group: Complete job control; TTY foreground process group signals (SIGINT, etc.); `wait4` fixes.
+- Reboot process enhanced (magic number verification / multiple command reservations).
+
+### 3. Memory Management (MM)
+- `mmap` lazy allocation / `msync` / `mprotect` fixes / `madvise` / `msync` table integration.
+- PageCache: ID management, page writeback, dirty page cleaning, recycling thread, multiple mapping consistency fixes.
+- SLAB → buddy release path completion; stack overflow detection (clippy); large function splitting to reduce stack usage.
+- `mincore()` placeholder returns `ENOSYS`; `truncate_inode_pages` framework.
+
+### 4. Observability & eBPF
+- `bpf()`: Initial Maps / kprobe / statistical examples; rbpf upgraded → mainline; Aya-compatible templates.
+- Tracepoint framework; static key support for conditional hotspot enabling.
+
+### 5. Virtualization & Platform
+- Initial KVM/VMX + EPT; old KVM code cleaned up.
+- HVM / Multiboot2 / boot command line parsing (Arg/KV/EarlyKV).
+- LoongArch64: Boot into `kernel_main` + exception handling; RISC-V64 runs Rust HelloWorld; multi-platform serial console/console abstraction; Serial Console + nographic.
+
+### 6. Devices & I/O
+- virtio console (HVC); virtio blk/net/console interrupt naming improvements; PCI configuration space access (portio).
+- Loopback network card; network device sysfs nodes and attributes; DHCP stability.
+- `eventfd` / `epoll` / `poll` / `ppoll` / `select` / `pselect6`: Consistent wait/timeout/signal handling.
+- TTY: Adapted to epoll; control character parsing; baud rate/termios; tab/erase fixes; SIGINT broadcasting.
+
+### 7. Security & Accounts
+- Cred framework: UID/EUID/FSUID/GID/group lists; `seteuid/setegid/setres*`; `chown/chmod/fchownat/lchown`.
+- `get/setgroups`; `umask` type transformation; `/proc` status name refinement.
+
+### 8. System Call Subsystem
+- Unified syscall table; `ERESTARTSYS`; batch migration (process/mm/vfs/ipc).
+- Added/completed: `mount`, `umount2`, `eventfd`, `poll/ppoll/select/pselect6`, `epoll` refactored, `fchdir`, `mkdirat/mkdirat2`, `utimensat/utimes`, `newfstatat/statx`, `execveat`, `unshare`, `set|getgroups`, `msync`, `madvise`, `mremap`, `mprotect`, `brk/sbrk`, `reboot` enhanced, `rt_sigpending`, `mincore(ENOSYS)`, etc.
+
+### 9. Toolchain / Build / Documentation
+- Dadk 0.2.0: Image lifecycle management / build acceleration / profiling.
+- Unified user program builds: Rust + C; example Rust applications.
+- Dynamic linking ELF interpreter; busybox boot mode & NovaShell/DragonReach evolution.
+- Automated documentation translation, multilingual, multi-version Sphinx; footer shows commit; README / Q&A / namespace docs updated.
+- CI: Docker build caching, branch-triggered, automatic image pushing, MinIO/S3 distribution, loongarch64 QEMU builds, toolchain nightly locking, backtrace/unwind upgrades, stack overflow tests.
+
+---
+
+## 🚀 Performance & Resource Footprint
+
+- Reduced multiple large stack frames: IRQ initialization split, ACPI table reading macro-ized, process create/memory pool structure rewritten (Vec replacing large arrays).
+- PageCache secondary mapping write panic fixes → improved mmap IO coherence; reduced copies.
+- SLAB free page recycling → buddy, reducing resident memory.
+- Early detection of illegal writes via write protection + Guard Pages.
+
+---
+
+## 🛠 Stability & Key Fixes
+
+Representative fixes:
+
+- Wait/process: `wait/wait4` semantics, `do_wait` lock release, blocked child process handling.
+- I/O Multiplexing: epoll inode reference release, epoll timeout/wake broadcast, poll boundary/RestartBlock.
+- Pipes/signals: pipe/FIFO non-blocking + signal/kill semantics; blocked pipes can be killed; named pipes POSIX behavior.
+- PageCache: mmap multi-instance consistency; writeback of dropped address space panic; `unlink` post dirty page handling.
+- futex: User-space address safety `safe_read/safe_write`; robust list.
+- Signals: Default handler restoration; SIGINT distribution; KILL pid=1 feedback; pending not masked check; `execve` error propagation.
+- TTY: Foreground process group null-setting error; init early character input crash; tab expansion out-of-bounds.
+- Timers: Insertion boundaries; `sleep` interrupted by signals `ERESTARTSYS`.
+- Races/memory: slab UAF/out-of-bounds; ntytData stack overflow; buddy construction large stack frame; incorrect kernel address RIP output.
+- File Systems: `getcwd` semantics; `read O_PATH` validation; `unlink` post dirty cleaning; remount errors; `mprotect vm_flags`.
+- ELF: Interpreter path read out-of-bounds; `execve` failure error code.
+- Multiplexing: `select/pselect6` initial compilation issues.
+- virtio/PCI: Multi-device interrupt conflicts; PCI initialization order; virtio net interrupt handling.
+- Networking: DHCP network card order; loopback / poll listen states.
+
+---
+
+## 🧾 New System Call List (Partial)
+
+`mount`, `umount2`, `fchdir`, `mkdirat/mkdirat2`, `linkat/renameat/renameat2`, `newfstatat`, `statx`, `readlinkat`, `faccessat/faccessat2`, `eventfd`, `poll`, `ppoll`, `select`, `pselect6`, `epoll` (refactored), `utimensat`, `utimes`, `msync`, `madvise`, `mremap`, `mprotect`, `brk/sbrk` (table-ized), `execveat`, `unshare`, `setgroups/getgroups`, `rt_sigpending`, `reboot` (enhanced), `mincore(ENOSYS)` ...
+
+---
+
+## 🧪 Development & Build Experience
+
+- Dadk 0.2.0: Unified image creation / mounting / unmounting; build acceleration; profiling.
+- User Programs: Unified Rust + C build pipeline; Rust examples.
+- Toolchain: Fixed nightly versions & upgrade scripts; multi-architecture cross-toolchain scripts.
+- Documentation: Automated translation & stale content cleanup; bilingual (Chinese/English); FAQ / build issue guidance.
+
+---
+
+## 🙌 Contributors (Partial, by Commit Activity / Alphabetical)
+
+Thanks to all contributors for their ongoing efforts in kernel subsystems, file systems, virtualization, documentation, and toolchains.
+
+Special thanks to the following core contributors:
+
+- **longjin** - Project lead, numerous core feature implementations and restructurings
+- **chenlinfeng (Godones)** - eBPF, networking, file systems, etc.
+- **sparkzky** - TTY, process management, system call restructurings
+- **MemoryShore** - File systems, memory management, VFS
+- **Samuel Dai** - KVM, networking, drivers
+- **黄铭涛** - PCI, drivers, kernel optimizations
+- And all other contributors!
+
+### Contributors for This Release
+
+LoGin <longjin@DragonOS.org>, <jinlong@tencent.com><br>
+linfeng: <chenlinfeng25@outlook.com>, <1925466036@qq.com><br>
+火花 <sparkhhhhhhhhhh@outlook.com>, <146502758+sparkzky@users.noreply.github.com><br>
+MemoryShore: <1353318529@qq.com>, <105195940+MemoryShore@users.noreply.github.com><br>
+黄铭涛: <1037827920@qq.com>, <114841534+1037827920@users.noreply.github.com><br>
+Jomo <xuzihao@dragonos.org><br>
+Samuel Dai: <samuka007@dragonos.org>, <dailvchen@dragonos.org><br>
+曾俊 <110876916+ZZJJWarth@users.noreply.github.com><br>
+kaleidoscope416 <2448956191@qq.com><br>
+github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com><br>
+DoL <1240800466@qq.com><br>
+donjuanplatinum <113148619+donjuanplatinum@users.noreply.github.com><br>
+chiichen <chiichen@qq.com><br>
+BrahmaMantra <140599389+BrahmaMantra@users.noreply.github.com><br>
+Vitus: <zhzvitus@gmail.com>, <144411726+Vitus213@users.noreply.github.com><br>
+YJwu2023 <yujianwu2019@gmail.com><br>
+GnoCiYeH <heyicong@dragonos.org><br>
+LIU Yuwei <22045841+Marsman1996@users.noreply.github.com><br>
+yuyi2439 <68320855+yuyi2439@users.noreply.github.com><br>
+codeironman <1553389239@qq.com><br>
+EMasi <1176949486@qq.com><br>
+SMALLC <121806694+smallcjy@users.noreply.github.com><br>
+laokengwt <143977175+laokengwt@users.noreply.github.com><br>
+Godones <chenlinfeng25@outlook.com><br>
+oeasy1412 <oeasy1412@gmail.com><br>
+dragonosbot <bot@dragonos.org><br>
+xiaolin2004 <1553367438@qq.com>, <109840258+xiaolin2004@users.noreply.github.com>
+
+---
+
+## ✅ Smoke Test Checklist
+
+- Basic boot: x86_64 / riscv64 / loongarch64 (serial/graphics); check `/proc/mounts` `/proc/*/status`.
+- Dynamic linking: Run dynamically linked busybox / Rust programs.
+- File Systems: Mount ext4 & vfat; create/delete/rename; `mmap` + direct write + `msync`.
+- Process Control: Multiple shells / Ctrl+C / foreground/background switching.
+- Networking: loopback ping / DHCP initialization logs.
+- eBPF: Load example kprobe statistical program; read `trace_pipe`.
+- poll/epoll: Run `test_poll` / `test_epoll`.
+- reboot: Execute reboot system call (simulated).
+- Namespaces: Test `unshare` (mount isolation / PID observation).
+
+---
+
+## 🙏 Acknowledgements
+
+Thanks to all developers, testers, documentation contributors, and community users for their feedback. DragonOS 0.2.0 builds upon the experiments and accumulations of previous versions, and also lays the structural foundation for subsequent containerization, resource isolation, and performance optimizations. Welcome to continue participating via Issues / PRs / discussion forums.
+
+---
+
+## 🔎 Appendix: Keyword Index (for Easy Reference)
+
+`ext4` `overlayfs` `PageCache` `mmap` `PID namespace` `mount namespace` `unshare` `syscall table` `eBPF` `kprobe` `tracepoint` `Aya` `KVM` `VMX` `EPT` `LoongArch64` `RISC-V` `virtio console` `loopback` `eventfd` `poll` `epoll` `select` `pselect6` `ppoll` `statx` `newfstatat` `execveat` `dynamic linking` `Dadk 0.2.0` `Cred` `chown` `msync` `mprotect` `utimensat` `reboot` `slab` `buddy` `Guard Page` `WP` `Tokio` `groupprocess/session`
+
+-- END OF DragonOS 0.2.0 Release Notes --