GNU Toolchain Builder

This repository provides a Docker-based solution for building the RISC-V GNU toolchain within an Ubuntu 22.04 container. The final build is packaged as a .tar.gz file. See more at riscv-collab/riscv-gnu-toolchain.

Getting Started

The Dockerfile sets up an Ubuntu 22.04 environment, installs necessary dependencies, clones the RISC-V GNU toolchain repository, and runs the build script. Then the build.sh script configures, builds, and packages the RISC-V GNU toolchain. The build process will generate a riscv-toolchain.tar.gz file in the current directory.

1. Prerequisites

• Docker

2. Clone the Repository

Clone this repository to your local machine:

git clone https://github.com/insper-riscv/gnu-toolchain-builder.git
cd riscv-gnu-toolchain-builder

3. Build the Docker Image

Build the Docker image using the provided Dockerfile:

docker build -t riscv-gnu-toolchain-builder .

4. Run the Docker Container

Run the Docker container to build the RISC-V GNU toolchain with the desired configuration. The output will be a .tar.gz file saved in the current directory.

docker run --rm -v "${PWD}:/~" -v "riscv-gnu-toolchain:/tmp" riscv-gnu-toolchain-builder [CONFIGURE_OPTIONS]

Example

docker run --rm -v "${PWD}:/~" -v "riscv-gnu-toolchain:/tmp" riscv-gnu-toolchain-builder --with-arch=rv32i --with-abi=ilp32 --disable-linux --with-newlib

1. --with-arch=rv32i: Specifies the RISC-V architecture. RV32I is a common minimal architecture for 32-bit processors.
2. --with-abi=ilp32: Specifies the ABI (Application Binary Interface). ILP32 is typically used with RV32I.
3. --disable-linux: Disables the building of Linux-specific components, focusing on bare-metal support.
4. --with-newlib: Includes the newlib C library, which is lightweight and suitable for bare-metal environments.

License

This project is licensed under the MIT License. See LICENSE for more details.