Struct GetLayerParams 

pub struct GetLayerParams {
    pub diff_id: Option<String>,
    pub storage: Option<StorageLocator>,
    pub consumer_has_cap_dac_override: bool,
    pub layer_index: Option<u64>,
}

Parameters for the GetLayer method of the org.composefs.Oci interface.

Exactly one of diff_id, storage or layer_index must be set:

• Repo service (CfsctlService): reads diff_id, errors if None.
• Cstor service (CstorLayerService): reads storage, errors if None.
• containers-storage image service (skopeo’s OpenVarlinkSocket): reads layer_index, errors if None.

Both fields are Option for forward-compatibility: new locator kinds can be added in future without breaking old clients.

Fields

diff_id: Option<String>

OCI diff-id (sha256:…) identifying the layer in a composefs repo.

storage: Option<StorageLocator>

Location of a specific layer inside a containers-storage store.

consumer_has_cap_dac_override: bool

Whether the consumer of this layer’s bytes can bypass file DAC permissions (real root or CAP_DAC_OVERRIDE). When true, the cstor service may emit FileBackedData chunks even for non-world-readable files, since the consumer can open them directly. Defaults to false for backward compatibility.

layer_index: Option<u64>

Position of a layer in the image a service serves, from 0 for the base layer, in the order of the config’s rootfs.diff_ids.

A service bound to one image resolves it with its own record of which layers make up the image, so a layer is found even when its diff ID was never checked, and a config cannot name a layer of an unrelated image. The client still has to verify what it receives against the diff ID it expects.

Trait Implementations

impl Clone for GetLayerParams

fn clone(&self) -> GetLayerParams

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for GetLayerParams

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Default for GetLayerParams

fn default() -> GetLayerParams

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for GetLayerParams

fn deserialize<__D>( __deserializer: __D, ) -> Result<GetLayerParams, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for GetLayerParams

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Type for GetLayerParams

const TYPE: &'static Type<'static>

The type information.