]>
Commit | Line | Data |
---|---|---|
34dc7c2f BB |
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 | /* | |
d164b209 | 22 | * Copyright 2009 Sun Microsystems, Inc. All rights reserved. |
34dc7c2f BB |
23 | * Use is subject to license terms. |
24 | */ | |
25 | ||
26 | #ifndef _SYS_SPA_H | |
27 | #define _SYS_SPA_H | |
28 | ||
34dc7c2f BB |
29 | #include <sys/avl.h> |
30 | #include <sys/zfs_context.h> | |
31 | #include <sys/nvpair.h> | |
32 | #include <sys/sysmacros.h> | |
33 | #include <sys/types.h> | |
34 | #include <sys/fs/zfs.h> | |
35 | ||
36 | #ifdef __cplusplus | |
37 | extern "C" { | |
38 | #endif | |
39 | ||
40 | /* | |
41 | * Forward references that lots of things need. | |
42 | */ | |
43 | typedef struct spa spa_t; | |
44 | typedef struct vdev vdev_t; | |
45 | typedef struct metaslab metaslab_t; | |
46 | typedef struct zilog zilog_t; | |
34dc7c2f BB |
47 | typedef struct spa_aux_vdev spa_aux_vdev_t; |
48 | struct dsl_pool; | |
49 | ||
50 | /* | |
51 | * General-purpose 32-bit and 64-bit bitfield encodings. | |
52 | */ | |
53 | #define BF32_DECODE(x, low, len) P2PHASE((x) >> (low), 1U << (len)) | |
54 | #define BF64_DECODE(x, low, len) P2PHASE((x) >> (low), 1ULL << (len)) | |
55 | #define BF32_ENCODE(x, low, len) (P2PHASE((x), 1U << (len)) << (low)) | |
56 | #define BF64_ENCODE(x, low, len) (P2PHASE((x), 1ULL << (len)) << (low)) | |
57 | ||
58 | #define BF32_GET(x, low, len) BF32_DECODE(x, low, len) | |
59 | #define BF64_GET(x, low, len) BF64_DECODE(x, low, len) | |
60 | ||
61 | #define BF32_SET(x, low, len, val) \ | |
62 | ((x) ^= BF32_ENCODE((x >> low) ^ (val), low, len)) | |
63 | #define BF64_SET(x, low, len, val) \ | |
64 | ((x) ^= BF64_ENCODE((x >> low) ^ (val), low, len)) | |
65 | ||
66 | #define BF32_GET_SB(x, low, len, shift, bias) \ | |
67 | ((BF32_GET(x, low, len) + (bias)) << (shift)) | |
68 | #define BF64_GET_SB(x, low, len, shift, bias) \ | |
69 | ((BF64_GET(x, low, len) + (bias)) << (shift)) | |
70 | ||
71 | #define BF32_SET_SB(x, low, len, shift, bias, val) \ | |
72 | BF32_SET(x, low, len, ((val) >> (shift)) - (bias)) | |
73 | #define BF64_SET_SB(x, low, len, shift, bias, val) \ | |
74 | BF64_SET(x, low, len, ((val) >> (shift)) - (bias)) | |
75 | ||
76 | /* | |
77 | * We currently support nine block sizes, from 512 bytes to 128K. | |
78 | * We could go higher, but the benefits are near-zero and the cost | |
79 | * of COWing a giant block to modify one byte would become excessive. | |
80 | */ | |
81 | #define SPA_MINBLOCKSHIFT 9 | |
82 | #define SPA_MAXBLOCKSHIFT 17 | |
83 | #define SPA_MINBLOCKSIZE (1ULL << SPA_MINBLOCKSHIFT) | |
84 | #define SPA_MAXBLOCKSIZE (1ULL << SPA_MAXBLOCKSHIFT) | |
85 | ||
86 | #define SPA_BLOCKSIZES (SPA_MAXBLOCKSHIFT - SPA_MINBLOCKSHIFT + 1) | |
87 | ||
b128c09f BB |
88 | /* |
89 | * Size of block to hold the configuration data (a packed nvlist) | |
90 | */ | |
91 | #define SPA_CONFIG_BLOCKSIZE (1 << 14) | |
92 | ||
34dc7c2f BB |
93 | /* |
94 | * The DVA size encodings for LSIZE and PSIZE support blocks up to 32MB. | |
95 | * The ASIZE encoding should be at least 64 times larger (6 more bits) | |
96 | * to support up to 4-way RAID-Z mirror mode with worst-case gang block | |
97 | * overhead, three DVAs per bp, plus one more bit in case we do anything | |
98 | * else that expands the ASIZE. | |
99 | */ | |
100 | #define SPA_LSIZEBITS 16 /* LSIZE up to 32M (2^16 * 512) */ | |
101 | #define SPA_PSIZEBITS 16 /* PSIZE up to 32M (2^16 * 512) */ | |
102 | #define SPA_ASIZEBITS 24 /* ASIZE up to 64 times larger */ | |
103 | ||
104 | /* | |
105 | * All SPA data is represented by 128-bit data virtual addresses (DVAs). | |
106 | * The members of the dva_t should be considered opaque outside the SPA. | |
107 | */ | |
108 | typedef struct dva { | |
109 | uint64_t dva_word[2]; | |
110 | } dva_t; | |
111 | ||
112 | /* | |
113 | * Each block has a 256-bit checksum -- strong enough for cryptographic hashes. | |
114 | */ | |
115 | typedef struct zio_cksum { | |
116 | uint64_t zc_word[4]; | |
117 | } zio_cksum_t; | |
118 | ||
119 | /* | |
120 | * Each block is described by its DVAs, time of birth, checksum, etc. | |
121 | * The word-by-word, bit-by-bit layout of the blkptr is as follows: | |
122 | * | |
123 | * 64 56 48 40 32 24 16 8 0 | |
124 | * +-------+-------+-------+-------+-------+-------+-------+-------+ | |
125 | * 0 | vdev1 | GRID | ASIZE | | |
126 | * +-------+-------+-------+-------+-------+-------+-------+-------+ | |
127 | * 1 |G| offset1 | | |
128 | * +-------+-------+-------+-------+-------+-------+-------+-------+ | |
129 | * 2 | vdev2 | GRID | ASIZE | | |
130 | * +-------+-------+-------+-------+-------+-------+-------+-------+ | |
131 | * 3 |G| offset2 | | |
132 | * +-------+-------+-------+-------+-------+-------+-------+-------+ | |
133 | * 4 | vdev3 | GRID | ASIZE | | |
134 | * +-------+-------+-------+-------+-------+-------+-------+-------+ | |
135 | * 5 |G| offset3 | | |
136 | * +-------+-------+-------+-------+-------+-------+-------+-------+ | |
137 | * 6 |E| lvl | type | cksum | comp | PSIZE | LSIZE | | |
138 | * +-------+-------+-------+-------+-------+-------+-------+-------+ | |
139 | * 7 | padding | | |
140 | * +-------+-------+-------+-------+-------+-------+-------+-------+ | |
141 | * 8 | padding | | |
142 | * +-------+-------+-------+-------+-------+-------+-------+-------+ | |
143 | * 9 | padding | | |
144 | * +-------+-------+-------+-------+-------+-------+-------+-------+ | |
145 | * a | birth txg | | |
146 | * +-------+-------+-------+-------+-------+-------+-------+-------+ | |
147 | * b | fill count | | |
148 | * +-------+-------+-------+-------+-------+-------+-------+-------+ | |
149 | * c | checksum[0] | | |
150 | * +-------+-------+-------+-------+-------+-------+-------+-------+ | |
151 | * d | checksum[1] | | |
152 | * +-------+-------+-------+-------+-------+-------+-------+-------+ | |
153 | * e | checksum[2] | | |
154 | * +-------+-------+-------+-------+-------+-------+-------+-------+ | |
155 | * f | checksum[3] | | |
156 | * +-------+-------+-------+-------+-------+-------+-------+-------+ | |
157 | * | |
158 | * Legend: | |
159 | * | |
160 | * vdev virtual device ID | |
161 | * offset offset into virtual device | |
162 | * LSIZE logical size | |
163 | * PSIZE physical size (after compression) | |
164 | * ASIZE allocated size (including RAID-Z parity and gang block headers) | |
165 | * GRID RAID-Z layout information (reserved for future use) | |
166 | * cksum checksum function | |
167 | * comp compression function | |
168 | * G gang block indicator | |
169 | * E endianness | |
170 | * type DMU object type | |
171 | * lvl level of indirection | |
172 | * birth txg transaction group in which the block was born | |
173 | * fill count number of non-zero blocks under this bp | |
174 | * checksum[4] 256-bit checksum of the data this bp describes | |
175 | */ | |
176 | typedef struct blkptr { | |
177 | dva_t blk_dva[3]; /* 128-bit Data Virtual Address */ | |
178 | uint64_t blk_prop; /* size, compression, type, etc */ | |
179 | uint64_t blk_pad[3]; /* Extra space for the future */ | |
180 | uint64_t blk_birth; /* transaction group at birth */ | |
181 | uint64_t blk_fill; /* fill count */ | |
182 | zio_cksum_t blk_cksum; /* 256-bit checksum */ | |
183 | } blkptr_t; | |
184 | ||
185 | #define SPA_BLKPTRSHIFT 7 /* blkptr_t is 128 bytes */ | |
186 | #define SPA_DVAS_PER_BP 3 /* Number of DVAs in a bp */ | |
187 | ||
188 | /* | |
189 | * Macros to get and set fields in a bp or DVA. | |
190 | */ | |
191 | #define DVA_GET_ASIZE(dva) \ | |
192 | BF64_GET_SB((dva)->dva_word[0], 0, 24, SPA_MINBLOCKSHIFT, 0) | |
193 | #define DVA_SET_ASIZE(dva, x) \ | |
194 | BF64_SET_SB((dva)->dva_word[0], 0, 24, SPA_MINBLOCKSHIFT, 0, x) | |
195 | ||
196 | #define DVA_GET_GRID(dva) BF64_GET((dva)->dva_word[0], 24, 8) | |
197 | #define DVA_SET_GRID(dva, x) BF64_SET((dva)->dva_word[0], 24, 8, x) | |
198 | ||
199 | #define DVA_GET_VDEV(dva) BF64_GET((dva)->dva_word[0], 32, 32) | |
200 | #define DVA_SET_VDEV(dva, x) BF64_SET((dva)->dva_word[0], 32, 32, x) | |
201 | ||
202 | #define DVA_GET_OFFSET(dva) \ | |
203 | BF64_GET_SB((dva)->dva_word[1], 0, 63, SPA_MINBLOCKSHIFT, 0) | |
204 | #define DVA_SET_OFFSET(dva, x) \ | |
205 | BF64_SET_SB((dva)->dva_word[1], 0, 63, SPA_MINBLOCKSHIFT, 0, x) | |
206 | ||
207 | #define DVA_GET_GANG(dva) BF64_GET((dva)->dva_word[1], 63, 1) | |
208 | #define DVA_SET_GANG(dva, x) BF64_SET((dva)->dva_word[1], 63, 1, x) | |
209 | ||
210 | #define BP_GET_LSIZE(bp) \ | |
211 | (BP_IS_HOLE(bp) ? 0 : \ | |
212 | BF64_GET_SB((bp)->blk_prop, 0, 16, SPA_MINBLOCKSHIFT, 1)) | |
213 | #define BP_SET_LSIZE(bp, x) \ | |
214 | BF64_SET_SB((bp)->blk_prop, 0, 16, SPA_MINBLOCKSHIFT, 1, x) | |
215 | ||
216 | #define BP_GET_PSIZE(bp) \ | |
217 | BF64_GET_SB((bp)->blk_prop, 16, 16, SPA_MINBLOCKSHIFT, 1) | |
218 | #define BP_SET_PSIZE(bp, x) \ | |
219 | BF64_SET_SB((bp)->blk_prop, 16, 16, SPA_MINBLOCKSHIFT, 1, x) | |
220 | ||
221 | #define BP_GET_COMPRESS(bp) BF64_GET((bp)->blk_prop, 32, 8) | |
222 | #define BP_SET_COMPRESS(bp, x) BF64_SET((bp)->blk_prop, 32, 8, x) | |
223 | ||
224 | #define BP_GET_CHECKSUM(bp) BF64_GET((bp)->blk_prop, 40, 8) | |
225 | #define BP_SET_CHECKSUM(bp, x) BF64_SET((bp)->blk_prop, 40, 8, x) | |
226 | ||
227 | #define BP_GET_TYPE(bp) BF64_GET((bp)->blk_prop, 48, 8) | |
228 | #define BP_SET_TYPE(bp, x) BF64_SET((bp)->blk_prop, 48, 8, x) | |
229 | ||
230 | #define BP_GET_LEVEL(bp) BF64_GET((bp)->blk_prop, 56, 5) | |
231 | #define BP_SET_LEVEL(bp, x) BF64_SET((bp)->blk_prop, 56, 5, x) | |
232 | ||
233 | #define BP_GET_BYTEORDER(bp) (0 - BF64_GET((bp)->blk_prop, 63, 1)) | |
234 | #define BP_SET_BYTEORDER(bp, x) BF64_SET((bp)->blk_prop, 63, 1, x) | |
235 | ||
236 | #define BP_GET_ASIZE(bp) \ | |
237 | (DVA_GET_ASIZE(&(bp)->blk_dva[0]) + DVA_GET_ASIZE(&(bp)->blk_dva[1]) + \ | |
238 | DVA_GET_ASIZE(&(bp)->blk_dva[2])) | |
239 | ||
240 | #define BP_GET_UCSIZE(bp) \ | |
241 | ((BP_GET_LEVEL(bp) > 0 || dmu_ot[BP_GET_TYPE(bp)].ot_metadata) ? \ | |
242 | BP_GET_PSIZE(bp) : BP_GET_LSIZE(bp)); | |
243 | ||
244 | #define BP_GET_NDVAS(bp) \ | |
245 | (!!DVA_GET_ASIZE(&(bp)->blk_dva[0]) + \ | |
246 | !!DVA_GET_ASIZE(&(bp)->blk_dva[1]) + \ | |
247 | !!DVA_GET_ASIZE(&(bp)->blk_dva[2])) | |
248 | ||
249 | #define BP_COUNT_GANG(bp) \ | |
250 | (DVA_GET_GANG(&(bp)->blk_dva[0]) + \ | |
251 | DVA_GET_GANG(&(bp)->blk_dva[1]) + \ | |
252 | DVA_GET_GANG(&(bp)->blk_dva[2])) | |
253 | ||
254 | #define DVA_EQUAL(dva1, dva2) \ | |
255 | ((dva1)->dva_word[1] == (dva2)->dva_word[1] && \ | |
256 | (dva1)->dva_word[0] == (dva2)->dva_word[0]) | |
257 | ||
258 | #define ZIO_CHECKSUM_EQUAL(zc1, zc2) \ | |
259 | (0 == (((zc1).zc_word[0] - (zc2).zc_word[0]) | \ | |
260 | ((zc1).zc_word[1] - (zc2).zc_word[1]) | \ | |
261 | ((zc1).zc_word[2] - (zc2).zc_word[2]) | \ | |
262 | ((zc1).zc_word[3] - (zc2).zc_word[3]))) | |
263 | ||
34dc7c2f BB |
264 | #define DVA_IS_VALID(dva) (DVA_GET_ASIZE(dva) != 0) |
265 | ||
266 | #define ZIO_SET_CHECKSUM(zcp, w0, w1, w2, w3) \ | |
267 | { \ | |
268 | (zcp)->zc_word[0] = w0; \ | |
269 | (zcp)->zc_word[1] = w1; \ | |
270 | (zcp)->zc_word[2] = w2; \ | |
271 | (zcp)->zc_word[3] = w3; \ | |
272 | } | |
273 | ||
274 | #define BP_IDENTITY(bp) (&(bp)->blk_dva[0]) | |
275 | #define BP_IS_GANG(bp) DVA_GET_GANG(BP_IDENTITY(bp)) | |
276 | #define BP_IS_HOLE(bp) ((bp)->blk_birth == 0) | |
277 | #define BP_IS_OLDER(bp, txg) (!BP_IS_HOLE(bp) && (bp)->blk_birth < (txg)) | |
278 | ||
b128c09f | 279 | #define BP_ZERO(bp) \ |
34dc7c2f BB |
280 | { \ |
281 | (bp)->blk_dva[0].dva_word[0] = 0; \ | |
282 | (bp)->blk_dva[0].dva_word[1] = 0; \ | |
283 | (bp)->blk_dva[1].dva_word[0] = 0; \ | |
284 | (bp)->blk_dva[1].dva_word[1] = 0; \ | |
285 | (bp)->blk_dva[2].dva_word[0] = 0; \ | |
286 | (bp)->blk_dva[2].dva_word[1] = 0; \ | |
34dc7c2f BB |
287 | (bp)->blk_prop = 0; \ |
288 | (bp)->blk_pad[0] = 0; \ | |
289 | (bp)->blk_pad[1] = 0; \ | |
290 | (bp)->blk_pad[2] = 0; \ | |
b128c09f | 291 | (bp)->blk_birth = 0; \ |
34dc7c2f BB |
292 | (bp)->blk_fill = 0; \ |
293 | ZIO_SET_CHECKSUM(&(bp)->blk_cksum, 0, 0, 0, 0); \ | |
294 | } | |
295 | ||
b128c09f BB |
296 | #define BLK_FILL_ALREADY_FREED (-1ULL) |
297 | ||
34dc7c2f BB |
298 | /* |
299 | * Note: the byteorder is either 0 or -1, both of which are palindromes. | |
300 | * This simplifies the endianness handling a bit. | |
301 | */ | |
302 | #ifdef _BIG_ENDIAN | |
303 | #define ZFS_HOST_BYTEORDER (0ULL) | |
304 | #else | |
305 | #define ZFS_HOST_BYTEORDER (-1ULL) | |
306 | #endif | |
307 | ||
308 | #define BP_SHOULD_BYTESWAP(bp) (BP_GET_BYTEORDER(bp) != ZFS_HOST_BYTEORDER) | |
309 | ||
310 | #define BP_SPRINTF_LEN 320 | |
311 | ||
312 | #include <sys/dmu.h> | |
313 | ||
314 | #define BP_GET_BUFC_TYPE(bp) \ | |
315 | (((BP_GET_LEVEL(bp) > 0) || (dmu_ot[BP_GET_TYPE(bp)].ot_metadata)) ? \ | |
316 | ARC_BUFC_METADATA : ARC_BUFC_DATA); | |
317 | /* | |
318 | * Routines found in spa.c | |
319 | */ | |
320 | ||
321 | /* state manipulation functions */ | |
322 | extern int spa_open(const char *pool, spa_t **, void *tag); | |
323 | extern int spa_get_stats(const char *pool, nvlist_t **config, | |
324 | char *altroot, size_t buflen); | |
325 | extern int spa_create(const char *pool, nvlist_t *config, nvlist_t *props, | |
b128c09f BB |
326 | const char *history_str, nvlist_t *zplprops); |
327 | extern int spa_check_rootconf(char *devpath, char *devid, | |
328 | nvlist_t **bestconf, uint64_t *besttxg); | |
34dc7c2f | 329 | extern boolean_t spa_rootdev_validate(nvlist_t *nv); |
b128c09f | 330 | extern int spa_import_rootpool(char *devpath, char *devid); |
34dc7c2f | 331 | extern int spa_import(const char *pool, nvlist_t *config, nvlist_t *props); |
b128c09f | 332 | extern int spa_import_faulted(const char *, nvlist_t *, nvlist_t *); |
34dc7c2f BB |
333 | extern nvlist_t *spa_tryimport(nvlist_t *tryconfig); |
334 | extern int spa_destroy(char *pool); | |
fb5f0bc8 BB |
335 | extern int spa_export(char *pool, nvlist_t **oldconfig, boolean_t force, |
336 | boolean_t hardforce); | |
34dc7c2f BB |
337 | extern int spa_reset(char *pool); |
338 | extern void spa_async_request(spa_t *spa, int flag); | |
b128c09f | 339 | extern void spa_async_unrequest(spa_t *spa, int flag); |
34dc7c2f BB |
340 | extern void spa_async_suspend(spa_t *spa); |
341 | extern void spa_async_resume(spa_t *spa); | |
342 | extern spa_t *spa_inject_addref(char *pool); | |
343 | extern void spa_inject_delref(spa_t *spa); | |
344 | ||
b128c09f BB |
345 | #define SPA_ASYNC_CONFIG_UPDATE 0x01 |
346 | #define SPA_ASYNC_REMOVE 0x02 | |
347 | #define SPA_ASYNC_PROBE 0x04 | |
348 | #define SPA_ASYNC_RESILVER_DONE 0x08 | |
349 | #define SPA_ASYNC_RESILVER 0x10 | |
34dc7c2f BB |
350 | |
351 | /* device manipulation */ | |
352 | extern int spa_vdev_add(spa_t *spa, nvlist_t *nvroot); | |
353 | extern int spa_vdev_attach(spa_t *spa, uint64_t guid, nvlist_t *nvroot, | |
354 | int replacing); | |
fb5f0bc8 BB |
355 | extern int spa_vdev_detach(spa_t *spa, uint64_t guid, uint64_t pguid, |
356 | int replace_done); | |
34dc7c2f BB |
357 | extern int spa_vdev_remove(spa_t *spa, uint64_t guid, boolean_t unspare); |
358 | extern int spa_vdev_setpath(spa_t *spa, uint64_t guid, const char *newpath); | |
359 | ||
360 | /* spare state (which is global across all pools) */ | |
361 | extern void spa_spare_add(vdev_t *vd); | |
362 | extern void spa_spare_remove(vdev_t *vd); | |
b128c09f | 363 | extern boolean_t spa_spare_exists(uint64_t guid, uint64_t *pool, int *refcnt); |
34dc7c2f BB |
364 | extern void spa_spare_activate(vdev_t *vd); |
365 | ||
366 | /* L2ARC state (which is global across all pools) */ | |
367 | extern void spa_l2cache_add(vdev_t *vd); | |
368 | extern void spa_l2cache_remove(vdev_t *vd); | |
369 | extern boolean_t spa_l2cache_exists(uint64_t guid, uint64_t *pool); | |
370 | extern void spa_l2cache_activate(vdev_t *vd); | |
371 | extern void spa_l2cache_drop(spa_t *spa); | |
372 | extern void spa_l2cache_space_update(vdev_t *vd, int64_t space, int64_t alloc); | |
373 | ||
374 | /* scrubbing */ | |
b128c09f | 375 | extern int spa_scrub(spa_t *spa, pool_scrub_type_t type); |
34dc7c2f BB |
376 | |
377 | /* spa syncing */ | |
378 | extern void spa_sync(spa_t *spa, uint64_t txg); /* only for DMU use */ | |
379 | extern void spa_sync_allpools(void); | |
380 | ||
b128c09f BB |
381 | /* spa namespace global mutex */ |
382 | extern kmutex_t spa_namespace_lock; | |
383 | ||
34dc7c2f BB |
384 | /* |
385 | * SPA configuration functions in spa_config.c | |
386 | */ | |
387 | ||
388 | #define SPA_CONFIG_UPDATE_POOL 0 | |
389 | #define SPA_CONFIG_UPDATE_VDEVS 1 | |
390 | ||
b128c09f | 391 | extern void spa_config_sync(spa_t *, boolean_t, boolean_t); |
34dc7c2f BB |
392 | extern void spa_config_load(void); |
393 | extern nvlist_t *spa_all_configs(uint64_t *); | |
394 | extern void spa_config_set(spa_t *spa, nvlist_t *config); | |
395 | extern nvlist_t *spa_config_generate(spa_t *spa, vdev_t *vd, uint64_t txg, | |
396 | int getstats); | |
397 | extern void spa_config_update(spa_t *spa, int what); | |
398 | extern void spa_config_update_common(spa_t *spa, int what, boolean_t isroot); | |
399 | ||
400 | /* | |
401 | * Miscellaneous SPA routines in spa_misc.c | |
402 | */ | |
403 | ||
404 | /* Namespace manipulation */ | |
405 | extern spa_t *spa_lookup(const char *name); | |
406 | extern spa_t *spa_add(const char *name, const char *altroot); | |
407 | extern void spa_remove(spa_t *spa); | |
408 | extern spa_t *spa_next(spa_t *prev); | |
409 | ||
410 | /* Refcount functions */ | |
411 | extern void spa_open_ref(spa_t *spa, void *tag); | |
412 | extern void spa_close(spa_t *spa, void *tag); | |
413 | extern boolean_t spa_refcount_zero(spa_t *spa); | |
414 | ||
b128c09f BB |
415 | #define SCL_CONFIG 0x01 |
416 | #define SCL_STATE 0x02 | |
417 | #define SCL_L2ARC 0x04 /* hack until L2ARC 2.0 */ | |
418 | #define SCL_ALLOC 0x08 | |
419 | #define SCL_ZIO 0x10 | |
420 | #define SCL_FREE 0x20 | |
421 | #define SCL_VDEV 0x40 | |
422 | #define SCL_LOCKS 7 | |
423 | #define SCL_ALL ((1 << SCL_LOCKS) - 1) | |
424 | #define SCL_STATE_ALL (SCL_STATE | SCL_L2ARC | SCL_ZIO) | |
425 | ||
426 | /* Pool configuration locks */ | |
427 | extern int spa_config_tryenter(spa_t *spa, int locks, void *tag, krw_t rw); | |
428 | extern void spa_config_enter(spa_t *spa, int locks, void *tag, krw_t rw); | |
429 | extern void spa_config_exit(spa_t *spa, int locks, void *tag); | |
430 | extern int spa_config_held(spa_t *spa, int locks, krw_t rw); | |
34dc7c2f BB |
431 | |
432 | /* Pool vdev add/remove lock */ | |
433 | extern uint64_t spa_vdev_enter(spa_t *spa); | |
434 | extern int spa_vdev_exit(spa_t *spa, vdev_t *vd, uint64_t txg, int error); | |
435 | ||
b128c09f BB |
436 | /* Pool vdev state change lock */ |
437 | extern void spa_vdev_state_enter(spa_t *spa); | |
438 | extern int spa_vdev_state_exit(spa_t *spa, vdev_t *vd, int error); | |
439 | ||
34dc7c2f | 440 | /* Accessor functions */ |
b128c09f | 441 | extern boolean_t spa_shutting_down(spa_t *spa); |
34dc7c2f BB |
442 | extern struct dsl_pool *spa_get_dsl(spa_t *spa); |
443 | extern blkptr_t *spa_get_rootblkptr(spa_t *spa); | |
444 | extern void spa_set_rootblkptr(spa_t *spa, const blkptr_t *bp); | |
445 | extern void spa_altroot(spa_t *, char *, size_t); | |
446 | extern int spa_sync_pass(spa_t *spa); | |
447 | extern char *spa_name(spa_t *spa); | |
448 | extern uint64_t spa_guid(spa_t *spa); | |
449 | extern uint64_t spa_last_synced_txg(spa_t *spa); | |
450 | extern uint64_t spa_first_txg(spa_t *spa); | |
451 | extern uint64_t spa_version(spa_t *spa); | |
b128c09f | 452 | extern pool_state_t spa_state(spa_t *spa); |
34dc7c2f BB |
453 | extern uint64_t spa_freeze_txg(spa_t *spa); |
454 | extern uint64_t spa_get_alloc(spa_t *spa); | |
455 | extern uint64_t spa_get_space(spa_t *spa); | |
456 | extern uint64_t spa_get_dspace(spa_t *spa); | |
457 | extern uint64_t spa_get_asize(spa_t *spa, uint64_t lsize); | |
458 | extern uint64_t spa_version(spa_t *spa); | |
459 | extern int spa_max_replication(spa_t *spa); | |
460 | extern int spa_busy(void); | |
461 | extern uint8_t spa_get_failmode(spa_t *spa); | |
b128c09f | 462 | extern boolean_t spa_suspended(spa_t *spa); |
34dc7c2f BB |
463 | |
464 | /* Miscellaneous support routines */ | |
465 | extern int spa_rename(const char *oldname, const char *newname); | |
466 | extern boolean_t spa_guid_exists(uint64_t pool_guid, uint64_t device_guid); | |
467 | extern char *spa_strdup(const char *); | |
468 | extern void spa_strfree(char *); | |
469 | extern uint64_t spa_get_random(uint64_t range); | |
470 | extern void sprintf_blkptr(char *buf, int len, const blkptr_t *bp); | |
471 | extern void spa_freeze(spa_t *spa); | |
472 | extern void spa_upgrade(spa_t *spa, uint64_t version); | |
473 | extern void spa_evict_all(void); | |
b128c09f BB |
474 | extern vdev_t *spa_lookup_by_guid(spa_t *spa, uint64_t guid, |
475 | boolean_t l2cache); | |
34dc7c2f BB |
476 | extern boolean_t spa_has_spare(spa_t *, uint64_t guid); |
477 | extern uint64_t bp_get_dasize(spa_t *spa, const blkptr_t *bp); | |
478 | extern boolean_t spa_has_slogs(spa_t *spa); | |
b128c09f | 479 | extern boolean_t spa_is_root(spa_t *spa); |
fb5f0bc8 BB |
480 | extern boolean_t spa_writeable(spa_t *spa); |
481 | extern int spa_mode(spa_t *spa); | |
34dc7c2f BB |
482 | |
483 | /* history logging */ | |
484 | typedef enum history_log_type { | |
485 | LOG_CMD_POOL_CREATE, | |
486 | LOG_CMD_NORMAL, | |
487 | LOG_INTERNAL | |
488 | } history_log_type_t; | |
489 | ||
490 | typedef struct history_arg { | |
491 | const char *ha_history_str; | |
492 | history_log_type_t ha_log_type; | |
493 | history_internal_events_t ha_event; | |
494 | char ha_zone[MAXPATHLEN]; | |
495 | } history_arg_t; | |
496 | ||
497 | extern char *spa_his_ievent_table[]; | |
498 | ||
499 | extern void spa_history_create_obj(spa_t *spa, dmu_tx_t *tx); | |
500 | extern int spa_history_get(spa_t *spa, uint64_t *offset, uint64_t *len_read, | |
501 | char *his_buf); | |
502 | extern int spa_history_log(spa_t *spa, const char *his_buf, | |
503 | history_log_type_t what); | |
504 | void spa_history_internal_log(history_internal_events_t event, spa_t *spa, | |
505 | dmu_tx_t *tx, cred_t *cr, const char *fmt, ...); | |
506 | ||
507 | /* error handling */ | |
508 | struct zbookmark; | |
509 | struct zio; | |
510 | extern void spa_log_error(spa_t *spa, struct zio *zio); | |
511 | extern void zfs_ereport_post(const char *class, spa_t *spa, vdev_t *vd, | |
512 | struct zio *zio, uint64_t stateoroffset, uint64_t length); | |
34dc7c2f BB |
513 | extern void zfs_post_remove(spa_t *spa, vdev_t *vd); |
514 | extern void zfs_post_autoreplace(spa_t *spa, vdev_t *vd); | |
515 | extern uint64_t spa_get_errlog_size(spa_t *spa); | |
516 | extern int spa_get_errlog(spa_t *spa, void *uaddr, size_t *count); | |
517 | extern void spa_errlog_rotate(spa_t *spa); | |
518 | extern void spa_errlog_drain(spa_t *spa); | |
519 | extern void spa_errlog_sync(spa_t *spa, uint64_t txg); | |
520 | extern void spa_get_errlists(spa_t *spa, avl_tree_t *last, avl_tree_t *scrub); | |
521 | ||
522 | /* vdev cache */ | |
523 | extern void vdev_cache_stat_init(void); | |
524 | extern void vdev_cache_stat_fini(void); | |
525 | ||
526 | /* Initialization and termination */ | |
527 | extern void spa_init(int flags); | |
528 | extern void spa_fini(void); | |
529 | extern void spa_boot_init(); | |
530 | ||
531 | /* properties */ | |
532 | extern int spa_prop_set(spa_t *spa, nvlist_t *nvp); | |
533 | extern int spa_prop_get(spa_t *spa, nvlist_t **nvp); | |
534 | extern void spa_prop_clear_bootfs(spa_t *spa, uint64_t obj, dmu_tx_t *tx); | |
d164b209 | 535 | extern void spa_configfile_set(spa_t *, nvlist_t *, boolean_t); |
34dc7c2f BB |
536 | |
537 | /* asynchronous event notification */ | |
538 | extern void spa_event_notify(spa_t *spa, vdev_t *vdev, const char *name); | |
539 | ||
540 | #ifdef ZFS_DEBUG | |
541 | #define dprintf_bp(bp, fmt, ...) do { \ | |
542 | if (zfs_flags & ZFS_DEBUG_DPRINTF) { \ | |
543 | char *__blkbuf = kmem_alloc(BP_SPRINTF_LEN, KM_SLEEP); \ | |
544 | sprintf_blkptr(__blkbuf, BP_SPRINTF_LEN, (bp)); \ | |
545 | dprintf(fmt " %s\n", __VA_ARGS__, __blkbuf); \ | |
546 | kmem_free(__blkbuf, BP_SPRINTF_LEN); \ | |
547 | } \ | |
548 | _NOTE(CONSTCOND) } while (0) | |
549 | #else | |
550 | #define dprintf_bp(bp, fmt, ...) | |
551 | #endif | |
552 | ||
fb5f0bc8 | 553 | extern int spa_mode_global; /* mode, e.g. FREAD | FWRITE */ |
34dc7c2f BB |
554 | |
555 | #ifdef __cplusplus | |
556 | } | |
557 | #endif | |
558 | ||
559 | #endif /* _SYS_SPA_H */ |