aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMike Pall <mike>2022-04-18 02:02:56 +0200
committerMike Pall <mike>2022-04-18 02:02:56 +0200
commitf2b37f51f69ba7e9f8defd05e5aca648121f0fe6 (patch)
tree483764815ada7a0f68e1768a64b5b593a63bfa32
parent34a62c7f738347e4981e7882bbf4f7a4f706dc5d (diff)
parent5743edf3b014599c16da6c3725e06e5820b59d23 (diff)
downloadluajit-f2b37f51f69ba7e9f8defd05e5aca648121f0fe6.tar.gz
luajit-f2b37f51f69ba7e9f8defd05e5aca648121f0fe6.tar.bz2
luajit-f2b37f51f69ba7e9f8defd05e5aca648121f0fe6.zip
Merge branch 'master' into v2.1
-rw-r--r--doc/install.html229
1 files changed, 180 insertions, 49 deletions
diff --git a/doc/install.html b/doc/install.html
index a38bdb5f..8210f476 100644
--- a/doc/install.html
+++ b/doc/install.html
@@ -14,25 +14,20 @@ table.compat {
14} 14}
15table.compat td { 15table.compat td {
16 border: 1px solid #bfcfff; 16 border: 1px solid #bfcfff;
17 height: 2.5em; 17 height: 1.5em;
18} 18}
19table.compat tr.compathead td { 19table.compat tr.compathead td {
20 font-weight: bold; 20 font-weight: bold;
21 border-bottom: 2px solid #bfcfff; 21 border-bottom: 2px solid #bfcfff;
22} 22}
23tr.compathead td.compatos { 23td.compatname, td.compatver {
24 vertical-align: top; 24 width: 10%;
25} 25}
26table.compat td.compatcpu { 26td.compatbits {
27 width: 18%; 27 width: 5%;
28 border-right: 2px solid #bfcfff;
29} 28}
30td.compatos { 29td.compatx {
31 width: 21%; 30 width: 21%;
32 vertical-align: middle;
33}
34td.compatno {
35 background-color: #d0d0d0;
36} 31}
37</style> 32</style>
38</head> 33</head>
@@ -95,62 +90,198 @@ For the impatient (on POSIX systems):
95<pre class="code"> 90<pre class="code">
96make &amp;&amp; sudo make install 91make &amp;&amp; sudo make install
97</pre> 92</pre>
93
94<h2 id="req">Requirements</h2>
95<h3 id="systems">Systems</h3>
96<p>
97LuaJIT currently builds out-of-the box on most systems:
98</p>
99<table class="compat">
100<tr class="compathead">
101<td class="compatname">OS</td>
102<td class="compatver">Min. Version</td>
103<td class="compatx">Requirements</td>
104<td class="compatx">LuaJIT Versions</td>
105</tr>
106<tr class="odd separate">
107<td class="compatname"><a href="#windows">Windows</a></td>
108<td class="compatver">7</td>
109<td class="compatx">x86 or x64, ARM64: TBA</td>
110<td class="compatx">v2.0 &ndash;</td>
111</tr>
112<tr class="even">
113<td class="compatname"><a href="#posix">Linux</a></td>
114<td class="compatver">&nbsp;</td>
115<td class="compatx">&nbsp;</td>
116<td class="compatx">v2.0 &ndash;</td>
117</tr>
118<tr class="odd">
119<td class="compatname"><a href="#posix">*BSD</a></td>
120<td class="compatver">&nbsp;</td>
121<td class="compatx">&nbsp;</td>
122<td class="compatx">v2.0 &ndash;</td>
123</tr>
124<tr class="even">
125<td class="compatname"><a href="#posix">macOS (OSX)</a></td>
126<td class="compatver">10.4</td>
127<td class="compatx">&nbsp;</td>
128<td class="compatx">v2.1 &ndash;</td>
129</tr>
130<tr class="odd">
131<td class="compatname"><a href="#posix">POSIX</a></td>
132<td class="compatver">&nbsp;</td>
133<td class="compatx">mmap, dlopen</td>
134<td class="compatx">v2.0 &ndash;</td>
135</tr>
136<tr class="even separate">
137<td class="compatname"><a href="#android">Android</a></td>
138<td class="compatver">4.0</td>
139<td class="compatx">Recent Android NDK</td>
140<td class="compatx">v2.0 &ndash;</td>
141</tr>
142<tr class="odd">
143<td class="compatname"><a href="#ios">iOS</a></td>
144<td class="compatver">3.0</td>
145<td class="compatx">Xcode iOS SDK</td>
146<td class="compatx">v2.1 &ndash;</td>
147</tr>
148<tr class="even separate">
149<td class="compatname"><a href="#consoles">PS3</a></td>
150<td class="compatver">&nbsp;</td>
151<td class="compatx">PS3 SDK</td>
152<td class="compatx">v2.0 &ndash; v2.1 EOL</td>
153</tr>
154<tr class="odd">
155<td class="compatname"><a href="#consoles">PS4</a></td>
156<td class="compatver">&nbsp;</td>
157<td class="compatx">PS4 SDK (ORBIS)</td>
158<td class="compatx">v2.0 &ndash;</td>
159</tr>
160<tr class="even">
161<td class="compatname"><a href="#consoles">PS5</a></td>
162<td class="compatver">&nbsp;</td>
163<td class="compatx">PS5 SDK (PROSPERO)</td>
164<td class="compatx">v2.1 &ndash;</td>
165</tr>
166<tr class="odd">
167<td class="compatname"><a href="#consoles">PS Vita</a></td>
168<td class="compatver">&nbsp;</td>
169<td class="compatx">PS Vita SDK (PSP2)</td>
170<td class="compatx">v2.0 &ndash; v2.1 EOL</td>
171</tr>
172<tr class="even">
173<td class="compatname"><a href="#consoles">Xbox 360</a></td>
174<td class="compatver">&nbsp;</td>
175<td class="compatx">Xbox 360 SDK (XEDK)</td>
176<td class="compatx">v2.0 &ndash; v2.1 EOL</td>
177</tr>
178<tr class="odd">
179<td class="compatname"><a href="#consoles">Xbox One</a></td>
180<td class="compatver">&nbsp;</td>
181<td class="compatx">Xbox One SDK (DURANGO)</td>
182<td class="compatx">v2.1 &ndash;</td>
183</tr>
184</table>
98<p> 185<p>
99LuaJIT currently builds out-of-the box on most systems. 186The codebase has compatibility defines for some more systems, but
100Here's the compatibility matrix for the supported combinations of 187without official support.
101operating systems, CPUs and compilers:
102</p> 188</p>
189<h3 id="toolchains">Toolchains</h3>
190<p>
191Building LuaJIT requires a recent toolchain based on GCC, Clang/LLVM or
192MSVC++.
193</p>
194<p>
195The Makefile-based build system requires GNU Make and supports
196cross-builds. Batch files are provided for MSVC++ builds and console
197cross-builds.
198</p>
199<h3 id="architectures">CPU Architectures</h3>
103<table class="compat"> 200<table class="compat">
104<tr class="compathead"> 201<tr class="compathead">
105<td class="compatcpu">CPU / OS</td> 202<td class="compatname">CPU</td>
106<td class="compatos"><a href="#posix">Linux</a> or<br><a href="#android">Android</a></td> 203<td class="compatbits">Bits</td>
107<td class="compatos"><a href="#posix">*BSD, Other</a></td> 204<td class="compatx">Requirements</td>
108<td class="compatos"><a href="#posix">macOS 10.4+</a> or<br><a href="#ios">iOS 3.0+</a></td> 205<td class="compatx">Variants</td>
109<td class="compatos"><a href="#windows">Windows 7<br>or later</a></td> 206<td class="compatx">LuaJIT Versions</td>
110</tr> 207</tr>
111<tr class="odd separate"> 208<tr class="odd separate">
112<td class="compatcpu">x86 (32 bit)</td> 209<td class="compatname">x86</td>
113<td class="compatos">GCC 4.2+</td> 210<td class="compatbits">32</td>
114<td class="compatos">GCC 4.2+</td> 211<td class="compatx">v2.1+: SSE2</td>
115<td class="compatos">XCode 5.0+<br>Clang</td> 212<td class="compatx">&nbsp;</td>
116<td class="compatos">MSVC<br>MinGW, Cygwin</td> 213<td class="compatx">v2.0 &ndash;</td>
214</tr>
215<tr class="even">
216<td class="compatname">x64</td>
217<td class="compatbits">64</td>
218<td class="compatx">&nbsp;</td>
219<td class="compatx">&nbsp;</td>
220<td class="compatx">v2.0 &ndash;</td>
221</tr>
222<tr class="odd">
223<td class="compatname">ARM</td>
224<td class="compatbits">32</td>
225<td class="compatx">ARMv5+, ARM9E+</td>
226<td class="compatx">hard-fp + soft-fp</td>
227<td class="compatx">v2.0 &ndash;</td>
117</tr> 228</tr>
118<tr class="even"> 229<tr class="even">
119<td class="compatcpu">x64 (64 bit)</td> 230<td class="compatname">ARM64</td>
120<td class="compatos">GCC 4.2+</td> 231<td class="compatbits">64</td>
121<td class="compatos">GCC 4.2+<br>ORBIS (<a href="#ps4">PS4</a>)<br>PROSPERO (<a href="#ps5">PS5</a>)</td> 232<td class="compatx">&nbsp;</td>
122<td class="compatos">XCode 5.0+<br>Clang</td> 233<td class="compatx">ARM64le + ARM64be</td>
123<td class="compatos">MSVC<br>Durango (<a href="#xboxone">Xbox One</a>)</td> 234<td class="compatx">v2.1 &ndash;</td>
124</tr> 235</tr>
125<tr class="odd"> 236<tr class="odd">
126<td class="compatcpu"><a href="#cross2">ARMv5+<br>ARM9E+</a></td> 237<td class="compatname">PPC32</td>
127<td class="compatos">GCC 4.2+</td> 238<td class="compatbits">32</td>
128<td class="compatos">GCC 4.2+<br>PSP2 (<a href="#psvita">PS VITA</a>)</td> 239<td class="compatx">&nbsp;</td>
129<td class="compatos">XCode 5.0+<br>Clang</td> 240<td class="compatx">hard-fp + soft-fp</td>
130<td class="compatos compatno">&nbsp;</td> 241<td class="compatx">v2.0 &ndash; v2.1 EOL</td>
131</tr> 242</tr>
132<tr class="even"> 243<tr class="even">
133<td class="compatcpu"><a href="#cross2">ARM64<br>ARM64be</a></td> 244<td class="compatname">PPC/e500</td>
134<td class="compatos">GCC 4.8+</td> 245<td class="compatbits">32</td>
135<td class="compatos compatno">&nbsp;</td> 246<td class="compatx">e500v2</td>
136<td class="compatos">XCode 6.0+<br>Clang 3.5+</td> 247<td class="compatx">&nbsp;</td>
137<td class="compatos compatno">&nbsp;</td> 248<td class="compatx">v2.0 EOL</td>
138</tr> 249</tr>
139<tr class="odd"> 250<tr class="odd">
140<td class="compatcpu"><a href="#cross2">PPC</a></td> 251<td class="compatname">MIPS32</td>
141<td class="compatos">GCC 4.3+</td> 252<td class="compatbits">32</td>
142<td class="compatos">GCC 4.3+<br>GCC 4.1 (<a href="#ps3">PS3</a>)</td> 253<td class="compatx">MIPS32r1 &ndash; r5</td>
143<td class="compatos compatno">&nbsp;</td> 254<td class="compatx">hard-fp + soft-fp</td>
144<td class="compatos">XEDK (<a href="#xbox360">Xbox 360</a>)</td> 255<td class="compatx">v2.0 &ndash;</td>
145</tr> 256</tr>
146<tr class="even"> 257<tr class="even">
147<td class="compatcpu"><a href="#cross2">MIPS32<br>MIPS64<br>MIPS64r6</a></td> 258<td class="compatname">MIPS64</td>
148<td class="compatos">GCC 4.3+</td> 259<td class="compatbits">64</td>
149<td class="compatos">GCC 4.3+</td> 260<td class="compatx">MIPS64r1 &ndash; r5</td>
150<td class="compatos compatno">&nbsp;</td> 261<td class="compatx">hard-fp + soft-fp</td>
151<td class="compatos compatno">&nbsp;</td> 262<td class="compatx">v2.1 &ndash;</td>
263</tr>
264<tr class="odd">
265<td class="compatname">MIPS64</td>
266<td class="compatbits">64</td>
267<td class="compatx">MIPS64r6</td>
268<td class="compatx">hard-fp + soft-fp</td>
269<td class="compatx">v2.1 EOL</td>
270</tr>
271<tr class="even">
272<td class="compatname">RISC-V</td>
273<td class="compatbits">64</td>
274<td class="compatx">RVA22+</td>
275<td class="compatx">&nbsp;</td>
276<td class="compatx">TBA</td>
152</tr> 277</tr>
153</table> 278</table>
279<p>
280There are no plans to add historic architectures or to continue support
281for end-of-life (EOL) architectures, for which no new CPUs are commonly
282available anymore. Likewise, there are no plans to support marginal
283and/or de-facto-dead architectures.
284</p>
154 285
155<h2>Configuring LuaJIT</h2> 286<h2>Configuring LuaJIT</h2>
156<p> 287<p>