blob: e3795e35b868f30f37876b77615eb93978997c17 (
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
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
|
# 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
## configure
### --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
It enables `--rjit-dump-disasm` if libcapstone is available.
It also enables `vm_insns_count` and `ratio_in_rjit` in `--rjit-stats`.
However, it makes the interpreter a little slower.
### --enable-rjit=disasm
It enables `--rjit-dump-disasm` if libcapstone is available.
## make
### 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`.
## ruby
### --rjit-stats
This prints RJIT stats at exit. Some stats are available only with `--enable-rjit=dev` on configure.
### --rjit-dump-disasm
This dumps all JIT code. You need to install libcapstone before configure and use `--enable-rjit=dev`
or `--enable-rjit=disasm` on configure.
* Ubuntu: `sudo apt-get install -y libcapstone-dev`
* macOS: `brew install capstone`
|