xref: /linux/fs/exfat/exfat_fs.h (revision 1553a1c48281243359a9529a10ddb551f3b967ab)
1 /* SPDX-License-Identifier: GPL-2.0-or-later */
2 /*
3  * Copyright (C) 2012-2013 Samsung Electronics Co., Ltd.
4  */
5 
6 #ifndef _EXFAT_FS_H
7 #define _EXFAT_FS_H
8 
9 #include <linux/fs.h>
10 #include <linux/ratelimit.h>
11 #include <linux/nls.h>
12 #include <linux/blkdev.h>
13 
14 #define EXFAT_ROOT_INO		1
15 
16 #define EXFAT_CLUSTERS_UNTRACKED (~0u)
17 
18 /*
19  * exfat error flags
20  */
21 enum exfat_error_mode {
22 	EXFAT_ERRORS_CONT,	/* ignore error and continue */
23 	EXFAT_ERRORS_PANIC,	/* panic on error */
24 	EXFAT_ERRORS_RO,	/* remount r/o on error */
25 };
26 
27 /*
28  * exfat nls lossy flag
29  */
30 enum {
31 	NLS_NAME_NO_LOSSY =	0,	/* no lossy */
32 	NLS_NAME_LOSSY =	1 << 0,	/* just detected incorrect filename(s) */
33 	NLS_NAME_OVERLEN =	1 << 1,	/* the length is over than its limit */
34 };
35 
36 #define EXFAT_HASH_BITS		8
37 #define EXFAT_HASH_SIZE		(1UL << EXFAT_HASH_BITS)
38 
39 /*
40  * Type Definitions
41  */
42 #define ES_2_ENTRIES		2
43 #define ES_ALL_ENTRIES		0
44 
45 #define ES_IDX_FILE		0
46 #define ES_IDX_STREAM		1
47 #define ES_IDX_FIRST_FILENAME	2
48 #define EXFAT_FILENAME_ENTRY_NUM(name_len) \
49 	DIV_ROUND_UP(name_len, EXFAT_FILE_NAME_LEN)
50 #define ES_IDX_LAST_FILENAME(name_len)	\
51 	(ES_IDX_FIRST_FILENAME + EXFAT_FILENAME_ENTRY_NUM(name_len) - 1)
52 
53 #define DIR_DELETED		0xFFFFFFF7
54 
55 /* type values */
56 #define TYPE_UNUSED		0x0000
57 #define TYPE_DELETED		0x0001
58 #define TYPE_INVALID		0x0002
59 #define TYPE_CRITICAL_PRI	0x0100
60 #define TYPE_BITMAP		0x0101
61 #define TYPE_UPCASE		0x0102
62 #define TYPE_VOLUME		0x0103
63 #define TYPE_DIR		0x0104
64 #define TYPE_FILE		0x011F
65 #define TYPE_CRITICAL_SEC	0x0200
66 #define TYPE_STREAM		0x0201
67 #define TYPE_EXTEND		0x0202
68 #define TYPE_ACL		0x0203
69 #define TYPE_BENIGN_PRI		0x0400
70 #define TYPE_GUID		0x0401
71 #define TYPE_PADDING		0x0402
72 #define TYPE_ACLTAB		0x0403
73 #define TYPE_BENIGN_SEC		0x0800
74 #define TYPE_VENDOR_EXT		0x0801
75 #define TYPE_VENDOR_ALLOC	0x0802
76 
77 #define MAX_CHARSET_SIZE	6 /* max size of multi-byte character */
78 #define MAX_NAME_LENGTH		255 /* max len of file name excluding NULL */
79 #define MAX_VFSNAME_BUF_SIZE	((MAX_NAME_LENGTH + 1) * MAX_CHARSET_SIZE)
80 
81 #define EXFAT_HINT_NONE		-1
82 #define EXFAT_MIN_SUBDIR	2
83 
84 /*
85  * helpers for cluster size to byte conversion.
86  */
87 #define EXFAT_CLU_TO_B(b, sbi)		((b) << (sbi)->cluster_size_bits)
88 #define EXFAT_B_TO_CLU(b, sbi)		((b) >> (sbi)->cluster_size_bits)
89 #define EXFAT_B_TO_CLU_ROUND_UP(b, sbi)	\
90 	(((b - 1) >> (sbi)->cluster_size_bits) + 1)
91 #define EXFAT_CLU_OFFSET(off, sbi)	((off) & ((sbi)->cluster_size - 1))
92 
93 /*
94  * helpers for block size to byte conversion.
95  */
96 #define EXFAT_BLK_TO_B(b, sb)		((b) << (sb)->s_blocksize_bits)
97 #define EXFAT_B_TO_BLK(b, sb)		((b) >> (sb)->s_blocksize_bits)
98 #define EXFAT_B_TO_BLK_ROUND_UP(b, sb)	\
99 	(((b - 1) >> (sb)->s_blocksize_bits) + 1)
100 #define EXFAT_BLK_OFFSET(off, sb)	((off) & ((sb)->s_blocksize - 1))
101 
102 /*
103  * helpers for block size to dentry size conversion.
104  */
105 #define EXFAT_B_TO_DEN(b)		((b) >> DENTRY_SIZE_BITS)
106 #define EXFAT_DEN_TO_B(b)		((b) << DENTRY_SIZE_BITS)
107 
108 /*
109  * helpers for cluster size to dentry size conversion.
110  */
111 #define EXFAT_CLU_TO_DEN(clu, sbi)	\
112 	((clu) << ((sbi)->cluster_size_bits - DENTRY_SIZE_BITS))
113 #define EXFAT_DEN_TO_CLU(dentry, sbi)	\
114 	((dentry) >> ((sbi)->cluster_size_bits - DENTRY_SIZE_BITS))
115 
116 /*
117  * helpers for fat entry.
118  */
119 #define FAT_ENT_SIZE (4)
120 #define FAT_ENT_SIZE_BITS (2)
121 #define FAT_ENT_OFFSET_SECTOR(sb, loc) (EXFAT_SB(sb)->FAT1_start_sector + \
122 	(((u64)loc << FAT_ENT_SIZE_BITS) >> sb->s_blocksize_bits))
123 #define FAT_ENT_OFFSET_BYTE_IN_SECTOR(sb, loc)	\
124 	((loc << FAT_ENT_SIZE_BITS) & (sb->s_blocksize - 1))
125 
126 /*
127  * helpers for bitmap.
128  */
129 #define CLUSTER_TO_BITMAP_ENT(clu) ((clu) - EXFAT_RESERVED_CLUSTERS)
130 #define BITMAP_ENT_TO_CLUSTER(ent) ((ent) + EXFAT_RESERVED_CLUSTERS)
131 #define BITS_PER_SECTOR(sb) ((sb)->s_blocksize * BITS_PER_BYTE)
132 #define BITS_PER_SECTOR_MASK(sb) (BITS_PER_SECTOR(sb) - 1)
133 #define BITMAP_OFFSET_SECTOR_INDEX(sb, ent) \
134 	((ent / BITS_PER_BYTE) >> (sb)->s_blocksize_bits)
135 #define BITMAP_OFFSET_BIT_IN_SECTOR(sb, ent) (ent & BITS_PER_SECTOR_MASK(sb))
136 #define BITMAP_OFFSET_BYTE_IN_SECTOR(sb, ent) \
137 	((ent / BITS_PER_BYTE) & ((sb)->s_blocksize - 1))
138 #define IGNORED_BITS_REMAINED(clu, clu_base) ((1UL << ((clu) - (clu_base))) - 1)
139 
140 #define ES_ENTRY_NUM(name_len)	(ES_IDX_LAST_FILENAME(name_len) + 1)
141 /* 19 entries = 1 file entry + 1 stream entry + 17 filename entries */
142 #define ES_MAX_ENTRY_NUM	ES_ENTRY_NUM(MAX_NAME_LENGTH)
143 
144 /*
145  * 19 entries x 32 bytes/entry = 608 bytes.
146  * The 608 bytes are in 3 sectors at most (even 512 Byte sector).
147  */
148 #define DIR_CACHE_SIZE		\
149 	(DIV_ROUND_UP(EXFAT_DEN_TO_B(ES_MAX_ENTRY_NUM), SECTOR_SIZE) + 1)
150 
151 struct exfat_dentry_namebuf {
152 	char *lfn;
153 	int lfnbuf_len; /* usually MAX_UNINAME_BUF_SIZE */
154 };
155 
156 /* unicode name structure */
157 struct exfat_uni_name {
158 	/* +3 for null and for converting */
159 	unsigned short name[MAX_NAME_LENGTH + 3];
160 	u16 name_hash;
161 	unsigned char name_len;
162 };
163 
164 /* directory structure */
165 struct exfat_chain {
166 	unsigned int dir;
167 	unsigned int size;
168 	unsigned char flags;
169 };
170 
171 /* first empty entry hint information */
172 struct exfat_hint_femp {
173 	/* entry index of a directory */
174 	int eidx;
175 	/* count of continuous empty entry */
176 	int count;
177 	/* the cluster that first empty slot exists in */
178 	struct exfat_chain cur;
179 };
180 
181 /* hint structure */
182 struct exfat_hint {
183 	unsigned int clu;
184 	union {
185 		unsigned int off; /* cluster offset */
186 		int eidx; /* entry index */
187 	};
188 };
189 
190 struct exfat_entry_set_cache {
191 	struct super_block *sb;
192 	unsigned int start_off;
193 	int num_bh;
194 	struct buffer_head *__bh[DIR_CACHE_SIZE];
195 	struct buffer_head **bh;
196 	unsigned int num_entries;
197 	bool modified;
198 };
199 
200 #define IS_DYNAMIC_ES(es)	((es)->__bh != (es)->bh)
201 
202 struct exfat_dir_entry {
203 	struct exfat_chain dir;
204 	int entry;
205 	unsigned int type;
206 	unsigned int start_clu;
207 	unsigned char flags;
208 	unsigned short attr;
209 	loff_t size;
210 	loff_t valid_size;
211 	unsigned int num_subdirs;
212 	struct timespec64 atime;
213 	struct timespec64 mtime;
214 	struct timespec64 crtime;
215 	struct exfat_dentry_namebuf namebuf;
216 };
217 
218 /*
219  * exfat mount in-memory data
220  */
221 struct exfat_mount_options {
222 	kuid_t fs_uid;
223 	kgid_t fs_gid;
224 	unsigned short fs_fmask;
225 	unsigned short fs_dmask;
226 	/* permission for setting the [am]time */
227 	unsigned short allow_utime;
228 	/* charset for filename input/display */
229 	char *iocharset;
230 	/* on error: continue, panic, remount-ro */
231 	enum exfat_error_mode errors;
232 	unsigned utf8:1, /* Use of UTF-8 character set */
233 		 sys_tz:1, /* Use local timezone */
234 		 discard:1, /* Issue discard requests on deletions */
235 		 keep_last_dots:1; /* Keep trailing periods in paths */
236 	int time_offset; /* Offset of timestamps from UTC (in minutes) */
237 	/* Support creating zero-size directory, default: false */
238 	bool zero_size_dir;
239 };
240 
241 /*
242  * EXFAT file system superblock in-memory data
243  */
244 struct exfat_sb_info {
245 	unsigned long long num_sectors; /* num of sectors in volume */
246 	unsigned int num_clusters; /* num of clusters in volume */
247 	unsigned int cluster_size; /* cluster size in bytes */
248 	unsigned int cluster_size_bits;
249 	unsigned int sect_per_clus; /* cluster size in sectors */
250 	unsigned int sect_per_clus_bits;
251 	unsigned long long FAT1_start_sector; /* FAT1 start sector */
252 	unsigned long long FAT2_start_sector; /* FAT2 start sector */
253 	unsigned long long data_start_sector; /* data area start sector */
254 	unsigned int num_FAT_sectors; /* num of FAT sectors */
255 	unsigned int root_dir; /* root dir cluster */
256 	unsigned int dentries_per_clu; /* num of dentries per cluster */
257 	unsigned int vol_flags; /* volume flags */
258 	unsigned int vol_flags_persistent; /* volume flags to retain */
259 	struct buffer_head *boot_bh; /* buffer_head of BOOT sector */
260 
261 	unsigned int map_clu; /* allocation bitmap start cluster */
262 	unsigned int map_sectors; /* num of allocation bitmap sectors */
263 	struct buffer_head **vol_amap; /* allocation bitmap */
264 
265 	unsigned short *vol_utbl; /* upcase table */
266 
267 	unsigned int clu_srch_ptr; /* cluster search pointer */
268 	unsigned int used_clusters; /* number of used clusters */
269 
270 	struct mutex s_lock; /* superblock lock */
271 	struct mutex bitmap_lock; /* bitmap lock */
272 	struct exfat_mount_options options;
273 	struct nls_table *nls_io; /* Charset used for input and display */
274 	struct ratelimit_state ratelimit;
275 
276 	spinlock_t inode_hash_lock;
277 	struct hlist_head inode_hashtable[EXFAT_HASH_SIZE];
278 	struct rcu_head rcu;
279 };
280 
281 #define EXFAT_CACHE_VALID	0
282 
283 /*
284  * EXFAT file system inode in-memory data
285  */
286 struct exfat_inode_info {
287 	struct exfat_chain dir;
288 	int entry;
289 	unsigned int type;
290 	unsigned short attr;
291 	unsigned int start_clu;
292 	unsigned char flags;
293 	/*
294 	 * the copy of low 32bit of i_version to check
295 	 * the validation of hint_stat.
296 	 */
297 	unsigned int version;
298 
299 	/* hint for cluster last accessed */
300 	struct exfat_hint hint_bmap;
301 	/* hint for entry index we try to lookup next time */
302 	struct exfat_hint hint_stat;
303 	/* hint for first empty entry */
304 	struct exfat_hint_femp hint_femp;
305 
306 	spinlock_t cache_lru_lock;
307 	struct list_head cache_lru;
308 	int nr_caches;
309 	/* for avoiding the race between alloc and free */
310 	unsigned int cache_valid_id;
311 
312 	/*
313 	 * NOTE: i_size_ondisk is 64bits, so must hold ->inode_lock to access.
314 	 * physically allocated size.
315 	 */
316 	loff_t i_size_ondisk;
317 	/* block-aligned i_size (used in cont_write_begin) */
318 	loff_t i_size_aligned;
319 	/* on-disk position of directory entry or 0 */
320 	loff_t i_pos;
321 	loff_t valid_size;
322 	/* hash by i_location */
323 	struct hlist_node i_hash_fat;
324 	/* protect bmap against truncate */
325 	struct rw_semaphore truncate_lock;
326 	struct inode vfs_inode;
327 	/* File creation time */
328 	struct timespec64 i_crtime;
329 };
330 
331 static inline struct exfat_sb_info *EXFAT_SB(struct super_block *sb)
332 {
333 	return sb->s_fs_info;
334 }
335 
336 static inline struct exfat_inode_info *EXFAT_I(struct inode *inode)
337 {
338 	return container_of(inode, struct exfat_inode_info, vfs_inode);
339 }
340 
341 /*
342  * If ->i_mode can't hold 0222 (i.e. ATTR_RO), we use ->i_attrs to
343  * save ATTR_RO instead of ->i_mode.
344  *
345  * If it's directory and !sbi->options.rodir, ATTR_RO isn't read-only
346  * bit, it's just used as flag for app.
347  */
348 static inline int exfat_mode_can_hold_ro(struct inode *inode)
349 {
350 	struct exfat_sb_info *sbi = EXFAT_SB(inode->i_sb);
351 
352 	if (S_ISDIR(inode->i_mode))
353 		return 0;
354 
355 	if ((~sbi->options.fs_fmask) & 0222)
356 		return 1;
357 	return 0;
358 }
359 
360 /* Convert attribute bits and a mask to the UNIX mode. */
361 static inline mode_t exfat_make_mode(struct exfat_sb_info *sbi,
362 		unsigned short attr, mode_t mode)
363 {
364 	if ((attr & EXFAT_ATTR_READONLY) && !(attr & EXFAT_ATTR_SUBDIR))
365 		mode &= ~0222;
366 
367 	if (attr & EXFAT_ATTR_SUBDIR)
368 		return (mode & ~sbi->options.fs_dmask) | S_IFDIR;
369 
370 	return (mode & ~sbi->options.fs_fmask) | S_IFREG;
371 }
372 
373 /* Return the FAT attribute byte for this inode */
374 static inline unsigned short exfat_make_attr(struct inode *inode)
375 {
376 	unsigned short attr = EXFAT_I(inode)->attr;
377 
378 	if (S_ISDIR(inode->i_mode))
379 		attr |= EXFAT_ATTR_SUBDIR;
380 	if (exfat_mode_can_hold_ro(inode) && !(inode->i_mode & 0222))
381 		attr |= EXFAT_ATTR_READONLY;
382 	return attr;
383 }
384 
385 static inline void exfat_save_attr(struct inode *inode, unsigned short attr)
386 {
387 	if (exfat_mode_can_hold_ro(inode))
388 		EXFAT_I(inode)->attr = attr & (EXFAT_ATTR_RWMASK | EXFAT_ATTR_READONLY);
389 	else
390 		EXFAT_I(inode)->attr = attr & EXFAT_ATTR_RWMASK;
391 }
392 
393 static inline bool exfat_is_last_sector_in_cluster(struct exfat_sb_info *sbi,
394 		sector_t sec)
395 {
396 	return ((sec - sbi->data_start_sector + 1) &
397 		((1 << sbi->sect_per_clus_bits) - 1)) == 0;
398 }
399 
400 static inline sector_t exfat_cluster_to_sector(struct exfat_sb_info *sbi,
401 		unsigned int clus)
402 {
403 	return ((sector_t)(clus - EXFAT_RESERVED_CLUSTERS) << sbi->sect_per_clus_bits) +
404 		sbi->data_start_sector;
405 }
406 
407 static inline unsigned int exfat_sector_to_cluster(struct exfat_sb_info *sbi,
408 		sector_t sec)
409 {
410 	return ((sec - sbi->data_start_sector) >> sbi->sect_per_clus_bits) +
411 		EXFAT_RESERVED_CLUSTERS;
412 }
413 
414 static inline bool is_valid_cluster(struct exfat_sb_info *sbi,
415 		unsigned int clus)
416 {
417 	return clus >= EXFAT_FIRST_CLUSTER && clus < sbi->num_clusters;
418 }
419 
420 /* super.c */
421 int exfat_set_volume_dirty(struct super_block *sb);
422 int exfat_clear_volume_dirty(struct super_block *sb);
423 
424 /* fatent.c */
425 #define exfat_get_next_cluster(sb, pclu) exfat_ent_get(sb, *(pclu), pclu)
426 
427 int exfat_alloc_cluster(struct inode *inode, unsigned int num_alloc,
428 		struct exfat_chain *p_chain, bool sync_bmap);
429 int exfat_free_cluster(struct inode *inode, struct exfat_chain *p_chain);
430 int exfat_ent_get(struct super_block *sb, unsigned int loc,
431 		unsigned int *content);
432 int exfat_ent_set(struct super_block *sb, unsigned int loc,
433 		unsigned int content);
434 int exfat_chain_cont_cluster(struct super_block *sb, unsigned int chain,
435 		unsigned int len);
436 int exfat_zeroed_cluster(struct inode *dir, unsigned int clu);
437 int exfat_find_last_cluster(struct super_block *sb, struct exfat_chain *p_chain,
438 		unsigned int *ret_clu);
439 int exfat_count_num_clusters(struct super_block *sb,
440 		struct exfat_chain *p_chain, unsigned int *ret_count);
441 
442 /* balloc.c */
443 int exfat_load_bitmap(struct super_block *sb);
444 void exfat_free_bitmap(struct exfat_sb_info *sbi);
445 int exfat_set_bitmap(struct inode *inode, unsigned int clu, bool sync);
446 void exfat_clear_bitmap(struct inode *inode, unsigned int clu, bool sync);
447 unsigned int exfat_find_free_bitmap(struct super_block *sb, unsigned int clu);
448 int exfat_count_used_clusters(struct super_block *sb, unsigned int *ret_count);
449 int exfat_trim_fs(struct inode *inode, struct fstrim_range *range);
450 
451 /* file.c */
452 extern const struct file_operations exfat_file_operations;
453 int __exfat_truncate(struct inode *inode);
454 void exfat_truncate(struct inode *inode);
455 int exfat_setattr(struct mnt_idmap *idmap, struct dentry *dentry,
456 		  struct iattr *attr);
457 int exfat_getattr(struct mnt_idmap *idmap, const struct path *path,
458 		  struct kstat *stat, unsigned int request_mask,
459 		  unsigned int query_flags);
460 int exfat_file_fsync(struct file *file, loff_t start, loff_t end, int datasync);
461 long exfat_ioctl(struct file *filp, unsigned int cmd, unsigned long arg);
462 long exfat_compat_ioctl(struct file *filp, unsigned int cmd,
463 				unsigned long arg);
464 
465 /* namei.c */
466 extern const struct dentry_operations exfat_dentry_ops;
467 extern const struct dentry_operations exfat_utf8_dentry_ops;
468 
469 /* cache.c */
470 int exfat_cache_init(void);
471 void exfat_cache_shutdown(void);
472 void exfat_cache_inval_inode(struct inode *inode);
473 int exfat_get_cluster(struct inode *inode, unsigned int cluster,
474 		unsigned int *fclus, unsigned int *dclus,
475 		unsigned int *last_dclus, int allow_eof);
476 
477 /* dir.c */
478 extern const struct inode_operations exfat_dir_inode_operations;
479 extern const struct file_operations exfat_dir_operations;
480 unsigned int exfat_get_entry_type(struct exfat_dentry *p_entry);
481 void exfat_init_dir_entry(struct exfat_entry_set_cache *es,
482 		unsigned int type, unsigned int start_clu,
483 		unsigned long long size, struct timespec64 *ts);
484 void exfat_init_ext_entry(struct exfat_entry_set_cache *es, int num_entries,
485 		struct exfat_uni_name *p_uniname);
486 void exfat_remove_entries(struct inode *inode, struct exfat_entry_set_cache *es,
487 		int order);
488 void exfat_update_dir_chksum(struct exfat_entry_set_cache *es);
489 int exfat_calc_num_entries(struct exfat_uni_name *p_uniname);
490 int exfat_find_dir_entry(struct super_block *sb, struct exfat_inode_info *ei,
491 		struct exfat_chain *p_dir, struct exfat_uni_name *p_uniname,
492 		struct exfat_hint *hint_opt);
493 int exfat_alloc_new_dir(struct inode *inode, struct exfat_chain *clu);
494 struct exfat_dentry *exfat_get_dentry(struct super_block *sb,
495 		struct exfat_chain *p_dir, int entry, struct buffer_head **bh);
496 struct exfat_dentry *exfat_get_dentry_cached(struct exfat_entry_set_cache *es,
497 		int num);
498 int exfat_get_dentry_set(struct exfat_entry_set_cache *es,
499 		struct super_block *sb, struct exfat_chain *p_dir, int entry,
500 		unsigned int num_entries);
501 int exfat_get_empty_dentry_set(struct exfat_entry_set_cache *es,
502 		struct super_block *sb, struct exfat_chain *p_dir, int entry,
503 		unsigned int num_entries);
504 int exfat_put_dentry_set(struct exfat_entry_set_cache *es, int sync);
505 int exfat_count_dir_entries(struct super_block *sb, struct exfat_chain *p_dir);
506 
507 /* inode.c */
508 extern const struct inode_operations exfat_file_inode_operations;
509 void exfat_sync_inode(struct inode *inode);
510 struct inode *exfat_build_inode(struct super_block *sb,
511 		struct exfat_dir_entry *info, loff_t i_pos);
512 void exfat_hash_inode(struct inode *inode, loff_t i_pos);
513 void exfat_unhash_inode(struct inode *inode);
514 struct inode *exfat_iget(struct super_block *sb, loff_t i_pos);
515 int __exfat_write_inode(struct inode *inode, int sync);
516 int exfat_write_inode(struct inode *inode, struct writeback_control *wbc);
517 void exfat_evict_inode(struct inode *inode);
518 int exfat_block_truncate_page(struct inode *inode, loff_t from);
519 
520 /* exfat/nls.c */
521 unsigned short exfat_toupper(struct super_block *sb, unsigned short a);
522 int exfat_uniname_ncmp(struct super_block *sb, unsigned short *a,
523 		unsigned short *b, unsigned int len);
524 int exfat_utf16_to_nls(struct super_block *sb,
525 		struct exfat_uni_name *uniname, unsigned char *p_cstring,
526 		int len);
527 int exfat_nls_to_utf16(struct super_block *sb,
528 		const unsigned char *p_cstring, const int len,
529 		struct exfat_uni_name *uniname, int *p_lossy);
530 int exfat_create_upcase_table(struct super_block *sb);
531 void exfat_free_upcase_table(struct exfat_sb_info *sbi);
532 
533 /* exfat/misc.c */
534 void __exfat_fs_error(struct super_block *sb, int report, const char *fmt, ...)
535 		__printf(3, 4) __cold;
536 #define exfat_fs_error(sb, fmt, args...)          \
537 		__exfat_fs_error(sb, 1, fmt, ## args)
538 #define exfat_fs_error_ratelimit(sb, fmt, args...) \
539 		__exfat_fs_error(sb, __ratelimit(&EXFAT_SB(sb)->ratelimit), \
540 		fmt, ## args)
541 
542 /* expand to pr_*() with prefix */
543 #define exfat_err(sb, fmt, ...)						\
544 	pr_err("exFAT-fs (%s): " fmt "\n", (sb)->s_id, ##__VA_ARGS__)
545 #define exfat_warn(sb, fmt, ...)					\
546 	pr_warn("exFAT-fs (%s): " fmt "\n", (sb)->s_id, ##__VA_ARGS__)
547 #define exfat_info(sb, fmt, ...)					\
548 	pr_info("exFAT-fs (%s): " fmt "\n", (sb)->s_id, ##__VA_ARGS__)
549 #define exfat_debug(sb, fmt, ...)					\
550 	pr_debug("exFAT-fs (%s): " fmt "\n", (sb)->s_id, ##__VA_ARGS__)
551 
552 void exfat_get_entry_time(struct exfat_sb_info *sbi, struct timespec64 *ts,
553 		u8 tz, __le16 time, __le16 date, u8 time_cs);
554 void exfat_truncate_atime(struct timespec64 *ts);
555 void exfat_truncate_inode_atime(struct inode *inode);
556 void exfat_set_entry_time(struct exfat_sb_info *sbi, struct timespec64 *ts,
557 		u8 *tz, __le16 *time, __le16 *date, u8 *time_cs);
558 u16 exfat_calc_chksum16(void *data, int len, u16 chksum, int type);
559 u32 exfat_calc_chksum32(void *data, int len, u32 chksum, int type);
560 void exfat_update_bh(struct buffer_head *bh, int sync);
561 int exfat_update_bhs(struct buffer_head **bhs, int nr_bhs, int sync);
562 void exfat_chain_set(struct exfat_chain *ec, unsigned int dir,
563 		unsigned int size, unsigned char flags);
564 void exfat_chain_dup(struct exfat_chain *dup, struct exfat_chain *ec);
565 
566 #endif /* !_EXFAT_FS_H */
567