u-boot/doc
Linus Walleij 41a29f284c cmd: Add a SEAMA image load command
Add a command to load SEAMA (Seattle Image), a NAND flash
on-flash storage format.

This type of flash image is found in some D-Link routers such
as DIR-645, DIR-842, DIR-859, DIR-860L, DIR-885L, DIR890L and
DCH-M225, as well as in WD and NEC routers on the ath79
(MIPS), Broadcom BCM53xx, and RAMIPS platforms.

This U-Boot command will read and decode a SEAMA image from
raw NAND flash on any platform. As it is always using big endian
format for the data decoding is always necessary on platforms
such as ARM.

The command is needed to read a SEAMA-encoded boot image on the
D-Link DIR-890L router for boot from NAND flash in an upcoming
port of U-Boot to the Broadcom Northstar (BCM4709, BCM53xx)
architecture.

A basic test and documentation is added as well. The test must
be run on a target with NAND flash support and at least one
resident SEAMA image in flash.

Cc: Rafał Miłecki <rafal@milecki.pl>
Signed-off-by: Linus Walleij <linus.walleij@linaro.org>
2023-02-06 17:10:15 -05:00
..
SPI
SPL Rename CONFIG_SYS_TEXT_BASE to CONFIG_TEXT_BASE 2022-10-31 11:01:31 -04:00
android fastboot: Add OEM run command 2023-01-11 15:02:24 -05:00
api doc: documentation of EFI driver binding protocol 2022-10-06 22:54:57 +02:00
arch global: Migrate CONFIG_MALLOC_F_ADDR to CFG 2022-12-23 10:14:51 -05:00
board For 2023.04 2023-02-01 09:30:52 -05:00
build doc: move 'Reproducible builds' 2023-01-27 18:32:00 +01:00
chromium Rename CONFIG_SYS_TEXT_BASE to CONFIG_TEXT_BASE 2022-10-31 11:01:31 -04:00
develop bootstd: Add some default filesystems and commands 2023-02-06 13:04:53 -05:00
device-tree-bindings dt-bindings: mtd: Add ti, elm DT binding documentation 2023-01-08 10:38:50 +01:00
imx global: Move remaining CONFIG_SYS_* to CFG_SYS_* 2022-12-05 16:06:08 -05:00
media doc: add texinfodocs and infodocs targets 2022-12-29 10:51:50 +01:00
mvebu
sphinx doc: update Sphinx requirements for certifi 2022-12-17 15:25:52 +00:00
sphinx-static
uImage.FIT cmd: source: Support specifying config name 2022-12-31 13:35:19 -05:00
usage cmd: Add a SEAMA image load command 2023-02-06 17:10:15 -05:00
.gitignore
I2C_Edge_Conditions
Makefile doc: add texinfodocs and infodocs targets 2022-12-29 10:51:50 +01:00
README.Heterogeneous-SoCs
README.JFFS2_NAND
README.LED
README.OFT
README.POST post: Move CONFIG_SYS_POST to CFG_SYS_POST 2022-12-23 13:01:13 -05:00
README.SNTP
README.TPL
README.VLAN
README.VSC3316-3308
README.arm-caches
README.arm-relocation global: Move remaining CONFIG_SYS_NAND_* to CFG_SYS_NAND_* 2022-12-05 16:05:38 -05:00
README.armada-secureboot Makefile: Rename u-boot-spl.kwb to u-boot-with-spl.kwb 2022-11-07 07:17:55 +01:00
README.asn1
README.atmel_mci global: Move remaining CONFIG_SYS_* to CFG_SYS_* 2022-12-05 16:06:08 -05:00
README.atmel_pmecc
README.autoboot
README.bcm7xxx
README.bcmns3
README.bitbangMII
README.bootcount bootcount: clarify documentation 2022-03-23 07:27:38 +01:00
README.boston
README.cfi global: Move remaining CONFIG_SYS_* to CFG_SYS_* 2022-12-05 16:06:08 -05:00
README.commands.itest
README.commands.spl
README.console
README.davinci global: Finish CONFIG -> CFG migration 2023-01-20 12:27:24 -05:00
README.davinci.nand_spl
README.dfutftp
README.displaying-bmps
README.dns
README.enetaddr
README.esbc_validate
README.ext4
README.falcon
README.fec_mxc global: Finish CONFIG -> CFG migration 2023-01-20 12:27:24 -05:00
README.fsl-ddr global: Migrate CONFIG_EXTRA_ENV_SETTINGS to CFG 2022-12-23 10:09:42 -05:00
README.fsl-esdhc
README.fsl-hwconfig
README.fsl-trustzone-components
README.fsl_iim Convert CONFIG_FSL_IIM to Kconfig 2022-12-05 16:06:43 -05:00
README.fuse
README.generic-board
README.generic_usb_ohci global: Move remaining CONFIG_SYS_* to CFG_SYS_* 2022-12-05 16:06:08 -05:00
README.gpio gpio: Get rid of gpio_hog_probe_all() 2023-01-12 14:06:16 -05:00
README.gpt doc: fix references to distro documentation 2023-01-20 16:38:52 +01:00
README.hwconfig Convert CONFIG_HWCONFIG to Kconfig 2022-12-05 16:07:12 -05:00
README.i2c
README.iomux
README.kconfig Revert "Revert "global: Remove CONFIG_SYS_EXTRA_OPTIONS support"" 2022-08-05 11:47:56 -04:00
README.kwbimage global: Migrate CONFIG_BOARDDIR to CFG 2022-12-23 10:07:03 -05:00
README.link-local global: Migrate CONFIG_EXTRA_ENV_SETTINGS to CFG 2022-12-23 10:09:42 -05:00
README.malta
README.marvell
README.mediatek
README.memory-test
README.mpc83xx.ddrecc
README.mpc83xxads
README.mpc85xx global: Move remaining CONFIG_SYS_* to CFG_SYS_* 2022-12-05 16:06:08 -05:00
README.mpc85xx-sd-spi-boot Fix URLs to old freescale git repos 2022-03-28 08:22:17 -04:00
README.mpc85xx-spin-table
README.mpc85xxcds
README.multi-dtb-fit
README.mxc_ocotp
README.nand global: Move remaining CONFIG_SYS_* to CFG_SYS_* 2022-12-05 16:06:08 -05:00
README.odroid
README.omap-ulpi-viewport
README.omap3 global: Move remaining CONFIG_SYS_NAND_* to CFG_SYS_NAND_* 2022-12-05 16:05:38 -05:00
README.pblimage ppc: Remove corenet_ds boards 2022-08-20 21:18:15 -04:00
README.pcap
README.power-framework
README.pxe cmd: pxe: support INITRD and FDT selection with FIT 2022-12-12 14:03:12 -05:00
README.ramboot-ppc85xx
README.rmobile
README.rockchip
README.rockusb
README.s5p4418
README.s5pc1xx
README.sata
README.sched
README.scrapyard
README.serial_multi global: Move remaining CONFIG_SYS_* to CFG_SYS_* 2022-12-05 16:06:08 -05:00
README.sha1
README.silent
README.socfpga global: Remove unused CONFIG defines 2023-01-20 12:27:06 -05:00
README.splashprepare
README.srio-pcie-boot-corenet
README.standalone nds32: Remove the architecture 2022-04-25 16:04:05 -04:00
README.t1040-l2switch
README.tee
README.ti-secure
README.ubi
README.ubispl
README.ublimage
README.udp
README.unaligned-memory-access.txt
README.uniphier doc: fix references to distro documentation 2023-01-20 16:38:52 +01:00
README.update
README.usb
README.vf610
README.video
README.watchdog nds32: Remove the architecture 2022-04-25 16:04:05 -04:00
README.zfs
bounces
conf.py doc: add texinfodocs and infodocs targets 2022-12-29 10:51:50 +01:00
dumpimage.1 doc: Add man page for dumpimage 2022-07-13 20:05:49 +02:00
feature-removal-schedule.txt
git-mailrc git-mailrc: remove invalid entry 'efi' 2022-08-13 11:09:48 +02:00
index.rst
kwboot.1 Makefile: Rename u-boot-spl.kwb to u-boot-with-spl.kwb 2022-11-07 07:17:55 +01:00
mkeficapsule.1 doc: rework doc/mkeficapsule.1 2023-01-27 18:31:59 +01:00
mkimage.1 mkimage: fit: Support signed configurations in 'auto' FITs 2023-01-27 12:51:27 -05:00

README.zfs

This patch series adds support for ZFS listing and load to u-boot.

To Enable zfs ls and load commands, modify the board specific config file with
#define CONFIG_CMD_ZFS

Steps to test:

1. After applying the patch, zfs specific commands can be seen
   in the boot loader prompt using
	UBOOT #help

	zfsload- load binary file from a ZFS file system
	zfsls  - list files in a directory (default /)

2. To list the files in zfs pool, device or partition, execute
	zfsls <interface> <dev[:part]> [POOL/@/dir/file]
	For example:
	UBOOT #zfsls mmc 0:5 /rpool/@/usr/bin/

3. To read and load a file from an ZFS formatted partition to RAM, execute
	zfsload <interface> <dev[:part]> [addr] [filename] [bytes]
	For example:
	UBOOT #zfsload mmc 2:2 0x30007fc0 /rpool/@/boot/uImage

References :
	-- ZFS GRUB sources from Solaris GRUB-0.97
	-- GRUB Bazaar repository

Jorgen Lundman <lundman at lundman.net> 2012.