efi_service.h File Reference

EFI service binding. More...

#include <ipxe/efi/efi.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.h.

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_SERVICE_BINDING_PROTOCOL *sb;
        EFI_STATUS efirc;
        int rc;

        /* Open service binding protocol */
        if ( ( rc = efi_open ( service, binding, &sb ) ) != 0 ) {
                DBGC ( service, "EFISVC %s cannot open %s binding: %s\n",
                       efi_handle_name ( service ), efi_guid_ntoa ( binding ),
                       strerror ( rc ) );
                return rc;
        }

        /* Create child handle */
        if ( ( efirc = sb->CreateChild ( 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 ) );
                return rc;
        }

        DBGC ( service, "EFISVC %s created %s child ",
               efi_handle_name ( service ), efi_guid_ntoa ( binding ) );
        DBGC ( service, "%s\n", efi_handle_name ( *handle ) );
        return 0;
}

References _EFI_SERVICE_BINDING_PROTOCOL::CreateChild, DBGC, EEFI, efi_guid_ntoa(), efi_handle_name(), efi_open, handle, rc, and strerror().

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 83 of file efi_service.c.

                                          {
        EFI_SERVICE_BINDING_PROTOCOL *sb;
        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 ( ( rc = efi_open ( service, binding, &sb ) ) != 0 ) {
                DBGC ( service, "EFISVC %s cannot open %s binding: %s\n",
                       efi_handle_name ( service ), efi_guid_ntoa ( binding ),
                       strerror ( rc ) );
                return rc;
        }

        /* Destroy child handle */
        if ( ( efirc = sb->DestroyChild ( 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 ) );
                return rc;
        }

        return 0;
}

References DBGC, _EFI_SERVICE_BINDING_PROTOCOL::DestroyChild, EEFI, efi_guid_ntoa(), efi_handle_name(), efi_open, handle, rc, and strerror().

Referenced by mnpnet_start(), and mnpnet_stop().