iso

Documentation

Overview

Package iso contains functions for creating ISO images.

Index

• func CreateGRUB(printf func(string, ...any), options GRUBOptions) error
• func CreateUEFI(printf func(string, ...any), options UEFIOptions) error
• func Label(version string, secureboot bool) string
• func VolumeID(label string) string
• type GRUBOptions
• type UEFIOptions

Functions

func CreateGRUB

func CreateGRUB(printf func(string, ...any), options GRUBOptions) error

CreateGRUB creates a GRUB-based ISO image.

This iso supports both BIOS and UEFI booting.

func CreateUEFI

func CreateUEFI(printf func(string, ...any), options UEFIOptions) error

CreateUEFI creates an iso using a UKI, systemd-boot.

The ISO created supports only booting in UEFI mode, and supports SecureBoot.

func Label

func Label(version string, secureboot bool) string

Label returns an ISO full label for a given version.

func VolumeID

func VolumeID(label string) string

VolumeID returns a valid volume ID for the given label.

Types

type GRUBOptions

type GRUBOptions struct {
	KernelPath    string
	InitramfsPath string
	Cmdline       string
	Version       string

	ScratchDir string

	OutPath string
}

GRUBOptions described the input for the CreateGRUB function.

type UEFIOptions

type UEFIOptions struct {
	UKIPath    string
	SDBootPath string

	// A value in loader.conf secure-boot-enroll: off, manual, if-safe, force.
	SDBootSecureBootEnrollKeys string

	// UKISigningCertDer is the DER encoded UKI signing certificate.
	UKISigningCertDerPath string

	// optional, for auto-enrolling secureboot keys
	PlatformKeyPath    string
	KeyExchangeKeyPath string
	SignatureKeyPath   string

	Arch    string
	Version string

	ScratchDir string
	OutPath    string
}

UEFIOptions describe the input for the CreateUEFI function.