diff options
| author | Mike Pall <mike> | 2010-01-17 22:02:13 +0100 |
|---|---|---|
| committer | Mike Pall <mike> | 2010-01-17 22:02:13 +0100 |
| commit | 379b8c5fe4cc2a2872c0d7f88cbc2a44d8097246 (patch) | |
| tree | 5a3a10dc9bba41df9b05ca3db005d214cb09c07f | |
| parent | 4b0725d5fc87da33477b13e74a32f24fafda3541 (diff) | |
| download | luajit-379b8c5fe4cc2a2872c0d7f88cbc2a44d8097246.tar.gz luajit-379b8c5fe4cc2a2872c0d7f88cbc2a44d8097246.tar.bz2 luajit-379b8c5fe4cc2a2872c0d7f88cbc2a44d8097246.zip | |
Update docs with x64 build instructions.
| -rw-r--r-- | doc/changes.html | 4 | ||||
| -rw-r--r-- | doc/install.html | 62 | ||||
| -rw-r--r-- | doc/luajit.html | 6 |
3 files changed, 62 insertions, 10 deletions
diff --git a/doc/changes.html b/doc/changes.html index 2841a371..84f7f9e0 100644 --- a/doc/changes.html +++ b/doc/changes.html | |||
| @@ -55,9 +55,7 @@ to see whether newer versions are available. | |||
| 55 | <div class="major" style="background: #d0d0d0;"> | 55 | <div class="major" style="background: #d0d0d0;"> |
| 56 | <h2 id="snap">Development Snapshot</h2> | 56 | <h2 id="snap">Development Snapshot</h2> |
| 57 | <ul> | 57 | <ul> |
| 58 | <li>Build of preliminary x64 interpreter can be enabled with | 58 | <li>Build of preliminary x64 interpreter works on Linux/x64 or WIN64.</li> |
| 59 | <tt>make "CC=gcc -m64"</tt>. | ||
| 60 | Only works on Linux/x64. Does not work on WIN64 or OSX/x64 (yet).</li> | ||
| 61 | <li>Implement yield from C hooks.</li> | 59 | <li>Implement yield from C hooks.</li> |
| 62 | <li>Add abstract C call handling to IR.</li> | 60 | <li>Add abstract C call handling to IR.</li> |
| 63 | <li>Improve KNUM fuse vs. load heuristics.</li> | 61 | <li>Improve KNUM fuse vs. load heuristics.</li> |
diff --git a/doc/install.html b/doc/install.html index faa60770..605f954d 100644 --- a/doc/install.html +++ b/doc/install.html | |||
| @@ -54,6 +54,17 @@ LuaJIT currently builds out-of-the box on all popular x86 systems | |||
| 54 | (Linux, Windows, OSX etc.). It builds and runs fine as a 32 bit | 54 | (Linux, Windows, OSX etc.). It builds and runs fine as a 32 bit |
| 55 | application under x64-based systems, too. | 55 | application under x64-based systems, too. |
| 56 | </p> | 56 | </p> |
| 57 | <p class="indent" style="color: #00a000;"> | ||
| 58 | The x64 port of LuaJIT is still experimental and not enabled by default. | ||
| 59 | It only contains the interpreter and only builds on Linux/x64 and WIN64 | ||
| 60 | right now. If you want to give it a try, follow the special build instructions | ||
| 61 | below. | ||
| 62 | </p> | ||
| 63 | <p class="indent" style="color: #00a000;"> | ||
| 64 | Note that the pure interpreter is quite a bit faster than Lua, but of | ||
| 65 | course not as fast as the x86 JIT compiler. Work on the x64 JIT compiler | ||
| 66 | is still ongoing. | ||
| 67 | </p> | ||
| 57 | 68 | ||
| 58 | <h2>Configuring LuaJIT</h2> | 69 | <h2>Configuring LuaJIT</h2> |
| 59 | <p> | 70 | <p> |
| @@ -84,8 +95,8 @@ complete SDK. | |||
| 84 | </p> | 95 | </p> |
| 85 | <p> | 96 | <p> |
| 86 | E.g. on a current Debian/Ubuntu, install <tt>libc6-dev</tt> | 97 | E.g. on a current Debian/Ubuntu, install <tt>libc6-dev</tt> |
| 87 | with the package manager. Currently LuaJIT only builds as a 32 bit | 98 | with the package manager. Currently LuaJIT builds as a 32 bit |
| 88 | application, so you actually need to install <tt>libc6-dev-i386</tt> | 99 | application by default, so you actually need to install <tt>libc6-dev-i386</tt> |
| 89 | when building on an x64 OS. | 100 | when building on an x64 OS. |
| 90 | </p> | 101 | </p> |
| 91 | <p> | 102 | <p> |
| @@ -106,6 +117,15 @@ which is probably the default on your system, anyway. Simply run: | |||
| 106 | <pre class="code"> | 117 | <pre class="code"> |
| 107 | make | 118 | make |
| 108 | </pre> | 119 | </pre> |
| 120 | <div style="color: #00a000;"> | ||
| 121 | <p> | ||
| 122 | You can force a build of the x64 interpreter on Linux/x64 with the | ||
| 123 | following command: | ||
| 124 | </p> | ||
| 125 | <pre class="code"> | ||
| 126 | make CC="gcc -m64" | ||
| 127 | </pre> | ||
| 128 | </div> | ||
| 109 | <p> | 129 | <p> |
| 110 | By default modules are only searched under the prefix <tt>/usr/local</tt>. | 130 | By default modules are only searched under the prefix <tt>/usr/local</tt>. |
| 111 | You can add an extra prefix to the search paths by appending the | 131 | You can add an extra prefix to the search paths by appending the |
| @@ -122,7 +142,7 @@ in <tt>src/Makefile</tt>. Change it, if you want to build on an older version. | |||
| 122 | <p> | 142 | <p> |
| 123 | The top-level Makefile installs LuaJIT by default under | 143 | The top-level Makefile installs LuaJIT by default under |
| 124 | <tt>/usr/local</tt>, i.e. the executable ends up in | 144 | <tt>/usr/local</tt>, i.e. the executable ends up in |
| 125 | <tt>/usr/local/bin</tt> and so on. You need to have root privileges | 145 | <tt>/usr/local/bin</tt> and so on. You need root privileges |
| 126 | to write to this path. So, assuming sudo is installed on your system, | 146 | to write to this path. So, assuming sudo is installed on your system, |
| 127 | run the following command and enter your sudo password: | 147 | run the following command and enter your sudo password: |
| 128 | </p> | 148 | </p> |
| @@ -157,9 +177,15 @@ Either install one of the open source SDKs | |||
| 157 | GCC plus the required development headers. | 177 | GCC plus the required development headers. |
| 158 | </p> | 178 | </p> |
| 159 | <p> | 179 | <p> |
| 160 | Or install Microsoft's Visual C++ (MSVC) — the freely downloadable | 180 | Or install Microsoft's Visual C++ (MSVC). The freely downloadable |
| 161 | <a href="http://www.microsoft.com/Express/VC/"><span class="ext">»</span> Express Edition</a> | 181 | <a href="http://www.microsoft.com/Express/VC/"><span class="ext">»</span> Express Edition</a> |
| 162 | works just fine. | 182 | works just fine, but only contains an x86 compiler. |
| 183 | </p> | ||
| 184 | <p> | ||
| 185 | The freely downloadable | ||
| 186 | <a href="http://msdn.microsoft.com/en-us/windowsserver/bb980924.aspx"><span class="ext">»</span> Windows SDK</a> | ||
| 187 | only comes with command line tools, but this is all you need to build LuaJIT. | ||
| 188 | It contains x86 and x64 compilers. | ||
| 163 | </p> | 189 | </p> |
| 164 | <p> | 190 | <p> |
| 165 | Next, download the source package and unpack it using an archive manager | 191 | Next, download the source package and unpack it using an archive manager |
| @@ -177,6 +203,32 @@ msvcbuild | |||
| 177 | <p> | 203 | <p> |
| 178 | Then follow the installation instructions below. | 204 | Then follow the installation instructions below. |
| 179 | </p> | 205 | </p> |
| 206 | <h3>Building with the Windows SDK</h3> | ||
| 207 | <p> | ||
| 208 | Open a "Windows SDK Command Shell" and select the x86 compiler: | ||
| 209 | </p> | ||
| 210 | <pre class="code"> | ||
| 211 | setenv /release /x86 | ||
| 212 | </pre> | ||
| 213 | <div style="color: #00a000;"> | ||
| 214 | <p> | ||
| 215 | Or select the x64 compiler (this only builds the interpreter right now): | ||
| 216 | </p> | ||
| 217 | <pre class="code"> | ||
| 218 | setenv /release /x64 | ||
| 219 | </pre> | ||
| 220 | </div> | ||
| 221 | <p> | ||
| 222 | Then <tt>cd</tt> to the directory where you've unpacked the sources | ||
| 223 | and run these commands: | ||
| 224 | </p> | ||
| 225 | <pre class="code"> | ||
| 226 | cd src | ||
| 227 | msvcbuild | ||
| 228 | </pre> | ||
| 229 | <p> | ||
| 230 | Then follow the installation instructions below. | ||
| 231 | </p> | ||
| 180 | <h3>Building with MinGW or Cygwin</h3> | 232 | <h3>Building with MinGW or Cygwin</h3> |
| 181 | <p> | 233 | <p> |
| 182 | Open a command prompt window and make sure the MinGW or Cygwin programs | 234 | Open a command prompt window and make sure the MinGW or Cygwin programs |
diff --git a/doc/luajit.html b/doc/luajit.html index 029a5919..7c3779d4 100644 --- a/doc/luajit.html +++ b/doc/luajit.html | |||
| @@ -63,8 +63,10 @@ standard Lua interpreter and can be deployed as a drop-in replacement. | |||
| 63 | <p> | 63 | <p> |
| 64 | LuaJIT offers more performance, at the expense of portability. It | 64 | LuaJIT offers more performance, at the expense of portability. It |
| 65 | currently runs on all popular operating systems based on <b>x86 CPUs</b> | 65 | currently runs on all popular operating systems based on <b>x86 CPUs</b> |
| 66 | (Linux, Windows, OSX etc.). It will be ported to x64 CPUs and other | 66 | (Linux, Windows, OSX etc.). A port to x64 CPUs is currently ongoing — |
| 67 | platforms in the future, based on user demand and sponsoring. | 67 | you can follow its progress in the <a href="http://luajit.org/download.html"><span class="ext">»</span> git repository</a>. |
| 68 | Other platforms will be supported in the future, based on user demand | ||
| 69 | and sponsoring. | ||
| 68 | </p> | 70 | </p> |
| 69 | 71 | ||
| 70 | <h2>Overview</h2> | 72 | <h2>Overview</h2> |
