Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Partition Image generator:
part-image

Mount nameTypeUsage
inputOverlayThe Raptor build target that will be put into the generated image
outputFilePoints to the resulting output file.

Compatibility

TargetCompatible?
Container: systemd-nspawn
Container: docker
Container: podman
Virtual Machine (UEFI)
Virtual Machine (BIOS)
Physical Machine (UEFI)
Physical Machine (BIOS)

This builder generates partition images, containing a single filesystem.

In other words, this image can be put into a partition, but does not contain a partition table.

The primary use case is for building systemd-nspawn images, but this builder is also useful in other specialty applications – for example, efibootguard, a bootloader that supports A/B partitions for upgrade and recovery.

Since efibootguard uses Unified Kernel Images, an update image typically consists of just a single filesystem. Such an image could be produced by this builder.

Example

Prerequisites:

  • raptor-builders is cloned to raptor-builders
  • An input target called test.rapt

Raptor.toml

[raptor.link]
rbuild = "raptor-builders"

# Partition (filesystem) image
[run.part1]
target = "$rbuild.part-image" # <-- builder is specified here
input = "test"
output = "part.img"

After this Raptor.toml is in place, call raptor make to build:

sudo raptor make part1

When the process is complete, part.img will be ready for use.