From patchwork Tue Apr 15 13:20:54 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Leonard Anderweit X-Patchwork-Id: 61301 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 aws-us-west-2-korg-lkml-1.web.codeaurora.org (localhost.localdomain [127.0.0.1]) by smtp.lore.kernel.org (Postfix) with ESMTP id 16045C369AB for ; Tue, 15 Apr 2025 13:21:24 +0000 (UTC) Received: from EUR05-AM6-obe.outbound.protection.outlook.com (EUR05-AM6-obe.outbound.protection.outlook.com [40.107.22.125]) by mx.groups.io with SMTP id smtpd.web11.19899.1744723277521214053 for ; Tue, 15 Apr 2025 06:21:18 -0700 Authentication-Results: mx.groups.io; dkim=pass header.i=@phytec.de header.s=selector2 header.b=FKpn0TpN; spf=pass (domain: phytec.de, ip: 40.107.22.125, mailfrom: l.anderweit@phytec.de) ARC-Seal: i=1; a=rsa-sha256; s=arcselector10001; d=microsoft.com; cv=none; b=ipijFbW/Kg2kkbWeq75uZ/jvsyuqGC2oh3Wq7gPU2z5iPDzmF2ki6XtWmo5w4khyBmUlqeNgpaDlIZiE1v0f6Jf8UjUPR0lfJP0zIRSITJN2zReowQNAvHdj0jBIT93SgwQPIrTppCbPyZJb835f0C7WAmXzHw80CNsW8/xJBv5/O6Y/ARrOCJk/DbTTNL0YpDHQttcVkXzp++nQ3isJuyuhvcQqizjktgrfeAVY0ElH0L/0tWsZ4WbDDryB8uvoYrHhVGaqW1FsLRvKkQ6Z8nObC3dVfsJncmsp61RIczkT1qRMuPsMcx0sGmUtUfKv5FkJL5HKMoymns96XC3nvA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector10001; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=RZzFr2KpvwQDCBdW3gcH1PNUkLRmmd3WTUWpcRXG6yk=; b=RVMKr6wCXCns/CeFwSUsYyrAgix4P2qFoaG4RxdA+w8v51C97Men/UgPTuAp89ou+zEtJkKu3XPPW2BYV85DVjUw0gyHq3+9TQ0s72u3fkhEjC1saPAtTSBRU/hvLQW0JHkQhpFmCCte27oOZDAQyTgIXrvsoStqzRsTjTUhv+Id7iuZ+Lm2lACEL0tJkR889EfF/6jZl+cJyKTJU7tbZz/n8XJVOfdyoh9KhJ96TjCOr1CXA9udOpPJfoQwDNaRz7sEW8up2NNekVaMUa7rpwxC/g4Swz0OYReLD1y8DVCtG+kcSJ+c8gWebpzZQE6NmjU4WJYZAaL+y9I2JN8fYw== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=softfail (sender ip is 91.26.50.189) smtp.rcpttodomain=lists.yoctoproject.org smtp.mailfrom=phytec.de; dmarc=fail (p=quarantine sp=quarantine pct=100) action=quarantine header.from=phytec.de; dkim=none (message not signed); arc=none (0) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=phytec.de; s=selector2; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=RZzFr2KpvwQDCBdW3gcH1PNUkLRmmd3WTUWpcRXG6yk=; b=FKpn0TpN+xxnbyvQ0Boquzp/obDEPDc/ZVCC1wDxwGjky6bNet2rFuctOjafwVmmXebv8c0kCS9esGHn3xrhYjGqVb42Y0nvkDid823IpMs7ZwsKfZhyq170ub3Dd20YW7LtEs7ZjW0i3C1dCh4XCIRotkBtuqbK0ajJeJwxH3+BjWMTB2wsIZa0gCyA3nK06IZMjIhXLAxQXFF3F3B81T8iwqNB+2q1+SSf5t8xA3NDmTpkX8yHegBaTkG40M4Cra1M8bZ/sy+vipQMi2rTaxUbEux0/th1jpM0FnhDCzVUqjA693t1RRqvMBvXkv6ES1R4sEoKA9Gp7R4LvACpEw== Received: from AM0PR02CA0226.eurprd02.prod.outlook.com (2603:10a6:20b:28f::33) by AM9P195MB0934.EURP195.PROD.OUTLOOK.COM (2603:10a6:20b:1f1::15) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.8632.33; Tue, 15 Apr 2025 13:21:14 +0000 Received: from AM1PEPF000252DE.eurprd07.prod.outlook.com (2603:10a6:20b:28f:cafe::85) by AM0PR02CA0226.outlook.office365.com (2603:10a6:20b:28f::33) with Microsoft SMTP Server (version=TLS1_3, cipher=TLS_AES_256_GCM_SHA384) id 15.20.8632.34 via Frontend Transport; Tue, 15 Apr 2025 13:21:14 +0000 X-MS-Exchange-Authentication-Results: spf=softfail (sender IP is 91.26.50.189) smtp.mailfrom=phytec.de; dkim=none (message not signed) header.d=none;dmarc=fail action=quarantine header.from=phytec.de; Received-SPF: SoftFail (protection.outlook.com: domain of transitioning phytec.de discourages use of 91.26.50.189 as permitted sender) Received: from Diagnostix.phytec.de (91.26.50.189) by AM1PEPF000252DE.mail.protection.outlook.com (10.167.16.56) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.20.8655.12 via Frontend Transport; Tue, 15 Apr 2025 13:21:13 +0000 Received: from Florix.phytec.de (172.25.0.13) by Diagnostix.phytec.de (172.25.0.14) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2507.44; Tue, 15 Apr 2025 15:21:13 +0200 Received: from llp-anderweit.phytec.de (172.25.32.131) by Florix.phytec.de (172.25.0.13) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2507.44; Tue, 15 Apr 2025 15:21:13 +0200 From: Leonard Anderweit Date: Tue, 15 Apr 2025 15:20:54 +0200 Subject: [PATCH] ref-manual: classes: uki: Fix git links MIME-Version: 1.0 Message-ID: <20250415-master-v1-1-00ec2b8cc934@phytec.de> X-B4-Tracking: v=1; b=H4sIADVd/mcC/6tWKk4tykwtVrJSqFYqSi3LLM7MzwNyDHUUlJIzE vPSU3UzU4B8JSMDI1MDE0NT3dzE4pLUIt1k8yTjlDQj47RUw0QloOKCotS0zAqwQdGxtbUA84v P0lgAAAA= To: CC: Leonard Anderweit X-Mailer: b4 0.13.0 X-Originating-IP: [172.25.32.131] X-ClientProxiedBy: Diagnostix.phytec.de (172.25.0.14) To Florix.phytec.de (172.25.0.13) X-EOPAttributedMessage: 0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: AM1PEPF000252DE:EE_|AM9P195MB0934:EE_ X-MS-Office365-Filtering-Correlation-Id: 08b573c0-b9c0-453a-64a4-08dd7c206549 X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0;ARA:13230040|1800799024|376014|36860700013|82310400026; X-Microsoft-Antispam-Message-Info: =?utf-8?q?4LOsIn1hvXzEEQf6Rt4HLLF04+5Sman?= =?utf-8?q?pHgGXKaqSkoJnIAaCqS7fVkeESbeEQHRhS/Nz8X3qzK5Jt1xQ0xBqPL+RtGHOMQI9?= =?utf-8?q?E6f2Dyj5U1K8qB7NhlWaqDA2dfy8wHnLYSJAbPsq8T8bpQE+zeNNtABsDWyqw5wJ1?= =?utf-8?q?T4pfFMQL0MvJN0/krrL4Q1AIcNZFZFHj/xpVlczpGXS+58MxODXunjPCC/sbQmJYR?= =?utf-8?q?q9fhFoyaksb8wT13zzr0bXgWe4I7LDlThSJfnKxx14t755+J4LmDcmbMYc6OMp+6E?= =?utf-8?q?q5JyMzviABT/25Umb4a8Iye9RZW9wsZmCLQqUL9MPqQEMN/UL9QaSRu013V719Z/p?= =?utf-8?q?C/XjPvreIafFMR1YrQo9rUCwsw0vhuYKC9rbCFRCehhyhi0SEX668KcTSuDzpY+yp?= =?utf-8?q?xyu0ILTSVHbZU2Ptw2PHUUxKiEyxbUz2VJ/rzLGH6YTU0Ep2xF70nNE3LcncuAsAx?= =?utf-8?q?Mchm6hFvkZzefMdtLbsEWDrH8d/jw2rWIAe8APLv8Es7BnOFWUw0UnDzj9PuG/Eiq?= =?utf-8?q?1bdOr/LhXUxvz8nT1KvvB5AqNd+tCg0RuMNAixorPV4GbJT4+sIyOv3XrBKpjj5aB?= =?utf-8?q?5s3/hgnwXXyTEt8+aZF19GrZq8Evyt5UMVPHnQy17XfxiNtp7pVRQ3isCuH/2Aw43?= =?utf-8?q?bDzR/CTk97jM3U9YgvXJxf6wCr35yRVoAjwLgok9GUnoy9HyZOnTf39ytVaqYZxK0?= =?utf-8?q?gQ/j6MW5loZPVSQ7z+DibNBhoQv0p0y7Y4XCJgxm3k6FEufi7H9Ee8WoeCUrCixLX?= =?utf-8?q?3ciflMzjqL3w9agCX93jo0CvsaIYufBlLWRV+bpx+S1I/404IxBfcc+1S2S9r22Ms?= =?utf-8?q?WGz15n22Zzge2/h3cfUsFx7PgveB5pcX3uBfiEOXWvRBlctH3oU4vxpJCgxM+7QNe?= =?utf-8?q?7doCcu200P9k4KC3HBNh/v39b/3Qe4dvSLIVhsMSAU+IAXOrv4w2d0PKMOAKtJekg?= =?utf-8?q?/nu+zEn5niqB3ochUO8gmrzprQOeHn8PSjhY8Jw3SkOFhZPEzuRvTEkKPelur49eZ?= =?utf-8?q?wDKv+xGdmK0HHDReB/DKAqBFVC1ekDZbtQ7XhGcGZx2yAcRVXqtugJmyEekEJ8Qk7?= =?utf-8?q?ARvv/Kz4KupkL2gbqRg3H6oC8qeE5HVYY0S/cMOdv0+oUpK8WqjwMbOgqHqg/YY67?= =?utf-8?q?6PtC/15+HE//9J409UuLjOHSWPzl1ndGo9h9J2Vgsjbm/FkMA78WPTy35bulW1/fT?= =?utf-8?q?99G9KwyloUrYlX/BeoEvaFoDkdpoHrbimgcJ5Pbw1v7Km60UakpwKMIg5F6/Ac7ny?= =?utf-8?q?5gDndD71iamPlZ6HLY2vYU4HwxpMdVTEEgEXvOGtGiTfmjTB8ufgMnIK1HYbIZF38?= =?utf-8?q?VkNf0rtV2XjIJJeOwn/MkRUz/2foPyEIiFmUJ+gySYINAyOx2/zJhvjZLbOQqxkxD?= =?utf-8?q?4FRSPjyn59Xmdbju7CHz0JMi8sJ7/3TdA=3D=3D?= X-Forefront-Antispam-Report: CIP:91.26.50.189;CTRY:DE;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:Diagnostix.phytec.de;PTR:InfoDomainNonexistent;CAT:NONE;SFS:(13230040)(1800799024)(376014)(36860700013)(82310400026);DIR:OUT;SFP:1102; X-OriginatorOrg: phytec.de X-MS-Exchange-CrossTenant-OriginalArrivalTime: 15 Apr 2025 13:21:13.6272 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 08b573c0-b9c0-453a-64a4-08dd7c206549 X-MS-Exchange-CrossTenant-Id: e609157c-80e2-446d-9be3-9c99c2399d29 X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=e609157c-80e2-446d-9be3-9c99c2399d29;Ip=[91.26.50.189];Helo=[Diagnostix.phytec.de] X-MS-Exchange-CrossTenant-AuthSource: AM1PEPF000252DE.eurprd07.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: AM9P195MB0934 List-Id: X-Webhook-Received: from li982-79.members.linode.com [45.33.32.79] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Tue, 15 Apr 2025 13:21:24 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/6748 Fix links to files in git by adding a leading / to the path. Signed-off-by: Leonard Anderweit --- documentation/ref-manual/classes.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) --- base-commit: 3b50193fa0c9acf4a601aeae6e1c78d0e4a05aef change-id: 20250415-master-c7b3df23fe1a Best regards, diff --git a/documentation/ref-manual/classes.rst b/documentation/ref-manual/classes.rst index 59efcbe19a71..5187033f77ac 100644 --- a/documentation/ref-manual/classes.rst +++ b/documentation/ref-manual/classes.rst @@ -3452,7 +3452,7 @@ on target hardware. Using ``systemd`` as init is recommended. Image builds should create an ESP partition for UEFI firmware and copy ``systemd-boot`` and UKI files there. Sample configuration for Wic images is provided in :oe_git:`scripts/lib/wic/canned-wks/efi-uki-bootdisk.wks.in -`. +`. UKIs are generated using ``systemd`` reference implementation `ukify `__. This class uses a number of variables but tries to find sensible defaults for @@ -3462,7 +3462,7 @@ The variables used by this class are: - :term:`EFI_ARCH`: architecture name within EFI standard, set in :oe_git:`meta/conf/image-uefi.conf - ` + ` - :term:`IMAGE_EFI_BOOT_FILES`: files to install to EFI boot partition created by the ``bootimg-efi`` Wic plugin - :term:`INITRAMFS_IMAGE`: initramfs recipe name @@ -3481,9 +3481,9 @@ The variables used by this class are: For examples on how to use this class see oeqa selftest :oe_git:`meta/lib/oeqa/selftest/cases/uki.py -`. +`. Also an oeqa runtime test :oe_git:`meta/lib/oeqa/runtime/cases/uki.py -` is provided which +` is provided which verifies that the target system booted the same UKI binary as was set at buildtime via :term:`UKI_FILENAME`.