sys/vfs/hammer/hammer.h

   1 /*
   2  * Copyright (c) 2007 The DragonFly Project.  All rights reserved.
   3  *
   4  * This code is derived from software contributed to The DragonFly Project
   5  * by Matthew Dillon <dillon@backplane.com>
   6  *
   7  * Redistribution and use in source and binary forms, with or without
   8  * modification, are permitted provided that the following conditions
   9  * are met:
  10  *
  11  * 1. Redistributions of source code must retain the above copyright
  12  *    notice, this list of conditions and the following disclaimer.
  13  * 2. Redistributions in binary form must reproduce the above copyright
  14  *    notice, this list of conditions and the following disclaimer in
  15  *    the documentation and/or other materials provided with the
  16  *    distribution.
  17  * 3. Neither the name of The DragonFly Project nor the names of its
  18  *    contributors may be used to endorse or promote products derived
  19  *    from this software without specific, prior written permission.
  20  *
  21  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
  22  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
  23  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
  24  * FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE
  25  * COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
  26  * INCIDENTAL, SPECIAL, EXEMPLARY OR CONSEQUENTIAL DAMAGES (INCLUDING,
  27  * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
  28  * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
  29  * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
  30  * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
  31  * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  32  * SUCH DAMAGE.
  33  *
  34  * $DragonFly: src/sys/vfs/hammer/hammer.h,v 1.21 2008/01/09 04:05:37 dillon Exp $
  35  */
  36 /*
  37  * This header file contains structures used internally by the HAMMERFS
  38  * implementation.  See hammer_disk.h for on-disk structures.
  39  */
  40
  41 #include <sys/param.h>
  42 #include <sys/types.h>
  43 #include <sys/kernel.h>
  44 #include <sys/systm.h>
  45 #include <sys/tree.h>
  46 #include <sys/malloc.h>
  47 #include <sys/mount.h>
  48 #include <sys/vnode.h>
  49 #include <sys/globaldata.h>
  50 #include <sys/lockf.h>
  51 #include <sys/buf.h>
  52 #include <sys/queue.h>
  53 #include <sys/globaldata.h>
  54
  55 #include <sys/buf2.h>
  56 #include "hammer_alist.h"
  57 #include "hammer_disk.h"
  58 #include "hammer_mount.h"
  59
  60 #if defined(_KERNEL) || defined(_KERNEL_STRUCTURES)
  61
  62 MALLOC_DECLARE(M_HAMMER);
  63
  64 struct hammer_mount;
  65
  66 /*
  67  * Key structure used for custom RB tree inode lookups.  This prototypes
  68  * the function hammer_ino_rb_tree_RB_LOOKUP_INFO(root, info).
  69  */
  70 typedef struct hammer_inode_info {
  71         u_int64_t       obj_id;         /* (key) object identifier */
  72         hammer_tid_t    obj_asof;       /* (key) snapshot transid or 0 */
  73 } *hammer_inode_info_t;
  74
  75 /*
  76  * HAMMER Transaction tracking
  77  */
  78 struct hammer_transaction {
  79         struct hammer_mount *hmp;
  80         hammer_tid_t    tid;
  81         struct hammer_volume *rootvol;
  82 };
  83
  84 typedef struct hammer_transaction *hammer_transaction_t;
  85
  86 /*
  87  * HAMMER locks
  88  */
  89 struct hammer_lock {
  90         int     refs;           /* active references delay writes */
  91         int     modifying;      /* indicates buffer being modified */
  92         int     lockcount;      /* lock count for exclusive/shared access */
  93         int     wanted;
  94         struct thread *locktd;
  95 };
  96
  97 static __inline int
  98 hammer_islocked(struct hammer_lock *lock)
  99 {
 100         return(lock->lockcount != 0);
 101 }
 102
 103 static __inline int
 104 hammer_isactive(struct hammer_lock *lock)
 105 {
 106         return(lock->refs != 0);
 107 }
 108
 109 static __inline int
 110 hammer_islastref(struct hammer_lock *lock)
 111 {
 112         return(lock->refs == 1);
 113 }
 114
 115 /*
 116  * Structure used to represent an inode in-memory.
 117  *
 118  * The record and data associated with an inode may be out of sync with
 119  * the disk (xDIRTY flags), or not even on the disk at all (ONDISK flag
 120  * clear).
 121  *
 122  * An inode may also hold a cache of unsynchronized records, used for
 123  * database and directories only.  Unsynchronized regular file data is
 124  * stored in the buffer cache.
 125  *
 126  * NOTE: A file which is created and destroyed within the initial
 127  * synchronization period can wind up not doing any disk I/O at all.
 128  *
 129  * Finally, an inode may cache numerous disk-referencing B-Tree cursors.
 130  */
 131 struct hammer_ino_rb_tree;
 132 struct hammer_inode;
 133 RB_HEAD(hammer_ino_rb_tree, hammer_inode);
 134 RB_PROTOTYPEX(hammer_ino_rb_tree, INFO, hammer_inode, rb_node,
 135               hammer_ino_rb_compare, hammer_inode_info_t);
 136
 137 struct hammer_rec_rb_tree;
 138 struct hammer_record;
 139 RB_HEAD(hammer_rec_rb_tree, hammer_record);
 140 RB_PROTOTYPEX(hammer_rec_rb_tree, INFO, hammer_record, rb_node,
 141               hammer_rec_rb_compare, hammer_base_elm_t);
 142
 143 TAILQ_HEAD(hammer_node_list, hammer_node);
 144
 145 struct hammer_inode {
 146         RB_ENTRY(hammer_inode) rb_node;
 147         u_int64_t       obj_id;         /* (key) object identifier */
 148         hammer_tid_t    obj_asof;       /* (key) snapshot transid or 0 */
 149         hammer_tid_t    last_tid;       /* last modified tid (for fsync) */
 150         struct hammer_mount *hmp;
 151         int             flags;
 152         struct vnode    *vp;
 153         struct lockf    advlock;
 154         struct hammer_lock lock;
 155         struct hammer_inode_record ino_rec;
 156         struct hammer_inode_data ino_data;
 157         struct hammer_rec_rb_tree rec_tree;     /* red-black record tree */
 158         struct hammer_node      *cache[2];      /* search initiate cache */
 159 };
 160
 161 typedef struct hammer_inode *hammer_inode_t;
 162
 163 #define VTOI(vp)        ((struct hammer_inode *)(vp)->v_data)
 164
 165 #define HAMMER_INODE_DDIRTY     0x0001  /* in-memory ino_data is dirty */
 166 #define HAMMER_INODE_RDIRTY     0x0002  /* in-memory ino_rec is dirty */
 167 #define HAMMER_INODE_ITIMES     0x0004  /* in-memory mtime/atime modified */
 168 #define HAMMER_INODE_XDIRTY     0x0008  /* in-memory records present */
 169 #define HAMMER_INODE_ONDISK     0x0010  /* inode is on-disk (else not yet) */
 170 #define HAMMER_INODE_FLUSH      0x0020  /* flush on last ref */
 171 #define HAMMER_INODE_DELETED    0x0080  /* inode ready for deletion */
 172 #define HAMMER_INODE_DELONDISK  0x0100  /* delete synchronized to disk */
 173 #define HAMMER_INODE_RO         0x0200  /* read-only (because of as-of) */
 174 #define HAMMER_INODE_GONE       0x0400  /* delete flushed out */
 175 #define HAMMER_INODE_DONDISK    0x0800  /* data records may be on disk */
 176
 177 #define HAMMER_INODE_MODMASK    (HAMMER_INODE_DDIRTY|HAMMER_INODE_RDIRTY| \
 178                                  HAMMER_INODE_XDIRTY|\
 179                                  HAMMER_INODE_ITIMES|HAMMER_INODE_DELETED)
 180
 181 #define HAMMER_MAX_INODE_CURSORS        4
 182
 183 /*
 184  * Structure used to represent an unsynchronized record in-memory.  This
 185  * structure is orgranized in a per-inode RB-tree.  If the inode is not
 186  * on disk then neither are any records and the in-memory record tree
 187  * represents the entire contents of the inode.  If the inode is on disk
 188  * then the on-disk B-Tree is scanned in parallel with the in-memory
 189  * RB-Tree to synthesize the current state of the file.
 190  *
 191  * Only current (delete_tid == 0) unsynchronized records are kept in-memory.
 192  */
 193 struct hammer_record {
 194         RB_ENTRY(hammer_record)         rb_node;
 195         struct hammer_lock              lock;
 196         struct hammer_inode             *ip;
 197         union hammer_record_ondisk      rec;
 198         union hammer_data_ondisk        *data;
 199         int                             flags;
 200 };
 201
 202 typedef struct hammer_record *hammer_record_t;
 203
 204 #define HAMMER_RECF_ALLOCDATA           0x0001
 205 #define HAMMER_RECF_ONRBTREE            0x0002
 206 #define HAMMER_RECF_DELETED             0x0004
 207 #define HAMMER_RECF_EMBEDDED_DATA       0x0008
 208 #define HAMMER_RECF_SYNCING             0x0010
 209
 210 /*
 211  * Structures used to internally represent a volume and a cluster
 212  */
 213 struct hammer_volume;
 214 struct hammer_cluster;
 215 struct hammer_supercl;
 216 struct hammer_buffer;
 217 struct hammer_node;
 218 RB_HEAD(hammer_vol_rb_tree, hammer_volume);
 219 RB_HEAD(hammer_clu_rb_tree, hammer_cluster);
 220 RB_HEAD(hammer_scl_rb_tree, hammer_supercl);
 221 RB_HEAD(hammer_buf_rb_tree, hammer_buffer);
 222 RB_HEAD(hammer_nod_rb_tree, hammer_node);
 223
 224 RB_PROTOTYPE2(hammer_vol_rb_tree, hammer_volume, rb_node,
 225               hammer_vol_rb_compare, int32_t);
 226 RB_PROTOTYPE2(hammer_clu_rb_tree, hammer_cluster, rb_node,
 227               hammer_clu_rb_compare, int32_t);
 228 RB_PROTOTYPE2(hammer_scl_rb_tree, hammer_supercl, rb_node,
 229               hammer_scl_rb_compare, int32_t);
 230 RB_PROTOTYPE2(hammer_buf_rb_tree, hammer_buffer, rb_node,
 231               hammer_buf_rb_compare, int32_t);
 232 RB_PROTOTYPE2(hammer_nod_rb_tree, hammer_node, rb_node,
 233               hammer_nod_rb_compare, int32_t);
 234
 235 /*
 236  * IO management - embedded at the head of various in-memory structures
 237  */
 238 enum hammer_io_type { HAMMER_STRUCTURE_VOLUME,
 239                       HAMMER_STRUCTURE_SUPERCL,
 240                       HAMMER_STRUCTURE_CLUSTER,
 241                       HAMMER_STRUCTURE_BUFFER };
 242
 243 union hammer_io_structure;
 244
 245 struct worklist {
 246         LIST_ENTRY(worklist) node;
 247 };
 248
 249 struct hammer_io {
 250         struct worklist worklist;
 251         struct hammer_lock lock;
 252         enum hammer_io_type type;
 253         struct buf      *bp;
 254         int64_t         offset;
 255         u_int           modified : 1;   /* bp's data was modified */
 256         u_int           released : 1;   /* bp released (w/ B_LOCKED set) */
 257 };
 258
 259 typedef struct hammer_io *hammer_io_t;
 260
 261 /*
 262  * In-memory volume representing on-disk buffer
 263  */
 264 struct hammer_volume {
 265         struct hammer_io io;
 266         RB_ENTRY(hammer_volume) rb_node;
 267         struct hammer_clu_rb_tree rb_clus_root;
 268         struct hammer_scl_rb_tree rb_scls_root;
 269         struct hammer_volume_ondisk *ondisk;
 270         struct hammer_alist_live alist;
 271         int32_t vol_no;
 272         int32_t vol_clsize;
 273         int32_t clu_iterator;   /* cluster allocation iterator */
 274         int64_t nblocks;        /* note: special calculation for statfs */
 275         int64_t cluster_base;   /* base offset of cluster 0 */
 276         char    *vol_name;
 277         struct vnode *devvp;
 278         struct hammer_mount *hmp;
 279         int     vol_flags;
 280 };
 281
 282 typedef struct hammer_volume *hammer_volume_t;
 283
 284 /*
 285  * In-memory super-cluster representing on-disk buffer
 286  */
 287 struct hammer_supercl {
 288         struct hammer_io io;
 289         RB_ENTRY(hammer_supercl) rb_node;
 290         struct hammer_supercl_ondisk *ondisk;
 291         struct hammer_volume *volume;
 292         struct hammer_alist_live alist;
 293         int32_t scl_no;
 294 };
 295
 296 typedef struct hammer_supercl *hammer_supercl_t;
 297
 298 enum hammer_cluster_state {
 299         HAMMER_CLUSTER_IDLE,
 300         HAMMER_CLUSTER_ASYNC,
 301         HAMMER_CLUSTER_OPEN
 302 };
 303
 304 /*
 305  * In-memory cluster representing on-disk buffer
 306  *
 307  * The cluster's indexing range is cached in hammer_cluster, separate
 308  * from the ondisk info in order to allow cursors to point to it.
 309  */
 310 struct hammer_cluster {
 311         struct hammer_io io;
 312         RB_ENTRY(hammer_cluster) rb_node;
 313         struct hammer_buf_rb_tree rb_bufs_root;
 314         struct hammer_cluster_ondisk *ondisk;
 315         struct hammer_volume *volume;
 316         struct hammer_alist_live alist_master;
 317         struct hammer_alist_live alist_btree;
 318         struct hammer_alist_live alist_record;
 319         struct hammer_alist_live alist_mdata;
 320         struct hammer_nod_rb_tree rb_nods_root; /* cursors in cluster */
 321         struct hammer_base_elm clu_btree_beg;   /* copy of on-disk info */
 322         struct hammer_base_elm clu_btree_end;   /* copy of on-disk info */
 323         int32_t clu_no;
 324         enum hammer_cluster_state state;
 325 };
 326
 327 typedef struct hammer_cluster *hammer_cluster_t;
 328
 329 /*
 330  * In-memory buffer (other then volume, super-cluster, or cluster),
 331  * representing an on-disk buffer.
 332  */
 333 struct hammer_buffer {
 334         struct hammer_io io;
 335         RB_ENTRY(hammer_buffer) rb_node;
 336         hammer_fsbuf_ondisk_t ondisk;
 337         struct hammer_volume *volume;
 338         struct hammer_cluster *cluster;
 339         int32_t buf_no;
 340         u_int64_t buf_type;
 341         struct hammer_alist_live alist;
 342         struct hammer_node_list clist;
 343         struct hammer_node *save_scan;
 344 };
 345
 346 typedef struct hammer_buffer *hammer_buffer_t;
 347
 348 /*
 349  * In-memory B-Tree node, representing an on-disk B-Tree node.
 350  *
 351  * This is a hang-on structure which is backed by a hammer_buffer,
 352  * indexed by a hammer_cluster, and used for fine-grained locking of
 353  * B-Tree nodes in order to properly control lock ordering.  A hammer_buffer
 354  * can contain multiple nodes representing wildly disassociated portions
 355  * of the B-Tree so locking cannot be done on a buffer-by-buffer basis.
 356  *
 357  * This structure uses a cluster-relative index to reduce the number
 358  * of layers required to access it, and also because all on-disk B-Tree
 359  * references are cluster-relative offsets.
 360  */
 361 struct hammer_node {
 362         struct hammer_lock      lock;           /* node-by-node lock */
 363         TAILQ_ENTRY(hammer_node) entry;         /* per-buffer linkage */
 364         RB_ENTRY(hammer_node)   rb_node;        /* per-cluster linkage */
 365         int32_t                 node_offset;    /* cluster-rel offset */
 366         struct hammer_cluster   *cluster;
 367         struct hammer_buffer    *buffer;        /* backing buffer */
 368         hammer_node_ondisk_t    ondisk;         /* ptr to on-disk structure */
 369         struct hammer_node      **cache1;       /* passive cache(s) */
 370         struct hammer_node      **cache2;
 371         int                     flags;
 372 };
 373
 374 #define HAMMER_NODE_DELETED     0x0001
 375 #define HAMMER_NODE_FLUSH       0x0002
 376 #define HAMMER_NODE_MODIFIED    0x0004
 377
 378 typedef struct hammer_node      *hammer_node_t;
 379
 380 /*
 381  * Common I/O management structure - embedded in in-memory structures
 382  * which are backed by filesystem buffers.
 383  */
 384 union hammer_io_structure {
 385         struct hammer_io        io;
 386         struct hammer_volume    volume;
 387         struct hammer_supercl   supercl;
 388         struct hammer_cluster   cluster;
 389         struct hammer_buffer    buffer;
 390 };
 391
 392 #define HAMFS_CLUSTER_DIRTY     0x0001
 393
 394 #include "hammer_cursor.h"
 395
 396 /*
 397  * Internal hammer mount data structure
 398  */
 399 struct hammer_mount {
 400         struct mount *mp;
 401         /*struct vnode *rootvp;*/
 402         struct hammer_ino_rb_tree rb_inos_root;
 403         struct hammer_vol_rb_tree rb_vols_root;
 404         struct hammer_volume *rootvol;
 405         struct hammer_cluster *rootcl;
 406         char    *zbuf;  /* HAMMER_BUFSIZE bytes worth of all-zeros */
 407         int     hflags;
 408         int     ronly;
 409         int     nvolumes;
 410         int     volume_iterator;
 411         uuid_t  fsid;
 412         udev_t  fsid_udev;
 413         hammer_tid_t asof;
 414         u_int32_t namekey_iterator;
 415 };
 416
 417 typedef struct hammer_mount     *hammer_mount_t;
 418
 419 struct hammer_sync_info {
 420         int error;
 421         int waitfor;
 422 };
 423
 424 #endif
 425
 426 #if defined(_KERNEL)
 427
 428 extern struct vop_ops hammer_vnode_vops;
 429 extern struct vop_ops hammer_spec_vops;
 430 extern struct vop_ops hammer_fifo_vops;
 431 extern struct hammer_alist_config Buf_alist_config;
 432 extern struct hammer_alist_config Vol_normal_alist_config;
 433 extern struct hammer_alist_config Vol_super_alist_config;
 434 extern struct hammer_alist_config Supercl_alist_config;
 435 extern struct hammer_alist_config Clu_master_alist_config;
 436 extern struct hammer_alist_config Clu_slave_alist_config;
 437 extern struct bio_ops hammer_bioops;
 438
 439 extern int hammer_debug_btree;
 440 extern int hammer_debug_tid;
 441 extern int hammer_count_inodes;
 442 extern int hammer_count_records;
 443 extern int hammer_count_record_datas;
 444 extern int hammer_count_volumes;
 445 extern int hammer_count_supercls;
 446 extern int hammer_count_clusters;
 447 extern int hammer_count_buffers;
 448 extern int hammer_count_nodes;
 449 extern int hammer_count_spikes;
 450
 451 int     hammer_vop_inactive(struct vop_inactive_args *);
 452 int     hammer_vop_reclaim(struct vop_reclaim_args *);
 453 int     hammer_vfs_vget(struct mount *mp, ino_t ino, struct vnode **vpp);
 454 int     hammer_get_vnode(struct hammer_inode *ip, int lktype,
 455                         struct vnode **vpp);
 456 struct hammer_inode *hammer_get_inode(hammer_mount_t hmp,
 457                         struct hammer_node **cache,
 458                         u_int64_t obj_id, hammer_tid_t asof, int flags,
 459                         int *errorp);
 460 void    hammer_put_inode(struct hammer_inode *ip);
 461 void    hammer_put_inode_ref(struct hammer_inode *ip);
 462
 463 int     hammer_unload_inode(hammer_inode_t ip, void *data);
 464 int     hammer_unload_volume(hammer_volume_t volume, void *data __unused);
 465 int     hammer_unload_supercl(hammer_supercl_t supercl, void *data __unused);
 466 int     hammer_unload_cluster(hammer_cluster_t cluster, void *data __unused);
 467 void    hammer_update_syncid(hammer_cluster_t cluster, hammer_tid_t tid);
 468 int     hammer_unload_buffer(hammer_buffer_t buffer, void *data __unused);
 469 int     hammer_install_volume(hammer_mount_t hmp, const char *volname);
 470
 471 int     hammer_ip_lookup(hammer_cursor_t cursor, hammer_inode_t ip);
 472 int     hammer_ip_first(hammer_cursor_t cursor, hammer_inode_t ip);
 473 int     hammer_ip_next(hammer_cursor_t cursor);
 474 int     hammer_ip_resolve_data(hammer_cursor_t cursor);
 475 int     hammer_ip_delete_record(hammer_cursor_t cursor, hammer_tid_t tid);
 476 int     hammer_ip_check_directory_empty(hammer_transaction_t trans,
 477                         hammer_inode_t ip);
 478 int     hammer_sync_hmp(hammer_mount_t hmp, int waitfor);
 479 int     hammer_sync_volume(hammer_volume_t volume, void *data);
 480 int     hammer_sync_cluster(hammer_cluster_t cluster, void *data);
 481 int     hammer_sync_buffer(hammer_buffer_t buffer, void *data);
 482
 483 hammer_record_t
 484         hammer_alloc_mem_record(hammer_inode_t ip);
 485 void    hammer_rel_mem_record(hammer_record_t record);
 486
 487 int     hammer_cursor_up(hammer_cursor_t cursor, int nonblock);
 488 int     hammer_cursor_toroot(hammer_cursor_t cursor);
 489 int     hammer_cursor_down(hammer_cursor_t cursor);
 490
 491 void    hammer_lock_ex(struct hammer_lock *lock);
 492 int     hammer_lock_ex_try(struct hammer_lock *lock);
 493 void    hammer_lock_sh(struct hammer_lock *lock);
 494 void    hammer_unlock(struct hammer_lock *lock);
 495 void    hammer_ref(struct hammer_lock *lock);
 496 void    hammer_unref(struct hammer_lock *lock);
 497 void    hammer_downgrade(struct hammer_lock *lock);
 498
 499 u_int32_t hammer_to_unix_xid(uuid_t *uuid);
 500 void hammer_guid_to_uuid(uuid_t *uuid, u_int32_t guid);
 501 void    hammer_to_timespec(hammer_tid_t tid, struct timespec *ts);
 502 hammer_tid_t hammer_timespec_to_transid(struct timespec *ts);
 503 hammer_tid_t hammer_alloc_tid(hammer_transaction_t trans);
 504 hammer_tid_t hammer_now_tid(void);
 505 hammer_tid_t hammer_str_to_tid(const char *str);
 506 hammer_tid_t hammer_alloc_recid(hammer_transaction_t trans);
 507
 508 enum vtype hammer_get_vnode_type(u_int8_t obj_type);
 509 int hammer_get_dtype(u_int8_t obj_type);
 510 u_int8_t hammer_get_obj_type(enum vtype vtype);
 511 int64_t hammer_directory_namekey(void *name, int len);
 512
 513 int     hammer_init_cursor_hmp(hammer_cursor_t cursor, struct hammer_node **cache, hammer_mount_t hmp);
 514 int     hammer_init_cursor_cluster(hammer_cursor_t cursor, hammer_cluster_t cluster);
 515
 516 void    hammer_done_cursor(hammer_cursor_t cursor);
 517 void    hammer_mem_done(hammer_cursor_t cursor);
 518
 519 int     hammer_btree_lookup(hammer_cursor_t cursor);
 520 int     hammer_btree_first(hammer_cursor_t cursor);
 521 int     hammer_btree_extract(hammer_cursor_t cursor, int flags);
 522 int     hammer_btree_iterate(hammer_cursor_t cursor);
 523 int     hammer_btree_insert(hammer_cursor_t cursor, hammer_btree_elm_t elm);
 524 int     hammer_btree_delete(hammer_cursor_t cursor);
 525 int     hammer_btree_cmp(hammer_base_elm_t key1, hammer_base_elm_t key2);
 526 int     hammer_btree_chkts(hammer_tid_t ts, hammer_base_elm_t key);
 527 void    hammer_print_btree_node(hammer_node_ondisk_t ondisk);
 528 void    hammer_print_btree_elm(hammer_btree_elm_t elm, u_int8_t type, int i);
 529
 530 void    *hammer_bread(struct hammer_cluster *cluster, int32_t cloff,
 531                       u_int64_t buf_type, int *errorp,
 532                       struct hammer_buffer **bufferp);
 533
 534 hammer_volume_t hammer_get_root_volume(hammer_mount_t hmp, int *errorp);
 535 hammer_cluster_t hammer_get_root_cluster(hammer_mount_t hmp, int *errorp);
 536
 537 hammer_volume_t hammer_get_volume(hammer_mount_t hmp,
 538                         int32_t vol_no, int *errorp);
 539 hammer_supercl_t hammer_get_supercl(hammer_volume_t volume, int32_t scl_no,
 540                         int *errorp, hammer_alloc_state_t isnew);
 541 hammer_cluster_t hammer_get_cluster(hammer_volume_t volume, int32_t clu_no,
 542                         int *errorp, hammer_alloc_state_t isnew);
 543 hammer_buffer_t hammer_get_buffer(hammer_cluster_t cluster,
 544                         int32_t buf_no, u_int64_t buf_type, int *errorp);
 545
 546 int             hammer_ref_volume(hammer_volume_t volume);
 547 int             hammer_ref_cluster(hammer_cluster_t cluster);
 548 int             hammer_ref_buffer(hammer_buffer_t buffer);
 549 void            hammer_flush_buffer_nodes(hammer_buffer_t buffer);
 550
 551
 552 void            hammer_rel_volume(hammer_volume_t volume, int flush);
 553 void            hammer_rel_supercl(hammer_supercl_t supercl, int flush);
 554 void            hammer_rel_cluster(hammer_cluster_t cluster, int flush);
 555 void            hammer_rel_buffer(hammer_buffer_t buffer, int flush);
 556
 557 hammer_node_t   hammer_get_node(hammer_cluster_t cluster,
 558                         int32_t node_offset, int *errorp);
 559 int             hammer_ref_node(hammer_node_t node);
 560 void            hammer_rel_node(hammer_node_t node);
 561 void            hammer_cache_node(hammer_node_t node,
 562                         struct hammer_node **cache);
 563 void            hammer_uncache_node(struct hammer_node **cache);
 564 void            hammer_flush_node(hammer_node_t node);
 565
 566 void hammer_dup_buffer(struct hammer_buffer **bufferp,
 567                         struct hammer_buffer *buffer);
 568 void hammer_dup_cluster(struct hammer_cluster **clusterp,
 569                         struct hammer_cluster *cluster);
 570 hammer_cluster_t hammer_alloc_cluster(hammer_mount_t hmp,
 571                         hammer_cluster_t cluster_hint, int *errorp);
 572 void hammer_init_cluster(hammer_cluster_t cluster,
 573                         hammer_base_elm_t left_bound,
 574                         hammer_base_elm_t right_bound);
 575 hammer_node_t hammer_alloc_btree(struct hammer_cluster *cluster, int *errorp);
 576 void *hammer_alloc_data(struct hammer_cluster *cluster, int32_t bytes,
 577                         int *errorp, struct hammer_buffer **bufferp);
 578 void *hammer_alloc_record(struct hammer_cluster *cluster,
 579                         int *errorp, struct hammer_buffer **bufferp);
 580 void hammer_initbuffer(hammer_alist_t live, hammer_fsbuf_head_t head,
 581                         u_int64_t type);
 582 void hammer_free_data_ptr(struct hammer_buffer *buffer,
 583                         void *data, int bytes);
 584 void hammer_free_record_ptr(struct hammer_buffer *buffer,
 585                         union hammer_record_ondisk *rec);
 586 void hammer_free_cluster(hammer_cluster_t cluster);
 587 void hammer_free_btree(struct hammer_cluster *cluster, int32_t bclu_offset);
 588 void hammer_free_data(struct hammer_cluster *cluster, int32_t bclu_offset,
 589                         int32_t bytes);
 590 void hammer_free_record(struct hammer_cluster *cluster, int32_t bclu_offset);
 591
 592 void hammer_put_volume(struct hammer_volume *volume, int flush);
 593 void hammer_put_supercl(struct hammer_supercl *supercl, int flush);
 594 void hammer_put_cluster(struct hammer_cluster *cluster, int flush);
 595 void hammer_put_buffer(struct hammer_buffer *buffer, int flush);
 596
 597 void hammer_init_alist_config(void);
 598
 599 void hammer_start_transaction(struct hammer_transaction *trans,
 600                               struct hammer_mount *hmp);
 601 void hammer_start_transaction_tid(struct hammer_transaction *trans,
 602                                   struct hammer_mount *hmp, hammer_tid_t tid);
 603 void hammer_commit_transaction(struct hammer_transaction *trans);
 604 void hammer_abort_transaction(struct hammer_transaction *trans);
 605
 606 void hammer_modify_inode(struct hammer_transaction *trans,
 607                         hammer_inode_t ip, int flags);
 608 int  hammer_create_inode(struct hammer_transaction *trans, struct vattr *vap,
 609                         struct ucred *cred, struct hammer_inode *dip,
 610                         struct hammer_inode **ipp);
 611 void hammer_rel_inode(hammer_inode_t ip, int flush);
 612 int hammer_sync_inode(hammer_inode_t ip, int waitfor, int handle_delete);
 613
 614 int  hammer_ip_add_directory(struct hammer_transaction *trans,
 615                         hammer_inode_t dip, struct namecache *ncp,
 616                         hammer_inode_t nip);
 617 int  hammer_ip_del_directory(struct hammer_transaction *trans,
 618                         hammer_cursor_t cursor, hammer_inode_t dip,
 619                         hammer_inode_t ip);
 620 int  hammer_ip_add_record(struct hammer_transaction *trans,
 621                         hammer_record_t record);
 622 int  hammer_ip_delete_range(struct hammer_transaction *trans,
 623                         hammer_inode_t ip, int64_t ran_beg, int64_t ran_end,
 624                         struct hammer_cursor **spikep);
 625 int  hammer_ip_delete_range_all(struct hammer_transaction *trans,
 626                         hammer_inode_t ip);
 627 int  hammer_ip_sync_data(struct hammer_transaction *trans,
 628                         hammer_inode_t ip, int64_t offset,
 629                         void *data, int bytes, struct hammer_cursor **spikep);
 630 int  hammer_ip_sync_record(hammer_record_t rec, struct hammer_cursor **spikep);
 631 int  hammer_write_record(hammer_cursor_t cursor, hammer_record_ondisk_t rec,
 632                         void *data, int cursor_flags);
 633
 634 void hammer_load_spike(hammer_cursor_t cursor, struct hammer_cursor **spikep);
 635 int hammer_spike(struct hammer_cursor **spikep);
 636 int hammer_recover(struct hammer_cluster *cluster);
 637
 638 int hammer_io_read(struct vnode *devvp, struct hammer_io *io);
 639 int hammer_io_new(struct vnode *devvp, struct hammer_io *io);
 640 void hammer_io_release(struct hammer_io *io, int flush);
 641 int hammer_io_checkflush(hammer_io_t io);
 642 void hammer_io_notify_cluster(hammer_cluster_t cluster);
 643 void hammer_io_flush(struct hammer_io *io, struct hammer_sync_info *info);
 644 void hammer_io_intend_modify(struct hammer_io *io);
 645 void hammer_io_modify_done(struct hammer_io *io);
 646 void hammer_io_clear_modify(struct hammer_io *io);
 647
 648 #endif
 649
 650 /*
 651  * Inline support functions (not kernel specific)
 652  */
 653 static __inline void
 654 hammer_modify_volume(struct hammer_volume *volume)
 655 {
 656         volume->io.modified = 1;
 657         ++volume->io.lock.modifying;
 658         if (volume->io.released)
 659                 hammer_io_intend_modify(&volume->io);
 660 }
 661
 662 static __inline void
 663 hammer_modify_volume_done(struct hammer_volume *volume)
 664 {
 665         hammer_io_modify_done(&volume->io);
 666 }
 667
 668 static __inline void
 669 hammer_modify_supercl(struct hammer_supercl *supercl)
 670 {
 671         supercl->io.modified = 1;
 672         ++supercl->io.lock.modifying;
 673         if (supercl->io.released)
 674                 hammer_io_intend_modify(&supercl->io);
 675 }
 676
 677 static __inline void
 678 hammer_modify_supercl_done(struct hammer_supercl *supercl)
 679 {
 680         hammer_io_modify_done(&supercl->io);
 681 }
 682
 683 static __inline void
 684 hammer_modify_cluster(struct hammer_cluster *cluster)
 685 {
 686         cluster->io.modified = 1;
 687         ++cluster->io.lock.modifying;
 688         if (cluster->io.released)
 689                 hammer_io_intend_modify(&cluster->io);
 690 }
 691
 692 static __inline void
 693 hammer_modify_cluster_done(struct hammer_cluster *cluster)
 694 {
 695         hammer_io_modify_done(&cluster->io);
 696 }
 697
 698 static __inline void
 699 hammer_modify_buffer(struct hammer_buffer *buffer)
 700 {
 701         hammer_io_notify_cluster(buffer->cluster);
 702         buffer->io.modified = 1;
 703         ++buffer->io.lock.modifying;
 704         if (buffer->io.released)
 705                 hammer_io_intend_modify(&buffer->io);
 706 }
 707
 708 static __inline void
 709 hammer_modify_buffer_done(struct hammer_buffer *buffer)
 710 {
 711         hammer_io_modify_done(&buffer->io);
 712 }
 713
 714 static __inline void
 715 hammer_modify_node(struct hammer_node *node)
 716 {
 717         hammer_modify_buffer(node->buffer);
 718 }
 719
 720 static __inline void
 721 hammer_modify_node_done(struct hammer_node *node)
 722 {
 723         hammer_modify_buffer_done(node->buffer);
 724 }
 725
 726 /*
 727  * Return the cluster-relative byte offset of an element within a buffer
 728  */
 729 static __inline int
 730 hammer_bclu_offset(struct hammer_buffer *buffer, void *ptr)
 731 {
 732         int bclu_offset;
 733
 734         bclu_offset = buffer->buf_no * HAMMER_BUFSIZE +
 735                       ((char *)ptr - (char *)buffer->ondisk);
 736         return(bclu_offset);
 737 }
 738