diff --git a/contrib/elftoolchain/libelftc/elftc_set_timestamps.3 b/contrib/elftoolchain/libelftc/elftc_set_timestamps.3 --- a/contrib/elftoolchain/libelftc/elftc_set_timestamps.3 +++ b/contrib/elftoolchain/libelftc/elftc_set_timestamps.3 @@ -62,7 +62,7 @@ On operating systems lacking support for .Xr utimes 2 , the function will use lower resolution -.Xr utime 2 +.Xr utime 3 system call. .Sh EXAMPLES To set the access and modified times for a new file to those of an @@ -80,5 +80,5 @@ .Sh SEE ALSO .Xr fstat 2 , .Xr stat 2 , -.Xr utime 2 , +.Xr utime 3 , .Xr utimes 2 diff --git a/sys/contrib/openzfs/man/man8/zpool-iostat.8 b/sys/contrib/openzfs/man/man8/zpool-iostat.8 deleted file mode 100644 --- a/sys/contrib/openzfs/man/man8/zpool-iostat.8 +++ /dev/null @@ -1,306 +0,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) 2007, Sun Microsystems, Inc. All Rights Reserved. -.\" Copyright (c) 2012, 2018 by Delphix. All rights reserved. -.\" Copyright (c) 2012 Cyril Plisko. All Rights Reserved. -.\" Copyright (c) 2017 Datto Inc. -.\" Copyright (c) 2018 George Melikov. All Rights Reserved. -.\" Copyright 2017 Nexenta Systems, Inc. -.\" Copyright (c) 2017 Open-E, Inc. All Rights Reserved. -.\" -.Dd March 16, 2022 -.Dt ZPOOL-IOSTAT 8 -.Os -. -.Sh NAME -.Nm zpool-iostat -.Nd display logical I/O statistics for ZFS storage pools -.Sh SYNOPSIS -.Nm zpool -.Cm iostat -.Op Oo Oo Fl c Ar SCRIPT Oc Oo Fl lq Oc Oc Ns | Ns Fl rw -.Op Fl T Sy u Ns | Ns Sy d -.Op Fl ghHLnpPvy -.Oo Ar pool Ns … Ns | Ns Oo Ar pool vdev Ns … Oc Ns | Ns Ar vdev Ns … Oc -.Op Ar interval Op Ar count -. -.Sh DESCRIPTION -Displays logical I/O statistics for the given pools/vdevs. -Physical I/O statistics may be observed via -.Xr iostat 1 . -If writes are located nearby, they may be merged into a single -larger operation. -Additional I/O may be generated depending on the level of vdev redundancy. -To filter output, you may pass in a list of pools, a pool and list of vdevs -in that pool, or a list of any vdevs from any pool. -If no items are specified, statistics for every pool in the system are shown. -When given an -.Ar interval , -the statistics are printed every -.Ar interval -seconds until killed. -If -.Fl n -flag is specified the headers are displayed only once, otherwise they are -displayed periodically. -If -.Ar count -is specified, the command exits after -.Ar count -reports are printed. -The first report printed is always the statistics since boot regardless of -whether -.Ar interval -and -.Ar count -are passed. -However, this behavior can be suppressed with the -.Fl y -flag. -Also note that the units of -.Sy K , -.Sy M , -.Sy G Ns … -that are printed in the report are in base 1024. -To get the raw values, use the -.Fl p -flag. -.Bl -tag -width Ds -.It Fl c Op Ar SCRIPT1 Ns Oo , Ns Ar SCRIPT2 Oc Ns … -Run a script (or scripts) on each vdev and include the output as a new column -in the -.Nm zpool Cm iostat -output. -Users can run any script found in their -.Pa ~/.zpool.d -directory or from the system -.Pa /etc/zfs/zpool.d -directory. -Script names containing the slash -.Pq Sy / -character are not allowed. -The default search path can be overridden by setting the -.Sy ZPOOL_SCRIPTS_PATH -environment variable. -A privileged user can only run -.Fl c -if they have the -.Sy ZPOOL_SCRIPTS_AS_ROOT -environment variable set. -If a script requires the use of a privileged command, like -.Xr smartctl 8 , -then it's recommended you allow the user access to it in -.Pa /etc/sudoers -or add the user to the -.Pa /etc/sudoers.d/zfs -file. -.Pp -If -.Fl c -is passed without a script name, it prints a list of all scripts. -.Fl c -also sets verbose mode -.No \&( Ns Fl v Ns No \&) . -.Pp -Script output should be in the form of "name=value". -The column name is set to "name" and the value is set to "value". -Multiple lines can be used to output multiple columns. -The first line of output not in the -"name=value" format is displayed without a column title, -and no more output after that is displayed. -This can be useful for printing error messages. -Blank or NULL values are printed as a '-' to make output AWKable. -.Pp -The following environment variables are set before running each script: -.Bl -tag -compact -width "VDEV_ENC_SYSFS_PATH" -.It Sy VDEV_PATH -Full path to the vdev -.It Sy VDEV_UPATH -Underlying path to the vdev -.Pq Pa /dev/sd* . -For use with device mapper, multipath, or partitioned vdevs. -.It Sy VDEV_ENC_SYSFS_PATH -The sysfs path to the enclosure for the vdev (if any). -.El -.It Fl T Sy u Ns | Ns Sy d -Display a time stamp. -Specify -.Sy u -for a printed representation of the internal representation of time. -See -.Xr time 2 . -Specify -.Sy d -for standard date format. -See -.Xr date 1 . -.It Fl g -Display vdev GUIDs instead of the normal device names. -These GUIDs can be used in place of device names for the zpool -detach/offline/remove/replace commands. -.It Fl H -Scripted mode. -Do not display headers, and separate fields by a -single tab instead of arbitrary space. -.It Fl L -Display real paths for vdevs resolving all symbolic links. -This can be used to look up the current block device name regardless of the -.Pa /dev/disk/ -path used to open it. -.It Fl n -Print headers only once when passed -.It Fl p -Display numbers in parsable (exact) values. -Time values are in nanoseconds. -.It Fl P -Display full paths for vdevs instead of only the last component of the path. -This can be used in conjunction with the -.Fl L -flag. -.It Fl r -Print request size histograms for the leaf vdev's I/O. -This includes histograms of individual I/O (ind) and aggregate I/O (agg). -These stats can be useful for observing how well I/O aggregation is working. -Note that TRIM I/O may exceed 16M, but will be counted as 16M. -.It Fl v -Verbose statistics Reports usage statistics for individual vdevs within the -pool, in addition to the pool-wide statistics. -.It Fl y -Normally the first line of output reports the statistics since boot: -suppress it. -.It Fl w -Display latency histograms: -.Bl -tag -compact -width "asyncq_read/write" -.It Sy total_wait -Total I/O time (queuing + disk I/O time). -.It Sy disk_wait -Disk I/O time (time reading/writing the disk). -.It Sy syncq_wait -Amount of time I/O spent in synchronous priority queues. -Does not include disk time. -.It Sy asyncq_wait -Amount of time I/O spent in asynchronous priority queues. -Does not include disk time. -.It Sy scrub -Amount of time I/O spent in scrub queue. -Does not include disk time. -.It Sy rebuild -Amount of time I/O spent in rebuild queue. -Does not include disk time. -.El -.It Fl l -Include average latency statistics: -.Bl -tag -compact -width "asyncq_read/write" -.It Sy total_wait -Average total I/O time (queuing + disk I/O time). -.It Sy disk_wait -Average disk I/O time (time reading/writing the disk). -.It Sy syncq_wait -Average amount of time I/O spent in synchronous priority queues. -Does not include disk time. -.It Sy asyncq_wait -Average amount of time I/O spent in asynchronous priority queues. -Does not include disk time. -.It Sy scrub -Average queuing time in scrub queue. -Does not include disk time. -.It Sy trim -Average queuing time in trim queue. -Does not include disk time. -.It Sy rebuild -Average queuing time in rebuild queue. -Does not include disk time. -.El -.It Fl q -Include active queue statistics. -Each priority queue has both pending -.Sy ( pend ) -and active -.Sy ( activ ) -I/O requests. -Pending requests are waiting to be issued to the disk, -and active requests have been issued to disk and are waiting for completion. -These stats are broken out by priority queue: -.Bl -tag -compact -width "asyncq_read/write" -.It Sy syncq_read/write -Current number of entries in synchronous priority -queues. -.It Sy asyncq_read/write -Current number of entries in asynchronous priority queues. -.It Sy scrubq_read -Current number of entries in scrub queue. -.It Sy trimq_write -Current number of entries in trim queue. -.It Sy rebuildq_write -Current number of entries in rebuild queue. -.El -.Pp -All queue statistics are instantaneous measurements of the number of -entries in the queues. -If you specify an interval, -the measurements will be sampled from the end of the interval. -.El -. -.Sh EXAMPLES -.\" These are, respectively, examples 13, 16 from zpool.8 -.\" Make sure to update them bidirectionally -.Ss Example 13 : No Adding Cache Devices to a ZFS Pool -The following command adds two disks for use as cache devices to a ZFS storage -pool: -.Dl # Nm zpool Cm add Ar pool Sy cache Pa sdc sdd -.Pp -Once added, the cache devices gradually fill with content from main memory. -Depending on the size of your cache devices, it could take over an hour for -them to fill. -Capacity and reads can be monitored using the -.Cm iostat -subcommand as follows: -.Dl # Nm zpool Cm iostat Fl v Ar pool 5 -. -.Ss Example 16 : No Adding output columns -Additional columns can be added to the -.Nm zpool Cm status No and Nm zpool Cm iostat No output with Fl c . -.Bd -literal -compact -offset Ds -.No # Nm zpool Cm status Fl c Pa vendor , Ns Pa model , Ns Pa size - NAME STATE READ WRITE CKSUM vendor model size - tank ONLINE 0 0 0 - mirror-0 ONLINE 0 0 0 - U1 ONLINE 0 0 0 SEAGATE ST8000NM0075 7.3T - U10 ONLINE 0 0 0 SEAGATE ST8000NM0075 7.3T - U11 ONLINE 0 0 0 SEAGATE ST8000NM0075 7.3T - U12 ONLINE 0 0 0 SEAGATE ST8000NM0075 7.3T - U13 ONLINE 0 0 0 SEAGATE ST8000NM0075 7.3T - U14 ONLINE 0 0 0 SEAGATE ST8000NM0075 7.3T - -.No # Nm zpool Cm iostat Fl vc Pa size - capacity operations bandwidth -pool alloc free read write read write size ----------- ----- ----- ----- ----- ----- ----- ---- -rpool 14.6G 54.9G 4 55 250K 2.69M - sda1 14.6G 54.9G 4 55 250K 2.69M 70G ----------- ----- ----- ----- ----- ----- ----- ---- -.Ed -. -.Sh SEE ALSO -.Xr iostat 1 , -.Xr smartctl 8 , -.Xr zpool-list 8 , -.Xr zpool-status 8 diff --git a/sys/contrib/openzfs/man/man8/zpool-list.8 b/sys/contrib/openzfs/man/man8/zpool-list.8 deleted file mode 100644 --- a/sys/contrib/openzfs/man/man8/zpool-list.8 +++ /dev/null @@ -1,146 +0,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) 2007, Sun Microsystems, Inc. All Rights Reserved. -.\" Copyright (c) 2012, 2018 by Delphix. All rights reserved. -.\" Copyright (c) 2012 Cyril Plisko. All Rights Reserved. -.\" Copyright (c) 2017 Datto Inc. -.\" Copyright (c) 2018 George Melikov. All Rights Reserved. -.\" Copyright 2017 Nexenta Systems, Inc. -.\" Copyright (c) 2017 Open-E, Inc. All Rights Reserved. -.\" -.Dd March 16, 2022 -.Dt ZPOOL-LIST 8 -.Os -. -.Sh NAME -.Nm zpool-list -.Nd list information about ZFS storage pools -.Sh SYNOPSIS -.Nm zpool -.Cm list -.Op Fl HgLpPv -.Op Fl o Ar property Ns Oo , Ns Ar property Oc Ns … -.Op Fl T Sy u Ns | Ns Sy d -.Oo Ar pool Oc Ns … -.Op Ar interval Op Ar count -. -.Sh DESCRIPTION -Lists the given pools along with a health status and space usage. -If no -.Ar pool Ns s -are specified, all pools in the system are listed. -When given an -.Ar interval , -the information is printed every -.Ar interval -seconds until killed. -If -.Ar count -is specified, the command exits after -.Ar count -reports are printed. -.Bl -tag -width Ds -.It Fl g -Display vdev GUIDs instead of the normal device names. -These GUIDs can be used in place of device names for the zpool -detach/offline/remove/replace commands. -.It Fl H -Scripted mode. -Do not display headers, and separate fields by a single tab instead of arbitrary -space. -.It Fl o Ar property -Comma-separated list of properties to display. -See the -.Xr zpoolprops 7 -manual page for a list of valid properties. -The default list is -.Sy name , size , allocated , free , checkpoint, expandsize , fragmentation , -.Sy capacity , dedupratio , health , altroot . -.It Fl L -Display real paths for vdevs resolving all symbolic links. -This can be used to look up the current block device name regardless of the -.Pa /dev/disk -path used to open it. -.It Fl p -Display numbers in parsable -.Pq exact -values. -.It Fl P -Display full paths for vdevs instead of only the last component of -the path. -This can be used in conjunction with the -.Fl L -flag. -.It Fl T Sy u Ns | Ns Sy d -Display a time stamp. -Specify -.Sy u -for a printed representation of the internal representation of time. -See -.Xr time 2 . -Specify -.Sy d -for standard date format. -See -.Xr date 1 . -.It Fl v -Verbose statistics. -Reports usage statistics for individual vdevs within the pool, in addition to -the pool-wide statistics. -.El -. -.Sh EXAMPLES -.\" These are, respectively, examples 6, 15 from zpool.8 -.\" Make sure to update them bidirectionally -.Ss Example 1 : No Listing Available ZFS Storage Pools -The following command lists all available pools on the system. -In this case, the pool -.Ar zion -is faulted due to a missing device. -The results from this command are similar to the following: -.Bd -literal -compact -offset Ds -.No # Nm zpool Cm list -NAME SIZE ALLOC FREE EXPANDSZ FRAG CAP DEDUP HEALTH ALTROOT -rpool 19.9G 8.43G 11.4G - 33% 42% 1.00x ONLINE - -tank 61.5G 20.0G 41.5G - 48% 32% 1.00x ONLINE - -zion - - - - - - - FAULTED - -.Ed -. -.Ss Example 2 : No Displaying expanded space on a device -The following command displays the detailed information for the pool -.Ar data . -This pool is comprised of a single raidz vdev where one of its devices -increased its capacity by 10 GiB. -In this example, the pool will not be able to utilize this extra capacity until -all the devices under the raidz vdev have been expanded. -.Bd -literal -compact -offset Ds -.No # Nm zpool Cm list Fl v Ar data -NAME SIZE ALLOC FREE EXPANDSZ FRAG CAP DEDUP HEALTH ALTROOT -data 23.9G 14.6G 9.30G - 48% 61% 1.00x ONLINE - - raidz1 23.9G 14.6G 9.30G - 48% - sda - - - - - - sdb - - - 10G - - sdc - - - - - -.Ed -. -.Sh SEE ALSO -.Xr zpool-import 8 , -.Xr zpool-status 8 diff --git a/sys/contrib/openzfs/man/man8/zpool-status.8 b/sys/contrib/openzfs/man/man8/zpool-status.8 deleted file mode 100644 --- a/sys/contrib/openzfs/man/man8/zpool-status.8 +++ /dev/null @@ -1,167 +0,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) 2007, Sun Microsystems, Inc. All Rights Reserved. -.\" Copyright (c) 2012, 2018 by Delphix. All rights reserved. -.\" Copyright (c) 2012 Cyril Plisko. All Rights Reserved. -.\" Copyright (c) 2017 Datto Inc. -.\" Copyright (c) 2018 George Melikov. All Rights Reserved. -.\" Copyright 2017 Nexenta Systems, Inc. -.\" Copyright (c) 2017 Open-E, Inc. All Rights Reserved. -.\" -.Dd March 16, 2022 -.Dt ZPOOL-STATUS 8 -.Os -. -.Sh NAME -.Nm zpool-status -.Nd show detailed health status for ZFS storage pools -.Sh SYNOPSIS -.Nm zpool -.Cm status -.Op Fl DigLpPstvx -.Op Fl T Sy u Ns | Ns Sy d -.Op Fl c Op Ar SCRIPT1 Ns Oo , Ns Ar SCRIPT2 Oc Ns … -.Oo Ar pool Oc Ns … -.Op Ar interval Op Ar count -. -.Sh DESCRIPTION -Displays the detailed health status for the given pools. -If no -.Ar pool -is specified, then the status of each pool in the system is displayed. -For more information on pool and device health, see the -.Sx Device Failure and Recovery -section of -.Xr zpoolconcepts 7 . -.Pp -If a scrub or resilver is in progress, this command reports the percentage done -and the estimated time to completion. -Both of these are only approximate, because the amount of data in the pool and -the other workloads on the system can change. -.Bl -tag -width Ds -.It Fl -power -Display vdev enclosure slot power status (on or off). -.It Fl c Op Ar SCRIPT1 Ns Oo , Ns Ar SCRIPT2 Oc Ns … -Run a script (or scripts) on each vdev and include the output as a new column -in the -.Nm zpool Cm status -output. -See the -.Fl c -option of -.Nm zpool Cm iostat -for complete details. -.It Fl i -Display vdev initialization status. -.It Fl g -Display vdev GUIDs instead of the normal device names -These GUIDs can be used in place of device names for the zpool -detach/offline/remove/replace commands. -.It Fl L -Display real paths for vdevs resolving all symbolic links. -This can be used to look up the current block device name regardless of the -.Pa /dev/disk/ -path used to open it. -.It Fl p -Display numbers in parsable (exact) values. -.It Fl P -Display full paths for vdevs instead of only the last component of -the path. -This can be used in conjunction with the -.Fl L -flag. -.It Fl D -Display a histogram of deduplication statistics, showing the allocated -.Pq physically present on disk -and referenced -.Pq logically referenced in the pool -block counts and sizes by reference count. -.It Fl s -Display the number of leaf vdev slow I/O operations. -This is the number of I/O operations that didn't complete in -.Sy zio_slow_io_ms -milliseconds -.Pq Sy 30000 No by default . -This does not necessarily mean the I/O operations failed to complete, just took -an -unreasonably long amount of time. -This may indicate a problem with the underlying storage. -.It Fl t -Display vdev TRIM status. -.It Fl T Sy u Ns | Ns Sy d -Display a time stamp. -Specify -.Sy u -for a printed representation of the internal representation of time. -See -.Xr time 2 . -Specify -.Sy d -for standard date format. -See -.Xr date 1 . -.It Fl v -Displays verbose data error information, printing out a complete list of all -data errors since the last complete pool scrub. -If the head_errlog feature is enabled and files containing errors have been -removed then the respective filenames will not be reported in subsequent runs -of this command. -.It Fl x -Only display status for pools that are exhibiting errors or are otherwise -unavailable. -Warnings about pools not using the latest on-disk format will not be included. -.El -. -.Sh EXAMPLES -.\" These are, respectively, examples 16 from zpool.8 -.\" Make sure to update them bidirectionally -.Ss Example 1 : No Adding output columns -Additional columns can be added to the -.Nm zpool Cm status No and Nm zpool Cm iostat No output with Fl c . -.Bd -literal -compact -offset Ds -.No # Nm zpool Cm status Fl c Pa vendor , Ns Pa model , Ns Pa size - NAME STATE READ WRITE CKSUM vendor model size - tank ONLINE 0 0 0 - mirror-0 ONLINE 0 0 0 - U1 ONLINE 0 0 0 SEAGATE ST8000NM0075 7.3T - U10 ONLINE 0 0 0 SEAGATE ST8000NM0075 7.3T - U11 ONLINE 0 0 0 SEAGATE ST8000NM0075 7.3T - U12 ONLINE 0 0 0 SEAGATE ST8000NM0075 7.3T - U13 ONLINE 0 0 0 SEAGATE ST8000NM0075 7.3T - U14 ONLINE 0 0 0 SEAGATE ST8000NM0075 7.3T - -.No # Nm zpool Cm iostat Fl vc Pa size - capacity operations bandwidth -pool alloc free read write read write size ----------- ----- ----- ----- ----- ----- ----- ---- -rpool 14.6G 54.9G 4 55 250K 2.69M - sda1 14.6G 54.9G 4 55 250K 2.69M 70G ----------- ----- ----- ----- ----- ----- ----- ---- -.Ed -. -.Sh SEE ALSO -.Xr zpool-events 8 , -.Xr zpool-history 8 , -.Xr zpool-iostat 8 , -.Xr zpool-list 8 , -.Xr zpool-resilver 8 , -.Xr zpool-scrub 8 , -.Xr zpool-wait 8 diff --git a/sys/contrib/openzfs/man/man8/zpool-wait.8 b/sys/contrib/openzfs/man/man8/zpool-wait.8 deleted file mode 100644 --- a/sys/contrib/openzfs/man/man8/zpool-wait.8 +++ /dev/null @@ -1,118 +0,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) 2007, Sun Microsystems, Inc. All Rights Reserved. -.\" Copyright (c) 2012, 2021 by Delphix. All rights reserved. -.\" Copyright (c) 2012 Cyril Plisko. All Rights Reserved. -.\" Copyright (c) 2017 Datto Inc. -.\" Copyright (c) 2018 George Melikov. All Rights Reserved. -.\" Copyright 2017 Nexenta Systems, Inc. -.\" Copyright (c) 2017 Open-E, Inc. All Rights Reserved. -.\" -.Dd May 27, 2021 -.Dt ZPOOL-WAIT 8 -.Os -. -.Sh NAME -.Nm zpool-wait -.Nd wait for activity to stop in a ZFS storage pool -.Sh SYNOPSIS -.Nm zpool -.Cm wait -.Op Fl Hp -.Op Fl T Sy u Ns | Ns Sy d -.Op Fl t Ar activity Ns Oo , Ns Ar activity Ns Oc Ns … -.Ar pool -.Op Ar interval -. -.Sh DESCRIPTION -Waits until all background activity of the given types has ceased in the given -pool. -The activity could cease because it has completed, or because it has been -paused or canceled by a user, or because the pool has been exported or -destroyed. -If no activities are specified, the command waits until background activity of -every type listed below has ceased. -If there is no activity of the given types in progress, the command returns -immediately. -.Pp -These are the possible values for -.Ar activity , -along with what each one waits for: -.Bl -tag -compact -offset Ds -width "raidz_expand" -.It Sy discard -Checkpoint to be discarded -.It Sy free -.Sy freeing -property to become -.Sy 0 -.It Sy initialize -All initializations to cease -.It Sy replace -All device replacements to cease -.It Sy remove -Device removal to cease -.It Sy resilver -Resilver to cease -.It Sy scrub -Scrub to cease -.It Sy trim -Manual trim to cease -.It Sy raidz_expand -Attaching to a RAID-Z vdev to complete -.El -.Pp -If an -.Ar interval -is provided, the amount of work remaining, in bytes, for each activity is -printed every -.Ar interval -seconds. -.Bl -tag -width Ds -.It Fl H -Scripted mode. -Do not display headers, and separate fields by a single tab instead of arbitrary -space. -.It Fl p -Display numbers in parsable (exact) values. -.It Fl T Sy u Ns | Ns Sy d -Display a time stamp. -Specify -.Sy u -for a printed representation of the internal representation of time. -See -.Xr time 2 . -Specify -.Sy d -for standard date format. -See -.Xr date 1 . -.El -. -.Sh SEE ALSO -.Xr zpool-checkpoint 8 , -.Xr zpool-initialize 8 , -.Xr zpool-remove 8 , -.Xr zpool-replace 8 , -.Xr zpool-resilver 8 , -.Xr zpool-scrub 8 , -.Xr zpool-status 8 , -.Xr zpool-trim 8