efi_service.c File Reference

EFI service binding. More...

#include <string.h>
#include <errno.h>
#include <ipxe/efi/efi.h>
#include <ipxe/efi/efi_service.h>
#include <ipxe/efi/Protocol/ServiceBinding.h>

Go to the source code of this file.

Functions
	FILE_LICENCE (GPL2_OR_LATER_OR_UBDL)
int	efi_service_add (EFI_HANDLE service, EFI_GUID *binding, EFI_HANDLE *handle)
	Add service to child handle. More...
int	efi_service_del (EFI_HANDLE service, EFI_GUID *binding, EFI_HANDLE handle)
	Remove service from child handle. More...

Detailed Description

EFI service binding.

Definition in file efi_service.c.

Function Documentation

FILE_LICENCE()

FILE_LICENCE

(

GPL2_OR_LATER_OR_UBDL

)

efi_service_add()

int efi_service_add	(	EFI_HANDLE	service,
		EFI_GUID *	binding,
		EFI_HANDLE *	handle
	)

Add service to child handle.

Parameters

service	Service binding handle
binding	Service binding protocol GUID
handle	Handle on which to install child

Return values

rc	Return status code

Definition at line 46 of file efi_service.c.

                                           {
        EFI_BOOT_SERVICES *bs = efi_systab->BootServices;
        union {
                EFI_SERVICE_BINDING_PROTOCOL *sb;
                void *interface;
        } u;
        EFI_STATUS efirc;
        int rc;

        /* Open service binding protocol */
        if ( ( efirc = bs->OpenProtocol ( service, binding, &u.interface,
                                          efi_image_handle, service,
                                          EFI_OPEN_PROTOCOL_GET_PROTOCOL ))!=0){
                rc = -EEFI ( efirc );
                DBGC ( service, "EFISVC %s cannot open %s binding: %s\n",
                       efi_handle_name ( service ), efi_guid_ntoa ( binding ),
                       strerror ( rc ) );
                goto err_open;
        }

        /* Create child handle */
        if ( ( efirc = u.sb->CreateChild ( u.sb, handle ) ) != 0 ) {
                rc = -EEFI ( efirc );
                DBGC ( service, "EFISVC %s could not create %s child: %s\n",
                       efi_handle_name ( service ), efi_guid_ntoa ( binding ),
                       strerror ( rc ) );
                goto err_create;
        }

        /* Success */
        rc = 0;
        DBGC ( service, "EFISVC %s created %s child ",
               efi_handle_name ( service ), efi_guid_ntoa ( binding ) );
        DBGC ( service, "%s\n", efi_handle_name ( *handle ) );

 err_create:
        bs->CloseProtocol ( service, binding, efi_image_handle, service );
 err_open:
        return rc;
}

References EFI_SYSTEM_TABLE::BootServices, EFI_BOOT_SERVICES::CloseProtocol, DBGC, EEFI, efi_guid_ntoa(), efi_handle_name(), efi_image_handle, EFI_OPEN_PROTOCOL_GET_PROTOCOL, efi_systab, handle, EFI_BOOT_SERVICES::OpenProtocol, rc, strerror(), and u.

Referenced by mnpnet_start().

efi_service_del()

int efi_service_del	(	EFI_HANDLE	service,
		EFI_GUID *	binding,
		EFI_HANDLE	handle
	)

Remove service from child handle.

Parameters

service	Service binding handle
binding	Service binding protocol GUID
handle	Child handle

Return values

rc	Return status code

Definition at line 96 of file efi_service.c.

                                          {
        EFI_BOOT_SERVICES *bs = efi_systab->BootServices;
        union {
                EFI_SERVICE_BINDING_PROTOCOL *sb;
                void *interface;
        } u;
        EFI_STATUS efirc;
        int rc;

        DBGC ( service, "EFISVC %s removing %s child ",
               efi_handle_name ( service ), efi_guid_ntoa ( binding ) );
        DBGC ( service, "%s\n", efi_handle_name ( handle ) );

        /* Open service binding protocol */
        if ( ( efirc = bs->OpenProtocol ( service, binding, &u.interface,
                                          efi_image_handle, service,
                                          EFI_OPEN_PROTOCOL_GET_PROTOCOL ))!=0){
                rc = -EEFI ( efirc );
                DBGC ( service, "EFISVC %s cannot open %s binding: %s\n",
                       efi_handle_name ( service ), efi_guid_ntoa ( binding ),
                       strerror ( rc ) );
                goto err_open;
        }

        /* Destroy child handle */
        if ( ( efirc = u.sb->DestroyChild ( u.sb, handle ) ) != 0 ) {
                rc = -EEFI ( efirc );
                DBGC ( service, "EFISVC %s could not destroy %s child ",
                       efi_handle_name ( service ), efi_guid_ntoa ( binding ) );
                DBGC ( service, "%s: %s\n",
                       efi_handle_name ( handle ), strerror ( rc ) );
                goto err_destroy;
        }

        /* Success */
        rc = 0;

 err_destroy:
        bs->CloseProtocol ( service, binding, efi_image_handle, service );
 err_open:
        return rc;
}

References EFI_SYSTEM_TABLE::BootServices, EFI_BOOT_SERVICES::CloseProtocol, DBGC, EEFI, efi_guid_ntoa(), efi_handle_name(), efi_image_handle, EFI_OPEN_PROTOCOL_GET_PROTOCOL, efi_systab, handle, EFI_BOOT_SERVICES::OpenProtocol, rc, strerror(), and u.

Referenced by mnpnet_start(), and mnpnet_stop().