Skip to content

Commit

Permalink
arm64: Add ZBOOT PE containing compressed image support
Browse files Browse the repository at this point in the history
The kernel EFI stub ZBOOT feature creates a PE that
contains a compressed linux kernel image. The stub
when run in a valid UEFI environment then decompresses
the resulting image and executes it.

Support these image formats with kexec as well to avoid
having to keep an alternate kernel image around.

This patch adds a the _probe(), _load() and usage() routines needed for
kexec to understand this format.

Signed-off-by: Jeremy Linton <[email protected]>
[Modified by Pingfan to export kernel fd with load method]
Signed-off-by: Pingfan Liu <[email protected]>
To: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Signed-off-by: Simon Horman <[email protected]>
  • Loading branch information
jlintonarm authored and horms committed Aug 3, 2023
1 parent 1c04083 commit 80c9204
Show file tree
Hide file tree
Showing 2 changed files with 111 additions and 0 deletions.
1 change: 1 addition & 0 deletions kexec/arch/arm64/image-header.h
Original file line number Diff line number Diff line change
Expand Up @@ -37,6 +37,7 @@ struct arm64_image_header {

static const uint8_t arm64_image_magic[4] = {'A', 'R', 'M', 0x64U};
static const uint8_t arm64_image_pe_sig[2] = {'M', 'Z'};
static const uint8_t arm64_pe_machtype[6] = {'P','E', 0x0, 0x0, 0x64, 0xAA};
static const uint64_t arm64_image_flag_be = (1UL << 0);
static const uint64_t arm64_image_flag_page_size = (3UL << 1);
static const uint64_t arm64_image_flag_placement = (1UL << 3);
Expand Down
110 changes: 110 additions & 0 deletions kexec/arch/arm64/kexec-vmlinuz-arm64.c
Original file line number Diff line number Diff line change
@@ -0,0 +1,110 @@
/*
* ARM64 PE compressed Image (vmlinuz, ZBOOT) support.
*
* Several distros use 'make zinstall' rule inside
* 'arch/arm64/boot/Makefile' to install the arm64
* ZBOOT compressed file inside the boot destination
* directory (for e.g. /boot).
*
* Currently we cannot use kexec_file_load() to load vmlinuz
* PE images that self decompress.
*
* To support ZBOOT, we should:
* a). Copy the compressed contents of vmlinuz to a temporary file.
* b). Decompress (gunzip-decompress) the contents inside the
* temporary file.
* c). Validate the resulting image and write it back to the
* temporary file.
* d). Pass the 'fd' of the temporary file to the kernel space.
*
* Note this, module doesn't provide a _load() function instead
* relying on image_arm64_load() to load the resulting decompressed
* image.
*
* So basically the kernel space still gets a decompressed
* kernel image to load via kexec-tools.
*/

#define _GNU_SOURCE
#include <fcntl.h>
#include <unistd.h>
#include <stdlib.h>
#include "kexec-arm64.h"
#include <kexec-pe-zboot.h>
#include "arch/options.h"

static int kernel_fd = -1;

/* Returns:
* -1 : in case of error/invalid format (not a valid PE+compressed ZBOOT format.
*/
int pez_arm64_probe(const char *kernel_buf, off_t kernel_size)
{
int ret = -1;
const struct arm64_image_header *h;
char *buf;
off_t buf_sz;

buf = (char *)kernel_buf;
buf_sz = kernel_size;
if (!buf)
return -1;
h = (const struct arm64_image_header *)buf;

dbgprintf("%s: PROBE.\n", __func__);
if (buf_sz < sizeof(struct arm64_image_header)) {
dbgprintf("%s: Not large enough to be a PE image.\n", __func__);
return -1;
}
if (!arm64_header_check_pe_sig(h)) {
dbgprintf("%s: Not an PE image.\n", __func__);
return -1;
}

if (buf_sz < sizeof(struct arm64_image_header) + h->pe_header) {
dbgprintf("%s: PE image offset larger than image.\n", __func__);
return -1;
}

if (memcmp(&buf[h->pe_header],
arm64_pe_machtype, sizeof(arm64_pe_machtype))) {
dbgprintf("%s: PE header doesn't match machine type.\n", __func__);
return -1;
}

ret = pez_prepare(buf, buf_sz, &kernel_fd);

if (!ret) {
/* validate the arm64 specific header */
struct arm64_image_header hdr_check;
if (read(kernel_fd, &hdr_check, sizeof(hdr_check)) != sizeof(hdr_check))
goto bad_header;

lseek(kernel_fd, 0, SEEK_SET);

if (!arm64_header_check_magic(&hdr_check)) {
dbgprintf("%s: Bad arm64 image header.\n", __func__);
goto bad_header;
}
}

return ret;
bad_header:
close(kernel_fd);
free(buf);
return -1;
}

int pez_arm64_load(int argc, char **argv, const char *buf, off_t len,
struct kexec_info *info)
{
info->kernel_fd = kernel_fd;
return image_arm64_load(argc, argv, buf, len, info);
}

void pez_arm64_usage(void)
{
printf(
" An ARM64 vmlinuz, PE image of a compressed, little endian.\n"
" kernel, built with ZBOOT enabled.\n\n");
}

0 comments on commit 80c9204

Please sign in to comment.