tizen 2.4 release
[kernel/u-boot-tm1.git] / doc / README.ext4
1 This patch series adds support for ext4 ls,load and write features in uboot
2 Journaling is supported for write feature.
3
4 To Enable ext4 ls and load commands, modify the board specific config file with
5 #define CONFIG_CMD_EXT4
6
7 To enable ext4 write command, modify the board specific config file with
8 #define CONFIG_CMD_EXT4_WRITE
9
10 Steps to test:
11
12 1. After applying the patch, ext4 specific commands can be seen
13    in the boot loader prompt using
14         UBOOT #help
15
16         ext4load- load binary file from a Ext4 file system
17         ext4ls  - list files in a directory (default /)
18         ext4write- create a file in ext4 formatted partition
19
20 2. To list the files in ext4 formatted partition, execute
21         ext4ls <interface> <dev[:part]> [directory]
22         For example:
23         UBOOT #ext4ls mmc 0:5 /usr/lib
24
25 3. To read and load a file from an ext4 formatted partition to RAM, execute
26         ext4load <interface> <dev[:part]> [addr] [filename] [bytes]
27         For example:
28         UBOOT #ext4load mmc 2:2 0x30007fc0 uImage
29
30 4. To write a file to a ext4 formatted partition.
31         a) First load a file to RAM at a particular address for example 0x30007fc0.
32         Now execute ext4write command
33         ext4write <interface> <dev[:part]> [filename] [Address] [sizebytes]
34         For example:
35         UBOOT #ext4write mmc 2:2 /boot/uImage 0x30007fc0 6183120
36         (here 6183120 is the size of the file to be written)
37         Note: Absolute path is required for the file to be written
38
39 5. To format a partition to a ext4 filesystem.
40         ext4format <interface> <dev[:part]>
41         For example:
42         UBOOT #ext4format mmc 2:2
43
44 References :
45         -- ext4 implementation in Linux Kernel
46         -- Uboot existing ext2 load and ls implementation
47         -- Journaling block device JBD2 implementation in linux Kernel
48