efi_init.c File Reference

#include <string.h>
#include <gpxe/efi/efi.h>
#include <gpxe/uuid.h>

Go to the source code of this file.

Functions
	FILE_LICENCE (GPL2_OR_LATER)
static void *	efi_find_table (EFI_GUID *guid)
	Look up EFI configuration table.
EFI_STATUS	efi_init (EFI_HANDLE image_handle, EFI_SYSTEM_TABLE *systab)
	Initialise EFI environment.
Variables
EFI_HANDLE	efi_image_handle
	Image handle passed to entry point.
EFI_SYSTEM_TABLE *	efi_systab
	System table passed to entry point.

---

Function Documentation

FILE_LICENCE

(

GPL2_OR_LATER

)

static void* efi_find_table

(

EFI_GUID *

guid

)

[static]

Look up EFI configuration table.

Parameters:

guid

Configuration table GUID

Return values:

table

Configuration table, or NULL

Definition at line 37 of file efi_init.c.

References _EFI_SYSTEM_TABLE::ConfigurationTable, memcmp(), NULL, _EFI_SYSTEM_TABLE::NumberOfTableEntries, EFI_CONFIGURATION_TABLE::VendorGuid, and EFI_CONFIGURATION_TABLE::VendorTable.

Referenced by efi_init().

                                                {
        unsigned int i;

        for ( i = 0 ; i < efi_systab->NumberOfTableEntries ; i++ ) {
                if ( memcmp ( &efi_systab->ConfigurationTable[i].VendorGuid,
                              guid, sizeof ( *guid ) ) == 0 )
                        return efi_systab->ConfigurationTable[i].VendorTable;
        }

        return NULL;
}

EFI_STATUS efi_init	(	EFI_HANDLE	image_handle,
		EFI_SYSTEM_TABLE *	systab
	)

Initialise EFI environment.

Parameters:

	image_handle	Image handle
	systab	System table

Return values:

efirc

EFI return status code

Definition at line 56 of file efi_init.c.

References _EFI_SYSTEM_TABLE::BootServices, _EFI_SYSTEM_TABLE::ConOut, DBGC, EFI_CONFIG_TABLES, efi_find_table(), efi_image_handle, EFI_NOT_AVAILABLE_YET, EFI_PROTOCOLS, for_each_table_entry, efi_config_table::guid, efi_protocol::guid, EFI_BOOT_SERVICES::LocateProtocol, NULL, efi_protocol::protocol, efi_config_table::required, _EFI_SYSTEM_TABLE::RuntimeServices, efi_config_table::table, efi_config_table::u, efi_protocol::u, efi_config_table::uuid, efi_protocol::uuid, and uuid_ntoa().

Referenced by _start().

                                                 {
        EFI_BOOT_SERVICES *bs;
        struct efi_protocol *prot;
        struct efi_config_table *tab;
        EFI_STATUS efirc;

        /* Store image handle and system table pointer for future use */
        efi_image_handle = image_handle;
        efi_systab = systab;

        /* Sanity checks */
        if ( ! systab )
                return EFI_NOT_AVAILABLE_YET;
        if ( ! systab->ConOut )
                return EFI_NOT_AVAILABLE_YET;
        if ( ! systab->BootServices ) {
                DBGC ( systab, "EFI provided no BootServices entry point\n" );
                return EFI_NOT_AVAILABLE_YET;
        }
        if ( ! systab->RuntimeServices ) {
                DBGC ( systab, "EFI provided no RuntimeServices entry "
                       "point\n" );
                return EFI_NOT_AVAILABLE_YET;
        }
        DBGC ( systab, "EFI handle %p systab %p\n", image_handle, systab );

        /* Look up used protocols */
        bs = systab->BootServices;
        for_each_table_entry ( prot, EFI_PROTOCOLS ) {
                if ( ( efirc = bs->LocateProtocol ( &prot->u.guid, NULL,
                                                    prot->protocol ) ) == 0 ) {
                        DBGC ( systab, "EFI protocol %s is at %p\n",
                               uuid_ntoa ( &prot->u.uuid ), *(prot->protocol));
                } else {
                        DBGC ( systab, "EFI does not provide protocol %s\n",
                               uuid_ntoa ( &prot->u.uuid ) );
                        /* All protocols are required */
                        return efirc;
                }
        }

        /* Look up used configuration tables */
        for_each_table_entry ( tab, EFI_CONFIG_TABLES ) {
                if ( ( *(tab->table) = efi_find_table ( &tab->u.guid ) ) ) {
                        DBGC ( systab, "EFI configuration table %s is at %p\n",
                               uuid_ntoa ( &tab->u.uuid ), *(tab->table) );
                } else {
                        DBGC ( systab, "EFI does not provide configuration "
                               "table %s\n", uuid_ntoa ( &tab->u.uuid ) );
                        if ( tab->required )
                                return EFI_NOT_AVAILABLE_YET;
                }
        }

        return 0;
}

---

Variable Documentation

EFI_HANDLE efi_image_handle

Image handle passed to entry point.

Definition at line 26 of file efi_init.c.

Referenced by efi_image_exec(), efi_image_load(), efi_init(), and efi_snp_install().

EFI_SYSTEM_TABLE* efi_systab

System table passed to entry point.

Definition at line 29 of file efi_init.c.

Referenced by efi_getchar(), efi_handle_cup(), efi_handle_ed(), efi_handle_sgr(), efi_image_exec(), efi_image_load(), efi_iskey(), efi_putchar(), efi_snp_driver_start(), efi_snp_driver_stop(), efi_snp_install(), efi_snp_netdev(), efi_snp_snpdev(), efi_snp_wait_for_packet(), efi_udelay(), and efi_urealloc().