From nobody Wed Dec 31 08:44:52 2025 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 vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id ED21DC4332F for ; Mon, 6 Nov 2023 10:12:23 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S229487AbjKFKMY (ORCPT ); Mon, 6 Nov 2023 05:12:24 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:35138 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229875AbjKFKMU (ORCPT ); Mon, 6 Nov 2023 05:12:20 -0500 Received: from mail-pf1-x436.google.com (mail-pf1-x436.google.com [IPv6:2607:f8b0:4864:20::436]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id F0541DB; Mon, 6 Nov 2023 02:12:17 -0800 (PST) Received: by mail-pf1-x436.google.com with SMTP id d2e1a72fcca58-6bf03b98b9bso4035346b3a.1; Mon, 06 Nov 2023 02:12:17 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1699265537; x=1699870337; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=xum/W7MJuOqob9sUjPMH2NvW74OGFL5uRCJzlfRnFqQ=; b=LW03H6sgHkyfpHjAcahw2n3R9t66SsDMV775Kq5wJeNvccD7zee71za9UI47VE6mvD orl0slm6CrCeslY+qy2AiNWyQDLwa6HWOqK6G0oDTbANWqRtqro224hELfVjZhVlPpLx LOvZ7os9K9TxALmvkHH7PJBzpEkbs3wJF5u4q3xV3cQq2ix2+jS8AqMxULZVOZJ0sBku wSMeo7Pe5Cgb3migCRuwbEZi8G3mi5Rpo4sqSVSKm8sBzHUdI434AjAZ0Gje17UGZ9XE wdUDAqTdOUkfsfcz4PXY6FSyqUY5BGHLbtuymmK1SBF34ou1vckp1oZ1pm5fF5k/xoHC 9j3w== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1699265537; x=1699870337; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=xum/W7MJuOqob9sUjPMH2NvW74OGFL5uRCJzlfRnFqQ=; b=bU2nwtLvjukhLgOseHhjHLAjWVCEnqPGGnkENSarbFCfYzjmiayRV67GKH5WpW+0aZ 25G0vlG1jMSBks5hVoOwA+tWHLlvSFmU3HKxGyi+LIMW8ePTpPTDagi1Sj8eX6iBXuzI HHbloofTOhLLL1jgXMCeo8oX/MD5Uwe54lQQPsfb6nCx5diGxf8OP/yiDfOoq9b2do8S +hfhvaFczpLvuhatUDVBIIWgPq5UGoYZ1V5I1bilC6jkHrrr+kxMvzsq7WAj5G0be2jg NuAlGqu9oXAFWnVnHTrxW17TYlngTXn498A5JCeiLmtc/wvr3tMXbp1MqxlEHLt/2hdd C0xQ== X-Gm-Message-State: AOJu0YwQhE272Qv+PHowKdTOILpB4Aufsdp1fNuiul+wmLH8A01qSdhW 6UXVt/yEscgXRrE/TiCjVRE= X-Google-Smtp-Source: AGHT+IELufpf/afAfT2Z7Touti4YQrWwKv1deBMsWqtCBLnXQXbzuPzjEsbciqxS97VmWcBRlb27pA== X-Received: by 2002:a05:6a20:9390:b0:159:e4ab:15ce with SMTP id x16-20020a056a20939000b00159e4ab15cemr15313432pzh.15.1699265537393; Mon, 06 Nov 2023 02:12:17 -0800 (PST) Received: from debian.me ([103.131.18.64]) by smtp.gmail.com with ESMTPSA id q4-20020a056a0002a400b006be4bb0d2dcsm5529216pfs.149.2023.11.06.02.12.16 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 06 Nov 2023 02:12:16 -0800 (PST) Received: by debian.me (Postfix, from userid 1000) id 8B301803540B; Mon, 6 Nov 2023 17:12:10 +0700 (WIB) From: Bagas Sanjaya To: Linux Kernel Mailing List , Linux Documentation Cc: Thomas Gleixner , Ingo Molnar , Borislav Petkov , Dave Hansen , x86@kernel.org, "H. Peter Anvin" , Jonathan Corbet , Ross Philipson , Daniel Kiper , Konrad Rzeszutek Wilk , Ard Biesheuvel , Bagas Sanjaya Subject: [PATCH 1/2] Documentation: x86: Indent note directive for protocol version number note Date: Mon, 6 Nov 2023 17:12:04 +0700 Message-ID: <20231106101206.76487-2-bagasdotme@gmail.com> X-Mailer: git-send-email 2.42.0 In-Reply-To: <20231106101206.76487-1-bagasdotme@gmail.com> References: <20231106101206.76487-1-bagasdotme@gmail.com> MIME-Version: 1.0 X-Developer-Signature: v=1; a=openpgp-sha256; l=1245; i=bagasdotme@gmail.com; h=from:subject; bh=0AsYoOImK8yW9QMJSvMT7LCOsE3kSASqZ9Au0ZMrQ+I=; b=owGbwMvMwCX2bWenZ2ig32LG02pJDKkeu/tMQgvmiRbX31xtvJnR69a8J8wL+p2d772ZJldqJ xI55cPNjlIWBjEuBlkxRZZJiXxNp3cZiVxoX+sIM4eVCWQIAxenAEzk1k5GhgkWZya78SyT2Tth xs4iN+3gJd7xlk45q8Mrpvud3hq9KJWRYcN78dxVl7LvnZS7EC2v6mQZwXtQz8tz0wOpTfMZLzl N5wAA X-Developer-Key: i=bagasdotme@gmail.com; a=openpgp; fpr=701B806FDCA5D3A58FFB8F7D7C276C64A5E44A1D Content-Transfer-Encoding: quoted-printable Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Type: text/plain; charset="utf-8" The protocol version number note is between protocol version table and memory layout section. As such, Sphinx renders the note directive not only on the actual note, but until the end of doc. Indent the directive so that only the actual protocol version number note is rendered as such. Fixes: 2c33c27fd603 ("x86/boot: Introduce kernel_info") Signed-off-by: Bagas Sanjaya --- Documentation/arch/x86/boot.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Documentation/arch/x86/boot.rst b/Documentation/arch/x86/boot.= rst index f5d2f2414de8b6..22cc7a040dae05 100644 --- a/Documentation/arch/x86/boot.rst +++ b/Documentation/arch/x86/boot.rst @@ -77,7 +77,7 @@ Protocol 2.14 BURNT BY INCORRECT COMMIT Protocol 2.15 (Kernel 5.5) Added the kernel_info and kernel_info.setup_typ= e_max. =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D =20 -.. note:: + .. note:: The protocol version number should be changed only if the setup header is changed. There is no need to update the version number if boot_par= ams or kernel_info are changed. Additionally, it is recommended to use --=20 An old man doll... just what I always wanted! - Clara From nobody Wed Dec 31 08:44:52 2025 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 vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 224AEC4167B for ; Mon, 6 Nov 2023 10:12:22 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S229972AbjKFKMW (ORCPT ); Mon, 6 Nov 2023 05:12:22 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:35134 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229715AbjKFKMU (ORCPT ); Mon, 6 Nov 2023 05:12:20 -0500 Received: from mail-ot1-x329.google.com (mail-ot1-x329.google.com [IPv6:2607:f8b0:4864:20::329]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 2D95DB8; Mon, 6 Nov 2023 02:12:17 -0800 (PST) Received: by mail-ot1-x329.google.com with SMTP id 46e09a7af769-6d2fedd836fso2857467a34.1; Mon, 06 Nov 2023 02:12:17 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1699265536; x=1699870336; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=W4r3fxaflm8Rb1r3UO8ZFUzVieAzzOq9dAGwIkPoNP4=; b=bLeFYjmxPXnL3CGCyLjaehGS89KXs2/loHij9r4ozwgnuaFwkiwbijCo3UfvoXnlDE iVdqooJ6DDS1qWEPV1k4KCvkwidbu79riNCNokyXTOE1FznPZ1G9vrEI49Xm61SuDkel /baXxJuH2lLLgB/qzpYPzYV3sQWWPQ/q2qOmCqt4IwXf0XbwXx6fmWY97y/VG7H2J2zC gGgXHcpJGmmwfoQljFp5nPcFtOpbu4DWeBAuJ8sVFZpaD03rbdgmOo1bvKJa9mUigykM zaS6LEtNvADTrKg/dp3yVgJwIPqXgpchu/Ex0cd+A2koKf40VZEXi8w4+J7db4O1Zu77 sHAw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1699265536; x=1699870336; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=W4r3fxaflm8Rb1r3UO8ZFUzVieAzzOq9dAGwIkPoNP4=; b=pXb+6kB2St/8UPTS5x4bNUTaJ5EesJcGtS9v9KkVqbtP536inwATGLCh1YUIQtDl1n 9G2uvDHee8eOmXzrBJJbRXuDINyBKealOPN3a2cgqpdZaMNIU7n715sqp+SAe4ycFcEr eNDAzxxEo6dttU+Rlyaqtqdhr9HGlsZRa45eq57k+e6J2hu7In4TIjlpyW72/t/hqsIN ikAEDkxCrregWITqrEWQUAsc8l5bQj1YcJNCwsqtqDbSZdwIMdvmFSFx/n6VoS4kpQCf +0eQLAYC+mqZQL1A54pw/Hvj55gJaIICiv3hQOsjyUg+mZNZM+9z7YEAIUTKtj1hTfHK N6/w== X-Gm-Message-State: AOJu0Yxt0kaJleEvqVkQn/ZzADCjevD4lEdgy7W2Z71ixrm5r9G8xJT0 DHvWefSEjAB+042wBnc7w04= X-Google-Smtp-Source: AGHT+IEG9SVOths7LJ3i0W/+eQV7ES3q00OVVfM8YXr6I9gSd7tf7n2fEHkU1qlVz6xt1wHLyOzQRw== X-Received: by 2002:a05:6830:4d8:b0:6b9:6a43:1f7c with SMTP id s24-20020a05683004d800b006b96a431f7cmr28606199otd.26.1699265536451; Mon, 06 Nov 2023 02:12:16 -0800 (PST) Received: from debian.me ([103.131.18.64]) by smtp.gmail.com with ESMTPSA id b3-20020a63cf43000000b0056c2f1a2f6bsm5185612pgj.41.2023.11.06.02.12.15 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 06 Nov 2023 02:12:15 -0800 (PST) Received: by debian.me (Postfix, from userid 1000) id 9E32080FD147; Mon, 6 Nov 2023 17:12:10 +0700 (WIB) From: Bagas Sanjaya To: Linux Kernel Mailing List , Linux Documentation Cc: Thomas Gleixner , Ingo Molnar , Borislav Petkov , Dave Hansen , x86@kernel.org, "H. Peter Anvin" , Jonathan Corbet , Ross Philipson , Daniel Kiper , Konrad Rzeszutek Wilk , Ard Biesheuvel , Bagas Sanjaya Subject: [PATCH 2/2] Documentation: x86: Wrap EFI handover deprecation in note block Date: Mon, 6 Nov 2023 17:12:05 +0700 Message-ID: <20231106101206.76487-3-bagasdotme@gmail.com> X-Mailer: git-send-email 2.42.0 In-Reply-To: <20231106101206.76487-1-bagasdotme@gmail.com> References: <20231106101206.76487-1-bagasdotme@gmail.com> MIME-Version: 1.0 X-Developer-Signature: v=1; a=openpgp-sha256; l=1659; i=bagasdotme@gmail.com; h=from:subject; bh=xpTSVbWHAAVOKSR7S+D95bM59pcWw6ryHRaMDExVMuE=; b=owGbwMvMwCX2bWenZ2ig32LG02pJDKkeu/vs15nunprjf7pgXoLQhjNenApeDwTFtoo87WG6G OosXT+xo5SFQYyLQVZMkWVSIl/T6V1GIhfa1zrCzGFlAhnCwMUpABMxk2L4p8jsO/P7i/XZ1fMd JdqnJEYEh82+m2n3JUymdHdn1OO9kxkZOq5tdul/sGlLB5PQjqwb2gF+u4t4LPw/WbkH5QfnLmv kBwA= X-Developer-Key: i=bagasdotme@gmail.com; a=openpgp; fpr=701B806FDCA5D3A58FFB8F7D7C276C64A5E44A1D Content-Transfer-Encoding: quoted-printable Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Type: text/plain; charset="utf-8" EFI handover protocol depreciation note is the only admonition in the doc that is written as normal paragraph instead. Use note:: block for that purpose. Fixes: 8b84769a7a15 ("Documentation/x86, efi/x86: Clarify EFI handover prot= ocol and its requirements") Signed-off-by: Bagas Sanjaya --- Documentation/arch/x86/boot.rst | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/Documentation/arch/x86/boot.rst b/Documentation/arch/x86/boot.= rst index 22cc7a040dae05..67cbb75cea6fdf 100644 --- a/Documentation/arch/x86/boot.rst +++ b/Documentation/arch/x86/boot.rst @@ -1432,7 +1432,8 @@ The boot loader *must* fill out the following fields = in bp:: =20 All other fields should be zero. =20 -NOTE: The EFI Handover Protocol is deprecated in favour of the ordinary PE= /COFF +.. note:: + The EFI Handover Protocol is deprecated in favour of the ordinary PE= /COFF entry point, combined with the LINUX_EFI_INITRD_MEDIA_GUID based ini= trd loading protocol (refer to [0] for an example of the bootloader side= of this), which removes the need for any knowledge on the part of the E= FI @@ -1440,4 +1441,4 @@ NOTE: The EFI Handover Protocol is deprecated in favo= ur of the ordinary PE/COFF requirements/limitations regarding the placement of the command line and ramdisk in memory, or the placement of the kernel image itself. =20 -[0] https://github.com/u-boot/u-boot/commit/ec80b4735a593961fe701cc3a5d717= d4739b0fd0 + [0] https://github.com/u-boot/u-boot/commit/ec80b4735a593961fe701cc3= a5d717d4739b0fd0 --=20 An old man doll... just what I always wanted! - Clara