From patchwork Fri Nov 23 08:44:04 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Ard Biesheuvel X-Patchwork-Id: 151847 Delivered-To: patch@linaro.org Received: by 2002:a2e:299d:0:0:0:0:0 with SMTP id p29-v6csp1799644ljp; Fri, 23 Nov 2018 00:46:06 -0800 (PST) X-Google-Smtp-Source: AFSGD/X7ihDqBuvGDdfrVuU3DR0TO92ph5PNi2PouKQgSTQQMqZuuiCgWMIzCkbcLrs6kYrTmWqw X-Received: by 2002:a24:6c55:: with SMTP id w82-v6mr12295716itb.106.1542962766270; Fri, 23 Nov 2018 00:46:06 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1542962766; cv=none; d=google.com; s=arc-20160816; b=p8zk4XPjWXUGhYoXfXkYtdmiclsJGgahVJfDWrx3an0jHrLASsduxa82cxmoPKkPJz zPKMcOrYgGp2DN57MFWjXS2t2TgVMj+F4PUzQvPA5NpO4STn5LO9WQi4pd+OASx9i8Eh qDdR7DfymHBcRZRuzYIwBajQBG7KqHeXqyaVn+fVra5Nmz04WRvLlCq3D66GhwKmS5m/ bZJSebcoMUUSrnHADyUxl5xV1lbCzEkvWDA4tsZVAlJlLLId/shrwsXOBcVLHTcn0sAy ZI9Azoxtsyfw40nvoPxsGllwx/lxldPcLpPqGrhiRiW70y06yoeUkODIYADVBnEBYCAk 1uYQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=sender:errors-to:content-transfer-encoding:mime-version:cc :list-subscribe:list-help:list-post:list-archive:list-unsubscribe :list-id:precedence:subject:references:in-reply-to:message-id:date :to:from:dkim-signature:delivered-to; bh=lzcNshS9lYGvbbRFcsvp2Pluvgd7EDsT02DY1Pxa2oI=; b=wS+wIBf+vKWV6gkezldNYK1K3ViyMwBPcV5WdZFbZdGf9uTT5Mq5sGGA9h7ut1+rsl hxpX6AMSKNfgg/azNQKbLNJfR95G++22jIJt3OLL8C2tc3hhItBVlWnOe+7lxdl7mvSf spn2j2uJSrkHKWQe6KNdTQyOlQpho5rdSsyb+Wo9i94TnGQX3Z0a2EmRmd2TQGfTEeKP bP4Py2RNHqAz+JVl3cvTtMIsMvVq3KpSkzgIelMEl/lataYtHrQNlPazpt7zRW+v9MWL 64MzXpiKyvjJLZ/OtijUoPmHD6juu44uDyHYas3OVtz9S6I8ultoyXsWKwu+zKA9E9dP Z7oA== ARC-Authentication-Results: i=1; mx.google.com; dkim=neutral (body hash did not verify) header.i=@linaro.org header.s=google header.b=eobBMSCB; spf=pass (google.com: best guess record for domain of edk2-devel-bounces@lists.01.org designates 2001:19d0:306:5::1 as permitted sender) smtp.mailfrom=edk2-devel-bounces@lists.01.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=linaro.org Return-Path: Received: from ml01.01.org (ml01.01.org. [2001:19d0:306:5::1]) by mx.google.com with ESMTPS id b87si10459178jad.14.2018.11.23.00.46.05 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Fri, 23 Nov 2018 00:46:06 -0800 (PST) Received-SPF: pass (google.com: best guess record for domain of edk2-devel-bounces@lists.01.org designates 2001:19d0:306:5::1 as permitted sender) client-ip=2001:19d0:306:5::1; Authentication-Results: mx.google.com; dkim=neutral (body hash did not verify) header.i=@linaro.org header.s=google header.b=eobBMSCB; spf=pass (google.com: best guess record for domain of edk2-devel-bounces@lists.01.org designates 2001:19d0:306:5::1 as permitted sender) smtp.mailfrom=edk2-devel-bounces@lists.01.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=linaro.org Received: from [127.0.0.1] (localhost [IPv6:::1]) by ml01.01.org (Postfix) with ESMTP id BCD392119489C; Fri, 23 Nov 2018 00:46:03 -0800 (PST) X-Original-To: edk2-devel@lists.01.org Delivered-To: edk2-devel@lists.01.org Received-SPF: Pass (sender SPF authorized) identity=mailfrom; client-ip=2a00:1450:4864:20::343; helo=mail-wm1-x343.google.com; envelope-from=ard.biesheuvel@linaro.org; receiver=edk2-devel@lists.01.org Received: from mail-wm1-x343.google.com (mail-wm1-x343.google.com [IPv6:2a00:1450:4864:20::343]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by ml01.01.org (Postfix) with ESMTPS id DA49921B02822 for ; Fri, 23 Nov 2018 00:44:11 -0800 (PST) Received: by mail-wm1-x343.google.com with SMTP id j207so4005531wmj.1 for ; Fri, 23 Nov 2018 00:44:11 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; h=from:to:cc:subject:date:message-id:in-reply-to:references; bh=UX/tnPRDV7bVuqZkFVOZeCPRfEQbLG1b/YdZS8TcTUI=; b=eobBMSCBBiE59cyWpRk9eFd5gVT4dObN68s6joUAK5d9B+xDTL2t9c54vpriXpfh9c TbQncxaA1TstnsdHocvOgozoohP4fgAO8vml5IpBE4qvEL2LsK9DWPVXGdbuZ7IjjEax GImUtOGaAPEjMkLA0lC3Y+GsTVOOrNdiykwyE= X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references; bh=UX/tnPRDV7bVuqZkFVOZeCPRfEQbLG1b/YdZS8TcTUI=; b=rda1LBtHYRpF8qg2zhpUPX7drI+2ONmGrvzsvWFS+SrjyDCtCx8652ZjzXPvHF/Daz I6A4qf1TmHq6H0TshnoRyMGA1UqY6nreqHh9pLlPYVO8fCB6DXoyNOBQ+QXxm0n+VMbw gx03PArzANRvT2cDOyxkq4KyseXxktUYDHr73UDDAqYZWMtk0BMP4X9e+s1LLcES2BQ9 T70o1IKiC7oOVrtzO46Z8Va4kKd6aOF6HzrVE0VXAnk6fTlD7mEtJj+3ZKGnnSgiDyus HRpeQOG3xHkli7XkyX16pYZRwvse/rQen1r4RmYsEWFgG/6AYUOWEjjEC4q/ObQMybUF MTaA== X-Gm-Message-State: AA+aEWYO/suPnqzRnWlbq6DZjoFYLt/AFAW66JENY1ksDYkXS85NOUEj MOYnH7Q+3UJI5e6F7nHg8MLrjnhb5CgyZA== X-Received: by 2002:a7b:c404:: with SMTP id k4mr12923667wmi.144.1542962650040; Fri, 23 Nov 2018 00:44:10 -0800 (PST) Received: from mba13.wifi.ns.nl (33.153.69.91.rev.sfr.net. [91.69.153.33]) by smtp.gmail.com with ESMTPSA id c8sm807377wrx.42.2018.11.23.00.44.08 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Fri, 23 Nov 2018 00:44:09 -0800 (PST) From: Ard Biesheuvel To: edk2-devel@lists.01.org Date: Fri, 23 Nov 2018 09:44:04 +0100 Message-Id: <20181123084406.27192-2-ard.biesheuvel@linaro.org> X-Mailer: git-send-email 2.17.1 In-Reply-To: <20181123084406.27192-1-ard.biesheuvel@linaro.org> References: <20181123084406.27192-1-ard.biesheuvel@linaro.org> Subject: [edk2] [PATCH v2 edk2-platforms 1/3] Platform/ARM: import ARM platform specific BdsLib header X-BeenThere: edk2-devel@lists.01.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: EDK II Development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: lersek@redhat.com, nariman.poushin@linaro.org MIME-Version: 1.0 Errors-To: edk2-devel-bounces@lists.01.org Sender: "edk2-devel" The BdsLib library has been moved into Platform/ARM a while ago, but the BdsLib.h header was left behind, and so all users in Platform/ARM are still relying on it to be available in ArmPkg. So let's add a copy to Platform/ARM and wire it up, so we can drop it from ArmPkg going forward. Note that the BdsLib implementation included ArmLib.h from ArmPkg without using anything it provides, so drop that false dependency as well. Contributed-under: TianoCore Contribution Agreement 1.1 Signed-off-by: Ard Biesheuvel Acked-by: Laszlo Ersek --- Platform/ARM/ARM.dec | 3 + Platform/ARM/Drivers/FdtPlatformDxe/FdtPlatformDxe.inf | 2 +- Platform/ARM/Include/Library/BdsLib.h | 212 ++++++++++++++++++++ Platform/ARM/Library/BdsLib/BdsInternal.h | 1 - Platform/ARM/Library/BdsLib/BdsLib.inf | 2 +- 5 files changed, 217 insertions(+), 3 deletions(-) -- 2.17.1 _______________________________________________ edk2-devel mailing list edk2-devel@lists.01.org https://lists.01.org/mailman/listinfo/edk2-devel diff --git a/Platform/ARM/ARM.dec b/Platform/ARM/ARM.dec index f9bf3294a0ca..6a6eeb6559fd 100644 --- a/Platform/ARM/ARM.dec +++ b/Platform/ARM/ARM.dec @@ -21,5 +21,8 @@ [Includes] Include # Root include for the package +[LibraryClasses] + BdsLib|Include/Library/BdsLib.h + [Guids] gArmBootMonFsFileInfoGuid = { 0x41e26b9c, 0xada6, 0x45b3, { 0x80, 0x8e, 0x23, 0x57, 0xa3, 0x5b, 0x60, 0xd6 } } diff --git a/Platform/ARM/Drivers/FdtPlatformDxe/FdtPlatformDxe.inf b/Platform/ARM/Drivers/FdtPlatformDxe/FdtPlatformDxe.inf index f9a5aee3596e..d4aef4bfce92 100644 --- a/Platform/ARM/Drivers/FdtPlatformDxe/FdtPlatformDxe.inf +++ b/Platform/ARM/Drivers/FdtPlatformDxe/FdtPlatformDxe.inf @@ -28,10 +28,10 @@ ShellSetFdt.c [Packages] - ArmPkg/ArmPkg.dec EmbeddedPkg/EmbeddedPkg.dec MdeModulePkg/MdeModulePkg.dec MdePkg/MdePkg.dec + Platform/ARM/ARM.dec Platform/ARM/Drivers/FdtPlatformDxe/FdtPlatformDxe.dec ShellPkg/ShellPkg.dec diff --git a/Platform/ARM/Include/Library/BdsLib.h b/Platform/ARM/Include/Library/BdsLib.h new file mode 100644 index 000000000000..4528c2e8739b --- /dev/null +++ b/Platform/ARM/Include/Library/BdsLib.h @@ -0,0 +1,212 @@ +/** @file +* +* Copyright (c) 2013-2015, ARM Limited. All rights reserved. +* +* This program and the accompanying materials +* are licensed and made available under the terms and conditions of the BSD License +* which accompanies this distribution. The full text of the license may be found at +* http://opensource.org/licenses/bsd-license.php +* +* THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, +* WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. +* +**/ + +#ifndef __BDS_ENTRY_H__ +#define __BDS_ENTRY_H__ + +#define IS_DEVICE_PATH_NODE(node,type,subtype) \ + (((node)->Type == (type)) && ((node)->SubType == (subtype))) + +/** + This is defined by the UEFI specs, don't change it +**/ +typedef struct { + UINT16 LoadOptionIndex; + EFI_LOAD_OPTION *LoadOption; + UINTN LoadOptionSize; + + UINT32 Attributes; + UINT16 FilePathListLength; + CHAR16 *Description; + EFI_DEVICE_PATH_PROTOCOL *FilePathList; + + VOID* OptionalData; + UINTN OptionalDataSize; +} BDS_LOAD_OPTION; + +/** + Connect a Device Path and return the handle of the driver that support this DevicePath + + @param DevicePath Device Path of the File to connect + @param Handle Handle of the driver that support this DevicePath + @param RemainingDevicePath Remaining DevicePath nodes that do not match the driver DevicePath + + @retval EFI_SUCCESS A driver that matches the Device Path has been found + @retval EFI_NOT_FOUND No handles match the search. + @retval EFI_INVALID_PARAMETER DevicePath or Handle is NULL + +**/ +EFI_STATUS +BdsConnectDevicePath ( + IN EFI_DEVICE_PATH_PROTOCOL* DevicePath, + OUT EFI_HANDLE *Handle, + OUT EFI_DEVICE_PATH_PROTOCOL **RemainingDevicePath + ); + +/** + Connect all DXE drivers + + @retval EFI_SUCCESS All drivers have been connected + @retval EFI_NOT_FOUND No handles match the search. + @retval EFI_OUT_OF_RESOURCES There is not resource pool memory to store the matching results. + +**/ +EFI_STATUS +BdsConnectAllDrivers ( + VOID + ); + +/** + Return the value of a global variable defined by its VariableName. + The variable must be defined with the VendorGuid gEfiGlobalVariableGuid. + + @param VariableName A Null-terminated string that is the name of the vendor's + variable. + @param DefaultValue Value returned by the function if the variable does not exist + @param DataSize On input, the size in bytes of the return Data buffer. + On output the size of data returned in Data. + @param Value Value read from the UEFI Variable or copy of the default value + if the UEFI Variable does not exist + + @retval EFI_SUCCESS All drivers have been connected + @retval EFI_NOT_FOUND No handles match the search. + @retval EFI_OUT_OF_RESOURCES There is not resource pool memory to store the matching results. + +**/ +EFI_STATUS +GetGlobalEnvironmentVariable ( + IN CONST CHAR16* VariableName, + IN VOID* DefaultValue, + IN OUT UINTN* Size, + OUT VOID** Value + ); + +/** + Return the value of the variable defined by its VariableName and VendorGuid + + @param VariableName A Null-terminated string that is the name of the vendor's + variable. + @param VendorGuid A unique identifier for the vendor. + @param DefaultValue Value returned by the function if the variable does not exist + @param DataSize On input, the size in bytes of the return Data buffer. + On output the size of data returned in Data. + @param Value Value read from the UEFI Variable or copy of the default value + if the UEFI Variable does not exist + + @retval EFI_SUCCESS All drivers have been connected + @retval EFI_NOT_FOUND No handles match the search. + @retval EFI_OUT_OF_RESOURCES There is not resource pool memory to store the matching results. + +**/ +EFI_STATUS +GetEnvironmentVariable ( + IN CONST CHAR16* VariableName, + IN EFI_GUID* VendorGuid, + IN VOID* DefaultValue, + IN OUT UINTN* Size, + OUT VOID** Value + ); + +EFI_STATUS +BootOptionFromLoadOptionIndex ( + IN UINT16 LoadOptionIndex, + OUT BDS_LOAD_OPTION** BdsLoadOption + ); + +EFI_STATUS +BootOptionFromLoadOptionVariable ( + IN CHAR16* BootVariableName, + OUT BDS_LOAD_OPTION** BdsLoadOption + ); + +EFI_STATUS +BootOptionToLoadOptionVariable ( + IN BDS_LOAD_OPTION* BdsLoadOption + ); + +UINT16 +BootOptionAllocateBootIndex ( + VOID + ); + +/** + Start an EFI Application from a Device Path + + @param ParentImageHandle Handle of the calling image + @param DevicePath Location of the EFI Application + + @retval EFI_SUCCESS All drivers have been connected + @retval EFI_NOT_FOUND The Linux kernel Device Path has not been found + @retval EFI_OUT_OF_RESOURCES There is not enough resource memory to store the matching results. + +**/ +EFI_STATUS +BdsStartEfiApplication ( + IN EFI_HANDLE ParentImageHandle, + IN EFI_DEVICE_PATH_PROTOCOL *DevicePath, + IN UINTN LoadOptionsSize, + IN VOID* LoadOptions + ); + +EFI_STATUS +BdsLoadImage ( + IN EFI_DEVICE_PATH *DevicePath, + IN EFI_ALLOCATE_TYPE Type, + IN OUT EFI_PHYSICAL_ADDRESS* Image, + OUT UINTN *FileSize + ); + +/** + * Call BS.ExitBootServices with the appropriate Memory Map information + */ +EFI_STATUS +ShutdownUefiBootServices ( + VOID + ); + +/** + Locate an EFI application in a the Firmware Volumes by its name + + @param EfiAppGuid Guid of the EFI Application into the Firmware Volume + @param DevicePath EFI Device Path of the EFI application + + @return EFI_SUCCESS The function completed successfully. + @return EFI_NOT_FOUND The protocol could not be located. + @return EFI_OUT_OF_RESOURCES There are not enough resources to find the protocol. + +**/ +EFI_STATUS +LocateEfiApplicationInFvByName ( + IN CONST CHAR16* EfiAppName, + OUT EFI_DEVICE_PATH **DevicePath + ); + +/** + Locate an EFI application in a the Firmware Volumes by its GUID + + @param EfiAppGuid Guid of the EFI Application into the Firmware Volume + @param DevicePath EFI Device Path of the EFI application + + @return EFI_SUCCESS The function completed successfully. + @return EFI_NOT_FOUND The protocol could not be located. + @return EFI_OUT_OF_RESOURCES There are not enough resources to find the protocol. + +**/ +EFI_STATUS +LocateEfiApplicationInFvByGuid ( + IN CONST EFI_GUID *EfiAppGuid, + OUT EFI_DEVICE_PATH **DevicePath + ); + +#endif diff --git a/Platform/ARM/Library/BdsLib/BdsInternal.h b/Platform/ARM/Library/BdsLib/BdsInternal.h index f70aae603d69..bb4566e3a6c4 100644 --- a/Platform/ARM/Library/BdsLib/BdsInternal.h +++ b/Platform/ARM/Library/BdsLib/BdsInternal.h @@ -16,7 +16,6 @@ #define __BDS_INTERNAL_H__ #include -#include #include #include #include diff --git a/Platform/ARM/Library/BdsLib/BdsLib.inf b/Platform/ARM/Library/BdsLib/BdsLib.inf index 96c1d6e7e200..637ef5a08128 100644 --- a/Platform/ARM/Library/BdsLib/BdsLib.inf +++ b/Platform/ARM/Library/BdsLib/BdsLib.inf @@ -27,10 +27,10 @@ BdsLoadOption.c [Packages] - ArmPkg/ArmPkg.dec EmbeddedPkg/EmbeddedPkg.dec MdeModulePkg/MdeModulePkg.dec MdePkg/MdePkg.dec + Platform/ARM/ARM.dec [LibraryClasses] ArmLib