rvld

README

rvld

English | 中文版

rvld is a minimal linker implementation for the RV64GC architecture, mainly for educational purposes. rvld mostly copied the source code of rui314/mold, so it is a derivative work of mold, and is also distributed under the GNU AGPL v3 LICENSE.

rvld can statically link a simple C program (such as the Hello world in the example below) and produce a runnable binary.

cat <<EOF | $CC -o a.o -c -xc -static -
#include <stdio.h>
int main() {
  printf("Hello, World.\n");
  return 0;
}
EOF

$CC -B. -s -static a.o -o out
qemu-riscv64 out

# Hello, World.

rvld is only about 2000 lines of Go code and has no external dependencies other than the standard library. Based on this project, PLCT Lab launched an open course Implementing a Linker from Scratch. The course is in Chinese.

Note

rvld may not be suitable for higher version toolchains, please consider using Docker environment for easier reproduction.

docker run -u root --volume ~/Developer:/code -it golang:bullseye

# Inside the docker container:
apt update
apt install -y gcc-10-riscv64-linux-gnu qemu-user
ln -sf /usr/bin/riscv64-linux-gnu-gcc-10 /usr/bin/riscv64-linux-gnu-gcc