4 * The contents of this file are subject to the terms of the
5 * Common Development and Distribution License (the "License").
6 * You may not use this file except in compliance with the License.
8 * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
9 * or http://www.opensolaris.org/os/licensing.
10 * See the License for the specific language governing permissions
11 * and limitations under the License.
13 * When distributing Covered Code, include this CDDL HEADER in each
14 * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
15 * If applicable, add the following below this CDDL HEADER, with the
16 * fields enclosed by brackets "[]" replaced with your own identifying
17 * information: Portions Copyright [yyyy] [name of copyright owner]
22 * Copyright (c) 2005, 2010, Oracle and/or its affiliates. All rights reserved.
23 * Copyright (c) 2013, 2018 by Delphix. All rights reserved.
26 #ifndef _SYS_FS_ZFS_VFSOPS_H
27 #define _SYS_FS_ZFS_VFSOPS_H
29 #include <sys/dataset_kstats.h>
30 #include <sys/isa_defs.h>
31 #include <sys/types32.h>
36 #include <sys/rrwlock.h>
37 #include <sys/dsl_dataset.h>
38 #include <sys/zfs_ioctl.h>
39 #include <sys/objlist.h>
45 typedef struct zfsvfs zfsvfs_t;
49 * This structure emulates the vfs_t from other platforms. It's purpose
50 * is to facilitate the handling of mount options and minimize structural
51 * differences between the platforms.
54 struct zfsvfs *vfs_data;
55 char *vfs_mntpoint; /* Primary mount point */
57 boolean_t vfs_readonly;
58 boolean_t vfs_do_readonly;
60 boolean_t vfs_do_setuid;
62 boolean_t vfs_do_exec;
63 boolean_t vfs_devices;
64 boolean_t vfs_do_devices;
65 boolean_t vfs_do_xattr;
67 boolean_t vfs_do_atime;
68 boolean_t vfs_relatime;
69 boolean_t vfs_do_relatime;
71 boolean_t vfs_do_nbmand;
74 typedef struct zfs_mnt {
75 const char *mnt_osname; /* Objset name */
76 char *mnt_data; /* Raw mount options */
80 vfs_t *z_vfs; /* generic fs struct */
81 struct super_block *z_sb; /* generic super_block */
82 struct zfsvfs *z_parent; /* parent fs */
83 objset_t *z_os; /* objset reference */
84 uint64_t z_flags; /* super_block flags */
85 uint64_t z_root; /* id of root znode */
86 uint64_t z_unlinkedobj; /* id of unlinked zapobj */
87 uint64_t z_max_blksz; /* maximum block size for files */
88 uint64_t z_fuid_obj; /* fuid table object number */
89 uint64_t z_fuid_size; /* fuid table size */
90 avl_tree_t z_fuid_idx; /* fuid tree keyed by index */
91 avl_tree_t z_fuid_domain; /* fuid tree keyed by domain */
92 krwlock_t z_fuid_lock; /* fuid lock */
93 boolean_t z_fuid_loaded; /* fuid tables are loaded */
94 boolean_t z_fuid_dirty; /* need to sync fuid table ? */
95 struct zfs_fuid_info *z_fuid_replay; /* fuid info for replay */
96 zilog_t *z_log; /* intent log pointer */
97 uint_t z_acl_mode; /* acl chmod/mode behavior */
98 uint_t z_acl_inherit; /* acl inheritance behavior */
99 uint_t z_acl_type; /* type of ACL usable on this FS */
100 zfs_case_t z_case; /* case-sense */
101 boolean_t z_utf8; /* utf8-only */
102 int z_norm; /* normalization flags */
103 boolean_t z_relatime; /* enable relatime mount option */
104 boolean_t z_unmounted; /* unmounted */
105 rrmlock_t z_teardown_lock;
106 krwlock_t z_teardown_inactive_lock;
107 list_t z_all_znodes; /* all znodes in the fs */
108 uint64_t z_nr_znodes; /* number of znodes in the fs */
109 unsigned long z_rollback_time; /* last online rollback time */
110 unsigned long z_snap_defer_time; /* last snapshot unmount deferral */
111 kmutex_t z_znodes_lock; /* lock for z_all_znodes */
112 arc_prune_t *z_arc_prune; /* called by ARC to prune caches */
113 struct inode *z_ctldir; /* .zfs directory inode */
114 boolean_t z_show_ctldir; /* expose .zfs in the root dir */
115 boolean_t z_issnap; /* true if this is a snapshot */
116 boolean_t z_vscan; /* virus scan on/off */
117 boolean_t z_use_fuids; /* version allows fuids */
118 boolean_t z_replay; /* set during ZIL replay */
119 boolean_t z_use_sa; /* version allow system attributes */
120 boolean_t z_xattr_sa; /* allow xattrs to be stores as SA */
121 boolean_t z_draining; /* is true when drain is active */
122 boolean_t z_drain_cancel; /* signal the unlinked drain to stop */
123 uint64_t z_version; /* ZPL version */
124 uint64_t z_shares_dir; /* hidden shares dir */
125 dataset_kstats_t z_kstat; /* fs kstats */
127 uint64_t z_userquota_obj;
128 uint64_t z_groupquota_obj;
129 uint64_t z_userobjquota_obj;
130 uint64_t z_groupobjquota_obj;
131 uint64_t z_projectquota_obj;
132 uint64_t z_projectobjquota_obj;
133 uint64_t z_replay_eof; /* New end of file - replay only */
134 sa_attr_type_t *z_attr_table; /* SA attr mapping->id */
135 uint64_t z_hold_size; /* znode hold array size */
136 avl_tree_t *z_hold_trees; /* znode hold trees */
137 kmutex_t *z_hold_locks; /* znode hold locks */
138 taskqid_t z_drain_task; /* task id for the unlink drain task */
141 #define ZSB_XATTR 0x0001 /* Enable user xattrs */
144 * Allow a maximum number of links. While ZFS does not internally limit
145 * this the inode->i_nlink member is defined as an unsigned int. To be
146 * safe we use 2^31-1 as the limit.
148 #define ZFS_LINK_MAX ((1U << 31) - 1U)
151 * Normal filesystems (those not under .zfs/snapshot) have a total
152 * file ID size limited to 12 bytes (including the length field) due to
153 * NFSv2 protocol's limitation of 32 bytes for a filehandle. For historical
154 * reasons, this same limit is being imposed by the Solaris NFSv3 implementation
155 * (although the NFSv3 protocol actually permits a maximum of 64 bytes). It
156 * is not possible to expand beyond 12 bytes without abandoning support
159 * For normal filesystems, we partition up the available space as follows:
160 * 2 bytes fid length (required)
161 * 6 bytes object number (48 bits)
162 * 4 bytes generation number (32 bits)
164 * We reserve only 48 bits for the object number, as this is the limit
165 * currently defined and imposed by the DMU.
167 typedef struct zfid_short {
169 uint8_t zf_object[6]; /* obj[i] = obj >> (8 * i) */
170 uint8_t zf_gen[4]; /* gen[i] = gen >> (8 * i) */
174 * Filesystems under .zfs/snapshot have a total file ID size of 22 bytes
175 * (including the length field). This makes files under .zfs/snapshot
176 * accessible by NFSv3 and NFSv4, but not NFSv2.
178 * For files under .zfs/snapshot, we partition up the available space
180 * 2 bytes fid length (required)
181 * 6 bytes object number (48 bits)
182 * 4 bytes generation number (32 bits)
183 * 6 bytes objset id (48 bits)
184 * 4 bytes currently just zero (32 bits)
186 * We reserve only 48 bits for the object number and objset id, as these are
187 * the limits currently defined and imposed by the DMU.
189 typedef struct zfid_long {
191 uint8_t zf_setid[6]; /* obj[i] = obj >> (8 * i) */
192 uint8_t zf_setgen[4]; /* gen[i] = gen >> (8 * i) */
195 #define SHORT_FID_LEN (sizeof (zfid_short_t) - sizeof (uint16_t))
196 #define LONG_FID_LEN (sizeof (zfid_long_t) - sizeof (uint16_t))
198 extern void zfs_init(void);
199 extern void zfs_fini(void);
201 extern int zfs_suspend_fs(zfsvfs_t *zfsvfs);
202 extern int zfs_resume_fs(zfsvfs_t *zfsvfs, struct dsl_dataset *ds);
203 extern int zfs_end_fs(zfsvfs_t *zfsvfs, struct dsl_dataset *ds);
204 extern void zfs_exit_fs(zfsvfs_t *zfsvfs);
205 extern int zfs_set_version(zfsvfs_t *zfsvfs, uint64_t newvers);
206 extern int zfsvfs_create(const char *name, boolean_t readony, zfsvfs_t **zfvp);
207 extern int zfsvfs_create_impl(zfsvfs_t **zfvp, zfsvfs_t *zfsvfs, objset_t *os);
208 extern void zfsvfs_free(zfsvfs_t *zfsvfs);
209 extern int zfs_check_global_label(const char *dsname, const char *hexsl);
211 extern boolean_t zfs_is_readonly(zfsvfs_t *zfsvfs);
212 extern int zfs_domount(struct super_block *sb, zfs_mnt_t *zm, int silent);
213 extern void zfs_preumount(struct super_block *sb);
214 extern int zfs_umount(struct super_block *sb);
215 extern int zfs_remount(struct super_block *sb, int *flags, zfs_mnt_t *zm);
216 extern int zfs_statvfs(struct inode *ip, struct kstatfs *statp);
217 extern int zfs_vget(struct super_block *sb, struct inode **ipp, fid_t *fidp);
218 extern int zfs_prune(struct super_block *sb, unsigned long nr_to_scan,
220 extern int zfs_get_temporary_prop(dsl_dataset_t *ds, zfs_prop_t zfs_prop,
221 uint64_t *val, char *setpoint);
227 #endif /* _SYS_FS_ZFS_VFSOPS_H */