riscv64 debian镜像制作

制作需要qemu-riscv64-static, 建议在debian 10或ubuntu 19.04的系统(可尝试使用docker)中进行操作.

• 创建空镜像和分区

dd if=/dev/zero of=debian.img bs=1G count=16  # 此处镜像大小为16GB
sudo cfdisk debian.img # 可创建两个分区, 第一个分区12GB作为rootfs, 第二个分区4GB作为swap
sudo losetup --partscan --show --find debian.img # 将debian.img作为loop设备
ls /dev/loop0* # 此时应该能看到/dev/loop0p1和/dev/loop0p2两个分区

• 创建ext4和swap文件系统

sudo mkfs.ext4 /dev/loop0p1
sudo mkswap /dev/loop0p2

• 挂载ext4分区

sudo mount /dev/loop0p1 /mnt

• 安装debian base system. 下面两条命令的操作来自debian社区的安装指南.

sudo apt-get install debootstrap qemu-user-static binfmt-support debian-ports-archive-keyring
sudo debootstrap --arch=riscv64 --keyring /usr/share/keyrings/debian-ports-archive-keyring.gpg --include=debian-ports-archive-keyring unstable /mnt http://deb.debian.org/debian-ports

若要安装x86系统, 则输入

sudo debootstrap --arch=i386 --keyring /usr/share/keyrings/debian-archive-keyring.gpg --include=debian-archive-keyring stable /mnt http://deb.debian.org/debian

如果在运行上述 debootstrap 命令时提示 gpg key 错误，可以在Debian官方镜像上选择合适的镜像下载最新的安装包，并手动安装。更新完 debian-ports-archive-keyring 包后，可以重新尝试执行上面的 debootstrap 命令。以下命令在 2022 年 3 月 29 日是可用的：

wget http://ftp.cn.debian.org/debian/pool/main/d/debian-ports-archive-keyring/debian-ports-archive-keyring_2022.02.15\~deb11u1_all.deb .
sudo dpkg -i debian-ports-archive-keyring_2022.02.15\~deb11u1_all.deb

• 进入镜像

sudo chroot /mnt /bin/bash

此时实际上是通过qemu-riscv64-static来执行镜像中的riscv64可执行文件.

• 安装所需工具(根据实际情况选择)

apt-get update
apt-get install gcc build-essential
apt-get install tmux libreadline-dev
apt-get install net-tools openssh-server
# fix long delay of openssh server
apt-get install haveged
agt-get install sbt

• 在/etc/fstab中添加swap分区

/dev/mmcblk0p2 none swap sw 0 0

• 添加/root/目录的写和执行权限, 使得host上的普通用户可以访问

chmod +w,+x /root

• 在/root/目录下提前写入所需的测试文件, 如hello.c等.
• 在/root/.bashrc中添加如下内容, 可以实现登录后自动运行命令(根据实际情况修改测试的命令):

TMP_DIR=/run/mytest

cmd=(
# enbale swap
  "swapon -a"

# show system information
  "uname -a"
  "cat /etc/issue"
  "cat /proc/cpuinfo"
  "df -ah"
  "free -h"

# show time
  "date"
  "uptime"

# create and switch to tmp directory
  "mkdir $TMP_DIR"
  "cd $TMP_DIR"

# compile and run hello
  "ls /root"
  "ls /root/hello"
  "cat /root/hello/hello.c"
  "gcc -time /root/hello/hello.c -o $TMP_DIR/hello"
  "ls -lh $TMP_DIR"
  "$TMP_DIR/hello"

# compile and run x86-nemu
  "ls /root/nemu"
  "cp -r /root/nemu $TMP_DIR"
  "export NEMU_HOME=$TMP_DIR/nemu"
  "make -C $TMP_DIR/nemu ISA=x86"
  "ls -lh /root/nemu-prog"
  "file /root/nemu-prog/amtest-x86-nemu.elf"
  "$TMP_DIR/nemu/build/x86-nemu --batch --mainargs=h /root/nemu-prog/amtest-x86-nemu.bin"
  "file /root/nemu-prog/microbench-x86-nemu.elf"
  "$TMP_DIR/nemu/build/x86-nemu --batch --mainargs=test /root/nemu-prog/microbench-x86-nemu.bin"

# compile and run riscv64-nemu
  "make -C $TMP_DIR/nemu clean"
  "make -C $TMP_DIR/nemu ISA=riscv64"
  "$TMP_DIR/nemu/build/riscv64-nemu --batch /root/nemu-prog/linux-hello-riscv64-nemu.bin"
)

prompt="`whoami`@`hostname`:`pwd`#"

echo -e "\n============ Now running preset commands =============\n"

for ((i = 0; i < ${#cmd[@]}; i++)); do
  c=${cmd[$i]}
  echo "$prompt $c"
  $c
  echo ""
done

echo -e "\n============ End of preset commands =============\n"

/root/nemutrap/good-trap

• 若在不方便输入的环境(如NEMU, verilator仿真等)中测试, 可采用如下两种方式的其中一种, 避免登录时输入
  • 通过紧急模式登录

cd /lib/systemd/system
# 通过紧急模式登录, 不启动非必须的服务, 节省将近一半的登录时间
ln -sf emergency.target default.target
# 跳过登录提示符, 直接运行bash
vim emergency.service
  -ExecStart=-/lib/systemd/systemd-sulogin-shell emergency
  +ExecStart=-/bin/bash

• 免密码登录, 见这里

cd /lib/systemd/system
vim serial-getty@.service
  -ExecStart=-/sbin/agetty -o '-p -- \u' --keep-baud 115200,57600,38400,9600 %I $TERM
  +ExecStart=-/sbin/agetty -a root --keep-baud 115200,57600,38400,9600 %I $TERM

• 退出并卸载镜像

exit  # 之前通过`chroot`方式进入
sudo umount /mnt  # 记得卸载! 在未卸载镜像的情况下通过可写方式再次打开`debian.img`(如作为qemu的文件系统), 镜像将会损坏!
sudo losetup -d /dev/loop0  # 删除loop设备

• 修改nemu/src/device/sdcard.c中init_sdcard()中打开的镜像文件路径, 即可使用制作的镜像. 在i9-9900k上测试, 约90s后看到debian的登录提示符.
• 当以可写方式启动镜像是, NEMU遇到错误或通过Ctrl+C直接退出NEMU时, 可能会损坏镜像的崩溃一致性, 此时可以通过fsck命令修复分区.

来源：https://github.com/OpenXiangShan