efi_driver.h File Reference

EFI driver interface. More...

#include <ipxe/device.h>
#include <ipxe/tables.h>
#include <ipxe/efi/efi.h>
#include <ipxe/efi/Protocol/DevicePath.h>

Go to the source code of this file.

Data Structures
struct	efi_device
	An EFI device. More...
struct	efi_driver
	An EFI driver. More...

Macros
#define	EFI_DRIVERS   __table ( struct efi_driver, "efi_drivers" )
	EFI driver table. More...
#define	__efi_driver(order)   __table_entry ( EFI_DRIVERS, order )
	Declare an EFI driver. More...
#define	EFI_DRIVER_EARLY   01
	Early drivers. More...
#define	EFI_DRIVER_NORMAL   02
	Normal drivers. More...
#define	EFI_DRIVER_LATE   03
	Late drivers. More...

Functions
	FILE_LICENCE (GPL2_OR_LATER_OR_UBDL)
static void	efidev_set_drvdata (struct efi_device *efidev, void *priv)
	Set EFI driver-private data. More...
static void *	efidev_get_drvdata (struct efi_device *efidev)
	Get EFI driver-private data. More...
struct efi_device *	efidev_alloc (EFI_HANDLE device)
	Allocate new EFI device. More...
void	efidev_free (struct efi_device *efidev)
	Free EFI device. More...
struct efi_device *	efidev_parent (struct device *dev)
	Get parent EFI device. More...
int	efi_driver_install (void)
	Install EFI driver. More...
void	efi_driver_uninstall (void)
	Uninstall EFI driver. More...
int	efi_driver_connect_all (void)
	Connect EFI driver to all possible devices. More...
void	efi_driver_disconnect_all (void)
	Disconnect EFI driver from all possible devices. More...
void	efi_driver_reconnect_all (void)
	Reconnect original EFI drivers to all possible devices. More...

Detailed Description

EFI driver interface.

Definition in file efi_driver.h.

Macro Definition Documentation

EFI_DRIVERS

#define EFI_DRIVERS   __table ( struct efi_driver, "efi_drivers" )

EFI driver table.

Definition at line 59 of file efi_driver.h.

__efi_driver

#define __efi_driver

(

order

)

__table_entry ( EFI_DRIVERS, order )

Declare an EFI driver.

Definition at line 62 of file efi_driver.h.

EFI_DRIVER_EARLY

#define EFI_DRIVER_EARLY   01

Early drivers.

Definition at line 64 of file efi_driver.h.

EFI_DRIVER_NORMAL

#define EFI_DRIVER_NORMAL   02

Normal drivers.

Definition at line 65 of file efi_driver.h.

EFI_DRIVER_LATE

#define EFI_DRIVER_LATE   03

Late drivers.

Definition at line 66 of file efi_driver.h.

Function Documentation

FILE_LICENCE()

FILE_LICENCE

(

GPL2_OR_LATER_OR_UBDL

)

efidev_set_drvdata()

static void efidev_set_drvdata ( struct efi_device *  efidev, void *  priv  )

inlinestatic

Set EFI driver-private data.

Parameters

efidev	EFI device
priv	Private data

Definition at line 74 of file efi_driver.h.

                                                     {
        efidev->priv = priv;
}

References efi_device::priv, and priv.

Referenced by efipci_start(), mnpnet_start(), nii_start(), snpnet_start(), and usbio_start().

efidev_get_drvdata()

static void* efidev_get_drvdata ( struct efi_device *  efidev )

inlinestatic

Get EFI driver-private data.

Parameters

efidev

EFI device

Return values

priv	Private data

Definition at line 85 of file efi_driver.h.

                                                                      {
        return efidev->priv;
}

References efi_device::priv.

Referenced by efipci_stop(), mnpnet_stop(), mnptemp_create(), nii_stop(), snpnet_stop(), and usbio_stop().

efidev_alloc()

struct efi_device* efidev_alloc

(

EFI_HANDLE

device

)

Allocate new EFI device.

Parameters

device

EFI device handle

Return values

efidev

EFI device, or NULL on error

Definition at line 70 of file efi_driver.c.

                                                       {
        EFI_BOOT_SERVICES *bs = efi_systab->BootServices;
        struct efi_device *efidev = NULL;
        union {
                EFI_DEVICE_PATH_PROTOCOL *path;
                void *interface;
        } path;
        EFI_DEVICE_PATH_PROTOCOL *path_end;
        size_t path_len;
        EFI_STATUS efirc;
        int rc;

        /* Open device path */
        if ( ( efirc = bs->OpenProtocol ( device,
                                          &efi_device_path_protocol_guid,
                                          &path.interface, efi_image_handle,
                                          device,
                                          EFI_OPEN_PROTOCOL_GET_PROTOCOL ))!=0){
                rc = -EEFI ( efirc );
                DBGC ( device, "EFIDRV %s could not open device path: %s\n",
                       efi_handle_name ( device ), strerror ( rc ) );
                goto err_open_path;
        }
        path_len = ( efi_path_len ( path.path ) + sizeof ( *path_end ) );

        /* Allocate and initialise structure */
        efidev = zalloc ( sizeof ( *efidev ) + path_len );
        if ( ! efidev )
                goto err_alloc;
        efidev->device = device;
        efidev->dev.desc.bus_type = BUS_TYPE_EFI;
        efidev->path = ( ( ( void * ) efidev ) + sizeof ( *efidev ) );
        memcpy ( efidev->path, path.path, path_len );
        INIT_LIST_HEAD ( &efidev->dev.children );
        list_add ( &efidev->dev.siblings, &efi_devices );

 err_alloc:
        bs->CloseProtocol ( device, &efi_device_path_protocol_guid,
                            efi_image_handle, device );
 err_open_path:
        return efidev;
}

References EFI_SYSTEM_TABLE::BootServices, device_description::bus_type, BUS_TYPE_EFI, device::children, EFI_BOOT_SERVICES::CloseProtocol, DBGC, device::desc, efi_device::dev, efi_device::device, device, EEFI, efi_device_path_protocol_guid, efi_handle_name(), efi_image_handle, EFI_OPEN_PROTOCOL_GET_PROTOCOL, efi_path_len(), efi_systab, INIT_LIST_HEAD, list_add, memcpy(), NULL, EFI_BOOT_SERVICES::OpenProtocol, efi_device::path, rc, device::siblings, strerror(), and zalloc().

Referenced by efi_driver_start(), and mnptemp_create().

efidev_free()

void efidev_free

(

struct efi_device *

efidev

)

Free EFI device.

Parameters

efidev

EFI device

Definition at line 118 of file efi_driver.c.

                                               {

        assert ( list_empty ( &efidev->dev.children ) );
        list_del ( &efidev->dev.siblings );
        free ( efidev );
}

References assert(), device::children, efi_device::dev, free, list_del, list_empty, and device::siblings.

Referenced by efi_driver_start(), efi_driver_stop(), mnptemp_create(), and mnptemp_destroy().

efidev_parent()

struct efi_device* efidev_parent

(

struct device *

dev

)

Get parent EFI device.

Parameters

dev	Generic device

Return values

efidev

Parent EFI device, or NULL

Definition at line 155 of file efi_driver.c.

                                                         {
        struct device *parent;
        struct efi_device *efidev;

        /* Walk upwards until we find a registered EFI device */
        while ( ( parent = dev->parent ) ) {
                list_for_each_entry ( efidev, &efi_devices, dev.siblings ) {
                        if ( parent == &efidev->dev )
                                return efidev;
                }
                dev = parent;
        }

        return NULL;
}

References efi_device::dev, list_for_each_entry, NULL, device::parent, and device::siblings.

Referenced by efi_ib_srp_path(), efi_netdev_path(), efi_snp_probe(), and efi_usb_path().

efi_driver_install()

int efi_driver_install

(

void

)

Install EFI driver.

Return values

rc	Return status code

Definition at line 414 of file efi_driver.c.

                                {
        EFI_BOOT_SERVICES *bs = efi_systab->BootServices;
        EFI_STATUS efirc;
        int rc;

        /* Calculate driver version number.  We use the build
         * timestamp (in seconds since the Epoch) shifted right by six
         * bits: this gives us an approximately one-minute resolution
         * and a scheme which will last until the year 10680.
         */
        efi_driver_binding.Version = ( build_timestamp >> 6 );

        /* Install protocols on image handle */
        efi_driver_binding.ImageHandle = efi_image_handle;
        efi_driver_binding.DriverBindingHandle = efi_image_handle;
        if ( ( efirc = bs->InstallMultipleProtocolInterfaces (
                        &efi_image_handle,
                        &efi_driver_binding_protocol_guid, &efi_driver_binding,
                        &efi_component_name2_protocol_guid, &efi_wtf,
                        NULL ) ) != 0 ) {
                rc = -EEFI ( efirc );
                DBGC ( &efi_driver_binding, "EFIDRV could not install "
                       "protocols: %s\n", strerror ( rc ) );
                return rc;
        }

        return 0;
}

References EFI_SYSTEM_TABLE::BootServices, build_timestamp, DBGC, _EFI_DRIVER_BINDING_PROTOCOL::DriverBindingHandle, EEFI, efi_component_name2_protocol_guid, efi_driver_binding, efi_driver_binding_protocol_guid, efi_image_handle, efi_systab, efi_wtf, _EFI_DRIVER_BINDING_PROTOCOL::ImageHandle, EFI_BOOT_SERVICES::InstallMultipleProtocolInterfaces, NULL, rc, strerror(), and _EFI_DRIVER_BINDING_PROTOCOL::Version.

Referenced by efi_init().

efi_driver_uninstall()

void efi_driver_uninstall

(

void

)

Uninstall EFI driver.

Definition at line 447 of file efi_driver.c.

                                   {
        EFI_BOOT_SERVICES *bs = efi_systab->BootServices;

        /* Uninstall protocols */
        bs->UninstallMultipleProtocolInterfaces (
                efi_image_handle,
                &efi_driver_binding_protocol_guid, &efi_driver_binding,
                &efi_component_name2_protocol_guid, &efi_wtf, NULL );
}

References EFI_SYSTEM_TABLE::BootServices, efi_component_name2_protocol_guid, efi_driver_binding, efi_driver_binding_protocol_guid, efi_image_handle, efi_systab, efi_wtf, NULL, and EFI_BOOT_SERVICES::UninstallMultipleProtocolInterfaces.

Referenced by efi_init(), and efi_unload().

efi_driver_connect_all()

int efi_driver_connect_all

(

void

)

Connect EFI driver to all possible devices.

Return values

rc	Return status code

Definition at line 602 of file efi_driver.c.

                                    {

        DBGC ( &efi_driver_binding, "EFIDRV connecting our drivers\n" );
        return efi_driver_handles ( efi_driver_connect );
}

References DBGC, efi_driver_binding, efi_driver_connect(), and efi_driver_handles().

Referenced by efi_probe().

efi_driver_disconnect_all()

void efi_driver_disconnect_all

(

void

)

Disconnect EFI driver from all possible devices.

Return values

rc	Return status code

Definition at line 613 of file efi_driver.c.

                                        {

        DBGC ( &efi_driver_binding, "EFIDRV disconnecting our drivers\n" );
        efi_driver_handles ( efi_driver_disconnect );
}

References DBGC, efi_driver_binding, efi_driver_disconnect(), and efi_driver_handles().

Referenced by efi_remove(), and efi_unload().

efi_driver_reconnect_all()

void efi_driver_reconnect_all

(

void

)

Reconnect original EFI drivers to all possible devices.

Return values

rc	Return status code

Definition at line 624 of file efi_driver.c.

                                       {

        DBGC ( &efi_driver_binding, "EFIDRV reconnecting old drivers\n" );
        efi_driver_handles ( efi_driver_reconnect );
}

References DBGC, efi_driver_binding, efi_driver_handles(), and efi_driver_reconnect().

Referenced by _efi_start(), and efi_image_exec().