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

   1 /* SPDX-License-Identifier: GPL-2.0 */
   2 #ifndef _BCACHEFS_BTREE_ITER_H
   3 #define _BCACHEFS_BTREE_ITER_H
   4
   5 #include "bset.h"
   6 #include "btree_types.h"
   7
   8 #include <trace/events/bcachefs.h>
   9
  10 static inline void __btree_path_get(struct btree_path *path, bool intent)
  11 {
  12         path->ref++;
  13         path->intent_ref += intent;
  14 }
  15
  16 static inline bool __btree_path_put(struct btree_path *path, bool intent)
  17 {
  18         EBUG_ON(!path->ref);
  19         EBUG_ON(!path->intent_ref && intent);
  20         path->intent_ref -= intent;
  21         return --path->ref == 0;
  22 }
  23
  24 static inline void btree_path_set_dirty(struct btree_path *path,
  25                                         enum btree_path_uptodate u)
  26 {
  27         path->uptodate = max_t(unsigned, path->uptodate, u);
  28 }
  29
  30 static inline struct btree *btree_path_node(struct btree_path *path,
  31                                             unsigned level)
  32 {
  33         return level < BTREE_MAX_DEPTH ? path->l[level].b : NULL;
  34 }
  35
  36 static inline bool btree_node_lock_seq_matches(const struct btree_path *path,
  37                                         const struct btree *b, unsigned level)
  38 {
  39         /*
  40          * We don't compare the low bits of the lock sequence numbers because
  41          * @path might have taken a write lock on @b, and we don't want to skip
  42          * the linked path if the sequence numbers were equal before taking that
  43          * write lock. The lock sequence number is incremented by taking and
  44          * releasing write locks and is even when unlocked:
  45          */
  46         return path->l[level].lock_seq >> 1 == b->c.lock.state.seq >> 1;
  47 }
  48
  49 static inline struct btree *btree_node_parent(struct btree_path *path,
  50                                               struct btree *b)
  51 {
  52         return btree_path_node(path, b->c.level + 1);
  53 }
  54
  55 /* Iterate over paths within a transaction: */
  56
  57 static inline struct btree_path *
  58 __trans_next_path(struct btree_trans *trans, unsigned idx)
  59 {
  60         u64 l;
  61
  62         if (idx == BTREE_ITER_MAX)
  63                 return NULL;
  64
  65         l = trans->paths_allocated >> idx;
  66         if (!l)
  67                 return NULL;
  68
  69         idx += __ffs64(l);
  70         EBUG_ON(idx >= BTREE_ITER_MAX);
  71         EBUG_ON(trans->paths[idx].idx != idx);
  72         return &trans->paths[idx];
  73 }
  74
  75 void bch2_btree_path_check_sort(struct btree_trans *, struct btree_path *, int);
  76
  77 #define trans_for_each_path_from(_trans, _path, _start)                 \
  78         for (_path = __trans_next_path((_trans), _start);               \
  79              (_path);                                                   \
  80              _path = __trans_next_path((_trans), (_path)->idx + 1))
  81
  82 #define trans_for_each_path(_trans, _path)                              \
  83         trans_for_each_path_from(_trans, _path, 0)
  84
  85 static inline struct btree_path *next_btree_path(struct btree_trans *trans, struct btree_path *path)
  86 {
  87         unsigned idx = path ? path->sorted_idx + 1 : 0;
  88
  89         EBUG_ON(idx > trans->nr_sorted);
  90
  91         return idx < trans->nr_sorted
  92                 ? trans->paths + trans->sorted[idx]
  93                 : NULL;
  94 }
  95
  96 static inline struct btree_path *prev_btree_path(struct btree_trans *trans, struct btree_path *path)
  97 {
  98         EBUG_ON(path->sorted_idx >= trans->nr_sorted);
  99         return path->sorted_idx
 100                 ? trans->paths + trans->sorted[path->sorted_idx - 1]
 101                 : NULL;
 102 }
 103
 104 #define trans_for_each_path_inorder(_trans, _path, _i)                  \
 105         for (_i = 0;                                                    \
 106              ((_path) = (_trans)->paths + trans->sorted[_i]), (_i) < (_trans)->nr_sorted;\
 107              _i++)
 108
 109 static inline bool __path_has_node(const struct btree_path *path,
 110                                    const struct btree *b)
 111 {
 112         return path->l[b->c.level].b == b &&
 113                 btree_node_lock_seq_matches(path, b, b->c.level);
 114 }
 115
 116 static inline struct btree_path *
 117 __trans_next_path_with_node(struct btree_trans *trans, struct btree *b,
 118                             unsigned idx)
 119 {
 120         struct btree_path *path = __trans_next_path(trans, idx);
 121
 122         while (path && !__path_has_node(path, b))
 123                 path = __trans_next_path(trans, path->idx + 1);
 124
 125         return path;
 126 }
 127
 128 #define trans_for_each_path_with_node(_trans, _b, _path)                \
 129         for (_path = __trans_next_path_with_node((_trans), (_b), 0);    \
 130              (_path);                                                   \
 131              _path = __trans_next_path_with_node((_trans), (_b),        \
 132                                                  (_path)->idx + 1))
 133
 134 struct btree_path *__bch2_btree_path_make_mut(struct btree_trans *, struct btree_path *,
 135                          bool, unsigned long);
 136
 137 static inline struct btree_path * __must_check
 138 bch2_btree_path_make_mut(struct btree_trans *trans,
 139                          struct btree_path *path, bool intent,
 140                          unsigned long ip)
 141 {
 142         if (path->ref > 1 || path->preserve)
 143                 path = __bch2_btree_path_make_mut(trans, path, intent, ip);
 144         path->should_be_locked = false;
 145         return path;
 146 }
 147
 148 struct btree_path * __must_check
 149 __bch2_btree_path_set_pos(struct btree_trans *, struct btree_path *,
 150                         struct bpos, bool, unsigned long, int);
 151
 152 static inline struct btree_path * __must_check
 153 bch2_btree_path_set_pos(struct btree_trans *trans,
 154                    struct btree_path *path, struct bpos new_pos,
 155                    bool intent, unsigned long ip)
 156 {
 157         int cmp = bpos_cmp(new_pos, path->pos);
 158
 159         return cmp
 160                 ? __bch2_btree_path_set_pos(trans, path, new_pos, intent, ip, cmp)
 161                 : path;
 162 }
 163
 164 int __must_check bch2_btree_path_traverse(struct btree_trans *,
 165                                           struct btree_path *, unsigned);
 166 struct btree_path *bch2_path_get(struct btree_trans *, enum btree_id, struct bpos,
 167                                  unsigned, unsigned, unsigned, unsigned long);
 168 struct bkey_s_c bch2_btree_path_peek_slot(struct btree_path *, struct bkey *);
 169
 170 struct bkey_i *bch2_btree_journal_peek_slot(struct btree_trans *,
 171                                         struct btree_iter *, struct bpos);
 172
 173 void bch2_btree_path_level_init(struct btree_trans *, struct btree_path *, struct btree *);
 174
 175 #ifdef CONFIG_BCACHEFS_DEBUG
 176 void bch2_trans_verify_paths(struct btree_trans *);
 177 void bch2_assert_pos_locked(struct btree_trans *, enum btree_id,
 178                             struct bpos, bool);
 179 #else
 180 static inline void bch2_trans_verify_paths(struct btree_trans *trans) {}
 181 static inline void bch2_assert_pos_locked(struct btree_trans *trans, enum btree_id id,
 182                                           struct bpos pos, bool key_cache) {}
 183 #endif
 184
 185 void bch2_btree_path_fix_key_modified(struct btree_trans *trans,
 186                                       struct btree *, struct bkey_packed *);
 187 void bch2_btree_node_iter_fix(struct btree_trans *trans, struct btree_path *,
 188                               struct btree *, struct btree_node_iter *,
 189                               struct bkey_packed *, unsigned, unsigned);
 190
 191 int bch2_btree_path_relock_intent(struct btree_trans *, struct btree_path *);
 192
 193 void bch2_path_put(struct btree_trans *, struct btree_path *, bool);
 194
 195 int bch2_trans_relock(struct btree_trans *);
 196 void bch2_trans_unlock(struct btree_trans *);
 197 bool bch2_trans_locked(struct btree_trans *);
 198
 199 static inline bool trans_was_restarted(struct btree_trans *trans, u32 restart_count)
 200 {
 201         return restart_count != trans->restart_count;
 202 }
 203
 204 void bch2_trans_verify_not_restarted(struct btree_trans *, u32);
 205
 206 __always_inline
 207 static inline int btree_trans_restart_nounlock(struct btree_trans *trans, int err)
 208 {
 209         BUG_ON(err <= 0);
 210         BUG_ON(!bch2_err_matches(err, BCH_ERR_transaction_restart));
 211
 212         trans->restarted = err;
 213         return -err;
 214 }
 215
 216 __always_inline
 217 static inline int btree_trans_restart(struct btree_trans *trans, int err)
 218 {
 219         btree_trans_restart_nounlock(trans, err);
 220         return -err;
 221 }
 222
 223 bool bch2_btree_node_upgrade(struct btree_trans *,
 224                              struct btree_path *, unsigned);
 225
 226 void __bch2_btree_path_downgrade(struct btree_trans *, struct btree_path *, unsigned);
 227
 228 static inline void bch2_btree_path_downgrade(struct btree_trans *trans,
 229                                              struct btree_path *path)
 230 {
 231         unsigned new_locks_want = path->level + !!path->intent_ref;
 232
 233         if (path->locks_want > new_locks_want)
 234                 __bch2_btree_path_downgrade(trans, path, new_locks_want);
 235 }
 236
 237 void bch2_trans_downgrade(struct btree_trans *);
 238
 239 void bch2_trans_node_add(struct btree_trans *trans, struct btree *);
 240 void bch2_trans_node_reinit_iter(struct btree_trans *, struct btree *);
 241
 242 int __must_check __bch2_btree_iter_traverse(struct btree_iter *iter);
 243 int __must_check bch2_btree_iter_traverse(struct btree_iter *);
 244
 245 struct btree *bch2_btree_iter_peek_node(struct btree_iter *);
 246 struct btree *bch2_btree_iter_next_node(struct btree_iter *);
 247
 248 struct bkey_s_c bch2_btree_iter_peek_upto(struct btree_iter *, struct bpos);
 249 struct bkey_s_c bch2_btree_iter_next(struct btree_iter *);
 250
 251 struct bkey_s_c bch2_btree_iter_peek_all_levels(struct btree_iter *);
 252
 253 static inline struct bkey_s_c bch2_btree_iter_peek(struct btree_iter *iter)
 254 {
 255         return bch2_btree_iter_peek_upto(iter, SPOS_MAX);
 256 }
 257
 258 struct bkey_s_c bch2_btree_iter_peek_prev(struct btree_iter *);
 259 struct bkey_s_c bch2_btree_iter_prev(struct btree_iter *);
 260
 261 struct bkey_s_c bch2_btree_iter_peek_slot(struct btree_iter *);
 262 struct bkey_s_c bch2_btree_iter_next_slot(struct btree_iter *);
 263 struct bkey_s_c bch2_btree_iter_prev_slot(struct btree_iter *);
 264
 265 bool bch2_btree_iter_advance(struct btree_iter *);
 266 bool bch2_btree_iter_rewind(struct btree_iter *);
 267
 268 static inline void __bch2_btree_iter_set_pos(struct btree_iter *iter, struct bpos new_pos)
 269 {
 270         iter->k.type = KEY_TYPE_deleted;
 271         iter->k.p.inode         = iter->pos.inode       = new_pos.inode;
 272         iter->k.p.offset        = iter->pos.offset      = new_pos.offset;
 273         iter->k.p.snapshot      = iter->pos.snapshot    = new_pos.snapshot;
 274         iter->k.size = 0;
 275 }
 276
 277 static inline void bch2_btree_iter_set_pos(struct btree_iter *iter, struct bpos new_pos)
 278 {
 279         if (unlikely(iter->update_path))
 280                 bch2_path_put(iter->trans, iter->update_path,
 281                               iter->flags & BTREE_ITER_INTENT);
 282         iter->update_path = NULL;
 283
 284         if (!(iter->flags & BTREE_ITER_ALL_SNAPSHOTS))
 285                 new_pos.snapshot = iter->snapshot;
 286
 287         __bch2_btree_iter_set_pos(iter, new_pos);
 288 }
 289
 290 static inline void bch2_btree_iter_set_pos_to_extent_start(struct btree_iter *iter)
 291 {
 292         BUG_ON(!(iter->flags & BTREE_ITER_IS_EXTENTS));
 293         iter->pos = bkey_start_pos(&iter->k);
 294 }
 295
 296 static inline void bch2_btree_iter_set_snapshot(struct btree_iter *iter, u32 snapshot)
 297 {
 298         struct bpos pos = iter->pos;
 299
 300         iter->snapshot = snapshot;
 301         pos.snapshot = snapshot;
 302         bch2_btree_iter_set_pos(iter, pos);
 303 }
 304
 305 void bch2_trans_iter_exit(struct btree_trans *, struct btree_iter *);
 306 void bch2_trans_iter_init(struct btree_trans *, struct btree_iter *,
 307                           unsigned, struct bpos, unsigned);
 308 void bch2_trans_node_iter_init(struct btree_trans *, struct btree_iter *,
 309                                enum btree_id, struct bpos,
 310                                unsigned, unsigned, unsigned);
 311 void bch2_trans_copy_iter(struct btree_iter *, struct btree_iter *);
 312
 313 static inline void set_btree_iter_dontneed(struct btree_iter *iter)
 314 {
 315         if (!iter->trans->restarted)
 316                 iter->path->preserve = false;
 317 }
 318
 319 void *__bch2_trans_kmalloc(struct btree_trans *, size_t);
 320
 321 static inline void *bch2_trans_kmalloc(struct btree_trans *trans, size_t size)
 322 {
 323         unsigned new_top = trans->mem_top + size;
 324         void *p = trans->mem + trans->mem_top;
 325
 326         if (likely(new_top <= trans->mem_bytes)) {
 327                 trans->mem_top += size;
 328                 memset(p, 0, size);
 329                 return p;
 330         } else {
 331                 return __bch2_trans_kmalloc(trans, size);
 332
 333         }
 334 }
 335
 336 u32 bch2_trans_begin(struct btree_trans *);
 337
 338 static inline struct btree *
 339 __btree_iter_peek_node_and_restart(struct btree_trans *trans, struct btree_iter *iter)
 340 {
 341         struct btree *b;
 342
 343         while (b = bch2_btree_iter_peek_node(iter),
 344                bch2_err_matches(PTR_ERR_OR_ZERO(b), BCH_ERR_transaction_restart))
 345                 bch2_trans_begin(trans);
 346
 347         return b;
 348 }
 349
 350 /*
 351  * XXX
 352  * this does not handle transaction restarts from bch2_btree_iter_next_node()
 353  * correctly
 354  */
 355 #define __for_each_btree_node(_trans, _iter, _btree_id, _start,         \
 356                               _locks_want, _depth, _flags, _b, _ret)    \
 357         for (bch2_trans_node_iter_init((_trans), &(_iter), (_btree_id), \
 358                                 _start, _locks_want, _depth, _flags);   \
 359              (_b) = __btree_iter_peek_node_and_restart((_trans), &(_iter)),\
 360              !((_ret) = PTR_ERR_OR_ZERO(_b)) && (_b);                   \
 361              (_b) = bch2_btree_iter_next_node(&(_iter)))
 362
 363 #define for_each_btree_node(_trans, _iter, _btree_id, _start,           \
 364                             _flags, _b, _ret)                           \
 365         __for_each_btree_node(_trans, _iter, _btree_id, _start,         \
 366                               0, 0, _flags, _b, _ret)
 367
 368 static inline int bkey_err(struct bkey_s_c k)
 369 {
 370         return PTR_ERR_OR_ZERO(k.k);
 371 }
 372
 373 static inline struct bkey_s_c bch2_btree_iter_peek_prev_type(struct btree_iter *iter,
 374                                                              unsigned flags)
 375 {
 376         BUG_ON(flags & BTREE_ITER_ALL_LEVELS);
 377
 378         return  flags & BTREE_ITER_SLOTS      ? bch2_btree_iter_peek_slot(iter) :
 379                                                 bch2_btree_iter_peek_prev(iter);
 380 }
 381
 382 static inline struct bkey_s_c bch2_btree_iter_peek_type(struct btree_iter *iter,
 383                                                         unsigned flags)
 384 {
 385         return  flags & BTREE_ITER_ALL_LEVELS ? bch2_btree_iter_peek_all_levels(iter) :
 386                 flags & BTREE_ITER_SLOTS      ? bch2_btree_iter_peek_slot(iter) :
 387                                                 bch2_btree_iter_peek(iter);
 388 }
 389
 390 static inline struct bkey_s_c bch2_btree_iter_peek_upto_type(struct btree_iter *iter,
 391                                                              struct bpos end,
 392                                                              unsigned flags)
 393 {
 394         if (!(flags & BTREE_ITER_SLOTS))
 395                 return bch2_btree_iter_peek_upto(iter, end);
 396
 397         if (bkey_cmp(iter->pos, end) > 0)
 398                 return bkey_s_c_null;
 399
 400         return bch2_btree_iter_peek_slot(iter);
 401 }
 402
 403 static inline int btree_trans_too_many_iters(struct btree_trans *trans)
 404 {
 405         if (hweight64(trans->paths_allocated) > BTREE_ITER_MAX - 8) {
 406                 trace_and_count(trans->c, trans_restart_too_many_iters, trans, _THIS_IP_);
 407                 return btree_trans_restart(trans, BCH_ERR_transaction_restart_too_many_iters);
 408         }
 409
 410         return 0;
 411 }
 412
 413 static inline struct bkey_s_c
 414 __bch2_btree_iter_peek_and_restart(struct btree_trans *trans,
 415                                    struct btree_iter *iter, unsigned flags)
 416 {
 417         struct bkey_s_c k;
 418
 419         while (btree_trans_too_many_iters(trans) ||
 420                (k = bch2_btree_iter_peek_type(iter, flags),
 421                 bch2_err_matches(bkey_err(k), BCH_ERR_transaction_restart)))
 422                 bch2_trans_begin(trans);
 423
 424         return k;
 425 }
 426
 427 #define lockrestart_do(_trans, _do)                                     \
 428 ({                                                                      \
 429         u32 _restart_count;                                             \
 430         int _ret;                                                       \
 431                                                                         \
 432         do {                                                            \
 433                 _restart_count = bch2_trans_begin(_trans);              \
 434                 _ret = (_do);                                           \
 435         } while (bch2_err_matches(_ret, BCH_ERR_transaction_restart));  \
 436                                                                         \
 437         if (!_ret)                                                      \
 438                 bch2_trans_verify_not_restarted(_trans, _restart_count);\
 439                                                                         \
 440         _ret;                                                           \
 441 })
 442
 443 /*
 444  * nested_lockrestart_do(), nested_commit_do():
 445  *
 446  * These are like lockrestart_do() and commit_do(), with two differences:
 447  *
 448  *  - We don't call bch2_trans_begin() unless we had a transaction restart
 449  *  - We return -BCH_ERR_transaction_restart_nested if we succeeded after a
 450  *  transaction restart
 451  */
 452 #define nested_lockrestart_do(_trans, _do)                              \
 453 ({                                                                      \
 454         u32 _restart_count, _orig_restart_count;                        \
 455         int _ret;                                                       \
 456                                                                         \
 457         _restart_count = _orig_restart_count = (_trans)->restart_count; \
 458                                                                         \
 459         while (bch2_err_matches(_ret = (_do), BCH_ERR_transaction_restart))\
 460                 _restart_count = bch2_trans_begin(_trans);              \
 461                                                                         \
 462         if (!_ret)                                                      \
 463                 bch2_trans_verify_not_restarted(_trans, _restart_count);\
 464                                                                         \
 465         if (!_ret && trans_was_restarted(_trans, _orig_restart_count))  \
 466                 _ret = -BCH_ERR_transaction_restart_nested;             \
 467                                                                         \
 468         _ret;                                                           \
 469 })
 470
 471 #define for_each_btree_key2(_trans, _iter, _btree_id,                   \
 472                             _start, _flags, _k, _do)                    \
 473 ({                                                                      \
 474         int _ret = 0;                                                   \
 475                                                                         \
 476         bch2_trans_iter_init((_trans), &(_iter), (_btree_id),           \
 477                              (_start), (_flags));                       \
 478                                                                         \
 479         while (1) {                                                     \
 480                 u32 _restart_count = bch2_trans_begin(_trans);          \
 481                                                                         \
 482                 _ret = 0;                                               \
 483                 (_k) = bch2_btree_iter_peek_type(&(_iter), (_flags));   \
 484                 if (!(_k).k)                                            \
 485                         break;                                          \
 486                                                                         \
 487                 _ret = bkey_err(_k) ?: (_do);                           \
 488                 if (bch2_err_matches(_ret, BCH_ERR_transaction_restart))\
 489                         continue;                                       \
 490                 if (_ret)                                               \
 491                         break;                                          \
 492                 bch2_trans_verify_not_restarted(_trans, _restart_count);\
 493                 if (!bch2_btree_iter_advance(&(_iter)))                 \
 494                         break;                                          \
 495         }                                                               \
 496                                                                         \
 497         bch2_trans_iter_exit((_trans), &(_iter));                       \
 498         _ret;                                                           \
 499 })
 500
 501 #define for_each_btree_key_reverse(_trans, _iter, _btree_id,            \
 502                                    _start, _flags, _k, _do)             \
 503 ({                                                                      \
 504         int _ret = 0;                                                   \
 505                                                                         \
 506         bch2_trans_iter_init((_trans), &(_iter), (_btree_id),           \
 507                              (_start), (_flags));                       \
 508                                                                         \
 509         while (1) {                                                     \
 510                 u32 _restart_count = bch2_trans_begin(_trans);          \
 511                 (_k) = bch2_btree_iter_peek_prev_type(&(_iter), (_flags));\
 512                 if (!(_k).k) {                                          \
 513                         _ret = 0;                                       \
 514                         break;                                          \
 515                 }                                                       \
 516                                                                         \
 517                 _ret = bkey_err(_k) ?: (_do);                           \
 518                 if (bch2_err_matches(_ret, BCH_ERR_transaction_restart))\
 519                         continue;                                       \
 520                 if (_ret)                                               \
 521                         break;                                          \
 522                 bch2_trans_verify_not_restarted(_trans, _restart_count);\
 523                 if (!bch2_btree_iter_rewind(&(_iter)))                  \
 524                         break;                                          \
 525         }                                                               \
 526                                                                         \
 527         bch2_trans_iter_exit((_trans), &(_iter));                       \
 528         _ret;                                                           \
 529 })
 530
 531 #define for_each_btree_key_commit(_trans, _iter, _btree_id,             \
 532                                   _start, _iter_flags, _k,              \
 533                                   _disk_res, _journal_seq, _commit_flags,\
 534                                   _do)                                  \
 535         for_each_btree_key2(_trans, _iter, _btree_id, _start, _iter_flags, _k,\
 536                             (_do) ?: bch2_trans_commit(_trans, (_disk_res),\
 537                                         (_journal_seq), (_commit_flags)))
 538
 539 #define for_each_btree_key(_trans, _iter, _btree_id,                    \
 540                            _start, _flags, _k, _ret)                    \
 541         for (bch2_trans_iter_init((_trans), &(_iter), (_btree_id),      \
 542                                   (_start), (_flags));                  \
 543              (_k) = __bch2_btree_iter_peek_and_restart((_trans), &(_iter), _flags),\
 544              !((_ret) = bkey_err(_k)) && (_k).k;                        \
 545              bch2_btree_iter_advance(&(_iter)))
 546
 547 #define for_each_btree_key_norestart(_trans, _iter, _btree_id,          \
 548                            _start, _flags, _k, _ret)                    \
 549         for (bch2_trans_iter_init((_trans), &(_iter), (_btree_id),      \
 550                                   (_start), (_flags));                  \
 551              (_k) = bch2_btree_iter_peek_type(&(_iter), _flags),        \
 552              !((_ret) = bkey_err(_k)) && (_k).k;                        \
 553              bch2_btree_iter_advance(&(_iter)))
 554
 555 #define for_each_btree_key_upto_norestart(_trans, _iter, _btree_id,     \
 556                            _start, _end, _flags, _k, _ret)              \
 557         for (bch2_trans_iter_init((_trans), &(_iter), (_btree_id),      \
 558                                   (_start), (_flags));                  \
 559              (_k) = bch2_btree_iter_peek_upto_type(&(_iter), _end, _flags),\
 560              !((_ret) = bkey_err(_k)) && (_k).k;                        \
 561              bch2_btree_iter_advance(&(_iter)))
 562
 563 #define for_each_btree_key_continue(_trans, _iter, _flags, _k, _ret)    \
 564         for (;                                                          \
 565              (_k) = __bch2_btree_iter_peek_and_restart((_trans), &(_iter), _flags),\
 566              !((_ret) = bkey_err(_k)) && (_k).k;                        \
 567              bch2_btree_iter_advance(&(_iter)))
 568
 569 #define for_each_btree_key_continue_norestart(_iter, _flags, _k, _ret)  \
 570         for (;                                                          \
 571              (_k) = bch2_btree_iter_peek_type(&(_iter), _flags),        \
 572              !((_ret) = bkey_err(_k)) && (_k).k;                        \
 573              bch2_btree_iter_advance(&(_iter)))
 574
 575 /* new multiple iterator interface: */
 576
 577 void bch2_trans_updates_to_text(struct printbuf *, struct btree_trans *);
 578 void bch2_btree_path_to_text(struct printbuf *, struct btree_path *);
 579 void bch2_trans_paths_to_text(struct printbuf *, struct btree_trans *);
 580 void bch2_dump_trans_updates(struct btree_trans *);
 581 void bch2_dump_trans_paths_updates(struct btree_trans *);
 582 void __bch2_trans_init(struct btree_trans *, struct bch_fs *, unsigned);
 583 void bch2_trans_exit(struct btree_trans *);
 584
 585 extern const char *bch2_btree_transaction_fns[BCH_TRANSACTIONS_NR];
 586 unsigned bch2_trans_get_fn_idx(const char *);
 587
 588 #define bch2_trans_init(_trans, _c, _nr_iters, _mem)                    \
 589 do {                                                                    \
 590         static unsigned trans_fn_idx;                                   \
 591                                                                         \
 592         if (unlikely(!trans_fn_idx))                                    \
 593                 trans_fn_idx = bch2_trans_get_fn_idx(__func__);         \
 594                                                                         \
 595         __bch2_trans_init(_trans, _c, trans_fn_idx);                    \
 596 } while (0)
 597
 598 void bch2_btree_trans_to_text(struct printbuf *, struct btree_trans *);
 599
 600 void bch2_fs_btree_iter_exit(struct bch_fs *);
 601 int bch2_fs_btree_iter_init(struct bch_fs *);
 602
 603 #endif /* _BCACHEFS_BTREE_ITER_H */