1 /*- 2 * SPDX-License-Identifier: BSD-2-Clause 3 * 4 * Copyright (c) 2022 The FreeBSD Foundation 5 * 6 * This software was developed by Mark Johnston under sponsorship from 7 * the FreeBSD Foundation. 8 * 9 * Redistribution and use in source and binary forms, with or without 10 * modification, are permitted provided that the following conditions are 11 * met: 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 distribution. 17 * 18 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND 19 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 20 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 21 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE 22 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 23 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 24 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 25 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 26 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 27 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 28 * SUCH DAMAGE. 29 */ 30 31 #ifndef _MAKEFS_ZFS_H_ 32 #define _MAKEFS_ZFS_H_ 33 34 #include <sys/types.h> 35 #include <sys/endian.h> 36 #include <sys/queue.h> 37 38 #include <bitstring.h> 39 #include <stdalign.h> 40 #include <stdbool.h> 41 42 #include "makefs.h" 43 44 #include "zfs/nvlist.h" 45 #define ASSERT assert 46 #include "zfs/zfsimpl.h" 47 48 #define MAXBLOCKSHIFT 17 /* 128KB */ 49 #define MAXBLOCKSIZE ((off_t)(1 << MAXBLOCKSHIFT)) 50 _Static_assert(MAXBLOCKSIZE == SPA_OLDMAXBLOCKSIZE, ""); 51 #define MINBLOCKSHIFT 9 /* 512B */ 52 #define MINBLOCKSIZE ((off_t)(1 << MINBLOCKSHIFT)) 53 _Static_assert(MINBLOCKSIZE == SPA_MINBLOCKSIZE, ""); 54 #define MINDEVSIZE ((off_t)SPA_MINDEVSIZE) 55 56 /* All data was written in this transaction group. */ 57 #define TXG 4 58 59 typedef struct zfs_dsl_dataset zfs_dsl_dataset_t; 60 typedef struct zfs_dsl_dir zfs_dsl_dir_t; 61 typedef struct zfs_objset zfs_objset_t; 62 typedef struct zfs_zap zfs_zap_t; 63 64 struct dataset_desc { 65 char *params; 66 STAILQ_ENTRY(dataset_desc) next; 67 }; 68 69 typedef struct { 70 /* 71 * Block buffer, needs to be aligned for various on-disk structures, 72 * ZAPs, etc.. 73 */ 74 char filebuf[MAXBLOCKSIZE] __aligned(alignof(uint64_t)); 75 76 bool nowarn; 77 78 /* Pool parameters. */ 79 const char *poolname; 80 char *rootpath; /* implicit mount point prefix */ 81 char *bootfs; /* bootable dataset, pool property */ 82 int ashift; /* vdev block size */ 83 uint64_t mssize; /* metaslab size */ 84 STAILQ_HEAD(, dataset_desc) datasetdescs; /* non-root dataset descrs */ 85 86 /* Pool state. */ 87 uint64_t poolguid; /* pool and root vdev GUID */ 88 zfs_zap_t *poolprops; 89 90 /* MOS state. */ 91 zfs_objset_t *mos; /* meta object set */ 92 uint64_t objarrid; /* space map object array */ 93 94 /* DSL state. */ 95 zfs_dsl_dir_t *rootdsldir; /* root DSL directory */ 96 zfs_dsl_dataset_t *rootds; 97 zfs_dsl_dir_t *origindsldir; /* $ORIGIN */ 98 zfs_dsl_dataset_t *originds; 99 zfs_dsl_dataset_t *snapds; 100 zfs_zap_t *cloneszap; 101 zfs_dsl_dir_t *freedsldir; /* $FREE */ 102 zfs_dsl_dir_t *mosdsldir; /* $MOS */ 103 104 /* vdev state. */ 105 int fd; /* vdev disk fd */ 106 uint64_t vdevguid; /* disk vdev GUID */ 107 off_t vdevsize; /* vdev size, including labels */ 108 off_t asize; /* vdev size, excluding labels */ 109 bitstr_t *spacemap; /* space allocation tracking */ 110 int spacemapbits; /* one bit per ashift-sized block */ 111 uint64_t msshift; /* log2(metaslab size) */ 112 uint64_t mscount; /* number of metaslabs for this vdev */ 113 } zfs_opt_t; 114 115 /* dsl.c */ 116 void dsl_init(zfs_opt_t *); 117 const char *dsl_dir_fullname(const zfs_dsl_dir_t *); 118 uint64_t dsl_dir_id(zfs_dsl_dir_t *); 119 uint64_t dsl_dir_dataset_id(zfs_dsl_dir_t *); 120 void dsl_dir_foreach(zfs_opt_t *, zfs_dsl_dir_t *, 121 void (*)(zfs_opt_t *, zfs_dsl_dir_t *, void *), void *); 122 int dsl_dir_get_canmount(zfs_dsl_dir_t *, uint64_t *); 123 char *dsl_dir_get_mountpoint(zfs_opt_t *, zfs_dsl_dir_t *); 124 bool dsl_dir_has_dataset(zfs_dsl_dir_t *); 125 bool dsl_dir_dataset_has_objset(zfs_dsl_dir_t *); 126 void dsl_dir_dataset_write(zfs_opt_t *, zfs_objset_t *, zfs_dsl_dir_t *); 127 void dsl_dir_root_finalize(zfs_opt_t *, uint64_t); 128 void dsl_write(zfs_opt_t *); 129 130 /* fs.c */ 131 void fs_build(zfs_opt_t *, int, fsnode *); 132 133 /* objset.c */ 134 zfs_objset_t *objset_alloc(zfs_opt_t *zfs, uint64_t type); 135 off_t objset_space_alloc(zfs_opt_t *, zfs_objset_t *, off_t *); 136 dnode_phys_t *objset_dnode_alloc(zfs_objset_t *, uint8_t, uint64_t *); 137 dnode_phys_t *objset_dnode_bonus_alloc(zfs_objset_t *, uint8_t, uint8_t, 138 uint16_t, uint64_t *); 139 dnode_phys_t *objset_dnode_lookup(zfs_objset_t *, uint64_t); 140 void objset_root_blkptr_copy(const zfs_objset_t *, blkptr_t *); 141 uint64_t objset_space(const zfs_objset_t *); 142 void objset_write(zfs_opt_t *zfs, zfs_objset_t *os); 143 144 /* vdev.c */ 145 void vdev_init(zfs_opt_t *, const char *); 146 off_t vdev_space_alloc(zfs_opt_t *zfs, off_t *lenp); 147 void vdev_pwrite_data(zfs_opt_t *zfs, uint8_t datatype, uint8_t cksumtype, 148 uint8_t level, uint64_t fill, const void *data, off_t sz, off_t loc, 149 blkptr_t *bp); 150 void vdev_pwrite_dnode_indir(zfs_opt_t *zfs, dnode_phys_t *dnode, uint8_t level, 151 uint64_t fill, const void *data, off_t sz, off_t loc, blkptr_t *bp); 152 void vdev_pwrite_dnode_data(zfs_opt_t *zfs, dnode_phys_t *dnode, const void *data, 153 off_t sz, off_t loc); 154 void vdev_label_write(zfs_opt_t *zfs, int ind, const vdev_label_t *labelp); 155 void vdev_spacemap_write(zfs_opt_t *); 156 void vdev_fini(zfs_opt_t *zfs); 157 158 /* zap.c */ 159 zfs_zap_t *zap_alloc(zfs_objset_t *, dnode_phys_t *); 160 void zap_add(zfs_zap_t *, const char *, size_t, size_t, const uint8_t *); 161 void zap_add_uint64(zfs_zap_t *, const char *, uint64_t); 162 void zap_add_uint64_self(zfs_zap_t *, uint64_t); 163 void zap_add_string(zfs_zap_t *, const char *, const char *); 164 bool zap_entry_exists(zfs_zap_t *, const char *); 165 void zap_write(zfs_opt_t *, zfs_zap_t *); 166 167 /* zfs.c */ 168 struct dnode_cursor *dnode_cursor_init(zfs_opt_t *, zfs_objset_t *, 169 dnode_phys_t *, off_t, off_t); 170 blkptr_t *dnode_cursor_next(zfs_opt_t *, struct dnode_cursor *, off_t); 171 void dnode_cursor_finish(zfs_opt_t *, struct dnode_cursor *); 172 uint64_t randomguid(void); 173 174 #endif /* !_MAKEFS_ZFS_H_ */ 175