Expand description
APIs for operating on container images in the bootc storage.
Β§bootc image set-unified
set_unified_entrypoint dispatches to set_unified (ostree backend) or
set_unified_composefs (composefs backend). Both pull the currently booted
image into bootc-owned containers-storage so that future upgrade/switch
operations can use the unified storage path.
In the planned three-store architecture (see crate::store), this will
require a reflink-capable filesystem (XFS or btrfs) by default to enable
block sharing. The planned --allow-copy flag will opt into a byte copy
for environments like ext4 where podman access to the OS image matters
more than disk efficiency.
StructsΒ§
- Image
Output π
EnumsΒ§
- Image
List πType Column
ConstantsΒ§
- IMAGE_
DEFAULT π - The name of the image we push to containers-storage if nothing is specified.
FunctionsΒ§
- get_
imgrefs_ πfor_ copy - Returns the source and target ImageReference If the source isnβt specified, we use booted image If the target isnβt specified, we push to containers-storage with our default image
- image_
exists_ πin_ host_ storage - Check if an image exists in the default containers-storage (podman storage).
- imgcmd_
entrypoint π - Thin wrapper for invoking
podman image <X>but set up for our internal image store (as distinct from /var/lib/containers default). - list_
entrypoint π - list_
host_ πimages - list_
host_ πimages_ composefs - list_
images π - list_
logical_ πimages - push_
entrypoint π - Implementation of
bootc image push-to-storage. - set_
unified π - Inner implementation of set_unified for ostree that accepts a storage reference.
- set_
unified_ πcomposefs - Composefs implementation of set_unified: pull the booted image into bootc-owned containers-storage so future upgrades use the unified (zero-copy) path automatically.
- set_
unified_ πentrypoint - Re-pull the currently booted image into the bootc-owned container storage.