Skip to content

gh-119786: Add jit.md. Move adaptive.md to a section of interpreter.md. #127175

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 13 commits into from
Dec 6, 2024
Merged

gh-119786: Add jit.md. Move adaptive.md to a section of interpreter.md. #127175

Changes from 1 commit
Commits
Show all changes
13 commits
Select commit Hold shift + click to select a range
2fb97e3
gh-119786: add intro to adaptive.md. Update index headings
iritkatriel Nov 22, 2024
2414871
add content to tier2
iritkatriel Nov 22, 2024
e040267
review comments
iritkatriel Nov 23, 2024
e5802d7
add jit
iritkatriel Nov 28, 2024
0c96eb2
merge adaptive.md into interpreter.md
iritkatriel Dec 5, 2024
43aa0df
cache layouts
iritkatriel Dec 5, 2024
e7c3363
tier 2 --> jit
iritkatriel Dec 5, 2024
4731d94
remove adaptive.md
iritkatriel Dec 5, 2024
c4b288b
mike's comments
iritkatriel Dec 5, 2024
aced06a
Apply suggestions from code review
iritkatriel Dec 6, 2024
bc8a50b
interpreter jit is for debugging
iritkatriel Dec 6, 2024
3bbf6ee
Update InternalDocs/jit.md
iritkatriel Dec 6, 2024
acaef71
Merge branch 'main' into adaptive
iritkatriel Dec 6, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
Apply suggestions from code review 
Co-authored-by: Mark Shannon <mark@hotpy.org>
  • Loading branch information
@iritkatriel @markshannon
iritkatriel and markshannon authored Dec 6, 2024
commit aced06a9dca0188b0148c5382ee95b0e6411748c
6 changes: 3 additions & 3 deletions InternalDocs/jit.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -42,7 +42,7 @@ The optimizer that `_PyOptimizer_Optimize()` runs is configurable via the
`_Py_SetTier2Optimizer()` function (this is used in test via
`_testinternalcapi.set_optimizer()`.)

The micro-op optimizer (abbreviated `uop` to approximate `μop`) is defined in
The micro-op (abbreviated `uop` to approximate `μop`) optimizer is defined in
[`Python/optimizer.c`](../Python/optimizer.c) as the type `_PyUOpOptimizer_Type`.
It translates an instruction trace into a sequence of micro-ops by replacing
each bytecode by an equivalent sequence of micro-ops (see
Expand All @@ -52,9 +52,9 @@ which is generated from [`Python/bytecodes.c`](../Python/bytecodes.c)).
The micro-op sequence is then optimized by
`_Py_uop_analyze_and_optimize` in
[`Python/optimizer_analysis.c`](../Python/optimizer_analysis.c)
and a `_PyUOpExecutor_Type` is created to contain it.
and an instance of `_PyUOpExecutor_Type` is created to contain it.

## Debugging a uop executor in the JIT interpreter
## The JIT interpreter

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can you add a sentence or two saying why we have this strange looking interpreter?
Being able to debug and analyze the optimizations prior independent of machine code generation is vey valuable.

After a `JUMP_BACKWARD` instruction invokes the uop optimizer to create a uop
executor, it transfers control to this executor via the `GOTO_TIER_TWO` macro.
Expand Down
Loading