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 https://opensource.org/licenses/CDDL-1.0. 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 2010 Sun Microsystems, Inc. All rights reserved. 23 * Use is subject to license terms. 24 */ 25 /* 26 * Copyright (c) 2012, 2016 by Delphix. All rights reserved. 27 */ 28 29 #ifndef _SYS_DMU_TX_H 30 #define _SYS_DMU_TX_H 31 32 #include <sys/inttypes.h> 33 #include <sys/dmu.h> 34 #include <sys/txg.h> 35 #include <sys/zfs_refcount.h> 36 37 #ifdef __cplusplus 38 extern "C" { 39 #endif 40 41 struct dmu_buf_impl; 42 struct dmu_tx_hold; 43 struct dnode_link; 44 struct dsl_pool; 45 struct dnode; 46 struct dsl_dir; 47 48 struct dmu_tx { 49 /* 50 * No synchronization is needed because a tx can only be handled 51 * by one thread. 52 */ 53 list_t tx_holds; /* list of dmu_tx_hold_t */ 54 objset_t *tx_objset; 55 struct dsl_dir *tx_dir; 56 struct dsl_pool *tx_pool; 57 uint64_t tx_txg; 58 uint64_t tx_lastsnap_txg; 59 uint64_t tx_lasttried_txg; 60 txg_handle_t tx_txgh; 61 void *tx_tempreserve_cookie; 62 struct dmu_tx_hold *tx_needassign_txh; 63 64 /* list of dmu_tx_callback_t on this dmu_tx */ 65 list_t tx_callbacks; 66 67 /* placeholder for syncing context, doesn't need specific holds */ 68 boolean_t tx_anyobj; 69 70 /* transaction is marked as being a "net free" of space */ 71 boolean_t tx_netfree; 72 73 /* time this transaction was created */ 74 hrtime_t tx_start; 75 76 /* need to wait for sufficient dirty space */ 77 boolean_t tx_wait_dirty; 78 79 /* has this transaction already been delayed? */ 80 boolean_t tx_dirty_delayed; 81 82 int tx_err; 83 }; 84 85 enum dmu_tx_hold_type { 86 THT_NEWOBJECT, 87 THT_WRITE, 88 THT_BONUS, 89 THT_FREE, 90 THT_ZAP, 91 THT_SPACE, 92 THT_SPILL, 93 THT_CLONE, 94 THT_APPEND, 95 THT_NUMTYPES 96 }; 97 98 typedef struct dmu_tx_hold { 99 dmu_tx_t *txh_tx; 100 list_node_t txh_node; 101 struct dnode *txh_dnode; 102 zfs_refcount_t txh_space_towrite; 103 zfs_refcount_t txh_memory_tohold; 104 enum dmu_tx_hold_type txh_type; 105 uint64_t txh_arg1; 106 uint64_t txh_arg2; 107 } dmu_tx_hold_t; 108 109 typedef struct dmu_tx_callback { 110 list_node_t dcb_node; /* linked to tx_callbacks list */ 111 dmu_tx_callback_func_t *dcb_func; /* caller function pointer */ 112 void *dcb_data; /* caller private data */ 113 } dmu_tx_callback_t; 114 115 /* 116 * Used for dmu tx kstat. 117 */ 118 typedef struct dmu_tx_stats { 119 kstat_named_t dmu_tx_assigned; 120 kstat_named_t dmu_tx_delay; 121 kstat_named_t dmu_tx_error; 122 kstat_named_t dmu_tx_suspended; 123 kstat_named_t dmu_tx_group; 124 kstat_named_t dmu_tx_memory_reserve; 125 kstat_named_t dmu_tx_memory_reclaim; 126 kstat_named_t dmu_tx_dirty_throttle; 127 kstat_named_t dmu_tx_dirty_delay; 128 kstat_named_t dmu_tx_dirty_over_max; 129 kstat_named_t dmu_tx_dirty_frees_delay; 130 kstat_named_t dmu_tx_wrlog_delay; 131 kstat_named_t dmu_tx_quota; 132 } dmu_tx_stats_t; 133 134 extern dmu_tx_stats_t dmu_tx_stats; 135 136 #define DMU_TX_STAT_INCR(stat, val) \ 137 atomic_add_64(&dmu_tx_stats.stat.value.ui64, (val)); 138 #define DMU_TX_STAT_BUMP(stat) \ 139 DMU_TX_STAT_INCR(stat, 1); 140 141 /* 142 * These routines are defined in dmu.h, and are called by the user. 143 */ 144 dmu_tx_t *dmu_tx_create(objset_t *dd); 145 int dmu_tx_assign(dmu_tx_t *tx, uint64_t txg_how); 146 void dmu_tx_commit(dmu_tx_t *tx); 147 void dmu_tx_abort(dmu_tx_t *tx); 148 uint64_t dmu_tx_get_txg(dmu_tx_t *tx); 149 struct dsl_pool *dmu_tx_pool(dmu_tx_t *tx); 150 void dmu_tx_wait(dmu_tx_t *tx); 151 152 /* 153 * These routines are defined in dmu_spa.h, and are called by the SPA. 154 */ 155 extern dmu_tx_t *dmu_tx_create_assigned(struct dsl_pool *dp, uint64_t txg); 156 157 /* 158 * These routines are only called by the DMU. 159 */ 160 dmu_tx_t *dmu_tx_create_dd(dsl_dir_t *dd); 161 int dmu_tx_is_syncing(dmu_tx_t *tx); 162 int dmu_tx_private_ok(dmu_tx_t *tx); 163 void dmu_tx_add_new_object(dmu_tx_t *tx, dnode_t *dn); 164 void dmu_tx_dirty_buf(dmu_tx_t *tx, struct dmu_buf_impl *db); 165 void dmu_tx_hold_space(dmu_tx_t *tx, uint64_t space); 166 167 #ifdef ZFS_DEBUG 168 #define DMU_TX_DIRTY_BUF(tx, db) dmu_tx_dirty_buf(tx, db) 169 #else 170 #define DMU_TX_DIRTY_BUF(tx, db) 171 #endif 172 173 void dmu_tx_init(void); 174 void dmu_tx_fini(void); 175 176 #ifdef __cplusplus 177 } 178 #endif 179 180 #endif /* _SYS_DMU_TX_H */ 181