Skip to content

Commit f8b9fbb

Browse files
committed
riscv: add README for patchset release
1 parent e322ef1 commit f8b9fbb

1 file changed

Lines changed: 44 additions & 0 deletions

File tree

README.md

Lines changed: 44 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,44 @@
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

Comments
 (0)