jffs2.h 8.0 KB

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