]> git.proxmox.com Git - mirror_ubuntu-focal-kernel.git/blob - fs/jfs/jfs_dtree.h
treewide: Replace GPLv2 boilerplate/reference with SPDX - rule 156
[mirror_ubuntu-focal-kernel.git] / fs / jfs / jfs_dtree.h
1 /* SPDX-License-Identifier: GPL-2.0-or-later */
2 /*
3 * Copyright (C) International Business Machines Corp., 2000-2002
4 */
5 #ifndef _H_JFS_DTREE
6 #define _H_JFS_DTREE
7
8 /*
9 * jfs_dtree.h: directory B+-tree manager
10 */
11
12 #include "jfs_btree.h"
13
14 typedef union {
15 struct {
16 tid_t tid;
17 struct inode *ip;
18 u32 ino;
19 } leaf;
20 pxd_t xd;
21 } ddata_t;
22
23
24 /*
25 * entry segment/slot
26 *
27 * an entry consists of type dependent head/only segment/slot and
28 * additional segments/slots linked vi next field;
29 * N.B. last/only segment of entry is terminated by next = -1;
30 */
31 /*
32 * directory page slot
33 */
34 struct dtslot {
35 s8 next; /* 1: */
36 s8 cnt; /* 1: */
37 __le16 name[15]; /* 30: */
38 }; /* (32) */
39
40
41 #define DATASLOTSIZE 16
42 #define L2DATASLOTSIZE 4
43 #define DTSLOTSIZE 32
44 #define L2DTSLOTSIZE 5
45 #define DTSLOTHDRSIZE 2
46 #define DTSLOTDATASIZE 30
47 #define DTSLOTDATALEN 15
48
49 /*
50 * internal node entry head/only segment
51 */
52 struct idtentry {
53 pxd_t xd; /* 8: child extent descriptor */
54
55 s8 next; /* 1: */
56 u8 namlen; /* 1: */
57 __le16 name[11]; /* 22: 2-byte aligned */
58 }; /* (32) */
59
60 #define DTIHDRSIZE 10
61 #define DTIHDRDATALEN 11
62
63 /* compute number of slots for entry */
64 #define NDTINTERNAL(klen) (DIV_ROUND_UP((4 + (klen)), 15))
65
66
67 /*
68 * leaf node entry head/only segment
69 *
70 * For legacy filesystems, name contains 13 wchars -- no index field
71 */
72 struct ldtentry {
73 __le32 inumber; /* 4: 4-byte aligned */
74 s8 next; /* 1: */
75 u8 namlen; /* 1: */
76 __le16 name[11]; /* 22: 2-byte aligned */
77 __le32 index; /* 4: index into dir_table */
78 }; /* (32) */
79
80 #define DTLHDRSIZE 6
81 #define DTLHDRDATALEN_LEGACY 13 /* Old (OS/2) format */
82 #define DTLHDRDATALEN 11
83
84 /*
85 * dir_table used for directory traversal during readdir
86 */
87
88 /*
89 * Keep persistent index for directory entries
90 */
91 #define DO_INDEX(INODE) (JFS_SBI((INODE)->i_sb)->mntflag & JFS_DIR_INDEX)
92
93 /*
94 * Maximum entry in inline directory table
95 */
96 #define MAX_INLINE_DIRTABLE_ENTRY 13
97
98 struct dir_table_slot {
99 u8 rsrvd; /* 1: */
100 u8 flag; /* 1: 0 if free */
101 u8 slot; /* 1: slot within leaf page of entry */
102 u8 addr1; /* 1: upper 8 bits of leaf page address */
103 __le32 addr2; /* 4: lower 32 bits of leaf page address -OR-
104 index of next entry when this entry was deleted */
105 }; /* (8) */
106
107 /*
108 * flag values
109 */
110 #define DIR_INDEX_VALID 1
111 #define DIR_INDEX_FREE 0
112
113 #define DTSaddress(dir_table_slot, address64)\
114 {\
115 (dir_table_slot)->addr1 = ((u64)address64) >> 32;\
116 (dir_table_slot)->addr2 = __cpu_to_le32((address64) & 0xffffffff);\
117 }
118
119 #define addressDTS(dts)\
120 ( ((s64)((dts)->addr1)) << 32 | __le32_to_cpu((dts)->addr2) )
121
122 /* compute number of slots for entry */
123 #define NDTLEAF_LEGACY(klen) (DIV_ROUND_UP((2 + (klen)), 15))
124 #define NDTLEAF NDTINTERNAL
125
126
127 /*
128 * directory root page (in-line in on-disk inode):
129 *
130 * cf. dtpage_t below.
131 */
132 typedef union {
133 struct {
134 struct dasd DASD; /* 16: DASD limit/usage info */
135
136 u8 flag; /* 1: */
137 u8 nextindex; /* 1: next free entry in stbl */
138 s8 freecnt; /* 1: free count */
139 s8 freelist; /* 1: freelist header */
140
141 __le32 idotdot; /* 4: parent inode number */
142
143 s8 stbl[8]; /* 8: sorted entry index table */
144 } header; /* (32) */
145
146 struct dtslot slot[9];
147 } dtroot_t;
148
149 #define PARENT(IP) \
150 (le32_to_cpu(JFS_IP(IP)->i_dtroot.header.idotdot))
151
152 #define DTROOTMAXSLOT 9
153
154 #define dtEmpty(IP) (JFS_IP(IP)->i_dtroot.header.nextindex == 0)
155
156
157 /*
158 * directory regular page:
159 *
160 * entry slot array of 32 byte slot
161 *
162 * sorted entry slot index table (stbl):
163 * contiguous slots at slot specified by stblindex,
164 * 1-byte per entry
165 * 512 byte block: 16 entry tbl (1 slot)
166 * 1024 byte block: 32 entry tbl (1 slot)
167 * 2048 byte block: 64 entry tbl (2 slot)
168 * 4096 byte block: 128 entry tbl (4 slot)
169 *
170 * data area:
171 * 512 byte block: 16 - 2 = 14 slot
172 * 1024 byte block: 32 - 2 = 30 slot
173 * 2048 byte block: 64 - 3 = 61 slot
174 * 4096 byte block: 128 - 5 = 123 slot
175 *
176 * N.B. index is 0-based; index fields refer to slot index
177 * except nextindex which refers to entry index in stbl;
178 * end of entry stot list or freelist is marked with -1.
179 */
180 typedef union {
181 struct {
182 __le64 next; /* 8: next sibling */
183 __le64 prev; /* 8: previous sibling */
184
185 u8 flag; /* 1: */
186 u8 nextindex; /* 1: next entry index in stbl */
187 s8 freecnt; /* 1: */
188 s8 freelist; /* 1: slot index of head of freelist */
189
190 u8 maxslot; /* 1: number of slots in page slot[] */
191 u8 stblindex; /* 1: slot index of start of stbl */
192 u8 rsrvd[2]; /* 2: */
193
194 pxd_t self; /* 8: self pxd */
195 } header; /* (32) */
196
197 struct dtslot slot[128];
198 } dtpage_t;
199
200 #define DTPAGEMAXSLOT 128
201
202 #define DT8THPGNODEBYTES 512
203 #define DT8THPGNODETSLOTS 1
204 #define DT8THPGNODESLOTS 16
205
206 #define DTQTRPGNODEBYTES 1024
207 #define DTQTRPGNODETSLOTS 1
208 #define DTQTRPGNODESLOTS 32
209
210 #define DTHALFPGNODEBYTES 2048
211 #define DTHALFPGNODETSLOTS 2
212 #define DTHALFPGNODESLOTS 64
213
214 #define DTFULLPGNODEBYTES 4096
215 #define DTFULLPGNODETSLOTS 4
216 #define DTFULLPGNODESLOTS 128
217
218 #define DTENTRYSTART 1
219
220 /* get sorted entry table of the page */
221 #define DT_GETSTBL(p) ( ((p)->header.flag & BT_ROOT) ?\
222 ((dtroot_t *)(p))->header.stbl : \
223 (s8 *)&(p)->slot[(p)->header.stblindex] )
224
225 /*
226 * Flags for dtSearch
227 */
228 #define JFS_CREATE 1
229 #define JFS_LOOKUP 2
230 #define JFS_REMOVE 3
231 #define JFS_RENAME 4
232
233 /*
234 * Maximum file offset for directories.
235 */
236 #define DIREND INT_MAX
237
238 /*
239 * external declarations
240 */
241 extern void dtInitRoot(tid_t tid, struct inode *ip, u32 idotdot);
242
243 extern int dtSearch(struct inode *ip, struct component_name * key,
244 ino_t * data, struct btstack * btstack, int flag);
245
246 extern int dtInsert(tid_t tid, struct inode *ip, struct component_name * key,
247 ino_t * ino, struct btstack * btstack);
248
249 extern int dtDelete(tid_t tid, struct inode *ip, struct component_name * key,
250 ino_t * data, int flag);
251
252 extern int dtModify(tid_t tid, struct inode *ip, struct component_name * key,
253 ino_t * orig_ino, ino_t new_ino, int flag);
254
255 extern int jfs_readdir(struct file *file, struct dir_context *ctx);
256 #endif /* !_H_JFS_DTREE */