udpate chapter-[34568] exercise info

2026-05-05 11:40:45 +08:00 · 2022-07-03 10:50:10 +08:00
parent 1a56e44032
commit a647afe244
5 changed files with 227 additions and 5 deletions
--- a/guide/source/chapter3/5exercise.rst
+++ b/guide/source/chapter3/5exercise.rst
@@ -60,7 +60,9 @@ ch3 中，我们的系统已经能够支持多个任务分时轮流运行，我
   ├── ...


- 通过所有测例：
+- 开发并通过所有测例：
+
+   在 ``YOUR_LAB1_REPO_DIR`` 下进行编码（可学习参考 ``os3-ref/src`` 目录下的源代码，并在 ``os3/src`` 中完成编码），并进行编译测试。

   CI 使用的测例与本地相同，测试中，user 文件夹及其它与构建相关的文件将被替换，请不要试图依靠硬编码通过测试。

@@ -68,14 +70,14 @@ ch3 中，我们的系统已经能够支持多个任务分时轮流运行，我
   你需要在编译时指定 ``BASE=0`` 控制框架仅编译实验测例（在 os 目录执行 ``make run BASE=0``），
   或指定 ``BASE=2`` 控制框架同时编译基础测例和实验测例。

-
+   
 .. note::

   **测试方式**

   你的实现只需且必须通过测例，建议读者感到困惑时先检查测例
   
-   如果实现正确，可在项目仓库的根目录下执行 ``make test3`` ，应该看到如显示输出：
+   如果实现正确，可在项目仓库的根目录下执行 ``make test3`` ，应该看到类似如下的显示输出：

   .. code-block:: console
   
--- a/guide/source/chapter4/7exercise.rst
+++ b/guide/source/chapter4/7exercise.rst
@@ -66,6 +66,68 @@ tips:

 TIPS：注意 port 参数的语义，它与内核定义的 MapPermission 有明显不同！

+- 开发并通过所有测例
+
+在 ``YOUR_LAB2_REPO_DIR`` 下进行编码（可学习参考 ``os4-ref/src`` 目录下的源代码，并在 ``os4/src`` 中完成编码），并进行编译测试。
+
+.. note::
+
+   **测试方式**
+
+   你的实现只需且必须通过测例，建议读者感到困惑时先检查测例
+   
+   如果实现正确，可在项目仓库的根目录下执行 ``make test4`` ，应该看到类似如下的显示输出：
+
+   .. code-block:: console
+   
+      $ cd  YOUR_LAB2_REPO_DIR
+      $ make test4
+      ......
+      [rustsbi] RustSBI version 0.2.2, adapting to RISC-V SBI v1.0.0
+      .______       __    __      _______.___________.  _______..______   __
+      |   _  \     |  |  |  |    /       |           | /       ||   _  \ |  |
+      |  |_)  |    |  |  |  |   |   (----`---|  |----`|   (----`|  |_)  ||  |
+      |      /     |  |  |  |    \   \       |  |      \   \    |   _  < |  |
+      |  |\  \----.|  `--'  |.----)   |      |  |  .----)   |   |  |_)  ||  |
+      | _| `._____| \______/ |_______/       |__|  |_______/    |______/ |__|
+      [rustsbi] Implementation     : RustSBI-QEMU Version 0.1.1
+      [rustsbi] Platform Name      : riscv-virtio,qemu
+      [rustsbi] Platform SMP       : 1
+      [rustsbi] Platform Memory    : 0x80000000..0x88000000
+      [rustsbi] Boot HART          : 0
+      [rustsbi] Device Tree Region : 0x87000000..0x87000ef2
+      [rustsbi] Firmware Address   : 0x80000000
+      [rustsbi] Supervisor Address : 0x80200000
+      [rustsbi] pmp01: 0x00000000..0x80000000 (-wr)
+      [rustsbi] pmp02: 0x80000000..0x80200000 (---)
+      [rustsbi] pmp03: 0x80200000..0x88000000 (xwr)
+      ......
+      [PASS] found <Hello, world from user mode program!>
+      [PASS] found <Test power_3 OK29777!>
+      [PASS] found <Test power_5 OK29777!>
+      [PASS] found <Test power_7 OK29777!>
+      [PASS] found <get_time OK29777! (\d+)>
+      [PASS] found <Test sleep OK29777!>
+      [PASS] found <current time_msec = (\d+)>
+      [PASS] found <time_msec = (\d+) after sleeping (\d+) ticks, delta = (\d+)ms!>
+      [PASS] found <Test sleep1 passed29777!>
+      [PASS] found <Test write A OK29777!>
+      [PASS] found <Test write B OK29777!>
+      [PASS] found <Test write C OK29777!>
+      [PASS] found <string from task info test>
+      [PASS] found <Test task info OK29777!>
+      [PASS] found <Test 04_1 OK29777!>
+      [PASS] found <Test 04_4 test OK29777!>
+      [PASS] found <Test 04_5 ummap OK29777!>
+      [PASS] found <Test 04_6 ummap2 OK29777!>
+      [PASS] not found <FAIL: T.T>
+      [PASS] not found <Should cause error, Test 04_2 fail!>
+      [PASS] not found <Should cause error, Test 04_3 fail!>
+
+      Test passed29777: 21/21
+      Report for lab1 found.
+      Report for lab2 found.
+
 - 提交你的修改

   - 如果是基于GitHub Classroom 开发, 在本地环境或在线codespaces环境下，执行 ``git push`` 命令，提交修改的代码到gitub进行CI自动评测。如果评测结果是 红色小叉 （位于repo的中上位置），可进一步点击红色小叉查找具体出错时的CI执行情况。 
--- a/guide/source/chapter5/4exercise.rst
+++ b/guide/source/chapter5/4exercise.rst
@@ -87,9 +87,60 @@ BigStride 表示一个预先定义的大常数，则该调度方案为每个进

  从本章开始，你的内核必须前向兼容，能通过前一章的所有测例。

+- 开发并通过所有测例
+
+在 ``YOUR_LAB3_REPO_DIR`` 下进行编码（可学习参考 ``os5-ref/src`` 目录下的源代码，并在 ``os5/src`` 中完成编码），并进行编译测试。
+
 .. note::

-    利用 ``git cherry-pick`` 系列指令，能方便地将前一章分支 commit 移植到本章分支。
+   **测试方式**
+
+   你的实现只需且必须通过测例，建议读者感到困惑时先检查测例
+   
+   如果实现正确，可在项目仓库的根目录下执行 ``make test5`` ，应该看到类似如下的显示输出：
+
+   .. code-block:: console
+   
+      $ cd  YOUR_LAB3_REPO_DIR
+      $ make test5
+      ......
+      [rustsbi] RustSBI version 0.2.2, adapting to RISC-V SBI v1.0.0
+      .______       __    __      _______.___________.  _______..______   __
+      |   _  \     |  |  |  |    /       |           | /       ||   _  \ |  |
+      |  |_)  |    |  |  |  |   |   (----`---|  |----`|   (----`|  |_)  ||  |
+      |      /     |  |  |  |    \   \       |  |      \   \    |   _  < |  |
+      |  |\  \----.|  `--'  |.----)   |      |  |  .----)   |   |  |_)  ||  |
+      | _| `._____| \______/ |_______/       |__|  |_______/    |______/ |__|
+      [rustsbi] Implementation     : RustSBI-QEMU Version 0.1.1
+      [rustsbi] Platform Name      : riscv-virtio,qemu
+      [rustsbi] Platform SMP       : 1
+      [rustsbi] Platform Memory    : 0x80000000..0x88000000
+      [rustsbi] Boot HART          : 0
+      [rustsbi] Device Tree Region : 0x87000000..0x87000ef2
+      [rustsbi] Firmware Address   : 0x80000000
+      [rustsbi] Supervisor Address : 0x80200000
+      [rustsbi] pmp01: 0x00000000..0x80000000 (-wr)
+      [rustsbi] pmp02: 0x80000000..0x80200000 (---)
+      [rustsbi] pmp03: 0x80200000..0x88000000 (xwr)
+      ......
+      [PASS] found <current time_msec = (\d+)>
+      [PASS] found <Test wait OK42266!>
+      [PASS] found <time_msec = (\d+) after sleeping (\d+) ticks, delta = (\d+)ms!>
+      [PASS] found <Test 04_4 test OK42266!>
+      [PASS] found <Test 04_6 ummap2 OK42266!>
+     ......
+      [PASS] found <Test set_priority OK42266!>
+      [PASS] found <Test write B OK42266!>
+      [PASS] not found <FAIL: T.T>
+      [PASS] not found <Should cause error, Test 04_2 fail!>
+      [PASS] not found <Should cause error, Test 04_3 fail!>
+
+      Test passed42266: 24/24
+
+      stride ratio = [15202320, 13745266, 13849200, 12149100, 10944222, 9782240]
+      [PASS] Stride Test
+
+      Test passed42266: 1/1

 - 提交你的修改
  
--- a/guide/source/chapter6/4exercise.rst
+++ b/guide/source/chapter6/4exercise.rst
@@ -102,6 +102,59 @@ Lab4 编程作业

    你也可以完全在用户态进行调试。仿照 ``easy-fs-fuse`` 建立一个在当前操作系统中运行的应用程序，将测试逻辑写在 ``main`` 函数中。这个时候就可以将它引用的 ``easy-fs`` 的 ``no_std`` 去掉并使用 ``println!`` 进行调试。

+- 开发并通过所有测例
+
+在 ``YOUR_LAB4_REPO_DIR`` 下进行编码（可学习参考 ``os6-ref/src`` 目录下的源代码，并在 ``os6/src`` 中完成编码），并进行编译测试。
+
+注意：本次实验需要扩展文件系统的功能，所以，除了需要修改扩展 ``os6`` 目录下的代码外，还需要修改扩展 ``easy-fs`` 和 ``easy-fs-fuse`` 下面的部分代码。
+
+.. note::
+
+   **测试方式**
+
+   你的实现只需且必须通过测例，建议读者感到困惑时先检查测例
+   
+   如果实现正确，可在项目仓库的根目录下执行 ``make test6`` ，应该看到类似如下的显示输出：
+
+   .. code-block:: console
+   
+      $ cd  YOUR_LAB4_REPO_DIR
+      $ make test6
+      ......
+      [rustsbi] RustSBI version 0.2.2, adapting to RISC-V SBI v1.0.0
+      .______       __    __      _______.___________.  _______..______   __
+      |   _  \     |  |  |  |    /       |           | /       ||   _  \ |  |
+      |  |_)  |    |  |  |  |   |   (----`---|  |----`|   (----`|  |_)  ||  |
+      |      /     |  |  |  |    \   \       |  |      \   \    |   _  < |  |
+      |  |\  \----.|  `--'  |.----)   |      |  |  .----)   |   |  |_)  ||  |
+      | _| `._____| \______/ |_______/       |__|  |_______/    |______/ |__|
+      [rustsbi] Implementation     : RustSBI-QEMU Version 0.1.1
+      [rustsbi] Platform Name      : riscv-virtio,qemu
+      [rustsbi] Platform SMP       : 1
+      [rustsbi] Platform Memory    : 0x80000000..0x88000000
+      [rustsbi] Boot HART          : 0
+      [rustsbi] Device Tree Region : 0x87000000..0x87000ef2
+      [rustsbi] Firmware Address   : 0x80000000
+      [rustsbi] Supervisor Address : 0x80200000
+      [rustsbi] pmp01: 0x00000000..0x80000000 (-wr)
+      [rustsbi] pmp02: 0x80000000..0x80200000 (---)
+      [rustsbi] pmp03: 0x80200000..0x88000000 (xwr)
+      ......
+      [PASS] found <Test 04_5 ummap OK53852!>
+      [PASS] found <Test 04_1 OK53852!>
+      .....
+      [PASS] found <Test write C OK53852!>
+      [PASS] found <get_time OK53852! (\d+)>
+      [PASS] not found <FAIL: T.T>
+      [PASS] not found <Should cause error, Test 04_2 fail!>
+      [PASS] not found <Should cause error, Test 04_3 fail!>
+
+      Test passed53852: 27/27
+      Report for lab1 found.
+      Report for lab2 found.
+      Report for lab3 found.
+      Report for lab4 found.
+
 - 提交你的修改
  
   - 如果是基于GitHub Classroom 开发, 在本地环境或在线codespaces环境下，执行 ``git push`` 命令，提交修改的代码到gitub进行CI自动评测。如果评测结果是 红色小叉 （位于repo的中上位置），可进一步点击红色小叉查找具体出错时的CI执行情况。 
--- a/guide/source/chapter8/5exercise.rst
+++ b/guide/source/chapter8/5exercise.rst
@@ -87,7 +87,61 @@ Lab5 编程作业
 -   `lab5(os8)参考框架: <https://github.com/LearningOS/rust-based-os-comp2022/tree/main/os8-ref>`_ 
 - 实验目录在 ``os8`` 。

- 通过所有测例
+- 开发并通过所有测例
+
+在 ``YOUR_LAB5_REPO_DIR`` 下进行编码（可学习参考 ``os8-ref/src`` 目录下的源代码，并在 ``os8/src`` 中完成编码），并进行编译测试。
+
+.. note::
+
+   **测试方式**
+
+   你的实现只需且必须通过测例，建议读者感到困惑时先检查测例
+   
+   如果实现正确，可在项目仓库的根目录下执行 ``make test8`` ，应该看到类似如下的显示输出：
+
+   .. code-block:: console
+   
+      $ cd  YOUR_LAB5_REPO_DIR
+      $ make test8
+      ......
+      [rustsbi] RustSBI version 0.2.2, adapting to RISC-V SBI v1.0.0
+      .______       __    __      _______.___________.  _______..______   __
+      |   _  \     |  |  |  |    /       |           | /       ||   _  \ |  |
+      |  |_)  |    |  |  |  |   |   (----`---|  |----`|   (----`|  |_)  ||  |
+      |      /     |  |  |  |    \   \       |  |      \   \    |   _  < |  |
+      |  |\  \----.|  `--'  |.----)   |      |  |  .----)   |   |  |_)  ||  |
+      | _| `._____| \______/ |_______/       |__|  |_______/    |______/ |__|
+      [rustsbi] Implementation     : RustSBI-QEMU Version 0.1.1
+      [rustsbi] Platform Name      : riscv-virtio,qemu
+      [rustsbi] Platform SMP       : 1
+      [rustsbi] Platform Memory    : 0x80000000..0x88000000
+      [rustsbi] Boot HART          : 0
+      [rustsbi] Device Tree Region : 0x87000000..0x87000ef2
+      [rustsbi] Firmware Address   : 0x80000000
+      [rustsbi] Supervisor Address : 0x80200000
+      [rustsbi] pmp01: 0x00000000..0x80000000 (-wr)
+      [rustsbi] pmp02: 0x80000000..0x80200000 (---)
+      [rustsbi] pmp03: 0x80200000..0x88000000 (xwr)
+      ......
+      [PASS] found <Hello, world from user mode program!>
+      [PASS] found <Test power_3 OK60963!>
+      [PASS] found <Test power_5 OK60963!>
+      ......
+      [PASS] found <threads test passed60963!>
+      [PASS] found <deadlock test mutex 1 OK60963!>
+      [PASS] found <deadlock test semaphore 1 OK60963!>
+      [PASS] found <deadlock test semaphore 2 OK60963!>
+      [PASS] found <ch8 Usertests passed60963!>
+      [PASS] not found <FAIL: T.T>
+      [PASS] not found <Should cause error, Test 04_2 fail!>
+      [PASS] not found <Should cause error, Test 04_3 fail!>
+
+      Test passed60963: 29/29
+      Report for lab1 found.
+      Report for lab2 found.
+      Report for lab3 found.
+      Report for lab4 found.
+      Report for lab5 found.

 - 提交你的修改