|
| 1 | +# LJRV - LuaJIT RISC-V 64 Port |
| 2 | + |
| 3 | +LuaJIT is a Just-In-Time (JIT) compiler for the Lua programming language, |
| 4 | +RISC-V is a free and open ISA enabling a new era of processor innovation. |
| 5 | + |
| 6 | +Find latest LJRV release at [IgnotaYun/LuaJIT,v2.1-riscv64](https://github.com/IgnotaYun/LuaJIT/tree/v2.1-riscv64). |
| 7 | +Development branch is avaliable at [IgnotaYun/LuaJIT,riscv](https://github.com/IgnotaYun/LuaJIT/tree/riscv). |
| 8 | + |
| 9 | +**This is the release branch of LJRV, containing patchset based on dev branch commit [1ce02ddf8b6e ("riscv(interp): fix cdata matching handler in BC_ISEQV & BC_ISNEV")](https://github.com/IgnotaYun/LuaJIT/commit/1ce02ddf8b6e705f7161a8e88dd6c42884224d5c), based off LuaJIT v2.1 rolling [194d7f2d635a ("Merge branch 'master' into v2.1")](https://github.com/LuaJIT/LuaJIT/commit/194d7f2d635a11193177f0ed820ae419148f0b70)** |
| 10 | + |
| 11 | +## Introduction |
| 12 | + |
| 13 | +LJRV is a ongoing porting project of LuaJIT to the RISC-V 64-bit architecture by ISRC, ISCAS. |
| 14 | +The ultimate goal is to provide a RISC-V 64 LuaJIT implementation and have it upstreamed to the official LuaJIT repository. |
| 15 | + |
| 16 | +## Building and Packaging |
| 17 | + |
| 18 | +LJRV is built and packaged in the same way as LuaJIT, requires a recent toolchain based on GCC or Clang with RISC-V 64 support and GNU Make. |
| 19 | +For building and installation instructions, please refer to the [LuaJIT README](https://luajit.org/install.html). |
| 20 | + |
| 21 | +For distro maintainers and packagers, we encourage one to follow our branch and patchset, as we would keep it up-to-date with the latest LuaJIT upstream. Cherry-picking and backporting is **strongly** discouraged, ["no matter how self-standing individual changes look (because they often are not)"](https://luajit.org/download.html). |
| 22 | + |
| 23 | +## Progress |
| 24 | + |
| 25 | +- [x] Interpreter Runtime |
| 26 | +- [x] JIT Compiler |
| 27 | + |
| 28 | +LJRV is still considered of beta quality, take it with a grain of salt. |
| 29 | + |
| 30 | +FFI struct passing is known to be partially broken, please report any issue you encounter. |
| 31 | + |
| 32 | +## Bug Report |
| 33 | + |
| 34 | +Please report bugs to [Issues](https://github.com/ruyisdk/LuaJIT/issues). |
| 35 | + |
| 36 | +## Copyright |
| 37 | + |
| 38 | +LuaJIT is Copyright (C) 2005-2026 Mike Pall. |
| 39 | +LuaJIT is free software, released under the MIT license. |
| 40 | +See full Copyright Notice in the COPYRIGHT file or in luajit.h. |
| 41 | + |
| 42 | +LJRV is Copyright (C) 2022-2026 ISRC, ISCAS. Contributed by gns. |
| 43 | +LJRV is free software, released under the MIT license. |
| 44 | +LJRV is part of openRuyi. |
0 commit comments