Skip to content

Commit a69dad1

Browse files
Update translated documentation (#1408)
1 parent 9420fe0 commit a69dad1

File tree

2 files changed

+18
-19
lines changed

2 files changed

+18
-19
lines changed

docs/.translation_cache.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -294,7 +294,7 @@
294294
"hash": "52df04d6a276b42617f7b79bbbffa61e"
295295
},
296296
"en:kernel/ktest/gvisor_syscall_test.rst": {
297-
"hash": "bfa0b1f0bcb791573c73670df23cbb32"
297+
"hash": "60cc96606ccd50bb3e669b378693b742"
298298
},
299299
"en:kernel/syscall/sys_capget_capset.md": {
300300
"hash": "f3b86c00e9f28df5c0e6c15905e53907"

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

Lines changed: 17 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44

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

7-
- Translation time: 2025-10-09 14:36:26
7+
- Translation time: 2025-11-25 16:01:36
88

99
- Translation model: `hunyuan-turbos-latest`
1010

@@ -20,26 +20,26 @@ DragonOS integrates the gVisor system call test suite to verify the compatibilit
2020
Overview
2121
========
2222

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.
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 implementations comply with Linux standards.
2424

2525
Key Features:
2626

2727
- **Comprehensive Test Coverage**: Contains hundreds of system call test cases
2828
- **Whitelist Mechanism**: By default, only verified tests are executed, with support gradually expanding
2929
- **Blacklist Filtering**: Allows blocking specific test cases for each test program
30-
- **Automated Execution**: Provides Makefile and scripts to simplify the testing process
30+
- **Automated Execution**: Provides Makefiles and scripts to simplify the testing process
3131

3232
Automated Testing
3333
==========
3434

35-
Execute the `make test-syscall` command. This command will launch DragonOS and automatically execute the gvisor syscall test suite. After testing completes, it will exit qemu. The return status will be success or failure based on the test case success rate - returning failure if the success rate is not 100%. The execution flow of this command is as follows:
35+
Execute the `make test-syscall` command. This command will launch DragonOS and automatically execute the gvisor syscall test suite. After testing completes, it will exit qemu. The command will return success or failure based on the test case success rate - returning failure if the success rate is not 100%. The execution flow of this command is as follows:
3636

37-
1. Execute the configuration in `enable_compile_gvisor.sh` comment `app-blocklist.toml` regarding blocking the gvisor test suite
37+
1. Execute `toggle_compile_gvisor.sh enable` to comment out the gvisor test suite-related blocking configurations in `app-blocklist.toml`
3838
2. Compile DragonOS
3939
3. Write the image
40-
4. Start DragonOS in qemu background mode (without graphics), while setting environment variables `AUTO_TEST` (auto-test option, currently only supports syscall testing) and `SYSCALL_TEST_DIR` (test suite directory). These environment variables will be passed to DragonOS as command-line parameters. Then when the busybox init process executes the rcS script, this script will execute the corresponding test through the `AUTO_TEST` option
41-
5. Execute `monitor_test_results.sh` to periodically check the qemu serial output content and determine success or failure return based on test results
42-
6. Execute `disable_compile_gvisor.sh` to uncomment the configuration in `app-blocklist.toml` regarding blocking the gvisor test suite
40+
4. Start DragonOS in the background in qemu's non-graphical mode, while setting environment variables `AUTO_TEST` (auto-test option, currently only supports syscall testing) and `SYSCALL_TEST_DIR` (directory where the test suite is located). These two environment variables will be passed to DragonOS as command-line parameters. Then, when the busybox init process executes the rcS script, this script will execute the corresponding tests through the `AUTO_TEST` option
41+
5. Execute `monitor_test_results.sh` to periodically check the qemu serial port output content and determine whether to return success or failure based on the test results
42+
6. Execute `toggle_compile_gvisor.sh disable` to uncomment the relevant configurations in `app-blocklist.toml`, restoring the default blocking state
4343

4444
The corresponding workflow configuration file is `test-x86.yml`
4545

@@ -52,22 +52,21 @@ Manual Testing
5252
5353
cd user/apps/tests/syscall/gvisor
5454
55-
2. Run whitelist tests on Linux (automatically downloads the test suite):
55+
2. Run whitelist tests in Linux (automatically downloads the test suite):
5656

5757
.. code-block:: bash
5858
5959
make test
6060
61-
3. If you need to run tests, first modify the configuration file:
61+
3. If you need to run tests, you can quickly modify configurations via scripts:
6262

63-
Edit `config/app-blocklist.toml`, and comment out the following content:
63+
.. code-block:: bash
6464
65-
.. code-block:: toml
65+
# Enable gVisor testing (comment out blocklist configurations)
66+
bash user/apps/tests/syscall/gvisor/toggle_compile_gvisor.sh enable
6667
67-
# Block gvisor system call tests
68-
# [[blocked_apps]]
69-
# name = "gvisor syscall tests"
70-
# reason = "Blocked due to large file size. To allow system call tests, uncomment these lines"
68+
# Restore default blocking after testing
69+
bash user/apps/tests/syscall/gvisor/toggle_compile_gvisor.sh disable
7170
7271
4. Run tests within the DragonOS system:
7372

@@ -90,12 +89,12 @@ Testing Mechanism
9089
Whitelist Mode
9190
-----------
9291

93-
The test framework enables whitelist mode by default, running only the test programs specified in `_translated_label__`whitelist.txt`_en`. This allows for gradual verification of DragonOS's system call implementations.
92+
The test framework enables whitelist mode by default, running only the test programs specified in `_translated_label__`whitelist.txt`_en`. This allows for gradual validation of DragonOS's system call implementations.
9493

9594
Blacklist Filtering
9695
-----------
9796

98-
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 unsupported or unstable tests.
97+
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.
9998

10099
More Detailed Information
101100
==============

0 commit comments

Comments
 (0)