2 * Copyright (c) 2011-2012 The DragonFly Project. All rights reserved.
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>
8 * Redistribution and use in source and binary forms, with or without
9 * modification, are permitted provided that the following conditions
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
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.
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
37 * This header file contains structures used internally by the HAMMER2
38 * implementation. See hammer2_disk.h for on-disk structures.
41 #ifndef _VFS_HAMMER2_HAMMER2_H_
42 #define _VFS_HAMMER2_HAMMER2_H_
44 #include <sys/param.h>
45 #include <sys/types.h>
46 #include <sys/kernel.h>
48 #include <sys/systm.h>
50 #include <sys/malloc.h>
51 #include <sys/mount.h>
52 #include <sys/vnode.h>
54 #include <sys/mountctl.h>
57 #include <sys/globaldata.h>
58 #include <sys/lockf.h>
60 #include <sys/queue.h>
61 #include <sys/limits.h>
63 #include <sys/signal2.h>
66 #include "hammer2_disk.h"
67 #include "hammer2_mount.h"
68 #include "hammer2_ioctl.h"
73 struct hammer2_pfsmount;
76 * The chain structure tracks blockref recursions all the way to
77 * the root volume. These consist of indirect blocks, inodes,
78 * and eventually the volume header.
80 * The chain structure is embedded in the hammer2_mount, hammer2_inode,
81 * and other system memory structures. The chain structure typically
82 * implements the reference count and busy flag for the larger structure.
84 * It is always possible to track a chain element all the way back to the
85 * root by following the (parent) links. (index) is a type-dependent index
86 * in the parent indicating where in the parent the chain element resides.
88 * When a blockref is added or deleted the related chain element is marked
89 * modified and all of its parents are marked SUBMODIFIED (the parent
90 * recursion can stop once we hit a node that is already marked SUBMODIFIED).
91 * A deleted chain element must remain intact until synchronized against
94 * The blockref at (parent, index) is not adjusted until the modified chain
95 * element is flushed and unmarked. Until then the child's blockref may
96 * not match the blockref at (parent, index).
98 SPLAY_HEAD(hammer2_chain_splay, hammer2_chain);
100 struct hammer2_chain {
101 struct hammer2_blockref bref;
102 struct hammer2_chain *parent; /* return chain to root */
103 struct hammer2_chain_splay shead;
104 SPLAY_ENTRY(hammer2_chain) snode;
105 TAILQ_ENTRY(hammer2_chain) flush_node; /* flush deferral list */
107 struct hammer2_inode *ip;
108 struct hammer2_indblock *np;
109 struct hammer2_data *dp;
113 struct buf *bp; /* buffer cache (ro) */
114 hammer2_media_data_t *data; /* modified copy of data (rw) */
115 u_int bytes; /* physical size of data */
116 struct lock lk; /* lockmgr lock */
117 int index; /* index in parent */
119 u_int busy; /* soft-busy */
123 typedef struct hammer2_chain hammer2_chain_t;
125 int hammer2_chain_cmp(hammer2_chain_t *chain1, hammer2_chain_t *chain2);
126 SPLAY_PROTOTYPE(hammer2_chain_splay, hammer2_chain, snode, hammer2_chain_cmp);
128 #define HAMMER2_CHAIN_MODIFIED 0x00000001 /* active mods */
129 #define HAMMER2_CHAIN_DIRTYEMBED 0x00000002 /* inode embedded */
130 #define HAMMER2_CHAIN_DIRTYBP 0x00000004 /* dirty on unlock */
131 #define HAMMER2_CHAIN_SUBMODIFIED 0x00000008 /* 1+ subs modified */
132 #define HAMMER2_CHAIN_DELETED 0x00000010
133 #define HAMMER2_CHAIN_INITIAL 0x00000020 /* initial create */
134 #define HAMMER2_CHAIN_FLUSHED 0x00000040 /* flush on unlock */
135 #define HAMMER2_CHAIN_MOVED 0x00000080 /* moved */
136 #define HAMMER2_CHAIN_IOFLUSH 0x00000100 /* bawrite on put */
137 #define HAMMER2_CHAIN_DEFERRED 0x00000200 /* on a deferral list*/
138 #define HAMMER2_CHAIN_DESTROYED 0x00000400 /* destroying */
139 #define HAMMER2_CHAIN_MODIFIED_AUX 0x00000800 /* hmp->vchain only */
140 #define HAMMER2_CHAIN_MOUNTED 0x00001000 /* PFS is mounted */
143 * Flags passed to hammer2_chain_lookup() and hammer2_chain_next()
145 #define HAMMER2_LOOKUP_NOLOCK 0x00000001 /* ref only */
146 #define HAMMER2_LOOKUP_NODATA 0x00000002 /* data left NULL */
149 * Flags passed to hammer2_chain_modify() and hammer2_chain_resize()
151 * NOTE: OPTDATA allows us to avoid instantiating buffers for INDIRECT
152 * blocks in the INITIAL-create state.
154 #define HAMMER2_MODIFY_NOSUB 0x00000001 /* do not set SUBMOD */
155 #define HAMMER2_MODIFY_OPTDATA 0x00000002 /* data can be NULL */
158 * Flags passed to hammer2_chain_lock()
160 #define HAMMER2_RESOLVE_NEVER 1
161 #define HAMMER2_RESOLVE_MAYBE 2
162 #define HAMMER2_RESOLVE_ALWAYS 3
165 * Cluster different types of storage together for allocations
167 #define HAMMER2_FREECACHE_INODE 0
168 #define HAMMER2_FREECACHE_INDIR 1
169 #define HAMMER2_FREECACHE_DATA 2
170 #define HAMMER2_FREECACHE_UNUSED3 3
171 #define HAMMER2_FREECACHE_TYPES 4
174 * BMAP read-ahead maximum parameters
176 #define HAMMER2_BMAP_COUNT 16 /* max bmap read-ahead */
177 #define HAMMER2_BMAP_BYTES (HAMMER2_PBUFSIZE * HAMMER2_BMAP_COUNT)
182 #define HAMMER2_FLUSH_DEPTH_LIMIT 40 /* stack recursion limit */
185 * HAMMER2 IN-MEMORY CACHE OF MEDIA STRUCTURES
187 * There is an in-memory representation of all on-media data structure.
189 * When accessed read-only the data will be mapped to the related buffer
192 * When accessed read-write (marked modified) a kmalloc()'d copy of the
193 * is created which can then be modified. The copy is destroyed when a
194 * filesystem block is allocated to replace it.
196 * Active inodes (those with vnodes attached) will maintain the kmalloc()'d
197 * copy for both the read-only and the read-write case. The combination of
198 * (bp) and (data) determines whether (data) was allocated or not.
200 * The in-memory representation may remain cached (for example in order to
201 * placemark clustering locks) even after the related data has been
208 struct hammer2_inode {
209 struct hammer2_mount *hmp; /* Global mount */
210 struct hammer2_pfsmount *pmp; /* PFS mount */
211 struct hammer2_inode *pip; /* parent inode */
213 hammer2_chain_t chain;
214 struct hammer2_inode_data ip_data;
215 struct lockf advlock;
218 typedef struct hammer2_inode hammer2_inode_t;
221 * A hammer2 indirect block
223 struct hammer2_indblock {
224 hammer2_chain_t chain;
227 typedef struct hammer2_indblock hammer2_indblock_t;
230 * A hammer2 data block
232 struct hammer2_data {
233 hammer2_chain_t chain;
236 typedef struct hammer2_data hammer2_data_t;
239 * Global (per device) mount structure for device (aka vp->v_mount->hmp)
241 struct hammer2_mount {
242 struct vnode *devvp; /* device vnode */
243 int ronly; /* read-only mount */
244 int pmp_count; /* PFS mounts backed by us */
245 TAILQ_ENTRY(hammer2_mount) mntentry; /* hammer2_mntlist */
247 struct malloc_type *minode;
251 struct malloc_type *mchain;
254 hammer2_chain_t vchain; /* anchor chain */
255 hammer2_chain_t *schain; /* super-root */
256 struct lock alloclk; /* lockmgr lock */
257 struct lock voldatalk; /* lockmgr lock */
259 hammer2_volume_data_t voldata;
260 hammer2_off_t freecache[HAMMER2_FREECACHE_TYPES][HAMMER2_MAX_RADIX+1];
263 typedef struct hammer2_mount hammer2_mount_t;
266 * Per-PFS mount structure for device (aka vp->v_mount)
268 struct hammer2_pfsmount {
269 struct mount *mp; /* kernel mount */
270 struct hammer2_mount *hmp; /* device global mount */
271 hammer2_chain_t *rchain; /* PFS root chain */
272 hammer2_inode_t *iroot; /* PFS root inode */
273 struct netexport export; /* nfs export */
274 int ronly; /* read-only mount */
277 typedef struct hammer2_pfsmount hammer2_pfsmount_t;
281 MALLOC_DECLARE(M_HAMMER2);
283 #define VTOI(vp) ((hammer2_inode_t *)(vp)->v_data)
284 #define ITOV(ip) ((ip)->vp)
288 MPTOPMP(struct mount *mp)
290 return ((hammer2_pfsmount_t *)mp->mnt_data);
295 MPTOHMP(struct mount *mp)
297 return (((hammer2_pfsmount_t *)mp->mnt_data)->hmp);
300 extern struct vop_ops hammer2_vnode_vops;
301 extern struct vop_ops hammer2_spec_vops;
302 extern struct vop_ops hammer2_fifo_vops;
304 extern int hammer2_debug;
305 extern int hammer2_cluster_enable;
306 extern long hammer2_iod_file_read;
307 extern long hammer2_iod_meta_read;
308 extern long hammer2_iod_indr_read;
309 extern long hammer2_iod_file_write;
310 extern long hammer2_iod_meta_write;
311 extern long hammer2_iod_indr_write;
312 extern long hammer2_iod_volu_write;
313 extern long hammer2_ioa_file_read;
314 extern long hammer2_ioa_meta_read;
315 extern long hammer2_ioa_indr_read;
316 extern long hammer2_ioa_file_write;
317 extern long hammer2_ioa_meta_write;
318 extern long hammer2_ioa_indr_write;
319 extern long hammer2_ioa_volu_write;
324 void hammer2_inode_lock_ex(hammer2_inode_t *ip);
325 void hammer2_inode_unlock_ex(hammer2_inode_t *ip);
326 void hammer2_inode_lock_sh(hammer2_inode_t *ip);
327 void hammer2_inode_unlock_sh(hammer2_inode_t *ip);
328 void hammer2_inode_busy(hammer2_inode_t *ip);
329 void hammer2_inode_unbusy(hammer2_inode_t *ip);
330 void hammer2_voldata_lock(hammer2_mount_t *hmp);
331 void hammer2_voldata_unlock(hammer2_mount_t *hmp);
333 void hammer2_mount_exlock(hammer2_mount_t *hmp);
334 void hammer2_mount_shlock(hammer2_mount_t *hmp);
335 void hammer2_mount_unlock(hammer2_mount_t *hmp);
337 int hammer2_get_dtype(hammer2_inode_t *ip);
338 int hammer2_get_vtype(hammer2_inode_t *ip);
339 u_int8_t hammer2_get_obj_type(enum vtype vtype);
340 void hammer2_time_to_timespec(u_int64_t xtime, struct timespec *ts);
341 u_int32_t hammer2_to_unix_xid(uuid_t *uuid);
343 hammer2_key_t hammer2_dirhash(const unsigned char *name, size_t len);
344 int hammer2_bytes_to_radix(size_t bytes);
346 int hammer2_calc_logical(hammer2_inode_t *ip, hammer2_off_t uoff,
347 hammer2_key_t *lbasep, hammer2_key_t *leofp);
352 struct vnode *hammer2_igetv(hammer2_inode_t *ip, int *errorp);
354 hammer2_inode_t *hammer2_inode_alloc(hammer2_pfsmount_t *pmp, void *data);
355 void hammer2_inode_free(hammer2_inode_t *ip);
356 void hammer2_inode_ref(hammer2_inode_t *ip);
357 void hammer2_inode_drop(hammer2_inode_t *ip);
358 int hammer2_inode_calc_alloc(hammer2_key_t filesize);
360 int hammer2_inode_create(hammer2_inode_t *dip,
361 struct vattr *vap, struct ucred *cred,
362 const uint8_t *name, size_t name_len,
363 hammer2_inode_t **nipp);
365 int hammer2_inode_connect(hammer2_inode_t *dip, hammer2_inode_t *nip,
366 const uint8_t *name, size_t name_len);
368 int hammer2_hardlink_create(hammer2_inode_t *ip, hammer2_inode_t *dip,
369 const uint8_t *name, size_t name_len);
371 int hammer2_unlink_file(hammer2_inode_t *dip,
372 const uint8_t *name, size_t name_len,
373 int isdir, int adjlinks);
378 void hammer2_modify_volume(hammer2_mount_t *hmp);
379 hammer2_chain_t *hammer2_chain_alloc(hammer2_mount_t *hmp,
380 hammer2_blockref_t *bref);
381 void hammer2_chain_free(hammer2_mount_t *hmp, hammer2_chain_t *chain);
382 void hammer2_chain_ref(hammer2_mount_t *hmp, hammer2_chain_t *chain);
383 void hammer2_chain_drop(hammer2_mount_t *hmp, hammer2_chain_t *chain);
384 int hammer2_chain_lock(hammer2_mount_t *hmp, hammer2_chain_t *chain, int how);
385 void hammer2_chain_moved(hammer2_mount_t *hmp, hammer2_chain_t *chain);
386 void hammer2_chain_modify(hammer2_mount_t *hmp, hammer2_chain_t *chain,
388 void hammer2_chain_resize(hammer2_mount_t *hmp, hammer2_chain_t *chain,
389 int nradix, int flags);
390 void hammer2_chain_unlock(hammer2_mount_t *hmp, hammer2_chain_t *chain);
391 hammer2_chain_t *hammer2_chain_find(hammer2_mount_t *hmp,
392 hammer2_chain_t *parent, int index);
393 hammer2_chain_t *hammer2_chain_get(hammer2_mount_t *hmp,
394 hammer2_chain_t *parent,
395 int index, int flags);
396 hammer2_chain_t *hammer2_chain_lookup(hammer2_mount_t *hmp,
397 hammer2_chain_t **parentp,
398 hammer2_key_t key_beg, hammer2_key_t key_end,
400 hammer2_chain_t *hammer2_chain_next(hammer2_mount_t *hmp,
401 hammer2_chain_t **parentp,
402 hammer2_chain_t *chain,
403 hammer2_key_t key_beg, hammer2_key_t key_end,
405 hammer2_chain_t *hammer2_chain_create(hammer2_mount_t *hmp,
406 hammer2_chain_t *parent,
407 hammer2_chain_t *chain,
408 hammer2_key_t key, int keybits,
409 int type, size_t bytes);
410 void hammer2_chain_delete(hammer2_mount_t *hmp, hammer2_chain_t *parent,
411 hammer2_chain_t *chain);
412 void hammer2_chain_flush(hammer2_mount_t *hmp, hammer2_chain_t *chain);
413 void hammer2_chain_commit(hammer2_mount_t *hmp, hammer2_chain_t *chain);
418 int hammer2_ioctl(hammer2_inode_t *ip, u_long com, void *data,
419 int fflag, struct ucred *cred);
424 hammer2_off_t hammer2_freemap_alloc(hammer2_mount_t *hmp,
425 int type, size_t bytes);
427 #endif /* !_KERNEL */
428 #endif /* !_VFS_HAMMER2_HAMMER2_H_ */