diff options
| author | Aiden Fox Ivey <aiden.foxivey@shopify.com> | 2025-09-30 11:55:33 -0400 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2025-09-30 15:55:33 +0000 |
| commit | 2f1c30cd50e464880e44da670d3ad8ebe00fc899 (patch) | |
| tree | 40176613b3f2587d7f898e21bfa74af84cd5311d /doc | |
| parent | d016595387069677c6b992dffe9322f67dc9bc73 (diff) | |
ZJIT: Add --zjit-trace-exits (#14640)
Add side exit tracing functionality for ZJIT
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/zjit.md | 14 |
1 files changed, 14 insertions, 0 deletions
diff --git a/doc/zjit.md b/doc/zjit.md index 4eedcca3ba..57a95457d3 100644 --- a/doc/zjit.md +++ b/doc/zjit.md @@ -153,6 +153,20 @@ To build with stats support: make -j ``` +### Tracing side exits + +Through [Stackprof](https://github.com/tmm1/stackprof), detailed information about the methods that the JIT side-exits from can be displayed after some execution of a program. Note that the use of `--zjit-trace-exits` must be used alongside `--zjit-stats`. + +```bash +./miniruby --zjit-stats --zjit-trace-exits script.rb +``` + +A file called `zjit_exit_locations.dump` will be created in the same directory as `script.rb`. Viewing the side exited methods can be done with Stackprof: + +```bash +stackprof path/to/zjit_exit_locations.dump +``` + ## ZJIT Glossary This glossary contains terms that are helpful for understanding ZJIT. |
