Skip to content

Commit bd4d6b8

Browse files
Update translated documentation (#1290)
1 parent e1db32e commit bd4d6b8

File tree

3 files changed

+103
-9
lines changed

3 files changed

+103
-9
lines changed

docs/.translation_cache.json

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -63,7 +63,7 @@
6363
"hash": "52dd12d566da2003602ee21c4a3d007f"
6464
},
6565
"en:kernel/ktest/index.rst": {
66-
"hash": "5a4565952877c82b9a0ed3b67103c141"
66+
"hash": "91a6018265b0505ee81ba83c0a7a172a"
6767
},
6868
"en:kernel/filesystem/vfs/api.md": {
6969
"hash": "1b0b3fe0cc2918cc2c53a5af392a96ff"
@@ -292,5 +292,8 @@
292292
},
293293
"en:kernel/ipc/ipc_namespace.md": {
294294
"hash": "52df04d6a276b42617f7b79bbbffa61e"
295+
},
296+
"en:kernel/ktest/gvisor_syscall_test.rst": {
297+
"hash": "019ff2a7240a60e49be0633625da88f6"
295298
}
296299
}
Lines changed: 91 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,91 @@
1+
.. note:: AI Translation Notice
2+
3+
This document was automatically translated by `hunyuan-turbos-latest` model, for reference only.
4+
5+
- Source document: kernel/ktest/gvisor_syscall_test.rst
6+
7+
- Translation time: 2025-09-24 08:27:04
8+
9+
- Translation model: `hunyuan-turbos-latest`
10+
11+
12+
Please report issues via `Community Channel <https://github.com/DragonOS-Community/DragonOS/issues>`_
13+
14+
==============================
15+
gVisor System Call Testing
16+
==============================
17+
18+
DragonOS integrates the gVisor system call test suite to verify the compatibility and correctness of the operating system's system call implementation.
19+
20+
Overview
21+
========
22+
23+
gVisor is a container runtime sandbox developed by Google, which includes a comprehensive set of system call compatibility tests. These tests are designed to validate whether an operating system's system call implementation complies with Linux standards.
24+
25+
Key Features:
26+
27+
- **Comprehensive Test Coverage**: Contains hundreds of system call test cases
28+
- **Whitelist Mechanism**: By default, only verified tests are executed, with support gradually expanding
29+
- **Blacklist Filtering**: Allows blocking specific test cases for each test program
30+
- **Automated Execution**: Provides Makefiles and scripts to simplify the testing process
31+
32+
Quick Start
33+
==========
34+
35+
1. Navigate to the test directory:
36+
37+
.. code-block:: bash
38+
39+
cd user/apps/tests/syscall/gvisor
40+
41+
2. Run whitelist tests on Linux (automatically downloads the test suite):
42+
43+
.. code-block:: bash
44+
45+
make test
46+
47+
3. If you need to run the tests, first modify the configuration file:
48+
49+
Edit `config/app-blocklist.toml`, and comment out the following content:
50+
51+
.. code-block:: toml
52+
53+
# Block gvisor system call tests
54+
# [[blocked_apps]]
55+
# name = "gvisor syscall tests"
56+
# reason = "Blocked due to large file size. To enable system call tests, uncomment these lines"
57+
58+
4. Run the tests within the DragonOS system:
59+
60+
Navigate to the installation directory and execute the test program:
61+
62+
.. code-block:: bash
63+
64+
cd /opt/tests/gvisor
65+
./gvisor-test-runner --help
66+
67+
Use `_translated_label__`./gvisor-test-runner`_en` to run specific test cases.
68+
69+
5. View detailed documentation:
70+
71+
Refer to `user/apps/tests/syscall/gvisor/README.md` for complete usage instructions.
72+
73+
Testing Mechanism
74+
==========
75+
76+
Whitelist Mode
77+
-----------
78+
79+
The test framework defaults to whitelist mode, executing only the test programs specified in `_translated_label__`whitelist.txt`_en`. This allows for gradual validation of DragonOS's system call implementation.
80+
81+
Blacklist Filtering
82+
-----------
83+
84+
For each test program, specific test cases can be blocked through files in the `_translated_label__`blocklists/`_en` directory. This is particularly useful for skipping tests that are not yet supported or are unstable.
85+
86+
More Details
87+
==============
88+
89+
For detailed usage instructions, configuration options, and development guides regarding gVisor system call testing, please consult the README.md document in the test directory:
90+
91+
- Documentation Location: `user/apps/tests/syscall/gvisor/README.md`
Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
11
.. note:: AI Translation Notice
22

3-
This document was automatically translated by `Qwen/Qwen3-8B` model, for reference only.
3+
This document was automatically translated by `hunyuan-turbos-latest` model, for reference only.
44

55
- Source document: kernel/ktest/index.rst
66

7-
- Translation time: 2025-05-19 01:41:16
7+
- Translation time: 2025-09-24 08:26:52
88

9-
- Translation model: `Qwen/Qwen3-8B`
9+
- Translation model: `hunyuan-turbos-latest`
1010

1111

1212
Please report issues via `Community Channel <https://github.com/DragonOS-Community/DragonOS/issues>`_
@@ -15,12 +15,12 @@
1515
Kernel Testing
1616
====================================
1717

18-
This chapter will introduce how to test the kernel, including manual testing and automated testing.
18+
This chapter introduces how to test the kernel, including both manual and automated testing.
1919

20-
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.
20+
We need to conduct as comprehensive testing of the kernel as possible to better ensure its stability and reduce the debugging difficulty of other modules.
2121

22-
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.
22+
Establishing well-designed test cases helps us detect issues as much as possible, preventing us from being "ambushed" by deeply hidden bugs in existing modules when developing new ones.
2323

24-
Since it is difficult to debug using tools like GDB, manual testing in the kernel is more challenging compared to testing applications.
24+
Since it is difficult to debug using tools like GDB, manual testing in the kernel is more challenging than application testing.
2525

26-
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.
26+
For some modules, we can write code for unit testing and output exception information. Unfortunately, not all modules can be unit tested. For example, common modules like memory management and process management cannot be unit tested.

0 commit comments

Comments
 (0)