https://github.com/FastVM/minivm
A VM That is Dynamic and Fast
https://github.com/FastVM/minivm
Last synced: 7 months ago
JSON representation
A VM That is Dynamic and Fast
- Host: GitHub
- URL: https://github.com/FastVM/minivm
- Owner: FastVM
- License: mit
- Created: 2021-03-20T22:29:00.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2024-10-26T08:17:04.000Z (about 1 year ago)
- Last Synced: 2024-10-29T15:33:35.158Z (about 1 year ago)
- Language: C
- Homepage:
- Size: 7.67 MB
- Stars: 1,567
- Watchers: 34
- Forks: 58
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- anything_about_game - minivm
README
# MiniVM
MiniVM is a Small but Optimizing Virtual Machine and Runtime.
It has a just-in-time compiler based on [Cuik](https://github.com/realnegate/cuik)'s [TB](https://github.com/RealNeGate/Cuik/tree/master/tb).
Currently it supports Linux x86-64, FreeBSD amd64, Windows x64 and WebAssembly.
MiniVM is written in C11 with (minor GNU extensions), and builds with GCC and Clang, with TCC support not hard to patch in.
## Building
MiniVM uses GNU Make as it's build system.
### Requirements
You'll need
* The MiniVM repo
* Make sure to get the cuik submodule
* You can use `git clone github.com/FastVM/minivm --recursive`
* If you've already cloned you can use `git submodule update --init`
* A C Compiler
* GCC works
* Clang works if you replace CC=gcc with CC=clang
### Build Configs
Here's some Shell Commands to build MiniVM different ways
* Debug - `make -Bj OPT='-g'`
* For Size - `make -Bj CC=gcc OPT='-s -Oz -flto -fno-asynchronous-unwind-tables -fomit-frame-pointer'`
* GCC does a better job than Clang to make tiny binaries of MiniVM.
* For Speed - `make -Bj OPT='-O3 -flto'`
## Speed
Here's some benchmark runs, they aren't too representative yet.
### Math + Recursion
```sh
shell> ./build/bin/minivm --dump-time test/fib/fib40.lua
102334155
took: 1725.805ms
```
### Startup Perf
```sh
shell> ./build/bin/minivm --dump-time -e 'print("hello world")'
Hello, World
took: 0.307ms
```