Environment Variables
This is a list of Scratchbox specific environment variables that can be set by the user. Some of them are already set in /scratchbox/etc/profile.
Redirector variables
SBOX_REDIRECT_FROM_DIRS
SBOX_REDIRECT_TO_DIRS
colon-separated list of directories to be used as the sources/destinations of binary redirection
SBOX_REDIRECT_BINARIES
comma-separated list of <source>:<target> pairs which specify explicit binary redirection rules (for example "/usr/bin/make:/scratchbox/tools/bin/make,/bin/cat:/host_usr/bin/dog")
SBOX_REDIRECT_IGNORE
colon-separated list of binaries which should not be redirected
SBOX_REDIRECT_LOG
specifies the filename where each binary redirection will be logged; logging will be disabled if this is not set
System reporting
SBOX_UNAME_SYSNAME
SBOX_UNAME_NODENAME
SBOX_UNAME_RELEASE
SBOX_UNAME_VERSION
SBOX_UNAME_MACHINE
override an uname field; see uname(1) or uname(2) manpage
Transparency device settings
SBOX_DISABLE_CPUTRANSPARENCY
"yes" or "no" (CPU-transparency is enabled by default)
SBOX_CPUTRANSPARENCY_LOG
specifies the filename where each CPU-transparency invocation will be logged; logging will be disabled if this is not set
SBOX_CPUTRANSPARENCY_VERBOSE
if enabled, a notice is printed to stderr when execution jumps to target system; "yes" or "no"
SBOX_CPUTRANSPARENCY_NOWARN
do not issue a warning when trying to execute a binary that is under /tmp with sbrsh; "yes" or "no"
SBOX_CPUTRANSPARENCY_METHOD
overrides the SBOX_CPUTRANSPARENCY_METHOD field in scratchbox.config, which contains the path to the actual target binary interpreter; good choices are "sbrsh", "qemu-arm", "qemu-ppc", etc.
SBOX_CPUTRANSPARENCY_FILTER
path to an executable (that is compiled for the target) that gets run whenever a command needs to be run on the target; the executable receives the command and the command's arguments as its arguments; this can be a shell script if a shell is compiled for the target system
SBOX_RLIMIT_<key>
sets a resource limit before executing commands with CPU-transparency; see sbrsh/README or setrlimit(2) manpage for details
SBOX_PRELOAD <host1:host..>,<target1:target..>
Comma-separated list of host and target preload libraries.
Compiling variables
SBOX_DEFAULT_GCC_PREFIX
overrides the SBOX_DEFAULT_GCC_PREFIX field in scratchbox.config, used by the compiler wrapper
SBOX_LD_FAKE_NATIVE
if set, the linker wrapper uses ld_fake_native instead of ld_orig
SBOX_USE_CCACHE
should the compiler wrapper automatically use ccache? "yes" or "no"
Extra and Block args
SBOX_EXTRA_ARGS
passes additional parameters to all programs executed via the compiler wrapper (see below for a list of affected programs)
SBOX_BLOCK_ARGS
suppresses selected parameters of all programs executed via the compiler wrapper (see below for a list of affected programs)
|
SBOX_EXTRA_COMPILER_ARGS |
SBOX_BLOCK_COMPILER_ARGS |
|
* affects only compilers; overrides the more general form |
|
|
SBOX_EXTRA_CROSS_COMPILER_ARGS |
SBOX_BLOCK_CROSS_COMPILER_ARGS |
|
* affects only cross compilers; (overrides the more general form?) |
|
|
SBOX_EXTRA_CC_ARGS |
SBOX_BLOCK_CC_ARGS |
|
SBOX_EXTRA_CXX_ARGS |
SBOX_BLOCK_CXX_ARGS |
|
SBOX_EXTRA_CPP_ARGS |
SBOX_BLOCK_CPP_ARGS |
|
* affects only specific compiler type; overrides the more general forms |
|
|
SBOX_EXTRA_LD_ARGS |
SBOX_BLOCK_LD_ARGS |
|
* affects only the linker; overrides the more general form |
|
|
SBOX_EXTRA_ADDR2LINE_ARGS |
SBOX_BLOCK_ADDR2LINE_ARGS |
|
SBOX_EXTRA_AR_ARGS |
SBOX_BLOCK_AR_ARGS |
|
SBOX_EXTRA_AS_ARGS |
SBOX_BLOCK_AS_ARGS |
|
SBOX_EXTRA_CXXFILT_ARGS |
SBOX_BLOCK_CXXFILT_ARGS |
|
SBOX_EXTRA_GCCBUG_ARGS |
SBOX_BLOCK_GCCBUG_ARGS |
|
SBOX_EXTRA_GCOV_ARGS |
SBOX_BLOCK_GCOV_ARGS |
|
SBOX_EXTRA_NM_ARGS |
SBOX_BLOCK_NM_ARGS |
|
SBOX_EXTRA_OBJCOPY_ARGS |
SBOX_BLOCK_OBJCOPY_ARGS |
|
SBOX_EXTRA_OBJDUMP_ARGS |
SBOX_BLOCK_OBJDUMP_ARGS |
|
SBOX_EXTRA_RANLIB_ARGS |
SBOX_BLOCK_RANLIB_ARGS |
|
SBOX_EXTRA_READELF_ARGS |
SBOX_BLOCK_READELF_ARGS |
|
SBOX_EXTRA_SIZE_ARGS |
SBOX_BLOCK_SIZE_ARGS |
|
SBOX_EXTRA_STRINGS_ARGS |
SBOX_BLOCK_STRINGS_ARGS |
|
SBOX_EXTRA_STRIP_ARGS |
SBOX_BLOCK_STRIP_ARGS |
|
* affects only a specific utility; overrides the more general form |
|
Generic variables
SBOX_SCRATCHBOX_CONFIG
overrides the location of /targets/links/scratchbox.config, used by the compiler wrapper
SBOX_BLOCK_<program>
blocks the execution of a program completely; the value can be either "yes" (normal return), "no" or a return code that will be used when blocking the program; <program> is one of the programs used with the *_ARGS forms (except "COMPILER")
SBOX_ENV_<var>
sets <var> to the environments of commands executed with sbrsh and qemu; "(UNSET)" removes <var> from the environment
SBOX_READLINK_HACK
if set, readlink will be wrapped so that if the "/proc/PID/exe" symlink of a CPU-transparency method process is accessed, its first foreign binary executable commandline argument is returned instead. Only works if set to "yes", this is also default.
SBOX_DEFAULT_AUTOMAKE
Specifies which automake version the 'automake' command points to. Available versions are "1.4", "1.7" and "1.8" (default).
SBOX_DEFAULT_AUTOCONF
Specifies which autoconf version the 'autoconf' command points to. Available versions are "2.13" and "2.59" (you can also specify "2.50" which is an alias for 2.59). The default is to automatically guess the appropriate version, so you should not set this variable under normal circumstances.
SBOX_DEFAULT_FLEX
Specifies which flex version the 'flex' command points to. Available versions are "0.4.5" and "0.4.31" (default). "old" is an alias for "0.4.5".