Bug#1031738: installation-guide: documentation about limits to kernel boot parameters is outdated
Source: installation-guide
Version: 20220129~deb11u1
Severity: normal
Tags: d-i patch
Dear Maintainer,
Some of the documentation related to limits in Linux kernel boot parameters in
the installation guide is outdated.
For example, the section describing[1] use of boot parameters for preseeding
references the 2.6.9 kernel in a callout note.
Please find attached a patch to update two such documentation sections.
Thanks,
James
[1] - https://www.debian.org/releases/bullseye/amd64/apbs02.en.html#preseed-bootparms
>From 55dbd6dae622cfb40e3397bc98e4e053b14ad45c Mon Sep 17 00:00:00 2001
From: James Addison <jay@jp-hosting.net>
Date: Tue, 21 Feb 2023 18:07:01 +0000
Subject: [PATCH] linux-kernel: update notes related to command-line limits
---
en/appendix/preseed.xml | 9 +++++----
en/boot-installer/parameters.xml | 9 +++++----
2 files changed, 10 insertions(+), 8 deletions(-)
diff --git a/en/appendix/preseed.xml b/en/appendix/preseed.xml
index 0a4582149..1ed69b83b 100644
--- a/en/appendix/preseed.xml
+++ b/en/appendix/preseed.xml
@@ -367,10 +367,11 @@ out any options (like preconfiguration options) that it recognizes.
</para>
<note arch="linux-any"><para>
-Current linux kernels (2.6.9 and later) accept a maximum of 32 command line
-options and 32 environment options, including any options added by default
-for the installer. If these numbers are exceeded, the kernel will panic
-(crash). (For earlier kernels, these numbers were lower.)
+Debian-built Linux kernels accept up to the default maximum of 32 command line
+options and 32 environment options. If these numbers are exceeded, the kernel
+will fail to boot. Additionally, there is an architecture-dependent limit to
+the number of characters for the entire kernel command line; command-lines
+longer than this limit are silently truncated.
</para></note>
<para>
diff --git a/en/boot-installer/parameters.xml b/en/boot-installer/parameters.xml
index 91d981406..18f87dc25 100644
--- a/en/boot-installer/parameters.xml
+++ b/en/boot-installer/parameters.xml
@@ -75,10 +75,11 @@ The installation system recognizes a few additional boot parameters<footnote>
<para>
-With current kernels (2.6.9 or newer) you can use 32 command line options and
-32 environment options. If these numbers are exceeded, the kernel will panic.
-Also there is a limit of 255 characters for the whole kernel command line,
-everything above this limit may be silently truncated.
+Debian-built Linux kernels accept up to the default maximum of 32 command line
+options and 32 environment options. If these numbers are exceeded, the kernel
+will fail to boot. Additionally, there is an architecture-dependent limit to
+the number of characters for the entire kernel command line; command-lines
+longer than this limit are silently truncated.
</para>
--
2.39.1
Reply to: