d07e0e213ba70d7c4fbe6bf98dda6288d51ba69f
[dragonfly.git] / sys / vfs / hammer2 / hammer2.h
1 /*
2  * Copyright (c) 2011-2016 The DragonFly Project.  All rights reserved.
3  *
4  * This code is derived from software contributed to The DragonFly Project
5  * by Matthew Dillon <dillon@dragonflybsd.org>
6  * by Venkatesh Srinivas <vsrinivas@dragonflybsd.org>
7  *
8  * Redistribution and use in source and binary forms, with or without
9  * modification, are permitted provided that the following conditions
10  * are met:
11  *
12  * 1. Redistributions of source code must retain the above copyright
13  *    notice, this list of conditions and the following disclaimer.
14  * 2. Redistributions in binary form must reproduce the above copyright
15  *    notice, this list of conditions and the following disclaimer in
16  *    the documentation and/or other materials provided with the
17  *    distribution.
18  * 3. Neither the name of The DragonFly Project nor the names of its
19  *    contributors may be used to endorse or promote products derived
20  *    from this software without specific, prior written permission.
21  *
22  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
23  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
24  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
25  * FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE
26  * COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
27  * INCIDENTAL, SPECIAL, EXEMPLARY OR CONSEQUENTIAL DAMAGES (INCLUDING,
28  * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
29  * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
30  * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
31  * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
32  * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
33  * SUCH DAMAGE.
34  */
35
36 /*
37  * HAMMER2 IN-MEMORY CACHE OF MEDIA STRUCTURES
38  *
39  * This header file contains structures used internally by the HAMMER2
40  * implementation.  See hammer2_disk.h for on-disk structures.
41  *
42  * There is an in-memory representation of all on-media data structure.
43  * Almost everything is represented by a hammer2_chain structure in-memory.
44  * Other higher-level structures typically map to chains.
45  *
46  * A great deal of data is accessed simply via its buffer cache buffer,
47  * which is mapped for the duration of the chain's lock.  Hammer2 must
48  * implement its own buffer cache layer on top of the system layer to
49  * allow for different threads to lock different sub-block-sized buffers.
50  *
51  * When modifications are made to a chain a new filesystem block must be
52  * allocated.  Multiple modifications do not typically allocate new blocks
53  * until the current block has been flushed.  Flushes do not block the
54  * front-end unless the front-end operation crosses the current inode being
55  * flushed.
56  *
57  * The in-memory representation may remain cached (for example in order to
58  * placemark clustering locks) even after the related data has been
59  * detached.
60  */
61
62 #ifndef _VFS_HAMMER2_HAMMER2_H_
63 #define _VFS_HAMMER2_HAMMER2_H_
64
65 #ifdef _KERNEL
66 #include <sys/param.h>
67 #endif
68 #include <sys/types.h>
69 #ifdef _KERNEL
70 #include <sys/kernel.h>
71 #endif
72 #include <sys/conf.h>
73 #ifdef _KERNEL
74 #include <sys/systm.h>
75 #endif
76 #include <sys/tree.h>
77 #include <sys/malloc.h>
78 #include <sys/mount.h>
79 #include <sys/vnode.h>
80 #include <sys/proc.h>
81 #include <sys/mountctl.h>
82 #include <sys/priv.h>
83 #include <sys/stat.h>
84 #include <sys/thread.h>
85 #include <sys/globaldata.h>
86 #include <sys/lockf.h>
87 #include <sys/buf.h>
88 #include <sys/queue.h>
89 #include <sys/limits.h>
90 #include <sys/dmsg.h>
91 #include <sys/mutex.h>
92 #ifdef _KERNEL
93 #include <sys/kern_syscall.h>
94 #endif
95
96 #ifdef _KERNEL
97 #include <sys/signal2.h>
98 #include <sys/buf2.h>
99 #include <sys/mutex2.h>
100 #include <sys/thread2.h>
101 #endif
102
103 #include "hammer2_xxhash.h"
104 #include "hammer2_disk.h"
105 #include "hammer2_mount.h"
106 #include "hammer2_ioctl.h"
107
108 struct hammer2_io;
109 struct hammer2_chain;
110 struct hammer2_cluster;
111 struct hammer2_inode;
112 struct hammer2_dev;
113 struct hammer2_pfs;
114 struct hammer2_span;
115 struct hammer2_state;
116 struct hammer2_msg;
117 struct hammer2_thread;
118 union hammer2_xop;
119
120 /*
121  * Mutex and lock shims.  Hammer2 requires support for asynchronous and
122  * abortable locks, and both exclusive and shared spinlocks.  Normal
123  * synchronous non-abortable locks can be substituted for spinlocks.
124  */
125 typedef mtx_t                           hammer2_mtx_t;
126 typedef mtx_link_t                      hammer2_mtx_link_t;
127 typedef mtx_state_t                     hammer2_mtx_state_t;
128
129 typedef struct spinlock                 hammer2_spin_t;
130
131 #define hammer2_mtx_ex                  mtx_lock_ex_quick
132 #define hammer2_mtx_sh                  mtx_lock_sh_quick
133 #define hammer2_mtx_sh_again            mtx_lock_sh_again
134 #define hammer2_mtx_unlock              mtx_unlock
135 #define hammer2_mtx_downgrade           mtx_downgrade
136 #define hammer2_mtx_owned               mtx_owned
137 #define hammer2_mtx_init                mtx_init
138 #define hammer2_mtx_temp_release        mtx_lock_temp_release
139 #define hammer2_mtx_temp_restore        mtx_lock_temp_restore
140 #define hammer2_mtx_refs                mtx_lockrefs
141
142 #define hammer2_spin_init               spin_init
143 #define hammer2_spin_sh                 spin_lock_shared
144 #define hammer2_spin_ex                 spin_lock
145 #define hammer2_spin_unsh               spin_unlock_shared
146 #define hammer2_spin_unex               spin_unlock
147
148 TAILQ_HEAD(hammer2_xop_list, hammer2_xop_head);
149 TAILQ_HEAD(hammer2_chain_list, hammer2_chain);
150
151 typedef struct hammer2_xop_list hammer2_xop_list_t;
152
153 #ifdef _KERNEL
154 /*
155  * General lock support
156  */
157 static __inline
158 int
159 hammer2_mtx_upgrade_try(hammer2_mtx_t *mtx)
160 {
161         return mtx_upgrade_try(mtx);
162 }
163
164 #endif
165
166 /*
167  * The xid tracks internal transactional updates.
168  *
169  * XXX fix-me, really needs to be 64-bits
170  */
171 typedef uint32_t hammer2_xid_t;
172
173 #define HAMMER2_XID_MIN                 0x00000000U
174 #define HAMMER2_XID_MAX                 0x7FFFFFFFU
175
176 #define HAMMER2_LIMIT_DIRTY_CHAINS      (65536)
177
178 /*
179  * The chain structure tracks a portion of the media topology from the
180  * root (volume) down.  Chains represent volumes, inodes, indirect blocks,
181  * data blocks, and freemap nodes and leafs.
182  *
183  * The chain structure utilizes a simple singly-homed topology and the
184  * chain's in-memory topology will move around as the chains do, due mainly
185  * to renames and indirect block creation.
186  *
187  * Block Table Updates
188  *
189  *      Block table updates for insertions and updates are delayed until the
190  *      flush.  This allows us to avoid having to modify the parent chain
191  *      all the way to the root.
192  *
193  *      Block table deletions are performed immediately (modifying the parent
194  *      in the process) because the flush code uses the chain structure to
195  *      track delayed updates and the chain will be (likely) gone or moved to
196  *      another location in the topology after a deletion.
197  *
198  *      A prior iteration of the code tried to keep the relationship intact
199  *      on deletes by doing a delete-duplicate operation on the chain, but
200  *      it added way too much complexity to the codebase.
201  *
202  * Flush Synchronization
203  *
204  *      The flush code must flush modified chains bottom-up.  Because chain
205  *      structures can shift around and are NOT topologically stable,
206  *      modified chains are independently indexed for the flush.  As the flush
207  *      runs it modifies (or further modifies) and updates the parents,
208  *      propagating the flush all the way to the volume root.
209  *
210  *      Modifying front-end operations can occur during a flush but will block
211  *      in two cases: (1) when the front-end tries to operate on the inode
212  *      currently in the midst of being flushed and (2) if the front-end
213  *      crosses an inode currently being flushed (such as during a rename).
214  *      So, for example, if you rename directory "x" to "a/b/c/d/e/f/g/x" and
215  *      the flusher is currently working on "a/b/c", the rename will block
216  *      temporarily in order to ensure that "x" exists in one place or the
217  *      other.
218  *
219  *      Meta-data statistics are updated by the flusher.  The front-end will
220  *      make estimates but meta-data must be fully synchronized only during a
221  *      flush in order to ensure that it remains correct across a crash.
222  *
223  *      Multiple flush synchronizations can theoretically be in-flight at the
224  *      same time but the implementation is not coded to handle the case and
225  *      currently serializes them.
226  *
227  * Snapshots:
228  *
229  *      Snapshots currently require the subdirectory tree being snapshotted
230  *      to be flushed.  The snapshot then creates a new super-root inode which
231  *      copies the flushed blockdata of the directory or file that was
232  *      snapshotted.
233  *
234  * RBTREE NOTES:
235  *
236  *      - Note that the radix tree runs in powers of 2 only so sub-trees
237  *        cannot straddle edges.
238  */
239 RB_HEAD(hammer2_chain_tree, hammer2_chain);
240 TAILQ_HEAD(h2_flush_list, hammer2_chain);
241 TAILQ_HEAD(h2_core_list, hammer2_chain);
242
243 #define CHAIN_CORE_DELETE_BMAP_ENTRIES  \
244         (HAMMER2_PBUFSIZE / sizeof(hammer2_blockref_t) / sizeof(uint32_t))
245
246 /*
247  * Core topology for chain (embedded in chain).  Protected by a spinlock.
248  */
249 struct hammer2_chain_core {
250         hammer2_spin_t  spin;
251         struct hammer2_chain_tree rbtree; /* sub-chains */
252         int             live_zero;      /* blockref array opt */
253         u_int           live_count;     /* live (not deleted) chains in tree */
254         u_int           chain_count;    /* live + deleted chains under core */
255         int             generation;     /* generation number (inserts only) */
256 };
257
258 typedef struct hammer2_chain_core hammer2_chain_core_t;
259
260 RB_HEAD(hammer2_io_tree, hammer2_io);
261
262 /*
263  * DIO - Management structure wrapping system buffer cache.
264  *
265  * HAMMER2 uses an I/O abstraction that allows it to cache and manipulate
266  * fixed-sized filesystem buffers frontend by variable-sized hammer2_chain
267  * structures.
268  */
269 struct hammer2_io {
270         RB_ENTRY(hammer2_io) rbnode;    /* indexed by device offset */
271         struct hammer2_dev *hmp;
272         struct buf      *bp;
273         off_t           pbase;
274         uint64_t        refs;
275         int             psize;
276         int             act;            /* activity */
277         int             btype;          /* approximate BREF_TYPE_* */
278         int             ticks;
279         int             error;
280         int             unused01;
281         uint64_t        dedup_valid;    /* valid for dedup operation */
282         uint64_t        dedup_alloc;    /* allocated / de-dupable */
283 };
284
285 typedef struct hammer2_io hammer2_io_t;
286
287 #define HAMMER2_DIO_INPROG      0x8000000000000000LLU   /* bio in progress */
288 #define HAMMER2_DIO_GOOD        0x4000000000000000LLU   /* dio->bp is stable */
289 #define HAMMER2_DIO_WAITING     0x2000000000000000LLU   /* wait on INPROG */
290 #define HAMMER2_DIO_DIRTY       0x1000000000000000LLU   /* flush last drop */
291
292 #define HAMMER2_DIO_MASK        0x00FFFFFFFFFFFFFFLLU
293
294 /*
295  * Primary chain structure keeps track of the topology in-memory.
296  */
297 struct hammer2_chain {
298         hammer2_mtx_t           lock;
299         hammer2_chain_core_t    core;
300         RB_ENTRY(hammer2_chain) rbnode;         /* live chain(s) */
301         hammer2_blockref_t      bref;
302         struct hammer2_chain    *parent;
303         struct hammer2_state    *state;         /* if active cache msg */
304         struct hammer2_dev      *hmp;
305         struct hammer2_pfs      *pmp;           /* A PFS or super-root (spmp) */
306
307         hammer2_io_t    *dio;                   /* physical data buffer */
308         u_int           bytes;                  /* physical data size */
309         u_int           flags;
310         u_int           refs;
311         u_int           lockcnt;
312         int             error;                  /* on-lock data error state */
313         int             unused01;               /* (aka ip->cluster) */
314
315         hammer2_media_data_t *data;             /* data pointer shortcut */
316         TAILQ_ENTRY(hammer2_chain) flush_node;  /* flush list */
317         TAILQ_ENTRY(hammer2_chain) lru_node;    /* 0-refs LRU */
318 };
319
320 typedef struct hammer2_chain hammer2_chain_t;
321
322 int hammer2_chain_cmp(hammer2_chain_t *chain1, hammer2_chain_t *chain2);
323 RB_PROTOTYPE(hammer2_chain_tree, hammer2_chain, rbnode, hammer2_chain_cmp);
324
325 /*
326  * Special notes on flags:
327  *
328  * INITIAL      - This flag allows a chain to be created and for storage to
329  *                be allocated without having to immediately instantiate the
330  *                related buffer.  The data is assumed to be all-zeros.  It
331  *                is primarily used for indirect blocks.
332  *
333  * MODIFIED     - The chain's media data has been modified.  Prevents chain
334  *                free on lastdrop if still in the topology.
335  *
336  * UPDATE       - Chain might not be modified but parent blocktable needs
337  *                an update.  Prevents chain free on lastdrop if still in
338  *                the topology.
339  *
340  * FICTITIOUS   - Faked chain as a placeholder for an error condition.  This
341  *                chain is unsuitable for I/O.
342  *
343  * BMAPPED      - Indicates that the chain is present in the parent blockmap.
344  *
345  * BMAPUPD      - Indicates that the chain is present but needs to be updated
346  *                in the parent blockmap.
347  */
348 #define HAMMER2_CHAIN_MODIFIED          0x00000001      /* dirty chain data */
349 #define HAMMER2_CHAIN_ALLOCATED         0x00000002      /* kmalloc'd chain */
350 #define HAMMER2_CHAIN_DESTROY           0x00000004
351 #define HAMMER2_CHAIN_DEDUPABLE         0x00000008      /* registered w/dedup */
352 #define HAMMER2_CHAIN_DELETED           0x00000010      /* deleted chain */
353 #define HAMMER2_CHAIN_INITIAL           0x00000020      /* initial create */
354 #define HAMMER2_CHAIN_UPDATE            0x00000040      /* need parent update */
355 #define HAMMER2_CHAIN_DEFERRED          0x00000080      /* flush depth defer */
356 #define HAMMER2_CHAIN_TESTEDGOOD        0x00000100      /* crc tested good */
357 #define HAMMER2_CHAIN_ONFLUSH           0x00000200      /* on a flush list */
358 #define HAMMER2_CHAIN_FICTITIOUS        0x00000400      /* unsuitable for I/O */
359 #define HAMMER2_CHAIN_VOLUMESYNC        0x00000800      /* needs volume sync */
360 #define HAMMER2_CHAIN_DELAYED           0x00001000      /* delayed flush */
361 #define HAMMER2_CHAIN_COUNTEDBREFS      0x00002000      /* block table stats */
362 #define HAMMER2_CHAIN_ONRBTREE          0x00004000      /* on parent RB tree */
363 #define HAMMER2_CHAIN_ONLRU             0x00008000      /* on LRU list */
364 #define HAMMER2_CHAIN_EMBEDDED          0x00010000      /* embedded data */
365 #define HAMMER2_CHAIN_RELEASE           0x00020000      /* don't keep around */
366 #define HAMMER2_CHAIN_BMAPPED           0x00040000      /* present in blkmap */
367 #define HAMMER2_CHAIN_BMAPUPD           0x00080000      /* +needs updating */
368 #define HAMMER2_CHAIN_IOINPROG          0x00100000      /* I/O interlock */
369 #define HAMMER2_CHAIN_IOSIGNAL          0x00200000      /* I/O interlock */
370 #define HAMMER2_CHAIN_PFSBOUNDARY       0x00400000      /* super->pfs inode */
371
372 #define HAMMER2_CHAIN_FLUSH_MASK        (HAMMER2_CHAIN_MODIFIED |       \
373                                          HAMMER2_CHAIN_UPDATE |         \
374                                          HAMMER2_CHAIN_ONFLUSH |        \
375                                          HAMMER2_CHAIN_DESTROY)
376
377 /*
378  * Hammer2 error codes, used by chain->error and cluster->error.  The error
379  * code is typically set on-lock unless no I/O was requested, and set on
380  * I/O otherwise.  If set for a cluster it generally means that the cluster
381  * code could not find a valid copy to present.
382  *
383  * IO           - An I/O error occurred
384  * CHECK        - I/O succeeded but did not match the check code
385  * INCOMPLETE   - A cluster is not complete enough to use, or
386  *                a chain cannot be loaded because its parent has an error.
387  *
388  * NOTE: API allows callers to check zero/non-zero to determine if an error
389  *       condition exists.
390  *
391  * NOTE: Chain's data field is usually NULL on an IO error but not necessarily
392  *       NULL on other errors.  Check chain->error, not chain->data.
393  */
394 #define HAMMER2_ERROR_NONE              0
395 #define HAMMER2_ERROR_IO                1       /* device I/O error */
396 #define HAMMER2_ERROR_CHECK             2       /* check code mismatch */
397 #define HAMMER2_ERROR_INCOMPLETE        3       /* incomplete cluster */
398 #define HAMMER2_ERROR_DEPTH             4       /* temporary depth limit */
399
400 /*
401  * Flags passed to hammer2_chain_lookup() and hammer2_chain_next()
402  *
403  * NOTES:
404  *      NOLOCK      - Input and output chains are referenced only and not
405  *                    locked.  Output chain might be temporarily locked
406  *                    internally.
407  *
408  *      NODATA      - Asks that the chain->data not be resolved in order
409  *                    to avoid I/O.
410  *
411  *      NODIRECT    - Prevents a lookup of offset 0 in an inode from returning
412  *                    the inode itself if the inode is in DIRECTDATA mode
413  *                    (i.e. file is <= 512 bytes).  Used by the synchronization
414  *                    code to prevent confusion.
415  *
416  *      SHARED      - The input chain is expected to be locked shared,
417  *                    and the output chain is locked shared.
418  *
419  *      MATCHIND    - Allows an indirect block / freemap node to be returned
420  *                    when the passed key range matches the radix.  Remember
421  *                    that key_end is inclusive (e.g. {0x000,0xFFF},
422  *                    not {0x000,0x1000}).
423  *
424  *                    (Cannot be used for remote or cluster ops).
425  *
426  *      ALLNODES    - Allows NULL focus.
427  *
428  *      ALWAYS      - Always resolve the data.  If ALWAYS and NODATA are both
429  *                    missing, bulk file data is not resolved but inodes and
430  *                    other meta-data will.
431  *
432  *      NOUNLOCK    - Used by hammer2_chain_next() to leave the lock on
433  *                    the input chain intact.  The chain is still dropped.
434  *                    This allows the caller to add a reference to the chain
435  *                    and retain it in a locked state (used by the
436  *                    XOP/feed/collect code).
437  */
438 #define HAMMER2_LOOKUP_NOLOCK           0x00000001      /* ref only */
439 #define HAMMER2_LOOKUP_NODATA           0x00000002      /* data left NULL */
440 #define HAMMER2_LOOKUP_NODIRECT         0x00000004      /* no offset=0 DD */
441 #define HAMMER2_LOOKUP_SHARED           0x00000100
442 #define HAMMER2_LOOKUP_MATCHIND         0x00000200      /* return all chains */
443 #define HAMMER2_LOOKUP_ALLNODES         0x00000400      /* allow NULL focus */
444 #define HAMMER2_LOOKUP_ALWAYS           0x00000800      /* resolve data */
445 #define HAMMER2_LOOKUP_NOUNLOCK         0x00001000      /* leave lock intact */
446
447 /*
448  * Flags passed to hammer2_chain_modify() and hammer2_chain_resize()
449  *
450  * NOTE: OPTDATA allows us to avoid instantiating buffers for INDIRECT
451  *       blocks in the INITIAL-create state.
452  */
453 #define HAMMER2_MODIFY_OPTDATA          0x00000002      /* data can be NULL */
454 #define HAMMER2_MODIFY_NO_MODIFY_TID    0x00000004
455 #define HAMMER2_MODIFY_UNUSED0008       0x00000008
456
457 /*
458  * Flags passed to hammer2_chain_lock()
459  *
460  * NOTE: RDONLY is set to optimize cluster operations when *no* modifications
461  *       will be made to either the cluster being locked or any underlying
462  *       cluster.  It allows the cluster to lock and access data for a subset
463  *       of available nodes instead of all available nodes.
464  */
465 #define HAMMER2_RESOLVE_NEVER           1
466 #define HAMMER2_RESOLVE_MAYBE           2
467 #define HAMMER2_RESOLVE_ALWAYS          3
468 #define HAMMER2_RESOLVE_MASK            0x0F
469
470 #define HAMMER2_RESOLVE_SHARED          0x10    /* request shared lock */
471 #define HAMMER2_RESOLVE_LOCKAGAIN       0x20    /* another shared lock */
472 #define HAMMER2_RESOLVE_RDONLY          0x40    /* higher level op flag */
473
474 /*
475  * Flags passed to hammer2_chain_delete()
476  */
477 #define HAMMER2_DELETE_PERMANENT        0x0001
478
479 /*
480  * Flags passed to hammer2_chain_insert() or hammer2_chain_rename()
481  */
482 #define HAMMER2_INSERT_PFSROOT          0x0004
483
484 /*
485  * Flags passed to hammer2_chain_delete_duplicate()
486  */
487 #define HAMMER2_DELDUP_RECORE           0x0001
488
489 /*
490  * Cluster different types of storage together for allocations
491  */
492 #define HAMMER2_FREECACHE_INODE         0
493 #define HAMMER2_FREECACHE_INDIR         1
494 #define HAMMER2_FREECACHE_DATA          2
495 #define HAMMER2_FREECACHE_UNUSED3       3
496 #define HAMMER2_FREECACHE_TYPES         4
497
498 /*
499  * hammer2_freemap_alloc() block preference
500  */
501 #define HAMMER2_OFF_NOPREF              ((hammer2_off_t)-1)
502
503 /*
504  * BMAP read-ahead maximum parameters
505  */
506 #define HAMMER2_BMAP_COUNT              16      /* max bmap read-ahead */
507 #define HAMMER2_BMAP_BYTES              (HAMMER2_PBUFSIZE * HAMMER2_BMAP_COUNT)
508
509 /*
510  * hammer2_freemap_adjust()
511  */
512 #define HAMMER2_FREEMAP_DORECOVER       1
513 #define HAMMER2_FREEMAP_DOMAYFREE       2
514 #define HAMMER2_FREEMAP_DOREALFREE      3
515
516 /*
517  * HAMMER2 cluster - A set of chains representing the same entity.
518  *
519  * hammer2_cluster typically represents a temporary set of representitive
520  * chains.  The one exception is that a hammer2_cluster is embedded in
521  * hammer2_inode.  This embedded cluster is ONLY used to track the
522  * representitive chains and cannot be directly locked.
523  *
524  * A cluster is usually temporary (and thus per-thread) for locking purposes,
525  * allowing us to embed the asynchronous storage required for cluster
526  * operations in the cluster itself and adjust the state and status without
527  * having to worry too much about SMP issues.
528  *
529  * The exception is the cluster embedded in the hammer2_inode structure.
530  * This is used to cache the cluster state on an inode-by-inode basis.
531  * Individual hammer2_chain structures not incorporated into clusters might
532  * also stick around to cache miscellanious elements.
533  *
534  * Because the cluster is a 'working copy' and is usually subject to cluster
535  * quorum rules, it is quite possible for us to end up with an insufficient
536  * number of live chains to execute an operation.  If an insufficient number
537  * of chains remain in a working copy, the operation may have to be
538  * downgraded, retried, stall until the requisit number of chains are
539  * available, or possibly even error out depending on the mount type.
540  *
541  * A cluster's focus is set when it is locked.  The focus can only be set
542  * to a chain still part of the synchronized set.
543  */
544 #define HAMMER2_MAXCLUSTER      8
545 #define HAMMER2_XOPMASK_CLUSTER ((1U << HAMMER2_MAXCLUSTER) - 1)
546 #define HAMMER2_XOPFIFO         16
547 #define HAMMER2_XOPFIFO_MASK    (HAMMER2_XOPFIFO - 1)
548 #define HAMMER2_XOPGROUPS       32
549 #define HAMMER2_XOPGROUPS_MASK  (HAMMER2_XOPGROUPS - 1)
550 #define HAMMER2_XOPMASK_VOP     0x80000000U
551 #define HAMMER2_XOPMASK_FIFOW   0x40000000U
552
553 #define HAMMER2_XOPMASK_ALLDONE (HAMMER2_XOPMASK_VOP | HAMMER2_XOPMASK_CLUSTER)
554
555 #define HAMMER2_SPECTHREADS     1       /* sync */
556
557 struct hammer2_cluster_item {
558         hammer2_chain_t         *chain;
559         int                     cache_index;
560         int                     error;
561         uint32_t                flags;
562 };
563
564 typedef struct hammer2_cluster_item hammer2_cluster_item_t;
565
566 /*
567  * INVALID      - Invalid for focus, i.e. not part of synchronized set.
568  *                Once set, this bit is sticky across operations.
569  *
570  * FEMOD        - Indicates that front-end modifying operations can
571  *                mess with this entry and MODSYNC will copy also
572  *                effect it.
573  */
574 #define HAMMER2_CITEM_INVALID   0x00000001
575 #define HAMMER2_CITEM_FEMOD     0x00000002
576 #define HAMMER2_CITEM_NULL      0x00000004
577
578 struct hammer2_cluster {
579         int                     refs;           /* track for deallocation */
580         int                     ddflag;
581         struct hammer2_pfs      *pmp;
582         uint32_t                flags;
583         int                     nchains;
584         int                     error;          /* error code valid on lock */
585         int                     focus_index;
586         hammer2_chain_t         *focus;         /* current focus (or mod) */
587         hammer2_cluster_item_t  array[HAMMER2_MAXCLUSTER];
588 };
589
590 typedef struct hammer2_cluster  hammer2_cluster_t;
591
592 /*
593  * WRHARD       - Hard mounts can write fully synchronized
594  * RDHARD       - Hard mounts can read fully synchronized
595  * UNHARD       - Unsynchronized masters present
596  * NOHARD       - No masters visible
597  * WRSOFT       - Soft mounts can write to at least the SOFT_MASTER
598  * RDSOFT       - Soft mounts can read from at least a SOFT_SLAVE
599  * UNSOFT       - Unsynchronized slaves present
600  * NOSOFT       - No slaves visible
601  * RDSLAVE      - slaves are accessible (possibly unsynchronized or remote).
602  * MSYNCED      - All masters are fully synchronized
603  * SSYNCED      - All known local slaves are fully synchronized to masters
604  *
605  * All available masters are always incorporated.  All PFSs belonging to a
606  * cluster (master, slave, copy, whatever) always try to synchronize the
607  * total number of known masters in the PFSs root inode.
608  *
609  * A cluster might have access to many slaves, copies, or caches, but we
610  * have a limited number of cluster slots.  Any such elements which are
611  * directly mounted from block device(s) will always be incorporated.   Note
612  * that SSYNCED only applies to such elements which are directly mounted,
613  * not to any remote slaves, copies, or caches that could be available.  These
614  * bits are used to monitor and drive our synchronization threads.
615  *
616  * When asking the question 'is any data accessible at all', then a simple
617  * test against (RDHARD|RDSOFT|RDSLAVE) gives you the answer.  If any of
618  * these bits are set the object can be read with certain caveats:
619  * RDHARD - no caveats.  RDSOFT - authoritative but might not be synchronized.
620  * and RDSLAVE - not authoritative, has some data but it could be old or
621  * incomplete.
622  *
623  * When both soft and hard mounts are available, data will be read and written
624  * via the soft mount only.  But all might be in the cluster because
625  * background synchronization threads still need to do their work.
626  */
627 #define HAMMER2_CLUSTER_INODE   0x00000001      /* embedded in inode struct */
628 #define HAMMER2_CLUSTER_UNUSED2 0x00000002
629 #define HAMMER2_CLUSTER_LOCKED  0x00000004      /* cluster lks not recursive */
630 #define HAMMER2_CLUSTER_WRHARD  0x00000100      /* hard-mount can write */
631 #define HAMMER2_CLUSTER_RDHARD  0x00000200      /* hard-mount can read */
632 #define HAMMER2_CLUSTER_UNHARD  0x00000400      /* unsynchronized masters */
633 #define HAMMER2_CLUSTER_NOHARD  0x00000800      /* no masters visible */
634 #define HAMMER2_CLUSTER_WRSOFT  0x00001000      /* soft-mount can write */
635 #define HAMMER2_CLUSTER_RDSOFT  0x00002000      /* soft-mount can read */
636 #define HAMMER2_CLUSTER_UNSOFT  0x00004000      /* unsynchronized slaves */
637 #define HAMMER2_CLUSTER_NOSOFT  0x00008000      /* no slaves visible */
638 #define HAMMER2_CLUSTER_MSYNCED 0x00010000      /* all masters synchronized */
639 #define HAMMER2_CLUSTER_SSYNCED 0x00020000      /* known slaves synchronized */
640
641 #define HAMMER2_CLUSTER_ANYDATA ( HAMMER2_CLUSTER_RDHARD |      \
642                                   HAMMER2_CLUSTER_RDSOFT |      \
643                                   HAMMER2_CLUSTER_RDSLAVE)
644
645 #define HAMMER2_CLUSTER_RDOK    ( HAMMER2_CLUSTER_RDHARD |      \
646                                   HAMMER2_CLUSTER_RDSOFT)
647
648 #define HAMMER2_CLUSTER_WROK    ( HAMMER2_CLUSTER_WRHARD |      \
649                                   HAMMER2_CLUSTER_WRSOFT)
650
651 #define HAMMER2_CLUSTER_ZFLAGS  ( HAMMER2_CLUSTER_WRHARD |      \
652                                   HAMMER2_CLUSTER_RDHARD |      \
653                                   HAMMER2_CLUSTER_WRSOFT |      \
654                                   HAMMER2_CLUSTER_RDSOFT |      \
655                                   HAMMER2_CLUSTER_MSYNCED |     \
656                                   HAMMER2_CLUSTER_SSYNCED)
657
658 /*
659  * Helper functions (cluster must be locked for flags to be valid).
660  */
661 static __inline
662 int
663 hammer2_cluster_rdok(hammer2_cluster_t *cluster)
664 {
665         return (cluster->flags & HAMMER2_CLUSTER_RDOK);
666 }
667
668 static __inline
669 int
670 hammer2_cluster_wrok(hammer2_cluster_t *cluster)
671 {
672         return (cluster->flags & HAMMER2_CLUSTER_WROK);
673 }
674
675 RB_HEAD(hammer2_inode_tree, hammer2_inode);
676
677 /*
678  * A hammer2 inode.
679  *
680  * NOTE: The inode-embedded cluster is never used directly for I/O (since
681  *       it may be shared).  Instead it will be replicated-in and synchronized
682  *       back out if changed.
683  */
684 struct hammer2_inode {
685         RB_ENTRY(hammer2_inode) rbnode;         /* inumber lookup (HL) */
686         hammer2_mtx_t           lock;           /* inode lock */
687         hammer2_mtx_t           truncate_lock;  /* prevent truncates */
688         struct hammer2_pfs      *pmp;           /* PFS mount */
689         struct vnode            *vp;
690         struct spinlock         cluster_spin;   /* update cluster */
691         hammer2_cluster_t       cluster;
692         struct lockf            advlock;
693         u_int                   flags;
694         u_int                   refs;           /* +vpref, +flushref */
695         uint8_t                 comp_heuristic;
696         hammer2_inode_meta_t    meta;           /* copy of meta-data */
697         hammer2_off_t           osize;
698 };
699
700 typedef struct hammer2_inode hammer2_inode_t;
701
702 /*
703  * MODIFIED     - Inode is in a modified state, ip->meta may have changes.
704  * RESIZED      - Inode truncated (any) or inode extended beyond
705  *                EMBEDDED_BYTES.
706  */
707 #define HAMMER2_INODE_MODIFIED          0x0001
708 #define HAMMER2_INODE_SROOT             0x0002  /* kmalloc special case */
709 #define HAMMER2_INODE_RENAME_INPROG     0x0004
710 #define HAMMER2_INODE_ONRBTREE          0x0008
711 #define HAMMER2_INODE_RESIZED           0x0010  /* requires inode_fsync */
712 #define HAMMER2_INODE_ISDELETED         0x0020  /* deleted */
713 #define HAMMER2_INODE_ISUNLINKED        0x0040
714 #define HAMMER2_INODE_METAGOOD          0x0080  /* inode meta-data good */
715 #define HAMMER2_INODE_ONSIDEQ           0x0100  /* on side processing queue */
716
717 int hammer2_inode_cmp(hammer2_inode_t *ip1, hammer2_inode_t *ip2);
718 RB_PROTOTYPE2(hammer2_inode_tree, hammer2_inode, rbnode, hammer2_inode_cmp,
719                 hammer2_tid_t);
720
721 /*
722  * inode-unlink side-structure
723  */
724 struct hammer2_inode_sideq {
725         TAILQ_ENTRY(hammer2_inode_sideq) entry;
726         hammer2_inode_t *ip;
727 };
728 TAILQ_HEAD(h2_sideq_list, hammer2_inode_sideq);
729
730 typedef struct hammer2_inode_sideq hammer2_inode_sideq_t;
731
732 /*
733  * Transaction management sub-structure under hammer2_pfs
734  */
735 struct hammer2_trans {
736         uint32_t                flags;
737         uint32_t                sync_wait;
738 };
739
740 typedef struct hammer2_trans hammer2_trans_t;
741
742 #define HAMMER2_TRANS_ISFLUSH           0x80000000      /* flush code */
743 #define HAMMER2_TRANS_BUFCACHE          0x40000000      /* bio strategy */
744 #define HAMMER2_TRANS_UNUSED20          0x20000000
745 #define HAMMER2_TRANS_FPENDING          0x10000000      /* flush pending */
746 #define HAMMER2_TRANS_WAITING           0x08000000      /* someone waiting */
747 #define HAMMER2_TRANS_MASK              0x00FFFFFF      /* count mask */
748
749 #define HAMMER2_FREEMAP_HEUR_NRADIX     4       /* pwr 2 PBUFRADIX-MINIORADIX */
750 #define HAMMER2_FREEMAP_HEUR_TYPES      8
751 #define HAMMER2_FREEMAP_HEUR_SIZE       (HAMMER2_FREEMAP_HEUR_NRADIX * \
752                                          HAMMER2_FREEMAP_HEUR_TYPES)
753
754 #define HAMMER2_DEDUP_HEUR_SIZE         (65536 * 4)
755 #define HAMMER2_DEDUP_HEUR_MASK         (HAMMER2_DEDUP_HEUR_SIZE - 1)
756
757 #define HAMMER2_FLUSH_TOP               0x0001
758 #define HAMMER2_FLUSH_ALL               0x0002
759
760
761 /*
762  * Hammer2 support thread element.
763  *
764  * Potentially many support threads can hang off of hammer2, primarily
765  * off the hammer2_pfs structure.  Typically:
766  *
767  * td x Nodes                   A synchronization thread for each node.
768  * td x Nodes x workers         Worker threads for frontend operations.
769  * td x 1                       Bioq thread for logical buffer writes.
770  *
771  * In addition, the synchronization thread(s) associated with the
772  * super-root PFS (spmp) for a node is responsible for automatic bulkfree
773  * and dedup scans.
774  */
775 struct hammer2_thread {
776         struct hammer2_pfs *pmp;
777         struct hammer2_dev *hmp;
778         hammer2_xop_list_t xopq;
779         thread_t        td;
780         uint32_t        flags;
781         int             depth;
782         int             clindex;        /* cluster element index */
783         int             repidx;
784         char            *scratch;       /* MAXPHYS */
785 };
786
787 typedef struct hammer2_thread hammer2_thread_t;
788
789 #define HAMMER2_THREAD_UNMOUNTING       0x0001  /* unmount request */
790 #define HAMMER2_THREAD_DEV              0x0002  /* related to dev, not pfs */
791 #define HAMMER2_THREAD_WAITING          0x0004  /* thread in idle tsleep */
792 #define HAMMER2_THREAD_REMASTER         0x0008  /* remaster request */
793 #define HAMMER2_THREAD_STOP             0x0010  /* exit request */
794 #define HAMMER2_THREAD_FREEZE           0x0020  /* force idle */
795 #define HAMMER2_THREAD_FROZEN           0x0040  /* thread is frozen */
796 #define HAMMER2_THREAD_XOPQ             0x0080  /* work pending */
797 #define HAMMER2_THREAD_STOPPED          0x0100  /* thread has stopped */
798 #define HAMMER2_THREAD_UNFREEZE         0x0200
799
800 #define HAMMER2_THREAD_WAKEUP_MASK      (HAMMER2_THREAD_UNMOUNTING |    \
801                                          HAMMER2_THREAD_REMASTER |      \
802                                          HAMMER2_THREAD_STOP |          \
803                                          HAMMER2_THREAD_FREEZE |        \
804                                          HAMMER2_THREAD_XOPQ)
805
806 /*
807  * Support structure for dedup heuristic.
808  */
809 struct hammer2_dedup {
810         hammer2_off_t   data_off;
811         uint64_t        data_crc;
812         uint32_t        ticks;
813         uint32_t        unused03;
814 };
815
816 typedef struct hammer2_dedup hammer2_dedup_t;
817
818 /*
819  * hammer2_xop - container for VOP/XOP operation (allocated, not on stack).
820  *
821  * This structure is used to distribute a VOP operation across multiple
822  * nodes.  It provides a rendezvous for concurrent node execution and
823  * can be detached from the frontend operation to allow the frontend to
824  * return early.
825  *
826  * This structure also sequences operations on up to three inodes.
827  */
828 typedef void (*hammer2_xop_func_t)(hammer2_thread_t *thr,
829                                    union hammer2_xop *xop);
830
831 struct hammer2_xop_fifo {
832         TAILQ_ENTRY(hammer2_xop_head) entry;
833         hammer2_chain_t         *array[HAMMER2_XOPFIFO];
834         int                     errors[HAMMER2_XOPFIFO];
835         int                     ri;
836         int                     wi;
837         int                     flags;
838         hammer2_thread_t        *thr;
839 };
840
841 typedef struct hammer2_xop_fifo hammer2_xop_fifo_t;
842
843 #define HAMMER2_XOP_FIFO_RUN    0x0001
844 #define HAMMER2_XOP_FIFO_STALL  0x0002
845
846 struct hammer2_xop_head {
847         hammer2_xop_func_t      func;
848         hammer2_tid_t           mtid;
849         struct hammer2_inode    *ip1;
850         struct hammer2_inode    *ip2;
851         struct hammer2_inode    *ip3;
852         uint32_t                check_counter;
853         uint32_t                run_mask;
854         uint32_t                chk_mask;
855         int                     flags;
856         int                     state;
857         int                     error;
858         hammer2_key_t           collect_key;
859         char                    *name1;
860         size_t                  name1_len;
861         char                    *name2;
862         size_t                  name2_len;
863         hammer2_xop_fifo_t      collect[HAMMER2_MAXCLUSTER];
864         hammer2_cluster_t       cluster;        /* help collections */
865 };
866
867 typedef struct hammer2_xop_head hammer2_xop_head_t;
868
869 #define HAMMER2_XOP_CHKWAIT     0x00000001U
870 #define HAMMER2_XOP_CHKINC      0x00000002U
871
872 struct hammer2_xop_ipcluster {
873         hammer2_xop_head_t      head;
874 };
875
876 struct hammer2_xop_strategy {
877         hammer2_xop_head_t      head;
878         hammer2_key_t           lbase;
879         int                     finished;
880         hammer2_mtx_t           lock;
881         struct bio              *bio;
882 };
883
884 struct hammer2_xop_readdir {
885         hammer2_xop_head_t      head;
886         hammer2_key_t           lkey;
887 };
888
889 struct hammer2_xop_nresolve {
890         hammer2_xop_head_t      head;
891         hammer2_key_t           lhc;    /* if name is NULL used lhc */
892 };
893
894 struct hammer2_xop_unlink {
895         hammer2_xop_head_t      head;
896         int                     isdir;
897         int                     dopermanent;
898 };
899
900 struct hammer2_xop_nrename {
901         hammer2_xop_head_t      head;
902         hammer2_tid_t           lhc;
903         int                     ip_key;
904 };
905
906 struct hammer2_xop_scanlhc {
907         hammer2_xop_head_t      head;
908         hammer2_key_t           lhc;
909 };
910
911 struct hammer2_xop_scanall {
912         hammer2_xop_head_t      head;
913         hammer2_key_t           key_beg;        /* inclusive */
914         hammer2_key_t           key_end;        /* inclusive */
915         int                     resolve_flags;
916         int                     lookup_flags;
917 };
918
919 struct hammer2_xop_lookup {
920         hammer2_xop_head_t      head;
921         hammer2_key_t           lhc;
922 };
923
924 struct hammer2_xop_mkdirent {
925         hammer2_xop_head_t      head;
926         hammer2_dirent_head_t   dirent;
927         hammer2_key_t           lhc;
928 };
929
930 struct hammer2_xop_create {
931         hammer2_xop_head_t      head;
932         hammer2_inode_meta_t    meta;           /* initial metadata */
933         hammer2_key_t           lhc;
934         int                     flags;
935 };
936
937 struct hammer2_xop_destroy {
938         hammer2_xop_head_t      head;
939 };
940
941 struct hammer2_xop_fsync {
942         hammer2_xop_head_t      head;
943         hammer2_inode_meta_t    meta;
944         hammer2_off_t           osize;
945         u_int                   ipflags;
946         int                     clear_directdata;
947 };
948
949 struct hammer2_xop_unlinkall {
950         hammer2_xop_head_t      head;
951         hammer2_key_t           key_beg;
952         hammer2_key_t           key_end;
953 };
954
955 struct hammer2_xop_connect {
956         hammer2_xop_head_t      head;
957         hammer2_key_t           lhc;
958 };
959
960 struct hammer2_xop_flush {
961         hammer2_xop_head_t      head;
962 };
963
964 typedef struct hammer2_xop_readdir hammer2_xop_readdir_t;
965 typedef struct hammer2_xop_nresolve hammer2_xop_nresolve_t;
966 typedef struct hammer2_xop_unlink hammer2_xop_unlink_t;
967 typedef struct hammer2_xop_nrename hammer2_xop_nrename_t;
968 typedef struct hammer2_xop_ipcluster hammer2_xop_ipcluster_t;
969 typedef struct hammer2_xop_strategy hammer2_xop_strategy_t;
970 typedef struct hammer2_xop_mkdirent hammer2_xop_mkdirent_t;
971 typedef struct hammer2_xop_create hammer2_xop_create_t;
972 typedef struct hammer2_xop_destroy hammer2_xop_destroy_t;
973 typedef struct hammer2_xop_fsync hammer2_xop_fsync_t;
974 typedef struct hammer2_xop_unlinkall hammer2_xop_unlinkall_t;
975 typedef struct hammer2_xop_scanlhc hammer2_xop_scanlhc_t;
976 typedef struct hammer2_xop_scanall hammer2_xop_scanall_t;
977 typedef struct hammer2_xop_lookup hammer2_xop_lookup_t;
978 typedef struct hammer2_xop_connect hammer2_xop_connect_t;
979 typedef struct hammer2_xop_flush hammer2_xop_flush_t;
980
981 union hammer2_xop {
982         hammer2_xop_head_t      head;
983         hammer2_xop_ipcluster_t xop_ipcluster;
984         hammer2_xop_readdir_t   xop_readdir;
985         hammer2_xop_nresolve_t  xop_nresolve;
986         hammer2_xop_unlink_t    xop_unlink;
987         hammer2_xop_nrename_t   xop_nrename;
988         hammer2_xop_strategy_t  xop_strategy;
989         hammer2_xop_mkdirent_t  xop_mkdirent;
990         hammer2_xop_create_t    xop_create;
991         hammer2_xop_destroy_t   xop_destroy;
992         hammer2_xop_fsync_t     xop_fsync;
993         hammer2_xop_unlinkall_t xop_unlinkall;
994         hammer2_xop_scanlhc_t   xop_scanlhc;
995         hammer2_xop_scanall_t   xop_scanall;
996         hammer2_xop_lookup_t    xop_lookup;
997         hammer2_xop_flush_t     xop_flush;
998         hammer2_xop_connect_t   xop_connect;
999 };
1000
1001 typedef union hammer2_xop hammer2_xop_t;
1002
1003 /*
1004  * hammer2_xop_group - Manage XOP support threads.
1005  */
1006 struct hammer2_xop_group {
1007         hammer2_thread_t        thrs[HAMMER2_MAXCLUSTER];
1008 };
1009
1010 typedef struct hammer2_xop_group hammer2_xop_group_t;
1011
1012 /*
1013  * flags to hammer2_xop_collect()
1014  */
1015 #define HAMMER2_XOP_COLLECT_NOWAIT      0x00000001
1016 #define HAMMER2_XOP_COLLECT_WAITALL     0x00000002
1017
1018 /*
1019  * flags to hammer2_xop_alloc()
1020  *
1021  * MODIFYING    - This is a modifying transaction, allocate a mtid.
1022  */
1023 #define HAMMER2_XOP_MODIFYING           0x00000001
1024 #define HAMMER2_XOP_STRATEGY            0x00000002
1025
1026 /*
1027  * Global (per partition) management structure, represents a hard block
1028  * device.  Typically referenced by hammer2_chain structures when applicable.
1029  * Typically not used for network-managed elements.
1030  *
1031  * Note that a single hammer2_dev can be indirectly tied to multiple system
1032  * mount points.  There is no direct relationship.  System mounts are
1033  * per-cluster-id, not per-block-device, and a single hard mount might contain
1034  * many PFSs and those PFSs might combine together in various ways to form
1035  * the set of available clusters.
1036  */
1037 struct hammer2_dev {
1038         struct vnode    *devvp;         /* device vnode */
1039         int             ronly;          /* read-only mount */
1040         int             mount_count;    /* number of actively mounted PFSs */
1041         TAILQ_ENTRY(hammer2_dev) mntentry; /* hammer2_mntlist */
1042
1043         struct malloc_type *mchain;
1044         int             nipstacks;
1045         int             maxipstacks;
1046         kdmsg_iocom_t   iocom;          /* volume-level dmsg interface */
1047         struct spinlock io_spin;        /* iotree, iolruq access */
1048         struct hammer2_io_tree iotree;
1049         int             iofree_count;
1050         hammer2_chain_t vchain;         /* anchor chain (topology) */
1051         hammer2_chain_t fchain;         /* anchor chain (freemap) */
1052         struct spinlock list_spin;
1053         struct h2_flush_list flushq;    /* flush seeds */
1054         struct hammer2_pfs *spmp;       /* super-root pmp for transactions */
1055         struct lock     vollk;          /* lockmgr lock */
1056         struct lock     bulklk;         /* bulkfree operation lock */
1057         struct lock     bflock;         /* bulk-free manual function lock */
1058         hammer2_off_t   heur_freemap[HAMMER2_FREEMAP_HEUR_SIZE];
1059         hammer2_dedup_t heur_dedup[HAMMER2_DEDUP_HEUR_SIZE];
1060         int             volhdrno;       /* last volhdrno written */
1061         uint32_t        hflags;         /* HMNT2 flags applicable to device */
1062         hammer2_thread_t bfthr;         /* bulk-free thread */
1063         char            devrepname[64]; /* for kprintf */
1064         hammer2_ioc_bulkfree_t bflast;  /* stats for last bulkfree run */
1065         hammer2_volume_data_t voldata;
1066         hammer2_volume_data_t volsync;  /* synchronized voldata */
1067 };
1068
1069 typedef struct hammer2_dev hammer2_dev_t;
1070
1071 /*
1072  * Helper functions (cluster must be locked for flags to be valid).
1073  */
1074 static __inline
1075 int
1076 hammer2_chain_rdok(hammer2_chain_t *chain)
1077 {
1078         return (chain->error == 0);
1079 }
1080
1081 static __inline
1082 int
1083 hammer2_chain_wrok(hammer2_chain_t *chain)
1084 {
1085         return (chain->error == 0 && chain->hmp->ronly == 0);
1086 }
1087
1088 /*
1089  * Per-cluster management structure.  This structure will be tied to a
1090  * system mount point if the system is mounting the PFS, but is also used
1091  * to manage clusters encountered during the super-root scan or received
1092  * via LNK_SPANs that might not be mounted.
1093  *
1094  * This structure is also used to represent the super-root that hangs off
1095  * of a hard mount point.  The super-root is not really a cluster element.
1096  * In this case the spmp_hmp field will be non-NULL.  It's just easier to do
1097  * this than to special case super-root manipulation in the hammer2_chain*
1098  * code as being only hammer2_dev-related.
1099  *
1100  * pfs_mode and pfs_nmasters are rollup fields which critically describes
1101  * how elements of the cluster act on the cluster.  pfs_mode is only applicable
1102  * when a PFS is mounted by the system.  pfs_nmasters is our best guess as to
1103  * how many masters have been configured for a cluster and is always
1104  * applicable.  pfs_types[] is an array with 1:1 correspondance to the
1105  * iroot cluster and describes the PFS types of the nodes making up the
1106  * cluster.
1107  *
1108  * WARNING! Portions of this structure have deferred initialization.  In
1109  *          particular, if not mounted there will be no wthread.
1110  *          umounted network PFSs will also be missing iroot and numerous
1111  *          other fields will not be initialized prior to mount.
1112  *
1113  *          Synchronization threads are chain-specific and only applicable
1114  *          to local hard PFS entries.  A hammer2_pfs structure may contain
1115  *          more than one when multiple hard PFSs are present on the local
1116  *          machine which require synchronization monitoring.  Most PFSs
1117  *          (such as snapshots) are 1xMASTER PFSs which do not need a
1118  *          synchronization thread.
1119  *
1120  * WARNING! The chains making up pfs->iroot's cluster are accounted for in
1121  *          hammer2_dev->mount_count when the pfs is associated with a mount
1122  *          point.
1123  */
1124 struct hammer2_pfs {
1125         struct mount            *mp;
1126         TAILQ_ENTRY(hammer2_pfs) mntentry;      /* hammer2_pfslist */
1127         uuid_t                  pfs_clid;
1128         hammer2_dev_t           *spmp_hmp;      /* only if super-root pmp */
1129         hammer2_dev_t           *force_local;   /* only if 'local' mount */
1130         hammer2_inode_t         *iroot;         /* PFS root inode */
1131         uint8_t                 pfs_types[HAMMER2_MAXCLUSTER];
1132         char                    *pfs_names[HAMMER2_MAXCLUSTER];
1133         hammer2_dev_t           *pfs_hmps[HAMMER2_MAXCLUSTER];
1134         hammer2_trans_t         trans;
1135         struct lock             lock;           /* PFS lock for certain ops */
1136         struct lock             lock_nlink;     /* rename and nlink lock */
1137         struct netexport        export;         /* nfs export */
1138         int                     ronly;          /* read-only mount */
1139         int                     hflags;         /* pfs-specific mount flags */
1140         struct malloc_type      *minode;
1141         struct malloc_type      *mmsg;
1142         struct spinlock         inum_spin;      /* inumber lookup */
1143         struct hammer2_inode_tree inum_tree;    /* (not applicable to spmp) */
1144         struct spinlock         lru_spin;       /* inumber lookup */
1145         struct hammer2_chain_list lru_list;     /* chains on LRU */
1146         int                     lru_count;      /* #of chains on LRU */
1147         hammer2_tid_t           modify_tid;     /* modify transaction id */
1148         hammer2_tid_t           inode_tid;      /* inode allocator */
1149         uint8_t                 pfs_nmasters;   /* total masters */
1150         uint8_t                 pfs_mode;       /* operating mode PFSMODE */
1151         uint8_t                 unused01;
1152         uint8_t                 unused02;
1153         int                     unused03;
1154         long                    inmem_inodes;
1155         uint32_t                inmem_dirty_chains;
1156         int                     count_lwinprog; /* logical write in prog */
1157         struct spinlock         list_spin;
1158         struct h2_sideq_list    sideq;          /* last-close dirty/unlink */
1159         hammer2_thread_t        sync_thrs[HAMMER2_MAXCLUSTER];
1160         uint32_t                cluster_flags;  /* cached cluster flags */
1161         int                     has_xop_threads;
1162         struct spinlock         xop_spin;       /* xop sequencer */
1163         hammer2_xop_group_t     xop_groups[HAMMER2_XOPGROUPS];
1164 };
1165
1166 typedef struct hammer2_pfs hammer2_pfs_t;
1167
1168 TAILQ_HEAD(hammer2_pfslist, hammer2_pfs);
1169
1170 #define HAMMER2_LRU_LIMIT               1024    /* per pmp lru_list */
1171
1172 #define HAMMER2_DIRTYCHAIN_WAITING      0x80000000
1173 #define HAMMER2_DIRTYCHAIN_MASK         0x7FFFFFFF
1174
1175 #define HAMMER2_LWINPROG_WAITING        0x80000000
1176 #define HAMMER2_LWINPROG_WAITING0       0x40000000
1177 #define HAMMER2_LWINPROG_MASK           0x3FFFFFFF
1178
1179 /*
1180  * hammer2_cluster_check
1181  */
1182 #define HAMMER2_CHECK_NULL      0x00000001
1183
1184 /*
1185  * Bulkscan
1186  */
1187 #define HAMMER2_BULK_ABORT      0x00000001
1188
1189 /*
1190  * Misc
1191  */
1192 #if defined(_KERNEL)
1193
1194 MALLOC_DECLARE(M_HAMMER2);
1195
1196 #define VTOI(vp)        ((hammer2_inode_t *)(vp)->v_data)
1197 #define ITOV(ip)        ((ip)->vp)
1198
1199 /*
1200  * Currently locked chains retain the locked buffer cache buffer for
1201  * indirect blocks, and indirect blocks can be one of two sizes.  The
1202  * device buffer has to match the case to avoid deadlocking recursive
1203  * chains that might otherwise try to access different offsets within
1204  * the same device buffer.
1205  */
1206 static __inline
1207 int
1208 hammer2_devblkradix(int radix)
1209 {
1210 #if 0
1211         if (radix <= HAMMER2_LBUFRADIX) {
1212                 return (HAMMER2_LBUFRADIX);
1213         } else {
1214                 return (HAMMER2_PBUFRADIX);
1215         }
1216 #endif
1217         return (HAMMER2_PBUFRADIX);
1218 }
1219
1220 /*
1221  * XXX almost time to remove this.  DIO uses PBUFSIZE exclusively now.
1222  */
1223 static __inline
1224 size_t
1225 hammer2_devblksize(size_t bytes)
1226 {
1227 #if 0
1228         if (bytes <= HAMMER2_LBUFSIZE) {
1229                 return(HAMMER2_LBUFSIZE);
1230         } else {
1231                 KKASSERT(bytes <= HAMMER2_PBUFSIZE &&
1232                          (bytes ^ (bytes - 1)) == ((bytes << 1) - 1));
1233                 return (HAMMER2_PBUFSIZE);
1234         }
1235 #endif
1236         return (HAMMER2_PBUFSIZE);
1237 }
1238
1239
1240 static __inline
1241 hammer2_pfs_t *
1242 MPTOPMP(struct mount *mp)
1243 {
1244         return ((hammer2_pfs_t *)mp->mnt_data);
1245 }
1246
1247 #define HAMMER2_DEDUP_FRAG      (HAMMER2_PBUFSIZE / 64)
1248 #define HAMMER2_DEDUP_FRAGRADIX (HAMMER2_PBUFRADIX - 6)
1249
1250 static __inline
1251 uint64_t
1252 hammer2_dedup_mask(hammer2_io_t *dio, hammer2_off_t data_off, u_int bytes)
1253 {
1254         int bbeg;
1255         int bits;
1256         uint64_t mask;
1257
1258         bbeg = (int)((data_off & ~HAMMER2_OFF_MASK_RADIX) - dio->pbase) >>
1259                HAMMER2_DEDUP_FRAGRADIX;
1260         bits = (int)((bytes + (HAMMER2_DEDUP_FRAG - 1)) >>
1261                HAMMER2_DEDUP_FRAGRADIX);
1262         mask = ((uint64_t)1 << bbeg) - 1;
1263         if (bbeg + bits == 64)
1264                 mask = (uint64_t)-1;
1265         else
1266                 mask = ((uint64_t)1 << (bbeg + bits)) - 1;
1267
1268         mask &= ~(((uint64_t)1 << bbeg) - 1);
1269
1270         return mask;
1271 }
1272
1273 extern struct vop_ops hammer2_vnode_vops;
1274 extern struct vop_ops hammer2_spec_vops;
1275 extern struct vop_ops hammer2_fifo_vops;
1276 extern struct hammer2_pfslist hammer2_pfslist;
1277 extern struct lock hammer2_mntlk;
1278
1279
1280 extern int hammer2_debug;
1281 extern int hammer2_cluster_read;
1282 extern int hammer2_cluster_write;
1283 extern int hammer2_dedup_enable;
1284 extern int hammer2_always_compress;
1285 extern int hammer2_inval_enable;
1286 extern int hammer2_flush_pipe;
1287 extern int hammer2_synchronous_flush;
1288 extern int hammer2_dio_count;
1289 extern int hammer2_limit_dio;
1290 extern long hammer2_chain_allocs;
1291 extern long hammer2_chain_frees;
1292 extern long hammer2_limit_dirty_chains;
1293 extern long hammer2_count_modified_chains;
1294 extern long hammer2_iod_invals;
1295 extern long hammer2_iod_file_read;
1296 extern long hammer2_iod_meta_read;
1297 extern long hammer2_iod_indr_read;
1298 extern long hammer2_iod_fmap_read;
1299 extern long hammer2_iod_volu_read;
1300 extern long hammer2_iod_file_write;
1301 extern long hammer2_iod_file_wembed;
1302 extern long hammer2_iod_file_wzero;
1303 extern long hammer2_iod_file_wdedup;
1304 extern long hammer2_iod_meta_write;
1305 extern long hammer2_iod_indr_write;
1306 extern long hammer2_iod_fmap_write;
1307 extern long hammer2_iod_volu_write;
1308
1309 extern long hammer2_check_xxhash64;
1310 extern long hammer2_check_icrc32;
1311
1312 extern struct objcache *cache_buffer_read;
1313 extern struct objcache *cache_buffer_write;
1314 extern struct objcache *cache_xops;
1315
1316 /*
1317  * hammer2_subr.c
1318  */
1319 #define hammer2_icrc32(buf, size)       iscsi_crc32((buf), (size))
1320 #define hammer2_icrc32c(buf, size, crc) iscsi_crc32_ext((buf), (size), (crc))
1321
1322 int hammer2_signal_check(time_t *timep);
1323 const char *hammer2_error_str(int error);
1324
1325 void hammer2_inode_lock(hammer2_inode_t *ip, int how);
1326 void hammer2_inode_unlock(hammer2_inode_t *ip);
1327 hammer2_chain_t *hammer2_inode_chain(hammer2_inode_t *ip, int clindex, int how);
1328 hammer2_chain_t *hammer2_inode_chain_and_parent(hammer2_inode_t *ip,
1329                         int clindex, hammer2_chain_t **parentp, int how);
1330 hammer2_mtx_state_t hammer2_inode_lock_temp_release(hammer2_inode_t *ip);
1331 void hammer2_inode_lock_temp_restore(hammer2_inode_t *ip,
1332                         hammer2_mtx_state_t ostate);
1333 int hammer2_inode_lock_upgrade(hammer2_inode_t *ip);
1334 void hammer2_inode_lock_downgrade(hammer2_inode_t *ip, int);
1335
1336 void hammer2_dev_exlock(hammer2_dev_t *hmp);
1337 void hammer2_dev_shlock(hammer2_dev_t *hmp);
1338 void hammer2_dev_unlock(hammer2_dev_t *hmp);
1339
1340 int hammer2_get_dtype(uint8_t type);
1341 int hammer2_get_vtype(uint8_t type);
1342 uint8_t hammer2_get_obj_type(enum vtype vtype);
1343 void hammer2_time_to_timespec(uint64_t xtime, struct timespec *ts);
1344 uint64_t hammer2_timespec_to_time(const struct timespec *ts);
1345 uint32_t hammer2_to_unix_xid(const uuid_t *uuid);
1346 void hammer2_guid_to_uuid(uuid_t *uuid, uint32_t guid);
1347 void hammer2_trans_manage_init(hammer2_pfs_t *pmp);
1348
1349 hammer2_key_t hammer2_dirhash(const unsigned char *name, size_t len);
1350 int hammer2_getradix(size_t bytes);
1351
1352 int hammer2_calc_logical(hammer2_inode_t *ip, hammer2_off_t uoff,
1353                         hammer2_key_t *lbasep, hammer2_key_t *leofp);
1354 int hammer2_calc_physical(hammer2_inode_t *ip, hammer2_key_t lbase);
1355 void hammer2_update_time(uint64_t *timep);
1356 void hammer2_adjreadcounter(hammer2_blockref_t *bref, size_t bytes);
1357
1358 /*
1359  * hammer2_inode.c
1360  */
1361 struct vnode *hammer2_igetv(hammer2_inode_t *ip, int *errorp);
1362 hammer2_inode_t *hammer2_inode_lookup(hammer2_pfs_t *pmp,
1363                         hammer2_tid_t inum);
1364 hammer2_inode_t *hammer2_inode_get(hammer2_pfs_t *pmp, hammer2_inode_t *dip,
1365                         hammer2_cluster_t *cluster, int idx);
1366 void hammer2_inode_free(hammer2_inode_t *ip);
1367 void hammer2_inode_ref(hammer2_inode_t *ip);
1368 void hammer2_inode_drop(hammer2_inode_t *ip);
1369 void hammer2_inode_repoint(hammer2_inode_t *ip, hammer2_inode_t *pip,
1370                         hammer2_cluster_t *cluster);
1371 void hammer2_inode_repoint_one(hammer2_inode_t *ip, hammer2_cluster_t *cluster,
1372                         int idx);
1373 void hammer2_inode_modify(hammer2_inode_t *ip);
1374 void hammer2_inode_run_sideq(hammer2_pfs_t *pmp);
1375
1376 hammer2_inode_t *hammer2_inode_create(hammer2_inode_t *dip,
1377                         hammer2_inode_t *pip,
1378                         struct vattr *vap, struct ucred *cred,
1379                         const uint8_t *name, size_t name_len, hammer2_key_t lhc,
1380                         hammer2_key_t inum, uint8_t type, uint8_t target_type,
1381                         int flags, int *errorp);
1382 void hammer2_inode_chain_sync(hammer2_inode_t *ip);
1383 int hammer2_inode_unlink_finisher(hammer2_inode_t *ip, int isopen);
1384 int hammer2_dirent_create(hammer2_inode_t *dip, const char *name,
1385                         size_t name_len, hammer2_key_t inum, uint8_t type);
1386
1387 /*
1388  * hammer2_chain.c
1389  */
1390 void hammer2_voldata_lock(hammer2_dev_t *hmp);
1391 void hammer2_voldata_unlock(hammer2_dev_t *hmp);
1392 void hammer2_voldata_modify(hammer2_dev_t *hmp);
1393 hammer2_chain_t *hammer2_chain_alloc(hammer2_dev_t *hmp,
1394                                 hammer2_pfs_t *pmp,
1395                                 hammer2_blockref_t *bref);
1396 void hammer2_chain_core_init(hammer2_chain_t *chain);
1397 void hammer2_chain_ref(hammer2_chain_t *chain);
1398 void hammer2_chain_ref_hold(hammer2_chain_t *chain);
1399 void hammer2_chain_drop(hammer2_chain_t *chain);
1400 void hammer2_chain_drop_unhold(hammer2_chain_t *chain);
1401 void hammer2_chain_lock(hammer2_chain_t *chain, int how);
1402 void hammer2_chain_lock_unhold(hammer2_chain_t *chain, int how);
1403 #if 0
1404 void hammer2_chain_push_shared_lock(hammer2_chain_t *chain);
1405 void hammer2_chain_pull_shared_lock(hammer2_chain_t *chain);
1406 #endif
1407 void hammer2_chain_load_data(hammer2_chain_t *chain);
1408 const hammer2_media_data_t *hammer2_chain_rdata(hammer2_chain_t *chain);
1409 hammer2_media_data_t *hammer2_chain_wdata(hammer2_chain_t *chain);
1410 int hammer2_chain_snapshot(hammer2_chain_t *chain, hammer2_ioc_pfs_t *pmp,
1411                                 hammer2_tid_t mtid);
1412
1413 int hammer2_chain_inode_find(hammer2_pfs_t *pmp, hammer2_key_t inum,
1414                                 int clindex, int flags,
1415                                 hammer2_chain_t **parentp,
1416                                 hammer2_chain_t **chainp);
1417 void hammer2_chain_modify(hammer2_chain_t *chain, hammer2_tid_t mtid,
1418                                 hammer2_off_t dedup_off, int flags);
1419 void hammer2_chain_modify_ip(hammer2_inode_t *ip, hammer2_chain_t *chain,
1420                                 hammer2_tid_t mtid, int flags);
1421 void hammer2_chain_resize(hammer2_chain_t *chain,
1422                                 hammer2_tid_t mtid, hammer2_off_t dedup_off,
1423                                 int nradix, int flags);
1424 void hammer2_chain_unlock(hammer2_chain_t *chain);
1425 void hammer2_chain_unlock_hold(hammer2_chain_t *chain);
1426 void hammer2_chain_wait(hammer2_chain_t *chain);
1427 hammer2_chain_t *hammer2_chain_get(hammer2_chain_t *parent, int generation,
1428                                 hammer2_blockref_t *bref);
1429 hammer2_chain_t *hammer2_chain_lookup_init(hammer2_chain_t *parent, int flags);
1430 void hammer2_chain_lookup_done(hammer2_chain_t *parent);
1431 hammer2_chain_t *hammer2_chain_getparent(hammer2_chain_t *chain, int how);
1432 hammer2_chain_t *hammer2_chain_repparent(hammer2_chain_t **chainp, int how);
1433 hammer2_chain_t *hammer2_chain_lookup(hammer2_chain_t **parentp,
1434                                 hammer2_key_t *key_nextp,
1435                                 hammer2_key_t key_beg, hammer2_key_t key_end,
1436                                 int *cache_indexp, int flags);
1437 hammer2_chain_t *hammer2_chain_next(hammer2_chain_t **parentp,
1438                                 hammer2_chain_t *chain,
1439                                 hammer2_key_t *key_nextp,
1440                                 hammer2_key_t key_beg, hammer2_key_t key_end,
1441                                 int *cache_indexp, int flags);
1442 hammer2_blockref_t *hammer2_chain_scan(hammer2_chain_t *parent,
1443                                 hammer2_chain_t **chainp,
1444                                 hammer2_blockref_t *bref,
1445                                 int *firstp, int *cache_indexp, int flags);
1446
1447 int hammer2_chain_create(hammer2_chain_t **parentp, hammer2_chain_t **chainp,
1448                                 hammer2_pfs_t *pmp, int methods,
1449                                 hammer2_key_t key, int keybits,
1450                                 int type, size_t bytes, hammer2_tid_t mtid,
1451                                 hammer2_off_t dedup_off, int flags);
1452 void hammer2_chain_rename(hammer2_blockref_t *bref,
1453                                 hammer2_chain_t **parentp,
1454                                 hammer2_chain_t *chain,
1455                                 hammer2_tid_t mtid, int flags);
1456 void hammer2_chain_delete(hammer2_chain_t *parent, hammer2_chain_t *chain,
1457                                 hammer2_tid_t mtid, int flags);
1458 void hammer2_chain_setflush(hammer2_chain_t *chain);
1459 void hammer2_chain_countbrefs(hammer2_chain_t *chain,
1460                                 hammer2_blockref_t *base, int count);
1461 hammer2_chain_t *hammer2_chain_bulksnap(hammer2_dev_t *hmp);
1462 void hammer2_chain_bulkdrop(hammer2_chain_t *copy);
1463
1464 void hammer2_chain_setcheck(hammer2_chain_t *chain, void *bdata);
1465 int hammer2_chain_testcheck(hammer2_chain_t *chain, void *bdata);
1466 int hammer2_chain_dirent_test(hammer2_chain_t *chain, const char *name,
1467                                 size_t name_len);
1468
1469 void hammer2_pfs_memory_wait(hammer2_pfs_t *pmp);
1470 void hammer2_pfs_memory_inc(hammer2_pfs_t *pmp);
1471 void hammer2_pfs_memory_wakeup(hammer2_pfs_t *pmp);
1472
1473 void hammer2_base_delete(hammer2_chain_t *chain,
1474                                 hammer2_blockref_t *base, int count,
1475                                 int *cache_indexp, hammer2_chain_t *child);
1476 void hammer2_base_insert(hammer2_chain_t *chain,
1477                                 hammer2_blockref_t *base, int count,
1478                                 int *cache_indexp, hammer2_chain_t *child);
1479
1480 /*
1481  * hammer2_flush.c
1482  */
1483 void hammer2_flush(hammer2_chain_t *chain, int istop);
1484 void hammer2_delayed_flush(hammer2_chain_t *chain);
1485
1486 /*
1487  * hammer2_trans.c
1488  */
1489 void hammer2_trans_init(hammer2_pfs_t *pmp, uint32_t flags);
1490 hammer2_tid_t hammer2_trans_sub(hammer2_pfs_t *pmp);
1491 void hammer2_trans_done(hammer2_pfs_t *pmp);
1492 hammer2_tid_t hammer2_trans_newinum(hammer2_pfs_t *pmp);
1493 void hammer2_trans_assert_strategy(hammer2_pfs_t *pmp);
1494 void hammer2_dedup_record(hammer2_chain_t *chain, hammer2_io_t *dio,
1495                                 char *data);
1496
1497 /*
1498  * hammer2_ioctl.c
1499  */
1500 int hammer2_ioctl(hammer2_inode_t *ip, u_long com, void *data,
1501                                 int fflag, struct ucred *cred);
1502
1503 /*
1504  * hammer2_io.c
1505  */
1506 void hammer2_io_putblk(hammer2_io_t **diop);
1507 void hammer2_io_inval(hammer2_io_t *dio, hammer2_off_t data_off, u_int bytes);
1508 void hammer2_io_cleanup(hammer2_dev_t *hmp, struct hammer2_io_tree *tree);
1509 char *hammer2_io_data(hammer2_io_t *dio, off_t lbase);
1510 hammer2_io_t *hammer2_io_getblk(hammer2_dev_t *hmp, int btype, off_t lbase,
1511                                 int lsize, int op);
1512 void hammer2_io_dedup_set(hammer2_dev_t *hmp, hammer2_blockref_t *bref);
1513 void hammer2_io_dedup_delete(hammer2_dev_t *hmp, uint8_t btype,
1514                                 hammer2_off_t data_off, u_int bytes);
1515 void hammer2_io_dedup_assert(hammer2_dev_t *hmp, hammer2_off_t data_off,
1516                                 u_int bytes);
1517 void hammer2_io_callback(struct bio *bio);
1518 int hammer2_io_new(hammer2_dev_t *hmp, int btype, off_t lbase, int lsize,
1519                                 hammer2_io_t **diop);
1520 int hammer2_io_newnz(hammer2_dev_t *hmp, int btype, off_t lbase, int lsize,
1521                                 hammer2_io_t **diop);
1522 int hammer2_io_bread(hammer2_dev_t *hmp, int btype, off_t lbase, int lsize,
1523                                 hammer2_io_t **diop);
1524 hammer2_io_t *hammer2_io_getquick(hammer2_dev_t *hmp, off_t lbase, int lsize);
1525 void hammer2_io_bawrite(hammer2_io_t **diop);
1526 void hammer2_io_bdwrite(hammer2_io_t **diop);
1527 int hammer2_io_bwrite(hammer2_io_t **diop);
1528 void hammer2_io_setdirty(hammer2_io_t *dio);
1529 void hammer2_io_brelse(hammer2_io_t **diop);
1530 void hammer2_io_bqrelse(hammer2_io_t **diop);
1531
1532 /*
1533  * hammer2_thread.c
1534  */
1535 void hammer2_thr_signal(hammer2_thread_t *thr, uint32_t flags);
1536 void hammer2_thr_signal2(hammer2_thread_t *thr,
1537                         uint32_t pflags, uint32_t nflags);
1538 void hammer2_thr_wait(hammer2_thread_t *thr, uint32_t flags);
1539 void hammer2_thr_wait_neg(hammer2_thread_t *thr, uint32_t flags);
1540 int hammer2_thr_wait_any(hammer2_thread_t *thr, uint32_t flags, int timo);
1541 void hammer2_thr_create(hammer2_thread_t *thr,
1542                         hammer2_pfs_t *pmp, hammer2_dev_t *hmp,
1543                         const char *id, int clindex, int repidx,
1544                         void (*func)(void *arg));
1545 void hammer2_thr_delete(hammer2_thread_t *thr);
1546 void hammer2_thr_remaster(hammer2_thread_t *thr);
1547 void hammer2_thr_freeze_async(hammer2_thread_t *thr);
1548 void hammer2_thr_freeze(hammer2_thread_t *thr);
1549 void hammer2_thr_unfreeze(hammer2_thread_t *thr);
1550 int hammer2_thr_break(hammer2_thread_t *thr);
1551 void hammer2_primary_xops_thread(void *arg);
1552
1553 /*
1554  * hammer2_thread.c (XOP API)
1555  */
1556 void hammer2_xop_group_init(hammer2_pfs_t *pmp, hammer2_xop_group_t *xgrp);
1557 void *hammer2_xop_alloc(hammer2_inode_t *ip, int flags);
1558 void hammer2_xop_setname(hammer2_xop_head_t *xop,
1559                                 const char *name, size_t name_len);
1560 void hammer2_xop_setname2(hammer2_xop_head_t *xop,
1561                                 const char *name, size_t name_len);
1562 size_t hammer2_xop_setname_inum(hammer2_xop_head_t *xop, hammer2_key_t inum);
1563 void hammer2_xop_setip2(hammer2_xop_head_t *xop, hammer2_inode_t *ip2);
1564 void hammer2_xop_setip3(hammer2_xop_head_t *xop, hammer2_inode_t *ip3);
1565 void hammer2_xop_reinit(hammer2_xop_head_t *xop);
1566 void hammer2_xop_helper_create(hammer2_pfs_t *pmp);
1567 void hammer2_xop_helper_cleanup(hammer2_pfs_t *pmp);
1568 void hammer2_xop_start(hammer2_xop_head_t *xop, hammer2_xop_func_t func);
1569 void hammer2_xop_start_except(hammer2_xop_head_t *xop, hammer2_xop_func_t func,
1570                                 int notidx);
1571 int hammer2_xop_collect(hammer2_xop_head_t *xop, int flags);
1572 void hammer2_xop_retire(hammer2_xop_head_t *xop, uint32_t mask);
1573 int hammer2_xop_active(hammer2_xop_head_t *xop);
1574 int hammer2_xop_feed(hammer2_xop_head_t *xop, hammer2_chain_t *chain,
1575                                 int clindex, int error);
1576
1577 /*
1578  * hammer2_synchro.c
1579  */
1580 void hammer2_primary_sync_thread(void *arg);
1581
1582 /*
1583  * XOP backends in hammer2_xops.c, primarily for VNOPS.  Other XOP backends
1584  * may be integrated into other source files.
1585  */
1586 void hammer2_xop_ipcluster(hammer2_thread_t *thr, hammer2_xop_t *xop);
1587 void hammer2_xop_readdir(hammer2_thread_t *thr, hammer2_xop_t *xop);
1588 void hammer2_xop_nresolve(hammer2_thread_t *thr, hammer2_xop_t *xop);
1589 void hammer2_xop_unlink(hammer2_thread_t *thr, hammer2_xop_t *xop);
1590 void hammer2_xop_nrename(hammer2_thread_t *thr, hammer2_xop_t *xop);
1591 void hammer2_xop_scanlhc(hammer2_thread_t *thr, hammer2_xop_t *xop);
1592 void hammer2_xop_scanall(hammer2_thread_t *thr, hammer2_xop_t *xop);
1593 void hammer2_xop_lookup(hammer2_thread_t *thr, hammer2_xop_t *xop);
1594 void hammer2_inode_xop_mkdirent(hammer2_thread_t *thr, hammer2_xop_t *xop);
1595 void hammer2_inode_xop_create(hammer2_thread_t *thr, hammer2_xop_t *xop);
1596 void hammer2_inode_xop_destroy(hammer2_thread_t *thr, hammer2_xop_t *xop);
1597 void hammer2_inode_xop_chain_sync(hammer2_thread_t *thr, hammer2_xop_t *xop);
1598 void hammer2_inode_xop_unlinkall(hammer2_thread_t *thr, hammer2_xop_t *xop);
1599 void hammer2_inode_xop_connect(hammer2_thread_t *thr, hammer2_xop_t *xop);
1600 void hammer2_inode_xop_flush(hammer2_thread_t *thr, hammer2_xop_t *xop);
1601
1602 /*
1603  * hammer2_msgops.c
1604  */
1605 int hammer2_msg_dbg_rcvmsg(kdmsg_msg_t *msg);
1606 int hammer2_msg_adhoc_input(kdmsg_msg_t *msg);
1607
1608 /*
1609  * hammer2_vfsops.c
1610  */
1611 void hammer2_volconf_update(hammer2_dev_t *hmp, int index);
1612 void hammer2_dump_chain(hammer2_chain_t *chain, int tab, int *countp, char pfx);
1613 int hammer2_vfs_sync(struct mount *mp, int waitflags);
1614 hammer2_pfs_t *hammer2_pfsalloc(hammer2_chain_t *chain,
1615                                 const hammer2_inode_data_t *ripdata,
1616                                 hammer2_tid_t modify_tid,
1617                                 hammer2_dev_t *force_local);
1618 void hammer2_pfsdealloc(hammer2_pfs_t *pmp, int clindex, int destroying);
1619 int hammer2_vfs_vget(struct mount *mp, struct vnode *dvp,
1620                                 ino_t ino, struct vnode **vpp);
1621
1622 void hammer2_lwinprog_ref(hammer2_pfs_t *pmp);
1623 void hammer2_lwinprog_drop(hammer2_pfs_t *pmp);
1624 void hammer2_lwinprog_wait(hammer2_pfs_t *pmp, int pipe);
1625
1626 /*
1627  * hammer2_freemap.c
1628  */
1629 int hammer2_freemap_alloc(hammer2_chain_t *chain, size_t bytes);
1630 void hammer2_freemap_adjust(hammer2_dev_t *hmp,
1631                                 hammer2_blockref_t *bref, int how);
1632
1633 /*
1634  * hammer2_cluster.c
1635  */
1636 uint8_t hammer2_cluster_type(hammer2_cluster_t *cluster);
1637 const hammer2_media_data_t *hammer2_cluster_rdata(hammer2_cluster_t *cluster);
1638 hammer2_media_data_t *hammer2_cluster_wdata(hammer2_cluster_t *cluster);
1639 hammer2_cluster_t *hammer2_cluster_from_chain(hammer2_chain_t *chain);
1640 void hammer2_cluster_bref(hammer2_cluster_t *cluster, hammer2_blockref_t *bref);
1641 hammer2_cluster_t *hammer2_cluster_alloc(hammer2_pfs_t *pmp,
1642                                 hammer2_blockref_t *bref);
1643 void hammer2_cluster_ref(hammer2_cluster_t *cluster);
1644 void hammer2_cluster_drop(hammer2_cluster_t *cluster);
1645 void hammer2_cluster_lock(hammer2_cluster_t *cluster, int how);
1646 int hammer2_cluster_check(hammer2_cluster_t *cluster, hammer2_key_t lokey,
1647                         int flags);
1648 void hammer2_cluster_resolve(hammer2_cluster_t *cluster);
1649 void hammer2_cluster_forcegood(hammer2_cluster_t *cluster);
1650 void hammer2_cluster_unlock(hammer2_cluster_t *cluster);
1651
1652 void hammer2_bulkfree_init(hammer2_dev_t *hmp);
1653 void hammer2_bulkfree_uninit(hammer2_dev_t *hmp);
1654 int hammer2_bulkfree_pass(hammer2_dev_t *hmp, hammer2_chain_t *vchain,
1655                         struct hammer2_ioc_bulkfree *bfi);
1656
1657 /*
1658  * hammer2_iocom.c
1659  */
1660 void hammer2_iocom_init(hammer2_dev_t *hmp);
1661 void hammer2_iocom_uninit(hammer2_dev_t *hmp);
1662 void hammer2_cluster_reconnect(hammer2_dev_t *hmp, struct file *fp);
1663
1664 /*
1665  * hammer2_strategy.c
1666  */
1667 int hammer2_vop_strategy(struct vop_strategy_args *ap);
1668 int hammer2_vop_bmap(struct vop_bmap_args *ap);
1669 void hammer2_write_thread(void *arg);
1670 void hammer2_bioq_sync(hammer2_pfs_t *pmp);
1671 void hammer2_dedup_clear(hammer2_dev_t *hmp);
1672
1673 #endif /* !_KERNEL */
1674 #endif /* !_VFS_HAMMER2_HAMMER2_H_ */