1/* SPDX-License-Identifier: GPL-2.0-only */
2/*
3 * This file is part of UBIFS.
4 *
5 * Copyright (C) 2006-2008 Nokia Corporation
6 *
7 * Authors: Artem Bityutskiy (Битюцкий Артём)
8 * Adrian Hunter
9 */
10
11#ifndef __UBIFS_H__
12#define __UBIFS_H__
13
14#include <asm/div64.h>
15#include <linux/statfs.h>
16#include <linux/fs.h>
17#include <linux/err.h>
18#include <linux/sched.h>
19#include <linux/slab.h>
20#include <linux/vmalloc.h>
21#include <linux/spinlock.h>
22#include <linux/mutex.h>
23#include <linux/rwsem.h>
24#include <linux/mtd/ubi.h>
25#include <linux/pagemap.h>
26#include <linux/backing-dev.h>
27#include <linux/security.h>
28#include <linux/xattr.h>
29#include <linux/random.h>
30#include <linux/sysfs.h>
31#include <linux/completion.h>
32#include <crypto/hash_info.h>
33#include <crypto/hash.h>
34#include <crypto/utils.h>
35
36#include <linux/fscrypt.h>
37
38#include "ubifs-media.h"
39
40/* Version of this UBIFS implementation */
41#define UBIFS_VERSION 1
42
43/* UBIFS file system VFS magic number */
44#define UBIFS_SUPER_MAGIC 0x24051905
45
46/* Number of UBIFS blocks per VFS page */
47#define UBIFS_BLOCKS_PER_PAGE (PAGE_SIZE / UBIFS_BLOCK_SIZE)
48#define UBIFS_BLOCKS_PER_PAGE_SHIFT (PAGE_SHIFT - UBIFS_BLOCK_SHIFT)
49
50/* "File system end of life" sequence number watermark */
51#define SQNUM_WARN_WATERMARK 0xFFFFFFFF00000000ULL
52#define SQNUM_WATERMARK 0xFFFFFFFFFF000000ULL
53
54/*
55 * Minimum amount of LEBs reserved for the index. At present the index needs at
56 * least 2 LEBs: one for the index head and one for in-the-gaps method (which
57 * currently does not cater for the index head and so excludes it from
58 * consideration).
59 */
60#define MIN_INDEX_LEBS 2
61
62/* Minimum amount of data UBIFS writes to the flash */
63#define MIN_WRITE_SZ (UBIFS_DATA_NODE_SZ + 8)
64
65/*
66 * Currently we do not support inode number overlapping and re-using, so this
67 * watermark defines dangerous inode number level. This should be fixed later,
68 * although it is difficult to exceed current limit. Another option is to use
69 * 64-bit inode numbers, but this means more overhead.
70 */
71#define INUM_WARN_WATERMARK 0xFFF00000
72#define INUM_WATERMARK 0xFFFFFF00
73
74/* Maximum number of entries in each LPT (LEB category) heap */
75#define LPT_HEAP_SZ 256
76
77/*
78 * Background thread name pattern. The numbers are UBI device and volume
79 * numbers.
80 */
81#define BGT_NAME_PATTERN "ubifs_bgt%d_%d"
82
83/* Maximum possible inode number (only 32-bit inodes are supported now) */
84#define MAX_INUM 0xFFFFFFFF
85
86/* Number of non-data journal heads */
87#define NONDATA_JHEADS_CNT 2
88
89/* Shorter names for journal head numbers for internal usage */
90#define GCHD UBIFS_GC_HEAD
91#define BASEHD UBIFS_BASE_HEAD
92#define DATAHD UBIFS_DATA_HEAD
93
94/* 'No change' value for 'ubifs_change_lp()' */
95#define LPROPS_NC 0x80000001
96
97/*
98 * There is no notion of truncation key because truncation nodes do not exist
99 * in TNC. However, when replaying, it is handy to introduce fake "truncation"
100 * keys for truncation nodes because the code becomes simpler. So we define
101 * %UBIFS_TRUN_KEY type.
102 *
103 * But otherwise, out of the journal reply scope, the truncation keys are
104 * invalid.
105 */
106#define UBIFS_TRUN_KEY UBIFS_KEY_TYPES_CNT
107#define UBIFS_INVALID_KEY UBIFS_KEY_TYPES_CNT
108
109/*
110 * How much a directory entry/extended attribute entry adds to the parent/host
111 * inode.
112 */
113#define CALC_DENT_SIZE(name_len) ALIGN(UBIFS_DENT_NODE_SZ + (name_len) + 1, 8)
114
115/* How much an extended attribute adds to the host inode */
116#define CALC_XATTR_BYTES(data_len) ALIGN(UBIFS_INO_NODE_SZ + (data_len) + 1, 8)
117
118/*
119 * Znodes which were not touched for 'OLD_ZNODE_AGE' seconds are considered
120 * "old", and znode which were touched last 'YOUNG_ZNODE_AGE' seconds ago are
121 * considered "young". This is used by shrinker when selecting znode to trim
122 * off.
123 */
124#define OLD_ZNODE_AGE 20
125#define YOUNG_ZNODE_AGE 5
126
127/*
128 * Some compressors, like LZO, may end up with more data then the input buffer.
129 * So UBIFS always allocates larger output buffer, to be sure the compressor
130 * will not corrupt memory in case of worst case compression.
131 */
132#define WORST_COMPR_FACTOR 2
133
134#ifdef CONFIG_FS_ENCRYPTION
135#define UBIFS_CIPHER_BLOCK_SIZE FSCRYPT_CONTENTS_ALIGNMENT
136#else
137#define UBIFS_CIPHER_BLOCK_SIZE 0
138#endif
139
140/*
141 * How much memory is needed for a buffer where we compress a data node.
142 */
143#define COMPRESSED_DATA_NODE_BUF_SZ \
144 (UBIFS_DATA_NODE_SZ + UBIFS_BLOCK_SIZE * WORST_COMPR_FACTOR)
145
146/* Maximum expected tree height for use by bottom_up_buf */
147#define BOTTOM_UP_HEIGHT 64
148
149/* Maximum number of data nodes to bulk-read */
150#define UBIFS_MAX_BULK_READ 32
151
152#ifdef CONFIG_UBIFS_FS_AUTHENTICATION
153#define UBIFS_HASH_ARR_SZ UBIFS_MAX_HASH_LEN
154#define UBIFS_HMAC_ARR_SZ UBIFS_MAX_HMAC_LEN
155#else
156#define UBIFS_HASH_ARR_SZ 0
157#define UBIFS_HMAC_ARR_SZ 0
158#endif
159
160/*
161 * The UBIFS sysfs directory name pattern and maximum name length (3 for "ubi"
162 * + 1 for "_" and plus 2x2 for 2 UBI numbers and 1 for the trailing zero byte.
163 */
164#define UBIFS_DFS_DIR_NAME "ubi%d_%d"
165#define UBIFS_DFS_DIR_LEN (3 + 1 + 2*2 + 1)
166
167/*
168 * Lockdep classes for UBIFS inode @ui_mutex.
169 */
170enum {
171 WB_MUTEX_1 = 0,
172 WB_MUTEX_2 = 1,
173 WB_MUTEX_3 = 2,
174 WB_MUTEX_4 = 3,
175};
176
177/*
178 * Znode flags (actually, bit numbers which store the flags).
179 *
180 * DIRTY_ZNODE: znode is dirty
181 * COW_ZNODE: znode is being committed and a new instance of this znode has to
182 * be created before changing this znode
183 * OBSOLETE_ZNODE: znode is obsolete, which means it was deleted, but it is
184 * still in the commit list and the ongoing commit operation
185 * will commit it, and delete this znode after it is done
186 */
187enum {
188 DIRTY_ZNODE = 0,
189 COW_ZNODE = 1,
190 OBSOLETE_ZNODE = 2,
191};
192
193/*
194 * Commit states.
195 *
196 * COMMIT_RESTING: commit is not wanted
197 * COMMIT_BACKGROUND: background commit has been requested
198 * COMMIT_REQUIRED: commit is required
199 * COMMIT_RUNNING_BACKGROUND: background commit is running
200 * COMMIT_RUNNING_REQUIRED: commit is running and it is required
201 * COMMIT_BROKEN: commit failed
202 */
203enum {
204 COMMIT_RESTING = 0,
205 COMMIT_BACKGROUND,
206 COMMIT_REQUIRED,
207 COMMIT_RUNNING_BACKGROUND,
208 COMMIT_RUNNING_REQUIRED,
209 COMMIT_BROKEN,
210};
211
212/*
213 * 'ubifs_scan_a_node()' return values.
214 *
215 * SCANNED_GARBAGE: scanned garbage
216 * SCANNED_EMPTY_SPACE: scanned empty space
217 * SCANNED_A_NODE: scanned a valid node
218 * SCANNED_A_CORRUPT_NODE: scanned a corrupted node
219 * SCANNED_A_BAD_PAD_NODE: scanned a padding node with invalid pad length
220 *
221 * Greater than zero means: 'scanned that number of padding bytes'
222 */
223enum {
224 SCANNED_GARBAGE = 0,
225 SCANNED_EMPTY_SPACE = -1,
226 SCANNED_A_NODE = -2,
227 SCANNED_A_CORRUPT_NODE = -3,
228 SCANNED_A_BAD_PAD_NODE = -4,
229};
230
231/*
232 * LPT cnode flag bits.
233 *
234 * DIRTY_CNODE: cnode is dirty
235 * OBSOLETE_CNODE: cnode is being committed and has been copied (or deleted),
236 * so it can (and must) be freed when the commit is finished
237 * COW_CNODE: cnode is being committed and must be copied before writing
238 */
239enum {
240 DIRTY_CNODE = 0,
241 OBSOLETE_CNODE = 1,
242 COW_CNODE = 2,
243};
244
245/*
246 * Dirty flag bits (lpt_drty_flgs) for LPT special nodes.
247 *
248 * LTAB_DIRTY: ltab node is dirty
249 * LSAVE_DIRTY: lsave node is dirty
250 */
251enum {
252 LTAB_DIRTY = 1,
253 LSAVE_DIRTY = 2,
254};
255
256/*
257 * Return codes used by the garbage collector.
258 * @LEB_FREED: the logical eraseblock was freed and is ready to use
259 * @LEB_FREED_IDX: indexing LEB was freed and can be used only after the commit
260 * @LEB_RETAINED: the logical eraseblock was freed and retained for GC purposes
261 */
262enum {
263 LEB_FREED,
264 LEB_FREED_IDX,
265 LEB_RETAINED,
266};
267
268/*
269 * Action taken upon a failed ubifs_assert().
270 * @ASSACT_REPORT: just report the failed assertion
271 * @ASSACT_RO: switch to read-only mode
272 * @ASSACT_PANIC: call BUG() and possible panic the kernel
273 */
274enum {
275 ASSACT_REPORT = 0,
276 ASSACT_RO,
277 ASSACT_PANIC,
278};
279
280/**
281 * struct ubifs_old_idx - index node obsoleted since last commit start.
282 * @rb: rb-tree node
283 * @lnum: LEB number of obsoleted index node
284 * @offs: offset of obsoleted index node
285 */
286struct ubifs_old_idx {
287 struct rb_node rb;
288 int lnum;
289 int offs;
290};
291
292/* The below union makes it easier to deal with keys */
293union ubifs_key {
294 uint8_t u8[UBIFS_SK_LEN];
295 uint32_t u32[UBIFS_SK_LEN/4];
296 uint64_t u64[UBIFS_SK_LEN/8];
297 __le32 j32[UBIFS_SK_LEN/4];
298};
299
300/**
301 * struct ubifs_scan_node - UBIFS scanned node information.
302 * @list: list of scanned nodes
303 * @key: key of node scanned (if it has one)
304 * @sqnum: sequence number
305 * @type: type of node scanned
306 * @offs: offset with LEB of node scanned
307 * @len: length of node scanned
308 * @node: raw node
309 */
310struct ubifs_scan_node {
311 struct list_head list;
312 union ubifs_key key;
313 unsigned long long sqnum;
314 int type;
315 int offs;
316 int len;
317 void *node;
318};
319
320/**
321 * struct ubifs_scan_leb - UBIFS scanned LEB information.
322 * @lnum: logical eraseblock number
323 * @nodes_cnt: number of nodes scanned
324 * @nodes: list of struct ubifs_scan_node
325 * @endpt: end point (and therefore the start of empty space)
326 * @buf: buffer containing entire LEB scanned
327 */
328struct ubifs_scan_leb {
329 int lnum;
330 int nodes_cnt;
331 struct list_head nodes;
332 int endpt;
333 void *buf;
334};
335
336/**
337 * struct ubifs_gced_idx_leb - garbage-collected indexing LEB.
338 * @list: list
339 * @lnum: LEB number
340 * @unmap: OK to unmap this LEB
341 *
342 * This data structure is used to temporary store garbage-collected indexing
343 * LEBs - they are not released immediately, but only after the next commit.
344 * This is needed to guarantee recoverability.
345 */
346struct ubifs_gced_idx_leb {
347 struct list_head list;
348 int lnum;
349 int unmap;
350};
351
352/**
353 * struct ubifs_inode - UBIFS in-memory inode description.
354 * @vfs_inode: VFS inode description object
355 * @creat_sqnum: sequence number at time of creation
356 * @del_cmtno: commit number corresponding to the time the inode was deleted,
357 * protected by @c->commit_sem;
358 * @xattr_size: summarized size of all extended attributes in bytes
359 * @xattr_cnt: count of extended attributes this inode has
360 * @xattr_names: sum of lengths of all extended attribute names belonging to
361 * this inode
362 * @dirty: non-zero if the inode is dirty
363 * @xattr: non-zero if this is an extended attribute inode
364 * @bulk_read: non-zero if bulk-read should be used
365 * @ui_mutex: serializes inode write-back with the rest of VFS operations,
366 * serializes "clean <-> dirty" state changes, serializes bulk-read,
367 * protects @dirty, @bulk_read, @ui_size, and @xattr_size
368 * @xattr_sem: serilizes write operations (remove|set|create) on xattr
369 * @ui_lock: protects @synced_i_size
370 * @synced_i_size: synchronized size of inode, i.e. the value of inode size
371 * currently stored on the flash; used only for regular file
372 * inodes
373 * @ui_size: inode size used by UBIFS when writing to flash
374 * @flags: inode flags (@UBIFS_COMPR_FL, etc)
375 * @compr_type: default compression type used for this inode
376 * @last_page_read: page number of last page read (for bulk read)
377 * @read_in_a_row: number of consecutive pages read in a row (for bulk read)
378 * @data_len: length of the data attached to the inode
379 * @data: inode's data
380 *
381 * @ui_mutex exists for two main reasons. At first it prevents inodes from
382 * being written back while UBIFS changing them, being in the middle of an VFS
383 * operation. This way UBIFS makes sure the inode fields are consistent. For
384 * example, in 'ubifs_rename()' we change 4 inodes simultaneously, and
385 * write-back must not write any of them before we have finished.
386 *
387 * The second reason is budgeting - UBIFS has to budget all operations. If an
388 * operation is going to mark an inode dirty, it has to allocate budget for
389 * this. It cannot just mark it dirty because there is no guarantee there will
390 * be enough flash space to write the inode back later. This means UBIFS has
391 * to have full control over inode "clean <-> dirty" transitions (and pages
392 * actually). But unfortunately, VFS marks inodes dirty in many places, and it
393 * does not ask the file-system if it is allowed to do so (there is a notifier,
394 * but it is not enough), i.e., there is no mechanism to synchronize with this.
395 * So UBIFS has its own inode dirty flag and its own mutex to serialize
396 * "clean <-> dirty" transitions.
397 *
398 * The @synced_i_size field is used to make sure we never write pages which are
399 * beyond last synchronized inode size. See 'ubifs_writepage()' for more
400 * information.
401 *
402 * The @ui_size is a "shadow" variable for @inode->i_size and UBIFS uses
403 * @ui_size instead of @inode->i_size. The reason for this is that UBIFS cannot
404 * make sure @inode->i_size is always changed under @ui_mutex, because it
405 * cannot call 'truncate_setsize()' with @ui_mutex locked, because it would
406 * deadlock with 'ubifs_writepage()' (see file.c). All the other inode fields
407 * are changed under @ui_mutex, so they do not need "shadow" fields. Note, one
408 * could consider to rework locking and base it on "shadow" fields.
409 */
410struct ubifs_inode {
411 struct inode vfs_inode;
412 unsigned long long creat_sqnum;
413 unsigned long long del_cmtno;
414 unsigned int xattr_size;
415 unsigned int xattr_cnt;
416 unsigned int xattr_names;
417 unsigned int dirty:1;
418 unsigned int xattr:1;
419 unsigned int bulk_read:1;
420 unsigned int compr_type:2;
421 struct mutex ui_mutex;
422 struct rw_semaphore xattr_sem;
423 spinlock_t ui_lock;
424 loff_t synced_i_size;
425 loff_t ui_size;
426 int flags;
427 pgoff_t last_page_read;
428 pgoff_t read_in_a_row;
429 int data_len;
430 void *data;
431};
432
433/**
434 * struct ubifs_unclean_leb - records a LEB recovered under read-only mode.
435 * @list: list
436 * @lnum: LEB number of recovered LEB
437 * @endpt: offset where recovery ended
438 *
439 * This structure records a LEB identified during recovery that needs to be
440 * cleaned but was not because UBIFS was mounted read-only. The information
441 * is used to clean the LEB when remounting to read-write mode.
442 */
443struct ubifs_unclean_leb {
444 struct list_head list;
445 int lnum;
446 int endpt;
447};
448
449/*
450 * LEB properties flags.
451 *
452 * LPROPS_UNCAT: not categorized
453 * LPROPS_DIRTY: dirty > free, dirty >= @c->dead_wm, not index
454 * LPROPS_DIRTY_IDX: dirty + free > @c->min_idx_node_sze and index
455 * LPROPS_FREE: free > 0, dirty < @c->dead_wm, not empty, not index
456 * LPROPS_HEAP_CNT: number of heaps used for storing categorized LEBs
457 * LPROPS_EMPTY: LEB is empty, not taken
458 * LPROPS_FREEABLE: free + dirty == leb_size, not index, not taken
459 * LPROPS_FRDI_IDX: free + dirty == leb_size and index, may be taken
460 * LPROPS_CAT_MASK: mask for the LEB categories above
461 * LPROPS_TAKEN: LEB was taken (this flag is not saved on the media)
462 * LPROPS_INDEX: LEB contains indexing nodes (this flag also exists on flash)
463 */
464enum {
465 LPROPS_UNCAT = 0,
466 LPROPS_DIRTY = 1,
467 LPROPS_DIRTY_IDX = 2,
468 LPROPS_FREE = 3,
469 LPROPS_HEAP_CNT = 3,
470 LPROPS_EMPTY = 4,
471 LPROPS_FREEABLE = 5,
472 LPROPS_FRDI_IDX = 6,
473 LPROPS_CAT_MASK = 15,
474 LPROPS_TAKEN = 16,
475 LPROPS_INDEX = 32,
476};
477
478/**
479 * struct ubifs_lprops - logical eraseblock properties.
480 * @free: amount of free space in bytes
481 * @dirty: amount of dirty space in bytes
482 * @flags: LEB properties flags (see above)
483 * @lnum: LEB number
484 * @list: list of same-category lprops (for LPROPS_EMPTY and LPROPS_FREEABLE)
485 * @hpos: heap position in heap of same-category lprops (other categories)
486 */
487struct ubifs_lprops {
488 int free;
489 int dirty;
490 int flags;
491 int lnum;
492 union {
493 struct list_head list;
494 int hpos;
495 };
496};
497
498/**
499 * struct ubifs_lpt_lprops - LPT logical eraseblock properties.
500 * @free: amount of free space in bytes
501 * @dirty: amount of dirty space in bytes
502 * @tgc: trivial GC flag (1 => unmap after commit end)
503 * @cmt: commit flag (1 => reserved for commit)
504 */
505struct ubifs_lpt_lprops {
506 int free;
507 int dirty;
508 unsigned tgc:1;
509 unsigned cmt:1;
510};
511
512/**
513 * struct ubifs_lp_stats - statistics of eraseblocks in the main area.
514 * @empty_lebs: number of empty LEBs
515 * @taken_empty_lebs: number of taken LEBs
516 * @idx_lebs: number of indexing LEBs
517 * @total_free: total free space in bytes (includes all LEBs)
518 * @total_dirty: total dirty space in bytes (includes all LEBs)
519 * @total_used: total used space in bytes (does not include index LEBs)
520 * @total_dead: total dead space in bytes (does not include index LEBs)
521 * @total_dark: total dark space in bytes (does not include index LEBs)
522 *
523 * The @taken_empty_lebs field counts the LEBs that are in the transient state
524 * of having been "taken" for use but not yet written to. @taken_empty_lebs is
525 * needed to account correctly for @gc_lnum, otherwise @empty_lebs could be
526 * used by itself (in which case 'unused_lebs' would be a better name). In the
527 * case of @gc_lnum, it is "taken" at mount time or whenever a LEB is retained
528 * by GC, but unlike other empty LEBs that are "taken", it may not be written
529 * straight away (i.e. before the next commit start or unmount), so either
530 * @gc_lnum must be specially accounted for, or the current approach followed
531 * i.e. count it under @taken_empty_lebs.
532 *
533 * @empty_lebs includes @taken_empty_lebs.
534 *
535 * @total_used, @total_dead and @total_dark fields do not account indexing
536 * LEBs.
537 */
538struct ubifs_lp_stats {
539 int empty_lebs;
540 int taken_empty_lebs;
541 int idx_lebs;
542 long long total_free;
543 long long total_dirty;
544 long long total_used;
545 long long total_dead;
546 long long total_dark;
547};
548
549struct ubifs_nnode;
550
551/**
552 * struct ubifs_cnode - LEB Properties Tree common node.
553 * @parent: parent nnode
554 * @cnext: next cnode to commit
555 * @flags: flags (%DIRTY_LPT_NODE or %OBSOLETE_LPT_NODE)
556 * @iip: index in parent
557 * @level: level in the tree (zero for pnodes, greater than zero for nnodes)
558 * @num: node number
559 */
560struct ubifs_cnode {
561 struct ubifs_nnode *parent;
562 struct ubifs_cnode *cnext;
563 unsigned long flags;
564 int iip;
565 int level;
566 int num;
567};
568
569/**
570 * struct ubifs_pnode - LEB Properties Tree leaf node.
571 * @parent: parent nnode
572 * @cnext: next cnode to commit
573 * @flags: flags (%DIRTY_LPT_NODE or %OBSOLETE_LPT_NODE)
574 * @iip: index in parent
575 * @level: level in the tree (always zero for pnodes)
576 * @num: node number
577 * @lprops: LEB properties array
578 */
579struct ubifs_pnode {
580 struct ubifs_nnode *parent;
581 struct ubifs_cnode *cnext;
582 unsigned long flags;
583 int iip;
584 int level;
585 int num;
586 struct ubifs_lprops lprops[UBIFS_LPT_FANOUT];
587};
588
589/**
590 * struct ubifs_nbranch - LEB Properties Tree internal node branch.
591 * @lnum: LEB number of child
592 * @offs: offset of child
593 * @nnode: nnode child
594 * @pnode: pnode child
595 * @cnode: cnode child
596 */
597struct ubifs_nbranch {
598 int lnum;
599 int offs;
600 union {
601 struct ubifs_nnode *nnode;
602 struct ubifs_pnode *pnode;
603 struct ubifs_cnode *cnode;
604 };
605};
606
607/**
608 * struct ubifs_nnode - LEB Properties Tree internal node.
609 * @parent: parent nnode
610 * @cnext: next cnode to commit
611 * @flags: flags (%DIRTY_LPT_NODE or %OBSOLETE_LPT_NODE)
612 * @iip: index in parent
613 * @level: level in the tree (always greater than zero for nnodes)
614 * @num: node number
615 * @nbranch: branches to child nodes
616 */
617struct ubifs_nnode {
618 struct ubifs_nnode *parent;
619 struct ubifs_cnode *cnext;
620 unsigned long flags;
621 int iip;
622 int level;
623 int num;
624 struct ubifs_nbranch nbranch[UBIFS_LPT_FANOUT];
625};
626
627/**
628 * struct ubifs_lpt_heap - heap of categorized lprops.
629 * @arr: heap array
630 * @cnt: number in heap
631 * @max_cnt: maximum number allowed in heap
632 *
633 * There are %LPROPS_HEAP_CNT heaps.
634 */
635struct ubifs_lpt_heap {
636 struct ubifs_lprops **arr;
637 int cnt;
638 int max_cnt;
639};
640
641/*
642 * Return codes for LPT scan callback function.
643 *
644 * LPT_SCAN_CONTINUE: continue scanning
645 * LPT_SCAN_ADD: add the LEB properties scanned to the tree in memory
646 * LPT_SCAN_STOP: stop scanning
647 */
648enum {
649 LPT_SCAN_CONTINUE = 0,
650 LPT_SCAN_ADD = 1,
651 LPT_SCAN_STOP = 2,
652};
653
654struct ubifs_info;
655
656/* Callback used by the 'ubifs_lpt_scan_nolock()' function */
657typedef int (*ubifs_lpt_scan_callback)(struct ubifs_info *c,
658 const struct ubifs_lprops *lprops,
659 int in_tree, void *data);
660
661/**
662 * struct ubifs_wbuf - UBIFS write-buffer.
663 * @c: UBIFS file-system description object
664 * @buf: write-buffer (of min. flash I/O unit size)
665 * @lnum: logical eraseblock number the write-buffer points to
666 * @offs: write-buffer offset in this logical eraseblock
667 * @avail: number of bytes available in the write-buffer
668 * @used: number of used bytes in the write-buffer
669 * @size: write-buffer size (in [@c->min_io_size, @c->max_write_size] range)
670 * @jhead: journal head the mutex belongs to (note, needed only to shut lockdep
671 * up by 'mutex_lock_nested()).
672 * @sync_callback: write-buffer synchronization callback
673 * @io_mutex: serializes write-buffer I/O
674 * @lock: serializes @buf, @lnum, @offs, @avail, @used, @next_ino and @inodes
675 * fields
676 * @timer: write-buffer timer
677 * @no_timer: non-zero if this write-buffer does not have a timer
678 * @need_sync: non-zero if the timer expired and the wbuf needs sync'ing
679 * @next_ino: points to the next position of the following inode number
680 * @inodes: stores the inode numbers of the nodes which are in wbuf
681 *
682 * The write-buffer synchronization callback is called when the write-buffer is
683 * synchronized in order to notify how much space was wasted due to
684 * write-buffer padding and how much free space is left in the LEB.
685 *
686 * Note: the fields @buf, @lnum, @offs, @avail and @used can be read under
687 * spin-lock or mutex because they are written under both mutex and spin-lock.
688 * @buf is appended to under mutex but overwritten under both mutex and
689 * spin-lock. Thus the data between @buf and @buf + @used can be read under
690 * spinlock.
691 */
692struct ubifs_wbuf {
693 struct ubifs_info *c;
694 void *buf;
695 int lnum;
696 int offs;
697 int avail;
698 int used;
699 int size;
700 int jhead;
701 int (*sync_callback)(struct ubifs_info *c, int lnum, int free, int pad);
702 struct mutex io_mutex;
703 spinlock_t lock;
704 struct hrtimer timer;
705 unsigned int no_timer:1;
706 unsigned int need_sync:1;
707 int next_ino;
708 ino_t *inodes;
709};
710
711/**
712 * struct ubifs_bud - bud logical eraseblock.
713 * @lnum: logical eraseblock number
714 * @start: where the (uncommitted) bud data starts
715 * @jhead: journal head number this bud belongs to
716 * @list: link in the list buds belonging to the same journal head
717 * @rb: link in the tree of all buds
718 * @log_hash: the log hash from the commit start node up to this bud
719 */
720struct ubifs_bud {
721 int lnum;
722 int start;
723 int jhead;
724 struct list_head list;
725 struct rb_node rb;
726 struct shash_desc *log_hash;
727};
728
729/**
730 * struct ubifs_jhead - journal head.
731 * @wbuf: head's write-buffer
732 * @buds_list: list of bud LEBs belonging to this journal head
733 * @grouped: non-zero if UBIFS groups nodes when writing to this journal head
734 * @log_hash: the log hash from the commit start node up to this journal head
735 *
736 * Note, the @buds list is protected by the @c->buds_lock.
737 */
738struct ubifs_jhead {
739 struct ubifs_wbuf wbuf;
740 struct list_head buds_list;
741 unsigned int grouped:1;
742 struct shash_desc *log_hash;
743};
744
745/**
746 * struct ubifs_zbranch - key/coordinate/length branch stored in znodes.
747 * @key: key
748 * @znode: znode address in memory
749 * @lnum: LEB number of the target node (indexing node or data node)
750 * @offs: target node offset within @lnum
751 * @len: target node length
752 * @hash: the hash of the target node
753 */
754struct ubifs_zbranch {
755 union ubifs_key key;
756 union {
757 struct ubifs_znode *znode;
758 void *leaf;
759 };
760 int lnum;
761 int offs;
762 int len;
763 u8 hash[UBIFS_HASH_ARR_SZ];
764};
765
766/**
767 * struct ubifs_znode - in-memory representation of an indexing node.
768 * @parent: parent znode or NULL if it is the root
769 * @cnext: next znode to commit
770 * @cparent: parent node for this commit
771 * @ciip: index in cparent's zbranch array
772 * @flags: znode flags (%DIRTY_ZNODE, %COW_ZNODE or %OBSOLETE_ZNODE)
773 * @time: last access time (seconds)
774 * @level: level of the entry in the TNC tree
775 * @child_cnt: count of child znodes
776 * @iip: index in parent's zbranch array
777 * @alt: lower bound of key range has altered i.e. child inserted at slot 0
778 * @lnum: LEB number of the corresponding indexing node
779 * @offs: offset of the corresponding indexing node
780 * @len: length of the corresponding indexing node
781 * @zbranch: array of znode branches (@c->fanout elements)
782 *
783 * Note! The @lnum, @offs, and @len fields are not really needed - we have them
784 * only for internal consistency check. They could be removed to save some RAM.
785 */
786struct ubifs_znode {
787 struct ubifs_znode *parent;
788 struct ubifs_znode *cnext;
789 struct ubifs_znode *cparent;
790 int ciip;
791 unsigned long flags;
792 time64_t time;
793 int level;
794 int child_cnt;
795 int iip;
796 int alt;
797 int lnum;
798 int offs;
799 int len;
800 struct ubifs_zbranch zbranch[];
801};
802
803/**
804 * struct bu_info - bulk-read information.
805 * @key: first data node key
806 * @zbranch: zbranches of data nodes to bulk read
807 * @buf: buffer to read into
808 * @buf_len: buffer length
809 * @gc_seq: GC sequence number to detect races with GC
810 * @cnt: number of data nodes for bulk read
811 * @blk_cnt: number of data blocks including holes
812 * @oef: end of file reached
813 */
814struct bu_info {
815 union ubifs_key key;
816 struct ubifs_zbranch zbranch[UBIFS_MAX_BULK_READ];
817 void *buf;
818 int buf_len;
819 int gc_seq;
820 int cnt;
821 int blk_cnt;
822 int eof;
823};
824
825/**
826 * struct ubifs_node_range - node length range description data structure.
827 * @len: fixed node length
828 * @min_len: minimum possible node length
829 * @max_len: maximum possible node length
830 *
831 * If @max_len is %0, the node has fixed length @len.
832 */
833struct ubifs_node_range {
834 union {
835 int len;
836 int min_len;
837 };
838 int max_len;
839};
840
841/**
842 * struct ubifs_compressor - UBIFS compressor description structure.
843 * @compr_type: compressor type (%UBIFS_COMPR_LZO, etc)
844 * @cc: cryptoapi compressor handle
845 * @comp_mutex: mutex used during compression
846 * @decomp_mutex: mutex used during decompression
847 * @name: compressor name
848 * @capi_name: cryptoapi compressor name
849 */
850struct ubifs_compressor {
851 int compr_type;
852 struct crypto_comp *cc;
853 struct mutex *comp_mutex;
854 struct mutex *decomp_mutex;
855 const char *name;
856 const char *capi_name;
857};
858
859/**
860 * struct ubifs_budget_req - budget requirements of an operation.
861 *
862 * @fast: non-zero if the budgeting should try to acquire budget quickly and
863 * should not try to call write-back
864 * @recalculate: non-zero if @idx_growth, @data_growth, and @dd_growth fields
865 * have to be re-calculated
866 * @new_page: non-zero if the operation adds a new page
867 * @dirtied_page: non-zero if the operation makes a page dirty
868 * @new_dent: non-zero if the operation adds a new directory entry
869 * @mod_dent: non-zero if the operation removes or modifies an existing
870 * directory entry
871 * @new_ino: non-zero if the operation adds a new inode
872 * @new_ino_d: how much data newly created inode contains
873 * @dirtied_ino: how many inodes the operation makes dirty
874 * @dirtied_ino_d: how much data dirtied inode contains
875 * @idx_growth: how much the index will supposedly grow
876 * @data_growth: how much new data the operation will supposedly add
877 * @dd_growth: how much data that makes other data dirty the operation will
878 * supposedly add
879 *
880 * @idx_growth, @data_growth and @dd_growth are not used in budget request. The
881 * budgeting subsystem caches index and data growth values there to avoid
882 * re-calculating them when the budget is released. However, if @idx_growth is
883 * %-1, it is calculated by the release function using other fields.
884 *
885 * An inode may contain 4KiB of data at max., thus the widths of @new_ino_d
886 * is 13 bits, and @dirtied_ino_d - 15, because up to 4 inodes may be made
887 * dirty by the re-name operation.
888 *
889 * Note, UBIFS aligns node lengths to 8-bytes boundary, so the requester has to
890 * make sure the amount of inode data which contribute to @new_ino_d and
891 * @dirtied_ino_d fields are aligned.
892 */
893struct ubifs_budget_req {
894 unsigned int fast:1;
895 unsigned int recalculate:1;
896#ifndef UBIFS_DEBUG
897 unsigned int new_page:1;
898 unsigned int dirtied_page:1;
899 unsigned int new_dent:1;
900 unsigned int mod_dent:1;
901 unsigned int new_ino:1;
902 unsigned int new_ino_d:13;
903 unsigned int dirtied_ino:4;
904 unsigned int dirtied_ino_d:15;
905#else
906 /* Not bit-fields to check for overflows */
907 unsigned int new_page;
908 unsigned int dirtied_page;
909 unsigned int new_dent;
910 unsigned int mod_dent;
911 unsigned int new_ino;
912 unsigned int new_ino_d;
913 unsigned int dirtied_ino;
914 unsigned int dirtied_ino_d;
915#endif
916 int idx_growth;
917 int data_growth;
918 int dd_growth;
919};
920
921/**
922 * struct ubifs_orphan - stores the inode number of an orphan.
923 * @rb: rb-tree node of rb-tree of orphans sorted by inode number
924 * @list: list head of list of orphans in order added
925 * @new_list: list head of list of orphans added since the last commit
926 * @child_list: list of xattr children if this orphan hosts xattrs, list head
927 * if this orphan is a xattr, not used otherwise.
928 * @cnext: next orphan to commit
929 * @dnext: next orphan to delete
930 * @inum: inode number
931 * @new: %1 => added since the last commit, otherwise %0
932 * @cmt: %1 => commit pending, otherwise %0
933 * @del: %1 => delete pending, otherwise %0
934 */
935struct ubifs_orphan {
936 struct rb_node rb;
937 struct list_head list;
938 struct list_head new_list;
939 struct list_head child_list;
940 struct ubifs_orphan *cnext;
941 struct ubifs_orphan *dnext;
942 ino_t inum;
943 unsigned new:1;
944 unsigned cmt:1;
945 unsigned del:1;
946};
947
948/**
949 * struct ubifs_mount_opts - UBIFS-specific mount options information.
950 * @unmount_mode: selected unmount mode (%0 default, %1 normal, %2 fast)
951 * @bulk_read: enable/disable bulk-reads (%0 default, %1 disable, %2 enable)
952 * @chk_data_crc: enable/disable CRC data checking when reading data nodes
953 * (%0 default, %1 disable, %2 enable)
954 * @override_compr: override default compressor (%0 - do not override and use
955 * superblock compressor, %1 - override and use compressor
956 * specified in @compr_type)
957 * @compr_type: compressor type to override the superblock compressor with
958 * (%UBIFS_COMPR_NONE, etc)
959 */
960struct ubifs_mount_opts {
961 unsigned int unmount_mode:2;
962 unsigned int bulk_read:2;
963 unsigned int chk_data_crc:2;
964 unsigned int override_compr:1;
965 unsigned int compr_type:2;
966};
967
968/**
969 * struct ubifs_budg_info - UBIFS budgeting information.
970 * @idx_growth: amount of bytes budgeted for index growth
971 * @data_growth: amount of bytes budgeted for cached data
972 * @dd_growth: amount of bytes budgeted for cached data that will make
973 * other data dirty
974 * @uncommitted_idx: amount of bytes were budgeted for growth of the index, but
975 * which still have to be taken into account because the index
976 * has not been committed so far
977 * @old_idx_sz: size of index on flash
978 * @min_idx_lebs: minimum number of LEBs required for the index
979 * @nospace: non-zero if the file-system does not have flash space (used as
980 * optimization)
981 * @nospace_rp: the same as @nospace, but additionally means that even reserved
982 * pool is full
983 * @page_budget: budget for a page (constant, never changed after mount)
984 * @inode_budget: budget for an inode (constant, never changed after mount)
985 * @dent_budget: budget for a directory entry (constant, never changed after
986 * mount)
987 */
988struct ubifs_budg_info {
989 long long idx_growth;
990 long long data_growth;
991 long long dd_growth;
992 long long uncommitted_idx;
993 unsigned long long old_idx_sz;
994 int min_idx_lebs;
995 unsigned int nospace:1;
996 unsigned int nospace_rp:1;
997 int page_budget;
998 int inode_budget;
999 int dent_budget;
1000};
1001
1002/**
1003 * ubifs_stats_info - per-FS statistics information.
1004 * @magic_errors: number of bad magic numbers (will be reset with a new mount).
1005 * @node_errors: number of bad nodes (will be reset with a new mount).
1006 * @crc_errors: number of bad crcs (will be reset with a new mount).
1007 */
1008struct ubifs_stats_info {
1009 unsigned int magic_errors;
1010 unsigned int node_errors;
1011 unsigned int crc_errors;
1012};
1013
1014struct ubifs_debug_info;
1015
1016/**
1017 * struct ubifs_info - UBIFS file-system description data structure
1018 * (per-superblock).
1019 * @vfs_sb: VFS @struct super_block object
1020 * @sup_node: The super block node as read from the device
1021 *
1022 * @highest_inum: highest used inode number
1023 * @max_sqnum: current global sequence number
1024 * @cmt_no: commit number of the last successfully completed commit, protected
1025 * by @commit_sem
1026 * @cnt_lock: protects @highest_inum and @max_sqnum counters
1027 * @fmt_version: UBIFS on-flash format version
1028 * @ro_compat_version: R/O compatibility version
1029 * @uuid: UUID from super block
1030 *
1031 * @lhead_lnum: log head logical eraseblock number
1032 * @lhead_offs: log head offset
1033 * @ltail_lnum: log tail logical eraseblock number (offset is always 0)
1034 * @log_mutex: protects the log, @lhead_lnum, @lhead_offs, @ltail_lnum, and
1035 * @bud_bytes
1036 * @min_log_bytes: minimum required number of bytes in the log
1037 * @cmt_bud_bytes: used during commit to temporarily amount of bytes in
1038 * committed buds
1039 *
1040 * @buds: tree of all buds indexed by bud LEB number
1041 * @bud_bytes: how many bytes of flash is used by buds
1042 * @buds_lock: protects the @buds tree, @bud_bytes, and per-journal head bud
1043 * lists
1044 * @jhead_cnt: count of journal heads
1045 * @jheads: journal heads (head zero is base head)
1046 * @max_bud_bytes: maximum number of bytes allowed in buds
1047 * @bg_bud_bytes: number of bud bytes when background commit is initiated
1048 * @old_buds: buds to be released after commit ends
1049 * @max_bud_cnt: maximum number of buds
1050 *
1051 * @commit_sem: synchronizes committer with other processes
1052 * @cmt_state: commit state
1053 * @cs_lock: commit state lock
1054 * @cmt_wq: wait queue to sleep on if the log is full and a commit is running
1055 *
1056 * @big_lpt: flag that LPT is too big to write whole during commit
1057 * @space_fixup: flag indicating that free space in LEBs needs to be cleaned up
1058 * @double_hash: flag indicating that we can do lookups by hash
1059 * @encrypted: flag indicating that this file system contains encrypted files
1060 * @no_chk_data_crc: do not check CRCs when reading data nodes (except during
1061 * recovery)
1062 * @bulk_read: enable bulk-reads
1063 * @default_compr: default compression algorithm (%UBIFS_COMPR_LZO, etc)
1064 * @rw_incompat: the media is not R/W compatible
1065 * @assert_action: action to take when a ubifs_assert() fails
1066 * @authenticated: flag indigating the FS is mounted in authenticated mode
1067 *
1068 * @tnc_mutex: protects the Tree Node Cache (TNC), @zroot, @cnext, @enext, and
1069 * @calc_idx_sz
1070 * @zroot: zbranch which points to the root index node and znode
1071 * @cnext: next znode to commit
1072 * @enext: next znode to commit to empty space
1073 * @gap_lebs: array of LEBs used by the in-gaps commit method
1074 * @cbuf: commit buffer
1075 * @ileb_buf: buffer for commit in-the-gaps method
1076 * @ileb_len: length of data in ileb_buf
1077 * @ihead_lnum: LEB number of index head
1078 * @ihead_offs: offset of index head
1079 * @ilebs: pre-allocated index LEBs
1080 * @ileb_cnt: number of pre-allocated index LEBs
1081 * @ileb_nxt: next pre-allocated index LEBs
1082 * @old_idx: tree of index nodes obsoleted since the last commit start
1083 * @bottom_up_buf: a buffer which is used by 'dirty_cow_bottom_up()' in tnc.c
1084 *
1085 * @mst_node: master node
1086 * @mst_offs: offset of valid master node
1087 *
1088 * @max_bu_buf_len: maximum bulk-read buffer length
1089 * @bu_mutex: protects the pre-allocated bulk-read buffer and @c->bu
1090 * @bu: pre-allocated bulk-read information
1091 *
1092 * @write_reserve_mutex: protects @write_reserve_buf
1093 * @write_reserve_buf: on the write path we allocate memory, which might
1094 * sometimes be unavailable, in which case we use this
1095 * write reserve buffer
1096 *
1097 * @log_lebs: number of logical eraseblocks in the log
1098 * @log_bytes: log size in bytes
1099 * @log_last: last LEB of the log
1100 * @lpt_lebs: number of LEBs used for lprops table
1101 * @lpt_first: first LEB of the lprops table area
1102 * @lpt_last: last LEB of the lprops table area
1103 * @orph_lebs: number of LEBs used for the orphan area
1104 * @orph_first: first LEB of the orphan area
1105 * @orph_last: last LEB of the orphan area
1106 * @main_lebs: count of LEBs in the main area
1107 * @main_first: first LEB of the main area
1108 * @main_bytes: main area size in bytes
1109 *
1110 * @key_hash_type: type of the key hash
1111 * @key_hash: direntry key hash function
1112 * @key_fmt: key format
1113 * @key_len: key length
1114 * @hash_len: The length of the index node hashes
1115 * @fanout: fanout of the index tree (number of links per indexing node)
1116 *
1117 * @min_io_size: minimal input/output unit size
1118 * @min_io_shift: number of bits in @min_io_size minus one
1119 * @max_write_size: maximum amount of bytes the underlying flash can write at a
1120 * time (MTD write buffer size)
1121 * @max_write_shift: number of bits in @max_write_size minus one
1122 * @leb_size: logical eraseblock size in bytes
1123 * @leb_start: starting offset of logical eraseblocks within physical
1124 * eraseblocks
1125 * @half_leb_size: half LEB size
1126 * @idx_leb_size: how many bytes of an LEB are effectively available when it is
1127 * used to store indexing nodes (@leb_size - @max_idx_node_sz)
1128 * @leb_cnt: count of logical eraseblocks
1129 * @max_leb_cnt: maximum count of logical eraseblocks
1130 * @ro_media: the underlying UBI volume is read-only
1131 * @ro_mount: the file-system was mounted as read-only
1132 * @ro_error: UBIFS switched to R/O mode because an error happened
1133 *
1134 * @dirty_pg_cnt: number of dirty pages (not used)
1135 * @dirty_zn_cnt: number of dirty znodes
1136 * @clean_zn_cnt: number of clean znodes
1137 *
1138 * @space_lock: protects @bi and @lst
1139 * @lst: lprops statistics
1140 * @bi: budgeting information
1141 * @calc_idx_sz: temporary variable which is used to calculate new index size
1142 * (contains accurate new index size at end of TNC commit start)
1143 *
1144 * @ref_node_alsz: size of the LEB reference node aligned to the min. flash
1145 * I/O unit
1146 * @mst_node_alsz: master node aligned size
1147 * @min_idx_node_sz: minimum indexing node aligned on 8-bytes boundary
1148 * @max_idx_node_sz: maximum indexing node aligned on 8-bytes boundary
1149 * @max_inode_sz: maximum possible inode size in bytes
1150 * @max_znode_sz: size of znode in bytes
1151 *
1152 * @leb_overhead: how many bytes are wasted in an LEB when it is filled with
1153 * data nodes of maximum size - used in free space reporting
1154 * @dead_wm: LEB dead space watermark
1155 * @dark_wm: LEB dark space watermark
1156 * @block_cnt: count of 4KiB blocks on the FS
1157 *
1158 * @ranges: UBIFS node length ranges
1159 * @ubi: UBI volume descriptor
1160 * @di: UBI device information
1161 * @vi: UBI volume information
1162 *
1163 * @orph_tree: rb-tree of orphan inode numbers
1164 * @orph_list: list of orphan inode numbers in order added
1165 * @orph_new: list of orphan inode numbers added since last commit
1166 * @orph_cnext: next orphan to commit
1167 * @orph_dnext: next orphan to delete
1168 * @orphan_lock: lock for orph_tree and orph_new
1169 * @orph_buf: buffer for orphan nodes
1170 * @new_orphans: number of orphans since last commit
1171 * @cmt_orphans: number of orphans being committed
1172 * @tot_orphans: number of orphans in the rb_tree
1173 * @max_orphans: maximum number of orphans allowed
1174 * @ohead_lnum: orphan head LEB number
1175 * @ohead_offs: orphan head offset
1176 * @no_orphs: non-zero if there are no orphans
1177 *
1178 * @bgt: UBIFS background thread
1179 * @bgt_name: background thread name
1180 * @need_bgt: if background thread should run
1181 * @need_wbuf_sync: if write-buffers have to be synchronized
1182 *
1183 * @gc_lnum: LEB number used for garbage collection
1184 * @sbuf: a buffer of LEB size used by GC and replay for scanning
1185 * @idx_gc: list of index LEBs that have been garbage collected
1186 * @idx_gc_cnt: number of elements on the idx_gc list
1187 * @gc_seq: incremented for every non-index LEB garbage collected
1188 * @gced_lnum: last non-index LEB that was garbage collected
1189 *
1190 * @infos_list: links all 'ubifs_info' objects
1191 * @umount_mutex: serializes shrinker and un-mount
1192 * @shrinker_run_no: shrinker run number
1193 *
1194 * @space_bits: number of bits needed to record free or dirty space
1195 * @lpt_lnum_bits: number of bits needed to record a LEB number in the LPT
1196 * @lpt_offs_bits: number of bits needed to record an offset in the LPT
1197 * @lpt_spc_bits: number of bits needed to space in the LPT
1198 * @pcnt_bits: number of bits needed to record pnode or nnode number
1199 * @lnum_bits: number of bits needed to record LEB number
1200 * @nnode_sz: size of on-flash nnode
1201 * @pnode_sz: size of on-flash pnode
1202 * @ltab_sz: size of on-flash LPT lprops table
1203 * @lsave_sz: size of on-flash LPT save table
1204 * @pnode_cnt: number of pnodes
1205 * @nnode_cnt: number of nnodes
1206 * @lpt_hght: height of the LPT
1207 * @pnodes_have: number of pnodes in memory
1208 *
1209 * @lp_mutex: protects lprops table and all the other lprops-related fields
1210 * @lpt_lnum: LEB number of the root nnode of the LPT
1211 * @lpt_offs: offset of the root nnode of the LPT
1212 * @nhead_lnum: LEB number of LPT head
1213 * @nhead_offs: offset of LPT head
1214 * @lpt_drty_flgs: dirty flags for LPT special nodes e.g. ltab
1215 * @dirty_nn_cnt: number of dirty nnodes
1216 * @dirty_pn_cnt: number of dirty pnodes
1217 * @check_lpt_free: flag that indicates LPT GC may be needed
1218 * @lpt_sz: LPT size
1219 * @lpt_nod_buf: buffer for an on-flash nnode or pnode
1220 * @lpt_buf: buffer of LEB size used by LPT
1221 * @nroot: address in memory of the root nnode of the LPT
1222 * @lpt_cnext: next LPT node to commit
1223 * @lpt_heap: array of heaps of categorized lprops
1224 * @dirty_idx: a (reverse sorted) copy of the LPROPS_DIRTY_IDX heap as at
1225 * previous commit start
1226 * @uncat_list: list of un-categorized LEBs
1227 * @empty_list: list of empty LEBs
1228 * @freeable_list: list of freeable non-index LEBs (free + dirty == @leb_size)
1229 * @frdi_idx_list: list of freeable index LEBs (free + dirty == @leb_size)
1230 * @freeable_cnt: number of freeable LEBs in @freeable_list
1231 * @in_a_category_cnt: count of lprops which are in a certain category, which
1232 * basically meants that they were loaded from the flash
1233 *
1234 * @ltab_lnum: LEB number of LPT's own lprops table
1235 * @ltab_offs: offset of LPT's own lprops table
1236 * @ltab: LPT's own lprops table
1237 * @ltab_cmt: LPT's own lprops table (commit copy)
1238 * @lsave_cnt: number of LEB numbers in LPT's save table
1239 * @lsave_lnum: LEB number of LPT's save table
1240 * @lsave_offs: offset of LPT's save table
1241 * @lsave: LPT's save table
1242 * @lscan_lnum: LEB number of last LPT scan
1243 *
1244 * @rp_size: size of the reserved pool in bytes
1245 * @report_rp_size: size of the reserved pool reported to user-space
1246 * @rp_uid: reserved pool user ID
1247 * @rp_gid: reserved pool group ID
1248 *
1249 * @hash_tfm: the hash transformation used for hashing nodes
1250 * @hmac_tfm: the HMAC transformation for this filesystem
1251 * @hmac_desc_len: length of the HMAC used for authentication
1252 * @auth_key_name: the authentication key name
1253 * @auth_hash_name: the name of the hash algorithm used for authentication
1254 * @auth_hash_algo: the authentication hash used for this fs
1255 * @log_hash: the log hash from the commit start node up to the latest reference
1256 * node.
1257 *
1258 * @empty: %1 if the UBI device is empty
1259 * @need_recovery: %1 if the file-system needs recovery
1260 * @replaying: %1 during journal replay
1261 * @mounting: %1 while mounting
1262 * @probing: %1 while attempting to mount if SB_SILENT mount flag is set
1263 * @remounting_rw: %1 while re-mounting from R/O mode to R/W mode
1264 * @replay_list: temporary list used during journal replay
1265 * @replay_buds: list of buds to replay
1266 * @cs_sqnum: sequence number of first node in the log (commit start node)
1267 * @unclean_leb_list: LEBs to recover when re-mounting R/O mounted FS to R/W
1268 * mode
1269 * @rcvrd_mst_node: recovered master node to write when re-mounting R/O mounted
1270 * FS to R/W mode
1271 * @size_tree: inode size information for recovery
1272 * @mount_opts: UBIFS-specific mount options
1273 *
1274 * @dbg: debugging-related information
1275 * @stats: statistics exported over sysfs
1276 *
1277 * @kobj: kobject for /sys/fs/ubifs/
1278 * @kobj_unregister: completion to unregister sysfs kobject
1279 */
1280struct ubifs_info {
1281 struct super_block *vfs_sb;
1282 struct ubifs_sb_node *sup_node;
1283
1284 ino_t highest_inum;
1285 unsigned long long max_sqnum;
1286 unsigned long long cmt_no;
1287 spinlock_t cnt_lock;
1288 int fmt_version;
1289 int ro_compat_version;
1290 unsigned char uuid[16];
1291
1292 int lhead_lnum;
1293 int lhead_offs;
1294 int ltail_lnum;
1295 struct mutex log_mutex;
1296 int min_log_bytes;
1297 long long cmt_bud_bytes;
1298
1299 struct rb_root buds;
1300 long long bud_bytes;
1301 spinlock_t buds_lock;
1302 int jhead_cnt;
1303 struct ubifs_jhead *jheads;
1304 long long max_bud_bytes;
1305 long long bg_bud_bytes;
1306 struct list_head old_buds;
1307 int max_bud_cnt;
1308
1309 struct rw_semaphore commit_sem;
1310 int cmt_state;
1311 spinlock_t cs_lock;
1312 wait_queue_head_t cmt_wq;
1313
1314 struct kobject kobj;
1315 struct completion kobj_unregister;
1316
1317 unsigned int big_lpt:1;
1318 unsigned int space_fixup:1;
1319 unsigned int double_hash:1;
1320 unsigned int encrypted:1;
1321 unsigned int no_chk_data_crc:1;
1322 unsigned int bulk_read:1;
1323 unsigned int default_compr:2;
1324 unsigned int rw_incompat:1;
1325 unsigned int assert_action:2;
1326 unsigned int authenticated:1;
1327 unsigned int superblock_need_write:1;
1328
1329 struct mutex tnc_mutex;
1330 struct ubifs_zbranch zroot;
1331 struct ubifs_znode *cnext;
1332 struct ubifs_znode *enext;
1333 int *gap_lebs;
1334 void *cbuf;
1335 void *ileb_buf;
1336 int ileb_len;
1337 int ihead_lnum;
1338 int ihead_offs;
1339 int *ilebs;
1340 int ileb_cnt;
1341 int ileb_nxt;
1342 struct rb_root old_idx;
1343 int *bottom_up_buf;
1344
1345 struct ubifs_mst_node *mst_node;
1346 int mst_offs;
1347
1348 int max_bu_buf_len;
1349 struct mutex bu_mutex;
1350 struct bu_info bu;
1351
1352 struct mutex write_reserve_mutex;
1353 void *write_reserve_buf;
1354
1355 int log_lebs;
1356 long long log_bytes;
1357 int log_last;
1358 int lpt_lebs;
1359 int lpt_first;
1360 int lpt_last;
1361 int orph_lebs;
1362 int orph_first;
1363 int orph_last;
1364 int main_lebs;
1365 int main_first;
1366 long long main_bytes;
1367
1368 uint8_t key_hash_type;
1369 uint32_t (*key_hash)(const char *str, int len);
1370 int key_fmt;
1371 int key_len;
1372 int hash_len;
1373 int fanout;
1374
1375 int min_io_size;
1376 int min_io_shift;
1377 int max_write_size;
1378 int max_write_shift;
1379 int leb_size;
1380 int leb_start;
1381 int half_leb_size;
1382 int idx_leb_size;
1383 int leb_cnt;
1384 int max_leb_cnt;
1385 unsigned int ro_media:1;
1386 unsigned int ro_mount:1;
1387 unsigned int ro_error:1;
1388
1389 atomic_long_t dirty_pg_cnt;
1390 atomic_long_t dirty_zn_cnt;
1391 atomic_long_t clean_zn_cnt;
1392
1393 spinlock_t space_lock;
1394 struct ubifs_lp_stats lst;
1395 struct ubifs_budg_info bi;
1396 unsigned long long calc_idx_sz;
1397
1398 int ref_node_alsz;
1399 int mst_node_alsz;
1400 int min_idx_node_sz;
1401 int max_idx_node_sz;
1402 long long max_inode_sz;
1403 int max_znode_sz;
1404
1405 int leb_overhead;
1406 int dead_wm;
1407 int dark_wm;
1408 int block_cnt;
1409
1410 struct ubifs_node_range ranges[UBIFS_NODE_TYPES_CNT];
1411 struct ubi_volume_desc *ubi;
1412 struct ubi_device_info di;
1413 struct ubi_volume_info vi;
1414
1415 struct rb_root orph_tree;
1416 struct list_head orph_list;
1417 struct list_head orph_new;
1418 struct ubifs_orphan *orph_cnext;
1419 struct ubifs_orphan *orph_dnext;
1420 spinlock_t orphan_lock;
1421 void *orph_buf;
1422 int new_orphans;
1423 int cmt_orphans;
1424 int tot_orphans;
1425 int max_orphans;
1426 int ohead_lnum;
1427 int ohead_offs;
1428 int no_orphs;
1429
1430 struct task_struct *bgt;
1431 char bgt_name[sizeof(BGT_NAME_PATTERN) + 9];
1432 int need_bgt;
1433 int need_wbuf_sync;
1434
1435 int gc_lnum;
1436 void *sbuf;
1437 struct list_head idx_gc;
1438 int idx_gc_cnt;
1439 int gc_seq;
1440 int gced_lnum;
1441
1442 struct list_head infos_list;
1443 struct mutex umount_mutex;
1444 unsigned int shrinker_run_no;
1445
1446 int space_bits;
1447 int lpt_lnum_bits;
1448 int lpt_offs_bits;
1449 int lpt_spc_bits;
1450 int pcnt_bits;
1451 int lnum_bits;
1452 int nnode_sz;
1453 int pnode_sz;
1454 int ltab_sz;
1455 int lsave_sz;
1456 int pnode_cnt;
1457 int nnode_cnt;
1458 int lpt_hght;
1459 int pnodes_have;
1460
1461 struct mutex lp_mutex;
1462 int lpt_lnum;
1463 int lpt_offs;
1464 int nhead_lnum;
1465 int nhead_offs;
1466 int lpt_drty_flgs;
1467 int dirty_nn_cnt;
1468 int dirty_pn_cnt;
1469 int check_lpt_free;
1470 long long lpt_sz;
1471 void *lpt_nod_buf;
1472 void *lpt_buf;
1473 struct ubifs_nnode *nroot;
1474 struct ubifs_cnode *lpt_cnext;
1475 struct ubifs_lpt_heap lpt_heap[LPROPS_HEAP_CNT];
1476 struct ubifs_lpt_heap dirty_idx;
1477 struct list_head uncat_list;
1478 struct list_head empty_list;
1479 struct list_head freeable_list;
1480 struct list_head frdi_idx_list;
1481 int freeable_cnt;
1482 int in_a_category_cnt;
1483
1484 int ltab_lnum;
1485 int ltab_offs;
1486 struct ubifs_lpt_lprops *ltab;
1487 struct ubifs_lpt_lprops *ltab_cmt;
1488 int lsave_cnt;
1489 int lsave_lnum;
1490 int lsave_offs;
1491 int *lsave;
1492 int lscan_lnum;
1493
1494 long long rp_size;
1495 long long report_rp_size;
1496 kuid_t rp_uid;
1497 kgid_t rp_gid;
1498
1499 struct crypto_shash *hash_tfm;
1500 struct crypto_shash *hmac_tfm;
1501 int hmac_desc_len;
1502 char *auth_key_name;
1503 char *auth_hash_name;
1504 enum hash_algo auth_hash_algo;
1505
1506 struct shash_desc *log_hash;
1507
1508 /* The below fields are used only during mounting and re-mounting */
1509 unsigned int empty:1;
1510 unsigned int need_recovery:1;
1511 unsigned int replaying:1;
1512 unsigned int mounting:1;
1513 unsigned int remounting_rw:1;
1514 unsigned int probing:1;
1515 struct list_head replay_list;
1516 struct list_head replay_buds;
1517 unsigned long long cs_sqnum;
1518 struct list_head unclean_leb_list;
1519 struct ubifs_mst_node *rcvrd_mst_node;
1520 struct rb_root size_tree;
1521 struct ubifs_mount_opts mount_opts;
1522
1523 struct ubifs_debug_info *dbg;
1524 struct ubifs_stats_info *stats;
1525};
1526
1527extern struct list_head ubifs_infos;
1528extern spinlock_t ubifs_infos_lock;
1529extern atomic_long_t ubifs_clean_zn_cnt;
1530extern const struct super_operations ubifs_super_operations;
1531extern const struct address_space_operations ubifs_file_address_operations;
1532extern const struct file_operations ubifs_file_operations;
1533extern const struct inode_operations ubifs_file_inode_operations;
1534extern const struct file_operations ubifs_dir_operations;
1535extern const struct inode_operations ubifs_dir_inode_operations;
1536extern const struct inode_operations ubifs_symlink_inode_operations;
1537extern struct ubifs_compressor *ubifs_compressors[UBIFS_COMPR_TYPES_CNT];
1538extern int ubifs_default_version;
1539
1540/* auth.c */
1541static inline int ubifs_authenticated(const struct ubifs_info *c)
1542{
1543 return (IS_ENABLED(CONFIG_UBIFS_FS_AUTHENTICATION)) && c->authenticated;
1544}
1545
1546struct shash_desc *__ubifs_hash_get_desc(const struct ubifs_info *c);
1547static inline struct shash_desc *ubifs_hash_get_desc(const struct ubifs_info *c)
1548{
1549 return ubifs_authenticated(c) ? __ubifs_hash_get_desc(c) : NULL;
1550}
1551
1552static inline int ubifs_shash_init(const struct ubifs_info *c,
1553 struct shash_desc *desc)
1554{
1555 if (ubifs_authenticated(c))
1556 return crypto_shash_init(desc);
1557 else
1558 return 0;
1559}
1560
1561static inline int ubifs_shash_update(const struct ubifs_info *c,
1562 struct shash_desc *desc, const void *buf,
1563 unsigned int len)
1564{
1565 int err = 0;
1566
1567 if (ubifs_authenticated(c)) {
1568 err = crypto_shash_update(desc, data: buf, len);
1569 if (err < 0)
1570 return err;
1571 }
1572
1573 return 0;
1574}
1575
1576static inline int ubifs_shash_final(const struct ubifs_info *c,
1577 struct shash_desc *desc, u8 *out)
1578{
1579 return ubifs_authenticated(c) ? crypto_shash_final(desc, out) : 0;
1580}
1581
1582int __ubifs_node_calc_hash(const struct ubifs_info *c, const void *buf,
1583 u8 *hash);
1584static inline int ubifs_node_calc_hash(const struct ubifs_info *c,
1585 const void *buf, u8 *hash)
1586{
1587 if (ubifs_authenticated(c))
1588 return __ubifs_node_calc_hash(c, buf, hash);
1589 else
1590 return 0;
1591}
1592
1593int ubifs_prepare_auth_node(struct ubifs_info *c, void *node,
1594 struct shash_desc *inhash);
1595
1596/**
1597 * ubifs_check_hash - compare two hashes
1598 * @c: UBIFS file-system description object
1599 * @expected: first hash
1600 * @got: second hash
1601 *
1602 * Compare two hashes @expected and @got. Returns 0 when they are equal, a
1603 * negative error code otherwise.
1604 */
1605static inline int ubifs_check_hash(const struct ubifs_info *c,
1606 const u8 *expected, const u8 *got)
1607{
1608 return crypto_memneq(a: expected, b: got, size: c->hash_len);
1609}
1610
1611/**
1612 * ubifs_check_hmac - compare two HMACs
1613 * @c: UBIFS file-system description object
1614 * @expected: first HMAC
1615 * @got: second HMAC
1616 *
1617 * Compare two hashes @expected and @got. Returns 0 when they are equal, a
1618 * negative error code otherwise.
1619 */
1620static inline int ubifs_check_hmac(const struct ubifs_info *c,
1621 const u8 *expected, const u8 *got)
1622{
1623 return crypto_memneq(a: expected, b: got, size: c->hmac_desc_len);
1624}
1625
1626#ifdef CONFIG_UBIFS_FS_AUTHENTICATION
1627void ubifs_bad_hash(const struct ubifs_info *c, const void *node,
1628 const u8 *hash, int lnum, int offs);
1629#else
1630static inline void ubifs_bad_hash(const struct ubifs_info *c, const void *node,
1631 const u8 *hash, int lnum, int offs) {};
1632#endif
1633
1634int __ubifs_node_check_hash(const struct ubifs_info *c, const void *buf,
1635 const u8 *expected);
1636static inline int ubifs_node_check_hash(const struct ubifs_info *c,
1637 const void *buf, const u8 *expected)
1638{
1639 if (ubifs_authenticated(c))
1640 return __ubifs_node_check_hash(c, buf, expected);
1641 else
1642 return 0;
1643}
1644
1645int ubifs_init_authentication(struct ubifs_info *c);
1646void __ubifs_exit_authentication(struct ubifs_info *c);
1647static inline void ubifs_exit_authentication(struct ubifs_info *c)
1648{
1649 if (ubifs_authenticated(c))
1650 __ubifs_exit_authentication(c);
1651}
1652
1653/**
1654 * ubifs_branch_hash - returns a pointer to the hash of a branch
1655 * @c: UBIFS file-system description object
1656 * @br: branch to get the hash from
1657 *
1658 * This returns a pointer to the hash of a branch. Since the key already is a
1659 * dynamically sized object we cannot use a struct member here.
1660 */
1661static inline u8 *ubifs_branch_hash(struct ubifs_info *c,
1662 struct ubifs_branch *br)
1663{
1664 return (void *)br + sizeof(*br) + c->key_len;
1665}
1666
1667/**
1668 * ubifs_copy_hash - copy a hash
1669 * @c: UBIFS file-system description object
1670 * @from: source hash
1671 * @to: destination hash
1672 *
1673 * With authentication this copies a hash, otherwise does nothing.
1674 */
1675static inline void ubifs_copy_hash(const struct ubifs_info *c, const u8 *from,
1676 u8 *to)
1677{
1678 if (ubifs_authenticated(c))
1679 memcpy(to, from, c->hash_len);
1680}
1681
1682int __ubifs_node_insert_hmac(const struct ubifs_info *c, void *buf,
1683 int len, int ofs_hmac);
1684static inline int ubifs_node_insert_hmac(const struct ubifs_info *c, void *buf,
1685 int len, int ofs_hmac)
1686{
1687 if (ubifs_authenticated(c))
1688 return __ubifs_node_insert_hmac(c, buf, len, ofs_hmac);
1689 else
1690 return 0;
1691}
1692
1693int __ubifs_node_verify_hmac(const struct ubifs_info *c, const void *buf,
1694 int len, int ofs_hmac);
1695static inline int ubifs_node_verify_hmac(const struct ubifs_info *c,
1696 const void *buf, int len, int ofs_hmac)
1697{
1698 if (ubifs_authenticated(c))
1699 return __ubifs_node_verify_hmac(c, buf, len, ofs_hmac);
1700 else
1701 return 0;
1702}
1703
1704/**
1705 * ubifs_auth_node_sz - returns the size of an authentication node
1706 * @c: UBIFS file-system description object
1707 *
1708 * This function returns the size of an authentication node which can
1709 * be 0 for unauthenticated filesystems or the real size of an auth node
1710 * authentication is enabled.
1711 */
1712static inline int ubifs_auth_node_sz(const struct ubifs_info *c)
1713{
1714 if (ubifs_authenticated(c))
1715 return sizeof(struct ubifs_auth_node) + c->hmac_desc_len;
1716 else
1717 return 0;
1718}
1719int ubifs_sb_verify_signature(struct ubifs_info *c,
1720 const struct ubifs_sb_node *sup);
1721bool ubifs_hmac_zero(struct ubifs_info *c, const u8 *hmac);
1722
1723int ubifs_hmac_wkm(struct ubifs_info *c, u8 *hmac);
1724
1725int __ubifs_shash_copy_state(const struct ubifs_info *c, struct shash_desc *src,
1726 struct shash_desc *target);
1727static inline int ubifs_shash_copy_state(const struct ubifs_info *c,
1728 struct shash_desc *src,
1729 struct shash_desc *target)
1730{
1731 if (ubifs_authenticated(c))
1732 return __ubifs_shash_copy_state(c, src, target);
1733 else
1734 return 0;
1735}
1736
1737/* io.c */
1738void ubifs_ro_mode(struct ubifs_info *c, int err);
1739int ubifs_leb_read(const struct ubifs_info *c, int lnum, void *buf, int offs,
1740 int len, int even_ebadmsg);
1741int ubifs_leb_write(struct ubifs_info *c, int lnum, const void *buf, int offs,
1742 int len);
1743int ubifs_leb_change(struct ubifs_info *c, int lnum, const void *buf, int len);
1744int ubifs_leb_unmap(struct ubifs_info *c, int lnum);
1745int ubifs_leb_map(struct ubifs_info *c, int lnum);
1746int ubifs_is_mapped(const struct ubifs_info *c, int lnum);
1747int ubifs_wbuf_write_nolock(struct ubifs_wbuf *wbuf, void *buf, int len);
1748int ubifs_wbuf_seek_nolock(struct ubifs_wbuf *wbuf, int lnum, int offs);
1749int ubifs_wbuf_init(struct ubifs_info *c, struct ubifs_wbuf *wbuf);
1750int ubifs_read_node(const struct ubifs_info *c, void *buf, int type, int len,
1751 int lnum, int offs);
1752int ubifs_read_node_wbuf(struct ubifs_wbuf *wbuf, void *buf, int type, int len,
1753 int lnum, int offs);
1754int ubifs_write_node(struct ubifs_info *c, void *node, int len, int lnum,
1755 int offs);
1756int ubifs_write_node_hmac(struct ubifs_info *c, void *buf, int len, int lnum,
1757 int offs, int hmac_offs);
1758int ubifs_check_node(const struct ubifs_info *c, const void *buf, int len,
1759 int lnum, int offs, int quiet, int must_chk_crc);
1760void ubifs_init_node(struct ubifs_info *c, void *buf, int len, int pad);
1761void ubifs_crc_node(struct ubifs_info *c, void *buf, int len);
1762void ubifs_prepare_node(struct ubifs_info *c, void *buf, int len, int pad);
1763int ubifs_prepare_node_hmac(struct ubifs_info *c, void *node, int len,
1764 int hmac_offs, int pad);
1765void ubifs_prep_grp_node(struct ubifs_info *c, void *node, int len, int last);
1766int ubifs_io_init(struct ubifs_info *c);
1767void ubifs_pad(const struct ubifs_info *c, void *buf, int pad);
1768int ubifs_wbuf_sync_nolock(struct ubifs_wbuf *wbuf);
1769int ubifs_bg_wbufs_sync(struct ubifs_info *c);
1770void ubifs_wbuf_add_ino_nolock(struct ubifs_wbuf *wbuf, ino_t inum);
1771int ubifs_sync_wbufs_by_inode(struct ubifs_info *c, struct inode *inode);
1772
1773/* scan.c */
1774struct ubifs_scan_leb *ubifs_scan(const struct ubifs_info *c, int lnum,
1775 int offs, void *sbuf, int quiet);
1776void ubifs_scan_destroy(struct ubifs_scan_leb *sleb);
1777int ubifs_scan_a_node(const struct ubifs_info *c, void *buf, int len, int lnum,
1778 int offs, int quiet);
1779struct ubifs_scan_leb *ubifs_start_scan(const struct ubifs_info *c, int lnum,
1780 int offs, void *sbuf);
1781void ubifs_end_scan(const struct ubifs_info *c, struct ubifs_scan_leb *sleb,
1782 int lnum, int offs);
1783int ubifs_add_snod(const struct ubifs_info *c, struct ubifs_scan_leb *sleb,
1784 void *buf, int offs);
1785void ubifs_scanned_corruption(const struct ubifs_info *c, int lnum, int offs,
1786 void *buf);
1787
1788/* log.c */
1789void ubifs_add_bud(struct ubifs_info *c, struct ubifs_bud *bud);
1790void ubifs_create_buds_lists(struct ubifs_info *c);
1791int ubifs_add_bud_to_log(struct ubifs_info *c, int jhead, int lnum, int offs);
1792struct ubifs_bud *ubifs_search_bud(struct ubifs_info *c, int lnum);
1793struct ubifs_wbuf *ubifs_get_wbuf(struct ubifs_info *c, int lnum);
1794int ubifs_log_start_commit(struct ubifs_info *c, int *ltail_lnum);
1795int ubifs_log_end_commit(struct ubifs_info *c, int new_ltail_lnum);
1796int ubifs_log_post_commit(struct ubifs_info *c, int old_ltail_lnum);
1797int ubifs_consolidate_log(struct ubifs_info *c);
1798
1799/* journal.c */
1800int ubifs_jnl_update(struct ubifs_info *c, const struct inode *dir,
1801 const struct fscrypt_name *nm, const struct inode *inode,
1802 int deletion, int xent);
1803int ubifs_jnl_write_data(struct ubifs_info *c, const struct inode *inode,
1804 const union ubifs_key *key, const void *buf, int len);
1805int ubifs_jnl_write_inode(struct ubifs_info *c, const struct inode *inode);
1806int ubifs_jnl_delete_inode(struct ubifs_info *c, const struct inode *inode);
1807int ubifs_jnl_xrename(struct ubifs_info *c, const struct inode *fst_dir,
1808 const struct inode *fst_inode,
1809 const struct fscrypt_name *fst_nm,
1810 const struct inode *snd_dir,
1811 const struct inode *snd_inode,
1812 const struct fscrypt_name *snd_nm, int sync);
1813int ubifs_jnl_rename(struct ubifs_info *c, const struct inode *old_dir,
1814 const struct inode *old_inode,
1815 const struct fscrypt_name *old_nm,
1816 const struct inode *new_dir,
1817 const struct inode *new_inode,
1818 const struct fscrypt_name *new_nm,
1819 const struct inode *whiteout, int sync);
1820int ubifs_jnl_truncate(struct ubifs_info *c, const struct inode *inode,
1821 loff_t old_size, loff_t new_size);
1822int ubifs_jnl_delete_xattr(struct ubifs_info *c, const struct inode *host,
1823 const struct inode *inode, const struct fscrypt_name *nm);
1824int ubifs_jnl_change_xattr(struct ubifs_info *c, const struct inode *inode1,
1825 const struct inode *inode2);
1826
1827/* budget.c */
1828int ubifs_budget_space(struct ubifs_info *c, struct ubifs_budget_req *req);
1829void ubifs_release_budget(struct ubifs_info *c, struct ubifs_budget_req *req);
1830void ubifs_release_dirty_inode_budget(struct ubifs_info *c,
1831 struct ubifs_inode *ui);
1832int ubifs_budget_inode_op(struct ubifs_info *c, struct inode *inode,
1833 struct ubifs_budget_req *req);
1834void ubifs_release_ino_dirty(struct ubifs_info *c, struct inode *inode,
1835 struct ubifs_budget_req *req);
1836void ubifs_cancel_ino_op(struct ubifs_info *c, struct inode *inode,
1837 struct ubifs_budget_req *req);
1838long long ubifs_get_free_space(struct ubifs_info *c);
1839long long ubifs_get_free_space_nolock(struct ubifs_info *c);
1840int ubifs_calc_min_idx_lebs(struct ubifs_info *c);
1841void ubifs_convert_page_budget(struct ubifs_info *c);
1842long long ubifs_reported_space(const struct ubifs_info *c, long long free);
1843long long ubifs_calc_available(const struct ubifs_info *c, int min_idx_lebs);
1844
1845/* find.c */
1846int ubifs_find_free_space(struct ubifs_info *c, int min_space, int *offs,
1847 int squeeze);
1848int ubifs_find_free_leb_for_idx(struct ubifs_info *c);
1849int ubifs_find_dirty_leb(struct ubifs_info *c, struct ubifs_lprops *ret_lp,
1850 int min_space, int pick_free);
1851int ubifs_find_dirty_idx_leb(struct ubifs_info *c);
1852int ubifs_save_dirty_idx_lnums(struct ubifs_info *c);
1853
1854/* tnc.c */
1855int ubifs_lookup_level0(struct ubifs_info *c, const union ubifs_key *key,
1856 struct ubifs_znode **zn, int *n);
1857int ubifs_tnc_lookup_nm(struct ubifs_info *c, const union ubifs_key *key,
1858 void *node, const struct fscrypt_name *nm);
1859int ubifs_tnc_lookup_dh(struct ubifs_info *c, const union ubifs_key *key,
1860 void *node, uint32_t secondary_hash);
1861int ubifs_tnc_locate(struct ubifs_info *c, const union ubifs_key *key,
1862 void *node, int *lnum, int *offs);
1863int ubifs_tnc_add(struct ubifs_info *c, const union ubifs_key *key, int lnum,
1864 int offs, int len, const u8 *hash);
1865int ubifs_tnc_replace(struct ubifs_info *c, const union ubifs_key *key,
1866 int old_lnum, int old_offs, int lnum, int offs, int len);
1867int ubifs_tnc_add_nm(struct ubifs_info *c, const union ubifs_key *key,
1868 int lnum, int offs, int len, const u8 *hash,
1869 const struct fscrypt_name *nm);
1870int ubifs_tnc_remove(struct ubifs_info *c, const union ubifs_key *key);
1871int ubifs_tnc_remove_nm(struct ubifs_info *c, const union ubifs_key *key,
1872 const struct fscrypt_name *nm);
1873int ubifs_tnc_remove_dh(struct ubifs_info *c, const union ubifs_key *key,
1874 uint32_t cookie);
1875int ubifs_tnc_remove_range(struct ubifs_info *c, union ubifs_key *from_key,
1876 union ubifs_key *to_key);
1877int ubifs_tnc_remove_ino(struct ubifs_info *c, ino_t inum);
1878struct ubifs_dent_node *ubifs_tnc_next_ent(struct ubifs_info *c,
1879 union ubifs_key *key,
1880 const struct fscrypt_name *nm);
1881void ubifs_tnc_close(struct ubifs_info *c);
1882int ubifs_tnc_has_node(struct ubifs_info *c, union ubifs_key *key, int level,
1883 int lnum, int offs, int is_idx);
1884int ubifs_dirty_idx_node(struct ubifs_info *c, union ubifs_key *key, int level,
1885 int lnum, int offs);
1886/* Shared by tnc.c for tnc_commit.c */
1887void destroy_old_idx(struct ubifs_info *c);
1888int is_idx_node_in_tnc(struct ubifs_info *c, union ubifs_key *key, int level,
1889 int lnum, int offs);
1890int insert_old_idx_znode(struct ubifs_info *c, struct ubifs_znode *znode);
1891int ubifs_tnc_get_bu_keys(struct ubifs_info *c, struct bu_info *bu);
1892int ubifs_tnc_bulk_read(struct ubifs_info *c, struct bu_info *bu);
1893
1894/* tnc_misc.c */
1895struct ubifs_znode *ubifs_tnc_levelorder_next(const struct ubifs_info *c,
1896 struct ubifs_znode *zr,
1897 struct ubifs_znode *znode);
1898int ubifs_search_zbranch(const struct ubifs_info *c,
1899 const struct ubifs_znode *znode,
1900 const union ubifs_key *key, int *n);
1901struct ubifs_znode *ubifs_tnc_postorder_first(struct ubifs_znode *znode);
1902struct ubifs_znode *ubifs_tnc_postorder_next(const struct ubifs_info *c,
1903 struct ubifs_znode *znode);
1904long ubifs_destroy_tnc_subtree(const struct ubifs_info *c,
1905 struct ubifs_znode *zr);
1906struct ubifs_znode *ubifs_load_znode(struct ubifs_info *c,
1907 struct ubifs_zbranch *zbr,
1908 struct ubifs_znode *parent, int iip);
1909int ubifs_tnc_read_node(struct ubifs_info *c, struct ubifs_zbranch *zbr,
1910 void *node);
1911
1912/* tnc_commit.c */
1913int ubifs_tnc_start_commit(struct ubifs_info *c, struct ubifs_zbranch *zroot);
1914int ubifs_tnc_end_commit(struct ubifs_info *c);
1915
1916/* shrinker.c */
1917unsigned long ubifs_shrink_scan(struct shrinker *shrink,
1918 struct shrink_control *sc);
1919unsigned long ubifs_shrink_count(struct shrinker *shrink,
1920 struct shrink_control *sc);
1921
1922/* commit.c */
1923int ubifs_bg_thread(void *info);
1924void ubifs_commit_required(struct ubifs_info *c);
1925void ubifs_request_bg_commit(struct ubifs_info *c);
1926int ubifs_run_commit(struct ubifs_info *c);
1927void ubifs_recovery_commit(struct ubifs_info *c);
1928int ubifs_gc_should_commit(struct ubifs_info *c);
1929void ubifs_wait_for_commit(struct ubifs_info *c);
1930
1931/* master.c */
1932int ubifs_compare_master_node(struct ubifs_info *c, void *m1, void *m2);
1933int ubifs_read_master(struct ubifs_info *c);
1934int ubifs_write_master(struct ubifs_info *c);
1935
1936/* sb.c */
1937int ubifs_read_superblock(struct ubifs_info *c);
1938int ubifs_write_sb_node(struct ubifs_info *c, struct ubifs_sb_node *sup);
1939int ubifs_fixup_free_space(struct ubifs_info *c);
1940int ubifs_enable_encryption(struct ubifs_info *c);
1941
1942/* replay.c */
1943int ubifs_validate_entry(struct ubifs_info *c,
1944 const struct ubifs_dent_node *dent);
1945int ubifs_replay_journal(struct ubifs_info *c);
1946
1947/* gc.c */
1948int ubifs_garbage_collect(struct ubifs_info *c, int anyway);
1949int ubifs_gc_start_commit(struct ubifs_info *c);
1950int ubifs_gc_end_commit(struct ubifs_info *c);
1951void ubifs_destroy_idx_gc(struct ubifs_info *c);
1952int ubifs_get_idx_gc_leb(struct ubifs_info *c);
1953int ubifs_garbage_collect_leb(struct ubifs_info *c, struct ubifs_lprops *lp);
1954
1955/* orphan.c */
1956int ubifs_add_orphan(struct ubifs_info *c, ino_t inum);
1957void ubifs_delete_orphan(struct ubifs_info *c, ino_t inum);
1958int ubifs_orphan_start_commit(struct ubifs_info *c);
1959int ubifs_orphan_end_commit(struct ubifs_info *c);
1960int ubifs_mount_orphans(struct ubifs_info *c, int unclean, int read_only);
1961int ubifs_clear_orphans(struct ubifs_info *c);
1962
1963/* lpt.c */
1964int ubifs_calc_lpt_geom(struct ubifs_info *c);
1965int ubifs_create_dflt_lpt(struct ubifs_info *c, int *main_lebs, int lpt_first,
1966 int *lpt_lebs, int *big_lpt, u8 *hash);
1967int ubifs_lpt_init(struct ubifs_info *c, int rd, int wr);
1968struct ubifs_lprops *ubifs_lpt_lookup(struct ubifs_info *c, int lnum);
1969struct ubifs_lprops *ubifs_lpt_lookup_dirty(struct ubifs_info *c, int lnum);
1970int ubifs_lpt_scan_nolock(struct ubifs_info *c, int start_lnum, int end_lnum,
1971 ubifs_lpt_scan_callback scan_cb, void *data);
1972
1973/* Shared by lpt.c for lpt_commit.c */
1974void ubifs_pack_lsave(struct ubifs_info *c, void *buf, int *lsave);
1975void ubifs_pack_ltab(struct ubifs_info *c, void *buf,
1976 struct ubifs_lpt_lprops *ltab);
1977void ubifs_pack_pnode(struct ubifs_info *c, void *buf,
1978 struct ubifs_pnode *pnode);
1979void ubifs_pack_nnode(struct ubifs_info *c, void *buf,
1980 struct ubifs_nnode *nnode);
1981struct ubifs_pnode *ubifs_get_pnode(struct ubifs_info *c,
1982 struct ubifs_nnode *parent, int iip);
1983struct ubifs_nnode *ubifs_get_nnode(struct ubifs_info *c,
1984 struct ubifs_nnode *parent, int iip);
1985struct ubifs_pnode *ubifs_pnode_lookup(struct ubifs_info *c, int i);
1986int ubifs_read_nnode(struct ubifs_info *c, struct ubifs_nnode *parent, int iip);
1987void ubifs_add_lpt_dirt(struct ubifs_info *c, int lnum, int dirty);
1988void ubifs_add_nnode_dirt(struct ubifs_info *c, struct ubifs_nnode *nnode);
1989uint32_t ubifs_unpack_bits(const struct ubifs_info *c, uint8_t **addr, int *pos, int nrbits);
1990struct ubifs_nnode *ubifs_first_nnode(struct ubifs_info *c, int *hght);
1991/* Needed only in debugging code in lpt_commit.c */
1992int ubifs_unpack_nnode(const struct ubifs_info *c, void *buf,
1993 struct ubifs_nnode *nnode);
1994int ubifs_lpt_calc_hash(struct ubifs_info *c, u8 *hash);
1995
1996/* lpt_commit.c */
1997int ubifs_lpt_start_commit(struct ubifs_info *c);
1998int ubifs_lpt_end_commit(struct ubifs_info *c);
1999int ubifs_lpt_post_commit(struct ubifs_info *c);
2000void ubifs_lpt_free(struct ubifs_info *c, int wr_only);
2001
2002/* lprops.c */
2003const struct ubifs_lprops *ubifs_change_lp(struct ubifs_info *c,
2004 const struct ubifs_lprops *lp,
2005 int free, int dirty, int flags,
2006 int idx_gc_cnt);
2007void ubifs_get_lp_stats(struct ubifs_info *c, struct ubifs_lp_stats *lst);
2008void ubifs_add_to_cat(struct ubifs_info *c, struct ubifs_lprops *lprops,
2009 int cat);
2010void ubifs_replace_cat(struct ubifs_info *c, struct ubifs_lprops *old_lprops,
2011 struct ubifs_lprops *new_lprops);
2012void ubifs_ensure_cat(struct ubifs_info *c, struct ubifs_lprops *lprops);
2013int ubifs_categorize_lprops(const struct ubifs_info *c,
2014 const struct ubifs_lprops *lprops);
2015int ubifs_change_one_lp(struct ubifs_info *c, int lnum, int free, int dirty,
2016 int flags_set, int flags_clean, int idx_gc_cnt);
2017int ubifs_update_one_lp(struct ubifs_info *c, int lnum, int free, int dirty,
2018 int flags_set, int flags_clean);
2019int ubifs_read_one_lp(struct ubifs_info *c, int lnum, struct ubifs_lprops *lp);
2020const struct ubifs_lprops *ubifs_fast_find_free(struct ubifs_info *c);
2021const struct ubifs_lprops *ubifs_fast_find_empty(struct ubifs_info *c);
2022const struct ubifs_lprops *ubifs_fast_find_freeable(struct ubifs_info *c);
2023const struct ubifs_lprops *ubifs_fast_find_frdi_idx(struct ubifs_info *c);
2024int ubifs_calc_dark(const struct ubifs_info *c, int spc);
2025
2026/* file.c */
2027int ubifs_fsync(struct file *file, loff_t start, loff_t end, int datasync);
2028int ubifs_setattr(struct mnt_idmap *idmap, struct dentry *dentry,
2029 struct iattr *attr);
2030int ubifs_update_time(struct inode *inode, int flags);
2031
2032/* dir.c */
2033struct inode *ubifs_new_inode(struct ubifs_info *c, struct inode *dir,
2034 umode_t mode, bool is_xattr);
2035int ubifs_getattr(struct mnt_idmap *idmap, const struct path *path,
2036 struct kstat *stat, u32 request_mask, unsigned int flags);
2037int ubifs_check_dir_empty(struct inode *dir);
2038
2039/* xattr.c */
2040int ubifs_xattr_set(struct inode *host, const char *name, const void *value,
2041 size_t size, int flags, bool check_lock);
2042ssize_t ubifs_xattr_get(struct inode *host, const char *name, void *buf,
2043 size_t size);
2044
2045#ifdef CONFIG_UBIFS_FS_XATTR
2046extern const struct xattr_handler * const ubifs_xattr_handlers[];
2047ssize_t ubifs_listxattr(struct dentry *dentry, char *buffer, size_t size);
2048void ubifs_evict_xattr_inode(struct ubifs_info *c, ino_t xattr_inum);
2049int ubifs_purge_xattrs(struct inode *host);
2050#else
2051#define ubifs_listxattr NULL
2052#define ubifs_xattr_handlers NULL
2053static inline void ubifs_evict_xattr_inode(struct ubifs_info *c,
2054 ino_t xattr_inum) { }
2055static inline int ubifs_purge_xattrs(struct inode *host)
2056{
2057 return 0;
2058}
2059#endif
2060
2061#ifdef CONFIG_UBIFS_FS_SECURITY
2062extern int ubifs_init_security(struct inode *dentry, struct inode *inode,
2063 const struct qstr *qstr);
2064#else
2065static inline int ubifs_init_security(struct inode *dentry,
2066 struct inode *inode, const struct qstr *qstr)
2067{
2068 return 0;
2069}
2070#endif
2071
2072
2073/* super.c */
2074struct inode *ubifs_iget(struct super_block *sb, unsigned long inum);
2075
2076/* recovery.c */
2077int ubifs_recover_master_node(struct ubifs_info *c);
2078int ubifs_write_rcvrd_mst_node(struct ubifs_info *c);
2079struct ubifs_scan_leb *ubifs_recover_leb(struct ubifs_info *c, int lnum,
2080 int offs, void *sbuf, int jhead);
2081struct ubifs_scan_leb *ubifs_recover_log_leb(struct ubifs_info *c, int lnum,
2082 int offs, void *sbuf);
2083int ubifs_recover_inl_heads(struct ubifs_info *c, void *sbuf);
2084int ubifs_clean_lebs(struct ubifs_info *c, void *sbuf);
2085int ubifs_rcvry_gc_commit(struct ubifs_info *c);
2086int ubifs_recover_size_accum(struct ubifs_info *c, union ubifs_key *key,
2087 int deletion, loff_t new_size);
2088int ubifs_recover_size(struct ubifs_info *c, bool in_place);
2089void ubifs_destroy_size_tree(struct ubifs_info *c);
2090
2091/* ioctl.c */
2092int ubifs_fileattr_get(struct dentry *dentry, struct fileattr *fa);
2093int ubifs_fileattr_set(struct mnt_idmap *idmap,
2094 struct dentry *dentry, struct fileattr *fa);
2095long ubifs_ioctl(struct file *file, unsigned int cmd, unsigned long arg);
2096void ubifs_set_inode_flags(struct inode *inode);
2097#ifdef CONFIG_COMPAT
2098long ubifs_compat_ioctl(struct file *file, unsigned int cmd, unsigned long arg);
2099#endif
2100
2101/* compressor.c */
2102int __init ubifs_compressors_init(void);
2103void ubifs_compressors_exit(void);
2104void ubifs_compress(const struct ubifs_info *c, const void *in_buf, int in_len,
2105 void *out_buf, int *out_len, int *compr_type);
2106int ubifs_decompress(const struct ubifs_info *c, const void *buf, int len,
2107 void *out, int *out_len, int compr_type);
2108
2109/* sysfs.c */
2110int ubifs_sysfs_init(void);
2111void ubifs_sysfs_exit(void);
2112int ubifs_sysfs_register(struct ubifs_info *c);
2113void ubifs_sysfs_unregister(struct ubifs_info *c);
2114
2115#include "debug.h"
2116#include "misc.h"
2117#include "key.h"
2118
2119#ifndef CONFIG_FS_ENCRYPTION
2120static inline int ubifs_encrypt(const struct inode *inode,
2121 struct ubifs_data_node *dn,
2122 unsigned int in_len, unsigned int *out_len,
2123 int block)
2124{
2125 struct ubifs_info *c = inode->i_sb->s_fs_info;
2126 ubifs_assert(c, 0);
2127 return -EOPNOTSUPP;
2128}
2129static inline int ubifs_decrypt(const struct inode *inode,
2130 struct ubifs_data_node *dn,
2131 unsigned int *out_len, int block)
2132{
2133 struct ubifs_info *c = inode->i_sb->s_fs_info;
2134 ubifs_assert(c, 0);
2135 return -EOPNOTSUPP;
2136}
2137#else
2138/* crypto.c */
2139int ubifs_encrypt(const struct inode *inode, struct ubifs_data_node *dn,
2140 unsigned int in_len, unsigned int *out_len, int block);
2141int ubifs_decrypt(const struct inode *inode, struct ubifs_data_node *dn,
2142 unsigned int *out_len, int block);
2143#endif
2144
2145extern const struct fscrypt_operations ubifs_crypt_operations;
2146
2147/* Normal UBIFS messages */
2148__printf(2, 3)
2149void ubifs_msg(const struct ubifs_info *c, const char *fmt, ...);
2150__printf(2, 3)
2151void ubifs_err(const struct ubifs_info *c, const char *fmt, ...);
2152__printf(2, 3)
2153void ubifs_warn(const struct ubifs_info *c, const char *fmt, ...);
2154/*
2155 * A conditional variant of 'ubifs_err()' which doesn't output anything
2156 * if probing (ie. SB_SILENT set).
2157 */
2158#define ubifs_errc(c, fmt, ...) \
2159do { \
2160 if (!(c)->probing) \
2161 ubifs_err(c, fmt, ##__VA_ARGS__); \
2162} while (0)
2163
2164#endif /* !__UBIFS_H__ */
2165

source code of linux/fs/ubifs/ubifs.h