1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385 386 387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417 418 419 420 421 422 423 424 425 426 427 428 429 430 431 432 433 434 435 436 437 438 439 440 441 442 443 444 445 446 447 448 449 450 451 452 453 454 455 456 457 458 459 460 461 462 463 464 465 466 467 468 469 470 471 472 473 474 475 476 477 478 479 480 481 482 483 484 485 486 487 488 489 490 491 492 493 494 495 496 497 498 499 500 501 502 503 504 505 506 507 508 509 510 511 512 513 514 515 516 517 518 519 520 521 522 523 524 525 526 527 528 529 530 531 532 533 534 535 536 537 538 539 540 541 542 543 544 545 546 547 548 549 550 551 552 553 554 555 556 557 558 559 560 561 562 563 564 565 566 567 568 569 570 571 572 573 574 575 576 577 578 579 580 581 582 583 584 585 586 587 588 589 590 591 592 593 594 595 596 597 598 599 600 601 602 603 604 605 606 607 608 609 610 611 612 613 614 615 616 617 618 619 620 621 622 623 624 625 626 627 628 629 630 631 632 633 634 635 636 637 638 639 640 641 642 643 644 645 646 647 648 649 650 651 652 653 654 655 656 657 658 659 660 661 662 663 664 665 666 667 668 669 670 671 672 673 674 675 676 677 678 679 680 681 682 683 684 685 686 687 688 689 690 691 692 693 694 695 696 697 698 699 700 701 702 703 704 705 706 707 708 709 710 711 712 713 714 715 716 717 718 719 720 721 722 723 724 725 726 727 728 729 730 731 732 733 734 735 736 737 738 739 740 741 742 743 744 745 746 747 748 749 750 751 752 753 754 755 756 757 758 759 760 761 762 763 764 765 766 767 768 769 770 771 772 773 774 775 776 777 778 779 780 781 782 783 784
|
=head1 NAME
box64 - Linux Userspace x86_64 Emulator with a twist
=head1 SYNOPSIS
B<box64> [B<--help>] [B<--version>] I<executable>
=head1 DESCRIPTION
B<Box64> lets you run x86_64 Linux programs (such as games) on non-x86_64 Linux
systems, like ARM (host system needs to be 64-bit little-endian). Since B<Box64>
uses the native versions of some "system" libraries, like libc, libm, SDL, and
OpenGL, it's easy to integrate and use with most applications, and performance
can be surprisingly high in many cases. B<Box64> integrates with DynaRec (dynamic
recompiler) for the ARM64 platform, providing a speed boost between 5 to 10
times faster than using only the interpreter.
=head1 OPTIONS
=over 8
=item B<-h,--help>
Print box64 help and quit.
=item B<-v,--version>
Print box64 version and quit.
=back
=head1 BRIEF USAGE
There are many environment variables to control B<Box64>'s behaviour. In
addition to environment variables, B<Box64> also looks for 2 places for rcfile:
F</etc/box64.box64rc> and F<~/.box64rc>, in the format of .ini files.
Settings priority: F<~/.box64rc> > F</etc/box64.box64rc> > environment variables.
Example:
[factorio]
BOX64_DYNAREC_SAFEFLAGS=0
BOX64_DYNAREC_BIGBLOCK=2
BOX64_DYNAREC_FORWARD=1024
BOX64_DYNAREC_CALLRET=1
=head1 ENVIRONMENT VARIABLES
=over 8
=item B<BOX64_ADDLIBS> =I<XXXX|XXXX:YYYY:ZZZZ>
Add extras to the needed libraries list, rarely needed.
* XXXX : Add library XXXX to the needed libraries list.
* XXXX:YYYY:ZZZZ : Add library XXXX, YYYY and ZZZZ to the needed libraries list.
=item B<BOX64_ALLOWMISSINGLIBS> =I<0|1>
Allow missing libraries to be ignored.
* 0 : Do not allow missing libraries. [Default]
* 1 : Allow missing libraries.
=item B<BOX64_ARGS> =I<XXXX|XXXX YYYY ZZZZ>
Arguments to pass to the guest program, only valid if there is no existing arguments.
* XXXX : Pass argument XXXX to the program.
* XXXX YYYY ZZZZ : Pass arguments XXXX, YYYY and ZZZZ to the guest program.
=item B<BOX64_BASH> =I<XXXX>
Path to the bash executable.
* XXXX : Use bash executable at path XXXX.
=item B<BOX64_CEFDISABLEGPU> =I<0|1>
Add -cef-disable-gpu argument to the guest program.
* 0 : Does nothing. [Default]
* 1 : Add -cef-disable-gpu argument to the guest program.
=item B<BOX64_CEFDISABLEGPUCOMPOSITOR> =I<0|1>
Add -cef-disable-gpu-compositor argument to the guest program.
* 0 : Does nothing. [Default]
* 1 : Add -cef-disable-gpu-compositor argument to the guest program.
=item B<BOX64_CPUTYPE> =I<0|1>
Specify the CPU type to emulate.
* 0 : Emulate a Intel CPU Model. [Default]
* 1 : Emulate a AMD CPU Model.
=item B<BOX64_CRASHHANDLER> =I<0|1>
Use a dummy crash handler or not.
* 0 : Use emulated crashhandler.so library if nedded.
* 1 : Use an internal dummy (empty) crashhandler.so library. [Default]
=item B<BOX64_DLSYM_ERROR> =I<0|1>
Enable or disable the logging of dlsym errors.
* 0 : Disable the logging of dlsym errors. [Default]
* 1 : Enable the logging of dlsym errors.
=item B<BOX64_DUMP> =I<0|1>
Dump elfloader debug information.
* 0 : Do not dump elfloader debug information. [Default]
* 1 : Dump elfloader debug information.
=item B<BOX64_DYNAREC_ALIGNED_ATOMICS> =I<0|1>
Generate aligned atomics only (only available on Arm64 for now).
* 0 : Generate unaligned atomics handling code. [Default]
* 1 : Generate aligned atomics only, which is faster and smaller code size, but will cause SIGBUS for LOCK prefixed opcodes operating on aligned data addresses.
=item B<BOX64_DYNAREC_BIGBLOCK> =I<0|1|2|3>
Enable building bigger DynaRec code blocks for better performance.
* 0 : Do not try to build block as big as possible, suitable for programs using lots of threads and JIT, like Unity.
* 1 : Build Dynarec block as big as possible.
* 2 : Build Dynarec block bigger, do not stop when block overlaps, but only for blocks in elf memory. [Default]
* 3 : Build Dynarec block bigger, do not stop when block overlaps, for all type of memory, useful for wine programs.
=item B<BOX64_DYNAREC_BLEEDING_EDGE> =I<0|1>
Detect MonoBleedingEdge and apply conservative settings.
* 0 : Do not detect MonoBleedingEdge.
* 1 : Detect MonoBleedingEdge and apply BOX64_DYNAREC_BIGBLOCK=0 BOX64_DYNAREC_STRONGMEM=1 when detected. [Default]
=item B<BOX64_DYNAREC_CALLRET> =I<0|1>
Optimize CALL/RET opcodes.
* 0 : Do not optimize CALL/RET, use jump table. [Default]
* 1 : Try to optimize CALL/RET, skipping the jump table when possible.
=item B<BOX64_DYNAREC_DF> =I<0|1>
Enable or disable the use of deferred flags.
* 0 : Disable the use of deferred flags.
* 1 : Enable the use of deferred flags. [Default]
=item B<BOX64_DYNAREC_DIRTY> =I<0|1>
Allow continue running a block that is unprotected and potentially dirty.
* 0 : Do not allow continue running a block that is unprotected and potentially dirty. [Default]
* 1 : Allow continue to run a dynablock that write data in the same page as code. It can gets faster in loading time of some game but can also get unexpected crashes.
=item B<BOX64_DYNAREC_DIV0> =I<0|1>
Enable or disable the generation of division-by-zero exception.
* 0 : Do not generate thr division-by-zero exception. [Default]
* 1 : Generate the division-by-zero exception.
=item B<BOX64_DYNAREC_DUMP> =I<0|1|2>
Enable DynaRec dump.
* 0 : Do not dump DynaRec blocks. [Default]
* 1 : Dump DynaRec blocks.
* 2 : Dump DynaRec blocks with some colors.
=item B<BOX64_DYNAREC_FASTNAN> =I<0|1>
Enable or disable fast NaN handling.
* 0 : Precisely emulate the -NaN generation like on x86.
* 1 : Do not do anything special with -NAN generation, faster. [Default]
=item B<BOX64_DYNAREC_FASTROUND> =I<0|1|2>
Enable or disable fast rounding.
* 0 : Generate float/double -> int rounding and use current rounding mode for float/double computation like on x86.
* 1 : Do not do anything special with edge case rounding, faster. [Default]
* 2 : Generate float/double -> int rounding using current rounding mode for float/double computation like on x86, but use fast int -> float/double conversion.
=item B<BOX64_DYNAREC_FORWARD> =I<0|128|XXXX>
Define max allowed forward value when building block.
* 0 : No forward value. When current block ends, do not try to go further even if there are previous forward jumps.
* 128 : Allow up to 128 bytes of gap between end of the block and the next forward jump. [Default]
* XXXX : Allow up to XXXX bytes of gap between end of the block and the next forward jump.
=item B<BOX64_DYNAREC_GDBJIT> =I<0|1|2>
The GDBJIT debugging support, only available on build with `-DGDBJIT=ON`, enable it with gdb command: jit-reader-load /usr/local/lib/libbox64gdbjitreader.so.
* 0 : Dynarec will not generate GDBJIT debuginfo. [Default]
* 1 : Dynarec will generate GDBJIT debuginfo.
* 2 : Dynarec will generate detailed GDBJIT debuginfo with internal state.
=item B<BOX64_DYNAREC_LOG> =I<0|1|2|3>
Disable or enable DynaRec logs.
* 0 : Disable DynaRec logs. [Default]
* 1 : Enable minimal DynaRec logs.
* 2 : Enable debug level DynaRec logs.
* 3 : Enable verbose level DynaRec logs.
=item B<BOX64_DYNAREC_MISSING> =I<0|1|2>
Print missing opcodes.
* 0 : Do not print the missing opcode. [Default]
* 1 : Print missing opcodes.
* 2 : Print the fallback to scalar opcodes, only valid on RISC-V.
=item B<BOX64_DYNAREC_NATIVEFLAGS> =I<0|1>
Enable or disable the use of native flags.
* 0 : Do not use native flags.
* 1 : Use native flags when possible. [Default]
=item B<BOX64_DYNAREC_PAUSE> =I<0|1|2|3>
Enable x86 PAUSE emulation, may help the performance of spinlocks.
* 0 : Ignore x86 PAUSE instruction. [Default]
* 1 : Use YIELD to emulate x86 PAUSE instruction.
* 2 : Use WFI to emulate x86 PAUSE instruction.
* 3 : Use SEVL+WFE to emulate x86 PAUSE instruction.
=item B<BOX64_DYNAREC_PERFMAP> =I<0|1>
Generate map file for Linux perf tool.
* 0 : Dynarec will not generate perf map. [Default]
* 1 : Dynarec will generate perf map.
=item B<BOX64_DYNAREC_SAFEFLAGS> =I<0|1|2>
Behaviour of flags emulation on CALL/RET opcodes.
* 0 : Treat CALL/RET as if it never needs any flags.
* 1 : Most of RETs will need flags, most of CALLs will not. [Default]
* 2 : All CALL/RET will need flags.
=item B<BOX64_DYNAREC_STRONGMEM> =I<0|1|2|3>
Enable the emulation of x86 strong memory model.
* 0 : Do not try anything special. [Default]
* 1 : Enable some memory barriers when writing to memory to emulate the x86 strong memory model in a limited way.
* 2 : All in 1, plus memory barriers on SIMD instructions.
* 3 : All in 2, plus more memory barriers on a regular basis.
=item B<BOX64_DYNAREC_TBB> =I<0|1>
Enable or disable libtbb detection.
* 0 : Do not detect libtbb.
* 1 : Detect libtbb and apply conservative settings. [Default]
=item B<BOX64_DYNAREC_TEST> =I<0|1|0xXXXXXXXX-0xYYYYYYYY>
Enable DynaRec execution comparison with the interpreter, very slow, only for testing.
* 0 : No comparison. [Default]
* 1 : Each opcode runs on interpreter and on Dynarec, regs and memory are compared and printed when they differ.
* 0xXXXXXXXX-0xYYYYYYYY : Define the range where dynarec is tested (inclusive-exclusive).
=item B<BOX64_DYNAREC_TRACE> =I<0|1>
Enable or disable DynaRec trace.
* 0 : Do not trace DynaRec blocks. [Default]
* 1 : Trace DynaRec blocks, will slow down the program a lot and generates huge logs.
=item B<BOX64_DYNAREC_WAIT> =I<0|1>
Wait or not for the building of a DynaRec code block to be ready.
* 0 : Do not wait and use interpreter instead, might speedup a bit on massive multithread or JIT programs.
* 1 : Wait for a DynaRec code block to be ready. [Default]
=item B<BOX64_DYNAREC_WEAKBARRIER> =I<0|1|2>
Tweak the memory barriers to reduce the performance impact by strong memory emualtion.
* 0 : Use regular safe barrier.
* 1 : Use weak barriers to have more performance boost. [Default]
* 2 : All in 1, plus disabled the last write barriers.
=item B<BOX64_DYNAREC_X87DOUBLE> =I<0|1>
Force the use of float/double for x87 emulation.
* 0 : Try to use float when possible for x87 emulation. [Default]
* 1 : Only use Double for x87 emulation.
=item B<BOX64_EMULATED_LIBS> =I<XXXX|XXXX:YYYY:ZZZZ>
Force the use of emulated libraries.
* XXXX : Force the use of emulated library XXXX.
* XXXX:YYYY:ZZZZ : Force the use of emulated libraries XXXX, YYYY and ZZZZ.
=item B<BOX64_ENV> =I<XXXX=yyyy>
Add an environment variable.
* XXXX=yyyy : Add environment variable XXXX with value yyyy.
=item B<BOX64_ENV[1-5]> =I<XXXX=yyyy>
Add an environment variable.
* XXXX=yyyy : Add environment variable XXXX with value yyyy.
=item B<BOX64_EXIT> =I<0|1>
Just exit, do not try to run the program.
* 0 : Does nothing. [Default]
* 1 : Just exit.
=item B<BOX64_FIX_64BIT_INODES> =I<0|1>
Fix 64bit inodes.
* 0 : Do not fix 64bit inodes. [Default]
* 1 : Fix 64bit inodes.
=item B<BOX64_IGNOREINT3> =I<0|1>
Ignore INT3 instructions.
* 0 : Trigger a TRAP signal if a handler is present. [Default]
* 1 : Skip the opcode silently.
=item B<BOX64_INSERT_ARGS> =I<XXXX|XXXX YYYY ZZZZ>
Prepend arguments to the command line.
* XXXX : Prepend argument XXXX to the program.
* XXXX YYYY ZZZZ : Prepend arguments XXXX, YYYY and ZZZZ to the guest program.
=item B<BOX64_INPROCESSGPU> =I<0|1>
Add --in-process-gpu argument to the guest program.
* 0 : Does nothing. [Default]
* 1 : Add --in-process-gpu argument to the guest program.
=item B<BOX64_JITGDB> =I<0|1|2|3>
Launch gdb or not for SIGSEGV, SIGILL, and SIGBUS.
* 0 : Just print the message when the signal is caught. [Default]
* 1 : Launch gdb when a SIGSEGV, SIGILL or SIGBUS signal is trapped, attached to the offending process and go in an endless loop, waiting. Inside gdb, you need to find the correct thread yourself (the one with `my_box64signalhandler` in is stack), then probably need to `finish` 1 or 2 functions (inside `usleep(..)`) and then you'll be in `my_box64signalhandler`, just before the printf of the Segfault message. Then `set waiting=0` to exit the infinite loop.
* 2 : Launch gdbserver when a SIGSEGV, SIGILL or SIGBUS signal is trapped, attached to the offending process, and go in an endless loop, waiting. Use `gdb /PATH/TO/box64` and then `target remote 127.0.0.1: 1234` to connect to the gdbserver (or use actual IP if not on the machine). After that, the procedure is the same as with `BOX64_JITGDB=1`.
* 3 : Launch lldb when a SIGSEGV, SIGILL or SIGBUS signal is trapped, attached to the offending process and go in an endless loop, waiting.
=item B<BOX64_JVM> =I<0|1>
Detect libjvm and apply conservative settings.
* 0 : Does nothing.
* 1 : Detect libjvm, and apply BOX64_DYNAREC_BIGBLOCK=0 BOX64_DYNAREC_STRONGMEM=1 BOX64_SSE42=0 when detected. [Default]
=item B<BOX64_LD_LIBRARY_PATH> =I<XXXX>
Path to look for x86_64 libraries.
* XXXX : Add path XXXX to the library path.
=item B<BOX64_LD_PRELOAD> =I<XXXX|XXXX:YYYY>
Force loading libraries with the binary.
* XXXX : Force the loading of library XXXX.
* XXXX:YYYY : Force the loading of libraries XXXX and YYYY.
=item B<BOX64_LIBCEF> =I<0|1>
Detect libcef and apply BOX64_MALLOC_HACK settings.
* 0 : Does nothing.
* 1 : Detect libcef, and apply BOX64_MALLOC_HACK=2 if detected. [Default]
=item B<BOX64_LIBGL> =I<libXXXX|/path/to/libXXXX>
Set the name for libGL.
* libXXXX : Set the name for libGL to libXXXX.
* /path/to/libXXXX : Set the name and path for libGL to /path/to/libXXXX, you can also use SDL_VIDEO_GL_DRIVER.
=item B<BOX64_LOAD_ADDR> =I<0xXXXXXXXX>
Set the address where the program is loaded, only active for PIE guest programs.
* 0xXXXXXXXX : Set the address where the program is loaded.
=item B<BOX64_LOG> =I<0|1|2|3>
Enable or disable Box64 logs.
* 0 : Disable Box64 logs. [Default]
* 1 : Enable minimal Box64 logs.
* 2 : Enable debug level Box64 logs.
* 3 : Enable verbose level Box64 logs.
=item B<BOX64_MALLOC_HACK> =I<0|1|2>
Behaviour when hooking malloc operators.
* 0 : Don't allow malloc operator to be redirected, rewriting code to use regular function. [Default]
* 1 : Allow malloc operator to be redirected.
* 2 : Like 0, but track special mmap/free (some redirected functions are inlined and cannot be redirected).
=item B<BOX64_MAXCPU> =I<0|XXXX>
Maximum CPU cores exposed.
* 0 : Use the actual number of CPU cores. [Default]
* XXXX : Use XXXX CPU cores.
=item B<BOX64_NOBANNER> =I<0|1>
Disable the Box64 banner.
* 0 : Show the Box64 banner. [Default]
* 1 : Do not show the Box64 banner.
=item B<BOX64_NODYNAREC> =I<0xXXXXXXXX-0xYYYYYYYY>
Forbid dynablock creation in the address range specified, helpful for debugging behaviour difference between Dynarec and Interpreter.
* 0xXXXXXXXX-0xYYYYYYYY : Define the range where dynablock creation is forbidden (inclusive-exclusive).
=item B<BOX64_NOGTK> =I<0|1>
Do not load wrapped GTK libraries.
* 0 : Load wrapped GTK libraries. [Default]
* 1 : Do not load wrapped GTK libraries.
=item B<BOX64_NOPULSE> =I<0|1>
Do not load PulseAudio libraries (both native and x86_64).
* 0 : Load PulseAudio libraries. [Default]
* 1 : Do not load PulseAudio libraries.
=item B<BOX64_NORCFILES> =I<0|1>
Do not load any rc files.
* 0 : Load rc files. [Default]
* 1 : Do not load any rc files.
=item B<BOX64_NOSANDBOX> =I<0|1>
Add --no-sandbox argument to the guest program.
* 0 : Does nothing. [Default]
* 1 : Add --no-sandbox argument to the guest program.
=item B<BOX64_NOSIGSEGV> =I<0|1>
Disable the handling of SIGSEGV.
* 0 : Let the x86 program set sighandler for SIGSEGV. [Default]
* 1 : Disable the handling of SIGSEGV.
=item B<BOX64_NOSIGILL> =I<0|1>
Disable the handling of SIGILL.
* 0 : Let the x86 program set sighandler for SIGILL. [Default]
* 1 : Disable the handling of SIGILL.
=item B<BOX64_NOVULKAN> =I<0|1>
Do not load Vulkan libraries.
* 0 : Load Vulkan libraries. [Default]
* 1 : Do not load Vulkan libraries, both native and x86_64.
=item B<BOX64_PATH> =I<XXXX>
Path to look for x86_64 binaries.
* XXXX : Add path XXXX to the binary path.
=item B<BOX64_PREFER_EMULATED> =I<0|1>
Prefer emulated libraries over native ones.
* 0 : Prefer native libraries over emulated ones. [Default]
* 1 : Prefer emulated libraries over native ones.
=item B<BOX64_PREFER_WRAPPED> =I<0|1>
Prefer wrapped libs first even if the lib is specified with absolute path.
* 0 : Prefer libs with absolute path over wrapped ones. [Default]
* 1 : Prefer wrapped libs first even if the lib is specified with absolute path.
=item B<BOX64_RCFILE> =I<XXXX>
Path to the rc file to load.
* XXXX : Load the rc file XXXX, default rc files will not be loaded.
=item B<BOX64_RDTSC_1GHZ> =I<0|1>
Use hardware counter for rdtsc if available.
* 0 : Use hardware counter for rdtsc opcode if available. [Default]
* 1 : Use hardware counter for rdtsc if and only if precision is at least 1GHz.
=item B<BOX64_RESERVE_HIGH> =I<0|1>
Reserve high memory area for the program, always enabled on Box32.
* 0 : Do not reserve high memory area for the program. [Default]
* 1 : Reserve high memory area for the program.
=item B<BOX64_ROLLING_LOG> =I<0|1|XXX>
Show last few wrapped function call when a signal is caught.
* 0 : Does nothing. [Default]
* 1 : Show last 16 wrapped function call when a signal is caught.
* XXX : Show last XXX wrapped function call when a signal is caught.
=item B<BOX64_SDL2_JGUID> =I<0|1>
Use a workaround for SDL_GetJoystickGUIDInfo function for wrapped SDL2.
* 0 : Does nothing. [Default]
* 1 : Use a workaround for SDL_GetJoystickGUIDInfo function for wrapped SDL2.
=item B<BOX64_SHAEXT> =I<0|1>
Expose SHAEXT (a.k.a. SHA_NI) capabilities.
* 0 : Do not expose SHAEXT capabilities.
* 1 : Expose SHAEXT capabilities. [Default]
=item B<BOX64_SHOWBT> =I<0|1>
Show native and emulated backtrace when a signal is caught.
* 0 : Does nothing. [Default]
* 1 : Show native and emulated backtrace when a signal is caught.
=item B<BOX64_SHOWSEGV> =I<0|1>
Always show SIGSEGV signal detailes.
* 0 : Does nothing. [Default]
* 1 : Always show SIGSEGV signal detailes.
=item B<BOX64_SSE_FLUSHTO0> =I<0|1>
Behaviour of SSE Flush to 0 flags.
* 0 : Just track the flag. [Default]
* 1 : Apply SSE Flush to 0 flag directly.
=item B<BOX64_SSE42> =I<0|1>
Expose SSE4.2 capabilities.
* 0 : Do not expose SSE4.2 capabilities.
* 1 : Expose SSE4.2 capabilities. [Default]
=item B<BOX64_SYNC_ROUNDING> =I<0|1>
Synchronize rounding mode between x86 and native.
* 0 : Do not synchronize rounding mode. [Default]
* 1 : Synchronize rounding mode between x86 and native.
=item B<BOX64_TRACE_COLOR> =I<0|1>
Enable or disable colored trace output.
* 0 : Disable colored trace output. [Default]
* 1 : Enable colored trace output.
=item B<BOX64_TRACE_EMM> =I<0|1>
Enable or disable EMM (i.e. MMX) trace output.
* 0 : Disable EMM trace output. [Default]
* 1 : Enable EMM trace output.
=item B<BOX64_TRACE_FILE> =I<XXXX|XXXX%pid|stderr>
Send all log and trace to a file instead of `stdout`.
* XXXX : Send all log and trace to file XXXX.
* XXXX%pid : Send all log and trace to file XXXX with pid appended.
* stderr : Send all log and trace to `stderr`.
=item B<BOX64_TRACE_INIT> =I<0|1>
Same as BOX64_TRACE but starts the trace immediately.
* 0 : Disable trace output. [Default]
* 1 : Enable trace output. Trace starts before the initialization of dependencies.
=item B<BOX64_TRACE_START> =I<0|1|XXXX>
Start trace after N opcodes executed.
* 0 : Start trace immediately. [Default]
* 1 : Start trace after 1 opcode executed.
* XXXX : Start trace after XXXX opcodes executed.
=item B<BOX64_TRACE_XMM> =I<0|1>
Enable or disable XMM (i.e. SSE) trace output.
* 0 : Disable XMM trace output. [Default]
* 1 : Enable XMM trace output.
=item B<BOX64_TRACE> =I<0|1|symbolname|0xXXXXXXX-0xYYYYYYY>
Only available on box64 build with trace. Adds trace of all instructions executed, along with a register dump.
* 0 : Disable trace output. [Default]
* 1 : Enable trace output.
* symbolname : Enable trace output for `symbolname` only.
* 0xXXXXXXX-0xYYYYYYY : Enable trace output for the range of address (inclusive-exclusive).
=item B<BOX64_UNITYPLAYER> =I<0|1>
Detect UnityPlayer and apply conservative settings.
* 0 : Does nothing.
* 1 : Detect UnityPlayer, and apply BOX64_DYNAREC_STRONGMEM=1 when detected. [Default]
=item B<BOX64_WRAP_EGL> =I<0|1>
Prefer wrapped libs for EGL and GLESv2.
* 0 : Prefer emulated libs for EGL and GLESv2. [Default]
* 1 : Prefer wrapped libs for EGL and GLESv2.
=item B<BOX64_X11GLX> =I<0|1>
Force Xorg GLX extension to be present.
* 0 : Do not force Xorg GLX extension to be present. [Default]
* 1 : Require Xorg GLX extension when using XQueryExtension.
=item B<BOX64_X11SYNC> =I<0|1>
Force synchronized operation on X11 display.
* 0 : Do not force synchronized operation on X11 display. [Default]
* 1 : Force synchronized operation on X11 display.
=item B<BOX64_X11THREADS> =I<0|1>
Call XInitThreads when loading X11. This is mostly for old Loki games with the Loki_Compat library.
* 0 : Do not call XInitThreads. [Default]
* 1 : Call XInitThreads as soon as libX11 is loaded.
=item B<BOX64_X87_NO80BITS> =I<0|1>
Behavoiur of x87 80bits long double.
* 0 : Try to handle 80bits long double as precise as possible. [Default]
* 1 : Use 64bits double for x87.
=back
=cut
|