aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorTsukasa OI <research_trasio@irq.a4lg.com>2023-11-30 05:02:45 +0000
committerTsukasa OI <research_trasio@irq.a4lg.com>2023-11-30 05:10:17 +0000
commitc3bb5cae80ef4d892b0488bdfd8644d6953e7c2a (patch)
treeb121e0ec636c4d52de1716ed52774f5768603002
parenta19f6714278f6bef51bc1f87e7e15c812ad645ce (diff)
downloadriscv-gnu-toolchain-c3bb5cae80ef4d892b0488bdfd8644d6953e7c2a.zip
riscv-gnu-toolchain-c3bb5cae80ef4d892b0488bdfd8644d6953e7c2a.tar.gz
riscv-gnu-toolchain-c3bb5cae80ef4d892b0488bdfd8644d6953e7c2a.tar.bz2
Document prerequisite on testing
pyelftools is required for a helper script. This commit adds basic installation guide to install pyelftools and removes "automatic installation" of pyelftools from Makefile.
-rw-r--r--Makefile.in6
-rw-r--r--README.md28
2 files changed, 29 insertions, 5 deletions
diff --git a/Makefile.in b/Makefile.in
index e8443ca..a1f677a 100644
--- a/Makefile.in
+++ b/Makefile.in
@@ -204,7 +204,7 @@ report-gdb: report-gdb-@default_target@
ifeq ($(SIM),qemu)
SIM_PATH:=$(srcdir)/scripts/wrapper/qemu:$(srcdir)/scripts
SIM_PREPARE:=PATH="$(SIM_PATH):$(INSTALL_DIR)/bin:$(PATH)" RISC_V_SYSROOT="$(SYSROOT)"
-SIM_STAMP:= stamps/build-qemu stamps/install-python-package
+SIM_STAMP:= stamps/build-qemu
else
ifeq ($(SIM),spike)
# Using spike simulator.
@@ -906,10 +906,6 @@ stamps/build-pk64: $(PK_SRCDIR) $(PK_SRC_GIT) stamps/build-gcc-newlib-stage2
mkdir -p $(dir $@)
date > $@
-stamps/install-python-package:
- python3 -m pip install --user pyelftools
- date > $@
-
stamps/build-qemu: $(QEMU_SRCDIR) $(QEMU_SRC_GIT)
rm -rf $@ $(notdir $@)
mkdir $(notdir $@)
diff --git a/README.md b/README.md
index 21dd68e..0284268 100644
--- a/README.md
+++ b/README.md
@@ -193,6 +193,34 @@ 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.
+
+#### Additional Prerequisite
+
+A helper script to setup testing environment requires
+[pyelftools](https://github.com/eliben/pyelftools).
+
+On newer versions of Ubuntu, executing the following command
+should suffice:
+
+ $ sudo apt-get install python3-pyelftools
+
+On newer versions of Fedora and CentOS/RHEL OS (9 or later), executing
+the following command should suffice:
+
+ $ sudo yum install python3-pyelftools
+
+On Arch Linux, executing the following command should suffice:
+
+ $ sudo pacman -Syyu python-pyelftools
+
+If your distribution/OS does not have pyelftools package, you can install
+it using PIP.
+
+ # Assuming that PIP is installed
+ $ pip3 install --user pyelftools
+
+#### Testing GCC
+
To test GCC, run the following commands:
./configure --prefix=$RISCV --disable-linux --with-arch=rv64ima # or --with-arch=rv32ima