2 * Compressed rom filesystem for Linux.
4 * Copyright (C) 1999 Linus Torvalds.
6 * This file is released under the GPL.
10 * These are the VFS interfaces to the compressed rom filesystem.
11 * The actual compression is based on zlib, see the other files.
14 #include <linux/module.h>
16 #include <linux/pagemap.h>
17 #include <linux/init.h>
18 #include <linux/string.h>
19 #include <linux/blkdev.h>
20 #include <linux/slab.h>
21 #include <linux/vfs.h>
22 #include <linux/mutex.h>
23 #include <uapi/linux/cramfs_fs.h>
24 #include <asm/uaccess.h>
29 * cramfs super-block data in memory
31 struct cramfs_sb_info {
39 static inline struct cramfs_sb_info *CRAMFS_SB(struct super_block *sb)
44 static const struct super_operations cramfs_ops;
45 static const struct inode_operations cramfs_dir_inode_operations;
46 static const struct file_operations cramfs_directory_operations;
47 static const struct address_space_operations cramfs_aops;
49 static DEFINE_MUTEX(read_mutex);
52 /* These macros may change in future, to provide better st_ino semantics. */
53 #define OFFSET(x) ((x)->i_ino)
55 static unsigned long cramino(const struct cramfs_inode *cino, unsigned int offset)
63 * The file mode test fixes buggy mkcramfs implementations where
64 * cramfs_inode->offset is set to a non zero value for entries
65 * which did not contain data, like devices node and fifos.
67 switch (cino->mode & S_IFMT) {
71 return cino->offset << 2;
78 static struct inode *get_cramfs_inode(struct super_block *sb,
79 const struct cramfs_inode *cramfs_inode, unsigned int offset)
82 static struct timespec zerotime;
84 inode = iget_locked(sb, cramino(cramfs_inode, offset));
86 return ERR_PTR(-ENOMEM);
87 if (!(inode->i_state & I_NEW))
90 switch (cramfs_inode->mode & S_IFMT) {
92 inode->i_fop = &generic_ro_fops;
93 inode->i_data.a_ops = &cramfs_aops;
96 inode->i_op = &cramfs_dir_inode_operations;
97 inode->i_fop = &cramfs_directory_operations;
100 inode->i_op = &page_symlink_inode_operations;
101 inode->i_data.a_ops = &cramfs_aops;
104 init_special_inode(inode, cramfs_inode->mode,
105 old_decode_dev(cramfs_inode->size));
108 inode->i_mode = cramfs_inode->mode;
109 i_uid_write(inode, cramfs_inode->uid);
110 i_gid_write(inode, cramfs_inode->gid);
112 /* if the lower 2 bits are zero, the inode contains data */
113 if (!(inode->i_ino & 3)) {
114 inode->i_size = cramfs_inode->size;
115 inode->i_blocks = (cramfs_inode->size - 1) / 512 + 1;
118 /* Struct copy intentional */
119 inode->i_mtime = inode->i_atime = inode->i_ctime = zerotime;
120 /* inode->i_nlink is left 1 - arguably wrong for directories,
121 but it's the best we can do without reading the directory
122 contents. 1 yields the right result in GNU find, even
123 without -noleaf option. */
125 unlock_new_inode(inode);
131 * We have our own block cache: don't fill up the buffer cache
132 * with the rom-image, because the way the filesystem is set
133 * up the accesses should be fairly regular and cached in the
134 * page cache and dentry tree anyway..
136 * This also acts as a way to guarantee contiguous areas of up to
137 * BLKS_PER_BUF*PAGE_CACHE_SIZE, so that the caller doesn't need to
138 * worry about end-of-buffer issues even when decompressing a full
141 #define READ_BUFFERS (2)
142 /* NEXT_BUFFER(): Loop over [0..(READ_BUFFERS-1)]. */
143 #define NEXT_BUFFER(_ix) ((_ix) ^ 1)
146 * BLKS_PER_BUF_SHIFT should be at least 2 to allow for "compressed"
147 * data that takes up more space than the original and with unlucky
150 #define BLKS_PER_BUF_SHIFT (2)
151 #define BLKS_PER_BUF (1 << BLKS_PER_BUF_SHIFT)
152 #define BUFFER_SIZE (BLKS_PER_BUF*PAGE_CACHE_SIZE)
154 static unsigned char read_buffers[READ_BUFFERS][BUFFER_SIZE];
155 static unsigned buffer_blocknr[READ_BUFFERS];
156 static struct super_block * buffer_dev[READ_BUFFERS];
157 static int next_buffer;
160 * Returns a pointer to a buffer containing at least LEN bytes of
161 * filesystem starting at byte offset OFFSET into the filesystem.
163 static void *cramfs_read(struct super_block *sb, unsigned int offset, unsigned int len)
165 struct address_space *mapping = sb->s_bdev->bd_inode->i_mapping;
166 struct page *pages[BLKS_PER_BUF];
167 unsigned i, blocknr, buffer;
168 unsigned long devsize;
173 blocknr = offset >> PAGE_CACHE_SHIFT;
174 offset &= PAGE_CACHE_SIZE - 1;
176 /* Check if an existing buffer already has the data.. */
177 for (i = 0; i < READ_BUFFERS; i++) {
178 unsigned int blk_offset;
180 if (buffer_dev[i] != sb)
182 if (blocknr < buffer_blocknr[i])
184 blk_offset = (blocknr - buffer_blocknr[i]) << PAGE_CACHE_SHIFT;
185 blk_offset += offset;
186 if (blk_offset + len > BUFFER_SIZE)
188 return read_buffers[i] + blk_offset;
191 devsize = mapping->host->i_size >> PAGE_CACHE_SHIFT;
193 /* Ok, read in BLKS_PER_BUF pages completely first. */
194 for (i = 0; i < BLKS_PER_BUF; i++) {
195 struct page *page = NULL;
197 if (blocknr + i < devsize) {
198 page = read_mapping_page(mapping, blocknr + i, NULL);
199 /* synchronous error? */
206 for (i = 0; i < BLKS_PER_BUF; i++) {
207 struct page *page = pages[i];
209 wait_on_page_locked(page);
210 if (!PageUptodate(page)) {
211 /* asynchronous error */
212 page_cache_release(page);
218 buffer = next_buffer;
219 next_buffer = NEXT_BUFFER(buffer);
220 buffer_blocknr[buffer] = blocknr;
221 buffer_dev[buffer] = sb;
223 data = read_buffers[buffer];
224 for (i = 0; i < BLKS_PER_BUF; i++) {
225 struct page *page = pages[i];
227 memcpy(data, kmap(page), PAGE_CACHE_SIZE);
229 page_cache_release(page);
231 memset(data, 0, PAGE_CACHE_SIZE);
232 data += PAGE_CACHE_SIZE;
234 return read_buffers[buffer] + offset;
237 static void cramfs_kill_sb(struct super_block *sb)
239 struct cramfs_sb_info *sbi = CRAMFS_SB(sb);
240 kill_block_super(sb);
244 static int cramfs_remount(struct super_block *sb, int *flags, char *data)
250 static int cramfs_fill_super(struct super_block *sb, void *data, int silent)
253 struct cramfs_super super;
254 unsigned long root_offset;
255 struct cramfs_sb_info *sbi;
258 sb->s_flags |= MS_RDONLY;
260 sbi = kzalloc(sizeof(struct cramfs_sb_info), GFP_KERNEL);
265 /* Invalidate the read buffers on mount: think disk change.. */
266 mutex_lock(&read_mutex);
267 for (i = 0; i < READ_BUFFERS; i++)
268 buffer_blocknr[i] = -1;
270 /* Read the first block and get the superblock from it */
271 memcpy(&super, cramfs_read(sb, 0, sizeof(super)), sizeof(super));
272 mutex_unlock(&read_mutex);
274 /* Do sanity checks on the superblock */
275 if (super.magic != CRAMFS_MAGIC) {
276 /* check for wrong endianness */
277 if (super.magic == CRAMFS_MAGIC_WEND) {
279 printk(KERN_ERR "cramfs: wrong endianness\n");
283 /* check at 512 byte offset */
284 mutex_lock(&read_mutex);
285 memcpy(&super, cramfs_read(sb, 512, sizeof(super)), sizeof(super));
286 mutex_unlock(&read_mutex);
287 if (super.magic != CRAMFS_MAGIC) {
288 if (super.magic == CRAMFS_MAGIC_WEND && !silent)
289 printk(KERN_ERR "cramfs: wrong endianness\n");
291 printk(KERN_ERR "cramfs: wrong magic\n");
296 /* get feature flags first */
297 if (super.flags & ~CRAMFS_SUPPORTED_FLAGS) {
298 printk(KERN_ERR "cramfs: unsupported filesystem features\n");
302 /* Check that the root inode is in a sane state */
303 if (!S_ISDIR(super.root.mode)) {
304 printk(KERN_ERR "cramfs: root is not a directory\n");
307 /* correct strange, hard-coded permissions of mkcramfs */
308 super.root.mode |= (S_IRUSR | S_IXUSR | S_IRGRP | S_IXGRP | S_IROTH | S_IXOTH);
310 root_offset = super.root.offset << 2;
311 if (super.flags & CRAMFS_FLAG_FSID_VERSION_2) {
312 sbi->size=super.size;
313 sbi->blocks=super.fsid.blocks;
314 sbi->files=super.fsid.files;
320 sbi->magic=super.magic;
321 sbi->flags=super.flags;
322 if (root_offset == 0)
323 printk(KERN_INFO "cramfs: empty filesystem");
324 else if (!(super.flags & CRAMFS_FLAG_SHIFTED_ROOT_OFFSET) &&
325 ((root_offset != sizeof(struct cramfs_super)) &&
326 (root_offset != 512 + sizeof(struct cramfs_super))))
328 printk(KERN_ERR "cramfs: bad root offset %lu\n", root_offset);
332 /* Set it all up.. */
333 sb->s_op = &cramfs_ops;
334 root = get_cramfs_inode(sb, &super.root, 0);
336 return PTR_ERR(root);
337 sb->s_root = d_make_root(root);
343 static int cramfs_statfs(struct dentry *dentry, struct kstatfs *buf)
345 struct super_block *sb = dentry->d_sb;
346 u64 id = huge_encode_dev(sb->s_bdev->bd_dev);
348 buf->f_type = CRAMFS_MAGIC;
349 buf->f_bsize = PAGE_CACHE_SIZE;
350 buf->f_blocks = CRAMFS_SB(sb)->blocks;
353 buf->f_files = CRAMFS_SB(sb)->files;
355 buf->f_fsid.val[0] = (u32)id;
356 buf->f_fsid.val[1] = (u32)(id >> 32);
357 buf->f_namelen = CRAMFS_MAXPATHLEN;
362 * Read a cramfs directory entry.
364 static int cramfs_readdir(struct file *file, struct dir_context *ctx)
366 struct inode *inode = file_inode(file);
367 struct super_block *sb = inode->i_sb;
371 /* Offset within the thing. */
372 if (ctx->pos >= inode->i_size)
375 /* Directory entries are always 4-byte aligned */
379 buf = kmalloc(CRAMFS_MAXPATHLEN, GFP_KERNEL);
383 while (offset < inode->i_size) {
384 struct cramfs_inode *de;
385 unsigned long nextoffset;
391 mutex_lock(&read_mutex);
392 de = cramfs_read(sb, OFFSET(inode) + offset, sizeof(*de)+CRAMFS_MAXPATHLEN);
393 name = (char *)(de+1);
396 * Namelengths on disk are shifted by two
397 * and the name padded out to 4-byte boundaries
400 namelen = de->namelen << 2;
401 memcpy(buf, name, namelen);
402 ino = cramino(de, OFFSET(inode) + offset);
404 mutex_unlock(&read_mutex);
405 nextoffset = offset + sizeof(*de) + namelen;
415 if (!dir_emit(ctx, buf, namelen, ino, mode >> 12))
418 ctx->pos = offset = nextoffset;
425 * Lookup and fill in the inode data..
427 static struct dentry * cramfs_lookup(struct inode *dir, struct dentry *dentry, unsigned int flags)
429 unsigned int offset = 0;
430 struct inode *inode = NULL;
433 mutex_lock(&read_mutex);
434 sorted = CRAMFS_SB(dir->i_sb)->flags & CRAMFS_FLAG_SORTED_DIRS;
435 while (offset < dir->i_size) {
436 struct cramfs_inode *de;
439 int dir_off = OFFSET(dir) + offset;
441 de = cramfs_read(dir->i_sb, dir_off, sizeof(*de)+CRAMFS_MAXPATHLEN);
442 name = (char *)(de+1);
444 /* Try to take advantage of sorted directories */
445 if (sorted && (dentry->d_name.name[0] < name[0]))
448 namelen = de->namelen << 2;
449 offset += sizeof(*de) + namelen;
451 /* Quick check that the name is roughly the right length */
452 if (((dentry->d_name.len + 3) & ~3) != namelen)
457 inode = ERR_PTR(-EIO);
464 if (namelen != dentry->d_name.len)
466 retval = memcmp(dentry->d_name.name, name, namelen);
470 inode = get_cramfs_inode(dir->i_sb, de, dir_off);
473 /* else (retval < 0) */
478 mutex_unlock(&read_mutex);
480 return ERR_CAST(inode);
481 d_add(dentry, inode);
485 static int cramfs_readpage(struct file *file, struct page * page)
487 struct inode *inode = page->mapping->host;
492 maxblock = (inode->i_size + PAGE_CACHE_SIZE - 1) >> PAGE_CACHE_SHIFT;
496 if (page->index < maxblock) {
497 struct super_block *sb = inode->i_sb;
498 u32 blkptr_offset = OFFSET(inode) + page->index*4;
499 u32 start_offset, compr_len;
501 start_offset = OFFSET(inode) + maxblock*4;
502 mutex_lock(&read_mutex);
504 start_offset = *(u32 *) cramfs_read(sb, blkptr_offset-4,
506 compr_len = (*(u32 *) cramfs_read(sb, blkptr_offset, 4) -
508 mutex_unlock(&read_mutex);
512 else if (unlikely(compr_len > (PAGE_CACHE_SIZE << 1))) {
513 pr_err("cramfs: bad compressed blocksize %u\n",
517 mutex_lock(&read_mutex);
518 bytes_filled = cramfs_uncompress_block(pgdata,
520 cramfs_read(sb, start_offset, compr_len),
522 mutex_unlock(&read_mutex);
523 if (unlikely(bytes_filled < 0))
528 memset(pgdata + bytes_filled, 0, PAGE_CACHE_SIZE - bytes_filled);
529 flush_dcache_page(page);
531 SetPageUptodate(page);
537 ClearPageUptodate(page);
543 static const struct address_space_operations cramfs_aops = {
544 .readpage = cramfs_readpage
552 * A directory can only readdir
554 static const struct file_operations cramfs_directory_operations = {
555 .llseek = generic_file_llseek,
556 .read = generic_read_dir,
557 .iterate = cramfs_readdir,
560 static const struct inode_operations cramfs_dir_inode_operations = {
561 .lookup = cramfs_lookup,
564 static const struct super_operations cramfs_ops = {
565 .remount_fs = cramfs_remount,
566 .statfs = cramfs_statfs,
569 static struct dentry *cramfs_mount(struct file_system_type *fs_type,
570 int flags, const char *dev_name, void *data)
572 return mount_bdev(fs_type, flags, dev_name, data, cramfs_fill_super);
575 static struct file_system_type cramfs_fs_type = {
576 .owner = THIS_MODULE,
578 .mount = cramfs_mount,
579 .kill_sb = cramfs_kill_sb,
580 .fs_flags = FS_REQUIRES_DEV,
582 MODULE_ALIAS_FS("cramfs");
584 static int __init init_cramfs_fs(void)
588 rv = cramfs_uncompress_init();
591 rv = register_filesystem(&cramfs_fs_type);
593 cramfs_uncompress_exit();
597 static void __exit exit_cramfs_fs(void)
599 cramfs_uncompress_exit();
600 unregister_filesystem(&cramfs_fs_type);
603 module_init(init_cramfs_fs)
604 module_exit(exit_cramfs_fs)
605 MODULE_LICENSE("GPL");