Skip to content

Commit d202f68

Browse files
committed
update docker related info
1 parent b7b341e commit d202f68

File tree

1 file changed

+45
-9
lines changed

1 file changed

+45
-9
lines changed

guide/source/0setup-devel-env.rst

Lines changed: 45 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -49,16 +49,52 @@ Docker方式进行本地OS开发环境配置
4949

5050
**Docker 开发环境**
5151

52-
感谢 dinghao188 和张汉东老师帮忙配置好的 Docker 开发环境,进入 Docker 开发环境之后不需要任何软件工具链的安装和配置,可以直接将 tutorial 运行起来,目前应该仅支持将 tutorial 运行在 Qemu 模拟器上。
53-
54-
使用方法如下(以 Ubuntu18.04 为例):
55-
56-
1. 通过 ``su`` 切换到管理员账户 ``root`` ;
57-
2. 在 ``rCore-Tutorial`` 根目录下 ``make docker`` 进入到 Docker 环境;
58-
3. 进入 Docker 之后,会发现当前处于根目录 ``/`` ,我们通过 ``cd mnt`` 将当前工作路径切换到 ``/mnt`` 目录;
59-
4. 通过 ``ls`` 可以发现 ``/mnt`` 目录下的内容和 ``rCore-Tutorial-v3`` 目录下的内容完全相同,接下来就可以在这个环境下运行 tutorial 了。例如 ``cd os && make run`` 。
52+
6053

61-
注:目前的Docker开发环境没有配置 Qemu-7.0.0 和下载 https://github.com/LearningOS/rust-based-os-comp2022.git 。所以还需要按照下面的步骤进行手动配置。
54+
使用方法如下(以 Ubuntu20.04 为例):
55+
56+
1. 以 ``lab0-0`` 为例,下载克隆本次的实验repo 或 https://github.com/LearningOS/rust-based-os-comp2022.git ; 在 ``lab0-0`` repo的根目录下,执行 ``make build_docker`` 来建立基于docker的开发环境;
57+
2. 在 ``lab0-0`` repo的根目录下执行 ``make docker`` 进入到 Docker 开发环境;
58+
3. 进入 Docker 之后,会发现当前处于根目录 ``/`` ,我们通过 ``cd os1`` 将当前工作路径切换到 ``lab0-0`` repo的根目录下;
59+
4. 接下来就可以在这个环境下进行实验了。例如 ``LOG=DEBUG make run`` 。
60+
61+
大致操作和输出如下:
62+
63+
.. code-block:: bash
64+
65+
$ make build_docker
66+
$ make docker
67+
docker$ cd os1
68+
docker$ LOG=DEBUG make run
69+
...
70+
[rustsbi] RustSBI version 0.2.2, adapting to RISC-V SBI v1.0.0
71+
.______ __ __ _______.___________. _______..______ __
72+
| _ \ | | | | / | | / || _ \ | |
73+
| |_) | | | | | | (----`---| |----`| (----`| |_) || |
74+
| / | | | | \ \ | | \ \ | _ < | |
75+
| |\ \----.| `--' |.----) | | | .----) | | |_) || |
76+
| _| `._____| \______/ |_______/ |__| |_______/ |______/ |__|
77+
[rustsbi] Implementation : RustSBI-QEMU Version 0.1.1
78+
[rustsbi] Platform Name : riscv-virtio,qemu
79+
[rustsbi] Platform SMP : 1
80+
[rustsbi] Platform Memory : 0x80000000..0x88000000
81+
[rustsbi] Boot HART : 0
82+
[rustsbi] Device Tree Region : 0x87000000..0x87000ef2
83+
[rustsbi] Firmware Address : 0x80000000
84+
[rustsbi] Supervisor Address : 0x80200000
85+
[rustsbi] pmp01: 0x00000000..0x80000000 (-wr)
86+
[rustsbi] pmp02: 0x80000000..0x80200000 (---)
87+
[rustsbi] pmp03: 0x80200000..0x88000000 (xwr)
88+
Hello, world!
89+
[DEBUG] .rodata [0x80203000, 0x80205000)
90+
[ INFO] .data [0x80205000, 0x80206000)
91+
[ WARN] boot_stack [0x80206000, 0x80216000)
92+
[ERROR] .bss [0x80216000, 0x80217000)
93+
94+
注:
95+
96+
- 感谢 qobilidop, dinghao188 和张汉东老师帮忙配置好的 Docker 开发环境,进入 Docker 开发环境之后不需要任何软件工具链的安装和配置,可以直接将 tutorial 运行起来,目前应该仅支持将 本次实验 运行在 Qemu-7.0.0 模拟器上。
97+
- 目前的Docker开发环境没有:设置国内crates源(可选) 、下载克隆本次的实验repo,https://github.com/LearningOS/rust-based-os-comp2022.git等 。所以还需要参考下面的步骤进行部分配置和部分安装。
6298
6399
64100
手动方式进行本地OS开发环境配置

0 commit comments

Comments
 (0)