From unknown Sat Aug 09 15:57:30 2025 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-Mailer: MIME-tools 5.509 (Entity 5.509) Content-Type: text/plain; charset=utf-8 From: bug#52750 <52750@debbugs.gnu.org> To: bug#52750 <52750@debbugs.gnu.org> Subject: Status: [PATCH] doc: cookbook: Update custom kernel guide. Reply-To: bug#52750 <52750@debbugs.gnu.org> Date: Sat, 09 Aug 2025 22:57:30 +0000 retitle 52750 [PATCH] doc: cookbook: Update custom kernel guide. reassign 52750 guix-patches submitter 52750 Leo Famulari severity 52750 normal tag 52750 patch thanks From debbugs-submit-bounces@debbugs.gnu.org Thu Dec 23 00:57:00 2021 Received: (at submit) by debbugs.gnu.org; 23 Dec 2021 05:57:01 +0000 Received: from localhost ([127.0.0.1]:60234 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1n0H64-0005Tn-K1 for submit@debbugs.gnu.org; Thu, 23 Dec 2021 00:57:00 -0500 Received: from lists.gnu.org ([209.51.188.17]:59112) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1n0H62-0005Tf-VU for submit@debbugs.gnu.org; Thu, 23 Dec 2021 00:56:59 -0500 Received: from eggs.gnu.org ([209.51.188.92]:43614) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1n0H62-0007P5-Ch for guix-patches@gnu.org; Thu, 23 Dec 2021 00:56:58 -0500 Received: from out5-smtp.messagingengine.com ([66.111.4.29]:35359) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1n0H5y-0001Zd-HH for guix-patches@gnu.org; Thu, 23 Dec 2021 00:56:56 -0500 Received: from compute4.internal (compute4.nyi.internal [10.202.2.44]) by mailout.nyi.internal (Postfix) with ESMTP id 311F95C0102; Thu, 23 Dec 2021 00:56:51 -0500 (EST) Received: from mailfrontend2 ([10.202.2.163]) by compute4.internal (MEProxy); Thu, 23 Dec 2021 00:56:51 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=famulari.name; h=from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; s=mesmtp; bh=n3C9SKfbKTlYLKzF4c67aXf 82Xk8FpM0rSCDpKlq51M=; b=YR9D0ChuWMFnEieKlr7cXYapH2UIdAw563uE3vO ivydBN+umUZ75NKzjtIwjRkZfuKdsXdTOI3TaRLM9wY55eyWPIpzH/S3lYp39gZ6 y5lESUllBZ4W/haYeXXVS0ITnHr/jd7vuO0cj7FFePr4j2jc8QSaS3nx0b6UrLAu WkjM= DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:content-transfer-encoding:date:from :message-id:mime-version:subject:to:x-me-proxy:x-me-proxy :x-me-sender:x-me-sender:x-sasl-enc; s=fm1; bh=n3C9SKfbKTlYLKzF4 c67aXf82Xk8FpM0rSCDpKlq51M=; b=VOgDAhsLRrFNuT7B0c8KXhDAQto3/mk5i NIpsmJzVwn0ND53W8nSPJU/Mr1g4OcBg8pKNHx1qw601xDAgrQm1rUzG1p7UY+CC ist5gmt1zwOBHiP0rrE+kGJwePGOsVAXr2kiVq/i/LYiYIXcidVJ9enqgKfT6mdy RFu52JMOdSaKRTby9itLCJegouTtF7n7NtjeEeW1qAa9Au19iAQ+IAkw2tVCY2i6 3bmBhjRywh0rJYyfUgVtR0mq9H7ajTTFMAvBOvYp2FlwDdUULM8EUCwJpMBSPQ4I nTqZt78Rop1tz6vwlfqWc+My3D1Z8tFN0aLaUcMr71vpzAl20D6HA== X-ME-Sender: X-ME-Received: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgedvuddruddtjedgledtucetufdoteggodetrfdotf fvucfrrhhofhhilhgvmecuhfgrshhtofgrihhlpdfqfgfvpdfurfetoffkrfgpnffqhgen uceurghilhhouhhtmecufedttdenucenucfjughrpefhvffufffkofgggfestdekredtre dttdenucfhrhhomhepnfgvohcuhfgrmhhulhgrrhhiuceolhgvohesfhgrmhhulhgrrhhi rdhnrghmvgeqnecuggftrfgrthhtvghrnhepteeuiefgleehkeevffevteffueegueduvd egieffveekuefffeetuddvhffhudfhnecuvehluhhsthgvrhfuihiivgeptdenucfrrghr rghmpehmrghilhhfrhhomheplhgvohesfhgrmhhulhgrrhhirdhnrghmvg X-ME-Proxy: Received: by mail.messagingengine.com (Postfix) with ESMTPA; Thu, 23 Dec 2021 00:56:50 -0500 (EST) From: Leo Famulari To: guix-patches@gnu.org Subject: [PATCH] doc: cookbook: Update custom kernel guide. Date: Thu, 23 Dec 2021 00:56:45 -0500 Message-Id: <80da5b3b4c1bbdd2b0a54357aeb7ac4af685df66.1640239005.git.leo@famulari.name> X-Mailer: git-send-email 2.34.0 MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Received-SPF: pass client-ip=66.111.4.29; envelope-from=leo@famulari.name; helo=out5-smtp.messagingengine.com X-Spam_score_int: -27 X-Spam_score: -2.8 X-Spam_bar: -- X-Spam_report: (-2.8 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_LOW=-0.7, RCVD_IN_MSPIKE_H3=0.001, RCVD_IN_MSPIKE_WL=0.001, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-Spam-Score: -1.4 (-) X-Debbugs-Envelope-To: submit Cc: efraim@flashner.co.il X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -2.4 (--) * doc/guix-cookbook.texi (Customizing the Kernel): Adjust to new interface. --- doc/guix-cookbook.texi | 54 ++++++++++++++++++++---------------------- 1 file changed, 26 insertions(+), 28 deletions(-) diff --git a/doc/guix-cookbook.texi b/doc/guix-cookbook.texi index e19ab9c51b..d2ce525998 100644 --- a/doc/guix-cookbook.texi +++ b/doc/guix-cookbook.texi @@ -1430,37 +1430,34 @@ The @code{linux-libre} kernel package definition is actually a procedure which creates a package. @lisp -(define* (make-linux-libre version hash supported-systems - #:key - ;; A function that takes an arch and a variant. - ;; See kernel-config for an example. - (extra-version #false) - (configuration-file #false) - (defconfig "defconfig") - (extra-options %default-extra-linux-options) - (patches (list %boot-logo-patch))) +(define* (make-linux-libre* version gnu-revision source supported-systems + #:key + (extra-version #f) + ;; A function that takes an arch and a variant. + ;; See kernel-config for an example. + (configuration-file #f) + (defconfig "defconfig") + (extra-options %default-extra-linux-options)) ...) @end lisp -The current @code{linux-libre} package is for the 5.1.x series, and is +The current @code{linux-libre} package is for the 5.15.x series, and is declared like this: @lisp -(define-public linux-libre - (make-linux-libre %linux-libre-version - %linux-libre-hash - '("x86_64-linux" "i686-linux" "armhf-linux" "aarch64-linux") - #:patches %linux-libre-5.1-patches - #:configuration-file kernel-config)) +(define-public linux-libre-5.15 + (make-linux-libre* linux-libre-5.15-version + linux-libre-5.15-gnu-revision + linux-libre-5.15-source + '("x86_64-linux" "i686-linux" "armhf-linux" "aarch64-linux" "riscv64-linux") + #:configuration-file kernel-config)) @end lisp Any keys which are not assigned values inherit their default value from the @code{make-linux-libre} definition. When comparing the two snippets above, -you may notice that the code comment in the first doesn't actually refer to -the @code{#:extra-version} keyword; it is actually for -@code{#:configuration-file}. Because of this, it is not actually easy to -include a custom kernel configuration from the definition, but don't worry, -there are other ways to work with what we do have. +notice the code comment that refers to @code{#:configuration-file}. Because of +this, it is not actually easy to include a custom kernel configuration from the +definition, but don't worry, there are other ways to work with what we do have. There are two ways to create a kernel with a custom kernel configuration. The first is to provide a standard @file{.config} file during the build process by @@ -1560,14 +1557,15 @@ custom kernel: (@@@@ (gnu packages linux) %default-extra-linux-options))) (define-public linux-libre-macbook41 - ;; XXX: Access the internal 'make-linux-libre' procedure, which is + ;; XXX: Access the internal 'make-linux-libre*' procedure, which is ;; private and unexported, and is liable to change in the future. - ((@@@@ (gnu packages linux) make-linux-libre) (@@@@ (gnu packages linux) %linux-libre-version) - (@@@@ (gnu packages linux) %linux-libre-hash) - '("x86_64-linux") - #:extra-version "macbook41" - #:patches (@@@@ (gnu packages linux) %linux-libre-5.1-patches) - #:extra-options %macbook41-config-options)) + ((@@@@ (gnu packages linux) make-linux-libre*) + (@@@@ (gnu packages linux) linux-libre-version) + (@@@@ (gnu packages linux) linux-libre-gnu-revision) + (@@@@ (gnu packages linux) linux-libre-source) + '("x86_64-linux") + #:extra-version "macbook41" + #:extra-options %macbook41-config-options)) @end lisp In the above example @code{%file-systems} is a collection of flags enabling -- 2.34.0 From debbugs-submit-bounces@debbugs.gnu.org Thu Dec 30 15:59:48 2021 Received: (at 52750-done) by debbugs.gnu.org; 30 Dec 2021 20:59:48 +0000 Received: from localhost ([127.0.0.1]:54707 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1n32Wa-0002SQ-Hs for submit@debbugs.gnu.org; Thu, 30 Dec 2021 15:59:48 -0500 Received: from wout1-smtp.messagingengine.com ([64.147.123.24]:33645) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1n32WX-0002S7-8Q for 52750-done@debbugs.gnu.org; Thu, 30 Dec 2021 15:59:46 -0500 Received: from compute3.internal (compute3.nyi.internal [10.202.2.43]) by mailout.west.internal (Postfix) with ESMTP id E7C933200F7C; Thu, 30 Dec 2021 15:59:38 -0500 (EST) Received: from mailfrontend1 ([10.202.2.162]) by compute3.internal (MEProxy); Thu, 30 Dec 2021 15:59:39 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=famulari.name; h=date:from:to:subject:message-id:mime-version:content-type; s= mesmtp; bh=t6UE+W1WJTTx6eGZiqYx2M+tgV7iGuF636zUD+aCR6U=; b=L2RGd ZpJPvjOJkRR7qaahE2Igj+pA71Sqhyl6VABtWbEmkQqjAP8zka3AFfBlNn74uwGQ ZEPPD/jmO8nrUevNuAOl8I1yYnwuOOJX0v1bPuikMUQudm745+HfQt9BGFnlLWzt BSzk8J7l1yrO978hSsKxcOkRUMRmmGeqhYHFAI= DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=content-type:date:from:message-id :mime-version:subject:to:x-me-proxy:x-me-proxy:x-me-sender :x-me-sender:x-sasl-enc; s=fm1; bh=t6UE+W1WJTTx6eGZiqYx2M+tgV7iG uF636zUD+aCR6U=; b=mYTcyAcaVTBwJOzdCo6sjzNBR60+32HbtAWlekgJaGldn ahQ42hM6k373jiEPw2qGLKLQE+qKa29b46NVn9lL814RTsiRUR1lY1vzqa9UJCXY OcU16lZl/QExWX9D7srhE1JUYXi2RrBfVpZy2Yq0uMu98F0Izy5u4KOYlaSu53jc u/vfQgRFCIFn3CMGu9MN5sh+rF/CpqM+eg9rWYfFr0gVwoHp6rYrZU1JzUQrfXaS +Rt+VxJyTBx1scqzlYexYP7zW5Q8ChCMpMa8cnxh9nT+BeZ+WGInKa9bUNm5whtK H7kPCxvhSNAJbSHpb9euGB5fI+zZvC3d4gT54i9jw== X-ME-Sender: X-ME-Received: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgedvuddruddvfedgudegiecutefuodetggdotefrod ftvfcurfhrohhfihhlvgemucfhrghsthforghilhdpqfgfvfdpuffrtefokffrpgfnqfgh necuuegrihhlohhuthemuceftddtnecunecujfgurhepfffhvffukfggtggusehttdertd dttddvnecuhfhrohhmpefnvghoucfhrghmuhhlrghrihcuoehlvghosehfrghmuhhlrghr ihdrnhgrmhgvqeenucggtffrrghtthgvrhhnpeffhedtfeeftddvueeifeduueejvdekhe ffueeijefgvdetleegheegfeehheduudenucevlhhushhtvghrufhiiigvpedtnecurfgr rhgrmhepmhgrihhlfhhrohhmpehlvghosehfrghmuhhlrghrihdrnhgrmhgv X-ME-Proxy: Received: by mail.messagingengine.com (Postfix) with ESMTPA for <52750-done@debbugs.gnu.org>; Thu, 30 Dec 2021 15:59:38 -0500 (EST) Date: Thu, 30 Dec 2021 15:59:36 -0500 From: Leo Famulari To: 52750-done@debbugs.gnu.org Subject: Re: [PATCH] doc: cookbook: Update custom kernel guide. Message-ID: MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline X-Spam-Score: -0.7 (/) X-Debbugs-Envelope-To: 52750-done X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.7 (-) Pushed as c7d74a9bccfc1b1274fc8754a6e78bb6887c7fea From unknown Sat Aug 09 15:57:30 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Fri, 28 Jan 2022 12:24:06 +0000 User-Agent: Fakemail v42.6.9 # This is a fake control message. # # The action: # bug archived. thanks # This fakemail brought to you by your local debbugs # administrator