Skip to content

docs/composefs: Document zstd:chunked pull limitation - #2409

Merged
cgwalters merged 1 commit into
bootc-dev:mainfrom
andrewdunndev:docs/composefs-chunked-limitation
Aug 25, 2026
Merged

docs/composefs: Document zstd:chunked pull limitation#2409
cgwalters merged 1 commit into
bootc-dev:mainfrom
andrewdunndev:docs/composefs-chunked-limitation

Conversation

@andrewdunndev

Copy link
Copy Markdown
Contributor

The composefs backend cannot currently pull zstd:chunked images (#2408): the decoder stops at the first zstd frame, so the pull fails with "unexpected EOF reading tar entry". Note the limitation, the fix in flight, and the publisher-side workaround under Known Issues.

Generated-by: AI
I measured the limitation on my own host and reviewed the line.

Images published with --compression-format zstd:chunked fail to pull
on the composefs backend ("unexpected EOF reading tar entry") because
composefs-rs's decompressor only reads the first zstd frame. Note the
limitation and the workaround per issue bootc-dev#2408.

Generated-by: AI
Signed-off-by: Andrew Dunn <andrew@dunn.dev>
@cgwalters

Copy link
Copy Markdown
Collaborator

(The question is if we'll remember to remove this when we apply the fix...)

@cgwalters
cgwalters merged commit 3eea5bd into bootc-dev:main Aug 25, 2026
19 checks passed
@andrewdunndev

Copy link
Copy Markdown
Contributor Author

The docs entry links #2408, which can't close until a composefs-rs update brings the fix in, so that's the standing reminder; I'll send the removal PR alongside that and close it out.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/documentation Updates to the documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants