X-Git-Url: https://git.librecmc.org/?a=blobdiff_plain;f=doc%2FREADME.pxe;h=42f913c61feba1b61ccbf46e1c51fe0a34d64fe3;hb=5b6b2c6bf8ad14af32f489acaaba0d44ddfc41f3;hp=8363383c53cef10fb9710d411792d397069971d2;hpb=695c1329e8c5cefcd79ed43ca556ddfaeefb368e;p=oweals%2Fu-boot.git diff --git a/doc/README.pxe b/doc/README.pxe index 8363383c53..42f913c61f 100644 --- a/doc/README.pxe +++ b/doc/README.pxe @@ -1,12 +1,11 @@ +SPDX-License-Identifier: GPL-2.0+ /* * Copyright 2010-2011 Calxeda, Inc. - * - * SPDX-License-Identifier: GPL-2.0+ */ 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 +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. Commands @@ -78,9 +77,9 @@ pxe boot address of the tftp server from which other files will be retrieved. kernel_addr_r, initrd_addr_r - locations in RAM at which 'pxe boot' will - store the kernel and initrd it retrieves from tftp. These locations will - be passed to the bootm command to boot the kernel. These environment - variables are required to be set. + store the kernel(or FIT image) and initrd it retrieves from tftp. These + locations will be passed to the bootm command to boot the kernel. These + environment variables are required to be set. fdt_addr_r - location in RAM at which 'pxe boot' will store the fdt blob it retrieves from tftp. The retrieval is possible if 'fdt' label is defined in @@ -99,7 +98,7 @@ with # are treated as comments. White space between and at the beginning of lines is ignored. The size of pxe files and the number of labels is only limited by the amount -of RAM available to U-boot. Memory for labels is dynamically allocated as +of RAM available to U-Boot. Memory for labels is dynamically allocated as they're parsed, and memory for pxe files is statically allocated, and its location is given by the pxefile_addr_r environment variable. The pxe code is not aware of the size of the pxefile memory and will outgrow it if pxe files @@ -138,9 +137,16 @@ menu default - set this label as the default label to boot; this is specified in a different way kernel - if this label is chosen, use tftp to retrieve the kernel - at . it will be stored at the address indicated in - the kernel_addr_r environment variable, and that address - will be passed to bootm to boot this kernel. + (or FIT image) at . it will be stored at the address + indicated in the kernel_addr_r environment variable, and + that address will be passed to bootm to boot this kernel. + For FIT image, The configuration specification can be + appended to the file name, with the format: + #[# - use as the kernel command line when booting this label. @@ -155,6 +161,13 @@ fdt - if this label is chosen, use tftp to retrieve the fdt blob the fdt_addr_r environment variable, and that address will be passed to bootm. +fdtdir - if this label is chosen, use tftp to retrieve a fdt blob + relative to . If the fdtfile environment variable + is set, / is retrieved. Otherwise, the + filename is generated from the soc and board environment + variables, i.e. /-.dtb is retrieved. + If the fdt command is specified, fdtdir is ignored. + localboot - Run the command defined by "localcmd" in the environment. is ignored and is only here to match the syntax of PXELINUX config files. @@ -199,38 +212,38 @@ to be downloaded, and boot with the command line "root=/dev/sdb1" Differences with PXELINUX ========================= -The biggest difference between U-boot's pxe and PXELINUX is that since -U-boot's pxe support is written entirely in C, it can run on any platform -with network support in U-boot. Here are some other differences between -PXELINUX and U-boot's pxe support. +The biggest difference between U-Boot's pxe and PXELINUX is that since +U-Boot's pxe support is written entirely in C, it can run on any platform +with network support in U-Boot. Here are some other differences between +PXELINUX and U-Boot's pxe support. -- U-boot's pxe does not support the PXELINUX DHCP option codes specified +- U-Boot's pxe does not support the PXELINUX DHCP option codes specified in RFC 5071, but could be extended to do so. -- when U-boot's pxe fails to boot, it will return control to U-boot, - allowing another command to run, other U-boot command, instead of resetting +- when U-Boot's pxe fails to boot, it will return control to U-Boot, + allowing another command to run, other U-Boot command, instead of resetting the machine like PXELINUX. -- U-boot's pxe doesn't rely on or provide an UNDI/PXE stack in memory, it - only uses U-boot. +- U-Boot's pxe doesn't rely on or provide an UNDI/PXE stack in memory, it + only uses U-Boot. -- U-boot's pxe doesn't provide the full menu implementation that PXELINUX +- U-Boot's pxe doesn't provide the full menu implementation that PXELINUX does, only a simple text based menu using the commands described in this README. With PXELINUX, it's possible to have a graphical boot - menu, submenus, passwords, etc. U-boot's pxe could be extended to support + menu, submenus, passwords, etc. U-Boot's pxe could be extended to support a more robust menuing system like that of PXELINUX's. -- U-boot's pxe expects U-boot uimg's as kernels. Anything that would work - with the 'bootm' command in U-boot could work with the 'pxe boot' command. +- U-Boot's pxe expects U-Boot uimg's as kernels. Anything that would work + with the 'bootm' command in U-Boot could work with the 'pxe boot' command. -- U-boot's pxe only recognizes a single file on the initrd command line. It +- U-Boot's pxe only recognizes a single file on the initrd command line. It could be extended to support multiple. -- in U-boot's pxe, the localboot command doesn't necessarily cause a local +- in U-Boot's pxe, the localboot command doesn't necessarily cause a local disk boot - it will do whatever is defined in the 'localcmd' env variable. And since it doesn't support a full UNDI/PXE stack, the type field is ignored. -- the interactive prompt in U-boot's pxe only allows you to choose a label +- the interactive prompt in U-Boot's pxe only allows you to choose a label from the menu. If you want to boot something not listed, you can ctrl+c - out of 'pxe boot' and use existing U-boot commands to accomplish it. + out of 'pxe boot' and use existing U-Boot commands to accomplish it.