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, 2015 by Delphix. All rights reserved. 24 * Copyright (c) 2014 Integros [integros.com] 25 * Copyright 2016 Nexenta Systems, Inc. All rights reserved. 26 */ 27 28 #ifndef _FREEBSD_ZFS_SYS_ZNODE_IMPL_H 29 #define _FREEBSD_ZFS_SYS_ZNODE_IMPL_H 30 31 #include <sys/list.h> 32 #include <sys/dmu.h> 33 #include <sys/sa.h> 34 #include <sys/zfs_vfsops.h> 35 #include <sys/rrwlock.h> 36 #include <sys/zfs_sa.h> 37 #include <sys/zfs_stat.h> 38 #include <sys/zfs_rlock.h> 39 #include <sys/zfs_acl.h> 40 #include <sys/zil.h> 41 #include <sys/zfs_project.h> 42 #include <vm/vm_object.h> 43 44 #ifdef __cplusplus 45 extern "C" { 46 #endif 47 48 /* 49 * Directory entry locks control access to directory entries. 50 * They are used to protect creates, deletes, and renames. 51 * Each directory znode has a mutex and a list of locked names. 52 */ 53 #define ZNODE_OS_FIELDS \ 54 struct zfsvfs *z_zfsvfs; \ 55 vnode_t *z_vnode; \ 56 char *z_cached_symlink; \ 57 uint64_t z_uid; \ 58 uint64_t z_gid; \ 59 uint64_t z_gen; \ 60 uint64_t z_atime[2]; \ 61 uint64_t z_links; 62 63 #define ZFS_LINK_MAX UINT64_MAX 64 65 /* 66 * ZFS minor numbers can refer to either a control device instance or 67 * a zvol. Depending on the value of zss_type, zss_data points to either 68 * a zvol_state_t or a zfs_onexit_t. 69 */ 70 enum zfs_soft_state_type { 71 ZSST_ZVOL, 72 ZSST_CTLDEV 73 }; 74 75 typedef struct zfs_soft_state { 76 enum zfs_soft_state_type zss_type; 77 void *zss_data; 78 } zfs_soft_state_t; 79 80 extern minor_t zfsdev_minor_alloc(void); 81 82 /* 83 * Range locking rules 84 * -------------------- 85 * 1. When truncating a file (zfs_create, zfs_setattr, zfs_space) the whole 86 * file range needs to be locked as RL_WRITER. Only then can the pages be 87 * freed etc and zp_size reset. zp_size must be set within range lock. 88 * 2. For writes and punching holes (zfs_write & zfs_space) just the range 89 * being written or freed needs to be locked as RL_WRITER. 90 * Multiple writes at the end of the file must coordinate zp_size updates 91 * to ensure data isn't lost. A compare and swap loop is currently used 92 * to ensure the file size is at least the offset last written. 93 * 3. For reads (zfs_read, zfs_get_data & zfs_putapage) just the range being 94 * read needs to be locked as RL_READER. A check against zp_size can then 95 * be made for reading beyond end of file. 96 */ 97 98 /* 99 * Convert between znode pointers and vnode pointers 100 */ 101 #define ZTOV(ZP) ((ZP)->z_vnode) 102 #define ZTOI(ZP) ((ZP)->z_vnode) 103 #define VTOZ(VP) ((struct znode *)(VP)->v_data) 104 #define VTOZ_SMR(VP) ((znode_t *)vn_load_v_data_smr(VP)) 105 #define ITOZ(VP) ((struct znode *)(VP)->v_data) 106 #define zhold(zp) vhold(ZTOV((zp))) 107 #define zrele(zp) vrele(ZTOV((zp))) 108 109 #define ZTOZSB(zp) ((zp)->z_zfsvfs) 110 #define ITOZSB(vp) (VTOZ(vp)->z_zfsvfs) 111 #define ZTOTYPE(zp) (ZTOV(zp)->v_type) 112 #define ZTOGID(zp) ((zp)->z_gid) 113 #define ZTOUID(zp) ((zp)->z_uid) 114 #define ZTONLNK(zp) ((zp)->z_links) 115 #define Z_ISBLK(type) ((type) == VBLK) 116 #define Z_ISCHR(type) ((type) == VCHR) 117 #define Z_ISLNK(type) ((type) == VLNK) 118 #define Z_ISDIR(type) ((type) == VDIR) 119 120 #define zn_has_cached_data(zp) vn_has_cached_data(ZTOV(zp)) 121 #define zn_rlimit_fsize(zp, uio, td) vn_rlimit_fsize(ZTOV(zp), (uio), (td)) 122 123 /* Called on entry to each ZFS vnode and vfs operation */ 124 #define ZFS_ENTER(zfsvfs) \ 125 { \ 126 ZFS_TEARDOWN_ENTER_READ((zfsvfs), FTAG); \ 127 if (__predict_false((zfsvfs)->z_unmounted)) { \ 128 ZFS_TEARDOWN_EXIT_READ(zfsvfs, FTAG); \ 129 return (EIO); \ 130 } \ 131 } 132 133 /* Must be called before exiting the vop */ 134 #define ZFS_EXIT(zfsvfs) ZFS_TEARDOWN_EXIT_READ(zfsvfs, FTAG) 135 136 /* Verifies the znode is valid */ 137 #define ZFS_VERIFY_ZP(zp) \ 138 if (__predict_false((zp)->z_sa_hdl == NULL)) { \ 139 ZFS_EXIT((zp)->z_zfsvfs); \ 140 return (EIO); \ 141 } \ 142 143 /* 144 * Macros for dealing with dmu_buf_hold 145 */ 146 #define ZFS_OBJ_HASH(obj_num) ((obj_num) & (ZFS_OBJ_MTX_SZ - 1)) 147 #define ZFS_OBJ_MUTEX(zfsvfs, obj_num) \ 148 (&(zfsvfs)->z_hold_mtx[ZFS_OBJ_HASH(obj_num)]) 149 #define ZFS_OBJ_HOLD_ENTER(zfsvfs, obj_num) \ 150 mutex_enter(ZFS_OBJ_MUTEX((zfsvfs), (obj_num))) 151 #define ZFS_OBJ_HOLD_TRYENTER(zfsvfs, obj_num) \ 152 mutex_tryenter(ZFS_OBJ_MUTEX((zfsvfs), (obj_num))) 153 #define ZFS_OBJ_HOLD_EXIT(zfsvfs, obj_num) \ 154 mutex_exit(ZFS_OBJ_MUTEX((zfsvfs), (obj_num))) 155 156 /* Encode ZFS stored time values from a struct timespec */ 157 #define ZFS_TIME_ENCODE(tp, stmp) \ 158 { \ 159 (stmp)[0] = (uint64_t)(tp)->tv_sec; \ 160 (stmp)[1] = (uint64_t)(tp)->tv_nsec; \ 161 } 162 163 /* Decode ZFS stored time values to a struct timespec */ 164 #define ZFS_TIME_DECODE(tp, stmp) \ 165 { \ 166 (tp)->tv_sec = (time_t)(stmp)[0]; \ 167 (tp)->tv_nsec = (long)(stmp)[1]; \ 168 } 169 #define ZFS_ACCESSTIME_STAMP(zfsvfs, zp) \ 170 if ((zfsvfs)->z_atime && !((zfsvfs)->z_vfs->vfs_flag & VFS_RDONLY)) \ 171 zfs_tstamp_update_setup_ext(zp, ACCESSED, NULL, NULL, B_FALSE); 172 173 extern void zfs_tstamp_update_setup_ext(struct znode *, 174 uint_t, uint64_t [2], uint64_t [2], boolean_t have_tx); 175 extern void zfs_znode_free(struct znode *); 176 177 extern zil_replay_func_t *zfs_replay_vector[TX_MAX_TYPE]; 178 extern int zfsfstype; 179 180 extern int zfs_znode_parent_and_name(struct znode *zp, struct znode **dzpp, 181 char *buf); 182 extern void zfs_inode_update(struct znode *); 183 #ifdef __cplusplus 184 } 185 #endif 186 187 #endif /* _FREEBSD_SYS_FS_ZFS_ZNODE_H */ 188