Feature: _bfpxe
Description
Produces a PXE boot image for NVIDIA BlueField Data Processing Units (DPUs), using a SquashFS root filesystem.
What it does
_bfpxe restricts the build to produce only the BlueField-specific PXE artifacts. Unlike the general _pxe flag, this variant targets the NVIDIA BlueField DPU platform, which requires a compressed SquashFS root image for network boot. It includes _ignite to enable Ignition-based first-boot configuration.
The exec.config script, the dracut live-boot modules, and network configuration files set up the PXE boot chain for the BlueField environment.
Files
Files present in this feature and their purpose. See the feature file reference for the semantics of each file type.
| File | Purpose |
|---|---|
exec.config (ref) | Configures the BlueField PXE build environment, adjusting dracut and network settings for the DPU platform. |
file.exclude (ref) | Removes /etc/repart.d/root.conf from the rootfs so that disk partitioning is skipped in the PXE-only image. |
image.pxe.tar.gz (ref) | Build script that assembles the PXE tarball (vmlinuz, initrd, cmdline, root.squashfs) for BlueField. |
info.yaml (ref) | Declares type: flag and included/excluded features. |
pkg.include (ref) | Installs network and filesystem packages required for the BlueField live-boot environment. |
file.include/etc/dracut.conf.d/20-gl-live.conf (file.include) | Configures dracut to build a live-boot initrd with SquashFS and overlay support. |
file.include/etc/systemd/network/91-default.network (file.include) | Default systemd-networkd configuration that brings up the network interface during PXE boot. |
file.include/usr/lib/dracut/modules.d/98gardenlinux-live/any.conf (file.include) | Dracut module configuration for the Garden Linux live-boot module. |
file.include/usr/lib/dracut/modules.d/98gardenlinux-live/cleanup.sh (file.include) | Cleans up the live environment after the root filesystem has been mounted. |
file.include/usr/lib/dracut/modules.d/98gardenlinux-live/gl-end.service (file.include) | Systemd unit run in the initrd to finalize the live-boot sequence. |
file.include/usr/lib/dracut/modules.d/98gardenlinux-live/is-live-image.sh (file.include) | Helper script that detects whether the system is booting as a live image. |
file.include/usr/lib/dracut/modules.d/98gardenlinux-live/live-get-squashfs.sh (file.include) | Downloads or locates the SquashFS root image during initrd execution. |
file.include/usr/lib/dracut/modules.d/98gardenlinux-live/live-overlay-setup.sh (file.include) | Sets up the writable overlay on top of the read-only SquashFS root. |
file.include/usr/lib/dracut/modules.d/98gardenlinux-live/live-sysroot-generator.sh (file.include) | Generates the sysroot mount units for the live environment. |
file.include/usr/lib/dracut/modules.d/98gardenlinux-live/module-setup.sh (file.include) | Registers the Garden Linux live-boot dracut module and its dependencies. |
file.include/usr/lib/dracut/modules.d/98gardenlinux-live/squash-mount-generator.sh (file.include) | Generates the systemd mount unit for the SquashFS image during early boot. |
Related features
Includes:
_ignite— Provides Ignition support for first-boot configuration of the BlueField system.