doc: Add ai doc translate tool and add English doc. (#1168)

- add tools/doc_translator.py
- translated docs into English

Signed-off-by: longjin <longjin@DragonOS.org>

docs/.translation_cache.json

@@ -0,0 +1,269 @@
+{
+  "en:kernel/memory_management/index.rst": {
+    "hash": "e394aa123a0030c0ec4276485fc764b7"
+  },
+  "en:kernel/debug/index.rst": {
+    "hash": "6dc058a954b8620162e8293faa4959b2"
+  },
+  "en:kernel/libs/index.rst": {
+    "hash": "d8667f36cbfe9d9f532737a3fbe39f2d"
+  },
+  "en:kernel/process_management/index.rst": {
+    "hash": "b200476562e580ee97d8a3ffe19d5605"
+  },
+  "en:kernel/libs/unified-init.md": {
+    "hash": "28374260f0134386d53392156d749733"
+  },
+  "en:kernel/process_management/load_binary.md": {
+    "hash": "b7d462c7c6573ecab186c535346d6609"
+  },
+  "en:kernel/core_api/index.rst": {
+    "hash": "7889b9dd1b120f09f3b7feaa2dbb3c41"
+  },
+  "en:kernel/process_management/kthread.md": {
+    "hash": "0ce92c5a05a0e78dfceb89c215294e28"
+  },
+  "en:kernel/debug/traceback.md": {
+    "hash": "f22fcde87181fe9bb5ba97f133506ca1"
+  },
+  "en:kernel/core_api/casting.md": {
+    "hash": "b86564a0d602dfad61ab0893de43a8f8"
+  },
+  "en:kernel/memory_management/intro.md": {
+    "hash": "777fe6a902720949596f5a35bdf26372"
+  },
+  "en:kernel/syscall/index.rst": {
+    "hash": "d94e7cff4242362399e96051df1e7aad"
+  },
+  "en:kernel/libs/lib_ui/scm.md": {
+    "hash": "a03d756677c64b1247cfe40b6d73f1b1"
+  },
+  "en:kernel/libs/id-allocation.md": {
+    "hash": "5789b9d1fe4f8f72848412f6e766e099"
+  },
+  "en:kernel/memory_management/allocate-memory.md": {
+    "hash": "9a5c0ec57bae0576c30fbab60407f178"
+  },
+  "en:kernel/locking/index.rst": {
+    "hash": "299b0ccecf4ef174fffcce4731a98728"
+  },
+  "en:kernel/sched/index.rst": {
+    "hash": "76ca73ed6d47a4207d2ca193b88eae0b"
+  },
+  "en:kernel/locking/locks.md": {
+    "hash": "5514ff361db4677d2b4fa522852aaeea"
+  },
+  "en:kernel/sched/cfs.md": {
+    "hash": "7c89ba1c0416ec346f2982b3139cc819"
+  },
+  "en:kernel/core_api/notifier_chain.md": {
+    "hash": "5d21aad4640544ad49348d3cd2e8a386"
+  },
+  "en:kernel/filesystem/index.rst": {
+    "hash": "52dd12d566da2003602ee21c4a3d007f"
+  },
+  "en:kernel/ktest/index.rst": {
+    "hash": "5a4565952877c82b9a0ed3b67103c141"
+  },
+  "en:kernel/filesystem/vfs/api.md": {
+    "hash": "1b0b3fe0cc2918cc2c53a5af392a96ff"
+  },
+  "en:kernel/filesystem/vfs/index.rst": {
+    "hash": "d0de5d78a2105a1ecfe4ef137c18f7f5"
+  },
+  "en:kernel/debug/profiling-kernel-with-dadk.md": {
+    "hash": "966d07272ad19e1afbdc64bb6cfcea73"
+  },
+  "en:kernel/filesystem/unionfs/index.rst": {
+    "hash": "7ee4201508b51b4c5ac9e3b520472cd6"
+  },
+  "en:kernel/core_api/atomic.md": {
+    "hash": "ff17c6b902baddffff32cb9f70ddefcb"
+  },
+  "en:kernel/libs/lib_ui/textui.md": {
+    "hash": "dc914079508390cf7544b5b9c7ef7e4f"
+  },
+  "en:kernel/sched/rust_waiting.md": {
+    "hash": "6777e758cd796a356c8789f4306911ae"
+  },
+  "en:kernel/locking/rwlock.md": {
+    "hash": "457db706fcf5f4a7e45d15d496a29605"
+  },
+  "en:kernel/configuration/index.rst": {
+    "hash": "77a375890e3abf508ea1147da0e92a50"
+  },
+  "en:kernel/filesystem/kernfs.md": {
+    "hash": "da5cf8148a5ab38c6d0efd9ada8a0a29"
+  },
+  "en:kernel/container/namespaces/index.rst": {
+    "hash": "60c3b1e0726791677414064c2a98e848"
+  },
+  "en:kernel/filesystem/vfs/design.md": {
+    "hash": "16577686b5f5b15a5cfb25f379e01a03"
+  },
+  "en:kernel/syscall/syscall_table.rst": {
+    "hash": "dc34f86b55c62bdd1777a97eb7e6bd26"
+  },
+  "en:kernel/filesystem/unionfs/overlayfs.md": {
+    "hash": "2eba6973dc429ea15ad6ac8f47bfa187"
+  },
+  "en:kernel/container/index.rst": {
+    "hash": "624e76dd31081ef9304da582d835992f"
+  },
+  "en:kernel/container/namespaces/mnt_namespace.md": {
+    "hash": "19af9b11f162c0e4be4725d8458fd253"
+  },
+  "en:kernel/memory_management/mmio.md": {
+    "hash": "e956a9cd454416578996f955cd905a08"
+  },
+  "en:kernel/cpu_arch/x86_64/index.rst": {
+    "hash": "ff36e992e4dee15f740259d545e161e2"
+  },
+  "en:kernel/sched/rt.md": {
+    "hash": "913a29f3bccbf0c10a093fd558100e8d"
+  },
+  "en:kernel/cpu_arch/index.rst": {
+    "hash": "72efe542c7854926ac0f33287345b856"
+  },
+  "en:kernel/ipc/index.rst": {
+    "hash": "bbc40e0a41a1467dbdd42196c443f1ef"
+  },
+  "en:kernel/boot/index.rst": {
+    "hash": "8fe854f9c48d4e2e3fee0cf7f3526dfe"
+  },
+  "en:kernel/container/namespaces/pid_namespace.md": {
+    "hash": "7b78f405306356aec439bfd5bad69967"
+  },
+  "en:kernel/cpu_arch/x86_64/usb_legacy_support.md": {
+    "hash": "a0c3300d1641f613777d631578e0ea58"
+  },
+  "en:kernel/sched/kernel_timer.md": {
+    "hash": "95bf320a3e748c7bb41150940fee0e77"
+  },
+  "en:kernel/configuration/arch.md": {
+    "hash": "a024ea920cdb719454beaae1eb9e09e9"
+  },
+  "en:kernel/filesystem/sysfs.md": {
+    "hash": "68d5270491432d41b254c750d59aca89"
+  },
+  "en:kernel/core_api/softirq.md": {
+    "hash": "c931f3fcfca7d8d10cd16a8b68e6274a"
+  },
+  "en:community/ChangeLog/index.rst": {
+    "hash": "aa1979d81b79f64b12962f885a6820af"
+  },
+  "en:kernel/trace/index.rst": {
+    "hash": "944a5b865100258ec7957a4cbedd7251"
+  },
+  "en:kernel/configuration/config.md": {
+    "hash": "dff794c4f3bfb4c3d66e6d0fa8f7c495"
+  },
+  "en:kernel/sched/core.md": {
+    "hash": "f449acec9b9ad36c4a75e8594d38e44d"
+  },
+  "en:kernel/filesystem/overview.md": {
+    "hash": "44499f7673a0c68c53b12882258b9f5c"
+  },
+  "en:kernel/boot/bootloader.md": {
+    "hash": "e6f65060560663ca2ce4d56d750332d8"
+  },
+  "en:kernel/ipc/signal.md": {
+    "hash": "abe911dac525b44fe083752a1e6bbdc7"
+  },
+  "en:kernel/locking/mutex.md": {
+    "hash": "a82fa540acd44a93f5cb3c069d5584da"
+  },
+  "en:kernel/boot/cmdline.md": {
+    "hash": "3d17446c60b72e9cadf82002520ebbf9"
+  },
+  "en:community/code_contribution/index.rst": {
+    "hash": "38b6fe56ee739723a662cd1fec7a194a"
+  },
+  "en:community/contact/index.rst": {
+    "hash": "1fbd4c64558614101f195681b92a179e"
+  },
+  "en:kernel/locking/spinlock.md": {
+    "hash": "b97729ffa1d19fb131a85c72c2411146"
+  },
+  "en:kernel/trace/kprobe.md": {
+    "hash": "7e92cda81dfc19881d45e7cc0606f8c6"
+  },
+  "en:introduction/mirrors.md": {
+    "hash": "e5b572a5f5abca55e9ffcbc9827ce6f7"
+  },
+  "en:community/ChangeLog/V0.1.x/V0.1.8.md": {
+    "hash": "8c26796807713751958810efecaedebd"
+  },
+  "en:community/ChangeLog/V0.1.x/V0.1.7.md": {
+    "hash": "c74fe7a6db6d59d3d6d5116d4c4e0ceb"
+  },
+  "en:community/ChangeLog/V0.1.x/V0.1.9.md": {
+    "hash": "bf42117b62c4739a8101b33390b5a4c7"
+  },
+  "en:community/code_contribution/rust-coding-style.md": {
+    "hash": "db7eddfe4d16166ebe28def72f63fbb6"
+  },
+  "en:community/ChangeLog/V0.1.x/V0.1.1.md": {
+    "hash": "d94351167179beb0bb1b1f3bb82da2ff"
+  },
+  "en:userland/appdev/index.rst": {
+    "hash": "78e6747475981b5cc17cd206c135ca4f"
+  },
+  "en:userland/appdev/c-cpp-quick-start.md": {
+    "hash": "0101f8fa98a0536d43ff897145d4a43d"
+  },
+  "en:community/code_contribution/c-coding-style.md": {
+    "hash": "ea3c95cc032e4fa7cde32a56359ab328"
+  },
+  "en:community/code_contribution/conventional-commit.md": {
+    "hash": "31666b2ee98f5fe3698ae234b6ef0f00"
+  },
+  "en:userland/appdev/rust-quick-start.md": {
+    "hash": "6366c994d75086098469d8ea02555b88"
+  },
+  "en:kernel/debug/debug-kernel-with-gdb.md": {
+    "hash": "ab7904f52dcf35d0675e48fe8e88ec9a"
+  },
+  "en:community/ChangeLog/V0.1.x/V0.1.3.md": {
+    "hash": "c302428982363f627bedda89c1ab9232"
+  },
+  "en:introduction/index.rst": {
+    "hash": "a7c445abd29ce6817b098787f69902b7"
+  },
+  "en:kernel/sched/c_waiting.md": {
+    "hash": "bb2435e3905e8e71eca8f6a583e31d94"
+  },
+  "en:introduction/build_system.md": {
+    "hash": "fafac4210fb49c9e160b46c2101df238"
+  },
+  "en:community/ChangeLog/V0.1.x/V0.1.4.md": {
+    "hash": "5720af929320997f8824bcdfd3a17bdd"
+  },
+  "en:kernel/trace/eBPF.md": {
+    "hash": "62f8451a2e9e851a67266bf8cbb0fc6d"
+  },
+  "en:community/ChangeLog/V0.1.x/V0.1.6.md": {
+    "hash": "5517b35f61f5b89d8e825a399581ea0f"
+  },
+  "en:introduction/features.md": {
+    "hash": "75d47fcb0d83487b28957dace1e24578"
+  },
+  "en:community/ChangeLog/V0.1.x/V0.1.5.md": {
+    "hash": "898444d989993df55486ca8d454efbb6"
+  },
+  "en:community/ChangeLog/V0.1.x/V0.1.0.md": {
+    "hash": "26fef9a12925fdcc4729f363ae5b2614"
+  },
+  "en:community/ChangeLog/V0.1.x/V0.1.2.md": {
+    "hash": "41afa92fde268ffd547a3e4326fba1cd"
+  },
+  "en:community/ChangeLog/V0.1.x/V0.1.10.md": {
+    "hash": "7a292c40f822e371ea650f3157857844"
+  },
+  "en:kernel/core_api/kernel_api.md": {
+    "hash": "8b840ec6af5782d8f793f746b1061ed9"
+  },
+  "en:index.rst": {
+    "hash": "8ca31b793978d962c65df867b3261860"
+  }
+}

docs/community/contact/index.rst

@@ -1,7 +1,7 @@
 .. _get_contact_with_community:
 
 与社区建立联系
-====================================
+====================================================================
 
 联系方式
 -------------------------
@@ -18,7 +18,7 @@ DragonOS官网： https://DragonOS.org
 
 
 赞助及捐赠
--------------------------
+---------------------------------------------------------
 
 DragonOS是一个开源项目，我们欢迎任何形式的赞助和捐赠，您的捐赠将用于DragonOS的开发和维护，以及社区的运营。
 
@@ -28,7 +28,7 @@ DragonOS是一个开源项目，我们欢迎任何形式的赞助和捐赠，您
 - 联系社区负责人，沟通具体的赞助方式等。联系方式：longjin@dragonos.org
 
 财务及捐赠信息公开
--------------------------
+---------------------------------------------------------
 
 DragonOS社区的捐赠信息将按年进行公开。赞助商、赞助者信息将在收到赞助后，15天内进行公开。
 

docs/conf.py

@@ -47,6 +47,7 @@ templates_path = ['_templates']
 # This is also used if you do content translation via gettext catalogs.
 # Usually you set "language" from the command line for these cases.
 language = 'zh_CN'
+locale_dirs = ['locale/']   # path is example but recommended.
 
 # List of patterns, relative to source directory, that match files and
 # directories to ignore when looking for source files.

docs/index.rst

@@ -3,9 +3,22 @@
    You can adapt this file completely to your liking, but it should at least
    contain the root `toctree` directive.
 
+.. Note: __EXCLUDE_IN_TRANSLATED_START
+
 欢迎来到DragonOS的文档！
 ====================================
 
+.. raw:: html
+
+   <div class="toctree-wrapper compound">
+   <p class="caption" role="heading"><span class="caption-text">Translations</span></p>
+   <ul>
+   <li class="toctree-l1"><a class="reference internal" href="locales/en/index.html">English</a></li>
+   </ul>
+   </div>
+
+.. Note: __EXCLUDE_IN_TRANSLATED_END
+
 .. toctree::
    :maxdepth: 1
    :caption: 入门
@@ -52,6 +65,13 @@
    community/contact/index
    community/ChangeLog/index
 
+.. Note: __EXCLUDE_IN_TRANSLATED_START
+
+.. toctree::
+   :maxdepth: 1
+   :caption: Translations
+
+   locales/en/index
 
 Indices and tables
 ==================
@@ -59,3 +79,5 @@ Indices and tables
 * :ref:`genindex`
 * :ref:`modindex`
 * :ref:`search`
+
+.. Note: __EXCLUDE_IN_TRANSLATED_END

docs/kernel/trace/eBPF.md

@@ -18,7 +18,7 @@ eBPF 从根本上改变了这个方式。通过允许在操作系统中运行沙
 
 ## eBPF的运行流程
 
-![image-20240909165945192](./ebpf_flow.png)
+![image-20240909165945192](/kernel/trace/ebpf_flow.png)
 
 如图所示，eBPF程序的运行过程分为三个主要步骤：
 

docs/kernel/trace/kprobe.md

@@ -14,7 +14,7 @@ kprobes技术依赖硬件架构相关的支持，主要包括CPU的异常处理
 
 ## kprobe工作流程
 
-<img src="./kprobe_flow.png" style="zoom: 67%;"  alt="xxx"/>
+<img src="/kernel/trace/kprobe_flow.png" style="zoom: 67%;"  alt="xxx"/>
 
 
 

docs/locales/en/community/ChangeLog/V0.1.x/V0.1.0.md

@@ -0,0 +1,304 @@
+:::{note}
+**AI Translation Notice**
+
+This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+- Source document: community/ChangeLog/V0.1.x/V0.1.0.md
+
+- Translation time: 2025-05-19 01:48:03
+
+- Translation model: `Qwen/Qwen3-8B`
+
+Please report issues via [Community Channel](https://github.com/DragonOS-Community/DragonOS/issues)
+
+:::
+
+# V0.1.0
+
+:::{note}
+Author of this document: Longjin <longjin@RinGoTek.cn>
+
+November 6, 2022
+:::
+
+## Preface
+
+&emsp;&emsp;DragonOS has been under development since January 15, 2022, and has now gone through nearly 300 days. In these many days and nights, it's hard to count how much time has been spent on DragonOS development. I have basically given all my free time to DragonOS, and the estimated total working hours have already exceeded 1000 hours. It feels very rewarding to be able to release the first version.
+
+&emsp;&emsp;Since July 2022, a number of friends and mentors from six universities or companies have joined the development of DragonOS. I was very happy about this. I think, with everyone's joint efforts, we can create an operating system that is truly practical! We have held 14 discussion meetings. I believe, with everyone's joint efforts, in the future, we will be able to create an independent, open, server-oriented open-source operating system that can be used in production environments.
+
+&emsp;&emsp;Although DragonOS is currently just a toy-level operating system, it's "only slightly more difficult than a undergraduate graduation project." However, please don't underestimate it. Its internal architecture design targets Linux 5.18 and later distributions. Although it has not yet reached the level of Linux, we are working hard to catch up. Thanks to the relevant resources of Linux, DragonOS has learned a lot of design ideas from Linux during its architecture design. The related components have considered scalability and portability as much as possible.
+
+&emsp;&emsp;A journey of a thousand miles begins with a single step. The release of DragonOS V0.1.0 is a new beginning. **I hope, in the next ten years, we can work together with many partners, and by 2032, build DragonOS into a practical, widely used open-source operating system in the server field!**
+
+&emsp;&emsp;**A hundred boats race, the ones who row first win; in the middle stream, the brave win.** I believe, with the continuous efforts of the community developers in the coming time, our goal will become a reality!
+
+## Special Thanks
+
+&emsp;&emsp;At the time of the release of DragonOS V0.1.0, I would like to express my sincere gratitude to my teachers, predecessors, and school!
+
+- **Teacher Yao Zhicheng from Dali Town Central Primary School, Nanhai District, Foshan City**: You are the guide who introduced me to computers and taught me programming. Ten years ago, when we talked, you said, "Our country currently does not have an independent and mature operating system." This sentence planted the seed of my dream. You cultivated my love for computers, so I chose the major of software engineering. Thank you for your guidance back then, I will never forget your kindness!
+
+- **Shimen Experimental School, Nanhai District, Foshan City**: During the three years I studied at Shimen Experimental School, I am very grateful for the school's "Strength-based Education" philosophy. Under the guidance of the teachers, I was able to fully develop my personality and talents, and achieved good results. During the three years at Shimen Experimental School, I learned C++, Java, and simple algorithms, and I developed several Android apps, accumulating nearly 6,000 lines of code.
+
+- **Shimen Middle School, Nanhai District, Foshan City**: "The road is long and the task is heavy, never forget to strive" is the school motto of Shimen Middle School. I think this motto should also become the motto of each new generation of youth. During the three years at Shimen Middle School, the education of national sentiment had a great impact on me. I think, as new generation of youth, we should shoulder the responsibility of the times, strive hard, and work for the development of the country, the strength of the nation, and the future of humanity!
+
+- **South China University of Technology**: "Broad learning, careful thinking, clear discernment, and firm action" – at SCUT, I received further learning and development. I broadened my horizons, learned to communicate with many people. Moreover, in the School of Software, I met a group of conscientious and responsible teachers. I am very grateful for the support of the school, which supported us in establishing the project group. I believe, with the support of the school, DragonOS can achieve better development and go further!
+
+- **Professor Wang Guohua from the School of Software, South China University of Technology**: Professor Wang is my teacher for the course "Operating System". Under her guidance, I gained a deeper understanding of the principles of operating systems, and participated in the "Pan-Delta+ University Students' Computer Works Competition". In the Guangdong provincial selection in June 2022, DragonOS won the first prize and the Best Innovation Award.
+
+- **Professor Tang Feng from the School of Software, South China University of Technology**: Professor Tang is our project group's on-campus mentor. Under her careful guidance, we will continue to move forward, keep our direction, and continuously build an open-source community. I sincerely thank Professor Tang for her guidance!
+
+- **[Yaotian Feng](https://github.com/Codetector1374)**: I met this very capable person on Bilibili. He answered many of my questions. Many times, after I had debugged for several days without any idea, a few words from him would wake me up and help me find the path to solve the problem. He also shared with me the places where I might fall into traps, allowing me to have a psychological expectation when about to fall into a trap, so I wouldn't feel so uncomfortable, ha ha.
+
+## Contributors List
+
+The release of DragonOS V0.1.0 could not have been achieved without the joint efforts of the following friends:
+
+- Longjin <longjin@RinGoTek.cn>
+- zzy666-hw <zzy666@mail.ustc.edu.cn>
+- Guan Jinquan <guanjinquan@DragonOS.org>
+- Zhou Yuzhe <zhouyuzhe@DragonOS.org>
+- kkkkkong <kongweichao@DragonOS.org>
+- houmkh <jiaying.hou@qq.com>
+- wang904 <1234366@qq.com>
+- Liric Mechan <i@liric.cn>
+- Mustang <handsomepd@qq.com>
+- Eugene <caima12138@foxmail.com>
+- kun <1582068144@qq.com>
+- zhujikuan <1335289286@qq.com>
+- Alloc Alice <1548742234@qq.com>
+
+## Sponsors List
+
+Thank you to the following students for their donations. We will keep working hard!
+
+- TerryLeeSCUT
+- Wu
+- slientbard
+
+## Kernel
+
+### Some Standards and Specifications Followed
+
+- Bootloader: Multiboot2
+- System Interface: POSIX 2008
+
+### Hardware Architecture
+
+- Currently supports running on x86-64 architecture processors
+
+### Bootloader
+
+- Uses Grub 2.06 as the bootloader
+
+### Memory Management
+
+- Implemented a bitmap-based page allocator
+- Implemented a slab allocator for allocating small, aligned memory blocks
+- Abstracted VMA (Virtual Memory Area)
+- Implemented VMA reverse mapping mechanism
+- Implemented MMIO address space auto-mapping mechanism
+
+### Multi-core
+
+- Supports multi-core boot. That is, after DragonOS starts, it will start the AP processor. However, to simplify the implementation of other kernel modules, currently, there are no tasks running on the AP processor.
+- Roughly implemented the IPI (Inter-Processor Interrupt) framework
+
+### Process Management
+
+- Supports process creation and recycling
+- Kernel threads
+- Kthread mechanism
+- User-space and kernel-space process/thread fork/vfork (note that user-space fork and kernel-space fork have some differences; kernel-space fork is more complex)
+- exec allows a process to execute a new executable file
+- Process timer sleep (sleep) (supports high-precision sleep with spin/rdtsc, supports sleep via context switching)
+
+### Synchronization Primitives
+
+- spinlock spin lock
+- mutex mutex
+- atomic atomic variable
+- wait_queue wait queue
+- semaphore semaphore
+
+### Scheduling Related
+
+- CFS scheduler
+- Single-core scheduling (multi-core load balancing is temporarily not supported)
+- completion "completion" mechanism, allowing a process to wait for a task to complete
+
+### IPC (Inter-Process Communication)
+
+- Anonymous pipe
+
+### File System
+
+- Basic functionality of the VFS virtual file system
+- FAT32 file system (does not support deleting folders)
+- devfs device file system. Currently, only the keyboard file is registered.
+- rootfs root file system, provides support for other pseudo-file systems before the real disk file system is mounted
+- Mount point abstraction. Currently, file system mounting is implemented, and all mount points are managed in a stack-like manner (optimization is needed in the future)
+
+### Exception and Interrupt Handling
+
+- Handling of processor exceptions
+- Support for APIC
+- Softirq soft interrupt mechanism
+- Ability to trace the kernel stack
+
+### Kernel Data Structures
+
+- Ordinary binary tree
+- kfifo first-in-first-out buffer
+- Circular linked list
+- IDR mapping data structure
+- IDA ID allocation data component
+
+### Screen Display
+
+- VESA VBE display chip driver
+- Implemented a screen manager, supporting multiple display frameworks to be registered with the screen manager
+- Implemented a TextUI text interface framework, capable of rendering text to the screen. Also reserves support for scrollable pages and multiple display windows
+- printk
+
+### Kernel Utility Library
+
+- String operation library
+- ELF executable file support component
+- Basic math library
+- CRC function library
+
+### Software Portability
+
+- Ported the LZ4 compression library (V1.9.3), laying the foundation for future page compression mechanisms
+
+### Kernel Testing
+
+- ktest unit test framework
+- Supports outputting screen content to a file via serial port (COM1)
+
+### Driver Support
+
+- IDE hard disk
+- AHCI hard disk (SATA Native)
+- ACPI Advanced Power Configuration module
+- PCI bus driver
+- XHCI host controller driver (USB 3.0)
+- PS/2 keyboard
+- PS/2 mouse
+- HPET high-precision timer
+- RTC clock
+- Local APIC timer
+- UART serial port (supports RS-232)
+- VBE display
+- Virtual tty device
+
+### System Calls
+
+DragonOS currently has a total of 22 valid system calls.
+
+- SYS_PUT_STRING Print characters to the screen
+- SYS_OPEN Open a file
+- SYS_CLOSE Close a file
+- SYS_READ Read from a file
+- SYS_WRITE Write to a file
+- SYS_LSEEK Adjust the file pointer
+- SYS_FORK Fork system call
+- SYS_VFORK Vfork system call
+- SYS_BRK Adjust the heap size to a specified value
+- SYS_SBRK Adjust the heap size by a relative value
+- SYS_REBOOT Reboot (this system call will be removed after sysfs is improved; please do not rely on this system call excessively)
+- SYS_CHDIR Change the working directory of the process
+- SYS_GET_DENTS Get metadata of directory entries
+- SYS_EXECVE Let the current process execute a new program file
+- SYS_WAIT4 Wait for a process to exit
+- SYS_EXIT Exit the current process
+- SYS_MKDIR Create a directory
+- SYS_NANOSLEEP Nanosecond-level sleep (up to 1 second), capable of high-precision sleep when less than 500ns
+- SYS_CLOCK Get the current CPU time
+- SYS_PIPE Create a pipe
+- SYS_MSTAT Get the current memory status information of the system
+- SYS_UNLINK_AT Delete a directory or delete a file link
+
+### Rust Support
+
+- Implemented a simple "hello world" in Rust. Plan to gradually shift to using Rust for development in the next version.
+
+## User Environment
+
+### LibC
+
+&emsp;&emsp;LibC is the bridge between applications and the operating system. DragonOS's LibC implements some simple functions.
+
+- malloc heap memory allocator
+- Basic math library
+- A few simple functions related to files
+- pipe
+- fork/vfork
+- clock
+- sleep
+- printf
+
+### Shell Command Line Programs
+
+- Based on simple string matching parsing (not done through the compilation course's method, so it's simple and crude)
+- Supported commands: ls, cd, mkdir, exec, about, rmdir, rm, cat, touch, reboot
+
+### User-space Driver Programs
+
+- User-space keyboard driver
+
+## Source Code and Release Image Download
+
+&emsp;&emsp;You can obtain the source code in the following ways:
+
+### Get via Git
+
+- You can visit [https://github.com/fslongjin/DragonOS/releases](https://github.com/fslongjin/DragonOS/releases) to download the release code and the compiled, runnable disk image.
+- We also have a mirror repository on gitee for download: [https://gitee.com/DragonOS/DragonOS](https://gitee.com/DragonOS/DragonOS)
+
+### Get via DragonOS Software Mirror Site
+
+&emsp;&emsp;To solve the problem of slow and unstable access to GitHub in China, and to make it convenient for developers to download the code of each version of DragonOS, we have specially set up a mirror site. You can access the mirror site through the following address:
+
+&emsp;&emsp;You can obtain the DragonOS code archive and the compiled, runnable disk image through the mirror site.
+
+- [https://mirrors.DragonOS.org](https://mirrors.DragonOS.org)
+- [https://mirrors.DragonOS.org.cn](https://mirrors.DragonOS.org.cn)
+
+## Open Source Code Declaration
+
+:::{note}
+To promote the healthy development of the DragonOS project, DragonOS is released under the GPLv2 open source protocol. Everyone who can obtain the DragonOS source code and related software products (including but not limited to binary copies and documents) will enjoy the rights granted by us through the GPLv2 protocol, and you must also comply with the obligations stipulated in the protocol.
+
+This is a rather strict protocol that protects the healthy development of open source software and prevents it from being encroached upon.
+
+For most people with good intentions, you will not violate our open source protocol.
+
+We encourage the free spread and promotion of DragonOS, but please ensure that all actions do not infringe on the legitimate rights and interests of others, nor do they violate the GPLv2 protocol.
+
+Please pay special attention to the fact that those who violate the open source protocol, especially **commercial closed-source use and any plagiarism or academic misconduct**, will be held seriously accountable. (This is the easiest scenario to violate our open source protocol.)
+
+Also, please note that according to the requirements of the GPLv2 protocol, any software modified or developed based on DragonOS must also be open-sourced under the GPLv2 protocol and must indicate that it is based on DragonOS. It must also ensure that users of these modified versions can easily obtain the original version of DragonOS.
+
+You must make sure that the DragonOS developers can obtain the source code of your modified version through the same way from public channels, otherwise you will violate the GPLv2 protocol.
+
+For detailed information about the protocol, please read the **LICENSE** file in the root directory of the project. Please note that according to the requirements of the GPLv2 protocol, **only the English original version has legal effect**. Any translated version is for reference only.
+:::
+
+### Usage of Open Source Software
+
+&emsp;&emsp;During the development of DragonOS, some open source projects' designs were referenced, or parts of their code were introduced, or they were inspired by them. Below are the list of these open source projects. We sincerely thank the contributors of these open source projects!
+
+Format: <Project Name> - <Link> - <Open Source License>
+
+- Linux - https://git.kernel.org/ - GPLv2
+- skiftOS - https://github.com/skiftOS/skift - MIT
+- FYSOS - https://github.com/fysnet/FYSOS - [FYSOS' License](https://github.com/fysnet/FYSOS/blob/9a8968e3d6600de34539c028c843f4c06d134039/license.txt)
+- LemonOS - https://github.com/LemonOSProject/LemonOS.git - BSD 2-Clause License
+- LZ4 - https://github.com/lz4/lz4 - BSD 2-Clause license
+- SerenityOS - https://github.com/SerenityOS/serenity.git - BSD 2-Clause license
+- MINE - 《A Design and Implementation of a 64-bit Operating System》Tian Yu; People's Posts and Telecommunications Press
+- chcore - 《Modern Operating Systems: Design and Implementation》Chen Haibo, Xia Yubin; Machinery Industry Press
+- SimpleKernel - https://github.com/Simple-XX/SimpleKernel - MIT

docs/locales/en/community/ChangeLog/V0.1.x/V0.1.1.md

@@ -0,0 +1,358 @@
+:::{note}
+**AI Translation Notice**
+
+This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+- Source document: community/ChangeLog/V0.1.x/V0.1.1.md
+
+- Translation time: 2025-05-19 01:41:56
+
+- Translation model: `Qwen/Qwen3-8B`
+
+Please report issues via [Community Channel](https://github.com/DragonOS-Community/DragonOS/issues)
+
+:::
+
+# V0.1.1
+
+:::{note}
+Author: Longjin <longjin@RinGoTek.cn>
+
+November 27, 2022
+:::
+
+## Contributors List
+
+The DragonOS V0.1.1 version was contributed by the following team members:
+
+- Longjin <longjin@RinGoTek.cn>
+- Zhou Yuzhe <zhouyuzhe@DragonOS.org>
+
+## Sponsors List
+
+Thank you to the following individuals for their support. We will continue to strive for excellence!
+
+- David Wen
+- TerryLeeSCUT 
+- Wu
+- slientbard
+
+Among them, we are especially grateful to **David Wen** for his sponsorship of RMB 1000 to the DragonOS project! We will carefully record each donation and ensure that it is used appropriately.
+
+## Update Content - Kernel
+
+- Added Rust FFI (#_translated_label__77_en)
+- Ported kmalloc and printk to Rust
+- Rust macros for kdebug, kinfo, kwarn, kBUG, kerror
+- Bugfix: Fixed the issue where the process PCB was not removed from the list when it was reclaimed
+- Directory structure optimization: Moved asm.h and cmpxchg.h
+- Signal sending
+- procfs: View process status
+- Resolved the issue of disk image permission errors during the first compilation
+- Moved fork-related code to fork.c
+
+## Update Content - User Environment
+
+- Shell: Added the kill command, which can send signals to a target process. However, since the signal mechanism is still not fully implemented, the target process cannot currently respond to this signal.
+
+## Source Code and Release Image Download
+
+&emsp;&emsp;You can obtain the source code through the following methods:
+
+### Get via Git
+
+- You can download the release code and the compiled, runnable disk image from [https://github.com/fslongjin/DragonOS/releases](https://github.com/fslongjin/DragonOS/releases).
+- We also have a mirror repository on Gitee for download: [https://gitee.com/DragonOS/DragonOS](https://gitee.com/DragonOS/DragonOS)
+
+### Get via DragonOS Software Mirror Site
+
+&emsp;&emsp;To address the slow and unstable access to GitHub in China, and to make it easier for developers to download the code for each version of DragonOS, we have specially set up a mirror site. You can access the mirror site through the following address:
+
+&emsp;&emsp;You can obtain the compressed package of DragonOS code and the compiled, runnable disk image through the mirror site.
+
+- [https://mirrors.DragonOS.org](https://mirrors.DragonOS.org)
+- [https://mirrors.DragonOS.org.cn](https://mirrors.DragonOS.org.cn)
+
+## Open Source Declaration
+
+:::{note}
+To promote the healthy development of the DragonOS project, DragonOS is released under the GPLv2 open source license. Anyone who can obtain the DragonOS source code and corresponding software products (including but not limited to binary copies and documentation) will enjoy the rights granted by us through the GPLv2 license, and you must also comply with the obligations stipulated in the agreement.
+
+This is a rather strict license that protects the healthy development of open source software and prevents it from being encroached upon.
+
+For most well-intentioned people, you will not violate our open source license.
+
+We encourage the free dissemination and promotion of DragonOS, but please ensure that all actions do not infringe on the legitimate rights and interests of others or violate the GPLv2 license.
+
+Please pay special attention to the fact that violations of the open source license, especially **commercial closed-source use and any plagiarism or academic misconduct**, will be subject to serious accountability. (This is the most common scenario where the open source license is violated.)
+
+Also, please note that according to the requirements of the GPLv2 license, any software modified or developed based on DragonOS must also be open-sourced under the GPLv2 license and must clearly indicate that it is based on DragonOS. It is also necessary to ensure that users of these modified versions can easily obtain the original version of DragonOS.
+
+You must make it possible for the developers of DragonOS to obtain the source code of your modified version through public channels, otherwise you will violate the GPLv2 license.
+
+For detailed information about the agreement, please read the **LICENSE** file in the project root directory. Please note that according to the requirements of the GPLv2 license, **only the English original version is legally binding**. Any translated version is for reference only.
+:::
+
+### Open Source Software Usage
+
+&emsp;&emsp;During the development of DragonOS, we have referenced the design of some open source projects, or introduced parts of their code, or been inspired by them. Below is a list of these open source projects. We sincerely thank the contributors of these open source projects!
+
+Format: <Project Name> - <Link> - <Open Source License>
+
+- Linux - https://git.kernel.org/ - GPLv2
+- skiftOS - https://github.com/skiftOS/skift - MIT
+- FYSOS - https://github.com/fysnet/FYSOS - [FYSOS' License](https://github.com/fysnet/FYSOS/blob/9a8968e3d6600de34539c028c843f4c06d134039/license.txt)
+- LemonOS - https://github.com/LemonOSProject/LemonOS.git - BSD 2-Clause License
+- LZ4 - https://github.com/lz4/lz4 - BSD 2-Clause license
+- SerenityOS - https://github.com/SerenityOS/serenity.git - BSD 2-Clause license
+- MINE - 《A Design and Implementation of a 64-bit Operating System》 by Tian Yu; People's Posts and Telecommunications Press
+- chcore - 《Modern Operating Systems: Design and Implementation》 by Chen Haibo and Xia Yubin; Machinery Industry Press
+- SimpleKernel - https://github.com/Simple-XX/SimpleKernel - MIT
+
+## All Commit Records of the Current Version
+
+```text
+commit d65ade9c5909076747bd00966a398fe27fbd290d
+Author: DaJiYuQia <88259094+DaJiYuQia@users.noreply.github.com>
+Date:   Sun Nov 27 14:21:31 2022 +0800
+
+    Patch procf (#95)
+    
+    * debug color problem
+    
+    Co-authored-by: longjin <longjin@RinGoTek.cn>
+
+commit 6cb769c423b09e88fea1763210200a716477be0a
+Author: login <longjin@ringotek.cn>
+Date:   Sun Nov 27 14:17:36 2022 +0800
+
+    将include目录下的rust代码转移到他们应当属于的模块中 (#96)
+    
+    * 将include目录下的rust代码转移到他们应当属于的模块下。
+
+commit 27a97abd2474b03ad09b562e5ed11e1fdae8eb32
+Author: DaJiYuQia <88259094+DaJiYuQia@users.noreply.github.com>
+Date:   Sat Nov 26 17:34:00 2022 +0800
+
+    Patch procf (#90)
+    
+    * 1234
+    
+    * 123
+    
+    * 合并master
+    
+    * procfs
+    
+    * 1
+    
+    * procfs展示进程基本信息
+    
+    * modified code
+    
+    * 恢复权限
+    
+    * 恢复权限
+    
+     #恢复权限
+    
+    * modify permission
+    
+    * 删除run.sh
+    
+    * 解决第一次编译时磁盘镜像权限错误的问题
+    
+    * 恢复.vscode/c_cpp_properties.json
+    
+    * 删除process.c中错误的do_fork
+    
+    * remake procfs
+    
+    * 修改一些变量名
+    
+    * 修改类型
+    
+    * modified
+    
+    * data_puts缓冲区溢出后return
+    
+    Co-authored-by: longjin <longjin@RinGoTek.cn>
+
+commit ad23fcddf893d7f92d2bf3efdb66e969416d2852
+Author: login <longjin@ringotek.cn>
+Date:   Wed Nov 23 21:34:35 2022 +0800
+
+    bugfix: 修复进程退出时未释放signal和sighand && 增加赞赏者名单：David Wen (#93)
+    
+    * bugfix: 修复进程退出时未释放signal和sighand的bug
+    
+    * 增加赞赏者名单：David Wen
+
+commit 0274cd6eeec01885232e7418a501857cb76da69e
+Author: login <longjin@ringotek.cn>
+Date:   Wed Nov 23 20:43:18 2022 +0800
+
+    修正drop signal结构体的box对象的的问题 (#92)
+    
+    * fix: exit signal and exit sighand
+
+commit c8025a88798dc57ecc5d7f20ad69de695445638f
+Author: login <longjin@ringotek.cn>
+Date:   Wed Nov 23 20:18:22 2022 +0800
+
+    new:在fork时拷贝signal和sighand (#91)
+    
+    * refcount初始化
+    
+    * new: 实现copy_sighand
+    del: 删除sighand_struct的wqh, 待将来有需要时，替换成rust版本的
+    
+    * new: 拷贝signal
+    bugfix: 解决拷贝sighand时的uaf问题
+
+commit 66f67c6a95b8aad85cfd2146a86e5e3e6a3568e7
+Author: login <longjin@ringotek.cn>
+Date:   Wed Nov 23 11:38:20 2022 +0800
+
+    signal的发送（暂时父子进程之间共享信号及相应的结构体） (#89)
+    
+    * 解决由于spinlock.h中包含preempt_enable()带来的循环include问题
+    
+    * new: 初步实现signal的数据结构
+    
+    * new:signal相关数据结构
+    
+    * fix: 解决bindings.rs报一堆警告的问题
+    
+    * new: rust下的kdebug kinfo kwarn kBUG kerror宏
+    
+    * 移动asm.h和cmpxchg.h
+    
+    * new: signal的发送（暂时只支持父子进程共享信号及处理函数）
+
+commit 3d729e2069e01ee07525ff83167566dac5322a40
+Author: login <longjin@ringotek.cn>
+Date:   Fri Nov 18 17:59:33 2022 +0800
+
+    bugfix: 修复进程pcb被回收时，未将其从链表中删除的问题 (#87)
+    
+    * bugfix: 修复进程pcb被回收时，未将其从链表中删除的问题
+    new: pcb相关api文档
+    
+    * 将文档加入目录
+
+commit 0bfe94f46be9bdde1ade81a20e803aa2aafd2964
+Author: login <longjin@ringotek.cn>
+Date:   Fri Nov 18 16:32:15 2022 +0800
+
+    new: rust下的kdebug kinfo kwarn kBUG kerror宏 (#86)
+    
+    * new: rust下的kdebug kinfo kwarn kBUG kerror宏
+
+commit c6174797dcf3427f38bfa0f4bd3e039c319f7c5b
+Author: login <longjin@ringotek.cn>
+Date:   Thu Nov 17 20:29:29 2022 +0800
+
+    fix: 解决bindings.rs报了很多警告的问题 (#85)
+    
+    * fix: 解决bindings.rs报一堆警告的问题
+
+commit cffd7144fbed84f9775e89d7b99602c6ccc5a510
+Author: login <longjin@ringotek.cn>
+Date:   Wed Nov 16 15:18:03 2022 +0800
+
+    signal相关数据结构&代码结构优化 (#84)
+    
+    * 解决由于spinlock.h中包含preempt_enable()带来的循环include问题
+    
+    * new: 初步实现signal的数据结构
+
+commit fb6c29d01d4cf92368efec08c01e419c2a941f7d
+Author: login <longjin@ringotek.cn>
+Date:   Sun Nov 13 16:43:58 2022 +0800
+
+    port kmalloc and printk to rust (#83)
+    
+    * 暂时移除cbindgen
+    
+    * 将lib文件夹更名为libs文件夹（解决rust的冲突）
+    
+    * 实现了全局的allocator
+    
+    * 实现了printk宏
+    
+    * new: 完善了printk的颜色
+
+commit 82d2e446a401e7eee57a847f48a6d162931170c3
+Author: login <longjin@ringotek.cn>
+Date:   Sat Nov 12 15:25:54 2022 +0800
+
+    new: 暂时移除cbindgen (#82)
+
+commit 2aaf7808efe44ecfaadd51ae4f8892e667108578
+Author: login <longjin@ringotek.cn>
+Date:   Fri Nov 11 22:21:44 2022 +0800
+
+    在内核中引入cbindgen，生成rust-C的FFI (#81)
+    
+    
+    * 解决codeql失败问题
+    
+    * new: 为内核引入cbindgen
+
+commit 2813126e3190c9b3c1a836a647b259a7adbe0cf3
+Author: login <longjin@ringotek.cn>
+Date:   Fri Nov 11 15:35:37 2022 +0800
+
+    新增rust ffi (#77)
+    
+    * 引入cargo
+    
+    * 取消对Cargo.lock的跟踪
+    
+    * 解决vscode报错问题
+    
+    * new: rust的代码能够调用c语言的printk_color
+    
+    * 1、将原本run.sh的工作拆解，变为几个不同的make命令
+    2、在docker镜像中编译rust
+    
+    * 更改workflow
+    
+    * update workflow
+    
+    * new: 解决workflow无法通过编译的问题
+
+commit 5e023cf7911333eb05bfe65704dce4b01fa4d0a7
+Author: login <longjin@ringotek.cn>
+Date:   Fri Nov 11 15:21:45 2022 +0800
+
+    Update makefile.yml
+
+commit e44795008f7e34d2068cf28dcedbcb91f5ccd66b
+Author: login <longjin@ringotek.cn>
+Date:   Fri Nov 11 15:18:13 2022 +0800
+
+    Update makefile.yml (#80)
+
+commit ec5fb84b61c313824cc2199ab64e3af4b7e5f895
+Author: login <longjin@ringotek.cn>
+Date:   Fri Nov 11 15:08:09 2022 +0800
+
+    Update makefile.yml
+
+commit 6d9dff5f1ff347ea780a0249e54eef356cdcaaea
+Author: login <longjin@ringotek.cn>
+Date:   Fri Nov 11 15:07:48 2022 +0800
+
+    Revert "Update makefile.yml (#78)" (#79)
+    
+    This reverts commit badc7d238f2341e844a90be3e357e5dd77a447fc.
+
+commit badc7d238f2341e844a90be3e357e5dd77a447fc
+Author: login <longjin@ringotek.cn>
+Date:   Fri Nov 11 15:05:52 2022 +0800
+
+    Update makefile.yml (#78)
+
+```

docs/locales/en/community/ChangeLog/V0.1.x/V0.1.10.md

@@ -0,0 +1,1075 @@
+:::{note}
+**AI Translation Notice**
+
+This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+- Source document: community/ChangeLog/V0.1.x/V0.1.10.md
+
+- Translation time: 2025-05-19 01:42:56
+
+- Translation model: `Qwen/Qwen3-8B`
+
+Please report issues via [Community Channel](https://github.com/DragonOS-Community/DragonOS/issues)
+
+:::
+
+# V0.1.10
+
+:::{note}
+Author: Longjin <longjin@DragonOS.org>
+
+DragonOS official forum: [bbs.dragonos.org.cn](https://bbs.dragonos.org.cn)
+
+May 13, 2024
+:::
+
+## Introduction
+
+&emsp;&emsp;This version update introduces 42 feature-type PRs, 24 bug fixes, 5 document updates, and some software porting and CI-related content.
+
+&emsp;&emsp;Key highlights of the current version:
+
+- Refactored the scheduling subsystem
+- Ability to run the "hello world" application on riscv64
+- The memory management subsystem introduces features such as anonymous page reverse mapping, copy-on-write, and delayed allocation
+- The file system introduces a large number of new system interfaces
+- Implemented pty and can run a simple ssh server
+
+## Sponsors List
+
+- **[YaCloud](https://yacloud.net)** Yaan Big Data Industrial Park provides cloud server support for DragonOS.
+
+## Update Content - Kernel
+
+- feat(fs): Implemented sys_rename (#_translated_label__578_en)
+- feat(fs): Implemented get_pathname (#_translated_label__615_en)
+- feat(kernel): Implemented uname system call (#_translated_label__614_en)
+- feat(fs): Added mount system call (#_translated_label__561_en)
+- feat(smp): Rewrote SMP module (#_translated_label__633_en)
+- feat(fs): Added Statx system call (#_translated_label__632_en)
+- feat(riscv64): Added flush tlb's IPI (#_translated_label__636_en)
+- feat(fs): Implemented SYS_LINK and SYS_LINKAT (#_translated_label__611_en)
+- fix(fs): mkdir outputs error message;
+- fix(clippy): Fixed kernel clippy check errors (#_translated_label__637_en)
+- feat(net): Implemented socketpair (#_translated_label__576_en)
+- feat(process/riscv): Process management initialization (#_translated_label__654_en)
+- fix(time): Fixed clock_gettime return type error and fixed small time interval duration returning 0 issue (#_translated_label__664_en)
+- fix(driver/base): Changed Device trait's set_class to set a Weak pointer to avoid circular reference issues. (#_translated_label__666_en)
+- feat(textui): Supports drawing 24-bit and 16-bit deep display buffers (#_translated_label__640_en)
+- fix(driver/tty): Fixed bug where tty device appears in /sys directory (#_translated_label__668_en)
+- feat(fs): Added struct POSIXSTATFS and SuperBlock for handling statfs system call (#_translated_label__667_en)
+- feat(driver/rtc): Implemented rtc abstraction and integrated x86's cmos rtc into device driver model (#_translated_label__674_en)
+- fix(net): Fixed udp bind issue with port0 handling (#_translated_label__676_en)
+- fix(fs/ramfs): Fixed bug where move_to did not update parent field in ramfs (#_translated_label__673_en)
+- feat(mm): Implemented page reverse mapping (#_translated_label__670_en)
+- fix(misc): Fixed get_ramdom length error issue () (#_translated_label__677_en)
+- feat(process/riscv): riscv64: switch process (#_translated_label__678_en)
+- fix(misc): Made nproc correctly obtain the number of CPU cores (#_translated_label__689_en)
+- fix(time): Fixed jiffy clock being too fast, enabled gettimeofday test, modified mount test (#_translated_label__680_en)
+- feat(driver/pty): Implemented pty with test program (#_translated_label__685_en)
+- feat(process/riscv): Implemented copy-thread (#_translated_label__696_en)
+- feat(sched): Rewrote scheduling module (#_translated_label__679_en)
+- fix(riscv): Changed kernel compilation target to riscv64gc, obtained time csr frequency, and fixed assembly issues with floating point save and restore (#_translated_label__699_en)
+- feat(lock): Implemented robust futex (#_translated_label__682_en)
+- feat(fs): BlockCache-read cache support (#_translated_label__521_en)
+- feat(mm): Implemented SystemV shared memory (#_translated_label__690_en)
+- chore(tools): Add bootstrap support for Centos/RHEL8/fedora (#_translated_label__713_en)
+- feat(driver/pty): Improved pty, currently pty can support ssh (#_translated_label__708_en)
+- fix(smp): Fixed issue where smp startup damaged the idle process's kernel stack of the 0th core (#_translated_label__711_en)
+- feat(driver/riscv): Initialized riscv-sbi-timer (#_translated_label__716_en)
+- doc: Update DragonOS description and introduction (#_translated_label__717_en)
+- feat(riscv): Let riscv64 run hello world user program and complete all initcall (#_translated_label__721_en)
+- feat(net): Implemented tcp backlog feature (#_translated_label__714_en)
+- feat(mm): Added slab memory allocator (#_translated_label__683_en)
+- feat(fs): Introduced Umount system call (#_translated_label__719_en)
+- doc: Update build instructions for riscv64 architecture (#_translated_label__725_en)
+- fix(fs): Socket uniformly changed to `GlobalSocketHandle`, and fixed fcntl SETFD error (#_translated_label__730_en)
+- feat: Alarm system call implementation (#_translated_label__710_en)
+- feat(tty): Add dummy console (#_translated_label__735_en)
+- fix(driver/pci): pci: Uniformly use ecam root (#_translated_label__744_en)
+- feat(driver/pci): pci: Added pci root manager to manage pci root, enabling riscv to scan pci devices normally. (#_translated_label__745_en)
+- build: Upgraded smoltcp to version 0.11.0 (#_translated_label__740_en)
+- fix(unified-init): Fixed unified-init causing cargo check failure issue (#_translated_label__747_en)
+- chore: Update virtio-drivers to commit 61ece509c4 and modify max_queue_size implementation (#_translated_label__748_en)
+- feat(net): Implemented raw socket's poll (#_translated_label__739_en)
+- feat(mm): Implemented page fault handling, supports page delayed allocation and copy-on-write, and user stack auto-expansion (#_translated_label__715_en)
+- feat(driver): Added virtio to sysfs (#_translated_label__752_en)
+- fix(dog): Added CC environment variable to solve the problem of not finding musl-gcc during compilation (#_translated_label__753_en)
+- doc(community): Added description of conventional commit standard (#_translated_label__754_en)
+- feat(driver/virtio): riscv: Added virtio-blk driver, and can correctly mount FAT32 on riscv (#_translated_label__761_en)
+- feat(fs): Add sys_dup3 (#_translated_label__755_en)
+- feat(riscv): riscv can run hello world user program (#_translated_label__770_en)
+- feat(sched): Add sched_yield (#_translated_label__766_en)
+- refactor(process): Adjusted arch_switch_to_user function, extracted common logic between riscv and x86_64. (#_translated_label__773_en)
+- feat(driver/acpi_pm): Implement ACPI PM Timer (#_translated_label__772_en)
+- chore: Adapt to dadk 0.1.11 (#_translated_label__777_en)
+- fix(libs/lib_ui): Fixed display errors when system initializes (#_translated_label__779_en)
+- fix(riscv/process): Synchronized riscv's scheduling clock tick rate with HZ, and fixed the bug of forgetting to disable interrupts in kernel mode when switching to user mode (#_translated_label__780_en)
+- fix: (riscv/timer): Fixed bug where riscv did not update wall clock and did not handle soft interrupts (#_translated_label__783_en)
+- feat(mm): Add slab usage calculation (#_translated_label__768_en)
+- feat(bitmap): Add bit and for AllocBitMap (#_translated_label__793_en)
+- fix(mm): Fixed vma mapping flag error (#_translated_label__801_en)
+- feat:(riscv/intr) Implemented riscv plic driver, capable of handling external interrupts (#_translated_label__799_en)
+- doc(sched): Scheduling subsystem document and CFS document (#_translated_label__807_en)
+- fix(net): Fix TCP Unresponsiveness and Inability to Close Connections (#_translated_label__791_en)
+- fix: disable mm debug log to prevent system lockup due to thingbuf issue (#_translated_label__808_en)
+- feat(driver/pci): add pci bus into sysfs (#_translated_label__792_en)
+- doc: Add Gentoo Linux In build_system.md (#_translated_label__810_en)
+
+## Update Content - User Environment
+
+### New Features / New Application Porting
+
+- Added core utils to the system (#_translated_label__624_en)
+- Ported the --tcp functionality of the DNS query tool dog (#_translated_label__652_en)
+
+## Update Content - CI
+
+- Introduced triagebot to classify issues and PRs
+- Added automated workflow for clippy detection (#_translated_label__649_en)
+- ci: import issue checker (#_translated_label__750_en)
+- ci: update the match regex of issue checker (#_translated_label__784_en)
+- ci: Added one-click installation script for Gentoo system (#_translated_label__809_en)
+
+## Source Code and Release Image Download
+
+&emsp;&emsp;You can obtain the source code through the following methods:
+
+### Through Git
+
+- You can access the DragonOS repository to get the source code: [https://github.com/DragonOS-Community/DragonOS](https://github.com/DragonOS-Community/DragonOS)
+- You can download the release code from [https://github.com/DragonOS-Community/DragonOS/releases](https://github.com/DragonOS-Community/DragonOS/releases).
+
+### Through DragonOS Software Mirror Site
+
+&emsp;&emsp;To address the slow and unstable access to GitHub in China, and to make it convenient for developers to download the code of each version of DragonOS, we have specially set up a mirror site. You can access the mirror site through the following address:
+
+&emsp;&emsp;You can obtain the DragonOS source code archive and the compiled and runnable disk image through the mirror site.
+
+- [https://mirrors.DragonOS.org.cn](https://mirrors.DragonOS.org.cn)
+- [https://git.mirrors.DragonOS.org.cn](https://git.mirrors.DragonOS.org.cn)
+
+## Open Source Declaration
+
+:::{note}
+To promote the healthy development of the DragonOS project, DragonOS is released under the GPLv2 open source license. Anyone who can obtain the DragonOS source code and corresponding software products (including but not limited to binary copies and documentation) can enjoy the rights granted by us through the GPLv2 license, while you also need to comply with the obligations stipulated in the agreement.
+
+This is a rather strict agreement that protects the healthy development of open source software and prevents it from being encroached upon.
+
+For most well-intentioned people, you will not violate our open source license.
+
+We encourage the free dissemination and promotion of DragonOS, but please ensure that all actions do not infringe upon the legitimate rights and interests of others or violate the GPLv2 license.
+
+Please pay special attention to the fact that violations of the open source license, especially **commercial closed-source usage and any plagiarism or academic misconduct**, will be subject to serious accountability. (This is the most common scenario where the open source license is violated.)
+
+Also, please note that according to the requirements of the GPLv2 license, any software modified or developed based on DragonOS must also be open-sourced under the GPLv2 license and must clearly indicate that it is based on DragonOS. It is also necessary to ensure that users of these modified versions can easily obtain the original version of DragonOS.
+
+You must make sure that DragonOS developers can obtain the source code of your modified version through public channels in the same way, otherwise you will violate the GPLv2 license.
+
+For detailed information about the agreement, please read the **LICENSE** file in the root directory of the project. Please note that according to the requirements of the GPLv2 license, **only the English original version has legal effect**. Any translated version is for reference only.
+:::
+
+### Open Source Software Usage
+
+&emsp;&emsp;During the development of DragonOS, we have referenced some designs from the Linux community, or introduced parts of their ideas, or been inspired by them. We would like to express our sincere gratitude to the Linux community and its contributors here!
+
+## All Commit Records of the Current Version
+
+```text
+commit 9a0802fd2ddda39e96342997abbfc30bf65f1f0e
+Author: donjuanplatinum <113148619+donjuanplatinum@users.noreply.github.com>
+Date:   Mon May 13 15:36:23 2024 +0800
+
+    doc: Add Gentoo Linux In build_system.md (#810)
+    
+    * 增加安装文档中的Gentoo Linux提示
+
+commit 1f4877a4c512eb5ad232436128a0c52287b39aaa
+Author: 曾俊 <110876916+ZZJJWarth@users.noreply.github.com>
+Date:   Mon May 13 15:27:08 2024 +0800
+
+    feat(driver/pci): add pci bus into sysfs (#792)
+    
+    把pci设备加入sysfs
+
+commit 1df85daf8f1b4426fe09d489d815997cdf989a87
+Author: donjuanplatinum <113148619+donjuanplatinum@users.noreply.github.com>
+Date:   Sun May 12 22:58:59 2024 +0800
+
+    添加支持gentoo系统的一键安装脚本 (#809)
+
+commit 352ee04918f4585ad4f8a896ca6e18b1ef7d7934
+Author: LoGin <longjin@DragonOS.org>
+Date:   Sat May 11 18:02:13 2024 +0800
+
+    fix: disable mm debug log to prevent system lockup due to thingbuf issue (#808)
+
+commit 37cef00bb404c9cc01509c12df57548029967dc2
+Author: Samuel Dai <samuka007@qq.com>
+Date:   Sat May 11 17:17:43 2024 +0800
+
+    fix(net): Fix TCP Unresponsiveness and Inability to Close Connections (#791)
+    
+    * fix(net): Improve stability. 为RawSocket与UdpSocket实现close时调用close方法，符合smoltcp的行为。为SocketInode实现drop，保证程序任何情况下退出时都能正确close对应socket, 释放被占用的端口。
+    
+    * fix(net): Correct socket close behavior.
+
+commit b941261d943fac38d3154495e19ec99c90ebea8d
+Author: GnoCiYeH <heyicong@dragonos.org>
+Date:   Tue May 7 22:01:01 2024 +0800
+
+    docs(sched):调度子系统文档即cfs文档 (#807)
+    
+    * 调度子系统文档以及cfs文档
+
+commit 0102d69fdd231e472d7bb3d609a41ae56a3799ee
+Author: LoGin <longjin@DragonOS.org>
+Date:   Wed May 1 21:11:32 2024 +0800
+
+    feat:(riscv/intr) 实现riscv plic驱动,能处理外部中断 (#799)
+    
+    * feat:(riscv/intr) 实现riscv plic驱动,能处理外部中断
+    
+    - 实现riscv plic驱动,能处理外部中断
+    - 能收到virtio-blk的中断
+    - 实现fasteoi interrupt handler
+
+commit 17dc558977663433bd0181aa73ad131a1a265c1f
+Author: MemoryShore <105195940+MemoryShore@users.noreply.github.com>
+Date:   Wed May 1 21:09:51 2024 +0800
+
+    修复vma映射标志错误 (#801)
+
+commit 7db6e06354328ea7c6164723f504e8ba58d0c4a4
+Author: LoGin <longjin@DragonOS.org>
+Date:   Tue Apr 30 18:45:01 2024 +0800
+
+    feat(bitmap): Add bit and for AllocBitMap (#793)
+
+commit 7401bec5e3c42015399a46e29c370abe7c7388b5
+Author: laokengwt <143977175+laokengwt@users.noreply.github.com>
+Date:   Mon Apr 29 23:03:33 2024 +0800
+
+    feat(mm): add slab usage calculation (#768)
+    
+    * Add slab free space calculation and add it to freeram of sysinfo
+
+commit bde4a334c1ff2ae27989de4f6f8b45f5154b684d
+Author: 曾俊 <110876916+ZZJJWarth@users.noreply.github.com>
+Date:   Mon Apr 29 18:55:17 2024 +0800
+
+    修复了未初始化时ui显示模块内存越界的问题，优化了代码结构 (#789)
+
+commit 0722a06a09ed52cb980a6147123453f86d0ea267
+Author: LoGin <longjin@DragonOS.org>
+Date:   Sun Apr 28 19:40:09 2024 +0800
+
+    fix: (riscv/timer): 修复riscv下没有更新墙上时钟以及没有处理软中断的bug (#783)
+
+commit ab53b2eb75fe79167aa100e655b3589ee306f793
+Author: Chiichen <chiichen@qq.com>
+Date:   Sun Apr 28 19:37:58 2024 +0800
+
+    ci: update the match regex of issue checker (#784)
+    
+    The previous regex can not successfully match the pattern like `feat(driver/pci)`, which has a slash in the scope
+
+commit 942cf26b48c8b024a6fa7867bb0c8ae39bb1ae09
+Author: LoGin <longjin@DragonOS.org>
+Date:   Sun Apr 28 16:49:40 2024 +0800
+
+    fix(riscv/process): 把riscv的调度时钟节拍率与HZ同步，并且修复切换到用户态的时候忘了在内核态关中断的bug (#780)
+
+commit 13b057cc0fda0cf9630c98d246937b85fa01a7c9
+Author: 曾俊 <110876916+ZZJJWarth@users.noreply.github.com>
+Date:   Sun Apr 28 16:49:19 2024 +0800
+
+    fix(libs/lib_ui): fix the display errors when system initialize (#779)
+    
+    * 修复了系统初启动时会花屏的bug
+
+commit 182b778a3ca8c633b605ae7dd90a5e9f1131cc6d
+Author: LoGin <longjin@DragonOS.org>
+Date:   Sun Apr 28 13:39:51 2024 +0800
+
+    chore: 适配dadk 0.1.11 (#777)
+    
+    * chore: 适配dadk 0.1.11
+
+commit dd8e74ef0d7f91a141bd217736bef4fe7dc6df3d
+Author: Mingtao Huang <114841534+1037827920@users.noreply.github.com>
+Date:   Sun Apr 28 13:25:12 2024 +0800
+
+    feat(driver/acpi_pm): Implement ACPI PM Timer (#772)
+    
+    * feat: Implement ACPI PM Timer
+
+commit f75cb0f8ed754d94c3b2924519b785db3321c1d9
+Author: LoGin <longjin@DragonOS.org>
+Date:   Sat Apr 27 15:35:24 2024 +0800
+
+    refactor(process): 调整arch_switch_to_user函数，把riscv和x86_64的共用逻辑抽取出来。 (#773)
+    
+    * refactor(process): Extract common logic for riscv and x86_64 in arch_switch_to_user to run_init_process
+    
+    调整arch_switch_to_user函数，把riscv和x86_64的共用逻辑抽取出来。写成run_init_process函数，并且能够尝试运行多个不同的init程序，直到某个运行成功
+
+commit 173c4567cf4fb2276ef3f4614b69da7913fc8381
+Author: zwb0x00 <163394849+zwb0x00@users.noreply.github.com>
+Date:   Fri Apr 26 15:33:29 2024 +0800
+
+    feat(sched): add sched_yield (#766)
+    
+    * 实现sched_yield系统调用
+
+commit 471d65cf158c9bf741c21f5d0ab92efe7bf1c3d4
+Author: LoGin <longjin@DragonOS.org>
+Date:   Fri Apr 26 11:59:47 2024 +0800
+
+    feat(riscv): riscv下能够运行hello world用户程序 (#770)
+    
+    * feat(riscv): riscv下能够运行hello world用户程序
+
+commit 40348dd8d5a008ecc9eb3aab931933e4eba0e6da
+Author: zwb0x00 <163394849+zwb0x00@users.noreply.github.com>
+Date:   Tue Apr 23 19:35:02 2024 +0800
+
+    feat(fs): add sys_dup3 (#755)
+    
+    * feat(fs): add sys_dup3
+
+commit 3b799d13beeb80900d728937308e47f8011835e1
+Author: LoGin <longjin@DragonOS.org>
+Date:   Tue Apr 23 19:14:41 2024 +0800
+
+    Create FUNDING.yml (#763)
+
+commit 731bc2b32d7b37298883d7a15b6dca659b436ee4
+Author: LoGin <longjin@DragonOS.org>
+Date:   Tue Apr 23 17:19:54 2024 +0800
+
+    feat(virtio): riscv: 添加virtio-blk driver,并在riscv下能够正确挂载FAT32 (#761)
+
+commit 0c1ef30087d10035c256fed08097f5897041979d
+Author: Chiichen <chiichen@qq.com>
+Date:   Tue Apr 23 00:27:05 2024 +0800
+
+    docs(community): add description of conventional commit standard (#754)
+    
+    * docs(community): add description of conventional commit standard
+    
+    * docs: add index
+
+commit 70c991af204167db26ec1d9494efcff010893482
+Author: laokengwt <143977175+laokengwt@users.noreply.github.com>
+Date:   Mon Apr 22 17:40:03 2024 +0800
+
+    fix(dog): 添加CC环境变量，解决编译时找不到musl-gcc的问题 (#753)
+
+commit e32effb1507773d32c216d9e77b963786e275c06
+Author: LoGin <longjin@DragonOS.org>
+Date:   Mon Apr 22 15:11:47 2024 +0800
+
+    feat(driver): 把virtio添加到sysfs (#752)
+
+commit a17651b14b86dd70655090381db4a2f710853aa1
+Author: MemoryShore <105195940+MemoryShore@users.noreply.github.com>
+Date:   Mon Apr 22 15:10:47 2024 +0800
+
+    feat(mm): 实现缺页中断处理，支持页面延迟分配和写时拷贝，以及用户栈自动拓展 (#715)
+    
+    * 实现缺页中断处理
+    
+    * 完善页表拷贝逻辑
+    
+    * 优化代码结构
+    
+    * 完善缺页异常信息
+    
+    * 修改大页映射逻辑
+    
+    * 修正大页映射错误
+    
+    * 添加缺页中断支持标志
+    
+    * 实现用户栈自动拓展功能
+
+commit cb02d0bbc213867ac845b7e8a0fb337f723d396a
+Author: Chiichen <chiichen@qq.com>
+Date:   Sun Apr 21 23:23:21 2024 +0800
+
+    ci: import issue checker (#750)
+    
+    * ci: supprot auto tag on pull request
+    
+    * ci: update issue checker config
+    
+    * ci: update issue checker & block merge while
+
+commit 93c379703e3be210799953bc0686d02f97119b39
+Author: sun5etop <146408999+sun5etop@users.noreply.github.com>
+Date:   Sun Apr 21 13:36:44 2024 +0800
+
+    feat(net): 实现raw socket的poll (#739)
+    
+    feat(net): 实现raw socket的poll
+
+commit b502fbf0b9c575a4c04e103d0fb708c4e383ab06
+Author: LoGin <longjin@DragonOS.org>
+Date:   Sun Apr 21 13:30:29 2024 +0800
+
+    chore: Update virtio-drivers to commit 61ece509c4 and modify max_queue_size implementation (#748)
+
+commit d770de5d53ce9b598fb0024800a347b081f92a73
+Author: LoGin <longjin@DragonOS.org>
+Date:   Sun Apr 21 13:12:31 2024 +0800
+
+    fix: 修复unified-init导致cargo check失败的问题 (#747)
+
+commit 881ff6f95e4addc373d815d66cb912bf721c20e6
+Author: yuyi2439 <68320855+yuyi2439@users.noreply.github.com>
+Date:   Sun Apr 21 11:39:00 2024 +0800
+
+    将smoltcp升级到0.11.0版本 (#740)
+
+commit 370472f7288b568c7b80815f5b150daf4496446c
+Author: LoGin <longjin@DragonOS.org>
+Date:   Sun Apr 21 11:27:36 2024 +0800
+
+    pci: 添加pci root manager来管理pci root，并使得riscv能够正常扫描pci设备. (#745)
+    
+    * pci: 添加pci root manager来管理pci root.
+    pci: 使得riscv能够正常扫描pci设备.
+    
+    * doc: 添加注释
+
+commit 2709e017d0d216d61b2caed3c7286459de7794c7
+Author: LoGin <longjin@DragonOS.org>
+Date:   Sat Apr 20 18:31:56 2024 +0800
+
+    pci: 统一使用ecam root (#744)
+
+commit 418ad41fd84c15ed7e132e56970150ac38fc24a9
+Author: LoGin <longjin@DragonOS.org>
+Date:   Wed Apr 17 10:03:22 2024 +0800
+
+    Feat(tty): add dummy console (#735)
+    
+    使得riscv能暂时完成stdio_init(将来需要实现riscv的串口console)
+
+commit 1012552dea71bf04cf1d329d570c4c9ca9b2a2f8
+Author: Saga1718 <161323888+Saga1718@users.noreply.github.com>
+Date:   Tue Apr 16 21:37:42 2024 +0800
+
+    删除无用的hid代码 (#734)
+
+commit fbd63a301c5648f906eeb802f10ac03518ba1264
+Author: SMALLC <121806694+SMALLC04@users.noreply.github.com>
+Date:   Tue Apr 16 21:34:36 2024 +0800
+
+    feat: alarm系统调用实现 (#710)
+    
+    * alarm系统调用实现
+
+commit d623e90231ef6a31d091c3f611c0af3a83d3343b
+Author: GnoCiYeH <heyicong@dragonos.org>
+Date:   Mon Apr 15 22:01:32 2024 +0800
+
+    socket统一改用`GlobalSocketHandle`,并且修复fcntl SETFD的错误 (#730)
+    
+    * socket统一改用`GlobalSocketHandle`,并且修复fcntl SETFD的错误
+    
+    ---------
+    
+    Co-authored-by: longjin <longjin@DragonOS.org>
+
+commit 7162a8358d94c7799dd2b5300192b6a794b23d79
+Author: LoGin <longjin@DragonOS.org>
+Date:   Mon Apr 15 13:20:46 2024 +0800
+
+    doc: Update build instructions for riscv64 architecture (#725)
+
+commit 1074eb34e784aa2adfc5b9e0d89fa4b7e6ea03ef
+Author: Samuel Dai <samuka007@qq.com>
+Date:   Mon Apr 15 13:02:04 2024 +0800
+
+    feat(filesystem): 引入Umount系统调用 (#719)
+    
+    * feat(filesystem): 引入Umount系统调用
+    
+    * 将所有ENOSYS误用更正
+    
+    * 修复了一个使同一个挂载点可以挂载2个文件系统的bug
+    
+    * 统一注释，增强程序稳定性，统一接口。注意：Umount时在fatfs的路径要使用大写，此受限于当前文件系统设计。
+
+commit ceeb2e943ca7645609920ec7ad8bfceea2b13de6
+Author: laokengwt <143977175+laokengwt@users.noreply.github.com>
+Date:   Mon Apr 15 12:51:14 2024 +0800
+
+    feat(mm): 添加slab内存分配器 (#683)
+    
+    feat(mm): 添加slab内存分配器
+    ---------
+    
+    Co-authored-by: longjin <longjin@DragonOS.org>
+
+commit c719ddc6312acd7976e0f6fd449a94ff9abad5a6
+Author: Saga1718 <161323888+Saga1718@users.noreply.github.com>
+Date:   Sun Apr 14 23:51:47 2024 +0800
+
+    feat(net): 实现tcp backlog功能 (#714)
+    
+    * feat:实现tcp的backlog功能
+
+commit 9621ab16ef27bc94f223e6254fafb9bb07d46d57
+Author: LoGin <longjin@DragonOS.org>
+Date:   Sun Apr 14 20:39:20 2024 +0800
+
+    让riscv64能正常切换进程，并运行完所有的initcall (#721)
+
+commit 9fab312ea9921618629924ab15c28c2d255b21c6
+Author: LoGin <longjin@DragonOS.org>
+Date:   Fri Apr 12 15:27:44 2024 +0800
+
+    Update DragonOS description and introduction (#717)
+
+commit f049d1af01da7b92f312245ed411b22475b76065
+Author: LoGin <longjin@DragonOS.org>
+Date:   Fri Apr 12 14:46:47 2024 +0800
+
+    初始化riscv-sbi-timer (#716)
+
+commit 3959e94df38073fdb80b199777015f95611ba05f
+Author: 曾俊 <110876916+ZZJJWarth@users.noreply.github.com>
+Date:   Wed Apr 10 19:00:32 2024 +0800
+
+    bugfix: 修复smp启动的时候，损坏0号核心的idle进程的内核栈的问题 (#711)
+    
+    ---------
+    
+    Co-authored-by: longjin <longjin@DragonOS.org>
+    Co-authored-by: heyicong <heyicong@dragonos.org>
+
+commit 9365e8017b39582eca620ba93c64f1b3c87c73d4
+Author: GnoCiYeH <heyicong@dragonos.org>
+Date:   Wed Apr 10 19:00:12 2024 +0800
+
+    完善pty，目前pty能够支持ssh (#708)
+
+commit 4b0170bd6bb374d0e9699a0076cc23b976ad6db7
+Author: Chiichen <chiichen@qq.com>
+Date:   Wed Apr 10 18:58:54 2024 +0800
+
+    chore(tools): add bootstrap support for Centos/RHEL8/fedora (#713)
+    
+    Co-authored-by: kejianchi <kejianchi@tencent.com>
+
+commit 15b94df01adc7e8931961b9b9a89db4e7c014b64
+Author: Jomo <xuzihao@dragonos.org>
+Date:   Wed Apr 10 10:58:07 2024 +0800
+
+    add xuzihao (#712)
+
+commit 6fc066ac11d2f9a3ac629d57487a6144fda1ac63
+Author: Jomo <2512364506@qq.com>
+Date:   Sun Apr 7 14:04:19 2024 +0800
+
+    实现SystemV共享内存 (#690)
+    
+    * 实现SystemV共享内存
+    
+    * 测试shm
+    
+    * 添加测试程序
+    
+    * 完善细节
+    
+    * 修正shm的时间数据错误的问题
+    
+    * fix: devfs的metadata权限为0x777的错误
+    
+    ---------
+    
+    Co-authored-by: longjin <longjin@DragonOS.org>
+
+commit eb49bb993a39964f92494ec3effafed3fb9adfd8
+Author: 曾俊 <110876916+ZZJJWarth@users.noreply.github.com>
+Date:   Sun Apr 7 14:03:51 2024 +0800
+
+    BlockCache-read cache支持 (#521)
+    
+    支持block cache的读缓存
+
+commit 06560afa2aa4db352526f4be8b6262719b8b3eac
+Author: hmt <114841534+1037827920@users.noreply.github.com>
+Date:   Sat Apr 6 22:26:34 2024 +0800
+
+    Patch feat robust futex (#682)
+    
+    * feat: 实现robust lock机制
+    
+    * 前面更改vscode,修改回来
+    
+    * 修改dadk的路径
+    
+    * 提交.gitnore和.cargo，删除LICENSE，修改README
+    
+    * 修改一个warn
+    
+    * 删除.rustc_info.json
+    
+    * 删除target文件夹
+    
+    * 恢复DragonOS的LICENSE，删除Cargo.lock
+    
+    * 将校验用户空间地址的代码写入函数内；将部分match分支用ok_or代替
+    
+    * 修改wakeup函数获取running queue时unwrap一个None值发生panic
+    
+    * 测试程序使用syscalls库进行系统调用
+
+commit 23ef2b33d1e3cfd2506eb7449a33df4ec42f11d3
+Author: LoGin <longjin@DragonOS.org>
+Date:   Sat Apr 6 22:13:26 2024 +0800
+
+    riscv: 把内核编译target改为riscv64gc & 获取time csr的频率 & 修正浮点保存与恢复的汇编的问题 (#699)
+    
+    * 1. 把内核编译target改为riscv64gc
+    2. fix: 修正浮点保存与恢复的汇编的问题
+    
+    * riscv: 获取time csr的频率
+
+commit f0c87a897fe813b7f06bf5a9e93c43ad9519dafd
+Author: GnoCiYeH <heyicong@dragonos.org>
+Date:   Fri Apr 5 17:54:48 2024 +0800
+
+    重写调度模块 (#679)
+    
+    ## PR：重写调度模块
+    ---
+    ### 完成的部分
+    - 实现cfs调度策略
+    - 搭建框架，后续功能可以迭代开发
+    - 目前能跑，未测试性能
+    
+    ### 需要后续接力的部分
+    - 实现组内调度（task_group）
+    - 实现跨核负载均衡（pelt算法）
+    - 接入sysfs，实现参数动态调节（sched_stat等）
+    - nice值以及priority等参数的设置及调优
+
+commit e8eab1ac824e1b1e638e50debb8326dfed4f05e5
+Author: LoGin <longjin@DragonOS.org>
+Date:   Fri Apr 5 16:37:08 2024 +0800
+
+    riscv: copy-thread (#696)
+
+commit dfe53cf087ef4c7b6db63d992906b062dc63e93f
+Author: GnoCiYeH <heyicong@dragonos.org>
+Date:   Fri Apr 5 00:21:55 2024 +0800
+
+    实现pty，附带测试程序 (#685)
+    
+    * 实现pty，附带测试程序
+    
+    * fmt ** clippy
+    
+    * 将file层的锁粒度缩小，从而不使用no_preempt。更改pipe在sleep部分的bug
+    
+    * 修复拼写错误
+
+commit b8ed38251dc255b0c525801b5dbf37d3b0d0d61e
+Author: Donkey Kane <109840258+xiaolin2004@users.noreply.github.com>
+Date:   Fri Apr 5 00:06:26 2024 +0800
+
+    修复jiffy时钟过快问题，启用gettimeofday测试，修改mount测试 (#680)
+    
+    1. 把clock tick rate与hpet频率关联起来
+    2. 修复墙上时间同步错误的问题
+    3. 启用时间watch dog.
+    4. 修复时间流逝速度异常
+    
+    ---------
+    
+    Co-authored-by: longjin <longjin@DragonOS.org>
+
+commit 9430523b465b19db4dd476e9fd3038bdc2aa0c8d
+Author: yuyi2439 <68320855+yuyi2439@users.noreply.github.com>
+Date:   Thu Apr 4 12:41:19 2024 +0800
+
+    使nproc可以正确获取到cpu核心数 (#689)
+
+commit 9b96c5b547c337502db7ec820312f119f95eece1
+Author: LoGin <longjin@DragonOS.org>
+Date:   Sun Mar 31 22:53:01 2024 +0800
+
+    riscv64: switch process (#678)
+    
+    * riscv64: switch process
+    
+    * fixname
+
+commit 7d580ef99d2a52250b384afd49c7f87ab66a8c84
+Author: Val213 <112376067+val213@users.noreply.github.com>
+Date:   Sun Mar 31 18:01:32 2024 +0800
+
+    修复get_ramdom的长度错误问题() (#677)
+
+commit 56cc4dbe27e132aac5c61b8bd4f4ec9a223b49ee
+Author: Jomo <2512364506@qq.com>
+Date:   Sun Mar 31 16:33:49 2024 +0800
+
+    实现页面反向映射 (#670)
+    
+    * 实现页面反向映射
+    
+    * 完善PAGE_MANAGER初始化时机 && 封装lock函数 && 删掉过时注释
+
+commit 924d64de8def99488f57dc618de763f7aca4a68b
+Author: BrahmaMantra <140599389+BrahmaMantra@users.noreply.github.com>
+Date:   Sun Mar 31 15:19:12 2024 +0800
+
+    修复了ramfs中move_to未更新parent字段的bug (#673)
+    
+    修复了ramfs中move_to未更新parent字段的bug
+    
+    ---------
+    
+    Co-authored-by: Samuel Dai <samuka007@qq.com>
+
+commit 9d9a09841ce2d650a41fed776916c0a11d52f92e
+Author: sun5etop <146408999+sun5etop@users.noreply.github.com>
+Date:   Sun Mar 31 15:11:10 2024 +0800
+
+    修复udp bind的时候，对port0处理不正确的问题(#676)
+
+commit da152319797436368304cbc3f85a3b9ec049134b
+Author: LoGin <longjin@DragonOS.org>
+Date:   Thu Mar 28 00:28:13 2024 +0800
+
+    实现了rtc的抽象，并且把x86的cmos rtc接入到设备驱动模型 (#674)
+    
+    * 实现了rtc的抽象，并且把x86的cmos rtc接入到设备驱动模型。
+
+commit 597ecc08c2444dcc8f527eb021932718b69c9cc5
+Author: TTaq <103996388+TTaq@users.noreply.github.com>
+Date:   Tue Mar 26 18:28:26 2024 +0800
+
+    新加结构体POSIXSTATFS与SuperBlock用于处理statfs系统调用 (#667)
+    
+    * 新加结构体POSIXSTATFS与SuperBlock用于处理statfs系统调用
+
+commit 0cb807346cb3c47924538585087d9fc846cf5e6f
+Author: LoGin <longjin@DragonOS.org>
+Date:   Tue Mar 26 18:26:02 2024 +0800
+
+    修复tty设备显示在/sys目录下的bug (#668)
+
+commit 2755467c790d6510fa97cbf052ce8e91ad1372c6
+Author: 曾俊 <110876916+ZZJJWarth@users.noreply.github.com>
+Date:   Mon Mar 25 16:39:36 2024 +0800
+
+    支持绘制24位深和16位深显示缓冲区 (#640)
+    
+    * 修复了初始化时显示，边界条件的一个bug
+    
+    * 解决了内存未初始前字体显示的兼容性问题
+    * 支持绘制24位深和16位深显示缓冲区
+
+commit 4256da7fb6ad25a3caab6f656607aaf047cb6446
+Author: LoGin <longjin@DragonOS.org>
+Date:   Mon Mar 25 15:47:05 2024 +0800
+
+    把Device trait的set_class改为设置Weak指针，以避免循环引用问题。 (#666)
+
+commit 5c20e05a2eb82da6dd73104fcf51d538500c2856
+Author: LoGin <longjin@DragonOS.org>
+Date:   Mon Mar 25 13:59:00 2024 +0800
+
+    修改bug report模版label (#665)
+
+commit 7c958c9ef0cd25eb15abb21d0d3420aac1c67c88
+Author: Val213 <112376067+val213@users.noreply.github.com>
+Date:   Mon Mar 25 13:04:53 2024 +0800
+
+    移植dns查询工具dog的--tcp功能 (#652)
+    
+    * add dog, modify user/Makefile and user.sysconfig
+    
+    * add dog, modify user/Makefile and user.sysconfig
+    
+    * fix tty unicode
+    
+    * 修正无法正确编译dog的问题
+    
+    ---------
+    
+    Co-authored-by: val213 <val213666@gmail.com>
+    Co-authored-by: GnoCiYeH <heyicong@dragonos.org>
+    Co-authored-by: longjin <longjin@DragonOS.org>
+
+commit 911132c4b8ea0e9c49a4e84b9fa1db114102acbb
+Author: Donkey Kane <109840258+xiaolin2004@users.noreply.github.com>
+Date:   Mon Mar 25 13:04:32 2024 +0800
+
+    修复clock_gettime返回类型错误，修复小时间间隔duration返回0问题 (#664)
+    
+    * 修复clock_gettime返回类型错误，修正wtm初始化逻辑
+    
+    * 修复duration在小时间间隔下为0的问题
+    
+    * 临时修复时间流逝速度异常，在test-mount中加入运行时间检测
+
+commit 401699735b5ec29768c3c0c47df6c529991f108f
+Author: LoGin <longjin@DragonOS.org>
+Date:   Sat Mar 23 16:25:56 2024 +0800
+
+    riscv: 进程管理初始化 (#654)
+
+commit 6046f77591cf23dc9cc53b68b25c0d74f94fa493
+Author: 裕依 <68320855+yuyi2439@users.noreply.github.com>
+Date:   Sat Mar 23 15:56:49 2024 +0800
+
+    Patch socketpair (#576)
+    
+    * 将sockets分成inet和unix域
+    - 添加File端点
+    - 添加SocketPair trait并将Socket trait中的pair相关方法移动
+    - 添加对SockAddrUn的处理
+    
+    * 精简SocketHandleItem
+    
+    * 重构socketpair相关逻辑
+    - 将File端点换成Inode端点
+    - 尝试使用SocketInode进行socketpair(未成功)
+    
+    
+    * 将SocketPair trait合并到Socket trait中，去除downcast
+
+commit 3660256a9ee94abc30b5b22508cbd48c44c86089
+Author: LoGin <longjin@DragonOS.org>
+Date:   Sat Mar 23 11:51:30 2024 +0800
+
+    只对x86_64进行clippy check (#651)
+
+commit 4e4c8c41e90989c1f732995511e0f9a77a33f650
+Author: LoGin <longjin@DragonOS.org>
+Date:   Fri Mar 22 23:56:30 2024 +0800
+
+    添加clippy检测的自动化工作流 (#649)
+    
+    * 添加clippy检测的自动化工作流
+    
+    * fmt
+    
+    * 1
+
+commit b5b571e02693d91eb6918d3b7561e088c3e7ee81
+Author: LoGin <longjin@DragonOS.org>
+Date:   Fri Mar 22 23:26:39 2024 +0800
+
+    修复内核的clippy检查报错 (#637)
+    
+    修复内核的clippy检查报错
+    ---------
+    
+    Co-authored-by: Samuel Dai <947309196@qq.com>
+    Co-authored-by: Donkey Kane <109840258+xiaolin2004@users.noreply.github.com>
+    Co-authored-by: themildwind <107623059+themildwind@users.noreply.github.com>
+    Co-authored-by: GnoCiYeH <heyicong@dragonos.org>
+    Co-authored-by: MemoryShore <105195940+MemoryShore@users.noreply.github.com>
+    Co-authored-by: 曾俊 <110876916+ZZJJWarth@users.noreply.github.com>
+    Co-authored-by: sun5etop <146408999+sun5etop@users.noreply.github.com>
+    Co-authored-by: hmt <114841534+1037827920@users.noreply.github.com>
+    Co-authored-by: laokengwt <143977175+laokengwt@users.noreply.github.com>
+    Co-authored-by: TTaq <103996388+TTaq@users.noreply.github.com>
+    Co-authored-by: Jomo <2512364506@qq.com>
+    Co-authored-by: Samuel Dai <samuka007@qq.com>
+    Co-authored-by: sspphh <112558065+sspphh@users.noreply.github.com>
+
+commit 4695947e1b601c83641676485571d42c692a2bbd
+Author: Chenzx <109664121+schulice@users.noreply.github.com>
+Date:   Fri Mar 22 18:27:07 2024 +0800
+
+    实现SYS_LINK和SYS_LINKAT (#611)
+    
+    * 实现do_linkat及SYS_LINK和SYS_LINKAT
+    
+    * 未在riscv上测试，添加target_arch
+    
+    * 将c字符串检查移动到vfs/syscall.rs，修改do_linkat()逻辑
+    
+    * 修改部分注释
+
+commit 70f159a3988eab656ea1d2b204fde87948526ecf
+Author: LoGin <longjin@DragonOS.org>
+Date:   Thu Mar 21 21:35:39 2024 +0800
+
+    riscv64: 添加flush tlb的ipi (#636)
+    
+    * riscv64: 添加flush tlb的ipi
+    
+    * update triagebot
+
+commit b4eb05a17f0f65668f69e7979660874ef8e01a2e
+Author: TTaq <103996388+TTaq@users.noreply.github.com>
+Date:   Thu Mar 21 19:59:10 2024 +0800
+
+    Statx (#632)
+    
+    
+    * 实现statx及测试的应用程序
+
+commit 8cb2e9b344230227fe5f3ab3ebeb2522f1c5e289
+Author: LoGin <longjin@DragonOS.org>
+Date:   Thu Mar 21 19:19:32 2024 +0800
+
+    重写SMP模块 (#633)
+    
+    * 修复cpumask的迭代器的错误。
+    
+    * 能进系统（AP核心还没有初始化自身）
+    
+    * 初始化ap core
+    
+    * 修改percpu
+    
+    * 删除无用的cpu.c
+    
+    * riscv64编译通过
+
+commit 1d37ca6d172e01a98fa6785d2b3e07fb8202a4a9
+Author: Donkey Kane <109840258+xiaolin2004@users.noreply.github.com>
+Date:   Wed Mar 20 15:31:20 2024 +0800
+
+    添加mount系统调用 (#561)
+    
+    * Modify dadk config to switch NovaShell revision
+    
+    * finish primary build of mount(2), usable now
+    
+    * 使用read_from_cstr函数优化代码可读性 , 针对文件系统新增错误EUNSUPFS
+    
+    * small changes
+    
+    * 添加系统调用文档
+    
+    * cargo fmt
+    
+    * Revert "small changes"
+    
+    This reverts commit e1991314ce687faa2d652479e8ef64f5bea25fa1.
+    
+    * 修复用户程序参数传入错误
+    
+    * Revert "small changes"
+    
+    This reverts commit e1991314ce687faa2d652479e8ef64f5bea25fa1.
+    
+    * 解决合并冲突，最终提交
+    
+    * 将dadk_config切换为相对路径以修复依赖问题
+    
+    * Update settings.json
+    
+    * Delete user/apps/test-mount/LICENSE
+    
+    * 换用更好的c字符串读取函数，优化系统调用函数注释，修复错误处理bug，删除无用文件，修改测试程序readme
+    
+    * 修改用户程序readme
+    
+    * 代码格式化，初级版本
+    
+    * 初级版本，未实现文件系统管理器，未支持设备挂载
+    
+    * 为文件系统添加name方法，返回文件系统名字字符串，为挂载查询服务
+    
+    * mount系统调用：添加统一文件系统初始化管理器
+    
+    * null
+    
+    * 解除冲突
+    
+    * 删除无用kdebug
+
+commit 1cd9bb43f0256aecf19a090dd71e4ac2b86a5e29
+Author: LoGin <longjin@DragonOS.org>
+Date:   Tue Mar 19 21:31:02 2024 +0800
+
+    添加core utils到系统 (#624)
+
+commit 8c6f21840f820a161d4386000aea1d79e3bc8d13
+Author: sspphh <112558065+sspphh@users.noreply.github.com>
+Date:   Tue Mar 19 17:01:20 2024 +0800
+
+    实现uname系统调用 (#614)
+    
+    * 实现uname系统调用
+    
+    Co-authored-by: longjin <longjin@DragonOS.org>
+
+commit 82df0a13109e400602ddaec049d04ae230eb485b
+Author: hmt <114841534+1037827920@users.noreply.github.com>
+Date:   Tue Mar 19 16:45:44 2024 +0800
+
+    fix: mkdir输出错误信息; feat: 实现get_pathname (#615)
+    
+    * fix: mkdir输出错误信息; feat: 实现get_pathname
+    
+    * fix: 将处理路径的操作放入vfs而不是在syscall/mod.rs中
+    
+    * 调整入参类型
+    
+    ---------
+    
+    Co-authored-by: longjin <longjin@DragonOS.org>
+
+commit 9e481b3bfe303e0b104694da9750ae978dfeecae
+Author: TTaq <103996388+TTaq@users.noreply.github.com>
+Date:   Mon Mar 18 14:47:59 2024 +0800
+
+    实现了sys_rename (#578)
+    
+    * 基本实现了rename的系统调用
+    
+    * 实现相对路径的mv
+    
+    * confilct resolve
+    
+    * make fmt
+    
+    * 更改校验位置，
+     增加了SYS_RENAMEAT与SYS_RENAMEAT2两个系统调用，其实现与SYS_RENAME基本一致
+    
+    * 删除了fat中的link
+    
+    * fix
+    
+    * 修改注释格式，删除管道文件判断
+    
+    * 1
+
+commit c3c73444516b7b47b6327cd66f5453133f47998d
+Author: LoGin <longjin@DragonOS.org>
+Date:   Sat Mar 16 22:28:59 2024 +0800
+
+    更新triagebot配置 (#616)
+    
+    * 更新triagebot配置
+
+commit 4fd916113e576a1c5d8ca9faae7a9d6b25afb9ae
+Author: LoGin <longjin@DragonOS.org>
+Date:   Sat Mar 16 18:09:32 2024 +0800
+
+    triagebot-add-shortcut (#612)
+
+commit fbc174499f5200924c732263e461c79b4a936c5b
+Author: LoGin <longjin@DragonOS.org>
+Date:   Fri Mar 15 20:06:24 2024 +0800
+
+    添加triagebot文件 (#608)
+    
+    * 添加triagebot文件
+
+```

docs/locales/en/community/ChangeLog/V0.1.x/V0.1.2.md

@@ -0,0 +1,333 @@
+:::{note}
+**AI Translation Notice**
+
+This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+- Source document: community/ChangeLog/V0.1.x/V0.1.2.md
+
+- Translation time: 2025-05-19 01:42:16
+
+- Translation model: `Qwen/Qwen3-8B`
+
+Please report issues via [Community Channel](https://github.com/DragonOS-Community/DragonOS/issues)
+
+:::
+
+# V0.1.2
+
+:::{note}
+Author: Long Jin <longjin@RinGoTek.cn>
+
+December 17, 2022
+:::
+
+## Contributors
+
+The DragonOS V0.1.2 version has been contributed by the following developers:
+
+- Long Jin <longjin@ringotek.cn>
+- Wu Yujian <wuyujian@DragonOS.org>
+- Gou Ngai <sujintao@DragonOS.org>
+- Huang Ting <huangting@DragonOS.org>
+- Wang Wencong <1297389017@qq.com>
+
+## Sponsors
+
+Thank you to the following individuals for their support. We will continue to strive hard!
+
+- David Wen
+- [Seele.Clover](https://github.com/seeleclover)
+- TerryLeeSCUT 
+- Wu
+- slientbard
+
+Among them, we are especially grateful to **Seele.Clover** for contributing RMB 500 to the DragonOS project! We will carefully record every sponsorship and ensure that it is used appropriately.
+
+## Update Content - Kernel
+
+- Remove rust_helloworld file (#_translated_label__113_en)
+- Signal: Allow users to register signal handler functions, enabling custom handlers. (#_translated_label__112_en)
+    - Support for the kill command
+    - Allow users to customize signal handling functions
+    - Add two new system calls: `SYS_SIGACTION`, `SYS_RT_SIGRETURN`
+    - libc adds `signal()`, `sigaction()` functions.
+    - Currently only supports the old version of sighandler, i.e., signal handler functions with only one parameter of type `void handler(int signum)`. The other type of signal handler function `void handler(int signum, siginfo_t *info, void* data)` does not currently support passing the third parameter.
+- Add a custom stdint.h file in the kernel code (#_translated_label__109_en)
+- Adjust the script for compiling grub (#_translated_label__108_en)
+- Add 32-bit and 64-bit UEFI boot support (#_translated_label__105_en)(#_translated_label__101_en)
+- Use compiled installed grub-2.06 to solve the problem of compilation failure due to incorrect grub version on the client.
+- Add a timekeeping module (#_translated_label__106_en)
+- Bugfix: Fix the issue where the rtc clock forgot to process the day field when converting to BCD code (#_translated_label__104_en)
+- New: Development process documentation (completed half)
+- bootstrap.sh solves the problem of slow rust download
+- Update the "Build System" documentation
+- procfs->status adds display of preempt and virtual runtime (#_translated_label__100_en)
+- ffz function: get the first bit that is 0 in a u64 (#_translated_label__100_en)
+- Solve the problem of local_irq_restore not being able to get the correct rflags value due to compiler optimization
+- Refactor the serial port driver using Rust (#_translated_label__99_en)
+
+## Update Content - User Environment
+
+- about app: Display the current git commit sha1 and build time (#_translated_label__114_en)
+- shell: Fix the error in the shell's exec command when concatenating absolute paths (#_translated_label__114_en)
+- shell: Add "&" background execution option for the exec command (#_translated_label__100_en)
+- New: Test app for signal
+- Adjust the libc directory and add cargo as the Rust package manager
+
+## Source Code and Release Image Download
+
+&emsp;&emsp;You can obtain the source code through the following methods:
+
+### Get via Git
+
+- You can download the release code and the compiled, runnable disk image from [https://github.com/fslongjin/DragonOS/releases](https://github.com/fslongjin/DragonOS/releases).
+- We also have a mirror repository on gitee for download: [https://gitee.com/DragonOS/DragonOS](https://gitee.com/DragonOS/DragonOS)
+
+### Get via DragonOS Software Mirror Site
+
+&emsp;&emsp;To solve the problem of slow and unstable access to GitHub in China, and to make it convenient for developers to download the code of each version of DragonOS, we have specially set up a mirror site. You can access the mirror site through the following address:
+
+&emsp;&emsp;You can obtain the DragonOS source code package and the compiled, runnable disk image through the mirror site.
+
+- [https://mirrors.DragonOS.org](https://mirrors.DragonOS.org)
+- [https://mirrors.DragonOS.org.cn](https://mirrors.DragonOS.org.cn)
+
+## Open Source Declaration
+
+:::{note}
+To promote the healthy development of the DragonOS project, DragonOS is released under the GPLv2 open source license. Anyone who can obtain the DragonOS source code and corresponding software products (including but not limited to binary copies and documents) can enjoy the rights granted by us through the GPLv2 protocol, while you also need to comply with the obligations stipulated in the protocol.
+
+This is a rather strict protocol that protects the healthy development of open source software and prevents it from being encroached upon.
+
+For most well-intentioned people, you will not violate our open source protocol.
+
+We encourage the free dissemination and promotion of DragonOS, but please ensure that all actions do not infringe on the legitimate rights and interests of others or violate the GPLv2 protocol.
+
+Please pay special attention to the fact that violations of the open source protocol, especially **commercial closed-source use and any plagiarism or academic misconduct**, will be subject to serious accountability. (This is the easiest scenario to violate our open source protocol.)
+
+Also, please note that according to the requirements of the GPLv2 protocol, any software modified or developed based on DragonOS must also be open-sourced under the GPLv2 protocol and clearly indicate that it is based on DragonOS. It must also ensure that users of these modified versions can easily obtain the original version of DragonOS.
+
+You must make sure that the developers of DragonOS can obtain the source code of your modified version through public channels in the same way, otherwise you will violate the GPLv2 protocol.
+
+For detailed information about the protocol, please read the **LICENSE** file in the root directory of the project. Please note that according to the requirements of the GPLv2 protocol, **only the English original version is legally binding**. Any translated version is for reference only.
+:::
+
+### Open Source Software Usage
+
+&emsp;&emsp;During the development of DragonOS, we have referenced some open source projects' designs, or introduced parts of their code, or been inspired by them. We list them below. We sincerely thank the contributors of these open source projects!
+
+Format: <Project Name> - <Link> - <Open Source License>
+
+- Linux - https://git.kernel.org/ - GPLv2
+- skiftOS - https://github.com/skiftOS/skift - MIT
+- FYSOS - https://github.com/fysnet/FYSOS - [FYSOS' License](https://github.com/fysnet/FYSOS/blob/9a8968e3d6600de34539c028c843f4c06d134039/license.txt)
+- LemonOS - https://github.com/LemonOSProject/LemonOS.git - BSD 2-Clause License
+- LZ4 - https://github.com/lz4/lz4 - BSD 2-Clause license
+- SerenityOS - https://github.com/SerenityOS/serenity.git - BSD 2-Clause license
+- MINE - 《A Design and Implementation of a 64-bit Operating System》 by Tian Yu; People's Posts and Telecommunications Press
+- chcore - 《Modern Operating Systems: Design and Implementation》 by Chen Haibo, Xia Yubin; Machinery Industry Press
+- SimpleKernel - https://github.com/Simple-XX/SimpleKernel - MIT
+
+## All Commit Records of the Current Version
+
+```text
+commit 7a818da88a1c7a1760de7671141b0ce1ca4e3dde
+Author: login <longjin@ringotek.cn>
+Date:   Sat Dec 17 17:49:12 2022 +0800
+
+    Patch about auto gen version string (#114)
+    
+    * new: about app中，显示当前构建的git commit sha1以及构建时间
+    
+    * bugfix: 修复shell的exec命令对绝对路径的拼接错误问题
+
+commit 83a7aaa46bbc411c43d4fc099c6c8884efbe4771
+Author: login <longjin@ringotek.cn>
+Date:   Sat Dec 17 16:31:50 2022 +0800
+
+    删除rust_helloworld文件 (#113)
+
+commit 6efd4740336205c9bfdd8b164e667cee2f38781e
+Author: login <longjin@ringotek.cn>
+Date:   Sat Dec 17 16:27:50 2022 +0800
+
+    允许用户自定义信号处理函数 (#112)
+    
+    * new: 用户注册信号处理函数，能够进入自定义的handler
+    
+    * 修复忘了传信号的数字给用户的处理函数的bug
+    
+    * new:sigreturn
+    
+    * 删除注释
+
+commit 0e0c187484281768391e131495f0655e40d70cf7
+Author: login <longjin@ringotek.cn>
+Date:   Fri Dec 16 16:20:09 2022 +0800
+
+    在内核代码中加入自定义的stdint.h文件 (#109)
+
+commit d02e6ea4112ad520aa4090ff73cdf592e14c0a82
+Author: login <longjin@ringotek.cn>
+Date:   Wed Dec 14 20:01:55 2022 +0800
+
+    调整编译grub的脚本的部分 (#108)
+    
+    1、bugfix: 修复编译grub的脚本的部分错误
+    2、将grub下载源替换为tuna
+    3、优化写入磁盘镜像的脚本
+    4、将bios文件夹改名为legacy
+
+commit 38b341b8aa671f75ac26d05059aa2e9a09e653b7
+Author: YJwu2023 <119829947+YJwu2023@users.noreply.github.com>
+Date:   Wed Dec 14 16:58:49 2022 +0800
+
+    新增32位uefi启动 (#105)
+    
+    * 新增32位uefi启动
+    
+    * 修复小bug
+    
+    * 增加grub本地编译安装
+    
+    * 增加本地grub编译安装脚本
+    
+    * 修正小错误
+    
+    * 修复空文件夹不上传的bug
+
+commit 01876902fbf6ed43992cc7d153bd8c505cb5224b
+Author: Gou Ngai <94795048+AlbertSanoe@users.noreply.github.com>
+Date:   Wed Dec 14 15:13:54 2022 +0800
+
+    增加了timekeeping模块 (#106)
+    
+    * 增加了timekeeping模块
+    
+    * 格式化文档和细节更改
+    
+    Co-authored-by: longjin <longjin@RinGoTek.cn>
+
+commit 728aca308917a7d4d0ba10fe8174e9408d77a9a6
+Author: login <longjin@ringotek.cn>
+Date:   Sun Dec 11 22:59:47 2022 +0800
+
+    bugfix: 修复rtc时钟对BCD码进行转换的时候，忘了处理day字段的问题 (#104)
+
+commit 237e95c6ddce72d72ae7fedfeca412fab82b3622
+Author: wwc-15172310230 <78997674+wwc-15172310230@users.noreply.github.com>
+Date:   Sun Dec 11 22:22:10 2022 +0800
+
+    调整user下libs的libc目录结构 (#103)
+    
+    * 调整user下libs的libc目录结构
+    
+    * 修正.gitignore文件的问题
+    
+    * 修复无法编译的问题
+    
+    Co-authored-by: longjin <longjin@RinGoTek.cn>
+
+commit 2291ffdece1dc5a703602f79f74df8a4854d215b
+Author: login <longjin@ringotek.cn>
+Date:   Sun Dec 11 20:09:58 2022 +0800
+
+    文档更新 (#102)
+    
+    * new: 开发过程文档（完成了一半）
+    
+    * bootstrap.sh解决下载rust慢的问题
+    
+    * 更新“构建系统”文档
+
+commit 7f439c5ddbd2ecffc112149d16983975f523052c
+Author: YJwu2023 <119829947+YJwu2023@users.noreply.github.com>
+Date:   Fri Dec 9 16:08:54 2022 +0800
+
+    增加uefi启动 (#101)
+    
+    * 增加uefi启动
+    
+    * 修改脚本
+    
+    * uefi修改
+    
+    * 删除错误的注释
+    
+    * 修正写入磁盘镜像的脚本
+    
+    * 修改X86_64为x86_64
+    
+    Co-authored-by: longjin <longjin@RinGoTek.cn>
+
+commit 1a2eaa402f05f82aaeebe1e03824534a0a425d4d
+Author: login <longjin@ringotek.cn>
+Date:   Thu Dec 8 22:59:51 2022 +0800
+
+    signal的处理(kill命令)以及一些其他的改进 (#100)
+    
+    * 将entry.S中冗余的ret_from_syscall代码删除，改为jmp Restore_all
+    
+    * new: 增加判断pt_regs是否来自用户态的函数
+    
+    * new: rust的cli和sti封装
+    
+    * 将原有的判断pt_regs是否来自用户态的代码，统一改为调用user_mode函数
+    
+    * ffz函数：获取u64中的第一个值为0的bit
+    
+    * spinlock增加 spinlock irq spin_unlock_irq
+    
+    * 临时解决显示刷新线程迟迟不运行的问题
+    
+    * 更改ffi_convert的生命周期标签
+    
+    * new: 测试signal用的app
+    
+    * 解决由于编译器优化导致local_irq_restore无法获取到正确的rflags的值的问题
+    
+    * new: exec命令增加"&"后台运行选项
+    
+    * procfs->status增加显示preempt和虚拟运行时间
+    
+    * 更改引用计数的FFIBind2Rust trait中的生命周期标签
+    
+    * new: signal处理(kill)
+    
+    * 更正在review中发现的一些细节问题
+
+commit f8b55f6d3fcbf152a1cb6d6fc722bf1607418b28
+Author: TingHuang <92705854+TingSHub@users.noreply.github.com>
+Date:   Tue Dec 6 22:15:03 2022 +0800
+
+    Patch uart (#99)
+    
+    * 添加UART驱动相关文件
+    
+    * 添加驱动核心文件，将rust编写的驱动代码加入Package中
+    
+    * 添加glib.h文件生成rust代码，添加uart驱动代码
+    
+    * 添加串口发送及接收相关代码
+    
+    * 添加字符串发送函数,未实现具体功能
+    
+    * 为调用uart驱动的代码添加rust接口
+    
+    * 添加字符串发送函数，修改C语言调用接口
+    
+    * 添加rust串口驱动
+    
+    * 添加uart.h头文件，将串口端口类型改为enum
+    
+    * 添加注释，规范代码
+
+commit 036acc52ce9d0fb9e7d92768ff74939a29c07f32
+Author: login <longjin@ringotek.cn>
+Date:   Tue Nov 29 21:46:13 2022 +0800
+
+    将entry.S中冗余的ret_from_syscall代码删除，改为jmp Restore_all (#98)
+    
+    * 将entry.S中冗余的ret_from_syscall代码删除，改为jmp Restore_all
+
+```

docs/locales/en/community/ChangeLog/V0.1.x/V0.1.3.md

@@ -0,0 +1,504 @@
+:::{note}
+**AI Translation Notice**
+
+This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+- Source document: community/ChangeLog/V0.1.x/V0.1.3.md
+
+- Translation time: 2025-05-19 01:41:49
+
+- Translation model: `Qwen/Qwen3-8B`
+
+Please report issues via [Community Channel](https://github.com/DragonOS-Community/DragonOS/issues)
+
+:::
+
+# V0.1.3
+
+:::{note}
+Author: Longjin <longjin@RinGoTek.cn>
+
+January 8, 2023
+:::
+
+## Contributors
+
+The DragonOS V0.1.3 version was contributed by the following individuals:
+
+- Longjin <longjin@RinGoTek.cn>
+- Wu Yujian <wuyujian@DragonOS.org>
+- Guan Jinquan <guanjinquan@DragonOS.org>
+- Gou Ngai <sujintao@DragonOS.org>
+
+## Sponsors
+
+Thank you to the following individuals for their support. We will continue to strive for excellence!
+
+- David Wen
+- [Seele.Clover](https://github.com/seeleclover)
+- TerryLeeSCUT 
+- Wu
+- slientbard
+
+## Update Content - Kernel
+
+- syscall: new: Add getpid system call (#_translated_label__120_en)
+- signal: update: Add all signals except SIGKILL to SigQueue (#_translated_label__120_en)
+- rtc: refactor: Refactor RTC driver using Rust (#_translated_label__118_en)
+- doc: new: Add documentation for signal (#_translated_label__126_en)
+- Spinlock: new: Add Rust-written RawSpinlock (#_translated_label__127_en)
+- arch: update: Change the path of the arch module in lib.rs, so that other modules can use the code in arch without specifying arch::x86_64 (#_translated_label__128_en)
+- mm: bugfix: Fix the bug where ZONE_NORMAL_INDEX was always 0 during initialization of the page allocator (#_translated_label__129_en)
+- scheduler: new: Refactor CFS scheduler using Rust (#_translated_label__131_en)
+- smp: Remove the HPET interrupt forwarding function that has been deprecated in smp (#_translated_label__131_en)
+- process: bugfix: Fix the issue where the init process forgot to set the fs and gs registers. (#_translated_label__132_en)
+- vfs: update: Rename the VFS folder to vfs (#_translated_label__133_en)
+- lockref: new: Add Rust version of lockref (#_translated_label__135_en)
+- cpu: new: Rust wrapper for cpu_relax(), using the pause instruction to let the CPU rest for a while, reducing idle power consumption. (#_translated_label__135_en)
+- Refactor softirq mechanism using Rust (#_translated_label__138_en)
+
+## Update Content - User Environment
+
+- libc: bugfix: Always register sigkill when registering signal handlers (#_translated_label__120_en)
+- libc: new: Add raise, kill, abort (#_translated_label__120_en)
+- libc: new: Add an arch folder, and add crt0, crti, crtn files under it (#_translated_label__134_en)
+- libc: new: Add `fflush()`, `fprintf()`, `stdin`, `stdout`, `stderr`, `ferror()`, `fopen()`, `fclose()`, `putchar()`, `puts()` (#_translated_label__136_en)
+- libc: new: Simply add `fopen()` for handling the mode parameter. Please note that it does not fully comply with POSIX, and is inconsistent with Linux. It will be improved when using Rust in the future. (#_translated_label__141_en)
+- Porting: new: Add porting and build scripts for gmp, mpfr, and mpc (#_translated_label__136_en)
+- Porting: new: Add cross-compilation build scripts for gcc and binutils, as well as patches for gcc-11.3.0 and binutils-2.38 (in the DragonOS-community repository) (#_translated_label__136_en)
+- compile: update: Update the include path for the compiler, so that includes do not need the `<libc/src/include/>` prefix (#_translated_label__124_en)
+
+## Update Content - Others
+
+- bugfix: Fix the bug where Docker installation would exit abnormally (#_translated_label__116_en)
+- new: Add a new GCC bare-metal compiler targeting x86_64-elf, and use it to compile DragonOS (#_translated_label__111_en)
+- update: Update the Docker build image to version `dragonos/dragonos-dev:v1.2`, and support building this build image from a Dockerfile (#_translated_label__111_en)
+- bugfix: Fix the bug where the MBR disk image did not set the boot flag (#_translated_label__111_en)
+- update: Update the GitHub workflow, add cache, and speed up build checks
+- bugfix: Fix the error message when downloading grub2.06 (#_translated_label__125_en)
+
+## Update Content - Software Porting
+
+- new: gcc 11.3.0 userland cross-compiler, commit: `64a5b1cbf28e3305560e166c1b6624e99745c720`, repository: [https://github.com/DragonOS-Community/gcc](https://github.com/DragonOS-Community/gcc)
+- new: binutils 2.38 cross-compile tools, commit: `a0ae560e0065862a9867b9e1f8364749ef38d99e`, repository: [https://github.com/DragonOS-Community/binutils](https://github.com/DragonOS-Community/binutils)
+- new: gmp 6.2.1, commit: `dd9eee5778fb6027fafa4fe850aff21b1a71c18e`, repository: [https://github.com/DragonOS-Community/gmp-6.2.1](https://github.com/DragonOS-Community/gmp-6.2.1)
+- new: mpfr 4.1.1, commit: `fa8e30cdc2e838fdd82b60fec31fcfc5e118aad6`, repository: [https://github.com/DragonOS-Community/mpfr](https://github.com/DragonOS-Community/mpfr)
+- new: mpc 1.2.1, (can be ported without applying patches), repository: [https://github.com/DragonOS-Community/mpc](https://github.com/DragonOS-Community/mpc)
+
+## Source Code and Release Image Download
+
+&emsp;&emsp;You can obtain the source code through the following methods:
+
+### Get via Git
+
+- You can download the release code and the compiled, runnable disk image from [https://github.com/fslongjin/DragonOS/releases](https://github.com/fslongjin/DragonOS/releases).
+- We also have a mirror repository on Gitee for download: [https://gitee.com/DragonOS/DragonOS](https://gitee.com/DragonOS/DragonOS)
+
+### Get via DragonOS Software Mirror Site
+
+&emsp;&emsp;To address the slow and unstable access to GitHub in China, and to make it convenient for developers to download the code of each version of DragonOS, we have specially set up a mirror site. You can access the mirror site through the following address:
+
+&emsp;&emsp;You can obtain the DragonOS source code archive and the compiled, runnable disk image through the mirror site.
+
+- [https://mirrors.DragonOS.org](https://mirrors.DragonOS.org)
+- [https://mirrors.DragonOS.org.cn](https://mirrors.DragonOS.org.cn)
+- Domestic mirror acceleration: [https://mirrors.ringotek.cn/](https://mirrors.ringotek.cn/)
+
+## Open Source Declaration
+
+:::{note}
+To promote the healthy development of the DragonOS project, DragonOS is released under the GPLv2 open source license. Anyone who can obtain the DragonOS source code and corresponding software products (including but not limited to binary copies and documentation) can enjoy the rights granted by us through the GPLv2 protocol, while you also need to comply with the obligations stipulated in the protocol.
+
+This is a rather strict protocol that protects the healthy development of open source software and prevents it from being encroached upon.
+
+For most well-intentioned people, you will not violate our open source license.
+
+We encourage the free dissemination and promotion of DragonOS, but please ensure that all actions do not infringe on the legitimate rights and interests of others or violate the GPLv2 protocol.
+
+Please pay special attention to the fact that violations of the open source license, especially **commercial closed-source usage and any acts of plagiarism or academic misconduct**, will be subject to serious accountability. (This is the easiest scenario to violate our open source license.)
+
+Also, please note that according to the requirements of the GPLv2 protocol, software modified or developed based on DragonOS must also be open-sourced under the GPLv2 protocol and must indicate that it is based on DragonOS. It must also ensure that users of these modified versions can easily obtain the original version of DragonOS.
+
+You must allow the DragonOS developers to obtain the source code of your modified version through the same method from public channels; otherwise, you will violate the GPLv2 protocol.
+
+For detailed information about the protocol, please read the **LICENSE** file in the root directory of the project. Please note that, according to the requirements of the GPLv2 protocol, **only the English original version has legal effect**. Any translated version is for reference only.
+:::
+
+### Usage of Open Source Software
+
+&emsp;&emsp;During the development of DragonOS, we have referenced the design of some open source projects, or introduced parts of their code, or been inspired by them. Below is a list of these open source projects. We sincerely thank the contributors of these open source projects!
+
+Format: <Project Name> - <Link> - <Open Source License>
+
+- Linux - https://git.kernel.org/ - GPLv2
+- skiftOS - https://github.com/skiftOS/skift - MIT
+- FYSOS - https://github.com/fysnet/FYSOS - [FYSOS' License](https://github.com/fysnet/FYSOS/blob/9a8968e3d6600de34539c028c843f4c06d134039/license.txt)
+- LemonOS - https://github.com/LemonOSProject/LemonOS.git - BSD 2-Clause License
+- LZ4 - https://github.com/lz4/lz4 - BSD 2-Clause license
+- SerenityOS - https://github.com/SerenityOS/serenity.git - BSD 2-Clause license
+- MINE - "A Design and Implementation of a 64-bit Operating System" by Tian Yu; People's Posts and Telecommunications Press
+- chcore - "Modern Operating Systems: Design and Implementation" by Chen Haibo, Xia Yubin; Machinery Industry Press
+- SimpleKernel - https://github.com/Simple-XX/SimpleKernel - MIT
+- rcore-fs - https://github.com/rcore-os/rcore-fs.git - MIT
+
+## All Commit Records of the Current Version
+
+```text
+commit a8b621c8d1fe77251b8e4eafe258dc0ee7366dd5
+Author: login <longjin@ringotek.cn>
+Date:   Sun Jan 8 15:47:44 2023 +0800
+
+    修正由于libc中具有crti.S和crtn.S，造成的与x86_64-elf-gcc不兼容的问题 (#144)
+
+commit 9358ff0f6f7daa18d6fab4497de025736b3d6725
+Author: login <longjin@ringotek.cn>
+Date:   Sun Jan 8 15:06:52 2023 +0800
+
+    Add v0.1.3 changelog (#143)
+    
+    * new: 0.1.3发行日志
+    
+    * 新增输出指定时间范围内的贡献者名单的脚本
+    
+    * 更新bootloader文档
+    
+    * update: 简介文档
+    
+    * new: 镜像站文档
+    
+    * update: 功能特性文档
+
+commit fd91905f022b3ceaa59e666d1ff42d91fb8d40ef
+Author: login <longjin@ringotek.cn>
+Date:   Sun Jan 8 11:38:59 2023 +0800
+
+    解决编译gcc、binutils的脚本中，变量名称错误的问题 (#142)
+
+commit 62e4613978193aaf5d949a331df0398f2d085a30
+Author: Gou Ngai <94795048+AlbertSanoe@users.noreply.github.com>
+Date:   Sat Jan 7 23:15:37 2023 +0800
+
+    使用rust重构softirq机制；解决Rtc驱动的编译警告问题 (#138)
+    
+    * 使用rust重构softirq机制
+    * 解决Rtc驱动的编译警告问题
+    
+    Co-authored-by: longjin <longjin@RinGoTek.cn>
+
+commit e9fdc57bf878f1bc5cc5743dfaeeaef743439291
+Author: login <longjin@ringotek.cn>
+Date:   Sat Jan 7 22:36:49 2023 +0800
+
+    简单添加了fopen对mode参数的处理。请注意，它没有完全遵循posix，也与Linux的不一致，将来使用Rust的时候完善它。 (#141)
+
+commit 2224c93ea968bc74621f7e124b4aca04875b3e6a
+Author: guanjinquan <1666320330@qq.com>
+Date:   Fri Jan 6 21:29:23 2023 +0800
+
+    完善libc，构建了OS-specific工具链，编译了基于gcc-11.3.0的DragonOS userland compiler，移植了mpfr,gmp,mpc库 (#134)
+    
+    * 修改include路径
+    
+    * 添加了创建libsysapi.a和/bin/sysroot/usr/include/+lib/的代码
+    
+    * 修补.gitignore
+    
+    * 删除多余项
+    
+    * 优化脚本可读性
+    
+    * 新增crt0 crti crtn
+    
+    * 编译binutils所需的东西
+    
+    * fflush()和fprintf()的简单实现
+    
+    * 应用程序启动前，调用初始化libc的函数
+    
+    * 自动创建sysroot
+    
+    * 添加了stderr的初始化
+    
+    * 修改了stderr的初始化
+    
+    * 内核添加对stdio的简略处理
+    
+    * 格式化代码
+    
+    * 修正打开stdio文件描述符的问题
+    
+    * bugfix: 修复fprintf忘记释放buf的问题
+    
+    * 修复shell错误地把入口设置为main而不是_start的问题
+    
+    * 新增__cxa_atexit  (gcc要求libc提供这个）
+    
+    * 增加putchar puts
+    
+    * 更新写入磁盘镜像的脚本，默认无参数时，使用legacy方式安装
+    
+    * 更新编译脚本
+    
+    * stdio增加eof的定义
+    
+    * 新增extern cplusplus
+    
+    * mpfr gmp mpc 构建脚本
+    
+    * 更新libsysapi.a为libc.a
+    
+    * 加上ferror fopen fclose
+    
+    * 更新移植的软件的构建脚本
+    
+    * 更改build_gcc_toolchain.sh中的-save参数名为-save-cache
+    
+    Co-authored-by: longjin <longjin@RinGoTek.cn>
+
+commit 61de2cdc3f29cdc6c441f128119e01e003e6f3ca
+Author: login <longjin@ringotek.cn>
+Date:   Tue Jan 3 23:09:25 2023 +0800
+
+    新增rust版本的lockref (#135)
+    
+    * new:Rust封装cpu_relax(),通过pause指令，让cpu休息一会儿。降低空转功耗
+    
+    * new: Rust版本的lockref
+    
+    * Rust的RawSpinlock新增is_locked()和set_value()方法。
+    
+    * lockref文档
+
+commit 2726f101b4cc787bbd36a69afffb0112f3a6567f
+Author: login <longjin@ringotek.cn>
+Date:   Tue Jan 3 21:01:56 2023 +0800
+
+    删除无用的cfs.h (#136)
+
+commit 587086d3f299f7394559d547c828191be20cfc11
+Author: login <longjin@ringotek.cn>
+Date:   Sun Jan 1 16:53:57 2023 +0800
+
+    1、在文件系统目录下增加mod.rs 2、将VFS的路径改为vfs(#133)
+    
+    2、将VFS的路径改为vfs
+
+commit 843e442971a47693f37a5f8d3452c383f7325359
+Author: login <longjin@ringotek.cn>
+Date:   Sat Dec 31 18:43:05 2022 +0800
+
+    修复init进程忘记设定fs gs寄存器的问题。 (#132)
+
+commit 74bde36e014ff501241bf40dd83653db47a2c8e4
+Author: guanjinquan <1666320330@qq.com>
+Date:   Sat Dec 31 17:35:39 2022 +0800
+
+    Patch porting gcc v2 (#124)
+    
+    * 更改编译器的Include路径，使得include时不需要加`<libc/src/include/>`前缀
+    
+    * 修改include路径
+    
+    Co-authored-by: longjin <longjin@RinGoTek.cn>
+
+commit d4f3de93a23e4bd4f000a3663768d47d094bf188
+Author: login <longjin@ringotek.cn>
+Date:   Sat Dec 31 17:26:12 2022 +0800
+
+    使用Rust重构CFS调度器 (#131)
+    
+    * 新建调度器的文件
+    
+    * 把softirq vector移动到c文件中（原来在.h)
+    
+    * 将进程切换方式改为“中断返回时切换”
+    
+    * new:使用rust重构CFS
+    
+    * 删除已经在smp中废弃的HPET中断转发函数
+    
+    * 代码格式化
+    
+    * 删除多余的dunce依赖
+
+commit 156949680c83f2d7e3b21ed68b11698b88eaf396
+Author: login <longjin@ringotek.cn>
+Date:   Sat Dec 31 13:47:49 2022 +0800
+
+    bugfix:修复当使用sched()运行调度器，在切换进程的时候，由于不在中断上下文内，导致当前进程的上下文丢失的问题。 (#130)
+    
+    bugfix:修复当使用sched()运行调度器，在切换进程的时候，由于不在中断上下文内，导致当前进程的上下文丢失的问题。
+    bugfix:修复切换进程的宏的汇编代码的损坏部分，未声明rax寄存器，从而导致的编译器未定义行为问题。
+
+commit 882f0b7e7498dbff8de527b2b9159b7f6e6359c9
+Author: YJwu2023 <119829947+YJwu2023@users.noreply.github.com>
+Date:   Wed Dec 28 19:35:17 2022 +0800
+
+    修复内存bug与grub安装脚本的错误 (#129)
+    
+    * 修复内存bug与grub安装脚本的错误
+    
+    * 修改小bug
+
+commit adc1846b06fb862caed049f435fc0061488a6ff9
+Author: login <longjin@ringotek.cn>
+Date:   Mon Dec 26 13:13:12 2022 +0800
+
+    内核：在lib.rs中，将arch模块的路径进行更改，使得其他模块使用arch的代码时，不需要指定arch::x86_64 (#128)
+
+commit ac643d420b22f9d454ecefccd51ed34a9664586b
+Author: login <longjin@ringotek.cn>
+Date:   Sun Dec 25 23:53:35 2022 +0800
+
+    new:新增rust写的RawSpinlock (#127)
+
+commit 998390210549b47e6bdcc3fdab49eff4086ad18b
+Author: login <longjin@ringotek.cn>
+Date:   Sat Dec 24 23:30:26 2022 +0800
+
+    新增signal文档 (#126)
+    
+    * 新增signal文档
+
+commit a7f5ca7b67160557abf84a1169dd60093220aeb0
+Author: YJwu2023 <119829947+YJwu2023@users.noreply.github.com>
+Date:   Sat Dec 24 23:29:36 2022 +0800
+
+    修复下载grub2.06时的提示错误 (#125)
+    
+    * 修复grub下载显示提示显示错误
+
+commit 82762007da41148e1ed1df465211eb5c8ba2c15e
+Author: login <longjin@ringotek.cn>
+Date:   Fri Dec 23 18:11:47 2022 +0800
+
+    Update makefile.yml
+
+commit b975025ec8854ca232152f4ee44cc2226891a34c
+Author: login <longjin@ringotek.cn>
+Date:   Fri Dec 23 11:45:19 2022 +0800
+
+    Update makefile.yml
+
+commit ad2bb74d949bfcb2935e43ac7b261d7ecce23389
+Author: login <longjin@ringotek.cn>
+Date:   Fri Dec 23 11:21:22 2022 +0800
+
+    Update makefile.yml
+
+commit 6b7776d189ab5f19fbab20d6c5c9ed3ab20c7ab6
+Author: login <longjin@ringotek.cn>
+Date:   Fri Dec 23 10:59:15 2022 +0800
+
+    修正smp的makefile中没有替换AS的问题
+
+commit beb12a188b6c6bc4196796ac2ae1ecd7d8ed8223
+Author: login <longjin@ringotek.cn>
+Date:   Fri Dec 23 10:57:39 2022 +0800
+
+    Update makefile.yml
+
+commit d65c527730e5c8a75f6dad0f996c093040699ee3
+Author: login <longjin@ringotek.cn>
+Date:   Thu Dec 22 22:58:28 2022 +0800
+
+    Update makefile.yml (#121)
+
+commit 5ed4cd460200cb19aae8c3c67dfd77e1e9f0e105
+Author: guanjinquan <75822481+guanjinquan@users.noreply.github.com>
+Date:   Thu Dec 22 21:09:12 2022 +0800
+
+    Patch gcc toolchain (#111)
+    
+    * 添加了GCC_cross_compile——tool_chain
+    
+    * - 解决环境变量路径拼接时，多了`/`的问题
+    - apt安装时增加-y,不需用户确认
+    
+    * 解决添加环境变量的命令有误的问题
+    
+    * 修正编译错误时，还会执行下一步的问题
+    
+    * new: 编译完成后清理临时文件
+    
+    * 更新makefile
+    
+    * 调整：把grub安装在 $HOME/opt/dragonos-grub下
+    
+    * new: 新增dockerfile
+    
+    * 将镜像源换成中科大的（原因是清华的总是ban掉用于构建镜像的服务器的ip）
+    
+    * 修改为基于debian bullseye构建
+    
+    * 取消指定版本
+    
+    * 修复MBR磁盘镜像未设置启动标志的bug
+    
+    * 取消在docker中安装grub
+    
+    * 安装grub的过程改到客户机上进行
+    
+    * bootstrap.sh 添加--no-docker
+    
+    * 使用新版的docker编译镜像
+    
+    * 修补, 添加了一些关于gcc的check
+    
+    Co-authored-by: longjin <longjin@RinGoTek.cn>
+
+commit ba0d93d8b26034abc54bcaf3f0ff04863bbd076e
+Author: Gou Ngai <94795048+AlbertSanoe@users.noreply.github.com>
+Date:   Mon Dec 19 15:04:37 2022 +0800
+
+    refactor rtc module in rust (#118)
+    
+    * 用rust重构rtc模块
+    
+    * refactor the rtc module by rust
+    
+    * rtc-updated
+    
+    * rtc-updated-4
+    
+    * rtc
+
+commit c588d6f77f4b38939701b946228218ea81a7c8dc
+Author: login <longjin@ringotek.cn>
+Date:   Mon Dec 19 15:03:44 2022 +0800
+
+    Patch add abort func (#120)
+    
+    * 对于除了sigkill以外的信号，也加入队列
+    
+    * bugfix:libc中，注册信号处理函数时，总是注册sigkill的问题
+    
+    * 增加getpid系统调用
+    
+    * 增加了raise、kill、abort
+
+commit 47f0d12a1f1a1aa11be8e751ecdbf76f0cb596d9
+Author: YJwu2023 <119829947+YJwu2023@users.noreply.github.com>
+Date:   Mon Dec 19 14:53:51 2022 +0800
+
+    修复docker安装时异常退出的bug (#119)
+    
+    * 修复docker安装时异常退出的bug
+    
+    * 修复grub编译脚本的小bug
+
+commit 978043e47d1143ca2d5cf22b20793f032e8eb5a5
+Author: login <longjin@ringotek.cn>
+Date:   Sun Dec 18 15:09:15 2022 +0800
+
+    修复当系统中不存在dosfstools时，无法正确格式化磁盘镜像的问题 (#117)
+    
+    * 修复当系统中不存在dosfstools时，无法正确格式化磁盘镜像的问题
+
+commit f9127772dc372a2e607388fdd6818d3f9c4c6d28
+Author: YJwu2023 <119829947+YJwu2023@users.noreply.github.com>
+Date:   Sat Dec 17 23:43:23 2022 +0800
+
+    修复docker安装时异常退出的bug (#116)
+
+```

docs/locales/en/community/ChangeLog/V0.1.x/V0.1.4.md

@@ -0,0 +1,279 @@
+:::{note}
+**AI Translation Notice**
+
+This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+- Source document: community/ChangeLog/V0.1.x/V0.1.4.md
+
+- Translation time: 2025-05-19 01:42:41
+
+- Translation model: `Qwen/Qwen3-8B`
+
+Please report issues via [Community Channel](https://github.com/DragonOS-Community/DragonOS/issues)
+
+:::
+
+# V0.1.4
+
+:::{note}
+Author: Longjin <longjin@RinGoTek.cn>
+
+February 4, 2023
+:::
+
+## Contributors List
+
+The DragonOS V0.1.4 version was contributed by the following developers:
+
+- Longjin <longjin@RinGoTek.cn>
+- Gou Ngai <sujintao@DragonOS.org>
+- Kong Weichao <kongweichao@DragonOS.org>
+- Hou Jiaying <houjiaying@DragonOS.org>
+
+## Sponsors List
+
+Thank you to the following individuals for their support. We will continue to strive for excellence!
+
+- David Wen (2000 RMB)
+- [Seele.Clover](https://github.com/seeleclover) (500 RMB)
+- Ye Jinyi (100 RMB)
+- Lin (50 RMB)
+- Albert (9.99 RMB)
+- TerryLeeSCUT (6.66 RMB)
+- slientbard (6.66 RMB)
+- Wu (2.00 RMB)
+- [Other anonymous contributors] (1.00 RMB)
+
+## Update Content - Kernel
+
+- Spinlock: new: Added SpinLock with guards, supporting compile-time checking of lock usage. (#_translated_label__148_en)
+- Spinlock: feature: Added lock_irqsave and unlock_irqrestore for raw spin lock (#_translated_label__151_en)
+- Mutex: new: Rust version of Mutex (#_translated_label__157_en)
+- doc: new: Rust code style document (#_translated_label__161_en)
+- WaitQueue: new: Rust version of WaitQueue (#_translated_label__162_en)
+- WaitQueue: update: For the C version of wait_queue, changed to immediate wake-up (#_translated_label__158_en)
+- block io: new: Block IO scheduler. When there are multiple cores, the IO scheduler runs on core 1. (#_translated_label__158_en)
+- smp: bugfix: Start apic_timer for AP cores, making them able to run scheduling (#_translated_label__158_en)
+- smp: new: Added kick_cpu function, supporting making a specific core run the scheduler immediately (#_translated_label__158_en)
+- smp: new: Added process migration functionality between cores (#_translated_label__158_en)
+- scheduler: new: Added real-time process scheduler (supporting FIFO and RR strategies) (#_translated_label__139_en)
+- scheduler: update: CFS scheduler sets a separate IDLE process pcb (pid is 0) for each core (#_translated_label__158_en)
+- scheduler: bugfix: When process_wakeup, reset the virtual runtime for CFS processes. Solves the problem of other processes starving due to small virtual runtime of sleeping processes. (#_translated_label__158_en)
+- process: new: Added migrate_to field in pcb (#_translated_label__158_en)
+
+## Update Content - User Environment
+
+None
+
+## Update Content - Others
+
+None
+
+## Update Content - Software Porting
+
+None
+
+## Source Code and Release Image Download
+
+&emsp;&emsp;You can obtain the source code through the following methods:
+
+### Get via Git
+
+- You can visit [https://github.com/fslongjin/DragonOS/releases](https://github.com/fslongjin/DragonOS/releases) to download the release code, as well as the compiled and runnable disk image.
+- We also have a mirror repository on gitee for download: [https://gitee.com/DragonOS/DragonOS](https://gitee.com/DragonOS/DragonOS)
+
+### Get via DragonOS Software Mirror Site
+
+&emsp;&emsp;To solve the problem of slow and unstable access to GitHub in China, and to make it convenient for developers to download the code of each version of DragonOS, we have specially set up a mirror site. You can access the mirror site through the following address:
+
+&emsp;&emsp;You can get the DragonOS code package and the compiled and runnable disk image through the mirror site.
+
+- [https://mirrors.DragonOS.org](https://mirrors.DragonOS.org)
+- [https://mirrors.DragonOS.org.cn](https://mirrors.DragonOS.org.cn)
+- Domestic mirror acceleration: [https://mirrors.ringotek.cn/](https://mirrors.ringotek.cn/)
+
+## Open Source Declaration
+
+:::{note}
+To promote the healthy development of the DragonOS project, DragonOS is released under the GPLv2 open source license. Anyone who can obtain the DragonOS source code and corresponding software products (including but not limited to binary copies and documents) will enjoy the rights granted by us through the GPLv2 license, and you must also comply with the obligations stipulated in the agreement.
+
+This is a rather strict license that protects the healthy development of open source software and prevents it from being encroached upon.
+
+For most well-intentioned people, you will not violate our open source license.
+
+We encourage the free dissemination and promotion of DragonOS, but please ensure that all actions do not infringe on the legitimate rights and interests of others and do not violate the GPLv2 license.
+
+Please pay special attention to the fact that violations of the open source license, especially **commercial closed-source use and any acts of plagiarism or academic misconduct**, will be subject to serious accountability. (This is the easiest scenario to violate our open source license.)
+
+Also, please note that according to the requirements of the GPLv2 license, any software modified or developed based on DragonOS must also be open-sourced under the GPLv2 license and must clearly indicate that it is based on DragonOS. It must also ensure that users of these modified versions can conveniently obtain the original version of DragonOS.
+
+You must make it possible for the DragonOS developers to obtain the source code of your modified version through public channels in the same way, otherwise you will violate the GPLv2 license.
+
+For detailed information about the license, please read the **LICENSE** file in the root directory of the project. Please note that according to the GPLv2 license, **only the English original version is legally binding**. Any translated version is for reference only.
+:::
+
+### Open Source Software Usage
+
+&emsp;&emsp;During the development of DragonOS, we have referenced the design of some open source projects, or introduced parts of their code, or been inspired by them. Below is a list of these open source projects. We sincerely thank the contributors of these open source projects!
+
+Format: <Project Name> - <Link> - <Open Source License>
+
+- Linux - https://git.kernel.org/ - GPLv2
+- skiftOS - https://github.com/skiftOS/skift - MIT
+- FYSOS - https://github.com/fysnet/FYSOS - [FYSOS' License](https://github.com/fysnet/FYSOS/blob/9a8968e3d6600de34539c028c843f4c06d134039/license.txt)
+- LemonOS - https://github.com/LemonOSProject/LemonOS.git - BSD 2-Clause License
+- LZ4 - https://github.com/lz4/lz4 - BSD 2-Clause license
+- SerenityOS - https://github.com/SerenityOS/serenity.git - BSD 2-Clause license
+- MINE - "A Design and Implementation of a 64-bit Operating System" by Tian Yu; People's Posts and Telecommunications Press
+- chcore - "Modern Operating Systems: Design and Implementation" by Chen Haibo, Xia Yubin; Machinery Industry Press
+- SimpleKernel - https://github.com/Simple-XX/SimpleKernel - MIT
+- rcore-fs - https://github.com/rcore-os/rcore-fs.git - MIT
+
+## All Commit Records of the Current Version
+
+```text
+commit f6ba114bb0420e848ef7fc844c96c0d7a0552d93
+Author: houmkh <100781004+houmkh@users.noreply.github.com>
+Date:   Sat Feb 4 12:31:15 2023 +0800
+
+    Block IO Scheduler (#158)
+    
+    * Block io调度器
+    * process_wakeup时，对cfs的进程，重设虚拟运行时间。解决由于休眠的进程，其虚拟运行时间过小，导致其他进程饥饿的问题
+    
+    * 1、为AP核启动apic_timer,使其能够运行调度
+    2、增加kick_cpu功能，支持让某个特定核心立即运行调度器
+    3、wait_queue的唤醒，改为立即唤醒。
+    4、增加进程在核心间迁移的功能
+    5、CFS调度器为每个核心设置单独的IDLE进程pcb（pid均为0）
+    6、pcb中增加migrate_to字段
+    7、当具有多核时，io调度器在核心1上运行。
+    
+    * io调度器文件位置修改
+    
+    * 修改io的makefile
+    
+    * 更新makefile中的变量名
+    
+    * 修改io调度器函数名
+    
+    ---------
+    
+    Co-authored-by: login <longjin@ringotek.cn>
+
+commit 151251b50b7ed55596edd32ffec49a4041010e2a
+Author: login <longjin@ringotek.cn>
+Date:   Tue Jan 31 19:27:02 2023 +0800
+
+    Patch add rust waitqueue (#162)
+    
+    * new: rust版本的waitqueue
+    
+    * new:等待队列的文档
+
+commit 3c369b1430e8d571bcc74a8ef7fefc1c4cae5dd2
+Author: login <longjin@ringotek.cn>
+Date:   Mon Jan 30 15:43:42 2023 +0800
+
+    new:新增rust代码风格 (#161)
+
+commit c28bd540ac856cd9d8d5597852af8f2588a660e4
+Author: login <longjin@ringotek.cn>
+Date:   Mon Jan 30 15:10:24 2023 +0800
+
+    更新赞助者名单 (#160)
+    
+    * 更新赞赏者列表
+
+commit 935f40ec174fec217aed4553d45996327443bc0e
+Author: login <longjin@ringotek.cn>
+Date:   Tue Jan 17 21:30:16 2023 +0800
+
+    new: Rust版本的Mutex (#157)
+
+commit d8a064128a8a06b90ff4c7b87c193518d9572641
+Author: Gou Ngai <94795048+AlbertSanoe@users.noreply.github.com>
+Date:   Mon Jan 16 19:58:50 2023 +0800
+
+    Raw spin lock 增加lock_irqsave、unlock_irqrestore(#151)
+    
+    Raw spin lock 增加lock_irqsave、unlock_irqrestore
+
+commit 06b09f34ed64a006a80ae8df383e3c8b176f02e0
+Author: kong <45937622+kkkkkong@users.noreply.github.com>
+Date:   Sat Jan 14 22:38:05 2023 +0800
+
+    Patch sched rust (#139)
+    
+    * update
+    
+    * 添加rt调度器的rust初步实现
+    
+    * 完善rt调度逻辑
+    
+    * 调试rt调度器
+    
+    * 修改sched的返回值
+    
+    * cargo fmt 格式化
+    
+    * 删除无用代码，修补rt bug
+    
+    * 删除无用的代码，和重复的逻辑
+    
+    * 软中断bugfix
+    
+    * 删除一些代码
+    
+    * 添加kthread_run_rt文档
+    
+    * 解决sphinix警告_static目录不存在的问题
+    
+    Co-authored-by: longjin <longjin@RinGoTek.cn>
+
+commit ec53d23ed03347854189d92b7e175f309779321b
+Author: login <longjin@ringotek.cn>
+Date:   Sat Jan 14 10:35:49 2023 +0800
+
+    new: 新增具有守卫的自旋锁SpinLock，支持编译期对锁的使用进行检查。 (#148)
+
+commit 41474ba3df99b6822ce452dc94dc53a4da62cba1
+Author: login <longjin@ringotek.cn>
+Date:   Tue Jan 10 22:07:41 2023 +0800
+
+    更新Readme中关于DragonOS的介绍部分 (#146)
+
+commit 8ad2e358fd3b05eed2919de50640682e51687fb5
+Author: login <longjin@ringotek.cn>
+Date:   Sun Jan 8 15:51:59 2023 +0800
+
+    更新about app中的版本号 (#145)
+    
+    * 更新about app中的版本号
+
+commit a8b621c8d1fe77251b8e4eafe258dc0ee7366dd5
+Author: login <longjin@ringotek.cn>
+Date:   Sun Jan 8 15:47:44 2023 +0800
+
+    修正由于libc中具有crti.S和crtn.S，造成的与x86_64-elf-gcc不兼容的问题 (#144)
+
+commit 9358ff0f6f7daa18d6fab4497de025736b3d6725
+Author: login <longjin@ringotek.cn>
+Date:   Sun Jan 8 15:06:52 2023 +0800
+
+    Add v0.1.3 changelog (#143)
+    
+    * new: 0.1.3发行日志
+    
+    * 新增输出指定时间范围内的贡献者名单的脚本
+    
+    * 更新bootloader文档
+    
+    * update: 简介文档
+    
+    * new: 镜像站文档
+    
+    * update: 功能特性文档
+
+
+```

docs/locales/en/community/ChangeLog/V0.1.x/V0.1.5.md

@@ -0,0 +1,321 @@
+:::{note}
+**AI Translation Notice**
+
+This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+- Source document: community/ChangeLog/V0.1.x/V0.1.5.md
+
+- Translation time: 2025-05-19 01:44:14
+
+- Translation model: `Qwen/Qwen3-8B`
+
+Please report issues via [Community Channel](https://github.com/DragonOS-Community/DragonOS/issues)
+
+:::
+
+# V0.1.5
+
+:::{note}
+Author: Longjin <longjin@RinGoTek.cn>
+
+March 13, 2023
+:::
+
+## Contributors List
+
+The DragonOS V0.1.5 version is contributed by the following developers:
+
+- Longjin <longjin@DragonOS.org>
+- Guan Jinquan <guanjinquan@DragonOS.org>
+- Su Jintao <sujintao@DragonOS.org>
+- Kong Weichao <kongweichao@DragonOS.org>
+- Hou Jiaying <houjiaying@DragonOS.org>
+- Wu Yujian <wuyujian@DragonOS.org>
+- Zhou Yuzhe <zhouyuzhe@DragonOS.org>
+- Satin Wuker <74630829+SatinWuker@users.noreply.github.com>
+
+## Sponsors List
+
+Thank you to the following contributors for their support. We will keep working hard!
+
+- Wan Xiaolan
+- David Wen
+- [Seele.Clover](https://github.com/seeleclover)
+- [FindWangHao](https://github.com/FindWangHao)
+- Ye Jinyi
+- Lin
+- Albert
+- [TerryLeeSCUT · GitHub](https://github.com/TerryLeeSCUT)
+- slientbard
+- Wu
+
+## Update Content - Kernel
+
+- scheduler: doc: Real-time process scheduler documentation (#_translated_label__163_en)
+- scheduler: rt: RTQueue now uses a doubly linked list for storage (#_translated_label__174_en)
+- scheduler: load balance: Multi-core load balancing (#_translated_label__193_en)
+- Semaphore: new: Added a Rust implementation of the semaphore (#_translated_label__183_en)
+- mm: refactor: Refactored the MMIO address allocator (#_translated_label__184_en)
+- RwLock: new: Added a Rust implementation of the read-write lock (#_translated_label__186_en)
+- driver: update: Improved PCI functionality (#_translated_label__194_en)
+- driver: new: VirtIO network card driver (still has issues) (#_translated_label__194_en)
+- driver: refactor: Rust version of the AHCI driver (#_translated_label__198_en)
+- block io: delete: Removed the Block IO scheduler. (#_translated_label__196_en)
+- filesystem: refactor: New version of VFS (#_translated_label__198_en)
+- filesystem: refactor: New version of ProcFS (#_translated_label__198_en)
+- filesystem: refactor: New version of DevS (#_translated_label__198_en)
+- filesystem: new: RamFS memory file system (#_translated_label__198_en)
+- filesystem: new: FAT12/FAT16/FAT32 file system (#_translated_label__198_en)
+- filesystem: new: New device and block device abstraction (#_translated_label__198_en)
+
+## Update Content - User Environment
+
+- libc: Adjusted, all apps are now directly linked to libc.a, instead of going through the "search.o" process (#_translated_label__171_en)
+
+## Update Content - Others
+
+- bootstrap: Fixed the issue with Ubuntu2210 not being able to compile GRUB correctly, and properly install QEMU (#_translated_label__176_en)
+- toolchain: Added a Rust bare bone toolchain (#_translated_label__197_en)
+
+## Update Content - Software Porting
+
+None
+
+## Source Code and Release Image Download
+
+&emsp;&emsp;You can obtain the source code through the following methods:
+
+### Get via Git
+
+- You can download the release code and the compiled, runnable disk image by visiting [https://github.com/DragonOS-Community/DragonOS/releases](https://github.com/DragonOS-Community/DragonOS/releases).
+- We also have a mirror repository on Gitee for download: [https://gitee.com/DragonOS/DragonOS](https://gitee.com/DragonOS/DragonOS)
+
+### Get via DragonOS Software Mirror Site
+
+&emsp;&emsp;To address the slow and unstable access to GitHub in China, and to make it easier for developers to download the code for each version of DragonOS, we have specifically set up a mirror site. You can access the mirror site through the following address:
+
+&emsp;&emsp;You can obtain the DragonOS source code archive and the compiled, runnable disk image through the mirror site.
+
+- [https://mirrors.DragonOS.org](https://mirrors.DragonOS.org)
+- [https://mirrors.DragonOS.org.cn](https://mirrors.DragonOS.org.cn)
+- Domestic mirror acceleration: [https://mirrors.ringotek.cn/](https://mirrors.ringotek.cn/)
+
+## Open Source Declaration
+
+:::{note}
+To promote the healthy development of the DragonOS project, DragonOS is released under the GPLv2 open source license. Anyone who can obtain the DragonOS source code and related software products (including but not limited to binary copies and documentation) is entitled to the rights granted by us through the GPLv2 license, and you must also comply with the obligations stipulated in the agreement.
+
+This is a rather strict license that protects the healthy development of open-source software and prevents it from being encroached upon.
+
+For most well-intentioned people, you will not violate our open-source license.
+
+We encourage the free dissemination and promotion of DragonOS, but please ensure that all actions do not infringe on the legitimate rights and interests of others or violate the GPLv2 license.
+
+Please pay special attention to the fact that violations of the open-source license, especially **commercial closed-source usage and any acts of plagiarism or academic misconduct**, will be subject to serious accountability. (This is the most common scenario where the open-source license is violated.)
+
+Also, please note that according to the requirements of the GPLv2 license, any software that is modified or developed based on DragonOS must also be open-sourced under the GPLv2 license and must clearly indicate that it is based on DragonOS. It is also necessary to ensure that users of these modified versions can easily obtain the original version of DragonOS.
+
+You must make it possible for the DragonOS developers to obtain the source code of your modified version through public channels, otherwise you will violate the GPLv2 license.
+
+For detailed information about the license, please read the **LICENSE** file in the root directory of the project. Please note that according to the requirements of the GPLv2 license, **only the English original version has legal effect**. Any translated versions are for reference only.
+:::
+
+### Usage of Open Source Software
+
+&emsp;&emsp;During the development of DragonOS, some open-source projects were referenced, or parts of their code were introduced, or they inspired us. Below is a list of these open-source projects. We sincerely thank the contributors of these open-source projects!
+
+Format: <Project Name> - <Link> - <Open Source License>
+
+- Linux - https://git.kernel.org/ - GPLv2
+- skiftOS - https://github.com/skiftOS/skift - MIT
+- FYSOS - https://github.com/fysnet/FYSOS - [FYSOS' License](https://github.com/fysnet/FYSOS/blob/9a8968e3d6600de34539c028c843f4c06d134039/license.txt)
+- LemonOS - https://github.com/LemonOSProject/LemonOS.git - BSD 2-Clause License
+- LZ4 - https://github.com/lz4/lz4 - BSD 2-Clause license
+- SerenityOS - https://github.com/SerenityOS/serenity.git - BSD 2-Clause license
+- MINE - 《A Design and Implementation of a 64-bit Operating System》 by Tian Yu; People's Posts and Telecommunications Press
+- chcore - 《Modern Operating Systems: Design and Implementation》 by Chen Haibo, Xia Yubin; Machinery Industry Press
+- SimpleKernel - https://github.com/Simple-XX/SimpleKernel - MIT
+- rcore-fs - https://github.com/rcore-os/rcore-fs.git - MIT
+- redox - https://gitlab.redox-os.org/redox-os/redox - MIT
+
+## All Commit Records of the Current Version
+
+```text
+commit 84407d360511c7699938a0f245ae33ff76f16b17
+Author: login <longjin@DragonOS.org>
+Date:   Mon Mar 13 00:26:04 2023 +0800
+
+    bugfix：解决touch命令失败的问题 (#199)
+    
+    * bug fix : 解决touch命令失败的问题
+
+commit 004e86ff19727df303c23b42c7a271b9214c6898
+Author: login <longjin@DragonOS.org>
+Date:   Sun Mar 12 22:36:11 2023 +0800
+
+    新版文件系统重构完成 (#198)
+    
+    1.重构：VFS
+    2. 重构：ProcFS
+    3. 重构：DevFS
+    4. 重构：FAT32
+    5. 重构：AHCI驱动
+    6. 新增：RamFS
+    7. 新增：MountFS
+    8. 新增：FAT12
+    9. 新增：FAT16
+    10. 重构：设备抽象
+    
+    Co-authored-by: guanjinquan <1666320330@qq.com>
+    Co-authored-by: DaJiYuQia <88259094+DaJiYuQia@users.noreply.github.com>
+
+commit 17041e0e307eaf9e8d8ddbddfa186cd1f10f1bc0
+Author: login <longjin@DragonOS.org>
+Date:   Sun Mar 12 21:04:37 2023 +0800
+
+    添加rust的bare bone工具链 (#197)
+
+commit 26d84a31393c50063ff416bc509316e8d342028c
+Author: YJwu2023 <119829947+YJwu2023@users.noreply.github.com>
+Date:   Sat Mar 11 21:09:50 2023 +0800
+
+    新增VirtIO网卡驱动 (#194)
+    
+    * 修复内存bug与grub安装脚本的错误
+    
+    * 修改小bug
+    
+    * PCI增加功能与virtio-net驱动
+    
+    * little fix
+    
+    * virtio-net小修改
+
+commit 1d48996375149279a721777b2c600e1b5c3ee1b5
+Author: kong <45937622+kkkkkong@users.noreply.github.com>
+Date:   Sat Mar 11 18:17:35 2023 +0800
+
+    多核负载均衡(#193)
+    
+    * feat(sched)：CPU负载检测初步实现
+    
+    * fix(smp):调整smp中的apic的头文件声明
+    
+    * fix(smp):简单的负载均衡算法实现
+    
+    * fix(sched):抽离负载均衡方法
+    
+    * fix(sched):修改rt中的运行队列bug，调整负载均衡逻辑
+    
+    * fix(process):移除无用测试代码
+    
+    * reformat code
+
+commit ef9f9732b09f78d7192f1d0dd3b41be655fb0914
+Author: houmkh <100781004+houmkh@users.noreply.github.com>
+Date:   Thu Mar 9 23:31:25 2023 +0800
+
+    修复了mmio buddy的bug (#189)
+    
+    * 修改buddy_query
+
+commit c1396d277115b371d09ad6d39a1c419f9224ffd0
+Author: Gou Ngai <sujintao@dragonos.org>
+Date:   Mon Mar 6 11:28:32 2023 +0800
+
+    Rwlock文档 (#186)
+    
+    * Rwlock文档
+
+commit a7eb62a47a8d701b90a14f83cc9028cfed07c268
+Author: houmkh <100781004+houmkh@users.noreply.github.com>
+Date:   Mon Mar 6 11:21:29 2023 +0800
+
+    修改mmio－buddy代码结构和函数名 (#184)
+    
+    * 修改mmio-buddy结构和函数名
+
+commit c2481452f81750ec02adec627ab2edbc93d9cd9c
+Author: houmkh <100781004+houmkh@users.noreply.github.com>
+Date:   Sat Mar 4 18:36:55 2023 +0800
+
+    rust重构mmio_buddy和mmio (#178)
+    
+    * rust重构mmio_buddy和mmio
+    
+    * mmio-buddy文档
+    
+    ---------
+    
+    Co-authored-by: longjin <longjin@RinGoTek.cn>
+
+commit f1284c35717a2f9f8cee7cecfc835ba1d23a1161
+Author: Gou Ngai <sujintao@dragonos.org>
+Date:   Sat Mar 4 17:47:17 2023 +0800
+
+    新增了rust实现的信号量 (#181)
+    
+    * 新增了rust实现的信号量
+    
+    ---------
+    
+    Co-authored-by: longjin <longjin@RinGoTek.cn>
+
+commit 83b9512c1c1e8289000084adcafddebee6a23f16
+Author: Gou Ngai <sujintao@dragonos.org>
+Date:   Sat Mar 4 16:54:42 2023 +0800
+
+    新增了rust实现的信号量 (#183)
+    
+    * 新增了rust实现的信号量
+
+commit e532a536a0b244f4590e6eb7910084bd63049704
+Author: login <longjin@ringotek.cn>
+Date:   Thu Mar 2 22:50:07 2023 +0800
+
+    添加赞助者：FengWangHao (#179)
+
+commit b66beefd4e9ead61ee55f335246ebeb8277d3011
+Author: login <longjin@ringotek.cn>
+Date:   Mon Feb 27 01:00:35 2023 +0800
+
+    解决ubuntu2210版本无法正确编译grub，以及正确安装qemu的问题 (#176)
+
+commit 4177d0327c3eacdc606f0b22f99f208fd48cfff3
+Author: kong <45937622+kkkkkong@users.noreply.github.com>
+Date:   Mon Feb 20 17:03:37 2023 +0800
+
+    RTQueue改用双向链表存储(#174)
+    
+    * RTQueue改用双向链表存储
+
+commit 2bf5ee0e3cac3a91dee6a13b71c86a9477c07d9b
+Author: login <longjin@ringotek.cn>
+Date:   Sat Feb 11 13:04:24 2023 +0800
+
+    修改libc的编译相关内容(#171)
+    
+    1.将libc的include文件夹分为export和internal
+    2.将所有app都直接链接libc.a,而不是都执行一遍"搜索.o"的过程
+
+commit 90b077f9d3ecd48ca46f8bbb32363620db6ddbe6
+Author: kong <45937622+kkkkkong@users.noreply.github.com>
+Date:   Thu Feb 9 15:24:37 2023 +0800
+
+    Sched rt doc (#163)
+    
+    * update
+    
+    * 完善调度器文档
+    
+    * 更新RT调度器文档
+    
+    * 更新实时调度文档
+
+commit 009f92d50fe2e52e425bce397801d3fa204daecd
+Author: Satin Wuker <74630829+SatinWuker@users.noreply.github.com>
+Date:   Tue Feb 7 19:29:09 2023 -0800
+
+    fix typos 改正README_EN的错别字和语法错误 (#167)
+
+```

docs/locales/en/community/ChangeLog/V0.1.x/V0.1.6.md

@@ -0,0 +1,319 @@
+:::{note}
+**AI Translation Notice**
+
+This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+- Source document: community/ChangeLog/V0.1.x/V0.1.6.md
+
+- Translation time: 2025-05-19 01:44:51
+
+- Translation model: `Qwen/Qwen3-8B`
+
+Please report issues via [Community Channel](https://github.com/DragonOS-Community/DragonOS/issues)
+
+:::
+
+# V0.1.6
+
+:::{note}
+Author: Longjin <longjin@DragonOS.org>
+
+April 2, 2023
+:::
+
+## Contributors List
+
+The DragonOS V0.1.6 version was contributed by the following developers:
+
+- Longjin <longjin@DragonOS.org>
+- Guan Jinquan <guanjinquan@DragonOS.org>
+- Su Jintao <sujintao@DragonOS.org>
+- Hou Jiaying <houjiaying@DragonOS.org>
+- Wu Yujian <wuyujian@DragonOS.org>
+- Mork <91721145+MorkCarpenter@users.noreply.github.com>
+- WaferJay <17383312+WaferJay@users.noreply.github.com>
+- HoshuChiu <129569557+HoshuChiu@users.noreply.github.com>
+
+## Sponsors List
+
+Thank you to the following individuals for their support. We will continue to strive for excellence!
+
+- Wan Xiaolan
+- David Wen
+- [Seele.Clover](https://github.com/seeleclover)
+- [FindWangHao](https://github.com/FindWangHao)
+- Ye Jinyi
+- Lin
+- Albert
+- [TerryLeeSCUT · GitHub](https://github.com/TerryLeeSCUT)
+- slientbard
+- Wu
+- Anonymous Kind-hearted Person
+
+## Update Content - Kernel
+
+- softirq: Refactored softirq (#_translated_label__223_en)
+- timer: Refactored system timer (#_translated_label__223_en)
+- stdio: Added tty device for standard input and output (#_translated_label__202_en) (#_translated_label__217_en)
+- lib: First set of keyboard scan code state machine (#_translated_label__216_en) (#_translated_label__219_en)
+- syscall: Added dup and dup2 system calls (#_translated_label__224_en)
+- syscall: Added SystemError enum type to make error handling clearer (#_translated_label__205_en)
+- driver: Added support for x87 floating-point processor (#_translated_label__212_en)
+- driver: VirtIO network card can now send and receive data normally (#_translated_label__204_en)
+- filesystem: Fixed FAT32 judgment logic, resolving the issue where the system could not boot normally when the file system was FAT12/16. (#_translated_label__211_en)
+- filesystem: Added VFS document and modified document configuration (#_translated_label__209_en)
+- textui: Fixed the issue where the process scheduler did not run when "processes output characters continuously" due to textui locking and changes in preempt_count. (#_translated_label__203_en)
+- scheduler: Solved the issue of double locking in cpu_queue caused by not disabling interrupts during sched_enqueue outside of interrupt context. (#_translated_label__201_en)
+
+## Update Content - User Environment
+
+### New Repositories
+
+- Added a sub-project: [dsc](https://github.com/DragonOS-Community/dsc.git)
+- Transplanted relic: [DragonOS-relibc](https://github.com/DragonOS-Community/relibc.git)
+
+## Update Content - Others
+
+- build: Added an option for using VNC as the image output for QEMU (#_translated_label__222_en)
+
+## Update Content - Software Porting
+
+None
+
+## Source Code and Release Image Download
+
+&emsp;&emsp;You can obtain the source code through the following methods:
+
+### Get via Git
+
+- You can download the release code and the compiled, runnable disk image from [https://github.com/DragonOS-Community/DragonOS/releases](https://github.com/DragonOS-Community/DragonOS/releases).
+- We also have a mirror repository on gitee for download: [https://gitee.com/DragonOS/DragonOS](https://gitee.com/DragonOS/DragonOS)
+
+### Get via DragonOS Software Mirror Site
+
+&emsp;&emsp;To address the slow and unstable access to GitHub in China, and to make it convenient for developers to download the code for each version of DragonOS, we have specially set up a mirror site. You can access the mirror site through the following address:
+
+&emsp;&emsp;You can obtain the DragonOS source code archive and the compiled, runnable disk image through the mirror site.
+
+- [https://mirrors.DragonOS.org](https://mirrors.DragonOS.org)
+- [https://mirrors.DragonOS.org.cn](https://mirrors.DragonOS.org.cn)
+- Domestic mirror acceleration: [https://mirrors.ringotek.cn/](https://mirrors.ringotek.cn/)
+
+## Open Source Declaration
+
+:::{note}
+To promote the healthy development of the DragonOS project, DragonOS is released under the GPLv2 open source license. Anyone who can obtain the DragonOS source code and corresponding software products (including but not limited to binary copies and documentation) can enjoy the rights granted by us through the GPLv2 protocol, while you also need to comply with the obligations stipulated in the protocol.
+
+This is a rather strict protocol that protects the healthy development of open source software and prevents it from being encroached upon.
+
+For most well-intentioned people, you will not violate our open source license.
+
+We encourage the free dissemination and promotion of DragonOS, but please ensure that all actions do not infringe on the legitimate rights and interests of others or violate the GPLv2 protocol.
+
+Please pay special attention to the fact that violations of the open source license, especially **commercial closed-source usage and any acts of plagiarism or academic misconduct**, will be subject to serious accountability. (This is the most common scenario of violating our open source license.)
+
+Also, please note that according to the requirements of the GPLv2 protocol, any software modified or developed based on DragonOS must also be open-sourced under the GPLv2 protocol and must indicate that it is based on DragonOS. It is also necessary to ensure that users of these modified versions can easily access the original version of DragonOS.
+
+You must make sure that the DragonOS developers can obtain the source code of your modified version through public channels in the same way, otherwise you will violate the GPLv2 protocol.
+
+For detailed information about the protocol, please read the **LICENSE** file in the root directory of the project. Please note that according to the requirements of the GPLv2 protocol, **only the English original version has legal effect**. Any translated version is for reference only.
+:::
+
+### Usage of Open Source Software
+
+&emsp;&emsp;During the development of DragonOS, some open source projects were referenced, or parts of their code were introduced, or they inspired us. The following list shows them. We sincerely thank the contributors of these open source projects!
+
+Format: <Project Name> - <Link> - <Open Source License>
+
+- Linux - https://git.kernel.org/ - GPLv2
+- skiftOS - https://github.com/skiftOS/skift - MIT
+- FYSOS - https://github.com/fysnet/FYSOS - [FYSOS' License](https://github.com/fysnet/FYSOS/blob/9a8968e3d6600de34539c028c843f4c06d134039/license.txt)
+- LemonOS - https://github.com/LemonOSProject/LemonOS.git - BSD 2-Clause License
+- LZ4 - https://github.com/lz4/lz4 - BSD 2-Clause license
+- SerenityOS - https://github.com/SerenityOS/serenity.git - BSD 2-Clause license
+- MINE - "Design and Implementation of a 64-bit Operating System" by Tian Yu; People's Posts and Telecommunications Press
+- chcore - "Modern Operating Systems: Design and Implementation" by Chen Haibo and Xia Yubin; Machinery Industry Press
+- SimpleKernel - https://github.com/Simple-XX/SimpleKernel - MIT
+- rcore-fs - https://github.com/rcore-os/rcore-fs.git - MIT
+- redox - https://gitlab.redox-os.org/redox-os/redox - MIT
+
+## All Commit Records of the Current Version
+
+```text
+commit bacd691c9ef0502b5cc618aad50517f9e59df5e0
+Author: login <longjin@DragonOS.org>
+Date:   Sun Apr 2 17:09:33 2023 +0800
+
+    软中断&定时器重构 (#223)
+    
+    * 软中断&定时器重构
+    
+    Co-authored-by: houmkh<houjiaying@DragonOS.org>
+    
+    * 修改timer的clock()
+    
+    * 删除debug信息
+    
+    ---------
+    
+    Co-authored-by: houmkh <1119644616@qq.com>
+
+commit 6d345b774223b0daaf0ee629c7fb595a1912a9e2
+Author: HoshuChiu <129569557+HoshuChiu@users.noreply.github.com>
+Date:   Sun Apr 2 15:55:24 2023 +0800
+
+    添加了qemu使用VNC作为图像输出的选项 (#222)
+    
+    * 添加了qemu使用VNC作为图像输出的选项
+    
+    * 设置vnc端口为5900
+    
+    ---------
+    
+    Co-authored-by: longjin <longjin@RinGoTek.cn>
+
+commit 2b771e32f5795e0fdda458e3bb2651ef6b9673ac
+Author: Gou Ngai <sujintao@dragonos.org>
+Date:   Sun Apr 2 15:43:53 2023 +0800
+
+    Add dup,dup2 (#224)
+    
+    * dup,dup2
+    
+    * fix: sys_dup2语义与posix不一致的问题
+    
+    ---------
+    
+    Co-authored-by: longjin <longjin@RinGoTek.cn>
+
+commit d7b31a969ff091224a4929496f0278d024f78c77
+Author: Gou Ngai <sujintao@dragonos.org>
+Date:   Fri Mar 31 18:23:58 2023 +0800
+
+    Patch keyboard capslock alt (#219)
+    
+    * keyboard-alt-capslock
+    
+    * 解决键盘输入'%'字符的时候无法回显的bug
+    
+    ---------
+    
+    Co-authored-by: longjin <longjin@RinGoTek.cn>
+
+commit 20e3152e1eea97f87d644c3023391e172bc83c93
+Author: login <longjin@DragonOS.org>
+Date:   Fri Mar 31 12:54:37 2023 +0800
+
+    将TTY与stdio进行连接,实现基本的stdio功能 (#217)
+    
+    * 将stdio与tty接上
+
+commit 5fb12ce447710edf8566f250655a06cb27519fca
+Author: Gou Ngai <sujintao@dragonos.org>
+Date:   Thu Mar 30 18:19:02 2023 +0800
+
+    第一套键盘扫描码的状态机 (#216)
+    
+    第一套键盘扫描码的状态机
+    ---------
+    
+    Co-authored-by: guanjinquan <1666320330@qq.com>
+    Co-authored-by: longjin <longjin@RinGoTek.cn>
+
+commit 676b8ef62e1a0a1e52d65b40c53c1636a2954040
+Author: Mork <91721145+MorkCarpenter@users.noreply.github.com>
+Date:   Wed Mar 29 21:24:11 2023 +0800
+
+    部分函数从返回值为Result<<>,i32>修改为Result<<>,SystemError> (#210)
+    
+    * 将Result<<>,i32>替换为Result<<>,SystemError>
+    * bugfix: 显示双缓冲区初始化的时候，连续注册了两次Video Softirq的问题。
+    
+    Co-authored-by: longjin <longjin@RinGoTek.cn>
+
+commit 64aea4b3494bee7375e1c1ee5739c9fab0db0cb7
+Author: Gou Ngai <sujintao@dragonos.org>
+Date:   Tue Mar 28 20:44:26 2023 +0800
+
+    增加x87FPU支持 (#212)
+    
+    * remove `ret_from_syscall`
+    *修复ps2键盘驱动程序inode在进程fork的时候导致死锁的问题.
+    *更新: VFS每次拷贝文件描述符的时候,都会去调用inode的open函数
+    
+    ---------
+    
+    Co-authored-by: longjin <longjin@RinGoTek.cn>
+
+commit 2286eda6526ed1b46afd79b47dc701034b9e903d
+Author: WaferJay <17383312+WaferJay@users.noreply.github.com>
+Date:   Mon Mar 27 09:32:43 2023 +0800
+
+    修正了FAT32判断逻辑，解决了文件系统为FAT12/16时系统无法正常启动的问题。 (#211)
+    
+    * fix(fat): fix determination of fat type casue crash if fs is fat12/16
+    
+    * refactor(fat): split BiosParameterBlock.validate() into BiosParameterBlockFAT32.validate() and BiosParameterBlockLegacy.validate()
+    
+    * 调整“最大允许的簇号”的常量放置的位置。
+    
+    ---------
+    
+    Co-authored-by: longjin <longjin@RinGoTek.cn>
+
+commit 45b8371173b070028457f7ee64be33f68b4f9ada
+Author: login <longjin@DragonOS.org>
+Date:   Sat Mar 25 14:51:16 2023 +0800
+
+    新增VFS文档，以及修改文档配置 (#209)
+    
+    * 1.新增vfs设计文档
+    2.修改文档版权标志为"2022-2023, DragonOS Community"
+    3.修改电脑版文档页面的宽度为90%
+    
+    * layout.html末尾加空行
+
+commit 73c607aaddf6e4634cad179a81d3f1bc589f7220
+Author: YJwu2023 <119829947+YJwu2023@users.noreply.github.com>
+Date:   Sat Mar 18 20:43:37 2023 +0800
+
+    VirtIO网卡能够正常发送、接收数据 (#204)
+    
+    * virtio-net小修改
+    
+    * 移动volatile.rs到libs文件夹
+    
+    * 使用virtio-drivers 0.3.0
+    
+    * bugfix: 初始化BAR之后，未正确设置command register的问题
+    
+    
+    ---------
+    
+    Co-authored-by: longjin <longjin@dragonos.org>
+
+commit 4454d1a2dd1f1078750151c028a794cfd9a04a1b
+Author: login <longjin@DragonOS.org>
+Date:   Sat Mar 18 20:26:05 2023 +0800
+
+    新增SystemError枚举类型，使得错误处理更清晰 (#205)
+
+commit 0d48c3c9c21a2dd470d0e1e58b507db60e0887bb
+Author: login <longjin@DragonOS.org>
+Date:   Thu Mar 16 19:48:59 2023 +0800
+
+    new: tty设备（尚未与stdio接上） (#202)
+
+commit 790d45764090bce3bbfb96b42b2818100a8cef9a
+Author: login <longjin@DragonOS.org>
+Date:   Wed Mar 15 11:42:41 2023 +0800
+
+    修复由于textui加锁，更改了preempt_count导致“进程长时间连续输出字符”的情况下，进程调度器不运行的问题。 (#203)
+
+commit c2e757d8cbeed01b16f48bea48ed8447685e6f1a
+Author: login <longjin@DragonOS.org>
+Date:   Mon Mar 13 22:22:23 2023 +0800
+
+    解决由于在中断上下文以外，sched_enqueue时，未关中断导致cpu_queue双重加锁的问题 (#201)
+
+```

docs/locales/en/community/ChangeLog/V0.1.x/V0.1.7.md

@@ -0,0 +1,359 @@
+:::{note}
+**AI Translation Notice**
+
+This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+- Source document: community/ChangeLog/V0.1.x/V0.1.7.md
+
+- Translation time: 2025-05-19 01:43:50
+
+- Translation model: `Qwen/Qwen3-8B`
+
+Please report issues via [Community Channel](https://github.com/DragonOS-Community/DragonOS/issues)
+
+:::
+
+# V0.1.7
+
+:::{note}
+Author: Longjin <longjin@DragonOS.org>
+
+April 24, 2023
+:::
+
+## Contributors List
+
+The DragonOS V0.1.7 version was contributed by the following contributors:
+
+- Longjin <longjin@DragonOS.org>
+- Guan Jinquan <guanjinquan@DragonOS.org>
+- Huang Ting <huangting@DragonOS.org>
+- Hou Jiaying <houjiaying@DragonOS.org>
+- Wu Yujian <wuyujian@DragonOS.org>
+- Su Jintao <sujintao@DragonOS.org>
+- Zhou Hanjie <zhouhanjie@DragonOS.org>
+- HoshuChiu <129569557+HoshuChiu@users.noreply.github.com>
+- Bullet <93781792+GP-Bullet@users.noreply.github.com>
+
+## Sponsors List
+
+Thank you to the following individuals for their support. We will continue to work hard!
+
+- Wan Xiaolan
+- David Wen
+- [Seele.Clover](https://github.com/seeleclover)
+- [FindWangHao](https://github.com/FindWangHao)
+- [ferchiel](https://github.com/ferchiel)
+- Ye Jinyi
+- Lin
+- Albert
+- [TerryLeeSCUT · GitHub](https://github.com/TerryLeeSCUT)
+- slientbard
+- Wu
+- Anonymous Kind-hearted Person
+
+## Update Content - Kernel
+
+- scheduler: Change CFSqueue from Vec to Red-Black Tree (#_translated_label__229_en)
+- new: lazy_init (#_translated_label__230_en) (#_translated_label__236_en)
+- pci: pci restructure + pcie support (#_translated_label__235_en)
+- net: Add network subsystem, and support programming in user space (#_translated_label__237_en) (#_translated_label__247_en)
+- mm: Adjust brk system call to make parameters and return values consistent with Linux (#_translated_label__238_en)
+- Modify errno to be consistent with relicb (#_translated_label__234_en)
+- pci: Fix the issue of not being able to get MCFG table with ecam (#_translated_label__241_en)
+- libs: DowncastArc and its docs (#_translated_label__244_en)
+- softirq: Add timer and softirq documentation, modify the C-oriented interface of softirq (#_translated_label__245_en)
+- spinlock: Fix the issue of forgetting to restore rflags in spinlock (#_translated_label__247_en)
+- waitqueue: Add wakeup_all and sleep_without_schedule functions (#_translated_label__247_en)(#_translated_label__253_en)
+- filesystem: Change the PollStatus structure to use the bitflags library (#_translated_label__247_en)
+- filesystem: Add iovec support (brute-force implementation) (#_translated_label__247_en)
+- filesystem: Add SysFS (#_translated_label__250_en) (#_translated_label__254_en)
+- driver: Improve device driver model according to sysfs (#_translated_label__254_en)
+- pipe: Pipe restructure (#_translated_label__253_en)
+- irq: Add IrqArch abstraction and IrqFlagsGuard to simplify the process of disabling and restoring interrupts (#_translated_label__253_en)
+
+## Update Content - User Environment
+
+### New Repositories
+
+- New subproject: [dsc](https://github.com/DragonOS-Community/dsc.git)
+- New subproject: [DADK](https://github.com/DragonOS-Community/DADK.git) DragonOS Application Development Kit
+
+### [DragonOS-relibc](https://github.com/DragonOS-Community/relibc.git)
+
+- Add sys_dup and sys_dup2 support (#_translated_label__2_en)
+- Add the original libc memory allocator, fix alignment issues. (#_translated_label__6_en) (#_translated_label__7_en)
+- Configure network-related system calls (#_translated_label__8_en)
+- Fix the issue of errno not working properly due to DragonOS not supporting TLS (thread local storage). (#_translated_label__8_en)
+
+## Update Content - Others
+
+- build: Fix Issue#220; restore VNC port number to 5900 (#_translated_label__243_en)
+- bootstrap: Solve the problem of not being able to directly use the one-click initialization script for installation when using zsh to build DragonOS (#_translated_label__252_en)
+
+## Update Content - Software Porting
+
+None
+
+## Source Code and Release Image Download
+
+&emsp;&emsp;You can obtain the source code through the following ways:
+
+### Get via Git
+
+- You can visit [https://github.com/DragonOS-Community/DragonOS/releases](https://github.com/DragonOS-Community/DragonOS/releases) to download the release code and the compiled, runnable disk image.
+- We also have a mirror repository on gitee for download: [https://gitee.com/DragonOS/DragonOS](https://gitee.com/DragonOS/DragonOS)
+
+### Get via DragonOS Software Mirror Site
+
+&emsp;&emsp;To solve the problem of slow and unstable access to GitHub in China, and to make it convenient for developers to download the code of each version of DragonOS, we have specially set up a mirror site. You can access the mirror site through the following address:
+
+&emsp;&emsp;You can get the compressed package of DragonOS code and the compiled, runnable disk image through the mirror site.
+
+- [https://mirrors.DragonOS.org](https://mirrors.DragonOS.org)
+- [https://mirrors.DragonOS.org.cn](https://mirrors.DragonOS.org.cn)
+- Domestic mirror acceleration: [https://mirrors.ringotek.cn/](https://mirrors.ringotek.cn/)
+
+## Open Source Declaration
+
+:::{note}
+To promote the healthy development of the DragonOS project, DragonOS is released under the GPLv2 open source license. Anyone who can obtain the source code of DragonOS and the corresponding software products (including but not limited to binary copies and documents) can enjoy the rights granted by us through the GPLv2 license, and you must also comply with the obligations stipulated in the agreement.
+
+This is a rather strict license that protects the healthy development of open source software and prevents it from being encroached upon.
+
+For most well-intentioned people, you will not violate our open source license.
+
+We encourage the free dissemination and promotion of DragonOS, but please ensure that all actions do not infringe on the legitimate rights and interests of others or violate the GPLv2 license.
+
+Please pay special attention to the fact that violations of the open source license, especially **commercial closed-source use and any acts of plagiarism or academic misconduct**, will be subject to serious accountability. (This is the most common scenario where the open source license is violated.)
+
+Also, please note that according to the requirements of the GPLv2 license, any software modified or developed based on DragonOS must also be open-sourced under the GPLv2 license and must indicate that it is based on DragonOS. It is also necessary to ensure that users of these modified versions can easily obtain the original version of DragonOS.
+
+You must make it possible for the developers of DragonOS to obtain the source code of your modified version through the same way from public channels, otherwise you will violate the GPLv2 license.
+
+For detailed information about the license, please read the **LICENSE** file in the root directory of the project. Please note that according to the requirements of the GPLv2 license, **only the English original version has legal effect**. Any translated version is for reference only.
+:::
+
+### Usage of Open Source Software
+
+&emsp;&emsp;During the development of DragonOS, some open source projects' designs were referenced, or parts of their code were introduced, or they were inspired by them. The following list shows them. We sincerely thank the contributors of these open source projects!
+
+Format: <Project Name> - <Link> - <Open Source License>
+
+- Linux - https://git.kernel.org/ - GPLv2
+- skiftOS - https://github.com/skiftOS/skift - MIT
+- FYSOS - https://github.com/fysnet/FYSOS - [FYSOS' License](https://github.com/fysnet/FYSOS/blob/9a8968e3d6600de34539c028c843f4c06d134039/license.txt)
+- LemonOS - https://github.com/LemonOSProject/LemonOS.git - BSD 2-Clause License
+- LZ4 - https://github.com/lz4/lz4 - BSD 2-Clause license
+- SerenityOS - https://github.com/SerenityOS/serenity.git - BSD 2-Clause license
+- MINE - "A Design and Implementation of a 64-bit Operating System" by Tian Yu; People's Posts and Telecommunications Press
+- chcore - "Modern Operating Systems: Design and Implementation" by Chen Haibo, Xia Yubin; Machinery Industry Press
+- SimpleKernel - https://github.com/Simple-XX/SimpleKernel - MIT
+- rcore-fs - https://github.com/rcore-os/rcore-fs.git - MIT
+- redox - https://gitlab.redox-os.org/redox-os/redox - MIT
+
+## All Commit Records of the Current Version
+
+```text
+commit e0de0fd6a52199753a3127cfbb5d12f0a1555aae
+Author: TingHuang <92705854+TingSHub@users.noreply.github.com>
+Date:   Sun Apr 23 22:55:57 2023 +0800
+
+    根据sysfs完善设备驱动模型 & 添加sysfs官方文档 (#254)
+    
+    * 根据sysfs完善设备驱动模型
+    
+    * 添加sysfs官方文档
+
+commit f678331a3315b7847f08ab32b42d5bf49a9f3a6a
+Author: hanjiezhou <zhouhanjie@dragonos.org>
+Date:   Sun Apr 23 21:05:10 2023 +0800
+
+    匿名管道重构&增加IrqArch trait以及IrqFlags及其守卫 (#253)
+    
+    * 实现匿名管道
+    
+    * 增加IrqArch trait以及IrqFlags及其守卫
+    
+    ---------
+    
+    Co-authored-by: longjin <longjin@RinGoTek.cn>
+
+commit 8a1e95abb5e4df5e872bb452efc26c9e9631157d
+Author: Bullet <93781792+GP-Bullet@users.noreply.github.com>
+Date:   Fri Apr 21 23:36:54 2023 +0800
+
+    解决使用zsh在构建DragonOS时，无法直接使用一键初始化脚本进行安装的问题  (#252)
+
+commit dd9f1fc1a42406461e6f0d38cce1e56e22a1a15f
+Author: TingHuang <92705854+TingSHub@users.noreply.github.com>
+Date:   Fri Apr 21 16:03:42 2023 +0800
+
+    新增SysFS (#250)
+    
+    * 添加sysfs
+    
+    * 注册sysfs
+    
+    * 添加sysfs相关
+    
+    * 添加rust-anlyzer辅助配置
+    
+    * 将设备与sysfs相关联
+    
+    * 添加单独的文件管理sysfs下的文件夹
+
+commit cde5492f725681ed89abe1e6eb088e05d943d793
+Author: login <longjin@DragonOS.org>
+Date:   Wed Apr 19 18:05:02 2023 +0800
+
+    新增网络socket的系统调用接口 (#247)
+    
+    1.修复spinlock忘记恢复rflags的问题
+    2.WaitQueue增加wakeup_all的功能
+    3.完善tcp,udp,raw socket
+    4.把PollStatus结构体改为使用bitflags
+    5.新增iovec结构体
+    6.完成网络的系统调用
+    7.在bootstrap里面添加dnsmasq bridge-utils iptables
+    
+    ---------
+    
+    Co-authored-by: guanjinquan <1666320330@qq.com>
+
+commit 8fd71f277271ae68e648f290c67f187b030feae0
+Author: houmkh <1119644616@qq.com>
+Date:   Mon Apr 17 17:17:06 2023 +0800
+
+    增加定时器和软中断文档，修改了softirq面向c的接口 (#245)
+    
+    * 增加定时器和软中断文档
+    
+    * 修改softirq对c的接口和文档
+    
+    * 修改文档格式
+
+commit 77c928f6ce3192c79ea42ab7bcba2713e289f73b
+Author: login <longjin@DragonOS.org>
+Date:   Sun Apr 16 20:29:04 2023 +0800
+
+    new: DowncastArc and its docs (#244)
+
+commit 7149abaa49a4ca70f0e42ad3b61fdfd6a941a092
+Author: HoshuChiu <129569557+HoshuChiu@users.noreply.github.com>
+Date:   Sun Apr 16 14:47:51 2023 +0800
+
+    修复Issue#220；vnc的端口号恢复5900 (#243)
+    
+    
+    * 修复Issue#220
+    
+    * qemu-vnc端口号恢复为5900
+
+commit 5c1e552cc7f0a6ad75c8a1fa2928e3b9cc619657
+Author: YJwu2023 <yujianwu2019@gmail.com>
+Date:   Fri Apr 14 12:21:08 2023 +0800
+
+    修复ecam无法获取MCFG table的问题 (#241)
+
+commit 79a452ce8f27ad9c7283ac0bcf4078ed6fa018d7
+Author: houmkh <1119644616@qq.com>
+Date:   Tue Apr 11 17:05:33 2023 +0800
+
+    修改errno,使其与relibc的保持一致 (#234)
+    
+    修改errno,使其与relibc的保持一致
+
+commit ac48398d3f17f24ff9b5da5e400ce912d05f0ba2
+Author: login <longjin@DragonOS.org>
+Date:   Tue Apr 11 16:54:14 2023 +0800
+
+    调整brk系统调用，使得参数、返回值与Linux一致 (#238)
+    
+    * 新增用于测试relibc的app
+    
+    * 为适配relibc,修改do_execve中关于用户栈的内容的设置
+    
+    * 调整brk系统调用，使得参数、返回值与Linux一致
+
+commit 13776c114b15c406b1e0aaeeb71812ea6e471d2e
+Author: login <longjin@DragonOS.org>
+Date:   Mon Apr 10 20:22:39 2023 +0800
+
+    增加对dhcpv4的支持（tcp、udp socket已写好，但由于缺少epoll机制，尚未完整测试） (#237)
+    
+    * 为virtio网卡完成smoltcp的phy层配置
+    
+    * raw socket
+    
+    * 初步写完udp和tcp socket
+    
+    * 能够正常通过dhcp获取ipv4地址（具有全局iface btree)
+    
+    ---------
+    
+    Co-authored-by: guanjinquan <1666320330@qq.com>
+
+commit 78bf93f02f84bf5e024ddfb559f040e68ce39ccf
+Author: YJwu2023 <yujianwu2019@gmail.com>
+Date:   Sun Apr 9 12:30:02 2023 +0800
+
+    pci重构+pcie支持 (#235)
+    
+    * pci重构+pcie支持
+    
+    * pci重构测试完成
+    
+    * 修正makefile的问题
+    
+    * 小修改
+    
+    * 修改函数名字
+
+commit 5c9a63df836eedaca33c8c4c600b7aaeb2caf9a6
+Author: login <longjin@DragonOS.org>
+Date:   Sat Apr 8 23:53:53 2023 +0800
+
+    Patch add lazy init (#236)
+    
+    * 修正并发安全问题
+
+commit 766127209ee49465a8086cfd0bec90d8b79a96c0
+Author: login <longjin@DragonOS.org>
+Date:   Thu Apr 6 19:01:30 2023 +0800
+
+    new: lazy_init (#230)
+
+commit e0dfd4d5d70d1b50fc7ad3ed4bf84b7ba6dad19d
+Author: hanjiezhou <zhouhanjie@dragonos.org>
+Date:   Thu Apr 6 00:50:14 2023 +0800
+
+    修改CFSqueue从Vec变成红黑树 (#229)
+    
+    使用了由tickbh编写的rbtree： https://github.com/tickbh/rbtree-rs/blob/master/src/lib.rs
+    
+    Co-authored-by: tickbh <tickdream125@hotmail.com>
+
+commit 2a7d773d3d39f1cb3d59d6baa817c896c6fd52d1
+Author: TingHuang <92705854+TingSHub@users.noreply.github.com>
+Date:   Wed Apr 5 13:02:05 2023 +0800
+
+    新增设备驱动模型，为设备和驱动提供高层视图 (#227)
+    
+    * 添加base mod
+    
+    * 添加设备驱动模型相关文件
+    
+    * 删除单独的mod文件，使用mod.rs，修改一些格式上的问题
+    
+    * 移动驱动错误类型到该文件
+    
+    * 修改一些格式上的问题
+
+commit 5d00b1852818dd4b25952fd6a30deb20e7c7df53
+Author: login <longjin@DragonOS.org>
+Date:   Wed Apr 5 00:53:35 2023 +0800
+
+    修复显示刷新线程的空指针问题 (#228)
+
+```

docs/locales/en/community/ChangeLog/V0.1.x/V0.1.8.md

@@ -0,0 +1,570 @@
+:::{note}
+**AI Translation Notice**
+
+This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+- Source document: community/ChangeLog/V0.1.x/V0.1.8.md
+
+- Translation time: 2025-05-19 01:43:47
+
+- Translation model: `Qwen/Qwen3-8B`
+
+Please report issues via [Community Channel](https://github.com/DragonOS-Community/DragonOS/issues)
+
+:::
+
+# V0.1.8
+
+:::{note}
+Author: Long Jin <longjin@DragonOS.org>
+
+August 16, 2023
+:::
+
+## Contributors
+
+The DragonOS V0.1.8 version was contributed by the following developers:
+
+- Long Jin <longjin@DragonOS.org>
+- Hou Jiaying <houjiaying@DragonOS.org>
+- Wu Yujian <wuyujian@DragonOS.org>
+- Huang Ting <huangting@DragonOS.org>
+- Kong Weichao <kongweichao@DragonOS.org>
+- Cai Jiaxin <caijiaxin@DragonOS.org>
+- Chi Kejin <chikejhian@DragonOS.org>
+- zhaoyao73 <dragonlinux@gmail.com>
+- Zhou Hanjie <zhouhanjie@DragonOS.org>
+- Bullet <93781792+GP-Bullet@users.noreply.github.com>
+- Sakura Momoka <89176634+TihayaKousaka@users.noreply.github.com>
+- Tptogiar <2528891112@qq.com>
+
+## Sponsors
+
+Thank you to the following contributors for their support. We will continue to work hard!
+
+- Wan Xiaolan
+- David Wen
+- [Seele.Clover](https://github.com/seeleclover)
+- [FindWangHao](https://github.com/FindWangHao)
+- [ferchiel](https://github.com/ferchiel)
+- Ye Jinyi
+- Lin
+- Albert
+- [TerryLeeSCUT · GitHub](https://github.com/TerryLeeSCUT)
+- slientbard
+- Wu
+- Anonymous enthusiastic person
+
+## Update Content - Kernel
+
+### New Features
+
+- refactor: Refactor system call module (#_translated_label__267_en)
+- feature: Add AlignBox and int_like macros (#_translated_label__272_en)
+- refactor: Rewrite new IPI function & kick_cpu function (#_translated_label__274_en)
+- feature: Implement gettimeofday() system call and clocksource+timekeeping sub-module (#_translated_label__278_en)
+- refactor: Reconstruct PCI device interrupts and remove USB-related code (#_translated_label__285_en)
+- feature: Register serial device, create character device framework (#_translated_label__290_en)
+- refactor: New memory management module (#_translated_label__303_en)
+- feature: New binary loader, elf parser (#_translated_label__303_en)
+- feature: Add ListenTable to detect port occupation (#_translated_label__291_en)
+- feature: Replace local_irq_save with IrqFlagsGuard implementation (#_translated_label__317_en)
+- feature: Implement system call Fstat (#_translated_label__295_en)
+- feature: Implement kernel notifier chain (#_translated_label__316_en)
+- feature: Add fcntl system call (#_translated_label__323_en)
+- feature: Add support for per CPU variables (#_translated_label__327_en)
+- feature: Spinlock guard adds leak, spinlock adds force unlock function (#_translated_label__329_en)
+
+### Bug Fixes
+
+- bugfix: Fix the issue of not being able to read stdin normally (#_translated_label__264_en)
+- bugfix: Fix the memory overflow problem when the buffer address passed to the AHCI driver is a user buffer (temporarily solved by allocating a kernel buffer) (#_translated_label__265_en)
+- bugfix: Solve the bug caused by the improper assembly of local_irq_save and local_irq_restore functions affecting stack behavior (#_translated_label__303_en)
+- bugfix: Solve the error of local_irq_save not disabling interrupts (#_translated_label__303_en)
+- bugfix: Solve the error in arch_try_cmpxchg for pointer handling (#_translated_label__307_en)
+- bugfix: Fix the exception error in wait4 (#_translated_label__312_en)
+- bugfix: Fix the issue of null device and zero device not being able to open and not behaving as expected (#_translated_label__314_en)
+- bugfix: Fix the bug in FAT file system not correctly extending file size (#_translated_label__323_en)
+- bugfix: Fix the use after free issue caused by not using ManuallyDrop in some places of rwlock (#_translated_label__329_en)
+
+## Update Content - User Environment
+
+### New Features
+
+- feature: Add new HTTP server (#_translated_label__265_en)
+
+### Bug Fixes
+
+- bugfix: Solve the issue of the init segment linking error caused by crt*.o not being sorted in ascending order during linking (#_translated_label__265_en)
+
+## Update Content - Others
+
+- bugfix: Fix the toolchain and resolve errors caused by the new Rust compiler (#_translated_label__258_en)
+- feature: Makefile: Add make help command in the root directory (#_translated_label__271_en)
+- doc: Update GitHub issue template (#_translated_label__277_en)
+- bugfix: Fix the issue where the relibc header file could not recognize the __dragonos__ definition (#_translated_label__315_en)
+- feature: Set the remote for the kernel and relibc to the DragonOS Git mirror site to prevent compilation failure due to domestic network issues (#_translated_label__318_en)
+- feature: Automatic installation and update of dadk (#_translated_label__319_en)
+
+## Update Content - Software Porting
+
+- feature: Ported sqlite3 (#_translated_label__323_en)
+
+## Source Code and Release Mirror Download
+
+&emsp;&emsp;You can obtain the source code through the following methods:
+
+### Get via Git
+
+- You can visit [https://github.com/DragonOS-Community/DragonOS/releases](https://github.com/DragonOS-Community/DragonOS/releases) to download the source code of the release version, as well as the compiled and runnable disk image.
+- We also have a mirror repository on Gitee for download: [https://gitee.com/DragonOS/DragonOS](https://gitee.com/DragonOS/DragonOS)
+
+### Get via DragonOS Software Mirror Site
+
+&emsp;&emsp;To address the slow and unstable access to GitHub in China, and to make it convenient for developers to download the source code of each version of DragonOS, we have specially set up a mirror site. You can access the mirror site through the following address:
+
+&emsp;&emsp;You can obtain the source code package and the compiled and runnable disk image of DragonOS through the mirror site.
+
+- [https://mirrors.DragonOS.org](https://mirrors.DragonOS.org)
+- [https://git.mirrors.DragonOS.org](https://git.mirrors.DragonOS.org)
+- Domestic mirror acceleration: [https://mirrors.ringotek.cn/](https://mirrors.ringotek.cn/)
+
+## Open Source Declaration
+
+:::{note}
+To promote the healthy development of the DragonOS project, DragonOS is released under the GPLv2 open source license. Anyone who can obtain the source code of DragonOS and the corresponding software products (including but not limited to binary copies and documentation) will enjoy the rights granted by us through the GPLv2 license, and you must also comply with the obligations stipulated in the license.
+
+This is a very strict license that protects the healthy development of open source software and prevents it from being infringed.
+
+For most people with good intentions, you will not violate our open source license.
+
+We encourage the free dissemination and promotion of DragonOS, but please ensure that all actions do not infringe on the legitimate rights and interests of others and do not violate the GPLv2 license.
+
+Please pay special attention to the fact that violations of the open source license, especially **commercial closed-source use and any plagiarism or academic misconduct**, will be subject to serious accountability. (This is the easiest scenario to violate our open source license.)
+
+Also, please note that according to the requirements of the GPLv2 license, any software modified or developed based on DragonOS must also be open-sourced under the GPLv2 license and must indicate that it is based on DragonOS. It must also ensure that users of these modified versions can easily obtain the original version of DragonOS.
+
+You must ensure that the developers of DragonOS can obtain the source code of your modified version through the same way from public channels. Otherwise, you will violate the GPLv2 license.
+
+For detailed information about the license, please read the **LICENSE** file in the root directory of the project. Please note that according to the requirements of the GPLv2 license, **only the English original version has legal effect**. Any translated version is for reference only.
+:::
+
+### Usage of Open Source Software
+
+&emsp;&emsp;During the development of DragonOS, some open source projects were referenced, or parts of their code were introduced, or they were inspired by them. The following list shows them. We sincerely thank the contributors of these open source projects!
+
+Format: <Project Name> - <Link> - <Open Source License>
+
+- Linux - https://git.kernel.org/ - GPLv2
+- skiftOS - https://github.com/skiftOS/skift - MIT
+- FYSOS - https://github.com/fysnet/FYSOS - [FYSOS' License](https://github.com/fysnet/FYSOS/blob/9a8968e3d6600de34539c028c843f4c06d134039/license.txt)
+- LemonOS - https://github.com/LemonOSProject/LemonOS.git - BSD 2-Clause License
+- LZ4 - https://github.com/lz4/lz4 - BSD 2-Clause license
+- SerenityOS - https://github.com/SerenityOS/serenity.git - BSD 2-Clause license
+- MINE - 《A Design and Implementation of a 64-bit Operating System》 by Tian Yu; People's Posts and Telecommunications Press
+- chcore - 《Modern Operating Systems: Design and Implementation》 by Chen Haibo, Xia Yubin; Machinery Industry Press
+- SimpleKernel - https://github.com/Simple-XX/SimpleKernel - MIT
+- rcore-fs - https://github.com/rcore-os/rcore-fs.git - MIT
+- redox - https://gitlab.redox-os.org/redox-os/redox - MIT
+
+## All Commit Records of the Current Version
+
+```text
+commit 40176b1c6603d487b7eb66fb81e641f0932ab90a
+Author: longjin <longjin@RinGoTek.cn>
+Date:   Tue Aug 15 15:06:57 2023 +0000
+
+    删除无用代码,并把about app的版本号更新为0.1.8
+
+commit 67b481888770c6469f572f244a4f97e42da77d1f
+Author: houmkh <1119644616@qq.com>
+Date:   Mon Aug 14 12:18:46 2023 +0800
+
+    移动fstat (#330)
+    
+    * 移动fstat
+
+commit 90a0a49048fdaf5e31320d0c87f8bed8db1bd882
+Author: LoGin <longjin@DragonOS.org>
+Date:   Mon Aug 14 01:24:49 2023 +0800
+
+    修正rwlock有的地方由于未使用ManuallyDrop导致的use after free && spinlock守卫新增leak,spinlock新增force unlock功能.(#329)
+    
+    1.修正rwlock有的地方由于未使用ManuallyDrop导致的use after free
+    2. spinlock守卫新增leak,spinlock新增force unlock功能.
+
+commit c3dad0011d331d782670e14723aa48e98fbac787
+Author: LoGin <longjin@DragonOS.org>
+Date:   Sun Aug 13 16:28:24 2023 +0800
+
+    添加per cpu变量支持 (#327)
+
+commit 42c97fa7f4fee7eeefeda5d2b7ed14f598a58493
+Author: LoGin <longjin@DragonOS.org>
+Date:   Tue Aug 8 23:45:04 2023 +0800
+
+    删除旧的libELF (#324)
+
+commit 6d81180b3b7328466b976b69c5f7782aa66d8a89
+Author: LoGin <longjin@DragonOS.org>
+Date:   Tue Aug 8 23:39:22 2023 +0800
+
+    移植sqlite3,并修复一些bug (#323)
+    
+    * bugfix: 程序加载器映射内存时，计算要映射的大小不正确的问题。
+    
+    * 修正brk系统调用不符合规范的地方
+    
+    * bugfix: 修正fat文件系统未能正确的扩展文件大小的bug
+    
+    * 增加fcntl系统调用
+    
+    * 移植sqlite3
+
+commit 26887c6334cdca2d13ad71dec27fb69faa0a57be
+Author: LoGin <longjin@DragonOS.org>
+Date:   Mon Aug 7 01:38:52 2023 +0800
+
+    bugfix: 解决取消低地址映射时，错误的把重映射的物理页释放，从而导致的use after free问题。 (#321)
+
+commit 729a96ef47f473d535d8317a2ace5ba141fd282a
+Author: Xshine <gshine@m.scnu.edu.cn>
+Date:   Sun Aug 6 12:53:47 2023 +0800
+
+    实现内核通知链 notifier chain (#316)
+    
+    * 实现通知链块结构
+    
+    * 实现通知链的基本功能
+    
+    * 实现 atomic notifier chain
+    
+    * 实现 blocking notifier chain
+    
+    * 使用 rust 范式完成功能
+    
+    * 支持回调次数 nr_to_call
+    
+    * 移动至 libs 目录
+    
+    * 完善通知链相关方法
+    
+    * 修正相关格式
+    
+    * 文档编写
+    
+    * 更改文档路径
+
+commit be63f3b2b6b472daa3ee17180aa607409cb9d182
+Author: houmkh <1119644616@qq.com>
+Date:   Sat Aug 5 18:52:46 2023 +0800
+
+    实现系统调用Fstat (#295)
+    
+    * fstat
+    
+    * 修改syscall.rs中的verify_area
+
+commit 9550910ae1de900e0291a84d268e8873fa142902
+Author: Chiichen <39649411+Chiichen@users.noreply.github.com>
+Date:   Sat Aug 5 18:30:55 2023 +0800
+
+     替换 local_irq_save 为 IrqFlagsGuard 实现 (#317)
+
+commit abf3f634bf7e13e829556e962e7c73a85d163335
+Author: LoGin <longjin@DragonOS.org>
+Date:   Sat Aug 5 15:30:06 2023 +0800
+
+    自动安装、更新dadk (#319)
+    
+    * auto install/auto update dadk
+
+commit d6fd9c1e8025dd679339f9156477cb7d26d3db0d
+Author: LoGin <longjin@DragonOS.org>
+Date:   Sat Aug 5 15:04:08 2023 +0800
+
+    设置内核、relibc的远程为dragonos的git镜像站，防止国内网络问题导致编译失败 (#318)
+
+commit 1a62e7767c1215f9668915b42de770e7993711bf
+Author: LoGin <longjin@DragonOS.org>
+Date:   Wed Aug 2 18:11:05 2023 +0800
+
+    解决relibc的头文件没能识别__dragonos__定义的问题 (#315)
+
+commit 06500303303ec14711b4f995e2058e12703f0f2c
+Author: LoGin <longjin@DragonOS.org>
+Date:   Wed Aug 2 17:33:16 2023 +0800
+
+    修正null设备以及zero设备无法open、行为不符合预期的问题 (#314)
+
+commit 4da3758acf0327d429dfce3d313b50c2e0fc7723
+Author: Chiichen <39649411+Chiichen@users.noreply.github.com>
+Date:   Wed Aug 2 14:29:59 2023 +0800
+
+    修复了wait4的异常报错 (#312)
+    
+    * 修复了wait4的异常报错
+
+commit 821bb9a2dcfd28f9878d53ba722bdf164cf00f69
+Author: Xshine <caijiaxin@dragonos.org>
+Date:   Fri Jul 28 17:51:05 2023 +0800
+
+    增加 ListenTable 来检测端口占用 (#291)
+    
+    * 增加 ListenTable 来检测端口占用
+    
+    
+    * 使用Arc封装GlobalSocketHandle
+    
+    * 删除 listen 处的端口检测逻辑，延至实现端口复用时完成
+    
+    * 设立两张表，分别记录TCP和UDP的端口占用
+    
+    * 实现 meatadata 相关逻辑
+    
+    * 实现socket关闭时，端口在表中移除
+    
+    * 使用端口管理器重构端口记录表
+    
+    * 修正与RawSocket相关的端口管理逻辑
+    
+    * 补充测试文件
+    
+    * 修正 unbind_port 在逻辑错误
+    
+    * 修正格式问题
+    
+    ---------
+    
+    Co-authored-by: longjin <longjin@RinGoTek.cn>
+
+commit 7cc4a02c7ff7bafd798b185beb7b0c2986b9f32f
+Author: zhaoyao73 <zhaoyao73@users.noreply.github.com>
+Date:   Fri Jul 28 03:44:45 2023 -0400
+
+    fix arch_try_cmpxchg macro declaration (#307)
+    
+    fix arch_try_cmpxchg in atomic_cmpxchg
+    
+    Co-authored-by: Yao Zhao <dragonlinux@gmail.com>
+
+commit a30434f5201ca4c60b9515c8c23444fea3b5a8c6
+Author: zhaoyao73 <zhaoyao73@users.noreply.github.com>
+Date:   Tue Jul 25 10:02:42 2023 -0400
+
+    fix some script bugs (#304)
+    
+    add arch linux prerequisited packages
+    
+    Co-authored-by: Yao Zhao <dragonlinux@gmail.com>
+
+commit 40fe15e0953f989ccfeb74826d61621d43dea6bb
+Author: LoGin <longjin@DragonOS.org>
+Date:   Sat Jul 22 16:27:02 2023 +0800
+
+    新的内存管理模块 (#303)
+    
+    &emsp;&emsp;实现了具有优秀架构设计的新的内存管理模块，对内核空间和用户空间的内存映射、分配、释放、管理等操作进行了封装，使得内核开发者可以更加方便地进行内存管理。
+    
+    &emsp;&emsp;内存管理模块主要由以下类型的组件组成：
+    
+    - **硬件抽象层（MemoryManagementArch）** - 提供对具体处理器架构的抽象，使得内存管理模块可以在不同的处理器架构上运行
+    - **页面映射器（PageMapper）**- 提供对虚拟地址和物理地址的映射，以及页表的创建、填写、销毁、权限管理等操作。分为两种类型：内核页表映射器（KernelMapper）和用户页表映射器（位于具体的用户地址空间结构中）
+    - **页面刷新器（PageFlusher）** - 提供对页表的刷新操作（整表刷新、单页刷新、跨核心刷新）
+    - **页帧分配器（FrameAllocator）** - 提供对页帧的分配、释放、管理等操作。具体来说，包括BumpAllocator、BuddyAllocator
+    - **小对象分配器** - 提供对小内存对象的分配、释放、管理等操作。指的是内核里面的SlabAllocator （SlabAllocator的实现目前还没有完成）
+    - **MMIO空间管理器** - 提供对MMIO地址空间的分配、管理操作。（目前这个模块待进一步重构）
+    - **用户地址空间管理机制** - 提供对用户地址空间的管理。
+        - VMA机制 - 提供对用户地址空间的管理，包括VMA的创建、销毁、权限管理等操作
+        - 用户映射管理 - 与VMA机制共同作用，管理用户地址空间的映射
+    - **系统调用层** - 提供对用户空间的内存管理系统调用，包括mmap、munmap、mprotect、mremap等
+    - **C接口兼容层** - 提供对原有的C代码的接口，是的C代码能够正常运行。
+    
+    
+    除上面的新增内容以外，其它的更改内容：
+    - 新增二进制加载器，以及elf的解析器
+    - 解决由于local_irq_save、local_irq_restore函数的汇编不规范导致影响栈行为的bug。
+    - 解决local_irq_save未关中断的错误。
+    - 修复sys_gettimeofday对timezone参数的处理的bug
+    
+    ---------
+    
+    Co-authored-by: kong <kongweichao@dragonos.org>
+
+commit bb5f098a864cee36b7d2c1ab9c029c0280d94a8a
+Author: LoGin <longjin@DragonOS.org>
+Date:   Sat Jul 22 16:24:55 2023 +0800
+
+    Revert "新的内存管理模块 (#301)" (#302)
+    
+    This reverts commit d8ad0a5e7724469abd5cc3cf271993538878033e.
+
+commit d8ad0a5e7724469abd5cc3cf271993538878033e
+Author: LoGin <longjin@DragonOS.org>
+Date:   Sat Jul 22 16:22:17 2023 +0800
+
+    新的内存管理模块 (#301)
+    
+    &emsp;&emsp;实现了具有优秀架构设计的新的内存管理模块，对内核空间和用户空间的内存映射、分配、释放、管理等操作进行了封装，使得内核开发者可以更加方便地进行内存管理。
+    
+    &emsp;&emsp;内存管理模块主要由以下类型的组件组成：
+    
+    - **硬件抽象层（MemoryManagementArch）** - 提供对具体处理器架构的抽象，使得内存管理模块可以在不同的处理器架构上运行
+    - **页面映射器（PageMapper）**- 提供对虚拟地址和物理地址的映射，以及页表的创建、填写、销毁、权限管理等操作。分为两种类型：内核页表映射器（KernelMapper）和用户页表映射器（位于具体的用户地址空间结构中）
+    - **页面刷新器（PageFlusher）** - 提供对页表的刷新操作（整表刷新、单页刷新、跨核心刷新）
+    - **页帧分配器（FrameAllocator）** - 提供对页帧的分配、释放、管理等操作。具体来说，包括BumpAllocator、BuddyAllocator
+    - **小对象分配器** - 提供对小内存对象的分配、释放、管理等操作。指的是内核里面的SlabAllocator （SlabAllocator的实现目前还没有完成）
+    - **MMIO空间管理器** - 提供对MMIO地址空间的分配、管理操作。（目前这个模块待进一步重构）
+    - **用户地址空间管理机制** - 提供对用户地址空间的管理。
+        - VMA机制 - 提供对用户地址空间的管理，包括VMA的创建、销毁、权限管理等操作
+        - 用户映射管理 - 与VMA机制共同作用，管理用户地址空间的映射
+    - **系统调用层** - 提供对用户空间的内存管理系统调用，包括mmap、munmap、mprotect、mremap等
+    - **C接口兼容层** - 提供对原有的C代码的接口，是的C代码能够正常运行。
+    
+    
+    除上面的新增内容以外，其它的更改内容：
+    - 新增二进制加载器，以及elf的解析器
+    - 解决由于local_irq_save、local_irq_restore函数的汇编不规范导致影响栈行为的bug。
+    - 解决local_irq_save未关中断的错误。
+    - 修复sys_gettimeofday对timezone参数的处理的bug
+
+commit 0663027b111ffb6ff93becd60ffef1e2b8fbd4c6
+Author: TingHuang <92705854+TingSHub@users.noreply.github.com>
+Date:   Wed Jul 12 12:49:45 2023 +0800
+
+    注册串口设备，创建字符设备框架(#290)
+    
+    * 按照rust规范修改两个函数名称
+    
+    * 修改一些函数句柄以符合rust规范
+    
+    * 添加字符设备相关
+    
+    * 添加字符设备相关文件
+    
+    * 添加字符设备驱动框架代码
+    
+    * 将串口注册
+    
+    * 规范代码
+
+commit cc36cf4a186be834e6c2ab857b9b9501ddb8b1eb
+Author: YJwu2023 <yujianwu2019@gmail.com>
+Date:   Sat Jul 8 17:22:42 2023 +0800
+
+    PCI设备中断重构，删去USB相关代码 (#285)
+    
+    * 修复ecam无法获取MCFG table的问题
+    
+    * 完善pcie
+    
+    * 完善irq的错误检测机制
+
+commit 2311e2f30048d09250afc3e2e4e7029627996655
+Author: 櫻井桃華 <89176634+TihayaKousaka@users.noreply.github.com>
+Date:   Fri Jul 7 22:50:46 2023 +0800
+
+    修改makefile通过编译 (#287)
+
+commit 36fd013004ee0bd5fc7cfb452ba22531a83a859c
+Author: houmkh <1119644616@qq.com>
+Date:   Sat Jun 17 22:48:15 2023 +0800
+
+    实现gettimeofday()系统调用和clocksource+timekeeping子模块 (#278)
+    
+    - 实现gettimeofday()系统调用
+    - 实现clocksource+timekeeping子模块部分功能
+    - 实现了timespec转换成日期时间
+
+commit a55ac7b928a6ca08483bbb3355bea55f1446ccab
+Author: LoGin <longjin@DragonOS.org>
+Date:   Tue Jun 6 17:44:54 2023 +0800
+
+    Update issue templates (#277)
+
+commit 5f57834372f6cb720ba14103effa4799e195a963
+Author: Tptogiar <2528891112@qq.com>
+Date:   Tue Jun 6 16:41:02 2023 +0800
+
+    Makefile: 根目录下添加make help命令 (#271)
+    
+    * Makefile: 根目录下添加make help命令
+    
+    * Makefile: 补充根目录Makefile的help命令
+
+commit aa0367d69e15989684109c5b454e85da9ecb1975
+Author: LoGin <longjin@DragonOS.org>
+Date:   Tue May 30 10:21:11 2023 +0800
+
+    新的ipi功能&kick_cpu功能的重写 (#274)
+
+commit bb24249faabc5006784aa98ca17b4cbdcb788c65
+Author: LoGin <longjin@DragonOS.org>
+Date:   Sun May 28 23:00:37 2023 +0800
+
+    添加AlignBox和int_like宏 (#272)
+
+commit ab5c8ca46db8e7d4793a9791292122b0b9684274
+Author: login <longjin@DragonOS.org>
+Date:   Wed May 24 17:05:33 2023 +0800
+
+    重构系统调用模块 (#267)
+    
+    * 完成系统调用模块重构
+    
+    * 更新github workflow
+
+commit 660a04cef803fd73e9b294b30a96421b021a4b9b
+Author: login <longjin@DragonOS.org>
+Date:   Sat May 13 21:17:12 2023 +0800
+
+    新增http server (#265)
+    
+    * 1.修复了当传入ahci驱动的缓冲区地址为用户缓冲区时,产生的内存越界问题.(采用分配内核缓冲区的方式临时解决)
+    2.新增http server
+    
+    * 把libssl-dev添加到bootstrap.sh
+    
+    * http_server增加对父级相对路径的安全检查，防止访问系统内的其他文件
+    
+    * 检查空指针情况
+    
+    * 解决由于链接时，crt*.o未按照升序排列导致init段链接错误的问题
+
+commit 49249f4ec94fad7baf923aed68d9a7b2da3de3d4
+Author: Bullet <93781792+GP-Bullet@users.noreply.github.com>
+Date:   Sat May 13 09:55:24 2023 +0800
+
+    把调度器实例的裸指针改为Option (#262)
+
+commit bfafc102798ab1968ccf6b04315d8d3359a70ca8
+Author: login <longjin@DragonOS.org>
+Date:   Thu May 11 17:41:42 2023 +0800
+
+    修复读取stdin时，无法正常读取的问题。 (#264)
+
+commit 7285c927d95bb4b5c692c51a8f86c47009d07667
+Author: login <longjin@DragonOS.org>
+Date:   Thu May 11 16:17:58 2023 +0800
+
+    添加dadk支持 (#263)
+    
+    * 引入dadk，使用dadk0.1.1来编译test-relibc程序
+    
+    * 由于gitee仓库体积限制导致无法继续使用gitee上的rust索引，因此更换为清华源
+    
+    * github workflow的环境中，安装dadk
+    
+    * Auto configure dragonos rust toolchain
+
+commit b11bb1b25676f528ec1b0e1da0af82b4652f70c4
+Author: login <longjin@DragonOS.org>
+Date:   Sun May 7 22:20:33 2023 +0800
+
+    固定编译工具链、修复由于新版rust编译器问题导致的报错。 (#258)
+    
+    * 固定编译工具链、修复由于新版rust编译器问题导致的报错。
+    
+    * 完善github workflow环境配置
+
+```

docs/locales/en/community/ChangeLog/V0.1.x/V0.1.9.md

@@ -0,0 +1,2326 @@
+:::{note}
+**AI Translation Notice**
+
+This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+- Source document: community/ChangeLog/V0.1.x/V0.1.9.md
+
+- Translation time: 2025-05-19 01:44:01
+
+- Translation model: `Qwen/Qwen3-8B`
+
+Please report issues via [Community Channel](https://github.com/DragonOS-Community/DragonOS/issues)
+
+:::
+
+# V0.1.9
+
+:::{note}
+Author: He Yicong <heyicong@dragonos.org>
+
+DragonOS Official Forum: [bbs.dragonos.org.cn](https://bbs.dragonos.org.cn)
+
+March 13, 2024
+:::
+
+## Contributors List
+
+The DragonOS V0.1.9 version was contributed by the following team members:
+
+- Long Jin <longjin@DragonOS.org>
+- He Yicong <heyicong@dragonos.rog>
+- Yu Yi <68320855+yuyi2439@users.noreply.github.com>
+- R0ronoa <84278015+2447742618@users.noreply.github.com>
+- Chiichen <39649411+Chiichen@users.noreply.github.com>
+- Wu Yujian <wuyujian@dragonos.org>
+- zhaoyao73 <zhaoyao73@users.noreply.github.com>
+- Hu Zhaopeng <105195940+MemoryShore@users.noreply.github.com>
+- Zhou Hanjie <zhouhanjie@dragonos.org>
+- Lizi <im.lechain@gmail.com>
+- Xshine <gshine@m.scnu.edu.cn>
+- Chenzx <109664121+schulice@users.noreply.github.com>
+- MContour <m-contour@qq.com>
+- Donkey Kane <109840258+xiaolin2004@users.noreply.github.com>
+- Luo Jia / Zhouqi Jiang <luojia@hust.edu.cn>
+- Wu Mianzhi <31810920+Hdksg10@users.noreply.github.com>
+- Xiaoye Zheng <xiaoyez@zju.edu.cn>
+- Plucky923 <107762234+Plucky923@users.noreply.github.com>
+- Xu Zihao <xuzihao@dragonos.org>
+
+## Sponsors List
+
+- **[YaCloud China](https://yacloud.net)** Yaan Big Data Industrial Park provided cloud server support for DragonOS.
+
+## Donors List
+
+Thank you to the following individuals for their donations. We will keep up the good work!
+
+- David Wen
+- Wan Xiaolan
+- Long Jin
+- Wu Yujian
+
+Less than 2000 yuan:
+
+- [Seele.Clover](https://github.com/seeleclover)
+- [FindWangHao](https://github.com/FindWangHao)
+- [ferchiel](https://github.com/ferchiel)
+- Ye Jinyi
+- Lin
+- Albert
+- [TerryLeeSCUT · GitHub](https://github.com/TerryLeeSCUT)
+- slientbard
+- Wu
+- Anonymous Kind-hearted Person
+
+## Update Content - Kernel
+
+### New Features
+
+- refactor: Refactor process management module ([#_translated_label__380_en](https://github.com/DragonOS-Community/DragonOS/pull/380))
+- feature: Improve device driver model ([#_translated_label__401_en](https://github.com/DragonOS-Community/DragonOS/pull/401))
+- feature: Implement e1000e network card driver ([#_translated_label__393_en](https://github.com/DragonOS-Community/DragonOS/pull/393))
+- feature: DragonOS virtualization framework ([#_translated_label__389_en](https://github.com/DragonOS-Community/DragonOS/pull/389))
+- feature: Support syscall fast system call instruction ([#_translated_label__417_en](https://github.com/DragonOS-Community/DragonOS/pull/417))
+- refactor: Rewrite apic driver ([#_translated_label__425_en](https://github.com/DragonOS-Community/DragonOS/pull/425))
+- feature: Thread mechanism and futex ([#_translated_label__411_en](https://github.com/DragonOS-Community/DragonOS/pull/411))
+- feature: DragonStub boot DragonOS kernel ([#_translated_label__460_en](https://github.com/DragonOS-Community/DragonOS/pull/460))
+- feature: Implement Epoll IO multiplexing mechanism ([#_translated_label__455_en](https://github.com/DragonOS-Community/DragonOS/pull/455))
+- feature: Frame buffer abstraction and vesafb driver ([#_translated_label__483_en](https://github.com/DragonOS-Community/DragonOS/pull/483))
+- feature: Add early io remap fixmap function ([#_translated_label__495_en](https://github.com/DragonOS-Community/DragonOS/pull/495))
+- feature: Implement kernel log system ([#_translated_label__489_en](https://github.com/DragonOS-Community/DragonOS/pull/489))
+- refactor: Rewrite kernel initialization code under x86_64 using Rust ([#_translated_label__507_en](https://github.com/DragonOS-Community/DragonOS/pull/507))
+- feature: Add memory management for riscv64 architecture ([#_translated_label__506_en](https://github.com/DragonOS-Community/DragonOS/pull/506))
+- refactor: Interrupt management module refactored ([#_translated_label__554_en](https://github.com/DragonOS-Community/DragonOS/pull/554))
+- refactor: Refactor tty module, implement UNIX compatible tty ([#_translated_label__577_en](https://github.com/DragonOS-Community/DragonOS/pull/577))
+- feature: Implement several POSIX standard system calls
+
+### Bug Fixes
+
+- bugfix: Fix the issue caused by the init proc union and the bug caused by the default sleep behavior of kernel threads leading to the inability to run the init process ([#_translated_label__381_en](https://github.com/DragonOS-Community/DragonOS/pull/381))
+- bugfix: Fix the bug where TLB was not automatically flushed during Flusher Drop ([#_translated_label__384_en](https://github.com/DragonOS-Community/DragonOS/pull/384))
+- bugfix: Fix the bug where multiboot2 startup information was not saved in time, leading to the inability to query it later ([#_translated_label__405_en](https://github.com/DragonOS-Community/DragonOS/pull/405))
+- bugfix: Fix the error in the handling of the unloading logic by bus/device manager ([#_translated_label__385_en](https://github.com/DragonOS-Community/DragonOS/pull/385))
+- bugfix: Solve the bug where the waitqueue sleep caused the sched failure due to preempt count not being zero, leading to the PCB being added multiple times to the scheduling queue on the next wake-up ([#_translated_label__419_en](https://github.com/DragonOS-Community/DragonOS/pull/419))
+- bugfix: Fix the bug where the vm holes were not correctly copied during fork ([#_translated_label__433_en](https://github.com/DragonOS-Community/DragonOS/pull/433))
+- bugfix: Fix the issue where multiple memory areas on the physical machine could not be used correctly, and the memory holes in the kernel code caused the system to fail to run normally ([#_translated_label__448_en](https://github.com/DragonOS-Community/DragonOS/pull/448))
+- bugfix: Fix the bug where the ACPI could not be initialized properly due to the rsdp v1 v2 version issue ([#_translated_label__454_en](https://github.com/DragonOS-Community/DragonOS/pull/454))
+- bugfix: Fix the bug where the bus driver and device strong-weak reference relationship was incorrect, leading to the object being released ([#_translated_label__483_en](https://github.com/DragonOS-Community/DragonOS/pull/483))
+- bugfix: Fix the bug where epoll still held the weak reference of the file descriptor after the file was closed ([#_translated_label__455_en](https://github.com/DragonOS-Community/DragonOS/pull/455))
+- bugfix: Fix the issue of being unable to sleep and the problem where the process in block(true) state could not be awakened by signals and the signals were not handled after waking up ([#_translated_label__470_en](https://github.com/DragonOS-Community/DragonOS/pull/470))
+
+## Update Content - User Environment
+
+### New Features
+
+- feature: Add the init program dragonreach ([#_translated_label__391_en](https://github.com/DragonOS-Community/DragonOS/pull/391))
+- featurn: Add the shell program NovaShell ([#_translated_label__456_en](https://github.com/DragonOS-Community/DragonOS/pull/456))
+- featurn: Add the text editor Held ([#_translated_label__583_en](https://github.com/DragonOS-Community/DragonOS/pull/583))
+- featurn: Support the execution of programs such as gcc, tar, redis, etc.
+
+## Source Code and Release Image Download
+
+&emsp;&emsp;You can obtain the source code through the following methods:
+
+### Get via Git
+
+- You can visit [https://github.com/DragonOS-Community/DragonOS/releases](https://github.com/DragonOS-Community/DragonOS/releases) to download the release code and the compiled, runnable disk image.
+
+### Get via DragonOS Software Mirror Site
+
+&emsp;&emsp;To solve the problem of slow and unstable access to GitHub in China, and to make it convenient for developers to download the code of each version of DragonOS, we have specially set up a mirror site. You can access the mirror site through the following address:
+
+&emsp;&emsp;You can get the DragonOS code package and the compiled, runnable disk image through the mirror site.
+
+- [https://mirrors.DragonOS.org.cn](https://mirrors.DragonOS.org.cn)
+- [https://git.mirrors.DragonOS.org.cn](https://git.mirrors.DragonOS.org.cn)
+
+## Open Source Declaration
+
+:::{note}
+To promote the healthy development of the DragonOS project, DragonOS is released under the GPLv2 open source license. Anyone who can obtain the DragonOS source code and corresponding software products (including but not limited to binary copies and documents) can enjoy the rights granted by us through the GPLv2 license, and you must also comply with the obligations stipulated in the license.
+
+This is a rather strict license that protects the healthy development of open source software and prevents it from being infringed.
+
+For most well-intentioned people, you will not violate our open source license.
+
+We encourage the free dissemination and promotion of DragonOS, but please ensure that all actions do not infringe upon the legitimate rights and interests of others or violate the GPLv2 license.
+
+Please pay special attention to the fact that violations of the open source license, especially **commercial closed-source use and any acts of plagiarism or academic misconduct**, will be subject to serious accountability. (This is the easiest scenario to violate our open source license.)
+
+Also, please note that according to the requirements of the GPLv2 license, software modified or developed based on DragonOS must also be open-sourced under the GPLv2 license and must clearly indicate that it is based on DragonOS. It is also necessary to ensure that users of these modified versions can conveniently obtain the original version of DragonOS.
+
+You must make sure that the DragonOS developers can obtain the source code of your modified version through public channels in the same way, otherwise you will violate the GPLv2 license.
+
+For detailed information about the license, please read the **LICENSE** file in the root directory of the project. Please note that according to the requirements of the GPLv2 license, **only the English original version is legally binding**. Any translated version is for reference only.
+:::
+
+### Usage of Open Source Software
+
+&emsp;&emsp;During the development of DragonOS, we have referenced some designs from the Linux community, or introduced some of their ideas, or been inspired by them. We would like to express our sincere gratitude to the Linux community and its contributors here!
+
+## All Commit Records of the Current Version
+
+```text
+commit af59116e1b8643862598607dbc6ef7233f3791b5
+Author: MemoryShore <105195940+MemoryShore@users.noreply.github.com>
+Date:   Tue Mar 12 17:52:14 2024 +0800
+
+    Update NovaShell version to c6454d3220 (#593)
+
+commit 59fdb447ee4f7b53b1d9c56ec1442aa8c597ac2b
+Author: LoGin <longjin@DragonOS.org>
+Date:   Tue Mar 12 16:32:33 2024 +0800
+
+    fix: 键盘中断上下文不再直接操作tty,而是由专门的kthread来渲染 (#592)
+  
+    fix: 键盘中断上下文不再直接操作tty,而是由专门的kthread来渲染
+    1.修正psmouse 日志
+    2. 键盘中断上下文不再直接操作tty,而是由专门的kthread来渲染
+    3. 由于调度器设计问题,load balance会由于时序问题导致错误.因此暂时只启用单核.
+
+commit 818a64c77613a9c2152739f1cddad78d61e4a94f
+Author: LoGin <longjin@DragonOS.org>
+Date:   Tue Mar 12 15:33:01 2024 +0800
+
+    暂时禁用load balance (#591)
+  
+    原因见issue: https://github.com/DragonOS-Community/DragonOS/issues/571
+
+commit 4374bd1d1177dbf94112aee3ea3f8e8c335a599c
+Author: GnoCiYeH <heyicong@dragonos.org>
+Date:   Mon Mar 11 19:40:52 2024 +0800
+
+    修复get_random一个问题，添加Held配置文件 (#583)
+
+commit 52bcb59e9286def2b66d766f6bf6f46745795ec8
+Author: GnoCiYeH <heyicong@dragonos.org>
+Date:   Mon Mar 11 15:13:37 2024 +0800
+
+    完善Tty的RawMode (#577)
+  
+    * 完善rowmode，改掉一部分bug
+  
+    * 增加两个ansi拓展功能功能，以及标记部分函数nerve inline
+  
+    * 修改do_signal和其他中断上下文锁未关中断，以及拓展tty功能，修改tty几个算法bug
+  
+    * 修改两个锁
+  
+    * 修改syscall_64
+  
+    * update
+
+commit 840045af94ea3391f29e87e968db5d9c48316981
+Author: LoGin <longjin@DragonOS.org>
+Date:   Sun Mar 10 21:45:34 2024 +0800
+
+    引入clippy，并根据clippy的提示，修改部分代码 (#575)
+
+commit f4a82aa55c55e1a9233e99a5598e180f0858d877
+Author: LoGin <longjin@DragonOS.org>
+Date:   Sun Mar 10 20:42:41 2024 +0800
+
+    Update Novashell version to 473d5c403c (#574)
+  
+    - fix: 用户输入不正确的;以及单独输入单引号和双引号造成系统重启
+    - 修改命令解析算法
+    - fix: 输出多余的光标和命令信息
+
+commit 4f8f484930ed3c09ecf4b5b05b1dea14f7b05d8b
+Author: 栗子 <im.lechain@gmail.com>
+Date:   Sat Mar 9 21:20:12 2024 +0800
+
+    修复Archlinux下的bootstrap脚本问题， (#552)
+  
+    * 修复Archlinux下的bootstrap脚本问题，
+  
+    由于archlinux 的 texinfo版本太新导致的gcc docs构建失败
+    使用 MAKEINFO=true 的make环境变量跳过gcc docs构建，绕过问题
+  
+  
+    ---------
+  
+    Co-authored-by: longjin <longjin@dragonos.org>
+
+commit 3055390c25bb7b12279df174689ba09ec50c7d46
+Author: Jomo <xuzihao@dragonos.org>
+Date:   Sat Mar 9 11:40:44 2024 +0800
+
+    完善重映射过程中获取新映射区域时的map_flags (#569)
+
+commit 5c4224e5a8244cb0fb32512e70354362fccd6321
+Author: LoGin <longjin@DragonOS.org>
+Date:   Fri Mar 8 23:23:06 2024 +0800
+
+    在riscv上实现异常处理，能够进入异常处理程序 (#564)
+
+commit c3dc6f2ff9169c309d1cbf47dcb9e4528d509b2f
+Author: LoGin <longjin@DragonOS.org>
+Date:   Fri Mar 8 23:22:48 2024 +0800
+
+    删除一些过时的C代码 (#565)
+  
+    * 删除C版本的crc库
+  
+    * 删除lockref
+  
+    * 删除过时的libc文档以及wait.c
+  
+    * 删除过时的C版本kfifo代码及文档
+  
+    * 移除未用到的lz4库
+  
+    * 删除内核的stdlib.c
+  
+    * 删除fabs.c
+  
+    * fmt
+  
+    * 使得put_string系统调用能够通过tty输出颜色
+    暂且这样改，这一部分应该是用户层面提供的功能，后续删除
+  
+    ---------
+  
+    Co-authored-by: GnoCiYeH <heyicong@dragonos.org>
+
+commit 5eeefb8c80e5580641d295724f8d2190bd54979c
+Author: Chenzx <109664121+schulice@users.noreply.github.com>
+Date:   Fri Mar 8 16:01:22 2024 +0800
+
+    实现SYS_RMDIR (#566)
+  
+    * 实现rmdir系统调用，整理do_remove_dir逻辑
+
+commit 338f6903262c5031abad3c8e361813355a27fcdb
+Author: LoGin <longjin@DragonOS.org>
+Date:   Tue Mar 5 17:22:04 2024 +0800
+
+    `riscv`: 初始化irq (#560)
+  
+    完成riscv的irqchip初始化的代码。
+  
+    这是该功能的第一个PR。由于还需要实现timer驱动才能测试，因此该功能将会通过2~3个PR来完成。
+
+commit bc6f0a967c8cb1e9379ced184b25a7722fbda2a4
+Author: 裕依 <68320855+yuyi2439@users.noreply.github.com>
+Date:   Mon Mar 4 14:20:01 2024 +0800
+
+    移除relibc和old libc以及旧的shell (#529)
+  
+    移除relibc和old libc以及旧的shell
+
+commit f3b05a97ec061e766247b18dc12e2a413b977b14
+Author: GnoCiYeH <heyicong@dragonos.org>
+Date:   Mon Mar 4 14:10:26 2024 +0800
+
+    将tty输出接入串口 (#555)
+
+commit cf45dede2e46d9341cec75871fdc1bc5961ba5a2
+Author: MContour <m-contour@qq.com>
+Date:   Sun Mar 3 17:20:11 2024 +0800
+
+    让 DragonOS 仓库管理 service 文件 (#548)
+  
+    * feat: create `user/services` folder to store service files
+
+commit e28411791f090c421fe4b6fa5956fb1bd362a8d9
+Author: LoGin <longjin@DragonOS.org>
+Date:   Sun Mar 3 16:31:08 2024 +0800
+
+    完成中断管理模块重构 (#554)
+  
+    - 支持中断共享
+    - 把现有驱动程序移植到新的irq模块
+    - 使用`ProcessorId`标识处理器id
+    - 尚未实现threaded_irq
+  
+    性能上，edge irq flow handler里面，对于锁的使用，可能有点问题。为了获取/修改common data还有其他几个结构体的状态，进行了多次加锁和放锁，导致性能降低。这是接下来需要优化的点。
+
+commit 44d051e5864adff6f4ace8a234ef57852840f365
+Author: Donkey Kane <109840258+xiaolin2004@users.noreply.github.com>
+Date:   Sun Mar 3 15:22:45 2024 +0800
+
+    Modify dadk config to switch NovaShell revision (#550)
+
+commit 0e7c46939604a02e739546200bea847f4951a963
+Author: GnoCiYeH <heyicong@dragonos.org>
+Date:   Fri Mar 1 15:07:00 2024 +0800
+
+    修改事件等待队列对于retain使用方法出错导致唤醒错误 (#551)
+
+commit be60c929c8285d3050e022aa23312a84129e54b2
+Author: GnoCiYeH <heyicong@dragonos.org>
+Date:   Wed Feb 28 20:18:49 2024 +0800
+
+    修改tty几个bug (#549)
+  
+    * 更改ioctl一处逻辑错误
+  
+    * 删除不必要的impl
+  
+    * 修改一处bug，并且加入tty的link，为pty做准备
+  
+    * 修改一处因为vc的pos和x计算错误导致的溢出
+
+commit 52da9a59374752b4d01907b052135a0d317781dd
+Author: GnoCiYeH <heyicong@dragonos.org>
+Date:   Mon Feb 26 15:27:19 2024 +0800
+
+    完成与Linux兼容的Ntty (#517)
+  
+    * 已经完成的功能：
+    - 写：printf能够正常在tty输出
+    - 读：与键盘驱动接上
+    - 信号： 能够正常通过ctrl向前台进程发送信号
+  
+    * 支持目前的shell，改动printk使其与新版tty兼容。
+  
+    * 删除原有tty文件夹，并更改新tty文件名
+  
+    * 添加clear清屏程序
+  
+    * 实现tty部分ioctl，更改部分问题
+
+commit 9993c0fc61e9603f631bd6748ff0b4fecb7bd483
+Author: R0ronoa <84278015+2447742618@users.noreply.github.com>
+Date:   Mon Feb 26 15:03:13 2024 +0800
+
+    添加i8042驱动 改正serio设备文件结构 (#538)
+  
+    * 添加i8042驱动 改正serio设备文件结构
+
+commit d2b28acb4d1f160779b25d76afca49ed60ad5d48
+Author: 栗子 <im.lechain@gmail.com>
+Date:   Sun Feb 25 19:57:30 2024 +0800
+
+    tools/bootstrap.sh: fix archlinux and zsh issue (#535)
+  
+    1. archlinux上没有libssl-dev包，相对应的包名是openssl
+    2. zsh用户使用bootstrap.sh 会因为 source ~/.zshrc
+       导致bash执行很多zsh built-in 指令出现非常多错误
+    3. mkdir命令加-p选项避免对象目录存在时（反复执行脚本）报错
+    4. 修复简单错误(typo gcc 为 binutils)
+    5. 修复bootstrap.sh等脚本无法在非tools/目录执行的错误
+
+commit 7d66c3134c1c5566ac8f8b7524e98650d0480a4a
+Author: LoGin <longjin@DragonOS.org>
+Date:   Mon Feb 19 21:40:37 2024 +0800
+
+    添加简单的cpumask (#533)
+
+commit b2ca6800f9d943e5d3656d9b50a099da768775a7
+Author: LoGin <longjin@DragonOS.org>
+Date:   Mon Feb 19 19:50:03 2024 +0800
+
+    添加动态申请的bitmap (#532)
+
+commit 0e2c2e8b48369b201f44e0933f775b932b6776ef
+Author: 裕依 <68320855+yuyi2439@users.noreply.github.com>
+Date:   Mon Feb 19 19:31:17 2024 +0800
+
+    修正systemerror号 (#527)
+  
+    修正systemerror号
+
+commit 4cfa009b87c8431a41fab740ffdbd7b008965c9a
+Author: Jomo <xuzihao@dragonos.org>
+Date:   Mon Feb 19 14:54:11 2024 +0800
+
+    实现mremap系统调用 (#518)
+  
+    * mremap系统调用
+
+commit 27b967a38a6dd7a266c43b5e705c29dfbbd71ae4
+Author: 裕依 <68320855+yuyi2439@users.noreply.github.com>
+Date:   Mon Feb 19 14:53:34 2024 +0800
+
+    添加pread&pwrite (#528)
+  
+    添加pread&pwrite
+
+commit 701589559f912deb03eb5176d049d9d07fb29447
+Author: LoGin <longjin@DragonOS.org>
+Date:   Mon Feb 19 11:17:23 2024 +0800
+
+    删除无用的C版本bitree和ida/idr. (#526)
+  
+    这些数据结构不再使用,将其删除.
+
+commit 196b75dc17b5cc2ed84301bce776e496ddfe1ed1
+Author: LoGin <longjin@DragonOS.org>
+Date:   Mon Feb 19 00:56:58 2024 +0800
+
+    把irqdesc添加到sysfs (#525)
+  
+    * 把irqdesc添加到sysfs
+
+commit 3bc96fa4a9c01d91cddeb152fe78d6408351c29f
+Author: LoGin <longjin@DragonOS.org>
+Date:   Mon Feb 19 00:36:36 2024 +0800
+
+    添加irqdesc的抽象，并在系统初始化时创建irqdesc (#522)
+  
+    * 添加irqdesc的抽象，并在系统初始化时创建irqdesc
+
+commit ce5850adbf74ec6c6717bbb5b1749f1fbff4ca0d
+Author: LoGin <longjin@DragonOS.org>
+Date:   Sun Feb 18 20:41:41 2024 +0800
+
+    添加irqchip这一层的数据结构(尚未接入真实的芯片) (#520)
+  
+    * 添加irqchip这一层的数据结构(尚未接入真实的芯片)
+
+commit ca318c376bd9e39f8fe71f304974f7e99e8e01f4
+Author: LoGin <longjin@DragonOS.org>
+Date:   Sat Feb 17 01:51:10 2024 +0800
+
+    update dragonreach to 3d99c3a9d9 (#519)
+
+commit 472f0b3931eadda2bbcc67889d612790f147190b
+Author: LoGin <longjin@DragonOS.org>
+Date:   Tue Feb 13 12:14:12 2024 +0800
+
+    update dragonreach to 40362c48d6 (#516)
+
+commit d90848514bea7efd5898f5824b98f1bf2e54de8d
+Author: Luo Jia / Zhouqi Jiang <luojia@hust.edu.cn>
+Date:   Sat Feb 10 23:20:50 2024 +0800
+
+    riscv: 更新sbi-rt至0.0.3版本 (#512)
+  
+    先前使用git仓库链接的最新更新已发布至crates.io网站
+  
+    Signed-off-by: Zhouqi Jiang <luojia@hust.edu.cn>
+
+commit 4ad52e57e612a88ab09413c7ac0072db96a93632
+Author: 裕依2439 <68320855+yuyi2439@users.noreply.github.com>
+Date:   Wed Feb 7 18:06:15 2024 +0800
+
+    添加socketpair (#505)
+  
+    * 添加对socketpair系统调用的处理
+  
+    ---------
+  
+    Co-authored-by: LoGin <longjin@DragonOS.org>
+
+commit cb23beb255d8e32b45d879ac19386a3597ca4115
+Author: LoGin <longjin@DragonOS.org>
+Date:   Wed Feb 7 17:15:17 2024 +0800
+
+    riscv: probe sbi extensions (#511)
+
+commit f2022a8a1cc4a8e2a85e9061e036e9c491a2fa00
+Author: LoGin <longjin@DragonOS.org>
+Date:   Wed Feb 7 13:29:47 2024 +0800
+
+    使用rust编写中断/异常的入口 (#509)
+  
+    * 使用rust编写中断/异常的入口
+
+commit d14e28a8a9b023ee8df7c2e8eee43e523134dbb2
+Author: Luo Jia / Zhouqi Jiang <me@luojia.cc>
+Date:   Wed Feb 7 11:38:15 2024 +0800
+
+    riscv: 使用sbi-rt库完成SBI操作 (#510)
+  
+    未来的其它SBI操作也将使用sbi-rt
+  
+    Signed-off-by: Zhouqi Jiang <luojia@hust.edu.cn>
+
+commit fccbe87dcae0f8e8fde611ef60b1f7923126d526
+Author: LoGin <longjin@DragonOS.org>
+Date:   Mon Feb 5 14:50:15 2024 +0800
+
+    删除关于zulip的表述,替换为社区论坛 (#508)
+
+commit 5b59005f930266d0e9c0092373e894826150f862
+Author: LoGin <longjin@DragonOS.org>
+Date:   Sun Feb 4 15:46:24 2024 +0800
+
+    x86_64: 使用Rust重写内核初始化代码 (#507)
+  
+    * x86_64: 使用Rust重写内核初始化代码
+
+commit 453452cc02e2766a28d87dd47bdee37caddc4c44
+Author: LoGin <longjin@DragonOS.org>
+Date:   Sun Feb 4 14:35:18 2024 +0800
+
+    初始化riscv的内存管理模块，并且设置保留内存 (#506)
+
+commit a02ce654cf0166720f8569827d0c5b2dfd0ca95a
+Author: Chiichen <chiichen@qq.com>
+Date:   Sun Jan 28 20:29:01 2024 +0800
+
+    支持对动态链接文件的加载，支持通过musl工具链编写用户空间程序 (#504)
+  
+    支持对动态链接文件的加载，支持通过musl工具链编写用户空间程序
+
+commit 5d549a76ab0cf66651a6614be92dcb481fe7af2a
+Author: Chiichen <chiichen@qq.com>
+Date:   Fri Jan 26 20:45:08 2024 +0800
+
+    修改一处常量定义 (#503)
+  
+    * 修改一处常量定义
+  
+    * 修复ELF加载程序对用户程序加载地址判断不正确的地方
+  
+    ---------
+  
+    Co-authored-by: longjin <longjin@DragonOS.org>
+
+commit 9284987850c1da2ce607a539eeae8a353a8f6df9
+Author: LoGin <longjin@DragonOS.org>
+Date:   Fri Jan 26 18:08:39 2024 +0800
+
+    riscv: 完成UEFI初始化,能正确设置memblock的信息 (#501)
+  
+    * riscv: 完成UEFI初始化,能正确设置memblock的信息
+  
+    * sbi增加reset功能
+  
+    * 把虚拟CPU修改为sifive-u54，使qemu能更正确地模拟硬件行为
+  
+    * 修复内存页面映射未设置“DIRTY”、”ACCESSED“、”GLOBAL“位，导致真机page fault的问题
+
+commit a381e482cbe742b2e4bbeaacae134a8131bf3f91
+Author: R0ronoa <84278015+2447742618@users.noreply.github.com>
+Date:   Wed Jan 24 19:17:22 2024 +0800
+
+    实现Ps/2鼠标驱动 (#500)
+  
+    实现Ps/2鼠标驱动
+
+commit 8d72b68da9339ec97e1b8929bcf2946f0fd83cd5
+Author: Jomo <xuzihao@dragonos.org>
+Date:   Wed Jan 24 16:13:15 2024 +0800
+
+    实现内核日志系统 (#489)
+  
+    * 实现写日志和读取日志，并且能够在用户态下执行dmesg命令查看日志
+  
+    * 通过klogctl实现dmesg
+  
+    * 改用ConstGenericRingBuffer作内核缓冲区
+  
+    * 更改缓冲区容量
+  
+    * 将能够输出到控制台的日志级别改为日志级别枚举类，使用SpinLock控制KMSG，使用枚举类定义SYSLOG_ACTION，将do_syslog系统调用接口放在syscall.rs
+  
+    * fix warning
+  
+    * 完善do_syslog注释
+  
+    * 将KMSG接入kinfo、kdebug等
+  
+    * fix warning
+  
+    * 修复显示的秒数不正确，·以及无法通过CI的问题
+
+commit d46c6d27941a26de14f55a2bbf956219bcc70871
+Author: 裕依2439 <68320855+yuyi2439@users.noreply.github.com>
+Date:   Tue Jan 23 23:36:52 2024 +0800
+
+    修复tty的buf满时始终阻塞的问题 (#493)
+  
+    * 修复tty的buf满时始终阻塞的问题
+
+commit 43ef2a0d2b6ec427f6775cd4593c56897dd5bf6d
+Author: LoGin <longjin@DragonOS.org>
+Date:   Sun Jan 21 18:45:07 2024 +0800
+
+    添加riscv64的github workflow (#499)
+  
+    * 添加riscv64的github workflow
+
+commit 7a29d4fcbcd89a226289c7bf541c2c78623de3ad
+Author: LoGin <longjin@DragonOS.org>
+Date:   Sun Jan 21 15:38:12 2024 +0800
+
+    riscv64: 映射uefi systemtable,并完善了riscv64页表填写的部分内容 (#498)
+  
+    * 从fdt的chosen段获取几个需要的字段
+  
+    * merge patch-early-ioremap
+  
+    * feature: 增加early io remap的fixmap功能
+  
+    允许在内存管理初始化之前,使用fixmap功能,映射一些物理内存,并记录.
+  
+    * riscv64: 映射uefi systemtable,并完善了riscv64页表填写的部分内容
+  
+    * 更新仓库网址
+
+commit 3e3c6316aaac5a8a2932bd1746ec8b900dc5e2c6
+Author: Chiichen <chiichen@qq.com>
+Date:   Sun Jan 21 01:38:45 2024 +0800
+
+    fix: 修复了ps2和tty初始化顺序的错误 (#497)
+  
+    * 修复了ps2和tty初始化顺序的错误
+
+commit 74ffde667e5e7f4ac8ce6d5a5ec2c1403f36cbb0
+Author: LoGin <longjin@DragonOS.org>
+Date:   Sun Jan 21 01:21:55 2024 +0800
+
+    feature: 增加early io remap的fixmap功能 (#495)
+  
+    允许在内存管理初始化之前,使用fixmap功能,映射一些物理内存,并记录.
+
+commit 1f58c8f5cff8e82441b66789c3dc7c009d52f29a
+Author: LoGin <longjin@DragonOS.org>
+Date:   Thu Jan 18 22:39:58 2024 +0800
+
+    Update mini-backtrace版本到e0b1d90940 (#494)
+  
+    内容:
+  
+    [https://github.com/DragonOS-Community/mini-backtrace/pull/1](https://github.com/DragonOS-Community/mini-backtrace/pull/1)
+  
+    Co-authored-by: Yao Zhao <dragonlinux@gmail.com>
+
+commit c75ef4e2126c180bf04c08635ffa5a278619c035
+Author: LoGin <longjin@DragonOS.org>
+Date:   Thu Jan 18 00:09:36 2024 +0800
+
+    添加early ioremap支持 (#492)
+  
+    * 使用early io remap来映射早期的vesa缓冲区
+
+commit d8e29bffeee4fe4fe76ead3c761dd03f5395e6c2
+Author: R0ronoa <84278015+2447742618@users.noreply.github.com>
+Date:   Wed Jan 17 23:57:49 2024 +0800
+
+    增加serio总线和相关trait (#488)
+  
+    * 新增serio总线和相关trait
+  
+    * 补充SerioDeviceManager和SerioDriverManager
+
+commit 6994f6b113f6fea7b997ec07130a7bdaecfd67b7
+Author: LoGin <longjin@DragonOS.org>
+Date:   Mon Jan 15 18:13:22 2024 +0800
+
+    完成bitmap的static bitmap功能，能够静态声明bitmap (#490)
+  
+    * 完成bitmap的static bitmap功能，能够静态声明bitmap
+
+commit dcf232f378b36fad754799fc121a70cadc8d5cb3
+Author: LoGin <longjin@DragonOS.org>
+Date:   Sun Jan 14 17:00:42 2024 +0800
+
+    当找不到内核日志缓冲区的时候，重试 (#491)
+
+commit 45626c859f95054b76d8b59afcbd24c6b235026f
+Author: LoGin <longjin@DragonOS.org>
+Date:   Wed Jan 3 18:00:47 2024 +0800
+
+    riscv: 解析dtb，获取可用内存空间并添加到memblock (#486)
+
+commit 02343d0b5b47c07e7f4ec3818940795b1009fae1
+Author: LoGin <longjin@DragonOS.org>
+Date:   Tue Jan 2 14:16:10 2024 +0800
+
+    增加/dev/fb0，能够在用户程序读写帧缓冲区 (#485)
+
+commit e7071df6a47c100381a8bc2000022e82d422361a
+Author: LoGin <longjin@DragonOS.org>
+Date:   Mon Jan 1 11:53:49 2024 +0800
+
+    把opengrok.ringotek.cn替换为code.dragonos.org.cn (#484)
+
+commit c566df451ce6dbf2af684333e68b39fdfff86498
+Author: LoGin <longjin@DragonOS.org>
+Date:   Mon Jan 1 11:46:51 2024 +0800
+
+    添加帧缓冲区抽象并实现vesafb的驱动 (#483)
+  
+    - 添加bootparams对象
+    - 修正由于bus的driver、device强弱引用关系 不正确从而导致对象被释放的bug
+    - 添加vesafb的驱动
+    - 实现framebuffer抽象层
+    - 为通用帧缓冲区抽象实现sysfs的属性
+    - 修改设备号DeviceNumber的定义
+    - 仿照linux，添加initcall，并在第一个内核线程中，调用他们。
+
+commit e3eb08d4d7148d6dad369e2ef27979d1bcf85bd6
+Author: LoGin <longjin@DragonOS.org>
+Date:   Sat Dec 30 16:23:26 2023 +0800
+
+    fix: 修复安装musl-gcc的脚本没能正确设置x86_64下的环境变量的问题 (#482)
+
+commit 81294aa2e6b257f0de5e3c28c3f3c89798330836
+Author: LoGin <longjin@DragonOS.org>
+Date:   Wed Dec 27 20:32:25 2023 +0800
+
+    fix: 修正bootstrap脚本安装docker后会使得当前终端进入root的问题 (#481)
+
+commit cfd642e2835eded086b6e944427e4a88f03e2fff
+Author: MemoryShore <105195940+MemoryShore@users.noreply.github.com>
+Date:   Wed Dec 27 15:07:01 2023 +0800
+
+    更新nova shell的revision为64ad1b282a (#477)
+  
+    - 修复tab补全时始终基于根目录的问题
+    - 修复touch命令提示已存在文件的bug
+
+commit 5e948c56506aa0554d212341a7630587d55ebb87
+Author: GnoCiYeH <heyicong@dragonos.org>
+Date:   Wed Dec 27 15:02:29 2023 +0800
+
+    修正pipe逻辑，将pipe接入epoll。 (#478)
+
+commit 0d6cf65aa124ee55bfee44cbb5196917ea6522fa
+Author: LoGin <longjin@DragonOS.org>
+Date:   Wed Dec 27 14:27:12 2023 +0800
+
+    Patch fix sched and net lockdep error (#479)
+  
+    - fix: 修复调度器,软中断,定时器,网络子系统的部分锁的使用不符合锁依赖安全规范的问题
+    - fix: 修复创建pcb时内核栈爆栈的问题
+    - 把异常的trap gate改成intr gate
+  
+    ---------
+  
+    Co-authored-by: GnoCiYeH <heyicong@dragonos.org>
+
+commit 91e9d4ab55ef960f57a1b6287bc523ca4341f67a
+Author: LoGin <longjin@DragonOS.org>
+Date:   Mon Dec 25 23:12:27 2023 +0800
+
+    实现unified-init库，支持收集初始化函数到一个数组，并统一初始化 (#474)
+  
+    * 添加“统一初始化”的过程宏，并把SystemError独立成crate
+  
+    * 使用unified-init来初始化fbmem
+  
+    * 更新workflow，增加内核自动化静态测试
+
+commit f110d330d5493f383067b4e82ebbfb72f40457b2
+Author: LoGin <longjin@DragonOS.org>
+Date:   Mon Dec 25 21:54:00 2023 +0800
+
+    修复bootstrap在安装riscv gcc依赖时出现冲突的问题 (#476)
+
+commit 406099704eb939ae23b18f0cfb3ed36c534c1c84
+Author: GnoCiYeH <heyicong@dragonos.org>
+Date:   Mon Dec 25 18:08:12 2023 +0800
+
+    增加epoll机制 (#455)
+  
+    * ## 增加epoll机制
+    - 增加epoll机制
+    - 添加事件等待队列，提升socket性能
+    - 优化poll，删除不能poll的文件系统中的poll方法
+  
+    * 添加细节注释
+  
+    * 修复文件关闭后epoll还持有对应描述符的文件弱引用的bug
+  
+    * 将EPollEvent设计为POSIX标准
+  
+    * 修改s到us转换的计算错误
+
+commit 070e991008b268b7103236a46b8651a983522869
+Author: R0ronoa <84278015+2447742618@users.noreply.github.com>
+Date:   Fri Dec 22 16:01:23 2023 +0800
+
+    解决由于Makefile问题导致make run-uefi无法正常启动的问题 (#473)
+
+commit 08a2ee408498b0db4c76c57b149f1cf047758f3c
+Author: LoGin <longjin@DragonOS.org>
+Date:   Wed Dec 20 17:24:05 2023 +0800
+
+    添加FrameBuffer的接口抽象&完善设备驱动模型的class相关代码 (#472)
+  
+    * 添加FrameBuffer的接口抽象（参考Linux 6.1.9）
+  
+    * feature: 完善设备驱动模型的class的抽象,并创建graphics class
+  
+    * feature: 完善设备驱动模型中Device对class的处理,使得能够在class下注册设备
+  
+    目前注册了fbcon设备,但是由于虚拟终端还没写,因此fbcon的到终端以及帧缓冲区的映射还没加上去.
+
+commit 8612b6ce7afc903999ccf0b65bd65019484d2fad
+Author: LoGin <longjin@DragonOS.org>
+Date:   Tue Dec 19 11:56:14 2023 +0800
+
+    bugfix: 修复无法sleep的问题以及进程处于block(true)状态时无法被信号唤醒&唤醒后不处理信号的问题 (#470)
+
+commit 24ff1faffb3d610cd55e3c658fd50ea0a0efedfb
+Author: LoGin <longjin@DragonOS.org>
+Date:   Mon Dec 18 17:44:53 2023 +0800
+
+    doc: 修改Rust代码注释风格文档 (#471)
+
+commit 111c5407ccb7774695c8047cf895481d3387fda9
+Author: LoGin <longjin@DragonOS.org>
+Date:   Sun Dec 17 21:08:03 2023 +0800
+
+    设置idle进程的时间片为0，降低调度延迟 (#469)
+
+commit 666cffedab3da9684e5abf5eebcbddae63590364
+Author: LoGin <longjin@DragonOS.org>
+Date:   Sat Dec 16 22:26:26 2023 +0800
+
+    riscv: 映射内核到指定的虚拟地址，使得kinfo能正常工作 (#468)
+  
+    * riscv: 映射内核到指定的虚拟地址，使得kinfo能正常工作
+
+commit cf442324231632df3c3b0da3d2c8e19087863aa0
+Author: LoGin <longjin@DragonOS.org>
+Date:   Wed Dec 13 14:44:57 2023 +0800
+
+    修复x86下第二次编译的时候内核没有拷贝到磁盘的问题 (#467)
+
+commit 1a72a751b18cf5bbe7b5b9e91aff530de0c18501
+Author: LoGin <longjin@DragonOS.org>
+Date:   Thu Dec 7 02:13:22 2023 +0800
+
+    在riscv输出hello world (#466)
+  
+    增加了以下内容：
+    - SBI驱动
+    - 把内核的rust工具链升级到2023-08-15版本
+    - 输出riscv的helloworld
+    - 设置内核是PIC的
+
+commit fca83acef4ba261453f7c71960eacf83d0cf51f4
+Author: LoGin <longjin@DragonOS.org>
+Date:   Mon Dec 4 22:10:10 2023 +0800
+
+    修复cache-toolchain.yml的格式问题 (#464)
+
+commit 6c7f966c2f3e3ed299168fc97ae346a85cc6e322
+Author: MemoryShore <105195940+MemoryShore@users.noreply.github.com>
+Date:   Mon Dec 4 22:07:30 2023 +0800
+
+    NovaShell替换为默认shell (#456)
+  
+    * NovaShell替换为默认shell
+  
+    * delete some envvar
+  
+    * 自动从dragonos镜像站更新dadk
+  
+    * 更新github ci环境
+  
+    * 修复yml格式问题
+  
+    * 更新novashell到95738b235f
+  
+    ---------
+  
+    Co-authored-by: longjin <longjin@DragonOS.org>
+
+commit 09d2bf52a6d048929a879748ae26e4fdea45e5d5
+Author: LoGin <longjin@DragonOS.org>
+Date:   Sun Dec 3 21:27:43 2023 +0800
+
+    update-dragon-stub-bf2617 (#463)
+
+commit af3543100543b9ac6159dc9f9367a76ff670b1f3
+Author: LoGin <longjin@DragonOS.org>
+Date:   Sun Dec 3 17:16:03 2023 +0800
+
+    使用submodule引入DragonStub (#462)
+  
+    * 修正构建系统文档: 使用repo工具克隆代码
+  
+    * 使用submodule管理
+
+commit 83ed0ebc293d5a10245089f627f52770fd5b9dd4
+Author: LoGin <longjin@DragonOS.org>
+Date:   Sun Dec 3 14:51:21 2023 +0800
+
+    修正构建系统文档: 使用repo工具克隆代码 (#461)
+
+commit 01090de77ef263b81edf449b77320d5fa28569de
+Author: LoGin <longjin@DragonOS.org>
+Date:   Sun Dec 3 14:40:13 2023 +0800
+
+    使用DragonStub引导riscv下的DragonOS内核 (#460)
+
+commit 4fda81ce81939d83b74c8042d6fb4223deff3685
+Author: LoGin <longjin@DragonOS.org>
+Date:   Sat Nov 25 12:07:39 2023 +0800
+
+    使得DragonOS kernel 能为riscv64编译通过(尚未能启动) (#457)
+  
+    * 使得DragonOS kernel 能为riscv64编译通过(尚未能启动)
+  
+    * 修正了系统调用号声明不正确的问题，同时添加了编译配置文档
+
+commit a1fd1cf1cbe6934221f95213ce02b21f21add225
+Author: LoGin <longjin@DragonOS.org>
+Date:   Thu Nov 23 21:12:16 2023 +0800
+
+    把tar的二进制镜像源更换为国内源 (#458)
+
+commit cc5feaf67b914ecf701abcba70c01da149755491
+Author: Jomo <2512364506@qq.com>
+Date:   Thu Nov 23 21:04:32 2023 +0800
+
+    bugfix: 修复因rsdp v1 v2版本问题，导致ACPI无法正常初始化的bug (#454)
+  
+    bugfix: 修复因rsdp v1 v2版本问题，导致ACPI无法正常初始化的bug
+
+commit c89d0c12377cd406a9b7465d7c087aeb9faefa51
+Author: LoGin <longjin@DragonOS.org>
+Date:   Tue Nov 21 20:24:43 2023 +0800
+
+    修复bootstrap的一系列脚本忘了source最新的shell rc的问题 (#453)
+
+commit c75089286e9d49cef8d039446bf570c1bd4d2550
+Author: LoGin <longjin@DragonOS.org>
+Date:   Tue Nov 21 13:42:18 2023 +0800
+
+    调整脚本,使得能够创建riscv的磁盘镜像,并引导进入riscv下的grub (#450)
+  
+    * 安装musl toolchain以及riscv相关的工具链
+  
+    * 调整脚本,使得能够创建riscv的磁盘镜像,并引导进入riscv下的grub
+  
+    ```shell
+    export ARCH=riscv64
+    make write_diskimage
+    make qemu
+    ```
+  
+    即可在serial_opt.txt看到进入grub的提示信息
+
+commit 48a3baa9b1d24dd1fc037cd9961945708c5c9b71
+Author: LoGin <longjin@DragonOS.org>
+Date:   Tue Nov 21 13:42:06 2023 +0800
+
+    安装musl toolchain以及riscv相关的工具链 (#449)
+
+commit 84e7f7100664123d8ebc6b0f983c96242d15c396
+Author: LoGin <longjin@DragonOS.org>
+Date:   Mon Nov 20 15:51:41 2023 +0800
+
+    添加赞助商雅安数字经济运营有限公司的信息到readme (#451)
+
+commit 99dbf38d2e279ea70e9e186753fd37001dbb749f
+Author: LoGin <longjin@DragonOS.org>
+Date:   Sun Nov 19 11:42:53 2023 +0800
+
+    bugfix: 当物理机具有多个memory area的时候,无法正确使用这些区域的问题.以及在内核代码处出现内存空洞而导致无法正常运行的问题. (#448)
+  
+    * bugfix: 当物理机具有多个memory area的时候,无法正确使用这些区域的问题.以及在内核代码处出现内存空洞而导致无法正常运行的问题.
+  
+    解决方案:
+    1. 分区域把空闲页添加到buddy
+    2. 将内核链接到16M的位置,以避免uefi带来的内存空洞.
+  
+    这个值是因为我看到linux的救援内核也是在16M的地址,因此猜测厂商不会使用这块内存.
+    尽管uefi规范讲的是固件可以采用任何地址,内核需要使用内核重定位技术去避免遇到内存空洞,但我没有这么做.
+
+commit 46e234aef65c081393fb7652e0ad2bae26786ce4
+Author: LoGin <longjin@DragonOS.org>
+Date:   Fri Nov 17 21:25:15 2023 +0800
+
+    使用cargo管理一些C文件的编译，并且移动部分汇编到arch目录 (#447)
+  
+    * 使用cargo管理main.c的编译
+  
+    * 使用build-scripts编译架构相关的c代码
+  
+    * 删除elf.h
+
+commit e4600f7f7d8f2295dbf970812ab1fcab81eb6eae
+Author: Jomo <2512364506@qq.com>
+Date:   Fri Nov 17 21:23:01 2023 +0800
+
+    Kconfig (#432)
+  
+    * 内核编译配置
+  
+    * 将kernel.config的解析代码搬入crate
+  
+    * 将设置feature函数放入CargoHandler中
+
+commit 11f78b73e7b18ef04e05e63612f8027eda0740e7
+Author: LoGin <longjin@DragonOS.org>
+Date:   Fri Nov 17 20:05:57 2023 +0800
+
+    使用kernel-build脚本来编译所有的asm文件 (#445)
+
+commit e4fb6c9754e535861a5e67db29fb6e8c2e9c8469
+Author: LoGin <longjin@DragonOS.org>
+Date:   Fri Nov 17 12:26:10 2023 +0800
+
+    美化readme (#446)
+  
+    * 美化readme
+
+commit e26ca418df7af685226d12d7f22fe1785ba163e4
+Author: LoGin <longjin@DragonOS.org>
+Date:   Fri Nov 17 11:26:26 2023 +0800
+
+    把内核构建脚本单独独立成一个crate (#444)
+
+commit a0c98cd4df88474f2efd927930862df50e016b73
+Author: Jomo <xuzihao@dragonos.org>
+Date:   Thu Nov 16 21:37:04 2023 +0800
+
+    解决textui framework初始化成功后串口无法正常换行 (#443)
+
+commit edaf015400f83967c2fc940f07be0dbb5792246f
+Author: LoGin <longjin@DragonOS.org>
+Date:   Wed Nov 15 17:17:56 2023 +0800
+
+    默认安装gnu tar到dragonos的/usr/bin目录下 (#442)
+
+commit 0fb515b011967be01006cf88d788793dbbce2967
+Author: LoGin <longjin@DragonOS.org>
+Date:   Wed Nov 15 15:39:35 2023 +0800
+
+    完善pipe系统调用以及openat系统调用 (#441)
+
+commit bf4a48994a2b284ee34aa49a66b4dec1b6ebc07c
+Author: LoGin <longjin@DragonOS.org>
+Date:   Mon Nov 13 23:02:21 2023 +0800
+
+    新增系统调用，并对照linux-6.1.9改写sys_wait4 (#440)
+  
+    * 1. 新增以下系统调用
+                - SYS_LSTAT
+                - SYS_READV
+                - SYS_ACCESS
+                - SYS_UNLINK
+                - SYS_CHMOD
+                - SYS_FCHMOD
+                - SYS_UMASK
+                - SYS_SYSINFO
+                - SYS_CLOCK_GETTIME
+                - SYS_FCHMODAT
+                - SYS_FACCESSAT
+  
+    2. 修改sys_wait4,使得其部分符合Linux的行为(还是有些地方不符合的,详情请对比linux-6.1.9的sys_wait4接口)
+
+commit 9b0abe6da72176086c3188e0599fda950562668f
+Author: LoGin <longjin@DragonOS.org>
+Date:   Sun Nov 12 21:23:48 2023 +0800
+
+    添加access、faccessat、faccessat2 (#439)
+
+commit 0d9b7d9240ef65c3e603a371db57a80d26a7b9dd
+Author: LoGin <longjin@DragonOS.org>
+Date:   Sun Nov 12 18:44:15 2023 +0800
+
+    添加prlimit64系统调用 (#438)
+  
+    注意: 目前仅支持读取默认的rlimit值,尚不支持设置rlimit值.
+
+commit 4a2d7191a3a6208b72e1d163c0235f566720f79a
+Author: LoGin <longjin@DragonOS.org>
+Date:   Sun Nov 12 17:53:36 2023 +0800
+
+    bugfix: 解决shell在exec的时候传递的argv不正确的bug (#437)
+
+commit 709498cac1f2134b2a5e089366ee7136ee029369
+Author: LoGin <longjin@DragonOS.org>
+Date:   Sun Nov 12 17:40:45 2023 +0800
+
+    feat: sys_readlink && sys_readlinkat (#436)
+
+commit be8cdf4b8edcd9579572672411f4489039dea313
+Author: LoGin <longjin@DragonOS.org>
+Date:   Sun Nov 12 16:36:17 2023 +0800
+
+    增加getrusage，并把apic timer的频率调整为系统HZ (#435)
+
+commit 02e249f30bfe08b8a5cde1226ca0161f9e370927
+Author: LoGin <longjin@DragonOS.org>
+Date:   Sun Nov 12 14:11:33 2023 +0800
+
+    添加uid、gid的系统调用（暴力封装返回0） (#434)
+
+commit ea8ad4d42e52016fe581a2451165146f109dfd6e
+Author: LoGin <longjin@DragonOS.org>
+Date:   Sun Nov 12 13:40:17 2023 +0800
+
+    修正fork的时候没有正确拷贝vm holes的bug (#433)
+
+commit c47fe90440fb7c6c82953e28a4b9597b22924758
+Author: LoGin <longjin@DragonOS.org>
+Date:   Thu Nov 9 18:20:27 2023 +0800
+
+    增加accept4系统调用 (#431)
+
+commit 393f691574844544e76231379e4938e9046be7b9
+Author: LoGin <longjin@DragonOS.org>
+Date:   Thu Nov 9 16:48:45 2023 +0800
+
+    增加gettid以及线程组group leader相关的逻辑 (#430)
+  
+    * 增加gettid以及线程组group leader相关的逻辑
+
+commit 0facf623d638816d7d01a700e19a52c3c16a8fa1
+Author: LoGin <longjin@DragonOS.org>
+Date:   Thu Nov 9 00:10:34 2023 +0800
+
+    修正文件open和写入的错误 (#429)
+  
+    1. 修正文件open的时候可能错误的把inode清空的问题(如果当前inode是mknod创建的)
+    2. 修正fat和block device中,对文件写入部分的错误问题
+
+commit 04babc3faba81997149ed11fda2ed03b4bbf4700
+Author: MemoryShore <105195940+MemoryShore@users.noreply.github.com>
+Date:   Wed Nov 8 21:42:51 2023 +0800
+
+    实现fat文件系统的truncate方法 (#428)
+
+commit df2f5051ac645f600f2aefcaff3a9608b2c0de3f
+Author: LoGin <longjin@DragonOS.org>
+Date:   Wed Nov 8 20:01:51 2023 +0800
+
+    添加read the docs yml文件 (#427)
+
+commit 5eaf536d5b81c234f9aea560e0c9d994fac3eb76
+Author: LoGin <longjin@DragonOS.org>
+Date:   Wed Nov 8 19:41:08 2023 +0800
+
+    添加初始化DragonOS的Rust-Musl工具链的脚本. (#426)
+
+commit 7b32f5080f42bcbf7d2421013f3ea53c776a063c
+Author: LoGin <longjin@DragonOS.org>
+Date:   Tue Nov 7 21:39:27 2023 +0800
+
+    增加内存分配日志监视器 (#424)
+  
+    * 完成内存日志监视，并输出日志到文件
+    * 修复进程退出后,procfs查看进程status文件会崩溃的问题
+    * 修复signal唤醒进程的判断条件问题
+
+commit 70a4e5550a9fb49b537092287c3ddc36448c5b78
+Author: LoGin <longjin@DragonOS.org>
+Date:   Tue Nov 7 20:32:06 2023 +0800
+
+    使用rust重写了apic的驱动 (#425)
+  
+    * 使用rust重写了apic的驱动。
+  
+    * 修正signal和调度器的部分加锁逻辑，增加回退策略。
+  
+    * 把pcb的flags字段替换为无锁的
+  
+    * 使用cargo管理apic的编译
+  
+    * 删除makefile中指定PIC的变量
+  
+    ---------
+  
+    Co-authored-by: Gou Ngai <ymd7823@outlook.com>
+    Co-authored-by: 櫻井桃華 <89176634+TihayaKousaka@users.noreply.github.com>
+
+commit 4935c74f326cd4e0854959c0ec8ab1d726c05e41
+Author: LoGin <longjin@DragonOS.org>
+Date:   Mon Nov 6 17:27:05 2023 +0800
+
+    添加自定义的crc库(支持crc64) (#423)
+
+commit 1effcfe519c06f04303340281fe9f62096184a74
+Author: GnoCiYeH <heyicong@dragonos.org>
+Date:   Sun Nov 5 23:15:46 2023 +0800
+
+    修复readdir以及读磁盘时buf传错问题 (#422)
+  
+    * 修复readdir以及读磁盘时buf传错问题
+  
+    * fix potential memory problem
+  
+    ---------
+  
+    Co-authored-by: longjin <longjin@DragonOS.org>
+
+commit 1603395155fc166de0ac5f80369526e196526ed2
+Author: GnoCiYeH <heyicong@dragonos.org>
+Date:   Sat Nov 4 21:39:44 2023 +0800
+
+    支持syscall快速系统调用指令 (#417)
+  
+    * 支持syscall快速系统调用指令
+  
+    ---------
+  
+    Co-authored-by: LoGin <longjin@DragonOS.org>
+
+commit 2f6f547ae05c19871138e558ba6943ff07f4c68c
+Author: GnoCiYeH <heyicong@dragonos.org>
+Date:   Sat Nov 4 21:35:25 2023 +0800
+
+    Patch fix sched (#419)
+  
+    1.解决waitqueue sleep的时候,由于preempt count不为0,导致sched失败,从而导致该waitqueue下一次wakeup时,会把pcb多次加入调度队列的bug
+    2.修复socket inode 的read和write方法里面没有使用no_preempt的问题
+    3. 修复cpu0的内核栈由于脏数据导致new_idle的时候set pcb报错的问题
+  
+    ---------
+  
+    Co-authored-by: longjin <longjin@DragonOS.org>
+
+commit 8058ccb307bbaf06a5810af32bcba3e41ab9fb93
+Author: LoGin <longjin@DragonOS.org>
+Date:   Fri Nov 3 21:01:09 2023 +0800
+
+    修复bootstrap.sh未能自动更换gcc镜像源, 未能自动安装docker的问题 (#418)
+
+commit d470019b1e675a04473cbb3c3eeaf180c8665e6d
+Author: LoGin <longjin@DragonOS.org>
+Date:   Wed Nov 1 22:12:19 2023 +0800
+
+    patch add mini backtrace (#416)
+  
+    * support rust panic backtrace
+  
+    mini-backtrace has llvm's unwind cpp source to support backtrace/unwind.
+    as unwind/backtrace needs dynamically allocates memory, mini-backtrace
+    uses stack memory to capture fixed number of backtrace to avoid heap
+    allocation.
+    as unwind library needed, it needs to turn on eh_frame_hdr
+  
+    * 修改忘了生成kernel.elf的问题
+  
+    * 设置backtrace是默认的feature
+  
+    ---------
+  
+    Co-authored-by: Yao Zhao <dragonlinux@gmail.com>
+
+commit 8b3d1688daac2aaf4e87403ecda5467a01464f81
+Author: yuyi2439 <68320855+yuyi2439@users.noreply.github.com>
+Date:   Wed Nov 1 21:11:55 2023 +0800
+
+    把pci驱动的读取acpi mcfg的代码，调整为从新的acpi驱动来读取 (#413)
+  
+    * 把pci驱动的读取acpi mcfg的代码，调整为从新的acpi驱动来读取
+
+commit 971462be94ba0a5c74af7a5f9653dfabd4932a63
+Author: GnoCiYeH <heyicong@dragonos.org>
+Date:   Wed Nov 1 20:55:57 2023 +0800
+
+    添加thread和futex机制 (#411)
+  
+    * 初步实现clone系统调用
+  
+    * 实现了线程，初步实现futex机制，添加了几个小的系统调用
+  
+    * 更改pcb引用计数问题
+  
+    * 解决死锁bug
+  
+    ---------
+  
+    Co-authored-by: LoGin <longjin@DragonOS.org>
+
+commit 665f4a7707e33f3b4d2fde77113fa3d13b5b52c4
+Author: Chiichen <39649411+Chiichen@users.noreply.github.com>
+Date:   Wed Nov 1 14:18:00 2023 +0800
+
+    更新了使用clangd的.gitignore (#415)
+  
+    Co-authored-by: chiichen <chiichen@qq.com>
+
+commit 77799ccaaca276fe127448d169f0e035837cce44
+Author: Wu Mianzhi <31810920+Hdksg10@users.noreply.github.com>
+Date:   Mon Oct 30 00:08:52 2023 +0800
+
+    完成e1000e驱动 (#393)
+  
+    * 测试RESET
+  
+    * 测试RESET
+  
+    * 基于轮询的实现
+  
+    * 规范化部分unsafe的使用
+  
+    * 完成中断处理函数，同时去除了不必要的内存拷贝行为，准备编写napi机制
+  
+    * 实现现有协议栈下的部分napi机制；修复了内存泄漏的问题；添加了一部分代码注释
+  
+    * 去除部分无用代码
+  
+    * 去除一些无用代码
+  
+    * 适配新的驱动模型
+  
+    * 完成msi中断测试
+  
+    * 去除一些无用代码
+  
+    * 格式化代码
+  
+    * 增加了一些注释，提高代码可读性
+  
+    * 去除无关文件
+  
+    * 优化了读取mac地址的方式，提高可读性
+
+commit fbe6becd6dd3cd72643707e0088f20364ac1b166
+Author: LoGin <longjin@DragonOS.org>
+Date:   Thu Oct 26 23:08:39 2023 +0800
+
+    添加rust重构版本的HPET驱动和tsc驱动,并使用HPET校准tsc频率和cpu总线频率 (#412)
+  
+    * 添加rust重构版本的HPET驱动和tsc驱动,并使用HPET校准tsc频率和cpu总线频率
+  
+    * 把hpet.c移动到arch文件夹下
+
+commit ad1d649eddee4aa8ac81b2f44bc99da462a6a813
+Author: GnoCiYeH <heyicong@dragonos.org>
+Date:   Tue Oct 24 19:59:01 2023 +0800
+
+    更新系统调用号 (#410)
+  
+    * 更新系统调用号
+  
+    * 更改DragonReach和relibc版本
+  
+    * update
+  
+    * update
+  
+    * fix warning
+  
+    ---------
+  
+    Co-authored-by: longjin <longjin@RinGoTek.cn>
+
+commit f4082b86b15989a1d43e62050c6ba9b363c91ece
+Author: LoGin <longjin@DragonOS.org>
+Date:   Tue Oct 24 16:40:49 2023 +0800
+
+    更改系统调用的寄存器传参顺序 (#409)
+
+commit 40314b30ab2a7e1fd06a05a00f693e644e446035
+Author: Xiaoye Zheng <xiaoyez@zju.edu.cn>
+Date:   Tue Oct 24 14:31:56 2023 +0800
+
+    DragonOS虚拟化 (#389)
+  
+    * try some ioctl flow & kvm device
+  
+    * add sys ioctl
+  
+    * 删掉一些debug信息
+  
+    * 修改run-qemu.sh脚本，在QEMU中enable vmx
+  
+    * 修改cr0,cr4,msr寄存器enable VMX operations
+  
+    * enable vmx operation
+  
+    * allocate memory for vmcs with bug
+  
+    * allocate memory for vmcs
+  
+    * cpu virt-50%
+  
+    * single vcpu virt
+  
+    * add vmcs fields
+  
+    * CPU virt overall flow with bug
+  
+    * run vmlaunch success
+  
+    * run CPU virt with bug
+  
+    * 成功运行non-root模式的guest
+  
+    * 成功运行vmexit,进入vmx_return函数
+  
+    * 成功运行vmlaunch, vmexit, vmresume
+  
+    * vmexit handler with bug
+  
+    * 完成vmexit cpuid handler
+  
+    * fix vmresume guest状态恢复的bug
+  
+    * 增加vm ioctl
+  
+    * refactor kvm 50%
+  
+    * refactor kvm 80%
+  
+    * FIXME: kvm vmlaunch failed
+  
+    * vmlaunch success
+  
+    * FIXME: output error
+  
+    * update guest_rsp
+  
+    * cpu virt refactor
+  
+    * add mmu related struct
+  
+    * add usermemory region workflow
+  
+    * add mem-virt workflow
+  
+    * add mem-virt
+  
+    * refactor code
+  
+    * add vcpu ioctl set_regs
+  
+    * rename hypervisor to vm & solve some deadlock bugs
+  
+    * workout mem pipeline
+  
+    * fix vmcs control setting bugs
+  
+    * refactor segment regs initialization
+  
+    * resovle conficts
+  
+    * resovle conficts
+  
+    * format code
+
+commit 485e2487616b1d33776b63724d4abc1ae8f506e8
+Author: LoGin <longjin@DragonOS.org>
+Date:   Tue Oct 24 14:19:26 2023 +0800
+
+    修改脚本,只有当磁盘未安装Grub的时候,才执行grub-install. 节省编译时间 (#408)
+
+commit 46795849a29eef77fd6f7af548d05ee6e654c5bb
+Author: LoGin <longjin@DragonOS.org>
+Date:   Tue Oct 24 13:56:57 2023 +0800
+
+    修复bootstrap.sh安装顺序导致的问题 (#407)
+
+commit 3c82aa56d1b784ea7371100b3e906365be8332fd
+Author: Chiichen <39649411+Chiichen@users.noreply.github.com>
+Date:   Tue Oct 24 12:02:20 2023 +0800
+
+    Signal refactor (#402)
+  
+    * 初步完成对 signal_types 和 部分signal代码的初始化
+  
+    * 重构了一部分架构相关代码进入 arch 中
+  
+    * 基本修改完成，编译通过，后续补上系统调用
+  
+    * signal基本完成，能实现 Sigaction 系统调用
+  
+    * 增加了一组枚举抽象
+  
+    * 进一步重构了一部分C风格的代码
+  
+    * 继续重构了一部分C风格代码
+  
+    * 继续完善了一部分逻辑
+  
+    * 修改了部分代码逻辑
+  
+    * 补充了 fork 中复制信号信息的逻辑
+  
+    * 修复了 kallsysms 未转义引号的问题
+  
+    * 修复了无法跳转到 sigreturn 的bug
+  
+    * 调通了 signal
+  
+    * 实现了 signal 架构抽象层的 trait
+  
+    * 为信号提供了默认处理函数
+  
+    * 基本完成了 signal 的大体逻辑
+  
+    * 修复了 Sigreturn 的一个小错误，格式化
+  
+    * 修复了一个编译器漏报错误
+  
+    * 删除了多余的代码
+  
+    * 修改测试程序为链接 relibc
+  
+    * 修复了信号处理过程中浮点寄存器错误保存的问题
+  
+    * 修复了一个结构体错误引起的无法在relibc下正确运行的错误
+  
+    * 修复了链接 relibc 时无法正常从信号处理返回的 bug
+  
+    * 修复了 signal 处理流程中 rsp 指针错误导致的浮点运算触发GP
+  
+    * 修复了一个死锁问题，解决了默认处理函数无法进入调度导致的bug
+  
+    * 修复了一些错误
+  
+    * 修改了 relibc 依赖版本号
+  
+    * 删除了多余的 imports
+  
+    * 删除一些debug日志
+  
+    * 删除内核 signal.h 文件
+  
+    * 删除一个依赖项
+  
+    * 删除了 binding 相关依赖项
+
+commit d7f5742a206c6c25ed30009796eb8248429f0a1e
+Author: LoGin <longjin@DragonOS.org>
+Date:   Mon Oct 23 21:40:39 2023 +0800
+
+    初步编写cpu信息获取的代码 (#406)
+  
+    1. 启动时从acpi获取所有的cpu信息并存到SMP_BOOT_DATA
+    2. 注册cpu subsystem/bus到sysfs(暂时未添加内容)
+  
+    todo:
+    1. build_cpu_map(在X86_64SmpManager中)
+    2. 实现cpu mask
+    3. 把cpu设备注册到sysfs
+
+commit 7eda31b2f07c6ef41dc0d2bd13051f0fce5e5976
+Author: LoGin <longjin@DragonOS.org>
+Date:   Sun Oct 22 22:00:16 2023 +0800
+
+    在Sysfs中引入ACPI Firmware (#405)
+  
+    - bugfix: multiboot2启动的信息因为没及时转存导致后面无法从其中进行查询的bug
+    - feature: 把acpi表、acpi bus加入sysfs
+
+commit 01bd5258cf467326819c77584713fbc6ffe4fb32
+Author: LoGin <longjin@DragonOS.org>
+Date:   Sun Oct 22 12:22:41 2023 +0800
+
+    解决shell无法输入大写字母'P'的问题 (#404)
+
+commit a03c4f9dee5705207325c56629c0ccd219168f10
+Author: LoGin <longjin@DragonOS.org>
+Date:   Fri Oct 20 22:11:33 2023 +0800
+
+    设备驱动模型：完善platform bus相关内容。并注册串口到sysfs (#403)
+  
+    * 完成初始化platform bus
+    * 删除旧的sysfs
+    * 把uart驱动移动到tty/serial文件夹下
+    * 完成将串口挂载到sysfs
+    * 修复vfs系统调用未能follow symlink的问题
+    * 修复shell未能正确获取pwd的问题
+
+commit 06d5e247267cb65b84a80f219853ccd0f384b16e
+Author: LoGin <longjin@DragonOS.org>
+Date:   Wed Oct 11 00:53:15 2023 +0800
+
+    完善设备驱动模型，基于kset、kobj来维护对象之间的关系 (#401)
+  
+    * 使用kobj和kset管理/sys文件夹下的对象
+  
+    * 修改notifier，把action从u64换为泛型。
+  
+    * 完善设备驱动模型，基于kset、kobj来维护对象之间的关系
+
+commit 6abb8bd7c0ee7746f0b6cf682a0c4d112a2ef6a3
+Author: LoGin <longjin@DragonOS.org>
+Date:   Mon Oct 9 01:55:58 2023 +0800
+
+    在github workflow的工具链配置文件里面添加rust-src组件 (#400)
+
+commit 9e9ffedfc59cd89f4cdbd7984abbb2ac19ea9575
+Author: Plucky923 <107762234+Plucky923@users.noreply.github.com>
+Date:   Mon Oct 9 01:11:14 2023 +0800
+
+    syscall: 完善syscall代码 (#387)
+  
+    * syscall: 完善syscall代码
+  
+    修改代码使这段代码可以使用语法糖。修改SYS_READ和SYS_WRITE的安全检查为userbuffer
+  
+    Signed-off-by: plucky <m202372036@hust.edu.cn>
+  
+    * syscall: 修改SYS_READ和SYS_WRITE的权限检查为userbuffer
+  
+    Signed-off-by: plucky <m202372036@hust.edu.cn>
+  
+    * syscall: 有不知道如何修改的错误
+  
+    Signed-off-by: plucky <m202372036@hust.edu.cn>
+  
+    * syscall: 修改SYS_READ和SYS_WRITE并编译通过
+  
+    Signed-off-by: plucky <m202372036@hust.edu.cn>
+
+commit 865f4ba4cdce23b154844d6d297f75033f3dcf70
+Author: GnoCiYeH <heyicong@dragonos.org>
+Date:   Mon Oct 9 01:10:14 2023 +0800
+
+    修改shell执行exec时传参错误问题 (#399)
+  
+    * 修改shell执行exec时传参错误问题
+
+commit b7b843beddea12cdedda90f6129b7c9980876112
+Author: GnoCiYeH <heyicong@dragonos.org>
+Date:   Mon Oct 9 00:58:08 2023 +0800
+
+    wait4系统调用支持options字段 (#398)
+
+commit 2dbef7859f0af395ccec348f17cf0b79ed56e003
+Author: GnoCiYeH <heyicong@dragonos.org>
+Date:   Mon Oct 9 00:28:08 2023 +0800
+
+    命名管道系统调用以及文件系统兼容特殊文件类型的接口 (#397)
+  
+    * 修复pipe2在读端或写端关闭后还阻塞问题。
+  
+    * 实现命名管道机制，增加特殊文件类型兼容普通文件系统的接口。
+  
+    * 普通文件系统能够适配特殊文件(命名管道等)
+
+commit 34e6d6c80f36494088db3284f85d1a2c63aa18a8
+Author: yuyi2439 <68320855+yuyi2439@users.noreply.github.com>
+Date:   Sun Oct 8 14:26:17 2023 +0800
+
+    实现free指令+修复 mountfs的内存泄露问题(#394)
+  
+    * 实现meminfo文件
+  
+    * 成功实现free指令，添加了一些string有关函数，并进行一些无影响的小改动
+  
+  
+    * 解决内存泄露的问题：mountfs inode的wrap方法使用了Arc::into_raw而没有from_raw，导致inode始终无法释放
+  
+    ---------
+  
+    Co-authored-by: LoGin <longjin@DragonOS.org>
+    Co-authored-by: longjin <longjin@RinGoTek.cn>
+
+commit afc95d5c2541c27c762091ad38fdffabe355db5a
+Author: YJwu2023 <yujianwu2019@gmail.com>
+Date:   Tue Oct 3 12:09:29 2023 +0800
+
+    完善pci中断的设计 (#392)
+  
+    * 完善pci中断的设计
+
+commit 876cb89ecf7c1bf1646bfc392efcbafacad2262f
+Author: GnoCiYeH <heyicong@dragonos.org>
+Date:   Tue Oct 3 12:03:34 2023 +0800
+
+    修复pipe2在读端或写端关闭后还阻塞问题 (#396)
+  
+    * 修复pipe2在读端或写端关闭后还阻塞问题。
+  
+    * update
+  
+    * update
+  
+    * 修改cloexec
+  
+    ---------
+  
+    Co-authored-by: longjin <longjin@RinGoTek.cn>
+
+commit fba5623183378da6b120caafca120615328efa2e
+Author: LoGin <longjin@DragonOS.org>
+Date:   Mon Oct 2 20:46:19 2023 +0800
+
+    引入intertrait库，支持trait之间的互相转换 (#395)
+  
+    * 能过编译（test还没法跑）
+  
+    * 初始化intertrait转换库
+  
+    * update license of intertrait
+
+commit bb0e4d4131046a69bbccdc0cdf1d5db51a2c6126
+Author: GnoCiYeH <heyicong@dragonos.org>
+Date:   Sat Sep 30 16:36:06 2023 +0800
+
+    使用DragonReach启动shell，修改getdents (#391)
+  
+    * 使用DragonReach启动shell，修改getdents
+  
+    * 更改关闭pipe时断言报错问题，以及DragonReach启动shell阶段版本
+  
+    * 修改目录结构
+  
+    * update
+  
+    * 解决小问题
+  
+    * 调整dragon reach版本号
+  
+    * 设置make clean的时候不清空应用程序的缓存。
+    指定relibc版本号
+  
+    ---------
+  
+    Co-authored-by: longjin <longjin@RinGoTek.cn>
+
+commit 0dd8ff43325b494ea777dbe6e552fdc77b9dabc8
+Author: YJwu2023 <yujianwu2019@gmail.com>
+Date:   Thu Sep 21 23:23:57 2023 +0800
+
+    添加中断 (#370)
+  
+    * 添加中断
+  
+    * dhcp更改为全局socketset
+  
+    * 解决异常中断的问题，使得能够使用中断来处理网卡数据
+  
+    ---------
+  
+    Co-authored-by: longjin <longjin@RinGoTek.cn>
+
+commit 6b4e7a2972cc06663754c0e35a0e541987006fa4
+Author: LoGin <longjin@DragonOS.org>
+Date:   Tue Sep 19 19:46:59 2023 +0800
+
+    增加kernfs (#386)
+  
+    * 增加kernfs
+  
+    * kernfs文档
+
+commit ae5ede03bebe5c4b593ad7a350f0945f1367be7c
+Author: LoGin <longjin@DragonOS.org>
+Date:   Mon Sep 18 07:38:04 2023 +0800
+
+    bugfix: bus/device manager对卸载逻辑的处理错误 (#385)
+  
+    * 移动位置
+  
+    * bugfix: bus/device manager对卸载逻辑的处理错误
+
+commit 7ae679ddd6481897a86523a52fad3b060254fa5b
+Author: LoGin <longjin@DragonOS.org>
+Date:   Sun Sep 17 15:41:01 2023 +0800
+
+    ahci内存越界问题修复+ mm的bug修复+在rust中解析acpi table (#384)
+  
+    * bugfix: 修复了Flusher Drop的时候没有自动刷新TLB的bug
+  
+    * 解决进程管理未初始化时，trap.c尝试打印pid导致错误的问题
+  
+    * 设置kmalloc默认强制清0
+  
+    * 修复ahci驱动的内存越界问题
+    * 修复mmio buddy忘记归还buddy block的问题
+    * 新增acpi模块,暂时能解析acpi tables
+
+commit 11110997465e858757da54b5ce28d7c22690aaff
+Author: hanjiezhou <zhouhanjie@dragonos.org>
+Date:   Sat Sep 16 20:14:56 2023 +0800
+
+    修改 tty 中resize bug (#383)
+
+commit 71474bc6829b3cd831df7ce24ea059557996524d
+Author: LoGin <longjin@DragonOS.org>
+Date:   Sat Sep 16 16:16:43 2023 +0800
+
+    修复drop fd时，文件描述符引用不为0的问题 (#382)
+
+commit de71ec259cd21c782f4031b01635eb8ad3df1943
+Author: LoGin <longjin@DragonOS.org>
+Date:   Fri Sep 15 19:44:11 2023 +0800
+
+    修正由于init proc union导致的无法运行的问题 && 修正由于内核线程启动后默认sleep的行为导致init进程无法正常运行的bug (#381)
+  
+    1. 修正由于init proc union导致的无法运行的问题
+    2. 修正由于内核线程启动后默认sleep的行为导致init进程无法正常运行的bug
+
+commit 1496ba7b24a5e6954291ca9643b9f3cec567479a
+Author: LoGin <longjin@DragonOS.org>
+Date:   Fri Sep 15 14:58:19 2023 +0800
+
+    进程管理模块重构完成 (#380)
+  
+    * 添加新版pcb的数据结构 (#273)
+  
+    * 将pcb中的内容分类，分别加锁 (#305)
+  
+    * 进程管理重构：完成fork的主体逻辑 (#309)
+  
+    1.完成fork的主体逻辑
+    2.将文件系统接到新的pcb上
+    3.经过思考,暂时弃用signal机制,待进程管理重构完成后,重写signal机制.原因是原本的signal机制太烂了
+  
+    * chdir getcwd pid pgid ppid (#310)
+  
+  
+    ---------
+  
+    Co-authored-by: longjin <longjin@RinGoTek.cn>
+  
+    * 删除旧的fork以及signal的代码，并调整fork/vfork/execve系统调用 (#325)
+  
+    1.删除旧的fork
+    2.删除signal相关代码,等进程管理重构结束之后,再重新写.
+    3.调整了fork/vfork/execve系统调用
+  
+    * 实现切换进程的代码 (#331)
+  
+  
+  
+    * 实现切换进程的代码
+  
+    * Patch modify preempt (#332)
+  
+    * 修改设置preempt的代码
+  
+    * 删除rust的list和refcount
+  
+    * 为每个核心初始化idle进程 (#333)
+  
+    * 为每个核心初始化idle进程
+  
+    * 完成了新的内核线程机制 (#335)
+  
+    * 调度器的pcb替换为新的Arc<ProcessControlBlock>，把调度器队列锁从 RwSpinLock 替换为了 SpinLock (#336)
+  
+    * 把调度器的pcb替换为新的Arc<ProcessControlBlock>
+  
+    * 把调度器队列锁从 RwSpinLock 替换为了 SpinLock ，修改了签名以通过编译
+  
+    * 修正一些双重加锁、细节问题
+  
+    ---------
+  
+    Co-authored-by: longjin <longjin@RinGoTek.cn>
+  
+    * github workflow自动检查代码是否格式化
+  
+    * cache toolchain yml
+  
+    * 调整rust版本的waitqueue中的pcb为新版的pcb (#343)
+  
+    * 解决设置rust workspace带来的“工具链不一致”的问题 (#344)
+  
+  
+    * 解决设置rust workspace带来的“工具链不一致”的问题
+  
+    更改workflow
+  
+    * 调整pcb的sched_info和rwlock，以避免调度器死锁问题 (#341)
+  
+    * 调整pcb的sched_info和rwlock，以避免调度器死锁问题
+  
+    * 修改为在 WriterGuard 中维护 Irq_guard
+  
+    * 修正了 write_irqsave方法
+  
+    * 优化了代码
+  
+    * 把 set state 操作从 wakup 移动到 sched_enqueue 中
+  
+    * 修正为在 wakeup 中设置 running ，以保留 set_state 的私有性
+  
+    * 移除了 process_wakeup
+  
+    * 实现进程退出的逻辑 (#340)
+  
+    实现进程退出的逻辑
+  
+    * 标志进程sleep
+  
+    * 修复wakeup的问题
+  
+    ---------
+  
+    Co-authored-by: longjin <longjin@RinGoTek.cn>
+  
+    * rust 重构 completion (#350)
+  
+    * 完成了completion的基本结构，待完善上级调用
+  
+    * 用SpinLock保护结构体并发安全
+  
+    * 修改原子变量为u32，修复符号错误
+  
+    * irq guard
+  
+    * 修改为具有内部可变性的结构体
+  
+    * temp fix
+  
+    * 修复了由于进程持有自旋锁导致的不被调度的问题
+  
+    * 对 complete 系列方法上锁，保护 done 数据并发安全
+  
+    * 移除了未使用的依赖
+  
+    * 重写显示刷新驱动 (#363)
+  
+    * 重构显示刷新驱动
+  
+    * Patch refactor process management (#366)
+  
+    * 维护进程树
+  
+    * 维护进程树
+  
+    * 更改代码结构
+  
+    * 新建进程时，设置cwd
+  
+    * 调整adopt childern函数，降低开销
+  
+    ---------
+  
+    Co-authored-by: longjin <longjin@RinGoTek.cn>
+  
+    * waitqueue兼容C部分 (#351)
+  
+    * PATH
+  
+    * safe init
+  
+    * waitqueue兼容C部分
+  
+    * waitqueue兼容C部分
+  
+    * 删除semaphore.c,在ps2_keyboard中使用waitqueue
+  
+    * 删除semaphore.c,在ps2_keyboard中使用waitqueue
+  
+    * current_pcb的C兼容
+  
+    * current_pcb的C兼容
+  
+    * current_pcb的C兼容
+  
+    * fmt
+  
+    * current_pcb的兼容
+  
+    * 针对修改
+  
+    * 调整代码
+  
+    * fmt
+  
+    * 删除pcb的set flags
+  
+    * 更改函数名
+  
+    ---------
+  
+    Co-authored-by: longjin <longjin@RinGoTek.cn>
+  
+    * merge master
+  
+    * Patch debug process management refactor (#372)
+  
+    * 能够调通，执行完textui_init
+  
+    * 能跑到initial kernel thread
+  
+    * fmt
+  
+    * 能够正常初始化所有服务（尚未能切换到用户程序）
+  
+    * 删除部分无用的extern
+  
+    * 存在问题：ap处理器启动后，bsp的smp_init函数return之后就出错了，怀疑是栈损坏
+  
+    * 解决smp启动由于未换栈导致的内存访问错误
+  
+    * debug
+  
+    * 1
+  
+    * 1
+  
+    * lock no preempt
+  
+    * 调通
+  
+    * 优化代码，删除一些调试日志
+  
+    * fix
+  
+    * 使用rust重写wait4 (#377)
+  
+    * 维护进程树
+  
+    * 维护进程树
+  
+    * 更改代码结构
+  
+    * 新建进程时，设置cwd
+  
+    * 调整adopt childern函数，降低开销
+  
+    * wait4
+  
+    * 删除c_sys_wait4
+  
+    * 使用userbuffer保护裸指针
+  
+    ---------
+  
+    Co-authored-by: longjin <longjin@RinGoTek.cn>
+  
+    * 消除warning
+  
+    * 1. 修正未设置cpu executing的问题
+  
+    * 修正kthread机制可能存在的内存泄露问题
+  
+    * 删除pcb文档
+  
+    * 删除C的tss struct
+  
+    ---------
+  
+    Co-authored-by: Bullet <93781792+GP-Bullet@users.noreply.github.com>
+    Co-authored-by: Chiichen <39649411+Chiichen@users.noreply.github.com>
+    Co-authored-by: hanjiezhou <zhouhanjie@dragonos.org>
+    Co-authored-by: GnoCiYeH <118462160+GnoCiYeH@users.noreply.github.com>
+    Co-authored-by: houmkh <1119644616@qq.com>
+
+commit b087521e07f601b30e3d48df788fcc2f09f19566
+Author: Chiichen <39649411+Chiichen@users.noreply.github.com>
+Date:   Wed Sep 13 18:01:52 2023 +0800
+
+    完善设备驱动模型&调试串口驱动 (#379)
+  
+    * 完成了基本架构重构，正在进行兼容
+  
+    * 重构了所有 Device Driver ，还没有接上具体设备
+  
+    * 基本把 Uart 接上了，还没有测试
+  
+    * 初步完成系统设备初始化
+  
+    * 初步重构 BlockDevice ，使其兼容新的 Device 结构
+  
+    * 修改文件系统内的部分函数调用以满足重构后的接口
+  
+    * 测试完 Uart 设备的功能
+  
+    * 移除了自动添加的文件
+  
+    * 修复了 warning 和部分格式
+  
+    * 解决warning，并且修正sysfs初始化的位置
+  
+    * Patch fix
+  
+    * 删除了 sysinfo 的默认实现
+  
+    * 删除了字符设备读写的 offset 参数
+  
+    * 修复了 warning 和一些小逻辑错误
+  
+    ---------
+  
+    Co-authored-by: longjin <longjin@RinGoTek.cn>
+
+commit 9029414af2089cbe7d2d2097be2e116c09beb6dd
+Author: zhaoyao73 <zhaoyao73@users.noreply.github.com>
+Date:   Wed Sep 13 01:49:03 2023 -0400
+
+    use demangled names (#375)
+  
+    there is no change for c symbols
+      rust symbols name will be more readable
+
+commit 22c9db312a5f02b48a1bf7853dc53434da65e28a
+Author: hanjiezhou <zhouhanjie@dragonos.org>
+Date:   Wed Sep 13 00:58:01 2023 +0800
+
+    Patch pipe2 (#364)
+
+commit 68312d3c68b9df288589f9636417745d46520ad2
+Author: Xshine <gshine@m.scnu.edu.cn>
+Date:   Wed Sep 13 00:26:41 2023 +0800
+
+    修正造成 http server 的错误 (#378)
+  
+    * 修正造成 http server 的错误
+
+commit 285de542f3ddb09bfdcad0a7022bd722f4f1cace
+Author: zhaoyao73 <zhaoyao73@users.noreply.github.com>
+Date:   Wed Sep 6 06:08:52 2023 -0400
+
+    modify kernel link script (#373)
+  
+    put rust text between _text and _etext, so rust symbols are included in
+    kallsyms, traceback could use them.
+  
+    modify grub_auto_install.sh to add arch linux support
+
+commit 3b0bf43bbb196a74a64cee8ecd2d4eb884c5e9ee
+Author: zhaoyao73 <zhaoyao73@users.noreply.github.com>
+Date:   Mon Sep 4 00:57:52 2023 -0400
+
+    fix compiler warnings in pci_irq.c (#371)
+  
+    Co-authored-by: Yao Zhao <dragonlinux@gmail.com>
+
+commit 607783d7414735d1dc54afb0c7346ed8e13303a2
+Author: zhaoyao73 <zhaoyao73@users.noreply.github.com>
+Date:   Sun Sep 3 01:36:02 2023 -0400
+
+    fix pci_irq.c - memory leak - wrong irq_name allocated length (#367)
+  
+    add function declaration to avoid compiling warning
+  
+    add extra packages need for build
+  
+    Co-authored-by: Yao Zhao <dragonlinux@gmail.com>
+
+commit d9113303d8e1d449a122f7a5f66453fbe7c26a46
+Author: LoGin <longjin@DragonOS.org>
+Date:   Sun Sep 3 13:33:27 2023 +0800
+
+    relibc与旧的C库同时开始编译 (#369)
+
+commit 4895ff6968ae8f24c7a0d55dce6ae23082d60e3b
+Author: yuyi2439 <68320855+yuyi2439@users.noreply.github.com>
+Date:   Sat Sep 2 00:27:41 2023 +0800
+
+    fix: DragonOS-Community/DragonOS#358 (#361)
+
+commit 8479f19979aa9ddc4e383651cc56a7a24bd94e21
+Author: GnoCiYeH <118462160+GnoCiYeH@users.noreply.github.com>
+Date:   Fri Sep 1 21:46:36 2023 +0800
+
+    添加rust-gdb调试内核文档 (#357)
+  
+    * 编写使用GDB调试内核文档
+
+commit 863a3cff06e618a5f0fc03920dfd5732452344c9
+Author: LoGin <longjin@DragonOS.org>
+Date:   Thu Aug 31 20:25:00 2023 +0800
+
+    添加与rust std接口相同的once库 (#353)
+
+commit a3ef8f8ad5248e3424113871950eb9c80eeeb99e
+Author: GnoCiYeH <118462160+GnoCiYeH@users.noreply.github.com>
+Date:   Thu Aug 31 19:52:32 2023 +0800
+
+    修改RamFS目前存在的BUG (#354)
+  
+    * 修改RamFS目前存在的BUG
+
+commit c757940bd61b0125e037a59eb77565e42470201b
+Author: YJwu2023 <yujianwu2019@gmail.com>
+Date:   Thu Aug 31 17:54:49 2023 +0800
+
+    优化makefile (#352)
+
+commit 2dd9f0c7503d1a325713764fedbce06fcab3a06b
+Author: LoGin <longjin@DragonOS.org>
+Date:   Mon Aug 28 15:54:52 2023 +0800
+
+    mmio buddy新增guard，把映射的职责交由其守卫进行处理，并且守卫被drop的时候自动释放内存 (#346)
+  
+    * mmio buddy新增guard，把映射的职责交由其守卫进行处理，并且守卫被drop的时候自动释放内存
+
+commit 8d94ea66a3eb3e02039730c8d08e9bead8c344b8
+Author: YJwu2023 <yujianwu2019@gmail.com>
+Date:   Mon Aug 28 15:43:07 2023 +0800
+
+    Patch ahci (#348)
+  
+    * Modify the ahci module and delete the useless c code
+  
+    修改ahci使其不再依赖旧的pci函数
+    删除旧的pci、msi函数代码
+
+commit f5df0e79c67a9508bc6a50fccded9dec78e7ed9d
+Author: LoGin <longjin@DragonOS.org>
+Date:   Mon Aug 28 15:29:00 2023 +0800
+
+    解决userbufferwriter的长度错误问题，并修复gettimeofday的pagefault问题 (#349)
+  
+    * 解决userbufferwriter的长度错误问题，并修复gettimeofday的pagefault问题
+
+commit ddb9d91712b6e87aa15b9cc4a8fdec8ae0996a5e
+Author: Xshine <gshine@m.scnu.edu.cn>
+Date:   Sun Aug 27 15:54:19 2023 +0800
+
+    将 io 移动至 vfs 目录，并修正引用路径 (#339)
+  
+    * 将 io 移动至 vfs 目录，并修正引用路径
+  
+    * fix bug in makefile
+
+commit e92d02281005bac31fe80e9070ac4a2a6cef0419
+Author: LoGin <longjin@DragonOS.org>
+Date:   Sat Aug 26 21:36:13 2023 +0800
+
+    解决设置rust workspace带来的“工具链不一致”的问题 (#345)
+  
+    更改workflow
+
+commit 9a367aa7eb1576a235f5f52ee542132a1e5e39df
+Author: LoGin <longjin@DragonOS.org>
+Date:   Thu Aug 24 18:50:52 2023 +0800
+
+    添加github workflow，检查代码是否已经格式化 (#342)
+  
+    * 添加github workflow，检查代码是否已经格式化
+
+commit f09a98329c4ec77010de86d126516310b407455a
+Author: LoGin <longjin@DragonOS.org>
+Date:   Wed Aug 23 16:09:29 2023 +0800
+
+    1. 修复bootstrap.sh在安装libssl-dev之前，安装dadk，从而导致错误的问题 (#338)
+  
+    1. 修复bootstrap.sh在安装libssl-dev之前，安装dadk，从而导致错误的问题
+    2. 构建系统的文档，补充对vnc端口的说明
+
+commit 4537ffb7e9afb2d96f2adcee32c8ac84b056d2e5
+Author: Chiichen <39649411+Chiichen@users.noreply.github.com>
+Date:   Mon Aug 21 18:37:31 2023 +0800
+
+    实现了对用户空间传入指针抽象的UserBufferReader/Writer，来检验用户空间指针地址并提供一定的功能抽象 (#326)
+  
+    * 构建了 Userbuffer 对用户空间传入的指针进行了抽象，并提供了读写操作
+  
+    * 分成了Reader和Writer，增加了从地址读和写入到指定地址的功能
+  
+    * 删除了多余的注释
+  
+    * 增加了直接获取BufferWriter切片的函数
+  
+    * 通过 where 的一个 Trick 实现了 const generic 和后续功能
+  
+    * 替换为了 core::slice::align_to 实现&[u8}转&[T]
+  
+    * 移除了 userbuffer.rs
+  
+    * 提供了独立获取缓冲区中不同偏移量位置的数据的函数
+  
+    * 替换了部分系统调用(还未测试
+  
+    * 简化了代码
+  
+    * 修复内存越界的bug
+  
+    ---------
+  
+    Co-authored-by: longjin <longjin@RinGoTek.cn>
+
+commit abe3a6ea3c543425e2cad12722e8a658b324d515
+Author: hanjiezhou <zhouhanjie@dragonos.org>
+Date:   Sun Aug 20 00:19:36 2023 +0800
+
+    Patch refactor scm and textui (#289)
+  
+    * 重构屏幕管理器和textui框架
+  
+    * 切换字体为spleen，并增加对字体的抽象
+  
+    * 修正文档
+  
+    ---------
+  
+    Co-authored-by: longjin <longjin@RinGoTek.cn>
+
+```

docs/locales/en/community/ChangeLog/index.rst

@@ -0,0 +1,32 @@
+.. note:: AI Translation Notice
+
+   This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+   - Source document: community/ChangeLog/index.rst
+
+   - Translation time: 2025-05-19 01:41:22
+
+   - Translation model: `Qwen/Qwen3-8B`
+
+
+   Please report issues via `Community Channel <https://github.com/DragonOS-Community/DragonOS/issues>`_
+
+Release Notes
+=====================
+
+This is the release log for DragonOS, which records the update content of every version of DragonOS.
+
+..  toctree::
+    :maxdepth: 1
+
+    V0.1.x/V0.1.10
+    V0.1.x/V0.1.9
+    V0.1.x/V0.1.8
+    V0.1.x/V0.1.7
+    V0.1.x/V0.1.6
+    V0.1.x/V0.1.5
+    V0.1.x/V0.1.4
+    V0.1.x/V0.1.3
+    V0.1.x/V0.1.2
+    V0.1.x/V0.1.1
+    V0.1.x/V0.1.0

docs/locales/en/community/code_contribution/c-coding-style.md

@@ -0,0 +1,173 @@
+:::{note}
+**AI Translation Notice**
+
+This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+- Source document: community/code_contribution/c-coding-style.md
+
+- Translation time: 2025-05-19 01:42:01
+
+- Translation model: `Qwen/Qwen3-8B`
+
+Please report issues via [Community Channel](https://github.com/DragonOS-Community/DragonOS/issues)
+
+:::
+
+# C Language Code Style
+
+  This document will briefly introduce the C language code style used in DragonOS. It is completely normal for each person to have their own code style. However, for the maintainability of an open-source project, we hope to establish some code standards so that every developer, including you, can feel more comfortable when reading the code. A project filled with various code styles is difficult to maintain.
+
+  We propose some recommendations here, and we hope you will follow them as much as possible. These recommendations are similar to those of Linux, but with some differences. DragonOS uses Linux's style for variable naming; for indentation, DragonOS uses Microsoft's style.
+
+## 0. Code Formatter
+
+  Before we present the following recommendations, we recommend that you use the `C/C++ Extension Pack` plugin in Visual Studio Code as a code formatter during development. These plugins provide good auto-formatting functionality, ensuring that your code's basic format meets DragonOS's requirements.
+
+  Pressing `Ctrl+shift+I` or your set code formatting shortcut frequently while coding can help you maintain good code formatting consistently.
+
+## 1. Indentation
+
+  The width of a tab is equal to 4 spaces. Code indentation is based on the tab width (usually 4 characters in most editors).
+
+  This makes your code more readable and helps better identify the control structures in the code. This can avoid many unnecessary troubles!
+
+For example: In a switch statement, place the switch and case on the same indentation level. And indent each case's code by one tab to the right. This improves code readability.
+
+```c
+switch (cmd)
+{
+case AHCI_CMD_READ_DMA_EXT:
+    pack->blk_pak.end_handler = NULL;
+    pack->blk_pak.cmd = AHCI_CMD_READ_DMA_EXT;
+    break;
+case AHCI_CMD_WRITE_DMA_EXT:
+    pack->blk_pak.end_handler = NULL;
+    pack->blk_pak.cmd = AHCI_CMD_WRITE_DMA_EXT;
+    break;
+default:
+    pack->blk_pak.end_handler = NULL;
+    pack->blk_pak.cmd = cmd;
+    break;
+}
+```
+
+## 2. Line Breaks
+
+  We recommend that each line should not exceed 120 characters. If it does, unless there is a necessary reason, it should be split into two lines.
+
+  When breaking lines, we need to indent the second line by one level from the first line's starting part to indicate that it is a sub-line. Using the code formatting shortcut can quickly accomplish this.
+
+  For log strings, we do not recommend breaking them into multiple lines for easier retrieval.
+
+  For code line breaks, do not try to place several statements on the same line, as this provides no benefit to code readability:
+
+```c
+// 错误示范(1)
+if(a) return 1;
+
+// 错误示范(2)
+if(b)
+    do_a(),do_b();
+```
+
+## 3. Braces and Spaces
+
+### 3.1 Braces
+
+  The placement of braces is a matter of personal preference, mainly due to habit rather than technical reasons. We recommend placing the opening and closing braces on new lines, as shown below:
+
+```c
+while(i<10)
+{
+    ++i;
+}
+```
+
+&emsp;&emsp;This rule applies to all code blocks.
+
+&emsp;&emsp;The reason for this choice is that, in some editors, placing the braces in this way will result in **a semi-transparent vertical line appearing in the editor, with the line ends being the braces**. This helps developers better understand the hierarchical relationships of the code blocks.
+
+Let's demonstrate this with some examples:
+
+&emsp;&emsp;In the following code block, we need to note that the `else if` statement should be on a new line, not after the previous `}`. This is because we require `{` to be at the start of each line and maintain the indentation level.
+
+```c
+if (*fmt == '*')
+{
+    ++fmt;
+}
+else if (is_digit(*fmt))
+{
+    field_width = skip_and_atoi(&fmt);
+}
+```
+
+&emsp;&emsp;When there are multiple simple statements in a loop, braces should be used.
+
+```c
+while (condition) 
+{
+    if (test)
+        do_something();
+}
+```
+
+&emsp;&emsp;When there is only one simple statement, we do not need to use braces.
+
+```c
+if(a)
+    return 1;
+```
+
+### 3.2 Spaces
+
+&emsp;&emsp;For most keywords, we need to add a space after them to improve code readability.
+
+&emsp;&emsp;Please add a space after all of these keywords:
+
+```c
+if, switch, case, for, do, while
+```
+
+&emsp;&emsp;Keywords such as sizeof, typeof, alignof, and __attribute__ do not require a space after them, as they are used like functions.
+
+&emsp;&emsp;For pointer-type variables, the asterisk should be close to the variable name rather than the type name. As shown below:
+
+```c
+char *a;
+void *func(char* s, int **p);
+```
+
+&emsp;&emsp;Use a space on both sides of most binary and ternary operators, as shown below:
+
+```c
+=  +  -  <  >  *  /  %  |  &  ^  <=  >=  ==  !=  ?  :
+```
+
+&emsp;&emsp;There is no space after these unary operators:
+
+```c
+&  *  +  -  ~  !  sizeof  typeof  alignof  __attribute__  defined
+```
+
+&emsp;&emsp;Special cases: no space is needed before or after the following operators:
+
+```c
+++  -- . ->
+```
+
+## 4. Naming
+
+&emsp;&emsp;DragonOS does not use the camelCase naming convention for function names, but instead uses concise and clear names like `tmp`.
+
+&emsp;&emsp;Note that this refers to our entire project not using the camelCase naming convention. It does not mean that programmers can use obscure abbreviations for variable names.
+
+&emsp;&emsp;For global variables or globally visible functions and structures, we need to follow the following naming conventions:
+
+- The name should be easy to understand and not ambiguous. For example, for a function that calculates folder size, we recommend using `count_folder_size()` instead of `cntfs()`, which can confuse others.
+- For global, non-static names, unless there is a special need, the naming should follow the format: `模块名缩写前缀_函数/变量名`. This naming convention helps others distinguish which module the name belongs to and reduces the risk of naming conflicts.
+- Global names that do not need to be visible to other code files must be prefixed with the `static` modifier.
+
+&emsp;&emsp;For local variables within functions, the naming convention should be concise. Long names for local variables have little significance.
+
+[Document not completed, to be continued]

docs/locales/en/community/code_contribution/conventional-commit.md

@@ -0,0 +1,62 @@
+:::{note}
+**AI Translation Notice**
+
+This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+- Source document: community/code_contribution/conventional-commit.md
+
+- Translation time: 2025-05-19 01:41:57
+
+- Translation model: `Qwen/Qwen3-8B`
+
+Please report issues via [Community Channel](https://github.com/DragonOS-Community/DragonOS/issues)
+
+:::
+
+# Code Commit Guidelines
+
+  This document will briefly introduce the code commit guidelines for the DragonOS GitHub repository, mainly providing the naming conventions based on Conventional Commit, as well as a brief introduction to the DragonOS Bot.
+
+## Conventional Commit (Conventional Commit)
+
+  For detailed specifications on Conventional Commit, please refer to the website [Conventional Commit/Conventional Commit](https://www.conventionalcommits.org/zh-hans/v1.0.0/). At the end of this section, we will provide examples (taken from the [Conventional Commit/Conventional Commit](https://www.conventionalcommits.org/zh-hans/v1.0.0/) website), which are optional to read. We make the following special notes:
+1. Since the DragonOS kernel ensures external usability primarily through system call interfaces, and up to now (April 22, 2024), considering the software ecosystem, DragonOS has chosen to implement system calls consistent with Linux. Therefore, there is no special explanation for `破坏性变更(BREAKING CHANGES)`, or in the current development environment, there will not be any destructive changes that significantly affect users. Therefore, unless there is a special need, the DragonOS kernel should not use `feat!` to indicate destructive changes. (Outside the kernel, such as dadk, the guidelines still apply.)
+2. The DragonOS community strictly follows a squash-based workflow, so we do not require each individual commit in a PR to conform to [Conventional Commit/Conventional Commit](https://www.conventionalcommits.org/zh-hans/v1.0.0/). However, we still strongly recommend using it.
+3. Regarding scope: If not specified otherwise, the scope should be the name of the submodule/system/directory. For example, if the code change is adding a feature in `kernel/src/driver/net`, it should be named as `feat(driver/net):`; if it is in `kernel/src/mm/allocator`, it should be named as `feat(mm)`. In short, the scope should be as short as possible to indicate the module it belongs to. Most of the time, it should not use more than two levels of scope identifiers. For example, `fix(x86_64/driver/apic)` is incorrect and should be named as `fix(x86_64/apic)`.
+4. In the DragonOS kernel code repository, `issue checker` will perform a simple review of the title format. If it does not conform to the format, it will be marked as `ambiguous`. Contributors are advised to modify it as needed.
+5. Use lowercase.
+
+### Examples
+
+#### Commit message with a description and a footnote indicating a breaking change
+```
+feat: allow provided config object to extend other configs
+
+BREAKING CHANGE: `extends` key in config file is now used for extending other config files
+```
+#### Commit message with the ! character to alert about a breaking change
+```
+feat!: send an email to the customer when a product is shipped
+```
+#### Commit message with scope and a breaking change !
+```
+feat(api)!: send an email to the customer when a product is shipped
+```
+#### Commit message with ! and BREAKING CHANGE footnote
+```
+chore!: drop support for Node 6
+
+BREAKING CHANGE: use JavaScript features not available in Node 6.
+```
+#### Commit message without a body
+```
+docs: correct spelling of CHANGELOG
+```
+#### Commit message with scope
+```
+feat(lang): add polish language
+```
+
+## DragonOS Bot
+
+  DragonOS uses triagebot to implement automatic labeling and reviewer assignment. Contributors can also interact with triagebot through some commands. For more details, see [triagebot](https://forge.rust-lang.org/triagebot/index.html)

docs/locales/en/community/code_contribution/index.rst

@@ -0,0 +1,29 @@
+.. note:: AI Translation Notice
+
+   This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+   - Source document: community/code_contribution/index.rst
+
+   - Translation time: 2025-05-19 01:41:37
+
+   - Translation model: `Qwen/Qwen3-8B`
+
+
+   Please report issues via `Community Channel <https://github.com/DragonOS-Community/DragonOS/issues>`_
+
+====================================
+Contributing to Development
+====================================
+
+   DragonOS community warmly welcomes your participation! While learning technology is important, the following documents will help you understand what DragonOS community needs.
+
+   Reading these documents will help you get involved in development and make your code merge into the mainline more quickly.
+
+.. toctree::
+   :maxdepth: 1
+
+   how-to-contribute <https://community.dragonos.org/contributors/>
+
+   c-coding-style
+   rust-coding-style
+   conventional-commit

docs/locales/en/community/code_contribution/rust-coding-style.md

@@ -0,0 +1,107 @@
+:::{note}
+**AI Translation Notice**
+
+This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+- Source document: community/code_contribution/rust-coding-style.md
+
+- Translation time: 2025-05-19 01:41:39
+
+- Translation model: `Qwen/Qwen3-8B`
+
+Please report issues via [Community Channel](https://github.com/DragonOS-Community/DragonOS/issues)
+
+:::
+
+# Rust Language Code Style
+
+  This document will introduce the Rust language code style used in DragonOS. As development progresses, these styles may change, but we will strive to maintain consistency in the style.
+
+## 1. Naming
+
+  This section is based on the naming conventions from the Rust language bible, [Naming Guide](https://course.rs/practice/naming.html). For parts not mentioned in this document, please refer to the [Naming Guide](https://course.rs/practice/naming.html) in the Rust language bible.
+
+## 2. Formatting
+
+### 2.1 Indentation
+
+  Please use the `cargo fmt` command to format the code before submitting it.
+
+### 2.2 Function Return Values
+
+  Although Rust allows returning the value of the last line of a function, this approach can reduce code readability. Therefore, we recommend using the `return` statement as the last line of the function, rather than directly returning the value.
+
+```rust
+// 不推荐
+fn foo() -> i32 {
+    1 + 2
+}
+
+// 推荐
+fn foo() -> i32 {
+    return 1 + 2;
+}
+```
+### 2.3 Error Handling
+
+  DragonOS uses returning POSIX error codes as the **inter-module error handling** method. To ensure consistency in error handling code across modules, we recommend returning the `SystemError` type when an error occurs. This approach is especially beneficial when calling functions across modules, as it allows direct return of a generic error code, thereby reducing the coupling of error handling code.
+
+```rust
+// 函数跨越模块边界时（由其他模块调用当前函数），不推荐
+fn foo() -> Result<(), CustomErr> {
+    if 1 + 2 == 3 {
+        return Ok(());
+    } else {
+        return Err(CustomErr::error);
+    }
+}
+
+// 函数跨越模块边界时（由其他模块调用当前函数），推荐
+fn foo() -> Result<(), SystemError> {
+    if 1 + 2 == 3 {
+        return Ok(());
+    } else {
+        return Err(SystemError::EINVAL);
+    }
+}
+```
+
+&emsp;&emsp;Within **modules**, you can either use a custom error enum or return the `SystemError` type. However, we recommend using a custom error enum for error handling within modules, as it makes the error handling code clearer.
+
+&emsp;&emsp;**TODO**: Convert existing code that uses i32 as an error code to use `SystemError`.
+
+## 3. Comments
+
+&emsp;&emsp;The commenting style in DragonOS is consistent with the official Rust style. We also recommend adding as many meaningful comments as possible in your code to help others understand your code. Additionally, variable and function declarations should follow the naming conventions mentioned in Section 1, making them "self-documenting."
+
+### 3.1 Function Comments
+
+&emsp;&emsp;Function comments should include the following:
+
+- The function's purpose
+- The function's parameters
+- The function's return value
+- The function's error handling
+- Any side effects or other information that needs to be explained
+
+&emsp;&emsp;The format for function comments is as follows:
+
+```rust
+/// # 函数的功能
+/// 
+/// 函数的详细描述
+/// 
+/// ## 参数
+/// 
+/// - 参数1: 参数1的说明
+/// - 参数2: 参数2的说明
+/// - ...
+/// 
+/// ## 返回值
+/// - Ok(返回值类型): 返回值的说明
+/// - Err(错误值类型): 错误的说明
+/// 
+/// ## Safety
+/// 
+/// 函数的安全性说明
+```

docs/locales/en/community/contact/index.rst

@@ -0,0 +1,45 @@
+.. note:: AI Translation Notice
+
+   This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+   - Source document: community/contact/index.rst
+
+   - Translation time: 2025-05-19 02:14:46
+
+   - Translation model: `Qwen/Qwen3-8B`
+
+
+   Please report issues via `Community Channel <https://github.com/DragonOS-Community/DragonOS/issues>`_
+
+.. _translated_label__get_contact_with_community_en:
+
+Get in Touch with the Community
+====================================================================
+
+Contact Information
+-------------------------
+
+Community Public Email: contact@DragonOS.org
+
+Community Management Staff Information: https://community.dragonos.org/governance/staff-info.html
+
+Development Discussion QQ Group: 115763565
+
+DragonOS Official Website: https://DragonOS.org
+
+To learn about development updates and tasks, please visit the DragonOS forum: https://bbs.dragonos.org.cn
+
+Sponsorship and Donations
+---------------------------------------------------------
+
+DragonOS is an open-source project, and we welcome any form of sponsorship and donations. Your donations will be used for the development and maintenance of DragonOS, as well as the operation of the community.
+
+You can sponsor or donate through the following methods:
+
+- Visit the DragonOS official website at https://DragonOS.org, click the "Sponsor" button in the top right corner, and make a donation.
+- Contact the community leader to discuss specific sponsorship methods. Contact information: longjin@dragonos.org
+
+Financial and Donation Transparency
+---------------------------------------------------------
+
+The donation information of the DragonOS community will be made public annually. Sponsorship details and sponsor information will be made public within 15 days after receiving the donation.

docs/locales/en/index.rst

@@ -0,0 +1,62 @@
+English
+==========================================
+.. note:: AI Translation Notice
+
+   This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+   - Source document: index.rst
+
+   - Translation time: 2025-05-19 02:12:15
+
+   - Translation model: `Qwen/Qwen3-8B`
+
+
+   Please report issues via `Community Channel <https://github.com/DragonOS-Community/DragonOS/issues>`_
+
+.. DragonOS documentation master file, created by
+   sphinx-quickstart on Fri Jun 17 23:12:00 2022.
+   You can adapt this file completely to your liking, but it should at least
+   contain the root `toctree` directive.
+
+.. toctree::
+   :maxdepth: 1
+   :caption: Getting Started
+
+   introduction/index
+   introduction/build_system
+   introduction/mirrors
+
+.. toctree::
+   :maxdepth: 1
+   :caption: Kernel Layer
+
+   kernel/configuration/index
+   kernel/boot/index
+   kernel/core_api/index
+   kernel/locking/index
+   kernel/process_management/index
+   kernel/sched/index
+   kernel/ipc/index
+   kernel/memory_management/index
+   kernel/filesystem/index
+   kernel/debug/index
+   kernel/ktest/index
+   kernel/cpu_arch/index
+   kernel/container/index
+   kernel/libs/index
+   kernel/trace/index
+   kernel/syscall/index
+
+.. toctree::
+   :maxdepth: 1
+   :caption: Userland Layer
+
+   userland/appdev/index
+
+.. toctree::
+   :maxdepth: 1
+   :caption: DragonOS Community
+
+   community/code_contribution/index
+   community/contact/index
+   community/ChangeLog/index

docs/locales/en/introduction/build_system.md

@@ -0,0 +1,294 @@
+:::{note}
+**AI Translation Notice**
+
+This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+- Source document: introduction/build_system.md
+
+- Translation time: 2025-05-19 01:44:01
+
+- Translation model: `Qwen/Qwen3-8B`
+
+Please report issues via [Community Channel](https://github.com/DragonOS-Community/DragonOS/issues)
+
+:::
+
+# Building DragonOS
+
+## 1. Introduction
+
+  Regardless of which method you use to compile DragonOS in the following sections, you must first follow the steps in this section to initialize your development environment.
+
+  Before you start, you need a computer running Linux or macOS with an X86-64 processor architecture.
+
+  For Linux distributions, it is recommended to use newer distributions such as Ubuntu 22, Debian, or Arch Linux, which can save you a lot of trouble.
+
+### 1.1 Downloading the DragonOS Source Code
+
+Use `https` to clone:
+
+```shell
+git clone https://github.com/DragonOS-Community/DragonOS.git
+cd DragonOS
+# 使用镜像源更新子模块
+make update-submodules-by-mirror
+```
+
+For convenience in subsequent development, we recommend using `ssh` to clone (please configure your GitHub SSH Key first) to avoid cloning failures due to network issues:
+
+Use `ssh` to clone (please configure your GitHub SSH Key first):
+
+```shell
+# 使用ssh克隆
+git clone git@github.com:DragonOS-Community/DragonOS.git
+cd DragonOS
+# 使用镜像源更新子模块
+make update-submodules-by-mirror
+```
+
+## 2. Installation Using One-Click Initialization Script (Recommended)
+
+  We provide a one-click initialization script that can install everything with a single command. Just run the following command in the terminal:
+
+```shell
+cd DragonOS
+cd tools
+bash bootstrap.sh  # 这里请不要加上sudo, 因为需要安装的开发依赖包是安装在用户环境而非全局环境
+```
+
+:::{note}
+The one-click configuration script currently supports the following systems:
+
+- Ubuntu/Debian/Deepin/UOS and other derivatives based on Debian
+- Gentoo, due to the characteristics of the Gentoo system, when Gentoo encounters USE or circular dependency issues, please handle them according to the emerge prompt information. Official dependency handling examples [GentooWiki](https://wiki.gentoo.org/wiki/Handbook:AMD64/Full/Working/zh-cn#.E5.BD.93_Portage_.E6.8A.A5.E9.94.99.E7.9A.84.E6.97.B6.E5.80.99)
+
+We welcome you to improve the build script for other systems!
+:::
+
+**If the one-click initialization script runs normally and outputs the final "Congratulations" interface (as shown below), please close the current terminal and then reopen it.**
+
+```shell
+|-----------Congratulations!---------------|
+|                                          |
+|   你成功安装了DragonOS所需的依赖项!          |
+|                                          |
+|   请关闭当前终端, 并重新打开一个终端          |
+|   然后通过以下命令运行:                     |
+|                                          |
+|                make run                  |
+|                                          |
+|------------------------------------------|
+```
+
+**Then, please directly jump to {ref}`编译命令讲解 <_build_system_command>` for reading!**
+
+## 3. Manual Installation
+
+### 3.1 Dependency List
+
+&emsp;&emsp;If the automatic installation script does not support your operating system, you need to manually install the required packages. The following is the list of dependencies:
+
+&emsp;&emsp;Among the following dependencies, except for `docker-ce` and `Rust及其工具链`, the rest can be installed using the system's built-in package manager. For the installation of Docker and Rust, please refer to the following sections.
+
+- docker-ce
+- llvm-dev
+- libclang-dev
+- clang
+- gcc-multilib
+- qemu qemu-system qemu-kvm
+- build-essential
+- fdisk
+- lsb-release
+- git
+- dosfstools
+- unzip
+- Rust and its toolchain
+
+**Please note that if your Linux system is running in a virtual machine, please make sure to enable the Intel VT-x or AMD-V option in the processor settings of your VMware/Virtual Box virtual machine, otherwise DragonOS will not be able to run.**
+
+:::{note}
+
+*In some Linux distributions, the Qemu built from the software repository may be incompatible with DragonOS due to an outdated version. If you encounter this issue, uninstall Qemu and reinstall it by compiling from source.*
+
+Download the Qemu source code from this address: https://download.qemu.org/
+
+After decompression, enter the source code directory and execute the following command:
+
+```shell
+# 安装编译依赖项
+sudo apt install -y autoconf automake autotools-dev curl libmpc-dev libmpfr-dev libgmp-dev \
+              gawk build-essential bison flex texinfo gperf libtool patchutils bc \
+              zlib1g-dev libexpat-dev pkg-config  libglib2.0-dev libpixman-1-dev libsdl2-dev \
+              git tmux python3 python3-pip ninja-build
+
+./configure --enable-kvm
+make -j 8
+sudo make install
+# 编译安装完成
+```
+Please note that the compiled QEMU will be linked via VNC mode, so you also need to install a VNC viewer on your computer to connect to the QEMU virtual machine.
+:::
+
+### 3.2 Installing Docker
+
+&emsp;&emsp;You can download and install docker-ce from the Docker official website.
+
+> For detailed information, please visit: [https://docs.docker.com/engine/install/](https://docs.docker.com/engine/install/)
+
+### 3.3 Installing Rust
+
+:::{warning}
+**[Common Misconception]**: If you plan to compile using Docker, although the Docker image already includes a Rust compilation environment, to enable code hints in VSCode using Rust-Analyzer and for the `make clean` command to run normally, you still need to install the Rust environment on your client machine.
+:::
+
+&emsp;&emsp;You can install Rust by entering the following command in the terminal.
+
+```shell
+# 这两行用于换源，加速Rust的安装过程
+export RUSTUP_DIST_SERVER=https://mirrors.ustc.edu.cn/rust-static
+export RUSTUP_UPDATE_ROOT=https://mirrors.ustc.edu.cn/rust-static/rustup
+# 安装Rust
+curl https://sh.rustup.rs -sSf | sh -s -- --default-toolchain nightly
+# 把Rustup加到环境变量
+echo "export PATH=\"\$HOME/.cargo/bin:\$PATH\"" >> ~/.bashrc
+source ~/.cargo/env
+source "$HOME/.cargo/env"
+
+# 更换cargo的索引源
+touch ~/.cargo/config
+echo -e "[source.crates-io]   \n \
+registry = \"https://github.com/rust-lang/crates.io-index\"  \n \
+\n \
+replace-with = 'dragonos-gitee' \n \
+[source.dragonos-gitee] \n \
+registry = \"https://gitee.com/DragonOS/crates.io-index.git\"	 \n \
+" > ~/.cargo/config
+
+# 安装DragonOS所需的工具链
+cargo install cargo-binutils
+rustup toolchain install nightly
+rustup default nightly
+rustup component add rust-src
+rustup component add llvm-tools-preview
+rustup target add x86_64-unknown-none
+# Rust安装完成
+```
+
+**At this point, the public dependencies have been installed. You can proceed to read the subsequent sections according to your needs.**
+
+**For the usage of the compilation command, please refer to: {ref}`编译命令讲解 <_build_system_command>`**
+
+## 4. Building from Docker (Not Recommended)
+
+&emsp;&emsp;DragonOS provides a Docker compilation environment for developers to run DragonOS. However, since the coding process still needs to be performed on the client machine, you need to install the Rust compilation environment on your client machine.
+
+&emsp;&emsp;This section assumes that all operations are performed under Linux.
+
+### 4.1 Installing QEMU Virtual Machine
+
+&emsp;&emsp;In this section, we recommend installing QEMU via the command line:
+
+```shell
+sudo apt install -y qemu qemu-system qemu-kvm
+```
+
+### 4.2 Creating a Disk Image
+
+&emsp;&emsp;First, you need to use the `create_hdd_image.sh` script in the `tools` folder to create a virtual disk image. You need to run this command in the `tools` folder.
+
+```shell
+bash create_hdd_image.sh
+```
+
+### 4.3 Running DragonOS
+
+&emsp;&emsp;If everything goes well, this will be the final step to run DragonOS. You just need to execute the following command in the DragonOS root directory to run DragonOS.
+
+```shell
+make run-docker
+```
+
+&emsp;&emsp;Wait a moment, DragonOS will be started.
+
+&emsp;&emsp;After the QEMU virtual machine is started, you need to input the letter `c` in the console and press Enter. This will start the virtual machine.
+
+:::{note}
+1. During the first compilation, since it requires downloading Rust-related indexes (hundreds of MB in size), it will take some time. Please be patient!
+2. Entering commands may require adding `sudo`
+:::
+
+**For the usage of the compilation command, please refer to: {ref}`编译命令讲解 <_build_system_command>`**
+
+## 5. Other Notes
+
+### 5.1 Creating a Disk Image
+
+&emsp;&emsp;First, you need to run `tools/create_hdd_image.sh` with **normal user** permissions to create a disk image file for DragonOS. This script will automatically complete the creation of the disk image and move it to the `bin/` directory.
+
+&emsp;&emsp;Please note that due to permission issues, you must run this script with **normal user** permissions. (After running, the system may prompt you to enter a password when you need to elevate permissions.)
+
+### 5.2 Compiling and Running DragonOS
+
+1. Install the compilation and runtime environment
+2. Enter the DragonOS folder
+3. Input `make run` to compile and write to the disk image, and run
+
+&emsp;&emsp;After the QEMU virtual machine is started, you need to input the letter `c` in the console and press Enter. This will start the virtual machine.
+
+:::{note}
+During the first compilation, since it requires downloading Rust-related indexes (hundreds of MB in size), it will take some time. Please be patient!
+:::
+
+**For the usage of the compilation command, please refer to: {ref}`编译命令讲解 <_build_system_command>`**
+
+(_translated_label___build_system_command_en)=
+## 6. Explanation of Compilation Commands
+
+- Local compilation, no execution: `make all -j 您的CPU核心数`
+- Local compilation, write to disk image, no execution: `make build`
+- Local compilation, write to disk image, and run in QEMU: `make run`
+- Local compilation, write to disk image, and run in headless mode: 
+`make run-nographic`
+- Docker compilation, write to disk image: `make docker`
+- Docker compilation, write to disk image, and run in QEMU: `make run-docker`
+- Start directly from an existing disk image without compilation: `make qemu`
+- Start directly from an existing disk image without compilation (headless mode): `make qemu-nographic`
+- Clean up compiled files: `make clean`
+- Compile documentation: `make docs` (requires manual installation of sphinx and dependencies in `requirements.txt`)
+- Clean up documentation: `make clean-docs`
+- Format code: `make fmt`
+
+:::{note}
+If you need to run DragonOS in VNC, add the `-vnc` suffix to the above command. For example: `make run-vnc`
+
+The QEMU virtual machine will listen on port 5900 for VNC connections. You can connect to the QEMU virtual machine using a VNC viewer or Remmina.
+:::
+
+## 7. Compiling for riscv64
+
+Since DragonOS has not been fully ported to riscv64 yet, the compilation needs to be done as follows:
+
+1. Modify `env.mk` and `.vscode/settings.json`
+
+Change the value of `ARCH` in `env.mk` to `riscv64`, and in `setting.json`, comment out `"rust-analyzer.cargo.target": "x86_64-unknown-none",` and change it to the line enabling riscv64.
+
+2. Restart rust-analyzer
+
+3. Clean up the compilation cache
+
+Due to the differences between x86_64 and riscv64 architectures, there may be compilation issues caused by cache. Ensure that you clean up the cache before running.
+
+```shell
+make clean
+```
+
+4. Compile and run for riscv64
+
+```shell
+# 下载DragonStub
+git submodule update --init --recursive --force
+
+make run
+```
+
+Please note that since you are running QEMU in the console, when you want to exit, input `Ctrl+A` and press `X` to do so.

docs/locales/en/introduction/features.md

@@ -0,0 +1,154 @@
+:::{note}
+**AI Translation Notice**
+
+This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+- Source document: introduction/features.md
+
+- Translation time: 2025-05-19 01:42:30
+
+- Translation model: `Qwen/Qwen3-8B`
+
+Please report issues via [Community Channel](https://github.com/DragonOS-Community/DragonOS/issues)
+
+:::
+
+(_translated_label___genreal_features_en)=
+
+# Features of DragonOS
+
+## Specifications
+
+- [x] Bootloader: Multiboot2
+
+- [x] Interface: POSIX 2008
+
+## Kernel Layer
+
+### Memory Management
+
+- [x] Page Frame Allocator
+- [x] Small Object Allocator
+- [x] VMA (Virtual Memory Area)
+- [x] Automatic MMIO Address Space Allocation
+- [x] Page Mapper
+- [x] Hardware Abstraction Layer
+- [x] Independent User Address Space Management Mechanism
+- [x] C Interface Compatibility Layer
+
+### Multicore
+
+- [x] Multicore Boot
+- [x] IPI (Inter-Processor Interrupt) Framework
+
+### Process Management
+
+- [x] Process Creation
+- [x] Process Reclamation
+- [x] Kernel Threads
+- [x] Fork
+- [x] Exec
+- [x] Process Sleep (Supports High-Precision Sleep)
+- [x] Kthread Mechanism
+- [x] Extensible Binary Loader
+
+#### Synchronization Primitives
+
+- [x] Mutex
+- [x] Semaphore
+- [x] Atomic Variables
+- [x] Spinlock
+- [x] Wait Queue
+
+### Scheduling
+
+- [x] CFS Scheduler
+- [x] Real-Time Scheduler (FIFO, RR)
+- [x] Single-Core Scheduling
+- [x] Multi-Core Scheduling
+- [x] Load Balancing
+
+### IPC (Inter-Process Communication)
+
+- [x] Anonymous Pipe
+- [x] Signal
+
+### File System
+
+- [x] VFS (Virtual File System)
+- [x] FAT12/16/32
+- [x] Devfs
+- [x] RamFS
+- [x] Procfs
+- [x] Sysfs
+
+### Exception and Interrupt Handling
+
+- [x] APIC
+- [x] Softirq (Soft Interrupt)
+- [x] Kernel Stack Traceback
+
+### Kernel Utility Library
+
+- [x] String Operation Library
+- [x] ELF Executable Support
+- [x] printk
+- [x] Basic Math Library
+- [x] Screen Manager
+- [x] TextUI Framework
+- [x] CRC Function Library
+- [x] Notification Chain
+
+### System Calls
+
+  [See System Call Documentation](https://docs.dragonos.org/zh_CN/latest/syscall_api/index.html)
+
+### Test Framework
+
+- [x] ktest
+
+### Drivers
+
+- [x] ACPI (Advanced Configuration and Power Interface) Module
+- [x] IDE Hard Disk
+- [x] AHCI Hard Disk
+- [x] PCI, PCIe Bus
+- [x] XHCI (USB 3.0)
+- [x] PS/2 Keyboard
+- [x] PS/2 Mouse
+- [x] HPET (High Precision Event Timer)
+- [x] RTC (Real-Time Clock)
+- [x] Local APIC Timer
+- [x] UART Serial Port
+- [x] VBE (Video BIOS Extension) Display
+- [x] VirtIO Network Card
+- [x] x87 FPU
+- [x] TTY Terminal
+- [x] Floating Point Processor
+
+## User Layer
+
+### LibC
+
+- [x] Basic System Calls
+- [x] Basic Standard Library Functions
+- [x] Partial Mathematical Functions
+
+### Shell Command Line Programs
+
+- [x] Parsing Based on String Matching
+- [x] Basic Commands
+
+### Http Server
+
+- A simple Http Server written in C, capable of running static websites.
+
+## Software Portability
+
+- [x] GCC 11.3.0 (Currently only supports x86_64 Cross Compiler) [https://github.com/DragonOS-Community/gcc](https://github.com/DragonOS-Community/gcc)
+- [x] binutils 2.38 (Currently only supports x86_64 Cross Compiler) [https://github.com/DragonOS-Community/binutils](https://github.com/DragonOS-Community/binutils)
+- [x] gmp 6.2.1 [https://github.com/DragonOS-Community/gmp-6.2.1](https://github.com/DragonOS-Community/gmp-6.2.1)
+- [x] mpfr 4.1.1 [https://github.com/DragonOS-Community/mpfr](https://github.com/DragonOS-Community/mpfr)
+- [x] mpc 1.2.1 [https://github.com/DragonOS-Community/mpc](https://github.com/DragonOS-Community/mpc)
+- [x] relibc [https://github.com/DragonOS-Community/relibc](https://github.com/DragonOS-Community/relibc)
+- [x] sqlite3

docs/locales/en/introduction/index.rst

@@ -0,0 +1,34 @@
+.. note:: AI Translation Notice
+
+   This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+   - Source document: introduction/index.rst
+
+   - Translation time: 2025-05-19 01:41:59
+
+   - Translation model: `Qwen/Qwen3-8B`
+
+
+   Please report issues via `Community Channel <https://github.com/DragonOS-Community/DragonOS/issues>`_
+
+Introduction to DragonOS
+====================================
+
+    DragonOS, the Dragon Operating System, is a 64-bit operating system designed for lightweight cloud computing scenarios. It features a fully self-developed kernel and provides Linux binary compatibility. Developed using the Rust programming language, it offers enhanced reliability. Currently, DragonOS ranks among the top three in the Rust operating system field on GitHub.
+
+    The DragonOS open-source community was established in July 2022. It is completely neutral in commercial matters. Our goal is to build a fully independent, open-source, high-performance, and highly reliable server operating system, **to create a fully self-controlled digital future!**
+
+    DragonOS has an excellent and well-designed architecture. Compared to other systems of similar size, DragonOS supports virtualization and has certain advantages in areas such as device model and scheduling subsystems. Currently, we are actively promoting cloud platform support, RISC-V support, as well as the porting of compilers and application software. We aim to achieve large-scale application in production environments within five years.
+
+    DragonOS is currently developing rapidly under the drive of the community. At present, DragonOS has already implemented about 1/4 of the Linux interface. In the future, we will provide 100% compatibility with Linux and introduce new features.
+
+    The goal of DragonOS is to build a fully independent, open-source, high-performance, and highly reliable server operating system, providing a completely self-controlled core power for the country's digital infrastructure construction.
+
+    As a community-driven open-source operating system, in order to promote the development of the open-source community and avoid potential infringement by commercial companies that do not comply with open-source agreements, we have decided to open the source code under the GPLv2 license, using a strict open-source agreement to protect DragonOS.
+
+    You may be interested in the features that have already been implemented in DragonOS. You can visit here: :ref:`功能特性 <_genreal_features>`
+
+.. toctree::
+    :maxdepth: 1
+
+    features

docs/locales/en/introduction/mirrors.md

@@ -0,0 +1,22 @@
+:::{note}
+**AI Translation Notice**
+
+This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+- Source document: introduction/mirrors.md
+
+- Translation time: 2025-05-19 01:41:42
+
+- Translation model: `Qwen/Qwen3-8B`
+
+Please report issues via [Community Channel](https://github.com/DragonOS-Community/DragonOS/issues)
+
+:::
+
+# DragonOS Mirror Site
+
+You can download the source code and other files of DragonOS from the following mirror sites:
+
+- [DragonOS Mirror Site https://mirrors.dragonos.org/](https://mirrors.dragonos.org/)
+- [DragonOS Domestic Mirror Site (RinGoTek)](https://mirrors.RinGoTek.cn)
+- [Git Mirror Site](https://git.mirrors.dragonos.org/)

docs/locales/en/kernel/boot/bootloader.md

@@ -0,0 +1,48 @@
+:::{note}
+**AI Translation Notice**
+
+This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+- Source document: kernel/boot/bootloader.md
+
+- Translation time: 2025-05-19 01:41:31
+
+- Translation model: `Qwen/Qwen3-8B`
+
+Please report issues via [Community Channel](https://github.com/DragonOS-Community/DragonOS/issues)
+
+:::
+
+# Bootloader
+
+## X86_64
+
+- [x] multiboot2
+- [x] HVM/PVH
+
+### HVM/PVH Boot on x86_64
+
+In the DragonOS note segment, there is a PVH header that allows QEMU to boot the DragonOS kernel using the ``-kernel`` parameter.
+
+## RISC-V 64
+
+DragonOS's boot process on RISC-V 64 is as follows:
+
+opensbi --> uboot --> DragonStub --> kernel
+
+This boot process decouples the DragonOS kernel from specific hardware boards, enabling the same binary file to boot and run on different hardware boards.
+
+## Kernel Boot Callbacks
+
+DragonOS abstracts the kernel bootloader, which is represented by the trait ``BootCallbacks``.
+Different bootloaders implement the corresponding callback to initialize the kernel's bootParams or other data structures.
+
+When the kernel boots, it automatically registers callbacks based on the type of bootloader. And at the appropriate time, it calls these callback functions.
+
+## References
+
+- [Multiboot2 Specification](http://git.savannah.gnu.org/cgit/grub.git/tree/doc/multiboot.texi?h=multiboot2)
+
+- [GNU GRUB Manual 2.06](https://www.gnu.org/software/grub/manual/grub/grub.html)
+
+- [UEFI/Legacy Boot - yujianwu - DragonOS Community](https://bbs.dragonos.org/forum.php?mod=viewthread&tid=46)

docs/locales/en/kernel/boot/cmdline.md

@@ -0,0 +1,123 @@
+:::{note}
+**AI Translation Notice**
+
+This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+- Source document: kernel/boot/cmdline.md
+
+- Translation time: 2025-05-19 01:41:48
+
+- Translation model: `Qwen/Qwen3-8B`
+
+Please report issues via [Community Channel](https://github.com/DragonOS-Community/DragonOS/issues)
+
+:::
+
+# Kernel Boot Command Line Parameters
+
+:::{note}
+Author:  
+- Longjin <longjin@DragonOS.org>
+:::
+
+## Overview
+
+&emsp;&emsp;The DragonOS kernel boot command line parameter parsing module aims to provide support for parsing kernel boot command line parameters similar to Linux, enabling more flexible behavior for the kernel. This module allows the kernel to receive and parse command line parameters at boot time, and execute corresponding callback functions or set environment variables based on the type of parameters.
+
+:::{note}
+Callback functions are not supported temporarily.
+:::
+
+## Design
+
+### Parameter Types
+
+Kernel boot command line parameters are divided into three types:
+
+- Arg type
+- KV type
+- EarlyKV type
+
+#### Arg Type
+
+Arg type parameters have only a name and no value. They are divided into the following two types:
+
+- ArgNormal: The default value is `false`. If the parameter is present in the command line, it will be set to `true`.
+- ArgInv: The default value is `true`. If the parameter is present in the command line, it will be set to `false`.
+
+#### KV Type
+
+KV type parameters are represented in the command line as `name=value`, `value` separated by commas. Kernel modules can provide default values for these parameters.
+
+#### EarlyKV Type
+
+EarlyKV type parameters are similar to KV type parameters, but they are parsed before memory management initialization.
+
+### Module Flags
+
+Module flags are similar to `usbprobe.xxxx`.
+
+### Parameter Declaration
+
+Provides macros to declare kernel command line parameters.
+### procfs Support
+
+:::{note}
+TODO: Display the current kernel's boot command line parameters under `/proc/cmdline`.
+:::
+
+## Macros for Declaring Kernel Boot Command Line Parameters
+
+### Arg Type Parameter Declaration
+```rust
+kernel_cmdline_param_arg!(varname, name, default_bool, inv);
+```
+- `varname`: The variable name of the parameter
+- `name`: The name of the parameter
+- `default_bool`: The default value
+- `inv`: Whether to invert
+
+### KV Type Parameter Declaration
+
+```rust
+kernel_cmdline_param_kv!(varname, name, default_str);
+```
+
+- `varname`: The variable name of the parameter
+- `name`: The name of the parameter
+- `default_str`: The default value
+
+### KV Type Parameter Declaration Before Memory Management Initialization
+
+```rust
+kernel_cmdline_param_early_kv!(varname, name, default_str);
+```
+
+- `varname`: The variable name of the parameter
+- `name`: The name of the parameter
+- `default_str`: The default value
+
+## Example
+
+The following example demonstrates how to declare and use KV type parameters:
+```rust
+kernel_cmdline_param_kv!(ROOTFS_PATH_PARAM, root, "");
+if let Some(rootfs_dev_path) = ROOTFS_PATH_PARAM.value_str() {
+    .......
+} else {
+    .......
+};
+```
+
+### Usage
+
+1. In the kernel code, use the `kernel_cmdline_param_kv!` macro to declare the required KV type parameters.
+2. During kernel initialization, retrieve the parameter value through the `value_str()` or `value_bool()` method of the parameter.
+3. Execute corresponding operations based on the parameter value.
+
+By following these steps, developers can flexibly use kernel boot command line parameters to control kernel behavior.
+
+## TODO
+
+- Support displaying the current kernel's boot command line parameters under `/proc/cmdline` (requires procfs refactoring)
+- Support setting callback functions to set parameter values

docs/locales/en/kernel/boot/index.rst

@@ -0,0 +1,22 @@
+.. note:: AI Translation Notice
+
+   This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+   - Source document: kernel/boot/index.rst
+
+   - Translation time: 2025-05-19 01:41:19
+
+   - Translation model: `Qwen/Qwen3-8B`
+
+
+   Please report issues via `Community Channel <https://github.com/DragonOS-Community/DragonOS/issues>`_
+
+Bootloader
+====================================
+
+.. toctree::
+   :maxdepth: 1
+   :caption: Contents
+
+   bootloader
+   cmdline

docs/locales/en/kernel/configuration/arch.md

@@ -0,0 +1,45 @@
+:::{note}
+**AI Translation Notice**
+
+This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+- Source document: kernel/configuration/arch.md
+
+- Translation time: 2025-05-19 01:41:24
+
+- Translation model: `Qwen/Qwen3-8B`
+
+Please report issues via [Community Channel](https://github.com/DragonOS-Community/DragonOS/issues)
+
+:::
+
+# Target Architecture Configuration
+
+## Supported Architectures
+
+- x86_64
+- riscv64
+
+## Architecture-Specific Configuration
+
+In order to support the debugging functionality of VSCode, we need to modify the following line in the `.vscode/settings.json` file:
+```
+    "rust-analyzer.cargo.target": "riscv64gc-unknown-none-elf",
+    // "rust-analyzer.cargo.target": "x86_64-unknown-none",
+```
+
+If you want to compile for the x86_64 architecture, enable the x86_64 line and comment out the others.
+If you want to compile for the riscv64 architecture, enable the riscv64 line and comment out the others.
+
+At the same time, we also need to modify the environment variable configuration in the makefile:
+
+Please modify the following line in the `env.mk` file:
+```Makefile
+ifeq ($(ARCH), )
+# ！！！！在这里设置ARCH，可选x86_64和riscv64
+# !!!!!!!如果不同时调整这里以及vscode的settings.json，那么自动补全和检查将会失效
+export ARCH=riscv64
+endif
+```
+
+Please note that changing the architecture requires a recompilation, so please run `make clean` to clean up the compilation results. Then run `make run` to proceed.

docs/locales/en/kernel/configuration/config.md

@@ -0,0 +1,114 @@
+:::{note}
+**AI Translation Notice**
+
+This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+- Source document: kernel/configuration/config.md
+
+- Translation time: 2025-05-19 01:41:17
+
+- Translation model: `Qwen/Qwen3-8B`
+
+Please report issues via [Community Channel](https://github.com/DragonOS-Community/DragonOS/issues)
+
+:::
+
+# Kernel Compilation Configuration Guide
+
+## Principle
+
+  Within the kernel directory, the kernel configuration is set using `kernel.config`. This file is parsed in a manner similar to a TOML file, and then the configuration of each module's `d.config` is parsed to determine the status of features.
+
+## Example
+
+**kernel.config**
+
+```toml
+[[module.include]]
+name = "init"
+path = "src/init/"
+enable = "y"
+description = ""
+
+[[module.include]]
+name = "mm"
+path = "src/mm/"
+enable = "y"
+description = ""
+```
+
+- **[[module.include]]:** Adds the module to the include list
+- **name:** Module name
+- **path:** Module path, where the `d.config` file is located
+- **enable:**
+  - **y:** Enabled, parse the `d.config` file of the module
+  - **n:** Disabled, do not parse
+- **description:** Description of the module
+
+**src/mm/d.config**
+
+```toml
+[module]
+name = "mm"
+description = ""
+
+[[module.include]]
+name = "allocator"
+path = "src/mm/allocator/"
+enable = "y"
+description = ""
+
+[[module.features]]
+name = "mm_debug"
+enable = "y"
+description = ""
+```
+
+- **[module]:** Current module
+  - **name:** Name of the current module
+  - **description:** Description of the module
+- **[[module.include]]:** Modules included in the current module, same as in `kernel.config`
+- **[[module.features]]:** Features in the current module
+  - **name:** Feature name
+  - **enable:** Whether the feature is enabled
+    - **y:** Enabled
+    - **n:** Disabled
+  - **description:** Description of the feature
+
+*The following are the `d.config` files of other modules:*
+
+**src/mm/allocator/d.config**
+
+```toml
+[module]
+name = "allocator"
+description = ""
+
+[[module.features]]
+name = "allocator_debug"
+enable = "y"
+description = ""
+```
+
+**src/init/d.config**
+
+```toml
+[module]
+name = "init"
+description = ""
+
+[[module.features]]
+name = "init_debug"
+enable = "y"
+description = ""
+```
+
+All features enabled in the `d.config` files of the activated modules will be ultimately generated into the `D.config` file in the kernel directory. That is, `D.config` is the final kernel compilation configuration, as follows:
+
+**D.config**
+
+```
+init_debug = y
+allocator_debug = y
+mm_debug = y
+```

docs/locales/en/kernel/configuration/index.rst

@@ -0,0 +1,22 @@
+.. note:: AI Translation Notice
+
+   This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+   - Source document: kernel/configuration/index.rst
+
+   - Translation time: 2025-05-19 01:41:17
+
+   - Translation model: `Qwen/Qwen3-8B`
+
+
+   Please report issues via `Community Channel <https://github.com/DragonOS-Community/DragonOS/issues>`_
+
+Kernel Compilation Configuration
+====================================
+
+.. toctree::
+   :maxdepth: 1
+   :caption: Contents
+
+   config
+   arch

docs/locales/en/kernel/container/index.rst

@@ -0,0 +1,26 @@
+.. note:: AI Translation Notice
+
+   This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+   - Source document: kernel/container/index.rst
+
+   - Translation time: 2025-05-19 01:41:19
+
+   - Translation model: `Qwen/Qwen3-8B`
+
+
+   Please report issues via `Community Channel <https://github.com/DragonOS-Community/DragonOS/issues>`_
+
+====================================
+Containerization
+====================================
+
+   This is the documentation related to containerization in DragonOS.
+
+   It mainly includes namespace, overlayfs, and cgroup
+
+.. toctree::
+   :maxdepth: 2
+
+   namespaces/index
+   ../filesystem/unionfs/index

docs/locales/en/kernel/container/namespaces/index.rst

@@ -0,0 +1,28 @@
+.. note:: AI Translation Notice
+
+   This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+   - Source document: kernel/container/namespaces/index.rst
+
+   - Translation time: 2025-05-19 01:41:19
+
+   - Translation model: `Qwen/Qwen3-8B`
+
+
+   Please report issues via `Community Channel <https://github.com/DragonOS-Community/DragonOS/issues>`_
+
+====================================
+Namespaces
+====================================
+
+DragonOS's namespaces currently support pid_namespace and mnt_namespace, and more features are expected to be added in the future.
+
+Namespaces are an important component in the process of containerization.
+
+Since the current OS is single-user, user_namespace is globally static.
+
+.. toctree::
+   :maxdepth: 1
+
+   pid_namespace
+   mnt_namespace

docs/locales/en/kernel/container/namespaces/mnt_namespace.md

@@ -0,0 +1,33 @@
+:::{note}
+**AI Translation Notice**
+
+This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+- Source document: kernel/container/namespaces/mnt_namespace.md
+
+- Translation time: 2025-05-19 01:41:19
+
+- Translation model: `Qwen/Qwen3-8B`
+
+Please report issues via [Community Channel](https://github.com/DragonOS-Community/DragonOS/issues)
+
+:::
+
+# Mount Namespace
+
+## Underlying Architecture
+
+pcb -> nsproxy -> mnt_namespace
+
+Each mounted file system has its own independent mount point, which is represented in the data structure as a red-black tree of mounts. Each namespace has its own independent mounts, so mounting and unmounting file systems will not affect others.
+
+## System Call Interface
+
+- clone
+    - CLONE_NEWNS is used to create a new MNT namespace. It provides an independent file system mount point.
+- unshare
+    - After calling unshare() with the CLONE_NEWPID flag, all subsequent child processes will run in the new namespace.
+- setns
+    - Adds the process to the specified namespace.
+- chroot
+    - Changes the current process's root directory to the specified path, providing file system isolation.

docs/locales/en/kernel/container/namespaces/pid_namespace.md

@@ -0,0 +1,38 @@
+:::{note}
+**AI Translation Notice**
+
+This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+- Source document: kernel/container/namespaces/pid_namespace.md
+
+- Translation time: 2025-05-19 01:41:31
+
+- Translation model: `Qwen/Qwen3-8B`
+
+Please report issues via [Community Channel](https://github.com/DragonOS-Community/DragonOS/issues)
+
+:::
+
+# Process Namespace
+:::{note} Author: Cao Fengyi 1553389239@qq.com
+
+October 30, 2024
+:::
+
+`pid_namespace` is a type of namespace in the kernel that is used to achieve process isolation. It allows processes running in different namespaces to have independent views of process IDs (PIDs).
+
+## Underlying Architecture
+
+pcb -> nsproxy -> pid_namespace
+- `pid_namespace` contains an independent set of process allocators and an orphan process reaper, which independently manages PIDs within the namespace.
+- Detailed information about processes is stored in the proc file system. The information corresponding to a specific PID is located within the `pid_namespace`, recording information related to the `pid_namespace`.
+- The limitations imposed by `pid_namespace` are controlled and managed by `ucount`.
+
+## System Call Interface
+
+- `clone`
+    - `CLONE_NEWPID` is used to create a new PID namespace. When this flag is used, the child process will run in the new PID namespace, with the process ID starting from 1.
+- `unshare`
+    - After calling `unshare()` with the `CLONE_NEWPID` flag, all subsequent child processes will run within the new namespace.
+- `getpid`
+    - Calling `getpid()` within a namespace returns the process ID of the process within the current PID namespace.

docs/locales/en/kernel/core_api/atomic.md

@@ -0,0 +1,112 @@
+:::{note}
+**AI Translation Notice**
+
+This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+- Source document: kernel/core_api/atomic.md
+
+- Translation time: 2025-05-19 01:41:25
+
+- Translation model: `Qwen/Qwen3-8B`
+
+Please report issues via [Community Channel](https://github.com/DragonOS-Community/DragonOS/issues)
+
+:::
+
+# Atomic Variables
+
+## Introduction
+
+  DragonOS implements atomic variables of type `atomic_t`. Atomic variables are implemented using architecture-specific atomic operation instructions. The specific implementation is located in `kernel/common/atomic.h`.
+
+## API
+
+   Note that all the following APIs are atomic operations.
+
+### `inline void atomic_add(atomic_t *ato, long val)`
+
+#### Description
+
+   Atomically adds a specified value to the atomic variable.
+
+#### Parameters
+
+**ato**
+
+   The atomic variable object.
+
+**val**
+
+   The value to be added to the variable.
+
+### `inline void atomic_sub(atomic_t *ato, long val)`
+
+#### Description
+
+   Atomically subtracts a specified value from the atomic variable.
+
+#### Parameters
+
+**ato**
+
+   The atomic variable object.
+
+**val**
+
+   The value to be subtracted from the variable.
+
+### `void atomic_inc(atomic_t *ato)`
+
+#### Description
+
+   Atomically increments the atomic variable by 1.
+
+#### Parameters
+
+**ato**
+
+   The atomic variable object.
+
+### `void atomic_dec(atomic_t *ato)`
+
+#### Description
+
+   Atomically decrements the atomic variable by 1.
+
+#### Parameters
+
+**ato**
+
+   The atomic variable object.
+
+### `inline void atomic_set_mask(atomic_t *ato, long mask)`
+
+#### Description
+
+   Performs a bitwise OR operation between the atomic variable and the mask variable.
+
+#### Parameters
+
+**ato**
+
+   The atomic variable object.
+
+**mask**
+
+   The variable used for the OR operation with the atomic variable.
+
+### `inline void atomic_clear_mask(atomic_t *ato, long mask)`
+
+#### Description
+
+   Performs a bitwise AND operation between the atomic variable and the mask variable.
+
+#### Parameters
+
+**ato**
+
+   The atomic variable object.
+
+**mask**
+
+   The variable used for the AND operation with the atomic variable.

docs/locales/en/kernel/core_api/casting.md

@@ -0,0 +1,77 @@
+:::{note}
+**AI Translation Notice**
+
+This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+- Source document: kernel/core_api/casting.md
+
+- Translation time: 2025-05-19 01:41:11
+
+- Translation model: `Qwen/Qwen3-8B`
+
+Please report issues via [Community Channel](https://github.com/DragonOS-Community/DragonOS/issues)
+
+:::
+
+# Type Conversion Library API
+
+  The kernel provides some functions to help you convert between different types. These include the following types:
+
+- Numeric type conversion (using the `num-traits` library)
+- Arc type conversion
+
+  All functions not specially marked are implemented in `kernel/src/libs/casting.rs`.
+
+## 1. Numeric Type Conversion
+
+### 1.1 Conversion Between Integer Types and Enum Types
+
+  You can use macros provided by the `num-traits` library to convert between enum types and integer types.
+The SystemError enum type uses this approach, and you can find its usage in `kernel/src/syscall/mod.rs`.
+
+  It first inherits the `FromPrimitive, ToPrimitive` two traits, and then performs the conversion like this:
+
+```rust
+impl SystemError {
+    /// @brief 把posix错误码转换为系统错误枚举类型。
+    pub fn from_posix_errno(errno: i32) -> Option<SystemError> {
+        // posix 错误码是小于0的
+        if errno >= 0 {
+            return None;
+        }
+        return <Self as FromPrimitive>::from_i32(-errno);
+    }
+
+    /// @brief 把系统错误枚举类型转换为负数posix错误码。
+    pub fn to_posix_errno(&self) -> i32 {
+        return -<Self as ToPrimitive>::to_i32(self).unwrap();
+    }
+}
+```
+
+&emsp;&emsp;These two functions well illustrate how to use these two traits.
+
+## 2. Arc Type Conversion
+
+### 2.1 Conversion from Arc<dyn U> to Arc<T>
+
+&emsp;&emsp;When we need to convert an `Arc<dyn U>` to a specific type pointer of `Arc<T>`, we need to implement the `DowncastArc` trait for `U`. This trait is defined in `kernel/src/libs/casting.rs`. It requires `trait U` to implement the `Any + Sync + Send` trait.
+
+&emsp;&emsp;To implement the `DowncastArc` trait for `trait U: Any + Send + Sync`, you need to do the following:
+
+```rust
+impl DowncastArc for dyn U {
+    fn as_any_arc(self: Arc<Self>) -> Arc<dyn Any> {
+        return self;
+    }
+}
+```
+
+&emsp;&emsp;Using the `DowncastArc` trait, we can convert like this:
+
+```rust
+let arc: Arc<dyn U> = ...;
+let arc_t: Arc<T> = arc.downcast_arc::<T>().unwrap();
+```
+
+&emsp;&emsp;If the specific type of `arc` is not `Arc<T>`, then `downcast_arc::<T>()` will return `None`.

docs/locales/en/kernel/core_api/index.rst

@@ -0,0 +1,28 @@
+.. note:: AI Translation Notice
+
+   This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+   - Source document: kernel/core_api/index.rst
+
+   - Translation time: 2025-05-19 01:41:08
+
+   - Translation model: `Qwen/Qwen3-8B`
+
+
+   Please report issues via `Community Channel <https://github.com/DragonOS-Community/DragonOS/issues>`_
+
+====================================
+Core API Documentation
+====================================
+
+   This is the core API documentation for DragonOS.
+
+.. toctree::
+   :maxdepth: 1
+   :caption: Kernel Utility Library
+
+   kernel_api
+   atomic
+   casting
+   notifier_chain
+   softirq

docs/locales/en/kernel/core_api/kernel_api.md

@@ -0,0 +1,630 @@
+:::{note}
+**AI Translation Notice**
+
+This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+- Source document: kernel/core_api/kernel_api.md
+
+- Translation time: 2025-05-19 01:43:39
+
+- Translation model: `Qwen/Qwen3-8B`
+
+Please report issues via [Community Channel](https://github.com/DragonOS-Community/DragonOS/issues)
+
+:::
+
+# DragonOS Kernel Core API
+
+## Circular Linked List Management Functions
+
+  Circular linked list is one of the important data structures in the kernel. It is included in `kernel/common/list.h`.
+
+### `void list_init(struct List *list)`
+
+#### Description
+
+  Initialize a List structure so that its prev and next pointers point to itself.
+
+#### Parameters
+
+**list**
+
+  The List structure to be initialized.
+
+### `void list_add(struct List *entry, struct List *node)`
+
+#### Description
+
+  Insert the node after the entry.
+
+#### Parameters
+
+**entry**
+
+  An existing node in the circular linked list.
+
+**node**
+
+  The node to be inserted.
+
+### `void list_append(struct List *entry, struct List *node)`
+
+#### Description
+
+  Insert the node before the entry.
+
+#### Parameters
+
+**entry**
+
+  An existing node in the circular linked list.
+
+**node**
+
+  The node to be inserted.
+
+### `void list_del(struct List *entry)`
+
+#### Description
+
+  Remove the node from the list.
+
+#### Parameters
+
+**entry**
+
+  The node to be removed.
+
+### `list_del_init(struct List *entry)`
+
+#### Description
+
+  Remove the node from the list and re-initialize the entry using list_init().
+
+#### Parameters
+
+**entry**
+
+  The node to be removed.
+
+### `bool list_empty(struct List *entry)`
+
+#### Description
+
+  Check if the list is empty.
+
+#### Parameters
+
+**entry**
+
+  A node in the list.
+
+### `struct List *list_prev(struct List *entry)`
+
+#### Description
+
+  Get the previous node of the entry.
+
+#### Parameters
+
+**entry**
+
+  A node in the list.
+
+### `struct List *list_next(struct List *entry)`
+
+#### Description
+
+  Get the next node of the entry.
+
+#### Parameters
+
+**entry**
+
+  A node in the list.
+
+### `void list_replace(struct List *old, struct List *new)`
+
+#### Description
+
+  Replace the old node in the list with the new node.
+
+#### Parameters
+
+**old**
+
+  The node to be removed.
+
+**new**
+
+  The new node to be inserted into the list.
+
+(_translated_label___list_entry_en)=
+
+### `list_entry(ptr, type, member)`
+
+#### Description
+
+  This macro can get the address of the structure that contains the List pointed to by ptr.
+
+#### Parameters
+
+**ptr**
+
+  Pointer to the List structure.
+
+**type**
+
+  The type of the structure that contains the List.
+
+**member**
+
+  The name of the List structure member in the structure that contains the List.
+
+### `list_first_entry(ptr, type, member)`
+
+#### Description
+
+  Get the first element in the list. Please note that this macro requires the list to be non-empty, otherwise it will cause an error.
+
+#### Parameters
+
+&emsp;&emsp;Same as {ref}`list_entry() <_list_entry>`
+
+### `list_first_entry_or_null(ptr, type, member)`
+
+#### Description
+
+&emsp;&emsp;Get the first element in the list. If the list is empty, return NULL.
+
+#### Parameters
+
+&emsp;&emsp;Same as {ref}`list_entry() <_list_entry>`
+
+### `list_last_entry(ptr, type, member)`
+
+#### Description
+
+&emsp;&emsp;Get the last element in the list. Please note that this macro requires the list to be non-empty, otherwise it will cause an error.
+
+#### Parameters
+
+&emsp;&emsp;Same as {ref}`list_entry() <_list_entry>`
+
+### `list_last_entry_or_full(ptr, type, member)`
+
+#### Description
+
+&emsp;&emsp;Get the last element in the list. If the list is empty, return NULL.
+
+#### Parameters
+
+&emsp;&emsp;Same as {ref}`list_entry() <_list_entry>`
+
+(_translated_label___list_next_entry_en)=
+### `list_next_entry(pos, member)`
+
+#### Description
+
+&emsp;&emsp;Get the next element in the list.
+
+#### Parameters
+
+**pos**
+
+&emsp;&emsp;Pointer to the outer structure.
+
+**member**
+
+&emsp;&emsp;The name of the List structure member in the outer structure.
+
+### `list_prev_entry(pos, member)`
+
+#### Description
+
+&emsp;&emsp;Get the previous element in the list.
+
+#### Parameters
+
+&emsp;&emsp;Same as {ref}`list_next_entry() <_list_next_entry>`
+
+(_translated_label___list_for_each_en)=
+### `list_for_each(ptr, head)`
+
+#### Description
+
+&emsp;&emsp;Traverse the entire list (from front to back).
+
+#### Parameters
+
+**ptr**
+
+&emsp;&emsp;Pointer to the List structure.
+
+**head**
+
+&emsp;&emsp;Pointer to the head node of the list (struct List*).
+
+### `list_for_each_prev(ptr, head)`
+
+#### Description
+
+&emsp;&emsp;Traverse the entire list (from back to front).
+
+#### Parameters
+
+&emsp;&emsp;Same as {ref}`list_for_each() <_list_for_each>`
+
+(_translated_label___list_for_each_safe_en)=
+### `list_for_each_safe(ptr, n, head)`
+
+#### Description
+
+&emsp;&emsp;Traverse the entire list from front to back (supports deletion of the current list node).
+
+&emsp;&emsp;This macro uses a temporary variable to prevent errors that may occur during iteration if the current ptr node is deleted.
+
+#### Parameters
+
+**ptr**
+
+&emsp;&emsp;Pointer to the List structure.
+
+**n**
+
+&emsp;&emsp;Pointer to store the temporary value (List type).
+
+**head**
+
+&emsp;&emsp;Pointer to the head node of the list (struct List*).
+
+### `list_for_each_prev_safe(ptr, n, head)`
+
+#### Description
+
+&emsp;&emsp;Traverse the entire list from back to front (supports deletion of the current list node).
+
+&emsp;&emsp;This macro uses a temporary variable to prevent errors that may occur during iteration if the current ptr node is deleted.
+
+#### Parameters
+
+&emsp;&emsp;Same as {ref}`list_for_each_safe() <_list_for_each_safe>`
+
+(_translated_label___list_for_each_entry_en)=
+### `list_for_each_entry(pos, head, member)`
+
+#### Description
+
+&emsp;&emsp;Iterate through the list of a given type from the beginning.
+
+#### Parameters
+
+**pos**
+
+&emsp;&emsp;Pointer to a structure of the specific type.
+
+**head**
+
+&emsp;&emsp;Pointer to the head node of the list (struct List*).
+
+**member**
+
+&emsp;&emsp;The name of the List member in the structure pointed to by pos.
+
+### `list_for_each_entry_reverse(pos, head, member)`
+
+#### Description
+
+&emsp;&emsp;Iterate through the list of a given type in reverse order.
+
+#### Parameters
+
+&emsp;&emsp;Same as {ref}`list_for_each_entry() <_list_for_each_entry>`
+
+### `list_for_each_entry_safe(pos, n, head, member)`
+
+#### Description
+
+&emsp;&emsp;Iterate through the list of a given type from the beginning (supports deletion of the current list node).
+
+#### Parameters
+
+**pos**
+
+&emsp;&emsp;Pointer to a structure of the specific type.
+
+**n**
+
+&emsp;&emsp;Pointer to store the temporary value (same type as pos).
+
+**head**
+
+&emsp;&emsp;Pointer to the head node of the list (struct List*).
+
+**member**
+
+&emsp;&emsp;The name of the List member in the structure pointed to by pos.
+
+### `list_prepare_entry(pos, head, member)`
+
+#### Description
+
+&emsp;&emsp;Prepare a 'pos' structure for {ref}`list_for_each_entry_continue() <_list_for_each_entry_continue>`.
+
+#### Parameters
+
+**pos**
+
+&emsp;&emsp;Pointer to a structure of the specific type, used as the starting point for iteration.
+
+**head**
+
+&emsp;&emsp;Pointer to the struct List structure to start iteration from.
+
+**member**
+
+&emsp;&emsp;The name of the List member in the structure pointed to by pos.
+
+(_translated_label___list_for_each_entry_continue_en)=
+### `list_for_each_entry_continue(pos, head, member)`
+
+#### Description
+
+&emsp;&emsp;Continue iterating through the list from the next element of the specified position.
+
+#### Parameters
+
+**pos**
+
+&emsp;&emsp;Pointer to a structure of the specific type. This pointer is used as the iteration pointer.
+
+**head**
+
+&emsp;&emsp;Pointer to the struct List structure to start iteration from.
+
+**member**
+
+&emsp;&emsp;The name of the List member in the structure pointed to by pos.
+
+### `list_for_each_entry_continue_reverse(pos, head, member)`
+
+#### Description
+
+&emsp;&emsp;Iterate through the list in reverse order, starting from the previous element of the specified position.
+
+#### Parameters
+
+&emsp;&emsp;Same as {ref}`list_for_each_entry_continue() <_list_for_each_entry_continue>`
+
+### `list_for_each_entry_from(pos, head, member)`
+
+#### Description
+
+&emsp;&emsp;Continue iterating through the list from the specified position.
+
+#### Parameters
+
+&emsp;&emsp;Same as {ref}`list_for_each_entry_continue() <_list_for_each_entry_continue>`
+
+(_translated_label___list_for_each_entry_safe_continue_en)=
+### `list_for_each_entry_safe_continue(pos, n, head, member)`
+
+#### Description
+
+&emsp;&emsp;Continue iterating through the list from the next element of the specified position (supports deletion of the current list node).
+
+#### Parameters
+
+**pos**
+
+&emsp;&emsp;Pointer to a structure of the specific type. This pointer is used as the iteration pointer.
+
+**n**
+
+&emsp;&emsp;Pointer to store the temporary value (same type as pos).
+
+**head**
+
+&emsp;&emsp;Pointer to the struct List structure to start iteration from.
+
+**member**
+
+&emsp;&emsp;The name of the List member in the structure pointed to by pos.
+
+### `list_for_each_entry_safe_continue_reverse(pos, n, head, member)`
+
+#### Description
+
+&emsp;&emsp;Iterate through the list in reverse order, starting from the previous element of the specified position (supports deletion of the current list node).
+
+#### Parameters
+
+&emsp;&emsp;Same as {ref}`list_for_each_entry_safe_continue() <_list_for_each_entry_safe_continue>`
+
+### `list_for_each_entry_safe_from(pos, n, head, member)`
+
+#### Description
+
+&emsp;&emsp;Continue iterating through the list from the specified position (supports deletion of the current list node).
+
+#### Parameters
+
+&emsp;&emsp;Same as {ref}`list_for_each_entry_safe_continue() <_list_for_each_entry_safe_continue>`
+
+---
+
+## Basic C Function Library
+
+&emsp;&emsp;Kernel programming differs from application layer programming; you will not be able to use functions from LibC. To address this, the kernel implements some commonly used C language functions, trying to make their behavior as close as possible to standard C library functions. It is important to note that the behavior of these functions may differ from standard C library functions, so it is recommended to carefully read the following documentation, which will be helpful to you.
+
+### String Operations
+
+#### `int strlen(const char *s)`
+
+##### Description
+
+&emsp;&emsp;Measure and return the length of the string.
+
+##### Parameters
+
+**src**
+
+&emsp;&emsp;Source string.
+
+#### `long strnlen(const char *src, unsigned long maxlen)`
+
+##### Description
+
+&emsp;&emsp;Measure and return the length of the string. If the string length is greater than maxlen, return maxlen.
+
+##### Parameters
+
+**src**
+
+&emsp;&emsp;Source string.
+
+**maxlen**
+
+&emsp;&emsp;Maximum length.
+
+#### `long strnlen_user(const char *src, unsigned long maxlen)`
+
+##### Description
+
+&emsp;&emsp;Measure and return the length of the string. If the string length is greater than maxlen, return maxlen.
+
+&emsp;&emsp;This function performs address space validation, requiring the src string to be from user space. If the source string is from kernel space, it will return 0.
+
+##### Parameters
+
+**src**
+
+&emsp;&emsp;Source string, located in user space.
+
+**maxlen**
+
+&emsp;&emsp;Maximum length.
+
+#### `char *strncpy(char *dst, const char *src, long count)`
+
+##### Description
+
+&emsp;&emsp;Copy a string of count bytes and return the dst string.
+
+##### Parameters
+
+**src**
+
+&emsp;&emsp;Source string.
+
+**dst**
+
+&emsp;&emsp;Destination string.
+
+**count**
+
+&emsp;&emsp;Length of the source string to copy.
+
+#### `char *strcpy(char *dst, const char *src)`
+
+##### Description
+
+&emsp;&emsp;Copy the source string and return the dst string.
+
+##### Parameters
+
+**src**
+
+&emsp;&emsp;Source string.
+
+**dst**
+
+&emsp;&emsp;Destination string.
+
+#### `long strncpy_from_user(char *dst, const char *src, unsigned long size)`
+
+##### Description
+
+&emsp;&emsp;Copy a string of count bytes from user space to kernel space, and return the size of the copied string.
+
+&emsp;&emsp;This function performs address space validation to prevent address space overflow issues.
+
+##### Parameters
+
+**src**
+
+&emsp;&emsp;Source string.
+
+**dst**
+
+&emsp;&emsp;Destination string.
+
+**size**
+
+&emsp;&emsp;Length of the source string to copy.
+
+#### `int strcmp(char *FirstPart, char *SecondPart)`
+
+##### Description
+
+  Compare the sizes of two strings.
+
+***Return Value***
+
+| Situation                      | Return Value |
+| ----------------------- | --- |
+| FirstPart == SecondPart | 0   |
+| FirstPart > SecondPart  | 1   |
+| FirstPart < SecondPart  | -1  |
+
+##### Parameters
+
+**FirstPart**
+
+&emsp;&emsp;First string.
+
+**SecondPart**
+
+&emsp;&emsp;Second string.
+
+### Memory Operations
+
+#### `void *memcpy(void *dst, const void *src, uint64_t size)`
+
+##### Description
+
+&emsp;&emsp;Copy memory from src to dst.
+
+##### Parameters
+
+**dst**
+
+&emsp;&emsp;Pointer to the destination address.
+
+**src**
+
+&emsp;&emsp;Pointer to the source address.
+
+**size**
+
+&emsp;&emsp;Size of data to be copied.
+
+#### `void *memmove(void *dst, const void *src, uint64_t size)`
+
+##### Description
+
+&emsp;&emsp;Similar to `memcpy()`, but this function prevents data from being incorrectly overwritten when the source and destination memory regions overlap.
+
+##### Parameters
+
+**dst**
+
+&emsp;&emsp;Pointer to the destination address.
+
+**src**
+
+&emsp;&emsp;Pointer to the source address.
+
+**size**
+
+&emsp;&emsp;Size of data to be copied.

docs/locales/en/kernel/core_api/notifier_chain.md

@@ -0,0 +1,48 @@
+:::{note}
+**AI Translation Notice**
+
+This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+- Source document: kernel/core_api/notifier_chain.md
+
+- Translation time: 2025-05-19 01:41:30
+
+- Translation model: `Qwen/Qwen3-8B`
+
+Please report issues via [Community Channel](https://github.com/DragonOS-Community/DragonOS/issues)
+
+:::
+
+# Notifier Chain Notification Chain
+
+## 1. Overview of Principles
+
+  The notification chain is an event notification mechanism between subsystems within the kernel or between modules within a subsystem. Essentially, a notification chain is a list of event handling functions. Each notification chain is associated with a specific type of event (e.g., reboot event). When a specific event occurs, the corresponding callback functions in the event's notification chain are called, allowing the subsystem/module to respond to the event and perform the appropriate processing.
+
+  The notification chain is somewhat similar to the subscription mechanism. It can be understood as: there is a "notifier" that maintains a list, and the "subscriber" registers its callback function into this list ("subscriber" can also unregister its callback function). When an event occurs that needs to be notified, the "notifier" traverses all the callback functions in the list and calls them, allowing all registered "subscribers" to respond and handle the event accordingly.
+
+## 2. Core Features
+
+### 2.1 Registering Callback Functions
+
+  The callback function is encapsulated into a specific structure and registered into the designated notification chain. The related method is `register`, which is used by the "subscriber".
+
+### 2.2 Unregistering Callback Functions
+
+  The callback function is removed from the designated notification chain, i.e., it is deleted from the notification chain. The related method is `unregister`, which is used by the "subscriber".
+
+### 2.3 Event Notification
+
+  When an event occurs, the notification chain related to that event performs the event notification through this method. `call_chain` This method traverses all elements in the notification chain and calls the registered callback functions in sequence. This method is used by the "notifier".
+
+## 3. Types of Notification Chains
+
+  Each type of notification chain has corresponding `register`, `unregister`, and `call_chain` interfaces, with functions as described in the core features above.
+
+- `AtomicNotifierChain`: Atomic notification chain, cannot sleep, recommended for use in interrupt context.
+- `BlockingNotifierChain`: Blocking notification chain, can sleep, recommended for use in process context.
+- `RawNotifierChain`: Raw notification chain, the caller is responsible for thread safety.
+
+## 4. Other Issues
+
+  `BlockingNotifierChain` does not currently support the sleeping functionality.

docs/locales/en/kernel/core_api/softirq.md

@@ -0,0 +1,178 @@
+:::{note}
+**AI Translation Notice**
+
+This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+- Source document: kernel/core_api/softirq.md
+
+- Translation time: 2025-05-19 01:41:38
+
+- Translation model: `Qwen/Qwen3-8B`
+
+Please report issues via [Community Channel](https://github.com/DragonOS-Community/DragonOS/issues)
+
+:::
+
+# Soft Interrupt
+
+  Software interrupt, also known as the bottom half of an interrupt, is used to delay the processing of work that was not completed by the hard interrupt (the top half of the interrupt). Dividing the interrupt into two stages can effectively solve the problems of long interrupt handling time and interrupt loss.
+
+## 1. Design Philosophy
+
+  Each CPU has its own pending status. Soft interrupts are "initiated by which CPU, executed by which CPU", and the pending status of each CPU is not shared. The same soft interrupt vector can run concurrently on multiple cores.
+
+  When we need to register a new soft interrupt, we need to implement the `SoftirqVec` feature for the soft interrupt handler, and then call the `register_softirq` function to register the soft interrupt handler within the soft interrupt mechanism.
+
+  Please note that due to the reentrancy and concurrency of soft interrupts, the soft interrupt handler must ensure thread safety itself.
+
+## 2. Soft Interrupt Vector Number
+
+```rust
+pub enum SoftirqNumber {
+    /// 时钟软中断信号
+    TIMER = 0,
+    /// 帧缓冲区刷新软中断
+    VideoRefresh = 1, 
+}
+```
+
+## 3. Soft Interrupt API
+
+### 3.1. SoftirqVec Feature
+
+```rust
+pub trait SoftirqVec: Send + Sync + Debug {
+    fn run(&self);
+}
+```
+
+  The feature that the soft interrupt handler needs to implement. It needs to implement the `run` function to handle the soft interrupt. When the soft interrupt is executed, the `run` function will be called.
+
+### 3.2. Softirq API
+
+#### 3.2.1. Register Soft Interrupt Vector
+
+```rust
+pub fn register_softirq(&self,
+        softirq_num: SoftirqNumber,
+        handler: Arc<dyn SoftirqVec>,
+    ) -> Result<i32, SystemError>
+```
+
+- Parameters:
+
+  - softirq_num: Interrupt vector number
+
+  - handler: The structure corresponding to the interrupt function, which needs to point to a structure variable that implements the `SoftirqVec` feature
+
+- Return:
+
+  - Ok(i32): 0
+
+  - Err(SystemError): Error code
+
+#### 3.2.2. Unregister Soft Interrupt Vector
+
+```rust
+pub fn unregister_softirq(&self, softirq_num: SoftirqNumber)
+```
+
+- Parameters:
+
+  - softirq_num: Interrupt vector number
+
+#### 3.2.3. Execute Soft Interrupt
+
+```rust
+pub fn do_softirq(&self)
+```
+
+- Purpose: Execute the soft interrupt function (**only called after hard interrupt execution**)
+
+#### 3.2.4. Clear the Pending Flag of Soft Interrupt
+
+```rust
+pub unsafe fn clear_softirq_pending(&self, softirq_num: SoftirqNumber)
+```
+
+- Purpose: Clear the pending flag of the specified soft interrupt on the current CPU. Please note that this function is unsafe because it directly modifies the pending flag without locking.
+
+- Parameters:
+
+  - softirq_num: Interrupt vector number
+
+#### 3.2.5. Mark Soft Interrupt as to be Executed
+
+```rust
+pub fn raise_softirq(&self, softirq_num: SoftirqNumber)
+```
+
+- Purpose: Mark the specified soft interrupt as to be executed on the current CPU
+
+- Parameters:
+
+  - softirq_num: Interrupt vector number
+
+### 3.3. Usage Example
+
+```rust
+#[derive(Debug)]
+/// SoftirqExample中断结构体
+pub struct SoftirqExample {
+    running: AtomicBool,
+}
+/// SoftirqExample中断需要处理的逻辑
+fn softirq_example_func() {
+    println!("addressed SoftirqExample");
+}
+impl SoftirqVec for SoftirqExample {
+    fn run(&self) {
+        if self.set_run() == false {
+            return;
+        }
+
+        softirq_example_func();
+
+        self.clear_run();
+    }
+}
+impl SoftirqExample {
+    pub fn new() -> SoftirqExample {
+        SoftirqExample {
+            running: AtomicBool::new(false),
+        }
+    }
+
+    fn set_run(&self) -> bool {
+        let x = self
+            .running
+            .compare_exchange(false, true, Ordering::Acquire, Ordering::Relaxed);
+        if x.is_ok() {
+            return true;
+        } else {
+            return false;
+        }
+    }
+
+    fn clear_run(&self) {
+        self.running.store(false, Ordering::Release);
+    }
+}
+fn main() {
+    let softirq_example = Arc::new(SoftirqExample::new());
+    let softirq_num = 2;
+    // 注册SoftirqExample中断
+    softirq_vectors()
+        .register_softirq(SoftirqNumber::from(softirq_num as u64), softirq_example)
+        .expect("failed to register SoftirqExample");
+
+    // 标志SoftirqExample中断需要执行
+    softirq_vectors().raise_softirq(SoftirqNumber::from(softirq_num as u64));
+
+    // 标志SoftirqExample中断不需要执行
+    softirq_vectors().clear_softirq_pending(SoftirqNumber::from(softirq_num as u64));
+
+    // 解注册SoftirqExample中断
+    softirq_vectors().unregister_softirq(SoftirqNumber::from(softirq_num as u64));
+}
+```

docs/locales/en/kernel/cpu_arch/index.rst

@@ -0,0 +1,23 @@
+.. note:: AI Translation Notice
+
+   This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+   - Source document: kernel/cpu_arch/index.rst
+
+   - Translation time: 2025-05-19 01:41:20
+
+   - Translation model: `Qwen/Qwen3-8B`
+
+
+   Please report issues via `Community Channel <https://github.com/DragonOS-Community/DragonOS/issues>`_
+
+Processor Architecture
+====================================
+
+   This section of the documentation provides descriptions of some programming implementation details related to the processor architecture.
+
+.. toctree::
+   :maxdepth: 1
+   :caption: Contents
+
+   x86_64/index

docs/locales/en/kernel/cpu_arch/x86_64/index.rst

@@ -0,0 +1,21 @@
+.. note:: AI Translation Notice
+
+   This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+   - Source document: kernel/cpu_arch/x86_64/index.rst
+
+   - Translation time: 2025-05-19 01:41:18
+
+   - Translation model: `Qwen/Qwen3-8B`
+
+
+   Please report issues via `Community Channel <https://github.com/DragonOS-Community/DragonOS/issues>`_
+
+x86-64 Related Documentation
+====================================
+
+.. toctree::
+   :maxdepth: 1
+   :caption: Contents
+
+   usb_legacy_support

docs/locales/en/kernel/cpu_arch/x86_64/usb_legacy_support.md

@@ -0,0 +1,24 @@
+:::{note}
+**AI Translation Notice**
+
+This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+- Source document: kernel/cpu_arch/x86_64/usb_legacy_support.md
+
+- Translation time: 2025-05-19 01:41:19
+
+- Translation model: `Qwen/Qwen3-8B`
+
+Please report issues via [Community Channel](https://github.com/DragonOS-Community/DragonOS/issues)
+
+:::
+
+# USB Legacy Support
+
+## Introduction
+
+  USB Legacy Support refers to the support provided by the BIOS for USB mice and USB keyboards. On computers that support and enable USB Legacy Support, the USB mouse and keyboard are simulated by the BIOS, making them appear to the operating system as if they were PS/2 mice and keyboards.
+
+## Related
+
+- When initializing the USB controller, its USB Legacy Support should be disabled.

docs/locales/en/kernel/debug/debug-kernel-with-gdb.md

@@ -0,0 +1,375 @@
+:::{note}
+**AI Translation Notice**
+
+This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+- Source document: kernel/debug/debug-kernel-with-gdb.md
+
+- Translation time: 2025-05-19 01:41:41
+
+- Translation model: `Qwen/Qwen3-8B`
+
+Please report issues via [Community Channel](https://github.com/DragonOS-Community/DragonOS/issues)
+
+:::
+
+# How to Use GDB to Debug the Kernel
+
+## Introduction
+  GDB is a powerful open-source debugging tool that can help you better diagnose and fix errors in programs.
+
+  It provides a rich set of features that allow you to check the execution status of a program, track the execution flow of code, view and modify the values of variables, analyze memory states, and more. It can be used in conjunction with a compiler to allow you to access debugging information during the debugging process.
+
+  This tutorial will guide you on how to use `rust-gdb` to debug the kernel in DragonOS, including how to start debugging and the corresponding debugging commands.
+
+:::{note}
+If you are already familiar with the various commands of `rust-gdb`, you only need to read the first part of this tutorial.
+:::
+
+---
+## 1. Getting Started
+
+### 1.1 Preparation
+
+  Before you start debugging the kernel, you need to enable debug mode in /Kernel/Cargo.toml by changing `debug = false` to `debug = true` in the Cargo.toml file.
+
+```shell
+debug = false
+```
+  **Change to**
+```shell
+debug = true
+```
+
+### 1.2 Running DragonOS
+
+  After the preparation is complete, you can compile and run DragonOS to proceed with the subsequent debugging work.
+
+  Open a terminal in the root directory of DragonOS and use `make run` to start compiling and running DragonOS. For more help with compilation commands, see
+> [Building DragonOS](https://docs.dragonos.org/zh_CN/latest/introduction/build_system.html).
+
+### 1.3 Running GDB
+  Once DragonOS has started running, you can start debugging with GDB.
+
+  **You only need to open a new terminal and run `make gdb` to start the GDB debugger.**
+
+```shell
+❯ make gdb
+rust-gdb -n -x tools/.gdbinit
+GNU gdb (Ubuntu 12.1-0ubuntu1~22.04) 12.1
+Copyright (C) 2022 Free Software Foundation, Inc.
+License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
+This is free software: you are free to change and redistribute it.
+There is NO WARRANTY, to the extent permitted by law.
+Type "show copying" and "show warranty" for details.
+This GDB was configured as "x86_64-linux-gnu".
+Type "show configuration" for configuration details.
+For bug reporting instructions, please see:
+<https://www.gnu.org/software/gdb/bugs/>.
+Find the GDB manual and other documentation resources online at:
+    <http://www.gnu.org/software/gdb/documentation/>.
+
+--Type <RET> for more, q to quit, c to continue without paging--
+```
+
+:::{note}
+If you see the above information, input `c` and press Enter.
+:::
+
+---
+
+## 2. Debugging
+
+### 2.1 Start
+
+&emsp;&emsp;After completing the above steps, you can start debugging.
+
+```shell
+For help, type "help".
+Type "apropos word" to search for commands related to "word".
+warning: No executable has been specified and target does not support
+determining executable automatically.  Try using the "file" command.
+0xffff8000001f8f63 in ?? ()
+(gdb)
+```
+
+:::{note}
+The output information from GDB, `0xffff8000001f8f63 in ?? ()`, indicates that DragonOS is still in the process of booting.
+:::
+
+&emsp;&emsp;**Input `continue` or `c` to continue the program execution.**
+
+```shell
+For help, type "help".
+Type "apropos word" to search for commands related to "word".
+warning: No executable has been specified and target does not support
+determining executable automatically.  Try using the "file" command.
+0xffff8000001f8f63 in ?? ()
+(gdb) continue
+Continuing.
+```
+
+&emsp;&emsp;While DragonOS is running, you can press `Ctrl+C` at any time to send an interrupt signal to view the current state of the kernel.
+
+```shell
+(gdb) continue
+Continuing.
+^C
+Thread 1 received signal SIGINT, Interrupt.
+0xffff800000140c21 in io_in8 (port=113) at common/glib.h:136
+136         __asm__ __volatile__("inb   %%dx,   %0      \n\t"
+(gdb) 
+```
+
+### 2.2 Setting Breakpoints and Watchpoints
+
+&emsp;&emsp;Setting breakpoints and watchpoints is the most fundamental step in program debugging.
+
+- **Setting Breakpoints**
+
+&emsp;&emsp;You can use the `break` or `b` command to set a breakpoint.
+
+&emsp;&emsp;Regarding the usage of `break` or `b` commands:
+
+```shell
+b <line_number> #在当前活动源文件的相应行号打断点
+
+b <file>:<line_number> #在对应文件的相应行号打断点
+
+b <function_name> #为一个命名函数打断点
+```
+
+- **Setting Watchpoints**
+
+&emsp;&emsp;You can use the `watch` command to set a watchpoint.
+
+```shell
+watch <variable> # 设置对特定变量的监视点,将在特定变量发生变化的时候触发断点
+
+watch <expression> # 设置对特定表达式的监视点，比如watch *(int*)0x12345678会在内存地址0x12345678处
+                   # 的整数值发生更改时触发断点。
+```
+
+- **Managing Breakpoints and Watchpoints**
+
+&emsp;&emsp;Once we have set breakpoints, how can we view all the breakpoint information?
+
+&emsp;&emsp;You can use `info b`, `info break`, or `info breakpoints` to view all breakpoint information:
+
+```shell
+(gdb) b 309
+Breakpoint 12 at 0xffff8000001f8f16: file /home/heyicong/.cargo/registry/src/mirrors.tuna.tsinghua.edu.cn-df7c3c540f42cdbd/thingbuf-0.1.4/src/lib.rs, line 315.
+(gdb) watch slots
+Watchpoint 13: slots
+(gdb) info b
+Num     Type           Disp Enb Address            What
+12      breakpoint     keep y   0xffff8000001f8f16 in thingbuf::Core::pop_ref<u8> 
+                                                   at /home/heyicong/.cargo/registry/src/mirrors.tuna.tsinghua.edu.cn-df7c3c540f42cdbd/thingbuf-0.1.4/src/lib.rs:315
+13      watchpoint     keep y                      slots
+(gdb) 
+```
+
+&emsp;&emsp;In the above information, the breakpoint with number 12 is the one we set in line 309 of the active source file. If its `Address` is `<MULTIPLE>`, it indicates that there are identical breakpoints at multiple addresses. This is very common in loops. The breakpoint with number 13 is the watchpoint we set for the `slots` variable.
+
+&emsp;&emsp;We can perform operations on breakpoints or watchpoints using the following commands:
+
+```shell
+delete <breakpoint#> # 或 d <breakpoint#> 删除对应编号的断点，在您不再需要使用这个断点的时候可以通过此命令删除断点
+delete <watchpoint#> # 或 d <watchpoint##> 删除对应编号的监视点，在您不再需要使用这个监视点的时候可以通过此命令删除监视点
+
+disable <breakpoint#> # 禁用对应编号的断点，这适合于您只是暂时不需要使用这个断点时使用，当您禁用一个断点，下
+                      # 次程序运行到该断点处将不会停下来
+disable <watchpoint#> # 禁用对应编号的监视点，这适合于您只是暂时不需要使用这个监视点时使用
+
+enable <breakpoint#> # 启用对应编号的断点
+enable <watchpoint#> # 启用对应编号的监视点
+
+#clear命令
+clear # 清除当前活动源文件的断点以及监视点
+clear <point_number> # 清除对应编号的所有断点或监视点，这与delete行为是一致的
+clear <file> # 清除指定文件的所有断点与监视点
+```
+
+## 2.3 Viewing Variables and Memory
+
+- **print and display**
+
+&emsp;&emsp;You can use `print` or `p` to print variable values.
+
+&emsp;&emsp;The `print` command is used to print the value of a variable or expression. It allows you to view the data in the program during debugging.
+
+```shell
+print <variable> # 打印对应变量名的值，例如：print my_variable 或者 p my_variable
+
+print <expression> # 打印合法表达式的值，例如：print a+b 或者 p a+b
+
+# 示例输出
+(gdb) print order
+$3 = core::sync::atomic::Ordering::SeqCst
+```
+
+```{note}
+如果您不仅想打印值，还想显示更多详细信息（例如类型信息），可以使用ptype命令。
+```
+
+&emsp;&emsp;You can use the `display` command to continuously track variables or expressions. The `display` command is used to set expressions that need to be tracked and displayed every time the program stops. It is similar to the print command, but unlike print, the display command automatically prints the value of the specified expression every time the program stops, without requiring manual input of a command.
+
+```shell
+display <variable> # 打印对应变量名的值，例如：display my_variable
+
+display <expression> # 打印合法表达式的值，例如：display a+b
+
+# 示例输出
+(gdb) display order
+1: order = core::sync::atomic::Ordering::SeqCst #其中1表示display编号，
+                                                #您可以通过info display命令来查看所有display编号
+```
+
+```{note}
+一旦您设置了display命令，每当程序停止（例如，在断点处停止）时，GDB将自动打印指定表达式的值。
+
+display命令非常有用，因为它允许您在调试过程中持续监视表达式的值，而无需每次都手动输入print命令。它特别适用于那些您希望持续跟踪的变量或表达式。
+```
+
+&emsp;&emsp;**To cancel an already set display command and stop automatically displaying the value of an expression, you can use the undisplay command:**
+
+```shell
+undisplay <display编号> # 如果不指定<display编号>，则将取消所有已设置的display命令，
+                       # 您可以通过info display命令来查看所有display编号
+```
+
+```{note}
+请注意，print和display命令只会在程序暂停执行时评估变量或表达式的值。如果程序正在运行，您需要通过设置断点或使用其他调试命令来暂停程序，然后才能使用print命令查看数据的值,display命令设置的值将会在程序暂停时自动输出。
+```
+
+- **Output Format**
+
+&emsp;&emsp;You can set the output format to get more information you need, for example: `print /a var`
+> Refer to [GDB Cheat Sheet](https://darkdust.net/files/GDB%20Cheat%20Sheet.pdf)
+
+```shell
+Format
+a Pointer.
+c Read as integer, print as character.
+d Integer, signed decimal.
+f Floating point number.
+o Integer, print as octal.
+s Try to treat as C string.
+t Integer, print as binary (t = „two“).
+u Integer, unsigned decimal.
+x Integer, print as hexadecimal.
+```
+
+### 2.4 Viewing the Call Stack
+
+- **Viewing the Call Stack**
+
+&emsp;&emsp;When the program is paused at a breakpoint, how should you trace the program's behavior?
+
+&emsp;&emsp;You can use the `backtarce` command to view the call stack. The `backtrace` command is used to print the backtrace information of the current call stack. It displays all the active function call chains during program execution, including the function names, parameters, and line numbers in the source files.
+
+```shell
+# 示例输出
+(gdb) backtrace 
+#0  function1 (arg1=10, arg2=20) at file1.c:15
+#1  function2 () at file2.c:25
+#2  xx () at xx.c:8
+```
+
+&emsp;&emsp;Each line of backtrace information starts with #<frame_number>, indicating the frame number. Then comes the function name and parameter list, followed by the source file name and line number.
+By viewing the backtrace information, you can understand in which functions the program is executing and the position of each function in the call stack. This is very useful for debugging the program and locating problems.
+
+- **Switching the Stack**
+
+&emsp;&emsp;You can use the `frame` or `f` command to switch to the corresponding stack frame to get more information and perform operations.
+
+```shell
+frame <frame_number>
+f <frame_number>
+```
+
+&emsp;&emsp;In addition to simply executing the backtrace command, you can also use some options to customize the output of the backtrace information. For example:
+```shell
+backtrace full                          #显示完整的符号信息，包括函数参数和局部变量。
+backtrace <frame_count>                 #限制回溯信息的帧数，只显示指定数量的帧。
+backtrace <frame_start>-<frame_end>     #指定要显示的帧范围。
+backtrace thread <thread_id>            #显示指定线程的回溯信息。
+```
+
+### 2.5 Multi-core
+
+&emsp;&emsp;When debugging the kernel, you may need to view the running status of each core.
+
+&emsp;&emsp;You can use the `info threads` command to view the running status of each core.
+
+```shell
+(gdb) info threads 
+  Id   Target Id                    Frame 
+  1    Thread 1.1 (CPU#0 [halted ]) 0xffff800000140a3e in Start_Kernel () at main.c:227
+* 2    Thread 1.2 (CPU#1 [running]) thingbuf::Core::pop_ref<u8> ()
+    at /home/heyicong/.cargo/registry/src/mirrors.tuna.tsinghua.edu.cn-df7c3c540f42cdbd/thingbuf-0.1.4/src/lib.rs:315
+(gdb) 
+```
+
+&emsp;&emsp;You can use the `thread <thread_id>` command to switch to the context of a specific core to view and debug the status of that core. For example:
+
+```shell
+(gdb) thread 1
+[Switching to thread 1 (Thread 1.1)]
+#0  0xffff800000140a3e in Start_Kernel () at main.c:227
+227                 hlt();
+```
+
+### 2.6 More
+
+&emsp;&emsp;Next, I will introduce more commands that you may find useful during debugging:
+
+```shell
+step                #或者s,逐行执行程序，并进入到函数调用中。可以在step命令后加执行次数，例：step 3 表示要连续执行3个步骤
+step <function>     #进入指定的函数，并停止在函数内的第一行。
+
+next                #或者n,逐行执行程序，但跳过函数调用，直接执行函数调用后的下一行代码。
+                    #它允许你在不进入函数内部的情况下执行代码，从而快速跳过函数调用的细节。
+                    #同样，next也可以在命令后加执行次数
+
+finish              #用于从当前函数中一直执行到函数返回为止，并停在调用该函数的地方。
+                    #它允许你快速执行完当前函数的剩余部分，并返回到调用函数的上下文中。  
+
+continue            #用于继续程序的执行，直到遇到下一个断点或
+                    #程序正常结束或者程序暂停。 
+
+quit                #退出调试                    
+
+list                            #或者l，显示当前活动源文件源代码的片段，以及当前执行的位置。
+list <filename>:<function>      #显示<filename>文件里面的<funtion>函数的源代码片段
+list <filename>:<line_number>   #显示<filename>文件里面的<line_number>附近的源代码片段
+list <first>,<last>             #显示当前活动源文件的<first>至<last>之间的源代码片段
+set listsize <count>            #设置list命令显示的源代码行数。默认情况下，list命令显示当前行和其周围的几行代码。
+
+info args                       #显示当前函数的参数及其值
+info breakpoints                #显示断点以及监视点信息
+info display                    #显示当前设置的display列表
+info locals                     #显示当前函数/栈帧中的局部变量及其值
+info sharedlibrary              #显示当前已加载的共享库（shared library）信息
+info signals                    #显示当前程序所支持的信号信息。它可以列出程序可以接收和处理的不同信号的列表。
+info threads                    #显示各个核心/线程信息，它可以列出当前正在运行的核心/线程以及它们的状态。
+
+show directories                #显示当前源代码文件的搜索路径列表。这些搜索路径决定了GDB在查找源代码文件时的搜索范围。
+show listsize                   #显示打印源代码时的上下文行数。它确定了在使用list命令（或其简写形式l）时显示的源代码行数。
+
+whatis variable_name            #查看给定变量或表达式的类型信息。它可以帮助你了解变量的数据类型。
+ptype                           #显示给定类型或变量的详细类型信息。它可以帮助你了解类型的结构和成员。
+                                #相较于whatis命令，ptype命令更加详细。
+
+set var <variable_name>=<value> #设置变量值
+
+return <expression>             #强制使当前函数返回设定值                                                  
+```
+
+---
+
+## Conclusion
+
+&emsp;&emsp;Now, you can use rust-gdb to debug the DragonOS kernel code.
+
+> You can refer to the GDB command documentation for more help: [GDB Cheat Sheet](https://darkdust.net/files/GDB%20Cheat%20Sheet.pdf)

docs/locales/en/kernel/debug/index.rst

@@ -0,0 +1,25 @@
+.. note:: AI Translation Notice
+
+   This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+   - Source document: kernel/debug/index.rst
+
+   - Translation time: 2025-05-19 01:41:09
+
+   - Translation model: `Qwen/Qwen3-8B`
+
+
+   Please report issues via `Community Channel <https://github.com/DragonOS-Community/DragonOS/issues>`_
+
+Kernel Debug Module
+====================================
+
+   This is the documentation for the kernel debug module of DragonOS.
+
+.. toctree::
+   :maxdepth: 1
+   :caption: Contents
+
+   traceback
+   debug-kernel-with-gdb
+   profiling-kernel-with-dadk

docs/locales/en/kernel/debug/profiling-kernel-with-dadk.md

@@ -0,0 +1,109 @@
+:::{note}
+**AI Translation Notice**
+
+This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+- Source document: kernel/debug/profiling-kernel-with-dadk.md
+
+- Translation time: 2025-05-19 01:41:49
+
+- Translation model: `Qwen/Qwen3-8B`
+
+Please report issues via [Community Channel](https://github.com/DragonOS-Community/DragonOS/issues)
+
+:::
+
+# Performance Analysis of the Kernel Using DADK
+
+## 1. Overview
+
+This document will teach you how to use DADK to perform performance analysis on the DragonOS kernel, in order to identify and resolve potential performance bottlenecks.
+
+### 1.1 Preparation
+
+::: {note}
+Before you start, please ensure that you have installed DADK and have set up the compilation environment for the DragonOS kernel.
+:::
+
+### 1.2 What is a Flame Graph?
+
+If you haven't heard of flame graphs before, you can read this article: [How to Read Flame Graphs? - Ruanyifeng](https://www.ruanyifeng.com/blog/2017/09/flame-graph.html)
+
+In simple terms, a flame graph is an SVG image generated from performance sampling results, used to display the call stack of the CPU.
+
+![](https://web-static2.dragonos.org.cn//longjin/flame2.svg?imageSlim)
+
+The x-axis represents the number of samples. If a function occupies a wider width on the x-axis, it means it was sampled more frequently, indicating longer execution time. Note that the x-axis does not represent time, but rather all call stacks are merged and sorted alphabetically.
+
+A flame graph is used to identify which function at the top level occupies the largest width. If there is a "plateau" (flat area), it indicates that the function may have performance issues.
+
+Colors have no special meaning, as flame graphs represent the CPU's busy level, so warm tones are generally chosen.
+
+## 2. Configuring the DragonOS Kernel
+
+Since performance analysis requires detailed symbol table data, we need to configure the kernel compilation as follows:
+
+In `kernel/Cargo.toml`'s `[profile.release]` section, set the following two options:
+
+```toml
+[profile.release]
+debug = true
+opt-level = 1
+```
+
+This will ensure that the compiled kernel includes symbol table data, making it easier for us to perform performance analysis.
+
+## 3. Using DADK for Performance Analysis
+
+### 3.1 Booting the Kernel
+
+First, we need to boot the DragonOS kernel.
+
+```shell
+# 使用你喜欢的方式启动内核，例如：
+make run
+# 或者
+make build && make qemu-nographic
+```
+
+### 3.2 Running Your Workload
+
+After booting the kernel, we need to run some workloads in order to perform performance analysis.
+
+This can be an application or something else. Even you can choose to do nothing and simply observe the call stack of the DragonOS kernel when it is idle.
+
+### 3.3 Starting DADK for Performance Analysis
+
+In the DragonOS project directory, run the following command:
+
+```shell
+dadk profile sample --format flamegraph  --output flame.svg --interval 200ms --duration 20s  --cpu-mask 0x1
+```
+
+The above command will perform performance analysis on the DragonOS kernel and generate a flame graph.
+
+Detailed explanation:
+
+- `--format flamegraph`: Specifies the output format as a flame graph.
+- `--output flame.svg`: Specifies the output filename as `flame.svg`.
+- `--interval 200ms`: Specifies the sampling interval as 200ms.
+- `--duration 20s`: Specifies the sampling duration as 20 seconds.
+- `--cpu-mask 0x1`: Specifies the CPU to be sampled as CPU 0. (This is a bitmask, meaning if you want to sample CPU 0 and 1, the cpu-mask would be 0x3)
+
+*For more parameters, please refer to `dadk profile sample --help`.*
+
+::: {note}
+Since sampling will pause vCPU, the sampling time should not be too short, otherwise it may affect the normal operation of the system.
+:::
+
+After waiting for a while, you will get a `flame.svg` file.
+
+### 3.4 Analyzing the Flame Graph
+
+Open the `flame.svg` file in a browser, and you will see a flame graph.
+
+You can click on a function in the flame graph to view its call stack.
+
+**You can right-click the image below and open it in a new tab to experience the interactive effects.**
+
+![](https://web-static2.dragonos.org.cn//longjin/flame2.svg?imageSlim)

docs/locales/en/kernel/debug/traceback.md

@@ -0,0 +1,50 @@
+:::{note}
+**AI Translation Notice**
+
+This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+- Source document: kernel/debug/traceback.md
+
+- Translation time: 2025-05-19 01:41:10
+
+- Translation model: `Qwen/Qwen3-8B`
+
+Please report issues via [Community Channel](https://github.com/DragonOS-Community/DragonOS/issues)
+
+:::
+
+# Kernel Stack Traceback
+
+## Introduction
+
+  The functionality of the kernel stack traceback is located in the `kernel/debug/traceback/` folder. It provides traceback capabilities for the kernel mode, printing the call stack to the screen.
+
+---
+
+## API
+
+### `void traceback(struct pt_regs * regs)`
+
+#### Purpose
+
+  This interface is defined in `kernel/debug/traceback/traceback.h`, which will perform a traceback on the given kernel stack and print the trace results to the screen.
+
+#### Parameters
+
+##### regs
+
+  The first stack frame of the kernel stack to start the tracing (i.e., the bottom of the stack)
+
+---
+
+## Implementation Principle
+
+  After the kernel is linked for the first time, the Makefile will run the `kernel/debug/kallsyms` program to extract the symbol table of the kernel file, and then generate `kernel/debug/kallsyms.S`. The rodata segment of this file stores the symbol table of the functions in the text segment. Then, this file will be compiled into `kallsyms.o`. Finally, the Makefile will again call the `ld` command to link the kallsyms.o into the kernel file.
+
+  When the `traceback` function is called, it will traverse the symbol table to find the corresponding symbols and output them.
+
+---
+
+## Future Development Directions
+
+- Add the capability to write to a log file

docs/locales/en/kernel/filesystem/index.rst

@@ -0,0 +1,29 @@
+.. note:: AI Translation Notice
+
+   This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+   - Source document: kernel/filesystem/index.rst
+
+   - Translation time: 2025-05-19 01:41:15
+
+   - Translation model: `Qwen/Qwen3-8B`
+
+
+   Please report issues via `Community Channel <https://github.com/DragonOS-Community/DragonOS/issues>`_
+
+File System
+====================================
+
+The file system module of DragonOS consists of VFS (Virtual File System) and specific file systems.
+
+todo: Due to the refactoring of the file system module, the documentation is temporarily unavailable and will be completed by April 10, 2023.
+
+.. toctree::
+   :maxdepth: 1
+   :caption: Contents
+
+   overview
+   vfs/index
+   sysfs
+   kernfs
+   unionfs/index

docs/locales/en/kernel/filesystem/kernfs.md

@@ -0,0 +1,37 @@
+:::{note}
+**AI Translation Notice**
+
+This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+- Source document: kernel/filesystem/kernfs.md
+
+- Translation time: 2025-05-19 01:41:15
+
+- Translation model: `Qwen/Qwen3-8B`
+
+Please report issues via [Community Channel](https://github.com/DragonOS-Community/DragonOS/issues)
+
+:::
+
+# KernFS
+
+:::{note}
+
+Maintainer:
+- Long Jin <longjin@dragonos.org>
+:::
+
+## 1. Introduction
+&emsp;&emsp;KernFS is a pseudo file system that acts as a container for other kernel file systems, providing a file interface to users. Its core functionality is that when files in KernFS are read/written or trigger callback points, the predefined callback functions will be invoked, triggering operations on other kernel file systems.
+
+&emsp;&emsp;This design decouples the basic operations of SysFS and file systems. KernFS serves as the carrier of SysFS, allowing SysFS to focus more on the management of KObjects, resulting in more elegant code.
+
+&emsp;&emsp;In the future, the kernel subsystem of DragonOS or other kernel file systems can use KernFS as a carrier for file system operations, decoupling the system management logic from specific file system operations.
+
+## 2. Usage
+
+&emsp;&emsp;Taking SysFS as an example, a new KernFS instance is created as the file system interface for SysFS, and then it is mounted under the directory `/sys`. Then, sysfs implements the upper-layer logic to manage KObjects. Each upper-layer KObject must include a KernFSInode. By setting the PrivateData of KernFSInode, KernFS can retrieve the corresponding KObject or sysfs attribute based on the Inode. Furthermore, when creating a KernFSInode, different callbacks are passed to the specific Inode, enabling "different Inodes to trigger different callback behaviors when read or written."
+
+&emsp;&emsp;When a callback occurs, KernFS passes the callback information and private information to the callback function, allowing the callback function to retrieve the corresponding KObject or sysfs attribute based on the input information, thus achieving the high-level functionality provided by sysfs.
+
+&emsp;&emsp;From the above description, we can see that KernFS achieves the purpose of "decoupling specific file operations from high-level management logic" by storing the callback functions and callback information of the upper-layer file systems.

docs/locales/en/kernel/filesystem/overview.md

@@ -0,0 +1,107 @@
+:::{note}
+**AI Translation Notice**
+
+This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+- Source document: kernel/filesystem/overview.md
+
+- Translation time: 2025-05-19 01:41:36
+
+- Translation model: `Qwen/Qwen3-8B`
+
+Please report issues via [Community Channel](https://github.com/DragonOS-Community/DragonOS/issues)
+
+:::
+
+:::{note}
+Author of this article: Long Jin
+
+Email: <longjin@DragonOS.org>
+:::
+
+# Overview
+
+&emsp;&emsp;In this article, we will introduce the architecture design of the DragonOS file system.
+
+## Overview
+
+&emsp;&emsp;As shown in the following diagram, the file system-related mechanisms of DragonOS mainly include the following parts:
+
+- System call interface
+- Virtual File System (VFS)
+    - File abstraction (File)
+    - Mount file system (MountFS)
+- Specific file systems
+
+```text
+            ┌─────────────────────────────────────────────────┐
+            │                                                 │
+Syscall:    │   sys_open, sys_read, sys_write, sys_close,     │
+            │                                                 │
+            │   sys_lseek, etc..                              │
+            │                                                 │
+            └───────────────────────┬─────────────────────────┘
+                                    │
+                                    │
+    VFS:                     ┌──────▼─────┐
+                             │            │
+                             │    File    │
+                             │            │
+                             └──────┬─────┘
+                                    │
+                           ┌────────▼────────┐
+                           │                 │
+                           │     MountFS     │
+                           │                 │
+                           └────┬────────────┘
+                                │
+   Filesystems:   ┌─────────────┼─────────────┬────────────┐
+                  │             │             │            │
+            ┌─────▼─────┐ ┌─────▼─────┐ ┌─────▼────┐ ┌─────▼─────┐
+            │           │ │           │ │          │ │           │
+            │    FAT    │ │   DevFS   │ │  ProcFS  │ │   RamFS   │
+            │           │ │           │ │          │ │           │
+            └───────────┘ └───────────┘ └──────────┘ └───────────┘
+```
+
+## System Call Interface
+
+&emsp;&emsp;The file system-related system call interfaces of DragonOS mainly include the following:
+
+- `sys_open`: Open file
+- `sys_read`: Read file
+- `sys_write`: Write file
+- `sys_close`: Close file
+- `sys_lseek`: Set file pointer position
+- `sys_mkdir`: Create directory
+- `sys_unlink_at`: Delete file or directory (distinguish between file and directory by parameter `flag`)
+- `sys_ioctl`: Control device (not implemented)
+- `sys_fstat`: Get file status (not implemented)
+- `sys_fsync`: Synchronize file (not implemented)
+- `sys_ftruncate`: Truncate file (not implemented)
+- `sys_fchmod`: Modify file permissions (not implemented)
+- Other system call interfaces (not implemented)
+
+&emsp;&emsp;For the specific meaning of the interfaces, you can refer to the relevant documentation of Linux.
+
+## Virtual File System (VFS)
+
+&emsp;&emsp;VFS is the core of the DragonOS file system, providing a unified set of file system interfaces, allowing DragonOS to support various different file systems. The main functions of VFS include:
+
+- Provide a unified file system interface
+- Provide file system mounting and unmounting mechanism (MountFS)
+- Provide file abstraction (File)
+- Provide file system abstraction (FileSystem)
+- Provide IndexNode abstraction
+- Provide file system caching and synchronization mechanism (not implemented yet)
+
+&emsp;&emsp;For detailed introduction of VFS, please see [DragonOS Virtual File System](vfs/index.rst).
+
+## Specific File Systems
+
+&emsp;&emsp;The file systems currently supported by DragonOS include:
+
+- FAT file system (FAT12, FAT16, FAT32)
+- DevFS
+- ProcFS
+- RamFS

docs/locales/en/kernel/filesystem/sysfs.md

@@ -0,0 +1,124 @@
+:::{note}
+**AI Translation Notice**
+
+This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+- Source document: kernel/filesystem/sysfs.md
+
+- Translation time: 2025-05-19 01:41:50
+
+- Translation model: `Qwen/Qwen3-8B`
+
+Please report issues via [Community Channel](https://github.com/DragonOS-Community/DragonOS/issues)
+
+:::
+
+# SysFS
+
+:::{note}
+Author: Huang Ting
+
+Email: <huangting@DragonOS.org>
+:::
+
+## 1. SysFS and Device Driver Model
+
+### 1.1. The relationship between devices, drivers, buses, etc., is complex
+
+&emsp;&emsp;If you want the kernel to run smoothly, you must code these functionalities for each module. This will make the kernel very bloated and redundant. The idea of the device model is to abstract these codes into a shared framework for all modules. This not only makes the code concise, but also allows device driver developers to avoid the headache of this essential but burdensome task, and focus their limited energy on implementing the differences of the devices.
+
+&emsp;&emsp;The device model provides a template, an optimal approach and process that has been proven. This reduces unnecessary errors during the development process and clears the way for future maintenance.
+
+### 1.2. sysfs is a memory-based file system, its role is to provide kernel information in the form of files for user programs to use.
+
+&emsp;&emsp;sysfs can be seen as a file system similar to proc, devfs, and devpty. This file system is virtual and can make it easier to manage system devices. It can generate a hierarchical view of all system hardware, similar to the proc file system that provides process and status information. sysfs organizes the devices and buses connected to the system into a hierarchical file structure, which can be accessed from user space, exporting kernel data structures and their attributes to user space.
+
+## 2. Device Driver Model in DragonOS
+
+### 2.1. The basic elements are composed of devices and drivers
+
+#### 2.1.1. Device
+
+```rust
+/// @brief: 所有设备都应该实现该trait
+pub trait Device: Any + Send + Sync + Debug {}
+```
+
+&emsp;&emsp;DragonOS uses a global device manager to manage all devices in the system.
+
+```rust
+/// @brief Device管理器
+#[derive(Debug, Clone)]
+pub struct DeviceManager {
+    devices: BTreeMap<IdTable, Arc<dyn Device>>, // 所有设备
+    sys_info: Option<Arc<dyn IndexNode>>,  // sys information
+}
+```
+
+#### 2.1.2. Driver
+
+```rust
+/// @brief: 所有驱动驱动都应该实现该trait
+pub trait Driver: Any + Send + Sync + Debug {}
+```
+
+&emsp;&emsp;Similarly, drivers also use a global driver manager for management.
+
+```rust
+/// @brief: 驱动管理器
+#[derive(Debug, Clone)]
+pub struct DriverManager {
+    drivers: BTreeMap<IdTable, Arc<dyn Driver>>, // 所有驱动
+    sys_info: Option<Arc<dyn IndexNode>>, // sys information
+}
+```
+
+### 2.2. Bus
+
+&emsp;&emsp;Bus is a type of device, and it also needs a driver to initialize. Due to the special nature of buses, a global bus manager is used for management.
+
+```rust
+/// @brief: 总线驱动trait，所有总线驱动都应实现该trait
+pub trait BusDriver: Driver {}
+
+/// @brief: 总线设备trait，所有总线都应实现该trait
+pub trait Bus: Device {}
+
+/// @brief: 总线管理结构体
+#[derive(Debug, Clone)]
+pub struct BusManager {
+    buses: BTreeMap<IdTable, Arc<dyn Bus>>,          // 总线设备表
+    bus_drvs: BTreeMap<IdTable, Arc<dyn BusDriver>>, // 总线驱动表
+    sys_info: Option<Arc<dyn IndexNode>>,            // 总线inode
+}
+```
+
+&emsp;&emsp;As can be seen, each manager contains a sys_info. The device model establishes a connection with sysfs through this member, and sys_info points to the unique inode in sysfs. For a device, it corresponds to the devices folder under sysfs, and the same applies to other components.
+
+## 3. How to Develop Drivers
+
+&emsp;&emsp;Taking the platform bus as an example, the platform bus is a virtual bus that can match devices and drivers mounted on it and drive the devices. This bus is a type of device and also a type of bus. When programming, you need to create an instance of this device and implement the Device trait and Bus trait for the device instance to indicate that this structure is a bus device. At the same time, the matching rules on the bus should be implemented. Different buses have different matching rules. This bus uses a matching table for matching, and both devices and drivers should have a matching table, indicating the devices supported by the driver and the drivers supported by the device.
+
+```rust
+pub struct CompatibleTable(BTreeSet<&'static str>);
+```
+
+&emsp;&emsp;For a bus device, you need to call bus_register to register the bus into the system and visualize it in sysfs.
+
+```rust
+/// @brief: 总线注册，将总线加入全局总线管理器中，并根据id table在sys/bus和sys/devices下生成文件夹
+/// @parameter bus: Bus设备实体
+/// @return: 成功:()   失败:DeviceError
+pub fn bus_register<T: Bus>(bus: Arc<T>) -> Result<(), DeviceError> {
+    BUS_MANAGER.add_bus(bus.get_id_table(), bus.clone());
+    match sys_bus_register(&bus.get_id_table().to_name()) {
+        Ok(inode) => {
+            let _ = sys_bus_init(&inode);
+            return device_register(bus);
+        }
+        Err(_) => Err(DeviceError::RegisterError),
+    }
+}
+```
+
+&emsp;&emsp;From the source code of bus_register, we can see that this function not only generates a bus folder under sysfs/bus, but also internally calls device_register. This function adds the bus to the device manager and generates a device folder under sys/devices.

docs/locales/en/kernel/filesystem/unionfs/index.rst

@@ -0,0 +1,23 @@
+.. note:: AI Translation Notice
+
+   This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+   - Source document: kernel/filesystem/unionfs/index.rst
+
+   - Translation time: 2025-05-19 01:41:16
+
+   - Translation model: `Qwen/Qwen3-8B`
+
+
+   Please report issues via `Community Channel <https://github.com/DragonOS-Community/DragonOS/issues>`_
+
+====================================
+Union Filesystem
+====================================
+Union Filesystem:
+OverlayFS merges multiple filesystems (referred to as "layers") into a single logical filesystem, allowing users to see a unified directory structure.
+
+.. toctree::
+   :maxdepth: 1
+
+   overlayfs

docs/locales/en/kernel/filesystem/unionfs/overlayfs.md

@@ -0,0 +1,46 @@
+:::{note}
+**AI Translation Notice**
+
+This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+- Source document: kernel/filesystem/unionfs/overlayfs.md
+
+- Translation time: 2025-05-19 01:41:18
+
+- Translation model: `Qwen/Qwen3-8B`
+
+Please report issues via [Community Channel](https://github.com/DragonOS-Community/DragonOS/issues)
+
+:::
+
+# overlayfs
+
+OverlayFS is currently the most widely used union file system, with a simple principle and convenient usage, mainly used in containers.
+
+In Docker, OverlayFS is one of the default storage drivers. Docker creates an independent upper directory for each container, while all containers share the same lower image file. This design makes resource sharing between containers more efficient and reduces storage requirements.
+
+## Architecture Design
+
+OverlayFS has two layers and a virtual merged layer.
+
+- **Lower Layer (Lower Layer)**: Usually a read-only file system. It can contain multiple layers.
+- **Upper Layer (Upper Layer)**: A writable layer. All write operations are performed on this layer.
+- **Merged Layer (Merged Layer)**: The logical view of the upper and lower layers is merged, and the final file system presented to the user is shown.
+
+## Working Principle
+
+- **Read Operation**:
+    - OverlayFS will first read the file from the Upper Layer. If the file does not exist in the upper layer, it will read the content from the Lower Layer.
+- **Write Operation**:
+    - If a file is located in the Lower Layer and an attempt is made to write to it, the system will copy it up to the Upper Layer and then write to it in the upper layer. If the file already exists in the Upper Layer, it will be directly written to that layer.
+- **Delete Operation**:
+    - When deleting a file, OverlayFS creates a whiteout entry in the upper layer, which hides the file in the lower layer.
+
+## Copy-up
+
+- **Copy-on-Write (Write-time Copy)**
+When a file in the lower layer is modified, it is copied to the upper layer (called copy-up). All subsequent modifications will be performed on the copied file in the upper layer.
+
+## Implementation Logic
+
+The implementation is achieved by building `ovlInode` to implement the `indexnode` trait to represent the inode of the upper or lower layer. Specific operations related to files and directories are handled accordingly.

docs/locales/en/kernel/filesystem/vfs/api.md

@@ -0,0 +1,16 @@
+:::{note}
+**AI Translation Notice**
+
+This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+- Source document: kernel/filesystem/vfs/api.md
+
+- Translation time: 2025-05-19 01:41:12
+
+- Translation model: `Qwen/Qwen3-8B`
+
+Please report issues via [Community Channel](https://github.com/DragonOS-Community/DragonOS/issues)
+
+:::
+
+# VFS API Documentation

docs/locales/en/kernel/filesystem/vfs/design.md

@@ -0,0 +1,72 @@
+:::{note}
+**AI Translation Notice**
+
+This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+- Source document: kernel/filesystem/vfs/design.md
+
+- Translation time: 2025-05-19 01:41:33
+
+- Translation model: `Qwen/Qwen3-8B`
+
+Please report issues via [Community Channel](https://github.com/DragonOS-Community/DragonOS/issues)
+
+:::
+
+:::{note}
+Author of this article: Long Jin
+
+Email: <longjin@DragonOS.org>
+:::
+
+# Design
+
+&emsp;&emsp;The architecture design of VFS is shown in the following diagram:
+
+```text
+                      ┌─────────┐
+                      │         │
+                      │  read   │
+            File      │         │
+                      │  write  │
+             │        │         │
+             │        │  ioctl  │
+             │        │         │
+             │        │  lseek  │
+             │        │         │
+             │        │  etc..  │
+             │        └─────────┘
+             │
+             ▼        ┌──────────────────────────────────────────────────────────────────────────────┐
+            MountFS   │ Maintain the mount tree and handle the mounting of file systems.             │
+               │      │    In particular, it handles the "crossing file system boundaries" condition │
+               │      │    while doing "lookup" or "find" operations.                                │
+               │      └──────────────────────────────────────────────────────────────────────────────┘
+               │
+               │
+               │
+Filesystems:   │
+               │
+               ▼      ┌────────────────────────────────────────────────────────────────────┐
+          xxxFSInode  │ Implement corresponding operations based on different file systems │
+                      └────────────────────────────────────────────────────────────────────┘
+```
+
+## 1. File
+&emsp;&emsp;The File structure is the most basic abstraction in VFS, representing an opened file. Whenever a process opens a file, a File structure is created to maintain the state information of that file.
+
+## 2. Traits
+
+&emsp;&emsp;For each specific file system, the following traits must be implemented:
+
+- FileSystem: Indicates that a struct is a file system
+- IndexNode: Indicates that a struct is an index node
+
+&emsp;&emsp;Generally, there is a one-to-one relationship between FileSystem and IndexNode, meaning that one file system corresponds to one type of IndexNode. However, for some special file systems, such as DevFS, different IndexNodes may exist based on different device types. Therefore, there is a one-to-many relationship between FileSystem and IndexNode.
+
+## 3. MountFS
+
+&emsp;&emsp;Although MountFS implements the FileSystem and IndexNode traits, it is not itself a "file system," but rather a mechanism used to mount different file systems onto the same file system tree.
+All file systems that need to be mounted onto the file system tree must go through MountFS to complete the mounting process. In other words, each file system structure in the mount tree is wrapped with a MountFS structure.
+
+&emsp;&emsp;For most operations, MountFS simply forwards the operation to the specific file system without any processing. At the same time, to support cross-file system operations, such as searching in a directory tree, each lookup or find operation will go through the corresponding method of MountFSInode to determine whether the current inode is a mount point and handle it specially. If the operation is found to cross the boundary of a specific file system, MountFS will forward the operation to the next file system and perform an inode replacement. This functionality is implemented by wrapping a regular Inode structure with a MountFSInode structure.

docs/locales/en/kernel/filesystem/vfs/index.rst

@@ -0,0 +1,33 @@
+.. note:: AI Translation Notice
+
+   This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+   - Source document: kernel/filesystem/vfs/index.rst
+
+   - Translation time: 2025-05-19 01:41:14
+
+   - Translation model: `Qwen/Qwen3-8B`
+
+
+   Please report issues via `Community Channel <https://github.com/DragonOS-Community/DragonOS/issues>`_
+
+VFS Virtual File System
+====================================
+
+In DragonOS, VFS acts as an adapter, hiding the differences between specific file systems and providing a unified file operation interface abstraction to the outside.
+
+VFS is the core of the file system in DragonOS. It provides a set of unified file system interfaces, enabling DragonOS to support various different file systems. The main functions of VFS include:
+
+- Providing a unified file system interface
+- Providing mount and unmount mechanisms for file systems (MountFS)
+- Providing file abstraction (File)
+- Providing file system abstraction (FileSystem)
+- Providing IndexNode abstraction
+- Providing caching and synchronization mechanisms for file systems (not yet implemented)
+
+.. toctree::
+   :maxdepth: 1
+   :caption: Directory
+
+   design
+   api

docs/locales/en/kernel/ipc/index.rst

@@ -0,0 +1,23 @@
+.. note:: AI Translation Notice
+
+   This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+   - Source document: kernel/ipc/index.rst
+
+   - Translation time: 2025-05-19 01:41:19
+
+   - Translation model: `Qwen/Qwen3-8B`
+
+
+   Please report issues via `Community Channel <https://github.com/DragonOS-Community/DragonOS/issues>`_
+
+====================================
+Inter-Process Communication
+====================================
+
+   This is the documentation for DragonOS Inter-Process Communication (IPC).
+
+.. toctree::
+   :maxdepth: 1
+
+   signal

docs/locales/en/kernel/ipc/signal.md

@@ -0,0 +1,97 @@
+:::{note}
+**AI Translation Notice**
+
+This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+- Source document: kernel/ipc/signal.md
+
+- Translation time: 2025-05-19 01:41:43
+
+- Translation model: `Qwen/Qwen3-8B`
+
+Please report issues via [Community Channel](https://github.com/DragonOS-Community/DragonOS/issues)
+
+:::
+
+# Signal Signal
+
+:::{note}
+This document Maintainer: Longjin
+
+Email: <longjin@RinGoTek.cn>
+:::
+
+&emsp;&emsp;Signals are a mechanism for inter-process communication. When a signal is sent to a specific process, it can trigger a specific behavior (such as exiting the program or running a signal handler). Signals are asynchronous notifications sent to a process or a specific thread within the same process, used to notify it that an event has occurred. Common uses of signals include interrupting, suspending, terminating, or ending a process. When sending a signal, the operating system interrupts the normal execution flow of the target process to deliver the signal. Execution can be interrupted at any non-atomic instruction. If the process has previously registered a signal handler, the handler routine is executed. Otherwise, the default signal handler is executed.
+
+&emsp;&emsp;Signals are similar to interrupts, with the difference being that interrupts are mediated by the CPU and handled by the kernel, while signals are generated within the kernel (and can also be generated through system calls) and are handled by the default handlers of individual processes or the kernel.
+
+## 1. Overview of Signal Handling
+
+### 1.1 Signal Sending
+
+&emsp;&emsp;When process A wants to send a signal to process B, it uses the `kill(pid, signal)` interface to send the signal. Then, it enters the `sys_kill()` function in the kernel for processing. The kernel will then add the signal to the `sigpending` in the target process's PCB.
+
+Illustration:
+
+```text
+   ┌────────────┐
+   │ Process A: │
+   │            │
+   │  sys_kill  │
+   └──────┬─────┘
+          │
+          │
+   ┌──────▼──────┐    ┌────────────────────┐
+   │ Send Signal ├────►Add to sigpending of│
+   └─────────────┘    │   process B.       │
+                      └────────────────────┘
+
+```
+
+### 1.2 Signal Handling
+
+&emsp;&emsp;When a process exits the kernel mode, it jumps into the `do_signal()` function to check if there are any signals that need to be handled. If there are, the signal handling process is initiated.
+
+Signal handling process illustration:
+
+```text
+
+ ┌───────────────────────┐
+ │       Process B:      │
+ │                       ◄─────────────────────────────────┐
+ │ Return from syscall...│                                 │
+ └─────────┬─────────────┘                                 │
+           │                                               │
+           │                                               │
+           │                ┌────────────────┐             │
+     ┌─────▼─────┐ default  │                │             │
+     │ do_signal ├────────► │ stop process B.│             │
+     └─────┬─────┘  action  │                │             │
+           │                └────────────────┘             │
+           │ custom action                                 │
+    ┌──────▼───────┐                                       │
+    │ setup signal │                                       │
+    │    frame     │                                       │
+    └──────┬───────┘                                       │
+           │jump to                                        │
+    ┌──────▼───────┐ ┌────────────┐ sys_sigreturn ┌────────┴────────┐
+    │   userland   ├─►sa_restorer ├──────────────►│Restore the stack│
+    │ sig handler  │ └────────────┘               │    frame.       │
+    └──────────────┘                              └─────────────────┘
+
+```
+
+- If the kernel checks and finds that the process has not specified a signal handler and the signal handling action is not "ignore", the process will be terminated.
+- If the kernel finds that the signal is not ignored, it will:
+    - Save the current kernel stack
+    - Set up the user-mode stack frame for signal handling
+    - Return to user mode and execute the signal handler
+    - After the signal handler finishes, it will enter the __sa_restorer__ provided by libc, initiating the `sys_sigreturn()` system call to return to kernel mode
+    - The kernel restores the kernel stack before handling the signal.
+    - The signal handling process ends, and the kernel continues with the process of returning to user mode.
+- If the kernel finds that the current signal is being ignored, it checks the next signal.
+- If no signals need to be handled, it returns to user mode.
+
+## 2. Other Issues
+
+&emsp;&emsp;None at present.

docs/locales/en/kernel/ktest/index.rst

@@ -0,0 +1,26 @@
+.. note:: AI Translation Notice
+
+   This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+   - Source document: kernel/ktest/index.rst
+
+   - Translation time: 2025-05-19 01:41:16
+
+   - Translation model: `Qwen/Qwen3-8B`
+
+
+   Please report issues via `Community Channel <https://github.com/DragonOS-Community/DragonOS/issues>`_
+
+====================================
+Kernel Testing
+====================================
+
+   This chapter will introduce how to test the kernel, including manual testing and automated testing.
+
+   We need to perform thorough testing on the kernel as much as possible, so that we can better ensure the stability of the kernel and reduce the difficulty of debugging other modules.
+
+   Setting up comprehensive test cases can help us detect problems as much as possible, preventing us from being "stabbed" by hidden bugs in existing modules when writing new modules.
+
+   Since it is difficult to debug using tools like GDB, manual testing in the kernel is more challenging compared to testing applications.
+
+   For some modules, we can write code for unit testing and output error messages. Unfortunately, not all modules can be unit tested. For example, common modules such as memory management and process management cannot be unit tested.

docs/locales/en/kernel/libs/id-allocation.md

@@ -0,0 +1,26 @@
+:::{note}
+**AI Translation Notice**
+
+This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+- Source document: kernel/libs/id-allocation.md
+
+- Translation time: 2025-05-19 01:41:12
+
+- Translation model: `Qwen/Qwen3-8B`
+
+Please report issues via [Community Channel](https://github.com/DragonOS-Community/DragonOS/issues)
+
+:::
+
+# ID Allocation
+
+:::{note}
+Author: Longjin <longjin@DragonOS.org>
+
+September 25, 2024
+:::
+
+The kernel provides an ID allocator named `IdAllocator`, located in `kernel/crates/ida`.
+
+It is capable of allocating and releasing IDs. By default, it increments to allocate IDs. If the ID exceeds the set maximum value, it will search for an available ID starting from the minimum value. If there are no available IDs, the allocation will fail.

docs/locales/en/kernel/libs/index.rst

@@ -0,0 +1,26 @@
+.. note:: AI Translation Notice
+
+   This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+   - Source document: kernel/libs/index.rst
+
+   - Translation time: 2025-05-19 01:41:11
+
+   - Translation model: `Qwen/Qwen3-8B`
+
+
+   Please report issues via `Community Channel <https://github.com/DragonOS-Community/DragonOS/issues>`_
+
+====================================
+Other Kernel Libraries
+====================================
+
+   This section contains documentation for some libraries in the kernel that do not belong to any subsystem.
+
+.. toctree::
+   :maxdepth: 1
+
+   lib_ui/scm
+   lib_ui/textui
+   unified-init
+   id-allocation

docs/locales/en/kernel/libs/lib_ui/scm.md

@@ -0,0 +1,97 @@
+:::{note}
+**AI Translation Notice**
+
+This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+- Source document: kernel/libs/lib_ui/scm.md
+
+- Translation time: 2025-05-19 01:41:31
+
+- Translation model: `Qwen/Qwen3-8B`
+
+Please report issues via [Community Channel](https://github.com/DragonOS-Community/DragonOS/issues)
+
+:::
+
+# Screen Manager (SCM)
+
+:::{note}
+Author: Zhou Hanjie <2625553453@qq.com>
+:::
+&emsp;&emsp;The Screen Manager is used to control all UI frameworks. All frameworks must be registered with the Screen Manager before they can be used. Then, SCM controls which UI framework is currently in use.
+
+## traits
+
+### ScmUiFramework
+&emsp;&emsp;Each UI framework that is to be registered with SCM must implement the methods defined in this trait, as follows:
+```rust
+pub trait ScmUiFramework: Sync + Send + Debug {
+    // 安装ui框架的回调函数
+    fn install(&self) -> Result<i32, SystemError> {
+        return Err(SystemError::ENOSYS);
+    }
+    // 卸载ui框架的回调函数
+    fn uninstall(&self) -> Result<i32, SystemError> {
+        return Err(SystemError::ENOSYS);
+    }
+    // 启用ui框架的回调函数
+    fn enable(&self) -> Result<i32, SystemError> {
+        return Err(SystemError::ENOSYS);
+    }
+    // 禁用ui框架的回调函数
+    fn disable(&self) -> Result<i32, SystemError> {
+        return Err(SystemError::ENOSYS);
+    }
+    // 改变ui框架的帧缓冲区的回调函数
+    fn change(&self, _buf: ScmBufferInfo) -> Result<i32, SystemError> {
+        return Err(SystemError::ENOSYS);
+    }
+    /// @brief 获取ScmUiFramework的元数据
+    /// @return 成功：Ok(ScmUiFramework的元数据)
+    ///         失败：Err(错误码)
+    fn metadata(&self) -> Result<ScmUiFrameworkMetadata, SystemError> {
+        // 若文件系统没有实现此方法，则返回“不支持”
+        return Err(SystemError::ENOSYS);
+    }
+}
+```
+## Main APIs
+### scm_init() - Initialize the screen management module
+#### Prototype
+```rust
+pub extern "C" fn scm_init()
+```
+#### Description
+&emsp;&emsp;scm_init() is mainly used to initialize some global variables used by SCM, such as the flag indicating whether double buffering is used, and some global variables used by textui when it is not initialized.
+
+### scm_reinit() - Reinitialize the screen management module after the memory management unit is initialized
+#### Prototype
+```rust
+pub extern "C" fn scm_reinit() -> i32
+```
+#### Description
+&emsp;&emsp;scm_reinit() is used to reprocess the frame buffer issues after the memory management unit has been initialized.
+
+### scm_enable_double_buffer() - Enable double buffering
+#### Prototype
+```rust
+pub extern "C" fn scm_enable_double_buffer() -> i32
+```
+#### Description
+&emsp;&emsp;scm_enable_double_buffer() is used to enable double buffering for outputting information to the window. After enabling, the information output to the window is temporarily stored in a buffer, and then this buffer's content is output to the window's frame buffer at regular intervals, rendering it to the window.
+
+### scm_framework_enable() - Enable a specific UI framework and render its frame buffer to the screen
+#### Prototype
+```rust
+pub fn scm_framework_enable(framework: Arc<dyn ScmUiFramework>) -> Result<i32, SystemError>
+```
+#### Description
+&emsp;&emsp;scm_framework_enable is used to enable a specific UI framework and render its frame buffer to the screen.
+
+### scm_register() - Register a UI framework with the screen manager
+#### Prototype
+```rust
+pub fn scm_register(framework: Arc<dyn ScmUiFramework>) -> Result<i32, SystemError> 
+```
+#### Description
+&emsp;&emsp;scm_register is used to register a UI framework with SCM. It mainly calls the callback functions of the UI framework to install and activate it.

docs/locales/en/kernel/libs/lib_ui/textui.md

@@ -0,0 +1,44 @@
+:::{note}
+**AI Translation Notice**
+
+This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+- Source document: kernel/libs/lib_ui/textui.md
+
+- Translation time: 2025-05-19 01:41:14
+
+- Translation model: `Qwen/Qwen3-8B`
+
+Please report issues via [Community Channel](https://github.com/DragonOS-Community/DragonOS/issues)
+
+:::
+
+# Text UI Framework (textui)
+
+:::{note}
+Author: Zhou Hanjie <2625553453@qq.com>
+:::
+&emsp;&emsp;The text framework is primarily used for rendering and displaying text windows in DragonOS. It outputs printed text information to the screen window. Displaying text in the window is divided into two scenarios: one is when the Memory Management Unit (MM) has not been initialized, which prevents dynamic memory allocation, imposing many restrictions (for example, not being able to use vec, mpsc, etc.), so it directly outputs the printed information to the window's frame buffer without using complex structures like virtual lines; the other is when the Memory Management Unit (MM) has been initialized, allowing dynamic memory allocation, which enables the use of more complex structures to handle the text information to be printed.
+
+## Main APIs
+### rs_textui_init() - Text UI framework initialization
+#### Prototype
+```rust
+pub extern "C" fn rs_textui_init() -> i32
+```
+#### Description
+&emsp;&emsp;rs_textui_init() is mainly used to initialize some global variable information that the textui framework needs (such as TEXTUIFRAMEWORK, TEXTUI_PRIVATE_INFO, etc.), and to register the textui framework with scm.
+
+### textui_putchar() - Print text information to the currently used window in the textui framework
+#### Prototype
+```rust
+pub extern "C" fn rs_textui_putchar(character: u8, fr_color: u32, bk_color: u32) -> i32
+
+pub fn textui_putchar(
+    character: char,
+    fr_color: FontColor,
+    bk_color: FontColor,
+) -> Result<(), SystemError> 
+```
+#### Description
+&emsp;&emsp;textui_putchar() needs to handle two scenarios: one is when the Memory Management Unit (MM) has not been initialized, which prevents dynamic memory allocation, imposing many restrictions (for example, not being able to use vec, mpsc, etc.), so it directly outputs the printed information to the window's frame buffer without using complex structures like virtual lines; the other is when the Memory Management Unit (MM) has been initialized, allowing dynamic memory allocation, which enables the use of more complex structures to handle the text information to be printed.

docs/locales/en/kernel/libs/unified-init.md

@@ -0,0 +1,64 @@
+:::{note}
+**AI Translation Notice**
+
+This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+- Source document: kernel/libs/unified-init.md
+
+- Translation time: 2025-05-19 01:41:09
+
+- Translation model: `Qwen/Qwen3-8B`
+
+Please report issues via [Community Channel](https://github.com/DragonOS-Community/DragonOS/issues)
+
+:::
+
+# unified-init Unified Initialization Library
+
+:::{note}
+Author: Longjin <longjin@DragonOS.org>
+
+December 25, 2023
+:::
+
+## 1. Introduction
+
+This library is located in `kernel/crates/unified-init`.
+It provides unified initialization macros to register functions into a unified initialization list. It facilitates unified initialization.
+
+It is important to note that the array of initializers is no_mangle, so its naming should follow the rules of `模块_初始化器` to prevent naming conflicts that could lead to unexpected errors.
+
+## 2. Usage
+
+```rust
+use system_error::SystemError;
+use unified_init::define_unified_initializer_slice;
+use unified_init_macros::unified_init;
+
+/// 初始化函数都将会被放到这个列表中
+define_unified_initializer_slice!(INITIALIZER_LIST);
+
+#[unified_init(INITIALIZER_LIST)]
+fn init1() -> Result<(), SystemError> {
+   Ok(())
+}
+
+#[unified_init(INITIALIZER_LIST)]
+fn init2() -> Result<(), SystemError> {
+   Ok(())
+}
+
+fn main() {
+    assert_eq!(INITIALIZER_LIST.len(), 2);
+}
+
+```
+
+## 3. Development
+
+When testing, you can write test code in `main.rs`,
+and then run `cargo expand --bin unified-init-expand` in the current directory to see the code after the proc macro has been expanded.
+
+## 4. Maintainer
+
+Longjin <longjin@DragonOS.org>

docs/locales/en/kernel/locking/index.rst

@@ -0,0 +1,26 @@
+.. note:: AI Translation Notice
+
+   This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+   - Source document: kernel/locking/index.rst
+
+   - Translation time: 2025-05-19 01:41:08
+
+   - Translation model: `Qwen/Qwen3-8B`
+
+
+   Please report issues via `Community Channel <https://github.com/DragonOS-Community/DragonOS/issues>`_
+
+====================================
+Locks
+====================================
+
+   This is the documentation explaining the lock variables in DragonOS.
+
+.. toctree::
+   :maxdepth: 1
+
+   locks
+   spinlock
+   mutex
+   rwlock

docs/locales/en/kernel/locking/locks.md

@@ -0,0 +1,63 @@
+:::{note}
+**AI Translation Notice**
+
+This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+- Source document: kernel/locking/locks.md
+
+- Translation time: 2025-05-19 01:41:26
+
+- Translation model: `Qwen/Qwen3-8B`
+
+Please report issues via [Community Channel](https://github.com/DragonOS-Community/DragonOS/issues)
+
+:::
+
+# Types of Locks and Their Rules
+
+## Introduction
+
+  The DragonOS kernel implements several types of locks, which can be broadly categorized into two types:
+
+- Sleepable locks
+- Spin locks
+
+## Types of Locks
+
+### Sleepable Locks
+
+  Sleepable locks can only be acquired in a context that is preemptible.
+
+  In DragonOS, the following sleepable locks are implemented:
+
+- semaphore
+- mutex_t
+
+### Spin Locks
+
+- spinlock_t
+- {ref}`RawSpinLock <_spinlock_doc_rawspinlock>` (Rust version of spinlock_t, but incompatible with spinlock_t)
+- {ref}`SpinLock <_spinlock_doc_spinlock>` —— Built on top of RawSpinLock, it wraps a guard, binding the lock and the data it protects into a single structure. This allows for compile-time checks to prevent accessing data without holding the lock.
+
+&emsp;&emsp;When a process acquires a spin lock, it changes the lock count in the PCB, thereby implicitly disabling preemption. To provide more flexible operations, spinlock also provides the following methods:
+
+| Suffix                | Description                                             |
+|----------------------|--------------------------------------------------------|
+| _irq()               | Disable interrupts when acquiring the lock, enable them when releasing |
+| _irqsave()/_irqrestore() | Save the interrupt state when acquiring the lock, and restore it when releasing |
+
+## Detailed Introduction
+
+### Detailed Introduction to Spin Locks
+
+&emsp;&emsp;For a detailed introduction to spin locks, please refer to the document: {ref}`自旋锁 <_spinlock_doc>`
+
+### Semaphore
+
+&emsp;&emsp;A semaphore is implemented based on a counter.
+
+&emsp;&emsp;When the available resources are insufficient, a process attempting to perform a down operation on the semaphore will be put to sleep until the resources become available.
+
+### Mutex
+
+&emsp;&emsp;Please refer to {ref}`Mutex文档 <_mutex_doc>`

docs/locales/en/kernel/locking/mutex.md

@@ -0,0 +1,185 @@
+:::{note}
+**AI Translation Notice**
+
+This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+- Source document: kernel/locking/mutex.md
+
+- Translation time: 2025-05-19 01:41:16
+
+- Translation model: `Qwen/Qwen3-8B`
+
+Please report issues via [Community Channel](https://github.com/DragonOS-Community/DragonOS/issues)
+
+:::
+
+(_translated_label___mutex_doc_en)=
+
+:::{note}
+Author: Longjin <longjin@RinGoTek.cn>
+:::
+
+# Mutex (Mutual Exclusion)
+
+&emsp;&emsp;A mutex is a lightweight synchronization primitive, with only two states: locked and idle.
+
+&emsp;&emsp;When a mutex is occupied, any process attempting to lock it will be put to sleep until the resource becomes available.
+
+## 1. Features
+
+- Only one task can hold the mutex at a time.
+- Recursive locking and unlocking are not allowed.
+- Mutex can only be operated through its API.
+- Mutex cannot be used in hard interrupts or soft interrupts.
+
+## 2. Definition
+
+&emsp;&emsp;The mutex is defined in `lib/mutex.rs`, as shown below:
+
+```rust
+/// @brief Mutex互斥量结构体
+/// 请注意！由于Mutex属于休眠锁，因此，如果您的代码可能在中断上下文内执行，请勿采用Mutex！
+#[derive(Debug)]
+pub struct Mutex<T> {
+    /// 该Mutex保护的数据
+    data: UnsafeCell<T>,
+    /// Mutex内部的信息
+    inner: SpinLock<MutexInner>,
+}
+
+#[derive(Debug)]
+struct MutexInner {
+    /// 当前Mutex是否已经被上锁(上锁时，为true)
+    is_locked: bool,
+    /// 等待获得这个锁的进程的链表
+    wait_list: LinkedList<&'static mut process_control_block>,
+}
+
+```
+
+## 3. Usage
+
+&emsp;&emsp;Similar to SpinLock, the Rust version of Mutex has a guard. When using it, you need to transfer the ownership of the data to be protected to the Mutex. Moreover, the guard can only be generated after a successful lock, so at any moment, each Mutex can have at most one guard.
+
+&emsp;&emsp;When you need to read or modify the data protected by the Mutex, you should first use the `lock()` method of the Mutex. This method returns a `MutexGuard`. You can use the member functions of the protected data to perform some operations, or directly read or write the protected data. (This is equivalent to obtaining a mutable reference to the protected data.)
+
+&emsp;&emsp;A complete example is shown in the code below:
+
+```rust
+let x :Mutex<Vec<i32>>= Mutex::new(Vec::new());
+    {
+        let mut g :MutexGuard<Vec<i32>>= x.lock();
+        g.push(1);
+        g.push(2);
+        g.push(2);
+        assert!(g.as_slice() == [1, 2, 2] || g.as_slice() == [2, 2, 1]);
+        // 在此处，Mutex是加锁的状态
+        debug!("x={:?}", x);
+    }
+    // 由于上方的变量`g`，也就是Mutex守卫的生命周期结束，自动释放了Mutex。因此，在此处，Mutex是放锁的状态
+    debug!("x={:?}", x);
+```
+
+&emsp;&emsp;For variables inside a structure, we can use Mutex to perform fine-grained locking, that is, wrap the member variables that need to be locked in detail with Mutex, for example:
+
+```rust
+pub struct a {
+  pub data: Mutex<data_struct>,
+}
+```
+
+&emsp;&emsp;Of course, we can also lock the entire structure:
+
+```rust
+struct MyStruct {
+  pub data: data_struct,
+}
+/// 被全局加锁的结构体
+pub struct LockedMyStruct(Mutex<MyStruct>);
+```
+
+## 4. API
+
+### 4.1. new - Initialize Mutex
+
+#### Prototype
+
+```rust
+pub const fn new(value: T) -> Self
+```
+
+#### Description
+
+&emsp;&emsp;The `new()` method is used to initialize a Mutex. This method requires a protected data as a parameter. It returns a Mutex.
+
+### 4.2. lock - Lock
+
+#### Prototype
+
+```rust
+pub fn lock(&self) -> MutexGuard<T>
+```
+
+#### Description
+
+&emsp;&emsp;Lock the Mutex, returns the guard of the Mutex. You can use this guard to operate the protected data.
+
+&emsp;&emsp;If the Mutex is already locked, this method will block the current process until the Mutex is released.
+
+### 4.3. try_lock - Try to Lock
+
+#### Prototype
+
+```rust
+pub fn try_lock(&self) -> Result<MutexGuard<T>, i32>
+```
+
+#### Description
+
+&emsp;&emsp;Try to lock the Mutex. If the lock fails, the current process will not be added to the waiting queue. If the lock is successful, it returns the guard of the Mutex; if the Mutex is already locked, it returns `Err(错误码)`.
+
+## 5. C Version of Mutex (Will be deprecated in the future)
+
+&emsp;&emsp;The mutex is defined in `common/mutex.h`. Its data type is as follows:
+
+```c
+typedef struct
+{
+
+    atomic_t count; // 锁计数。1->已解锁。 0->已上锁,且有可能存在等待者
+    spinlock_t wait_lock;   // mutex操作锁，用于对mutex的list的操作进行加锁
+    struct List wait_list;  // Mutex的等待队列
+} mutex_t;
+```
+
+### 5.1. API
+
+#### mutex_init
+
+**`void mutex_init(mutex_t *lock)`**
+
+&emsp;&emsp;Initialize a mutex object.
+
+#### mutex_lock
+
+**`void mutex_lock(mutex_t *lock)`**
+
+&emsp;&emsp;Lock a mutex object. If the mutex is currently held by another process, the current process will enter a sleep state.
+
+#### mutex_unlock
+
+**`void mutex_unlock(mutex_t *lock)`**
+
+&emsp;&emsp;Unlock a mutex object. If there are other processes in the mutex's waiting queue, the next process will be awakened.
+
+#### mutex_trylock
+
+**`void mutex_trylock(mutex_t *lock)`**
+
+&emsp;&emsp;Try to lock a mutex object. If the mutex is currently held by another process, it returns 0. Otherwise, the lock is successful and returns 1.
+
+#### mutex_is_locked
+
+**`void mutex_is_locked(mutex_t *lock)`**
+
+&emsp;&emsp;Determine if the mutex is already locked. If the given mutex is in a locked state, it returns 1; otherwise, it returns 0.

docs/locales/en/kernel/locking/rwlock.md

@@ -0,0 +1,216 @@
+:::{note}
+**AI Translation Notice**
+
+This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+- Source document: kernel/locking/rwlock.md
+
+- Translation time: 2025-05-19 01:41:57
+
+- Translation model: `Qwen/Qwen3-8B`
+
+Please report issues via [Community Channel](https://github.com/DragonOS-Community/DragonOS/issues)
+
+:::
+
+# RwLock Read-Write Lock
+:::{note}
+Author: sujintao
+
+Email: <sujintao@dragonos.org>
+:::
+
+## 1. Introduction
+&emsp;&emsp;A read-write lock is a mechanism used in a concurrent environment to protect shared data among multiple processes. Compared to a regular spinlock, a read-write lock divides access to shared data into two types: read access and write access. Read access to shared data is controlled by a read lock, while write access to shared data is controlled by a write lock. The design of a read-write lock allows for multiple "readers" (read-only access) and a single "writer" (write access) to coexist simultaneously. For shared data that is mostly read-only, using a read-write lock to control access can improve performance to some extent.
+
+## 2. Implementation of Read-Write Lock in DragonOS
+### 2.1 Mechanism of Read-Write Lock
+&emsp;&emsp;The purpose of a read-write lock is to maintain the consistency of shared variables in a multi-threaded system. Data is wrapped in an RwLock data structure, and all access and modification must be done through this structure. Each process that accesses shared data will obtain a guard. A read-only process obtains a READER (reader guard), while a process that needs to modify a shared variable obtains a WRITER (writer guard). As a "shadow" of the RwLock, threads perform access and modification operations based on the guard.
+
+&emsp;&emsp;In practice, in addition to READER and WRITER, a read-write lock also introduces an UPGRADER. This is a guard that lies between READER and WRITER. The role of the UPGRADER is to prevent WRITER starvation. When a process obtains an UPGRADER, it treats it as a READER. However, the UPGRADER can be upgraded, and after upgrading, it becomes a WRITER guard, allowing write operations on shared data.
+
+&emsp;&emsp;All guards satisfy the RAII mechanism native to Rust. When the scope of a guard ends, the guard will automatically release.
+
+### 2.2 Relationship Between Read-Write Lock Guards
+&emsp;&emsp;At any given time, multiple READERS can exist, meaning that multiple processes can access shared data simultaneously. However, only one WRITER can exist at a time, and when a process obtains a WRITER, no READERS or UPGRADERS can exist. A process can obtain an UPGRADER only if there are no existing UPGRADERS or WRITERS. However, once a process obtains an UPGRADER, it cannot successfully apply for a READER.
+
+### 2.3 Design Details
+
+#### 2.3.1 RwLock Data Structure
+```rust
+pub struct RwLock<T> {
+    lock: AtomicU32,//原子变量
+    data: UnsafeCell<T>,
+}
+```
+
+#### 2.3.2 READER Guard Data Structure
+```rust
+pub struct RwLockReadGuard<'a, T: 'a> {
+    data: *const T,
+    lock: &'a AtomicU32,
+}
+```
+
+#### 2.3.3 UPGRADER Guard Data Structure
+```rust
+pub struct RwLockUpgradableGuard<'a, T: 'a> {
+    data: *const T,
+    inner: &'a RwLock<T>,
+}
+```
+
+#### 2.3.4 WRITER Guard Data Structure
+```rust
+pub struct RwLockWriteGuard<'a, T: 'a> {
+    data: *mut T,
+    inner: &'a RwLock<T>,
+}
+```
+
+#### 2.3.5 Introduction to the lock Structure in RwLock
+The lock is a 32-bit atomic variable AtomicU32, and its bit allocation is as follows:
+```
+                                                       UPGRADER_BIT     WRITER_BIT
+                                                         ^                   ^
+OVERFLOW_BIT                                             +------+    +-------+
+  ^                                                             |    |
+  |                                                             |    |
++-+--+--------------------------------------------------------+-+--+-+--+
+|    |                                                        |    |    |
+|    |                                                        |    |    |
+|    |             The number of the readers                  |    |    |
+|    |                                                        |    |    |
++----+--------------------------------------------------------+----+----+
+  31  30                                                    2   1    0
+```
+
+&emsp;&emsp;(From right to left) The 0th bit represents whether WRITER is valid. If WRITER_BIT = 1, it indicates that a process has obtained a WRITER guard. If UPGRADER_BIT = 1, it indicates that a process has obtained an UPGRADER guard. Bits 2 to 30 are used to represent the number of processes that have obtained READER guards in binary form. The 31st bit is an overflow detection bit. If OVERFLOW_BIT = 1, new requests for obtaining READER guards will be rejected.
+
+## 3. Main APIs of Read-Write Lock
+### 3.1 Main APIs of RwLock
+```rust
+///功能:  输入需要保护的数据类型data,返回一个新的RwLock类型.
+pub const fn new(data: T) -> Self
+```
+```rust
+///功能: 获得READER守卫
+pub fn read(&self) -> RwLockReadGuard<T>
+```
+```rust
+///功能: 尝试获得READER守卫
+pub fn try_read(&self) -> Option<RwLockReadGuard<T>>
+```
+```rust
+///功能: 获得WRITER守卫
+pub fn write(&self) -> RwLockWriteGuard<T>
+```
+```rust
+///功能: 尝试获得WRITER守卫
+pub fn try_write(&self) -> Option<RwLockWriteGuard<T>>
+```
+```rust
+///功能: 获得UPGRADER守卫
+pub fn upgradeable_read(&self) -> RwLockUpgradableGuard<T>
+```
+```rust
+///功能: 尝试获得UPGRADER守卫
+pub fn try_upgradeable_read(&self) -> Option<RwLockUpgradableGuard<T>>
+```
+### 3.2 Main APIs of the WRITER Guard RwLockWriteGuard
+```rust
+///功能: 将WRITER降级为READER
+pub fn downgrade(self) -> RwLockReadGuard<'rwlock, T>
+```
+```rust
+///功能: 将WRITER降级为UPGRADER
+pub fn downgrade_to_upgradeable(self) -> RwLockUpgradableGuard<'rwlock, T>
+```
+### 3.3 Main APIs of the UPGRADER Guard RwLockUpgradableGuard
+```rust
+///功能: 将UPGRADER升级为WRITER
+pub fn upgrade(mut self) -> RwLockWriteGuard<'rwlock, T> 
+```
+```rust
+///功能: 将UPGRADER降级为READER
+pub fn downgrade(self) -> RwLockReadGuard<'rwlock, T>
+```
+
+## 4. Usage Examples
+```rust
+static LOCK: RwLock<u32> = RwLock::new(100 as u32);
+
+fn t_read1() {
+    let guard = LOCK.read();
+    let value = *guard;
+    let readers_current = LOCK.reader_count();
+    let writers_current = LOCK.writer_count();
+    println!(
+        "Reader1: the value is {value}
+    There are totally {writers_current} writers, {readers_current} readers"
+    );
+}
+
+fn t_read2() {
+    let guard = LOCK.read();
+    let value = *guard;
+    let readers_current = LOCK.reader_count();
+    let writers_current = LOCK.writer_count();
+    println!(
+        "Reader2: the value is {value}
+    There are totally {writers_current} writers, {readers_current} readers"
+    );
+}
+
+fn t_write() {
+    let mut guard = LOCK.write();
+    *guard += 100;
+    let writers_current = LOCK.writer_count();
+    let readers_current = LOCK.reader_count();
+    println!(
+        "Writers: the value is {guard}
+    There are totally {writers_current} writers, {readers_current} readers",
+        guard = *guard
+    );
+    let read_guard=guard.downgrade();
+    let value=*read_guard;
+    println!("After downgraded to read_guard: {value}");
+}
+
+fn t_upgrade() {
+    let guard = LOCK.upgradeable_read();
+    let value = *guard;
+    let readers_current = LOCK.reader_count();
+    let writers_current = LOCK.writer_count();
+    println!(
+        "Upgrader1 before upgrade: the value is {value}
+    There are totally {writers_current} writers, {readers_current} readers"
+    );
+    let mut upgraded_guard = guard.upgrade();
+    *upgraded_guard += 100;
+    let writers_current = LOCK.writer_count();
+    let readers_current = LOCK.reader_count();
+    println!(
+        "Upgrader1 after upgrade: the value is {temp}
+    There are totally {writers_current} writers, {readers_current} readers",
+        temp = *upgraded_guard
+    );
+    let downgraded_guard=upgraded_guard.downgrade_to_upgradeable();
+    let value=*downgraded_guard;
+    println!("value after downgraded: {value}");
+    let read_guard=downgraded_guard.downgrade();
+    let value_=*read_guard;
+    println!("value after downgraded to read_guard: {value_}");
+}
+
+fn main() {
+    let r2=thread::spawn(t_read2);
+    let r1 = thread::spawn(t_read1);
+    let t1 = thread::spawn(t_write);
+    let g1 = thread::spawn(t_upgrade);
+    r1.join().expect("r1");
+    t1.join().expect("t1");
+    g1.join().expect("g1");
+    r2.join().expect("r2");
+}
+```

docs/locales/en/kernel/locking/spinlock.md

@@ -0,0 +1,118 @@
+:::{note}
+**AI Translation Notice**
+
+This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+- Source document: kernel/locking/spinlock.md
+
+- Translation time: 2025-05-19 01:43:03
+
+- Translation model: `Qwen/Qwen3-8B`
+
+Please report issues via [Community Channel](https://github.com/DragonOS-Community/DragonOS/issues)
+
+:::
+
+(_translated_label___spinlock_doc_en)=
+
+:::{note}
+Author: Longjin <longjin@RinGoTek.cn>
+:::
+
+# Spinlock
+
+## 1. Introduction
+
+&emsp;&emsp;A spinlock is a type of lock used for synchronization in multi-threaded environments. Threads repeatedly check if the lock variable is available. Since the thread remains in a running state during this process, it is a form of busy waiting. Once a spinlock is acquired, the thread will hold onto it until it is explicitly released.
+
+&emsp;&emsp;DragonOS implements spinlocks in the `kernel/src/lib/spinlock.rs` file. Based on slight differences in functional characteristics, two types of spinlocks, `RawSpinLock` and `SpinLock`, are provided.
+
+(_translated_label___spinlock_doc_rawspinlock_en)=
+## 2. RawSpinLock - Raw Spinlock
+
+&emsp;&emsp;`RawSpinLock` is a raw spinlock, whose data part contains an AtomicBool, implementing the basic functionality of a spinlock. Its locking and unlocking require manual determination of the corresponding timing, meaning that, like spinlocks used in other languages, you need to first call the `lock()` method, and then manually call the `unlock()` method when leaving the critical section. We do not explicitly inform the compiler of which data the spinlock is protecting.
+
+&emsp;&emsp;RawSpinLock provides programmers with very flexible control over locking and unlocking. However, due to its excessive flexibility, it is easy to make mistakes when using it. Common issues include "accessing critical section data without locking", "forgetting to unlock", and "double unlocking". The compiler cannot check for these issues, and they can only be discovered at runtime.
+
+:::{warning}
+`RawSpinLock` is not binary compatible with the C version of `spinlock_t`. If you need to operate on the C version of `spinlock_t` for temporary compatibility reasons, please use the operation functions for the C version of spinlock_t provided in `spinlock.rs`.
+
+However, for newly developed features, please do not use the C version of `spinlock_t`, as it will be removed as code refactoring progresses.
+:::
+
+(_translated_label___spinlock_doc_spinlock_en)=
+## 3. SpinLock - Spinlock with Guard
+
+&emsp;&emsp;`SpinLock` is an encapsulation of `RawSpinLock`, enabling compile-time checks for issues such as "accessing critical section data without locking", "forgetting to unlock", and "double unlocking"; it also supports internal mutability of data.
+
+&emsp;&emsp;Its struct prototype is as follows:
+
+```rust
+#[derive(Debug)]
+pub struct SpinLock<T> {
+    lock: RawSpinlock,
+    /// 自旋锁保护的数据
+    data: UnsafeCell<T>,
+}
+```
+
+### 3.1. Usage
+
+&emsp;&emsp;You can initialize a SpinLock like this:
+
+```rust
+let x = SpinLock::new(Vec::new());
+```
+
+&emsp;&emsp;When initializing this SpinLock, you must pass the data you want to protect into the SpinLock, which will then manage it.
+
+&emsp;&emsp;When you need to read or modify data protected by SpinLock, please first use the `lock()` method of SpinLock. This method will return a `SpinLockGuard`. You can use the member functions of the protected data to perform some operations, or directly read and write the protected data. (This is equivalent to obtaining a mutable reference to the protected data.)
+
+&emsp;&emsp;The complete example is shown in the code below:
+
+```rust
+let x :SpinLock<Vec<i32>>= SpinLock::new(Vec::new());
+    {
+        let mut g :SpinLockGuard<Vec<i32>>= x.lock();
+        g.push(1);
+        g.push(2);
+        g.push(2);
+        assert!(g.as_slice() == [1, 2, 2] || g.as_slice() == [2, 2, 1]);
+        // 在此处，SpinLock是加锁的状态
+        debug!("x={:?}", x);
+    }
+    // 由于上方的变量`g`，也就是SpinLock守卫的生命周期结束，自动释放了SpinLock。因此，在此处，SpinLock是放锁的状态
+    debug!("x={:?}", x);
+```
+
+&emsp;&emsp;For variables inside a struct, we can use SpinLock to perform fine-grained locking, that is, wrap the member variables that need to be locked in SpinLock, for example:
+
+```rust
+pub struct a {
+  pub data: SpinLock<data_struct>,
+}
+```
+
+&emsp;&emsp;Of course, we can also lock the entire struct:
+
+```rust
+struct MyStruct {
+  pub data: data_struct,
+}
+/// 被全局加锁的结构体
+pub struct LockedMyStruct(SpinLock<MyStruct>);
+```
+
+### 3.2. Principle
+
+&emsp;&emsp;`SpinLock` can achieve compile-time checking because it introduces a `SpinLockGuard` as a guard. When writing code, we ensure that only after calling the `lock()` method of `SpinLock` to acquire the lock can a `SpinLockGuard` be generated. Moreover, whenever we want to access protected data, we must obtain a guard. We also implement the `Drop` trait for `SpinLockGuard`; when the guard's lifetime ends, the lock will be automatically released. There is no other way to release the lock. Therefore, we can know that, in a context, as long as the `SpinLockGuard`'s lifetime has not ended, it has the right to access the critical section data, and the data access is safe.
+
+### 3.3. Existing Issues
+
+#### 3.3.1. Double Locking
+
+&emsp;&emsp;Please note that the compile-time checks supported by `SpinLock` are not omnipotent. It currently cannot detect the issue of "double locking" at compile time. Consider this scenario: function A acquires the lock, and then function B attempts to lock again, which results in a "double locking" issue. This kind of problem cannot be detected at compile time.
+
+&emsp;&emsp;To address this issue, we recommend the following programming approach:
+
+- If function B needs to access data within the critical section, function B should receive a parameter of type `&SpinLockGuard`, which is obtained by function A. In this way, function B can access the data within the critical section.

docs/locales/en/kernel/memory_management/allocate-memory.md

@@ -0,0 +1,42 @@
+:::{note}
+**AI Translation Notice**
+
+This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+- Source document: kernel/memory_management/allocate-memory.md
+
+- Translation time: 2025-05-19 01:41:13
+
+- Translation model: `Qwen/Qwen3-8B`
+
+Please report issues via [Community Channel](https://github.com/DragonOS-Community/DragonOS/issues)
+
+:::
+
+# Memory Allocation Guide
+
+  This document will explain how to perform memory allocation within the kernel. Before starting, please understand a basic point: DragonOS's kernel manages memory using 4KB pages and has a buddy allocator and a slab allocator. It also has specific management mechanisms for both user space and kernel space.
+
+## 1. Safe Memory Allocation
+
+  By default, KernelAllocator is bound as the global memory allocator. It automatically selects between using the slab allocator or the buddy allocator based on the size of the memory requested. Therefore, in the kernel, using Rust's native memory allocation functions or creating an `Box` object, etc., is safe.
+
+## 2. Manual Management of Page Frames
+
+:::{warning}
+**Please be extremely cautious!** Manually managing page frames bypasses Rust's memory safety mechanisms, which may lead to memory leaks or memory errors.
+:::
+
+  In some cases, we need to manually allocate page frames. For example, when we need to create a new page table or a new address space within the kernel. In such situations, we need to manually allocate page frames. Using the `LockedFrameAllocator`'s `allocate()` function can allocate contiguous page frames in physical address space. Please note that since the underlying implementation uses the buddy allocator, the number of page frames must be a power of two, and the maximum size should not exceed 1GB.
+
+  When you need to release page frames, you can use the `LockedFrameAllocator`'s `deallocate()` function or the `deallocate_page_frames()` function to release contiguous page frames in physical address space.
+
+  When you need to map page frames, you can use the `KernelMapper::lock()` function to obtain a kernel mapper object and then perform the mapping. Since KernelMapper is an encapsulation of PageMapper, once you obtain a KernelMapper, you can use the PageMapper-related interfaces to manage the mapping in the kernel space.
+
+:::{warning}
+**Never** use KernelMapper to map memory in user address space. This would cause that part of memory to be detached from the user address space management, leading to memory errors.
+:::
+
+## 3. Allocating Memory for User Programs
+
+  In the kernel, you can use the user address space structure (`AddressSpace`) and its functions such as `mmap()`, `map_anonymous()`, etc., to allocate memory for user programs. These functions will automatically map the user program's memory into the user address space and automatically create VMA structures. You can use the `AddressSpace`'s `munmap()` function to unmap the user program's memory from the user address space and destroy the VMA structure. Functions such as `mprotect()` can be used for adjusting permissions.

docs/locales/en/kernel/memory_management/index.rst

@@ -0,0 +1,27 @@
+.. note:: AI Translation Notice
+
+   This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+   - Source document: kernel/memory_management/index.rst
+
+   - Translation time: 2025-05-19 01:41:10
+
+   - Translation model: `Qwen/Qwen3-8B`
+
+
+   Please report issues via `Community Channel <https://github.com/DragonOS-Community/DragonOS/issues>`_
+
+.. _translated_label__memory_management_module_en:
+
+====================================
+Memory Management
+====================================
+
+   This section explains the design and implementation principles of the memory management module, along with the corresponding interfaces.
+
+.. toctree::
+   :maxdepth: 1
+
+   intro
+   allocate-memory
+   mmio

docs/locales/en/kernel/memory_management/intro.md

@@ -0,0 +1,34 @@
+:::{note}
+**AI Translation Notice**
+
+This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+- Source document: kernel/memory_management/intro.md
+
+- Translation time: 2025-05-19 01:41:11
+
+- Translation model: `Qwen/Qwen3-8B`
+
+Please report issues via [Community Channel](https://github.com/DragonOS-Community/DragonOS/issues)
+
+:::
+
+# Introduction to the Memory Management Module
+
+## 1. Overview
+
+  DragonOS implements a memory management module with excellent architectural design, encapsulating operations such as memory mapping, allocation, release, and management for both kernel space and user space. This allows kernel developers to more conveniently perform memory management tasks.
+
+  The memory management module of DragonOS is mainly composed of the following types of components:
+
+- **Hardware Abstraction Layer (MemoryManagementArch)** - Provides abstraction for specific processor architectures, enabling the memory management module to run on different processor architectures.
+- **Page Mapper (PageMapper)** - Provides mapping between virtual addresses and physical addresses, as well as operations for creating, filling, destroying, and managing page tables. It is divided into two types: Kernel Page Table Mapper (KernelMapper) and User Page Table Mapper (located within the specific user address space structure).
+- **Page Flusher (PageFlusher)** - Provides operations for flushing page tables (full table flush, single page flush, cross-core flush).
+- **Frame Allocator (FrameAllocator)** - Provides operations for allocating, releasing, and managing page frames. Specifically, it includes BumpAllocator and BuddyAllocator.
+- **Small Object Allocator** - Provides operations for allocating, releasing, and managing small memory objects. This refers to the SlabAllocator within the kernel (the implementation of SlabAllocator is currently not completed).
+- **MMIO Space Manager** - Provides operations for allocating and managing MMIO address spaces. (This module is pending further refactoring.)
+- **User Address Space Management Mechanism** - Provides management of user address spaces.
+    - **VMA Mechanism** - Provides management of user address spaces, including creation, destruction, and permission management of VMA.
+    - **User Mapping Management** - Works together with the VMA mechanism to manage mappings in user address spaces.
+- **System Call Layer** - Provides system calls for the user-space memory management system, including mmap, munmap, mprotect, mremap, etc.
+- **C Interface Compatibility Layer** - Provides interfaces for existing C code, enabling C code to run normally.

docs/locales/en/kernel/memory_management/mmio.md

@@ -0,0 +1,204 @@
+:::{note}
+**AI Translation Notice**
+
+This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+- Source document: kernel/memory_management/mmio.md
+
+- Translation time: 2025-05-19 01:41:34
+
+- Translation model: `Qwen/Qwen3-8B`
+
+Please report issues via [Community Channel](https://github.com/DragonOS-Community/DragonOS/issues)
+
+:::
+
+# MMIO
+
+MMIO stands for "Memory-Mapped I/O," and it is widely used for interaction with hardware devices.
+
+## Address Space Management
+
+DragonOS implements a mechanism for managing MMIO address spaces. This section will introduce them.
+
+### Why is Automatic Allocation of MMIO Address Space Needed?
+
+  Since many devices on a computer require MMIO address space, and the demand for MMIO address space varies among different devices connected to each computer, manually specifying an MMIO address for each device type would lead to significant waste of virtual address space and increase system complexity. Moreover, we will need to handle exception handling functions for different virtual memory regions in the future. Therefore, we need a mechanism that can automatically allocate MMIO address space.
+
+### What Features Does This Mechanism Provide?
+
+- Allocates MMIO virtual address space ranging from 4K to 1GB for drivers
+- Adds these virtual address spaces to VMA for unified management
+- Allows batch release of these address spaces
+
+### How Is This Mechanism Implemented?
+
+  This mechanism essentially uses the buddy system to maintain MMIO virtual address space. In `mm/mm.h`, the MMIO virtual address space range is specified, which starts at `0xffffa10000000000` and covers a 1TB space. In other words, the buddy system maintains this 1TB virtual address space for MMIO.
+
+### Address Space Allocation Process
+
+1. Initialize the MMIO-mapping module, creating 512 1GB `__mmio_buddy_addr_region` blocks in the MMIO buddy system.
+2. The driver uses `mmio_create` to request address space allocation.
+3. `mmio_create` aligns the requested address space size to the nearest power of 2 and allocates memory address space from the buddy.
+4. Create a VMA and mark it as `VM_IO|VM_DONTCOPY`. MMIO VMA is only bound under `initial_mm` and will not be copied.
+5. Allocation is complete.
+
+Once the MMIO address space is allocated, it behaves like a regular VMA and can be operated using mmap series functions.
+
+### MMIO Mapping Process
+
+  After obtaining the virtual address space, when we attempt to map memory into this address space, we can call the `mm_map` function to map this region.
+
+  This function performs special handling for MMIO VMA mapping. That is: it creates a `Page` structure and the corresponding `anon_vma`. Then, it fills the corresponding physical address into the page table.
+
+### Releasing MMIO Virtual Address Space
+
+  When a device is unmounted, the driver can call the `mmio_release` function to release the specified MMIO address space.
+
+  During the release process, `mmio_release` performs the following steps:
+
+1. Remove the MMIO region's mapping from the page table.
+2. Release the MMIO region's VMA.
+3. Return the address space back to the MMIO buddy system.
+
+## Buddy Algorithm for MMIO
+
+### Definition of Buddy
+
+  Two memory blocks are considered buddy memory blocks if they satisfy the following three conditions:
+
+1. The sizes of the two memory blocks are the same.
+2. The memory addresses of the two memory blocks are contiguous.
+3. The two memory blocks are derived from the same larger block of memory.
+
+### Buddy Algorithm
+
+  The buddy algorithm is used to manage and organize the allocation and recycling of large contiguous memory blocks to reduce external fragmentation during system runtime. In the buddy system, each memory block size is $2^n$ bytes. In DragonOS, the buddy system memory pool maintains a total of 1TB of contiguous storage space, with the largest memory block size being $1G$ (i.e., $2^{30}B$) and the smallest memory block size being $4K$ (i.e., $2^{12}B$).
+
+  The core idea of the buddy algorithm is that when an application requests memory, it always allocates the smallest memory block larger than the requested size, and the allocated memory block size is $2^nB$. (e.g., if an application requests $3B$ of memory, there is no integer $n$ such that $2^n = 3$, and $3 \in [2^1, 2^2]$, so the system will allocate a $2^2B$ memory block to the application, and the memory request is successfully completed.)
+
+  What if there is no such "suitable" memory block in the buddy system? The system will first look for a larger memory block. If found, it will split the larger memory block into suitable memory blocks to allocate to the application. (e.g., if an application requests $3B$ of memory, and the system's smallest memory block larger than $3B$ is $16B$, then the $16B$ block will be split into two $8B$ blocks. One is placed back into the memory pool, and the other is further split into two $4B$ blocks. One of the $4B$ blocks is placed back into the memory pool, and the other is allocated to the application. Thus, the memory request is successfully completed.)
+
+  If the system cannot find a larger memory block, it will attempt to merge smaller memory blocks until the required size is met. (e.g., if an application requests $3B$ of memory, and the system checks the memory pool and finds only two $2B$ memory blocks, the system will merge these two $2B$ blocks into a $4B$ block and allocate it to the application. Thus, the memory request is successfully completed.)
+
+  Finally, if the system cannot find a large enough memory block and is unable to successfully merge smaller blocks, it will notify the application that there is not enough memory to allocate.
+
+### Data Structures of the Buddy Algorithm
+
+```
+
+                                  MmioBuddyMemPool
+
+┌─────────────────────────────────────────────────────────────────────────────────────┐
+│                                                                                     │
+│                                 pool_start_addr                                     │
+│                                                                                     │
+├─────────────────────────────────────────────────────────────────────────────────────┤
+│                                                                                     │
+│                                    pool_size                                        │
+│                                                                                     │
+├─────────────────────────────────────────────────────────────────────────────────────┤
+│                                                                                     │
+│                                                                                     │
+│                                   free_regions                                      │
+│                                                                                     │
+│                                  ┌────────────┐                                     │
+│                                  │            │     ┌───────┐     ┌────────┐        │
+│                                  │ ┌────────┬─┼────►│       ├────►│        │        │
+│                                  │ │  list  │ │     │ vaddr │     │ vaddr  │        │
+│                                  │ │        │◄├─────┤       │◄────┤        │        │
+│                  MmioFreeRegionList├────────┤ │     └───────┘     └────────┘        │
+│                                  │ │num_free│ │                                     │
+│                                  │ └────────┘ │  MmioBuddyAddrRegion                │
+│          MMIO_BUDDY_MIN_EXP - 12 │      0     │                                     │
+│                                  ├────────────┤                                     │
+│                                  │      1     │                                     │
+│                                  ├────────────┤                                     │
+│                                  │      2     │                                     │
+│                                  ├────────────┤                                     │
+│                                  │      3     │                                     │
+│                                  ├────────────┤                                     │
+│                                  │     ...    │                                     │
+│                                  ├────────────┤                                     │
+│                                  │     ...    │                                     │
+│                                  ├────────────┤                                     │
+│          MMIO_BUDDY_MAX_EXP - 12 │     18     │                                     │
+│                                  └────────────┘                                     │
+│                                                                                     │
+│                                                                                     │
+│                                                                                     │
+└─────────────────────────────────────────────────────────────────────────────────────┘
+```
+
+```rust
+
+/// 最大的内存块为1G，其幂为30
+const MMIO_BUDDY_MAX_EXP: u32 = PAGE_1G_SHIFT;
+/// 最小的内存块为4K，其幂为12                                  
+const MMIO_BUDDY_MIN_EXP: u32 = PAGE_4K_SHIFT;
+/// 内存池数组的大小为18
+const MMIO_BUDDY_REGION_COUNT: u32 = MMIO_BUDDY_MAX_EXP - MMIO_BUDDY_MIN_EXP + 1;
+
+/// buddy内存池
+pub struct MmioBuddyMemPool {
+    /// 内存池的起始地址
+    pool_start_addr: u64, 
+    /// 内存池大小：初始化为1TB
+    pool_size: u64,
+    /// 空闲内存块链表数组
+    /// MMIO_BUDDY_REGION_COUNT = MMIO_BUDDY_MAX_EXP - MMIO_BUDDY_MIN_EXP + 1
+    free_regions: [SpinLock<MmioFreeRegionList>; MMIO_BUDDY_REGION_COUNT as usize],
+}
+
+/// 空闲内存块链表结构体
+pub struct MmioFreeRegionList {
+    /// 存储了空闲内存块信息的结构体的链表
+    list: LinkedList<Box<MmioBuddyAddrRegion>>,
+    /// 当前链表空闲块的数量
+    num_free: i64,
+}
+
+/// mmio伙伴系统内部的地址区域结构体
+pub struct MmioBuddyAddrRegion {
+    /// 内存块的起始地址
+    vaddr: u64,
+}                                  
+                  
+```
+
+### Design Philosophy
+
+&emsp;&emsp;In DragonOS, the `MmioBuddyMemPool` structure is used as the data structure for the buddy (for convenience of expression, the buddy algorithm is referred to as buddy) memory pool. It records the starting address (pool_start_addr) of the memory pool and the total size of memory blocks in the memory pool (pool_size). It also maintains a bidirectional linked list array (free_regions) of size `MMIO_BUDDY_REGION_COUNT`. Each linked list in `free_regions` maintains several free memory blocks (MmioBuddyAddrRegion).
+
+&emsp;&emsp;The index of `free_regions` is related to the size of the memory block. Since each memory block size is $2^{n}$ bytes, we can let $exp = n$. The conversion formula between index and exp is as follows: $index = exp - 12$. For example, a memory block of size $2^{12}$ bytes has $exp = 12$, and using the above formula, we get $index = 12 - 12 = 0$, so this memory block is stored in `free_regions[0].list`. Through this conversion formula, each time we take or release a memory block of size $2^n$, we only need to operate on `free_regions[n -12]`. In DragonOS, the largest memory block size in the buddy memory pool is $1G = 2^{30} bytes$, and the smallest is $4K = 2^{12} bytes$, so $index \in [0, 18]$.
+
+&emsp;&emsp;As a memory allocation mechanism, the buddy serves all processes. To solve the problem of synchronizing the linked list data in free_regions among different processes, the linked list type in `free_regions` uses a SpinLock (denoted as {ref}`自旋锁 <_spinlock_doc_spinlock>`) to protect the free memory block linked list (MmioFreeRegionList). `MmioFreeRegionList` encapsulates a linked list (list) that actually stores information about free memory blocks and the corresponding list length (num_free). With the use of a spinlock, only one process can modify a particular linked list at the same time, such as taking elements from the list (memory allocation) or inserting elements into the list (memory release).
+
+&emsp;&emsp;The element type in `MmioFreeRegionList` is the `MmioBuddyAddrRegion` structure, which records the starting address (vaddr) of the memory block.
+
+### Internal APIs of the Buddy Algorithm
+
+**P.S. The following functions are all members of the MmioBuddyMemPool structure. A global reference of type MmioBuddyMemPool has already been created in the system, denoted as `MMIO_POOL`. To use the following functions, please use them in the form of `MMIO_POOL.xxx()`, which does not require passing self.**
+
+| **Function Name**                                                           | **Description**                                                    |
+|:----------------------------------------------------------------- |:--------------------------------------------------------- |
+| __create_region(&self, vaddr)                                     | Pass the virtual address to create a new memory block address structure                                      |
+| __give_back_block(&self, vaddr, exp)                              | Return the memory block at address vaddr with exponent exp back to the buddy                               |
+| __buddy_split(&self, region, exp, list_guard)                        | Split the given memory block of size $2^{exp}$ into two and insert the memory blocks of size $2^{exp-1}$ into the list |
+| __query_addr_region(&self, exp, list_guard)                         | Request a memory block of size $2^{exp}$ from the buddy                               |
+| mmio_buddy_query_addr_region(&self, exp)                           | A wrapper for query_addr_region, **please use this function instead of __query_addr_region** |
+| __buddy_add_region_obj(&self, region, list_guard)                   | Add a memory block to the specified address space list                                        |
+| __buddy_block_vaddr(&self, vaddr, exp)                            | Calculate the virtual memory address of the buddy block based on the address and memory block size                                   |
+| __pop_buddy_block( &self, vaddr, exp, list_guard)                   | Find and pop the buddy block of the specified memory block                                            |
+| __buddy_pop_region( &self, list_guard)                     | Retrieve a memory region from the specified free list                                            |
+| __buddy_merge(&self, exp, list_guard, high_list_guard)               | Merge all memory blocks of size $2^{exp}$                                       |
+| __buddy_merge_blocks(&self, region_1, region_2, exp, high_list_guard) | Merge two **already removed from the list** memory blocks                                      |
+
+### External APIs of the Buddy Algorithm
+
+| **Function Name**                                         | **Description**                                      |
+| ----------------------------------------------- | ------------------------------------------- |
+| __mmio_buddy_init()                             | Initialize the buddy system, **called in mmio_init(), do not call it arbitrarily**       |
+| __exp2index(exp)                                | Convert the exponent $exp$ of $2^{exp}$ to the index in the memory pool's array          |
+| mmio_create(size, vm_flags, res_vaddr, res_length) | Create an MMIO region with size aligned to the requested size, and bind its VMA to initial_mm |
+| mmio_release(vaddr, length)                     | Cancel the mapping of MMIO at address vaddr with size length and return it to the buddy    |

docs/locales/en/kernel/process_management/index.rst

@@ -0,0 +1,21 @@
+.. note:: AI Translation Notice
+
+   This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+   - Source document: kernel/process_management/index.rst
+
+   - Translation time: 2025-05-19 01:41:09
+
+   - Translation model: `Qwen/Qwen3-8B`
+
+
+   Please report issues via `Community Channel <https://github.com/DragonOS-Community/DragonOS/issues>`_
+
+Process Management Module
+====================================
+
+.. toctree::
+   :maxdepth: 1
+
+   kthread
+   load_binary

docs/locales/en/kernel/process_management/kthread.md

@@ -0,0 +1,30 @@
+:::{note}
+**AI Translation Notice**
+
+This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+- Source document: kernel/process_management/kthread.md
+
+- Translation time: 2025-05-19 01:41:23
+
+- Translation model: `Qwen/Qwen3-8B`
+
+Please report issues via [Community Channel](https://github.com/DragonOS-Community/DragonOS/issues)
+
+:::
+
+# kthread Kernel Threads
+
+  The kernel thread module is implemented in `process/kthread.rs`, providing support for kernel threads and related functionalities. Kernel threads act as the "avatars" of the kernel, enhancing the system's parallelism and fault tolerance capabilities.
+
+## Principles
+
+  Each kernel thread runs in kernel mode, executing its specific tasks.
+
+  The creation of a kernel thread is achieved by calling the `KernelThreadMechanism::create()` or `KernelThreadMechanism::create_and_run()` function, which sends a creation task to the `kthreadd` daemon thread. In other words, the creation of a kernel thread is ultimately handled by `kthread_daemon`.
+
+  After a kernel thread is created, it defaults to a sleeping state. To wake it up, the `ProcessManager::wakeup` function should be used.
+
+  When other kernel modules wish to stop a kernel thread, they can call the `KernelThreadMechanism::stop()` function to wait for the thread to exit, then obtain the return value and clean up the thread's PCB (Process Control Block).
+
+  Kernel threads should frequently check the result of `KernelThreadMechanism::should_stop()` to determine whether they should exit. When it is detected that the thread needs to exit, it can return a return code to terminate itself. (Note: resource cleanup is important)

docs/locales/en/kernel/process_management/load_binary.md

@@ -0,0 +1,30 @@
+:::{note}
+**AI Translation Notice**
+
+This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+- Source document: kernel/process_management/load_binary.md
+
+- Translation time: 2025-05-19 01:41:18
+
+- Translation model: `Qwen/Qwen3-8B`
+
+Please report issues via [Community Channel](https://github.com/DragonOS-Community/DragonOS/issues)
+
+:::
+
+# Loader
+
+## 1. Binary Program Loading
+
+  In this section, you will learn about the principles of the binary loader in DragonOS.
+
+  When DragonOS loads a binary program, it performs a "probe-load" process.
+
+  During the probe phase, DragonOS reads the file header and sequentially calls the probe functions of each binary loader to determine whether the binary program is suitable for that loader. If it is suitable, the loader will be used to load the program.
+
+  During the load phase, DragonOS uses the aforementioned loader to load the program. The loader will map the various segments of the binary program into memory and obtain the entry address of the binary program.
+
+:::{note}
+Currently, DragonOS does not support dynamic linking, so all binary programs are statically linked. And only the ELF loader is temporarily supported.
+:::

docs/locales/en/kernel/sched/c_waiting.md

@@ -0,0 +1,202 @@
+:::{note}
+**AI Translation Notice**
+
+This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+- Source document: kernel/sched/c_waiting.md
+
+- Translation time: 2025-05-19 01:43:09
+
+- Translation model: `Qwen/Qwen3-8B`
+
+Please report issues via [Community Channel](https://github.com/DragonOS-Community/DragonOS/issues)
+
+:::
+
+# APIs Related to "Waiting" (C Language)
+
+:::{warning}
+
+As the kernel evolves, we will gradually replace the C language waiting mechanism with the Rust language waiting mechanism. During this process, we will retain both the C and Rust waiting mechanisms to allow for comparison during development.
+Once the timing is ripe, we will gradually remove the C language waiting mechanism.
+:::
+
+   If several processes need to wait for an event to occur before they can be executed, a "waiting" mechanism is required to achieve process synchronization.
+
+## I. wait_queue Waiting Queue
+
+   wait_queue is a process synchronization mechanism, known as "waiting queue" in Chinese. It can suspend the current process and wake them up when the time is ripe, by another process.
+
+   When you need to wait for an event to complete, using the wait_queue mechanism can reduce the overhead of process synchronization. Compared to overusing spinlocks and semaphores, or repeatedly calling usleep(1000) functions for synchronization, wait_queue is an efficient solution.
+
+:::{warning}
+The implementation of the wait_queue in `wait_queue.h` does not have an independent queue head and does not consider locking the wait_queue. Therefore, in later development, the queue head implementation in `wait_queue_head_t` was added, which is essentially a linked list plus a spinlock. It is compatible with the queue `wait_queue_node_t` in `wait_queue.h`. When you use `struct wait_queue_head` as the queue head, you can still use the functions to add nodes to the waiting queue.
+:::
+
+### Simple Usage
+
+   The usage of a waiting queue mainly includes the following parts:
+
+- Creating and initializing a waiting queue
+- Using the `wait_queue_sleep_on_` series of functions to suspend the current process. Processes that are suspended later will be placed at the end of the queue.
+- Using the `wait_queue_wakeup()` function to wake up processes waiting in the waiting queue and add them to the scheduling queue
+
+&emsp;&emsp; To use wait_queue, you need to `#include<common/wait_queue.h>`, and create a `wait_queue_node_t` type variable as the head of the waiting queue. This structure contains only two member variables:
+
+```c
+typedef struct
+{
+    struct List wait_list;
+    struct process_control_block *pcb;
+} wait_queue_node_t;
+```
+
+&emsp;&emsp; For the waiting queue, there is a good naming method:
+
+```c
+wait_queue_node_t wq_keyboard_interrupt_received;
+```
+
+&emsp;&emsp; This naming convention increases code readability and makes it easier to understand what the code is waiting for.
+
+### Initializing the Waiting Queue
+
+&emsp;&emsp; The function `wait_queue_init(wait_queue_node_t *wait_queue, struct process_control_block *pcb)` provides the functionality to initialize a wait_queue node.
+
+&emsp;&emsp; When you initialize the queue head, you only need to pass the pointer to the wait_queue head node, and set the second parameter to NULL.
+
+### Inserting a Node into the Waiting Queue
+
+&emsp;&emsp; You can use the following functions to suspend the current process and insert it into the specified waiting queue. These functions have similar overall functions, but differ in some details.
+
+| Function Name                         | Explanation                                                       |
+| ----------------------------------- | ---------------------------------------------------------------- |
+| wait_queue_sleep_on()               | Suspends the current process and sets the suspension state to PROC_UNINTERRUPTIBLE |
+| wait_queue_sleep_on_unlock()        | Suspends the current process and sets the suspension state to PROC_UNINTERRUPTIBLE. After the current process is inserted into the waiting queue, it unlocks the given spinlock |
+| wait_queue_sleep_on_interriptible() | Suspends the current process and sets the suspension state to PROC_INTERRUPTIBLE |
+
+### Waking Up a Process from the Waiting Queue
+
+&emsp;&emsp; You can use the `void wait_queue_wakeup(wait_queue_node_t * wait_queue_head, int64_t state);` function to wake up the first process in the specified waiting queue that has a suspension state matching the specified `state`.
+
+&emsp;&emsp; If there are no matching processes, no process will be woken up, as if nothing happened.
+
+------------------------------------------------------------
+&emsp;&emsp; 
+&emsp;&emsp; 
+&emsp;&emsp; 
+
+## II. wait_queue_head Waiting Queue Head
+
+&emsp;&emsp; The data structure is defined as follows:
+
+```c
+typedef struct
+{
+    struct List wait_list;
+    spinlock_t lock;  // 队列需要有一个自旋锁,虽然目前内部并没有使用,但是以后可能会用.
+} wait_queue_head_t;
+```
+
+&emsp;&emsp; The usage logic of the waiting queue head is the same as the waiting queue itself, because it is also a node of the waiting queue (just with an additional lock). The functions of wait_queue_head are basically the same as those of wait_queue, except that they include the string \*\*\*\_with\_node\_\*\*\*.
+
+&emsp;&emsp; Meanwhile, the wait_queue.h file provides many macros that can make your work easier.
+
+### Provided Macros
+| Macro                               | Explanation                                                       |
+| ----------------------------------- | ---------------------------------------------------------------- |
+| DECLARE_WAIT_ON_STACK(name, pcb)             | Declare a wait_queue node on the stack, and bind the pcb-represented process to this node |
+| DECLARE_WAIT_ON_STACK_SELF(name)     | Declare a wait_queue node on the stack, and bind the current process (i.e., the process itself) to this node |
+| DECLARE_WAIT_ALLOC(name, pcb)  | Use `kzalloc` to declare a wait_queue node, and bind the pcb-represented process to this node. Remember to use kfree to release the space |
+| DECLARE_WAIT_ALLOC_SELF(name)      | Use `kzalloc` to declare a wait_queue node, and bind the current process (i.e., the process itself) to this node. Remember to use kfree to release the space |
+
+### Creating a Waiting Queue Head
+&emsp;&emsp; You can directly call the macro
+```c
+DECLARE_WAIT_QUEUE_HEAD(m_wait_queue_head);  // 在栈上声明一个队列头变量
+```
+&emsp;&emsp; Or manually declare
+```c
+struct wait_queue_head_t m_wait_queue_head = {0}; 
+wait_queue_head_init(&m_wait_queue_head);
+```
+
+### Inserting a Node into the Waiting Queue
+
+| Function Name                         | Explanation                                                       |
+| ----------------------------------- | ---------------------------------------------------------------- |
+| wait_queue_sleep_with_node(wait_queue_head_t *head, wait_queue_node_t *wait_node)              | Pass in a waiting queue node, and set the suspension state of the node to PROC_UNINTERRUPTIBLE |
+| wait_queue_sleep_with_node_unlock(wait_queue_head_t *q, wait_queue_node_t *wait, void *lock)      | Pass in a waiting queue node, suspend the process pointed to by the node's pcb, and set the suspension state to PROC_UNINTERRUPTIBLE. After the current process is inserted into the waiting queue, unlock the given spinlock |
+| wait_queue_sleep_with_node_interriptible(wait_queue_head_t *q, wait_queue_node_t *wait) | Pass in a waiting queue node, suspend the process pointed to by the node's pcb, and set the suspension state to PROC_INTERRUPTIBLE |
+
+### Waking Up a Process from the Waiting Queue
+&emsp;&emsp; The `wait_queue_wakeup` function in `wait_queue.h` directly kfree's the wait_node node. For stack-based wait_node, you can choose `wait_queue_wakeup_on_stack(wait_queue_head_t *q, int64_t state)` to wake up the queue head node in the queue.
+
+------------------------------------------------------------
+&emsp;&emsp; 
+&emsp;&emsp; 
+&emsp;&emsp; 
+
+## III. completion Completion Count
+
+### Simple Usage
+&emsp;&emsp; The usage of completion mainly includes the following parts:
+
+- Declare a completion (can be on the stack, using kmalloc, or using an array)
+- Use wait_for_completion to wait for the event to complete
+- Use complete to wake up the waiting processes
+
+&emsp;&emsp; Waiting operation
+```c
+void wait_fun() {
+    DECLARE_COMPLETION_ON_STACK(comp);  // 声明一个completion 
+
+    // .... do somethind here 
+    // 大部分情况是你使用kthread_run()创建了另一个线程
+    // 你需要把comp变量传给这个线程, 然后当前线程就会等待他的完成
+
+    if (!try_wait_for_completion(&comp))  // 进入等待
+        wait_for_completion(&comp);
+}
+```
+
+&emsp;&emsp; Completion operation
+```c
+void kthread_fun(struct completion *comp) {
+    // ...... 做一些事  .......
+    // 这里你确定你完成了目标事件
+
+    complete(&comp);
+    // 或者你使用complete_all
+    complete_all(&comp);
+}
+```
+
+### More Usage
+&emsp;&emsp; In the kernel/sched/completion.c folder, you can see several functions starting with __test__, which are test code for the completion module and cover most of the completion functions. You can refer to these functions to learn how to use them.
+
+### Initializing Completion
+&emsp;&emsp; The function `completion_init(struct completion *x)` provides the functionality to initialize a completion. When you use `DECLARE_COMPLETION_ON_STACK` to create (on the stack), it will be automatically initialized.
+
+### Completion-related wait series functions
+
+| Function Name                         | Explanation                                                       |
+| ----------------------------------- | ---------------------------------------------------------------- |
+| wait_for_completion(struct completion *x)       | Suspends the current process and sets the suspension state to PROC_UNINTERRUPTIBLE.                     |
+| wait_for_completion_timeout(struct completion *x, long timeout)  | Suspends the current process and sets the suspension state to PROC_UNINTERRUPTIBLE. After waiting for timeout time (jiffies time slice), the process is automatically awakened. |
+| wait_for_completion_interruptible(struct completion *x) | Suspends the current process and sets the suspension state to PROC_INTERRUPTIBLE.                          |
+| wait_for_completion_interruptible_timeout(struct completion *x, long timeout) | Suspends the current process and sets the suspension state to PROC_INTERRUPTIBLE. After waiting for timeout time (jiffies time slice), the process is automatically awakened.                         |
+| wait_for_multicompletion(struct completion x[], int n)| Suspends the current process and sets the suspension state to PROC_UNINTERRUPTIBLE. (Waiting for the completion of the array's completions)                     |
+
+### Completion-related complete series functions
+
+| Function Name                         | Explanation                                                       |
+| ----------------------------------- | ---------------------------------------------------------------- |
+| complete(struct completion *x)             | Indicates that an event has been completed, and wakes up one process from the waiting queue                     |
+| complete_all(struct completion *x)      | Indicates that the events related to this completion are marked as permanently completed, and wakes up all processes in the waiting queue |
+
+### Other Functions for Querying Information
+| Function Name                         | Explanation                                                       |
+| ----------------------------------- | ---------------------------------------------------------------- |
+| completion_done(struct completion *x)            | Checks if the completion's done variable is greater than 0. If it is, returns true; otherwise, returns false. Adding this function before waiting may accelerate the process? (Not tested experimentally yet, needs further verification)                     |
+| try_wait_for_completion(struct completion *x)   | Checks if the completion's done variable is greater than 0. If it is, returns true (and decrements done by 1); otherwise, returns false. Adding this function before waiting may accelerate the process? (This function has the same logic as `completion_done`, but actively decrements the completion's done variable by 1)   |

docs/locales/en/kernel/sched/cfs.md

@@ -0,0 +1,43 @@
+:::{note}
+**AI Translation Notice**
+
+This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+- Source document: kernel/sched/cfs.md
+
+- Translation time: 2025-05-19 01:41:13
+
+- Translation model: `Qwen/Qwen3-8B`
+
+Please report issues via [Community Channel](https://github.com/DragonOS-Community/DragonOS/issues)
+
+:::
+
+# APIs Related to the Completely Fair Scheduler
+
+   CFS (Completely Fair Scheduler), as the name suggests, is a fully fair scheduler. CFS is one of the mainline schedulers and is also one of the most typical O(1) schedulers.
+
+## Structure Introduction
+
+- `_translated_label__`CompletelyFairScheduler``
+   ``CompletelyFairScheduler``实现了``Scheduler``trait，他是完全调度算法逻辑的主要实施者。
+
+- ``FairSchedEntity``
+	- **重要字段**
+		- ``cfs_rq``: 它指向了自己所在的完全公平调度队列。
+		- ``my_cfs_rq``: 为一个``Option``变量，当该实体作为一个单独进程时，这个值为``None``，但是若这个实体为一个组，那这个变量必需为这个组内的私有调度队列。这个``cfs_rq``还可以继续往下深入，就构成了上述的树型结构。
+		- ``pcb``: 它指向了当前实体对应的``PCB``，同样，若当前实体为一个组，则这个``Weak``指针不指向任何值。
+
+  ``FairSchedEntity``是完全公平调度器中最重要的结构体，他代表一个实体单位，它不止表示一个进程，它还可以是一个组或者一个用户，但是它在cfs队列中所表示的就单单是一个调度实体。这样的设计可以为上层提供更多的思路，比如上层可以把不同的进程归纳到一个调度实体从而实现组调度等功能而不需要改变调度算法。
+
+  在cfs中，整体的结构是**一棵树**，每一个调度实体作为``cfs_rq``中的一个节点，若该调度实体不是单个进程（它可能是一个进程组），则在该调度实体中还需要维护一个自己的``cfs_rq``，这样的嵌套展开后，每一个叶子节点就是一个单独的进程。需要理解这样一棵树，**在后续文档中会以这棵树为核心讲解**。
+
+  该结构体具体的字段意义请查阅源代码。这里提及几个重要的字段：
+
+
+- ``CfsRunQueue``
+  ``CfsRunQueue``完全公平调度算法中管理``FairSchedEntity``的队列，它可以挂在总的``CpuRunQueue``下，也可以作为子节点挂在``FairSchedEntity``上，详见上文``FairSchedEntity``。
+
+	- **重要字段**
+		- ``entities``: 存储调度实体的红黑树
+		- ``current`_en`: The entity currently running

docs/locales/en/kernel/sched/core.md

@@ -0,0 +1,79 @@
+:::{note}
+**AI Translation Notice**
+
+This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+- Source document: kernel/sched/core.md
+
+- Translation time: 2025-05-19 01:41:31
+
+- Translation model: `Qwen/Qwen3-8B`
+
+Please report issues via [Community Channel](https://github.com/DragonOS-Community/DragonOS/issues)
+
+:::
+
+# APIs Related to Process Scheduler
+
+   This section defines the APIs related to process scheduling in DragonOS, which are the interfaces for the system to perform process scheduling. It also abstracts the Scheduler trait to allow specific scheduler implementations.
+
+## Introduction to Scheduler
+
+   Generally, a system handles multiple requests at the same time, but its resources are limited and prioritized. Scheduling is the method used to coordinate each request's usage of these resources.
+
+## Overall Architecture
+   The entire scheduling subsystem is organized in a **tree structure**, with each CPU managing such a tree. Each CPU's ``CpuRunQueue``即可以理解为树的根节点。每个``CpuRunQueue``下会管理着不同调度策略的子树，根据不同的调度策略深入到对应子树中实施调度。大体结构如下：
+
+- CpuRunQueue
+	- Cfs
+		- CfsRunQueue
+			- FairSchedEntity
+				- CfsRunQueue
+					- ...（嵌套）
+	- Rt
+		- ...
+	- Idle
+		- ...
+	- RR
+		- ...
+	- ...
+
+  基于这个结构，调度子系统能够更轻松地解耦以及添加其他调度策略。
+  
+
+## 重要结构
+- ``Scheduler:``
+  ``Scheduler``是各个调度算法提供给上层的接口，实现不同的调度算法，只需要向外提供这样一组接口即可。
+
+- ``CpuRunQueue:``
+  ``CpuRunQueue``为总的CPU运行队列，他会根据不同的调度策略来进行调度。他作为调度子系统的根节点来组织调度。
+	- **重要字段**
+		- ``lock``: 过程锁，因为在深入到具体调度策略后的调度过程中还会需要访问``CpuRunQueue``中的信息，在cfs中保存了``CpuRunQueue``对象，我们需要确保在整体过程上锁后，子对象中不需要二次加锁即可访问，所以过程锁比较适合这个场景，若使用对象锁，则在对应调度策略中想要访问``CpuRunQueue``中的信息时需要加锁，但是最外层已经将``CpuRunQueue``对象上锁，会导致内层永远拿不到锁。对于该字段，详见[CpuRunQueue的self_lock方法及其注释](https://code.dragonos.org.cn/xref/DragonOS/kernel/src/sched/mod.rs?r=dd8e74ef0d7f91a141bd217736bef4fe7dc6df3d#360)。
+		- ``cfs``: Cfs调度器的根节点，往下伸展为一棵子树，详见完全公平调度文档。
+		- ``current``: 当前在CPU上运行的进程。
+		- ``idle``: 当前CPU的Idle进程。
+
+
+## 调度流程
+  一次有效的调度分两种情况，第一是主动调用``__schedule``或者``schedule``函数进行调度，第二是通过时钟中断，判断当前运行的任务时间是否到期。
+
+- **主动调度**
+	- ``__schedule``和``schedule``函数：
+		- ``__schedule``:真正执行调度。会按照当前调度策略来选择下一个任务执行。
+		- ``schedule``: ``__schedule``的上层封装，它需要该任务在内核中的所有资源释放干净才能进行调度，即判断当前进程的``preempt_count``是否为0，若不为0则会**panic**。
+		- 参数：这两个函数都需要提供一个参数：``SchedMode``。用于控制此次调度的行为,可选参数主要有以下两个：
+			- ``SchedMode::SM_NONE``: 标志当前进程没有被抢占而是主动让出，他**不会**被再次加入队列，直到有其他进程主动唤醒它，这个标志位主要用于信号量、等待队列以及一些主动唤醒场景的实现。
+			- ``SchedMode::SM_PREEMPT``:标志当前是被**抢占**运行的，他**会**再次被加入调度队列等待下次调度，通俗来说：它是被别的进程抢占了运行时间，有机会运行时他会继续执行。
+
+- **时钟调度**
+  时钟中断到来的时候，调度系统会进行更新，包括判断是否需要下一次调度。以下为主要的函数调用栈：
+	- ``LocalApicTimer::handle_irq``: 中断处理函数
+		- ``ProcessManager::update_process_times``: 更新当前进程的时钟信息（统计运行时等）
+		 - ``scheduler_tick``: 调度子系统tick入口
+		 	- ``CompletelyFairScheduler::tick``: 以cfs为例，此为cfs调度算法的tick入口
+		 		- ``CfsRunQueue::entity_tick``: 对所有调度实体进行tick
+		 		 - ``CfsRunQueue::update_current``: 更新当前运行任务的运行时间及判断是否到期
+		 		 	- ``CfsRunQueue::account_cfs_rq_runtime``: 计算当前队列的运行时间
+		 		 	 - ``CpuRunQueue::resched_current``: 若上一步计算的时间超时则到这一步，这里会设置进程标志为``NEED_SCHEDULE``.
+
+	- 退出中断：退出中断时检查当前进程是否存在标志位``NEED_SCHEDULE``，若存在则调用``__schedule`` performs scheduling.

docs/locales/en/kernel/sched/index.rst

@@ -0,0 +1,28 @@
+.. note:: AI Translation Notice
+
+   This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+   - Source document: kernel/sched/index.rst
+
+   - Translation time: 2025-05-19 01:41:10
+
+   - Translation model: `Qwen/Qwen3-8B`
+
+
+   Please report issues via `Community Channel <https://github.com/DragonOS-Community/DragonOS/issues>`_
+
+====================================
+DragonOS Scheduling
+====================================
+
+   This is the documentation related to process scheduling in DragonOS.
+
+.. toctree::
+   :maxdepth: 1
+
+   c_waiting
+   rust_waiting
+   core
+   cfs
+   rt
+   kernel_timer

docs/locales/en/kernel/sched/kernel_timer.md

@@ -0,0 +1,184 @@
+:::{note}
+**AI Translation Notice**
+
+This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+- Source document: kernel/sched/kernel_timer.md
+
+- Translation time: 2025-05-19 01:41:48
+
+- Translation model: `Qwen/Qwen3-8B`
+
+Please report issues via [Community Channel](https://github.com/DragonOS-Community/DragonOS/issues)
+
+:::
+
+# Kernel Timer
+
+## 1. Introduction
+
+  The kernel timer is a type of timer within the kernel. The working mechanism of the kernel timer is: adding the timer to a queue and setting the expiration time for each timer. When the timer expires, the function corresponding to the timer is executed.
+
+## 2. Design Concept
+
+&emsp;&emsp;The timer type is a structure of `Timer`, and `Timer` is composed of `SpinLock<InnerTimer>`. A global queue `TIMER_LIST` with element type `Arc<Timer>` is used to store the timers created by the system. When creating a timer, you should call `Timer::new(timer_func,expire_jiffies)`, where timer_func is the function to be executed by the timer, expire_jiffies is the expiration time of the timer, and the type of `timer_func` parameter is a structure that implements the `TimerFunction` characteristic. After creating the timer, you should use `Timer::activate()` to insert the timer into `TIMER_LIST`.
+
+&emsp;&emsp;**If you only want the current PCB to sleep for a certain period, you should call `schedule_timeout(timeout)`, and timeout specifies the duration of the PCB sleep.**
+
+## 3. Features That the Timer Should Implement
+
+&emsp;&emsp;The function to be executed by the timer should implement the `TimerFunction` characteristic, and its definition is as follows:
+
+```rust
+/// 定时器要执行的函数的特征
+pub trait TimerFunction: Send + Sync {
+    fn run(&mut self);
+}
+```
+
+&emsp;&emsp;A typical implementation method is: creating a zero-length structure, implementing the `TimerFunction` characteristic, and then implementing the operation to be performed by the timer in the `run` function.
+
+## 4. Timer API
+
+### 4.1. Timer API
+
+#### 4.1.1. Create a Timer
+```rust
+pub fn new(timer_func: Box<dyn TimerFunction>, expire_jiffies: u64) -> Arc<Self>
+```
+
+**Parameters**
+
+- timer_func: A structure corresponding to the function that the timer needs to execute, which implements the `TimerFunction` characteristic
+
+- expire_jiffies: The expiration time of the timer (unit: **jiffies**)
+
+**Return**
+
+- Pointer to the timer structure
+
+#### 4.1.2. Insert the Timer into the Timer List
+
+```rust
+pub fn activate(&self)
+```
+
+### 4.2. Other APIs
+
+&emsp;&emsp;**If you want to use the following functions in a .c module, please add rs_ before the function name.**
+
+#### 4.2.1. Make the Process Sleep for a Certain Period
+
+```rust
+pub fn schedule_timeout(mut timeout: i64) -> Result<i64, SystemError>
+```
+
+**Function**
+
+&emsp;&emsp;Make the process sleep for timeout jiffies
+
+**Parameters**
+
+- timeout: The time to sleep (unit: **jiffies**)
+
+**Return Value**
+
+- Ok(i64): Remaining time to sleep (unit: **jiffies**)
+- Err(SystemError): Error code
+
+#### 4.2.2. Get the Expiration Time of the First Timer in the Queue
+
+```rust
+pub fn timer_get_first_expire() -> Result<u64, SystemError>
+```
+
+**Function**
+
+&emsp;&emsp;Get the expiration time of the first timer in the queue, i.e., the expiration time of the earliest expiring timer
+
+**Return Value**
+
+- Ok(i64): Expiration time of the earliest expiring timer (unit: **jiffies**)
+- Err(SystemError): Error code
+
+#### 4.2.3. Get the Current System Time
+
+```rust
+pub fn clock() -> u64 
+```
+
+**Function**
+
+&emsp;&emsp;Get the current system time (unit: **jiffies**)
+
+#### 4.2.4. Calculate the Timer Time Slice Corresponding to the Next n Milliseconds or Microseconds
+
+##### 4.2.4.1. Milliseconds
+
+```rust
+pub fn next_n_ms_timer_jiffies(expire_ms: u64) -> u64
+```
+
+**Function**
+
+&emsp;&emsp;Calculate the timer time slice corresponding to the next n **milliseconds**
+
+**Parameters**
+
+- expire_ms: n milliseconds
+
+**Return Value**
+
+&emsp;&emsp;The corresponding timer time slice (unit: **milliseconds**)
+
+##### 4.2.4.2. Microseconds
+
+```rust
+pub fn next_n_us_timer_jiffies(expire_us: u64) -> u64
+```
+
+**Function**
+
+&emsp;&emsp;Calculate the timer time slice corresponding to the next n **microseconds**
+
+**Parameters**
+
+- expire_ms: n microseconds
+
+**Return Value**
+
+&emsp;&emsp;The corresponding timer time slice (unit: **microseconds**)
+
+## 5. Creating a Timer Instance
+
+```rust
+struct TimerExample {
+    /// 结构体的成员对应函数的形参
+    example_parameter: i32,
+}
+impl TimerExample {
+    pub fn new(para: i32) -> Box<TimerExample> {
+        return Box::new(TimerExample {
+            example_parameter: para,
+        });
+    }
+}
+/// 为结构体实现TimerFunction特性
+impl TimerFunction for TimerExample {
+    /// TimerFunction特性中的函数run
+    fn run(&mut self) {
+        // 定时器需要执行的操作
+        example_func(self.example_parameter);
+    }
+}
+fn example_func(para: i32) {
+    println!("para is {:?}", para);
+}
+fn main() {
+    let timer_example: Box<TimerExample> = TimerExample::new(1);
+    // 创建一个定时器
+    let timer: Arc<Timer> = Timer::new(timer_example, 1);
+    // 将定时器插入队列
+    timer.activate();
+}
+```

docs/locales/en/kernel/sched/rt.md

@@ -0,0 +1,71 @@
+:::{note}
+**AI Translation Notice**
+
+This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+- Source document: kernel/sched/rt.md
+
+- Translation time: 2025-05-19 01:41:17
+
+- Translation model: `Qwen/Qwen3-8B`
+
+Please report issues via [Community Channel](https://github.com/DragonOS-Community/DragonOS/issues)
+
+:::
+
+# APIs Related to Real-Time Process Scheduler
+
+   RT (Real-Time Scheduler), real-time scheduler. Real-time scheduling is a method of allocating CPU resources to complete real-time processing tasks.
+
+   In DragonOS, processes are divided into two categories: "real-time processes" and "normal processes". Real-time processes have higher priority than normal processes. If there are real-time processes in the current system's execution queue, the RT scheduler will prioritize selecting a real-time process. If there are multiple real-time processes in the queue, the scheduler will select the one with the highest priority to execute.
+
+## 1. Introduction to RTQueue
+
+   RTQueue is a scheduling queue used to store real-time processes with a state of running. Each CPU maintains its own RTQueue, and it primarily uses Vec as the main storage structure to implement this.
+
+### 1.1 Main Functions
+1. enqueue(): Add the PCB to the queue
+2. dequeue(): Remove the PCB from the queue
+
+## 2. Introduction to SchedulerRT
+
+   RT Scheduler class, which mainly implements the initialization and scheduling function of the RT scheduler.
+
+### 2.1 Main Functions
+1. pick_next_task_rt(): Get the first PCB that needs to be executed on the current CPU
+2. sched(): Implementation of the sched() function for the Scheduler trait. This function handles the logic for scheduling real-time processes and returns the PCB to be executed next. If no suitable PCB is found, it returns None.
+3. enqueue(): Also an implementation of the sched() function for the Scheduler trait, which adds a PCB to the scheduler's scheduling queue
+
+### 2.2 Kernel Scheduling Policies
+   Currently, the main scheduling policies in DragonOS are SCHED_NORMAL policy | SCHED_FIFO policy | SCHED_RT policy. The specific scheduling policies are as follows:
+1. SCHED_NORMAL policy:
+SCHED_NORMAL is an "absolute fair scheduling policy", and processes using this policy are scheduled using CFS.
+
+2. SCHED_FIFO policy:
+SCHED_FIFO is a "real-time process scheduling policy", which is a first-in-first-out scheduling strategy. This policy does not involve the CPU time slice mechanism. Without a higher-priority process, the process can only wait for other processes to release CPU resources. In the SCHED_FIFO policy, the running time of the process scheduled by the scheduler is not limited and can run for an arbitrary length of time.
+
+3. SCHED_RR policy:
+SCHED_RR is a "real-time process scheduling policy", which uses a time-slice rotation mechanism. The time_slice of the corresponding process will decrease during execution. Once the process uses up its CPU time slice, it will be added to the execution queue of the same priority on the same CPU. At the same time, the CPU resource is released, and the CPU usage will be allocated to the next process to execute.
+
+## 3. Q&A
+   Several commonly used methods
+1. How to create a real-time process
+
+    ```c
+    struct process_control_block *pcb_name = kthread_run_rt(&fn_name, NULL, "test create rt pcb");
+    ```
+    Where kthread_run_rt is a macro for creating a kernel real-time thread
+
+2. Meaning of fields related to real-time processes in the PCB
+    1. policy: The scheduling policy of the real-time process, currently SCHED_FIFO and SCHED_RR
+    2. priority: The priority of the real-time process, ranging from 0 to 99. The larger the number, the higher the priority
+    3. rt_time_slice: The time slice of the real-time process. The default is 100, which decreases as the CPU runs. When rt_time_slice reaches 0, the time slice is reset to its initial value, and the process is added to the execution queue
+
+3. How real-time processes are stored in the queue
+    - Currently, Vec is used to store the processes. Due to the specific implementation logic, the enqueue and dequeue operations are performed at the end of the queue. Therefore, the following phenomenon may occur: when there are multiple real-time processes with the same priority waiting to run, a starvation phenomenon may occur. That is, the process that ran out of its time slice will be executed next, causing starvation among the processes with the same priority waiting.
+
+4. Todo
+    1. Use a doubly linked list (or other methods) to store the queue of real-time processes to solve the above starvation issue
+    2. Currently, the real-time scheduling is for a single CPU. It needs to be implemented for multiple CPUs
+    3. Implement the bandwidth allocation ratio between real-time processes and normal processes
+    4. Achieve load balancing between multiple CPUs

docs/locales/en/kernel/sched/rust_waiting.md

@@ -0,0 +1,94 @@
+:::{note}
+**AI Translation Notice**
+
+This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+- Source document: kernel/sched/rust_waiting.md
+
+- Translation time: 2025-05-19 01:41:21
+
+- Translation model: `Qwen/Qwen3-8B`
+
+Please report issues via [Community Channel](https://github.com/DragonOS-Community/DragonOS/issues)
+
+:::
+
+# APIs Related to "Waiting" (Rust Language)
+
+   If several processes need to wait for a certain event to occur before they can be executed, a "waiting" mechanism is required to achieve process synchronization.
+
+## 1. WaitQueue Waiting Queue
+
+   WaitQueue is a process synchronization mechanism, known as "Waiting Queue" in Chinese. It can suspend the current process and, when the time is ripe, another process can wake them up.
+
+   When you need to wait for an event to complete, using the WaitQueue mechanism can reduce the overhead of process synchronization. Compared to abusing spinlocks and semaphores, or repeatedly using functions like usleep(1000), WaitQueue is an efficient solution.
+
+### 1.1 Using WaitQueue
+
+   Using WaitQueue is very simple, requiring just three steps:
+
+1. Initialize a WaitQueue object.
+2. Call the API related to suspending the current process and suspend it.
+3. When the event occurs, another process calls the API related to waking up the WaitQueue to wake up a process.
+
+   Here is a simple example:
+
+### 1.1.1 Initializing a WaitQueue Object
+
+   Initializing a WaitQueue object is very simple; you just need to call `WaitQueue::INIT`.
+
+```rust
+let mut wq = WaitQueue::INIT;
+```
+
+### 1.1.2 Suspending the Process
+
+   You can suspend the current process as follows:
+
+```rust
+wq.sleep();
+```
+
+   The current process will be suspended until another process calls `wq.wakeup()`.
+
+### 1.1.3 Waking Up the Process
+
+   You can wake up a process as follows:
+
+```rust
+// 唤醒等待队列头部的进程（如果它的state & PROC_INTERRUPTIBLE 不为0）
+wq.wakeup(PROC_INTERRUPTIBLE);
+
+// 唤醒等待队列头部的进程（如果它的state & PROC_UNINTERRUPTIBLE 不为0）
+wq.wakeup(PROC_UNINTERRUPTIBLE);
+
+// 唤醒等待队列头部的进程（无论它的state是什么）
+wq.wakeup((-1) as u64);
+```
+
+### 1.2 APIs
+
+### 1.2.1 Suspending the Process
+
+   You can use the following functions to suspend the current process and insert it into the specified waiting queue. These functions have similar overall functionality, but differ in some details.
+
+| Function Name                             | Explanation                                                       |
+| --------------------------------------- | ---------------------------------------------------------------- |
+| sleep()                                 | Suspend the current process and set its state to `PROC_INTERRUPTIBLE` |
+| sleep_uninterruptible()                 | Suspend the current process and set its state to `PROC_UNINTERRUPTIBLE` |
+| sleep_unlock_spinlock()                 | Suspend the current process and set its state to `PROC_INTERRUPTIBLE`. After inserting the current process into the waiting queue, unlock the given spinlock |
+| sleep_unlock_mutex()                    | Suspend the current process and set its state to `PROC_INTERRUPTIBLE`. After inserting the current process into the waiting queue, unlock the given Mutex |
+| sleep_uninterruptible_unlock_spinlock() | Suspend the current process and set its state to `PROC_UNINTERRUPTIBLE`. After inserting the current process into the waiting queue, unlock the given spinlock |
+| sleep_uninterruptible_unlock_mutex()    | Suspend the current process and set its state to `PROC_UNINTERRUPTIBLE`. After inserting the current process into the waiting queue, unlock the given Mutex |
+
+### 1.2.2 Waking Up the Process
+
+   You can use the `wakeup(state)` function to wake up the first process in the waiting queue. If the process's state, after performing a bitwise AND operation with the given state, results in a non-zero value, it will be woken up.
+
+   Return value: Returns `true` if a process is woken up, otherwise returns `false`.
+
+### 1.2.3 Other APIs
+
+| Function Name | Explanation         |
+| ------------- | ------------------ |
+| len()         | Returns the number of processes in the waiting queue |

docs/locales/en/kernel/syscall/index.rst

@@ -0,0 +1,23 @@
+.. note:: AI Translation Notice
+
+   This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+   - Source document: kernel/syscall/index.rst
+
+   - Translation time: 2025-05-19 01:41:08
+
+   - Translation model: `Qwen/Qwen3-8B`
+
+
+   Please report issues via `Community Channel <https://github.com/DragonOS-Community/DragonOS/issues>`_
+
+.. _translated_label__syscall_en:
+
+System Calls
+====================================
+
+.. toctree::
+   :maxdepth: 1
+   :caption: Contents
+
+   syscall_table

docs/locales/en/kernel/syscall/syscall_table.rst

@@ -0,0 +1,107 @@
+.. note:: AI Translation Notice
+
+   This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+   - Source document: kernel/syscall/syscall_table.rst
+
+   - Translation time: 2025-05-19 01:41:32
+
+   - Translation model: `Qwen/Qwen3-8B`
+
+
+   Please report issues via `Community Channel <https://github.com/DragonOS-Community/DragonOS/issues>`_
+
+System Call Table Implementation Plan
+=====================================
+
+.. note::
+    Author: longjin <longjin@dragonos.org>
+
+    Date: 2025/05/13
+
+Overview
+--------
+
+.. mermaid::
+   :align: center
+   :caption: System Call Table Architecture
+
+   classDiagram
+      class Syscall {
+         <<trait>>
+         +num_args() usize
+         +handle(args, from_user) Result<usize, SystemError>
+         +entry_format(args) Vec<FormattedSyscallParam>
+      }
+
+      class SyscallHandle {
+         +nr: usize
+         +inner_handle: &dyn Syscall
+      }
+
+      class SyscallTable {
+         -entries: [Option<&SyscallHandle>; 512]
+         +get(nr) Option<&dyn Syscall>
+      }
+
+      Syscall <|.. SysXXXXXXHandle
+      SyscallHandle "1" *-- "1" Syscall
+      SyscallTable "1" *-- "512" SyscallHandle
+
+Compared to the original approach of dispatching system calls in a single large match statement, this approach uses a trait-based and system call table-based implementation. The main advantages include:
+
+- Reduced stack memory usage: Avoids a single large function consuming excessive stack space
+- Support for parameter printing: Through a unified parameter formatting interface
+- Better extensibility: Adding new system calls does not require modifying the dispatch logic
+
+Core Design
+-----------
+
+Syscall Trait
+~~~~~~~~~~~~~
+
+All system call handler functions must implement the `Syscall` trait:
+
+.. code-block:: rust
+
+    pub trait Syscall: Send + Sync + 'static {
+        fn num_args(&self) -> usize;
+        fn handle(&self, args: &[usize], from_user: bool) -> Result<usize, SystemError>;
+        fn entry_format(&self, args: &[usize]) -> Vec<FormattedSyscallParam>;
+    }
+
+- `num_args()`: Returns the number of arguments required by the system call
+- `handle()`: Executes the actual system call handling
+- `entry_format()`: Formats the parameters for debugging printing
+
+SyscallHandle
+~~~~~~~~~~~~~
+
+The `SyscallHandle` struct associates a system call number with its handler:
+
+.. code-block:: rust
+
+    pub struct SyscallHandle {
+        pub nr: usize,  // System call number
+        pub inner_handle: &'static dyn Syscall,  // Handler function
+        pub name: &'static str,
+    }
+
+SyscallTable
+~~~~~~~~~~~~
+
+The `SyscallTable` manages all system calls:
+
+- Fixed size of 512 entries
+- Initialized at compile time
+- Allows quick lookup of the handler function by system call number
+
+Usage
+-----
+
+Implementing a System Call
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+1. Define the implementation of `Syscall` for the specific system call
+2. Register the system call in the system call table
+3. Load all registered system calls during system initialization

docs/locales/en/kernel/trace/eBPF.md

@@ -0,0 +1,332 @@
+:::{note}
+**AI Translation Notice**
+
+This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+- Source document: kernel/trace/eBPF.md
+
+- Translation time: 2025-05-19 01:41:41
+
+- Translation model: `Qwen/Qwen3-8B`
+
+Please report issues via [Community Channel](https://github.com/DragonOS-Community/DragonOS/issues)
+
+:::
+
+# eBPF
+
+> Author: Chen Linfeng  
+> 
+> Email: chenlinfeng25@outlook.com
+
+## Overview
+
+eBPF is a revolutionary technology that originated from the Linux kernel. It allows sandboxed programs to run in privileged contexts (such as the operating system kernel). It is used to extend the kernel's functionality in a secure and efficient manner without modifying the kernel source code or loading kernel modules.
+
+Historically, due to the kernel's privileged position in supervising and controlling the entire system, the operating system has been an ideal place for implementing observability, security, and networking features. At the same time, due to the kernel's core position and high requirements for stability and security, the kernel has been difficult to iterate quickly. Therefore, traditionally, the innovation speed at the operating system level has been slower compared to features implemented outside the operating system itself.
+
+eBPF fundamentally changes this approach. By allowing sandboxed programs to run within the operating system, application developers can run eBPF programs to add additional functionality to the operating system at runtime. Then, with the help of JIT compilers and verification engines, the operating system ensures that these programs are as secure and efficient as natively compiled programs. This has sparked a wave of eBPF-based projects covering a wide range of use cases, including next-generation network implementations, observability, and security features.
+
+## eBPF in DragonOS
+
+Adding eBPF support to a new OS requires understanding the eBPF runtime process. Typically, eBPF needs user-space tools and kernel-related infrastructure to function properly. Since a new OS usually is compatible with Linux applications, this can further simplify the porting work of user-space tools. As long as the kernel implements the relevant system calls and features, it can work with existing tools to support eBPF.
+
+## eBPF Execution Process
+
+![image-20240909165945192](/kernel/trace/ebpf_flow.png)
+
+As shown in the figure, the execution process of an eBPF program is divided into three main steps:
+
+1. Source code -> Binary
+    1. Users can write eBPF programs in Python/C/Rust and compile the source code into a binary program using the relevant toolchain.
+    2. In this step, users need to reasonably use helper functions to enrich the functionality of the eBPF program.
+2. Loading eBPF program
+    1. User-space tool libraries encapsulate the system call interfaces provided by the kernel to simplify the user's work. After preprocessing, user-space tools make system calls to request the kernel to load the eBPF program.
+    1. The kernel first verifies the eBPF program to check its correctness and legality, and also performs further processing on the program.
+    1. The kernel attaches the eBPF program to the kernel's mount points (kprobe/uprobe/trace_point) based on the user's request.
+    1. During kernel operation, when these mount points are triggered by specific events, the eBPF program is executed.
+3. Data Interaction
+    1. eBPF programs can collect information from the kernel, and user tools can selectively retrieve this information.
+    2. eBPF programs can directly output information to a file, and user tools can read and parse the content of the file to obtain the information.
+    3. eBPF programs share and exchange data between the kernel and user space through Maps.
+
+## User-space Support
+
+There are many user-space eBPF tool libraries, such as C's libbpf, Python's bcc, and Rust's Aya. Overall, the processing flow of these tools is similar. DragonOS currently supports eBPF programs written with the [Aya](https://github.com/aya-rs/aya) framework. As an example, the user-space tool processing flow for Aya is as follows:
+
+1. Provide helper functions and Map abstractions for eBPF usage, making it easier to implement eBPF programs.
+2. Process the compiled eBPF program, call system calls to create Maps, and obtain corresponding file descriptors.
+3. Update the values of Maps (.data) as needed.
+4. Modify the relevant instructions of the eBPF program based on relocation information.
+5. Handle bpf to bpf calls in the eBPF program according to the kernel version.
+6. Load the eBPF program into the kernel.
+7. Package system calls and provide a large number of functions to help access eBPF information and interact with the kernel.
+
+DragonOS's support for the Aya library is not complete. By trimming the Aya library, we have implemented a smaller [tiny-aya](https://github.com/DragonOS-Community/tiny-aya). To ensure future compatibility with Aya, tiny-aya only modifies the core tool aya in Aya. Some functions have been disabled because the system calls or files they require are not yet implemented in DragonOS.
+
+### Tokio
+
+Aya requires an asynchronous runtime. With the addition of some system calls and fixes for some errors, DragonOS now supports a basic Tokio runtime.
+
+### Using Aya to Create an eBPF Program
+
+As described in the [official documentation](https://aya-rs.dev/book/start/development/) provided by Aya, users only need to install the corresponding Rust toolchain according to its process to create an eBPF project based on a template. Taking the current implementation of `syscall_ebf` as an example, this program counts the number of system calls and stores them in a HashMap.
+
+```
+├── Cargo.toml
+├── README.md
+├── syscall_ebpf
+├── syscall_ebpf-common
+├── syscall_ebpf-ebpf
+└── xtask
+```
+
+The project structure in the user/app directory is as follows:
+
+- `syscall_ebpf-ebpf` is the directory for implementing eBPF code, which will be compiled into bytecode.
+- `syscall_ebpf-common` is a common library, convenient for information exchange between the kernel and user space.
+- `syscall_ebpf` is the user-space program, responsible for loading the eBPF program and retrieving data generated by the eBPF program.
+- `xtask` is a command-line tool, convenient for users to compile and run user-space programs.
+
+To run user-space programs in DragonOS, the project created using the template cannot be used directly:
+
+1. This project does not meet DragonOS's requirements for the structure of user programs, but this can be easily modified.
+2. Because DragonOS's support for the Tokio runtime is not yet complete, the usage method needs to be slightly modified.
+
+```
+#[tokio::main(flavor = "current_thread")]
+async fn main() -> Result<(), Box<dyn Error>> {
+```
+
+3. Because the support for Aya is not complete, the project's dependencies on aya and aya-log need to be replaced with the implementations in tiny-aya.
+
+```
+[dependencies]
+aya = { git = "https://github.com/DragonOS-Community/tiny-aya.git" }
+aya-log = { git = "https://github.com/DragonOS-Community/tiny-aya.git" }
+```
+
+With slight modifications, eBPF programs can be implemented using the existing tools of Aya.
+
+## Kernel-space Support
+
+Kernel-space support mainly consists of three parts:
+
+1. kprobe implementation: located in directory `kernel/crates/kprobe`
+2. rbpf runtime: located in directory `kernel/crates/rbpf`
+3. System call support
+4. Helper function support
+
+### rbpf
+
+Previously, rbpf was used to run some simple eBPF programs. To run more complex programs, it needs to be modified.
+
+1. Add support for bpf to bpf calls: by adding new stack abstractions and saving and restoring necessary register data.
+2. Disable unnecessary internal memory checks, which are usually handled by the kernel's verifier.
+3. Add data structures with ownership to avoid limitations on lifetimes.
+
+### System Calls
+
+All eBPF-related system calls are concentrated in `bpf()`, and they are further distinguished by the parameter `cmd`. The current support is as follows:
+
+```rust
+pub fn bpf(cmd: bpf_cmd, attr: &bpf_attr) -> Result<usize> {
+    let res = match cmd {
+        // Map related commands
+        bpf_cmd::BPF_MAP_CREATE => map::bpf_map_create(attr),
+        bpf_cmd::BPF_MAP_UPDATE_ELEM => map::bpf_map_update_elem(attr),
+        bpf_cmd::BPF_MAP_LOOKUP_ELEM => map::bpf_lookup_elem(attr),
+        bpf_cmd::BPF_MAP_GET_NEXT_KEY => map::bpf_map_get_next_key(attr),
+        bpf_cmd::BPF_MAP_DELETE_ELEM => map::bpf_map_delete_elem(attr),
+        bpf_cmd::BPF_MAP_LOOKUP_AND_DELETE_ELEM => map::bpf_map_lookup_and_delete_elem(attr),
+        bpf_cmd::BPF_MAP_LOOKUP_BATCH => map::bpf_map_lookup_batch(attr),
+        bpf_cmd::BPF_MAP_FREEZE => map::bpf_map_freeze(attr),
+        // Program related commands
+        bpf_cmd::BPF_PROG_LOAD => prog::bpf_prog_load(attr),
+        // Object creation commands
+        bpf_cmd::BPF_BTF_LOAD => {
+            error!("bpf cmd {:?} not implemented", cmd);
+            return Err(SystemError::ENOSYS);
+        }
+        ty => {
+            unimplemented!("bpf cmd {:?} not implemented", ty)
+        }
+    };
+    res
+}
+```
+
+Among these, the command for creating a Map is further细分 to determine the specific Map type. Currently, we have added support for general Maps:
+
+```rust
+bpf_map_type::BPF_MAP_TYPE_ARRAY 
+bpf_map_type::BPF_MAP_TYPE_PERCPU_ARRAY 
+bpf_map_type::BPF_MAP_TYPE_PERF_EVENT_ARRAY
+bpf_map_type::BPF_MAP_TYPE_HASH 
+bpf_map_type::BPF_MAP_TYPE_PERCPU_HASH 
+bpf_map_type::BPF_MAP_TYPE_QUEUE 
+bpf_map_type::BPF_MAP_TYPE_STACK 
+bpf_map_type::BPF_MAP_TYPE_LRU_HASH 
+bpf_map_type::BPF_MAP_TYPE_LRU_PERCPU_HASH 
+
+bpf_map_type::BPF_MAP_TYPE_CPUMAP
+| bpf_map_type::BPF_MAP_TYPE_DEVMAP
+| bpf_map_type::BPF_MAP_TYPE_DEVMAP_HASH => {
+    error!("bpf map type {:?} not implemented", map_meta.map_type);
+    Err(SystemError::EINVAL)?
+}
+```
+
+All Maps implement the defined interface, which is referenced from the Linux implementation:
+
+```rust
+pub trait BpfMapCommonOps: Send + Sync + Debug + CastFromSync {
+    /// Lookup an element in the map.
+    ///
+    /// See https://ebpf-docs.dylanreimerink.nl/linux/helper-function/bpf_map_lookup_elem/
+    fn lookup_elem(&mut self, _key: &[u8]) -> Result<Option<&[u8]>> {
+        Err(SystemError::ENOSYS)
+    }
+    /// Update an element in the map.
+    ///
+    /// See https://ebpf-docs.dylanreimerink.nl/linux/helper-function/bpf_map_update_elem/
+    fn update_elem(&mut self, _key: &[u8], _value: &[u8], _flags: u64) -> Result<()> {
+        Err(SystemError::ENOSYS)
+    }
+    /// Delete an element from the map.
+    ///
+    /// See https://ebpf-docs.dylanreimerink.nl/linux/helper-function/bpf_map_delete_elem/
+    fn delete_elem(&mut self, _key: &[u8]) -> Result<()> {
+        Err(SystemError::ENOSYS)
+    }
+    /// For each element in map, call callback_fn function with map,
+    /// callback_ctx and other map-specific parameters.
+    ///
+    /// See https://ebpf-docs.dylanreimerink.nl/linux/helper-function/bpf_for_each_map_elem/
+    fn for_each_elem(&mut self, _cb: BpfCallBackFn, _ctx: *const u8, _flags: u64) -> Result<u32> {
+        Err(SystemError::ENOSYS)
+    }
+    /// Look up an element with the given key in the map referred to by the file descriptor fd,
+    /// and if found, delete the element.
+    fn lookup_and_delete_elem(&mut self, _key: &[u8], _value: &mut [u8]) -> Result<()> {
+        Err(SystemError::ENOSYS)
+    }
+    /// perform a lookup in percpu map for an entry associated to key on cpu.
+    fn lookup_percpu_elem(&mut self, _key: &[u8], cpu: u32) -> Result<Option<&[u8]>> {
+        Err(SystemError::ENOSYS)
+    }
+    /// Get the next key in the map. If key is None, get the first key.
+    ///
+    /// Called from syscall
+    fn get_next_key(&self, _key: Option<&[u8]>, _next_key: &mut [u8]) -> Result<()> {
+        Err(SystemError::ENOSYS)
+    }
+    /// Push an element value in map.
+    fn push_elem(&mut self, _value: &[u8], _flags: u64) -> Result<()> {
+        Err(SystemError::ENOSYS)
+    }
+    /// Pop an element value from map.
+    fn pop_elem(&mut self, _value: &mut [u8]) -> Result<()> {
+        Err(SystemError::ENOSYS)
+    }
+    /// Peek an element value from map.
+    fn peek_elem(&self, _value: &mut [u8]) -> Result<()> {
+        Err(SystemError::ENOSYS)
+    }
+    /// Freeze the map.
+    ///
+    /// It's useful for .rodata maps.
+    fn freeze(&self) -> Result<()> {
+        Err(SystemError::ENOSYS)
+    }
+    /// Get the first value pointer.
+    fn first_value_ptr(&self) -> *const u8 {
+        panic!("value_ptr not implemented")
+    }
+}
+```
+
+The system call that connects eBPF and kprobe is [`perf_event_open`](https://man7.org/linux/man-pages/man2/perf_event_open.2.html). This system call is very complex in Linux, so DragonOS does not implement it according to Linux. Currently, only two functions are supported:
+
+```rust
+match args.type_ {
+    // Kprobe
+    // See /sys/bus/event_source/devices/kprobe/type
+    perf_type_id::PERF_TYPE_MAX => {
+        let kprobe_event = kprobe::perf_event_open_kprobe(args);
+        Box::new(kprobe_event)
+    }
+    perf_type_id::PERF_TYPE_SOFTWARE => {
+        // For bpf prog output
+        assert_eq!(args.config, perf_sw_ids::PERF_COUNT_SW_BPF_OUTPUT);
+        assert_eq!(
+            args.sample_type,
+            Some(perf_event_sample_format::PERF_SAMPLE_RAW)
+        );
+        let bpf_event = bpf::perf_event_open_bpf(args);
+        Box::new(bpf_event)
+    }
+}
+```
+
+- One of them, `PERF_TYPE_SOFTWARE`, is used to create software-defined events, and `PERF_COUNT_SW_BPF_OUTPUT` ensures that this event is used to collect the output of bpf.
+- `PERF_TYPE_MAX` usually indicates the creation of kprobe/uprobe events, which is one of the ways users can use kprobe. Users can bind an eBPF program to this event.
+
+Similarly, different events of perf also implement the defined interface:
+
+```rust
+pub trait PerfEventOps: Send + Sync + Debug + CastFromSync + CastFrom {
+    fn mmap(&self, _start: usize, _len: usize, _offset: usize) -> Result<()> {
+        panic!("mmap not implemented for PerfEvent");
+    }
+    fn set_bpf_prog(&self, _bpf_prog: Arc<File>) -> Result<()> {
+        panic!("set_bpf_prog not implemented for PerfEvent");
+    }
+    fn enable(&self) -> Result<()> {
+        panic!("enable not implemented");
+    }
+    fn disable(&self) -> Result<()> {
+        panic!("disable not implemented");
+    }
+    fn readable(&self) -> bool {
+        panic!("readable not implemented");
+    }
+}
+```
+
+This interface is currently not stable.
+
+### Helper Function Support
+
+User-space tools communicate with the kernel through system calls to set up and exchange eBPF data. In the kernel, the execution of eBPF programs also requires the help of the kernel. A standalone eBPF program is not very useful, so it calls the kernel-provided `helper` functions to access kernel resources.
+
+Most of the currently supported `helper` functions are related to Map operations:
+
+```rust
+/// Initialize the helper functions.
+pub fn init_helper_functions() {
+    let mut map = BTreeMap::new();
+    unsafe {
+        // Map helpers::Generic map helpers
+        map.insert(1, define_func!(raw_map_lookup_elem));
+        map.insert(2, define_func!(raw_map_update_elem));
+        map.insert(3, define_func!(raw_map_delete_elem));
+        map.insert(164, define_func!(raw_map_for_each_elem));
+        map.insert(195, define_func!(raw_map_lookup_percpu_elem));
+        // map.insert(93,define_func!(raw_bpf_spin_lock);
+        // map.insert(94,define_func!(raw_bpf_spin_unlock);
+        // Map helpers::Perf event array helpers
+        map.insert(25, define_func!(raw_perf_event_output));
+        // Probe and trace helpers::Memory helpers
+        map.insert(4, define_func!(raw_bpf_probe_read));
+        // Print helpers
+        map.insert(6, define_func!(trace_printf));
+
+        // Map helpers::Queue and stack helpers
+        map.insert(87, define_func!(raw_map_push_elem));
+        map.insert(88, define_func!(raw_map_pop_elem));
+        map.insert(89, define_func!(raw_map_peek_elem));
+    }
+    BPF_HELPER_FUN_SET.init(map);
+}
+```

docs/locales/en/kernel/trace/index.rst

@@ -0,0 +1,24 @@
+.. note:: AI Translation Notice
+
+   This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+   - Source document: kernel/trace/index.rst
+
+   - Translation time: 2025-05-19 01:41:20
+
+   - Translation model: `Qwen/Qwen3-8B`
+
+
+   Please report issues via `Community Channel <https://github.com/DragonOS-Community/DragonOS/issues>`_
+
+Kernel Tracing Mechanism
+====================================
+
+   The kernel tracing mechanism consists of many functionalities, such as kprobe, uprobe, tracepoint, ftrace, and eBPF, which is used to extend the observability of the kernel. The kernel currently supports kprobe and eBPF. This chapter will introduce these two mechanisms.
+
+.. toctree::
+   :maxdepth: 1
+   :caption: Contents
+
+   eBPF
+   kprobe

docs/locales/en/kernel/trace/kprobe.md

@@ -0,0 +1,64 @@
+:::{note}
+**AI Translation Notice**
+
+This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+- Source document: kernel/trace/kprobe.md
+
+- Translation time: 2025-05-19 01:54:55
+
+- Translation model: `Qwen/Qwen3-8B`
+
+Please report issues via [Community Channel](https://github.com/DragonOS-Community/DragonOS/issues)
+
+:::
+
+# kprobe
+
+> Author: Chen Linfeng  
+> Email: chenlinfeng25@outlook.com
+
+## Overview
+
+The Linux kprobes debugging technology is a lightweight kernel debugging technique specifically designed by kernel developers to facilitate tracking the execution status of kernel functions. Using kprobes technology, kernel developers can dynamically insert probe points in most specified functions of the kernel to collect the required debugging status information, with minimal impact on the original execution flow of the kernel.
+
+The kprobes technology relies on hardware architecture support, mainly including CPU exception handling and single-step debugging mechanisms. The former is used to cause the program's execution flow to enter the user-registered callback function, while the latter is used for single-step execution of the probed instruction. It is worth noting that on some architectures, the hardware does not support the single-step debugging mechanism, which can be resolved through software simulation methods (such as RISC-V).
+
+## kprobe Workflow
+
+<img src="/kernel/trace/kprobe_flow.png" style="zoom: 67%;"  alt="xxx"/>
+
+1. After registering a kprobe, each registered kprobe corresponds to a kprobe structure, which records the location of the probe point and the original instruction at that location.
+2. The location of the probe point is replaced with an exception instruction. When the CPU executes to this location, it will enter an exception state. On x86_64, the instruction is int3 (if the kprobe is optimized, the instruction is jmp).
+3. When the exception instruction is executed, the system checks whether it is an exception installed by kprobe. If it is, the pre_handler of the kprobe is executed. Then, using the CPU's single-step debugging (single-step) feature, the relevant registers are set, and the next instruction is set to the original instruction at the probe point, returning from the exception state.
+4. The system enters the exception state again. The previous step has set the single-step related registers, so the original instruction is executed and the system will enter the exception state again. At this point, the single-step is cleared, and the post_handler is executed, and the system safely returns from the exception state.
+5. When unloading the kprobe, the original instruction at the probe point is restored.
+
+The kernel currently supports x86 and riscv64. Since riscv64 does not have a single-step execution mode, we use the break exception to simulate it. When saving the probe point instruction, we additionally fill in a break instruction, allowing the execution of the original instruction to trigger the break exception again on the riscv64 architecture.
+
+## kprobe Interfaces
+
+```rust
+pub fn register_kprobe(kprobe_info: KprobeInfo) -> Result<LockKprobe, SystemError>;
+pub fn unregister_kprobe(kprobe: LockKprobe) -> Result<(), SystemError>;
+
+impl KprobeBasic {
+    pub fn call_pre_handler(&self, trap_frame: &dyn ProbeArgs) 
+    pub fn call_post_handler(&self, trap_frame: &dyn ProbeArgs)
+    pub fn call_fault_handler(&self, trap_frame: &dyn ProbeArgs)
+    pub fn call_event_callback(&self, trap_frame: &dyn ProbeArgs) 
+    pub fn update_event_callback(&mut self, callback: Box<dyn CallBackFunc>) 
+    pub fn disable(&mut self) 
+    pub fn enable(&mut self) 
+    pub fn is_enabled(&self) -> bool
+    pub fn symbol(&self) -> Option<&str>
+}
+```
+
+- `call_pre_handler` Calls the user-defined callback function before the probe point instruction is executed.
+- `call_post_handler` Calls the user-defined callback function after the probe point instruction has been executed in single-step mode.
+- `call_fault_handler` Calls the user-defined callback function if the first two callback functions fail.
+- `call_event_callback` Used to call eBPF-related callback functions, usually called in the same way as `call_post_handler` after the probe point instruction is executed in single-step mode.
+- `update_event_callback` Used to update the callback function during runtime.
+- `disable` and `enable` are used to dynamically disable the kprobe. After calling `disable`, the kprobe will not execute the callback function when triggered.
+- `symbol` Returns the function name of the probe point.

docs/locales/en/userland/appdev/c-cpp-quick-start.md

@@ -0,0 +1,32 @@
+:::{note}
+**AI Translation Notice**
+
+This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+- Source document: userland/appdev/c-cpp-quick-start.md
+
+- Translation time: 2025-05-19 01:41:49
+
+- Translation model: `Qwen/Qwen3-8B`
+
+Please report issues via [Community Channel](https://github.com/DragonOS-Community/DragonOS/issues)
+
+:::
+
+# Developing C/C++ Applications for DragonOS
+
+## Compilation Environment
+
+  DragonOS has partial binary compatibility with Linux, so you can use the musl-gcc compiler from Linux. However, since DragonOS does not currently support dynamic linking, you need to add the compilation parameter `-static`.
+
+For example, you can use the following command:
+```shell
+musl-gcc -static -o hello hello.c
+```
+to compile a hello.c file.
+
+When porting existing programs, you may need to configure `CFLAGS`, `LDFLAGS`, and `CPPFLAGS` to ensure correct compilation. Please refer to the actual requirements.
+
+## Configuring DADK
+
+Please refer to: [Quick Start | DADK](https://docs.dragonos.org.cn/p/dadk/user-manual/quickstart.html)

docs/locales/en/userland/appdev/index.rst

@@ -0,0 +1,24 @@
+.. note:: AI Translation Notice
+
+   This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+   - Source document: userland/appdev/index.rst
+
+   - Translation time: 2025-05-19 02:13:34
+
+   - Translation model: `Qwen/Qwen3-8B`
+
+
+   Please report issues via `Community Channel <https://github.com/DragonOS-Community/DragonOS/issues>`_
+
+Application Development Documentation
+===================================================
+
+.. toctree::
+   :maxdepth: 1
+   :caption: Contents
+
+   rust-quick-start
+   c-cpp-quick-start
+   Quick Start to Package an Application to DragonOS Using DADK <https://docs.dragonos.org.cn/p/dadk/user-manual/quickstart.html>
+   DADK Complete Documentation <https://docs.dragonos.org.cn/p/dadk/>

docs/locales/en/userland/appdev/rust-quick-start.md

@@ -0,0 +1,51 @@
+:::{note}
+**AI Translation Notice**
+
+This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
+
+- Source document: userland/appdev/rust-quick-start.md
+
+- Translation time: 2025-05-19 01:41:52
+
+- Translation model: `Qwen/Qwen3-8B`
+
+Please report issues via [Community Channel](https://github.com/DragonOS-Community/DragonOS/issues)
+
+:::
+
+# Quick Start Guide for Rust Application Development
+
+## Compilation Environment
+
+  DragonOS has partial binary compatibility with Linux, so you can use the Rust compiler for Linux to compile.
+
+## Project Configuration
+
+### Creating from a Template
+
+:::{note}
+This feature requires dadk version 0.2.0 or higher. For older versions, please refer to the historical DragonOS documentation.
+:::
+
+1. Use the `bootstrap.sh` script in the tools directory of DragonOS to initialize the environment.
+2. Enter `cargo install cargo-generate` in the terminal.
+3. Enter the following command in the terminal:
+
+```shell
+cargo generate --git https://github.com/DragonOS-Community/Rust-App-Template
+```
+To create the project. If your network is slow, please use a mirror site.
+```shell
+cargo generate --git https://git.mirrors.dragonos.org/DragonOS-Community/Rust-App-Template
+```
+
+4. Use `cargo run` to run the project.
+5. In the `user/dadk/config` directory of DragonOS, refer to the template [userapp_config.toml](https://github.com/DragonOS-Community/DADK/blob/main/dadk-config/templates/config/userapp_config.toml) to create a compilation configuration, and install it to the `/` directory of DragonOS.
+(When using the compilation command options of dadk, please use the `make install` configuration in the Makefile for compilation and installation)
+6. Compile DragonOS to install.
+
+### Manual Configuration
+
+If you need to port other libraries or programs to DragonOS, please refer to the configuration in the template.
+
+Since DragonOS currently does not support dynamic linking, you need to specify `-C target-feature=+crt-static -C link-arg=-no-pie` in RUSTFLAGS.

docs/requirements.txt

@@ -3,3 +3,5 @@ myst-parser==0.18.0
 sphinx-rtd-theme
 sphinxcontrib-mermaid==1.0.0
 git+https://git.mirrors.dragonos.org.cn/DragonOS-Community/sphinx-multiversion.git@5858b75#egg=sphinx-multiversion
+openai~=1.79
+tqdm~=4.65.0

docs/userland/appdev/index.rst

@@ -1,5 +1,5 @@
 应用程序开发文档
-====================================
+===================================================
 
 
 .. toctree::

tools/doc_translator.py

@@ -0,0 +1,467 @@
+#!/usr/bin/env python3
+"""
+DragonOS文档自动翻译工具
+Usage:
+在DragonOS源码根目录下运行此脚本。
+
+需要先进入docs目录，执行命令安装依赖包。
+pip install -r requirements.txt
+
+接着先声明以下变量：
+export OPENAI_API_KEY=your_api_key
+export OPENAI_MODEL=your_model_name (推荐qwen3的4b以上的)
+export OPENAI_BASE_URL=your_openai_base_url
+export MAX_WORKERS=your_max_workers (推荐2-20)
+
+然后运行：
+python3 tools/doc_translator.py
+"""
+
+import os
+import re
+import hashlib
+import json
+from pathlib import Path
+import threading
+from typing import List, Dict, Tuple
+import openai
+import datetime
+import time
+
+from tqdm import tqdm
+
+# 配置
+
+
+def get_env_var(name, required=False, default=None):
+    """从环境变量获取配置"""
+    value = os.getenv(name, default)
+    if required and not value:
+        raise ValueError(f"环境变量 {name} 未设置")
+    return value
+
+
+CONFIG = {
+    "source_dir": "docs",  # 源文档目录
+    "target_languages": {
+        "en": "English",
+    },
+    "dirs_exclude": ["_build", "locales"],  # 排除的目录
+    "model": get_env_var("OPENAI_MODEL", default="qwen3:4b"),  # 模型名称
+    # API地址
+    "base_url": get_env_var("OPENAI_BASE_URL", default="http://localhost:11434/v1"),
+    "chunk_size": 1000,  # 分块大小(tokens)
+    "cache_file": "docs/.translation_cache.json",  # 翻译缓存文件
+    "max_workers": int(get_env_var("MAX_WORKERS", default="1")),  # 并行工作数
+    # 元数据模板
+    "meta_templates": {
+        ".rst": (
+            ".. note:: AI Translation Notice\n\n"
+            "   This document was automatically translated by `{model}` model, for reference only.\n\n"
+            "   - Source document: {original_path}\n\n"
+            "   - Translation time: {timestamp}\n\n"
+            "   - Translation model: `{model}`\n\n"
+            "\n   Please report issues via `Community Channel <https://github.com/DragonOS-Community/DragonOS/issues>`_\n\n"
+        ),
+        ".md": (
+            ":::{note}\n"
+            "**AI Translation Notice**\n\n"
+            "This document was automatically translated by `{model}` model, for reference only.\n\n"
+            "- Source document: {original_path}\n\n"
+            "- Translation time: {timestamp}\n\n"
+            "- Translation model: `{model}`\n\n"
+            "Please report issues via [Community Channel](https://github.com/DragonOS-Community/DragonOS/issues)\n\n"
+            ":::\n\n"
+        )
+    }
+}
+
+
+class LabelManager:
+    """管理文档标签和引用"""
+
+    def __init__(self, lang: str):
+        self.label_map = {}
+        self.prefix = "_translated_label_"
+        self.lang = lang
+
+    def register_label(self, original_label: str) -> str:
+        """注册新标签并返回映射后的标签"""
+        if original_label not in self.label_map:
+            new_label = f"{self.prefix}_{original_label}_{self.lang}"
+            self.label_map[original_label] = new_label
+        return self.label_map[original_label]
+
+    def get_all_labels(self) -> Dict[str, str]:
+        """获取所有标签映射"""
+        return self.label_map
+
+
+class DocumentTranslator:
+    def __init__(self):
+        self._cache_lock = threading.Lock()
+        self._cache = self._load_cache()
+        self.fail_count = 0
+        try:
+            self.client = openai.OpenAI(
+                base_url=CONFIG["base_url"],
+                # 这是故意把key的获取写在这里的。防止哪个二货直接print CONFIG导致key泄露。
+                api_key=get_env_var("OPENAI_API_KEY", default="ollama"),
+            )
+        except Exception as e:
+            raise RuntimeError(f"OpenAI客户端初始化失败: {str(e)}")
+
+    def _load_cache(self) -> Dict:
+        """加载翻译缓存"""
+        if os.path.exists(CONFIG["cache_file"]):
+            with open(CONFIG["cache_file"], "r", encoding="utf-8") as f:
+                try:
+                    return json.load(f)
+                except json.JSONDecodeError:
+                    pass
+        return {}
+
+    def _save_cache(self):
+        """保存翻译缓存"""
+        with self._cache_lock:
+            with open(CONFIG["cache_file"], "w", encoding="utf-8") as f:
+                json.dump(self._cache, f, ensure_ascii=False, indent=2)
+
+    def _get_cache_key(self, filepath: str, lang: str) -> str:
+        """生成缓存键(包含语言代码)"""
+        rel_path = os.path.relpath(filepath, CONFIG["source_dir"])
+        return f"{lang}:{rel_path}"
+
+    def _split_into_chunks(self, text: str) -> List[str]:
+        """将文本分块"""
+        # 按段落分割
+        paragraphs = re.split(r"\n\s*\n", text)
+        chunks = []
+        current_chunk = []
+        current_size = 0
+        for para in paragraphs:
+            para_size = len(para.split())
+            if current_size + para_size > CONFIG["chunk_size"] and current_chunk:
+                chunks.append("\n\n".join(current_chunk))
+                current_chunk = []
+                current_size = 0
+            current_chunk.append(para)
+            current_size += para_size
+
+        if current_chunk:
+            chunks.append("\n\n".join(current_chunk))
+
+        return chunks
+
+    def _process_rst_labels(self, text: str, label_manager: LabelManager) -> str:
+        """处理reStructuredText标签"""
+        def replace_label(match):
+            original_label = match.group(1)
+            new_label = label_manager.register_label(original_label)
+            return f'.. {new_label}:'
+
+        # 处理标签定义
+        text = re.sub(r'\.\.\s+_([^:]+):', replace_label, text)
+        # 处理标签引用
+        text = re.sub(r'(?<!\w)`([^`]+)`(?!\w)',
+                      lambda m: f'`{label_manager.register_label(m.group(1))}`',
+                      text)
+        return text
+
+    def _process_md_labels(self, text: str, label_manager: LabelManager) -> str:
+        """处理Markdown标签"""
+        # 处理显式标签定义 {#label}
+        text = re.sub(r'\{#([^}]+)\}',
+                      lambda m: f'{{#{label_manager.register_label(m.group(1))}}}',
+                      text)
+
+        # 处理显式标签定义 (label)=
+        text = re.sub(r'\(([^)]+)\)=',
+                      lambda m: f'({label_manager.register_label(m.group(1))})=',
+                      text)
+
+        # 处理标签引用 [text](#label)
+        text = re.sub(r'\[([^\]]+)\]\(#([^)]+)\)',
+                      lambda m: f'[{m.group(1)}](#{label_manager.register_label(m.group(2))})',
+                      text)
+
+        # 处理裸标签引用 #label
+        text = re.sub(r'(?<!\w)#([\w-]+)(?!\w)',
+                      lambda m: f'#{label_manager.register_label(m.group(1))}',
+                      text)
+
+        return text
+
+    def _generate_unique_label_for_lang(self, text: str, lang: str) -> str:
+        # 处理标签
+
+        label_manager = LabelManager(lang)
+        text = self._process_rst_labels(text, label_manager)
+        text = self._process_md_labels(text, label_manager)
+        return text
+
+    def _preserve_special_format(self, text: str) -> Tuple[str, Dict]:
+        """保留特殊格式"""
+        preserved = {}
+
+        # 排除不需要翻译的块
+        exclude_blocks = re.findall(
+            r'\.\. Note: __EXCLUDE_IN_TRANSLATED_START.*?\.\. Note: __EXCLUDE_IN_TRANSLATED_END',
+            text, re.DOTALL)
+        for block in exclude_blocks:
+            text = text.replace(block, '')
+
+        # 处理多行代码块
+        code_blocks = re.findall(r"```.*?\n.*?```", text, re.DOTALL)
+        for i, block in enumerate(code_blocks):
+            placeholder = f"__CODE_BLOCK_{i}__"
+            preserved[placeholder] = block
+            text = text.replace(block, placeholder)
+        # 处理内联代码块
+        inline_code = re.findall(r"`[^`]+`", text)
+        for i, code in enumerate(inline_code):
+            placeholder = f"__INLINE_CODE_{i}__"
+            preserved[placeholder] = code
+            text = text.replace(code, placeholder)
+
+        return text, preserved
+
+    def _restore_special_format(self, text: str, preserved: Dict) -> str:
+        """恢复特殊格式"""
+        # 先恢复内联代码块
+        for placeholder, content in preserved.items():
+            if placeholder.startswith("__INLINE_CODE_"):
+                text = text.replace(placeholder, content)
+
+        # 然后恢复多行代码块
+        for placeholder, content in preserved.items():
+            if placeholder.startswith("__CODE_BLOCK_"):
+                text = text.replace(placeholder, content)
+
+        return text
+
+    def _remove_thinking(self, text: str) -> str:
+        """Remove <think> tags from text"""
+        return re.sub(r'<think>.*?</think>', '', text, flags=re.DOTALL)
+
+    def _translate_chunk(self, args: Tuple[str, str]) -> str:
+        """翻译单个文本块(内部方法，用于并行处理)"""
+        chunk, lang = args
+        retry = 3
+        while retry > 0:
+            try:
+                lang_name = CONFIG["target_languages"].get(lang, "English")
+                prompt = f"你是一个专业的文档翻译助手，请将以下中文技术文档准确翻译成{lang_name}，保持技术术语的正确性和格式不变。"
+
+                # disable qwen3's thinking mode
+                if "qwen3" in CONFIG["model"].lower():
+                    prompt += "\n/no_think\n"
+                    chunk += "\n/no_think\n"
+
+                response = self.client.chat.completions.create(
+                    extra_body={"enable_thinking": False},
+                    model=CONFIG["model"],
+                    messages=[
+                        {"role": "system", "content": prompt},
+                        {"role": "user", "content": chunk}
+                    ],
+                    temperature=0.3,
+                )
+                content = response.choices[0].message.content
+                return self._remove_thinking(content)
+            except Exception as e:
+                retry -= 1
+                if retry == 0:
+                    print("翻译失败: {e}，放弃重试。")
+                    return None
+
+                print(f"翻译出错: {e}, retrying... ({retry})")
+                time.sleep(2)
+
+    def translate_text(self, text: str, lang: str) -> str:
+        """使用openai接口翻译文本
+        Args:
+            text: 要翻译的文本
+            lang: 目标语言代码
+        """
+        chunks = self._split_into_chunks(text)
+        translated_chunks = []
+
+        for chunk in chunks:
+            translated_chunk = self._translate_chunk((chunk, lang))
+            if translated_chunk:
+                translated_chunks.append(translated_chunk)
+
+        return "\n\n".join(translated_chunks)
+
+    def process_file(self, filepath: str, lang: str = "en"):
+        """处理单个文件
+        Args:
+            filepath: 源文件路径
+            lang: 目标语言代码 (默认'en')
+        """
+        rel_path = os.path.relpath(filepath, CONFIG["source_dir"])
+        target_path = os.path.join(
+            CONFIG["source_dir"], "locales", lang, rel_path)
+
+        # 检查文件是否已存在且未修改
+        cache_key = self._get_cache_key(filepath, lang)
+        file_hash = hashlib.md5(open(filepath, "rb").read()).hexdigest()
+        target_file_exists = os.path.exists(target_path)
+        with self._cache_lock:
+            if cache_key in self._cache and self._cache[cache_key]["hash"] == file_hash and target_file_exists:
+                print(f"文件未修改，跳过: {rel_path} (语言: {lang})")
+                return
+
+        print(f"正在处理: {rel_path}")
+
+        # 读取文件内容
+        with open(filepath, "r", encoding="utf-8") as f:
+            content = f.read()
+
+        # 保留特殊格式
+        content, preserved = self._preserve_special_format(content)
+
+        content = self._generate_unique_label_for_lang(content, lang)
+
+        # 分块翻译
+        translated_content = self.translate_text(
+            content, lang)
+        if not translated_content:
+            print(f"翻译失败！{filepath}")
+            self.fail_count += 1
+            return
+
+        # 恢复特殊格式
+        translated_content = self._restore_special_format(
+            translated_content, preserved)
+
+        # 创建目标目录
+        os.makedirs(os.path.dirname(target_path), exist_ok=True)
+
+        # 写入翻译结果
+        with open(target_path, "w", encoding="utf-8") as f:
+            # 添加翻译元数据
+            file_ext = os.path.splitext(filepath)[1]
+            template = CONFIG["meta_templates"].get(file_ext, "")
+
+            if template:
+                timestamp = datetime.datetime.now().strftime("%Y-%m-%d %H:%M:%S")
+                original_path = os.path.relpath(filepath, CONFIG["source_dir"])
+                meta_content = template.format(
+                    note="{note}",
+                    model=CONFIG["model"],
+                    timestamp=timestamp,
+                    original_name=os.path.basename(filepath),
+                    original_path=original_path
+                )
+                translated_content = meta_content + translated_content
+
+            f.write(translated_content)
+            f.write("\n")
+
+        # 更新缓存
+        with self._cache_lock:
+            self._cache[cache_key] = {
+                "hash": file_hash,
+            }
+
+        self._save_cache()
+
+        print(f"文件 {rel_path} 已成功翻译为 {lang} 并保存到 {target_path}")
+
+    def add_language_root_title(self, lang):
+        """为每个语言的文档添加标题"""
+        lang_root_doc_path = os.path.join(
+            CONFIG["source_dir"], "locales", lang, "index.rst")
+
+        if not os.path.exists(lang_root_doc_path):
+            raise FileNotFoundError(f"未找到 {lang} 的标题文件: {lang_root_doc_path}")
+        print(f"正在为 {CONFIG['target_languages'][lang]} 添加标题...")
+
+        # Read existing content first
+        with open(lang_root_doc_path, "r", encoding="utf-8") as f:
+            content = f.read()
+
+        lang_v = CONFIG["target_languages"][lang]
+        if content.startswith(lang_v):
+            print(f"{lang_v} 的标题已存在，跳过...")
+            return
+
+        # Then write new content (this clears the file)
+        with open(lang_root_doc_path, "w", encoding="utf-8") as f:
+            f.write(
+                f"{lang_v}\n==========================================\n{content}")
+
+        print(f"标题已添加到 {lang_root_doc_path}")
+
+    def run(self):
+        """运行翻译流程"""
+
+        print("Collecting all files...")
+        all_files = []
+        for root, dirs, files in os.walk(CONFIG["source_dir"], topdown=True):
+            # 只在根目录应用排除逻辑
+            if root == CONFIG["source_dir"]:
+                dirs[:] = [d for d in dirs if d not in CONFIG["dirs_exclude"]]
+            for file in files:
+                if file.endswith((".rst", ".md")):
+                    all_files.append(os.path.join(root, file))
+        total_files = len(all_files)
+        print(
+            f"Total {total_files} files to translate in {len(CONFIG['target_languages'])} languages.")
+        total_tasks = total_files * len(CONFIG["target_languages"])
+
+        # 外层进度条：语言
+        lang_pbar = tqdm(CONFIG["target_languages"].items(),
+                         desc="Overall progress",
+                         unit="lang",
+                         position=0)
+
+        for lang_k, lang_v in lang_pbar:
+            lang_pbar.set_description(f"Translating to {lang_v}")
+
+            # 并行处理文件
+            from concurrent.futures import ThreadPoolExecutor, as_completed
+
+            # 包装处理函数便于调试之类的
+
+            def process_file_wrapper(file_path):
+                self.process_file(file_path, lang_k)
+                return file_path
+
+            # 创建线程池
+            with ThreadPoolExecutor(max_workers=CONFIG["max_workers"]) as executor:
+                # 提交所有文件处理任务
+                futures = [executor.submit(
+                    process_file_wrapper, path) for path in all_files]
+
+                # 创建进度条
+                file_pbar = tqdm(total=len(all_files),
+                                 desc=f"Files in {lang_v}",
+                                 unit="file",
+                                 position=1,
+                                 leave=False)
+
+                # 更新进度条
+                for future in as_completed(futures):
+                    file_pbar.update(1)
+                    future.result()  # 获取结果（如果有异常会在这里抛出）
+
+                file_pbar.close()
+            self.add_language_root_title(lang_k)
+
+        lang_pbar.close()
+        print(
+            f"\n翻译完成！ Succ: {total_tasks-self.fail_count}, Fail: {self.fail_count}")
+
+
+if __name__ == "__main__":
+    print("Starting translation process...")
+    print("WORKERS: ", CONFIG["max_workers"])
+    print("LANGUAGES: ", CONFIG["target_languages"])
+    print("SOURCE_DIR: ", CONFIG["source_dir"])
+    print("MODEL: ", CONFIG["model"])
+
+    translator = DocumentTranslator()
+    translator.run()