From nobody Sat Jul 12 21:40:34 2025 Delivered-To: importer@patchew.org Received-SPF: none (zoho.com: 198.145.21.10 is neither permitted nor denied by domain of lists.01.org) client-ip=198.145.21.10; envelope-from=edk2-devel-bounces@lists.01.org; helo=ml01.01.org; Authentication-Results: mx.zoho.com; spf=none (zoho.com: 198.145.21.10 is neither permitted nor denied by domain of lists.01.org) smtp.mailfrom=edk2-devel-bounces@lists.01.org; Return-Path: Received: from ml01.01.org (ml01.01.org [198.145.21.10]) by mx.zohomail.com with SMTPS id 1497433017515688.4841005399843; Wed, 14 Jun 2017 02:36:57 -0700 (PDT) Received: from [127.0.0.1] (localhost [IPv6:::1]) by ml01.01.org (Postfix) with ESMTP id A78BA21A143E7; Wed, 14 Jun 2017 02:35:39 -0700 (PDT) Received: from mga11.intel.com (mga11.intel.com [192.55.52.93]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ml01.01.org (Postfix) with ESMTPS id 2434821A143D0 for ; Wed, 14 Jun 2017 02:35:37 -0700 (PDT) Received: from orsmga002.jf.intel.com ([10.7.209.21]) by fmsmga102.fm.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 14 Jun 2017 02:36:52 -0700 Received: from sfu5-mobl.ccr.corp.intel.com ([10.239.194.153]) by orsmga002.jf.intel.com with ESMTP; 14 Jun 2017 02:36:51 -0700 X-Original-To: edk2-devel@lists.01.org X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.39,340,1493708400"; d="scan'208";a="99321963" From: Fu Siyuan To: edk2-devel@lists.01.org Date: Wed, 14 Jun 2017 17:36:41 +0800 Message-Id: <20170614093642.2240-2-siyuan.fu@intel.com> X-Mailer: git-send-email 2.13.0.windows.1 In-Reply-To: <20170614093642.2240-1-siyuan.fu@intel.com> References: <20170614093642.2240-1-siyuan.fu@intel.com> Subject: [edk2] [Patch 1/2] MdePkg: Add header file for HTTP Boot Callback protocol in UEFI 2.7. X-BeenThere: edk2-devel@lists.01.org X-Mailman-Version: 2.1.22 Precedence: list List-Id: EDK II Development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Ye Ting , Wu Jiaxin MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Errors-To: edk2-devel-bounces@lists.01.org Sender: "edk2-devel" X-ZohoMail: RSF_4 Z_629925259 SPT_0 Content-Type: text/plain; charset="utf-8" Cc: Ye Ting Cc: Wu Jiaxin Contributed-under: TianoCore Contribution Agreement 1.0 Signed-off-by: Fu Siyuan Reviewed-by: Wu Jiaxin --- MdePkg/Include/Protocol/HttpBootCallback.h | 100 +++++++++++++++++++++++++= ++++ MdePkg/MdePkg.dec | 7 +- 2 files changed, 105 insertions(+), 2 deletions(-) create mode 100644 MdePkg/Include/Protocol/HttpBootCallback.h diff --git a/MdePkg/Include/Protocol/HttpBootCallback.h b/MdePkg/Include/Pr= otocol/HttpBootCallback.h new file mode 100644 index 0000000000..7542b30e03 --- /dev/null +++ b/MdePkg/Include/Protocol/HttpBootCallback.h @@ -0,0 +1,100 @@ +/** @file + This file defines the EFI HTTP Boot Callback Protocol interface. + + Copyright (c) 2017, Intel Corporation. All rights reserved.
+ This program and the accompanying materials + are licensed and made available under the terms and conditions of the BS= D 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 IMP= LIED. + + @par Revision Reference: + This Protocol is introduced in UEFI Specification 2.7 + +**/ + +#ifndef __EFI_HTTP_BOOT_CALLBACK_H__ +#define __EFI_HTTP_BOOT_CALLBACK_H__ + +#define EFI_HTTP_BOOT_CALLBACK_PROTOCOL_GUID \ + { \ + 0xba23b311, 0x343d, 0x11e6, {0x91, 0x85, 0x58, 0x20, 0xb1, 0xd6, 0x52,= 0x99} \ + } + +typedef struct _EFI_HTTP_BOOT_CALLBACK_PROTOCOL EFI_HTTP_BOOT_CALLBACK_PR= OTOCOL; + +/// +/// EFI_HTTP_BOOT_CALLBACK_DATA_TYPE +/// +typedef enum { + /// + /// Data points to a DHCP4 packet which is about to transmit or has rece= ived. + /// + HttpBootDhcp4, + /// + /// Data points to a DHCP6 packet which is about to be transmit or has r= eceived. + /// + HttpBootDhcp6, + /// + /// Data points to an EFI_HTTP_MESSAGE structure, whichcontians a HTTP r= equest message + /// to be transmitted. + /// + HttpBootHttpRequest, + /// + /// Data points to an EFI_HTTP_MESSAGE structure, which contians a recei= ved HTTP=20 + /// response message. + /// + HttpBootHttpResponse, + /// + /// Part of the entity body has been received from the HTTP server. Data= points to the + /// buffer of the entity body data. + /// + HttpBootHttpEntityBody, + HttpBootTypeMax +} EFI_HTTP_BOOT_CALLBACK_DATA_TYPE; + +/** + Callback function that is invoked when the HTTP Boot driver is about to = transmit or has received a + packet. + + This function is invoked when the HTTP Boot driver is about to transmit = or has received packet. + Parameters DataType and Received specify the type of event and the forma= t of the buffer pointed + to by Data. Due to the polling nature of UEFI device drivers, this callb= ack function should not + execute for more than 5 ms. + The returned status code determines the behavior of the HTTP Boot driver. + + @param[in] This Pointer to the EFI_HTTP_BOOT_CALLBACK_PR= OTOCOL instance. + @param[in] DataType The event that occurs in the current sta= te. + @param[in] Received TRUE if the callback is being invoked du= e to a receive event. + FALSE if the callback is being invoked d= ue to a transmit event. + @param[in] DataLength The length in bytes of the buffer pointe= d to by Data. + @param[in] Data A pointer to the buffer of data, the dat= a type is specified by + DataType. + =20 + @retval EFI_SUCCESS Tells the HTTP Boot driver to continue t= he HTTP Boot process. + @retval EFI_ABORTED Tells the HTTP Boot driver to abort the = current HTTP Boot process. +**/ +typedef +EFI_STATUS +(EFIAPI * EFI_HTTP_BOOT_CALLBACK) ( + IN EFI_HTTP_BOOT_CALLBACK_PROTOCOL *This, + IN EFI_HTTP_BOOT_CALLBACK_DATA_TYPE DataType, + IN BOOLEAN Received, + IN UINT32 DataLength, + IN VOID *Data OPTIONAL + ); + +/// +/// EFI HTTP Boot Callback Protocol is invoked when the HTTP Boot driver i= s about to transmit or=20 +/// has received a packet. The EFI HTTP Boot Callback Protocol must be ins= talled on the same handle +/// as the Load File Protocol for the HTTP Boot. +/// +struct _EFI_HTTP_BOOT_CALLBACK_PROTOCOL { + EFI_HTTP_BOOT_CALLBACK Callback; +}; + +extern EFI_GUID gEfiHttpBootCallbackProtocolGuid; + +#endif diff --git a/MdePkg/MdePkg.dec b/MdePkg/MdePkg.dec index 7a7504b7a3..a55e8ce1d9 100644 --- a/MdePkg/MdePkg.dec +++ b/MdePkg/MdePkg.dec @@ -2,7 +2,7 @@ # This Package provides all definitions, library classes and libraries ins= tances. # # It also provides the definitions(including PPIs/PROTOCOLs/GUIDs) of -# EFI1.10/UEFI2.6/PI1.4 and some Industry Standards. +# EFI1.10/UEFI2.7/PI1.4 and some Industry Standards. # # Copyright (c) 2007 - 2017, Intel Corporation. All rights reserved.
# Portions copyright (c) 2008 - 2009, Apple Inc. All rights reserved.
@@ -1671,6 +1671,9 @@ ## Include/Protocol/BluetoothLeConfig.h gEfiBluetoothLeConfigProtocolGuid =3D { 0x8f76da58, 0x1f99, 0x42= 75, { 0xa4, 0xec, 0x47, 0x56, 0x51, 0x5b, 0x1c, 0xe8 } } =20 + ## Include/Protocol/HttpBootCallback.h + gEfiHttpBootCallbackProtocolGuid =3D {0xba23b311, 0x343d, 0x11e6, {0x9= 1, 0x85, 0x58, 0x20, 0xb1, 0xd6, 0x52, 0x99}} + # # Protocols defined in Shell2.0 # @@ -1685,7 +1688,7 @@ # ## Include/Protocol/ShellDynamicCommand.h gEfiShellDynamicCommandProtocolGuid =3D { 0x3c7200e9, 0x005f, 0x4ea4, {= 0x87, 0xde, 0xa3, 0xdf, 0xac, 0x8a, 0x27, 0xc3 }} - + =20 # # [Error.gEfiMdePkgTokenSpaceGuid] # 0x80000001 | Invalid value provided. --=20 2.13.0.windows.1 _______________________________________________ edk2-devel mailing list edk2-devel@lists.01.org https://lists.01.org/mailman/listinfo/edk2-devel