xref: /linux-6.15/fs/ext4/fast_commit.h (revision aa75f4d3)
1 /* SPDX-License-Identifier: GPL-2.0 */
2 
3 #ifndef __FAST_COMMIT_H__
4 #define __FAST_COMMIT_H__
5 
6 /* Number of blocks in journal area to allocate for fast commits */
7 #define EXT4_NUM_FC_BLKS		256
8 
9 /* Fast commit tags */
10 #define EXT4_FC_TAG_ADD_RANGE		0x0001
11 #define EXT4_FC_TAG_DEL_RANGE		0x0002
12 #define EXT4_FC_TAG_CREAT		0x0003
13 #define EXT4_FC_TAG_LINK		0x0004
14 #define EXT4_FC_TAG_UNLINK		0x0005
15 #define EXT4_FC_TAG_INODE		0x0006
16 #define EXT4_FC_TAG_PAD			0x0007
17 #define EXT4_FC_TAG_TAIL		0x0008
18 #define EXT4_FC_TAG_HEAD		0x0009
19 
20 #define EXT4_FC_SUPPORTED_FEATURES	0x0
21 
22 /* On disk fast commit tlv value structures */
23 
24 /* Fast commit on disk tag length structure */
25 struct ext4_fc_tl {
26 	__le16 fc_tag;
27 	__le16 fc_len;
28 };
29 
30 /* Value structure for tag EXT4_FC_TAG_HEAD. */
31 struct ext4_fc_head {
32 	__le32 fc_features;
33 	__le32 fc_tid;
34 };
35 
36 /* Value structure for EXT4_FC_TAG_ADD_RANGE. */
37 struct ext4_fc_add_range {
38 	__le32 fc_ino;
39 	__u8 fc_ex[12];
40 };
41 
42 /* Value structure for tag EXT4_FC_TAG_DEL_RANGE. */
43 struct ext4_fc_del_range {
44 	__le32 fc_ino;
45 	__le32 fc_lblk;
46 	__le32 fc_len;
47 };
48 
49 /*
50  * This is the value structure for tags EXT4_FC_TAG_CREAT, EXT4_FC_TAG_LINK
51  * and EXT4_FC_TAG_UNLINK.
52  */
53 struct ext4_fc_dentry_info {
54 	__le32 fc_parent_ino;
55 	__le32 fc_ino;
56 	u8 fc_dname[0];
57 };
58 
59 /* Value structure for EXT4_FC_TAG_INODE and EXT4_FC_TAG_INODE_PARTIAL. */
60 struct ext4_fc_inode {
61 	__le32 fc_ino;
62 	__u8 fc_raw_inode[0];
63 };
64 
65 /* Value structure for tag EXT4_FC_TAG_TAIL. */
66 struct ext4_fc_tail {
67 	__le32 fc_tid;
68 	__le32 fc_crc;
69 };
70 
71 /*
72  * In memory list of dentry updates that are performed on the file
73  * system used by fast commit code.
74  */
75 struct ext4_fc_dentry_update {
76 	int fcd_op;		/* Type of update create / unlink / link */
77 	int fcd_parent;		/* Parent inode number */
78 	int fcd_ino;		/* Inode number */
79 	struct qstr fcd_name;	/* Dirent name */
80 	unsigned char fcd_iname[DNAME_INLINE_LEN];	/* Dirent name string */
81 	struct list_head fcd_list;
82 };
83 
84 /*
85  * Fast commit reason codes
86  */
87 enum {
88 	/*
89 	 * Commit status codes:
90 	 */
91 	EXT4_FC_REASON_OK = 0,
92 	EXT4_FC_REASON_INELIGIBLE,
93 	EXT4_FC_REASON_ALREADY_COMMITTED,
94 	EXT4_FC_REASON_FC_START_FAILED,
95 	EXT4_FC_REASON_FC_FAILED,
96 
97 	/*
98 	 * Fast commit ineligiblity reasons:
99 	 */
100 	EXT4_FC_REASON_XATTR = 0,
101 	EXT4_FC_REASON_CROSS_RENAME,
102 	EXT4_FC_REASON_JOURNAL_FLAG_CHANGE,
103 	EXT4_FC_REASON_MEM,
104 	EXT4_FC_REASON_SWAP_BOOT,
105 	EXT4_FC_REASON_RESIZE,
106 	EXT4_FC_REASON_RENAME_DIR,
107 	EXT4_FC_REASON_FALLOC_RANGE,
108 	EXT4_FC_COMMIT_FAILED,
109 	EXT4_FC_REASON_MAX
110 };
111 
112 struct ext4_fc_stats {
113 	unsigned int fc_ineligible_reason_count[EXT4_FC_REASON_MAX];
114 	unsigned long fc_num_commits;
115 	unsigned long fc_ineligible_commits;
116 	unsigned long fc_numblks;
117 };
118 
119 #endif /* __FAST_COMMIT_H__ */
120