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.
|