.\" SPDX-License-Identifier: CDDL-1.0
.\"
.\" This file and its contents are supplied under the terms of the
.\" Common Development and Distribution License ("CDDL"), version 1.0.
.\" You may only use this file in accordance with the terms of version
.\" 1.0 of the CDDL.
.\"
.\" A full copy of the text of the CDDL should have accompanied this
.\" source.  A copy of the CDDL is also available via the Internet at
.\" https://opensource.org/license/CDDL-1.0.
.\"
.\"
.\" Copyright (c) 2024-2026, Klara, Inc.
.\" Copyright (c) 2026, TrueNAS.
.\"
.Dd May 26, 2026
.Dt ZPOOL-CONDENSE 8
.Os
.
.Sh NAME
.Nm zpool-condense
.Nd Condense, flush, garbage collect or otherwise clean up pool metadata
.Sh SYNOPSIS
.Nm zpool
.Cm condense
.Op Fl t Ar type
.Op Fl c | w
.Fl a Ns | Ns Ar pool Ns …
.Nm zpool
.Cm condense
.Fl -types
.Sh DESCRIPTION
Many internal pool metadata updates are performed in the background at a rate
chosen to limit the performance impact to normal use of the pool.
Sometimes it is desirable to accelerate these operations,
even if it affects overall performance.
.Sy condense
allows an operator to request that a specific background operation be
prioritised to complete as soon as possible.
.Bl -tag -width Ds
.It Fl t , -type
What to condense.
If not specified, all types will be condensed.
These are the possible values for
.Ar type :
.Bl -tag -compact -offset Ds -width "log_spacemap"
.It Sy log_spacemap
flushing log spacemap entries to their underlying metaslabs.
.El
.It Fl a , -all
Begin, cancel or wait on condense for all pools.
.It Fl c , -cancel
Cancel a previous
.Sy condense .
This will return background updates to their normal rate.
.It Fl w , -wait
Wait until the condense has completed before returning.
.It Fl -types
List condense types supported by this build of
.Sy condense .
.El
.Sh EXAMPLES
.Ss Example 1
Status of pool with
.Sy log_spacemap
condense in progress:
.sp
.Bd -literal -compact
.No # Nm zpool Cm condense -t log_spacemap
.No # Nm zpool Cm status
  pool: tank
  state: ONLINE
  condense: log_spacemap: condensing, 104/321 metaslabs done in 00:00:15
  ...
.Ed
.Sh SEE ALSO
.Xr zpool-status 8 ,
.Xr zpool-wait 8