https://github.com/gligneul/Lua-Low-Level

Per function, Lua JIT using LLVM C++ toolchain
https://github.com/gligneul/Lua-Low-Level

Last synced: 28 days ago
JSON representation

Per function, Lua JIT using LLVM C++ toolchain

• Host: GitHub
• URL: https://github.com/gligneul/Lua-Low-Level
• Owner: gligneul
• License: mit
• Created: 2015-09-19T21:44:53.000Z (about 9 years ago)
• Default Branch: master
• Last Pushed: 2017-06-08T04:20:41.000Z (over 7 years ago)
• Last Synced: 2024-05-02T20:13:52.656Z (7 months ago)
• Language: C
• Homepage:
• Size: 559 KB
• Stars: 10
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• AwesomeCppGameDev - Lua-Low-Level

README

        
# Lua Low Level

## Brief

This is an alternative Lua (5.3.2) implementation that aims to archive better 

performance by generating native code with the help of LLVM toolchain.

For further information about Lua, see https://www.lua.org.

ATENTION: This is still on development state.

## Usage

The usage should be equal to the standard Lua interpreter.

The compilation is done automatically by default, but you can also pre-compile

a function by calling ```lll.compile(f)```. You can also disable the

auto compilation or change the number of calls required to auto compile a

function.

## TODO List

- Support coroutines;

- Archive better performance by proper implementing the SSA format;

- Support newer LLVM versions;

- Support gcc/g++ compilation;

- Rename the genarated binary to ```lll```.

## Requiriments

- LLVM (version 3.5)

- Clang (same version of llvm)

## Compilation

Run ```make``` at project root folder.

The compilation/installation is equal to Lua.

## Library

A library is provided to manually control the LLL compiler behavior.

```

lll.compile(f)

  Compiles $f and returns true if it succeeds. If not, returns false and the

  error message.

lll.setAutoCompileEnable(b)

  Enables or disables the auto compilation. $b will be converted to a boolean.

  (default = enable)

lll.isAutoCompileEnable()

  Returns whether the auto compilation is enable.

lll.setCallsToCompile(calls)

  Sets the number of $calls required to auto compile a function. (default = 50)

lll.getCallsToCompile()

  Obtains the number of calls required to auto-compile a function.

lll.isCompiled(f)

  Returns whether $f is compiled.

lll.debug(f)

  Writes in stderr the generated LLVM IR of $f. (DEBUG)

lll.write(f, path)

  Writes to $path (default = 'f') the generated IR and the respective assembly

  (.s) file. The asm file is created by llc command. (DEBUG)

```