[people/ms/u-boot.git] / doc / README.JFFS2

JFFS2 options and usage.
-----------------------

JFFS2 in U-Boot is a read only implementation of the file system in
Linux with the same name. To use JFFS2 define CONFIG_CMD_JFFS2.

The module adds three new commands.
fsload  - load binary file from a file system image
fsinfo  - print information about file systems
ls      - list files in a directory
chpart  - change active partition

If you do now need the commands, you can enable the filesystem separately
with CONFIG_FS_JFFS2 and call the jffs2 functions yourself.

If you boot from a partition which is mounted writable, and you
update your boot environment by replacing single files on that
partition, you should also define CONFIG_SYS_JFFS2_SORT_FRAGMENTS. Scanning
the JFFS2 filesystem takes *much* longer with this feature, though.
Sorting is done while inserting into the fragment list, which is
more or less a bubble sort. That algorithm is known to be O(n^2),
thus you should really consider if you can avoid it!


There only one way for JFFS2 to find the disk. It uses the flash_info
structure to find the start of a JFFS2 disk (called partition in the code)
and you can change where the partition is with two defines.

CONFIG_SYS_JFFS2_FIRST_BANK
	defined the first flash bank to use

CONFIG_SYS_JFFS2_FIRST_SECTOR
	defines the first sector to use
---

TODO.

	Remove the assumption that JFFS can dereference a pointer
	into the disk. The current code do not work with memory holes
	or hardware with a sliding window (PCMCIA).
Commit	Line	Data
c609719b WD	1	JFFS2 options and usage.
	2	-----------------------
	3
	4	JFFS2 in U-Boot is a read only implementation of the file system in
b3aff0cb	5	Linux with the same name. To use JFFS2 define CONFIG_CMD_JFFS2.
c609719b WD	6
	7	The module adds three new commands.
	8	fsload - load binary file from a file system image
	9	fsinfo - print information about file systems
	10	ls - list files in a directory
f39748ae	11	chpart - change active partition
c609719b	12
59e12a4a SG	13	If you do now need the commands, you can enable the filesystem separately
	14	with CONFIG_FS_JFFS2 and call the jffs2 functions yourself.
	15
06d01dbe WD	16	If you boot from a partition which is mounted writable, and you
06d01dbe WD	17	update your boot environment by replacing single files on that
6d0f6bcf	18	partition, you should also define CONFIG_SYS_JFFS2_SORT_FRAGMENTS. Scanning
06d01dbe WD	19	the JFFS2 filesystem takes much longer with this feature, though.
	20	Sorting is done while inserting into the fragment list, which is
	21	more or less a bubble sort. That algorithm is known to be O(n^2),
	22	thus you should really consider if you can avoid it!
	23
c609719b	24
b2482dff SG	25	There only one way for JFFS2 to find the disk. It uses the flash_info
	26	structure to find the start of a JFFS2 disk (called partition in the code)
	27	and you can change where the partition is with two defines.
c609719b	28
6d0f6bcf	29	CONFIG_SYS_JFFS2_FIRST_BANK
c609719b WD	30	defined the first flash bank to use
c609719b WD	31
6d0f6bcf	32	CONFIG_SYS_JFFS2_FIRST_SECTOR
c609719b	33	defines the first sector to use
c609719b WD	34	---
	35
	36	TODO.
	37
8bde7f77 WD	38	Remove the assumption that JFFS can dereference a pointer
	39	into the disk. The current code do not work with memory holes
	40	or hardware with a sliding window (PCMCIA).