aboutsummaryrefslogtreecommitdiff
path: root/doc/running.html
diff options
context:
space:
mode:
Diffstat (limited to 'doc/running.html')
-rw-r--r--doc/running.html28
1 files changed, 23 insertions, 5 deletions
diff --git a/doc/running.html b/doc/running.html
index 293ce429..20965f0a 100644
--- a/doc/running.html
+++ b/doc/running.html
@@ -1,8 +1,8 @@
1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> 1<!DOCTYPE html>
2<html> 2<html>
3<head> 3<head>
4<title>Running LuaJIT</title> 4<title>Running LuaJIT</title>
5<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> 5<meta charset="utf-8">
6<meta name="Copyright" content="Copyright (C) 2005-2026"> 6<meta name="Copyright" content="Copyright (C) 2005-2026">
7<meta name="Language" content="en"> 7<meta name="Language" content="en">
8<link rel="stylesheet" type="text/css" href="bluequad.css" media="screen"> 8<link rel="stylesheet" type="text/css" href="bluequad.css" media="screen">
@@ -59,9 +59,13 @@ td.param_default {
59<a href="ext_ffi_semantics.html">FFI Semantics</a> 59<a href="ext_ffi_semantics.html">FFI Semantics</a>
60</li></ul> 60</li></ul>
61</li><li> 61</li><li>
62<a href="ext_buffer.html">String Buffers</a>
63</li><li>
62<a href="ext_jit.html">jit.* Library</a> 64<a href="ext_jit.html">jit.* Library</a>
63</li><li> 65</li><li>
64<a href="ext_c_api.html">Lua/C API</a> 66<a href="ext_c_api.html">Lua/C API</a>
67</li><li>
68<a href="ext_profiler.html">Profiler</a>
65</li></ul> 69</li></ul>
66</li><li> 70</li><li>
67<a href="https://luajit.org/status.html">Status <span class="ext">&raquo;</span></a> 71<a href="https://luajit.org/status.html">Status <span class="ext">&raquo;</span></a>
@@ -102,10 +106,14 @@ are accepted:
102<li><tt>-l</tt> &mdash; Only list bytecode.</li> 106<li><tt>-l</tt> &mdash; Only list bytecode.</li>
103<li><tt>-s</tt> &mdash; Strip debug info (this is the default).</li> 107<li><tt>-s</tt> &mdash; Strip debug info (this is the default).</li>
104<li><tt>-g</tt> &mdash; Keep debug info.</li> 108<li><tt>-g</tt> &mdash; Keep debug info.</li>
109<li><tt>-W</tt> &mdash; Generate 32 bit (non-GC64) bytecode.</li>
110<li><tt>-X</tt> &mdash; Generate 64 bit (GC64) bytecode.</li>
111<li><tt>-d</tt> &mdash; Generate bytecode in deterministic manner.</li>
105<li><tt>-n name</tt> &mdash; Set module name (default: auto-detect from input name)</li> 112<li><tt>-n name</tt> &mdash; Set module name (default: auto-detect from input name)</li>
106<li><tt>-t type</tt> &mdash; Set output file type (default: auto-detect from output name).</li> 113<li><tt>-t type</tt> &mdash; Set output file type (default: auto-detect from output name).</li>
107<li><tt>-a arch</tt> &mdash; Override architecture for object files (default: native).</li> 114<li><tt>-a arch</tt> &mdash; Override architecture for object files (default: native).</li>
108<li><tt>-o os</tt> &mdash; Override OS for object files (default: native).</li> 115<li><tt>-o os</tt> &mdash; Override OS for object files (default: native).</li>
116<li><tt>-F name</tt> &mdash; Override filename (default: input filename).</li>
109<li><tt>-e chunk</tt> &mdash; Use chunk string as input.</li> 117<li><tt>-e chunk</tt> &mdash; Use chunk string as input.</li>
110<li><tt>-</tt> (a single minus sign) &mdash; Use stdin as input and/or stdout as output.</li> 118<li><tt>-</tt> (a single minus sign) &mdash; Use stdin as input and/or stdout as output.</li>
111</ul> 119</ul>
@@ -115,7 +123,8 @@ file name:
115</p> 123</p>
116<ul> 124<ul>
117<li><tt>c</tt> &mdash; C source file, exported bytecode data.</li> 125<li><tt>c</tt> &mdash; C source file, exported bytecode data.</li>
118<li><tt>h</tt> &mdash; C header file, static bytecode data.</li> 126<li><tt>cc</tt> &mdash; C++ source file, exported bytecode data.</li>
127<li><tt>h</tt> &mdash; C/C++ header file, static bytecode data.</li>
119<li><tt>obj</tt> or <tt>o</tt> &mdash; Object file, exported bytecode data 128<li><tt>obj</tt> or <tt>o</tt> &mdash; Object file, exported bytecode data
120(OS- and architecture-specific).</li> 129(OS- and architecture-specific).</li>
121<li><tt>raw</tt> or any other extension &mdash; Raw bytecode file (portable). 130<li><tt>raw</tt> or any other extension &mdash; Raw bytecode file (portable).
@@ -171,6 +180,7 @@ Here are the available LuaJIT control commands:
171<li id="j_flush"><tt>-jflush</tt> &mdash; Flushes the whole cache of compiled code.</li> 180<li id="j_flush"><tt>-jflush</tt> &mdash; Flushes the whole cache of compiled code.</li>
172<li id="j_v"><tt>-jv</tt> &mdash; Shows verbose information about the progress of the JIT compiler.</li> 181<li id="j_v"><tt>-jv</tt> &mdash; Shows verbose information about the progress of the JIT compiler.</li>
173<li id="j_dump"><tt>-jdump</tt> &mdash; Dumps the code and structures used in various compiler stages.</li> 182<li id="j_dump"><tt>-jdump</tt> &mdash; Dumps the code and structures used in various compiler stages.</li>
183<li id="j_p"><tt>-jp</tt> &mdash; Start the <a href="ext_profiler.html">integrated profiler</a>.</li>
174</ul> 184</ul>
175<p> 185<p>
176The <tt>-jv</tt> and <tt>-jdump</tt> commands are extension modules 186The <tt>-jv</tt> and <tt>-jdump</tt> commands are extension modules
@@ -215,6 +225,12 @@ mix the three forms, but note that setting an optimization level
215overrides all earlier flags. 225overrides all earlier flags.
216</p> 226</p>
217<p> 227<p>
228Note that <tt>-Ofma</tt> is not enabled by default at any level,
229because it affects floating-point result accuracy. Only enable this,
230if you fully understand the trade-offs of FMA for performance (higher),
231determinism (lower) and numerical accuracy (higher).
232</p>
233<p>
218Here are the available flags and at what optimization levels they 234Here are the available flags and at what optimization levels they
219are enabled: 235are enabled:
220</p> 236</p>
@@ -246,6 +262,8 @@ are enabled:
246<td class="flag_name">sink</td><td class="flag_level">&nbsp;</td><td class="flag_level">&nbsp;</td><td class="flag_level">&bull;</td><td class="flag_desc">Allocation/Store Sinking</td></tr> 262<td class="flag_name">sink</td><td class="flag_level">&nbsp;</td><td class="flag_level">&nbsp;</td><td class="flag_level">&bull;</td><td class="flag_desc">Allocation/Store Sinking</td></tr>
247<tr class="even"> 263<tr class="even">
248<td class="flag_name">fuse</td><td class="flag_level">&nbsp;</td><td class="flag_level">&nbsp;</td><td class="flag_level">&bull;</td><td class="flag_desc">Fusion of operands into instructions</td></tr> 264<td class="flag_name">fuse</td><td class="flag_level">&nbsp;</td><td class="flag_level">&nbsp;</td><td class="flag_level">&bull;</td><td class="flag_desc">Fusion of operands into instructions</td></tr>
265<tr class="odd">
266<td class="flag_name">fma </td><td class="flag_level">&nbsp;</td><td class="flag_level">&nbsp;</td><td class="flag_level">&nbsp;</td><td class="flag_desc">Fused multiply-add</td></tr>
249</table> 267</table>
250<p> 268<p>
251Here are the parameters and their default settings: 269Here are the parameters and their default settings:
@@ -281,9 +299,9 @@ Here are the parameters and their default settings:
281<tr class="even"> 299<tr class="even">
282<td class="param_name">recunroll</td><td class="param_default">2</td><td class="param_desc">Min. unroll factor for true recursion</td></tr> 300<td class="param_name">recunroll</td><td class="param_default">2</td><td class="param_desc">Min. unroll factor for true recursion</td></tr>
283<tr class="odd separate"> 301<tr class="odd separate">
284<td class="param_name">sizemcode</td><td class="param_default">32</td><td class="param_desc">Size of each machine code area in KBytes (Windows: 64K)</td></tr> 302<td class="param_name">sizemcode</td><td class="param_default">64</td><td class="param_desc">Size of each machine code area in KBytes</td></tr>
285<tr class="even"> 303<tr class="even">
286<td class="param_name">maxmcode</td><td class="param_default">512</td><td class="param_desc">Max. total size of all machine code areas in KBytes</td></tr> 304<td class="param_name">maxmcode</td><td class="param_default">2048</td><td class="param_desc">Max. total size of all machine code areas in KBytes</td></tr>
287</table> 305</table>
288<br class="flush"> 306<br class="flush">
289</div> 307</div>