4 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
6 * This program is free software; you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License version 2 only,
8 * as published by the Free Software Foundation.
10 * This program is distributed in the hope that it will be useful, but
11 * WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13 * General Public License version 2 for more details (a copy is included
14 * in the LICENSE file that accompanied this code).
16 * You should have received a copy of the GNU General Public License
17 * version 2 along with this program; If not, see [sun.com URL with a
20 * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
21 * CA 95054 USA or visit www.sun.com if you need additional information or
27 * Copyright (c) 2009, 2010, Oracle and/or its affiliates. All rights reserved.
28 * Use is subject to license terms.
30 * Copyright (c) 2012, Intel Corporation.
33 * This file is part of Lustre, http://www.lustre.org/
34 * Lustre is a trademark of Sun Microsystems, Inc.
37 * implementation of iam format for fixed size records.
39 * Author: Wang Di <wangdi@clusterfs.com>
40 * Author: Nikita Danilov <nikita@clusterfs.com>
43 #include <linux/types.h>
44 #include "osd_internal.h"
51 IAM_LEAF_HEADER_MAGIC = 0x1976 /* This is duplicated in
52 * lustre/utils/create_iam.c */
55 /* This is duplicated in lustre/utils/create_iam.c */
56 struct iam_leaf_head {
61 static inline int iam_lfix_entry_size(const struct iam_leaf *l)
63 return iam_leaf_descr(l)->id_key_size + iam_leaf_descr(l)->id_rec_size;
66 static inline struct iam_lentry *
67 iam_lfix_shift(const struct iam_leaf *l, struct iam_lentry *entry, int shift)
69 return (void *)entry + shift * iam_lfix_entry_size(l);
72 static inline struct iam_key *iam_leaf_key_at(struct iam_lentry *entry)
74 return (struct iam_key *)entry;
77 static inline int lfix_keycmp(const struct iam_container *c,
78 const struct iam_key *k1,
79 const struct iam_key *k2)
81 return memcmp(k1, k2, c->ic_descr->id_key_size);
84 static struct iam_leaf_head *iam_get_head(const struct iam_leaf *l)
86 return (struct iam_leaf_head *)l->il_bh->b_data;
89 static struct iam_lentry *iam_entries(const struct buffer_head *bh)
91 return (void *)bh->b_data + sizeof(struct iam_leaf_head);
94 static struct iam_lentry *iam_get_lentries(const struct iam_leaf *l)
96 return iam_entries(l->il_bh);
99 static int leaf_count_limit(const struct iam_leaf *leaf)
103 free_space = iam_leaf_container(leaf)->ic_object->i_sb->s_blocksize;
104 free_space -= sizeof(struct iam_leaf_head);
105 return free_space / iam_lfix_entry_size(leaf);
108 static int lentry_count_get(const struct iam_leaf *leaf)
110 return le16_to_cpu(iam_get_head(leaf)->ill_count);
113 static void lentry_count_set(struct iam_leaf *leaf, unsigned count)
115 assert_corr(0 <= count && count <= leaf_count_limit(leaf));
116 iam_get_head(leaf)->ill_count = cpu_to_le16(count);
119 static struct iam_lentry *iam_lfix_get_end(const struct iam_leaf *l);
121 #if LDISKFS_CORRECTNESS_ON || LDISKFS_INVARIANT_ON
122 static int iam_leaf_at_rec(const struct iam_leaf *folio)
125 iam_get_lentries(folio) <= folio->il_at &&
126 folio->il_at < iam_lfix_get_end(folio);
130 static struct iam_ikey *iam_lfix_ikey(const struct iam_leaf *l,
131 struct iam_ikey *key)
134 assert_corr(iam_leaf_at_rec(l));
135 return (struct iam_ikey*)ie;
138 static struct iam_key *iam_lfix_key(const struct iam_leaf *l)
141 assert_corr(iam_leaf_at_rec(l));
142 return (struct iam_key*)ie;
145 static int iam_lfix_key_size(const struct iam_leaf *l)
147 return iam_leaf_descr(l)->id_key_size;
150 static void iam_lfix_start(struct iam_leaf *l)
152 l->il_at = iam_get_lentries(l);
155 static inline ptrdiff_t iam_lfix_diff(const struct iam_leaf *l,
156 const struct iam_lentry *e1,
157 const struct iam_lentry *e2)
162 esize = iam_lfix_entry_size(l);
163 diff = (void *)e1 - (void *)e2;
164 assert_corr(diff / esize * esize == diff);
168 static int iam_lfix_init(struct iam_leaf *l)
171 struct iam_leaf_head *ill;
174 assert_corr(l->il_bh != NULL);
176 ill = iam_get_head(l);
177 count = le16_to_cpu(ill->ill_count);
178 if (le16_to_cpu(ill->ill_magic) == IAM_LEAF_HEADER_MAGIC &&
179 0 <= count && count <= leaf_count_limit(l)) {
180 l->il_at = l->il_entries = iam_get_lentries(l);
185 obj = iam_leaf_container(l)->ic_object;
186 CERROR("Wrong magic in node %llu (#%lu): %#x != %#x or "
187 "wrong count: %d (%d)\n",
188 (unsigned long long)l->il_bh->b_blocknr, obj->i_ino,
189 le16_to_cpu(ill->ill_magic), IAM_LEAF_HEADER_MAGIC,
190 count, leaf_count_limit(l));
196 static void iam_lfix_fini(struct iam_leaf *l)
198 l->il_entries = l->il_at = NULL;
201 static struct iam_lentry *iam_lfix_get_end(const struct iam_leaf *l)
203 int count = lentry_count_get(l);
204 struct iam_lentry *ile = iam_lfix_shift(l, l->il_entries, count);
209 struct iam_rec *iam_lfix_rec(const struct iam_leaf *l)
212 assert_corr(iam_leaf_at_rec(l));
213 return e + iam_leaf_descr(l)->id_key_size;
216 static void iam_lfix_next(struct iam_leaf *l)
218 assert_corr(iam_leaf_at_rec(l));
219 l->il_at = iam_lfix_shift(l, l->il_at, 1);
226 EXPORT_SYMBOL(lfix_dump);
228 static char hdigit(char ch)
230 static char d[] = "0123456789abcdef";
234 static char *hex(char ch, char *area)
236 area[0] = hdigit(ch >> 4);
237 area[1] = hdigit(ch);
242 static void l_print(struct iam_leaf *leaf, struct iam_lentry *entry)
248 area = (char *)entry;
249 printk(KERN_EMERG "[");
250 for (i = iam_lfix_key_size(leaf); i > 0; --i, ++area)
251 printk("%s", hex(*area, h));
253 for (i = iam_leaf_descr(leaf)->id_rec_size; i > 0; --i, ++area)
254 printk("%s", hex(*area, h));
258 static void lfix_print(struct iam_leaf *leaf)
260 struct iam_lentry *entry;
264 entry = leaf->il_entries;
265 count = lentry_count_get(leaf);
266 printk(KERN_EMERG "lfix: %p %p %d\n", leaf, leaf->il_at, count);
267 for (i = 0; i < count; ++i, entry = iam_lfix_shift(leaf, entry, 1))
268 l_print(leaf, entry);
271 static int iam_lfix_lookup(struct iam_leaf *l, const struct iam_key *k)
273 struct iam_lentry *p, *q, *m, *t;
274 struct iam_container *c;
278 count = lentry_count_get(l);
280 return IAM_LOOKUP_EMPTY;
282 result = IAM_LOOKUP_OK;
283 c = iam_leaf_container(l);
286 q = iam_lfix_shift(l, p, count - 1);
287 if (lfix_keycmp(c, k, iam_leaf_key_at(p)) < 0) {
289 * @k is less than the least key in the leaf
292 result = IAM_LOOKUP_BEFORE;
293 } else if (lfix_keycmp(c, iam_leaf_key_at(q), k) <= 0) {
299 while (iam_lfix_shift(l, p, 1) != q) {
300 m = iam_lfix_shift(l, p, iam_lfix_diff(l, q, p) / 2);
301 assert_corr(p < m && m < q);
302 if (lfix_keycmp(c, iam_leaf_key_at(m), k) <= 0)
307 assert_corr(lfix_keycmp(c, iam_leaf_key_at(p), k) <= 0 &&
308 lfix_keycmp(c, k, iam_leaf_key_at(q)) < 0);
310 * skip over records with duplicate keys.
312 while (p > l->il_entries) {
313 t = iam_lfix_shift(l, p, -1);
314 if (lfix_keycmp(c, iam_leaf_key_at(t), k) == 0)
321 assert_corr(iam_leaf_at_rec(l));
323 if (lfix_keycmp(c, iam_leaf_key_at(l->il_at), k) == 0)
324 result = IAM_LOOKUP_EXACT;
332 static int iam_lfix_ilookup(struct iam_leaf *l, const struct iam_ikey *ik)
334 return iam_lfix_lookup(l, (const struct iam_key *)ik);
337 static void iam_lfix_key_set(struct iam_leaf *l, const struct iam_key *k)
339 assert_corr(iam_leaf_at_rec(l));
340 memcpy(iam_leaf_key_at(l->il_at), k, iam_leaf_descr(l)->id_key_size);
343 static int iam_lfix_key_cmp(const struct iam_leaf *l, const struct iam_key *k)
345 return lfix_keycmp(iam_leaf_container(l), iam_leaf_key_at(l->il_at), k);
348 static int iam_lfix_key_eq(const struct iam_leaf *l, const struct iam_key *k)
350 return !lfix_keycmp(iam_leaf_container(l),
351 iam_leaf_key_at(l->il_at), k);
354 static void iam_lfix_rec_set(struct iam_leaf *l, const struct iam_rec *r)
356 assert_corr(iam_leaf_at_rec(l));
357 memcpy(iam_lfix_rec(l), r, iam_leaf_descr(l)->id_rec_size);
360 static inline int lfix_reccmp(const struct iam_container *c,
361 const struct iam_rec *r1,
362 const struct iam_rec *r2)
364 return memcmp(r1, r2, c->ic_descr->id_rec_size);
367 static int iam_lfix_rec_eq(const struct iam_leaf *l, const struct iam_rec *r)
369 return !lfix_reccmp(iam_leaf_container(l), iam_lfix_rec(l), r);
372 static void iam_lfix_rec_get(const struct iam_leaf *l, struct iam_rec *r)
374 assert_corr(iam_leaf_at_rec(l));
375 memcpy(r, iam_lfix_rec(l), iam_leaf_descr(l)->id_rec_size);
378 static void iam_lfix_rec_add(struct iam_leaf *leaf,
379 const struct iam_key *k, const struct iam_rec *r)
381 struct iam_lentry *end;
382 struct iam_lentry *cur;
383 struct iam_lentry *start;
387 assert_corr(iam_leaf_can_add(leaf, k, r));
389 count = lentry_count_get(leaf);
391 * This branch handles two exceptional cases:
393 * - leaf positioned beyond last record, and
397 if (!iam_leaf_at_end(leaf)) {
398 end = iam_lfix_get_end(leaf);
400 if (lfix_keycmp(iam_leaf_container(leaf),
401 k, iam_leaf_key_at(cur)) >= 0)
405 * Another exceptional case: insertion with the key
406 * less than least key in the leaf.
408 assert_corr(cur == leaf->il_entries);
411 diff = (void *)end - (void *)start;
412 assert_corr(diff >= 0);
413 memmove(iam_lfix_shift(leaf, start, 1), start, diff);
415 lentry_count_set(leaf, count + 1);
416 iam_lfix_key_set(leaf, k);
417 iam_lfix_rec_set(leaf, r);
418 assert_corr(iam_leaf_at_rec(leaf));
421 static void iam_lfix_rec_del(struct iam_leaf *leaf, int shift)
423 struct iam_lentry *next, *end;
427 assert_corr(iam_leaf_at_rec(leaf));
429 count = lentry_count_get(leaf);
430 end = iam_lfix_get_end(leaf);
431 next = iam_lfix_shift(leaf, leaf->il_at, 1);
432 diff = (void *)end - (void *)next;
433 memmove(leaf->il_at, next, diff);
435 lentry_count_set(leaf, count - 1);
438 static int iam_lfix_can_add(const struct iam_leaf *l,
439 const struct iam_key *k, const struct iam_rec *r)
441 return lentry_count_get(l) < leaf_count_limit(l);
444 static int iam_lfix_at_end(const struct iam_leaf *folio)
446 return folio->il_at == iam_lfix_get_end(folio);
449 static void iam_lfix_init_new(struct iam_container *c, struct buffer_head *bh)
451 struct iam_leaf_head *hdr;
453 hdr = (struct iam_leaf_head*)bh->b_data;
454 hdr->ill_magic = cpu_to_le16(IAM_LEAF_HEADER_MAGIC);
455 hdr->ill_count = cpu_to_le16(0);
458 static void iam_lfix_split(struct iam_leaf *l, struct buffer_head **bh,
461 struct iam_path *path;
462 struct iam_leaf_head *hdr;
463 const struct iam_ikey *pivot;
464 struct buffer_head *new_leaf;
473 path = iam_leaf_path(l);
475 hdr = (void *)new_leaf->b_data;
477 count = lentry_count_get(l);
480 start = iam_lfix_shift(l, iam_get_lentries(l), split);
481 finis = iam_lfix_shift(l, iam_get_lentries(l), count);
483 pivot = (const struct iam_ikey *)iam_leaf_key_at(start);
485 memmove(iam_entries(new_leaf), start, finis - start);
486 hdr->ill_count = cpu_to_le16(count - split);
487 lentry_count_set(l, split);
488 if ((void *)l->il_at >= start) {
490 * insertion point moves into new leaf.
495 shift = iam_lfix_diff(l, l->il_at, start);
498 l->il_curidx = new_blknr;
499 result = iam_lfix_init(l);
501 * init cannot fail, as node was just initialized.
503 assert_corr(result == 0);
504 l->il_at = iam_lfix_shift(l, iam_get_lentries(l), shift);
507 * Insert pointer to the new node (together with the least key in
508 * the node) into index node.
510 iam_insert_key_lock(path, path->ip_frame, pivot, new_blknr);
513 static int iam_lfix_leaf_empty(struct iam_leaf *leaf)
515 return lentry_count_get(leaf) == 0;
518 static struct iam_leaf_operations iam_lfix_leaf_ops = {
519 .init = iam_lfix_init,
520 .init_new = iam_lfix_init_new,
521 .fini = iam_lfix_fini,
522 .start = iam_lfix_start,
523 .next = iam_lfix_next,
525 .ikey = iam_lfix_ikey,
527 .key_set = iam_lfix_key_set,
528 .key_cmp = iam_lfix_key_cmp,
529 .key_eq = iam_lfix_key_eq,
530 .key_size = iam_lfix_key_size,
531 .rec_set = iam_lfix_rec_set,
532 .rec_eq = iam_lfix_rec_eq,
533 .rec_get = iam_lfix_rec_get,
534 .lookup = iam_lfix_lookup,
535 .ilookup = iam_lfix_ilookup,
536 .at_end = iam_lfix_at_end,
537 .rec_add = iam_lfix_rec_add,
538 .rec_del = iam_lfix_rec_del,
539 .can_add = iam_lfix_can_add,
540 .split = iam_lfix_split,
541 .leaf_empty = iam_lfix_leaf_empty,
549 /* This is duplicated in lustre/utils/create_iam.c */
551 * Then shalt thou see the dew-BEDABBLED wretch
552 * Turn, and return, indenting with the way;
553 * Each envious brier his weary legs doth scratch,
554 * Each shadow makes him stop, each murmur stay:
555 * For misery is trodden on by many,
556 * And being low never relieved by any.
558 IAM_LFIX_ROOT_MAGIC = 0xbedabb1edULL // d01efull
561 /* This is duplicated in lustre/utils/create_iam.c */
562 struct iam_lfix_root {
567 u8 ilr_indirect_levels;
571 static __u32 iam_lfix_root_ptr(struct iam_container *c)
576 static int iam_lfix_node_init(struct iam_container *c, struct buffer_head *bh,
582 static struct iam_entry *iam_lfix_root_inc(struct iam_container *c,
583 struct iam_path *path,
584 struct iam_frame *frame)
586 struct iam_lfix_root *root;
587 struct iam_entry *entries;
589 entries = frame->entries;
591 dx_set_count(entries, 2);
592 assert_corr(dx_get_limit(entries) == dx_root_limit(path));
594 root = (void *)frame->bh->b_data;
595 assert_corr(le64_to_cpu(root->ilr_magic) == IAM_LFIX_ROOT_MAGIC);
596 root->ilr_indirect_levels ++;
597 frame->at = entries = iam_entry_shift(path, entries, 1);
598 memset(iam_ikey_at(path, entries), 0,
599 iam_path_descr(path)->id_ikey_size);
603 static int iam_lfix_node_check(struct iam_path *path, struct iam_frame *frame)
607 unsigned limit_correct;
608 struct iam_entry *entries;
610 entries = dx_node_get_entries(path, frame);
612 if (frame == path->ip_frames) {
613 struct iam_lfix_root *root;
615 root = (void *)frame->bh->b_data;
616 if (le64_to_cpu(root->ilr_magic) != IAM_LFIX_ROOT_MAGIC) {
619 limit_correct = dx_root_limit(path);
621 limit_correct = dx_node_limit(path);
622 count = dx_get_count(entries);
623 limit = dx_get_limit(entries);
627 if (limit != limit_correct) {
633 static int iam_lfix_node_load(struct iam_path *path, struct iam_frame *frame)
635 struct iam_entry *entries;
637 entries = dx_node_get_entries(path, frame);
639 data = frame->bh->b_data;
641 if (frame == path->ip_frames) {
642 struct iam_lfix_root *root;
645 path->ip_indirect = root->ilr_indirect_levels;
646 if (path->ip_ikey_target == NULL)
647 path->ip_ikey_target =
648 (struct iam_ikey *)path->ip_key_target;
650 frame->entries = frame->at = entries;
654 static int iam_lfix_ikeycmp(const struct iam_container *c,
655 const struct iam_ikey *k1,
656 const struct iam_ikey *k2)
658 return memcmp(k1, k2, c->ic_descr->id_ikey_size);
661 static struct iam_path_descr *iam_lfix_ipd_alloc(const struct iam_container *c,
664 return iam_ipd_alloc(area, c->ic_descr->id_ikey_size);
667 static struct iam_operations iam_lfix_ops = {
668 .id_root_ptr = iam_lfix_root_ptr,
669 .id_node_read = iam_node_read,
670 .id_node_init = iam_lfix_node_init,
671 .id_node_check = iam_lfix_node_check,
672 .id_node_load = iam_lfix_node_load,
673 .id_ikeycmp = iam_lfix_ikeycmp,
674 .id_root_inc = iam_lfix_root_inc,
675 .id_ipd_alloc = iam_lfix_ipd_alloc,
676 .id_ipd_free = iam_ipd_free,
680 static int iam_lfix_guess(struct iam_container *c)
683 struct buffer_head *bh;
684 const struct iam_lfix_root *root;
686 assert_corr(c->ic_object != NULL);
688 result = iam_node_read(c, iam_lfix_root_ptr(c), NULL, &bh);
690 root = (void *)bh->b_data;
691 if (le64_to_cpu(root->ilr_magic) == IAM_LFIX_ROOT_MAGIC) {
692 struct iam_descr *descr;
695 descr->id_key_size = le16_to_cpu(root->ilr_keysize);
696 descr->id_ikey_size = le16_to_cpu(root->ilr_keysize);
697 descr->id_rec_size = le16_to_cpu(root->ilr_recsize);
698 descr->id_ptr_size = le16_to_cpu(root->ilr_ptrsize);
699 descr->id_root_gap = sizeof(struct iam_lfix_root);
700 descr->id_node_gap = 0;
701 descr->id_ops = &iam_lfix_ops;
702 descr->id_leaf_ops = &iam_lfix_leaf_ops;
713 static struct iam_format iam_lfix_format = {
714 .if_guess = iam_lfix_guess
717 void iam_lfix_format_init(void)
719 iam_format_register(&iam_lfix_format);
730 #define LFIX_ROOT_RECNO \
731 ((4096 - sizeof(struct iam_lfix_root)) / (KEYSIZE + PTRSIZE))
733 #define LFIX_INDEX_RECNO (4096 / (KEYSIZE + PTRSIZE))
735 #define LFIX_LEAF_RECNO \
736 ((4096 - sizeof(struct iam_leaf_head)) / (KEYSIZE + RECSIZE))
739 struct iam_lfix_root lr_root;
743 } lr_entry[LFIX_ROOT_RECNO];
747 struct dx_countlimit li_cl;
748 char li_padding[KEYSIZE + PTRSIZE - sizeof(struct dx_countlimit)];
752 } li_entry[LFIX_INDEX_RECNO - 1];
756 struct iam_leaf_head ll_head;
760 } ll_entry[LFIX_LEAF_RECNO];
763 #define STORE_UNALIGNED(val, dst) \
765 typeof(val) __val = (val); \
766 CLASSERT(sizeof(val) == sizeof(*(dst))); \
767 memcpy(dst, &__val, sizeof(*(dst))); \
770 static void lfix_root(void *buf,
771 int blocksize, int keysize, int ptrsize, int recsize)
773 struct iam_lfix_root *root;
774 struct dx_countlimit *limit;
778 *root = (typeof(*root)) {
779 .ilr_magic = cpu_to_le64(IAM_LFIX_ROOT_MAGIC),
780 .ilr_keysize = cpu_to_le16(keysize),
781 .ilr_recsize = cpu_to_le16(recsize),
782 .ilr_ptrsize = cpu_to_le16(ptrsize),
783 .ilr_indirect_levels = 0
786 limit = (void *)(root + 1);
787 *limit = (typeof(*limit)){
789 * limit itself + one pointer to the leaf.
791 .count = cpu_to_le16(2),
792 .limit = iam_root_limit(sizeof(struct iam_lfix_root),
793 blocksize, keysize + ptrsize)
796 /* To guarantee that the padding "keysize + ptrsize"
797 * covers the "dx_countlimit" and the "idle_blocks". */
798 LASSERT((keysize + ptrsize) >=
799 (sizeof(struct dx_countlimit) + sizeof(__u32)));
801 entry = (void *)(limit + 1);
802 /* Put "idle_blocks" just after the limit. There was padding after
803 * the limit, the "idle_blocks" re-uses part of the padding, so no
804 * compatibility issues with old layout.
811 entry = (void *)(root + 1) + keysize + ptrsize;
814 * Entry format is <key> followed by <ptr>. In the minimal tree
815 * consisting of a root and single node, <key> is a minimal possible
818 * XXX: this key is hard-coded to be a sequence of 0's.
821 memset(entry, 0, keysize);
823 /* now @entry points to <ptr> */
825 STORE_UNALIGNED(cpu_to_le32(1), (u_int32_t *)entry);
827 STORE_UNALIGNED(cpu_to_le64(1), (u_int64_t *)entry);
830 static void lfix_leaf(void *buf,
831 int blocksize, int keysize, int ptrsize, int recsize)
833 struct iam_leaf_head *head;
838 *head = (struct iam_leaf_head) {
839 .ill_magic = cpu_to_le16(IAM_LEAF_HEADER_MAGIC),
841 * Leaf contains an entry with the smallest possible key
842 * (created by zeroing).
844 .ill_count = cpu_to_le16(1),
847 entry = (void *)(head + 1);
848 memset(entry, 0, keysize + recsize);
851 int iam_lfix_create(struct inode *obj,
852 int keysize, int ptrsize, int recsize, handle_t *handle)
854 struct buffer_head *root_node;
855 struct buffer_head *leaf_node;
856 struct super_block *sb;
862 assert_corr(obj->i_size == 0);
865 bsize = sb->s_blocksize;
866 root_node = osd_ldiskfs_append(handle, obj, &blknr, &result);
867 leaf_node = osd_ldiskfs_append(handle, obj, &blknr, &result);
868 if (root_node != NULL && leaf_node != NULL) {
869 lfix_root(root_node->b_data, bsize, keysize, ptrsize, recsize);
870 lfix_leaf(leaf_node->b_data, bsize, keysize, ptrsize, recsize);
871 ldiskfs_mark_inode_dirty(handle, obj);
872 result = ldiskfs_journal_dirty_metadata(handle, root_node);
874 result = ldiskfs_journal_dirty_metadata(handle, leaf_node);
876 ldiskfs_std_error(sb, result);
882 EXPORT_SYMBOL(iam_lfix_create);