Add splitfdstream crate for binary streaming format#229
Merged
cgwalters merged 1 commit intocomposefs:mainfrom Feb 13, 2026
Merged
Add splitfdstream crate for binary streaming format#229cgwalters merged 1 commit intocomposefs:mainfrom
cgwalters merged 1 commit intocomposefs:mainfrom
Conversation
Add a new crate implementing the splitfdstream binary format, which enables streaming tar archives with external file references. The format uses an 8-byte LE signed prefix followed by optional data: - Negative prefix: inline data of size |prefix| - Non-negative prefix: external file descriptor reference by index Key types: - SplitfdstreamWriter: Build splitfdstreams with inline/external chunks - SplitfdstreamReader: Parse splitfdstreams back into chunks - SplitfdstreamTarReader: Read adapter that reconstructs byte streams This enables zero-copy tar reconstruction from containers-storage's tar-split metadata by streaming headers inline while referencing file content via fd. Assisted-by: OpenCode (Opus 4.5) Signed-off-by: Colin Walters <walters@verbum.org>
Collaborator
Author
|
cc @giuseppe |
giuseppe
approved these changes
Feb 13, 2026
Collaborator
giuseppe
left a comment
giuseppe
left a comment
There was a problem hiding this comment.
I am fine with the code, but do we want to merge even without consensus on the c/storage side?
LGTM
Collaborator
Author
|
This PR just adds new internal crate that has zero impact here unless enabled, it's dead code. But I think you and I are making the call on splitfdstream right? Unless someone else shows interest or opinion... The higher level IPC is IMO a distinct topic. |
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
2 participants
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.
Add a new crate implementing the splitfdstream binary format, which enables streaming tar archives with external file references.
The format uses an 8-byte LE signed prefix followed by optional data:
Key types:
This enables zero-copy tar reconstruction from containers-storage's tar-split metadata by streaming headers inline while referencing file content via fd.
Assisted-by: OpenCode (Opus 4.5)