diff options
Diffstat (limited to 'doc/running.html')
| -rw-r--r-- | doc/running.html | 28 |
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">»</span></a> | 71 | <a href="https://luajit.org/status.html">Status <span class="ext">»</span></a> |
| @@ -102,10 +106,14 @@ are accepted: | |||
| 102 | <li><tt>-l</tt> — Only list bytecode.</li> | 106 | <li><tt>-l</tt> — Only list bytecode.</li> |
| 103 | <li><tt>-s</tt> — Strip debug info (this is the default).</li> | 107 | <li><tt>-s</tt> — Strip debug info (this is the default).</li> |
| 104 | <li><tt>-g</tt> — Keep debug info.</li> | 108 | <li><tt>-g</tt> — Keep debug info.</li> |
| 109 | <li><tt>-W</tt> — Generate 32 bit (non-GC64) bytecode.</li> | ||
| 110 | <li><tt>-X</tt> — Generate 64 bit (GC64) bytecode.</li> | ||
| 111 | <li><tt>-d</tt> — Generate bytecode in deterministic manner.</li> | ||
| 105 | <li><tt>-n name</tt> — Set module name (default: auto-detect from input name)</li> | 112 | <li><tt>-n name</tt> — Set module name (default: auto-detect from input name)</li> |
| 106 | <li><tt>-t type</tt> — Set output file type (default: auto-detect from output name).</li> | 113 | <li><tt>-t type</tt> — Set output file type (default: auto-detect from output name).</li> |
| 107 | <li><tt>-a arch</tt> — Override architecture for object files (default: native).</li> | 114 | <li><tt>-a arch</tt> — Override architecture for object files (default: native).</li> |
| 108 | <li><tt>-o os</tt> — Override OS for object files (default: native).</li> | 115 | <li><tt>-o os</tt> — Override OS for object files (default: native).</li> |
| 116 | <li><tt>-F name</tt> — Override filename (default: input filename).</li> | ||
| 109 | <li><tt>-e chunk</tt> — Use chunk string as input.</li> | 117 | <li><tt>-e chunk</tt> — Use chunk string as input.</li> |
| 110 | <li><tt>-</tt> (a single minus sign) — Use stdin as input and/or stdout as output.</li> | 118 | <li><tt>-</tt> (a single minus sign) — 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> — C source file, exported bytecode data.</li> | 125 | <li><tt>c</tt> — C source file, exported bytecode data.</li> |
| 118 | <li><tt>h</tt> — C header file, static bytecode data.</li> | 126 | <li><tt>cc</tt> — C++ source file, exported bytecode data.</li> |
| 127 | <li><tt>h</tt> — C/C++ header file, static bytecode data.</li> | ||
| 119 | <li><tt>obj</tt> or <tt>o</tt> — Object file, exported bytecode data | 128 | <li><tt>obj</tt> or <tt>o</tt> — 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 — Raw bytecode file (portable). | 130 | <li><tt>raw</tt> or any other extension — Raw bytecode file (portable). |
| @@ -171,6 +180,7 @@ Here are the available LuaJIT control commands: | |||
| 171 | <li id="j_flush"><tt>-jflush</tt> — Flushes the whole cache of compiled code.</li> | 180 | <li id="j_flush"><tt>-jflush</tt> — Flushes the whole cache of compiled code.</li> |
| 172 | <li id="j_v"><tt>-jv</tt> — Shows verbose information about the progress of the JIT compiler.</li> | 181 | <li id="j_v"><tt>-jv</tt> — Shows verbose information about the progress of the JIT compiler.</li> |
| 173 | <li id="j_dump"><tt>-jdump</tt> — Dumps the code and structures used in various compiler stages.</li> | 182 | <li id="j_dump"><tt>-jdump</tt> — Dumps the code and structures used in various compiler stages.</li> |
| 183 | <li id="j_p"><tt>-jp</tt> — Start the <a href="ext_profiler.html">integrated profiler</a>.</li> | ||
| 174 | </ul> | 184 | </ul> |
| 175 | <p> | 185 | <p> |
| 176 | The <tt>-jv</tt> and <tt>-jdump</tt> commands are extension modules | 186 | The <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 | |||
| 215 | overrides all earlier flags. | 225 | overrides all earlier flags. |
| 216 | </p> | 226 | </p> |
| 217 | <p> | 227 | <p> |
| 228 | Note that <tt>-Ofma</tt> is not enabled by default at any level, | ||
| 229 | because it affects floating-point result accuracy. Only enable this, | ||
| 230 | if you fully understand the trade-offs of FMA for performance (higher), | ||
| 231 | determinism (lower) and numerical accuracy (higher). | ||
| 232 | </p> | ||
| 233 | <p> | ||
| 218 | Here are the available flags and at what optimization levels they | 234 | Here are the available flags and at what optimization levels they |
| 219 | are enabled: | 235 | are enabled: |
| 220 | </p> | 236 | </p> |
| @@ -246,6 +262,8 @@ are enabled: | |||
| 246 | <td class="flag_name">sink</td><td class="flag_level"> </td><td class="flag_level"> </td><td class="flag_level">•</td><td class="flag_desc">Allocation/Store Sinking</td></tr> | 262 | <td class="flag_name">sink</td><td class="flag_level"> </td><td class="flag_level"> </td><td class="flag_level">•</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"> </td><td class="flag_level"> </td><td class="flag_level">•</td><td class="flag_desc">Fusion of operands into instructions</td></tr> | 264 | <td class="flag_name">fuse</td><td class="flag_level"> </td><td class="flag_level"> </td><td class="flag_level">•</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"> </td><td class="flag_level"> </td><td class="flag_level"> </td><td class="flag_desc">Fused multiply-add</td></tr> | ||
| 249 | </table> | 267 | </table> |
| 250 | <p> | 268 | <p> |
| 251 | Here are the parameters and their default settings: | 269 | Here 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> |
