xref: /rk3399_rockchip-uboot/include/jffs2/jffs2.h (revision 412babe304b948e1e3a909f8d2eb091b83f700d5)
1fe8c2806Swdenk /*
2fe8c2806Swdenk  * JFFS2 -- Journalling Flash File System, Version 2.
3fe8c2806Swdenk  *
4fe8c2806Swdenk  * Copyright (C) 2001 Red Hat, Inc.
5fe8c2806Swdenk  *
6fe8c2806Swdenk  * Created by David Woodhouse <dwmw2@cambridge.redhat.com>
7fe8c2806Swdenk  *
8fe8c2806Swdenk  * The original JFFS, from which the design for JFFS2 was derived,
9fe8c2806Swdenk  * was designed and implemented by Axis Communications AB.
10fe8c2806Swdenk  *
11fe8c2806Swdenk  * The contents of this file are subject to the Red Hat eCos Public
12fe8c2806Swdenk  * License Version 1.1 (the "Licence"); you may not use this file
13fe8c2806Swdenk  * except in compliance with the Licence.  You may obtain a copy of
14fe8c2806Swdenk  * the Licence at http://www.redhat.com/
15fe8c2806Swdenk  *
16fe8c2806Swdenk  * Software distributed under the Licence is distributed on an "AS IS"
17fe8c2806Swdenk  * basis, WITHOUT WARRANTY OF ANY KIND, either express or implied.
18fe8c2806Swdenk  * See the Licence for the specific language governing rights and
19fe8c2806Swdenk  * limitations under the Licence.
20fe8c2806Swdenk  *
21fe8c2806Swdenk  * The Original Code is JFFS2 - Journalling Flash File System, version 2
22fe8c2806Swdenk  *
23fe8c2806Swdenk  * Alternatively, the contents of this file may be used under the
24fe8c2806Swdenk  * terms of the GNU General Public License version 2 (the "GPL"), in
25fe8c2806Swdenk  * which case the provisions of the GPL are applicable instead of the
26fe8c2806Swdenk  * above.  If you wish to allow the use of your version of this file
27fe8c2806Swdenk  * only under the terms of the GPL and not to allow others to use your
28fe8c2806Swdenk  * version of this file under the RHEPL, indicate your decision by
29fe8c2806Swdenk  * deleting the provisions above and replace them with the notice and
30fe8c2806Swdenk  * other provisions required by the GPL.  If you do not delete the
31fe8c2806Swdenk  * provisions above, a recipient may use your version of this file
32fe8c2806Swdenk  * under either the RHEPL or the GPL.
33fe8c2806Swdenk  *
34fe8c2806Swdenk  * $Id: jffs2.h,v 1.2 2002/01/17 00:53:20 nyet Exp $
35fe8c2806Swdenk  *
36fe8c2806Swdenk  */
37fe8c2806Swdenk 
38fe8c2806Swdenk #ifndef __LINUX_JFFS2_H__
39fe8c2806Swdenk #define __LINUX_JFFS2_H__
40fe8c2806Swdenk 
41fe8c2806Swdenk #include <asm/types.h>
42fe8c2806Swdenk #include <jffs2/load_kernel.h>
43fe8c2806Swdenk 
44fe8c2806Swdenk #define JFFS2_SUPER_MAGIC 0x72b6
45fe8c2806Swdenk 
46fe8c2806Swdenk /* Values we may expect to find in the 'magic' field */
47fe8c2806Swdenk #define JFFS2_OLD_MAGIC_BITMASK 0x1984
48fe8c2806Swdenk #define JFFS2_MAGIC_BITMASK 0x1985
49fe8c2806Swdenk #define KSAMTIB_CIGAM_2SFFJ 0x5981 /* For detecting wrong-endian fs */
50fe8c2806Swdenk #define JFFS2_EMPTY_BITMASK 0xffff
51fe8c2806Swdenk #define JFFS2_DIRTY_BITMASK 0x0000
52fe8c2806Swdenk 
53fe8c2806Swdenk /* We only allow a single char for length, and 0xFF is empty flash so
54fe8c2806Swdenk    we don't want it confused with a real length. Hence max 254.
55fe8c2806Swdenk */
56fe8c2806Swdenk #define JFFS2_MAX_NAME_LEN 254
57fe8c2806Swdenk 
58fe8c2806Swdenk /* How small can we sensibly write nodes? */
59fe8c2806Swdenk #define JFFS2_MIN_DATA_LEN 128
60fe8c2806Swdenk 
61fe8c2806Swdenk #define JFFS2_COMPR_NONE	0x00
62fe8c2806Swdenk #define JFFS2_COMPR_ZERO	0x01
63fe8c2806Swdenk #define JFFS2_COMPR_RTIME	0x02
64fe8c2806Swdenk #define JFFS2_COMPR_RUBINMIPS	0x03
65fe8c2806Swdenk #define JFFS2_COMPR_COPY	0x04
66fe8c2806Swdenk #define JFFS2_COMPR_DYNRUBIN	0x05
67fe8c2806Swdenk #define JFFS2_COMPR_ZLIB	0x06
68*412babe3Swdenk #if defined(CONFIG_JFFS2_LZO_LZARI)
6907cc0999Swdenk #define JFFS2_COMPR_LZO		0x07
7007cc0999Swdenk #define JFFS2_COMPR_LZARI	0x08
7107cc0999Swdenk #define JFFS2_NUM_COMPR		9
72*412babe3Swdenk #else
73*412babe3Swdenk #define JFFS2_NUM_COMPR		7
74*412babe3Swdenk #endif
75fe8c2806Swdenk 
76fe8c2806Swdenk /* Compatibility flags. */
77fe8c2806Swdenk #define JFFS2_COMPAT_MASK 0xc000      /* What do to if an unknown nodetype is found */
78fe8c2806Swdenk #define JFFS2_NODE_ACCURATE 0x2000
79fe8c2806Swdenk /* INCOMPAT: Fail to mount the filesystem */
80fe8c2806Swdenk #define JFFS2_FEATURE_INCOMPAT 0xc000
81fe8c2806Swdenk /* ROCOMPAT: Mount read-only */
82fe8c2806Swdenk #define JFFS2_FEATURE_ROCOMPAT 0x8000
83fe8c2806Swdenk /* RWCOMPAT_COPY: Mount read/write, and copy the node when it's GC'd */
84fe8c2806Swdenk #define JFFS2_FEATURE_RWCOMPAT_COPY 0x4000
85fe8c2806Swdenk /* RWCOMPAT_DELETE: Mount read/write, and delete the node when it's GC'd */
86fe8c2806Swdenk #define JFFS2_FEATURE_RWCOMPAT_DELETE 0x0000
87fe8c2806Swdenk 
88fe8c2806Swdenk #define JFFS2_NODETYPE_DIRENT (JFFS2_FEATURE_INCOMPAT | JFFS2_NODE_ACCURATE | 1)
89fe8c2806Swdenk #define JFFS2_NODETYPE_INODE (JFFS2_FEATURE_INCOMPAT | JFFS2_NODE_ACCURATE | 2)
90fe8c2806Swdenk #define JFFS2_NODETYPE_CLEANMARKER (JFFS2_FEATURE_RWCOMPAT_DELETE | JFFS2_NODE_ACCURATE | 3)
917205e407Swdenk #define JFFS2_NODETYPE_PADDING (JFFS2_FEATURE_RWCOMPAT_DELETE | JFFS2_NODE_ACCURATE | 4)
92fe8c2806Swdenk 
93fe8c2806Swdenk /* Maybe later... */
94fe8c2806Swdenk /*#define JFFS2_NODETYPE_CHECKPOINT (JFFS2_FEATURE_RWCOMPAT_DELETE | JFFS2_NODE_ACCURATE | 3) */
95fe8c2806Swdenk /*#define JFFS2_NODETYPE_OPTIONS (JFFS2_FEATURE_RWCOMPAT_COPY | JFFS2_NODE_ACCURATE | 4) */
96fe8c2806Swdenk 
97fe8c2806Swdenk /* Same as the non_ECC versions, but with extra space for real
98fe8c2806Swdenk  * ECC instead of just the checksum. For use on NAND flash
99fe8c2806Swdenk  */
100fe8c2806Swdenk /*#define JFFS2_NODETYPE_DIRENT_ECC (JFFS2_FEATURE_INCOMPAT | JFFS2_NODE_ACCURATE | 5) */
101fe8c2806Swdenk /*#define JFFS2_NODETYPE_INODE_ECC (JFFS2_FEATURE_INCOMPAT | JFFS2_NODE_ACCURATE | 6) */
102fe8c2806Swdenk 
103fe8c2806Swdenk #define JFFS2_INO_FLAG_PREREAD	  1	/* Do read_inode() for this one at
104fe8c2806Swdenk 					   mount time, don't wait for it to
105fe8c2806Swdenk 					   happen later */
106fe8c2806Swdenk #define JFFS2_INO_FLAG_USERCOMPR  2	/* User has requested a specific
107fe8c2806Swdenk 					   compression type */
108fe8c2806Swdenk 
109fe8c2806Swdenk 
110fe8c2806Swdenk struct jffs2_unknown_node
111fe8c2806Swdenk {
112fe8c2806Swdenk 	/* All start like this */
113fe8c2806Swdenk 	__u16 magic;
114fe8c2806Swdenk 	__u16 nodetype;
115fe8c2806Swdenk 	__u32 totlen; /* So we can skip over nodes we don't grok */
116fe8c2806Swdenk 	__u32 hdr_crc;
117fe8c2806Swdenk } __attribute__((packed));
118fe8c2806Swdenk 
119fe8c2806Swdenk struct jffs2_raw_dirent
120fe8c2806Swdenk {
121fe8c2806Swdenk 	__u16 magic;
122fe8c2806Swdenk 	__u16 nodetype;	/* == JFFS_NODETYPE_DIRENT */
123fe8c2806Swdenk 	__u32 totlen;
124fe8c2806Swdenk 	__u32 hdr_crc;
125fe8c2806Swdenk 	__u32 pino;
126fe8c2806Swdenk 	__u32 version;
127fe8c2806Swdenk 	__u32 ino; /* == zero for unlink */
128fe8c2806Swdenk 	__u32 mctime;
129fe8c2806Swdenk 	__u8 nsize;
130fe8c2806Swdenk 	__u8 type;
131fe8c2806Swdenk 	__u8 unused[2];
132fe8c2806Swdenk 	__u32 node_crc;
133fe8c2806Swdenk 	__u32 name_crc;
134fe8c2806Swdenk 	__u8 name[0];
135fe8c2806Swdenk } __attribute__((packed));
136fe8c2806Swdenk 
137fe8c2806Swdenk /* The JFFS2 raw inode structure: Used for storage on physical media.  */
138fe8c2806Swdenk /* The uid, gid, atime, mtime and ctime members could be longer, but
139fe8c2806Swdenk    are left like this for space efficiency. If and when people decide
140fe8c2806Swdenk    they really need them extended, it's simple enough to add support for
141fe8c2806Swdenk    a new type of raw node.
142fe8c2806Swdenk */
143fe8c2806Swdenk struct jffs2_raw_inode
144fe8c2806Swdenk {
145fe8c2806Swdenk 	__u16 magic;      /* A constant magic number.  */
146fe8c2806Swdenk 	__u16 nodetype;   /* == JFFS_NODETYPE_INODE */
147fe8c2806Swdenk 	__u32 totlen;     /* Total length of this node (inc data, etc.) */
148fe8c2806Swdenk 	__u32 hdr_crc;
149fe8c2806Swdenk 	__u32 ino;        /* Inode number.  */
150fe8c2806Swdenk 	__u32 version;    /* Version number.  */
151fe8c2806Swdenk 	__u32 mode;       /* The file's type or mode.  */
152fe8c2806Swdenk 	__u16 uid;        /* The file's owner.  */
153fe8c2806Swdenk 	__u16 gid;        /* The file's group.  */
154fe8c2806Swdenk 	__u32 isize;      /* Total resultant size of this inode (used for truncations)  */
155fe8c2806Swdenk 	__u32 atime;      /* Last access time.  */
156fe8c2806Swdenk 	__u32 mtime;      /* Last modification time.  */
157fe8c2806Swdenk 	__u32 ctime;      /* Change time.  */
158fe8c2806Swdenk 	__u32 offset;     /* Where to begin to write.  */
159fe8c2806Swdenk 	__u32 csize;      /* (Compressed) data size */
160fe8c2806Swdenk 	__u32 dsize;	  /* Size of the node's data. (after decompression) */
161fe8c2806Swdenk 	__u8 compr;       /* Compression algorithm used */
162fe8c2806Swdenk 	__u8 usercompr;	  /* Compression algorithm requested by the user */
163fe8c2806Swdenk 	__u16 flags;	  /* See JFFS2_INO_FLAG_* */
164fe8c2806Swdenk 	__u32 data_crc;   /* CRC for the (compressed) data.  */
165fe8c2806Swdenk 	__u32 node_crc;   /* CRC for the raw inode (excluding data)  */
166fe8c2806Swdenk /*	__u8 data[dsize]; */
167fe8c2806Swdenk } __attribute__((packed));
168fe8c2806Swdenk 
169fe8c2806Swdenk union jffs2_node_union {
170fe8c2806Swdenk 	struct jffs2_raw_inode i;
171fe8c2806Swdenk 	struct jffs2_raw_dirent d;
172fe8c2806Swdenk 	struct jffs2_unknown_node u;
173fe8c2806Swdenk } __attribute__((packed));
174fe8c2806Swdenk 
175fe8c2806Swdenk enum
176fe8c2806Swdenk   {
177fe8c2806Swdenk     DT_UNKNOWN = 0,
178fe8c2806Swdenk # define DT_UNKNOWN     DT_UNKNOWN
179fe8c2806Swdenk     DT_FIFO = 1,
180fe8c2806Swdenk # define DT_FIFO        DT_FIFO
181fe8c2806Swdenk     DT_CHR = 2,
182fe8c2806Swdenk # define DT_CHR         DT_CHR
183fe8c2806Swdenk     DT_DIR = 4,
184fe8c2806Swdenk # define DT_DIR         DT_DIR
185fe8c2806Swdenk     DT_BLK = 6,
186fe8c2806Swdenk # define DT_BLK         DT_BLK
187fe8c2806Swdenk     DT_REG = 8,
188fe8c2806Swdenk # define DT_REG         DT_REG
189fe8c2806Swdenk     DT_LNK = 10,
190fe8c2806Swdenk # define DT_LNK         DT_LNK
191fe8c2806Swdenk     DT_SOCK = 12,
192fe8c2806Swdenk # define DT_SOCK        DT_SOCK
193fe8c2806Swdenk     DT_WHT = 14
194fe8c2806Swdenk # define DT_WHT         DT_WHT
195fe8c2806Swdenk   };
196fe8c2806Swdenk 
197fe8c2806Swdenk 
198fe8c2806Swdenk u32 jffs2_1pass_ls(struct part_info *part,const char *fname);
199fe8c2806Swdenk u32 jffs2_1pass_load(char *dest, struct part_info *part,const char *fname);
200fe8c2806Swdenk u32 jffs2_1pass_info(struct part_info *part);
201fe8c2806Swdenk 
20207cc0999Swdenk void rtime_decompress(unsigned char *data_in, unsigned char *cpage_out,
20307cc0999Swdenk 		u32 srclen, u32 destlen);
20407cc0999Swdenk void rubin_do_decompress(unsigned char *bits, unsigned char *in,
20507cc0999Swdenk 		unsigned char *page_out, __u32 destlen);
206fe8c2806Swdenk void dynrubin_decompress(unsigned char *data_in, unsigned char *cpage_out,
207fe8c2806Swdenk 		unsigned long sourcelen, unsigned long dstlen);
208fe8c2806Swdenk long zlib_decompress(unsigned char *data_in, unsigned char *cpage_out,
209fe8c2806Swdenk 		__u32 srclen, __u32 destlen);
210*412babe3Swdenk #if defined(CONFIG_JFFS2_LZO_LZARI)
21107cc0999Swdenk int lzo_decompress(unsigned char *data_in, unsigned char *cpage_out,
21207cc0999Swdenk 		u32 srclen, u32 destlen);
213*412babe3Swdenk int lzari_decompress(unsigned char *data_in, unsigned char *cpage_out,
214*412babe3Swdenk 		u32 srclen, u32 destlen);
21507cc0999Swdenk #endif
216fe8c2806Swdenk 
217180d3f74Swdenk char *mkmodestr(unsigned long mode, char *str);
218fe8c2806Swdenk #endif /* __LINUX_JFFS2_H__ */
219