Enum ContainerOpts 

pub(crate) enum ContainerOpts {
    Inspect {
        rootfs: Utf8PathBuf,
        json: bool,
        format: Option<OutputFormat>,
    },
    Lint {
        rootfs: Utf8PathBuf,
        fatal_warnings: bool,
        list: bool,
        skip: Vec<String>,
        no_truncate: bool,
    },
    ComputeComposefsDigest {
        path: Utf8PathBuf,
        write_dumpfile_to: Option<Utf8PathBuf>,
        erofs_version: ErofsVersionArg,
    },
    ComputeComposefsDigestFromStorage {
        write_dumpfile_to: Option<Utf8PathBuf>,
        erofs_version: ErofsVersionArg,
        image: Option<String>,
    },
    SplitKernelAndRootfs {
        rootfs: Utf8PathBuf,
        output: Utf8PathBuf,
    },
    Ukify {
        rootfs: Utf8PathBuf,
        kargs: Vec<String>,
        allow_missing_verity: bool,
        erofs_version: Option<BootArtifactErofsVersionArg>,
        write_dumpfile_to: Option<Utf8PathBuf>,
        kernel_dir: Option<Utf8PathBuf>,
        args: Vec<OsString>,
    },
    Aboot {
        rootfs: Utf8PathBuf,
        allow_missing_verity: bool,
        erofs_version: Option<BootArtifactErofsVersionArg>,
        write_dumpfile_to: Option<Utf8PathBuf>,
        kernel_dir: Option<Utf8PathBuf>,
        out: Option<Utf8PathBuf>,
    },
    Export {
        format: ExportFormat,
        output: Option<Utf8PathBuf>,
        kernel_in_boot: bool,
        selinux: ExportSelinuxMode,
        target: Utf8PathBuf,
    },
}

Subcommands which can be executed as part of a container build.

Variants

Inspect

Output information about the container image.

By default, a human-readable summary is output. Use –json or –format to change the output format.

Fields

rootfs: Utf8PathBuf

Operate on the provided rootfs.

json: bool

Output in JSON format.

format: Option<OutputFormat>

The output format.

Lint

Perform relatively inexpensive static analysis checks as part of a container build.

This is intended to be invoked via e.g. RUN bootc container lint as part of a build process; it will error if any problems are detected.

Fields

rootfs: Utf8PathBuf

Operate on the provided rootfs.

fatal_warnings: bool

Make warnings fatal.

list: bool

Instead of executing the lints, just print all available lints. At the current time, this will output in YAML format because it’s reasonably human friendly. However, there is no commitment to maintaining this exact format; do not parse it via code or scripts.

skip: Vec<String>

Skip checking the targeted lints, by name. Use --list to discover the set of available lints.

Example: –skip nonempty-boot –skip baseimage-root

no_truncate: bool

Don’t truncate the output. By default, only a limited number of entries are shown for each lint, followed by a count of remaining entries.

ComputeComposefsDigest

Output the bootable composefs digest for a directory.

This is the digest that bootc container ukify embeds in the kernel command line of a UKI. It is useful for scripting and debugging outside of that flow.

Fields

path: Utf8PathBuf

Path to the filesystem root

write_dumpfile_to: Option<Utf8PathBuf>

Additionally generate a dumpfile for the preferred digest, written to the target path

erofs_version: ErofsVersionArg

EROFS format version to use when computing the composefs digest.

V1 produces a composefs.digest=v1-sha512-12:<hex> karg (C-tool compatible). V2 produces the legacy composefs=<hex> karg (composefs-rs native).

ComputeComposefsDigestFromStorage

Output the bootable composefs digest from container storage.

Fields

write_dumpfile_to: Option<Utf8PathBuf>

Additionally generate a dumpfile for the preferred digest, written to the target path

erofs_version: ErofsVersionArg

EROFS format version to use when computing the composefs digest.

Must match the format used by compute-composefs-digest (and by container ukify) for the two views to be comparable.

image: Option<String>

Identifier for image; if not provided, the running image will be used.

SplitKernelAndRootfs

Split kernel and rootfs from a container image

This command extracts the kernel (vmlinuz and initramfs.img) from the container rootfs and moves them to a separate output directory, organized by kernel version. Files that belong to the kernel binary are moved along with it, currently the FIPS HMAC file (.vmlinuz.hmac) that Fedora and RHEL derivatives ship.

Example: bootc container split-kernel-and-rootfs –rootfs /target-rootfs –output /out

Fields

rootfs: Utf8PathBuf

Operate on the provided rootfs

output: Utf8PathBuf

Output directory for the extracted kernel files

Ukify

Build a Unified Kernel Image (UKI) using ukify.

This command computes the necessary arguments from the container image (kernel, initrd, cmdline, os-release) and invokes ukify with them. Any additional arguments after -- are passed through to ukify unchanged.

Example: bootc container ukify –rootfs /target – –output /output/uki.efi

Fields

rootfs: Utf8PathBuf

Operate on the provided rootfs.

kargs: Vec<String>

Additional kernel arguments to append to the cmdline. Can be specified multiple times. This is a temporary workaround and will be removed.

allow_missing_verity: bool

Make fs-verity validation optional in case the filesystem doesn’t support it

erofs_version: Option<BootArtifactErofsVersionArg>

EROFS format version to use when computing the composefs digest.

By default, produce V1 then V2 kargs for compatibility. V1 produces a composefs.digest=v1-sha512-12:<hex> karg (C-tool compatible), while V2 produces the legacy composefs=<hex> karg (composefs-rs native). V1-only omits the V2 fallback to shorten the kernel command line. Explicit V2 produces only the V2 karg as a compatibility escape hatch.

write_dumpfile_to: Option<Utf8PathBuf>

Write a dumpfile to this path

kernel_dir: Option<Utf8PathBuf>

The directory containing the kernel and initramfs.img Must be of the format /parent/$kernel_version

Ex. /boot/6.18.7-100.fc42.x86_64

args: Vec<OsString>

Additional arguments to pass to ukify (after --).

Aboot

Build an Android boot or ukiboot image using aboot-update.

Fields

rootfs: Utf8PathBuf

Operate on the provided rootfs.

allow_missing_verity: bool

Make fs-verity validation optional in case the filesystem doesn’t support it

erofs_version: Option<BootArtifactErofsVersionArg>

EROFS format version to use when computing the composefs digest.

By default, produce V1 then V2 kargs for compatibility. V1-only omits the V2 fallback to shorten the kernel command line. Explicit V2 produces only the legacy V2 karg.

write_dumpfile_to: Option<Utf8PathBuf>

Write a dumpfile to this path

kernel_dir: Option<Utf8PathBuf>

The directory containing vmlinuz and initramfs.img. Must be of the format /parent/$kernel_version.

out: Option<Utf8PathBuf>

Output directory. Defaults to $rootfs/boot.

Export

Export container filesystem as a tar archive.

This command exports the container filesystem in a bootable format with proper SELinux labeling. The output is written to stdout by default or to a specified file.

Example: bootc container export /target > output.tar

Fields

format: ExportFormat

Format for export output

output: Option<Utf8PathBuf>

Output file (defaults to stdout)

kernel_in_boot: bool

Copy kernel and initramfs from /usr/lib/modules to /boot for legacy compatibility. This is useful for installers that expect the kernel in /boot.

selinux: ExportSelinuxMode

SELinux labeling mode for exported entries.

target: Utf8PathBuf

Path to the container filesystem root

Trait Implementations

impl Debug for ContainerOpts

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

Formats the value using the given formatter.

impl Eq for ContainerOpts

impl FromArgMatches for ContainerOpts

fn from_arg_matches(__clap_arg_matches: &ArgMatches) -> Result<Self, Error>

Instantiate Self from [ArgMatches], parsing the arguments as needed.

fn from_arg_matches_mut( __clap_arg_matches: &mut ArgMatches, ) -> Result<Self, Error>

Instantiate Self from [ArgMatches], parsing the arguments as needed.

fn update_from_arg_matches( &mut self, __clap_arg_matches: &ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

fn update_from_arg_matches_mut<'b>( &mut self, __clap_arg_matches: &mut ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

impl PartialEq for ContainerOpts

fn eq(&self, other: &ContainerOpts) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for ContainerOpts

impl Subcommand for ContainerOpts

fn augment_subcommands<'b>(__clap_app: Command) -> Command

Append to [Command] so it can instantiate Self via [FromArgMatches::from_arg_matches_mut]

fn augment_subcommands_for_update<'b>(__clap_app: Command) -> Command

Append to [Command] so it can instantiate self via [FromArgMatches::update_from_arg_matches_mut]

fn has_subcommand(__clap_name: &str) -> bool

Test whether Self can parse a specific subcommand