README.ext4 2.21 KB
Newer Older
1 2
U-Boot supports access of both ext2 and ext4 filesystems, either in read-only
mode or in read-write mode.
Uma Shankar's avatar
Uma Shankar committed
3

4 5
First, to enable support for both ext4 (and, automatically, ext2 as well),
but without selecting the corresponding commands, use one of:
6

7 8
  #define CONFIG_FS_EXT4	(for read-only)
  #define CONFIG_EXT4_WRITE	(for read-write)
9

10
Next, to select the ext2-related commands:
Uma Shankar's avatar
Uma Shankar committed
11

12 13
  * ext2ls
  * ext2load
Uma Shankar's avatar
Uma Shankar committed
14

15
or ext4-related commands:
16

17 18 19
  * ext4size
  * ext4ls
  * ext4load
Uma Shankar's avatar
Uma Shankar committed
20

21
use one or both of:
Uma Shankar's avatar
Uma Shankar committed
22

23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43
  #define CONFIG_CMD_EXT2
  #define CONFIG_CMD_EXT4

Selecting either of the above automatically defines CONFIG_FS_EXT4 if it
wasn't defined already.

In addition, to get the write access command "ext4write", use:

  #define CONFIG_CMD_EXT4_WRITE

which automatically defines CONFIG_EXT4_WRITE if it wasn't defined
already.

Also relevant are the generic filesystem commands, selected by:

  #define CONFIG_CMD_FS_GENERIC

This does not automatically enable EXT4 support for you, you still need
to do that yourself.

Some sample commands to test ext4 support:
Uma Shankar's avatar
Uma Shankar committed
44

45 46 47 48
1. Check that the commands can be seen in the output of U-Boot help:

	UBOOT #help
	...
49 50
	ext4load- load binary file from a Ext4 file system
	ext4ls  - list files in a directory (default /)
51
	ext4size - determine a file's size
52
	ext4write- create a file in ext4 formatted partition
53 54 55
	...

2. To list the files in an ext4-formatted partition, run:
Uma Shankar's avatar
Uma Shankar committed
56

57
	ext4ls <interface> <dev[:part]> [directory]
58

59 60
	For example:
	UBOOT #ext4ls mmc 0:5 /usr/lib
Uma Shankar's avatar
Uma Shankar committed
61

62 63
3. To read and load a file from an ext4-formatted partition to RAM, run:

64
	ext4load <interface> <dev[:part]> [addr] [filename] [bytes]
65

66 67
	For example:
	UBOOT #ext4load mmc 2:2 0x30007fc0 uImage
Uma Shankar's avatar
Uma Shankar committed
68

69 70
4. To write a file to an ext4-formatted partition.

71
	a) First load a file to RAM at a particular address for example 0x30007fc0.
72
	Now execute ext4write command:
73
	ext4write <interface> <dev[:part]> [filename] [Address] [sizebytes]
74

75 76 77 78
	For example:
	UBOOT #ext4write mmc 2:2 /boot/uImage 0x30007fc0 6183120
	(here 6183120 is the size of the file to be written)
	Note: Absolute path is required for the file to be written
Uma Shankar's avatar
Uma Shankar committed
79 80 81 82 83

References :
	-- ext4 implementation in Linux Kernel
	-- Uboot existing ext2 load and ls implementation
	-- Journaling block device JBD2 implementation in linux Kernel