sysadmin/ipxe
1
0
Fork 0
mirror of https://github.com/ipxe/ipxe synced 2025-12-24 15:23:42 +03:00
Code Issues Packages Projects Releases Wiki Activity

[efi] Add helper functions for service binding protocols

Browse Source 
The EFI service binding abstraction is used to add and remove child
handles for multiple different protocols.  Provide a common interface
for doing so.

Signed-off-by: Michael Brown <mcb30@ipxe.org>
This commit is contained in:
Michael Brown
2024-03-20 12:47:25 +00:00
parent a15ce00182
commit ca483a196c
4 changed files with 248 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

138
src/interface/efi/efi_service.c Normal file
View File

@@ -0,0 +1,138 @@
/*
* Copyright (C) 2024 Michael Brown <mbrown@fensystems.co.uk>.
*
* This program is free software; you can redistribute it and/or
* modify it under the terms of the GNU General Public License as
* published by the Free Software Foundation; either version 2 of the
* License, or any later version.
*
* This program is distributed in the hope that it will be useful, but
* WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program; if not, write to the Free Software
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
* 02110-1301, USA.
*
* You can also choose to distribute this program under the terms of
* the Unmodified Binary Distribution Licence (as given in the file
* COPYING.UBDL), provided that you have satisfied its requirements.
*/
FILE_LICENCE ( GPL2_OR_LATER_OR_UBDL );
/** @file
*
* EFI service binding
*
*/
#include <string.h>
#include <errno.h>
#include <ipxe/efi/efi.h>
#include <ipxe/efi/efi_service.h>
#include <ipxe/efi/Protocol/ServiceBinding.h>
/**
* Add service to child handle
*
* @v service Service binding handle
* @v binding Service binding protocol GUID
* @v handle Handle on which to install child
* @ret rc Return status code
*/
int efi_service_add ( EFI_HANDLE service, EFI_GUID *binding,
EFI_HANDLE *handle ) {
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;
}
/**
* Remove service from child handle
*
* @v service Service binding handle
* @v binding Service binding protocol GUID
* @v handle Child handle
* @ret rc Return status code
*/
int efi_service_del ( EFI_HANDLE service, EFI_GUID *binding,
EFI_HANDLE handle ) {
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;
}