EFI API. More...

#include <ipxe/efi/Uefi/UefiBaseType.h>
#include <ipxe/efi/Uefi.h>
#include <ipxe/efi/PiDxe.h>
#include <ipxe/efi/Protocol/LoadedImage.h>
#include <ipxe/tables.h>
#include <ipxe/uuid.h>
#include <ipxe/version.h>
#include <ipxe/profile.h>

Data Structures
struct	EFI_HANDLE

struct	efi_saved_tpl
	An EFI saved task priority level. More...

struct	efi_protocol
	An EFI protocol used by iPXE. More...

struct	efi_config_table
	An EFI configuration table used by iPXE. More...

Macros
#define	EFI_HANDLE STUPID_EFI_HANDLE

#define	_Static_assert(expr, msg)

#define	EFI_PROTOCOLS __table ( struct efi_protocol, "efi_protocols" )
	EFI protocol table. More...

#define	__efi_protocol __table_entry ( EFI_PROTOCOLS, 01 )
	Declare an EFI protocol used by iPXE. More...

#define	EFI_REQUIRE_PROTOCOL(_protocol, _ptr)
	Declare an EFI protocol to be required by iPXE. More...

#define	EFI_REQUEST_PROTOCOL(_protocol, _ptr)
	Declare an EFI protocol to be requested by iPXE. More...

#define	EFI_CONFIG_TABLES __table ( struct efi_config_table, "efi_config_tables" )
	EFI configuration table table. More...

#define	__efi_config_table __table_entry ( EFI_CONFIG_TABLES, 01 )
	Declare an EFI configuration table used by iPXE. More...

#define	EFI_USE_TABLE(_table, _ptr, _required)
	Declare an EFI configuration table to be used by iPXE. More...

#define	EFIRC(rc) ERRNO_TO_PLATFORM ( -(rc) )
	Convert an iPXE status code to an EFI status code. More...

#define	EEFI(efirc) EPLATFORM ( EINFO_EPLATFORM, efirc )
	Convert an EFI status code to an iPXE status code. More...

#define	DBG_EFI_OPENER_IF(level, handle, protocol, opener)

#define	DBG_EFI_OPENERS_IF(level, handle, protocol)

#define	DBG_EFI_PROTOCOLS_IF(level, handle)

#define	DBGC_EFI_OPENER_IF(level, id, ...)

#define	DBGC_EFI_OPENERS_IF(level, id, ...)

#define	DBGC_EFI_PROTOCOL_IF(level, id, ...)

#define	DBGC_EFI_PROTOCOLS_IF(level, id, ...)

#define	DBGC_EFI_OPENER(...) DBGC_EFI_OPENER_IF ( LOG, ##__VA_ARGS__ )

#define	DBGC_EFI_OPENERS(...) DBGC_EFI_OPENERS_IF ( LOG, ##__VA_ARGS__ )

#define	DBGC_EFI_PROTOCOL(...) DBGC_EFI_PROTOCOL_IF ( LOG, ##__VA_ARGS__ )

#define	DBGC_EFI_PROTOCOLS(...) DBGC_EFI_PROTOCOLS_IF ( LOG, ##__VA_ARGS__ )

#define	DBGC2_EFI_OPENER(...) DBGC_EFI_OPENER_IF ( EXTRA, ##__VA_ARGS__ )

#define	DBGC2_EFI_OPENERS(...) DBGC_EFI_OPENERS_IF ( EXTRA, ##__VA_ARGS__ )

#define	DBGC2_EFI_PROTOCOL(...) DBGC_EFI_PROTOCOL_IF ( EXTRA, ##__VA_ARGS__ )

#define	DBGC2_EFI_PROTOCOLS(...) DBGC_EFI_PROTOCOLS_IF ( EXTRA, ##__VA_ARGS__ )

#define	DBGCP_EFI_OPENER(...) DBGC_EFI_OPENER_IF ( PROFILE, ##__VA_ARGS__ )

#define	DBGCP_EFI_OPENERS(...) DBGC_EFI_OPENERS_IF ( PROFILE, ##__VA_ARGS__ )

#define	DBGCP_EFI_PROTOCOL(...) DBGC_EFI_PROTOCOL_IF ( PROFILE, ##__VA_ARGS__ )

#define	DBGCP_EFI_PROTOCOLS(...) DBGC_EFI_PROTOCOLS_IF ( PROFILE, ##__VA_ARGS__ )

#define	EFI_INTF_OP UNUSED_INTF_OP

Functions
	FILE_LICENCE (GPL2_OR_LATER)

const char *	efi_guid_ntoa (CONST EFI_GUID *guid)
	Convert GUID to a printable string. More...

const char *	efi_locate_search_type_name (EFI_LOCATE_SEARCH_TYPE search_type)
	Name locate search type. More...

const char *	efi_open_attributes_name (unsigned int attributes)
	Name protocol open attributes. More...

const char *	efi_devpath_text (EFI_DEVICE_PATH_PROTOCOL *path)
	Get textual representation of device path. More...

const char *	efi_handle_name (EFI_HANDLE handle)
	Get name of an EFI handle. More...

void	dbg_efi_opener (EFI_HANDLE handle, EFI_GUID protocol, EFI_OPEN_PROTOCOL_INFORMATION_ENTRY opener)
	Print opened protocol information. More...

void	dbg_efi_openers (EFI_HANDLE handle, EFI_GUID *protocol)
	Print list of openers of a given protocol on a given handle. More...

void	dbg_efi_protocol (EFI_HANDLE handle, EFI_GUID *protocol)
	Print protocol information on a given handle. More...

void	dbg_efi_protocols (EFI_HANDLE handle)
	Print list of protocol handlers attached to a handle. More...

unsigned long	efi_stack_cookie (EFI_HANDLE handle)
	Construct a stack cookie value. More...

void	__stack_chk_fail (void)
	Abort on stack check failure. More...

static void	efi_init_stack_guard (EFI_HANDLE handle)
	Initialise stack cookie. More...

EFI_STATUS	efi_init (EFI_HANDLE image_handle, EFI_SYSTEM_TABLE *systab)
	Initialise EFI environment. More...

void	efi_raise_tpl (struct efi_saved_tpl *tpl)
	Raise task priority level to internal level. More...

void	efi_restore_tpl (struct efi_saved_tpl *tpl)
	Restore task priority level. More...

Variables
EFI_GUID	efi_absolute_pointer_protocol_guid
	Absolute pointer protocol GUID. More...

EFI_GUID	efi_acpi_table_protocol_guid
	ACPI table protocol GUID. More...

EFI_GUID	efi_apple_net_boot_protocol_guid
	Apple NetBoot protocol GUID. More...

EFI_GUID	efi_arp_protocol_guid
	ARP protocol GUID. More...

EFI_GUID	efi_arp_service_binding_protocol_guid
	ARP service binding protocol GUID. More...

EFI_GUID	efi_block_io_protocol_guid
	Block I/O protocol GUID. More...

EFI_GUID	efi_block_io2_protocol_guid
	Block I/O version 2 protocol GUID. More...

EFI_GUID	efi_bus_specific_driver_override_protocol_guid
	Bus specific driver override protocol GUID. More...

EFI_GUID	efi_component_name_protocol_guid
	Component name protocol GUID. More...

EFI_GUID	efi_component_name2_protocol_guid
	Component name 2 protocol GUID. More...

EFI_GUID	efi_console_control_protocol_guid
	Console control protocol GUID. More...

EFI_GUID	efi_device_path_protocol_guid
	Device path protocol GUID. More...

EFI_GUID	efi_dhcp4_protocol_guid
	DHCPv4 protocol GUID. More...

EFI_GUID	efi_dhcp4_service_binding_protocol_guid
	DHCPv4 service binding protocol GUID. More...

EFI_GUID	efi_dhcp6_protocol_guid
	DHCPv6 protocol GUID. More...

EFI_GUID	efi_dhcp6_service_binding_protocol_guid
	DHCPv6 service binding protocol GUID. More...

EFI_GUID	efi_disk_io_protocol_guid
	Disk I/O protocol GUID. More...

EFI_GUID	efi_dns4_protocol_guid
	DNSv4 protocol GUID. More...

EFI_GUID	efi_dns4_service_binding_protocol_guid
	DNSv4 service binding protocol GUID. More...

EFI_GUID	efi_dns6_protocol_guid
	DNSv6 protocol GUID. More...

EFI_GUID	efi_dns6_service_binding_protocol_guid
	DNSv6 service binding protocol GUID. More...

EFI_GUID	efi_driver_binding_protocol_guid
	Driver binding protocol GUID. More...

EFI_GUID	efi_graphics_output_protocol_guid
	Graphics output protocol GUID. More...

EFI_GUID	efi_hii_config_access_protocol_guid
	HII configuration access protocol GUID. More...

EFI_GUID	efi_hii_font_protocol_guid
	HII font protocol GUID. More...

EFI_GUID	efi_http_protocol_guid
	HTTP protocol GUID. More...

EFI_GUID	efi_http_service_binding_protocol_guid
	HTTP service binding protocol GUID. More...

EFI_GUID	efi_ip4_protocol_guid
	IPv4 protocol GUID. More...

EFI_GUID	efi_ip4_config_protocol_guid
	IPv4 configuration protocol GUID. More...

EFI_GUID	efi_ip4_config2_protocol_guid
	IPv4 configuration 2 protocol GUID. More...

EFI_GUID	efi_ip4_service_binding_protocol_guid
	IPv4 service binding protocol GUID. More...

EFI_GUID	efi_ip6_protocol_guid
	IPv6 protocol GUID. More...

EFI_GUID	efi_ip6_config_protocol_guid
	IPv6 configuration protocol GUID. More...

EFI_GUID	efi_ip6_service_binding_protocol_guid
	IPv6 service binding protocol GUID. More...

EFI_GUID	efi_load_file_protocol_guid
	Load file protocol GUID. More...

EFI_GUID	efi_load_file2_protocol_guid
	Load file 2 protocol GUID. More...

EFI_GUID	efi_loaded_image_protocol_guid
	Loaded image protocol GUID. More...

EFI_GUID	efi_loaded_image_device_path_protocol_guid
	Loaded image device path protocol GUID. More...

EFI_GUID	efi_managed_network_protocol_guid
	Managed network protocol GUID. More...

EFI_GUID	efi_managed_network_service_binding_protocol_guid
	Managed network service binding protocol GUID. More...

EFI_GUID	efi_mtftp4_protocol_guid
	MTFTPv4 protocol GUID. More...

EFI_GUID	efi_mtftp4_service_binding_protocol_guid
	MTFTPv4 service binding protocol GUID. More...

EFI_GUID	efi_mtftp6_protocol_guid
	MTFTPv6 protocol GUID. More...

EFI_GUID	efi_mtftp6_service_binding_protocol_guid
	MTFTPv6 service binding protocol GUID. More...

EFI_GUID	efi_nii_protocol_guid
	Network interface identifier protocol GUID (old version) More...

EFI_GUID	efi_nii31_protocol_guid
	Network interface identifier protocol GUID (new version) More...

EFI_GUID	efi_pci_io_protocol_guid
	PCI I/O protocol GUID. More...

EFI_GUID	efi_pci_root_bridge_io_protocol_guid
	PCI root bridge I/O protocol GUID. More...

EFI_GUID	efi_pxe_base_code_protocol_guid
	PXE base code protocol GUID. More...

EFI_GUID	efi_serial_io_protocol_guid
	Serial I/O protocol GUID. More...

EFI_GUID	efi_shim_lock_protocol_guid
	Shim lock protocol GUID. More...

EFI_GUID	efi_simple_file_system_protocol_guid
	Simple file system protocol GUID. More...

EFI_GUID	efi_simple_network_protocol_guid
	Simple network protocol GUID. More...

EFI_GUID	efi_simple_pointer_protocol_guid
	Simple pointer protocol GUID. More...

EFI_GUID	efi_simple_text_input_protocol_guid
	Simple text input protocol GUID. More...

EFI_GUID	efi_simple_text_input_ex_protocol_guid
	Simple text input extension protocol GUID. More...

EFI_GUID	efi_simple_text_output_protocol_guid
	Simple text output protocol GUID. More...

EFI_GUID	efi_tcg_protocol_guid
	TCG protocol GUID. More...

EFI_GUID	efi_tcg2_protocol_guid
	TCG2 protocol GUID. More...

EFI_GUID	efi_tcp4_protocol_guid
	TCPv4 protocol GUID. More...

EFI_GUID	efi_tcp4_service_binding_protocol_guid
	TCPv4 service binding protocol GUID. More...

EFI_GUID	efi_tcp6_protocol_guid
	TCPv6 protocol GUID. More...

EFI_GUID	efi_tcp6_service_binding_protocol_guid
	TCPv6 service binding protocol GUID. More...

EFI_GUID	efi_tree_protocol_guid
	TrEE protocol GUID. More...

EFI_GUID	efi_udp4_protocol_guid
	UDPv4 protocol GUID. More...

EFI_GUID	efi_udp4_service_binding_protocol_guid
	UDPv4 service binding protocol GUID. More...

EFI_GUID	efi_udp6_protocol_guid
	UDPv6 protocol GUID. More...

EFI_GUID	efi_udp6_service_binding_protocol_guid
	UDPv6 service binding protocol GUID. More...

EFI_GUID	efi_uga_draw_protocol_guid
	UGA draw protocol GUID. More...

EFI_GUID	efi_unicode_collation_protocol_guid
	Unicode collation protocol GUID. More...

EFI_GUID	efi_usb_hc_protocol_guid
	USB host controller protocol GUID. More...

EFI_GUID	efi_usb2_hc_protocol_guid
	USB2 host controller protocol GUID. More...

EFI_GUID	efi_usb_io_protocol_guid
	USB I/O protocol GUID. More...

EFI_GUID	efi_vlan_config_protocol_guid
	VLAN configuration protocol GUID. More...

EFI_GUID	efi_file_info_id
	File information GUID. More...

EFI_GUID	efi_file_system_info_id
	File system information GUID. More...

EFI_HANDLE	efi_image_handle
	Image handle passed to entry point. More...

EFI_LOADED_IMAGE_PROTOCOL *	efi_loaded_image
	Loaded image protocol for this image. More...

EFI_DEVICE_PATH_PROTOCOL *	efi_loaded_image_path
	Device path for the loaded image's device handle. More...

EFI_SYSTEM_TABLE *	efi_systab

EFI_TPL	efi_internal_tpl
	Internal task priority level. More...

EFI_TPL	efi_external_tpl
	External task priority level. More...

int	efi_shutdown_in_progress
	EFI shutdown is in progress. More...

unsigned long	__stack_chk_guard
	Stack cookie. More...

Detailed Description

EFI API.

The intention is to include near-verbatim copies of the EFI headers required by iPXE. This is achieved using the import.pl script in this directory. Run the import script to update the local copies of the headers:

./import.pl /path/to/edk2/edk2

where /path/to/edk2/edk2 is the path to your local checkout of the EFI Development Kit.

Note that import.pl will modify any #include lines in each imported header to reflect its new location within the iPXE tree. It will also tidy up the file by removing carriage return characters and trailing whitespace.

Definition in file efi.h.

Macro Definition Documentation

◆ EFI_HANDLE

#define EFI_HANDLE STUPID_EFI_HANDLE

Definition at line 52 of file efi.h.

◆ _Static_assert

#define _Static_assert	(	expr,
		msg
	)

Definition at line 54 of file efi.h.

◆ EFI_PROTOCOLS

#define EFI_PROTOCOLS __table ( struct efi_protocol, "efi_protocols" )

EFI protocol table.

Definition at line 94 of file efi.h.

◆ __efi_protocol

#define __efi_protocol __table_entry ( EFI_PROTOCOLS, 01 )

Declare an EFI protocol used by iPXE.

Definition at line 97 of file efi.h.

◆ EFI_REQUIRE_PROTOCOL

#define EFI_REQUIRE_PROTOCOL	(	_protocol,
		_ptr
	)

Value:

struct efi_protocol __ ## _protocol __efi_protocol = {               \
                .guid = _protocol ## _GUID,                                  \
                .protocol = ( ( void ** ) ( void * )                         \
                              ( ( (_ptr) == ( ( _protocol ** ) (_ptr) ) ) ?  \
                                (_ptr) : (_ptr) ) ),                         \
                .required = 1,                                               \
        }

Declare an EFI protocol to be required by iPXE.

Parameters

_protocol	EFI protocol name
_ptr	Pointer to protocol instance

Definition at line 104 of file efi.h.

◆ EFI_REQUEST_PROTOCOL

#define EFI_REQUEST_PROTOCOL	(	_protocol,
		_ptr
	)

Value:

struct efi_protocol __ ## _protocol __efi_protocol = {               \
                .guid = _protocol ## _GUID,                                  \
                .protocol = ( ( void ** ) ( void * )                         \
                              ( ( (_ptr) == ( ( _protocol ** ) (_ptr) ) ) ?  \
                                (_ptr) : (_ptr) ) ),                         \
                .required = 0,                                               \
        }

Declare an EFI protocol to be requested by iPXE.

Parameters

_protocol	EFI protocol name
_ptr	Pointer to protocol instance

Definition at line 118 of file efi.h.

◆ EFI_CONFIG_TABLES

#define EFI_CONFIG_TABLES __table ( struct efi_config_table, "efi_config_tables" )

EFI configuration table table.

Definition at line 138 of file efi.h.

◆ __efi_config_table

#define __efi_config_table __table_entry ( EFI_CONFIG_TABLES, 01 )

Declare an EFI configuration table used by iPXE.

Definition at line 142 of file efi.h.

◆ EFI_USE_TABLE

#define EFI_USE_TABLE	(	_table,
		_ptr,
		_required
	)

Value:

struct efi_config_table __ ## _table __efi_config_table = {          \
                .guid = _table ## _GUID,                                     \
                .table = ( ( void ** ) ( void * ) (_ptr) ),                  \
                .required = (_required),                                     \
        }

Declare an EFI configuration table to be used by iPXE.

Parameters

_table	EFI configuration table name
_ptr	Pointer to configuration table
_required	Table is required for operation

Definition at line 150 of file efi.h.

◆ EFIRC

#define EFIRC ( rc ) ERRNO_TO_PLATFORM ( -(rc) )

Convert an iPXE status code to an EFI status code.

Parameters

rc	iPXE status code

Return values

efirc EFI status code

Definition at line 163 of file efi.h.

◆ EEFI

#define EEFI ( efirc ) EPLATFORM ( EINFO_EPLATFORM, efirc )

Convert an EFI status code to an iPXE status code.

Parameters

efirc EFI status code

Return values

rc	iPXE status code (before negation)

Definition at line 171 of file efi.h.

◆ DBG_EFI_OPENER_IF

#define DBG_EFI_OPENER_IF	(	level,
		handle,
		protocol,
		opener
	)

Value:

do {                    \
                if ( DBG_ ## level ) {                          \
                        dbg_efi_opener ( handle, protocol,      \
                                         opener );              \
                }                                               \
        } while ( 0 )

Definition at line 276 of file efi.h.

◆ DBG_EFI_OPENERS_IF

#define DBG_EFI_OPENERS_IF	(	level,
		handle,
		protocol
	)

Value:

do {    \
                if ( DBG_ ## level ) {                          \
                        dbg_efi_openers ( handle, protocol );   \
                }                                               \
        } while ( 0 )

Definition at line 284 of file efi.h.

◆ DBG_EFI_PROTOCOLS_IF

#define DBG_EFI_PROTOCOLS_IF	(	level,
		handle
	)

Value:

do {            \
                if ( DBG_ ## level ) {                          \
                        dbg_efi_protocols ( handle );           \
                }                                               \
        } while ( 0 )

Definition at line 290 of file efi.h.

◆ DBGC_EFI_OPENER_IF

#define DBGC_EFI_OPENER_IF	(	level,
		id,
		...
	)

Value:

do {            \
                DBG_AC_IF ( level, id );                        \
                DBG_EFI_OPENER_IF ( level, __VA_ARGS__ );       \
                DBG_DC_IF ( level );                            \
        } while ( 0 )

Definition at line 296 of file efi.h.

◆ DBGC_EFI_OPENERS_IF

#define DBGC_EFI_OPENERS_IF	(	level,
		id,
		...
	)

Value:

do {            \
                DBG_AC_IF ( level, id );                        \
                DBG_EFI_OPENERS_IF ( level, __VA_ARGS__ );      \
                DBG_DC_IF ( level );                            \
        } while ( 0 )

Definition at line 302 of file efi.h.

◆ DBGC_EFI_PROTOCOL_IF

#define DBGC_EFI_PROTOCOL_IF	(	level,
		id,
		...
	)

Value:

do {            \
                DBG_AC_IF ( level, id );                        \
                DBG_EFI_PROTOCOL_IF ( level, __VA_ARGS__ );     \
                DBG_DC_IF ( level );                            \
        } while ( 0 )

Definition at line 308 of file efi.h.

◆ DBGC_EFI_PROTOCOLS_IF

#define DBGC_EFI_PROTOCOLS_IF	(	level,
		id,
		...
	)

Value:

do {            \
                DBG_AC_IF ( level, id );                        \
                DBG_EFI_PROTOCOLS_IF ( level, __VA_ARGS__ );    \
                DBG_DC_IF ( level );                            \
        } while ( 0 )

Definition at line 314 of file efi.h.

◆ DBGC_EFI_OPENER

#define DBGC_EFI_OPENER ( ... ) DBGC_EFI_OPENER_IF ( LOG, ##__VA_ARGS__ )

Definition at line 320 of file efi.h.

◆ DBGC_EFI_OPENERS

#define DBGC_EFI_OPENERS ( ... ) DBGC_EFI_OPENERS_IF ( LOG, ##__VA_ARGS__ )

Definition at line 322 of file efi.h.

◆ DBGC_EFI_PROTOCOL

#define DBGC_EFI_PROTOCOL ( ... ) DBGC_EFI_PROTOCOL_IF ( LOG, ##__VA_ARGS__ )

Definition at line 324 of file efi.h.

◆ DBGC_EFI_PROTOCOLS

#define DBGC_EFI_PROTOCOLS ( ... ) DBGC_EFI_PROTOCOLS_IF ( LOG, ##__VA_ARGS__ )

Definition at line 326 of file efi.h.

◆ DBGC2_EFI_OPENER

#define DBGC2_EFI_OPENER ( ... ) DBGC_EFI_OPENER_IF ( EXTRA, ##__VA_ARGS__ )

Definition at line 329 of file efi.h.

◆ DBGC2_EFI_OPENERS

#define DBGC2_EFI_OPENERS ( ... ) DBGC_EFI_OPENERS_IF ( EXTRA, ##__VA_ARGS__ )

Definition at line 331 of file efi.h.

◆ DBGC2_EFI_PROTOCOL

#define DBGC2_EFI_PROTOCOL ( ... ) DBGC_EFI_PROTOCOL_IF ( EXTRA, ##__VA_ARGS__ )

Definition at line 333 of file efi.h.

◆ DBGC2_EFI_PROTOCOLS

#define DBGC2_EFI_PROTOCOLS ( ... ) DBGC_EFI_PROTOCOLS_IF ( EXTRA, ##__VA_ARGS__ )

Definition at line 335 of file efi.h.

◆ DBGCP_EFI_OPENER

#define DBGCP_EFI_OPENER ( ... ) DBGC_EFI_OPENER_IF ( PROFILE, ##__VA_ARGS__ )

Definition at line 338 of file efi.h.

◆ DBGCP_EFI_OPENERS

#define DBGCP_EFI_OPENERS ( ... ) DBGC_EFI_OPENERS_IF ( PROFILE, ##__VA_ARGS__ )

Definition at line 340 of file efi.h.

◆ DBGCP_EFI_PROTOCOL

#define DBGCP_EFI_PROTOCOL ( ... ) DBGC_EFI_PROTOCOL_IF ( PROFILE, ##__VA_ARGS__ )

Definition at line 342 of file efi.h.

◆ DBGCP_EFI_PROTOCOLS

#define DBGCP_EFI_PROTOCOLS ( ... ) DBGC_EFI_PROTOCOLS_IF ( PROFILE, ##__VA_ARGS__ )

Definition at line 344 of file efi.h.

◆ EFI_INTF_OP

#define EFI_INTF_OP UNUSED_INTF_OP

Definition at line 351 of file efi.h.

Function Documentation

◆ FILE_LICENCE()

FILE_LICENCE ( GPL2_OR_LATER )

◆ efi_guid_ntoa()

const char* efi_guid_ntoa ( CONST EFI_GUID * guid )

Convert GUID to a printable string.

Parameters

guid GUID

Return values

string Printable string

Definition at line 256 of file efi_debug.c.

                                                                              {
         union {
                 union uuid uuid;
                 EFI_GUID guid;
         } u;
         unsigned int i;
 
         /* Sanity check */
         if ( ! guid )
                 return NULL;
 
         /* Check for a match against well-known GUIDs */
         for ( i = 0 ; i < ( sizeof ( efi_well_known_guids ) /
                             sizeof ( efi_well_known_guids[0] ) ) ; i++ ) {
                 if ( memcmp ( guid, efi_well_known_guids[i].guid,
                               sizeof ( *guid ) ) == 0 ) {
                         return efi_well_known_guids[i].name;
                 }
         }
 
         /* Convert GUID to standard endianness */
         memcpy ( &u.guid, guid, sizeof ( u.guid ) );
         uuid_mangle ( &u.uuid );
         return uuid_ntoa ( &u.uuid );
 }

References efi_well_known_guids, guid, efi_well_known_guid::guid, memcmp(), memcpy(), efi_well_known_guid::name, NULL, u, uuid_mangle(), and uuid_ntoa().

Referenced by chained_locate(), chained_supported(), dbg_efi_opener(), dbg_efi_openers(), dbg_efi_protocol(), efi_autoexec_load(), efi_close_protocol_wrapper(), efi_create_event_ex_wrapper(), efi_file_get_info(), efi_file_path_uninstall(), efi_file_set_info(), efi_handle_name(), efi_handle_protocol_wrapper(), efi_init(), efi_install_configuration_table_wrapper(), efi_install_multiple_protocol_interfaces_wrapper(), efi_install_protocol_interface_wrapper(), efi_locate_device(), efi_locate_device_path_wrapper(), efi_locate_handle_buffer_wrapper(), efi_locate_handle_wrapper(), efi_locate_protocol_wrapper(), efi_open_protocol_information_wrapper(), efi_open_protocol_wrapper(), efi_protocols_per_handle_wrapper(), efi_register_protocol_notify_wrapper(), efi_reinstall_protocol_interface_wrapper(), efi_service_add(), efi_service_del(), efi_uninstall_multiple_protocol_interfaces_wrapper(), efi_uninstall_protocol_interface_wrapper(), efi_veto_close_protocol(), efivars_fetch(), efivars_find(), and snpnet_supported().

◆ efi_locate_search_type_name()

const char* efi_locate_search_type_name ( EFI_LOCATE_SEARCH_TYPE search_type )

Name locate search type.

Parameters

search_type Locate search type

Return values

name	Locate search type name

Definition at line 289 of file efi_debug.c.

                                                                    {
         static char buf[16];
 
         switch ( search_type ) {
         case AllHandles :       return "AllHandles";
         case ByRegisterNotify:  return "ByRegisterNotify";
         case ByProtocol:        return "ByProtocol";
         default:
                 snprintf ( buf, sizeof ( buf ), "UNKNOWN<%d>", search_type );
                 return buf;
         }
 }

References AllHandles, ByProtocol, ByRegisterNotify, and snprintf().

Referenced by efi_locate_handle_buffer_wrapper(), and efi_locate_handle_wrapper().

◆ efi_open_attributes_name()

const char* efi_open_attributes_name ( unsigned int attributes )

Name protocol open attributes.

Parameters

attributes Protocol open attributes

Return values

name	Protocol open attributes name

Returns a (static) string with characters for each set bit corresponding to BY_(H)ANDLE_PROTOCOL, (G)ET_PROTOCOL, (T)EST_PROTOCOL, BY_(C)HILD_CONTROLLER, BY_(D)RIVER, and E(X)CLUSIVE.

Definition at line 314 of file efi_debug.c.

                                                      {
         static char attribute_chars[] = "HGTCDX";
         static char name[ sizeof ( attribute_chars ) ];
         char *tmp = name;
         unsigned int i;
 
         for ( i = 0 ; i < ( sizeof ( attribute_chars ) - 1 ) ; i++ ) {
                 if ( attributes & ( 1 << i ) )
                         *(tmp++) = attribute_chars[i];
         }
         *tmp = '\0';
 
         return name;
 }

References name, and tmp.

Referenced by dbg_efi_opener(), and efi_open_protocol_wrapper().

◆ efi_devpath_text()

const char* efi_devpath_text ( EFI_DEVICE_PATH_PROTOCOL * path )

Get textual representation of device path.

Parameters

path	Device path

Return values

text	Textual representation of device path, or NULL

Definition at line 463 of file efi_debug.c.

                                                     {
         EFI_BOOT_SERVICES *bs = efi_systab->BootServices;
         static char text[512];
         size_t len;
         CHAR16 *wtext;
 
         /* Sanity checks */
         if ( ! path ) {
                 DBG ( "[NULL DevicePath]" );
                 return NULL;
         }
 
         /* If we have no DevicePathToText protocol then use a raw hex string */
         if ( ! efidpt ) {
                 DBG ( "[No DevicePathToText]" );
                 len = efi_path_len ( path );
                 base16_encode ( path, len, text, sizeof ( text ) );
                 return text;
         }
 
         /* Convert path to a textual representation */
         wtext = efidpt->ConvertDevicePathToText ( path, FALSE, FALSE );
         if ( ! wtext )
                 return NULL;
 
         /* Store path in buffer */
         snprintf ( text, sizeof ( text ), "%ls", wtext );
 
         /* Free path */
         bs->FreePool ( wtext );
 
         return text;
 }

References EFI_SYSTEM_TABLE::BootServices, EFI_DEVICE_PATH_TO_TEXT_PROTOCOL::ConvertDevicePathToText, DBG, efi_path_len(), efi_systab, efidpt, FALSE, EFI_BOOT_SERVICES::FreePool, len, NULL, and snprintf().

Referenced by efi_block_exec(), efi_block_hook(), efi_block_match(), efi_connect_controller_wrapper(), efi_driver_start(), efi_driver_supported(), efi_dump_image(), efi_file_path_claim(), efi_file_path_install(), efi_file_path_uninstall(), efi_init(), efi_load_image_wrapper(), efi_loaded_image_filepath_name(), efi_local_open_volume(), efi_locate_device(), efi_locate_device_path_wrapper(), efi_path_net_probe(), usbio_open(), and usbio_path().

◆ efi_handle_name()

const char* efi_handle_name ( EFI_HANDLE handle )

Get name of an EFI handle.

Parameters

handle EFI handle

Return values

text	Name of handle, or NULL

Definition at line 810 of file efi_debug.c.

                                                                             {
         EFI_BOOT_SERVICES *bs = efi_systab->BootServices;
         struct efi_handle_name_type *type;
         static char buf[256];
         size_t used = 0;
         EFI_GUID **protocols;
         UINTN count;
         unsigned int i;
         void *interface;
         const char *name;
         EFI_STATUS efirc;
 
         /* Fail immediately for NULL handles */
         if ( ! handle )
                 return NULL;
 
         /* Try each name type in turn */
         for ( i = 0 ; i < ( sizeof ( efi_handle_name_types ) /
                             sizeof ( efi_handle_name_types[0] ) ) ; i++ ) {
                 type = &efi_handle_name_types[i];
                 DBG2 ( "<%d", i );
 
                 /* Try to open the applicable protocol */
                 efirc = bs->OpenProtocol ( handle, type->protocol, &interface,
                                            efi_image_handle, handle,
                                            EFI_OPEN_PROTOCOL_GET_PROTOCOL );
                 if ( efirc != 0 ) {
                         DBG2 ( ">" );
                         continue;
                 }
 
                 /* Try to get name from this protocol */
                 DBG2 ( "-" );
                 name = type->name ( interface );
                 DBG2 ( "%c", ( name ? ( name[0] ? 'Y' : 'E' ) : 'N' ) );
 
                 /* Close protocol */
                 bs->CloseProtocol ( handle, type->protocol,
                                     efi_image_handle, handle );
                 DBG2 ( ">" );
 
                 /* Use this name, if possible */
                 if ( name && name[0] )
                         return name;
         }
 
         /* If no name is found, then use the raw handle value and a
          * list of installed protocols.
          */
         used = ssnprintf ( buf, sizeof ( buf ), "UNKNOWN<%p", handle );
         if ( ( efirc = bs->ProtocolsPerHandle ( handle, &protocols,
                                                 &count ) ) == 0 ) {
                 for ( i = 0 ; i < count ; i++ ) {
                         used += ssnprintf ( ( buf + used ),
                                             ( sizeof ( buf ) - used ), ",%s",
                                             efi_guid_ntoa ( protocols[i] ) );
                 }
                 bs->FreePool ( protocols );
         }
         used += ssnprintf ( ( buf + used ), ( sizeof ( buf ) - used ), ">" );
         return buf;
 }

References EFI_SYSTEM_TABLE::BootServices, EFI_BOOT_SERVICES::CloseProtocol, count, DBG2, efi_guid_ntoa(), efi_handle_name_types, efi_image_handle, EFI_OPEN_PROTOCOL_GET_PROTOCOL, efi_systab, EFI_BOOT_SERVICES::FreePool, handle, name, NULL, EFI_BOOT_SERVICES::OpenProtocol, EFI_BOOT_SERVICES::ProtocolsPerHandle, ssnprintf(), and type.

Referenced by chained_locate(), chained_supported(), dbg_efi_opener(), dbg_efi_openers(), dbg_efi_protocol(), dbg_efi_protocols(), efi_autoexec_filesystem(), efi_autoexec_load(), efi_autoexec_network(), efi_block_boot(), efi_block_filename(), efi_block_hook(), efi_block_local(), efi_block_match(), efi_block_root(), efi_bofm_start(), efi_bofm_supported(), efi_cachedhcp_record(), efi_child_add(), efi_child_del(), efi_close_protocol_wrapper(), efi_connect_controller_wrapper(), efi_device_info(), efi_disconnect_controller_wrapper(), efi_driver_connect(), efi_driver_start(), efi_driver_stop(), efi_driver_supported(), efi_dump_image(), efi_exit_boot_services_wrapper(), efi_exit_wrapper(), efi_file_path_claim(), efi_handle_protocol_wrapper(), efi_install_multiple_protocol_interfaces_wrapper(), efi_install_protocol_interface_wrapper(), efi_load_image_wrapper(), efi_local_check_volume_name(), efi_local_open_root(), efi_local_open_volume(), efi_locate_device(), efi_locate_device_path_wrapper(), efi_locate_handle_buffer_wrapper(), efi_locate_handle_wrapper(), efi_open_protocol_information_wrapper(), efi_open_protocol_wrapper(), efi_pci_info(), efi_protocols_per_handle_wrapper(), efi_pxe_install(), efi_pxe_uninstall(), efi_reinstall_protocol_interface_wrapper(), efi_service_add(), efi_service_del(), efi_set_autoboot_ll_addr(), efi_snp_probe(), efi_start_image_wrapper(), efi_uninstall_multiple_protocol_interfaces_wrapper(), efi_uninstall_protocol_interface_wrapper(), efi_unload_image_wrapper(), efi_usb_install(), efi_usb_uninstall(), efi_veto(), efi_veto_close(), efi_veto_close_handle(), efi_veto_close_protocol(), efi_veto_destroy(), efi_veto_disconnect(), efi_veto_find(), efi_veto_uninstall(), efi_veto_unload(), efidev_alloc(), efipci_discover_one(), efipci_open(), efipci_root_open(), efipci_start(), mnpnet_start(), mnptemp_create(), nii_start(), snpnet_start(), snpnet_stop(), snpnet_supported(), usbio_bulk_in_poll(), usbio_bulk_out_poll(), usbio_config(), usbio_control_poll(), usbio_endpoint_open(), usbio_interface(), usbio_interfaces(), usbio_interrupt_callback(), usbio_interrupt_open(), usbio_open(), usbio_path(), usbio_start(), and usbio_supported().

◆ dbg_efi_opener()

void dbg_efi_opener	(	EFI_HANDLE	handle,
		EFI_GUID *	protocol,
		EFI_OPEN_PROTOCOL_INFORMATION_ENTRY *	opener
	)

Print opened protocol information.

Parameters

handle	EFI handle @V protocol Protocol GUID
opener	Opened protocol information

Definition at line 336 of file efi_debug.c.

                                                                     {
 
         printf ( "HANDLE %s %s opened %dx (%s)", efi_handle_name ( handle ),
                  efi_guid_ntoa ( protocol ), opener->OpenCount,
                  efi_open_attributes_name ( opener->Attributes ) );
         printf ( " by %s", efi_handle_name ( opener->AgentHandle ) );
         if ( opener->ControllerHandle == handle ) {
                 printf ( "\n" );
         } else {
                 printf ( " for %s\n",
                          efi_handle_name ( opener->ControllerHandle ) );
         }
 }

References EFI_OPEN_PROTOCOL_INFORMATION_ENTRY::AgentHandle, EFI_OPEN_PROTOCOL_INFORMATION_ENTRY::Attributes, EFI_OPEN_PROTOCOL_INFORMATION_ENTRY::ControllerHandle, efi_guid_ntoa(), efi_handle_name(), efi_open_attributes_name(), handle, EFI_OPEN_PROTOCOL_INFORMATION_ENTRY::OpenCount, printf(), and protocol.

Referenced by dbg_efi_openers().

◆ dbg_efi_openers()

void dbg_efi_openers	(	EFI_HANDLE	handle,
		EFI_GUID *	protocol
	)

Print list of openers of a given protocol on a given handle.

Parameters

handle	EFI handle
protocol	Protocol GUID

Definition at line 357 of file efi_debug.c.

                                                                {
         EFI_BOOT_SERVICES *bs = efi_systab->BootServices;
         EFI_OPEN_PROTOCOL_INFORMATION_ENTRY *openers;
         UINTN count;
         unsigned int i;
         EFI_STATUS efirc;
         int rc;
 
         /* Sanity check */
         if ( ( ! handle ) || ( ! protocol ) ) {
                 printf ( "HANDLE %s could not retrieve openers for %s\n",
                          efi_handle_name ( handle ),
                          efi_guid_ntoa ( protocol ) );
                 return;
         }
 
         /* Retrieve list of openers */
         if ( ( efirc = bs->OpenProtocolInformation ( handle, protocol, &openers,
                                                      &count ) ) != 0 ) {
                 rc = -EEFI ( efirc );
                 printf ( "HANDLE %s could not retrieve openers for %s: %s\n",
                          efi_handle_name ( handle ),
                          efi_guid_ntoa ( protocol ), strerror ( rc ) );
                 return;
         }
 
         /* Dump list of openers */
         for ( i = 0 ; i < count ; i++ )
                 dbg_efi_opener ( handle, protocol, &openers[i] );
 
         /* Free list */
         bs->FreePool ( openers );
 }

References EFI_SYSTEM_TABLE::BootServices, count, dbg_efi_opener(), EEFI, efi_guid_ntoa(), efi_handle_name(), efi_systab, EFI_BOOT_SERVICES::FreePool, handle, EFI_BOOT_SERVICES::OpenProtocolInformation, printf(), protocol, rc, and strerror().

Referenced by dbg_efi_protocol().

◆ dbg_efi_protocol()

void dbg_efi_protocol	(	EFI_HANDLE	handle,
		EFI_GUID *	protocol
	)

Print protocol information on a given handle.

Parameters

handle	EFI handle
protocol	Protocol GUID

Definition at line 397 of file efi_debug.c.

                                                                 {
         EFI_BOOT_SERVICES *bs = efi_systab->BootServices;
         VOID *interface;
         EFI_STATUS efirc;
         int rc;
 
         /* Get protocol instance */
         if ( ( efirc = bs->HandleProtocol ( handle, protocol,
                                             &interface ) ) != 0 ) {
                 rc = -EEFI ( efirc );
                 printf ( "HANDLE %s could not identify %s: %s\n",
                          efi_handle_name ( handle ),
                          efi_guid_ntoa ( protocol ), strerror ( rc ) );
                 return;
         }
         printf ( "HANDLE %s %s at %p\n", efi_handle_name ( handle ),
                  efi_guid_ntoa ( protocol ), interface );
 
         /* Dump list of openers */
         dbg_efi_openers ( handle, protocol );
 }

References EFI_SYSTEM_TABLE::BootServices, dbg_efi_openers(), EEFI, efi_guid_ntoa(), efi_handle_name(), efi_systab, handle, EFI_BOOT_SERVICES::HandleProtocol, printf(), protocol, rc, strerror(), and VOID.

Referenced by dbg_efi_protocols().

◆ dbg_efi_protocols()

void dbg_efi_protocols ( EFI_HANDLE handle )

Print list of protocol handlers attached to a handle.

Parameters

handle EFI handle

Definition at line 424 of file efi_debug.c.

                                              {
         EFI_BOOT_SERVICES *bs = efi_systab->BootServices;
         EFI_GUID **protocols;
         UINTN count;
         unsigned int i;
         EFI_STATUS efirc;
         int rc;
 
         /* Sanity check */
         if ( ! handle ) {
                 printf ( "HANDLE %p could not retrieve protocols\n", handle );
                 return;
         }
 
         /* Retrieve list of protocols */
         if ( ( efirc = bs->ProtocolsPerHandle ( handle, &protocols,
                                                 &count ) ) != 0 ) {
                 rc = -EEFI ( efirc );
                 printf ( "HANDLE %s could not retrieve protocols: %s\n",
                          efi_handle_name ( handle ), strerror ( rc ) );
                 return;
         }
 
         /* Dump list of protocols */
         for ( i = 0 ; i < count ; i++ ) {
                 dbg_efi_protocol ( handle, protocols[i] );
         }
 
         /* Free list */
         bs->FreePool ( protocols );
 }

References EFI_SYSTEM_TABLE::BootServices, count, dbg_efi_protocol(), EEFI, efi_handle_name(), efi_systab, EFI_BOOT_SERVICES::FreePool, handle, printf(), EFI_BOOT_SERVICES::ProtocolsPerHandle, rc, and strerror().

◆ efi_stack_cookie()

unsigned long efi_stack_cookie ( EFI_HANDLE handle )

Construct a stack cookie value.

Parameters

handle Image handle

Return values

cookie Stack cookie

Definition at line 131 of file efi_init.c.

                                        {
         unsigned long cookie = 0;
         unsigned int rotation = ( 8 * sizeof ( cookie ) / 4 );
 
         /* There is no viable source of entropy available at this
          * point.  Construct a value that is at least likely to vary
          * between platforms and invocations.
          */
         cookie ^= ( ( unsigned long ) handle );
         cookie = roll ( cookie, rotation );
         cookie ^= ( ( unsigned long ) &handle );
         cookie = roll ( cookie, rotation );
         cookie ^= profile_timestamp();
         cookie = roll ( cookie, rotation );
         cookie ^= build_id;
 
         /* Ensure that the value contains a NUL byte, to act as a
          * runaway string terminator.  Construct the NUL using a shift
          * rather than a mask, to avoid losing valuable entropy in the
          * lower-order bits.
          */
         cookie <<= 8;
 
         /* Ensure that the NUL byte is placed at the bottom of the
          * stack cookie, to avoid potential disclosure via an
          * unterminated string.
          */
         if ( __BYTE_ORDER == __BIG_ENDIAN )
                 cookie >>= 8;
 
         return cookie;
 }

References __BIG_ENDIAN, __BYTE_ORDER, build_id, handle, profile_timestamp(), and rotation.

Referenced by efi_init_stack_guard().

◆ __stack_chk_fail()

void __stack_chk_fail ( void )

Abort on stack check failure.

Definition at line 372 of file efi_init.c.

                                                             {
         EFI_STATUS efirc;
         int rc;
 
         /* Report failure (when debugging) */
         DBGC ( efi_systab, "EFI stack check failed (cookie %#lx); aborting\n",
                __stack_chk_guard );
 
         /* Attempt to exit cleanly with an error status */
         if ( efi_exit ) {
                 efirc = efi_exit ( efi_image_handle, EFI_COMPROMISED_DATA,
                                    0, NULL );
                 rc = -EEFI ( efirc );
                 DBGC ( efi_systab, "EFI stack check exit failed: %s\n",
                        strerror ( rc ) );
         }
 
         /* If the exit fails for any reason, lock the system */
         while ( 1 ) {}
 
 }

References __stack_chk_guard, DBGC, EEFI, EFI_COMPROMISED_DATA, efi_exit, efi_image_handle, efi_systab, NULL, rc, and strerror().

◆ efi_init_stack_guard()

static void efi_init_stack_guard ( EFI_HANDLE handle )

inlinestatic

Initialise stack cookie.

Parameters

handle Image handle

Definition at line 364 of file efi.h.

                                            {
 
         /* The calling function must not itself use stack protection,
          * since the change in the stack guard value would trigger a
          * false positive.
          *
          * There is unfortunately no way to annotate a function to
          * exclude the use of stack protection.  We must therefore
          * rely on correctly anticipating the compiler's decision on
          * the use of stack protection.
          *
          * The calculation of the stack cookie value deliberately
          * takes the address of a stack variable (to provide an
          * additional source of entropy).  This operation would
          * trigger the application of stack protection to the calling
          * function, and so must be externalised.
          */
         __stack_chk_guard = efi_stack_cookie ( handle );
 }

References __stack_chk_guard, efi_stack_cookie(), and handle.

Referenced by _efi_start(), and _efidrv_start().

◆ efi_init()

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 171 of file efi_init.c.

                                                  {
         EFI_BOOT_SERVICES *bs;
         struct efi_protocol *prot;
         struct efi_config_table *tab;
         void *loaded_image;
         void *device_path;
         void *device_path_copy;
         size_t device_path_len;
         EFI_STATUS efirc;
         int rc;
 
         /* Store image handle and system table pointer for future use */
         efi_image_handle = image_handle;
         efi_systab = systab;
 
         /* Sanity checks */
         if ( ! systab ) {
                 efirc = EFI_NOT_AVAILABLE_YET;
                 goto err_sanity;
         }
         if ( ! systab->ConOut ) {
                 efirc = EFI_NOT_AVAILABLE_YET;
                 goto err_sanity;
         }
         if ( ! systab->BootServices ) {
                 DBGC ( systab, "EFI provided no BootServices entry point\n" );
                 efirc = EFI_NOT_AVAILABLE_YET;
                 goto err_sanity;
         }
         if ( ! systab->RuntimeServices ) {
                 DBGC ( systab, "EFI provided no RuntimeServices entry "
                        "point\n" );
                 efirc = EFI_NOT_AVAILABLE_YET;
                 goto err_sanity;
         }
         DBGC ( systab, "EFI handle %p systab %p\n", image_handle, systab );
         bs = systab->BootServices;
 
         /* Store abort function pointer */
         efi_exit = bs->Exit;
 
         /* Look up used protocols */
         for_each_table_entry ( prot, EFI_PROTOCOLS ) {
                 if ( ( efirc = bs->LocateProtocol ( &prot->guid, NULL,
                                                     prot->protocol ) ) == 0 ) {
                         DBGC ( systab, "EFI protocol %s is at %p\n",
                                efi_guid_ntoa ( &prot->guid ),
                                *(prot->protocol) );
                 } else {
                         DBGC ( systab, "EFI does not provide protocol %s\n",
                                efi_guid_ntoa ( &prot->guid ) );
                         /* Fail if protocol is required */
                         if ( prot->required )
                                 goto err_missing_protocol;
                 }
         }
 
         /* Look up used configuration tables */
         for_each_table_entry ( tab, EFI_CONFIG_TABLES ) {
                 if ( ( *(tab->table) = efi_find_table ( &tab->guid ) ) ) {
                         DBGC ( systab, "EFI configuration table %s is at %p\n",
                                efi_guid_ntoa ( &tab->guid ), *(tab->table) );
                 } else {
                         DBGC ( systab, "EFI does not provide configuration "
                                "table %s\n", efi_guid_ntoa ( &tab->guid ) );
                         if ( tab->required ) {
                                 efirc = EFI_NOT_AVAILABLE_YET;
                                 goto err_missing_table;
                         }
                 }
         }
 
         /* Get loaded image protocol */
         if ( ( efirc = bs->OpenProtocol ( image_handle,
                                 &efi_loaded_image_protocol_guid,
                                 &loaded_image, image_handle, NULL,
                                 EFI_OPEN_PROTOCOL_GET_PROTOCOL ) ) != 0 ) {
                 rc = -EEFI ( efirc );
                 DBGC ( systab, "EFI could not get loaded image protocol: %s",
                        strerror ( rc ) );
                 goto err_no_loaded_image;
         }
         efi_loaded_image = loaded_image;
         DBGC ( systab, "EFI image base address %p\n",
                efi_loaded_image->ImageBase );
 
         /* Record command line */
         efi_cmdline = efi_loaded_image->LoadOptions;
         efi_cmdline_len = efi_loaded_image->LoadOptionsSize;
 
         /* Get loaded image's device handle's device path */
         if ( ( efirc = bs->OpenProtocol ( efi_loaded_image->DeviceHandle,
                                 &efi_device_path_protocol_guid,
                                 &device_path, image_handle, NULL,
                                 EFI_OPEN_PROTOCOL_GET_PROTOCOL ) ) != 0 ) {
                 rc = -EEFI ( efirc );
                 DBGC ( systab, "EFI could not get loaded image's device path: "
                        "%s", strerror ( rc ) );
                 goto err_no_device_path;
         }
 
         /* Make a copy of the loaded image's device handle's device
          * path, since the device handle itself may become invalidated
          * when we load our own drivers.
          */
         device_path_len = ( efi_path_len ( device_path ) +
                             sizeof ( EFI_DEVICE_PATH_PROTOCOL ) );
         if ( ( efirc = bs->AllocatePool ( EfiBootServicesData, device_path_len,
                                           &device_path_copy ) ) != 0 ) {
                 rc = -EEFI ( efirc );
                 goto err_alloc_device_path;
         }
         memcpy ( device_path_copy, device_path, device_path_len );
         efi_loaded_image_path = device_path_copy;
         DBGC ( systab, "EFI image device path %s\n",
                efi_devpath_text ( efi_loaded_image_path ) );
 
         /* EFI is perfectly capable of gracefully shutting down any
          * loaded devices if it decides to fall back to a legacy boot.
          * For no particularly comprehensible reason, it doesn't
          * bother doing so when ExitBootServices() is called.
          */
         if ( ( efirc = bs->CreateEvent ( EVT_SIGNAL_EXIT_BOOT_SERVICES,
                                          TPL_NOTIFY, efi_shutdown_hook,
                                          NULL, &efi_shutdown_event ) ) != 0 ) {
                 rc = -EEFI ( efirc );
                 DBGC ( systab, "EFI could not create ExitBootServices event: "
                        "%s\n", strerror ( rc ) );
                 goto err_create_event;
         }
 
         /* Install driver binding protocol */
         if ( ( rc = efi_driver_install() ) != 0 ) {
                 DBGC ( systab, "EFI could not install driver: %s\n",
                        strerror ( rc ) );
                 efirc = EFIRC ( rc );
                 goto err_driver_install;
         }
 
         /* Install image unload method */
         efi_loaded_image->Unload = efi_unload;
 
         return 0;
 
         efi_driver_uninstall();
  err_driver_install:
         bs->CloseEvent ( efi_shutdown_event );
  err_create_event:
         bs->FreePool ( efi_loaded_image_path );
  err_alloc_device_path:
  err_no_device_path:
  err_no_loaded_image:
  err_missing_table:
  err_missing_protocol:
  err_sanity:
         return efirc;
 }

References EFI_BOOT_SERVICES::AllocatePool, EFI_SYSTEM_TABLE::BootServices, EFI_BOOT_SERVICES::CloseEvent, EFI_SYSTEM_TABLE::ConOut, EFI_BOOT_SERVICES::CreateEvent, DBGC, device_path, EFI_LOADED_IMAGE_PROTOCOL::DeviceHandle, EEFI, efi_cmdline, efi_cmdline_len, EFI_CONFIG_TABLES, efi_device_path_protocol_guid, efi_devpath_text(), efi_driver_install(), efi_driver_uninstall(), efi_exit, efi_find_table(), efi_guid_ntoa(), efi_image_handle, efi_loaded_image, efi_loaded_image_path, efi_loaded_image_protocol_guid, EFI_NOT_AVAILABLE_YET, EFI_OPEN_PROTOCOL_GET_PROTOCOL, efi_path_len(), EFI_PROTOCOLS, efi_shutdown_event, efi_shutdown_hook(), efi_systab, efi_unload(), EfiBootServicesData, EFIRC, EVT_SIGNAL_EXIT_BOOT_SERVICES, EFI_BOOT_SERVICES::Exit, for_each_table_entry, EFI_BOOT_SERVICES::FreePool, efi_protocol::guid, efi_config_table::guid, EFI_LOADED_IMAGE_PROTOCOL::ImageBase, EFI_LOADED_IMAGE_PROTOCOL::LoadOptions, EFI_LOADED_IMAGE_PROTOCOL::LoadOptionsSize, EFI_BOOT_SERVICES::LocateProtocol, memcpy(), NULL, EFI_BOOT_SERVICES::OpenProtocol, efi_protocol::protocol, rc, efi_protocol::required, efi_config_table::required, EFI_SYSTEM_TABLE::RuntimeServices, strerror(), efi_config_table::table, TPL_NOTIFY, and EFI_LOADED_IMAGE_PROTOCOL::Unload.

Referenced by _efi_start(), and _efidrv_start().

◆ efi_raise_tpl()

void efi_raise_tpl ( struct efi_saved_tpl * tpl )

Raise task priority level to internal level.

Parameters

tpl Saved TPL

Definition at line 399 of file efi_init.c.

                                                  {
         EFI_BOOT_SERVICES *bs = efi_systab->BootServices;
 
         /* Record current external TPL */
         tpl->previous = efi_external_tpl;
 
         /* Raise TPL and record previous TPL as new external TPL */
         tpl->current = bs->RaiseTPL ( efi_internal_tpl );
         efi_external_tpl = tpl->current;
 }

References EFI_SYSTEM_TABLE::BootServices, efi_saved_tpl::current, efi_external_tpl, efi_internal_tpl, efi_systab, efi_saved_tpl::previous, and EFI_BOOT_SERVICES::RaiseTPL.

Referenced by _efidrv_start(), efi_driver_start(), efi_driver_stop(), efi_snp_add_claim(), efi_snp_get_status(), efi_snp_initialize(), efi_snp_receive(), efi_snp_reset(), efi_snp_shutdown(), efi_snp_transmit(), efi_snp_wait_for_packet(), efi_unload(), efi_usb_async_interrupt_transfer(), efi_usb_bulk_transfer(), efi_usb_control_transfer(), efi_usb_get_string_descriptor(), efi_usb_sync_interrupt_transfer(), efi_vlan_find(), efi_vlan_remove(), and efi_vlan_set().

◆ efi_restore_tpl()

void efi_restore_tpl ( struct efi_saved_tpl * tpl )

Restore task priority level.

Parameters

tpl Saved TPL

Definition at line 415 of file efi_init.c.

                                                    {
         EFI_BOOT_SERVICES *bs = efi_systab->BootServices;
 
         /* Restore external TPL */
         efi_external_tpl = tpl->previous;
 
         /* Restore TPL */
         bs->RestoreTPL ( tpl->current );
 }

References EFI_SYSTEM_TABLE::BootServices, efi_saved_tpl::current, efi_external_tpl, efi_systab, efi_saved_tpl::previous, and EFI_BOOT_SERVICES::RestoreTPL.

Referenced by _efidrv_start(), efi_driver_start(), efi_driver_stop(), efi_snp_add_claim(), efi_snp_get_status(), efi_snp_initialize(), efi_snp_receive(), efi_snp_reset(), efi_snp_shutdown(), efi_snp_transmit(), efi_snp_wait_for_packet(), efi_unload(), efi_usb_async_interrupt_transfer(), efi_usb_bulk_transfer(), efi_usb_control_transfer(), efi_usb_get_string_descriptor(), efi_usb_sync_interrupt_transfer(), efi_vlan_find(), efi_vlan_remove(), and efi_vlan_set().

Variable Documentation

◆ efi_absolute_pointer_protocol_guid

EFI_GUID efi_absolute_pointer_protocol_guid

Absolute pointer protocol GUID.

Definition at line 100 of file efi_guid.c.

◆ efi_acpi_table_protocol_guid

EFI_GUID efi_acpi_table_protocol_guid

ACPI table protocol GUID.

Definition at line 104 of file efi_guid.c.

◆ efi_apple_net_boot_protocol_guid

EFI_GUID efi_apple_net_boot_protocol_guid

Apple NetBoot protocol GUID.

Definition at line 108 of file efi_guid.c.

Referenced by efi_pxe_install(), and efi_pxe_uninstall().

◆ efi_arp_protocol_guid

EFI_GUID efi_arp_protocol_guid

ARP protocol GUID.

Definition at line 112 of file efi_guid.c.

◆ efi_arp_service_binding_protocol_guid

EFI_GUID efi_arp_service_binding_protocol_guid

ARP service binding protocol GUID.

Definition at line 116 of file efi_guid.c.

◆ efi_block_io_protocol_guid

EFI_GUID efi_block_io_protocol_guid

Block I/O protocol GUID.

Definition at line 120 of file efi_guid.c.

Referenced by efi_block_boot(), efi_block_hook(), efi_block_local(), efi_block_unhook(), efi_file_install(), and efi_file_uninstall().

◆ efi_block_io2_protocol_guid

EFI_GUID efi_block_io2_protocol_guid

Block I/O version 2 protocol GUID.

Definition at line 124 of file efi_guid.c.

◆ efi_bus_specific_driver_override_protocol_guid

EFI_GUID efi_bus_specific_driver_override_protocol_guid

Bus specific driver override protocol GUID.

Definition at line 128 of file efi_guid.c.

◆ efi_component_name_protocol_guid

EFI_GUID efi_component_name_protocol_guid

Component name protocol GUID.

Definition at line 132 of file efi_guid.c.

Referenced by efi_veto_find().

◆ efi_component_name2_protocol_guid

EFI_GUID efi_component_name2_protocol_guid

Component name 2 protocol GUID.

Definition at line 136 of file efi_guid.c.

Referenced by efi_driver_controller_name(), efi_driver_install(), efi_driver_uninstall(), efi_snp_probe(), and efi_snp_remove().

◆ efi_console_control_protocol_guid

EFI_GUID efi_console_control_protocol_guid

Console control protocol GUID.

Definition at line 140 of file efi_guid.c.

◆ efi_device_path_protocol_guid

EFI_GUID efi_device_path_protocol_guid

Device path protocol GUID.

Definition at line 144 of file efi_guid.c.

Referenced by efi_block_hook(), efi_block_match(), efi_block_scan(), efi_block_unhook(), efi_child_add(), efi_child_del(), efi_file_path_claim(), efi_file_path_install(), efi_file_path_uninstall(), efi_init(), efi_locate_device(), efi_snp_hii_install(), efi_snp_hii_uninstall(), efi_snp_probe(), efi_snp_remove(), efi_usb_install(), efi_usb_uninstall(), efidev_alloc(), and usbio_path().

◆ efi_dhcp4_protocol_guid

EFI_GUID efi_dhcp4_protocol_guid

DHCPv4 protocol GUID.

Definition at line 148 of file efi_guid.c.

◆ efi_dhcp4_service_binding_protocol_guid

EFI_GUID efi_dhcp4_service_binding_protocol_guid

DHCPv4 service binding protocol GUID.

Definition at line 152 of file efi_guid.c.

◆ efi_dhcp6_protocol_guid

EFI_GUID efi_dhcp6_protocol_guid

DHCPv6 protocol GUID.

Definition at line 156 of file efi_guid.c.

◆ efi_dhcp6_service_binding_protocol_guid

EFI_GUID efi_dhcp6_service_binding_protocol_guid

DHCPv6 service binding protocol GUID.

Definition at line 160 of file efi_guid.c.

◆ efi_disk_io_protocol_guid

EFI_GUID efi_disk_io_protocol_guid

Disk I/O protocol GUID.

Definition at line 164 of file efi_guid.c.

Referenced by efi_file_install(), and efi_file_uninstall().

◆ efi_dns4_protocol_guid

EFI_GUID efi_dns4_protocol_guid

DNSv4 protocol GUID.

Definition at line 168 of file efi_guid.c.

◆ efi_dns4_service_binding_protocol_guid

EFI_GUID efi_dns4_service_binding_protocol_guid

DNSv4 service binding protocol GUID.

Definition at line 172 of file efi_guid.c.

◆ efi_dns6_protocol_guid

EFI_GUID efi_dns6_protocol_guid

DNSv6 protocol GUID.

Definition at line 176 of file efi_guid.c.

◆ efi_dns6_service_binding_protocol_guid

EFI_GUID efi_dns6_service_binding_protocol_guid

DNSv6 service binding protocol GUID.

Definition at line 180 of file efi_guid.c.

◆ efi_driver_binding_protocol_guid

EFI_GUID efi_driver_binding_protocol_guid

Driver binding protocol GUID.

Definition at line 184 of file efi_guid.c.

Referenced by efi_driver_install(), efi_driver_uninstall(), efi_veto(), efi_veto_find(), and efi_veto_uninstall().

◆ efi_graphics_output_protocol_guid

EFI_GUID efi_graphics_output_protocol_guid

Graphics output protocol GUID.

Definition at line 188 of file efi_guid.c.

Referenced by efifb_init().

◆ efi_hii_config_access_protocol_guid

EFI_GUID efi_hii_config_access_protocol_guid

HII configuration access protocol GUID.

Definition at line 192 of file efi_guid.c.

Referenced by efi_snp_hii_install(), and efi_snp_hii_uninstall().

◆ efi_hii_font_protocol_guid

EFI_GUID efi_hii_font_protocol_guid

HII font protocol GUID.

Definition at line 196 of file efi_guid.c.

Referenced by efifb_init().

◆ efi_http_protocol_guid

EFI_GUID efi_http_protocol_guid

HTTP protocol GUID.

Definition at line 200 of file efi_guid.c.

◆ efi_http_service_binding_protocol_guid

EFI_GUID efi_http_service_binding_protocol_guid

HTTP service binding protocol GUID.

Definition at line 204 of file efi_guid.c.

◆ efi_ip4_protocol_guid

EFI_GUID efi_ip4_protocol_guid

IPv4 protocol GUID.

Definition at line 208 of file efi_guid.c.

◆ efi_ip4_config_protocol_guid

EFI_GUID efi_ip4_config_protocol_guid

IPv4 configuration protocol GUID.

Definition at line 212 of file efi_guid.c.

◆ efi_ip4_config2_protocol_guid

EFI_GUID efi_ip4_config2_protocol_guid

IPv4 configuration 2 protocol GUID.

Definition at line 216 of file efi_guid.c.

◆ efi_ip4_service_binding_protocol_guid

EFI_GUID efi_ip4_service_binding_protocol_guid

IPv4 service binding protocol GUID.

Definition at line 220 of file efi_guid.c.

◆ efi_ip6_protocol_guid

EFI_GUID efi_ip6_protocol_guid

IPv6 protocol GUID.

Definition at line 224 of file efi_guid.c.

◆ efi_ip6_config_protocol_guid

EFI_GUID efi_ip6_config_protocol_guid

IPv6 configuration protocol GUID.

Definition at line 228 of file efi_guid.c.

◆ efi_ip6_service_binding_protocol_guid

EFI_GUID efi_ip6_service_binding_protocol_guid

IPv6 service binding protocol GUID.

Definition at line 232 of file efi_guid.c.

◆ efi_load_file_protocol_guid

EFI_GUID efi_load_file_protocol_guid

Load file protocol GUID.

Definition at line 236 of file efi_guid.c.

Referenced by efi_snp_probe(), and efi_snp_remove().

◆ efi_load_file2_protocol_guid

EFI_GUID efi_load_file2_protocol_guid

Load file 2 protocol GUID.

Definition at line 240 of file efi_guid.c.

Referenced by efi_file_path_install(), and efi_file_path_uninstall().

◆ efi_loaded_image_protocol_guid

EFI_GUID efi_loaded_image_protocol_guid

Loaded image protocol GUID.

Definition at line 244 of file efi_guid.c.

Referenced by efi_dump_image(), efi_image_exec(), efi_init(), and efi_veto_find().

◆ efi_loaded_image_device_path_protocol_guid

EFI_GUID efi_loaded_image_device_path_protocol_guid

Loaded image device path protocol GUID.

Definition at line 248 of file efi_guid.c.

◆ efi_managed_network_protocol_guid

EFI_GUID efi_managed_network_protocol_guid

Managed network protocol GUID.

Definition at line 252 of file efi_guid.c.

Referenced by mnpnet_start(), and mnpnet_stop().

◆ efi_managed_network_service_binding_protocol_guid

EFI_GUID efi_managed_network_service_binding_protocol_guid

Managed network service binding protocol GUID.

Definition at line 256 of file efi_guid.c.

Referenced by mnp_supported(), mnpnet_start(), and mnpnet_stop().

◆ efi_mtftp4_protocol_guid

EFI_GUID efi_mtftp4_protocol_guid

MTFTPv4 protocol GUID.

Definition at line 260 of file efi_guid.c.

◆ efi_mtftp4_service_binding_protocol_guid

EFI_GUID efi_mtftp4_service_binding_protocol_guid

MTFTPv4 service binding protocol GUID.

Definition at line 264 of file efi_guid.c.

◆ efi_mtftp6_protocol_guid

EFI_GUID efi_mtftp6_protocol_guid

MTFTPv6 protocol GUID.

Definition at line 268 of file efi_guid.c.

◆ efi_mtftp6_service_binding_protocol_guid

EFI_GUID efi_mtftp6_service_binding_protocol_guid

MTFTPv6 service binding protocol GUID.

Definition at line 272 of file efi_guid.c.

◆ efi_nii_protocol_guid

EFI_GUID efi_nii_protocol_guid

Network interface identifier protocol GUID (old version)

Definition at line 276 of file efi_guid.c.

Referenced by efi_snp_probe(), and efi_snp_remove().

◆ efi_nii31_protocol_guid

EFI_GUID efi_nii31_protocol_guid

Network interface identifier protocol GUID (new version)

Definition at line 280 of file efi_guid.c.

Referenced by efi_snp_probe(), efi_snp_remove(), nii_start(), nii_stop(), and nii_supported().

◆ efi_pci_io_protocol_guid

EFI_GUID efi_pci_io_protocol_guid

PCI I/O protocol GUID.

Definition at line 284 of file efi_guid.c.

Referenced by efi_pci_info(), efipci_close(), efipci_open(), efipci_start(), nii_pci_close(), and nii_pci_open().

◆ efi_pci_root_bridge_io_protocol_guid

EFI_GUID efi_pci_root_bridge_io_protocol_guid

PCI root bridge I/O protocol GUID.

Definition at line 288 of file efi_guid.c.

Referenced by efipci_discover_any(), efipci_discover_one(), efipci_root_close(), and efipci_root_open().

◆ efi_pxe_base_code_protocol_guid

EFI_GUID efi_pxe_base_code_protocol_guid

PXE base code protocol GUID.

Definition at line 292 of file efi_guid.c.

Referenced by efi_cachedhcp_record(), efi_pxe_install(), efi_pxe_uninstall(), and efi_shim_inhibit_pxe().

◆ efi_serial_io_protocol_guid

EFI_GUID efi_serial_io_protocol_guid

Serial I/O protocol GUID.

Definition at line 296 of file efi_guid.c.

◆ efi_shim_lock_protocol_guid

EFI_GUID efi_shim_lock_protocol_guid

Shim lock protocol GUID.

Definition at line 300 of file efi_guid.c.

Referenced by efi_shim_is_sbatlevel(), and efi_shim_unlock().

◆ efi_simple_file_system_protocol_guid

EFI_GUID efi_simple_file_system_protocol_guid

Simple file system protocol GUID.

Definition at line 304 of file efi_guid.c.

Referenced by efi_block_root(), efi_block_scan(), efi_file_install(), efi_file_uninstall(), efi_local_open_root(), and efi_local_open_volume().

◆ efi_simple_network_protocol_guid

EFI_GUID efi_simple_network_protocol_guid

Simple network protocol GUID.

Definition at line 308 of file efi_guid.c.

Referenced by efi_set_autoboot_ll_addr(), efi_snp_probe(), efi_snp_remove(), snp_supported(), snpnet_start(), and snpnet_stop().

◆ efi_simple_pointer_protocol_guid

EFI_GUID efi_simple_pointer_protocol_guid

Simple pointer protocol GUID.

Definition at line 312 of file efi_guid.c.

◆ efi_simple_text_input_protocol_guid

EFI_GUID efi_simple_text_input_protocol_guid

Simple text input protocol GUID.

Definition at line 316 of file efi_guid.c.

◆ efi_simple_text_input_ex_protocol_guid

EFI_GUID efi_simple_text_input_ex_protocol_guid

Simple text input extension protocol GUID.

Definition at line 320 of file efi_guid.c.

Referenced by efi_console_init().

◆ efi_simple_text_output_protocol_guid

EFI_GUID efi_simple_text_output_protocol_guid

Simple text output protocol GUID.

Definition at line 324 of file efi_guid.c.

◆ efi_tcg_protocol_guid

EFI_GUID efi_tcg_protocol_guid

TCG protocol GUID.

Definition at line 328 of file efi_guid.c.

◆ efi_tcg2_protocol_guid

EFI_GUID efi_tcg2_protocol_guid

TCG2 protocol GUID.

Definition at line 332 of file efi_guid.c.

◆ efi_tcp4_protocol_guid

EFI_GUID efi_tcp4_protocol_guid

TCPv4 protocol GUID.

Definition at line 336 of file efi_guid.c.

◆ efi_tcp4_service_binding_protocol_guid

EFI_GUID efi_tcp4_service_binding_protocol_guid

TCPv4 service binding protocol GUID.

Definition at line 340 of file efi_guid.c.

◆ efi_tcp6_protocol_guid

EFI_GUID efi_tcp6_protocol_guid

TCPv6 protocol GUID.

Definition at line 344 of file efi_guid.c.

◆ efi_tcp6_service_binding_protocol_guid

EFI_GUID efi_tcp6_service_binding_protocol_guid

TCPv6 service binding protocol GUID.

Definition at line 348 of file efi_guid.c.

◆ efi_tree_protocol_guid

EFI_GUID efi_tree_protocol_guid

TrEE protocol GUID.

Definition at line 352 of file efi_guid.c.

◆ efi_udp4_protocol_guid

EFI_GUID efi_udp4_protocol_guid

UDPv4 protocol GUID.

Definition at line 356 of file efi_guid.c.

◆ efi_udp4_service_binding_protocol_guid

EFI_GUID efi_udp4_service_binding_protocol_guid

UDPv4 service binding protocol GUID.

Definition at line 360 of file efi_guid.c.

◆ efi_udp6_protocol_guid

EFI_GUID efi_udp6_protocol_guid

UDPv6 protocol GUID.

Definition at line 364 of file efi_guid.c.

◆ efi_udp6_service_binding_protocol_guid

EFI_GUID efi_udp6_service_binding_protocol_guid

UDPv6 service binding protocol GUID.

Definition at line 368 of file efi_guid.c.

◆ efi_uga_draw_protocol_guid

EFI_GUID efi_uga_draw_protocol_guid

UGA draw protocol GUID.

Definition at line 372 of file efi_guid.c.

◆ efi_unicode_collation_protocol_guid

EFI_GUID efi_unicode_collation_protocol_guid

Unicode collation protocol GUID.

Definition at line 376 of file efi_guid.c.

◆ efi_usb_hc_protocol_guid

EFI_GUID efi_usb_hc_protocol_guid

USB host controller protocol GUID.

Definition at line 380 of file efi_guid.c.

◆ efi_usb2_hc_protocol_guid

EFI_GUID efi_usb2_hc_protocol_guid

USB2 host controller protocol GUID.

Definition at line 384 of file efi_guid.c.

◆ efi_usb_io_protocol_guid

EFI_GUID efi_usb_io_protocol_guid

USB I/O protocol GUID.

Definition at line 388 of file efi_guid.c.

Referenced by efi_usb_install(), efi_usb_uninstall(), usbio_close(), usbio_open(), usbio_start(), usbio_stop(), and usbio_supported().

◆ efi_vlan_config_protocol_guid

EFI_GUID efi_vlan_config_protocol_guid

VLAN configuration protocol GUID.

Definition at line 392 of file efi_guid.c.

Referenced by efi_snp_probe(), and efi_snp_remove().

◆ efi_file_info_id

EFI_GUID efi_file_info_id

File information GUID.

Definition at line 395 of file efi_guid.c.

Referenced by efi_file_get_info(), and efi_local_len().

◆ efi_file_system_info_id

EFI_GUID efi_file_system_info_id

File system information GUID.

Definition at line 398 of file efi_guid.c.

Referenced by efi_block_label(), efi_file_get_info(), and efi_local_check_volume_name().

◆ efi_image_handle

EFI_HANDLE efi_image_handle

Image handle passed to entry point.

Definition at line 34 of file efi_init.c.

Referenced by __stack_chk_fail(), chained_locate(), chained_supported(), efi_block_exec(), efi_block_local(), efi_block_match(), efi_block_root(), efi_block_scan(), efi_cachedhcp_record(), efi_child_add(), efi_child_del(), efi_console_init(), efi_driver_install(), efi_driver_uninstall(), efi_dump_image(), efi_file_install(), efi_file_uninstall(), efi_handle_name(), efi_image_exec(), efi_image_probe(), efi_init(), efi_local_open_root(), efi_locate_device(), efi_service_add(), efi_service_del(), efi_set_autoboot_ll_addr(), efi_shim_inhibit_pxe(), efi_snp_probe(), efi_snp_remove(), efi_veto_find(), efi_veto_uninstall(), efidev_alloc(), efipci_close(), efipci_discover_one(), efipci_open(), efipci_root_close(), efipci_root_open(), mnpnet_start(), mnpnet_stop(), nii_pci_close(), nii_pci_open(), nii_start(), nii_stop(), snpnet_start(), snpnet_stop(), snpnet_supported(), usbio_close(), usbio_open(), usbio_path(), usbio_start(), usbio_stop(), and usbio_supported().

◆ efi_loaded_image

EFI_LOADED_IMAGE_PROTOCOL* efi_loaded_image

Loaded image protocol for this image.

Definition at line 37 of file efi_init.c.

Referenced by _efi_start(), chained_locate(), efi_autoexec_filesystem(), efi_autoexec_load(), efi_autoexec_network(), efi_init(), efi_init_application(), and efi_local_open_path().

◆ efi_loaded_image_path

EFI_DEVICE_PATH_PROTOCOL* efi_loaded_image_path

Device path for the loaded image's device handle.

Definition at line 40 of file efi_init.c.

Referenced by efi_init(), efi_init_application(), efi_local_open_volume(), efi_path_net_probe(), and efi_unload().

◆ efi_systab

EFI_SYSTEM_TABLE* efi_systab

Referenced by __stack_chk_fail(), chained_locate(), chained_supported(), dbg_efi_openers(), dbg_efi_protocol(), dbg_efi_protocols(), efi_allocate_pages_wrapper(), efi_allocate_pool_wrapper(), efi_block_boot(), efi_block_connect(), efi_block_exec(), efi_block_hook(), efi_block_local(), efi_block_match(), efi_block_root(), efi_block_scan(), efi_block_unhook(), efi_bofm_start(), efi_bofm_supported(), efi_cachedhcp_record(), efi_check_event_wrapper(), efi_child_add(), efi_child_del(), efi_close_event_wrapper(), efi_close_protocol_wrapper(), efi_conin_name(), efi_connect_controller_wrapper(), efi_conout_name(), efi_console_init(), efi_create_event_ex_wrapper(), efi_create_event_wrapper(), efi_currticks(), efi_devpath_text(), efi_disconnect_controller_wrapper(), efi_download_install(), efi_download_uninstall(), efi_driver_connect(), efi_driver_controller_name(), efi_driver_disconnect(), efi_driver_handles(), efi_driver_install(), efi_driver_reconnect(), efi_driver_uninstall(), efi_dump_image(), efi_entropy_disable(), efi_entropy_enable(), efi_entropy_tick(), efi_exit_boot_services_wrapper(), efi_exit_wrapper(), efi_file_install(), efi_file_path_claim(), efi_file_path_install(), efi_file_path_uninstall(), efi_file_uninstall(), efi_find_table(), efi_free_pages_wrapper(), efi_free_pool_wrapper(), efi_get_memory_map_wrapper(), efi_get_next_monotonic_count_wrapper(), efi_get_time(), efi_getchar(), efi_handle_cup(), efi_handle_dectcem_reset(), efi_handle_dectcem_set(), efi_handle_ed(), efi_handle_name(), efi_handle_protocol_wrapper(), efi_handle_sgr(), efi_image_exec(), efi_image_probe(), efi_init(), efi_install_configuration_table_wrapper(), efi_install_multiple_protocol_interfaces_wrapper(), efi_install_protocol_interface_wrapper(), efi_iskey(), efi_load_image_wrapper(), efi_local_open_root(), efi_local_open_volume(), efi_locate_device(), efi_locate_device_path_wrapper(), efi_locate_handle_buffer_wrapper(), efi_locate_handle_wrapper(), efi_locate_protocol_wrapper(), efi_open_protocol_information_wrapper(), efi_open_protocol_wrapper(), efi_poweroff(), efi_protocols_per_handle_wrapper(), efi_putchar(), efi_pxe_install(), efi_pxe_uninstall(), efi_raise_tpl(), efi_raise_tpl_wrapper(), efi_reboot(), efi_register_protocol_notify_wrapper(), efi_reinstall_protocol_interface_wrapper(), efi_restore_tpl(), efi_restore_tpl_wrapper(), efi_service_add(), efi_service_del(), efi_set_autoboot_ll_addr(), efi_set_timer_wrapper(), efi_set_watchdog_timer_wrapper(), efi_shim_get_memory_map(), efi_shim_inhibit_pxe(), efi_shim_install(), efi_shim_uninstall(), efi_shim_unlock(), efi_signal_event_wrapper(), efi_snp_hii_append(), efi_snp_hii_install(), efi_snp_hii_uninstall(), efi_snp_poll(), efi_snp_probe(), efi_snp_remove(), efi_stall_wrapper(), efi_start_image_wrapper(), efi_tick_shutdown(), efi_tick_startup(), efi_udelay(), efi_uninstall_multiple_protocol_interfaces_wrapper(), efi_uninstall_protocol_interface_wrapper(), efi_unload(), efi_unload_image_wrapper(), efi_urealloc(), efi_usb_async_start(), efi_usb_async_stop(), efi_usb_close(), efi_usb_get_string_descriptor(), efi_usb_install(), efi_usb_open(), efi_usb_probe(), efi_usb_uninstall(), efi_veto(), efi_veto_close(), efi_veto_close_handle(), efi_veto_close_protocol(), efi_veto_disconnect(), efi_veto_find(), efi_veto_uninstall(), efi_veto_unload(), efi_vlan_find(), efi_wait_for_event_wrapper(), efi_watchdog_expired(), efi_watchdog_shutdown(), efi_wrap(), efi_wrap_bs(), efidev_alloc(), efifb_draw(), efifb_init(), efifb_select_mode(), efipci_close(), efipci_discover_any(), efipci_discover_one(), efipci_open(), efipci_root_close(), efipci_root_open(), efivars_fetch(), efivars_find(), mnpnet_close(), mnpnet_open(), mnpnet_poll_rx(), mnpnet_start(), mnpnet_stop(), nii_block(), nii_issue_cpb_db(), nii_pci_close(), nii_pci_open(), nii_start(), nii_stop(), snpnet_start(), snpnet_stop(), snpnet_supported(), usbio_close(), usbio_open(), usbio_path(), usbio_start(), usbio_stop(), and usbio_supported().

◆ efi_internal_tpl

EFI_TPL efi_internal_tpl

Internal task priority level.

Definition at line 52 of file efi_init.c.

Referenced by efi_currticks(), efi_entropy_disable(), efi_raise_tpl(), efi_shutdown_hook(), and nii_issue_cpb_db().

◆ efi_external_tpl

EFI_TPL efi_external_tpl

External task priority level.

Definition at line 55 of file efi_init.c.

Referenced by efi_currticks(), efi_entropy_enable(), efi_raise_tpl(), and efi_restore_tpl().

◆ efi_shutdown_in_progress

int efi_shutdown_in_progress

EFI shutdown is in progress.

Definition at line 58 of file efi_init.c.

Referenced by efi_block_unhook(), efi_cpu_nap(), efi_currticks(), efi_pxe_uninstall(), efi_shutdown_hook(), efi_snp_hii_uninstall(), efi_snp_remove(), efi_usb_uninstall(), mnpnet_close(), mnpnet_poll(), mnpnet_stop(), mnpnet_transmit(), snpnet_close(), snpnet_poll(), snpnet_stop(), snpnet_transmit(), usbio_endpoint_enqueue(), and usbio_endpoint_poll().

◆ __stack_chk_guard

unsigned long __stack_chk_guard

Stack cookie.

Definition at line 64 of file efi_init.c.

Referenced by __stack_chk_fail(), and efi_init_stack_guard().

Data Structures

Macros

Functions

Variables

Detailed Description

Macro Definition Documentation

◆ EFI_HANDLE

◆ _Static_assert

◆ EFI_PROTOCOLS

◆ __efi_protocol

◆ EFI_REQUIRE_PROTOCOL

◆ EFI_REQUEST_PROTOCOL

◆ EFI_CONFIG_TABLES

◆ __efi_config_table

◆ EFI_USE_TABLE

◆ EFIRC

◆ EEFI

◆ DBG_EFI_OPENER_IF

◆ DBG_EFI_OPENERS_IF

◆ DBG_EFI_PROTOCOLS_IF

◆ DBGC_EFI_OPENER_IF

◆ DBGC_EFI_OPENERS_IF

◆ DBGC_EFI_PROTOCOL_IF

◆ DBGC_EFI_PROTOCOLS_IF

◆ DBGC_EFI_OPENER

◆ DBGC_EFI_OPENERS

◆ DBGC_EFI_PROTOCOL

◆ DBGC_EFI_PROTOCOLS

◆ DBGC2_EFI_OPENER

◆ DBGC2_EFI_OPENERS

◆ DBGC2_EFI_PROTOCOL

◆ DBGC2_EFI_PROTOCOLS

◆ DBGCP_EFI_OPENER

◆ DBGCP_EFI_OPENERS

◆ DBGCP_EFI_PROTOCOL

◆ DBGCP_EFI_PROTOCOLS

◆ EFI_INTF_OP

Function Documentation

◆ FILE_LICENCE()

◆ efi_guid_ntoa()

◆ efi_locate_search_type_name()

◆ efi_open_attributes_name()

◆ efi_devpath_text()

◆ efi_handle_name()

◆ dbg_efi_opener()

◆ dbg_efi_openers()

◆ dbg_efi_protocol()

◆ dbg_efi_protocols()

◆ efi_stack_cookie()

◆ __stack_chk_fail()

◆ efi_init_stack_guard()

◆ efi_init()

◆ efi_raise_tpl()

◆ efi_restore_tpl()

Variable Documentation

◆ efi_absolute_pointer_protocol_guid

◆ efi_acpi_table_protocol_guid

◆ efi_apple_net_boot_protocol_guid

◆ efi_arp_protocol_guid

◆ efi_arp_service_binding_protocol_guid

◆ efi_block_io_protocol_guid

◆ efi_block_io2_protocol_guid

◆ efi_bus_specific_driver_override_protocol_guid

◆ efi_component_name_protocol_guid

◆ efi_component_name2_protocol_guid

◆ efi_console_control_protocol_guid

◆ efi_device_path_protocol_guid

◆ efi_dhcp4_protocol_guid

◆ efi_dhcp4_service_binding_protocol_guid

◆ efi_dhcp6_protocol_guid

◆ efi_dhcp6_service_binding_protocol_guid

◆ efi_disk_io_protocol_guid

◆ efi_dns4_protocol_guid

◆ efi_dns4_service_binding_protocol_guid

◆ efi_dns6_protocol_guid

◆ efi_dns6_service_binding_protocol_guid

◆ efi_driver_binding_protocol_guid

◆ efi_graphics_output_protocol_guid

◆ efi_hii_config_access_protocol_guid

◆ efi_hii_font_protocol_guid