xref: /freebsd/sys/contrib/openzfs/man/man8/zfs-wait.8 (revision 271171e0d97b88ba2a7c3bf750c9672b484c1c13)
1eda14cbcSMatt Macy.\"
2eda14cbcSMatt Macy.\" CDDL HEADER START
3eda14cbcSMatt Macy.\"
4eda14cbcSMatt Macy.\" The contents of this file are subject to the terms of the
5eda14cbcSMatt Macy.\" Common Development and Distribution License (the "License").
6eda14cbcSMatt Macy.\" You may not use this file except in compliance with the License.
7eda14cbcSMatt Macy.\"
8eda14cbcSMatt Macy.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
9*271171e0SMartin Matuska.\" or https://opensource.org/licenses/CDDL-1.0.
10eda14cbcSMatt Macy.\" See the License for the specific language governing permissions
11eda14cbcSMatt Macy.\" and limitations under the License.
12eda14cbcSMatt Macy.\"
13eda14cbcSMatt Macy.\" When distributing Covered Code, include this CDDL HEADER in each
14eda14cbcSMatt Macy.\" file and include the License file at usr/src/OPENSOLARIS.LICENSE.
15eda14cbcSMatt Macy.\" If applicable, add the following below this CDDL HEADER, with the
16eda14cbcSMatt Macy.\" fields enclosed by brackets "[]" replaced with your own identifying
17eda14cbcSMatt Macy.\" information: Portions Copyright [yyyy] [name of copyright owner]
18eda14cbcSMatt Macy.\"
19eda14cbcSMatt Macy.\" CDDL HEADER END
20eda14cbcSMatt Macy.\"
21eda14cbcSMatt Macy.\" Copyright (c) 2007, Sun Microsystems, Inc. All Rights Reserved.
22eda14cbcSMatt Macy.\" Copyright (c) 2012, 2018 by Delphix. All rights reserved.
23eda14cbcSMatt Macy.\" Copyright (c) 2012 Cyril Plisko. All Rights Reserved.
24eda14cbcSMatt Macy.\" Copyright (c) 2017 Datto Inc.
25eda14cbcSMatt Macy.\" Copyright (c) 2018 George Melikov. All Rights Reserved.
26eda14cbcSMatt Macy.\" Copyright 2017 Nexenta Systems, Inc.
27eda14cbcSMatt Macy.\" Copyright (c) 2017 Open-E, Inc. All Rights Reserved.
28eda14cbcSMatt Macy.\"
2916038816SMartin Matuska.Dd May 31, 2021
30eda14cbcSMatt Macy.Dt ZFS-WAIT 8
31eda14cbcSMatt Macy.Os
3216038816SMartin Matuska.
33eda14cbcSMatt Macy.Sh NAME
347877fdebSMatt Macy.Nm zfs-wait
3516038816SMartin Matuska.Nd wait for activity in ZFS filesystem to stop
36eda14cbcSMatt Macy.Sh SYNOPSIS
377877fdebSMatt Macy.Nm zfs
38eda14cbcSMatt Macy.Cm wait
3916038816SMartin Matuska.Op Fl t Ar activity Ns Oo , Ns Ar activity Ns Oc Ns …
4016038816SMartin Matuska.Ar filesystem
4116038816SMartin Matuska.
42eda14cbcSMatt Macy.Sh DESCRIPTION
43eda14cbcSMatt MacyWaits until all background activity of the given types has ceased in the given
44eda14cbcSMatt Macyfilesystem.
45eda14cbcSMatt MacyThe activity could cease because it has completed or because the filesystem has
46eda14cbcSMatt Macybeen destroyed or unmounted.
47eda14cbcSMatt MacyIf no activities are specified, the command waits until background activity of
48eda14cbcSMatt Macyevery type listed below has ceased.
49eda14cbcSMatt MacyIf there is no activity of the given types in progress, the command returns
50eda14cbcSMatt Macyimmediately.
51eda14cbcSMatt Macy.Pp
52eda14cbcSMatt MacyThese are the possible values for
53eda14cbcSMatt Macy.Ar activity ,
54eda14cbcSMatt Macyalong with what each one waits for:
5516038816SMartin Matuska.Bl -tag -compact -offset Ds -width "deleteq"
5616038816SMartin Matuska.It Sy deleteq
5716038816SMartin MatuskaThe filesystem's internal delete queue to empty
5816038816SMartin Matuska.El
59eda14cbcSMatt Macy.Pp
60eda14cbcSMatt MacyNote that the internal delete queue does not finish draining until
61eda14cbcSMatt Macyall large files have had time to be fully destroyed and all open file
62eda14cbcSMatt Macyhandles to unlinked files are closed.
6316038816SMartin Matuska.
64eda14cbcSMatt Macy.Sh SEE ALSO
65eda14cbcSMatt Macy.Xr lsof 8
66