blob: d509887c580ceedba9ab003cb390417aeab993e9 [file] [log] [blame]
Linus Torvalds1da177e2005-04-16 15:20:36 -07001/*
2 * linux/fs/befs/btree.c
3 *
4 * Copyright (C) 2001-2002 Will Dyson <will_dyson@pobox.com>
5 *
6 * Licensed under the GNU GPL. See the file COPYING for details.
7 *
Lucas De Marchi25985ed2011-03-30 22:57:33 -03008 * 2002-02-05: Sergey S. Kostyliov added binary search within
Linus Torvalds1da177e2005-04-16 15:20:36 -07009 * btree nodes.
10 *
11 * Many thanks to:
12 *
13 * Dominic Giampaolo, author of "Practical File System
14 * Design with the Be File System", for such a helpful book.
Luis de Bethencourte60f7492016-11-10 11:25:36 +000015 *
16 * Marcus J. Ranum, author of the b+tree package in
Linus Torvalds1da177e2005-04-16 15:20:36 -070017 * comp.sources.misc volume 10. This code is not copied from that
18 * work, but it is partially based on it.
19 *
20 * Makoto Kato, author of the original BeFS for linux filesystem
21 * driver.
22 */
23
24#include <linux/kernel.h>
25#include <linux/string.h>
26#include <linux/slab.h>
27#include <linux/mm.h>
28#include <linux/buffer_head.h>
29
30#include "befs.h"
31#include "btree.h"
32#include "datastream.h"
Linus Torvalds1da177e2005-04-16 15:20:36 -070033
34/*
35 * The btree functions in this file are built on top of the
36 * datastream.c interface, which is in turn built on top of the
37 * io.c interface.
38 */
39
40/* Befs B+tree structure:
Luis de Bethencourte60f7492016-11-10 11:25:36 +000041 *
Linus Torvalds1da177e2005-04-16 15:20:36 -070042 * The first thing in the tree is the tree superblock. It tells you
43 * all kinds of useful things about the tree, like where the rootnode
44 * is located, and the size of the nodes (always 1024 with current version
45 * of BeOS).
46 *
47 * The rest of the tree consists of a series of nodes. Nodes contain a header
Luis de Bethencourte60f7492016-11-10 11:25:36 +000048 * (struct befs_btree_nodehead), the packed key data, an array of shorts
Linus Torvalds1da177e2005-04-16 15:20:36 -070049 * containing the ending offsets for each of the keys, and an array of
Luis de Bethencourte60f7492016-11-10 11:25:36 +000050 * befs_off_t values. In interior nodes, the keys are the ending keys for
51 * the childnode they point to, and the values are offsets into the
52 * datastream containing the tree.
Linus Torvalds1da177e2005-04-16 15:20:36 -070053 */
54
55/* Note:
Luis de Bethencourte60f7492016-11-10 11:25:36 +000056 *
57 * The book states 2 confusing things about befs b+trees. First,
Linus Torvalds1da177e2005-04-16 15:20:36 -070058 * it states that the overflow field of node headers is used by internal nodes
59 * to point to another node that "effectively continues this one". Here is what
60 * I believe that means. Each key in internal nodes points to another node that
Luis de Bethencourte60f7492016-11-10 11:25:36 +000061 * contains key values less than itself. Inspection reveals that the last key
62 * in the internal node is not the last key in the index. Keys that are
63 * greater than the last key in the internal node go into the overflow node.
Linus Torvalds1da177e2005-04-16 15:20:36 -070064 * I imagine there is a performance reason for this.
65 *
Luis de Bethencourte60f7492016-11-10 11:25:36 +000066 * Second, it states that the header of a btree node is sufficient to
67 * distinguish internal nodes from leaf nodes. Without saying exactly how.
Linus Torvalds1da177e2005-04-16 15:20:36 -070068 * After figuring out the first, it becomes obvious that internal nodes have
69 * overflow nodes and leafnodes do not.
70 */
71
Luis de Bethencourte60f7492016-11-10 11:25:36 +000072/*
Linus Torvalds1da177e2005-04-16 15:20:36 -070073 * Currently, this code is only good for directory B+trees.
74 * In order to be used for other BFS indexes, it needs to be extended to handle
75 * duplicate keys and non-string keytypes (int32, int64, float, double).
76 */
77
78/*
79 * In memory structure of each btree node
80 */
Himangi Saraogi0f2a84f2014-10-13 15:53:18 -070081struct befs_btree_node {
Al Viroa9721f32005-12-24 14:28:55 -050082 befs_host_btree_nodehead head; /* head of node converted to cpu byteorder */
Linus Torvalds1da177e2005-04-16 15:20:36 -070083 struct buffer_head *bh;
84 befs_btree_nodehead *od_node; /* on disk node */
Himangi Saraogi0f2a84f2014-10-13 15:53:18 -070085};
Linus Torvalds1da177e2005-04-16 15:20:36 -070086
87/* local constants */
Salah Triki4bb59432016-07-27 04:11:53 +010088static const befs_off_t BEFS_BT_INVAL = 0xffffffffffffffffULL;
Linus Torvalds1da177e2005-04-16 15:20:36 -070089
90/* local functions */
Al Viro22341d82016-05-10 14:24:06 -040091static int befs_btree_seekleaf(struct super_block *sb, const befs_data_stream *ds,
Linus Torvalds1da177e2005-04-16 15:20:36 -070092 befs_btree_super * bt_super,
Himangi Saraogi0f2a84f2014-10-13 15:53:18 -070093 struct befs_btree_node *this_node,
Linus Torvalds1da177e2005-04-16 15:20:36 -070094 befs_off_t * node_off);
95
Al Viro22341d82016-05-10 14:24:06 -040096static int befs_bt_read_super(struct super_block *sb, const befs_data_stream *ds,
Linus Torvalds1da177e2005-04-16 15:20:36 -070097 befs_btree_super * sup);
98
Al Viro22341d82016-05-10 14:24:06 -040099static int befs_bt_read_node(struct super_block *sb, const befs_data_stream *ds,
Himangi Saraogi0f2a84f2014-10-13 15:53:18 -0700100 struct befs_btree_node *node,
101 befs_off_t node_off);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700102
Himangi Saraogi0f2a84f2014-10-13 15:53:18 -0700103static int befs_leafnode(struct befs_btree_node *node);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700104
Himangi Saraogi0f2a84f2014-10-13 15:53:18 -0700105static fs16 *befs_bt_keylen_index(struct befs_btree_node *node);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700106
Himangi Saraogi0f2a84f2014-10-13 15:53:18 -0700107static fs64 *befs_bt_valarray(struct befs_btree_node *node);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700108
Himangi Saraogi0f2a84f2014-10-13 15:53:18 -0700109static char *befs_bt_keydata(struct befs_btree_node *node);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700110
Himangi Saraogi0f2a84f2014-10-13 15:53:18 -0700111static int befs_find_key(struct super_block *sb,
112 struct befs_btree_node *node,
Linus Torvalds1da177e2005-04-16 15:20:36 -0700113 const char *findkey, befs_off_t * value);
114
Himangi Saraogi0f2a84f2014-10-13 15:53:18 -0700115static char *befs_bt_get_key(struct super_block *sb,
116 struct befs_btree_node *node,
Linus Torvalds1da177e2005-04-16 15:20:36 -0700117 int index, u16 * keylen);
118
119static int befs_compare_strings(const void *key1, int keylen1,
120 const void *key2, int keylen2);
121
122/**
123 * befs_bt_read_super - read in btree superblock convert to cpu byteorder
124 * @sb: Filesystem superblock
125 * @ds: Datastream to read from
126 * @sup: Buffer in which to place the btree superblock
127 *
128 * Calls befs_read_datastream to read in the btree superblock and
129 * makes sure it is in cpu byteorder, byteswapping if necessary.
130 *
131 * On success, returns BEFS_OK and *@sup contains the btree superblock,
132 * in cpu byte order.
133 *
134 * On failure, BEFS_ERR is returned.
135 */
136static int
Al Viro22341d82016-05-10 14:24:06 -0400137befs_bt_read_super(struct super_block *sb, const befs_data_stream *ds,
Linus Torvalds1da177e2005-04-16 15:20:36 -0700138 befs_btree_super * sup)
139{
Fabian Frederick9f0f5642015-06-25 15:03:43 -0700140 struct buffer_head *bh;
141 befs_disk_btree_super *od_sup;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700142
Fabian Frederickdac52fc2014-04-03 14:50:23 -0700143 befs_debug(sb, "---> %s", __func__);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700144
145 bh = befs_read_datastream(sb, ds, 0, NULL);
146
147 if (!bh) {
148 befs_error(sb, "Couldn't read index header.");
149 goto error;
150 }
Al Viroa9721f32005-12-24 14:28:55 -0500151 od_sup = (befs_disk_btree_super *) bh->b_data;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700152 befs_dump_index_entry(sb, od_sup);
153
154 sup->magic = fs32_to_cpu(sb, od_sup->magic);
155 sup->node_size = fs32_to_cpu(sb, od_sup->node_size);
156 sup->max_depth = fs32_to_cpu(sb, od_sup->max_depth);
157 sup->data_type = fs32_to_cpu(sb, od_sup->data_type);
158 sup->root_node_ptr = fs64_to_cpu(sb, od_sup->root_node_ptr);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700159
160 brelse(bh);
161 if (sup->magic != BEFS_BTREE_MAGIC) {
162 befs_error(sb, "Index header has bad magic.");
163 goto error;
164 }
165
Fabian Frederickdac52fc2014-04-03 14:50:23 -0700166 befs_debug(sb, "<--- %s", __func__);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700167 return BEFS_OK;
168
169 error:
Fabian Frederickdac52fc2014-04-03 14:50:23 -0700170 befs_debug(sb, "<--- %s ERROR", __func__);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700171 return BEFS_ERR;
172}
173
174/**
175 * befs_bt_read_node - read in btree node and convert to cpu byteorder
176 * @sb: Filesystem superblock
177 * @ds: Datastream to read from
178 * @node: Buffer in which to place the btree node
179 * @node_off: Starting offset (in bytes) of the node in @ds
180 *
181 * Calls befs_read_datastream to read in the indicated btree node and
182 * makes sure its header fields are in cpu byteorder, byteswapping if
183 * necessary.
Luis de Bethencourt2dfa8a62016-07-12 00:02:50 +0100184 * Note: node->bh must be NULL when this function is called the first time.
185 * Don't forget brelse(node->bh) after last call.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700186 *
187 * On success, returns BEFS_OK and *@node contains the btree node that
188 * starts at @node_off, with the node->head fields in cpu byte order.
189 *
190 * On failure, BEFS_ERR is returned.
191 */
192
193static int
Al Viro22341d82016-05-10 14:24:06 -0400194befs_bt_read_node(struct super_block *sb, const befs_data_stream *ds,
Himangi Saraogi0f2a84f2014-10-13 15:53:18 -0700195 struct befs_btree_node *node, befs_off_t node_off)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700196{
197 uint off = 0;
198
Fabian Frederickdac52fc2014-04-03 14:50:23 -0700199 befs_debug(sb, "---> %s", __func__);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700200
201 if (node->bh)
202 brelse(node->bh);
203
204 node->bh = befs_read_datastream(sb, ds, node_off, &off);
205 if (!node->bh) {
Fabian Frederickdac52fc2014-04-03 14:50:23 -0700206 befs_error(sb, "%s failed to read "
207 "node at %llu", __func__, node_off);
208 befs_debug(sb, "<--- %s ERROR", __func__);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700209
210 return BEFS_ERR;
211 }
212 node->od_node =
213 (befs_btree_nodehead *) ((void *) node->bh->b_data + off);
214
215 befs_dump_index_node(sb, node->od_node);
216
217 node->head.left = fs64_to_cpu(sb, node->od_node->left);
218 node->head.right = fs64_to_cpu(sb, node->od_node->right);
219 node->head.overflow = fs64_to_cpu(sb, node->od_node->overflow);
220 node->head.all_key_count =
221 fs16_to_cpu(sb, node->od_node->all_key_count);
222 node->head.all_key_length =
223 fs16_to_cpu(sb, node->od_node->all_key_length);
224
Fabian Frederickdac52fc2014-04-03 14:50:23 -0700225 befs_debug(sb, "<--- %s", __func__);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700226 return BEFS_OK;
227}
228
229/**
230 * befs_btree_find - Find a key in a befs B+tree
231 * @sb: Filesystem superblock
232 * @ds: Datastream containing btree
233 * @key: Key string to lookup in btree
234 * @value: Value stored with @key
235 *
Joe Perchesc78bad12008-02-03 17:33:42 +0200236 * On success, returns BEFS_OK and sets *@value to the value stored
Linus Torvalds1da177e2005-04-16 15:20:36 -0700237 * with @key (usually the disk block number of an inode).
238 *
239 * On failure, returns BEFS_ERR or BEFS_BT_NOT_FOUND.
Luis de Bethencourte60f7492016-11-10 11:25:36 +0000240 *
241 * Algorithm:
Linus Torvalds1da177e2005-04-16 15:20:36 -0700242 * Read the superblock and rootnode of the b+tree.
243 * Drill down through the interior nodes using befs_find_key().
244 * Once at the correct leaf node, use befs_find_key() again to get the
Luis de Bethencourt02d91f92016-08-11 22:15:16 +0100245 * actual value stored with the key.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700246 */
247int
Al Viro22341d82016-05-10 14:24:06 -0400248befs_btree_find(struct super_block *sb, const befs_data_stream *ds,
Linus Torvalds1da177e2005-04-16 15:20:36 -0700249 const char *key, befs_off_t * value)
250{
Fabian Frederick9f0f5642015-06-25 15:03:43 -0700251 struct befs_btree_node *this_node;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700252 befs_btree_super bt_super;
253 befs_off_t node_off;
254 int res;
255
Fabian Frederickdac52fc2014-04-03 14:50:23 -0700256 befs_debug(sb, "---> %s Key: %s", __func__, key);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700257
258 if (befs_bt_read_super(sb, ds, &bt_super) != BEFS_OK) {
259 befs_error(sb,
260 "befs_btree_find() failed to read index superblock");
261 goto error;
262 }
263
Himangi Saraogi0f2a84f2014-10-13 15:53:18 -0700264 this_node = kmalloc(sizeof(struct befs_btree_node),
Linus Torvalds1da177e2005-04-16 15:20:36 -0700265 GFP_NOFS);
266 if (!this_node) {
Fabian Frederickdac52fc2014-04-03 14:50:23 -0700267 befs_error(sb, "befs_btree_find() failed to allocate %zu "
Himangi Saraogi0f2a84f2014-10-13 15:53:18 -0700268 "bytes of memory", sizeof(struct befs_btree_node));
Linus Torvalds1da177e2005-04-16 15:20:36 -0700269 goto error;
270 }
271
272 this_node->bh = NULL;
273
274 /* read in root node */
275 node_off = bt_super.root_node_ptr;
276 if (befs_bt_read_node(sb, ds, this_node, node_off) != BEFS_OK) {
277 befs_error(sb, "befs_btree_find() failed to read "
Fabian Frederickdac52fc2014-04-03 14:50:23 -0700278 "node at %llu", node_off);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700279 goto error_alloc;
280 }
281
282 while (!befs_leafnode(this_node)) {
283 res = befs_find_key(sb, this_node, key, &node_off);
Luis de Bethencourt672a8512016-08-08 15:21:20 +0100284 /* if no key set, try the overflow node */
285 if (res == BEFS_BT_OVERFLOW)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700286 node_off = this_node->head.overflow;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700287 if (befs_bt_read_node(sb, ds, this_node, node_off) != BEFS_OK) {
288 befs_error(sb, "befs_btree_find() failed to read "
Fabian Frederickdac52fc2014-04-03 14:50:23 -0700289 "node at %llu", node_off);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700290 goto error_alloc;
291 }
292 }
293
Luis de Bethencourt672a8512016-08-08 15:21:20 +0100294 /* at a leaf node now, check if it is correct */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700295 res = befs_find_key(sb, this_node, key, value);
296
297 brelse(this_node->bh);
298 kfree(this_node);
299
300 if (res != BEFS_BT_MATCH) {
Luis de Bethencourt4c3897c2016-07-03 16:29:44 +0100301 befs_error(sb, "<--- %s Key %s not found", __func__, key);
302 befs_debug(sb, "<--- %s ERROR", __func__);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700303 *value = 0;
304 return BEFS_BT_NOT_FOUND;
305 }
Fabian Frederickdac52fc2014-04-03 14:50:23 -0700306 befs_debug(sb, "<--- %s Found key %s, value %llu", __func__,
Linus Torvalds1da177e2005-04-16 15:20:36 -0700307 key, *value);
308 return BEFS_OK;
309
310 error_alloc:
311 kfree(this_node);
312 error:
313 *value = 0;
Fabian Frederickdac52fc2014-04-03 14:50:23 -0700314 befs_debug(sb, "<--- %s ERROR", __func__);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700315 return BEFS_ERR;
316}
317
318/**
319 * befs_find_key - Search for a key within a node
320 * @sb: Filesystem superblock
321 * @node: Node to find the key within
Fabian Frederick817e1d92014-06-06 14:36:17 -0700322 * @findkey: Keystring to search for
Linus Torvalds1da177e2005-04-16 15:20:36 -0700323 * @value: If key is found, the value stored with the key is put here
324 *
Luis de Bethencourt672a8512016-08-08 15:21:20 +0100325 * Finds exact match if one exists, and returns BEFS_BT_MATCH.
326 * If there is no match and node's value array is too small for key, return
327 * BEFS_BT_OVERFLOW.
328 * If no match and node should countain this key, return BEFS_BT_NOT_FOUND.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700329 *
Luis de Bethencourt672a8512016-08-08 15:21:20 +0100330 * Uses binary search instead of a linear.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700331 */
332static int
Himangi Saraogi0f2a84f2014-10-13 15:53:18 -0700333befs_find_key(struct super_block *sb, struct befs_btree_node *node,
Linus Torvalds1da177e2005-04-16 15:20:36 -0700334 const char *findkey, befs_off_t * value)
335{
336 int first, last, mid;
337 int eq;
338 u16 keylen;
339 int findkey_len;
340 char *thiskey;
Al Viroa9721f32005-12-24 14:28:55 -0500341 fs64 *valarray;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700342
Fabian Frederickdac52fc2014-04-03 14:50:23 -0700343 befs_debug(sb, "---> %s %s", __func__, findkey);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700344
Linus Torvalds1da177e2005-04-16 15:20:36 -0700345 findkey_len = strlen(findkey);
346
Luis de Bethencourtbb75e662016-08-08 15:21:21 +0100347 /* if node can not contain key, just skip this node */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700348 last = node->head.all_key_count - 1;
349 thiskey = befs_bt_get_key(sb, node, last, &keylen);
350
351 eq = befs_compare_strings(thiskey, keylen, findkey, findkey_len);
352 if (eq < 0) {
Luis de Bethencourt672a8512016-08-08 15:21:20 +0100353 befs_debug(sb, "<--- node can't contain %s", findkey);
354 return BEFS_BT_OVERFLOW;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700355 }
356
357 valarray = befs_bt_valarray(node);
358
359 /* simple binary search */
360 first = 0;
361 mid = 0;
362 while (last >= first) {
363 mid = (last + first) / 2;
364 befs_debug(sb, "first: %d, last: %d, mid: %d", first, last,
365 mid);
366 thiskey = befs_bt_get_key(sb, node, mid, &keylen);
367 eq = befs_compare_strings(thiskey, keylen, findkey,
368 findkey_len);
369
370 if (eq == 0) {
Fabian Frederickdac52fc2014-04-03 14:50:23 -0700371 befs_debug(sb, "<--- %s found %s at %d",
372 __func__, thiskey, mid);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700373
374 *value = fs64_to_cpu(sb, valarray[mid]);
375 return BEFS_BT_MATCH;
376 }
377 if (eq > 0)
378 last = mid - 1;
379 else
380 first = mid + 1;
381 }
Luis de Bethencourt672a8512016-08-08 15:21:20 +0100382
383 /* return an existing value so caller can arrive to a leaf node */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700384 if (eq < 0)
385 *value = fs64_to_cpu(sb, valarray[mid + 1]);
386 else
387 *value = fs64_to_cpu(sb, valarray[mid]);
Luis de Bethencourt672a8512016-08-08 15:21:20 +0100388 befs_error(sb, "<--- %s %s not found", __func__, findkey);
389 befs_debug(sb, "<--- %s ERROR", __func__);
390 return BEFS_BT_NOT_FOUND;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700391}
392
393/**
394 * befs_btree_read - Traverse leafnodes of a btree
395 * @sb: Filesystem superblock
396 * @ds: Datastream containing btree
397 * @key_no: Key number (alphabetical order) of key to read
398 * @bufsize: Size of the buffer to return key in
399 * @keybuf: Pointer to a buffer to put the key in
400 * @keysize: Length of the returned key
401 * @value: Value stored with the returned key
402 *
Luis de Bethencourt02d91f92016-08-11 22:15:16 +0100403 * Here's how it works: Key_no is the index of the key/value pair to
Linus Torvalds1da177e2005-04-16 15:20:36 -0700404 * return in keybuf/value.
Luis de Bethencourte60f7492016-11-10 11:25:36 +0000405 * Bufsize is the size of keybuf (BEFS_NAME_LEN+1 is a good size). Keysize is
Fabian Frederick6cb103b2014-06-06 14:36:15 -0700406 * the number of characters in the key (just a convenience).
Linus Torvalds1da177e2005-04-16 15:20:36 -0700407 *
408 * Algorithm:
409 * Get the first leafnode of the tree. See if the requested key is in that
Luis de Bethencourte60f7492016-11-10 11:25:36 +0000410 * node. If not, follow the node->right link to the next leafnode. Repeat
Linus Torvalds1da177e2005-04-16 15:20:36 -0700411 * until the (key_no)th key is found or the tree is out of keys.
412 */
413int
Al Viro22341d82016-05-10 14:24:06 -0400414befs_btree_read(struct super_block *sb, const befs_data_stream *ds,
Linus Torvalds1da177e2005-04-16 15:20:36 -0700415 loff_t key_no, size_t bufsize, char *keybuf, size_t * keysize,
416 befs_off_t * value)
417{
Himangi Saraogi0f2a84f2014-10-13 15:53:18 -0700418 struct befs_btree_node *this_node;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700419 befs_btree_super bt_super;
Salah Triki143d2a62016-07-31 21:34:28 +0100420 befs_off_t node_off;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700421 int cur_key;
Al Viroa9721f32005-12-24 14:28:55 -0500422 fs64 *valarray;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700423 char *keystart;
424 u16 keylen;
425 int res;
426
427 uint key_sum = 0;
428
Fabian Frederickdac52fc2014-04-03 14:50:23 -0700429 befs_debug(sb, "---> %s", __func__);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700430
431 if (befs_bt_read_super(sb, ds, &bt_super) != BEFS_OK) {
432 befs_error(sb,
433 "befs_btree_read() failed to read index superblock");
434 goto error;
435 }
436
Himangi Saraogi0f2a84f2014-10-13 15:53:18 -0700437 this_node = kmalloc(sizeof(struct befs_btree_node), GFP_NOFS);
438 if (this_node == NULL) {
Fabian Frederickdac52fc2014-04-03 14:50:23 -0700439 befs_error(sb, "befs_btree_read() failed to allocate %zu "
Himangi Saraogi0f2a84f2014-10-13 15:53:18 -0700440 "bytes of memory", sizeof(struct befs_btree_node));
Linus Torvalds1da177e2005-04-16 15:20:36 -0700441 goto error;
442 }
443
444 node_off = bt_super.root_node_ptr;
445 this_node->bh = NULL;
446
447 /* seeks down to first leafnode, reads it into this_node */
448 res = befs_btree_seekleaf(sb, ds, &bt_super, this_node, &node_off);
449 if (res == BEFS_BT_EMPTY) {
450 brelse(this_node->bh);
451 kfree(this_node);
452 *value = 0;
453 *keysize = 0;
Fabian Frederickdac52fc2014-04-03 14:50:23 -0700454 befs_debug(sb, "<--- %s Tree is EMPTY", __func__);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700455 return BEFS_BT_EMPTY;
456 } else if (res == BEFS_ERR) {
457 goto error_alloc;
458 }
459
460 /* find the leaf node containing the key_no key */
461
462 while (key_sum + this_node->head.all_key_count <= key_no) {
463
464 /* no more nodes to look in: key_no is too large */
Salah Triki4bb59432016-07-27 04:11:53 +0100465 if (this_node->head.right == BEFS_BT_INVAL) {
Linus Torvalds1da177e2005-04-16 15:20:36 -0700466 *keysize = 0;
467 *value = 0;
468 befs_debug(sb,
Fabian Frederickdac52fc2014-04-03 14:50:23 -0700469 "<--- %s END of keys at %llu", __func__,
470 (unsigned long long)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700471 key_sum + this_node->head.all_key_count);
472 brelse(this_node->bh);
473 kfree(this_node);
474 return BEFS_BT_END;
475 }
476
477 key_sum += this_node->head.all_key_count;
478 node_off = this_node->head.right;
479
480 if (befs_bt_read_node(sb, ds, this_node, node_off) != BEFS_OK) {
Fabian Frederickdac52fc2014-04-03 14:50:23 -0700481 befs_error(sb, "%s failed to read node at %llu",
482 __func__, (unsigned long long)node_off);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700483 goto error_alloc;
484 }
485 }
486
487 /* how many keys into this_node is key_no */
488 cur_key = key_no - key_sum;
489
490 /* get pointers to datastructures within the node body */
491 valarray = befs_bt_valarray(this_node);
492
493 keystart = befs_bt_get_key(sb, this_node, cur_key, &keylen);
494
Fabian Frederickdac52fc2014-04-03 14:50:23 -0700495 befs_debug(sb, "Read [%llu,%d]: keysize %d",
496 (long long unsigned int)node_off, (int)cur_key,
497 (int)keylen);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700498
499 if (bufsize < keylen + 1) {
Fabian Frederickdac52fc2014-04-03 14:50:23 -0700500 befs_error(sb, "%s keybuf too small (%zu) "
501 "for key of size %d", __func__, bufsize, keylen);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700502 brelse(this_node->bh);
503 goto error_alloc;
Fabian Frederick6cb103b2014-06-06 14:36:15 -0700504 }
Linus Torvalds1da177e2005-04-16 15:20:36 -0700505
Fabian Frederick6cb103b2014-06-06 14:36:15 -0700506 strlcpy(keybuf, keystart, keylen + 1);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700507 *value = fs64_to_cpu(sb, valarray[cur_key]);
508 *keysize = keylen;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700509
Fabian Frederickdac52fc2014-04-03 14:50:23 -0700510 befs_debug(sb, "Read [%llu,%d]: Key \"%.*s\", Value %llu", node_off,
Linus Torvalds1da177e2005-04-16 15:20:36 -0700511 cur_key, keylen, keybuf, *value);
512
513 brelse(this_node->bh);
514 kfree(this_node);
515
Fabian Frederickdac52fc2014-04-03 14:50:23 -0700516 befs_debug(sb, "<--- %s", __func__);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700517
518 return BEFS_OK;
519
520 error_alloc:
521 kfree(this_node);
522
523 error:
524 *keysize = 0;
525 *value = 0;
Fabian Frederickdac52fc2014-04-03 14:50:23 -0700526 befs_debug(sb, "<--- %s ERROR", __func__);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700527 return BEFS_ERR;
528}
529
530/**
531 * befs_btree_seekleaf - Find the first leafnode in the btree
532 * @sb: Filesystem superblock
533 * @ds: Datastream containing btree
534 * @bt_super: Pointer to the superblock of the btree
535 * @this_node: Buffer to return the leafnode in
536 * @node_off: Pointer to offset of current node within datastream. Modified
537 * by the function.
538 *
Luis de Bethencourte60f7492016-11-10 11:25:36 +0000539 * Helper function for btree traverse. Moves the current position to the
Linus Torvalds1da177e2005-04-16 15:20:36 -0700540 * start of the first leaf node.
541 *
542 * Also checks for an empty tree. If there are no keys, returns BEFS_BT_EMPTY.
543 */
544static int
Al Viro22341d82016-05-10 14:24:06 -0400545befs_btree_seekleaf(struct super_block *sb, const befs_data_stream *ds,
Himangi Saraogi0f2a84f2014-10-13 15:53:18 -0700546 befs_btree_super *bt_super,
547 struct befs_btree_node *this_node,
Linus Torvalds1da177e2005-04-16 15:20:36 -0700548 befs_off_t * node_off)
549{
550
Fabian Frederickdac52fc2014-04-03 14:50:23 -0700551 befs_debug(sb, "---> %s", __func__);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700552
553 if (befs_bt_read_node(sb, ds, this_node, *node_off) != BEFS_OK) {
Fabian Frederickdac52fc2014-04-03 14:50:23 -0700554 befs_error(sb, "%s failed to read "
555 "node at %llu", __func__, *node_off);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700556 goto error;
557 }
Fabian Frederickdac52fc2014-04-03 14:50:23 -0700558 befs_debug(sb, "Seekleaf to root node %llu", *node_off);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700559
560 if (this_node->head.all_key_count == 0 && befs_leafnode(this_node)) {
Fabian Frederickdac52fc2014-04-03 14:50:23 -0700561 befs_debug(sb, "<--- %s Tree is EMPTY", __func__);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700562 return BEFS_BT_EMPTY;
563 }
564
565 while (!befs_leafnode(this_node)) {
566
567 if (this_node->head.all_key_count == 0) {
Fabian Frederickdac52fc2014-04-03 14:50:23 -0700568 befs_debug(sb, "%s encountered "
569 "an empty interior node: %llu. Using Overflow "
570 "node: %llu", __func__, *node_off,
Linus Torvalds1da177e2005-04-16 15:20:36 -0700571 this_node->head.overflow);
572 *node_off = this_node->head.overflow;
573 } else {
Al Viroa9721f32005-12-24 14:28:55 -0500574 fs64 *valarray = befs_bt_valarray(this_node);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700575 *node_off = fs64_to_cpu(sb, valarray[0]);
576 }
577 if (befs_bt_read_node(sb, ds, this_node, *node_off) != BEFS_OK) {
Fabian Frederickdac52fc2014-04-03 14:50:23 -0700578 befs_error(sb, "%s failed to read "
579 "node at %llu", __func__, *node_off);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700580 goto error;
581 }
582
Fabian Frederickdac52fc2014-04-03 14:50:23 -0700583 befs_debug(sb, "Seekleaf to child node %llu", *node_off);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700584 }
Fabian Frederickdac52fc2014-04-03 14:50:23 -0700585 befs_debug(sb, "Node %llu is a leaf node", *node_off);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700586
587 return BEFS_OK;
588
589 error:
Fabian Frederickdac52fc2014-04-03 14:50:23 -0700590 befs_debug(sb, "<--- %s ERROR", __func__);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700591 return BEFS_ERR;
592}
593
594/**
Luis de Bethencourte60f7492016-11-10 11:25:36 +0000595 * befs_leafnode - Determine if the btree node is a leaf node or an
Linus Torvalds1da177e2005-04-16 15:20:36 -0700596 * interior node
597 * @node: Pointer to node structure to test
Luis de Bethencourte60f7492016-11-10 11:25:36 +0000598 *
Linus Torvalds1da177e2005-04-16 15:20:36 -0700599 * Return 1 if leaf, 0 if interior
600 */
601static int
Himangi Saraogi0f2a84f2014-10-13 15:53:18 -0700602befs_leafnode(struct befs_btree_node *node)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700603{
604 /* all interior nodes (and only interior nodes) have an overflow node */
Salah Triki4bb59432016-07-27 04:11:53 +0100605 if (node->head.overflow == BEFS_BT_INVAL)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700606 return 1;
607 else
608 return 0;
609}
610
611/**
612 * befs_bt_keylen_index - Finds start of keylen index in a node
613 * @node: Pointer to the node structure to find the keylen index within
614 *
615 * Returns a pointer to the start of the key length index array
616 * of the B+tree node *@node
617 *
618 * "The length of all the keys in the node is added to the size of the
619 * header and then rounded up to a multiple of four to get the beginning
620 * of the key length index" (p.88, practical filesystem design).
621 *
622 * Except that rounding up to 8 works, and rounding up to 4 doesn't.
623 */
Al Viroa9721f32005-12-24 14:28:55 -0500624static fs16 *
Himangi Saraogi0f2a84f2014-10-13 15:53:18 -0700625befs_bt_keylen_index(struct befs_btree_node *node)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700626{
627 const int keylen_align = 8;
628 unsigned long int off =
629 (sizeof (befs_btree_nodehead) + node->head.all_key_length);
630 ulong tmp = off % keylen_align;
631
632 if (tmp)
633 off += keylen_align - tmp;
634
Al Viroa9721f32005-12-24 14:28:55 -0500635 return (fs16 *) ((void *) node->od_node + off);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700636}
637
638/**
639 * befs_bt_valarray - Finds the start of value array in a node
640 * @node: Pointer to the node structure to find the value array within
641 *
642 * Returns a pointer to the start of the value array
643 * of the node pointed to by the node header
644 */
Al Viroa9721f32005-12-24 14:28:55 -0500645static fs64 *
Himangi Saraogi0f2a84f2014-10-13 15:53:18 -0700646befs_bt_valarray(struct befs_btree_node *node)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700647{
648 void *keylen_index_start = (void *) befs_bt_keylen_index(node);
Al Viroa9721f32005-12-24 14:28:55 -0500649 size_t keylen_index_size = node->head.all_key_count * sizeof (fs16);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700650
Al Viroa9721f32005-12-24 14:28:55 -0500651 return (fs64 *) (keylen_index_start + keylen_index_size);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700652}
653
654/**
655 * befs_bt_keydata - Finds start of keydata array in a node
656 * @node: Pointer to the node structure to find the keydata array within
657 *
658 * Returns a pointer to the start of the keydata array
Luis de Bethencourte60f7492016-11-10 11:25:36 +0000659 * of the node pointed to by the node header
Linus Torvalds1da177e2005-04-16 15:20:36 -0700660 */
661static char *
Himangi Saraogi0f2a84f2014-10-13 15:53:18 -0700662befs_bt_keydata(struct befs_btree_node *node)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700663{
664 return (char *) ((void *) node->od_node + sizeof (befs_btree_nodehead));
665}
666
667/**
668 * befs_bt_get_key - returns a pointer to the start of a key
669 * @sb: filesystem superblock
670 * @node: node in which to look for the key
671 * @index: the index of the key to get
672 * @keylen: modified to be the length of the key at @index
673 *
674 * Returns a valid pointer into @node on success.
675 * Returns NULL on failure (bad input) and sets *@keylen = 0
676 */
677static char *
Himangi Saraogi0f2a84f2014-10-13 15:53:18 -0700678befs_bt_get_key(struct super_block *sb, struct befs_btree_node *node,
Linus Torvalds1da177e2005-04-16 15:20:36 -0700679 int index, u16 * keylen)
680{
681 int prev_key_end;
682 char *keystart;
Al Viroa9721f32005-12-24 14:28:55 -0500683 fs16 *keylen_index;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700684
685 if (index < 0 || index > node->head.all_key_count) {
686 *keylen = 0;
687 return NULL;
688 }
689
690 keystart = befs_bt_keydata(node);
691 keylen_index = befs_bt_keylen_index(node);
692
693 if (index == 0)
694 prev_key_end = 0;
695 else
696 prev_key_end = fs16_to_cpu(sb, keylen_index[index - 1]);
697
698 *keylen = fs16_to_cpu(sb, keylen_index[index]) - prev_key_end;
699
700 return keystart + prev_key_end;
701}
702
703/**
704 * befs_compare_strings - compare two strings
Luis de Bethencourte60f7492016-11-10 11:25:36 +0000705 * @key1: pointer to the first key to be compared
Linus Torvalds1da177e2005-04-16 15:20:36 -0700706 * @keylen1: length in bytes of key1
707 * @key2: pointer to the second key to be compared
Fabian Frederick817e1d92014-06-06 14:36:17 -0700708 * @keylen2: length in bytes of key2
Linus Torvalds1da177e2005-04-16 15:20:36 -0700709 *
710 * Returns 0 if @key1 and @key2 are equal.
711 * Returns >0 if @key1 is greater.
Luis de Bethencourt02d91f92016-08-11 22:15:16 +0100712 * Returns <0 if @key2 is greater.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700713 */
714static int
715befs_compare_strings(const void *key1, int keylen1,
716 const void *key2, int keylen2)
717{
718 int len = min_t(int, keylen1, keylen2);
719 int result = strncmp(key1, key2, len);
720 if (result == 0)
721 result = keylen1 - keylen2;
722 return result;
723}
724
725/* These will be used for non-string keyed btrees */
726#if 0
727static int
728btree_compare_int32(cont void *key1, int keylen1, const void *key2, int keylen2)
729{
730 return *(int32_t *) key1 - *(int32_t *) key2;
731}
732
733static int
734btree_compare_uint32(cont void *key1, int keylen1,
735 const void *key2, int keylen2)
736{
737 if (*(u_int32_t *) key1 == *(u_int32_t *) key2)
738 return 0;
739 else if (*(u_int32_t *) key1 > *(u_int32_t *) key2)
740 return 1;
741
742 return -1;
743}
744static int
745btree_compare_int64(cont void *key1, int keylen1, const void *key2, int keylen2)
746{
747 if (*(int64_t *) key1 == *(int64_t *) key2)
748 return 0;
749 else if (*(int64_t *) key1 > *(int64_t *) key2)
750 return 1;
751
752 return -1;
753}
754
755static int
756btree_compare_uint64(cont void *key1, int keylen1,
757 const void *key2, int keylen2)
758{
759 if (*(u_int64_t *) key1 == *(u_int64_t *) key2)
760 return 0;
761 else if (*(u_int64_t *) key1 > *(u_int64_t *) key2)
762 return 1;
763
764 return -1;
765}
766
767static int
768btree_compare_float(cont void *key1, int keylen1, const void *key2, int keylen2)
769{
770 float result = *(float *) key1 - *(float *) key2;
771 if (result == 0.0f)
772 return 0;
773
774 return (result < 0.0f) ? -1 : 1;
775}
776
777static int
778btree_compare_double(cont void *key1, int keylen1,
779 const void *key2, int keylen2)
780{
781 double result = *(double *) key1 - *(double *) key2;
782 if (result == 0.0)
783 return 0;
784
785 return (result < 0.0) ? -1 : 1;
786}
787#endif //0