[PATCH 2/3] Documentation: user: booting-linux: split off mtdparts fixup section

Ahmad Fatoum a.fatoum at pengutronix.de
Tue May 5 02:50:59 PDT 2026


Specifying mtdparts on the command line instead of the device tree is
not as relevant nowadays, so move it into its own section at the end as
not to clutter the more relevant global.linux.bootargs section that is
going to be extended in a later commit.

While at it, extend it to cover the related blkdevparts as well.

Signed-off-by: Ahmad Fatoum <a.fatoum at pengutronix.de>
---
 Documentation/user/booting-linux.rst | 55 +++++++++++++++-------------
 1 file changed, 30 insertions(+), 25 deletions(-)

diff --git a/Documentation/user/booting-linux.rst b/Documentation/user/booting-linux.rst
index 3972777f30cf..cc0bdb4661ca 100644
--- a/Documentation/user/booting-linux.rst
+++ b/Documentation/user/booting-linux.rst
@@ -98,31 +98,6 @@ with ``global.linux.bootargs.`` will be concatenated to the bootargs:
 
   Kernel command line: console=ttymxc0,115200n8 earlyprintk ignore_loglevel
 
-Additionally all variables starting with ``global.linux.mtdparts.`` are concatenated
-to a ``mtdparts=`` parameter to the kernel. This makes it possible to consistently
-partition devices with the :ref:`command_addpart` command and pass the same string as used
-with addpart to the Kernel:
-
-.. code-block:: sh
-
-  norparts="512k(bootloader),512k(env),4M(kernel),-(root)"
-  nandparts="1M(bootloader),1M(env),4M(kernel),-(root)"
-
-  global linux.mtdparts.nor0="physmap-flash.0:$norparts"
-  global linux.mtdparts.nand0="mxc_nand:$nandparts"
-
-  addpart /dev/nor0 $norparts
-  addpart /dev/nand0 $nandparts
-
-  ...
-
-  bootm zImage
-
-  ...
-
-  Kernel command line: mtdparts=physmap-flash.0:512k(bootloader),512k(env),4M(kernel),-(root);
-			mxc_nand:1M(bootloader),1M(env),4M(kernel),-(root)
-
 Creating root= options for the Kernel
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -380,3 +355,33 @@ If the preconfigured paths or names are not suitable, they can be adjusted in
 
 ``boot net`` will then retrieve the kernel (and also the device tree and
 initramfs, if used) over TFTP and boot it.
+
+mtdparts/blkdevparts fixup
+--------------------------
+
+All variables starting with ``global.linux.mtdparts.`` or ``global.linux.blkdevparts``
+are concatenated to a ``mtdparts=`` or ``blkdevparts=`` parameter to the
+kernel, respectively.
+This makes it possible to consistently partition devices with the :ref:`command_addpart`
+command and pass the same string as used with addpart to the Kernel:
+
+.. code-block:: sh
+
+  norparts="512k(bootloader),512k(env),4M(kernel),-(root)"
+  nandparts="1M(bootloader),1M(env),4M(kernel),-(root)"
+
+  global linux.mtdparts.nor0="physmap-flash.0:$norparts"
+  global linux.mtdparts.nand0="mxc_nand:$nandparts"
+
+  addpart /dev/nor0 $norparts
+  addpart /dev/nand0 $nandparts
+
+  ...
+
+  bootm zImage
+
+  ...
+
+  Kernel command line: mtdparts=physmap-flash.0:512k(bootloader),512k(env),4M(kernel),-(root);
+			mxc_nand:1M(bootloader),1M(env),4M(kernel),-(root)
+
-- 
2.47.3




More information about the barebox mailing list