SYSROOT.ECLASS

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

NAME

sysroot.eclass - Common functions for using a different (sys)root

DESCRIPTION

This eclass provides common functions to run executables within a different root or sysroot, with or without emulation by QEMU. Despite the name, these functions can be used in src_* or pkg_* phase functions.

SUPPORTED EAPIS

7 8

FUNCTIONS

qemu_arch: Return the QEMU architecture name for the given target or CHOST. This name is used in qemu-user binary filenames, e.g. qemu-ppc64le.
sysroot_make_run_prefixed: Create a wrapper script for directly running executables within a (sys)root without changing the root directory. The path to that script is returned. If no sysroot has been set, then this function returns unsuccessfully.
The script explicitly uses QEMU if this is necessary and it is available in this environment. It may otherwise implicitly use a QEMU outside this environment if binfmt_misc has been used with the F flag. It is not feasible to add a conditional dependency on QEMU.
sysroot_run_prefixed: Create a wrapper script with sysroot_make_run_prefixed if necessary, and use it to execute the given command, otherwise just execute the command directly.

AUTHORS

James Le Cuirot <chewi@gentoo.org>

MAINTAINERS

cross@gentoo.org

REPORTING BUGS

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

FILES

sysroot.eclass

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