2019-03-03 20:04:07 +00:00
|
|
|
Usage
|
|
|
|
|
----
|
|
|
|
|
|
2019-10-08 20:44:06 +00:00
|
|
|
There are many environment variable to control Box86 behaviour.
|
2019-03-03 20:04:07 +00:00
|
|
|
|
|
|
|
|
##### BOX86_LOG
|
|
|
|
|
Controls the Verbose level of the log
|
|
|
|
|
* 0
|
2019-10-08 20:44:06 +00:00
|
|
|
* NONE : No message (except some fatal error)
|
2019-03-03 20:04:07 +00:00
|
|
|
* 1
|
|
|
|
|
* INFO : Current default. Show some log
|
|
|
|
|
* 2
|
|
|
|
|
* DEBUG : Verbose a lot of stuffs (like relocations or function called)
|
|
|
|
|
* 3
|
|
|
|
|
* DUMP : All DEBUG plus DUMP of all ELF Info
|
|
|
|
|
|
|
|
|
|
#### BOX86_LD_LIBRARY_PATH
|
|
|
|
|
Controls the folder scanned to look for x86 libs. Default is current folder and `lib` in current folder.
|
|
|
|
|
Also `/usr/lib/i386-linux-gnu` and `/lib/i386-linux-gnu` are added if they exists
|
|
|
|
|
|
|
|
|
|
#### BOX86_PATH
|
|
|
|
|
Controls the folder scanned to look for x86 executable. Default is current folder and `bin` in current folder.
|
|
|
|
|
|
|
|
|
|
#### BOX86_DLSYM_ERROR
|
|
|
|
|
* 0 : default. Don't log `dlsym` error
|
|
|
|
|
* 1 : Log dlsym error
|
|
|
|
|
|
|
|
|
|
#### BOX86_TRACE_FILE
|
|
|
|
|
Send all log and trace to a file instead of `stdout`
|
|
|
|
|
|
|
|
|
|
#### BOX86_TRACE
|
|
|
|
|
Only on build with trace enabled. Trace allow the logging of all instruction execute, along with register dump
|
|
|
|
|
* 0 : No trace
|
2019-07-10 05:41:21 +00:00
|
|
|
* 1 : Trace enabled. The trace start after the init of all depending libs is done
|
2019-03-03 20:04:07 +00:00
|
|
|
* symbolname : Trace only `symbolname` (trace is disable if the symbol is not found)
|
|
|
|
|
* 0xXXXXXXX-0xYYYYYYY : trace only between the 2 addresses
|
|
|
|
|
|
2019-07-10 05:41:21 +00:00
|
|
|
#### BOX86_TRACE_INIT
|
|
|
|
|
Use BOX86_TRACE_INIT instead of BOX_TRACE to start trace before init of Libs and main program
|
|
|
|
|
* 0 : No trace
|
|
|
|
|
* 1 : Trace enabled. The trace start with the init of all depending libs is done
|
|
|
|
|
|
2019-03-03 20:04:07 +00:00
|
|
|
#### BOX86_TRACE_START
|
|
|
|
|
Only on build with trace enabled.
|
2019-10-08 20:44:06 +00:00
|
|
|
* NNNNNNN : Start trace only after NNNNNNNN opcode execute (number is an `uint64_t`)
|
2019-03-03 20:04:07 +00:00
|
|
|
|
|
|
|
|
#### BOX86_TRACE_XMM
|
|
|
|
|
Only on build with trace enabled.
|
|
|
|
|
* 0 : Default, the XMM (i.e. SSE/SSE2) register will not be logged with the general and x87 registers
|
|
|
|
|
* 1 : Dump the XMM registers
|
|
|
|
|
|
2019-03-18 16:28:21 +00:00
|
|
|
#### BOX86_LOAD_ADDR
|
|
|
|
|
Try to load at 0xXXXXXX main binaray (if binary is a PIE)
|
2019-07-10 05:41:21 +00:00
|
|
|
* 0xXXXXXXXX the load address (only active on PIE programs)
|
|
|
|
|
|
|
|
|
|
#### BOX86_NOSIGSEGV
|
|
|
|
|
To disable handling of SigSEGV (to ease debugging mainly)
|
|
|
|
|
* 0 : default, let x86 program set sighandler for SEGV
|
2019-08-15 13:08:14 +00:00
|
|
|
* 1 : disable handling of SigSEGV
|
|
|
|
|
|
|
|
|
|
#### BOX86_X11COLOR16
|
|
|
|
|
PANDORA only: to try convert X11 color from 32 bits to 16 bits (to avoid light green on light cyan windows
|
|
|
|
|
* 0 : default, don't touch X11 colors
|
|
|
|
|
* 1 : Change colors arguments in XSetForeground, XSetBackground and XCreateGC
|
2019-10-15 12:39:33 +00:00
|
|
|
|
2019-12-21 14:13:15 +00:00
|
|
|
#### BOX86_X11THREADS
|
|
|
|
|
To call XInitThreads when loading X11 (for old Loki games with Loki_Compat lib)
|
|
|
|
|
* 0 : default, don't force call XInitThreads
|
|
|
|
|
* 1 : Call XInitThreads as soon as libX11 is loaded
|
|
|
|
|
|
2019-10-15 12:39:33 +00:00
|
|
|
#### BOX86_DYNAREC_LOG
|
|
|
|
|
Set level of DynaRec log
|
|
|
|
|
* 0 :
|
|
|
|
|
* NONE : No Log for DynaRec
|
|
|
|
|
* 1 :
|
|
|
|
|
* INFO : Minimum Dynarec Log (only unimplemented OpCode)
|
|
|
|
|
* 2 :
|
|
|
|
|
* DEBUG : Debug Log for Dynarec (with detail on block created / executed)
|
|
|
|
|
* 3 :
|
|
|
|
|
* DUMP : All above plus dump of the x86 -> native opcode conversions
|
|
|
|
|
|
|
|
|
|
#### BOX86_DYNAREC
|
|
|
|
|
* 0 : Disable Dynarec
|
|
|
|
|
* 1 : Enable Dynarec (default)
|
|
|
|
|
|
|
|
|
|
#### BOX86_DYNAREC_LINKER
|
|
|
|
|
* 0 : Disable Dynarec Linker (use that on debug, with dynarec log >= 2, to have detail on wich block get executed)
|
|
|
|
|
* 1 : Enable Dynarec Linker (default)
|
|
|
|
|
|
|
|
|
|
#### BOX86_DYNAREC_TRACE
|
|
|
|
|
* 0 : Disable trace for generated code (default)
|
|
|
|
|
* 1 : Enable trace for generated code (like regular Trace, this will slow down a lot and generate huge logs)
|
2019-12-03 22:25:08 +00:00
|
|
|
|
|
|
|
|
#### BOX86_LIBGL
|
|
|
|
|
* libXXXX set the name for libGL (default to libGL.so.1)
|
|
|
|
|
* /PATH/TO/libGLXXX set the name and path for libGL
|
2019-12-05 22:36:40 +00:00
|
|
|
You can also use SDL_VIDEO_GL_DRIVER
|
|
|
|
|
|
|
|
|
|
#### BOX86_LD_PRELOAD
|
|
|
|
|
* XXXX[:YYYYY] force loading XXXX (and YYYY...) libraries with the binary
|
|
|
|
|
PreLoaded libs can be emulated or native, and are treated the same way as if they were comming from the binary
|
2020-01-05 14:47:10 +00:00
|
|
|
|
|
|
|
|
#### BOX86_EMULATED_LIBS
|
|
|
|
|
* XXXX[:YYYYY] force lib XXXX (and YYYY...) to be emulated (and not wrapped)
|
|
|
|
|
Some games use old version of some lib, with an ABI incompatible with native version.
|
2020-01-27 16:22:02 +00:00
|
|
|
Note that LittleInforno for example is auto detected, and libvorbis.so.0 is automatical added to emulated libs
|
|
|
|
|
|
|
|
|
|
#### BOX86_ALLOWMISSINGLIBS
|
|
|
|
|
Allow box86 to continue even if a lib is missing
|
|
|
|
|
* 0 : default, stop if a lib cannot be loaded
|
|
|
|
|
* 1 : continue even if a needed lib cannot be loaded. Unadvised, this will, in most cases, crash later on.
|
|
|
|
|
|
