sys/cddl/contrib/opensolaris/uts/common/fs/zfs/sys/dmu_objset.h

   1 /*
   2  * CDDL HEADER START
   3  *
   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.
   7  *
   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.
  12  *
  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]
  18  *
  19  * CDDL HEADER END
  20  */
  21 /*
  22  * Copyright (c) 2005, 2010, Oracle and/or its affiliates. All rights reserved.
  23  * Copyright (c) 2012, 2017 by Delphix. All rights reserved.
  24  * Copyright (c) 2013 by Saso Kiselkov. All rights reserved.
  25  * Copyright (c) 2014 Spectra Logic Corporation, All rights reserved.
  26  * Copyright (c) 2014 Integros [integros.com]
  27  */
  28
  29 /* Portions Copyright 2010 Robert Milkowski */
  30
  31 #ifndef _SYS_DMU_OBJSET_H
  32 #define _SYS_DMU_OBJSET_H
  33
  34 #include <sys/spa.h>
  35 #include <sys/arc.h>
  36 #include <sys/txg.h>
  37 #include <sys/zfs_context.h>
  38 #include <sys/dnode.h>
  39 #include <sys/zio.h>
  40 #include <sys/zil.h>
  41 #include <sys/sa.h>
  42 #include <sys/zfs_ioctl.h>
  43
  44 #ifdef  __cplusplus
  45 extern "C" {
  46 #endif
  47
  48 extern krwlock_t os_lock;
  49
  50 struct dsl_pool;
  51 struct dsl_dataset;
  52 struct dmu_tx;
  53
  54 #define OBJSET_PHYS_SIZE 2048
  55 #define OBJSET_OLD_PHYS_SIZE 1024
  56
  57 #define OBJSET_BUF_HAS_USERUSED(buf) \
  58         (arc_buf_size(buf) > OBJSET_OLD_PHYS_SIZE)
  59
  60 #define OBJSET_FLAG_USERACCOUNTING_COMPLETE     (1ULL<<0)
  61
  62 typedef struct objset_phys {
  63         dnode_phys_t os_meta_dnode;
  64         zil_header_t os_zil_header;
  65         uint64_t os_type;
  66         uint64_t os_flags;
  67         char os_pad[OBJSET_PHYS_SIZE - sizeof (dnode_phys_t)*3 -
  68             sizeof (zil_header_t) - sizeof (uint64_t)*2];
  69         dnode_phys_t os_userused_dnode;
  70         dnode_phys_t os_groupused_dnode;
  71 } objset_phys_t;
  72
  73 #define OBJSET_PROP_UNINITIALIZED       ((uint64_t)-1)
  74 struct objset {
  75         /* Immutable: */
  76         struct dsl_dataset *os_dsl_dataset;
  77         spa_t *os_spa;
  78         arc_buf_t *os_phys_buf;
  79         objset_phys_t *os_phys;
  80         /*
  81          * The following "special" dnodes have no parent, are exempt
  82          * from dnode_move(), and are not recorded in os_dnodes, but they
  83          * root their descendents in this objset using handles anyway, so
  84          * that all access to dnodes from dbufs consistently uses handles.
  85          */
  86         dnode_handle_t os_meta_dnode;
  87         dnode_handle_t os_userused_dnode;
  88         dnode_handle_t os_groupused_dnode;
  89         zilog_t *os_zil;
  90
  91         list_node_t os_evicting_node;
  92
  93         /* can change, under dsl_dir's locks: */
  94         uint64_t os_dnodesize; /* default dnode size for new objects */
  95         enum zio_checksum os_checksum;
  96         enum zio_compress os_compress;
  97         uint8_t os_copies;
  98         enum zio_checksum os_dedup_checksum;
  99         boolean_t os_dedup_verify;
 100         zfs_logbias_op_t os_logbias;
 101         zfs_cache_type_t os_primary_cache;
 102         zfs_cache_type_t os_secondary_cache;
 103         zfs_sync_type_t os_sync;
 104         zfs_redundant_metadata_type_t os_redundant_metadata;
 105         int os_recordsize;
 106         /*
 107          * The next four values are used as a cache of whatever's on disk, and
 108          * are initialized the first time these properties are queried. Before
 109          * being initialized with their real values, their values are
 110          * OBJSET_PROP_UNINITIALIZED.
 111          */
 112         uint64_t os_version;
 113         uint64_t os_normalization;
 114         uint64_t os_utf8only;
 115         uint64_t os_casesensitivity;
 116
 117         /*
 118          * Pointer is constant; the blkptr it points to is protected by
 119          * os_dsl_dataset->ds_bp_rwlock
 120          */
 121         blkptr_t *os_rootbp;
 122
 123         /* no lock needed: */
 124         struct dmu_tx *os_synctx; /* XXX sketchy */
 125         zil_header_t os_zil_header;
 126         multilist_t *os_synced_dnodes;
 127         uint64_t os_flags;
 128         uint64_t os_freed_dnodes;
 129         boolean_t os_rescan_dnodes;
 130
 131         /* Protected by os_obj_lock */
 132         kmutex_t os_obj_lock;
 133         uint64_t os_obj_next;
 134
 135         /* Protected by os_lock */
 136         kmutex_t os_lock;
 137         multilist_t *os_dirty_dnodes[TXG_SIZE];
 138         list_t os_dnodes;
 139         list_t os_downgraded_dbufs;
 140
 141         /* Protects changes to DMU_{USER,GROUP}USED_OBJECT */
 142         kmutex_t os_userused_lock;
 143
 144         /* stuff we store for the user */
 145         kmutex_t os_user_ptr_lock;
 146         void *os_user_ptr;
 147         sa_os_t *os_sa;
 148 };
 149
 150 #define DMU_META_OBJSET         0
 151 #define DMU_META_DNODE_OBJECT   0
 152 #define DMU_OBJECT_IS_SPECIAL(obj) ((int64_t)(obj) <= 0)
 153 #define DMU_META_DNODE(os)      ((os)->os_meta_dnode.dnh_dnode)
 154 #define DMU_USERUSED_DNODE(os)  ((os)->os_userused_dnode.dnh_dnode)
 155 #define DMU_GROUPUSED_DNODE(os) ((os)->os_groupused_dnode.dnh_dnode)
 156
 157 #define DMU_OS_IS_L2CACHEABLE(os)                               \
 158         ((os)->os_secondary_cache == ZFS_CACHE_ALL ||           \
 159         (os)->os_secondary_cache == ZFS_CACHE_METADATA)
 160
 161 #define DMU_OS_IS_L2COMPRESSIBLE(os)    (zfs_mdcomp_disable == B_FALSE)
 162
 163 /* called from zpl */
 164 int dmu_objset_hold(const char *name, void *tag, objset_t **osp);
 165 int dmu_objset_own(const char *name, dmu_objset_type_t type,
 166     boolean_t readonly, void *tag, objset_t **osp);
 167 int dmu_objset_own_obj(struct dsl_pool *dp, uint64_t obj,
 168     dmu_objset_type_t type, boolean_t readonly, void *tag, objset_t **osp);
 169 void dmu_objset_refresh_ownership(struct dsl_dataset *ds,
 170     struct dsl_dataset **newds, void *tag);
 171 void dmu_objset_rele(objset_t *os, void *tag);
 172 void dmu_objset_disown(objset_t *os, void *tag);
 173 int dmu_objset_from_ds(struct dsl_dataset *ds, objset_t **osp);
 174
 175 void dmu_objset_stats(objset_t *os, nvlist_t *nv);
 176 void dmu_objset_fast_stat(objset_t *os, dmu_objset_stats_t *stat);
 177 void dmu_objset_space(objset_t *os, uint64_t *refdbytesp, uint64_t *availbytesp,
 178     uint64_t *usedobjsp, uint64_t *availobjsp);
 179 uint64_t dmu_objset_fsid_guid(objset_t *os);
 180 int dmu_objset_find_dp(struct dsl_pool *dp, uint64_t ddobj,
 181     int func(struct dsl_pool *, struct dsl_dataset *, void *),
 182     void *arg, int flags);
 183 int dmu_objset_prefetch(const char *name, void *arg);
 184 void dmu_objset_evict_dbufs(objset_t *os);
 185 timestruc_t dmu_objset_snap_cmtime(objset_t *os);
 186
 187 /* called from dsl */
 188 void dmu_objset_sync(objset_t *os, zio_t *zio, dmu_tx_t *tx);
 189 boolean_t dmu_objset_is_dirty(objset_t *os, uint64_t txg);
 190 objset_t *dmu_objset_create_impl(spa_t *spa, struct dsl_dataset *ds,
 191     blkptr_t *bp, dmu_objset_type_t type, dmu_tx_t *tx);
 192 int dmu_objset_open_impl(spa_t *spa, struct dsl_dataset *ds, blkptr_t *bp,
 193     objset_t **osp);
 194 void dmu_objset_evict(objset_t *os);
 195 void dmu_objset_do_userquota_updates(objset_t *os, dmu_tx_t *tx);
 196 void dmu_objset_userquota_get_ids(dnode_t *dn, boolean_t before, dmu_tx_t *tx);
 197 boolean_t dmu_objset_userused_enabled(objset_t *os);
 198 int dmu_objset_userspace_upgrade(objset_t *os);
 199 boolean_t dmu_objset_userspace_present(objset_t *os);
 200 int dmu_fsname(const char *snapname, char *buf);
 201
 202 void dmu_objset_evict_done(objset_t *os);
 203 void dmu_objset_willuse_space(objset_t *os, int64_t space, dmu_tx_t *tx);
 204
 205 void dmu_objset_init(void);
 206 void dmu_objset_fini(void);
 207
 208 #ifdef  __cplusplus
 209 }
 210 #endif
 211
 212 #endif /* _SYS_DMU_OBJSET_H */