mtd/util mkfs.jffs2.1,1.2,1.3

[David Woodhouse]

Update of /home/cvs/mtd/util
In directory phoenix.infradead.org:/tmp/cvs-serv9235

Modified Files:
	mkfs.jffs2.1 
Log Message:
Update man page

Index: mkfs.jffs2.1
===================================================================
RCS file: /home/cvs/mtd/util/mkfs.jffs2.1,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- mkfs.jffs2.1	24 Apr 2001 01:48:52 -0000	1.2
+++ mkfs.jffs2.1	12 Jan 2003 15:31:31 -0000	1.3
@@ -2,34 +2,60 @@
 .SH NAME
 mkfs.jffs2 \- Create a JFFS2 filesystem image from directory
 .SH SYNOPSIS
-.B mkfs.jffs
+.B mkfs.jffs2
 [
-.B -b,--big-endian
-.B -l,--little-endian
+.B -p,--pad[=SIZE]
 ]
 [
-.B -e,--eraseblock=SIZE
+.B -r,-d,--root
+.I directory
 ]
 [
 .B -s,--pagesize=SIZE
 ]
 [
-.B -p,--pad[=SIZE]
-]
-[
-.B \-h,\-\-help
+.B -e,--eraseblock=SIZE
 ]
 [
-.B -v,--version
+.B -c,--cleanmarker=SIZE
 ]
 [
-.B -r,--root
-.I directory
+.B -n,--no-cleanmarkers
 ]
 [
 .B -o,--output
 .I image.jffs2
 ]
+|
+.B -l,--little-endian
+]
+[
+.B -b,--big-endian
+]
+[
+.B -D,--devtable=FILE
+]
+[
+.B -f,--faketime
+]
+[
+.B -q,--squash
+]
+[
+.B -U,--squash-uids
+]
+[
+.B -P,--squash-perms
+]
+[
+.B -h,--help
+]
+[
+.B -v,--verbose
+]
+[
+.B -V,--version
+]
 .SH DESCRIPTION
 The program
 .B mkfs.jffs2
@@ -55,9 +81,10 @@
 .B -b
 or
 .B -l
-options are specified.  As of 2001-04-21, the JFFS2 driver in the
-Linux kernel only supported images having the same endianness as
-the CPU.
+options are specified.  JFFS2 driver in the 2.4 Linux kernel only
+supported images having the same endianness as the CPU. As of 2.5.48,
+the kernel can be changed with a #define to accept images of the
+non-native endianness.
 
 It is unlikely that JFFS2 images are useful except in conjuction
 with the MTD (Memory Technology Device) drivers in the Linux
@@ -67,38 +94,72 @@
 Options that take SIZE arguments can be specified as either
 decimal (e.g., 65536), octal (0200000), or hexidecimal (0x1000).
 .TP
-.B -b, --big-endian
-Create a big-endian JFFS2 image.  Default is to make an image
-with the same endianness as the host.
+.B -p, --pad[=SIZE]
+Pad output to SIZE bytes with 0xFF.  If SIZE is not specified,
+the output is padded to the end of the final erase block.
+.TP
+.B -r, -d, --root=DIR
+Build filesystem from directory DIR.  The default is the current
+directory.
+.TP
+.B -s, --pagesize=SIZE
+Use page size SIZE.  The default is 4 KiB.  This size is the
+maximum size of a data node.
 .TP
 .B -e, --eraseblock=SIZE
-Use erase block size SIZE.  The default is 64 kB.  If you use
-a erase block size different than the erase block size of the
-target MTD device, JFFS2 may not perform optimally.
+Use erase block size SIZE.  The default is 64 KiB.  If you use a erase
+block size different than the erase block size of the target MTD
+device, JFFS2 may not perform optimally. If the SIZE specified is
+below 4096, the units are assumed to be KiB.
+.TP
+.B -c, --cleanmarker=SIZE
+Write \'CLEANMARKER\' nodes with the size specified. It is not
+normally appropriate to specify a size other than the default 12
+bytes.
+.TP
+.B -n, --no-cleanmarkers
+Do not write \'CLEANMARKER\' nodes to the beginning of each erase
+block. This option can be useful for creating JFFS2 images for
+use on NAND flash, and for creating images which are to be used
+on a variety of hardware with differing eraseblock sizes.
 .TP
-.B -h, --help
-Display help text.
+.B -o, --output=FILE
+Write JFFS2 image to file FILE.  Default is the standard output.
 .TP
 .B -l, --little-endian
 Create a little-endian JFFS2 image.  Default is to make an image
 with the same endianness as the host.
 .TP
-.B -o, --output=FILE
-Write JFFS2 image to file FILE.  Default is the standard output.
+.B -b, --big-endian
+Create a big-endian JFFS2 image.  Default is to make an image
+with the same endianness as the host.
 .TP
-.B -p, --pad[=SIZE]
-Pad output to SIZE bytes with 0xFF.  If SIZE is not specified,
-the output is padded to the end of the final erase block.
+.B -D, --devtable=FILE
+Use the named FILE as a device table file, for including devices and
+changing permissions in the created image when the user does not have
+appropriate permissions to create them on the file system used as
+source.
+.TP
+.B -f, --faketime
+Change all file timestamps to \'0\' for regression testing.
+.TP
+.B -q, --squash
+Squash permissions and owners, making all files be owned by root and
+removing write permission for \'group\' and \'other\'.
 .TP
-.B -r, -d, --root=DIR
-Build filesystem from directory DIR.  The default is the current
-directory.
+.B -U, --squash-uids
+Squash owners making all files be owned by root.
 .TP
-.B -s, --pagesize=SIZE
-Use page size SIZE.  The default is 4 kB.  This size is the
-maximum size of a data node.
+.B -P, --squash-perms
+Squash permissions, removing write permission for \'group\' and \'other\'.
+.TP
+.B -h, --help
+Display help text.
+.TP
+.B -v, --verbose
+Verbose operation.
 .TP
-.B -v, --version
+.B -V, --version
 Display version information.
 .SH BUGS
 JFFS2 limits device major and minor numbers to 8 bits each.  Some