diff options
Diffstat (limited to 'docs/box64.pod')
| -rw-r--r-- | docs/box64.pod | 64 |
1 files changed, 32 insertions, 32 deletions
diff --git a/docs/box64.pod b/docs/box64.pod index 444d5702..3d58ee10 100644 --- a/docs/box64.pod +++ b/docs/box64.pod @@ -75,7 +75,7 @@ Arguments to pass to the guest program, only valid if there is no existing argum =item B<BOX64_AVX> =I<0|1|2> -Expose AVX extension to CPUID and cpuinfo file. Default value is 2 on Arm64 because it's fully implemented in DynaRec, 0 otherwise. +Expose AVX extension to CPUID and cpuinfo file. Default value is 2 on Arm64 because it's fully implemented in DynaRec, 0 otherwise. Availble in WowBox64. * 0 : Do not expose AVX capabilities. * 1 : Expose AVX, BMI1, F16C and VAES extensions to CPUID and cpuinfo file. @@ -107,7 +107,7 @@ Add -cef-disable-gpu-compositor argument to the guest program. =item B<BOX64_CPUTYPE> =I<0|1> -Specify the CPU type to emulate. +Specify the CPU type to emulate. Availble in WowBox64. * 0 : Emulate a Intel CPU Model. [Default] * 1 : Emulate a AMD CPU Model. @@ -131,7 +131,7 @@ Enable or disable the logging of dlsym errors. =item B<BOX64_DUMP> =I<0|1> -Dump elfloader debug information. +Dump elfloader debug information. Availble in WowBox64. * 0 : Do not dump elfloader debug information. [Default] * 1 : Dump elfloader debug information. @@ -139,7 +139,7 @@ Dump elfloader debug information. =item B<BOX64_DYNAREC> =I<0|1> -Enable/disable the Dynamic Recompiler (a.k.a DynaRec). This option defaults to 1 if it's enabled in the build options for a supported architecture. +Enable/disable the Dynamic Recompiler (a.k.a DynaRec). This option defaults to 1 if it's enabled in the build options for a supported architecture. Availble in WowBox64. * 0 : Disable DynaRec. * 1 : Enable DynaRec. @@ -147,7 +147,7 @@ Enable/disable the Dynamic Recompiler (a.k.a DynaRec). This option defaults to 1 =item B<BOX64_DYNAREC_ALIGNED_ATOMICS> =I<0|1> -Generate aligned atomics only (only available on Arm64 for now). +Generate aligned atomics only (only available on Arm64 for now). Availble in WowBox64. * 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. @@ -155,7 +155,7 @@ Generate aligned atomics only (only available on Arm64 for now). =item B<BOX64_DYNAREC_BIGBLOCK> =I<0|1|2|3> -Enable building bigger DynaRec code blocks for better performance. +Enable building bigger DynaRec code blocks for better performance. Availble in WowBox64. * 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. @@ -173,16 +173,16 @@ Detect MonoBleedingEdge and apply conservative settings. =item B<BOX64_DYNAREC_CALLRET> =I<0|1|2> -Optimize CALL/RET opcodes. +Optimize CALL/RET opcodes. Availble in WowBox64. * 0 : Do not optimize CALL/RET, use jump table. [Default] * 1 : Try to optimize CALL/RET, skipping the jump table when possible. - * 2 : Try to optimize CALL/RET, skipping the jump table when possible, adding code to handle return to dirty/modified block. + * 2 : Try to optimize CALL/RET, skipping the jump table when possible, adding code to handle return to dirty/modified block. Does not work on WowBox64. =item B<BOX64_DYNAREC_DF> =I<0|1> -Enable or disable the use of deferred flags. +Enable or disable the use of deferred flags. Availble in WowBox64. * 0 : Disable the use of deferred flags. * 1 : Enable the use of deferred flags. [Default] @@ -199,7 +199,7 @@ Allow continue running a block that is unprotected and potentially dirty. =item B<BOX64_DYNAREC_DIV0> =I<0|1> -Enable or disable the generation of division-by-zero exception. +Enable or disable the generation of division-by-zero exception. Availble in WowBox64. * 0 : Do not generate thr division-by-zero exception. [Default] * 1 : Generate the division-by-zero exception. @@ -207,7 +207,7 @@ Enable or disable the generation of division-by-zero exception. =item B<BOX64_DYNAREC_DUMP> =I<0|1|2> -Enable DynaRec dump. +Enable DynaRec dump. Availble in WowBox64. * 0 : Do not dump DynaRec blocks. [Default] * 1 : Dump DynaRec blocks. @@ -216,14 +216,14 @@ Enable DynaRec dump. =item B<BOX64_DYNAREC_DUMP_RANGE> =I<0xXXXXXXXX-0xYYYYYYYY> -Dump DynaRec blocks in the specified range. +Dump DynaRec blocks in the specified range. Availble in WowBox64. * 0xXXXXXXXX-0xYYYYYYYY : Define the range where dynablock gets dumped (inclusive-exclusive). =item B<BOX64_DYNAREC_FASTNAN> =I<0|1> -Enable or disable fast NaN handling. +Enable or disable fast NaN handling. Availble in WowBox64. * 0 : Precisely emulate the -NaN generation like on x86. * 1 : Do not do anything special with -NAN generation, faster. [Default] @@ -231,7 +231,7 @@ Enable or disable fast NaN handling. =item B<BOX64_DYNAREC_FASTROUND> =I<0|1|2> -Enable or disable fast rounding. +Enable or disable fast rounding. Availble in WowBox64. * 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] @@ -240,7 +240,7 @@ Enable or disable fast rounding. =item B<BOX64_DYNAREC_FORWARD> =I<0|128|XXXX> -Define max allowed forward value when building block. +Define max allowed forward value when building block. Availble in WowBox64. * 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] @@ -260,7 +260,7 @@ The GDBJIT debugging support, only available on build with `-DGDBJIT=ON`, enable =item B<BOX64_DYNAREC_LOG> =I<0|1|2|3> -Disable or enable DynaRec logs. +Disable or enable DynaRec logs. Availble in WowBox64. * 0 : Disable DynaRec logs. [Default] * 1 : Enable minimal DynaRec logs. @@ -270,7 +270,7 @@ Disable or enable DynaRec logs. =item B<BOX64_DYNAREC_MISSING> =I<0|1|2> -Print missing opcodes. +Print missing opcodes. Availble in WowBox64. * 0 : Do not print the missing opcode. [Default] * 1 : Print missing opcodes. @@ -279,7 +279,7 @@ Print missing opcodes. =item B<BOX64_DYNAREC_NATIVEFLAGS> =I<0|1> -Enable or disable the use of native flags. +Enable or disable the use of native flags. Availble in WowBox64. * 0 : Do not use native flags. * 1 : Use native flags when possible. [Default] @@ -287,7 +287,7 @@ Enable or disable the use of native flags. =item B<BOX64_DYNAREC_PAUSE> =I<0|1|2|3> -Enable x86 PAUSE emulation, may help the performance of spinlocks. +Enable x86 PAUSE emulation, may help the performance of spinlocks. Availble in WowBox64. * 0 : Ignore x86 PAUSE instruction. [Default] * 1 : Use YIELD to emulate x86 PAUSE instruction. @@ -305,7 +305,7 @@ Generate map file for Linux perf tool. =item B<BOX64_DYNAREC_SAFEFLAGS> =I<0|1|2> -Behaviour of flags emulation on CALL/RET opcodes. +Behaviour of flags emulation on CALL/RET opcodes. Availble in WowBox64. * 0 : Treat CALL/RET as if it never needs any flags. * 1 : Most of RETs will need flags, most of CALLs will not. [Default] @@ -314,7 +314,7 @@ Behaviour of flags emulation on CALL/RET opcodes. =item B<BOX64_DYNAREC_STRONGMEM> =I<0|1|2|3> -Enable the emulation of x86 strong memory model. +Enable the emulation of x86 strong memory model. Availble in WowBox64. * 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. @@ -332,7 +332,7 @@ Enable or disable libtbb detection. =item B<BOX64_DYNAREC_TEST> =I<0|1|0xXXXXXXXX-0xYYYYYYYY> -Enable DynaRec execution comparison with the interpreter, very slow, only for testing. +Enable DynaRec execution comparison with the interpreter, very slow, only for testing. Availble in WowBox64. * 0 : No comparison. [Default] * 1 : Each opcode runs on interpreter and on Dynarec, regs and memory are compared and printed when they differ. @@ -357,7 +357,7 @@ Use volatile metadata parsed from PE files, only valid for 64bit Windows games. =item B<BOX64_DYNAREC_WAIT> =I<0|1> -Wait or not for the building of a DynaRec code block to be ready. +Wait or not for the building of a DynaRec code block to be ready. Availble in WowBox64. * 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] @@ -365,7 +365,7 @@ Wait or not for the building of a DynaRec code block to be ready. =item B<BOX64_DYNAREC_WEAKBARRIER> =I<0|1|2> -Tweak the memory barriers to reduce the performance impact by strong memory emualtion. +Tweak the memory barriers to reduce the performance impact by strong memory emualtion. Availble in WowBox64. * 0 : Use regular safe barrier. * 1 : Use weak barriers to have more performance boost. [Default] @@ -374,7 +374,7 @@ Tweak the memory barriers to reduce the performance impact by strong memory emua =item B<BOX64_DYNAREC_X87DOUBLE> =I<0|1|2> -Force the use of float/double for x87 emulation. +Force the use of float/double for x87 emulation. Availble in WowBox64. * 0 : Try to use float when possible for x87 emulation. [Default] * 1 : Only use Double for x87 emulation. @@ -501,7 +501,7 @@ Set the address where the program is loaded, only active for PIE guest programs. =item B<BOX64_LOG> =I<0|1|2|3> -Enable or disable Box64 logs, default value is 0 if stdout is not terminal, 1 otherwise. +Enable or disable Box64 logs, default value is 0 if stdout is not terminal, 1 otherwise. Availble in WowBox64. * 0 : Disable Box64 logs. * 1 : Enable minimal Box64 logs. @@ -520,7 +520,7 @@ Behaviour when hooking malloc operators. =item B<BOX64_MAXCPU> =I<0|XXXX> -Maximum CPU cores exposed. +Maximum CPU cores exposed. Availble in WowBox64. * 0 : Use the actual number of CPU cores. [Default] * XXXX : Use XXXX CPU cores. @@ -536,7 +536,7 @@ Force 32-bit compatible memory mappings on 64-bit programs that run 32-bit code =item B<BOX64_NOBANNER> =I<0|1> -Disable the Box64 banner. +Disable the Box64 banner. Availble in WowBox64. * 0 : Show the Box64 banner. * 1 : Do not show the Box64 banner. @@ -544,7 +544,7 @@ Disable 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. +Forbid dynablock creation in the address range specified, helpful for debugging behaviour difference between Dynarec and Interpreter. Availble in WowBox64. * 0xXXXXXXXX-0xYYYYYYYY : Define the range where dynablock creation is forbidden (inclusive-exclusive). @@ -694,7 +694,7 @@ Always show SIGSEGV signal detailes. =item B<BOX64_SSE_FLUSHTO0> =I<0|1> -Behaviour of SSE Flush to 0 flags. +Behaviour of SSE Flush to 0 flags. Availble in WowBox64. * 0 : Just track the flag. [Default] * 1 : Apply SSE Flush to 0 flag directly. @@ -702,7 +702,7 @@ Behaviour of SSE Flush to 0 flags. =item B<BOX64_SSE42> =I<0|1> -Expose SSE4.2 capabilities. +Expose SSE4.2 capabilities. Availble in WowBox64. * 0 : Do not expose SSE4.2 capabilities. * 1 : Expose SSE4.2 capabilities. [Default] @@ -818,7 +818,7 @@ Call XInitThreads when loading X11. This is mostly for old Loki games with the L =item B<BOX64_X87_NO80BITS> =I<0|1> -Behavoiur of x87 80bits long double. +Behavoiur of x87 80bits long double. Availble in WowBox64. * 0 : Try to handle 80bits long double as precise as possible. [Default] * 1 : Use 64bits double for x87. |