NAME

       debefivm-ukify - Create Unified Kernel Images for UEFI systems in a similar way to systemd's ukify

SYNOPSIS

       debefivm-ukify build --linux=vmlinuz --output=uki.efi [options]

DESCRIPTION

       debefivm-ukify is a reimplementation of parts of systemd-ukify and mainly meant for backports.  Please
       prefer systemd's implementation.  It only supports the build subcommand, does not implement any
       functionality related to secure boot and lacks configuration file support.  Other than that, it can be
       used to assemble a linux kernel image, an initrd and an EFI stub image from systemd into an EFI-bootable
       Unified Kernel Image.

OPTIONS

       --deb-arch=debian_architecture
               Set  the  architecture  of  the  supplied  and  produced  artifacts  using  Debian's architecture
               nomenclature.  See --efi-arch for another supplying it using the EFI nomenclature instead.   This
               option is not available on the systemd implementation.

       --devicetree=devicetree_blob
               Add  a  device  tree file as a dtb section to the generated UKI.  There can be at most one device
               tree.

       --cmdline=kernel_cmdline
               Supply extra arguments to be appended to the Linux kernel command line during boot.  Can be given
               given at most once.  If the value starts with an @, it is treated as a  filename  whose  contents
               will be added.

       --efi-arch=efi_architecture
               Set   the   architecture  of  the  supplied  and  produced  artifacts  using  EFI's  architecture
               nomenclature.  See --deb-arch for another supplying it using the Debian nomenclature instead.

       --initrd=initrd
               Supply an initrd image to be embedded.  There can be at most one initrd.

       --linux=vmlinuz
               Supply a Linux kernel image to be embedded.  This option must be given exactly once.

       --os-release=release_information
               Set the os-release description of in the UKI.  Can be given given at most  once.   If  the  value
               starts with an @, it is treated as a filename whose contents will be added.

       --output=<uki.efi>
               Set  the  name of the resulting UKI image.  This option must be given exactly once and the target
               file must not exist already.

       --section=<name:value>
               Add an arbitrary ELF section to the resulting UKI.  If the value starts with an @, it is  treated
               as  a  filename  whose  contents  will  be  added.   Most  image components actually are such ELF
               sections.  For instance --os-release, adds a section named osrel.

       --stub=efi_stub
               Supply the location of systemd's EFI stub image.  Unlike the systemd implementation, this  option
               accepts  a directory containing stubs named by architecture.  By default, stubs will be looked up
               in /usr/lib/systemd/boot/efi.

       --verbose
               Print diagnostic information during image conversion.   This  option  is  not  available  on  the
               systemd implementation.

SEE ALSO

           ukify(1)

perl v5.40.1                                       2025-06-18                                  DEBEFIVM-UKIFY(1)