doc: document per-architecture fast FFI argument limits - #65207
Open
leah-1ee wants to merge 1 commit into
Open
Conversation
Collaborator
|
Review requested:
|
nodejs-github-bot
added
doc
There was a problem hiding this comment.
Pull request overview
Updates the Fast FFI documentation to clarify when optimized Fast FFI falls back to the generic path by documenting per-architecture trampoline/register constraints.
Changes:
- Replaces the previous narrative description of Fast FFI argument limits with an architecture matrix.
- Adds explicit notes/definitions around buffer-shaped arguments and architectures without a fast-call trampoline (e.g., PPC64BE).
💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
leah-1ee
force-pushed
the
doc-ffi-platform-argument-limits
branch
from
August 11, 2026 05:18
c337b36 to
3b33d30
Compare
The prior text covered only two of the seven supported architectures and conflated x86-64 SysV with the stricter Win64 emitter. Signed-off-by: leah-1ee <selee3196@gmail.com>
leah-1ee
force-pushed
the
doc-ffi-platform-argument-limits
branch
from
August 11, 2026 05:22
3b33d30 to
bfab024
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
The Fast FFI argument-limit paragraph only documented AArch64 and
x86-64, conflating x86-64 SysV with the stricter Win64 x64 emitter
and leaving five architectures undocumented.
Replaces it with a table covering all seven fast-call architectures,
verified against
src/ffi/types.ccand the trampoline generators insrc/ffi/platforms/*.cc.Follow-up to #63960.