From nobody Fri Mar 29 05:57:46 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of groups.io designates 66.175.222.108 as permitted sender) client-ip=66.175.222.108; envelope-from=bounce+27952+85336+1787277+3901457@groups.io; helo=mail02.groups.io; Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of groups.io designates 66.175.222.108 as permitted sender) smtp.mailfrom=bounce+27952+85336+1787277+3901457@groups.io; dmarc=fail(p=none dis=none) header.from=gmail.com ARC-Seal: i=1; a=rsa-sha256; t=1641605576; cv=none; d=zohomail.com; s=zohoarc; b=HYJM3hkJYbscm5qOxIB7AUWHmD4V4zgl4w3kfEK2GWBGAb4bzKkC9q7daagFwWWztC9m2tz7YJYpc1axcYk95NAQ4m8+YaQgcvppwlTEoCE4VzXJK/mFJsdpl7X9vQPq/VfCQm0F594O/V+oWXYB3Im0LwSfhJ7XJ3qEJYH2sZY= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1641605576; h=Content-Transfer-Encoding:Cc:Date:From:In-Reply-To:List-Subscribe:List-Id:List-Help:List-Unsubscribe:MIME-Version:Message-ID:Reply-To:References:Sender:Subject:To; bh=5aNMxD9r4qoO6MtTLMp9Y5Wmhp15vcYlegn+6jV2fwI=; b=TAIdCWJzJPpkDONDYYV8pvrchveird2Yt+jksdDuldGx/KGf7ToAmxkliPLZkDU+DYRtWAvPOZ5M5zLdbE3AAvH4dDHE9HXhFU1B1QN/gZI4XFpNUK5NoMEi9lchWvVh5g+zCjaZS1DzvrQqBcdQBKK29xR3XQlUJl+CUQuoTJQ= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of groups.io designates 66.175.222.108 as permitted sender) smtp.mailfrom=bounce+27952+85336+1787277+3901457@groups.io; dmarc=fail header.from= (p=none dis=none) Received: from mail02.groups.io (mail02.groups.io [66.175.222.108]) by mx.zohomail.com with SMTPS id 1641605576662875.7422142344502; Fri, 7 Jan 2022 17:32:56 -0800 (PST) Return-Path: X-Received: by 127.0.0.2 with SMTP id VKJGYY1788612xStH5xJrvK9; Fri, 07 Jan 2022 17:32:56 -0800 X-Received: from mail-pf1-f175.google.com (mail-pf1-f175.google.com [209.85.210.175]) by mx.groups.io with SMTP id smtpd.web08.1032.1641605575544748442 for ; Fri, 07 Jan 2022 17:32:55 -0800 X-Received: by mail-pf1-f175.google.com with SMTP id m1so6676621pfk.8 for ; Fri, 07 Jan 2022 17:32:55 -0800 (PST) X-Gm-Message-State: oS3aNNGziR9CLmtdk1VXpjHFx1787277AA= X-Google-Smtp-Source: ABdhPJyyLoZWSSFqUBuBvGJbORQSrliyPKnbEvUNA3tCGjkHFCrw4wckvXD4+8PvnBfzGvgQJcVstA== X-Received: by 2002:a63:950b:: with SMTP id p11mr12889614pgd.475.1641605574943; Fri, 07 Jan 2022 17:32:54 -0800 (PST) X-Received: from localhost.localdomain ([50.35.74.198]) by smtp.gmail.com with ESMTPSA id h19sm151784pfh.112.2022.01.07.17.32.54 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 07 Jan 2022 17:32:54 -0800 (PST) From: "Kun Qin" To: devel@edk2.groups.io Cc: Andrew Fish , Leif Lindholm , Michael D Kinney , Liming Gao , Zhiguang Liu Subject: [edk2-devel] [PATCH v2 1/2] EDK2 Code First: PI Specification: New error codes of Host Software class Date: Fri, 7 Jan 2022 17:32:41 -0800 Message-Id: <20220108013242.2030-2-kuqin12@gmail.com> In-Reply-To: <20220108013242.2030-1-kuqin12@gmail.com> References: <20220108013242.2030-1-kuqin12@gmail.com> MIME-Version: 1.0 Precedence: Bulk List-Unsubscribe: List-Subscribe: List-Help: Sender: devel@edk2.groups.io List-Id: Mailing-List: list devel@edk2.groups.io; contact devel+owner@edk2.groups.io Reply-To: devel@edk2.groups.io,kuqin12@gmail.com Content-Transfer-Encoding: quoted-printable DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=groups.io; q=dns/txt; s=20140610; t=1641605576; bh=GGBflhp06FkaPjcMXNs1dnhaPNTHa8scWjaYPXwvrRE=; h=Cc:Date:From:Reply-To:Subject:To; b=mJbIJjYuBrxWyCO4J9OpdPRVrvqeb9b9I3AMXcR956y22sZuwnhdyKhuSuyDoIkorut 95oiRiAvPlNVphi6+ZZ3wyELqmPpXJqIL6r5jlTPnDCT2Zs3oV0K6u1YXRftJoQukSk83 7Ly5LtLWuAEDZ0QTroIve63yR9TLZhTItGA= X-ZohoMail-DKIM: pass (identity @groups.io) X-ZM-MESSAGEID: 1641605577834100004 Content-Type: text/plain; charset="utf-8" REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3D3794 This change includes specification update markdown file that describes the proposed PI Specification v1.7 Errata A in detail and potential impact to the existing codebase. Cc: Andrew Fish Cc: Leif Lindholm Cc: Michael D Kinney Cc: Liming Gao Cc: Zhiguang Liu Signed-off-by: Kun Qin --- Notes: v2: - Removed "RELEASE_ASSERT" definition - Removed reference to EDK2 based memory type info [Mike] CodeFirst/BZ3794-SpecChange.md | 55 ++++++++++++++++++++ 1 file changed, 55 insertions(+) diff --git a/CodeFirst/BZ3794-SpecChange.md b/CodeFirst/BZ3794-SpecChange.md new file mode 100644 index 000000000000..61a0be798d7f --- /dev/null +++ b/CodeFirst/BZ3794-SpecChange.md @@ -0,0 +1,55 @@ +# Title: Introduction of `EFI_SW_EC_FRAGMENTED_MEMORY_MAP` Status Code + +## Status: Draft + +## Document: UEFI Platform Initialization Specification Version 1.7 Errata= A + +## License + +SPDX-License-Identifier: CC-BY-4.0 + +## Submitter: [TianoCore Community](https://www.tianocore.org) + +## Summary of the change + +Add `EFI_SW_EC_FRAGMENTED_MEMORY_MAP` into Status Codes definition. + +## Benefits of the change + +Current Status Codes covered various [software class error code definition= s](https://github.com/tianocore/edk2/blob/master/MdePkg/Include/Pi/PiStatus= Code.h). + +However, fragmented memory map from boot to boot would fail to meet certai= n OS ACPI requirements (i.e. S4 resume boot requires consistent memory maps= ) and trigger system reboots. Yet the corresponding case was not covered by= the already defined status codes. + +The unexpected system reboots above could indicate decay of system health = and reporting of such generic events would provide helpful information to O= EMs to investigate/prevent system failures in general. + +The request of this change intends to expand definitions of `EFI_SW_EC_**`= under Status Codes to cover more unexpected system reboot events, which co= uld improve Status Code futility and readability. + +## Impact of the change + +Occupy a new macro definitions of Error Codes under Software class Status = Codes. + +## Detailed description of the change [normative updates] + +### Specification Changes + +1. In PI Specification v1.7 Errata A: Vol. 3, Table 3-61: Error Code Opera= tions: Host Software Class, add one new rows below `EFI_SW_EC_FV_CORRUPTED`= definition: + + | Operation | Description | Extended Data | + | --- | --- | --- | + | EFI_SW_EC_FRAGMENTED_MEMORY_MAP | System will reboot due to fragment= ed memory maps | None | + +1. In PI Specification v1.7 Errata A: Vol. 3, Table 3-61: Error Code Opera= tions: Host Software Class, replace the row of `0x0014-0x00FF` to: + + | Operation | Description | Extended Data | + | --- | --- | --- | + | 0x0015-0x00FF | Reserved for future use by this specification for Ho= st Software class error codes. | None | + +1. In PI Specification v1.7 Errata A: Vol. 3, Section 6.7.4.3 Error Code D= efinitions: Prototype, add one new definitions below `EFI_SW_EC_FV_CORRUPTE= D` definition: + + ```c + #define EFI_SW_EC_FRAGMENTED_MEMORY_MAP 0x00000014 + ``` + +### Code Changes + +1. Add macro definitions in `MdePkg/Include/Pi/PiStatusCode.h` to match ne= w specification. --=20 2.34.1.windows.1 -=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D- Groups.io Links: You receive all messages sent to this group. View/Reply Online (#85336): https://edk2.groups.io/g/devel/message/85336 Mute This Topic: https://groups.io/mt/88276263/1787277 Group Owner: devel+owner@edk2.groups.io Unsubscribe: https://edk2.groups.io/g/devel/unsub [importer@patchew.org] -=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-