efiprefix.c File Reference

#include <stdlib.h>
#include <errno.h>
#include <ipxe/device.h>
#include <ipxe/uri.h>
#include <ipxe/init.h>
#include <ipxe/efi/efi.h>
#include <ipxe/efi/efi_driver.h>
#include <ipxe/efi/efi_snp.h>
#include <ipxe/efi/efi_autoboot.h>
#include <ipxe/efi/efi_autoexec.h>
#include <ipxe/efi/efi_cachedhcp.h>
#include <ipxe/efi/efi_watchdog.h>
#include <ipxe/efi/efi_path.h>
#include <ipxe/efi/efi_veto.h>

Go to the source code of this file.

Functions
	FILE_LICENCE (GPL2_OR_LATER)
	FILE_SECBOOT (PERMITTED)
EFI_STATUS EFIAPI	_efi_start (EFI_HANDLE image_handle, EFI_SYSTEM_TABLE *systab)
	EFI entry point.
static void	efi_init_application (void)
	Initialise EFI application.
struct init_fn efi_init_application_fn	__init_fn (INIT_NORMAL)
	EFI application initialisation function.
static int	efi_probe (struct root_device *rootdev __unused)
	Probe EFI root bus.
static void	efi_remove (struct root_device *rootdev __unused)
	Remove EFI root bus.

Variables
static struct root_driver	efi_root_driver
	EFI root device driver.
struct root_device efi_root_device	__root_device
	EFI root device.

Function Documentation

FILE_LICENCE()

FILE_LICENCE

(

GPL2_OR_LATER

)

FILE_SECBOOT()

FILE_SECBOOT

(

PERMITTED

)

_efi_start()

EFI_STATUS EFIAPI _efi_start	(	EFI_HANDLE	image_handle,
		EFI_SYSTEM_TABLE *	systab )

EFI entry point.

Parameters

image_handle	Image handle
systab	System table

Return values

efirc

EFI return status code

Definition at line 45 of file efiprefix.c.

                                                          {
        EFI_STATUS efirc;
        int rc;
 
        /* Initialise stack cookie */
        efi_init_stack_guard ( image_handle );
 
        /* Initialise EFI environment */
        if ( ( efirc = efi_init ( image_handle, systab ) ) != 0 )
                goto err_init;
 
        /* Claim SNP devices for use by iPXE */
        efi_snp_claim();
 
        /* Start watchdog holdoff timer */
        efi_watchdog_start();
 
        /* Call to main() */
        if ( ( rc = main() ) != 0 ) {
                efirc = EFIRC ( rc );
                goto err_main;
        }
 
 err_main:
        efi_watchdog_stop();
        efi_snp_release();
        efi_loaded_image->Unload ( image_handle );
        efi_driver_reconnect_all();
 err_init:
        return efirc;
}

References efi_driver_reconnect_all(), EFI_HANDLE, efi_init(), efi_init_stack_guard(), efi_loaded_image, efi_snp_claim(), efi_snp_release(), efi_watchdog_start(), efi_watchdog_stop(), EFIAPI, EFIRC, main(), and rc.

efi_init_application()

void efi_init_application ( void )

static

Initialise EFI application.

Definition at line 82 of file efiprefix.c.

                                          {
        EFI_HANDLE device = efi_loaded_image->DeviceHandle;
        EFI_DEVICE_PATH_PROTOCOL *devpath = efi_loaded_image_path;
        EFI_DEVICE_PATH_PROTOCOL *bootpath;
        struct uri *uri;
 
        /* Set current working URI from device path, if present */
        bootpath = efi_current_boot_path();
        DBGC ( device, "EFI has loaded image device path %s\n",
               efi_devpath_text ( devpath ) );
        DBGC ( device, "EFI has boot option device path %s\n",
               efi_devpath_text ( bootpath ) );
        uri = efi_path_uri ( devpath );
        if ( bootpath && ( ! uri ) )
                uri = efi_path_uri ( bootpath );
        if ( uri )
                churi ( uri );
        uri_put ( uri );
        free ( bootpath );
 
        /* Identify autoboot device, if any */
        efi_set_autoboot_ll_addr ( device, devpath );
 
        /* Store cached DHCP packet, if any */
        efi_cachedhcp_record ( device, devpath );
}

References churi(), DBGC, efi_cachedhcp_record(), efi_current_boot_path(), efi_devpath_text(), EFI_HANDLE, efi_loaded_image, efi_loaded_image_path, efi_path_uri(), efi_set_autoboot_ll_addr(), free, and uri_put().

Referenced by __init_fn().

__init_fn()

struct init_fn efi_init_application_fn __init_fn

(

INIT_NORMAL

)

EFI application initialisation function.

References __init_fn, efi_init_application(), and INIT_NORMAL.

efi_probe()

int efi_probe ( struct root_device *rootdev __unused )

static

Probe EFI root bus.

Parameters

rootdev

EFI root device

Definition at line 120 of file efiprefix.c.

                                                              {
 
        /* Try loading autoexec script */
        efi_autoexec_load();
 
        /* Remove any vetoed drivers */
        efi_veto();
 
        /* Connect our drivers */
        return efi_driver_connect_all();
}

References __unused, efi_autoexec_load(), efi_driver_connect_all(), and efi_veto().

efi_remove()

void efi_remove ( struct root_device *rootdev __unused )

static

Remove EFI root bus.

Parameters

rootdev

EFI root device

Definition at line 137 of file efiprefix.c.

                                                                {
 
        /* Disconnect our drivers */
        efi_driver_disconnect_all();
}

References __unused, and efi_driver_disconnect_all().

Variable Documentation

efi_root_driver

struct root_driver efi_root_driver

static

Initial value:

= {
        .probe = efi_probe,
        .remove = efi_remove,
}

EFI root device driver.

Definition at line 144 of file efiprefix.c.

                                            {
        .probe = efi_probe,
        .remove = efi_remove,
};

__root_device

struct root_device efi_root_device __root_device

Initial value:

= {
        .dev = { .name = "EFI" },
        .driver = &efi_root_driver,
}

EFI root device.

Definition at line 150 of file efiprefix.c.

                                                   {
        .dev = { .name = "EFI" },
        .driver = &efi_root_driver,
};