Blame view

doc/README.ext4 2.18 KB
28983f4b1   Robert P. J. Day   doc: Updated READ...
1
2
  U-Boot supports access of both ext2 and ext4 filesystems, either in read-only
  mode or in read-write mode.
ed34f34db   Uma Shankar   ext4fs write support
3

28983f4b1   Robert P. J. Day   doc: Updated READ...
4
  First, to enable support for both ext4 (and, automatically, ext2 as well),
3d22bae57   Tuomas Tynkkynen   fs: Migrate ext4 ...
5
  but without selecting the corresponding commands, enable one of the following:
03e2ecf6b   Stephen Warren   fs: separate CONF...
6

3d22bae57   Tuomas Tynkkynen   fs: Migrate ext4 ...
7
8
    CONFIG_FS_EXT4	(for read-only)
    CONFIG_EXT4_WRITE	(for read-write)
03e2ecf6b   Stephen Warren   fs: separate CONF...
9

28983f4b1   Robert P. J. Day   doc: Updated READ...
10
  Next, to select the ext2-related commands:
ed34f34db   Uma Shankar   ext4fs write support
11

28983f4b1   Robert P. J. Day   doc: Updated READ...
12
13
    * ext2ls
    * ext2load
ed34f34db   Uma Shankar   ext4fs write support
14

28983f4b1   Robert P. J. Day   doc: Updated READ...
15
  or ext4-related commands:
03e2ecf6b   Stephen Warren   fs: separate CONF...
16

28983f4b1   Robert P. J. Day   doc: Updated READ...
17
18
19
    * ext4size
    * ext4ls
    * ext4load
ed34f34db   Uma Shankar   ext4fs write support
20

28983f4b1   Robert P. J. Day   doc: Updated READ...
21
  use one or both of:
ed34f34db   Uma Shankar   ext4fs write support
22

3d22bae57   Tuomas Tynkkynen   fs: Migrate ext4 ...
23
24
    CONFIG_CMD_EXT2
    CONFIG_CMD_EXT4
28983f4b1   Robert P. J. Day   doc: Updated READ...
25

3d22bae57   Tuomas Tynkkynen   fs: Migrate ext4 ...
26
27
  Selecting either of the above automatically selects CONFIG_FS_EXT4 if it
  wasn't enabled already.
28983f4b1   Robert P. J. Day   doc: Updated READ...
28

3d22bae57   Tuomas Tynkkynen   fs: Migrate ext4 ...
29
  In addition, to get the write access command "ext4write", enable:
28983f4b1   Robert P. J. Day   doc: Updated READ...
30

3d22bae57   Tuomas Tynkkynen   fs: Migrate ext4 ...
31
    CONFIG_CMD_EXT4_WRITE
28983f4b1   Robert P. J. Day   doc: Updated READ...
32

3d22bae57   Tuomas Tynkkynen   fs: Migrate ext4 ...
33
  which automatically selects CONFIG_EXT4_WRITE if it wasn't defined
28983f4b1   Robert P. J. Day   doc: Updated READ...
34
35
36
  already.
  
  Also relevant are the generic filesystem commands, selected by:
3d22bae57   Tuomas Tynkkynen   fs: Migrate ext4 ...
37
    CONFIG_CMD_FS_GENERIC
28983f4b1   Robert P. J. Day   doc: Updated READ...
38
39
40
41
42
  
  This does not automatically enable EXT4 support for you, you still need
  to do that yourself.
  
  Some sample commands to test ext4 support:
ed34f34db   Uma Shankar   ext4fs write support
43

28983f4b1   Robert P. J. Day   doc: Updated READ...
44
45
46
47
  1. Check that the commands can be seen in the output of U-Boot help:
  
  	UBOOT #help
  	...
93e145964   Wolfgang Denk   Coding Style clea...
48
49
  	ext4load- load binary file from a Ext4 file system
  	ext4ls  - list files in a directory (default /)
28983f4b1   Robert P. J. Day   doc: Updated READ...
50
  	ext4size - determine a file's size
93e145964   Wolfgang Denk   Coding Style clea...
51
  	ext4write- create a file in ext4 formatted partition
28983f4b1   Robert P. J. Day   doc: Updated READ...
52
53
54
  	...
  
  2. To list the files in an ext4-formatted partition, run:
ed34f34db   Uma Shankar   ext4fs write support
55

93e145964   Wolfgang Denk   Coding Style clea...
56
  	ext4ls <interface> <dev[:part]> [directory]
28983f4b1   Robert P. J. Day   doc: Updated READ...
57

93e145964   Wolfgang Denk   Coding Style clea...
58
59
  	For example:
  	UBOOT #ext4ls mmc 0:5 /usr/lib
ed34f34db   Uma Shankar   ext4fs write support
60

28983f4b1   Robert P. J. Day   doc: Updated READ...
61
  3. To read and load a file from an ext4-formatted partition to RAM, run:
93e145964   Wolfgang Denk   Coding Style clea...
62
  	ext4load <interface> <dev[:part]> [addr] [filename] [bytes]
28983f4b1   Robert P. J. Day   doc: Updated READ...
63

93e145964   Wolfgang Denk   Coding Style clea...
64
65
  	For example:
  	UBOOT #ext4load mmc 2:2 0x30007fc0 uImage
ed34f34db   Uma Shankar   ext4fs write support
66

28983f4b1   Robert P. J. Day   doc: Updated READ...
67
  4. To write a file to an ext4-formatted partition.
93e145964   Wolfgang Denk   Coding Style clea...
68
  	a) First load a file to RAM at a particular address for example 0x30007fc0.
28983f4b1   Robert P. J. Day   doc: Updated READ...
69
  	Now execute ext4write command:
93e145964   Wolfgang Denk   Coding Style clea...
70
  	ext4write <interface> <dev[:part]> [filename] [Address] [sizebytes]
28983f4b1   Robert P. J. Day   doc: Updated READ...
71

93e145964   Wolfgang Denk   Coding Style clea...
72
73
74
75
  	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
ed34f34db   Uma Shankar   ext4fs write support
76
77
78
79
80
  
  References :
  	-- ext4 implementation in Linux Kernel
  	-- Uboot existing ext2 load and ls implementation
  	-- Journaling block device JBD2 implementation in linux Kernel