CSE 536: Getting Started

In ASU's Advanced Operating System course (CSE 536), we are using the xv6 Operating System for programming assignments. xv6 is a teaching-focused OS designed by some incredible folks at MIT (link). This README explains how to setup QEMU and a GNU RISC-V toolchain, needed for running xv6, as well how to boot up a QEMU VM with xv6.

• Boot Rom and Bootloader
• Process Memory Management
• User-Level Thread Management
• Trap and Emulate Virtualization

Follow the below steps to setup necessary dependencies for developing xv6 OS.

A. Installing xv6 pre-requisites

Please reach out to the TAs if you have any installation issues.

Linux/WSL

1. Navigate to the install/linux-wsl folder
2. Install RISC-V QEMU: ./linux-qemu.sh
3. Install RISC-V toolchain:./linux-toolchain.sh
4. Add installed binaries to path: source .add-linux-paths

MacOS

1. Navigate to the install/mac folder
2. Install RISC-V QEMU: ./mac-qemu.sh
3. Install RISC-V toolchain: ./mac-toolchain.sh
4. Add installed binaries to path: source .add-mac-paths

Installing using package manager

If installing QEMU and the toolchain from source does not work for you, then do the following steps:

1. Linux/WSL
   1. sudo apt-get update
   2. sudo apt-get install git build-essential gdb-multiarch qemu-system-misc gcc-riscv64-linux-gnu binutils-riscv64-linux-gnu
2. Mac (work in progress)
   1. xcode-select --install
   2. /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
   3. (echo; echo 'eval "$(/opt/homebrew/bin/brew shellenv)"') >> ~/.zprofile
   4. eval "$(/opt/homebrew/bin/brew shellenv)"
   5. brew tap riscv/riscv
   6. brew install riscv-tools
   7. Write the follwing line to ~/.zshrc " export PATH="/opt/homebrew/Cellar/riscv-gnu-toolchain/main/bin:$PATH" "
   8. source ~/.zshrc
   9. brew install qemu
   10. brew link qemu
   11. brew link --overwrite qemu (Run this if you can't link qemu due to any conflicts)

B. Running the xv6 OS

1. Navigate back to main folder and clone the xv6 OS using

    git clone https://github.com/mit-pdos/xv6-riscv.git
   

2. Navigate to xv6-riscv and run make qemu

C. FAQs

1. While running linux-qemu.sh, if you run into ERROR: glib-2.48 gthread-2.0 is required to compile QEMU, then :

• Run this command in the terminal. sudo apt install libglib2.0-dev. This is caused due to a newer version of your linux distro(link).

2. linux-qemu.sh : ../meson.build:328:2: ERROR: Dependency "pixman-1" not found, tried pkgconfig

• Can be resolved by running sudo apt install libpixman-1-dev (link)

Acknowledgement