Configuration

Configuration and environment variables

LATX supports system configuration files, user configuration files, environment variables, and command-line options. To avoid maintaining divergent option tables in the README, Wiki, and troubleshooting guide, the complete reference is maintained in the repository: LATX configuration reference.

It covers:

• configuration precedence and when settings take effect;
• 32-bit and 64-bit system and user configuration paths;
• sections that apply only to one guest program;
• the current semantics of AOT, KZT, software floating point, virtualization hiding, SMC, and AVX CPUID;
• guest runtime selection with LAT_LD_PREFIX, -L, and -runtime-info;
• common logging entry points in debug builds.

Short examples

Enable software floating point for one invocation:

LATX_SOFTFPU=1 latx-x86_64 /path/to/x86_64-program

Show the guest runtime directory currently selected by each translator and the source of that selection:

latx-x86_64 -runtime-info
latx-i386 -runtime-info

Configuration is read when the guest starts and cannot be switched while it is running. When investigating a problem, change one option at a time and make it persistent only after confirming that it works.