Blame view

include/linux/jffs2.h 6.85 KB
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
1
2
3
  /*
   * JFFS2 -- Journalling Flash File System, Version 2.
   *
6088c0587   David Woodhouse   jffs2: Update cop...
4
5
   * Copyright © 2001-2007 Red Hat, Inc.
   * Copyright © 2004-2010 David Woodhouse <dwmw2@infradead.org>
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
6
7
8
   *
   * Created by David Woodhouse <dwmw2@infradead.org>
   *
182ec4eee   Thomas Gleixner   [JFFS2] Clean up ...
9
   * For licensing information, see the file 'LICENCE' in the
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
10
   * jffs2 directory.
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
11
12
13
14
   */
  
  #ifndef __LINUX_JFFS2_H__
  #define __LINUX_JFFS2_H__
ccef7ab53   Arnd Bergmann   make MTD headers ...
15
  #include <linux/types.h>
e18fa700c   Jeff Garzik   Move several *_SU...
16
  #include <linux/magic.h>
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
17
18
19
  /* You must include something which defines the C99 uintXX_t types. 
     We don't do it from here because this file is used in too many
     different environments. */
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
20
21
22
23
24
25
  /* Values we may expect to find in the 'magic' field */
  #define JFFS2_OLD_MAGIC_BITMASK 0x1984
  #define JFFS2_MAGIC_BITMASK 0x1985
  #define KSAMTIB_CIGAM_2SFFJ 0x8519 /* For detecting wrong-endian fs */
  #define JFFS2_EMPTY_BITMASK 0xffff
  #define JFFS2_DIRTY_BITMASK 0x0000
e631ddba5   Ferenc Havasi   [JFFS2] Add erase...
26
27
  /* Summary node MAGIC marker */
  #define JFFS2_SUM_MAGIC	0x02851885
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
  /* We only allow a single char for length, and 0xFF is empty flash so
     we don't want it confused with a real length. Hence max 254.
  */
  #define JFFS2_MAX_NAME_LEN 254
  
  /* How small can we sensibly write nodes? */
  #define JFFS2_MIN_DATA_LEN 128
  
  #define JFFS2_COMPR_NONE	0x00
  #define JFFS2_COMPR_ZERO	0x01
  #define JFFS2_COMPR_RTIME	0x02
  #define JFFS2_COMPR_RUBINMIPS	0x03
  #define JFFS2_COMPR_COPY	0x04
  #define JFFS2_COMPR_DYNRUBIN	0x05
  #define JFFS2_COMPR_ZLIB	0x06
c799aca31   Richard Purdie   [JFFS2] Add LZO c...
43
  #define JFFS2_COMPR_LZO		0x07
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
  /* Compatibility flags. */
  #define JFFS2_COMPAT_MASK 0xc000      /* What do to if an unknown nodetype is found */
  #define JFFS2_NODE_ACCURATE 0x2000
  /* INCOMPAT: Fail to mount the filesystem */
  #define JFFS2_FEATURE_INCOMPAT 0xc000
  /* ROCOMPAT: Mount read-only */
  #define JFFS2_FEATURE_ROCOMPAT 0x8000
  /* RWCOMPAT_COPY: Mount read/write, and copy the node when it's GC'd */
  #define JFFS2_FEATURE_RWCOMPAT_COPY 0x4000
  /* RWCOMPAT_DELETE: Mount read/write, and delete the node when it's GC'd */
  #define JFFS2_FEATURE_RWCOMPAT_DELETE 0x0000
  
  #define JFFS2_NODETYPE_DIRENT (JFFS2_FEATURE_INCOMPAT | JFFS2_NODE_ACCURATE | 1)
  #define JFFS2_NODETYPE_INODE (JFFS2_FEATURE_INCOMPAT | JFFS2_NODE_ACCURATE | 2)
  #define JFFS2_NODETYPE_CLEANMARKER (JFFS2_FEATURE_RWCOMPAT_DELETE | JFFS2_NODE_ACCURATE | 3)
  #define JFFS2_NODETYPE_PADDING (JFFS2_FEATURE_RWCOMPAT_DELETE | JFFS2_NODE_ACCURATE | 4)
e631ddba5   Ferenc Havasi   [JFFS2] Add erase...
60
  #define JFFS2_NODETYPE_SUMMARY (JFFS2_FEATURE_RWCOMPAT_DELETE | JFFS2_NODE_ACCURATE | 6)
aa98d7cf5   KaiGai Kohei   [JFFS2][XATTR] XA...
61
62
63
64
65
66
67
68
69
70
71
  #define JFFS2_NODETYPE_XATTR (JFFS2_FEATURE_INCOMPAT | JFFS2_NODE_ACCURATE | 8)
  #define JFFS2_NODETYPE_XREF (JFFS2_FEATURE_INCOMPAT | JFFS2_NODE_ACCURATE | 9)
  
  /* XATTR Related */
  #define JFFS2_XPREFIX_USER		1	/* for "user." */
  #define JFFS2_XPREFIX_SECURITY		2	/* for "security." */
  #define JFFS2_XPREFIX_ACL_ACCESS	3	/* for "system.posix_acl_access" */
  #define JFFS2_XPREFIX_ACL_DEFAULT	4	/* for "system.posix_acl_default" */
  #define JFFS2_XPREFIX_TRUSTED		5	/* for "trusted.*" */
  
  #define JFFS2_ACL_VERSION		0x0001
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
72
73
74
  // Maybe later...
  //#define JFFS2_NODETYPE_CHECKPOINT (JFFS2_FEATURE_RWCOMPAT_DELETE | JFFS2_NODE_ACCURATE | 3)
  //#define JFFS2_NODETYPE_OPTIONS (JFFS2_FEATURE_RWCOMPAT_COPY | JFFS2_NODE_ACCURATE | 4)
182ec4eee   Thomas Gleixner   [JFFS2] Clean up ...
75
76
  #define JFFS2_INO_FLAG_PREREAD	  1	/* Do read_inode() for this one at
  					   mount time, don't wait for it to
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
77
  					   happen later */
182ec4eee   Thomas Gleixner   [JFFS2] Clean up ...
78
  #define JFFS2_INO_FLAG_USERCOMPR  2	/* User has requested a specific
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
79
80
81
82
83
84
85
  					   compression type */
  
  
  /* These can go once we've made sure we've caught all uses without
     byteswapping */
  
  typedef struct {
ccef7ab53   Arnd Bergmann   make MTD headers ...
86
  	__u32 v32;
ba9627b85   David Woodhouse   [JFFS2] Repack so...
87
  } __attribute__((packed)) jint32_t;
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
88
89
  
  typedef struct {
ccef7ab53   Arnd Bergmann   make MTD headers ...
90
  	__u32 m;
ba9627b85   David Woodhouse   [JFFS2] Repack so...
91
  } __attribute__((packed)) jmode_t;
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
92
93
  
  typedef struct {
ccef7ab53   Arnd Bergmann   make MTD headers ...
94
  	__u16 v16;
ba9627b85   David Woodhouse   [JFFS2] Repack so...
95
  } __attribute__((packed)) jint16_t;
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
96
97
98
99
100
101
102
103
  
  struct jffs2_unknown_node
  {
  	/* All start like this */
  	jint16_t magic;
  	jint16_t nodetype;
  	jint32_t totlen; /* So we can skip over nodes we don't grok */
  	jint32_t hdr_crc;
3e68fbb59   David Woodhouse   [JFFS2] Don't pac...
104
  };
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
105
106
107
108
  
  struct jffs2_raw_dirent
  {
  	jint16_t magic;
f302cd028   Artem B. Bityutskiy   [JFFS2] Namespace...
109
  	jint16_t nodetype;	/* == JFFS2_NODETYPE_DIRENT */
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
110
111
112
113
114
115
  	jint32_t totlen;
  	jint32_t hdr_crc;
  	jint32_t pino;
  	jint32_t version;
  	jint32_t ino; /* == zero for unlink */
  	jint32_t mctime;
ccef7ab53   Arnd Bergmann   make MTD headers ...
116
117
118
  	__u8 nsize;
  	__u8 type;
  	__u8 unused[2];
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
119
120
  	jint32_t node_crc;
  	jint32_t name_crc;
ccef7ab53   Arnd Bergmann   make MTD headers ...
121
  	__u8 name[0];
3e68fbb59   David Woodhouse   [JFFS2] Don't pac...
122
  };
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
123
124
  
  /* The JFFS2 raw inode structure: Used for storage on physical media.  */
182ec4eee   Thomas Gleixner   [JFFS2] Clean up ...
125
  /* The uid, gid, atime, mtime and ctime members could be longer, but
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
126
127
128
129
130
131
132
     are left like this for space efficiency. If and when people decide
     they really need them extended, it's simple enough to add support for
     a new type of raw node.
  */
  struct jffs2_raw_inode
  {
  	jint16_t magic;      /* A constant magic number.  */
f302cd028   Artem B. Bityutskiy   [JFFS2] Namespace...
133
  	jint16_t nodetype;   /* == JFFS2_NODETYPE_INODE */
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
134
135
136
137
138
139
140
141
142
143
144
145
146
147
  	jint32_t totlen;     /* Total length of this node (inc data, etc.) */
  	jint32_t hdr_crc;
  	jint32_t ino;        /* Inode number.  */
  	jint32_t version;    /* Version number.  */
  	jmode_t mode;       /* The file's type or mode.  */
  	jint16_t uid;        /* The file's owner.  */
  	jint16_t gid;        /* The file's group.  */
  	jint32_t isize;      /* Total resultant size of this inode (used for truncations)  */
  	jint32_t atime;      /* Last access time.  */
  	jint32_t mtime;      /* Last modification time.  */
  	jint32_t ctime;      /* Change time.  */
  	jint32_t offset;     /* Where to begin to write.  */
  	jint32_t csize;      /* (Compressed) data size */
  	jint32_t dsize;	     /* Size of the node's data. (after decompression) */
ccef7ab53   Arnd Bergmann   make MTD headers ...
148
149
  	__u8 compr;       /* Compression algorithm used */
  	__u8 usercompr;   /* Compression algorithm requested by the user */
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
150
151
152
  	jint16_t flags;	     /* See JFFS2_INO_FLAG_* */
  	jint32_t data_crc;   /* CRC for the (compressed) data.  */
  	jint32_t node_crc;   /* CRC for the raw inode (excluding data)  */
ccef7ab53   Arnd Bergmann   make MTD headers ...
153
  	__u8 data[0];
3e68fbb59   David Woodhouse   [JFFS2] Don't pac...
154
  };
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
155

aa98d7cf5   KaiGai Kohei   [JFFS2][XATTR] XA...
156
157
158
159
160
161
162
  struct jffs2_raw_xattr {
  	jint16_t magic;
  	jint16_t nodetype;	/* = JFFS2_NODETYPE_XATTR */
  	jint32_t totlen;
  	jint32_t hdr_crc;
  	jint32_t xid;		/* XATTR identifier number */
  	jint32_t version;
ccef7ab53   Arnd Bergmann   make MTD headers ...
163
164
  	__u8 xprefix;
  	__u8 name_len;
aa98d7cf5   KaiGai Kohei   [JFFS2][XATTR] XA...
165
166
167
  	jint16_t value_len;
  	jint32_t data_crc;
  	jint32_t node_crc;
ccef7ab53   Arnd Bergmann   make MTD headers ...
168
  	__u8 data[0];
aa98d7cf5   KaiGai Kohei   [JFFS2][XATTR] XA...
169
170
171
172
173
174
175
176
177
178
  } __attribute__((packed));
  
  struct jffs2_raw_xref
  {
  	jint16_t magic;
  	jint16_t nodetype;	/* = JFFS2_NODETYPE_XREF */
  	jint32_t totlen;
  	jint32_t hdr_crc;
  	jint32_t ino;		/* inode number */
  	jint32_t xid;		/* XATTR identifier number */
b27d63d8f   Uwe Kleine-König   fix comment typos...
179
  	jint32_t xseqno;	/* xref sequential number */
aa98d7cf5   KaiGai Kohei   [JFFS2][XATTR] XA...
180
181
  	jint32_t node_crc;
  } __attribute__((packed));
2bc9764c4   Ferenc Havasi   [JFFS2] Rename jf...
182
183
  struct jffs2_raw_summary
  {
e631ddba5   Ferenc Havasi   [JFFS2] Add erase...
184
  	jint16_t magic;
2bc9764c4   Ferenc Havasi   [JFFS2] Rename jf...
185
  	jint16_t nodetype; 	/* = JFFS2_NODETYPE_SUMMARY */
e631ddba5   Ferenc Havasi   [JFFS2] Add erase...
186
187
188
189
190
191
192
193
  	jint32_t totlen;
  	jint32_t hdr_crc;
  	jint32_t sum_num;	/* number of sum entries*/
  	jint32_t cln_mkr;	/* clean marker size, 0 = no cleanmarker */
  	jint32_t padded;	/* sum of the size of padding nodes */
  	jint32_t sum_crc;	/* summary information crc */
  	jint32_t node_crc; 	/* node crc */
  	jint32_t sum[0]; 	/* inode summary info */
3e68fbb59   David Woodhouse   [JFFS2] Don't pac...
194
  };
e631ddba5   Ferenc Havasi   [JFFS2] Add erase...
195

182ec4eee   Thomas Gleixner   [JFFS2] Clean up ...
196
  union jffs2_node_union
2bc9764c4   Ferenc Havasi   [JFFS2] Rename jf...
197
  {
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
198
199
  	struct jffs2_raw_inode i;
  	struct jffs2_raw_dirent d;
aa98d7cf5   KaiGai Kohei   [JFFS2][XATTR] XA...
200
201
  	struct jffs2_raw_xattr x;
  	struct jffs2_raw_xref r;
2bc9764c4   Ferenc Havasi   [JFFS2] Rename jf...
202
  	struct jffs2_raw_summary s;
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
203
204
  	struct jffs2_unknown_node u;
  };
aef9ab478   David Woodhouse   [JFFS2] Support n...
205
206
  /* Data payload for device nodes. */
  union jffs2_device_node {
91f802660   Andrew Morton   JFFS2: avoid usin...
207
208
  	jint16_t old_id;
  	jint32_t new_id;
aef9ab478   David Woodhouse   [JFFS2] Support n...
209
  };
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
210
  #endif /* __LINUX_JFFS2_H__ */