[PATCH 3/3] doc: PXE: mention extlinux.conf and sysboot

Fiona Klute fiona.klute at gmx.de
Mon Jun 30 12:53:23 CEST 2025


These use the same format as PXE boot.

Signed-off-by: Fiona Klute <fiona.klute at gmx.de>
Cc: Tom Rini <trini at konsulko.com>
---
 doc/usage/pxe.rst | 23 +++++++++++++++++++----
 1 file changed, 19 insertions(+), 4 deletions(-)

diff --git a/doc/usage/pxe.rst b/doc/usage/pxe.rst
index d23cd453227..c2dc11f218d 100644
--- a/doc/usage/pxe.rst
+++ b/doc/usage/pxe.rst
@@ -1,19 +1,22 @@
 .. SPDX-License-Identifier: GPL-2.0+
    Copyright 2010-2011 Calxeda, Inc.
 
-PXE Boot
-========
+PXE Boot and extlinux.conf
+==========================
 
 The ``pxe`` commands provide a near subset of the functionality
 provided by the PXELINUX boot loader. This allows U-Boot based systems
 to be controlled remotely using the same PXE based techniques that
 many non U-Boot based servers use.
 
+The ``sysboot`` command and Extlinux boot method use the same file
+format as PXE boot for ``extlinux.conf``.
+
 Commands
 --------
 
 ``pxe get``
-        **syntax:** ``pxe get``
+        **Syntax:** ``pxe get``
 
 	follows PXELINUX's rules for retrieving configuration files
 	from a tftp server, and supports a subset of PXELINUX's config
@@ -30,7 +33,7 @@ Commands
 	http://syslinux.zytor.com/wiki/index.php/Doc/pxelinux
 
 ``pxe boot``
-        **syntax:** ``pxe boot [pxefile_addr_r]``
+        **Syntax:** ``pxe boot [pxefile_addr_r]``
 
 	Interprets a pxe file stored in memory.
 
@@ -40,6 +43,18 @@ Commands
 	There are some environment variables that may need to be set,
 	depending on conditions, see the Environment section below.
 
+``sysboot``
+        **Syntax:** ``sysboot [-p] <interface> <dev[:part]> <ext2|fat|any> [addr] [filename]``
+
+	Load and boot an ``extlinux.conf`` file from a local
+	filesystem. Paths in the ``extlinux.conf`` file (kernel,
+	initrd, FDT and overlays) will be interpreted within that
+	filesystem.
+
+	Example:
+
+	``sysboot mmc 0.0:2 any ${pxefile_addr_r} /boot/extlinux.conf``
+
 Environment
 -----------
 
-- 
2.50.0



More information about the U-Boot mailing list