[J-u-boot.git] / doc / 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.
Commit	Line	Data
4d3c95f5 JL	1	This patch series adds support for ZFS listing and load to u-boot.
	2
	3	To Enable zfs ls and load commands, modify the board specific config file with
	4	#define CONFIG_CMD_ZFS
	5
	6	Steps to test:
	7
	8	1. After applying the patch, zfs specific commands can be seen
	9	in the boot loader prompt using
	10	UBOOT #help
	11
	12	zfsload- load binary file from a ZFS file system
	13	zfsls - list files in a directory (default /)
	14
	15	2. To list the files in zfs pool, device or partition, execute
	16	zfsls <interface> <dev[:part]> [POOL/@/dir/file]
	17	For example:
	18	UBOOT #zfsls mmc 0:5 /rpool/@/usr/bin/
	19
	20	3. To read and load a file from an ZFS formatted partition to RAM, execute
	21	zfsload <interface> <dev[:part]> [addr] [filename] [bytes]
	22	For example:
	23	UBOOT #zfsload mmc 2:2 0x30007fc0 /rpool/@/boot/uImage
	24
	25	References :
	26	-- ZFS GRUB sources from Solaris GRUB-0.97
	27	-- GRUB Bazaar repository
	28
	29	Jorgen Lundman <lundman at lundman.net> 2012.