Thanks to visit codestin.com
Credit goes to github.com

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
cache layouts
  • Loading branch information
@iritkatriel
iritkatriel committed Dec 5, 2024
commit 43aa0dfd62f7da5b402f942e483e007fe9cddf6c
12 changes: 7 additions & 5 deletions InternalDocs/interpreter.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -127,11 +127,13 @@ the same. Cache entries are reserved by the compiler and initialized with zeros
Although they are represented by code units, cache entries do not conform to the
`opcode` / `oparg` format.

If an instruction has an inline cache, the layout of its cache is described by
a `struct` definition in [`pycore_code.h`](../Include/internal/pycore_code.h).
This allows us to access the cache by casting `next_instr` to a pointer to this `struct`.
The size of such a `struct` must be independent of the machine architecture, word size
and alignment requirements. For a 32-bit field, the `struct` should use `_Py_CODEUNIT field[2]`.
If an instruction has an inline cache, the layout of its cache is described in
the instruction's definition in [`Python/bytecodes.c`](../Python/bytecodes.c).
The structs defined in [`pycore_code.h`](../Include/internal/pycore_code.h)
allow us to access the cache by casting `next_instr` to a pointer to the relevant
`struct`. The size of such a `struct` must be independent of the machine
architecture, word size and alignment requirements. For a 32-bit field, the
`struct` should use `_Py_CODEUNIT field[2]`.

The instruction implementation is responsible for advancing `next_instr` past the inline cache.
For example, if an instruction's inline cache is four bytes (that is, two code units) in size,
Expand Down