efi_image.c File Reference

#include <errno.h>
#include <gpxe/efi/efi.h>
#include <gpxe/image.h>
#include <gpxe/features.h>

Go to the source code of this file.

Functions
	FILE_LICENCE (GPL2_OR_LATER)
	FEATURE (FEATURE_IMAGE,"EFI", DHCP_EB_FEATURE_EFI, 1)
struct image_type efi_image_type	__image_type (PROBE_NORMAL)
	EFI image type.
static int	efi_image_exec (struct image *image)
	Execute EFI image.
static int	efi_image_load (struct image *image)
	Load EFI image into memory.

---

Function Documentation

FILE_LICENCE

(

GPL2_OR_LATER

)

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

struct image_type nbi_image_type __image_type

(

PROBE_NORMAL

)

[read]

Initial value:

 {
        .name = "EFI",
        .load = efi_image_load,
        .exec = efi_image_exec,
}

EFI image type.

NBI image type.

El Torito image type.

ELF image type.

SYSLINUX COMBOOT (16-bit) image type.

SYSLINUX COM32 image type.

Linux bzImage image type.

Script image type.

static int efi_image_exec

(

struct image *

image

)

[static]

Execute EFI image.

Parameters:

image

EFI image

Return values:

rc

Return status code

Definition at line 36 of file efi_image.c.

References _EFI_SYSTEM_TABLE::BootServices, image::data, DBGC, efi_image_handle, efi_strerror(), efi_systab, EFIRC_TO_RC, ENOEXEC, FALSE, image::len, EFI_BOOT_SERVICES::LoadImage, NULL, EFI_BOOT_SERVICES::StartImage, EFI_BOOT_SERVICES::UnloadImage, and user_to_virt().

                                                  {
        EFI_BOOT_SERVICES *bs = efi_systab->BootServices;
        EFI_HANDLE handle;
        UINTN exit_data_size;
        CHAR16 *exit_data;
        EFI_STATUS efirc;

        /* Attempt loading image */
        if ( ( efirc = bs->LoadImage ( FALSE, efi_image_handle, NULL,
                                       user_to_virt ( image->data, 0 ),
                                       image->len, &handle ) ) != 0 ) {
                /* Not an EFI image */
                DBGC ( image, "EFIIMAGE %p could not load: %s\n",
                       image, efi_strerror ( efirc ) );
                return -ENOEXEC;
        }

        /* Start the image */
        if ( ( efirc = bs->StartImage ( handle, &exit_data_size,
                                        &exit_data ) ) != 0 ) {
                DBGC ( image, "EFIIMAGE %p returned with status %s\n",
                       image, efi_strerror ( efirc ) );
                goto done;
        }

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

        return EFIRC_TO_RC ( efirc );
}

static int efi_image_load

(

struct image *

image

)

[static]

Load EFI image into memory.

Parameters:

image

EFI file

Return values:

rc

Return status code

Definition at line 76 of file efi_image.c.

References _EFI_SYSTEM_TABLE::BootServices, image::data, DBGC, efi_image_handle, efi_strerror(), efi_systab, ENOEXEC, FALSE, image::len, EFI_BOOT_SERVICES::LoadImage, NULL, image::type, EFI_BOOT_SERVICES::UnloadImage, and user_to_virt().

                                                  {
        EFI_BOOT_SERVICES *bs = efi_systab->BootServices;
        EFI_HANDLE handle;
        EFI_STATUS efirc;

        /* Attempt loading image */
        if ( ( efirc = bs->LoadImage ( FALSE, efi_image_handle, NULL,
                                       user_to_virt ( image->data, 0 ),
                                       image->len, &handle ) ) != 0 ) {
                /* Not an EFI image */
                DBGC ( image, "EFIIMAGE %p could not load: %s\n",
                       image, efi_strerror ( efirc ) );
                return -ENOEXEC;
        }

        /* This is an EFI image */
        if ( ! image->type )
                image->type = &efi_image_type;

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

        return 0;
}