From mboxrd@z Thu Jan 1 00:00:00 1970 X-GM-THRID: 7330292884155924480 X-Received: by 2002:a05:600c:1c11:b0:411:e0f0:7a71 with SMTP id j17-20020a05600c1c1100b00411e0f07a71mr1402373wms.33.1707905439231; Wed, 14 Feb 2024 02:10:39 -0800 (PST) X-BeenThere: isar-users@googlegroups.com Received: by 2002:a05:600c:1e0b:b0:411:f09e:9d69 with SMTP id ay11-20020a05600c1e0b00b00411f09e9d69ls151372wmb.2.-pod-prod-04-eu; Wed, 14 Feb 2024 02:10:37 -0800 (PST) X-Google-Smtp-Source: AGHT+IEhUkbS7pNNL3IuoVrfbqBvA7DSwcVlJFP2iBUZn1+XyddjxVEeUj2kqZsLZYwk8M/jxszy X-Received: by 2002:a05:600c:1912:b0:40e:fc29:f527 with SMTP id j18-20020a05600c191200b0040efc29f527mr1643917wmq.31.1707905436978; Wed, 14 Feb 2024 02:10:36 -0800 (PST) ARC-Seal: i=2; a=rsa-sha256; t=1707905436; cv=pass; d=google.com; s=arc-20160816; b=p4kQimHkkBbujlhWRO449yhiAUfbpp22g2EO4T++c5jDIuNDOqIfDR8oEZ7PIQ6pJ3 riOtRYq7R/Qgy93aMrQy38K01rnQuIw3E6VGPGCbruVMSm5JzEPTwjIET7G3J8vF9wzS 6ZjXDVjFJmyAZ1abk3SoKrV3d19HXxAUG+qRihENi5fzJyye/gsba+HPrHdP2KmceNLq 4DmqLv58yPZykcixkajePbiMQBh7FHhVicwEXFHEfgta86bo+ZyOxSCkYn4mUdR48o7W qINWP2+AwBGZwxnJl1449r7WvPhMXUj0oVtOw6bqpaJ5uSfZvgRIXbtK/YXsuC6s3rgM lG5A== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=mime-version:content-transfer-encoding:references:in-reply-to :message-id:date:subject:cc:to:from:dkim-signature; bh=jPQyybfjiH+i2hsHFkVRBG2UZqUtoPz/2BXaLPeLjq0=; fh=xEShFggSpnuOkNhWsuGGuL9hws+gR5u0Poxh36yfvmk=; b=PWAKl6pIzKb5Wib0rJSqipQp9545cGXPhOTJ7GkXLrPb8oPrGL+O15HB/VgNp257KD U3TsmN1f2YHX1fW88ybTNa3ANElXJye8RP9nokXdFT8B+qwYU1MaJBJZAfbUqKVbM75n sF4VO8+VRZljRKfTLxaJ+MiKOHu4gyh0/VZGOcKhBSYJFJp+KPvI3TmSLZn9I0jbdAcD VMD5XtNiyiMlFV1LXD6Zy6MkZgq2B9p+XtVu2oJsBw2+cywIPke6WY/TFkXCTH06+YP/ YHKhMgjJj7wrTHxSNa9HTFkcRssJKO0hBFDTZsM53PVH8ovqhuTK/5r4yjVLCEscOmjo 12DA==; dara=google.com ARC-Authentication-Results: i=2; gmr-mx.google.com; dkim=pass header.i=@siemens.com header.s=selector2 header.b=FuC2QxIX; arc=pass (i=1 spf=pass spfdomain=siemens.com dkim=pass dkdomain=siemens.com dmarc=pass fromdomain=siemens.com); spf=pass (google.com: domain of stefan-koch@siemens.com designates 2a01:111:f403:2612::600 as permitted sender) smtp.mailfrom=stefan-koch@siemens.com; dmarc=pass (p=REJECT sp=REJECT dis=NONE) header.from=siemens.com Return-Path: Received: from EUR05-AM6-obe.outbound.protection.outlook.com (mail-am6eur05on20600.outbound.protection.outlook.com. [2a01:111:f403:2612::600]) by gmr-mx.google.com with ESMTPS id n40-20020a05600c3ba800b00411a80271d8si32552wms.2.2024.02.14.02.10.36 for (version=TLS1_2 cipher=ECDHE-ECDSA-AES128-GCM-SHA256 bits=128/128); Wed, 14 Feb 2024 02:10:36 -0800 (PST) Received-SPF: pass (google.com: domain of stefan-koch@siemens.com designates 2a01:111:f403:2612::600 as permitted sender) client-ip=2a01:111:f403:2612::600; Authentication-Results: gmr-mx.google.com; dkim=pass header.i=@siemens.com header.s=selector2 header.b=FuC2QxIX; arc=pass (i=1 spf=pass spfdomain=siemens.com dkim=pass dkdomain=siemens.com dmarc=pass fromdomain=siemens.com); spf=pass (google.com: domain of stefan-koch@siemens.com designates 2a01:111:f403:2612::600 as permitted sender) smtp.mailfrom=stefan-koch@siemens.com; dmarc=pass (p=REJECT sp=REJECT dis=NONE) header.from=siemens.com ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=Iauhwk3lMcTXLzuy1SsJZQuq2IjPDFaAh53HqyTfnrxb/k6vg45DH+J/EtVNQoBJS4jh5NPrtfnBLI7gF24Q3J3j5KdHFb82pz+EXx29D4e1zd6jPPfpRjMtQAzEDKm1F02Y2mnv9lCAOxDYQyGjSkWEB3dSdC48XBGQ1cHi83PWjnVkGZRkEdhT/r+S7MdyviirW9rqSu9apCVQJzPcbDa33UTaSXuTu1sK/bM5Pn+muNIbbzQT2eg5c/KKxcNEVd/8d6p3T4NQKLdjaX27AeUFgeZFHpUtX7SPmjmfegoCRLWKv0fxo/hSrbsqzdH0CvywOLSVwOeSaSPuHkNYIg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; 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=jPQyybfjiH+i2hsHFkVRBG2UZqUtoPz/2BXaLPeLjq0=; b=fmp6yf9+dDygXlNvA3d4zqcAIe7hR8og6t9Paf9nZ97l30AuXjj/Nkv50A48vmotYGOEO0vAxQV7+Xny76FHIT36OO5c4UW4x8WSX/teqzBG0DqKAnKbJIdqvzB54nbuxqnPkuTSL2XUMjC2Ryf1PtBUH3H24xtmlaspTcXWqCnERqfaAcbOgtkg4znqz1mFTCnO1dd0tQND5eJpTOBSy3d/D2ielBGy9Q5tpcpG3NQz8sZr9IeAMGWSNX4ERifAjvU+xM5AaJTe4uNuqgb79ur8Vx4Jjh/kOGf9DYbc47qK5KVLS6j+ORmxWEWTahomTnylYmV7Tkm5P+zAhfXS9A== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=siemens.com; dmarc=pass action=none header.from=siemens.com; dkim=pass header.d=siemens.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=siemens.com; s=selector2; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=jPQyybfjiH+i2hsHFkVRBG2UZqUtoPz/2BXaLPeLjq0=; b=FuC2QxIXSRRmR4knWJD4BpPnk75kNv6PSvAN/T1k7wNyrjd8NY/nK9giOb2diSgyKGfT3sRzp6ZTakijlpw+F2lg7H+Fd0HjtCLjA0O89pid9eRJxGDNDT/1Vg/Y2yeC6Pvr1Yn//MAiv6dwYZTGGoBbKGY6ZS2HgD7Y+T6OTAivuTnWj6ljzcIobE22tBzbA88dRuJo3t5W/OWBWsxvJ9MelGUYMo58+8Fg6ED34bXFTxOynjK+GVteX6ejhoW9K9VsEItTduEtPCJwXy2jR5aWXSmwgBCgguPah7eCb6tD7kqXl8fhQLdDo4thZfE50w8LjUfFbZfrJPXQ880mdg== Authentication-Results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=siemens.com; Received: from AM9PR10MB4959.EURPRD10.PROD.OUTLOOK.COM (2603:10a6:20b:41e::11) by DB8PR10MB3305.EURPRD10.PROD.OUTLOOK.COM (2603:10a6:10:11c::11) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.7292.26; Wed, 14 Feb 2024 10:10:35 +0000 Received: from AM9PR10MB4959.EURPRD10.PROD.OUTLOOK.COM ([fe80::33ca:62e:abfc:b1a]) by AM9PR10MB4959.EURPRD10.PROD.OUTLOOK.COM ([fe80::33ca:62e:abfc:b1a%4]) with mapi id 15.20.7292.026; Wed, 14 Feb 2024 10:10:35 +0000 From: Stefan Koch To: isar-users@googlegroups.com Cc: stefan-koch@siemens.com, jan.kiszka@siemens.com, christian.storm@siemens.com, michael.adler@siemens.com, simon.sudler@siemens.com, cedric.hombourger@siemens.com, adriaan.schmidt@siemens.com, felix.moessbauer@siemens.com, ubely@ilbers.de Subject: [PATCH v6 5/5] docs: Update custom_kernel docs for split up of kernel scripts and tools Date: Wed, 14 Feb 2024 11:10:25 +0100 Message-Id: <20240214101025.2123540-6-stefan-koch@siemens.com> X-Mailer: git-send-email 2.39.2 In-Reply-To: <20240214101025.2123540-1-stefan-koch@siemens.com> References: <20240214101025.2123540-1-stefan-koch@siemens.com> Content-Transfer-Encoding: 8bit Content-Type: text/plain X-ClientProxiedBy: FR0P281CA0102.DEUP281.PROD.OUTLOOK.COM (2603:10a6:d10:a9::18) To AM9PR10MB4959.EURPRD10.PROD.OUTLOOK.COM (2603:10a6:20b:41e::11) Return-Path: stefan-koch@siemens.com MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: AM9PR10MB4959:EE_|DB8PR10MB3305:EE_ X-MS-Office365-Filtering-Correlation-Id: 3e635fb4-002b-4378-fc42-08dc2d452f16 X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: 4nk1PRdc4vbuPPh63LFW7idr8cFm/lDfkB2bN0JtXXDNX0ROC06Y8M7T/wifTNjOmr60L/nx5Xhl90o5sXlrfobolYANU+jBR+9vjcotG7lsQCkzlRh/qBoYjvjtp8pn8YOLcH2DO5C1sQmOOqtoiCRnyOxvcJOmHeJpCaxKQYZEklJUTrBkAvrObUSQNkGpiKEyASNCs4e6nXMhsii2gt8wLiqs2dcWNhUw42fcJAwqEK2M3buWlg9xJ5VRHYuqlACSZz8GDfC/v7rNl57WN97X34JdXJQg02Hi8ipS8Rl2Tk6+6A5DNX26tf7O0PS0TQFjoBnQKgJ3STU03V5yzeouqeR2xjzE80cHiAlJdmALuR3q4gedHUqLfsS+nXnJWN1vbqJa6cnaEKYyhVeEpGb/Q4/YxzbD/3YeFsVK04xMCcbdvnexrjUUt7ukNqduXyMbKmJe45RSgSmAqKszLyu/PCaekNQ0TKXPOf/OymNlw6GP8WU5SIx8jOcmkOyQTKXo2U0IgB+JxSMVwZUh9n6Ykx3S4F6fN48APfrmE+8ZHTUCypoY/JKMJjhB70k9 X-Forefront-Antispam-Report: CIP:255.255.255.255;CTRY:;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:AM9PR10MB4959.EURPRD10.PROD.OUTLOOK.COM;PTR:;CAT:NONE;SFS:(13230031)(376002)(346002)(366004)(39860400002)(396003)(136003)(230273577357003)(230922051799003)(1800799012)(186009)(451199024)(64100799003)(5660300002)(2906002)(478600001)(6512007)(6506007)(6486002)(26005)(2616005)(1076003)(41300700001)(66946007)(66556008)(66476007)(4326008)(6916009)(8936002)(8676002)(316002)(6666004)(83380400001)(86362001)(38100700002)(36756003)(82960400001);DIR:OUT;SFP:1101; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?us-ascii?Q?+8mFgXlwpgoRw5mgRYnMUtfLfXOWcJYsM68M9DJwCvFCvki5YvMr8TGw66Gn?= =?us-ascii?Q?bJQiyNomq2aVjS5h0E3EcLgsqjdDRDq2wGKRI9u6P4jR9UXmbfVwFGZWDpGq?= =?us-ascii?Q?2zakmYx6zLrCdHj/h8tDemki9LlSFAmD8+6xZ6UHzDeiCoY1tkdOuOLHnTyn?= =?us-ascii?Q?7foFnPng4l9vrmknW/EaKoHINd8+g38fwo3gDPF5XMlljN6xRGavaY96sadj?= =?us-ascii?Q?L9dScnsf5NslTuOYcRWvn7za6X8YDIvdgBPQHIGzXAXdyj6X42HveLsdAQcA?= =?us-ascii?Q?TUjj80UOlCXFmtcXJhuK8wMbeohgnlUrKZggVt6eCReXxyfz46BIY9MA38z2?= =?us-ascii?Q?aNghjysxWPnLiVSJnq7AQv31DvhajpjxH+NdFFTu6j0DtC/zTxeqFTINBZEd?= =?us-ascii?Q?BfmGTwCmiILw3Ea1xglmWOzRwKZXwnRQDQaCKlR+B5VQj+MiPM4n1mVaNEhl?= =?us-ascii?Q?kc4ozPcDI72g0HTsusX5BW3p54288+rMOAa3ybSR52V963AsBZh+UqF4C1e2?= =?us-ascii?Q?bE9BKheGJ5nLO/Mt2p8bGtoQldw7V0nFUkrt2qUBOJrBy+m7KJJwAENY7GC1?= =?us-ascii?Q?jrxO+yzSdAxgg/cAoMvtRNoIGPPRgg+hibp9Mby3SnQcCxQM5UEZoRpDXd2u?= =?us-ascii?Q?eB8RIpo7OLhZPElKmylIOHiUB+r6KCJijhJnw9Cv1JOwbq6mCS6gvcSIQeh7?= =?us-ascii?Q?DtCLP7kP7sdZczEjxXLyRU54QO4TFBZA0zdw1erEMbydYP1MiEWWsX1PC+jF?= =?us-ascii?Q?7BC1iXEvxvLC/Bh+mgY9lf819CfUMrjkMDeEaJDr8LymOMoKEXe9JJVtVkxP?= =?us-ascii?Q?tEAf9dHWh8wdatN2ZGEqqED65PYmKklLZ71LonxsbZaTkclld+rYt49lJt1a?= =?us-ascii?Q?GMsbb4pRWCbJcEnXEet9KurSJ7iS+JkVxXe4oRLQk0C3/neAHlf/xZNoejvS?= =?us-ascii?Q?TlF0G5PbOWHd77YfoIFG0k8sU2wnc5j2XSDStyyfK8VwAMJQ5TiCzekwkPWF?= =?us-ascii?Q?saPW+H1B5rYcbvOFYQxmgh8ecLsnmfl8c31jFs+KN168NKte4MfszagMPzCZ?= =?us-ascii?Q?4eSLYdHHzm0Dbps+RLrkKfyM/I7knRLaMGHsJMfVJQbIKt5Ds/V+OHA/Rs/C?= =?us-ascii?Q?SWRz0pLLnGuJYMXe1oBfeRmvX2/Aw2RmkODYgoBMReZC/AxJu0c5CLWD6l3O?= =?us-ascii?Q?dK5KqAkN2cuaXQFTALjFLbLU2QTDd3Ry96I7/69hxjtFDj8Z2DAgpLh0u295?= =?us-ascii?Q?f2ql1bXKCUITfNw79wbPekeNYAtXqhX9TVJhyiK/4GzvvZKQqYM8j6yppbHe?= =?us-ascii?Q?EywGcdFlvst1GxJtcVcCTWlUu/HL3NQF05XnOGstedk8hzVgIIQyG0gR2FU+?= =?us-ascii?Q?UjiKM2/aI9nxsnDpa6nzkey+kbQu3N7XoNKeo91c8AnDqmmfNkO+2ao8u0Ht?= =?us-ascii?Q?JT+KwfOibIvALfiQ32J+lhtzIHhs5EK89ocgEuMsTgXvDJ4j3I557q8+uniF?= =?us-ascii?Q?xR0R1vh9JJW3yGQqjxBClEm4XZ/A2Qp0aqQE2xCM7Vq/cSy5rnfqwwgW6BmA?= =?us-ascii?Q?P9oMUwIxYTwlrQE9p+8TpfEsz+BtpeE/R4Ie2RjhMajopYkfkabUhxtJePNP?= =?us-ascii?Q?cg=3D=3D?= X-OriginatorOrg: siemens.com X-MS-Exchange-CrossTenant-Network-Message-Id: 3e635fb4-002b-4378-fc42-08dc2d452f16 X-MS-Exchange-CrossTenant-AuthSource: AM9PR10MB4959.EURPRD10.PROD.OUTLOOK.COM X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 14 Feb 2024 10:10:34.6526 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 38ae3bcd-9579-4fd4-adda-b42e1495d55a X-MS-Exchange-CrossTenant-MailboxType: HOSTED X-MS-Exchange-CrossTenant-UserPrincipalName: tkitZ9hw4XDBeQi5T5lispnrKWlezXIpSgO0SkSLBdCU6hFNcUFn8sR4+noRp867GFOOSmus36LEDpknMlP5pw== X-MS-Exchange-Transport-CrossTenantHeadersStamped: DB8PR10MB3305 X-TUID: jGQJhnls22Tv Signed-off-by: Stefan Koch --- RECIPE-API-CHANGELOG.md | 31 +++++++++++++++++++++++++++++++ doc/custom_kernel.md | 18 +++++++++++------- 2 files changed, 42 insertions(+), 7 deletions(-) diff --git a/RECIPE-API-CHANGELOG.md b/RECIPE-API-CHANGELOG.md index bea12871..def1e7f2 100644 --- a/RECIPE-API-CHANGELOG.md +++ b/RECIPE-API-CHANGELOG.md @@ -566,3 +566,34 @@ supported, but a warning is issued when it is used. Future versions will drop When building a custom kernel module, the `KBuild` file might be located in a subdirectory. To support this use-case, set `MODULE_DIR=$(PWD)/subdir` in the module build recipe. + +### Split up binaries from kernel headers to kbuild package for linux-custom + +Swap out the binaries from the kernel headers +into kernel kbuild package. + + * Split up binaries from kernel headers to kbuild package: + Introduce specific kernel kbuild packages that + ship the "scripts" and "tools" binaries. + The kernel headers fulfill this using symlinks to point + to the "scripts" and "tools" of the kernel kbuild package. + + * Provide target and host specific kernel kbuild packages: + Introduce target and host specific kernel kbuild packages that + ship the "scripts" and "tools" binaries. + + The "-kbuildtarget" and "-native" multiarch bitbake targets are useable to + run additional target or host specific builds for kbuild scripts and tools. + + Using the "-kbuildtarget" bitbake target enables the build of + a target specific kbuild package at cross builds. + So using "linux-kbuild" provides the package for the target platform. + + Using the "-native" bitbake target enables the build of + a host specific kbuild package at cross builds. + When cross building using "linux-kbuild-native" + provides the package for the host platform. + + Only the "host" specific package is built automatically at cross builds. + + * Support emulated module build with cross-compiled kernel for linux-module diff --git a/doc/custom_kernel.md b/doc/custom_kernel.md index 73987a5b..ce5f1bf7 100644 --- a/doc/custom_kernel.md +++ b/doc/custom_kernel.md @@ -38,12 +38,18 @@ The linux-custom recipe provides support for: 7. Allow the name of the kernel image to be changed via `KERNEL_FILE` (defaults to `vmlinuz`) - 8. Produce a `linux-headers` package which includes kernel headers and kbuild - scripts/tools + 8. Produce a `linux-headers` package which includes kernel headers - 9. The `linux-headers` package shall support native and cross compiles of - out-of-tree kernel modules. However, when built in cross-compilation mode, - it cannot be used on the target so far. + 9. Produce a `linux-kbuild` package for both `target` and `host` arch + which includes kbuild scripts and tools. + Using `linux-kbuild` provides the package for the target and when + cross building `linux-kbuild-native` provides the package for the host. + + So the `linux-headers` package supports native and cross compiles of + out-of-tree kernel modules. Even, when built in cross-compilation mode, + it can be used on the target using the `linux-kbuild` package. + + Only the `host` specific package is built automatically at cross builds. 10. Produce a `linux-libc-dev` package to support user-land builds @@ -72,8 +78,6 @@ In the future, the recipe may be extended to: 3. Be compatible with Ubuntu - 4. When cross-building, generate kernel-headers for both host and target - ## Examples The linux-custom recipe is currently used by the linux-mainline package and is -- 2.39.2