Files
freebsd/include/sys/vdev_initialize.h
T
MorganaFuture 50557cc803 zpool initialize: add -z to write zeroes
zpool initialize writes a non-zero pattern (0xdeadbeefdeadbeee) to free
space.  The pattern can be changed globally with the
zfs_initialize_value module parameter, but there was no per-command way
to zero free space, which is what is wanted to reclaim thinly
provisioned backing storage.

Add a -z/--zero flag to "zpool initialize" that writes zeroes for that
run.  The fill value is threaded from the CLI through libzfs and the
POOL_INITIALIZE ioctl into vdev_initialize(), and is recorded in the
leaf ZAP so a run that is suspended and resumed (including across export
and import) keeps writing the same value.  When no value is supplied the
zfs_initialize_value default is used, preserving existing behavior.  -z
is only valid when starting initialization.

The zpool-initialize(8) page notes that -z targets backing storage which
does not support TRIM and points at zpool-trim(8) as the more efficient
option when the device does support it; zfs.4 documents
zfs_initialize_value as the default fill value.

Add a zpool_initialize_zero test that pre-fills a device, runs
"initialize -z", and checks its free space is zeroed and the chosen
value is persisted, and cover the optional ZPOOL_INITIALIZE_VALUE ioctl
key in test_vdev_initialize().

Reviewed-by: Brian Behlendorf <[email protected]>
Reviewed-by: Alexander Motin <[email protected]>
Reviewed-by: Akash B <[email protected]>
Signed-off-by: MorganaFuture <[email protected]>
Closes #16778
Closes #18765
2026-07-24 13:00:18 -07:00

51 lines
1.5 KiB
C

// SPDX-License-Identifier: CDDL-1.0
/*
* CDDL HEADER START
*
* The contents of this file are subject to the terms of the
* Common Development and Distribution License (the "License").
* You may not use this file except in compliance with the License.
*
* You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
* or https://opensource.org/licenses/CDDL-1.0.
* See the License for the specific language governing permissions
* and limitations under the License.
*
* When distributing Covered Code, include this CDDL HEADER in each
* file and include the License file at usr/src/OPENSOLARIS.LICENSE.
* If applicable, add the following below this CDDL HEADER, with the
* fields enclosed by brackets "[]" replaced with your own identifying
* information: Portions Copyright [yyyy] [name of copyright owner]
*
* CDDL HEADER END
*/
/*
* Copyright (c) 2016 by Delphix. All rights reserved.
*/
#ifndef _SYS_VDEV_INITIALIZE_H
#define _SYS_VDEV_INITIALIZE_H
#include <sys/spa.h>
#ifdef __cplusplus
extern "C" {
#endif
extern void vdev_initialize(vdev_t *vd, uint64_t value,
boolean_t value_provided);
extern void vdev_uninitialize(vdev_t *vd);
extern void vdev_initialize_stop(vdev_t *vd,
vdev_initializing_state_t tgt_state, list_t *vd_list);
extern void vdev_initialize_stop_all(vdev_t *vd,
vdev_initializing_state_t tgt_state);
extern void vdev_initialize_stop_wait(spa_t *spa, list_t *vd_list);
extern void vdev_initialize_restart(vdev_t *vd);
#ifdef __cplusplus
}
#endif
#endif /* _SYS_VDEV_INITIALIZE_H */