Skip to content

gh-119786: Edit InternalDocs/frames.md, Python/vm-state.md, Python/tier2_engine.md #124450

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

Open
Eclips4 wants to merge 11 commits into
base: main
Choose a base branch
from
Open

gh-119786: Edit InternalDocs/frames.md, Python/vm-state.md, Python/tier2_engine.md #124450

Changes from 1 commit
Commits
Show all changes
11 commits
Select commit Hold shift + click to select a range
60b1689
Move files to InternalDocs
Eclips4 Sep 24, 2024
fbf47e4
Fix grammar
Eclips4 Sep 24, 2024
3aaa70c
Add link to VM in the README
Eclips4 Sep 24, 2024
1a6df69
Apply suggestions from code review
Eclips4 Sep 27, 2024
944d1ab
Remove reference to PEP 695; instead add reference to adaptive.md
Eclips4 Sep 27, 2024
0c2489f
Add reference to exception_handling.md
Eclips4 Sep 27, 2024
c7cdfb5
Move thread state section right after the frame state section
Eclips4 Sep 27, 2024
be38623
Remove Tier2 IR section from vm-state
Eclips4 Sep 27, 2024
26d5559
Address review
Eclips4 Jan 13, 2025
52225eb
Move unwinding to the exception_handling
Eclips4 Jan 13, 2025
ba8f39a
Unwinding is already covered; Reverting
Eclips4 Jan 13, 2025
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
Remove Tier2 IR section from vm-state
  • Loading branch information
@Eclips4
Eclips4 committed Sep 27, 2024
commit be38623947e73086a2e575b27f97206c33b07c88
10 changes: 0 additions & 10 deletions InternalDocs/vm-state.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -69,13 +69,3 @@ Patching exits should be fairly straightforward in the interpreter.
It will be more complex in the JIT.

(We might also consider deoptimizations as a separate jump type.)

# Tier 2 IR format

The tier 2 IR (Internal Representation) format is also the basis for the Tier 2 interpreter (though the two formats may eventually differ). This format is also used as the input to the machine code generator (the JIT compiler).

Tier 2 IR entries are all the same size; there is no equivalent to `EXTENDED_ARG` or trailing inline cache entries. Each instruction is a struct with the following fields (all integers of varying sizes):

- **opcode**: Sometimes the same as a Tier 1 opcode, sometimes a separate micro opcode. Tier 2 opcodes are 9 bits (as opposed to Tier 1 opcodes, which fit in 8 bits). By convention, Tier 2 opcode names start with `_`.
- **oparg**: The argument. Usually the same as the Tier 1 oparg after expansion of `EXTENDED_ARG` prefixes. Up to 32 bits.
- **operand**: An additional argument, Typically the value of *one* cache item from the Tier 1 inline cache, up to 64 bits.
Comment thread
Eclips4 marked this conversation as resolved.