xref: /freebsd/sys/contrib/openzfs/man/man8/zpool-wait.8 (revision b197d4b893974c9eb4d7b38704c6d5c486235d6f)
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 https://opensource.org/licenses/CDDL-1.0.
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) 2007, Sun Microsystems, Inc. All Rights Reserved.
23.\" Copyright (c) 2012, 2018 by Delphix. All rights reserved.
24.\" Copyright (c) 2012 Cyril Plisko. All Rights Reserved.
25.\" Copyright (c) 2017 Datto Inc.
26.\" Copyright (c) 2018 George Melikov. All Rights Reserved.
27.\" Copyright 2017 Nexenta Systems, Inc.
28.\" Copyright (c) 2017 Open-E, Inc. All Rights Reserved.
29.\"
30.Dd May 27, 2021
31.Dt ZPOOL-WAIT 8
32.Os
33.
34.Sh NAME
35.Nm zpool-wait
36.Nd wait for activity to stop in a ZFS storage pool
37.Sh SYNOPSIS
38.Nm zpool
39.Cm wait
40.Op Fl Hp
41.Op Fl T Sy u Ns | Ns Sy d
42.Op Fl t Ar activity Ns Oo , Ns Ar activity Ns Oc Ns …
43.Ar pool
44.Op Ar interval
45.
46.Sh DESCRIPTION
47Waits until all background activity of the given types has ceased in the given
48pool.
49The activity could cease because it has completed, or because it has been
50paused or canceled by a user, or because the pool has been exported or
51destroyed.
52If no activities are specified, the command waits until background activity of
53every type listed below has ceased.
54If there is no activity of the given types in progress, the command returns
55immediately.
56.Pp
57These are the possible values for
58.Ar activity ,
59along with what each one waits for:
60.Bl -tag -compact -offset Ds -width "initialize"
61.It Sy discard
62Checkpoint to be discarded
63.It Sy free
64.Sy freeing
65property to become
66.Sy 0
67.It Sy initialize
68All initializations to cease
69.It Sy replace
70All device replacements to cease
71.It Sy remove
72Device removal to cease
73.It Sy resilver
74Resilver to cease
75.It Sy scrub
76Scrub to cease
77.It Sy trim
78Manual trim to cease
79.El
80.Pp
81If an
82.Ar interval
83is provided, the amount of work remaining, in bytes, for each activity is
84printed every
85.Ar interval
86seconds.
87.Bl -tag -width Ds
88.It Fl H
89Scripted mode.
90Do not display headers, and separate fields by a single tab instead of arbitrary
91space.
92.It Fl p
93Display numbers in parsable (exact) values.
94.It Fl T Sy u Ns | Ns Sy d
95Display a time stamp.
96Specify
97.Sy u
98for a printed representation of the internal representation of time.
99See
100.Xr time 2 .
101Specify
102.Sy d
103for standard date format.
104See
105.Xr date 1 .
106.El
107.
108.Sh SEE ALSO
109.Xr zpool-checkpoint 8 ,
110.Xr zpool-initialize 8 ,
111.Xr zpool-remove 8 ,
112.Xr zpool-replace 8 ,
113.Xr zpool-resilver 8 ,
114.Xr zpool-scrub 8 ,
115.Xr zpool-status 8 ,
116.Xr zpool-trim 8
117