blob: 53811e567a6983966a6b3ee3da26ca15120a54ca [file] [log] [blame]
Artem Bityutskiy1e517642008-07-14 19:08:37 +03001/*
2 * This file is part of UBIFS.
3 *
4 * Copyright (C) 2006-2008 Nokia Corporation.
5 *
6 * This program is free software; you can redistribute it and/or modify it
7 * under the terms of the GNU General Public License version 2 as published by
8 * the Free Software Foundation.
9 *
10 * This program is distributed in the hope that it will be useful, but WITHOUT
11 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
12 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
13 * more details.
14 *
15 * You should have received a copy of the GNU General Public License along with
16 * this program; if not, write to the Free Software Foundation, Inc., 51
17 * Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
18 *
19 * Authors: Artem Bityutskiy (Битюцкий Артём)
20 * Adrian Hunter
21 */
22
23/*
24 * This file implements UBIFS initialization and VFS superblock operations. Some
25 * initialization stuff which is rather large and complex is placed at
26 * corresponding subsystems, but most of it is here.
27 */
28
29#include <linux/init.h>
30#include <linux/slab.h>
31#include <linux/module.h>
32#include <linux/ctype.h>
Artem Bityutskiy1e517642008-07-14 19:08:37 +030033#include <linux/kthread.h>
34#include <linux/parser.h>
35#include <linux/seq_file.h>
36#include <linux/mount.h>
Artem Bityutskiy4d61db42008-12-18 14:06:51 +020037#include <linux/math64.h>
Artem Bityutskiy304d4272008-12-28 08:04:17 +020038#include <linux/writeback.h>
Artem Bityutskiy1e517642008-07-14 19:08:37 +030039#include "ubifs.h"
40
Artem Bityutskiy39ce81c2008-11-18 18:09:49 +020041/*
42 * Maximum amount of memory we may 'kmalloc()' without worrying that we are
43 * allocating too much.
44 */
45#define UBIFS_KMALLOC_OK (128*1024)
46
Artem Bityutskiy1e517642008-07-14 19:08:37 +030047/* Slab cache for UBIFS inodes */
48struct kmem_cache *ubifs_inode_slab;
49
50/* UBIFS TNC shrinker description */
51static struct shrinker ubifs_shrinker_info = {
52 .shrink = ubifs_shrinker,
53 .seeks = DEFAULT_SEEKS,
54};
55
56/**
57 * validate_inode - validate inode.
58 * @c: UBIFS file-system description object
59 * @inode: the inode to validate
60 *
61 * This is a helper function for 'ubifs_iget()' which validates various fields
62 * of a newly built inode to make sure they contain sane values and prevent
63 * possible vulnerabilities. Returns zero if the inode is all right and
64 * a non-zero error code if not.
65 */
66static int validate_inode(struct ubifs_info *c, const struct inode *inode)
67{
68 int err;
69 const struct ubifs_inode *ui = ubifs_inode(inode);
70
71 if (inode->i_size > c->max_inode_sz) {
72 ubifs_err("inode is too large (%lld)",
73 (long long)inode->i_size);
74 return 1;
75 }
76
77 if (ui->compr_type < 0 || ui->compr_type >= UBIFS_COMPR_TYPES_CNT) {
78 ubifs_err("unknown compression type %d", ui->compr_type);
79 return 2;
80 }
81
82 if (ui->xattr_names + ui->xattr_cnt > XATTR_LIST_MAX)
83 return 3;
84
85 if (ui->data_len < 0 || ui->data_len > UBIFS_MAX_INO_DATA)
86 return 4;
87
88 if (ui->xattr && (inode->i_mode & S_IFMT) != S_IFREG)
89 return 5;
90
91 if (!ubifs_compr_present(ui->compr_type)) {
92 ubifs_warn("inode %lu uses '%s' compression, but it was not "
93 "compiled in", inode->i_ino,
94 ubifs_compr_name(ui->compr_type));
95 }
96
97 err = dbg_check_dir_size(c, inode);
98 return err;
99}
100
101struct inode *ubifs_iget(struct super_block *sb, unsigned long inum)
102{
103 int err;
104 union ubifs_key key;
105 struct ubifs_ino_node *ino;
106 struct ubifs_info *c = sb->s_fs_info;
107 struct inode *inode;
108 struct ubifs_inode *ui;
109
110 dbg_gen("inode %lu", inum);
111
112 inode = iget_locked(sb, inum);
113 if (!inode)
114 return ERR_PTR(-ENOMEM);
115 if (!(inode->i_state & I_NEW))
116 return inode;
117 ui = ubifs_inode(inode);
118
119 ino = kmalloc(UBIFS_MAX_INO_NODE_SZ, GFP_NOFS);
120 if (!ino) {
121 err = -ENOMEM;
122 goto out;
123 }
124
125 ino_key_init(c, &key, inode->i_ino);
126
127 err = ubifs_tnc_lookup(c, &key, ino);
128 if (err)
129 goto out_ino;
130
131 inode->i_flags |= (S_NOCMTIME | S_NOATIME);
132 inode->i_nlink = le32_to_cpu(ino->nlink);
133 inode->i_uid = le32_to_cpu(ino->uid);
134 inode->i_gid = le32_to_cpu(ino->gid);
135 inode->i_atime.tv_sec = (int64_t)le64_to_cpu(ino->atime_sec);
136 inode->i_atime.tv_nsec = le32_to_cpu(ino->atime_nsec);
137 inode->i_mtime.tv_sec = (int64_t)le64_to_cpu(ino->mtime_sec);
138 inode->i_mtime.tv_nsec = le32_to_cpu(ino->mtime_nsec);
139 inode->i_ctime.tv_sec = (int64_t)le64_to_cpu(ino->ctime_sec);
140 inode->i_ctime.tv_nsec = le32_to_cpu(ino->ctime_nsec);
141 inode->i_mode = le32_to_cpu(ino->mode);
142 inode->i_size = le64_to_cpu(ino->size);
143
144 ui->data_len = le32_to_cpu(ino->data_len);
145 ui->flags = le32_to_cpu(ino->flags);
146 ui->compr_type = le16_to_cpu(ino->compr_type);
147 ui->creat_sqnum = le64_to_cpu(ino->creat_sqnum);
148 ui->xattr_cnt = le32_to_cpu(ino->xattr_cnt);
149 ui->xattr_size = le32_to_cpu(ino->xattr_size);
150 ui->xattr_names = le32_to_cpu(ino->xattr_names);
151 ui->synced_i_size = ui->ui_size = inode->i_size;
152
153 ui->xattr = (ui->flags & UBIFS_XATTR_FL) ? 1 : 0;
154
155 err = validate_inode(c, inode);
156 if (err)
157 goto out_invalid;
158
Artem Bityutskiy0a883a02008-08-13 14:13:26 +0300159 /* Disable read-ahead */
Artem Bityutskiy1e517642008-07-14 19:08:37 +0300160 inode->i_mapping->backing_dev_info = &c->bdi;
161
162 switch (inode->i_mode & S_IFMT) {
163 case S_IFREG:
164 inode->i_mapping->a_ops = &ubifs_file_address_operations;
165 inode->i_op = &ubifs_file_inode_operations;
166 inode->i_fop = &ubifs_file_operations;
167 if (ui->xattr) {
168 ui->data = kmalloc(ui->data_len + 1, GFP_NOFS);
169 if (!ui->data) {
170 err = -ENOMEM;
171 goto out_ino;
172 }
173 memcpy(ui->data, ino->data, ui->data_len);
174 ((char *)ui->data)[ui->data_len] = '\0';
175 } else if (ui->data_len != 0) {
176 err = 10;
177 goto out_invalid;
178 }
179 break;
180 case S_IFDIR:
181 inode->i_op = &ubifs_dir_inode_operations;
182 inode->i_fop = &ubifs_dir_operations;
183 if (ui->data_len != 0) {
184 err = 11;
185 goto out_invalid;
186 }
187 break;
188 case S_IFLNK:
189 inode->i_op = &ubifs_symlink_inode_operations;
190 if (ui->data_len <= 0 || ui->data_len > UBIFS_MAX_INO_DATA) {
191 err = 12;
192 goto out_invalid;
193 }
194 ui->data = kmalloc(ui->data_len + 1, GFP_NOFS);
195 if (!ui->data) {
196 err = -ENOMEM;
197 goto out_ino;
198 }
199 memcpy(ui->data, ino->data, ui->data_len);
200 ((char *)ui->data)[ui->data_len] = '\0';
201 break;
202 case S_IFBLK:
203 case S_IFCHR:
204 {
205 dev_t rdev;
206 union ubifs_dev_desc *dev;
207
208 ui->data = kmalloc(sizeof(union ubifs_dev_desc), GFP_NOFS);
209 if (!ui->data) {
210 err = -ENOMEM;
211 goto out_ino;
212 }
213
214 dev = (union ubifs_dev_desc *)ino->data;
215 if (ui->data_len == sizeof(dev->new))
216 rdev = new_decode_dev(le32_to_cpu(dev->new));
217 else if (ui->data_len == sizeof(dev->huge))
218 rdev = huge_decode_dev(le64_to_cpu(dev->huge));
219 else {
220 err = 13;
221 goto out_invalid;
222 }
223 memcpy(ui->data, ino->data, ui->data_len);
224 inode->i_op = &ubifs_file_inode_operations;
225 init_special_inode(inode, inode->i_mode, rdev);
226 break;
227 }
228 case S_IFSOCK:
229 case S_IFIFO:
230 inode->i_op = &ubifs_file_inode_operations;
231 init_special_inode(inode, inode->i_mode, 0);
232 if (ui->data_len != 0) {
233 err = 14;
234 goto out_invalid;
235 }
236 break;
237 default:
238 err = 15;
239 goto out_invalid;
240 }
241
242 kfree(ino);
243 ubifs_set_inode_flags(inode);
244 unlock_new_inode(inode);
245 return inode;
246
247out_invalid:
248 ubifs_err("inode %lu validation failed, error %d", inode->i_ino, err);
249 dbg_dump_node(c, ino);
250 dbg_dump_inode(c, inode);
251 err = -EINVAL;
252out_ino:
253 kfree(ino);
254out:
255 ubifs_err("failed to read inode %lu, error %d", inode->i_ino, err);
256 iget_failed(inode);
257 return ERR_PTR(err);
258}
259
260static struct inode *ubifs_alloc_inode(struct super_block *sb)
261{
262 struct ubifs_inode *ui;
263
264 ui = kmem_cache_alloc(ubifs_inode_slab, GFP_NOFS);
265 if (!ui)
266 return NULL;
267
268 memset((void *)ui + sizeof(struct inode), 0,
269 sizeof(struct ubifs_inode) - sizeof(struct inode));
270 mutex_init(&ui->ui_mutex);
271 spin_lock_init(&ui->ui_lock);
272 return &ui->vfs_inode;
273};
274
275static void ubifs_destroy_inode(struct inode *inode)
276{
277 struct ubifs_inode *ui = ubifs_inode(inode);
278
279 kfree(ui->data);
280 kmem_cache_free(ubifs_inode_slab, inode);
281}
282
283/*
284 * Note, Linux write-back code calls this without 'i_mutex'.
285 */
286static int ubifs_write_inode(struct inode *inode, int wait)
287{
Artem Bityutskiyfbfa6c82008-07-22 11:52:52 +0300288 int err = 0;
Artem Bityutskiy1e517642008-07-14 19:08:37 +0300289 struct ubifs_info *c = inode->i_sb->s_fs_info;
290 struct ubifs_inode *ui = ubifs_inode(inode);
291
292 ubifs_assert(!ui->xattr);
293 if (is_bad_inode(inode))
294 return 0;
295
296 mutex_lock(&ui->ui_mutex);
297 /*
298 * Due to races between write-back forced by budgeting
299 * (see 'sync_some_inodes()') and pdflush write-back, the inode may
300 * have already been synchronized, do not do this again. This might
301 * also happen if it was synchronized in an VFS operation, e.g.
302 * 'ubifs_link()'.
303 */
304 if (!ui->dirty) {
305 mutex_unlock(&ui->ui_mutex);
306 return 0;
307 }
308
Artem Bityutskiyfbfa6c82008-07-22 11:52:52 +0300309 /*
310 * As an optimization, do not write orphan inodes to the media just
311 * because this is not needed.
312 */
313 dbg_gen("inode %lu, mode %#x, nlink %u",
314 inode->i_ino, (int)inode->i_mode, inode->i_nlink);
315 if (inode->i_nlink) {
Artem Bityutskiy1f286812008-07-22 12:06:13 +0300316 err = ubifs_jnl_write_inode(c, inode);
Artem Bityutskiyfbfa6c82008-07-22 11:52:52 +0300317 if (err)
318 ubifs_err("can't write inode %lu, error %d",
319 inode->i_ino, err);
320 }
Artem Bityutskiy1e517642008-07-14 19:08:37 +0300321
322 ui->dirty = 0;
323 mutex_unlock(&ui->ui_mutex);
324 ubifs_release_dirty_inode_budget(c, ui);
325 return err;
326}
327
328static void ubifs_delete_inode(struct inode *inode)
329{
330 int err;
331 struct ubifs_info *c = inode->i_sb->s_fs_info;
Artem Bityutskiy1e0f3582008-07-21 10:59:53 +0300332 struct ubifs_inode *ui = ubifs_inode(inode);
Artem Bityutskiy1e517642008-07-14 19:08:37 +0300333
Artem Bityutskiy1e0f3582008-07-21 10:59:53 +0300334 if (ui->xattr)
Artem Bityutskiy1e517642008-07-14 19:08:37 +0300335 /*
336 * Extended attribute inode deletions are fully handled in
337 * 'ubifs_removexattr()'. These inodes are special and have
338 * limited usage, so there is nothing to do here.
339 */
340 goto out;
341
Artem Bityutskiy7d32c2b2008-07-18 18:54:29 +0300342 dbg_gen("inode %lu, mode %#x", inode->i_ino, (int)inode->i_mode);
Artem Bityutskiy1e517642008-07-14 19:08:37 +0300343 ubifs_assert(!atomic_read(&inode->i_count));
344 ubifs_assert(inode->i_nlink == 0);
345
346 truncate_inode_pages(&inode->i_data, 0);
347 if (is_bad_inode(inode))
348 goto out;
349
Artem Bityutskiy1e0f3582008-07-21 10:59:53 +0300350 ui->ui_size = inode->i_size = 0;
Artem Bityutskiyde94eb52008-07-22 13:06:20 +0300351 err = ubifs_jnl_delete_inode(c, inode);
Artem Bityutskiy1e517642008-07-14 19:08:37 +0300352 if (err)
353 /*
354 * Worst case we have a lost orphan inode wasting space, so a
Artem Bityutskiy0a883a02008-08-13 14:13:26 +0300355 * simple error message is OK here.
Artem Bityutskiy1e517642008-07-14 19:08:37 +0300356 */
Artem Bityutskiyde94eb52008-07-22 13:06:20 +0300357 ubifs_err("can't delete inode %lu, error %d",
358 inode->i_ino, err);
359
Artem Bityutskiy1e517642008-07-14 19:08:37 +0300360out:
Artem Bityutskiy1e0f3582008-07-21 10:59:53 +0300361 if (ui->dirty)
362 ubifs_release_dirty_inode_budget(c, ui);
Artem Bityutskiy1e517642008-07-14 19:08:37 +0300363 clear_inode(inode);
364}
365
366static void ubifs_dirty_inode(struct inode *inode)
367{
368 struct ubifs_inode *ui = ubifs_inode(inode);
369
370 ubifs_assert(mutex_is_locked(&ui->ui_mutex));
371 if (!ui->dirty) {
372 ui->dirty = 1;
373 dbg_gen("inode %lu", inode->i_ino);
374 }
375}
376
377static int ubifs_statfs(struct dentry *dentry, struct kstatfs *buf)
378{
379 struct ubifs_info *c = dentry->d_sb->s_fs_info;
380 unsigned long long free;
Artem Bityutskiy7c7cbad2008-09-03 14:16:42 +0300381 __le32 *uuid = (__le32 *)c->uuid;
Artem Bityutskiy1e517642008-07-14 19:08:37 +0300382
Artem Bityutskiy7dad1812008-08-25 18:58:19 +0300383 free = ubifs_get_free_space(c);
Artem Bityutskiy1e517642008-07-14 19:08:37 +0300384 dbg_gen("free space %lld bytes (%lld blocks)",
385 free, free >> UBIFS_BLOCK_SHIFT);
386
387 buf->f_type = UBIFS_SUPER_MAGIC;
388 buf->f_bsize = UBIFS_BLOCK_SIZE;
389 buf->f_blocks = c->block_cnt;
390 buf->f_bfree = free >> UBIFS_BLOCK_SHIFT;
391 if (free > c->report_rp_size)
392 buf->f_bavail = (free - c->report_rp_size) >> UBIFS_BLOCK_SHIFT;
393 else
394 buf->f_bavail = 0;
395 buf->f_files = 0;
396 buf->f_ffree = 0;
397 buf->f_namelen = UBIFS_MAX_NLEN;
Artem Bityutskiy7c7cbad2008-09-03 14:16:42 +0300398 buf->f_fsid.val[0] = le32_to_cpu(uuid[0]) ^ le32_to_cpu(uuid[2]);
399 buf->f_fsid.val[1] = le32_to_cpu(uuid[1]) ^ le32_to_cpu(uuid[3]);
Artem Bityutskiy1e517642008-07-14 19:08:37 +0300400 return 0;
401}
402
403static int ubifs_show_options(struct seq_file *s, struct vfsmount *mnt)
404{
405 struct ubifs_info *c = mnt->mnt_sb->s_fs_info;
406
407 if (c->mount_opts.unmount_mode == 2)
408 seq_printf(s, ",fast_unmount");
409 else if (c->mount_opts.unmount_mode == 1)
410 seq_printf(s, ",norm_unmount");
411
Adrian Hunter4793e7c2008-09-02 16:29:46 +0300412 if (c->mount_opts.bulk_read == 2)
413 seq_printf(s, ",bulk_read");
414 else if (c->mount_opts.bulk_read == 1)
415 seq_printf(s, ",no_bulk_read");
416
Adrian Hunter2953e732008-09-04 16:26:00 +0300417 if (c->mount_opts.chk_data_crc == 2)
418 seq_printf(s, ",chk_data_crc");
419 else if (c->mount_opts.chk_data_crc == 1)
420 seq_printf(s, ",no_chk_data_crc");
421
Artem Bityutskiy553dea42008-11-01 14:57:49 +0200422 if (c->mount_opts.override_compr) {
423 seq_printf(s, ",compr=");
424 seq_printf(s, ubifs_compr_name(c->mount_opts.compr_type));
425 }
426
Artem Bityutskiy1e517642008-07-14 19:08:37 +0300427 return 0;
428}
429
430static int ubifs_sync_fs(struct super_block *sb, int wait)
431{
Artem Bityutskiyf1038302008-12-28 08:16:32 +0200432 int i, err;
Artem Bityutskiy1e517642008-07-14 19:08:37 +0300433 struct ubifs_info *c = sb->s_fs_info;
Artem Bityutskiy304d4272008-12-28 08:04:17 +0200434 struct writeback_control wbc = {
Artem Bityutskiydedb0d42009-01-09 21:02:37 +0200435 .sync_mode = WB_SYNC_ALL,
Artem Bityutskiy304d4272008-12-28 08:04:17 +0200436 .range_start = 0,
437 .range_end = LLONG_MAX,
438 .nr_to_write = LONG_MAX,
439 };
440
Artem Bityutskiye8ea1752009-01-06 14:40:23 -0800441 /*
Artem Bityutskiydedb0d42009-01-09 21:02:37 +0200442 * Zero @wait is just an advisory thing to help the file system shove
443 * lots of data into the queues, and there will be the second
Artem Bityutskiye8ea1752009-01-06 14:40:23 -0800444 * '->sync_fs()' call, with non-zero @wait.
445 */
Artem Bityutskiydedb0d42009-01-09 21:02:37 +0200446 if (!wait)
447 return 0;
Artem Bityutskiye8ea1752009-01-06 14:40:23 -0800448
Artem Bityutskiyf1038302008-12-28 08:16:32 +0200449 if (sb->s_flags & MS_RDONLY)
450 return 0;
451
452 /*
453 * Synchronize write buffers, because 'ubifs_run_commit()' does not
454 * do this if it waits for an already running commit.
455 */
456 for (i = 0; i < c->jhead_cnt; i++) {
457 err = ubifs_wbuf_sync(&c->jheads[i].wbuf);
458 if (err)
459 return err;
460 }
461
Artem Bityutskiy304d4272008-12-28 08:04:17 +0200462 /*
463 * VFS calls '->sync_fs()' before synchronizing all dirty inodes and
464 * pages, so synchronize them first, then commit the journal. Strictly
465 * speaking, it is not necessary to commit the journal here,
466 * synchronizing write-buffers would be enough. But committing makes
467 * UBIFS free space predictions much more accurate, so we want to let
468 * the user be able to get more accurate results of 'statfs()' after
469 * they synchronize the file system.
470 */
471 generic_sync_sb_inodes(sb, &wbc);
Artem Bityutskiy1e517642008-07-14 19:08:37 +0300472
Artem Bityutskiyf1038302008-12-28 08:16:32 +0200473 err = ubifs_run_commit(c);
474 if (err)
475 return err;
Artem Bityutskiy403e12a2008-09-09 12:31:37 +0300476
Artem Bityutskiycb5c6a22008-12-28 08:18:43 +0200477 return ubi_sync(c->vi.ubi_num);
Artem Bityutskiy1e517642008-07-14 19:08:37 +0300478}
479
480/**
481 * init_constants_early - initialize UBIFS constants.
482 * @c: UBIFS file-system description object
483 *
484 * This function initialize UBIFS constants which do not need the superblock to
485 * be read. It also checks that the UBI volume satisfies basic UBIFS
486 * requirements. Returns zero in case of success and a negative error code in
487 * case of failure.
488 */
489static int init_constants_early(struct ubifs_info *c)
490{
491 if (c->vi.corrupted) {
492 ubifs_warn("UBI volume is corrupted - read-only mode");
493 c->ro_media = 1;
494 }
495
496 if (c->di.ro_mode) {
497 ubifs_msg("read-only UBI device");
498 c->ro_media = 1;
499 }
500
501 if (c->vi.vol_type == UBI_STATIC_VOLUME) {
502 ubifs_msg("static UBI volume - read-only mode");
503 c->ro_media = 1;
504 }
505
506 c->leb_cnt = c->vi.size;
507 c->leb_size = c->vi.usable_leb_size;
508 c->half_leb_size = c->leb_size / 2;
509 c->min_io_size = c->di.min_io_size;
510 c->min_io_shift = fls(c->min_io_size) - 1;
511
512 if (c->leb_size < UBIFS_MIN_LEB_SZ) {
513 ubifs_err("too small LEBs (%d bytes), min. is %d bytes",
514 c->leb_size, UBIFS_MIN_LEB_SZ);
515 return -EINVAL;
516 }
517
518 if (c->leb_cnt < UBIFS_MIN_LEB_CNT) {
519 ubifs_err("too few LEBs (%d), min. is %d",
520 c->leb_cnt, UBIFS_MIN_LEB_CNT);
521 return -EINVAL;
522 }
523
524 if (!is_power_of_2(c->min_io_size)) {
525 ubifs_err("bad min. I/O size %d", c->min_io_size);
526 return -EINVAL;
527 }
528
529 /*
530 * UBIFS aligns all node to 8-byte boundary, so to make function in
531 * io.c simpler, assume minimum I/O unit size to be 8 bytes if it is
532 * less than 8.
533 */
534 if (c->min_io_size < 8) {
535 c->min_io_size = 8;
536 c->min_io_shift = 3;
537 }
538
539 c->ref_node_alsz = ALIGN(UBIFS_REF_NODE_SZ, c->min_io_size);
540 c->mst_node_alsz = ALIGN(UBIFS_MST_NODE_SZ, c->min_io_size);
541
542 /*
543 * Initialize node length ranges which are mostly needed for node
544 * length validation.
545 */
546 c->ranges[UBIFS_PAD_NODE].len = UBIFS_PAD_NODE_SZ;
547 c->ranges[UBIFS_SB_NODE].len = UBIFS_SB_NODE_SZ;
548 c->ranges[UBIFS_MST_NODE].len = UBIFS_MST_NODE_SZ;
549 c->ranges[UBIFS_REF_NODE].len = UBIFS_REF_NODE_SZ;
550 c->ranges[UBIFS_TRUN_NODE].len = UBIFS_TRUN_NODE_SZ;
551 c->ranges[UBIFS_CS_NODE].len = UBIFS_CS_NODE_SZ;
552
553 c->ranges[UBIFS_INO_NODE].min_len = UBIFS_INO_NODE_SZ;
554 c->ranges[UBIFS_INO_NODE].max_len = UBIFS_MAX_INO_NODE_SZ;
555 c->ranges[UBIFS_ORPH_NODE].min_len =
556 UBIFS_ORPH_NODE_SZ + sizeof(__le64);
557 c->ranges[UBIFS_ORPH_NODE].max_len = c->leb_size;
558 c->ranges[UBIFS_DENT_NODE].min_len = UBIFS_DENT_NODE_SZ;
559 c->ranges[UBIFS_DENT_NODE].max_len = UBIFS_MAX_DENT_NODE_SZ;
560 c->ranges[UBIFS_XENT_NODE].min_len = UBIFS_XENT_NODE_SZ;
561 c->ranges[UBIFS_XENT_NODE].max_len = UBIFS_MAX_XENT_NODE_SZ;
562 c->ranges[UBIFS_DATA_NODE].min_len = UBIFS_DATA_NODE_SZ;
563 c->ranges[UBIFS_DATA_NODE].max_len = UBIFS_MAX_DATA_NODE_SZ;
564 /*
565 * Minimum indexing node size is amended later when superblock is
566 * read and the key length is known.
567 */
568 c->ranges[UBIFS_IDX_NODE].min_len = UBIFS_IDX_NODE_SZ + UBIFS_BRANCH_SZ;
569 /*
570 * Maximum indexing node size is amended later when superblock is
571 * read and the fanout is known.
572 */
573 c->ranges[UBIFS_IDX_NODE].max_len = INT_MAX;
574
575 /*
576 * Initialize dead and dark LEB space watermarks.
577 *
578 * Dead space is the space which cannot be used. Its watermark is
579 * equivalent to min. I/O unit or minimum node size if it is greater
580 * then min. I/O unit.
581 *
582 * Dark space is the space which might be used, or might not, depending
583 * on which node should be written to the LEB. Its watermark is
584 * equivalent to maximum UBIFS node size.
585 */
586 c->dead_wm = ALIGN(MIN_WRITE_SZ, c->min_io_size);
587 c->dark_wm = ALIGN(UBIFS_MAX_NODE_SZ, c->min_io_size);
588
Artem Bityutskiy9bbb5722008-08-22 18:23:22 +0300589 /*
590 * Calculate how many bytes would be wasted at the end of LEB if it was
591 * fully filled with data nodes of maximum size. This is used in
592 * calculations when reporting free space.
593 */
594 c->leb_overhead = c->leb_size % UBIFS_MAX_DATA_NODE_SZ;
Artem Bityutskiy39ce81c2008-11-18 18:09:49 +0200595
Adrian Hunter4793e7c2008-09-02 16:29:46 +0300596 /* Buffer size for bulk-reads */
Artem Bityutskiy6c0c42c2008-11-18 20:20:05 +0200597 c->max_bu_buf_len = UBIFS_MAX_BULK_READ * UBIFS_MAX_DATA_NODE_SZ;
598 if (c->max_bu_buf_len > c->leb_size)
599 c->max_bu_buf_len = c->leb_size;
Artem Bityutskiy1e517642008-07-14 19:08:37 +0300600 return 0;
601}
602
603/**
604 * bud_wbuf_callback - bud LEB write-buffer synchronization call-back.
605 * @c: UBIFS file-system description object
606 * @lnum: LEB the write-buffer was synchronized to
607 * @free: how many free bytes left in this LEB
608 * @pad: how many bytes were padded
609 *
610 * This is a callback function which is called by the I/O unit when the
611 * write-buffer is synchronized. We need this to correctly maintain space
612 * accounting in bud logical eraseblocks. This function returns zero in case of
613 * success and a negative error code in case of failure.
614 *
615 * This function actually belongs to the journal, but we keep it here because
616 * we want to keep it static.
617 */
618static int bud_wbuf_callback(struct ubifs_info *c, int lnum, int free, int pad)
619{
620 return ubifs_update_one_lp(c, lnum, free, pad, 0, 0);
621}
622
623/*
Artem Bityutskiy79807d02008-12-27 19:18:00 +0200624 * init_constants_sb - initialize UBIFS constants.
Artem Bityutskiy1e517642008-07-14 19:08:37 +0300625 * @c: UBIFS file-system description object
626 *
627 * This is a helper function which initializes various UBIFS constants after
628 * the superblock has been read. It also checks various UBIFS parameters and
629 * makes sure they are all right. Returns zero in case of success and a
630 * negative error code in case of failure.
631 */
Artem Bityutskiy79807d02008-12-27 19:18:00 +0200632static int init_constants_sb(struct ubifs_info *c)
Artem Bityutskiy1e517642008-07-14 19:08:37 +0300633{
634 int tmp, err;
Artem Bityutskiy4d61db42008-12-18 14:06:51 +0200635 long long tmp64;
Artem Bityutskiy1e517642008-07-14 19:08:37 +0300636
637 c->main_bytes = (long long)c->main_lebs * c->leb_size;
638 c->max_znode_sz = sizeof(struct ubifs_znode) +
639 c->fanout * sizeof(struct ubifs_zbranch);
640
641 tmp = ubifs_idx_node_sz(c, 1);
642 c->ranges[UBIFS_IDX_NODE].min_len = tmp;
643 c->min_idx_node_sz = ALIGN(tmp, 8);
644
645 tmp = ubifs_idx_node_sz(c, c->fanout);
646 c->ranges[UBIFS_IDX_NODE].max_len = tmp;
647 c->max_idx_node_sz = ALIGN(tmp, 8);
648
649 /* Make sure LEB size is large enough to fit full commit */
650 tmp = UBIFS_CS_NODE_SZ + UBIFS_REF_NODE_SZ * c->jhead_cnt;
651 tmp = ALIGN(tmp, c->min_io_size);
652 if (tmp > c->leb_size) {
653 dbg_err("too small LEB size %d, at least %d needed",
654 c->leb_size, tmp);
655 return -EINVAL;
656 }
657
658 /*
659 * Make sure that the log is large enough to fit reference nodes for
660 * all buds plus one reserved LEB.
661 */
Artem Bityutskiy4d61db42008-12-18 14:06:51 +0200662 tmp64 = c->max_bud_bytes + c->leb_size - 1;
663 c->max_bud_cnt = div_u64(tmp64, c->leb_size);
Artem Bityutskiy1e517642008-07-14 19:08:37 +0300664 tmp = (c->ref_node_alsz * c->max_bud_cnt + c->leb_size - 1);
665 tmp /= c->leb_size;
666 tmp += 1;
667 if (c->log_lebs < tmp) {
668 dbg_err("too small log %d LEBs, required min. %d LEBs",
669 c->log_lebs, tmp);
670 return -EINVAL;
671 }
672
673 /*
674 * When budgeting we assume worst-case scenarios when the pages are not
675 * be compressed and direntries are of the maximum size.
676 *
677 * Note, data, which may be stored in inodes is budgeted separately, so
678 * it is not included into 'c->inode_budget'.
679 */
680 c->page_budget = UBIFS_MAX_DATA_NODE_SZ * UBIFS_BLOCKS_PER_PAGE;
681 c->inode_budget = UBIFS_INO_NODE_SZ;
682 c->dent_budget = UBIFS_MAX_DENT_NODE_SZ;
683
684 /*
685 * When the amount of flash space used by buds becomes
686 * 'c->max_bud_bytes', UBIFS just blocks all writers and starts commit.
687 * The writers are unblocked when the commit is finished. To avoid
688 * writers to be blocked UBIFS initiates background commit in advance,
689 * when number of bud bytes becomes above the limit defined below.
690 */
691 c->bg_bud_bytes = (c->max_bud_bytes * 13) >> 4;
692
693 /*
694 * Ensure minimum journal size. All the bytes in the journal heads are
695 * considered to be used, when calculating the current journal usage.
696 * Consequently, if the journal is too small, UBIFS will treat it as
697 * always full.
698 */
Artem Bityutskiy4d61db42008-12-18 14:06:51 +0200699 tmp64 = (long long)(c->jhead_cnt + 1) * c->leb_size + 1;
Artem Bityutskiy1e517642008-07-14 19:08:37 +0300700 if (c->bg_bud_bytes < tmp64)
701 c->bg_bud_bytes = tmp64;
702 if (c->max_bud_bytes < tmp64 + c->leb_size)
703 c->max_bud_bytes = tmp64 + c->leb_size;
704
705 err = ubifs_calc_lpt_geom(c);
706 if (err)
707 return err;
708
Artem Bityutskiy79807d02008-12-27 19:18:00 +0200709 return 0;
710}
711
712/*
713 * init_constants_master - initialize UBIFS constants.
714 * @c: UBIFS file-system description object
715 *
716 * This is a helper function which initializes various UBIFS constants after
717 * the master node has been read. It also checks various UBIFS parameters and
718 * makes sure they are all right.
719 */
720static void init_constants_master(struct ubifs_info *c)
721{
722 long long tmp64;
723
Artem Bityutskiy1e517642008-07-14 19:08:37 +0300724 c->min_idx_lebs = ubifs_calc_min_idx_lebs(c);
725
726 /*
727 * Calculate total amount of FS blocks. This number is not used
728 * internally because it does not make much sense for UBIFS, but it is
729 * necessary to report something for the 'statfs()' call.
730 *
Artem Bityutskiy7dad1812008-08-25 18:58:19 +0300731 * Subtract the LEB reserved for GC, the LEB which is reserved for
Artem Bityutskiyaf14a1a2008-12-19 19:26:29 +0200732 * deletions, minimum LEBs for the index, and assume only one journal
733 * head is available.
Artem Bityutskiy1e517642008-07-14 19:08:37 +0300734 */
Artem Bityutskiyaf14a1a2008-12-19 19:26:29 +0200735 tmp64 = c->main_lebs - 1 - 1 - MIN_INDEX_LEBS - c->jhead_cnt + 1;
Artem Bityutskiy4d61db42008-12-18 14:06:51 +0200736 tmp64 *= (long long)c->leb_size - c->leb_overhead;
Artem Bityutskiy1e517642008-07-14 19:08:37 +0300737 tmp64 = ubifs_reported_space(c, tmp64);
738 c->block_cnt = tmp64 >> UBIFS_BLOCK_SHIFT;
Artem Bityutskiy1e517642008-07-14 19:08:37 +0300739}
740
741/**
742 * take_gc_lnum - reserve GC LEB.
743 * @c: UBIFS file-system description object
744 *
745 * This function ensures that the LEB reserved for garbage collection is
746 * unmapped and is marked as "taken" in lprops. We also have to set free space
747 * to LEB size and dirty space to zero, because lprops may contain out-of-date
748 * information if the file-system was un-mounted before it has been committed.
749 * This function returns zero in case of success and a negative error code in
750 * case of failure.
751 */
752static int take_gc_lnum(struct ubifs_info *c)
753{
754 int err;
755
756 if (c->gc_lnum == -1) {
757 ubifs_err("no LEB for GC");
758 return -EINVAL;
759 }
760
761 err = ubifs_leb_unmap(c, c->gc_lnum);
762 if (err)
763 return err;
764
765 /* And we have to tell lprops that this LEB is taken */
766 err = ubifs_change_one_lp(c, c->gc_lnum, c->leb_size, 0,
767 LPROPS_TAKEN, 0, 0);
768 return err;
769}
770
771/**
772 * alloc_wbufs - allocate write-buffers.
773 * @c: UBIFS file-system description object
774 *
775 * This helper function allocates and initializes UBIFS write-buffers. Returns
776 * zero in case of success and %-ENOMEM in case of failure.
777 */
778static int alloc_wbufs(struct ubifs_info *c)
779{
780 int i, err;
781
782 c->jheads = kzalloc(c->jhead_cnt * sizeof(struct ubifs_jhead),
783 GFP_KERNEL);
784 if (!c->jheads)
785 return -ENOMEM;
786
787 /* Initialize journal heads */
788 for (i = 0; i < c->jhead_cnt; i++) {
789 INIT_LIST_HEAD(&c->jheads[i].buds_list);
790 err = ubifs_wbuf_init(c, &c->jheads[i].wbuf);
791 if (err)
792 return err;
793
794 c->jheads[i].wbuf.sync_callback = &bud_wbuf_callback;
795 c->jheads[i].wbuf.jhead = i;
796 }
797
798 c->jheads[BASEHD].wbuf.dtype = UBI_SHORTTERM;
799 /*
800 * Garbage Collector head likely contains long-term data and
801 * does not need to be synchronized by timer.
802 */
803 c->jheads[GCHD].wbuf.dtype = UBI_LONGTERM;
804 c->jheads[GCHD].wbuf.timeout = 0;
805
806 return 0;
807}
808
809/**
810 * free_wbufs - free write-buffers.
811 * @c: UBIFS file-system description object
812 */
813static void free_wbufs(struct ubifs_info *c)
814{
815 int i;
816
817 if (c->jheads) {
818 for (i = 0; i < c->jhead_cnt; i++) {
819 kfree(c->jheads[i].wbuf.buf);
820 kfree(c->jheads[i].wbuf.inodes);
821 }
822 kfree(c->jheads);
823 c->jheads = NULL;
824 }
825}
826
827/**
828 * free_orphans - free orphans.
829 * @c: UBIFS file-system description object
830 */
831static void free_orphans(struct ubifs_info *c)
832{
833 struct ubifs_orphan *orph;
834
835 while (c->orph_dnext) {
836 orph = c->orph_dnext;
837 c->orph_dnext = orph->dnext;
838 list_del(&orph->list);
839 kfree(orph);
840 }
841
842 while (!list_empty(&c->orph_list)) {
843 orph = list_entry(c->orph_list.next, struct ubifs_orphan, list);
844 list_del(&orph->list);
845 kfree(orph);
846 dbg_err("orphan list not empty at unmount");
847 }
848
849 vfree(c->orph_buf);
850 c->orph_buf = NULL;
851}
852
853/**
854 * free_buds - free per-bud objects.
855 * @c: UBIFS file-system description object
856 */
857static void free_buds(struct ubifs_info *c)
858{
859 struct rb_node *this = c->buds.rb_node;
860 struct ubifs_bud *bud;
861
862 while (this) {
863 if (this->rb_left)
864 this = this->rb_left;
865 else if (this->rb_right)
866 this = this->rb_right;
867 else {
868 bud = rb_entry(this, struct ubifs_bud, rb);
869 this = rb_parent(this);
870 if (this) {
871 if (this->rb_left == &bud->rb)
872 this->rb_left = NULL;
873 else
874 this->rb_right = NULL;
875 }
876 kfree(bud);
877 }
878 }
879}
880
881/**
882 * check_volume_empty - check if the UBI volume is empty.
883 * @c: UBIFS file-system description object
884 *
885 * This function checks if the UBIFS volume is empty by looking if its LEBs are
886 * mapped or not. The result of checking is stored in the @c->empty variable.
887 * Returns zero in case of success and a negative error code in case of
888 * failure.
889 */
890static int check_volume_empty(struct ubifs_info *c)
891{
892 int lnum, err;
893
894 c->empty = 1;
895 for (lnum = 0; lnum < c->leb_cnt; lnum++) {
896 err = ubi_is_mapped(c->ubi, lnum);
897 if (unlikely(err < 0))
898 return err;
899 if (err == 1) {
900 c->empty = 0;
901 break;
902 }
903
904 cond_resched();
905 }
906
907 return 0;
908}
909
910/*
911 * UBIFS mount options.
912 *
913 * Opt_fast_unmount: do not run a journal commit before un-mounting
914 * Opt_norm_unmount: run a journal commit before un-mounting
Adrian Hunter4793e7c2008-09-02 16:29:46 +0300915 * Opt_bulk_read: enable bulk-reads
916 * Opt_no_bulk_read: disable bulk-reads
Adrian Hunter2953e732008-09-04 16:26:00 +0300917 * Opt_chk_data_crc: check CRCs when reading data nodes
918 * Opt_no_chk_data_crc: do not check CRCs when reading data nodes
Artem Bityutskiy553dea42008-11-01 14:57:49 +0200919 * Opt_override_compr: override default compressor
Artem Bityutskiy1e517642008-07-14 19:08:37 +0300920 * Opt_err: just end of array marker
921 */
922enum {
923 Opt_fast_unmount,
924 Opt_norm_unmount,
Adrian Hunter4793e7c2008-09-02 16:29:46 +0300925 Opt_bulk_read,
926 Opt_no_bulk_read,
Adrian Hunter2953e732008-09-04 16:26:00 +0300927 Opt_chk_data_crc,
928 Opt_no_chk_data_crc,
Artem Bityutskiy553dea42008-11-01 14:57:49 +0200929 Opt_override_compr,
Artem Bityutskiy1e517642008-07-14 19:08:37 +0300930 Opt_err,
931};
932
Steven Whitehousea447c092008-10-13 10:46:57 +0100933static const match_table_t tokens = {
Artem Bityutskiy1e517642008-07-14 19:08:37 +0300934 {Opt_fast_unmount, "fast_unmount"},
935 {Opt_norm_unmount, "norm_unmount"},
Adrian Hunter4793e7c2008-09-02 16:29:46 +0300936 {Opt_bulk_read, "bulk_read"},
937 {Opt_no_bulk_read, "no_bulk_read"},
Adrian Hunter2953e732008-09-04 16:26:00 +0300938 {Opt_chk_data_crc, "chk_data_crc"},
939 {Opt_no_chk_data_crc, "no_chk_data_crc"},
Artem Bityutskiy553dea42008-11-01 14:57:49 +0200940 {Opt_override_compr, "compr=%s"},
Artem Bityutskiy1e517642008-07-14 19:08:37 +0300941 {Opt_err, NULL},
942};
943
944/**
945 * ubifs_parse_options - parse mount parameters.
946 * @c: UBIFS file-system description object
947 * @options: parameters to parse
948 * @is_remount: non-zero if this is FS re-mount
949 *
950 * This function parses UBIFS mount options and returns zero in case success
951 * and a negative error code in case of failure.
952 */
953static int ubifs_parse_options(struct ubifs_info *c, char *options,
954 int is_remount)
955{
956 char *p;
957 substring_t args[MAX_OPT_ARGS];
958
959 if (!options)
960 return 0;
961
962 while ((p = strsep(&options, ","))) {
963 int token;
964
965 if (!*p)
966 continue;
967
968 token = match_token(p, tokens, args);
969 switch (token) {
970 case Opt_fast_unmount:
971 c->mount_opts.unmount_mode = 2;
972 c->fast_unmount = 1;
973 break;
974 case Opt_norm_unmount:
975 c->mount_opts.unmount_mode = 1;
976 c->fast_unmount = 0;
977 break;
Adrian Hunter4793e7c2008-09-02 16:29:46 +0300978 case Opt_bulk_read:
979 c->mount_opts.bulk_read = 2;
980 c->bulk_read = 1;
981 break;
982 case Opt_no_bulk_read:
983 c->mount_opts.bulk_read = 1;
984 c->bulk_read = 0;
985 break;
Adrian Hunter2953e732008-09-04 16:26:00 +0300986 case Opt_chk_data_crc:
987 c->mount_opts.chk_data_crc = 2;
988 c->no_chk_data_crc = 0;
989 break;
990 case Opt_no_chk_data_crc:
991 c->mount_opts.chk_data_crc = 1;
992 c->no_chk_data_crc = 1;
993 break;
Artem Bityutskiy553dea42008-11-01 14:57:49 +0200994 case Opt_override_compr:
995 {
996 char *name = match_strdup(&args[0]);
997
998 if (!name)
999 return -ENOMEM;
1000 if (!strcmp(name, "none"))
1001 c->mount_opts.compr_type = UBIFS_COMPR_NONE;
1002 else if (!strcmp(name, "lzo"))
1003 c->mount_opts.compr_type = UBIFS_COMPR_LZO;
1004 else if (!strcmp(name, "zlib"))
1005 c->mount_opts.compr_type = UBIFS_COMPR_ZLIB;
1006 else {
1007 ubifs_err("unknown compressor \"%s\"", name);
1008 kfree(name);
1009 return -EINVAL;
1010 }
1011 kfree(name);
1012 c->mount_opts.override_compr = 1;
1013 c->default_compr = c->mount_opts.compr_type;
1014 break;
1015 }
Artem Bityutskiy1e517642008-07-14 19:08:37 +03001016 default:
1017 ubifs_err("unrecognized mount option \"%s\" "
1018 "or missing value", p);
1019 return -EINVAL;
1020 }
1021 }
1022
1023 return 0;
1024}
1025
1026/**
1027 * destroy_journal - destroy journal data structures.
1028 * @c: UBIFS file-system description object
1029 *
1030 * This function destroys journal data structures including those that may have
1031 * been created by recovery functions.
1032 */
1033static void destroy_journal(struct ubifs_info *c)
1034{
1035 while (!list_empty(&c->unclean_leb_list)) {
1036 struct ubifs_unclean_leb *ucleb;
1037
1038 ucleb = list_entry(c->unclean_leb_list.next,
1039 struct ubifs_unclean_leb, list);
1040 list_del(&ucleb->list);
1041 kfree(ucleb);
1042 }
1043 while (!list_empty(&c->old_buds)) {
1044 struct ubifs_bud *bud;
1045
1046 bud = list_entry(c->old_buds.next, struct ubifs_bud, list);
1047 list_del(&bud->list);
1048 kfree(bud);
1049 }
1050 ubifs_destroy_idx_gc(c);
1051 ubifs_destroy_size_tree(c);
1052 ubifs_tnc_close(c);
1053 free_buds(c);
1054}
1055
1056/**
Artem Bityutskiy3477d202008-11-19 11:53:15 +02001057 * bu_init - initialize bulk-read information.
1058 * @c: UBIFS file-system description object
1059 */
1060static void bu_init(struct ubifs_info *c)
1061{
1062 ubifs_assert(c->bulk_read == 1);
1063
1064 if (c->bu.buf)
1065 return; /* Already initialized */
1066
1067again:
1068 c->bu.buf = kmalloc(c->max_bu_buf_len, GFP_KERNEL | __GFP_NOWARN);
1069 if (!c->bu.buf) {
1070 if (c->max_bu_buf_len > UBIFS_KMALLOC_OK) {
1071 c->max_bu_buf_len = UBIFS_KMALLOC_OK;
1072 goto again;
1073 }
1074
1075 /* Just disable bulk-read */
1076 ubifs_warn("Cannot allocate %d bytes of memory for bulk-read, "
1077 "disabling it", c->max_bu_buf_len);
1078 c->mount_opts.bulk_read = 1;
1079 c->bulk_read = 0;
1080 return;
1081 }
1082}
1083
1084/**
Artem Bityutskiy57a450e2008-12-30 16:23:34 +02001085 * check_free_space - check if there is enough free space to mount.
1086 * @c: UBIFS file-system description object
1087 *
1088 * This function makes sure UBIFS has enough free space to be mounted in
1089 * read/write mode. UBIFS must always have some free space to allow deletions.
1090 */
1091static int check_free_space(struct ubifs_info *c)
1092{
1093 ubifs_assert(c->dark_wm > 0);
1094 if (c->lst.total_free + c->lst.total_dirty < c->dark_wm) {
1095 ubifs_err("insufficient free space to mount in read/write mode");
1096 dbg_dump_budg(c);
1097 dbg_dump_lprops(c);
1098 /*
1099 * We return %-EINVAL instead of %-ENOSPC because it seems to
1100 * be the closest error code mentioned in the mount function
1101 * documentation.
1102 */
1103 return -EINVAL;
1104 }
1105 return 0;
1106}
1107
1108/**
Artem Bityutskiy1e517642008-07-14 19:08:37 +03001109 * mount_ubifs - mount UBIFS file-system.
1110 * @c: UBIFS file-system description object
1111 *
1112 * This function mounts UBIFS file system. Returns zero in case of success and
1113 * a negative error code in case of failure.
1114 *
1115 * Note, the function does not de-allocate resources it it fails half way
1116 * through, and the caller has to do this instead.
1117 */
1118static int mount_ubifs(struct ubifs_info *c)
1119{
1120 struct super_block *sb = c->vfs_sb;
1121 int err, mounted_read_only = (sb->s_flags & MS_RDONLY);
1122 long long x;
1123 size_t sz;
1124
1125 err = init_constants_early(c);
1126 if (err)
1127 return err;
1128
Artem Bityutskiy17c2f9f2008-10-17 13:31:39 +03001129 err = ubifs_debugging_init(c);
1130 if (err)
1131 return err;
Artem Bityutskiy1e517642008-07-14 19:08:37 +03001132
1133 err = check_volume_empty(c);
1134 if (err)
1135 goto out_free;
1136
1137 if (c->empty && (mounted_read_only || c->ro_media)) {
1138 /*
1139 * This UBI volume is empty, and read-only, or the file system
1140 * is mounted read-only - we cannot format it.
1141 */
1142 ubifs_err("can't format empty UBI volume: read-only %s",
1143 c->ro_media ? "UBI volume" : "mount");
1144 err = -EROFS;
1145 goto out_free;
1146 }
1147
1148 if (c->ro_media && !mounted_read_only) {
1149 ubifs_err("cannot mount read-write - read-only media");
1150 err = -EROFS;
1151 goto out_free;
1152 }
1153
1154 /*
1155 * The requirement for the buffer is that it should fit indexing B-tree
1156 * height amount of integers. We assume the height if the TNC tree will
1157 * never exceed 64.
1158 */
1159 err = -ENOMEM;
1160 c->bottom_up_buf = kmalloc(BOTTOM_UP_HEIGHT * sizeof(int), GFP_KERNEL);
1161 if (!c->bottom_up_buf)
1162 goto out_free;
1163
1164 c->sbuf = vmalloc(c->leb_size);
1165 if (!c->sbuf)
1166 goto out_free;
1167
1168 if (!mounted_read_only) {
1169 c->ileb_buf = vmalloc(c->leb_size);
1170 if (!c->ileb_buf)
1171 goto out_free;
1172 }
1173
Artem Bityutskiy3477d202008-11-19 11:53:15 +02001174 if (c->bulk_read == 1)
1175 bu_init(c);
1176
1177 /*
1178 * We have to check all CRCs, even for data nodes, when we mount the FS
1179 * (specifically, when we are replaying).
1180 */
Adrian Hunter2953e732008-09-04 16:26:00 +03001181 c->always_chk_crc = 1;
1182
Artem Bityutskiy1e517642008-07-14 19:08:37 +03001183 err = ubifs_read_superblock(c);
1184 if (err)
1185 goto out_free;
1186
1187 /*
Artem Bityutskiy553dea42008-11-01 14:57:49 +02001188 * Make sure the compressor which is set as default in the superblock
Artem Bityutskiy57a450e2008-12-30 16:23:34 +02001189 * or overridden by mount options is actually compiled in.
Artem Bityutskiy1e517642008-07-14 19:08:37 +03001190 */
1191 if (!ubifs_compr_present(c->default_compr)) {
Artem Bityutskiy553dea42008-11-01 14:57:49 +02001192 ubifs_err("'compressor \"%s\" is not compiled in",
1193 ubifs_compr_name(c->default_compr));
1194 goto out_free;
Artem Bityutskiy1e517642008-07-14 19:08:37 +03001195 }
1196
Artem Bityutskiy79807d02008-12-27 19:18:00 +02001197 err = init_constants_sb(c);
Artem Bityutskiy1e517642008-07-14 19:08:37 +03001198 if (err)
Artem Bityutskiy17c2f9f2008-10-17 13:31:39 +03001199 goto out_free;
Artem Bityutskiy1e517642008-07-14 19:08:37 +03001200
1201 sz = ALIGN(c->max_idx_node_sz, c->min_io_size);
1202 sz = ALIGN(sz + c->max_idx_node_sz, c->min_io_size);
1203 c->cbuf = kmalloc(sz, GFP_NOFS);
1204 if (!c->cbuf) {
1205 err = -ENOMEM;
Artem Bityutskiy17c2f9f2008-10-17 13:31:39 +03001206 goto out_free;
Artem Bityutskiy1e517642008-07-14 19:08:37 +03001207 }
1208
Sebastian Siewior0855f312008-09-09 11:17:29 +02001209 sprintf(c->bgt_name, BGT_NAME_PATTERN, c->vi.ubi_num, c->vi.vol_id);
Artem Bityutskiy1e517642008-07-14 19:08:37 +03001210 if (!mounted_read_only) {
1211 err = alloc_wbufs(c);
1212 if (err)
1213 goto out_cbuf;
1214
1215 /* Create background thread */
Artem Bityutskiy1e517642008-07-14 19:08:37 +03001216 c->bgt = kthread_create(ubifs_bg_thread, c, c->bgt_name);
Artem Bityutskiy1e517642008-07-14 19:08:37 +03001217 if (IS_ERR(c->bgt)) {
1218 err = PTR_ERR(c->bgt);
1219 c->bgt = NULL;
1220 ubifs_err("cannot spawn \"%s\", error %d",
1221 c->bgt_name, err);
1222 goto out_wbufs;
1223 }
1224 wake_up_process(c->bgt);
1225 }
1226
1227 err = ubifs_read_master(c);
1228 if (err)
1229 goto out_master;
1230
Artem Bityutskiy79807d02008-12-27 19:18:00 +02001231 init_constants_master(c);
1232
Artem Bityutskiy1e517642008-07-14 19:08:37 +03001233 if ((c->mst_node->flags & cpu_to_le32(UBIFS_MST_DIRTY)) != 0) {
1234 ubifs_msg("recovery needed");
1235 c->need_recovery = 1;
1236 if (!mounted_read_only) {
1237 err = ubifs_recover_inl_heads(c, c->sbuf);
1238 if (err)
1239 goto out_master;
1240 }
1241 } else if (!mounted_read_only) {
1242 /*
1243 * Set the "dirty" flag so that if we reboot uncleanly we
1244 * will notice this immediately on the next mount.
1245 */
1246 c->mst_node->flags |= cpu_to_le32(UBIFS_MST_DIRTY);
1247 err = ubifs_write_master(c);
1248 if (err)
1249 goto out_master;
1250 }
1251
1252 err = ubifs_lpt_init(c, 1, !mounted_read_only);
1253 if (err)
1254 goto out_lpt;
1255
1256 err = dbg_check_idx_size(c, c->old_idx_sz);
1257 if (err)
1258 goto out_lpt;
1259
1260 err = ubifs_replay_journal(c);
1261 if (err)
1262 goto out_journal;
1263
1264 err = ubifs_mount_orphans(c, c->need_recovery, mounted_read_only);
1265 if (err)
1266 goto out_orphans;
1267
1268 if (!mounted_read_only) {
1269 int lnum;
1270
Artem Bityutskiy57a450e2008-12-30 16:23:34 +02001271 err = check_free_space(c);
1272 if (err)
Artem Bityutskiy1e517642008-07-14 19:08:37 +03001273 goto out_orphans;
Artem Bityutskiy1e517642008-07-14 19:08:37 +03001274
1275 /* Check for enough log space */
1276 lnum = c->lhead_lnum + 1;
1277 if (lnum >= UBIFS_LOG_LNUM + c->log_lebs)
1278 lnum = UBIFS_LOG_LNUM;
1279 if (lnum == c->ltail_lnum) {
1280 err = ubifs_consolidate_log(c);
1281 if (err)
1282 goto out_orphans;
1283 }
1284
1285 if (c->need_recovery) {
1286 err = ubifs_recover_size(c);
1287 if (err)
1288 goto out_orphans;
1289 err = ubifs_rcvry_gc_commit(c);
1290 } else
1291 err = take_gc_lnum(c);
1292 if (err)
1293 goto out_orphans;
1294
1295 err = dbg_check_lprops(c);
1296 if (err)
1297 goto out_orphans;
1298 } else if (c->need_recovery) {
1299 err = ubifs_recover_size(c);
1300 if (err)
1301 goto out_orphans;
1302 }
1303
1304 spin_lock(&ubifs_infos_lock);
1305 list_add_tail(&c->infos_list, &ubifs_infos);
1306 spin_unlock(&ubifs_infos_lock);
1307
1308 if (c->need_recovery) {
1309 if (mounted_read_only)
1310 ubifs_msg("recovery deferred");
1311 else {
1312 c->need_recovery = 0;
1313 ubifs_msg("recovery completed");
1314 }
1315 }
1316
Artem Bityutskiy552ff312008-10-23 11:49:28 +03001317 err = dbg_debugfs_init_fs(c);
1318 if (err)
1319 goto out_infos;
1320
Artem Bityutskiy1e517642008-07-14 19:08:37 +03001321 err = dbg_check_filesystem(c);
1322 if (err)
1323 goto out_infos;
1324
Adrian Hunter2953e732008-09-04 16:26:00 +03001325 c->always_chk_crc = 0;
1326
Artem Bityutskiyce769ca2008-07-18 12:54:21 +03001327 ubifs_msg("mounted UBI device %d, volume %d, name \"%s\"",
1328 c->vi.ubi_num, c->vi.vol_id, c->vi.name);
Artem Bityutskiy1e517642008-07-14 19:08:37 +03001329 if (mounted_read_only)
1330 ubifs_msg("mounted read-only");
1331 x = (long long)c->main_lebs * c->leb_size;
Artem Bityutskiy948cfb22008-08-20 11:56:33 +03001332 ubifs_msg("file system size: %lld bytes (%lld KiB, %lld MiB, %d "
1333 "LEBs)", x, x >> 10, x >> 20, c->main_lebs);
Artem Bityutskiy1e517642008-07-14 19:08:37 +03001334 x = (long long)c->log_lebs * c->leb_size + c->max_bud_bytes;
Artem Bityutskiy948cfb22008-08-20 11:56:33 +03001335 ubifs_msg("journal size: %lld bytes (%lld KiB, %lld MiB, %d "
1336 "LEBs)", x, x >> 10, x >> 20, c->log_lebs + c->max_bud_cnt);
1337 ubifs_msg("media format: %d (latest is %d)",
Artem Bityutskiy1e517642008-07-14 19:08:37 +03001338 c->fmt_version, UBIFS_FORMAT_VERSION);
Artem Bityutskiy948cfb22008-08-20 11:56:33 +03001339 ubifs_msg("default compressor: %s", ubifs_compr_name(c->default_compr));
Artem Bityutskiyfae7fb22008-10-17 18:49:23 +03001340 ubifs_msg("reserved for root: %llu bytes (%llu KiB)",
Artem Bityutskiy948cfb22008-08-20 11:56:33 +03001341 c->report_rp_size, c->report_rp_size >> 10);
Artem Bityutskiy1e517642008-07-14 19:08:37 +03001342
1343 dbg_msg("compiled on: " __DATE__ " at " __TIME__);
1344 dbg_msg("min. I/O unit size: %d bytes", c->min_io_size);
1345 dbg_msg("LEB size: %d bytes (%d KiB)",
Artem Bityutskiy948cfb22008-08-20 11:56:33 +03001346 c->leb_size, c->leb_size >> 10);
Artem Bityutskiy1e517642008-07-14 19:08:37 +03001347 dbg_msg("data journal heads: %d",
1348 c->jhead_cnt - NONDATA_JHEADS_CNT);
1349 dbg_msg("UUID: %02X%02X%02X%02X-%02X%02X"
1350 "-%02X%02X-%02X%02X-%02X%02X%02X%02X%02X%02X",
1351 c->uuid[0], c->uuid[1], c->uuid[2], c->uuid[3],
1352 c->uuid[4], c->uuid[5], c->uuid[6], c->uuid[7],
1353 c->uuid[8], c->uuid[9], c->uuid[10], c->uuid[11],
1354 c->uuid[12], c->uuid[13], c->uuid[14], c->uuid[15]);
1355 dbg_msg("fast unmount: %d", c->fast_unmount);
1356 dbg_msg("big_lpt %d", c->big_lpt);
1357 dbg_msg("log LEBs: %d (%d - %d)",
1358 c->log_lebs, UBIFS_LOG_LNUM, c->log_last);
1359 dbg_msg("LPT area LEBs: %d (%d - %d)",
1360 c->lpt_lebs, c->lpt_first, c->lpt_last);
1361 dbg_msg("orphan area LEBs: %d (%d - %d)",
1362 c->orph_lebs, c->orph_first, c->orph_last);
1363 dbg_msg("main area LEBs: %d (%d - %d)",
1364 c->main_lebs, c->main_first, c->leb_cnt - 1);
1365 dbg_msg("index LEBs: %d", c->lst.idx_lebs);
1366 dbg_msg("total index bytes: %lld (%lld KiB, %lld MiB)",
1367 c->old_idx_sz, c->old_idx_sz >> 10, c->old_idx_sz >> 20);
1368 dbg_msg("key hash type: %d", c->key_hash_type);
1369 dbg_msg("tree fanout: %d", c->fanout);
1370 dbg_msg("reserved GC LEB: %d", c->gc_lnum);
1371 dbg_msg("first main LEB: %d", c->main_first);
Artem Bityutskiy8e5033a2008-12-30 18:37:45 +02001372 dbg_msg("max. znode size %d", c->max_znode_sz);
1373 dbg_msg("max. index node size %d", c->max_idx_node_sz);
1374 dbg_msg("node sizes: data %zu, inode %zu, dentry %zu",
1375 UBIFS_DATA_NODE_SZ, UBIFS_INO_NODE_SZ, UBIFS_DENT_NODE_SZ);
1376 dbg_msg("node sizes: trun %zu, sb %zu, master %zu",
1377 UBIFS_TRUN_NODE_SZ, UBIFS_SB_NODE_SZ, UBIFS_MST_NODE_SZ);
1378 dbg_msg("node sizes: ref %zu, cmt. start %zu, orph %zu",
1379 UBIFS_REF_NODE_SZ, UBIFS_CS_NODE_SZ, UBIFS_ORPH_NODE_SZ);
1380 dbg_msg("max. node sizes: data %zu, inode %zu dentry %zu",
1381 UBIFS_MAX_DATA_NODE_SZ, UBIFS_MAX_INO_NODE_SZ,
1382 UBIFS_MAX_DENT_NODE_SZ);
Artem Bityutskiy1e517642008-07-14 19:08:37 +03001383 dbg_msg("dead watermark: %d", c->dead_wm);
1384 dbg_msg("dark watermark: %d", c->dark_wm);
Artem Bityutskiy8e5033a2008-12-30 18:37:45 +02001385 dbg_msg("LEB overhead: %d", c->leb_overhead);
Artem Bityutskiy1e517642008-07-14 19:08:37 +03001386 x = (long long)c->main_lebs * c->dark_wm;
1387 dbg_msg("max. dark space: %lld (%lld KiB, %lld MiB)",
1388 x, x >> 10, x >> 20);
1389 dbg_msg("maximum bud bytes: %lld (%lld KiB, %lld MiB)",
1390 c->max_bud_bytes, c->max_bud_bytes >> 10,
1391 c->max_bud_bytes >> 20);
1392 dbg_msg("BG commit bud bytes: %lld (%lld KiB, %lld MiB)",
1393 c->bg_bud_bytes, c->bg_bud_bytes >> 10,
1394 c->bg_bud_bytes >> 20);
1395 dbg_msg("current bud bytes %lld (%lld KiB, %lld MiB)",
1396 c->bud_bytes, c->bud_bytes >> 10, c->bud_bytes >> 20);
1397 dbg_msg("max. seq. number: %llu", c->max_sqnum);
1398 dbg_msg("commit number: %llu", c->cmt_no);
1399
1400 return 0;
1401
1402out_infos:
1403 spin_lock(&ubifs_infos_lock);
1404 list_del(&c->infos_list);
1405 spin_unlock(&ubifs_infos_lock);
1406out_orphans:
1407 free_orphans(c);
1408out_journal:
1409 destroy_journal(c);
1410out_lpt:
1411 ubifs_lpt_free(c, 0);
1412out_master:
1413 kfree(c->mst_node);
1414 kfree(c->rcvrd_mst_node);
1415 if (c->bgt)
1416 kthread_stop(c->bgt);
1417out_wbufs:
1418 free_wbufs(c);
1419out_cbuf:
1420 kfree(c->cbuf);
Artem Bityutskiy1e517642008-07-14 19:08:37 +03001421out_free:
Artem Bityutskiy3477d202008-11-19 11:53:15 +02001422 kfree(c->bu.buf);
Artem Bityutskiy1e517642008-07-14 19:08:37 +03001423 vfree(c->ileb_buf);
1424 vfree(c->sbuf);
1425 kfree(c->bottom_up_buf);
Artem Bityutskiy17c2f9f2008-10-17 13:31:39 +03001426 ubifs_debugging_exit(c);
Artem Bityutskiy1e517642008-07-14 19:08:37 +03001427 return err;
1428}
1429
1430/**
1431 * ubifs_umount - un-mount UBIFS file-system.
1432 * @c: UBIFS file-system description object
1433 *
1434 * Note, this function is called to free allocated resourced when un-mounting,
1435 * as well as free resources when an error occurred while we were half way
1436 * through mounting (error path cleanup function). So it has to make sure the
1437 * resource was actually allocated before freeing it.
1438 */
1439static void ubifs_umount(struct ubifs_info *c)
1440{
1441 dbg_gen("un-mounting UBI device %d, volume %d", c->vi.ubi_num,
1442 c->vi.vol_id);
1443
Artem Bityutskiy552ff312008-10-23 11:49:28 +03001444 dbg_debugfs_exit_fs(c);
Artem Bityutskiy1e517642008-07-14 19:08:37 +03001445 spin_lock(&ubifs_infos_lock);
1446 list_del(&c->infos_list);
1447 spin_unlock(&ubifs_infos_lock);
1448
1449 if (c->bgt)
1450 kthread_stop(c->bgt);
1451
1452 destroy_journal(c);
1453 free_wbufs(c);
1454 free_orphans(c);
1455 ubifs_lpt_free(c, 0);
1456
1457 kfree(c->cbuf);
1458 kfree(c->rcvrd_mst_node);
1459 kfree(c->mst_node);
Artem Bityutskiy3477d202008-11-19 11:53:15 +02001460 kfree(c->bu.buf);
1461 vfree(c->ileb_buf);
Artem Bityutskiy1e517642008-07-14 19:08:37 +03001462 vfree(c->sbuf);
1463 kfree(c->bottom_up_buf);
Artem Bityutskiy17c2f9f2008-10-17 13:31:39 +03001464 ubifs_debugging_exit(c);
Artem Bityutskiy1e517642008-07-14 19:08:37 +03001465}
1466
1467/**
1468 * ubifs_remount_rw - re-mount in read-write mode.
1469 * @c: UBIFS file-system description object
1470 *
1471 * UBIFS avoids allocating many unnecessary resources when mounted in read-only
1472 * mode. This function allocates the needed resources and re-mounts UBIFS in
1473 * read-write mode.
1474 */
1475static int ubifs_remount_rw(struct ubifs_info *c)
1476{
1477 int err, lnum;
1478
1479 if (c->ro_media)
1480 return -EINVAL;
1481
1482 mutex_lock(&c->umount_mutex);
1483 c->remounting_rw = 1;
Adrian Hunter2953e732008-09-04 16:26:00 +03001484 c->always_chk_crc = 1;
Artem Bityutskiy1e517642008-07-14 19:08:37 +03001485
Artem Bityutskiy57a450e2008-12-30 16:23:34 +02001486 err = check_free_space(c);
1487 if (err)
Artem Bityutskiy1e517642008-07-14 19:08:37 +03001488 goto out;
Artem Bityutskiy1e517642008-07-14 19:08:37 +03001489
1490 if (c->old_leb_cnt != c->leb_cnt) {
1491 struct ubifs_sb_node *sup;
1492
1493 sup = ubifs_read_sb_node(c);
1494 if (IS_ERR(sup)) {
1495 err = PTR_ERR(sup);
1496 goto out;
1497 }
1498 sup->leb_cnt = cpu_to_le32(c->leb_cnt);
1499 err = ubifs_write_sb_node(c, sup);
1500 if (err)
1501 goto out;
1502 }
1503
1504 if (c->need_recovery) {
1505 ubifs_msg("completing deferred recovery");
1506 err = ubifs_write_rcvrd_mst_node(c);
1507 if (err)
1508 goto out;
1509 err = ubifs_recover_size(c);
1510 if (err)
1511 goto out;
1512 err = ubifs_clean_lebs(c, c->sbuf);
1513 if (err)
1514 goto out;
1515 err = ubifs_recover_inl_heads(c, c->sbuf);
1516 if (err)
1517 goto out;
1518 }
1519
1520 if (!(c->mst_node->flags & cpu_to_le32(UBIFS_MST_DIRTY))) {
1521 c->mst_node->flags |= cpu_to_le32(UBIFS_MST_DIRTY);
1522 err = ubifs_write_master(c);
1523 if (err)
1524 goto out;
1525 }
1526
1527 c->ileb_buf = vmalloc(c->leb_size);
1528 if (!c->ileb_buf) {
1529 err = -ENOMEM;
1530 goto out;
1531 }
1532
1533 err = ubifs_lpt_init(c, 0, 1);
1534 if (err)
1535 goto out;
1536
1537 err = alloc_wbufs(c);
1538 if (err)
1539 goto out;
1540
1541 ubifs_create_buds_lists(c);
1542
1543 /* Create background thread */
1544 c->bgt = kthread_create(ubifs_bg_thread, c, c->bgt_name);
Artem Bityutskiy1e517642008-07-14 19:08:37 +03001545 if (IS_ERR(c->bgt)) {
1546 err = PTR_ERR(c->bgt);
1547 c->bgt = NULL;
1548 ubifs_err("cannot spawn \"%s\", error %d",
1549 c->bgt_name, err);
Adrian Hunter2953e732008-09-04 16:26:00 +03001550 goto out;
Artem Bityutskiy1e517642008-07-14 19:08:37 +03001551 }
1552 wake_up_process(c->bgt);
1553
1554 c->orph_buf = vmalloc(c->leb_size);
Adrian Hunter2953e732008-09-04 16:26:00 +03001555 if (!c->orph_buf) {
1556 err = -ENOMEM;
1557 goto out;
1558 }
Artem Bityutskiy1e517642008-07-14 19:08:37 +03001559
1560 /* Check for enough log space */
1561 lnum = c->lhead_lnum + 1;
1562 if (lnum >= UBIFS_LOG_LNUM + c->log_lebs)
1563 lnum = UBIFS_LOG_LNUM;
1564 if (lnum == c->ltail_lnum) {
1565 err = ubifs_consolidate_log(c);
1566 if (err)
1567 goto out;
1568 }
1569
1570 if (c->need_recovery)
1571 err = ubifs_rcvry_gc_commit(c);
1572 else
1573 err = take_gc_lnum(c);
1574 if (err)
1575 goto out;
1576
1577 if (c->need_recovery) {
1578 c->need_recovery = 0;
1579 ubifs_msg("deferred recovery completed");
1580 }
1581
1582 dbg_gen("re-mounted read-write");
1583 c->vfs_sb->s_flags &= ~MS_RDONLY;
1584 c->remounting_rw = 0;
Adrian Hunter2953e732008-09-04 16:26:00 +03001585 c->always_chk_crc = 0;
Artem Bityutskiy1e517642008-07-14 19:08:37 +03001586 mutex_unlock(&c->umount_mutex);
1587 return 0;
1588
1589out:
1590 vfree(c->orph_buf);
1591 c->orph_buf = NULL;
1592 if (c->bgt) {
1593 kthread_stop(c->bgt);
1594 c->bgt = NULL;
1595 }
1596 free_wbufs(c);
1597 vfree(c->ileb_buf);
1598 c->ileb_buf = NULL;
1599 ubifs_lpt_free(c, 1);
1600 c->remounting_rw = 0;
Adrian Hunter2953e732008-09-04 16:26:00 +03001601 c->always_chk_crc = 0;
Artem Bityutskiy1e517642008-07-14 19:08:37 +03001602 mutex_unlock(&c->umount_mutex);
1603 return err;
1604}
1605
1606/**
1607 * commit_on_unmount - commit the journal when un-mounting.
1608 * @c: UBIFS file-system description object
1609 *
Artem Bityutskiyaf2eb562008-09-09 12:23:50 +03001610 * This function is called during un-mounting and re-mounting, and it commits
Artem Bityutskiy26d05772008-12-28 09:11:02 +02001611 * the journal unless the "fast unmount" mode is enabled.
Artem Bityutskiy1e517642008-07-14 19:08:37 +03001612 */
1613static void commit_on_unmount(struct ubifs_info *c)
1614{
Artem Bityutskiy26d05772008-12-28 09:11:02 +02001615 struct super_block *sb = c->vfs_sb;
1616 long long bud_bytes;
Artem Bityutskiy1e517642008-07-14 19:08:37 +03001617
Artem Bityutskiy26d05772008-12-28 09:11:02 +02001618 /*
1619 * This function is called before the background thread is stopped, so
1620 * we may race with ongoing commit, which means we have to take
1621 * @c->bud_lock to access @c->bud_bytes.
1622 */
1623 spin_lock(&c->buds_lock);
1624 bud_bytes = c->bud_bytes;
1625 spin_unlock(&c->buds_lock);
1626
1627 if (!c->fast_unmount && !(sb->s_flags & MS_RDONLY) && bud_bytes)
1628 ubifs_run_commit(c);
Artem Bityutskiy1e517642008-07-14 19:08:37 +03001629}
1630
1631/**
1632 * ubifs_remount_ro - re-mount in read-only mode.
1633 * @c: UBIFS file-system description object
1634 *
1635 * We rely on VFS to have stopped writing. Possibly the background thread could
1636 * be running a commit, however kthread_stop will wait in that case.
1637 */
1638static void ubifs_remount_ro(struct ubifs_info *c)
1639{
1640 int i, err;
1641
1642 ubifs_assert(!c->need_recovery);
1643 commit_on_unmount(c);
1644
1645 mutex_lock(&c->umount_mutex);
1646 if (c->bgt) {
1647 kthread_stop(c->bgt);
1648 c->bgt = NULL;
1649 }
1650
1651 for (i = 0; i < c->jhead_cnt; i++) {
1652 ubifs_wbuf_sync(&c->jheads[i].wbuf);
1653 del_timer_sync(&c->jheads[i].wbuf.timer);
1654 }
1655
1656 if (!c->ro_media) {
1657 c->mst_node->flags &= ~cpu_to_le32(UBIFS_MST_DIRTY);
1658 c->mst_node->flags |= cpu_to_le32(UBIFS_MST_NO_ORPHS);
1659 c->mst_node->gc_lnum = cpu_to_le32(c->gc_lnum);
1660 err = ubifs_write_master(c);
1661 if (err)
1662 ubifs_ro_mode(c, err);
1663 }
1664
1665 ubifs_destroy_idx_gc(c);
1666 free_wbufs(c);
1667 vfree(c->orph_buf);
1668 c->orph_buf = NULL;
1669 vfree(c->ileb_buf);
1670 c->ileb_buf = NULL;
1671 ubifs_lpt_free(c, 1);
1672 mutex_unlock(&c->umount_mutex);
1673}
1674
1675static void ubifs_put_super(struct super_block *sb)
1676{
1677 int i;
1678 struct ubifs_info *c = sb->s_fs_info;
1679
1680 ubifs_msg("un-mount UBI device %d, volume %d", c->vi.ubi_num,
1681 c->vi.vol_id);
1682 /*
1683 * The following asserts are only valid if there has not been a failure
1684 * of the media. For example, there will be dirty inodes if we failed
1685 * to write them back because of I/O errors.
1686 */
1687 ubifs_assert(atomic_long_read(&c->dirty_pg_cnt) == 0);
1688 ubifs_assert(c->budg_idx_growth == 0);
Artem Bityutskiy7d32c2b2008-07-18 18:54:29 +03001689 ubifs_assert(c->budg_dd_growth == 0);
Artem Bityutskiy1e517642008-07-14 19:08:37 +03001690 ubifs_assert(c->budg_data_growth == 0);
1691
1692 /*
1693 * The 'c->umount_lock' prevents races between UBIFS memory shrinker
1694 * and file system un-mount. Namely, it prevents the shrinker from
1695 * picking this superblock for shrinking - it will be just skipped if
1696 * the mutex is locked.
1697 */
1698 mutex_lock(&c->umount_mutex);
1699 if (!(c->vfs_sb->s_flags & MS_RDONLY)) {
1700 /*
1701 * First of all kill the background thread to make sure it does
1702 * not interfere with un-mounting and freeing resources.
1703 */
1704 if (c->bgt) {
1705 kthread_stop(c->bgt);
1706 c->bgt = NULL;
1707 }
1708
1709 /* Synchronize write-buffers */
1710 if (c->jheads)
1711 for (i = 0; i < c->jhead_cnt; i++) {
1712 ubifs_wbuf_sync(&c->jheads[i].wbuf);
1713 del_timer_sync(&c->jheads[i].wbuf.timer);
1714 }
1715
1716 /*
1717 * On fatal errors c->ro_media is set to 1, in which case we do
1718 * not write the master node.
1719 */
1720 if (!c->ro_media) {
1721 /*
1722 * We are being cleanly unmounted which means the
1723 * orphans were killed - indicate this in the master
1724 * node. Also save the reserved GC LEB number.
1725 */
1726 int err;
1727
1728 c->mst_node->flags &= ~cpu_to_le32(UBIFS_MST_DIRTY);
1729 c->mst_node->flags |= cpu_to_le32(UBIFS_MST_NO_ORPHS);
1730 c->mst_node->gc_lnum = cpu_to_le32(c->gc_lnum);
1731 err = ubifs_write_master(c);
1732 if (err)
1733 /*
1734 * Recovery will attempt to fix the master area
1735 * next mount, so we just print a message and
1736 * continue to unmount normally.
1737 */
1738 ubifs_err("failed to write master node, "
1739 "error %d", err);
1740 }
1741 }
1742
1743 ubifs_umount(c);
1744 bdi_destroy(&c->bdi);
1745 ubi_close_volume(c->ubi);
1746 mutex_unlock(&c->umount_mutex);
1747 kfree(c);
1748}
1749
1750static int ubifs_remount_fs(struct super_block *sb, int *flags, char *data)
1751{
1752 int err;
1753 struct ubifs_info *c = sb->s_fs_info;
1754
1755 dbg_gen("old flags %#lx, new flags %#x", sb->s_flags, *flags);
1756
1757 err = ubifs_parse_options(c, data, 1);
1758 if (err) {
1759 ubifs_err("invalid or unknown remount parameter");
1760 return err;
1761 }
Artem Bityutskiy3477d202008-11-19 11:53:15 +02001762
Artem Bityutskiy1e517642008-07-14 19:08:37 +03001763 if ((sb->s_flags & MS_RDONLY) && !(*flags & MS_RDONLY)) {
1764 err = ubifs_remount_rw(c);
1765 if (err)
1766 return err;
1767 } else if (!(sb->s_flags & MS_RDONLY) && (*flags & MS_RDONLY))
1768 ubifs_remount_ro(c);
1769
Artem Bityutskiy3477d202008-11-19 11:53:15 +02001770 if (c->bulk_read == 1)
1771 bu_init(c);
1772 else {
1773 dbg_gen("disable bulk-read");
1774 kfree(c->bu.buf);
1775 c->bu.buf = NULL;
1776 }
1777
Artem Bityutskiy1e517642008-07-14 19:08:37 +03001778 return 0;
1779}
1780
Artem Bityutskiye8b81562009-01-15 17:43:23 +02001781const struct super_operations ubifs_super_operations = {
Artem Bityutskiy1e517642008-07-14 19:08:37 +03001782 .alloc_inode = ubifs_alloc_inode,
1783 .destroy_inode = ubifs_destroy_inode,
1784 .put_super = ubifs_put_super,
1785 .write_inode = ubifs_write_inode,
1786 .delete_inode = ubifs_delete_inode,
1787 .statfs = ubifs_statfs,
1788 .dirty_inode = ubifs_dirty_inode,
1789 .remount_fs = ubifs_remount_fs,
1790 .show_options = ubifs_show_options,
1791 .sync_fs = ubifs_sync_fs,
1792};
1793
1794/**
1795 * open_ubi - parse UBI device name string and open the UBI device.
1796 * @name: UBI volume name
1797 * @mode: UBI volume open mode
1798 *
1799 * There are several ways to specify UBI volumes when mounting UBIFS:
1800 * o ubiX_Y - UBI device number X, volume Y;
1801 * o ubiY - UBI device number 0, volume Y;
1802 * o ubiX:NAME - mount UBI device X, volume with name NAME;
1803 * o ubi:NAME - mount UBI device 0, volume with name NAME.
1804 *
1805 * Alternative '!' separator may be used instead of ':' (because some shells
1806 * like busybox may interpret ':' as an NFS host name separator). This function
1807 * returns ubi volume object in case of success and a negative error code in
1808 * case of failure.
1809 */
1810static struct ubi_volume_desc *open_ubi(const char *name, int mode)
1811{
1812 int dev, vol;
1813 char *endptr;
1814
1815 if (name[0] != 'u' || name[1] != 'b' || name[2] != 'i')
1816 return ERR_PTR(-EINVAL);
1817
1818 /* ubi:NAME method */
1819 if ((name[3] == ':' || name[3] == '!') && name[4] != '\0')
1820 return ubi_open_volume_nm(0, name + 4, mode);
1821
1822 if (!isdigit(name[3]))
1823 return ERR_PTR(-EINVAL);
1824
1825 dev = simple_strtoul(name + 3, &endptr, 0);
1826
1827 /* ubiY method */
1828 if (*endptr == '\0')
1829 return ubi_open_volume(0, dev, mode);
1830
1831 /* ubiX_Y method */
1832 if (*endptr == '_' && isdigit(endptr[1])) {
1833 vol = simple_strtoul(endptr + 1, &endptr, 0);
1834 if (*endptr != '\0')
1835 return ERR_PTR(-EINVAL);
1836 return ubi_open_volume(dev, vol, mode);
1837 }
1838
1839 /* ubiX:NAME method */
1840 if ((*endptr == ':' || *endptr == '!') && endptr[1] != '\0')
1841 return ubi_open_volume_nm(dev, ++endptr, mode);
1842
1843 return ERR_PTR(-EINVAL);
1844}
1845
1846static int ubifs_fill_super(struct super_block *sb, void *data, int silent)
1847{
1848 struct ubi_volume_desc *ubi = sb->s_fs_info;
1849 struct ubifs_info *c;
1850 struct inode *root;
1851 int err;
1852
1853 c = kzalloc(sizeof(struct ubifs_info), GFP_KERNEL);
1854 if (!c)
1855 return -ENOMEM;
1856
1857 spin_lock_init(&c->cnt_lock);
1858 spin_lock_init(&c->cs_lock);
1859 spin_lock_init(&c->buds_lock);
1860 spin_lock_init(&c->space_lock);
1861 spin_lock_init(&c->orphan_lock);
1862 init_rwsem(&c->commit_sem);
1863 mutex_init(&c->lp_mutex);
1864 mutex_init(&c->tnc_mutex);
1865 mutex_init(&c->log_mutex);
1866 mutex_init(&c->mst_mutex);
1867 mutex_init(&c->umount_mutex);
Artem Bityutskiy3477d202008-11-19 11:53:15 +02001868 mutex_init(&c->bu_mutex);
Artem Bityutskiy1e517642008-07-14 19:08:37 +03001869 init_waitqueue_head(&c->cmt_wq);
1870 c->buds = RB_ROOT;
1871 c->old_idx = RB_ROOT;
1872 c->size_tree = RB_ROOT;
1873 c->orph_tree = RB_ROOT;
1874 INIT_LIST_HEAD(&c->infos_list);
1875 INIT_LIST_HEAD(&c->idx_gc);
1876 INIT_LIST_HEAD(&c->replay_list);
1877 INIT_LIST_HEAD(&c->replay_buds);
1878 INIT_LIST_HEAD(&c->uncat_list);
1879 INIT_LIST_HEAD(&c->empty_list);
1880 INIT_LIST_HEAD(&c->freeable_list);
1881 INIT_LIST_HEAD(&c->frdi_idx_list);
1882 INIT_LIST_HEAD(&c->unclean_leb_list);
1883 INIT_LIST_HEAD(&c->old_buds);
1884 INIT_LIST_HEAD(&c->orph_list);
1885 INIT_LIST_HEAD(&c->orph_new);
1886
1887 c->highest_inum = UBIFS_FIRST_INO;
Artem Bityutskiy1e517642008-07-14 19:08:37 +03001888 c->lhead_lnum = c->ltail_lnum = UBIFS_LOG_LNUM;
1889
1890 ubi_get_volume_info(ubi, &c->vi);
1891 ubi_get_device_info(c->vi.ubi_num, &c->di);
1892
1893 /* Re-open the UBI device in read-write mode */
1894 c->ubi = ubi_open_volume(c->vi.ubi_num, c->vi.vol_id, UBI_READWRITE);
1895 if (IS_ERR(c->ubi)) {
1896 err = PTR_ERR(c->ubi);
1897 goto out_free;
1898 }
1899
1900 /*
Artem Bityutskiy0a883a02008-08-13 14:13:26 +03001901 * UBIFS provides 'backing_dev_info' in order to disable read-ahead. For
Artem Bityutskiy1e517642008-07-14 19:08:37 +03001902 * UBIFS, I/O is not deferred, it is done immediately in readpage,
1903 * which means the user would have to wait not just for their own I/O
Artem Bityutskiy0a883a02008-08-13 14:13:26 +03001904 * but the read-ahead I/O as well i.e. completely pointless.
Artem Bityutskiy1e517642008-07-14 19:08:37 +03001905 *
1906 * Read-ahead will be disabled because @c->bdi.ra_pages is 0.
1907 */
1908 c->bdi.capabilities = BDI_CAP_MAP_COPY;
1909 c->bdi.unplug_io_fn = default_unplug_io_fn;
1910 err = bdi_init(&c->bdi);
1911 if (err)
1912 goto out_close;
1913
1914 err = ubifs_parse_options(c, data, 0);
1915 if (err)
1916 goto out_bdi;
1917
1918 c->vfs_sb = sb;
1919
1920 sb->s_fs_info = c;
1921 sb->s_magic = UBIFS_SUPER_MAGIC;
1922 sb->s_blocksize = UBIFS_BLOCK_SIZE;
1923 sb->s_blocksize_bits = UBIFS_BLOCK_SHIFT;
1924 sb->s_dev = c->vi.cdev;
1925 sb->s_maxbytes = c->max_inode_sz = key_max_inode_size(c);
1926 if (c->max_inode_sz > MAX_LFS_FILESIZE)
1927 sb->s_maxbytes = c->max_inode_sz = MAX_LFS_FILESIZE;
1928 sb->s_op = &ubifs_super_operations;
1929
1930 mutex_lock(&c->umount_mutex);
1931 err = mount_ubifs(c);
1932 if (err) {
1933 ubifs_assert(err < 0);
1934 goto out_unlock;
1935 }
1936
1937 /* Read the root inode */
1938 root = ubifs_iget(sb, UBIFS_ROOT_INO);
1939 if (IS_ERR(root)) {
1940 err = PTR_ERR(root);
1941 goto out_umount;
1942 }
1943
1944 sb->s_root = d_alloc_root(root);
1945 if (!sb->s_root)
1946 goto out_iput;
1947
1948 mutex_unlock(&c->umount_mutex);
Artem Bityutskiy1e517642008-07-14 19:08:37 +03001949 return 0;
1950
1951out_iput:
1952 iput(root);
1953out_umount:
1954 ubifs_umount(c);
1955out_unlock:
1956 mutex_unlock(&c->umount_mutex);
1957out_bdi:
1958 bdi_destroy(&c->bdi);
1959out_close:
1960 ubi_close_volume(c->ubi);
1961out_free:
1962 kfree(c);
1963 return err;
1964}
1965
1966static int sb_test(struct super_block *sb, void *data)
1967{
1968 dev_t *dev = data;
1969
1970 return sb->s_dev == *dev;
1971}
1972
1973static int sb_set(struct super_block *sb, void *data)
1974{
1975 dev_t *dev = data;
1976
1977 sb->s_dev = *dev;
1978 return 0;
1979}
1980
1981static int ubifs_get_sb(struct file_system_type *fs_type, int flags,
1982 const char *name, void *data, struct vfsmount *mnt)
1983{
1984 struct ubi_volume_desc *ubi;
1985 struct ubi_volume_info vi;
1986 struct super_block *sb;
1987 int err;
1988
1989 dbg_gen("name %s, flags %#x", name, flags);
1990
1991 /*
1992 * Get UBI device number and volume ID. Mount it read-only so far
1993 * because this might be a new mount point, and UBI allows only one
1994 * read-write user at a time.
1995 */
1996 ubi = open_ubi(name, UBI_READONLY);
1997 if (IS_ERR(ubi)) {
1998 ubifs_err("cannot open \"%s\", error %d",
1999 name, (int)PTR_ERR(ubi));
2000 return PTR_ERR(ubi);
2001 }
2002 ubi_get_volume_info(ubi, &vi);
2003
2004 dbg_gen("opened ubi%d_%d", vi.ubi_num, vi.vol_id);
2005
2006 sb = sget(fs_type, &sb_test, &sb_set, &vi.cdev);
2007 if (IS_ERR(sb)) {
2008 err = PTR_ERR(sb);
2009 goto out_close;
2010 }
2011
2012 if (sb->s_root) {
2013 /* A new mount point for already mounted UBIFS */
2014 dbg_gen("this ubi volume is already mounted");
2015 if ((flags ^ sb->s_flags) & MS_RDONLY) {
2016 err = -EBUSY;
2017 goto out_deact;
2018 }
2019 } else {
2020 sb->s_flags = flags;
2021 /*
2022 * Pass 'ubi' to 'fill_super()' in sb->s_fs_info where it is
2023 * replaced by 'c'.
2024 */
2025 sb->s_fs_info = ubi;
2026 err = ubifs_fill_super(sb, data, flags & MS_SILENT ? 1 : 0);
2027 if (err)
2028 goto out_deact;
2029 /* We do not support atime */
2030 sb->s_flags |= MS_ACTIVE | MS_NOATIME;
2031 }
2032
2033 /* 'fill_super()' opens ubi again so we must close it here */
2034 ubi_close_volume(ubi);
2035
2036 return simple_set_mnt(mnt, sb);
2037
2038out_deact:
2039 up_write(&sb->s_umount);
2040 deactivate_super(sb);
2041out_close:
2042 ubi_close_volume(ubi);
2043 return err;
2044}
2045
2046static void ubifs_kill_sb(struct super_block *sb)
2047{
2048 struct ubifs_info *c = sb->s_fs_info;
2049
2050 /*
2051 * We do 'commit_on_unmount()' here instead of 'ubifs_put_super()'
2052 * in order to be outside BKL.
2053 */
Artem Bityutskiy26d05772008-12-28 09:11:02 +02002054 if (sb->s_root)
Artem Bityutskiy1e517642008-07-14 19:08:37 +03002055 commit_on_unmount(c);
2056 /* The un-mount routine is actually done in put_super() */
2057 generic_shutdown_super(sb);
2058}
2059
2060static struct file_system_type ubifs_fs_type = {
2061 .name = "ubifs",
2062 .owner = THIS_MODULE,
2063 .get_sb = ubifs_get_sb,
2064 .kill_sb = ubifs_kill_sb
2065};
2066
2067/*
2068 * Inode slab cache constructor.
2069 */
Alexey Dobriyan51cc5062008-07-25 19:45:34 -07002070static void inode_slab_ctor(void *obj)
Artem Bityutskiy1e517642008-07-14 19:08:37 +03002071{
2072 struct ubifs_inode *ui = obj;
2073 inode_init_once(&ui->vfs_inode);
2074}
2075
2076static int __init ubifs_init(void)
2077{
2078 int err;
2079
2080 BUILD_BUG_ON(sizeof(struct ubifs_ch) != 24);
2081
2082 /* Make sure node sizes are 8-byte aligned */
2083 BUILD_BUG_ON(UBIFS_CH_SZ & 7);
2084 BUILD_BUG_ON(UBIFS_INO_NODE_SZ & 7);
2085 BUILD_BUG_ON(UBIFS_DENT_NODE_SZ & 7);
2086 BUILD_BUG_ON(UBIFS_XENT_NODE_SZ & 7);
2087 BUILD_BUG_ON(UBIFS_DATA_NODE_SZ & 7);
2088 BUILD_BUG_ON(UBIFS_TRUN_NODE_SZ & 7);
2089 BUILD_BUG_ON(UBIFS_SB_NODE_SZ & 7);
2090 BUILD_BUG_ON(UBIFS_MST_NODE_SZ & 7);
2091 BUILD_BUG_ON(UBIFS_REF_NODE_SZ & 7);
2092 BUILD_BUG_ON(UBIFS_CS_NODE_SZ & 7);
2093 BUILD_BUG_ON(UBIFS_ORPH_NODE_SZ & 7);
2094
2095 BUILD_BUG_ON(UBIFS_MAX_DENT_NODE_SZ & 7);
2096 BUILD_BUG_ON(UBIFS_MAX_XENT_NODE_SZ & 7);
2097 BUILD_BUG_ON(UBIFS_MAX_DATA_NODE_SZ & 7);
2098 BUILD_BUG_ON(UBIFS_MAX_INO_NODE_SZ & 7);
2099 BUILD_BUG_ON(UBIFS_MAX_NODE_SZ & 7);
2100 BUILD_BUG_ON(MIN_WRITE_SZ & 7);
2101
2102 /* Check min. node size */
2103 BUILD_BUG_ON(UBIFS_INO_NODE_SZ < MIN_WRITE_SZ);
2104 BUILD_BUG_ON(UBIFS_DENT_NODE_SZ < MIN_WRITE_SZ);
2105 BUILD_BUG_ON(UBIFS_XENT_NODE_SZ < MIN_WRITE_SZ);
2106 BUILD_BUG_ON(UBIFS_TRUN_NODE_SZ < MIN_WRITE_SZ);
2107
2108 BUILD_BUG_ON(UBIFS_MAX_DENT_NODE_SZ > UBIFS_MAX_NODE_SZ);
2109 BUILD_BUG_ON(UBIFS_MAX_XENT_NODE_SZ > UBIFS_MAX_NODE_SZ);
2110 BUILD_BUG_ON(UBIFS_MAX_DATA_NODE_SZ > UBIFS_MAX_NODE_SZ);
2111 BUILD_BUG_ON(UBIFS_MAX_INO_NODE_SZ > UBIFS_MAX_NODE_SZ);
2112
2113 /* Defined node sizes */
2114 BUILD_BUG_ON(UBIFS_SB_NODE_SZ != 4096);
2115 BUILD_BUG_ON(UBIFS_MST_NODE_SZ != 512);
2116 BUILD_BUG_ON(UBIFS_INO_NODE_SZ != 160);
2117 BUILD_BUG_ON(UBIFS_REF_NODE_SZ != 64);
2118
2119 /*
Artem Bityutskiya1dc080c22008-11-01 14:20:50 +02002120 * We use 2 bit wide bit-fields to store compression type, which should
2121 * be amended if more compressors are added. The bit-fields are:
Artem Bityutskiy553dea42008-11-01 14:57:49 +02002122 * @compr_type in 'struct ubifs_inode', @default_compr in
2123 * 'struct ubifs_info' and @compr_type in 'struct ubifs_mount_opts'.
Artem Bityutskiya1dc080c22008-11-01 14:20:50 +02002124 */
2125 BUILD_BUG_ON(UBIFS_COMPR_TYPES_CNT > 4);
2126
2127 /*
Artem Bityutskiy1e517642008-07-14 19:08:37 +03002128 * We require that PAGE_CACHE_SIZE is greater-than-or-equal-to
2129 * UBIFS_BLOCK_SIZE. It is assumed that both are powers of 2.
2130 */
2131 if (PAGE_CACHE_SIZE < UBIFS_BLOCK_SIZE) {
2132 ubifs_err("VFS page cache size is %u bytes, but UBIFS requires"
2133 " at least 4096 bytes",
2134 (unsigned int)PAGE_CACHE_SIZE);
2135 return -EINVAL;
2136 }
2137
2138 err = register_filesystem(&ubifs_fs_type);
2139 if (err) {
2140 ubifs_err("cannot register file system, error %d", err);
2141 return err;
2142 }
2143
2144 err = -ENOMEM;
2145 ubifs_inode_slab = kmem_cache_create("ubifs_inode_slab",
2146 sizeof(struct ubifs_inode), 0,
2147 SLAB_MEM_SPREAD | SLAB_RECLAIM_ACCOUNT,
2148 &inode_slab_ctor);
2149 if (!ubifs_inode_slab)
2150 goto out_reg;
2151
2152 register_shrinker(&ubifs_shrinker_info);
2153
2154 err = ubifs_compressors_init();
2155 if (err)
Artem Bityutskiy552ff312008-10-23 11:49:28 +03002156 goto out_shrinker;
2157
2158 err = dbg_debugfs_init();
2159 if (err)
Artem Bityutskiy1e517642008-07-14 19:08:37 +03002160 goto out_compr;
2161
2162 return 0;
2163
2164out_compr:
Artem Bityutskiy552ff312008-10-23 11:49:28 +03002165 ubifs_compressors_exit();
2166out_shrinker:
Artem Bityutskiy1e517642008-07-14 19:08:37 +03002167 unregister_shrinker(&ubifs_shrinker_info);
2168 kmem_cache_destroy(ubifs_inode_slab);
2169out_reg:
2170 unregister_filesystem(&ubifs_fs_type);
2171 return err;
2172}
2173/* late_initcall to let compressors initialize first */
2174late_initcall(ubifs_init);
2175
2176static void __exit ubifs_exit(void)
2177{
2178 ubifs_assert(list_empty(&ubifs_infos));
2179 ubifs_assert(atomic_long_read(&ubifs_clean_zn_cnt) == 0);
2180
Artem Bityutskiy552ff312008-10-23 11:49:28 +03002181 dbg_debugfs_exit();
Artem Bityutskiy1e517642008-07-14 19:08:37 +03002182 ubifs_compressors_exit();
2183 unregister_shrinker(&ubifs_shrinker_info);
2184 kmem_cache_destroy(ubifs_inode_slab);
2185 unregister_filesystem(&ubifs_fs_type);
2186}
2187module_exit(ubifs_exit);
2188
2189MODULE_LICENSE("GPL");
2190MODULE_VERSION(__stringify(UBIFS_VERSION));
2191MODULE_AUTHOR("Artem Bityutskiy, Adrian Hunter");
2192MODULE_DESCRIPTION("UBIFS - UBI File System");