rCore-Tutorial-Book-v3/chapter0/5setup-devel-env

[utterances-bot]

实验环境配置 — rCore-Tutorial-Book-v3 0.1 文档

https://rcore-os.github.io/rCore-Tutorial-Book-v3/chapter0/5setup-devel-env.html

[hsiachi]

请问虚拟磁盘文件可以传一份到清华云盘上吗？

[dinghao188]

想问下有docker镜像吗

[wyfcyx]

请问虚拟磁盘文件可以传一份到清华云盘上吗？

虚拟磁盘文件已经传到清华云盘上了。

[wyfcyx]

想问下有docker镜像吗

抱歉，暂时还没有。

[dinghao188]

我弄了个docker镜像，不想重新配一遍的话可以用一下
docker pull dinghao188/rcore-tutorial

[xinhaoyu-wd]

安装rustup target add riscv64gc-unknown-none-elf提示
info: component 'rust-std' for target 'riscv64gc-unknown-none-elf' is up to date，但是cargo build 编译程序提示can't find crate for std，the riscv64gc-unknown-none-elf target may not be installed，蒙圈了

[wyfcyx]

安装rustup target add riscv64gc-unknown-none-elf提示
info: component 'rust-std' for target 'riscv64gc-unknown-none-elf' is up to date，但是cargo build 编译程序提示can't find crate for std，the riscv64gc-unknown-none-elf target may not be installed，蒙圈了

Rust 官方并没有为 riscv64gc-unknown-none-elf 这个 target 提供标准库 std，而只有核心库 core 。所以是因为现在 build 的项目用到了标准库 std 才出现了这个问题，详情参考文档第一章第二小节的 移除标准库依赖 。

[ZhangHanDong]

M1 MacbookPro 正常启动 Qemu 安装：

执行：

brew install ninja glib pixman pkg-config texinfo nettle gettext libffi
git clone https://github.com/patchew-project/qemu
cd qemu

然后需要加一个补丁，以避免qemu-system-riscv: qemu_mprotect__osdep: mprotect failed: Permission denied的问题。

// util/osdep.c 
// 在 int qemu_mprotect_none(void *addr, size_t size) 函数中加入 m1 平台判断

int qemu_mprotect_none(void *addr, size_t size)
{
#ifdef _WIN32
    return qemu_mprotect__osdep(addr, size, PAGE_NOACCESS);
#elif defined(__APPLE__) && defined(__arm64__)
    /* Workaround mprotect (RWX->NONE) issue on Big Sur 11.2 */
    return 0;
#else
    return qemu_mprotect__osdep(addr, size, PROT_NONE);
#endif
}

开始构建：

mkdir build && cd build
../configure --target-list=riscv64-softmmu,aarch64-softmmu --extra-cflags=-I/opt/homebrew/opt/gnutls/include --extra-ldflags=-L/opt/homebrew/opt/gnutls/lib --enable-cocoa
make -j
sudo make install

构建完毕，注意设置 qemu 的 PATH 为 build 目录。

以上。应该就可以在 M1 上正常使用 Qemu 了。

[sedationh]

qemu-riscv64在mac下怎么没有呢？
只能使用qemu-system-riscv64

$ qemu-
qemu-edid                 qemu-system-m68k          qemu-system-riscv64     
qemu-ga                   qemu-system-microblaze    qemu-system-rx          
qemu-img                  qemu-system-microblazeel  qemu-system-s390x       
qemu-io                   qemu-system-mips          qemu-system-sh4         
qemu-nbd                  qemu-system-mips64        qemu-system-sh4eb       
qemu-storage-daemon       qemu-system-mips64el      qemu-system-sparc       
qemu-system-aarch64       qemu-system-mipsel        qemu-system-sparc64     
qemu-system-alpha         qemu-system-moxie         qemu-system-tricore     
qemu-system-arm           qemu-system-nios2         qemu-system-x86_64      
qemu-system-avr           qemu-system-or1k          qemu-system-xtensa      
qemu-system-cris          qemu-system-ppc           qemu-system-xtensaeb    
qemu-system-hppa          qemu-system-ppc64                                 
qemu-system-i386          qemu-system-riscv32                               

[TB5z035]

Ubuntu-20.04(wsl2)环境下安装后，使用qemu-system-riscv64命令提示libtinfo.so.6不存在；Ubuntu-18.04(wsl2)正常

[TB5z035]

rust安装脚本中toolchain需要手动选择nightly，否则默认安装的为default版本

[duskmoon314]

Ubuntu-20.04(wsl2)环境下安装后，使用qemu-system-riscv64命令提示libtinfo.so.6不存在；Ubuntu-18.04(wsl2)正常

按照实验指导书中所述进行qemu的手动编译安装，wsl2 ubuntu20.04未发现此情况。请确认你正确的进行了编译安装。

> qemu-system-riscv64 --version
QEMU emulator version 5.0.0
Copyright (c) 2003-2020 Fabrice Bellard and the QEMU Project developers

rust安装脚本中toolchain需要手动选择nightly，否则默认安装的为default版本

可以通过在项目根目录下添加写有 nightly 的 rust-toolchain 文件实现本项目使用 nightly 版本，而非 stable 版本。这样的话，电脑上会同时存在两个版本。

> rustup toolchain list
stable-x86_64-unknown-linux-gnu (default)
nightly-x86_64-unknown-linux-gnu

[zeyuanj]

楼上大佬提供的docker镜像下载如果慢的话，使用如下pull姿势，亲测可行：
docker pull dockerhub.azk8s.cn/dinghao188/rcore-tutorial

[ZhangHanDong]

@zeyuanj @dinghao188 请问这个 dinghao188/rcore-tutorial 的dockerfile 在哪里？

[hsiachi]

macOS (Intel)可以使用brew安装qemu：

brew install qemu

经过测试，5.2.50版本的qemu会在make run的时候报错（invalid instruction），5.1.0和5.2.0可以正常运行。

[ZhangHanDong]

@Hunter-CH3

macOS(Arm) 下 5.2.50 版本的 qemu 同样会在 make run 的时候报错（invalid instruction）。 我还以为是我自己的问题呢。。。 看来是qemu的问题

[ZhangHanDong]

@zeyuanj 你提供的这个镜像地址返回 403

[imjustfly]

@ZhangHanDong 同样启动qemu 后加载sbi报错

➜  os git:(main) ✗ qemu-system-riscv64 \
                -machine virt \
                -nographic \
                -bios ../bootloader/rustsbi-qemu.bin
[rustsbi] RustSBI version 0.1.1
.______       __    __      _______.___________.  _______..______   __
|   _  \     |  |  |  |    /       |           | /       ||   _  \ |  |
|  |_)  |    |  |  |  |   |   (----`---|  |----`|   (----`|  |_)  ||  |
|      /     |  |  |  |    \   \       |  |      \   \    |   _  < |  |
|  |\  \----.|  `--'  |.----)   |      |  |  .----)   |   |  |_)  ||  |
| _| `._____| \______/ |_______/       |__|  |_______/    |______/ |__|

[rustsbi] Platform: QEMU (Version 0.1.0)
[rustsbi] misa: RV64ACDFIMSU
[rustsbi] mideleg: 0x222
[rustsbi] medeleg: 0xb1ab
[rustsbi-dtb] Hart count: cluster0 with 1 cores
[rustsbi] Kernel entry: 0x80200000
[rustsbi-panic] hart 0 panicked at 'invalid instruction, mepc: 0000000080003eba, instruction: 0000000030200073', platform\qemu\src\main.rs:458:17
[rustsbi-panic] system shutdown scheduled due to RustSBI panic

降到5.2.0，之后会出现 Could not allocate dynamic translator buffer 错误，trace了一下，是一个mmap的出错。

所以貌似又无解了

[zhugy08]

安装完rust后，需要切换到nightly，要不然RV64裸机应用那里的实验通不过。

cargo default nightly

[ZhangHanDong]

@imjustfly 你是在用m1 吗？ Could not allocate dynamic translator buffer这个错误是需要打patch的。你可以看看我上面评论里的那个方法重装一下qemu。然而那个patch也是针对 5.2.50最新版本的。总之目前还不如用docker。

[dinghao188]

@zeyuanj @dinghao188 请问这个 dinghao188/rcore-tutorial 的dockerfile 在哪里？

发到这了 https://github.com/dinghao188/rcore-tutorial-v3-docker；

这个里面的rust是最小化安装的

[chyyuu]

Q：windows下可以开展OS实验的方便环境吗？
A：可以的，有两种方式：

1. 安装wsl2和vscode，在wsl2上安装ubuntu 20.04，并进一步根据本章描述在ubuntu上安装相关软件；在vscode安装Remote - WSL，Rust Analyzer等插件。就可以在vscode上编辑/分析位于wsl2的ubuntu 20.04中的代码文件了
2. 安装wsl2和clion，在wsl2上安装ubuntu 20.04，并进一步根据本章描述在ubuntu上安装相关软件（包括xfce4 GUI环境，clion IDE for linux）；安装VcXsrv（xserver in win）。这样就可以在VcXsrv提供的图形界面下用clion IDE编辑/分析位于wsl2的ubuntu 20.04中的代码文件了

注：编译运行一般在命令行通过 make run等完成。

[Gallium70]

安装WSL2应该不需要加入预览体验计划吧

[imjustfly]

@ZhangHanDong M1 没错。你上面那个手动的patch是修复M1 macos 11.2 下的 mprotect问题，Could not allocate dynamic translator buffer 是mmap问题，这个在5.2.50版本才修复，之前的版本都不行。

然而，rustsbi表示必须在5.1以下的qemu中使用：

https://github.com/luojia65/rustsbi/issues/12#issuecomment-784900685

所以，我也懒得研究把5.2.50中对于mmap syscall的使用的修改port到5.1去了，毕竟只是一时兴起想学习一下这个项目，我还是直接docker或者ssh 一个linux主机吧。

[ZhangHanDong]

@imjustfly 你看我上面那个 qemu 的clone仓库是patch版本的，修复了 Could not allocate dynamic translator buffer .

然而，还是docker吧，等qemu后面完全兼容m1再切吧

[imjustfly]

@ZhangHanDong 哦哦，了解。多谢！

[ZhangHanDong]

结合 @dinghao188 提供的 Dockerfile 给实验环境加了个 Docker 支持，方便使用。

rcore-os/rCore-Tutorial-v3#6

[duskmoon314]

安装WSL2应该不需要加入预览体验计划吧

@Gallium70

不需要加入

实验指导书中已有安装讲解，你也可以参考微软的指南 https://docs.microsoft.com/zh-cn/windows/wsl/install-win10

[zeyuanj]

@zeyuanj 你提供的这个镜像地址返回 403

不好意思，我可能描述有误，仅就docker pull来说，我这边的网下载原始镜像速度有点慢，添加pdockerhub.azk8s.cn后加速成功，类似于更换下载源实现镜像加速(其他方式如阿里云等效果不好)可能仅针对自己的环境有效，不具有普遍性

[HNUrookie1]

请问为什么make run报错呀

[yghhust]

按照“Github Classroom方式进行在线OS 环境配置”章节中的说明，在 vscode的console中执行make codespaces_setenv和make setupclassroom_testX失败是怎么回事呢？

@yghhust ➜ /workspaces/lab0-0-setup-env-run-os1-yghhust (main) $ make codespaces_setenv
make: *** No rule to make target 'codespaces_setenv'. Stop.

[Aeolusw]

VMware虚拟机方式应该是最省心的了，你只需要下好Ubuntu 22.04的iso文件，下载本文提供的虚拟磁盘文件，新建虚拟机时注意选择磁盘文件，就能直接打开了
然后一行官方脚本配好rust
在Downloads文件夹里找到下好的qemu，根据本文操作
就可以了

[Deadpoolmine]

注意，最后网络问题virtio-drivers切到gitee上时，需要添加rev，virtio-drivers = { git = "https://gitee.com/rcore-os/virtio-drivers", rev = "4ee80e5" }

[lichade-son]

切换到gitee仍然无法访问。
riscv64gc-unknown-none-elf (installed)
cargo install cargo-binutils
Updating ustc index
Ignored package cargo-binutils v0.3.6 is already installed, use --force to override
rustup component add rust-src
info: component 'rust-src' is up to date
rustup component add llvm-tools-preview
info: component 'llvm-tools-preview' for target 'x86_64-unknown-linux-gnu' is up to date
Platform: qemu
Updating ustc index
Updating git repository https://gitee.com/yfblock/lose-net-stack
error: failed to get lose-net-stack as a dependency of package os v0.1.0 (/home/oslab/Desktop/rCore-Tutorial-v3/os)

Caused by:
failed to load source for dependency lose-net-stack

Caused by:
Unable to update https://gitee.com/yfblock/lose-net-stack?rev=db42380

Caused by:
failed to fetch into: /root/.cargo/git/db/lose-net-stack-d574d5cd332c0d84

Caused by:
failed to authenticate when downloading repository

• attempted to find username/password via git's credential.helper support, but failed

if the git CLI succeeds then net.git-fetch-with-cli may help here
https://doc.rust-lang.org/cargo/reference/config.html#netgit-fetch-with-cli

Caused by:
failed to acquire username/password from local configuration
make: *** [Makefile:60: kernel] Error 101

[XiaoYi-byte]

gitee上没有lose-net-stack，你不能将https://github.com/yfblock/lose-net-stack改成https://gitee.com/yfblock/lose-net-stack。如果你用的是ubuntu，你可以试试执行
export CARGO_NET_GIT_FETCH_WITH_CLI=true再make run

[cxchhh]

安装WSL2应该不需要加入预览体验计划吧

千万不要！！

[Git4Mark]

os目录下执行 make run，报错:

src_path = ../user/src/bin/
target_path = ../user/target/riscv64gc-unknown-none-elf/release/
qemu-system-riscv64: -netdev user,id=net0,hostfwd=udp::6200-:2000,hostfwd=tcp::6201-:80: network backend 'user' is not compiled into this binary
make: *** [Makefile:93: run-inner] Error 1

[Git4Mark]

我的问题，高版本的qemu没有netdev user这个选项

[xuanz20]

按照文档下载QEMU并编译，运行qemu-system-riscv64 --version显示：

QEMU emulator version 4.2.1 (Debian 1:4.2-3ubuntu6.27)
Copyright (c) 2003-2019 Fabrice Bellard and the QEMU Project developers

[xuanz20]

运行which qemu-system-riscv64后发现输出是/usr/bin/qemu-system-riscv64
将~/.bashrc改成export PATH=/path/to/qemu-7.0.0/build:$PATH改变优先级就好了

[chestNutLsj]

个人在ArchLinux下尝试配置qemu环境和实验环境，只需要

$ sudo pacman -S qemu-full

一条命令即可，这个安装的版本是8.0.1的（2023.9.19），之后直接在clone下的rCore-Tutorial-v3的os目录下进行make run即可，我能够直接输出RustSBI图样及Rust user_shell的那些应用。

至于之前的riscv环境和rust环境按照教程即可，唯一不同的是安装riscv-elf-gdb，没有中间那个unknown字样，这些可以在extra仓库里搜索到。

后续运行若出现什么问题会回来回帖补充。

[liukangcc]

make run 报下面的错误

lk@ubuntu20:~/repo/rCore-Tutorial-v3/os$ make run
(rustup target list | grep "riscv64gc-unknown-none-elf (installed)") || rustup target add riscv64gc-unknown-none-elf
riscv64gc-unknown-none-elf (installed)
cargo install cargo-binutils
    Updating crates.io index
  Installing cargo-binutils v0.3.6
error: failed to compile `cargo-binutils v0.3.6`, intermediate artifacts can be found at `/tmp/cargo-install7OjPSu`.
To reuse those artifacts with a future compilation, set the environment variable `CARGO_TARGET_DIR` to that path.

Caused by:
  failed to run `rustc` to learn about target-specific information

Caused by:
  process didn't exit successfully: `rustc - --crate-name ___ --print=file-names --crate-type bin --crate-type rlib --crate-type dylib --crate-type cdylib --crate-type staticlib --crate-type proc-macro --print=sysroot --print=split-debuginfo --print=crate-name --print=cfg` (exit status: 1)
  --- stderr
  error: unknown print request `split-debuginfo`

make: *** [Makefile:43: env] Error 101

[liukangcc]

The above problem has been fixed.

[dirgochan]

error: failed to select a version for the requirement funty = "~1.2"

[dirgochan]

error: failed to select a version for the requirement funty = "~1.2"

这个关联的版本已经下线了：https://docs.rs/funty/1.2.0/funty/index.html

[HATTER-LONG]

如果变异 qemu 大于 7.2 版本要注意安装 slirp，否则 make run 时会有这个报错
qemu-system-riscv64: -netdev user,id=net0,hostfwd=udp::6200-:2000,hostfwd=tcp::6201-:80: network backend 'user' is not compiled into this binary

sudo apt install libslirp-dev
./configure --target-list=riscv64-softmmu,riscv64-linux-user --enable-slirp

[ghost]

老师，我按照教程安装qemu后输入“qemu-riscv64 --version“命令，发现版本还是4.2.1
”qemu-riscv64 version 4.2.1 (Debian 1:4.2-3ubuntu6.27)“
这是什么原因？

[ChaiByte]

在 "GDB 调试支持" 一节提到：

我们推荐使用 gdb-dashboard 插件，可以大大提升调试体验。

如若默认使用 riscv64-unknown-elf-toolchain 的 bin 文件夹下的预编译文件，应当将所有出现于 Makefile文件 中的 riscv64-unknown-elf-gdb 替换成 riscv64-unknown-elf-gdb-py 以启用 Python 支持，否则的话由 gdb-dashboard 提供的 .gdbinit 并未生效，该细节建议进行补充。

[Max-Ming]

Finished release [optimized + debuginfo] target(s) in 1.96s
make[1]: Entering directory '/home/oslab/rCore-Tutorial-v3/user'
    Finished release [optimized + debuginfo] target(s) in 0.02s
make[1]: Leaving directory '/home/oslab/rCore-Tutorial-v3/user'
    Finished release [optimized] target(s) in 0.03s
     Running `target/release/easy-fs-fuse -s ../user/src/bin/ -t ../user/target/riscv64gc-unknown-none-elf/release/`
src_path = ../user/src/bin/
target_path = ../user/target/riscv64gc-unknown-none-elf/release/

我make run之后卡在这里不动了，怎么回事

[wyfcyx]

@Max-Ming 看起来没什么问题，可能只是这一步比较慢？如果还有问题的话报一下平台和Qemu版本。

[msdlisper]

@kidcats 转载你的原始内容，便于在GitHub Issue中搜索，谢谢你的贡献。 补一个vscode远程调试的方法 1.先在os路径下执行,make debugserver,开启远程调试 2. 配置launch.json

{
    "version": "0.2.0",
    "configurations": [
        {
            "type": "cppdbg",
            "request": "launch",
            "name": "Attach to gdbserver",
            "program": "${workspaceFolder}/os/target/riscv64gc-unknown-none-elf/release/os",
            "miDebuggerServerAddress": "localhost:1234",
            "miDebuggerPath": "/home/***/riscv64-gcc/bin/riscv64-unknown-elf-gdb",
            "cwd": "${workspaceRoot}",
        }
    ]
}

验证了以上方法可行, 需要额外安装一个vscode的插件: C/C++ IntelliSense, debugging, and code browsing. (插件名字就叫C/C++)

[Max-Ming]

@wyfcyx 好像是qemu版本低了，应该使用7.0.0版本

[Max-Ming]

注意！注意！注意！在虚拟机vmware上使用磁盘文件的，不要用qemu5.0.0版本，使用qemu7.0.0

[TL-SN]

Scripting in the "Python" language is not supported in this copy of GDB.```
能不能帮忙提供一份支持python的gdb

一、如果想用gdb-dashboard插件的话，只是将所有出现于 Makefile文件 中的 riscv64-unknown-elf-gdb 替换成 riscv64-unknown-elf-gdb-py可能不太行(至少我没有成功，插件依然使用不了，另外我的环境是ubuntu20.04,python版本为python2.7、python3.8)

二、可以选择自行编译riscv64-unknown-elf-gdb，就按照 https://rcore-os.cn/rCore-Tutorial-deploy/docs/pre-lab/gdb.html 提供的方法(亲测行得通)

三、不过按照这个网站编译的话需要注意一下几点

1、用python2环境

2、不要编译版本太高的gdb，我最初选择编译的是gdb14.1，莫名报错编译失败，后来使用gdb10.1版本源码编译就成功了

四、这是我在我上面提到的环境下编译好的支持gdb-dashboard插件的gdb， 希望对你有所帮助

链接：https://pan.baidu.com/s/1VBRWAwWoEgZxRDhGwLxjTA?pwd=btcc
提取码：btcc
--来自百度网盘超级会员V6的分享

[MR-Promethus]

调了好几天了，我用VMware虚拟机的方式makerun的时候出现了错误：error[E0599]: the method configure exists for struct k210_pac::UARTHS, but its trait bounds were not satisfied。qemu是7.0.0的，rustc也是 nightly的，具体如下：
error[E0599]: the method configure exists for struct k210_pac::UARTHS, but its trait bounds were not satisfied
--> src/drivers/block/sdcard.rs:730:24
|
730 | peripherals.UARTHS.configure(115_200.bps(), &clocks);
| ^^^^^^^^^ method cannot be called on k210_pac::UARTHS due to unsatisfied trait bounds
|
::: /home/oslab/.cargo/git/checkouts/k210-pac-79b5d460421358d6/8f99c1c/src/lib.rs:1028:1
|
1028 | pub struct UARTHS {
| -----------------
| |
| doesn't satisfy k210_pac::UARTHS: SerialExt
| doesn't satisfy k210_pac::UARTHS: serial::closed_trait::UartX
...
1050 | pub struct RegisterBlock {
| ------------------------
| |
| doesn't satisfy _: serial::closed_trait::UartX
| doesn't satisfy k210_pac::uarths::RegisterBlock: SerialExt
|
= note: the following trait bounds were not satisfied:
k210_pac::UARTHS: serial::closed_trait::UartX
which is required by k210_pac::UARTHS: SerialExt
&k210_pac::UARTHS: serial::closed_trait::UartX
which is required by &k210_pac::UARTHS: SerialExt
&mut k210_pac::UARTHS: serial::closed_trait::UartX
which is required by &mut k210_pac::UARTHS: SerialExt
k210_pac::uarths::RegisterBlock: serial::closed_trait::UartX
which is required by k210_pac::uarths::RegisterBlock: SerialExt
&k210_pac::uarths::RegisterBlock: serial::closed_trait::UartX
which is required by &k210_pac::uarths::RegisterBlock: SerialExt
&mut k210_pac::uarths::RegisterBlock: serial::closed_trait::UartX
which is required by &mut k210_pac::uarths::RegisterBlock: SerialExt

For more information about this error, try rustc --explain E0599.

[wyfcyx]

@MR-Promethus 请问是哪个分支呢？是k210分支吗？

[wwk1498]

为什么我使用ubuntu22.04的安装了docker，如何使用docker进行本地os开发环境配置，到cd /mnt这步发现/mnt目录下是空的？

[Charlie-Ping]

arch用cargo安装cargo-binutils找不到rust-objdump等可执行文件的话 可以在aur里找