summaryrefslogtreecommitdiff
path: root/doc/rjit/rjit.md
blob: 273fdbeb9d5e14a444f18433fb546e4256fdc1bc (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
# RJIT: Ruby JIT

This document has some tips that might be useful when you work on RJIT.

## Project purpose

This project is for experimental purposes.
For production deployment, consider using YJIT instead.

## Supported platforms

The following platforms are assumed to work. `linux-x86_64` is tested on CI.

* OS: Linux, macOS, BSD
* Arch: x86\_64

## Developing RJIT

### Bindgen

If you see an "RJIT bindgen" GitHub Actions failure, please commit the `git diff` shown on the failed job.

For doing the same thing locally, run `make rjit-bindgen` after installing libclang.
macOS seems to have libclang by default. On Ubuntu, you can install it with `apt install libclang1`.

### --enable-rjit

On supported platforms, `--enable-rjit` is set by default. You usually don't need to specify this.
You may still manually pass `--enable-rjit` to try RJIT on unsupported platforms.

### --enable-rjit=dev

`--enable-rjit=dev` makes the interpreter slower, but enables the following two features:

* `--rjit-dump-disasm`: Dump all JIT code.
* `--rjit-stats`: Print RJIT stats.