automation-tests/storage/docs
Miloslav Trmač fc19c49e20 When applying a chunked layer with a tar-split, compute its uncompressed digest
This will allow c/image to validate the uncompressed digest against the config's
RootFS.DiffID value (ensuring that the layer's contents are the same when pulled
via TOC and traditionally); and the uncompressed digest will be used as a layer ID,
ensuring users see the traditional layer and image IDs they are used to.

This doesn't work for layers without a tar-split (all estargz, and old zstd:chunked
layers); for those, we fall back to traditional pulls.

Alternatively, for EXTREMELY restricted use cases, add an
"insecure_allow_unpredictable_image_contents" option to storage.conf. This option
allows partial pulls of estargz and old zstd:chunked layers, and skips the costly
uncompressed digest computation. It is then up to the user to worry about
images where the tar representation and the TOC representation don't match,
and about unpredictable image IDs.

Signed-off-by: Miloslav Trmač <mitr@redhat.com>
2025-01-07 16:56:09 +01:00
..
Makefile docs/Makefile: add missing phony targets 2023-05-23 17:56:03 -07:00
containers-storage-add-names.md Complete "pulling up" of images in updateNames() 2023-03-31 10:36:30 -04:00
containers-storage-applydiff-using-staging-dir.md cmd: add applydiff-using-staging-dir 2023-10-03 09:38:44 +02:00
containers-storage-applydiff.md Finish renaming oci-storage to containers-storage 2017-07-10 16:11:09 -04:00
containers-storage-changes.md Finish renaming oci-storage to containers-storage 2017-07-10 16:11:09 -04:00
containers-storage-check.md Initial implementation of consistency checks 2023-04-13 10:38:24 -04:00
containers-storage-composefs.md docs: Fill in more about composefs and zstd:chunked 2024-08-22 15:22:22 -04:00
containers-storage-config.md Disable partial pulls (zstd:chunked) by default 2024-11-04 13:52:48 -05:00
containers-storage-container.md Add a CLI "layer" command 2017-09-29 15:06:59 -04:00
containers-storage-containers.md Finish renaming oci-storage to containers-storage 2017-07-10 16:11:09 -04:00
containers-storage-copy.md Exercise Copy[File]WithTar, optionally with Chown flags 2018-05-01 10:27:34 -04:00
containers-storage-create-container.md Finish renaming oci-storage to containers-storage 2017-07-10 16:11:09 -04:00
containers-storage-create-image.md Finish renaming oci-storage to containers-storage 2017-07-10 16:11:09 -04:00
containers-storage-create-layer.md Test helper: add "unshare"/"create-storage-layer"/"storage-layers" 2023-04-10 10:23:23 -04:00
containers-storage-create-storage-layer.md Test helper: add "unshare"/"create-storage-layer"/"storage-layers" 2023-04-10 10:23:23 -04:00
containers-storage-dedup.md containers-storage: new command 'dedup' 2024-12-09 16:41:59 +01:00
containers-storage-delete-container.md Finish renaming oci-storage to containers-storage 2017-07-10 16:11:09 -04:00
containers-storage-delete-image.md fix typos and spelling 2022-07-27 21:39:12 +02:00
containers-storage-delete-layer.md Finish renaming oci-storage to containers-storage 2017-07-10 16:11:09 -04:00
containers-storage-delete.md Finish renaming oci-storage to containers-storage 2017-07-10 16:11:09 -04:00
containers-storage-diff.md Finish renaming oci-storage to containers-storage 2017-07-10 16:11:09 -04:00
containers-storage-diffsize.md Finish renaming oci-storage to containers-storage 2017-07-10 16:11:09 -04:00
containers-storage-exists.md Finish renaming oci-storage to containers-storage 2017-07-10 16:11:09 -04:00
containers-storage-gc.md Run codespell on codebase 2023-02-09 12:27:59 -05:00
containers-storage-get-container-data-digest.md Wrap new data retrieval APIs in the CLI tool 2017-10-02 17:50:01 -04:00
containers-storage-get-container-data-size.md Wrap new data retrieval APIs in the CLI tool 2017-10-02 17:50:01 -04:00
containers-storage-get-container-data.md Wrap new data retrieval APIs in the CLI tool 2017-10-02 17:50:01 -04:00
containers-storage-get-container-dir.md fix typos and spelling 2022-07-27 21:39:12 +02:00
containers-storage-get-container-run-dir.md fix typos and spelling 2022-07-27 21:39:12 +02:00
containers-storage-get-image-data-digest.md Wrap new data retrieval APIs in the CLI tool 2017-10-02 17:50:01 -04:00
containers-storage-get-image-data-size.md Wrap new data retrieval APIs in the CLI tool 2017-10-02 17:50:01 -04:00
containers-storage-get-image-data.md Wrap new data retrieval APIs in the CLI tool 2017-10-02 17:50:01 -04:00
containers-storage-get-image-dir.md Store: add ImageDirectory() and ImageRunDirectory() 2024-01-23 14:35:01 -05:00
containers-storage-get-image-run-dir.md Store: add ImageDirectory() and ImageRunDirectory() 2024-01-23 14:35:01 -05:00
containers-storage-get-layer-data.md containers-storage: support layer bigdata 2021-02-02 11:39:03 +01:00
containers-storage-get-names.md Complete "pulling up" of images in updateNames() 2023-03-31 10:36:30 -04:00
containers-storage-image.md Add a CLI "layer" command 2017-09-29 15:06:59 -04:00
containers-storage-images-by-digest.md Teach images to hold multiple manifests 2019-02-07 10:27:36 -05:00
containers-storage-images.md Finish renaming oci-storage to containers-storage 2017-07-10 16:11:09 -04:00
containers-storage-import-layer.md docs: add manpage for import-layer 2019-05-03 16:18:29 +02:00
containers-storage-layer.md fix typos and spelling 2022-07-27 21:39:12 +02:00
containers-storage-layers.md Finish renaming oci-storage to containers-storage 2017-07-10 16:11:09 -04:00
containers-storage-list-container-data.md Wrap new data retrieval APIs in the CLI tool 2017-10-02 17:50:01 -04:00
containers-storage-list-image-data.md Wrap new data retrieval APIs in the CLI tool 2017-10-02 17:50:01 -04:00
containers-storage-list-layer-data.md fix typos and spelling 2022-07-27 21:39:12 +02:00
containers-storage-metadata.md Finish renaming oci-storage to containers-storage 2017-07-10 16:11:09 -04:00
containers-storage-mount.md Add man-page of subcommand mounted 2018-11-20 12:35:51 +09:00
containers-storage-mounted.md Add man-page of subcommand mounted 2018-11-20 12:35:51 +09:00
containers-storage-remove-names.md Complete "pulling up" of images in updateNames() 2023-03-31 10:36:30 -04:00
containers-storage-set-container-data.md Wrap new data retrieval APIs in the CLI tool 2017-10-02 17:50:01 -04:00
containers-storage-set-image-data.md Wrap new data retrieval APIs in the CLI tool 2017-10-02 17:50:01 -04:00
containers-storage-set-layer-data.md containers-storage: support layer bigdata 2021-02-02 11:39:03 +01:00
containers-storage-set-metadata.md Finish renaming oci-storage to containers-storage 2017-07-10 16:11:09 -04:00
containers-storage-set-names.md Complete "pulling up" of images in updateNames() 2023-03-31 10:36:30 -04:00
containers-storage-shutdown.md Finish renaming oci-storage to containers-storage 2017-07-10 16:11:09 -04:00
containers-storage-status.md Finish renaming oci-storage to containers-storage 2017-07-10 16:11:09 -04:00
containers-storage-unmount.md Add man-page of subcommand mounted 2018-11-20 12:35:51 +09:00
containers-storage-unshare.md Test helper: add "unshare"/"create-storage-layer"/"storage-layers" 2023-04-10 10:23:23 -04:00
containers-storage-version.md Finish renaming oci-storage to containers-storage 2017-07-10 16:11:09 -04:00
containers-storage-wipe.md Finish renaming oci-storage to containers-storage 2017-07-10 16:11:09 -04:00
containers-storage-zstd-chunked.md docs: Fill in more about composefs and zstd:chunked 2024-08-22 15:22:22 -04:00
containers-storage.conf.5.md When applying a chunked layer with a tar-split, compute its uncompressed digest 2025-01-07 16:56:09 +01:00
containers-storage.md cmd: add applydiff-using-staging-dir 2023-10-03 09:38:44 +02:00