Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.lore.kernel.org (Postfix) with ESMTPS id 01C4ACCA471 for ; Fri, 3 Oct 2025 17:36:28 +0000 (UTC) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1v4jge-0002Zr-88; Fri, 03 Oct 2025 13:35:21 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1v4jgE-0002Fu-Mi for grub-devel@gnu.org; Fri, 03 Oct 2025 13:34:54 -0400 Received: from mx0a-001b2d01.pphosted.com ([148.163.156.1]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1v4jg0-0003qO-U1 for grub-devel@gnu.org; Fri, 03 Oct 2025 13:34:53 -0400 Received: from pps.filterd (m0360083.ppops.net [127.0.0.1]) by mx0a-001b2d01.pphosted.com (8.18.1.2/8.18.1.2) with ESMTP id 593EgxBZ010564; Fri, 3 Oct 2025 17:34:35 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=ibm.com; h=cc :content-transfer-encoding:date:from:in-reply-to:message-id :mime-version:references:subject:to; s=pp1; bh=uXixH0LaSVey3NC9S X1TGE+2jPgWYU9GVeQYOzv4v7A=; b=PLkqvisOIO3I7uA9y4e8wXDvNFZ8lKxTY BrN9+A71UWOs1AVNr/kcukkascYour00q7+FbLV8dXewbDNSgWbngtTf2QiwQAlX SQT7dnOh6gLle+zugutHwfc6nUwLW+63uy8C61oWtio5OhkruCIFACewADQBAvUK ji0DakSQodWBsKABSjDsBqHCB5rEixO5x24DqfJVIackVPmKTU73gOoAvg/RDtrO HMzdk0x/XQSQSE2YgxS3Tz5ayoSn47w7v9StHiz7B8QA6svfQ9qLjET2qXGAaCFI x4rAXmifaRrl2SsG1Iz+1uyZ0mTh+JsWubnf/8g4BS4GL4jH7/YiA== Received: from ppma11.dal12v.mail.ibm.com (db.9e.1632.ip4.static.sl-reverse.com [50.22.158.219]) by mx0a-001b2d01.pphosted.com (PPS) with ESMTPS id 49e7e7vwtj-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT); Fri, 03 Oct 2025 17:34:35 +0000 (GMT) Received: from pps.filterd (ppma11.dal12v.mail.ibm.com [127.0.0.1]) by ppma11.dal12v.mail.ibm.com (8.18.1.2/8.18.1.2) with ESMTP id 593F5eG0024157; Fri, 3 Oct 2025 17:34:34 GMT Received: from smtprelay05.fra02v.mail.ibm.com ([9.218.2.225]) by ppma11.dal12v.mail.ibm.com (PPS) with ESMTPS id 49evy1krpx-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT); Fri, 03 Oct 2025 17:34:34 +0000 Received: from smtpav06.fra02v.mail.ibm.com (smtpav06.fra02v.mail.ibm.com [10.20.54.105]) by smtprelay05.fra02v.mail.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id 593HYVhj56361362 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Fri, 3 Oct 2025 17:34:31 GMT Received: from smtpav06.fra02v.mail.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 0A97C20049; Fri, 3 Oct 2025 17:34:31 +0000 (GMT) Received: from smtpav06.fra02v.mail.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 63CD920040; Fri, 3 Oct 2025 17:34:28 +0000 (GMT) Received: from localhost.localdomain (unknown [9.124.213.155]) by smtpav06.fra02v.mail.ibm.com (Postfix) with ESMTP; Fri, 3 Oct 2025 17:34:28 +0000 (GMT) From: Sudhakar Kuppusamy To: grub-devel@gnu.org Cc: dja@axtens.net, jan.setjeeilers@oracle.com, julian.klode@canonical.com, mate.kukri@canonical.com, pjones@redhat.com, msuchanek@suse.com, mlewando@redhat.com, stefanb@linux.ibm.com, avnish@linux.ibm.com, nayna@linux.ibm.com, ssrish@linux.ibm.com, Sudhakar Kuppusamy , sridharm@linux.ibm.com, Daniel Kiper Subject: [PATCH v17 19/20] docs/grub: Document signing GRUB with an appended signature Date: Fri, 3 Oct 2025 23:01:05 +0530 Message-ID: <20251003173108.8449-20-sudhakar@linux.ibm.com> X-Mailer: git-send-email 2.50.1 In-Reply-To: <20251003173108.8449-1-sudhakar@linux.ibm.com> References: <20251003173108.8449-1-sudhakar@linux.ibm.com> MIME-Version: 1.0 X-TM-AS-GCONF: 00 X-Proofpoint-ORIG-GUID: 8L5_YKiyn2zTP1k8koHBVzC5k8EpZszz X-Proofpoint-Spam-Details-Enc: AW1haW4tMjUwOTI3MDAyMCBTYWx0ZWRfXxP1RODWw5Ypr P3crv67YblKnuTW/eB6M5W0uO8pUqOTA7BYKaTw1nuyMeZ7x3j3ZOQ0yf75XECcyNgka/YfZWD5 2WWiw/FYdz8rgvzcwPeXxIqLTQ33nakXVLsak/baNW0h0VaE9RMIE/0NbwkkfgR6lgv9yf1wxH1 Y2eQBt4h6YpBwNB+kNuiwlRmFqULqLlR/SfntQX/tzXj2boCGC1Qibqg3hn4NBQUKjvupWDli5F UQ4z3bdC4r4tp9klYgR9rxeBlm2Yu8iSSR6ub9N2nx7c6OHIgdB9NVrgXjeWtniiVBOpBnIryVv a4Vdu0JtU3u9lXnEcBq5BbHDjYmLgWDYOFarCoRei78k8ZUvb+1Zxe4Q6bVguu3AatQpXcfIZy9 AZh1otJvjSQcZmOc1ljJOxzpwK1bAQ== X-Proofpoint-GUID: 8L5_YKiyn2zTP1k8koHBVzC5k8EpZszz X-Authority-Analysis: v=2.4 cv=Jvj8bc4C c=1 sm=1 tr=0 ts=68e0092b cx=c_pps a=aDMHemPKRhS1OARIsFnwRA==:117 a=aDMHemPKRhS1OARIsFnwRA==:17 a=x6icFKpwvdMA:10 a=JuTF4qcAAAAA:8 a=VnNF1IyMAAAA:8 a=yPCof4ZbAAAA:8 a=BlRlUMKLR4rfvJ7WqM8A:9 a=WlT8qwTXB_Kj6um4hl3b:22 a=cPQSjfK2_nFv0Q5t_7PE:22 X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.293,Aquarius:18.0.1117,Hydra:6.1.9,FMLib:17.12.80.40 definitions=2025-10-03_05,2025-10-02_03,2025-03-28_01 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 lowpriorityscore=0 malwarescore=0 priorityscore=1501 impostorscore=0 suspectscore=0 phishscore=0 bulkscore=0 clxscore=1015 spamscore=0 adultscore=0 classifier=typeunknown authscore=0 authtc= authcc= route=outbound adjust=0 reason=mlx scancount=1 engine=8.19.0-2509150000 definitions=main-2509270020 Received-SPF: pass client-ip=148.163.156.1; envelope-from=sudhakar@linux.ibm.com; helo=mx0a-001b2d01.pphosted.com X-Spam_score_int: -26 X-Spam_score: -2.7 X-Spam_bar: -- X-Spam_report: (-2.7 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_LOW=-0.7, RCVD_IN_MSPIKE_H4=0.001, RCVD_IN_MSPIKE_WL=0.001, RCVD_IN_VALIDITY_CERTIFIED_BLOCKED=0.001, RCVD_IN_VALIDITY_RPBL_BLOCKED=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: grub-devel@gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: The development of GNU GRUB List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Reply-To: The development of GNU GRUB Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Errors-To: grub-devel-bounces+grub-devel=archiver.kernel.org@gnu.org Sender: grub-devel-bounces+grub-devel=archiver.kernel.org@gnu.org U2lnbmluZyBHUlVCIGZvciBmaXJtd2FyZSB0aGF0IHZlcmlmaWVzIGFuIGFwcGVuZGVkIHNpZ25h dHVyZSBpcyBhCmJpdCBmaWRkbHkuIEkgZG9uJ3Qgd2FudCBwZW9wbGUgdG8gaGF2ZSB0byBmaWd1 cmUgaXQgb3V0IGZyb20gc2NyYXRjaApzbyBkb2N1bWVudCBpdCBoZXJlLgoKU2lnbmVkLW9mZi1i eTogRGFuaWVsIEF4dGVucyA8ZGphQGF4dGVucy5uZXQ+ClNpZ25lZC1vZmYtYnk6IFN1ZGhha2Fy IEt1cHB1c2FteSA8c3VkaGFrYXJAbGludXguaWJtLmNvbT4KUmV2aWV3ZWQtYnk6IFN0ZWZhbiBC ZXJnZXIgPHN0ZWZhbmJAbGludXguaWJtLmNvbT4KUmV2aWV3ZWQtYnk6IEF2bmlzaCBDaG91aGFu IDxhdm5pc2hAbGludXguaWJtLmNvbT4KUmV2aWV3ZWQtYnk6IERhbmllbCBLaXBlciA8ZGFuaWVs LmtpcGVyQG9yYWNsZS5jb20+Ci0tLQogZG9jcy9ncnViLnRleGkgfCA5NSArKysrKysrKysrKysr KysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKwogMSBmaWxlIGNoYW5nZWQsIDk1 IGluc2VydGlvbnMoKykKCmRpZmYgLS1naXQgYS9kb2NzL2dydWIudGV4aSBiL2RvY3MvZ3J1Yi50 ZXhpCmluZGV4IGI3OTZiNDc5Ni4uYzQ2MmM2OGU3IDEwMDY0NAotLS0gYS9kb2NzL2dydWIudGV4 aQorKysgYi9kb2NzL2dydWIudGV4aQpAQCAtOTYxMSw2ICs5NjExLDEwMSBAQCBpbWFnZSB3b3Jr cyB1bmRlciBVRUZJIHNlY3VyZSBib290IGFuZCBjYW4gbWFpbnRhaW4gdGhlIHNlY3VyZS1ib290 IGNoYWluLiBJdAogd2lsbCBhbHNvIGJlIG5lY2Vzc2FyeSB0byBlbnJvbGwgdGhlIHB1YmxpYyBr ZXkgdXNlZCBpbnRvIGEgcmVsZXZhbnQgZmlybXdhcmUKIGtleSBkYXRhYmFzZS4KIAorQHNlY3Rp b24gU2lnbmluZyBHUlVCIHdpdGggYW4gYXBwZW5kZWQgc2lnbmF0dXJlCitUaGUgQGZpbGV7Y29y ZS5lbGZ9IGl0c2VsZiBjYW4gYmUgc2lnbmVkIHdpdGggYSBMaW51eCBrZXJuZWwgbW9kdWxlLXN0 eWxlCithcHBlbmRlZCBzaWduYXR1cmUgKEBweHJlZntVc2luZyBhcHBlbmRlZCBzaWduYXR1cmVz fSkuCitUbyBzdXBwb3J0IElFRUUxMjc1IHBsYXRmb3JtcyB3aGVyZSB0aGUgYm9vdCBpbWFnZSBp cyBvZnRlbiBsb2FkZWQgZGlyZWN0bHkKK2Zyb20gYSBkaXNrIHBhcnRpdGlvbiByYXRoZXIgdGhh biBmcm9tIGEgZmlsZSBzeXN0ZW0sIHRoZSBAZmlsZXtjb3JlLmVsZn0KK2NhbiBzcGVjaWZ5IHRo ZSBzaXplIGFuZCBsb2NhdGlvbiBvZiB0aGUgYXBwZW5kZWQgc2lnbmF0dXJlIHdpdGggYW4gRUxG CitOb3RlIGFkZGVkIGJ5IEBjb21tYW5ke2dydWItaW5zdGFsbH0gb3IgQGNvbW1hbmR7Z3J1Yi1t a2ltYWdlfS4KK0FuIGltYWdlIGNhbiBiZSBzaWduZWQgdGhpcyB3YXkgdXNpbmcgdGhlIEBjb21t YW5ke3NpZ24tZmlsZX0gY29tbWFuZCBmcm9tCit0aGUgTGludXgga2VybmVsOgorCitAaXRlbWl6 ZQorQGl0ZW0gU2lnbmluZyBhIEdSVUIgaW1hZ2UgdXNpbmcgYSBzaW5nbGUgc2lnbmVyIGtleS4g VGhlIGdydWIua2V5IGlzIHlvdXIKK3ByaXZhdGUga2V5IHVzZWQgZm9yIEdSVUIgc2lnbmluZywg Z3J1Yi5kZXIgaXMgYSBjb3JyZXNwb25kaW5nIHB1YmxpYyBrZXkKKyhjZXJ0aWZpY2F0ZSkgdXNl ZCBmb3IgR1JVQiBzaWduYXR1cmUgdmVyaWZpY2F0aW9uLCBhbmQgdGhlIGtlcm5lbC5kZXIgaXMK K3lvdXIgcHVibGljIGtleSAoY2VydGlmaWNhdGUpIHVzZWQgZm9yIGtlcm5lbCBzaWduYXR1cmUg dmVyaWZpY2F0aW9uLgorQGV4YW1wbGUKK0Bncm91cAorIyBEZXRlcm1pbmUgdGhlIHNpemUgb2Yg dGhlIGFwcGVuZGVkIHNpZ25hdHVyZS4gSXQgZGVwZW5kcyBvbiB0aGUKKyMgc2lnbmluZyBrZXkg YW5kIHRoZSBoYXNoIGFsZ29yaXRobS4KKyMKKyMgU2lnbmluZyAvZGV2L251bGwgd2l0aCBhbiBh cHBlbmRlZCBzaWduYXR1cmUuCisKK3NpZ24tZmlsZSBTSEEyNTYgZ3J1Yi5rZXkgZ3J1Yi5kZXIg L2Rldi9udWxsIC4vZW1wdHkuc2lnCisKKyMgQnVpbGQgYSBHUlVCIGltYWdlIGZvciB0aGUgc2ln bmF0dXJlLgorCitncnViLW1raW1hZ2UgLU8gcG93ZXJwYy1pZWVlMTI3NSAtbyBjb3JlLmVsZi51 bnNpZ25lZCAteCBrZXJuZWwuZGVyIFwKKyAgLXAgL2dydWIgLS1hcHBlbmRlZC1zaWduYXR1cmUt c2l6ZSAkKHN0YXQgLWMgJyVzJyAuL2VtcHR5LnNpZykgXAorICAtLW1vZHVsZXM9ImFwcGVuZGVk c2lnIC4uLiIgLi4uCisKKyMgUmVtb3ZlIHRoZSBzaWduYXR1cmUgZmlsZS4KKworcm0gLi9lbXB0 eS5zaWcKKworIyBTaWduaW5nIGEgR1JVQiBpbWFnZSB3aXRoIGFuIGFwcGVuZGVkIHNpZ25hdHVy ZS4KKworc2lnbi1maWxlIFNIQTI1NiBncnViLmtleSBncnViLmRlciBjb3JlLmVsZi51bnNpZ25l ZCBjb3JlLmVsZi5zaWduZWQKKworQGVuZCBncm91cAorQGVuZCBleGFtcGxlCitAaXRlbSBTaWdu aW5nIGEgR1JVQiBpbWFnZSB1c2luZyBtb3JlIHRoYW4gb25lIHNpZ25lciBrZXkuIFRoZSBncnVi MS5rZXkgYW5kCitncnViMi5rZXkgYXJlIHByaXZhdGUga2V5cyB1c2VkIGZvciBHUlVCIHNpZ25p bmcsIGdydWIxLmRlciBhbmQgZ3J1YjIuZGVyCithcmUgY29ycmVzcG9uZGluZyBwdWJsaWMga2V5 cyAoY2VydGlmaWNhdGVzKSB1c2VkIGZvciBHUlVCIHNpZ25hdHVyZSB2ZXJpZmljYXRpb24uCitU aGUga2VybmVsMS5kZXIgYW5kIGtlcm5lbDIuZGVyIGFyZSB5b3VyIHB1YmxpYyBrZXlzIChjZXJ0 aWZpY2F0ZXMpIHVzZWQgZm9yCitrZXJuZWwgc2lnbmF0dXJlIHZlcmlmaWNhdGlvbi4KK0BleGFt cGxlCitAZ3JvdXAKKyMgR2VuZXJhdGUgYSBzaWduYXR1cmUgYnkgc2lnbmluZyAvZGV2L251bGwu CisKK29wZW5zc2wgY21zIC1zaWduIC1iaW5hcnkgLW5vY2VydHMgLWluIC9kZXYvbnVsbCAtc2ln bmVyIFwKKyAgZ3J1YjEuZGVyIC1pbmtleSBncnViMS5rZXkgLXNpZ25lciBncnViMi5kZXIgLWlu a2V5IGdydWIyLmtleSBcCisgIC1vdXQgLi9lbXB0eS5wN3MgLW91dGZvcm0gREVSIC1ub2F0dHIg LW1kIHNoYTI1NgorCisjIFRvIGJlIGFibGUgdG8gZGV0ZXJtaW5lIHRoZSBzaXplIG9mIGFuIGFw cGVuZGVkIHNpZ25hdHVyZSwgc2lnbiBhbgorIyBlbXB0eSBmaWxlICgvZGV2L251bGwpIHRvIHdo aWNoIGEgc2lnbmF0dXJlIHdpbGwgYmUgYXBwZW5kZWQgdG8uCisKK3NpZ24tZmlsZSAtcyAuL2Vt cHR5LnA3cyBzaGEyNTYgL2Rldi9udWxsIC9kZXYvbnVsbCAuL2VtcHR5LnNpZworCisjIEJ1aWxk IGEgR1JVQiBpbWFnZSBmb3IgdGhlIHNpZ25hdHVyZS4KKworZ3J1Yi1ta2ltYWdlIC1PIHBvd2Vy cGMtaWVlZTEyNzUgLW8gY29yZS5lbGYudW5zaWduZWQgLXgga2VybmVsMS5kZXIgXAorICBrZXJu ZWwyLmRlciAtcCAvZ3J1YiAtLWFwcGVuZGVkLXNpZ25hdHVyZS1zaXplICQoc3RhdCAtYyAnJXMn IC4vZW1wdHkuc2lnKSBcCisgIC0tbW9kdWxlcz0iYXBwZW5kZWRzaWcgLi4uIiAuLi4KKworIyBS ZW1vdmUgdGhlIHNpZ25hdHVyZSBmaWxlcy4KKworcm0gLi9lbXB0eS5zaWcgLi9lbXB0eS5wN3MK KworIyBHZW5lcmF0ZSBhIHJhdyBzaWduYXR1cmUgZm9yIEdSVUIgaW1hZ2Ugc2lnbmluZyB1c2lu ZyBPcGVuU1NMLgorCitvcGVuc3NsIGNtcyAtc2lnbiAtYmluYXJ5IC1ub2NlcnRzIC1pbiBjb3Jl LmVsZi51bnNpZ25lZCAtc2lnbmVyIFwKKyAgZ3J1YjEuZGVyIC1pbmtleSBncnViMS5rZXkgLXNp Z25lciBncnViMi5kZXIgLWlua2V5IGdydWIyLmtleSBcCisgIC1vdXQgY29yZS5wN3MgLW91dGZv cm0gREVSIC1ub2F0dHIgLW1kIHNoYTI1NgorCisjIFNpZ24gYSBHUlVCIGltYWdlIHRvIGdldCBh biBpbWFnZSBmaWxlIHdpdGggYW4gYXBwZW5kZWQgc2lnbmF0dXJlLgorCitzaWduLWZpbGUgLXMg Y29yZS5wN3Mgc2hhMjU2IC9kZXYvbnVsbCBjb3JlLmVsZi51bnNpZ25lZCBjb3JlLmVsZi5zaWdu ZWQKKworQGVuZCBncm91cAorQGVuZCBleGFtcGxlCitAaXRlbSBEb24ndCBmb3JnZXQgdG8gaW5z dGFsbCB0aGUgc2lnbmVkIGltYWdlIGFzIHJlcXVpcmVkCisoZS5nLiBvbiBwb3dlcnBjLWllZWUx Mjc1LCB0byB0aGUgUFJlUCBwYXJ0aXRpb24pLgorQGV4YW1wbGUKK0Bncm91cAorIyBJbnN0YWxs IHNpZ25lZCBHUlVCIGltYWdlIHRvIHRoZSBQUmVQIHBhcnRpdGlvbiBvbiBwb3dlcnBjLWllZWUx Mjc1CisKK2RkIGlmPWNvcmUuZWxmLnNpZ25lZCBvZj0vZGV2L3NkYTEKKworQGVuZCBncm91cAor QGVuZCBleGFtcGxlCitAZW5kIGl0ZW1pemUKKworQXMgd2l0aCBVRUZJIHNlY3VyZSBib290LCBp dCBpcyBuZWNlc3NhcnkgdG8gYnVpbGQtaW4gdGhlIHJlcXVpcmVkIG1vZHVsZXMsCitvciBzaWdu IHRoZW0gaWYgdGhleSBhcmUgbm90IHBhcnQgb2YgdGhlIEdSVUIgaW1hZ2UuCisKIEBub2RlIFBs YXRmb3JtIGxpbWl0YXRpb25zCiBAY2hhcHRlciBQbGF0Zm9ybSBsaW1pdGF0aW9ucwogCi0tIAoy LjUwLjEgKEFwcGxlIEdpdC0xNTUpCgoKX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19f X19fX19fX19fX19fX18KR3J1Yi1kZXZlbCBtYWlsaW5nIGxpc3QKR3J1Yi1kZXZlbEBnbnUub3Jn Cmh0dHBzOi8vbGlzdHMuZ251Lm9yZy9tYWlsbWFuL2xpc3RpbmZvL2dydWItZGV2ZWwK