git.sesse.net Git - bcachefs-tools-debian/blob - libbcachefs/bkey_methods.h

   1 /* SPDX-License-Identifier: GPL-2.0 */
   2 #ifndef _BCACHEFS_BKEY_METHODS_H
   3 #define _BCACHEFS_BKEY_METHODS_H
   4
   5 #include "bkey.h"
   6
   7 struct bch_fs;
   8 struct btree;
   9 struct bkey;
  10 enum btree_node_type;
  11
  12 extern const char * const bch2_bkey_types[];
  13
  14 enum merge_result {
  15         BCH_MERGE_NOMERGE,
  16
  17         /*
  18          * The keys were mergeable, but would have overflowed size - so instead
  19          * l was changed to the maximum size, and both keys were modified:
  20          */
  21         BCH_MERGE_PARTIAL,
  22         BCH_MERGE_MERGE,
  23 };
  24
  25 struct bkey_ops {
  26         /* Returns reason for being invalid if invalid, else NULL: */
  27         const char *    (*key_invalid)(const struct bch_fs *,
  28                                        struct bkey_s_c);
  29         void            (*key_debugcheck)(struct bch_fs *, struct bkey_s_c);
  30         void            (*val_to_text)(struct printbuf *, struct bch_fs *,
  31                                        struct bkey_s_c);
  32         void            (*swab)(struct bkey_s);
  33         bool            (*key_normalize)(struct bch_fs *, struct bkey_s);
  34         enum merge_result (*key_merge)(struct bch_fs *,
  35                                        struct bkey_s, struct bkey_s);
  36         void            (*compat)(enum btree_id id, unsigned version,
  37                                   unsigned big_endian, int write,
  38                                   struct bkey_s);
  39 };
  40
  41 const char *bch2_bkey_val_invalid(struct bch_fs *, struct bkey_s_c);
  42 const char *__bch2_bkey_invalid(struct bch_fs *, struct bkey_s_c,
  43                                 enum btree_node_type);
  44 const char *bch2_bkey_invalid(struct bch_fs *, struct bkey_s_c,
  45                               enum btree_node_type);
  46 const char *bch2_bkey_in_btree_node(struct btree *, struct bkey_s_c);
  47
  48 void bch2_bkey_debugcheck(struct bch_fs *, struct btree *, struct bkey_s_c);
  49
  50 void bch2_bpos_to_text(struct printbuf *, struct bpos);
  51 void bch2_bkey_to_text(struct printbuf *, const struct bkey *);
  52 void bch2_val_to_text(struct printbuf *, struct bch_fs *,
  53                       struct bkey_s_c);
  54 void bch2_bkey_val_to_text(struct printbuf *, struct bch_fs *,
  55                            struct bkey_s_c);
  56
  57 void bch2_bkey_swab_val(struct bkey_s);
  58
  59 bool bch2_bkey_normalize(struct bch_fs *, struct bkey_s);
  60
  61 enum merge_result bch2_bkey_merge(struct bch_fs *,
  62                                   struct bkey_s, struct bkey_s);
  63
  64 void bch2_bkey_renumber(enum btree_node_type, struct bkey_packed *, int);
  65
  66 void __bch2_bkey_compat(unsigned, enum btree_id, unsigned, unsigned,
  67                         int, struct bkey_format *, struct bkey_packed *);
  68
  69 static inline void bch2_bkey_compat(unsigned level, enum btree_id btree_id,
  70                                unsigned version, unsigned big_endian,
  71                                int write,
  72                                struct bkey_format *f,
  73                                struct bkey_packed *k)
  74 {
  75         if (version < bcachefs_metadata_version_current ||
  76             big_endian != CPU_BIG_ENDIAN)
  77                 __bch2_bkey_compat(level, btree_id, version,
  78                                    big_endian, write, f, k);
  79
  80 }
  81
  82 #endif /* _BCACHEFS_BKEY_METHODS_H */