From patchwork Wed Apr 3 21:30:38 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: =?utf-8?q?Gero_Schw=C3=A4ricke?= X-Patchwork-Id: 1919430 Return-Path: X-Original-To: incoming-buildroot@patchwork.ozlabs.org Delivered-To: patchwork-incoming-buildroot@legolas.ozlabs.org Authentication-Results: legolas.ozlabs.org; spf=pass (sender SPF authorized) smtp.mailfrom=buildroot.org (client-ip=2605:bc80:3010::137; helo=smtp4.osuosl.org; envelope-from=buildroot-bounces@buildroot.org; receiver=patchwork.ozlabs.org) Received: from smtp4.osuosl.org (smtp4.osuosl.org [IPv6:2605:bc80:3010::137]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature ECDSA (secp384r1) server-digest SHA384) (No client certificate requested) by legolas.ozlabs.org (Postfix) with ESMTPS id 4V8ydg0rgpz1yYP for ; Thu, 4 Apr 2024 08:32:37 +1100 (AEDT) Received: from localhost (localhost [127.0.0.1]) by smtp4.osuosl.org (Postfix) with ESMTP id 18AFC402EB; Wed, 3 Apr 2024 21:32:34 +0000 (UTC) X-Virus-Scanned: amavis at osuosl.org Received: from smtp4.osuosl.org ([127.0.0.1]) by localhost (smtp4.osuosl.org [127.0.0.1]) (amavis, port 10024) with ESMTP id UpF-OTuTu4mp; Wed, 3 Apr 2024 21:32:33 +0000 (UTC) X-Comment: SPF check N/A for local connections - client-ip=140.211.166.34; helo=ash.osuosl.org; envelope-from=buildroot-bounces@buildroot.org; receiver= DKIM-Filter: OpenDKIM Filter v2.11.0 smtp4.osuosl.org E6CEA41848 Received: from ash.osuosl.org (ash.osuosl.org [140.211.166.34]) by smtp4.osuosl.org (Postfix) with ESMTP id E6CEA41848; Wed, 3 Apr 2024 21:32:32 +0000 (UTC) X-Original-To: buildroot@lists.busybox.net Delivered-To: buildroot@osuosl.org Received: from smtp3.osuosl.org (smtp3.osuosl.org [140.211.166.136]) by ash.osuosl.org (Postfix) with ESMTP id A4D141BF982 for ; Wed, 3 Apr 2024 21:32:30 +0000 (UTC) Received: from localhost (localhost [127.0.0.1]) by smtp3.osuosl.org (Postfix) with ESMTP id 7DF0B60ED9 for ; Wed, 3 Apr 2024 21:32:28 +0000 (UTC) X-Virus-Scanned: amavis at osuosl.org Received: from smtp3.osuosl.org ([127.0.0.1]) by localhost (smtp3.osuosl.org [127.0.0.1]) (amavis, port 10024) with ESMTP id jqg3RV6HjZ47 for ; Wed, 3 Apr 2024 21:32:27 +0000 (UTC) Received-SPF: Pass (mailfrom) identity=mailfrom; client-ip=185.67.36.65; helo=mout01.posteo.de; envelope-from=gero.schwaericke@posteo.de; receiver= DMARC-Filter: OpenDMARC Filter v1.4.2 smtp3.osuosl.org 9A12960E4B DKIM-Filter: OpenDKIM Filter v2.11.0 smtp3.osuosl.org 9A12960E4B Received: from mout01.posteo.de (mout01.posteo.de [185.67.36.65]) by smtp3.osuosl.org (Postfix) with ESMTPS id 9A12960E4B for ; Wed, 3 Apr 2024 21:32:26 +0000 (UTC) Received: from submission (posteo.de [185.67.36.169]) by mout01.posteo.de (Postfix) with ESMTPS id 3CE93240027 for ; Wed, 3 Apr 2024 23:32:23 +0200 (CEST) Received: from customer (localhost [127.0.0.1]) by submission (posteo.de) with ESMTPSA id 4V8ydL4XXGz6tw9; Wed, 3 Apr 2024 23:32:22 +0200 (CEST) From: =?utf-8?q?Gero_Schw=C3=A4ricke?= To: buildroot@buildroot.org Date: Wed, 3 Apr 2024 21:30:38 +0000 Message-ID: <20240403213135.699268-1-gero.schwaericke@posteo.de> MIME-Version: 1.0 X-Mailman-Original-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=posteo.de; s=2017; t=1712179943; bh=OK23nHC564FsULcXv9Z+3L3d33SrvV5VMt6N5bayZZY=; h=From:To:Cc:Subject:Date:Message-ID:MIME-Version:Content-Type: Content-Transfer-Encoding:From; b=ZbtkJpUEKuwZW3cout9WE0PwdFmt+VU8G4JT10yKjcbVqMmkm+j5ePs02zOgeNQtE hKnfc1iSr/btzDBuU38tBXEsi74Poef9GulFTnROopzzv42Z9/s1tMFN8zwHqCCi9m 6CFXd84++/Kd8Sn+EiRbZfhzhrWJ/golQsszXaIDMVmG1DW2B5WGQ3et2iAhXDl5wI ynry2Khb306jANncBhknhmzC59sKohFCi3Kt46WKI9Ye7KQcXokRwWnfK4uwLb/ASS NqevWAef5Cw+uguQ3/9iTckZ8VcjmTo9UNh4u5ElonwG96eFb87N4qLlRFYDz0xLe4 Zt5CtuFd4gjNA== X-Mailman-Original-Authentication-Results: smtp3.osuosl.org; dmarc=pass (p=none dis=none) header.from=posteo.de X-Mailman-Original-Authentication-Results: smtp3.osuosl.org; dkim=pass (2048-bit key, unprotected) header.d=posteo.de header.i=@posteo.de header.a=rsa-sha256 header.s=2017 header.b=ZbtkJpUE Subject: [Buildroot] [PATCH] docs/manual: promote using fixed version for kernel headers when contributing a board X-BeenThere: buildroot@buildroot.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Discussion and development of buildroot List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Thomas De Schampheleire , =?utf-8?q?G?= =?utf-8?q?ero_Schw=C3=A4ricke?= Errors-To: buildroot-bounces@buildroot.org Sender: "buildroot" When the default (newest) kernel headers series changes the build can break. Example error message: Incorrect selection of kernel headers: expected 6.8.x, got 6.5.x In the above case the defconfig used: BR2_LINUX_KERNEL_CUSTOM_VERSION=y BR2_LINUX_KERNEL_CUSTOM_VERSION_VALUE="6.5.9" The kernel headers were not specified, so the build defaulted to using the kernel sources as header source and the default (newest) header series. From .config: BR2_KERNEL_HEADERS_AS_KERNEL=y BR2_PACKAGE_HOST_LINUX_HEADERS_CUSTOM_6_8=y Signed-off-by: Gero Schwäricke --- docs/manual/adding-board-support.adoc | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/docs/manual/adding-board-support.adoc b/docs/manual/adding-board-support.adoc index ef6dbd3c2b..85fd0815a8 100644 --- a/docs/manual/adding-board-support.adoc +++ b/docs/manual/adding-board-support.adoc @@ -32,7 +32,11 @@ Always use fixed versions or commit hashes for the different components, not the "latest" version. For example, set +BR2_LINUX_KERNEL_CUSTOM_VERSION=y+ and +BR2_LINUX_KERNEL_CUSTOM_VERSION_VALUE+ to the kernel version you tested -with. +with. If you are using the buildroot toolchain +BR2_TOOLCHAIN_BUILDROOT+ +(default) additionally ensure that the kernel headers ++BR2_KERNEL_HEADERS_*+ and (if applicable) the custom kernel headers +series +BR2_PACKAGE_HOST_LINUX_HEADERS_CUSTOM_*+ match your kernel +version. It is recommended to use as much as possible upstream versions of the Linux kernel and bootloaders, and to use as much as possible default