TOOLCHAIN.ECLASS

Section: eclass-manpages (5)
Updated: Jul 2025
Index Return to Main Contents

NAME

toolchain.eclass - Common code for sys-devel/gcc ebuilds

DESCRIPTION

Common code for sys-devel/gcc ebuilds (and occasionally GCC forks, like GNAT for Ada). If not building GCC itself, please use toolchain-funcs.eclass instead.

SUPPORTED EAPIS

7 8

FUNCTIONS

tc_version_is_at_least ver1 [ver2]

General purpose version check. Without a second argument, matches up to minor version (x.x.x).

tc_version_is_between ver1 ver2

General purpose version range check. Note that it matches up to but NOT including the second version

_get_bootstrap_gcc_info [gcc_pkg|gcc_bin_base]...

Get some information about the gcc that would be used to build this package. All the variables that are passed as arguments will be set to their apropriate values:

- bootstrap_gcc_pkg = the ${CATEGORY}/${PN} that provides the build gcc

- bootstrap_gcc_bin_base = the directory up to /gcc-bin but excluding the slot, of the aformentioned package.

ECLASS VARIABLES

TOOLCHAIN_GCC_PV: Used to override GCC version. Useful for e.g. live ebuilds or snapshots. Defaults to ${PV}.
TOOLCHAIN_GCC_VALIDATE_FAILURES_VERSION: Version of test comparison script (validate_failures.py) to use.
TOOLCHAIN_USE_GIT_PATCHES: Used to force fetching patches from git. Useful for non-released versions of GCC where we don't want to keep creating patchset tarballs for a new release series (e.g. suppose 12.0 just got released, then adding snapshots for 13.0, we don't want to create new patchsets for every single 13.0 snapshot, so just grab patches from git each time if this variable is set).
GCC_TESTS_COMPARISON_DIR ?= ${BROOT}/var/cache/gcc/testresults/${CHOST} (USER VARIABLE): Source of previous GCC test results and location to store new results.
GCC_TESTS_COMPARISON_SLOT ?= ${SLOT} (USER VARIABLE): Slot to compare test results with. Defaults to current slot.
GCC_TESTS_IGNORE_NO_BASELINE (USER VARIABLE): Ignore missing baseline/reference data and create new baseline.
GCC_TESTS_REGEN_BASELINE (USER VARIABLE): Ignore baseline/reference data and create new baseline.
GCC_TESTS_CHECK_TARGET ?= check (USER VARIABLE): Defaults to 'check'. Allows choosing a different test target, e.g. 'test-gcc' (https://gcc.gnu.org/install/test.html).
GCC_TESTS_RUNTESTFLAGS (USER VARIABLE): Extra options to pass to DejaGnu as RUNTESTFLAGS.
TOOLCHAIN_PATCH_DEV: Indicate the developer who hosts the patchset for an ebuild.
TOOLCHAIN_HAS_TESTS: Controls whether python-any-r1 is inherited and validate_failures.py is used.
TOOLCHAIN_PATCH_SUFFIX: Used to override compression used for for patchsets. Default is xz for EAPI 8+ and bz2 for older EAPIs.
TOOLCHAIN_SET_S ?= yes: Used to override value of S for snapshots and such. Mainly useful if needing to set GCC_TARBALL_SRC_URI.

MAINTAINERS

Toolchain Ninjas <toolchain@gentoo.org>

REPORTING BUGS

Please report bugs via https://bugs.gentoo.org/

FILES

toolchain.eclass

This document was created by man2html, using the manual pages.
Time: 03:27:01 GMT, July 14, 2025