From de1212de3d2c3d2e39ed77a4ee8aebf08208e3ae Mon Sep 17 00:00:00 2001 From: Tobias Rosenkranz Date: Thu, 3 Jul 2025 16:59:28 +0200 Subject: [PATCH] Updated buildenv documentation --- ci/docker/buildenv/README.rst | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/ci/docker/buildenv/README.rst b/ci/docker/buildenv/README.rst index 64d82509b..5ee9e4e95 100644 --- a/ci/docker/buildenv/README.rst +++ b/ci/docker/buildenv/README.rst @@ -13,7 +13,7 @@ Verilator build. It uses the following parameters: - Source revision (default: master) -- Compiler (GCC 10.3.0, clang 10.0.0, default: 10.3.0) +- Compiler (GCC 13.3.0, clang 18.1.3, default: 13.3.0) The container is published as ``verilator/verilator-buildenv`` on `docker hub @@ -31,18 +31,18 @@ To also run tests: docker run -ti verilator/verilator-buildenv test -To change the compiler: +To change the compiler use the `-e` switch to pass environment variables: :: - docker run -ti -e CC=clang-10 -e CXX=clang++-10 verilator/verilator-buildenv test + docker run -ti -e CC=clang-18 -e CXX=clang++-18 verilator/verilator-buildenv test -The tests that involve gdb are not working due to security restrictions. -To run those too: +The tests, that involve numactl are not working due to security restrictions. +To run those too, add the CAP_SYS_NICE capability during the start of the container: :: - docker run -ti -e CC=clang-10 -e CXX=clang++-10 --cap-add=SYS_PTRACE --security-opt seccomp=unconfined verilator/verilator-buildenv test + docker run -ti --cap-add=CAP_SYS_NICE verilator/verilator-buildenv test Rather then building using a remote git repository you may prefer to use a working copy on the local filesystem. Mount the local working copy path as @@ -52,7 +52,7 @@ top of a repository: :: - docker run -ti -v ${PWD}:/tmp/repo -e REPO=/tmp/repo -e REV=`git rev-parse --short HEAD` --cap-add=SYS_PTRACE --security-opt seccomp=unconfined verilator/verilator-buildenv test + docker run -ti -v ${PWD}:/tmp/repo -e REPO=/tmp/repo -e REV=`git rev-parse --short HEAD` verilator/verilator-buildenv test Rebuilding