From mboxrd@z Thu Jan 1 00:00:00 1970 Delivery-date: Wed, 22 Apr 2026 11:15:06 +0200 Received: from metis.whiteo.stw.pengutronix.de ([2a0a:edc0:2:b01:1d::104]) by lore.white.stw.pengutronix.de with esmtps (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.96) (envelope-from ) id 1wFTfm-00F2zo-25 for lore@lore.pengutronix.de; Wed, 22 Apr 2026 11:15:06 +0200 Received: from bombadil.infradead.org ([2607:7c80:54:3::133]) by metis.whiteo.stw.pengutronix.de with esmtps (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1wFTfm-00076g-1D for lore@pengutronix.de; Wed, 22 Apr 2026 11:15:06 +0200 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=bombadil.20210309; h=Sender:List-Subscribe:List-Help :List-Post:List-Archive:List-Unsubscribe:List-Id:Content-Transfer-Encoding: Content-Type:In-Reply-To:From:References:To:Subject:MIME-Version:Date: Message-ID:Reply-To:Cc:Content-ID:Content-Description:Resent-Date:Resent-From :Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:List-Owner; bh=VB9s8IWKW4IXXce9hd3/HMJn0/1xgdvz3XQ4iw1vKI8=; b=aT/zZkGcacZ7e/L3cQ4Ng4dP1f pYL/ziILHeTdWKZO6qcesOLoZN8eVen5VDFxBZt/X7qehe/MIjvlbRAyKGevr8r7AXuNHTVnlPJwx BepHswr2O+YbPHrQ5QUoSXM3caDncWtd2885bmxgl3t4a07Cn92qBXBxQlkQEe394PK/bx7YPR/UC YWMQN3JFEgsIisd3rJottVFYkjvOYNyV6lBp3tn3xOsb/lqsJCO6n8aXM+sdXqXzPn9rSRVuCC5eV ZLi8I0UDtfIQXL8pkyo6eYzMSa+vR/0DiD6HCM9tW6JhMKECcWQawCkCrHXfpdvcTKUm8V5oSnXUu Y79h6HpA==; Received: from localhost ([::1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.98.2 #2 (Red Hat Linux)) id 1wFTfO-00000009pGr-431g; Wed, 22 Apr 2026 09:14:42 +0000 Received: from metis.whiteo.stw.pengutronix.de ([2a0a:edc0:2:b01:1d::104]) by bombadil.infradead.org with esmtps (Exim 4.98.2 #2 (Red Hat Linux)) id 1wFTfM-00000009pGC-0for for barebox@lists.infradead.org; Wed, 22 Apr 2026 09:14:41 +0000 Received: from ptz.office.stw.pengutronix.de ([2a0a:edc0:0:900:1d::77] helo=[127.0.0.1]) by metis.whiteo.stw.pengutronix.de with esmtp (Exim 4.92) (envelope-from ) id 1wFTfK-00070k-JI; Wed, 22 Apr 2026 11:14:38 +0200 Message-ID: <2a9c9062-621c-4d8d-bbb9-5f979a4da81d@pengutronix.de> Date: Wed, 22 Apr 2026 11:14:38 +0200 MIME-Version: 1.0 User-Agent: Mozilla Thunderbird To: Alexander Shiyan , barebox@lists.infradead.org References: <20260416134518.3282395-1-eagle.alexander923@gmail.com> <20260416134518.3282395-2-eagle.alexander923@gmail.com> From: Ahmad Fatoum Content-Language: en-US, de-DE, de-BE In-Reply-To: <20260416134518.3282395-2-eagle.alexander923@gmail.com> Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 7bit X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20260422_021440_204290_86B797A8 X-CRM114-Status: GOOD ( 22.53 ) X-BeenThere: barebox@lists.infradead.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: "barebox" X-SA-Exim-Connect-IP: 2607:7c80:54:3::133 X-SA-Exim-Mail-From: barebox-bounces+lore=pengutronix.de@lists.infradead.org X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on metis.whiteo.stw.pengutronix.de X-Spam-Level: X-Spam-Status: No, score=-4.9 required=4.0 tests=AWL,BAYES_00,DKIMWL_WL_HIGH, DKIM_SIGNED,DKIM_VALID,HEADER_FROM_DIFFERENT_DOMAINS, MAILING_LIST_MULTI,RCVD_IN_DNSWL_MED,SPF_HELO_NONE,SPF_NONE autolearn=unavailable autolearn_force=no version=3.4.2 Subject: Re: [PATCH 2/2] Documentation: add extlinux.conf support description X-SA-Exim-Version: 4.2.1 (built Wed, 08 May 2019 21:11:16 +0000) X-SA-Exim-Scanned: Yes (on metis.whiteo.stw.pengutronix.de) Hi, On 4/16/26 3:45 PM, Alexander Shiyan wrote: > Signed-off-by: Alexander Shiyan Thanks for adding documentation. I have been wanting to add bootloader spec support to openembedded-core to barebox can be used to boot Beaglebone black images generated by it, but with extlinux support in barebox that should work as well. I will surely give this a try in the future. Could I motivate you to add a self test that exercises the parser? Doesn't have to be anything extensive, see test/self/blspec.c for an example. It's basically adding a few configs into the barebox environment, calling bootentry_create_from_name() on the directory and then running some assertions. Thanks, Ahmad > --- > Documentation/user/booting-linux.rst | 38 ++++++++++++++++++++++++++++ > 1 file changed, 38 insertions(+) > > diff --git a/Documentation/user/booting-linux.rst b/Documentation/user/booting-linux.rst > index ed1ec3f68a..307f33bb22 100644 > --- a/Documentation/user/booting-linux.rst > +++ b/Documentation/user/booting-linux.rst > @@ -306,6 +306,44 @@ Additional notes about keys in the bootloader spec entries: > different devices without having to specify a different ``root=`` option each > time. > > +.. _extlinux_conf: > + > +extlinux.conf Support > +^^^^^^^^^^^^^^^^^^^^^ > + > +In addition to the Boot Loader Specification, barebox also supports the > +extlinux configuration format, commonly used by the Syslinux bootloader and > +many Linux distributions. This format is often found on SD cards, USB drives, > +or disk partitions prepared with tools like ``extlinux --install``. > + > +The configuration file is named ``extlinux.conf`` and can be located at: > +* ``/boot/extlinux/extlinux.conf`` > + > +The file uses a simple key-value syntax with sections labeled by ``LABEL``. > +A typical example looks like: > + > +.. code-block:: none > + > + DEFAULT linux > + LABEL linux > + KERNEL /boot/vmlinuz > + INITRD /boot/initrd.img > + FDT /boot/board.dtb > + APPEND console=ttyS0,115200 root=PARTUUID=deadbeef-01 > + > +When booting an extlinux entry, barebox automatically strips any ``root=`` > +parameter from the ``APPEND`` line and injects the correct ``root=`` based on > +the boot device (similar to the ``linux-appendroot`` feature in blspec). This > +makes the same root filesystem image usable across different storage media. > + > +To use extlinux support, enable ``CONFIG_EXTLINUX`` in your barebox > +configuration. Entries are automatically discovered by the :ref:`command_boot` > +command when scanning a device or mount point. For example: > + > +.. code-block:: sh > + > + boot mmc1.2 > + > .. _booting_linux_net: > > Network boot -- Pengutronix e.K. | | Steuerwalder Str. 21 | http://www.pengutronix.de/ | 31137 Hildesheim, Germany | Phone: +49-5121-206917-0 | Amtsgericht Hildesheim, HRA 2686 | Fax: +49-5121-206917-5555 |