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_EVENT

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	EFI_EVENT STUPID_EFI_EVENT

#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

#define	efi_test(handle, protocol) efi_open_untyped ( (handle), (protocol), NULL )
	Test protocol existence. More...

#define	efi_open(handle, protocol, interface)
	Open protocol for ephemeral use. More...

#define	efi_open_unsafe(handle, protocol, interface)
	Open protocol for unsafe persistent use. More...

#define	efi_open_by_driver(handle, protocol, interface)
	Open protocol for persistent use by a driver. More...

#define	efi_open_by_child(handle, protocol, child, interface)
	Open protocol for persistent use by a child controller. More...

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_tpl_name (EFI_TPL tpl)
	Name EFI TPL. 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...

int	efi_open_untyped (EFI_HANDLE handle, EFI_GUID protocol, void *interface)
	Open (or test) protocol for ephemeral use. More...

int	efi_open_unsafe_untyped (EFI_HANDLE handle, EFI_GUID protocol, void *interface)
	Open protocol for unsafe persistent use. More...

void	efi_close_unsafe (EFI_HANDLE handle, EFI_GUID *protocol)
	Close protocol opened for unsafe persistent use. More...

int	efi_open_by_driver_untyped (EFI_HANDLE handle, EFI_GUID protocol, void *interface)
	Open protocol for persistent use by a driver. More...

void	efi_close_by_driver (EFI_HANDLE handle, EFI_GUID *protocol)
	Close protocol opened for persistent use by a driver. More...

int	efi_open_by_child_untyped (EFI_HANDLE handle, EFI_GUID protocol, EFI_HANDLE child, void *interface)
	Open protocol for persistent use by a child controller. More...

void	efi_close_by_child (EFI_HANDLE handle, EFI_GUID *protocol, EFI_HANDLE child)
	Close protocol opened for persistent use by a child controller. More...

int	efi_connect (EFI_HANDLE device, EFI_HANDLE driver)
	Connect UEFI driver(s) More...

int	efi_disconnect (EFI_HANDLE device, EFI_HANDLE driver)
	Disconnect UEFI driver(s) 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_adapter_information_protocol_guid
	Adapter information 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_eap_configuration_protocol_guid
	EAP configuration 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_rng_protocol_guid
	Random number generator 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_supplicant_protocol_guid
	Supplicant 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_wifi2_protocol_guid
	WiFi 2 protocol GUID. More...

EFI_GUID	efi_acpi_10_table_guid
	ACPI 1.0 table GUID. More...

EFI_GUID	efi_acpi_20_table_guid
	ACPI 2.0 table GUID. More...

EFI_GUID	efi_fdt_table_guid
	FDT table GUID. More...

EFI_GUID	efi_smbios_table_guid
	SMBIOS table GUID. More...

EFI_GUID	efi_smbios2_table_guid

EFI_GUID	efi_cert_x509_guid
	X.509 certificate 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_GUID	efi_global_variable
	Global variable GUID. More...

EFI_GUID	efi_tls_ca_certificate_guid
	TLS CA certificate variable 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.

◆ EFI_EVENT

#define EFI_EVENT STUPID_EFI_EVENT

Definition at line 53 of file efi.h.

◆ _Static_assert

#define _Static_assert	(	expr,
		msg
	)

Definition at line 55 of file efi.h.

◆ EFI_PROTOCOLS

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

EFI protocol table.

Definition at line 97 of file efi.h.

◆ __efi_protocol

#define __efi_protocol __table_entry ( EFI_PROTOCOLS, 01 )

Declare an EFI protocol used by iPXE.

Definition at line 100 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 107 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 121 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 141 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 145 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 153 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 166 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 174 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 295 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 303 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 309 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 315 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 321 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 327 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 333 of file efi.h.

◆ DBGC_EFI_OPENER

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

Definition at line 339 of file efi.h.

◆ DBGC_EFI_OPENERS

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

Definition at line 341 of file efi.h.

◆ DBGC_EFI_PROTOCOL

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

Definition at line 343 of file efi.h.

◆ DBGC_EFI_PROTOCOLS

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

Definition at line 345 of file efi.h.

◆ DBGC2_EFI_OPENER

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

Definition at line 348 of file efi.h.

◆ DBGC2_EFI_OPENERS

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

Definition at line 350 of file efi.h.

◆ DBGC2_EFI_PROTOCOL

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

Definition at line 352 of file efi.h.

◆ DBGC2_EFI_PROTOCOLS

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

Definition at line 354 of file efi.h.

◆ DBGCP_EFI_OPENER

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

Definition at line 357 of file efi.h.

◆ DBGCP_EFI_OPENERS

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

Definition at line 359 of file efi.h.

◆ DBGCP_EFI_PROTOCOL

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

Definition at line 361 of file efi.h.

◆ DBGCP_EFI_PROTOCOLS

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

Definition at line 363 of file efi.h.

◆ EFI_INTF_OP

#define EFI_INTF_OP UNUSED_INTF_OP

Definition at line 370 of file efi.h.

◆ efi_test

#define efi_test	(	handle,
		protocol
	)	efi_open_untyped ( (handle), (protocol), NULL )

Test protocol existence.

Parameters

handle	EFI handle
protocol	Protocol GUID

Return values

rc	Return status code

Definition at line 429 of file efi.h.

◆ efi_open

#define efi_open	(	handle,
		protocol,
		interface
	)

Value:

( {                     \
        typeof ( *(interface) ) check_ptr_ptr = NULL;                   \
        efi_open_untyped ( (handle), (protocol),                        \
                           ( ( void ) check_ptr_ptr,                    \
                             ( void ** ) (interface) ) );               \
        } )

Open protocol for ephemeral use.

Parameters

handle	EFI handle
protocol	Protocol GUID
interface	Protocol interface pointer to fill in

Return values

rc	Return status code

Definition at line 440 of file efi.h.

◆ efi_open_unsafe

#define efi_open_unsafe	(	handle,
		protocol,
		interface
	)

Value:

( {             \
        typeof ( *(interface) ) check_ptr_ptr = NULL;                   \
        efi_open_unsafe_untyped ( (handle), (protocol),                 \
                                  ( ( void ) check_ptr_ptr,             \
                                    ( void ** ) (interface) ) );        \
        } )

Open protocol for unsafe persistent use.

Parameters

handle	EFI handle
protocol	Protocol GUID
interface	Protocol interface pointer to fill in

Return values

rc	Return status code

Definition at line 455 of file efi.h.

◆ efi_open_by_driver

#define efi_open_by_driver	(	handle,
		protocol,
		interface
	)

Value:

( {             \
        typeof ( *(interface) ) check_ptr_ptr = NULL;                   \
        efi_open_by_driver_untyped ( (handle), (protocol),              \
                                     ( ( void ) check_ptr_ptr,          \
                                       ( void ** ) (interface) ) );     \
        } )

Open protocol for persistent use by a driver.

Parameters

handle	EFI handle
protocol	Protocol GUID
interface	Protocol interface pointer to fill in

Return values

rc	Return status code

Definition at line 470 of file efi.h.

◆ efi_open_by_child

#define efi_open_by_child	(	handle,
		protocol,
		child,
		interface
	)

Value:

( {     \
        typeof ( *(interface) ) check_ptr_ptr = NULL;                   \
        efi_open_by_child_untyped ( (handle), (protocol), (child),      \
                                    ( ( void ) check_ptr_ptr,           \
                                      ( void ** ) (interface) ) );      \
        } )

Open protocol for persistent use by a child controller.

Parameters

handle	EFI handle
protocol	Protocol GUID
child	Child controller handle
interface	Protocol interface pointer to fill in

Return values

rc	Return status code

Definition at line 486 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 702 of file efi_guid.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_driver_exclude(), efi_file_get_info(), efi_file_path_uninstall(), efi_file_set_info(), efi_find_table(), 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_install_table(), 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(), efisig_find(), efivars_fetch(), efivars_find(), and snpnet_supported().

◆ efi_tpl_name()

const char* efi_tpl_name ( EFI_TPL tpl )

Name EFI TPL.

Parameters

tpl	Task priority level

Return values

text	Task priority level as text

Definition at line 55 of file efi_debug.c.

                                                                    {
         static char buf[ 19 /* "0xXXXXXXXXXXXXXXXX" + NUL */ ];
 
         switch ( tpl ) {
         case TPL_APPLICATION:           return "Application";
         case TPL_CALLBACK:              return "Callback";
         case TPL_NOTIFY:                return "Notify";
         case TPL_HIGH_LEVEL:            return "HighLevel";
         default:
                 snprintf ( buf, sizeof ( buf ), "%#lx",
                            ( unsigned long ) tpl );
                 return buf;
         }
 }

References snprintf(), TPL_APPLICATION, TPL_CALLBACK, TPL_HIGH_LEVEL, and TPL_NOTIFY.

Referenced by efi_connect(), efi_create_event_ex_wrapper(), efi_create_event_wrapper(), efi_disconnect(), efi_raise_tpl_wrapper(), and efi_restore_tpl_wrapper().

◆ 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 77 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 102 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 247 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_init_application(), 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 652 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;
         int rc;
 
         /* 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 */
                 if ( ( rc = efi_open ( handle, type->protocol,
                                        &interface ) ) != 0 ) {
                         DBG2 ( ">" );
                         continue;
                 }
 
                 /* Try to get name from this protocol */
                 DBG2 ( "-" );
                 name = type->name ( interface );
                 DBG2 ( "%c>", ( name ? ( name[0] ? 'Y' : 'E' ) : 'N' ) );
 
                 /* 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, count, DBG2, efi_guid_ntoa(), efi_handle_name_types, efi_open, efi_systab, EFI_BOOT_SERVICES::FreePool, handle, name, NULL, EFI_BOOT_SERVICES::ProtocolsPerHandle, rc, 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(), efi_connect_controller_wrapper(), efi_device_info(), efi_device_info_pci(), efi_disconnect(), efi_disconnect_controller_wrapper(), efi_driver_connect(), efi_driver_exclude(), 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_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_exclude(), efipci_info(), efipci_root_open(), efipci_start(), mnpnet_start(), mnptemp_create(), nii_exclude(), nii_start(), snpnet_exclude(), snpnet_insomniac_patch(), snpnet_insomniac_restore(), snpnet_is_insomniac(), snpnet_start(), snpnet_stop(), snpnet_supported(), usbio_bulk_in_poll(), usbio_bulk_out_poll(), usbio_config(), usbio_control_poll(), usbio_endpoint_open(), usbio_exclude(), 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 124 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 145 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 185 of file efi_debug.c.

                                                                 {
         VOID *interface;
         int rc;
 
         /* Get protocol instance */
         if ( ( rc = efi_open ( handle, protocol, &interface ) ) != 0 ) {
                 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 dbg_efi_openers(), efi_guid_ntoa(), efi_handle_name(), efi_open, handle, 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 208 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 114 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 355 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 383 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 154 of file efi_init.c.

                                                  {
         EFI_BOOT_SERVICES *bs;
         struct efi_protocol *prot;
         struct efi_config_table *tab;
         EFI_DEVICE_PATH_PROTOCOL *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
          *
          * We assume that our loaded image protocol will not be
          * uninstalled while our image code is still running.
          */
         if ( ( rc = efi_open_unsafe ( image_handle,
                                       &efi_loaded_image_protocol_guid,
                                       &efi_loaded_image ) ) != 0 ) {
                 DBGC ( systab, "EFI could not get loaded image protocol: %s",
                        strerror ( rc ) );
                 efirc = EFIRC ( rc );
                 goto err_no_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 ( ( rc = efi_open ( efi_loaded_image->DeviceHandle,
                                &efi_device_path_protocol_guid,
                                &device_path ) ) != 0 ) {
                 DBGC ( systab, "EFI could not get loaded image's device path: "
                        "%s", strerror ( rc ) );
                 efirc = EFIRC ( 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, efi_open_unsafe, 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_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 382 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 398 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().

◆ efi_open_untyped()

int efi_open_untyped	(	EFI_HANDLE	handle,
		EFI_GUID *	protocol,
		void **	interface
	)

Open (or test) protocol for ephemeral use.

Parameters

handle	EFI handle
protocol	Protocol GUID
interface	Protocol interface pointer to fill in (or NULL to test)

Return values

rc	Return status code

Definition at line 96 of file efi_open.c.

                                           {
         EFI_BOOT_SERVICES *bs = efi_systab->BootServices;
         EFI_HANDLE agent = efi_image_handle;
         EFI_HANDLE controller;
         unsigned int attributes;
         EFI_STATUS efirc;
         int rc;
 
         /* Sanity checks */
         assert ( handle != NULL );
         assert ( protocol != NULL );
 
         /* Open protocol
          *
          * We set ControllerHandle to NULL to avoid collisions with
          * other open types.
          */
         controller = NULL;
         attributes = ( interface ? EFI_OPEN_PROTOCOL_GET_PROTOCOL :
                        EFI_OPEN_PROTOCOL_TEST_PROTOCOL );
         if ( ( efirc = bs->OpenProtocol ( handle, protocol, interface, agent,
                                           controller, attributes ) ) != 0 ) {
                 rc = -EEFI ( efirc );
                 if ( interface )
                         *interface = NULL;
                 return rc;
         }
 
         /* Close protocol immediately
          *
          * While it may seem prima facie unsafe to use a protocol
          * after closing it, UEFI doesn't actually give us any safety
          * even while the protocol is nominally open.  Opening a
          * protocol with EFI_OPEN_PROTOCOL_GET_PROTOCOL attributes
          * does not in any way ensure that the interface pointer
          * remains valid: there are no locks or notifications
          * associated with these "opens".
          *
          * The only way to obtain a (partially) guaranteed persistent
          * interface pointer is to open the protocol with the
          * EFI_OPEN_PROTOCOL_BY_DRIVER attributes.  This is not
          * possible in the general case, since UEFI permits only a
          * single image at a time to have the protocol opened with
          * these attributes.
          *
          * We can therefore obtain at best an ephemeral interface
          * pointer: one that is guaranteed to remain valid only for as
          * long as we do not relinquish the thread of control.
          *
          * (Since UEFI permits calls to UninstallProtocolInterface()
          * at levels up to and including TPL_NOTIFY, this means that
          * we technically cannot rely on the pointer remaining valid
          * unless the caller is itself running at TPL_NOTIFY.  This is
          * clearly impractical, and large portions of the EDK2
          * codebase presume that using EFI_OPEN_PROTOCOL_GET_PROTOCOL
          * is safe at lower TPLs.)
          *
          * Closing is not strictly necessary for protocols opened
          * ephemerally (i.e. using EFI_OPEN_PROTOCOL_GET_PROTOCOL or
          * EFI_OPEN_PROTOCOL_TEST_PROTOCOL), but avoids polluting the
          * protocol open information tables with stale data.
          *
          * Closing immediately also simplifies the callers' code
          * paths, since they do not need to worry about closing the
          * protocol.
          *
          * The overall effect is equivalent to using HandleProtocol(),
          * but without the associated pollution of the protocol open
          * information tables, and with improved traceability.
          */
         bs->CloseProtocol ( handle, protocol, agent, controller );
 
         return 0;
 }

References assert(), EFI_SYSTEM_TABLE::BootServices, EFI_BOOT_SERVICES::CloseProtocol, controller, EEFI, efi_image_handle, EFI_OPEN_PROTOCOL_GET_PROTOCOL, EFI_OPEN_PROTOCOL_TEST_PROTOCOL, efi_systab, handle, if(), NULL, protocol, and rc.

◆ efi_open_unsafe_untyped()

int efi_open_unsafe_untyped	(	EFI_HANDLE	handle,
		EFI_GUID *	protocol,
		void **	interface
	)

Open protocol for unsafe persistent use.

Parameters

handle	EFI handle
protocol	Protocol GUID
interface	Protocol interface pointer to fill in

Return values

rc	Return status code

Definition at line 180 of file efi_open.c.

                                                  {
         EFI_BOOT_SERVICES *bs = efi_systab->BootServices;
         EFI_HANDLE agent = efi_image_handle;
         EFI_HANDLE controller;
         unsigned int attributes;
         EFI_STATUS efirc;
         int rc;
 
         /* Sanity checks */
         assert ( handle != NULL );
         assert ( protocol != NULL );
         assert ( interface != NULL );
 
         /* Open protocol
          *
          * We set ControllerHandle equal to AgentHandle to avoid
          * collisions with other open types.
          */
         controller = agent;
         attributes = EFI_OPEN_PROTOCOL_GET_PROTOCOL;
         if ( ( efirc = bs->OpenProtocol ( handle, protocol, interface, agent,
                                           controller, attributes ) ) != 0 ) {
                 rc = -EEFI ( efirc );
                 *interface = NULL;
                 return rc;
         }
 
         return 0;
 }

References assert(), EFI_SYSTEM_TABLE::BootServices, controller, EEFI, efi_image_handle, EFI_OPEN_PROTOCOL_GET_PROTOCOL, efi_systab, handle, NULL, EFI_BOOT_SERVICES::OpenProtocol, protocol, and rc.

◆ efi_close_unsafe()

void efi_close_unsafe	(	EFI_HANDLE	handle,
		EFI_GUID *	protocol
	)

Close protocol opened for unsafe persistent use.

Parameters

handle	EFI handle
protocol	Protocol GUID
child	Child controller handle

Definition at line 218 of file efi_open.c.

                                                                 {
         EFI_BOOT_SERVICES *bs = efi_systab->BootServices;
         EFI_HANDLE agent = efi_image_handle;
         EFI_HANDLE controller;
 
         /* Sanity checks */
         assert ( handle != NULL );
         assert ( protocol != NULL );
 
         /* Close protocol */
         controller = agent;
         bs->CloseProtocol ( handle, protocol, agent, controller );
 }

References assert(), EFI_SYSTEM_TABLE::BootServices, EFI_BOOT_SERVICES::CloseProtocol, controller, efi_image_handle, efi_systab, handle, NULL, and protocol.

Referenced by efi_bofm_start(), nii_pci_close(), and nii_pci_open().

◆ efi_open_by_driver_untyped()

int efi_open_by_driver_untyped	(	EFI_HANDLE	handle,
		EFI_GUID *	protocol,
		void **	interface
	)

Open protocol for persistent use by a driver.

Parameters

handle	EFI handle
protocol	Protocol GUID
interface	Protocol interface pointer to fill in

Return values

rc	Return status code

Definition at line 240 of file efi_open.c.

                                                     {
         EFI_BOOT_SERVICES *bs = efi_systab->BootServices;
         EFI_HANDLE agent = efi_image_handle;
         EFI_HANDLE controller;
         unsigned int attributes;
         EFI_STATUS efirc;
         int rc;
 
         /* Sanity checks */
         assert ( handle != NULL );
         assert ( protocol != NULL );
         assert ( interface != NULL );
 
         /* Open protocol
          *
          * We set ControllerHandle equal to Handle to avoid collisions
          * with other open types.
          */
         controller = handle;
         attributes = ( EFI_OPEN_PROTOCOL_BY_DRIVER |
                        EFI_OPEN_PROTOCOL_EXCLUSIVE );
         if ( ( efirc = bs->OpenProtocol ( handle, protocol, interface, agent,
                                           controller, attributes ) ) != 0 ) {
                 rc = -EEFI ( efirc );
                 *interface = NULL;
                 return rc;
         }
 
         return 0;
 }

References assert(), EFI_SYSTEM_TABLE::BootServices, controller, EEFI, efi_image_handle, EFI_OPEN_PROTOCOL_BY_DRIVER, EFI_OPEN_PROTOCOL_EXCLUSIVE, efi_systab, handle, NULL, EFI_BOOT_SERVICES::OpenProtocol, protocol, and rc.

◆ efi_close_by_driver()

void efi_close_by_driver	(	EFI_HANDLE	handle,
		EFI_GUID *	protocol
	)

Close protocol opened for persistent use by a driver.

Parameters

handle	EFI handle
protocol	Protocol GUID

Definition at line 278 of file efi_open.c.

                                                                    {
         EFI_BOOT_SERVICES *bs = efi_systab->BootServices;
         EFI_HANDLE agent = efi_image_handle;
         EFI_HANDLE controller;
 
         /* Sanity checks */
         assert ( handle != NULL );
         assert ( protocol != NULL );
 
         /* Close protocol */
         controller = handle;
         bs->CloseProtocol ( handle, protocol, agent, controller );
 }

References assert(), EFI_SYSTEM_TABLE::BootServices, EFI_BOOT_SERVICES::CloseProtocol, controller, efi_image_handle, efi_systab, handle, NULL, and protocol.

Referenced by efi_file_install(), efi_file_uninstall(), efi_snp_probe(), efi_snp_remove(), efipci_start(), efipci_stop(), mnpnet_start(), mnpnet_stop(), nii_start(), nii_stop(), snpnet_start(), snpnet_stop(), usbio_close(), usbio_start(), and usbio_stop().

◆ efi_open_by_child_untyped()

int efi_open_by_child_untyped	(	EFI_HANDLE	handle,
		EFI_GUID *	protocol,
		EFI_HANDLE	child,
		void **	interface
	)

Open protocol for persistent use by a child controller.

Parameters

handle	EFI handle
protocol	Protocol GUID
child	Child controller handle
interface	Protocol interface pointer to fill in

Return values

rc	Return status code

Definition at line 301 of file efi_open.c.

                                                                      {
         EFI_BOOT_SERVICES *bs = efi_systab->BootServices;
         EFI_HANDLE agent = efi_image_handle;
         EFI_HANDLE controller;
         unsigned int attributes;
         EFI_STATUS efirc;
         int rc;
 
         /* Sanity checks */
         assert ( handle != NULL );
         assert ( protocol != NULL );
         assert ( child != NULL );
         assert ( interface != NULL );
 
         /* Open protocol
          *
          * We set ControllerHandle to a non-NULL value distinct from
          * both Handle and AgentHandle to avoid collisions with other
          * open types.
          */
         controller = child;
         assert ( controller != handle );
         assert ( controller != agent );
         attributes = EFI_OPEN_PROTOCOL_BY_CHILD_CONTROLLER;
         if ( ( efirc = bs->OpenProtocol ( handle, protocol, interface, agent,
                                           controller, attributes ) ) != 0 ) {
                 rc = -EEFI ( efirc );
                 *interface = NULL;
                 return rc;
         }
 
         return 0;
 }

References assert(), EFI_SYSTEM_TABLE::BootServices, controller, EEFI, efi_image_handle, EFI_OPEN_PROTOCOL_BY_CHILD_CONTROLLER, efi_systab, handle, NULL, EFI_BOOT_SERVICES::OpenProtocol, protocol, and rc.

◆ efi_close_by_child()

void efi_close_by_child	(	EFI_HANDLE	handle,
		EFI_GUID *	protocol,
		EFI_HANDLE	child
	)

Close protocol opened for persistent use by a child controller.

Parameters

handle	EFI handle
protocol	Protocol GUID
child	Child controller handle

Definition at line 343 of file efi_open.c.

                                              {
         EFI_BOOT_SERVICES *bs = efi_systab->BootServices;
         EFI_HANDLE agent = efi_image_handle;
         EFI_HANDLE controller;
 
         /* Sanity checks */
         assert ( handle != NULL );
         assert ( protocol != NULL );
         assert ( child != NULL );
 
         /* Close protocol */
         controller = child;
         assert ( controller != handle );
         assert ( controller != agent );
         bs->CloseProtocol ( handle, protocol, agent, controller );
 }

References assert(), EFI_SYSTEM_TABLE::BootServices, EFI_BOOT_SERVICES::CloseProtocol, controller, efi_image_handle, efi_systab, handle, NULL, and protocol.

Referenced by efi_child_del().

◆ efi_connect()

int efi_connect	(	EFI_HANDLE	device,
		EFI_HANDLE	driver
	)

Connect UEFI driver(s)

Parameters

device	EFI device handle
driver	EFI driver handle, or NULL

Return values

rc	Return status code

Definition at line 57 of file efi_connect.c.

                                                          {
         EFI_BOOT_SERVICES *bs = efi_systab->BootServices;
         EFI_HANDLE driverlist[2] = { driver, NULL };
         EFI_HANDLE *drivers = ( driver ? driverlist : NULL );
         EFI_STATUS efirc;
         int rc;
 
         /* Attempt connection at external TPL */
         DBGC ( device, "EFI %s connecting ", efi_handle_name ( device ) );
         DBGC ( device, "%s driver at %s TPL\n",
                ( driver ? efi_handle_name ( driver ) : "any" ),
                efi_tpl_name ( efi_external_tpl ) );
         bs->RestoreTPL ( efi_external_tpl );
         efirc = bs->ConnectController ( device, drivers, NULL, TRUE );
         bs->RaiseTPL ( efi_internal_tpl );
         if ( efirc != 0 ) {
                 rc = -EEFI_CONNECT ( efirc );
                 DBGC ( device, "EFI %s could not connect: %s\n",
                        efi_handle_name ( device ), strerror ( rc ) );
                 return rc;
         }
 
         return 0;
 }

References EFI_SYSTEM_TABLE::BootServices, EFI_BOOT_SERVICES::ConnectController, DBGC, EEFI_CONNECT, efi_external_tpl, efi_handle_name(), efi_internal_tpl, efi_systab, efi_tpl_name(), NULL, EFI_BOOT_SERVICES::RaiseTPL, rc, EFI_BOOT_SERVICES::RestoreTPL, strerror(), and TRUE.

Referenced by efi_block_connect(), efi_driver_connect(), efi_driver_reconnect(), and efi_usb_probe().

◆ efi_disconnect()

int efi_disconnect	(	EFI_HANDLE	device,
		EFI_HANDLE	driver
	)

Disconnect UEFI driver(s)

Parameters

device	EFI device handle
driver	EFI driver handle, or NULL

Return values

rc	Return status code

Definition at line 89 of file efi_connect.c.

                                                             {
         EFI_BOOT_SERVICES *bs = efi_systab->BootServices;
         EFI_STATUS efirc;
         int rc;
 
         /* Attempt disconnection at external TPL */
         DBGC ( device, "EFI %s disconnecting ", efi_handle_name ( device ) );
         DBGC ( device, "%s driver at %s TPL\n",
                ( driver ? efi_handle_name ( driver ) : "any" ),
                efi_tpl_name ( efi_external_tpl ) );
         bs->RestoreTPL ( efi_external_tpl );
         efirc = bs->DisconnectController ( device, driver, NULL );
         bs->RaiseTPL ( efi_internal_tpl );
         if ( ( efirc != 0 ) && ( efirc != EFI_NOT_FOUND ) ) {
                 rc = -EEFI ( efirc );
                 DBGC ( device, "EFI %s could not disconnect: %s\n",
                        efi_handle_name ( device ), strerror ( rc ) );
                 return rc;
         }
 
         return 0;
 }

References EFI_SYSTEM_TABLE::BootServices, DBGC, EFI_BOOT_SERVICES::DisconnectController, EEFI, efi_external_tpl, efi_handle_name(), efi_internal_tpl, EFI_NOT_FOUND, efi_systab, efi_tpl_name(), NULL, EFI_BOOT_SERVICES::RaiseTPL, rc, EFI_BOOT_SERVICES::RestoreTPL, and strerror().

Referenced by efi_driver_disconnect(), efi_driver_exclude(), efi_usb_uninstall(), and efi_veto_disconnect().

Variable Documentation

◆ efi_absolute_pointer_protocol_guid

EFI_GUID efi_absolute_pointer_protocol_guid

Absolute pointer protocol GUID.

Definition at line 113 of file efi_guid.c.

◆ efi_acpi_table_protocol_guid

EFI_GUID efi_acpi_table_protocol_guid

ACPI table protocol GUID.

Definition at line 117 of file efi_guid.c.

◆ efi_adapter_information_protocol_guid

EFI_GUID efi_adapter_information_protocol_guid

Adapter information protocol GUID.

Definition at line 121 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 125 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 129 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 133 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 137 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 141 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 145 of file efi_guid.c.

◆ efi_component_name_protocol_guid

EFI_GUID efi_component_name_protocol_guid

Component name protocol GUID.

Definition at line 149 of file efi_guid.c.

Referenced by efi_binding_name(), and efi_veto_find().

◆ efi_component_name2_protocol_guid

EFI_GUID efi_component_name2_protocol_guid

Component name 2 protocol GUID.

Definition at line 153 of file efi_guid.c.

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

◆ efi_console_control_protocol_guid

EFI_GUID efi_console_control_protocol_guid

Console control protocol GUID.

Definition at line 157 of file efi_guid.c.

◆ efi_device_path_protocol_guid

EFI_GUID efi_device_path_protocol_guid

Device path protocol GUID.

Definition at line 161 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 165 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 169 of file efi_guid.c.

◆ efi_dhcp6_protocol_guid

EFI_GUID efi_dhcp6_protocol_guid

DHCPv6 protocol GUID.

Definition at line 173 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 177 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 181 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 185 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 189 of file efi_guid.c.

◆ efi_dns6_protocol_guid

EFI_GUID efi_dns6_protocol_guid

DNSv6 protocol GUID.

Definition at line 193 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 197 of file efi_guid.c.

◆ efi_driver_binding_protocol_guid

EFI_GUID efi_driver_binding_protocol_guid

Driver binding protocol GUID.

Definition at line 201 of file efi_guid.c.

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

◆ efi_eap_configuration_protocol_guid

EFI_GUID efi_eap_configuration_protocol_guid

EAP configuration protocol GUID.

Definition at line 205 of file efi_guid.c.

◆ efi_graphics_output_protocol_guid

EFI_GUID efi_graphics_output_protocol_guid

Graphics output protocol GUID.

Definition at line 209 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 213 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 217 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 221 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 225 of file efi_guid.c.

◆ efi_ip4_protocol_guid

EFI_GUID efi_ip4_protocol_guid

IPv4 protocol GUID.

Definition at line 229 of file efi_guid.c.

◆ efi_ip4_config_protocol_guid

EFI_GUID efi_ip4_config_protocol_guid

IPv4 configuration protocol GUID.

Definition at line 233 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 237 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 241 of file efi_guid.c.

◆ efi_ip6_protocol_guid

EFI_GUID efi_ip6_protocol_guid

IPv6 protocol GUID.

Definition at line 245 of file efi_guid.c.

◆ efi_ip6_config_protocol_guid

EFI_GUID efi_ip6_config_protocol_guid

IPv6 configuration protocol GUID.

Definition at line 249 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 253 of file efi_guid.c.

◆ efi_load_file_protocol_guid

EFI_GUID efi_load_file_protocol_guid

Load file protocol GUID.

Definition at line 257 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 261 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 265 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 269 of file efi_guid.c.

◆ efi_managed_network_protocol_guid

EFI_GUID efi_managed_network_protocol_guid

Managed network protocol GUID.

Definition at line 273 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 277 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 281 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 285 of file efi_guid.c.

◆ efi_mtftp6_protocol_guid

EFI_GUID efi_mtftp6_protocol_guid

MTFTPv6 protocol GUID.

Definition at line 289 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 293 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 297 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 301 of file efi_guid.c.

Referenced by efi_snp_probe(), efi_snp_remove(), nii_exclude(), 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 305 of file efi_guid.c.

Referenced by efi_bofm_start(), efi_device_info_pci(), efipci_exclude(), efipci_info(), efipci_start(), efipci_stop(), 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 309 of file efi_guid.c.

Referenced by efipci_discover_any(), efipci_discover_one(), 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 313 of file efi_guid.c.

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

◆ efi_rng_protocol_guid

EFI_GUID efi_rng_protocol_guid

Random number generator protocol GUID.

Definition at line 317 of file efi_guid.c.

◆ efi_serial_io_protocol_guid

EFI_GUID efi_serial_io_protocol_guid

Serial I/O protocol GUID.

Definition at line 321 of file efi_guid.c.

◆ efi_shim_lock_protocol_guid

EFI_GUID efi_shim_lock_protocol_guid

Shim lock protocol GUID.

Definition at line 325 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 329 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 333 of file efi_guid.c.

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

◆ efi_simple_pointer_protocol_guid

EFI_GUID efi_simple_pointer_protocol_guid

Simple pointer protocol GUID.

Definition at line 337 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 341 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 345 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 349 of file efi_guid.c.

◆ efi_supplicant_protocol_guid

EFI_GUID efi_supplicant_protocol_guid

Supplicant protocol GUID.

Definition at line 353 of file efi_guid.c.

◆ efi_tcg_protocol_guid

EFI_GUID efi_tcg_protocol_guid

TCG protocol GUID.

Definition at line 357 of file efi_guid.c.

◆ efi_tcg2_protocol_guid

EFI_GUID efi_tcg2_protocol_guid

TCG2 protocol GUID.

Definition at line 361 of file efi_guid.c.

◆ efi_tcp4_protocol_guid

EFI_GUID efi_tcp4_protocol_guid

TCPv4 protocol GUID.

Definition at line 365 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 369 of file efi_guid.c.

◆ efi_tcp6_protocol_guid

EFI_GUID efi_tcp6_protocol_guid

TCPv6 protocol GUID.

Definition at line 373 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 377 of file efi_guid.c.

◆ efi_tree_protocol_guid

EFI_GUID efi_tree_protocol_guid

TrEE protocol GUID.

Definition at line 381 of file efi_guid.c.

◆ efi_udp4_protocol_guid

EFI_GUID efi_udp4_protocol_guid

UDPv4 protocol GUID.

Definition at line 385 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 389 of file efi_guid.c.

◆ efi_udp6_protocol_guid

EFI_GUID efi_udp6_protocol_guid

UDPv6 protocol GUID.

Definition at line 393 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 397 of file efi_guid.c.

◆ efi_uga_draw_protocol_guid

EFI_GUID efi_uga_draw_protocol_guid

UGA draw protocol GUID.

Definition at line 401 of file efi_guid.c.

◆ efi_unicode_collation_protocol_guid

EFI_GUID efi_unicode_collation_protocol_guid

Unicode collation protocol GUID.

Definition at line 405 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 409 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 413 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 417 of file efi_guid.c.

Referenced by efi_usb_install(), efi_usb_uninstall(), usbio_close(), usbio_exclude(), 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 421 of file efi_guid.c.

Referenced by efi_snp_probe(), and efi_snp_remove().

◆ efi_wifi2_protocol_guid

EFI_GUID efi_wifi2_protocol_guid

WiFi 2 protocol GUID.

Definition at line 425 of file efi_guid.c.

Referenced by chained_supported(), snpnet_is_insomniac(), and snpnet_supported().

◆ efi_acpi_10_table_guid

EFI_GUID efi_acpi_10_table_guid

ACPI 1.0 table GUID.

Definition at line 429 of file efi_guid.c.

◆ efi_acpi_20_table_guid

EFI_GUID efi_acpi_20_table_guid

ACPI 2.0 table GUID.

Definition at line 433 of file efi_guid.c.

◆ efi_fdt_table_guid

EFI_GUID efi_fdt_table_guid

FDT table GUID.

Definition at line 437 of file efi_guid.c.

◆ efi_smbios_table_guid

EFI_GUID efi_smbios_table_guid

SMBIOS table GUID.

Definition at line 441 of file efi_guid.c.

◆ efi_smbios2_table_guid

EFI_GUID efi_smbios2_table_guid

◆ efi_cert_x509_guid

EFI_GUID efi_cert_x509_guid

X.509 certificate GUID.

Definition at line 448 of file efi_guid.c.

◆ efi_file_info_id

EFI_GUID efi_file_info_id

File information GUID.

Definition at line 451 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 454 of file efi_guid.c.

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

◆ efi_global_variable

EFI_GUID efi_global_variable

Global variable GUID.

Definition at line 457 of file efi_guid.c.

Referenced by efi_boot_path(), efi_current_boot_path(), and efi_reboot().

◆ efi_tls_ca_certificate_guid

EFI_GUID efi_tls_ca_certificate_guid

TLS CA certificate variable GUID.

Definition at line 460 of file efi_guid.c.

Referenced by efi_cacert_all().

◆ efi_image_handle

EFI_HANDLE efi_image_handle

Image handle passed to entry point.

Definition at line 35 of file efi_init.c.

Referenced by __stack_chk_fail(), efi_block_exec(), efi_close_by_child(), efi_close_by_driver(), efi_close_unsafe(), efi_driver_install(), efi_driver_uninstall(), efi_image_exec(), efi_image_probe(), efi_init(), efi_open_by_child_untyped(), efi_open_by_driver_untyped(), efi_open_unsafe_untyped(), and efi_open_untyped().

◆ efi_loaded_image

EFI_LOADED_IMAGE_PROTOCOL* efi_loaded_image

Loaded image protocol for this image.

Definition at line 38 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 41 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(), dbg_efi_openers(), dbg_efi_protocols(), efi_allocate_pages_wrapper(), efi_allocate_pool_wrapper(), efi_block_boot(), efi_block_exec(), efi_block_hook(), efi_block_scan(), efi_block_unhook(), efi_bofm_start(), efi_bofm_supported(), efi_boot_path(), efi_cacert_all(), efi_check_event_wrapper(), efi_close_by_child(), efi_close_by_driver(), efi_close_event_wrapper(), efi_close_protocol_wrapper(), efi_close_unsafe(), efi_conin_name(), efi_connect(), efi_connect_controller_wrapper(), efi_conout_name(), efi_console_init(), efi_create_event_ex_wrapper(), efi_create_event_wrapper(), efi_current_boot_path(), efi_currticks(), efi_devpath_text(), efi_disconnect(), efi_disconnect_controller_wrapper(), efi_download_install(), efi_download_uninstall(), efi_driver_exclude(), efi_driver_handles(), efi_driver_install(), efi_driver_uninstall(), efi_entropy_disable(), efi_entropy_enable(), efi_entropy_tick(), efi_exit_boot_services_wrapper(), efi_exit_wrapper(), efi_fdt_init(), 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_install_table(), efi_iskey(), efi_load_image_wrapper(), 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_by_child_untyped(), efi_open_by_driver_untyped(), efi_open_protocol_information_wrapper(), efi_open_protocol_wrapper(), efi_open_unsafe_untyped(), efi_open_untyped(), efi_poweroff(), efi_prescroll(), 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_set_timer_wrapper(), efi_set_watchdog_timer_wrapper(), efi_shim_get_memory_map(), 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_uninstall_table(), efi_unload(), efi_unload_image_wrapper(), efi_unwrap(), 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_uninstall(), efi_veto(), efi_veto_close(), efi_veto_close_handle(), efi_veto_close_protocol(), efi_veto_disconnect(), efi_veto_uninstall(), efi_veto_unload(), efi_vlan_find(), efi_wait_for_event_wrapper(), efi_watchdog_expired(), efi_watchdog_shutdown(), efi_wrap_bs(), efi_wrap_systab(), efifb_draw(), efifb_init(), efifb_select_mode(), efipci_discover_any(), efivars_fetch(), efivars_find(), mnpnet_close(), mnpnet_open(), mnpnet_poll_rx(), nii_block(), nii_issue_cpb_db(), nii_pci_open(), and usbio_open().

◆ efi_internal_tpl

EFI_TPL efi_internal_tpl

Internal task priority level.

Definition at line 53 of file efi_init.c.

Referenced by efi_connect(), efi_currticks(), efi_disconnect(), 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 56 of file efi_init.c.

Referenced by efi_connect(), efi_currticks(), efi_disconnect(), 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 59 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 65 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

◆ EFI_EVENT

◆ _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

◆ efi_test

◆ efi_open

◆ efi_open_unsafe

◆ efi_open_by_driver

◆ efi_open_by_child

Function Documentation

◆ FILE_LICENCE()

◆ efi_guid_ntoa()

◆ efi_tpl_name()

◆ 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()

◆ efi_open_untyped()

◆ efi_open_unsafe_untyped()

◆ efi_close_unsafe()

◆ efi_open_by_driver_untyped()

◆ efi_close_by_driver()

◆ efi_open_by_child_untyped()

◆ efi_close_by_child()

◆ efi_connect()

◆ efi_disconnect()

Variable Documentation

◆ efi_absolute_pointer_protocol_guid

◆ efi_acpi_table_protocol_guid

◆ efi_adapter_information_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