https://github.com/riscv-collab/riscv-gnu-toolchain Skip to content Toggle navigation Sign up * Product + Actions Automate any workflow + Packages Host and manage packages + Security Find and fix vulnerabilities + Codespaces Instant dev environments + Copilot Write better code with AI + Code review Manage code changes + Issues Plan and track work + Discussions Collaborate outside of code Explore + All features + Documentation + GitHub Skills + Blog * Solutions For + Enterprise + Teams + Startups + Education By Solution + CI/CD & Automation + DevOps + DevSecOps Case Studies + Customer Stories + Resources * Open Source + GitHub Sponsors Fund open source developers + The ReadME Project GitHub community articles Repositories + Topics + Trending + Collections * Pricing [ ] * # In this repository All GitHub | Jump to | * No suggested jump to results * # In this repository All GitHub | Jump to | * # In this organization All GitHub | Jump to | * # In this repository All GitHub | Jump to | Sign in Sign up {{ message }} riscv-collab / riscv-gnu-toolchain Public * Notifications * Fork 859 * Star 2.3k GNU toolchain for RISC-V, including GCC License View license 2.3k stars 859 forks Star Notifications * Code * Issues 27 * Pull requests 3 * Actions * Projects 0 * Wiki * Security * Insights More * Code * Issues * Pull requests * Actions * Projects * Wiki * Security * Insights riscv-collab/riscv-gnu-toolchain This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository. master Switch branches/tags [ ] Branches Tags Could not load branches Nothing to show {{ refName }} default View all branches Could not load tags Nothing to show {{ refName }} default View all tags Name already in use A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch? Cancel Create 5 branches 55 tags Code * Local * Codespaces * Clone HTTPS GitHub CLI [https://github.com/r] Use Git or checkout with SVN using the web URL. [gh repo clone riscv-] Work fast with our official CLI. Learn more. * Open with GitHub Desktop * Download ZIP Sign In Required Please sign in to use Codespaces. Launching GitHub Desktop If nothing happens, download GitHub Desktop and try again. Launching GitHub Desktop If nothing happens, download GitHub Desktop and try again. Launching Xcode If nothing happens, download Xcode and try again. Launching Visual Studio Code Your codespace will open once ready. There was a problem preparing your codespace, please try again. Latest commit @kito-cheng kito-cheng Merge pull request #1207 from mga-sc/master ... 170a9a3 Mar 13, 2023 Merge pull request #1207 from mga-sc/master [NEWLIB][Cross-build]: Fix merge-newlib-nano. 170a9a3 Git stats * 1,041 commits Files Permalink Failed to load latest commit information. Type Name Latest commit message Commit time .github binutils @ b2bc62b contrib dejagnu @ d51e3f9 gcc @ 2ee5e43 gdb @ e53a8e8 glibc @ a704fd9 linux-headers/include musl @ 85e0e35 newlib @ 415fdd4 pk @ 2efabd3 qemu @ 621da77 regression scripts spike @ a0298a3 test .gitignore .gitmodules LICENSE Makefile.in README.md configure configure.ac View code [ ] RISC-V GNU Compiler Toolchain Getting the sources Prerequisites Installation (Newlib) Installation (Linux) Installation (Newlib/Linux multilib) Troubleshooting Build Problems Advanced Options Set default ISA spec version Build with customized multi-lib configure. Test Suite Selecting the tests to run in GCC's regression test suite Testing GCC, Binutils, and glibc of a Linux toolchain Development Update Source Tree How to Check Which Branch are Used for Specific submodule Use Source Tree Other Than riscv-gnu-toolchain README.md RISC-V GNU Compiler Toolchain This is the RISC-V C and C++ cross-compiler. It supports two build modes: a generic ELF/Newlib toolchain and a more sophisticated Linux-ELF/glibc toolchain. Getting the sources This repository uses submodules, but submodules will fetch automatically on demand, so --recursive or git submodule update --init --recursive is not needed. $ git clone https://github.com/riscv/riscv-gnu-toolchain Warning: git clone takes around 6.65 GB of disk and download size Prerequisites Several standard packages are needed to build the toolchain. On Ubuntu, executing the following command should suffice: $ sudo apt-get install autoconf automake autotools-dev curl python3 libmpc-dev libmpfr-dev libgmp-dev gawk build-essential bison flex texinfo gperf libtool patchutils bc zlib1g-dev libexpat-dev ninja-build On Fedora/CentOS/RHEL OS, executing the following command should suffice: $ sudo yum install autoconf automake python3 libmpc-devel mpfr-devel gmp-devel gawk bison flex texinfo patchutils gcc gcc-c++ zlib-devel expat-devel On Arch Linux, executing the following command should suffice: $ sudo pacman -Syyu autoconf automake curl python3 libmpc mpfr gmp gawk base-devel bison flex texinfo gperf libtool patchutils bc zlib expat Also available for Arch users on the AUR: https://aur.archlinux.org/ packages/riscv-gnu-toolchain-bin On OS X, you can use Homebrew to install the dependencies: $ brew install python3 gawk gnu-sed gmp mpfr libmpc isl zlib expat texinfo flock To build the glibc (Linux) on OS X, you will need to build within a case-sensitive file system. The simplest approach is to create and mount a new disk image with a case sensitive format. Make sure that the mount point does not contain spaces. This is not necessary to build newlib or gcc itself on OS X. This process will start by downloading about 200 MiB of upstream sources, then will patch, build, and install the toolchain. If a local cache of the upstream sources exists in $(DISTDIR), it will be used; the default location is /var/cache/distfiles. Your computer will need about 8 GiB of disk space to complete the process. Installation (Newlib) To build the Newlib cross-compiler, pick an install path (that is writeable). If you choose, say, /opt/riscv, then add /opt/riscv/bin to your PATH. Then, simply run the following command: ./configure --prefix=/opt/riscv make You should now be able to use riscv64-unknown-elf-gcc and its cousins. Installation (Linux) To build the Linux cross-compiler, pick an install path (that is writeable). If you choose, say, /opt/riscv, then add /opt/riscv/bin to your PATH. Then, simply run the following command: ./configure --prefix=/opt/riscv make linux The build defaults to targeting RV64GC (64-bit) with glibc, even on a 32-bit build environment. To build the 32-bit RV32GC toolchain, use: ./configure --prefix=/opt/riscv --with-arch=rv32gc --with-abi=ilp32d make linux In case you prefer musl libc over glibc, configure just like above and opt for make musl instead of make linux. Supported architectures are rv32i or rv64i plus standard extensions (a)tomics, (m)ultiplication and division, (f)loat, (d)ouble, or (g) eneral for MAFD. Supported ABIs are ilp32 (32-bit soft-float), ilp32d (32-bit hard-float), ilp32f (32-bit with single-precision in registers and double in memory, niche use only), lp64 lp64f lp64d (same but with 64-bit long and pointers). Installation (Newlib/Linux multilib) To build either cross-compiler with support for both 32-bit and 64-bit, run the following command: ./configure --prefix=/opt/riscv --enable-multilib And then either make, make linux or make musl for the Newlib, Linux glibc-based or Linux musl libc-based cross-compiler, respectively. The multilib compiler will have the prefix riscv64-unknown-elf- or riscv64-unknown-linux-gnu- but will be able to target both 32-bit and 64-bit systems. It will support the most common -march/-mabi options, which can be seen by using the --print-multi-lib flag on either cross-compiler. The musl compiler (riscv64-unknown-linux-musl-) will only be able to target 64-bit systems due to limitations in the upstream musl architecture support. The --enable-multilib flag therefore does not actually enable multilib support for musl libc. Troubleshooting Build Problems Builds work best if installing into an empty directory. If you build a hard-float toolchain and then try to build a soft-float toolchain with the same --prefix directory, then the build scripts may get confused and exit with a linker error complaining that hard float code can't be linked with soft float code. Removing the existing toolchain first, or using a different prefix for the second build, avoids the problem. It is OK to build one newlib and one linux toolchain with the same prefix. But you should avoid building two newlib or two linux toolchains with the same prefix. If building a linux toolchain on a MacOS system, or on a Windows system using the Linux subsystem or cygwin, you must ensure that the filesystem is case-sensitive. A build on a case-insensitive filesystem will fail when building glibc because *.os and *.oS files will clobber each other during the build eventually resulting in confusing link errors. Centos (and RHEL) provide old GNU tools versions that may be too old to build a RISC-V toolchain. There is an alternate toolset provided that includes current versions of the GNU tools. This is the devtoolset provided as part of the Software Collection service. For more info, see the devtoolset-7 URL. There are various versions of the devtoolset that are available, so you can also try other versions of it, but we have at least one report that devtoolset-7 works. Advanced Options There are a number of additional options that may be passed to configure. See './configure --help' for more details. Also you can define extra flags to pass to specific projects: BINUTILS_NATIVE_FLAGS_EXTRA, BINUTILS_TARGET_FLAGS_EXTRA, GCC_EXTRA_CONFIGURE_FLAGS, GDB_NATIVE_FLAGS_EXTRA, GDB_TARGET_FLAGS_EXTRA, GLIBC_NATIVE_FLAGS_EXTRA, GLIBC_TARGET_FLAGS_EXTRA. Example: GCC_EXTRA_CONFIGURE_FLAGS= --with-gmp=/opt/gmp make linux Set default ISA spec version --with-isa-spec= can specify the default version of the RISC-V Unprivileged (formerly User-Level) ISA specification. Possible options are: 2.2, 20190608 and 20191213. The default version is 2.2. More details about this option you can refer this post RISC-V GNU toolchain bumping default ISA spec to 20191213. Build with customized multi-lib configure. --with-multilib-generator= can specify what multilibs to build. The argument is a semicolon separated list of values, possibly consisting of a single value. Currently only supported for riscv*--elf. The accepted values and meanings are given below. Every config is constructed with four components: architecture string, ABI, reuse rule with architecture string and reuse rule with sub-extension. Re-use part support expansion operator (*) to simplify the combination of different sub-extensions, example 4 demonstrate how it uses and works. Example 1: Add multi-lib support for rv32i with ilp32. ./configure --with-multilib-generator="rv32i-ilp32--" Example 2: Add multi-lib support for rv32i with ilp32 and rv32imafd with ilp32. ./configure --with-multilib-generator="rv32i-ilp32--;rv32imafd-ilp32--" Example 3: Add multi-lib support for rv32i with ilp32; rv32im with ilp32 and rv32ic with ilp32 will reuse this multi-lib set. ./configure --with-multilib-generator="rv32i-ilp32-rv32im-c" Example 4: Add multi-lib support for rv64ima with lp64; rv64imaf with lp64, rv64imac with lp64 and rv64imafc with lp64 will reuse this multi-lib set. ./configure --with-multilib-generator="rv64ima-lp64--f*c" Test Suite The Dejagnu test suite has been ported to RISC-V. This can be run with a simulator for the elf and linux toolchains. The simulator can be selected by the SIM variable in the Makefile, e.g. SIM=qemu, SIM= gdb, or SIM=spike (experimental).In addition, the simulator can also be selected with the configure time option --with-sim=.However, the testsuite allowlist is only mintained for qemu.Other simulators might get extra failures. To test GCC, run the following commands: ./configure --prefix=$RISCV --disable-linux --with-arch=rv64ima # or --with-arch=rv32ima make newlib make report-newlib SIM=gdb # Run with gdb simulator ./configure --prefix=$RISCV make linux make report-linux SIM=qemu # Run with qemu ./configure --prefix=$RISCV --with-sim=spike make linux make report # Run with spike Note: * spike only support rv64* bare-metal/elf toolchain. * gdb simulator only support bare-metal/elf toolchain. Selecting the tests to run in GCC's regression test suite By default GCC will execute all tests of its regression test suite. While running them in parallel (e.g. make -j$(nproc) report) will significanlty speed up the execution time on multi-processor systems, the required time for executing all tests is usually too high for typical development cycles. Therefore GCC allows to select the tests that are being executed using the environment variable RUNTESTFLAGS. To restrict a test run to only RISC-V specific tests the following command can be used: RUNTESTFLAGS="riscv.exp" make report To to restrict a test run to only RISC-V specific tests with match the pattern "zb*.c" and "sm*.c" the following command can be used: RUNTESTFLAGS="riscv.exp=zb*.c\ sm*.c" make report Testing GCC, Binutils, and glibc of a Linux toolchain The default Makefile target to run toolchain tests is report. This will run all tests of the GCC regression test suite. Alternatively, the following command can be used to do the same: make check-gcc The following command can be used to run the Binutils tests: make check-binutils The command below can be used to run the glibc tests: make check-glibc-linux Development This section is only for developer or advanced user, or you want to build toolchain with your own source tree. Update Source Tree riscv-gnu-toolchain contain stable but not latest source for each submodule, in case you want to using latest develoment tree, you can use following command to upgrade all submodule. git submodule update --remote Or you can upgrade specific submodule only. git submodule update --remote For example, upgrade riscv-gcc only, you can using following command: git submodule update --remote riscv-gcc How to Check Which Branch are Used for Specific submodule The branch info has recorded in .gitmodules file, which can set or update via git submodule add -b or git submodule set-branch. However the only way to check which branch are using is to check .gitmodules file, here is the example for riscv-gcc, it using riscv-gcc-10.2.0 branch, so it will has a section named riscv-gcc and has a field branch is riscv-gcc-10.2.0. [submodule "riscv-gcc"] path = riscv-gcc url = ../riscv-gcc.git branch = riscv-gcc-10.2.0 Use Source Tree Other Than riscv-gnu-toolchain riscv-gnu-toolchain also support using out-of-tree source to build toolchain, there is couple configure option to specify the source tree of each submodule/component. For example you have a gcc in $HOME/gcc, use --with-gcc-src can specify that: ./configure --with-gcc-src=$HOME/gcc Here is the list of configure option for specify source tree: --with-gcc-src --with-binutils-src --with-newlib-src --with-glibc-src --with-musl-src --with-gdb-src --with-linux-headers-src --with-qemu-src --with-spike-src --with-pk-src About GNU toolchain for RISC-V, including GCC Resources Readme License View license Stars 2.3k stars Watchers 132 watching Forks 859 forks Report repository Releases 55 tags Packages 0 No packages published Contributors 59 * @palmer-dabbelt * @kito-cheng * @aswaterman * @cmuellner * @a0u * @darius-bluespec * @timsifive * @florianhofhammer * @kevinpark1217 * @pz9115 * @yunsup + 48 contributors Languages * C 98.6% * Other 1.4% Footer (c) 2023 GitHub, Inc. Footer navigation * Terms * Privacy * Security * Status * Docs * Contact GitHub * Pricing * API * Training * Blog * About You can't perform that action at this time. You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.