docs: clarify image artifacts and clean rebuilds

Document the amd64 ISO and arm64 image roles, and note that Buildroot
package-option changes require clean rebuilds to avoid stale reverse
dependencies.

Signed-off-by: Jarkko Sakkinen <jarkko@kernel.org>
1 file changed
tree: efbc20df691f99f400f2ce4a4b6787108b67d04e
  1. board/
  2. configs/
  3. linux/
  4. overlay/
  5. package/
  6. patches/
  7. scripts/
  8. sdk/
  9. .dockerignore
  10. .editorconfig
  11. .gitattributes
  12. .gitignore
  13. buildroot.patch
  14. Config.in
  15. Dockerfile
  16. external.desc
  17. external.mk
  18. LICENSE
  19. Makefile
  20. README.md
README.md

linux-tpmdd test suite

bootc container host for linux-tpmdd kernel testing. Builds a live ISO/image and an OCI bootc image (rootfs-oci-latest-<arch>-linux.oci-image.tar).

Building

Host

make build BOARD=tpmdd_amd64
make build BOARD=tpmdd_arm64

After changing Buildroot package options, run make clean before rebuilding both targets. Incremental builds do not rebuild reverse dependencies and may otherwise combine incompatible binaries and libraries.

Artifacts under build/<BOARD>/images/:

  • tpmdd_amd64.iso — live test and offline installation media (UEFI)
  • tpmdd_arm64.img — live test media for Raspberry Pi
  • rootfs-oci-latest-<arch>-linux.oci-image.tar — OCI bootc container (containers.bootc=1)
  • image.manifest — imgref/digest metadata
  • ssh_config — generated SSH client config

OCI container

CONTAINER=docker ./scripts/build.sh

Builds every board defconfig; Buildroot downloads/ccache stay in tpmdd-cache. Export TPMDD_VERSION and/or TPMDD_TARGET_IMGREF to override the image version and target image reference. Unset variables retain their build defaults.

Running

Build first with make build BOARD=<BOARD>. make burn only writes an existing image and requires DEVICE:

make burn BOARD=tpmdd_amd64 DEVICE=/dev/sdX
make burn BOARD=tpmdd_arm64 DEVICE=/dev/sdX

Open a root SSH session with the generated client configuration:

make ssh BOARD=tpmdd_amd64