src/image/efi_image.c - master - githubmirror/ipxe

src/image/efi_image.c
595 строк17 KB
Michael Brown
[efi] Allow creating an image device handle with no parent device
05 мар 2026, 16:25
05 мар 2026, 16:25cbeda20
/*
 * Copyright (C) 2008 Michael Brown <mbrown@fensystems.co.uk>.
 *
 * This program is free software; you can redistribute it and/or
 * modify it under the terms of the GNU General Public License as
 * published by the Free Software Foundation; either version 2 of the
 * License, or any later version.
 *
 * This program is distributed in the hope that it will be useful, but
 * WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
 * 02110-1301, USA.
 */

FILE_LICENCE ( GPL2_OR_LATER );
FILE_SECBOOT ( PERMITTED );

#include <errno.h>
#include <stdlib.h>
#include <string.h>
#include <wchar.h>
#include <ipxe/efi/efi.h>
#include <ipxe/efi/efi_snp.h>
#include <ipxe/efi/efi_download.h>
#include <ipxe/efi/efi_file.h>
#include <ipxe/efi/efi_path.h>
#include <ipxe/efi/efi_strings.h>
#include <ipxe/efi/efi_wrap.h>
#include <ipxe/efi/efi_pxe.h>
#include <ipxe/efi/efi_driver.h>
#include <ipxe/efi/efi_image.h>
#include <ipxe/efi/efi_shim.h>
#include <ipxe/efi/efi_fdt.h>
#include <ipxe/efi/efi_utils.h>
#include <ipxe/image.h>
#include <ipxe/init.h>
#include <ipxe/features.h>
#include <ipxe/uri.h>
#include <ipxe/console.h>

FEATURE ( FEATURE_IMAGE, "EFI", DHCP_EB_FEATURE_EFI, 1 );

/* Disambiguate the various error causes */
#define EINFO_EEFI_LOAD							\
	__einfo_uniqify ( EINFO_EPLATFORM, 0x01,			\
			  "Could not load image" )
#define EINFO_EEFI_LOAD_PROHIBITED					\
	__einfo_platformify ( EINFO_EEFI_LOAD, EFI_SECURITY_VIOLATION,	\
			      "Image prohibited by security policy" )
#define EEFI_LOAD_PROHIBITED						\
	__einfo_error ( EINFO_EEFI_LOAD_PROHIBITED )
#define EEFI_LOAD( efirc ) EPLATFORM ( EINFO_EEFI_LOAD, efirc,		\
				       EEFI_LOAD_PROHIBITED )
#define EINFO_EEFI_START						\
	__einfo_uniqify ( EINFO_EPLATFORM, 0x02,			\
			  "Could not start image" )
#define EEFI_START( efirc ) EPLATFORM ( EINFO_EEFI_START, efirc )

/**
 * Create a URI device path for image
 *
 * @v image		EFI image
 * @v parent		Parent device path
 * @ret path		Device path, or NULL on failure
 *
 * The caller must eventually free() the device path.
 */
static EFI_DEVICE_PATH_PROTOCOL *
efi_image_uripath ( struct image *image, EFI_DEVICE_PATH_PROTOCOL *parent ) {
	EFI_DEVICE_PATH_PROTOCOL *path;
	URI_DEVICE_PATH *uripath;
	EFI_DEVICE_PATH_PROTOCOL *end;
	size_t uri_len;
	size_t prefix_len;
	size_t uripath_len;
	size_t len;

	/* Calculate device path lengths */
	prefix_len = efi_path_len ( parent );
	uri_len = format_uri ( image->uri, NULL, 0 );
	uripath_len = ( sizeof ( *uripath ) + uri_len + 1 /* NUL */ );
	len = ( prefix_len + uripath_len + sizeof ( *end ) );

	/* Allocate device path */
	path = zalloc ( len );
	if ( ! path )
		return NULL;

	/* Construct device path */
	memcpy ( path, parent, prefix_len );
	uripath = ( ( ( void * ) path ) + prefix_len );
	uripath->Header.Type = MESSAGING_DEVICE_PATH;
	uripath->Header.SubType = MSG_URI_DP;
	uripath->Header.Length[0] = ( uripath_len & 0xff );
	uripath->Header.Length[1] = ( uripath_len >> 8 );
	format_uri ( image->uri, uripath->Uri, ( uri_len + 1 /* NUL */ ) );
	end = ( ( ( void * ) uripath ) + uripath_len );
	efi_path_terminate ( end );

	return path;
}

/**
 * Create a file device path for image
 *
 * @v image		EFI image
 * @v parent		Parent device path
 * @ret path		Device path, or NULL on failure
 *
 * The caller must eventually free() the device path.
 */
static EFI_DEVICE_PATH_PROTOCOL *
efi_image_filepath ( struct image *image, EFI_DEVICE_PATH_PROTOCOL *parent ) {
	EFI_DEVICE_PATH_PROTOCOL *path;
	FILEPATH_DEVICE_PATH *filepath;
	EFI_DEVICE_PATH_PROTOCOL *end;
	size_t name_len;
	size_t prefix_len;
	size_t filepath_len;
	size_t len;

	/* Calculate device path lengths */
	prefix_len = efi_path_len ( parent );
	name_len = strlen ( image->name );
	filepath_len = ( SIZE_OF_FILEPATH_DEVICE_PATH +
			 ( name_len + 1 /* NUL */ ) * sizeof ( wchar_t ) );
	len = ( prefix_len + filepath_len + sizeof ( *end ) );

	/* Allocate device path */
	path = zalloc ( len );
	if ( ! path )
		return NULL;

	/* Construct device path */
	memcpy ( path, parent, prefix_len );
	filepath = ( ( ( void * ) path ) + prefix_len );
	filepath->Header.Type = MEDIA_DEVICE_PATH;
	filepath->Header.SubType = MEDIA_FILEPATH_DP;
	filepath->Header.Length[0] = ( filepath_len & 0xff );
	filepath->Header.Length[1] = ( filepath_len >> 8 );
	efi_snprintf ( filepath->PathName, ( name_len + 1 /* NUL */ ),
		       "%s", image->name );
	end = ( ( ( void * ) filepath ) + filepath_len );
	efi_path_terminate ( end );

	return path;
}

/**
 * Create command line for image
 *
 * @v image             EFI image
 * @ret cmdline		Command line, or NULL on failure
 */
static wchar_t * efi_image_cmdline ( struct image *image ) {
	wchar_t *cmdline;

	/* Allocate and construct command line */
	if ( efi_asprintf ( &cmdline, "%s%s%s", image->name,
			    ( image->cmdline ? " " : "" ),
			    ( image->cmdline ? image->cmdline : "" ) ) < 0 ) {
		return NULL;
	}

	return cmdline;
}

/**
 * Install EFI Flattened Device Tree table (when no FDT support is present)
 *
 * @v cmdline		Command line, or NULL
 * @ret rc		Return status code
 */
__weak int efi_fdt_install ( const char *cmdline __unused ) {
	return 0;
}

/**
 * Uninstall EFI Flattened Device Tree table (when no FDT support is present)
 *
 * @ret rc		Return status code
 */
__weak int efi_fdt_uninstall ( void ) {
	return 0;
}

/**
 * Execute EFI image
 *
 * @v image		EFI image
 * @ret rc		Return status code
 */
static int efi_image_exec ( struct image *image ) {
	EFI_BOOT_SERVICES *bs = efi_systab->BootServices;
	struct efi_snp_device *snpdev;
	struct net_device *netdev;
	EFI_DEVICE_PATH_PROTOCOL *basepath;
	EFI_DEVICE_PATH_PROTOCOL *devpath;
	EFI_DEVICE_PATH_PROTOCOL *imgpath;
	EFI_LOADED_IMAGE_PROTOCOL *loaded;
	struct image *shim;
	struct image *exec;
	EFI_HANDLE parent;
	EFI_HANDLE device;
	EFI_HANDLE handle;
	EFI_MEMORY_TYPE type;
	wchar_t *cmdline;
	unsigned int toggle;
	EFI_STATUS efirc;
	int rc;

	/* Find an appropriate parent device handle to use */
	snpdev = last_opened_snpdev();
	if ( snpdev ) {
		/* We have a netX: use this as the base device */
		parent = snpdev->handle;
		basepath = snpdev->path;
		netdev = netdev_get ( snpdev->netdev );
		DBGC ( image, "EFIIMAGE %s using %s %s\n", image->name,
		       netdev->name, efi_devpath_text ( basepath ) );
	} else {
		/* We have no netX: fall back to using our own loaded
		 * image's device.
		 */
		parent = efi_loaded_image->DeviceHandle;
		basepath = efi_loaded_image_path;
		netdev = NULL;
		if ( efi_test ( parent, &efi_device_path_protocol_guid ) != 0 )
			parent = NULL;
		DBGC ( image, "EFIIMAGE %s using %s%s\n",
		       image->name, efi_devpath_text ( basepath ),
		       ( parent ? "" : " (removed)" ) );
	}

	/* Construct URI device path */
	devpath = efi_image_uripath ( image, basepath );
	if ( ! devpath ) {
		DBGC ( image, "EFIIMAGE %s could not create URI device path\n",
		       image->name );
		rc = -ENOMEM;
		goto err_device_path;
	}

	/* Create device handle */
	device = NULL;
	if ( ( efirc = bs->InstallMultipleProtocolInterfaces (
			&device,
			&efi_device_path_protocol_guid, devpath,
			NULL ) ) != 0 ) {
		rc = -EEFI ( efirc );
		DBGC ( image, "EFIIMAGE %s could not install %s: %s\n",
		       image->name, efi_devpath_text ( devpath ),
		       strerror ( rc ) );
		goto err_path_install;
	}
	DBGC ( image, "EFIIMAGE %s device is %s\n",
	       image->name, efi_handle_name ( device ) );

	/* Add as a child of the parent device */
	if ( ( parent != NULL ) &&
	     ( rc = efi_child_add ( parent, device ) ) != 0 ) {
		DBGC ( image, "EFIIMAGE %s could not become child of %s: %s\n",
		       image->name, efi_handle_name ( parent ),
		       strerror ( rc ) );
		goto err_child_add;
	}

	/* Use shim instead of directly executing image if applicable */
	shim = ( efi_can_load ( image ) ?
		 NULL : find_image_tag ( &efi_shim ) );
	exec = ( shim ? shim : image );
	if ( shim ) {
		DBGC ( image, "EFIIMAGE %s executing via %s\n",
		       image->name, shim->name );
	}

	/* Re-register as a hidden image to allow for access via file I/O */
	toggle = ( ~image->flags & IMAGE_HIDDEN );
	image->flags |= IMAGE_HIDDEN;
	if ( ( rc = register_image ( image ) ) != 0 )
		goto err_register_image;

	/* Install file I/O protocols */
	if ( ( rc = efi_file_install ( device ) ) != 0 ) {
		DBGC ( image, "EFIIMAGE %s could not install file protocol: "
		       "%s\n", image->name, strerror ( rc ) );
		goto err_file_install;
	}

	/* Install PXE base code protocol */
	if ( ( netdev != NULL ) &&
	     ( rc = efi_pxe_install ( device, netdev ) ) != 0 ) {
		DBGC ( image, "EFIIMAGE %s could not install PXE protocol: "
		       "%s\n", image->name, strerror ( rc ) );
		goto err_pxe_install;
	}

	/* Install iPXE download protocol */
	if ( ( rc = efi_download_install ( device ) ) != 0 ) {
		DBGC ( image, "EFIIMAGE %s could not install iPXE download "
		       "protocol: %s\n", image->name, strerror ( rc ) );
		goto err_download_install;
	}

	/* Install Flattened Device Tree table */
	if ( ( rc = efi_fdt_install ( image->cmdline ) ) != 0 ) {
		DBGC ( image, "EFIIMAGE %s could not install FDT: %s\n",
		       image->name, strerror ( rc ) );
		goto err_fdt_install;
	}

	/* Create file device path for image */
	imgpath = efi_image_filepath ( exec, devpath );
	if ( ! imgpath ) {
		DBGC ( image, "EFIIMAGE %s could not create file device "
		       "path\n", image->name );
		rc = -ENOMEM;
		goto err_image_path;
	}
	DBGC ( image, "EFIIMAGE %s file is %s\n",
	       image->name, efi_devpath_text ( imgpath ) );

	/* Create command line for image */
	cmdline = efi_image_cmdline ( image );
	if ( ! cmdline ) {
		DBGC ( image, "EFIIMAGE %s could not create command line\n",
		       image->name );
		rc = -ENOMEM;
		goto err_cmdline;
	}

	/* Install shim special handling if applicable */
	if ( shim &&
	     ( ( rc = efi_shim_install ( shim, device, &cmdline ) ) != 0 ) ) {
		DBGC ( image, "EFIIMAGE %s could not install shim handling: "
		       "%s\n", image->name, strerror ( rc ) );
		goto err_shim_install;
	}

	/* Attempt loading image
	 *
	 * LoadImage() does not (allegedly) modify the image content,
	 * but requires a non-const pointer to SourceBuffer.  We
	 * therefore use the .rwdata field rather than .data.
	 */
	handle = NULL;
	if ( ( efirc = bs->LoadImage ( FALSE, efi_image_handle, imgpath,
				       exec->rwdata, exec->len,
				       &handle ) ) != 0 ) {
		/* Not an EFI image */
		rc = -EEFI_LOAD ( efirc );
		DBGC ( image, "EFIIMAGE %s could not load: %s\n",
		       image->name, strerror ( rc ) );
		if ( efirc == EFI_SECURITY_VIOLATION ) {
			goto err_load_image_security_violation;
		} else {
			goto err_load_image;
		}
	}

	/* Get the loaded image protocol for the newly loaded image */
	if ( ( rc = efi_open (  handle, &efi_loaded_image_protocol_guid,
				&loaded ) ) != 0 ) {
		/* Should never happen */
		goto err_open_protocol;
	}

	/* Some EFI 1.10 implementations seem not to fill in DeviceHandle */
	if ( loaded->DeviceHandle == NULL ) {
		DBGC ( image, "EFIIMAGE %s filling in missing DeviceHandle\n",
		       image->name );
		loaded->DeviceHandle = device;
	}

	/* Sanity checks */
	assert ( loaded->ParentHandle == efi_image_handle );
	assert ( loaded->DeviceHandle == device );
	assert ( loaded->LoadOptionsSize == 0 );
	assert ( loaded->LoadOptions == NULL );

	/* Record image code type */
	type = loaded->ImageCodeType;

	/* Set command line */
	loaded->LoadOptions = cmdline;
	loaded->LoadOptionsSize =
		( ( wcslen ( cmdline ) + 1 /* NUL */ ) * sizeof ( wchar_t ) );

	/* Release network devices for use via SNP */
	efi_snp_release();

	/* Wrap calls made by the loaded image (for debugging) */
	efi_wrap_image ( handle );

	/* Reset console since image will probably use it */
	console_reset();

	/* Start the image */
	if ( ( efirc = bs->StartImage ( handle, NULL, NULL ) ) != 0 ) {
		rc = -EEFI_START ( efirc );
		DBGC ( image, "EFIIMAGE %s could not start (or returned with "
		       "error): %s\n", image->name, strerror ( rc ) );
		goto err_start_image;
	}

	/* If image was a driver, connect it up to anything available */
	if ( type == EfiBootServicesCode ) {
		DBGC ( image, "EFIIMAGE %s connecting drivers\n", image->name );
		efi_driver_reconnect_all();
	}

	/* Success */
	rc = 0;

 err_start_image:
	efi_unwrap();
	efi_snp_claim();
 err_open_protocol:
	/* If there was no error, then the image must have been
	 * started and returned successfully.  It either unloaded
	 * itself, or it intended to remain loaded (e.g. it was a
	 * driver).  We therefore do not unload successful images.
	 *
	 * If there was an error, attempt to unload the image.  This
	 * may not work.  In particular, there is no way to tell
	 * whether an error returned from StartImage() was due to
	 * being unable to start the image (in which case we probably
	 * should call UnloadImage()), or due to the image itself
	 * returning an error (in which case we probably should not
	 * call UnloadImage()).  We therefore ignore any failures from
	 * the UnloadImage() call itself.
	 */
 err_load_image_security_violation:
	if ( rc != 0 )
		bs->UnloadImage ( handle );
 err_load_image:
	if ( shim )
		efi_shim_uninstall();
 err_shim_install:
	free ( cmdline );
 err_cmdline:
	free ( imgpath );
 err_image_path:
	efi_fdt_uninstall();
 err_fdt_install:
	efi_download_uninstall ( device );
 err_download_install:
	if ( netdev )
		efi_pxe_uninstall ( device );
 err_pxe_install:
	efi_file_uninstall ( device );
 err_file_install:
	unregister_image ( image );
 err_register_image:
	image->flags ^= toggle;
	if ( parent )
		efi_child_del ( parent, device );
 err_child_add:
	bs->UninstallMultipleProtocolInterfaces (
			device,
			&efi_device_path_protocol_guid, devpath,
			NULL );
 err_path_install:
	free ( devpath );
 err_device_path:
	netdev_put ( netdev );
	return rc;
}

/**
 * Probe EFI image
 *
 * @v image		EFI file
 * @ret rc		Return status code
 */
static int efi_image_probe ( struct image *image ) {
	EFI_BOOT_SERVICES *bs = efi_systab->BootServices;
	static EFI_DEVICE_PATH_PROTOCOL empty_path = {
		.Type = END_DEVICE_PATH_TYPE,
		.SubType = END_ENTIRE_DEVICE_PATH_SUBTYPE,
		.Length[0] = sizeof ( empty_path ),
	};
	EFI_HANDLE handle;
	EFI_STATUS efirc;
	int rc;

	/* Attempt loading image
	 *
	 * LoadImage() does not (allegedly) modify the image content,
	 * but requires a non-const pointer to SourceBuffer.  We
	 * therefore use the .rwdata field rather than .data.
	 */
	handle = NULL;
	if ( ( efirc = bs->LoadImage ( FALSE, efi_image_handle, &empty_path,
				       image->rwdata, image->len,
				       &handle ) ) != 0 ) {
		/* Not an EFI image */
		rc = -EEFI_LOAD ( efirc );
		DBGC ( image, "EFIIMAGE %s could not load: %s\n",
		       image->name, strerror ( rc ) );
		if ( efirc == EFI_SECURITY_VIOLATION ) {
			goto err_load_image_security_violation;
		} else {
			goto err_load_image;
		}
	}

	/* Unload the image.  We can't leave it loaded, because we
	 * have no "unload" operation.
	 */
	bs->UnloadImage ( handle );

	return 0;

 err_load_image_security_violation:
	bs->UnloadImage ( handle );
 err_load_image:
	return rc;
}

/**
 * Probe EFI PE image
 *
 * @v image		EFI file
 * @ret rc		Return status code
 *
 * The extremely broken UEFI Secure Boot model provides no way for us
 * to unambiguously determine that a valid EFI executable image was
 * rejected by LoadImage() because it failed signature verification.
 * We must therefore use heuristics to guess whether not an image that
 * was rejected by LoadImage() could still be loaded via a separate PE
 * loader such as the UEFI shim.
 */
static int efi_pe_image_probe ( struct image *image ) {
	const UINT16 magic = ( ( sizeof ( UINTN ) == sizeof ( uint32_t ) ) ?
			       EFI_IMAGE_NT_OPTIONAL_HDR32_MAGIC :
			       EFI_IMAGE_NT_OPTIONAL_HDR64_MAGIC );
	const EFI_IMAGE_DOS_HEADER *dos;
	const EFI_IMAGE_OPTIONAL_HEADER_UNION *pe;

	/* Check for existence of DOS header */
	if ( image->len < sizeof ( *dos ) ) {
		DBGC ( image, "EFIIMAGE %s too short for DOS header\n",
		       image->name );
		return -ENOEXEC;
	}
	dos = image->data;
	if ( dos->e_magic != EFI_IMAGE_DOS_SIGNATURE ) {
		DBGC ( image, "EFIIMAGE %s missing MZ signature\n",
		       image->name );
		return -ENOEXEC;
	}

	/* Check for existence of PE header */
	if ( ( image->len < dos->e_lfanew ) ||
	     ( ( image->len - dos->e_lfanew ) < sizeof ( *pe ) ) ) {
		DBGC ( image, "EFIIMAGE %s too short for PE header\n",
		       image->name );
		return -ENOEXEC;
	}
	pe = ( image->data + dos->e_lfanew );
	if ( pe->Pe32.Signature != EFI_IMAGE_NT_SIGNATURE ) {
		DBGC ( image, "EFIIMAGE %s missing PE signature\n",
		       image->name );
		return -ENOEXEC;
	}

	/* Check PE header magic */
	if ( pe->Pe32.OptionalHeader.Magic != magic ) {
		DBGC ( image, "EFIIMAGE %s incorrect magic %04x\n",
		       image->name, pe->Pe32.OptionalHeader.Magic );
		return -ENOEXEC;
	}

	return 0;
}

/** EFI image types */
struct image_type efi_image_type[] __image_type ( PROBE_NORMAL ) = {
	{
		.name = "EFI",
		.probe = efi_image_probe,
		.exec = efi_image_exec,
	},
	{
		.name = "EFIPE",
		.probe = efi_pe_image_probe,
		.exec = efi_image_exec,
	},
};